Initial plan

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Author: Copilot

src/main/java/com/github/copilot/sdk/SessionRequestBuilder.java

@@ -152,6 +152,7 @@ static CreateSessionRequest buildCreateRequest(SessionConfig config, String sess
         }
         request.setGitHubToken(config.getGitHubToken());
         request.setRemoteSession(config.getRemoteSession());
+        request.setCloud(config.getCloud());
 
         return request;
     }

src/main/java/com/github/copilot/sdk/json/CloudSessionOptions.java

@@ -0,0 +1,43 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Options for creating a remote session in the cloud.
+ *
+ * @since 1.5.0
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class CloudSessionOptions {
+
+    @JsonProperty("repository")
+    private CloudSessionRepository repository;
+
+    /**
+     * Gets the optional GitHub repository metadata to associate with the cloud
+     * session.
+     *
+     * @return the repository metadata, or {@code null} if not set
+     */
+    public CloudSessionRepository getRepository() {
+        return repository;
+    }
+
+    /**
+     * Sets the optional GitHub repository metadata to associate with the cloud
+     * session.
+     *
+     * @param repository
+     *            the repository metadata
+     * @return this instance for method chaining
+     */
+    public CloudSessionOptions setRepository(CloudSessionRepository repository) {
+        this.repository = repository;
+        return this;
+    }
+}

src/main/java/com/github/copilot/sdk/json/CloudSessionRepository.java

@@ -0,0 +1,89 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * GitHub repository metadata to associate with a cloud session.
+ *
+ * @since 1.5.0
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class CloudSessionRepository {
+
+    @JsonProperty("owner")
+    private String owner;
+
+    @JsonProperty("name")
+    private String name;
+
+    @JsonProperty("branch")
+    private String branch;
+
+    /**
+     * Gets the repository owner.
+     *
+     * @return the repository owner
+     */
+    public String getOwner() {
+        return owner;
+    }
+
+    /**
+     * Sets the repository owner.
+     *
+     * @param owner
+     *            the repository owner
+     * @return this instance for method chaining
+     */
+    public CloudSessionRepository setOwner(String owner) {
+        this.owner = owner;
+        return this;
+    }
+
+    /**
+     * Gets the repository name.
+     *
+     * @return the repository name
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Sets the repository name.
+     *
+     * @param name
+     *            the repository name
+     * @return this instance for method chaining
+     */
+    public CloudSessionRepository setName(String name) {
+        this.name = name;
+        return this;
+    }
+
+    /**
+     * Gets the optional branch name.
+     *
+     * @return the branch name, or {@code null} if not set
+     */
+    public String getBranch() {
+        return branch;
+    }
+
+    /**
+     * Sets the optional branch name.
+     *
+     * @param branch
+     *            the branch name
+     * @return this instance for method chaining
+     */
+    public CloudSessionRepository setBranch(String branch) {
+        this.branch = branch;
+        return this;
+    }
+}

src/main/java/com/github/copilot/sdk/json/CreateSessionRequest.java

@@ -127,6 +127,9 @@ public final class CreateSessionRequest {
     @JsonProperty("remoteSession")
     private String remoteSession;
 
+    @JsonProperty("cloud")
+    private CloudSessionOptions cloud;
+
     /** Gets the model name. @return the model */
     public String getModel() {
         return model;
@@ -543,4 +546,14 @@ public String getRemoteSession() {
     public void setRemoteSession(String remoteSession) {
         this.remoteSession = remoteSession;
     }
+
+    /** Gets the cloud session options. @return the cloud session options */
+    public CloudSessionOptions getCloud() {
+        return cloud;
+    }
+
+    /** Sets the cloud session options. @param cloud the cloud session options */
+    public void setCloud(CloudSessionOptions cloud) {
+        this.cloud = cloud;
+    }
 }

src/main/java/com/github/copilot/sdk/json/CustomAgentConfig.java

@@ -60,6 +60,9 @@ public class CustomAgentConfig {
     @JsonProperty("skills")
     private List<String> skills;
 
+    @JsonProperty("model")
+    private String model;
+
     /**
      * Gets the unique identifier name for this agent.
      *
@@ -255,4 +258,28 @@ public CustomAgentConfig setSkills(List<String> skills) {
         this.skills = skills;
         return this;
     }
+
+    /**
+     * Gets the model identifier for this agent.
+     *
+     * @return the model identifier, or {@code null} if not set
+     */
+    public String getModel() {
+        return model;
+    }
+
+    /**
+     * Sets the model identifier for this agent.
+     * <p>
+     * When set, the runtime will attempt to use this model for the agent, falling
+     * back to the parent session model if unavailable.
+     *
+     * @param model
+     *            the model identifier (e.g., "claude-haiku-4.5")
+     * @return this config for method chaining
+     */
+    public CustomAgentConfig setModel(String model) {
+        this.model = model;
+        return this;
+    }
 }

src/main/java/com/github/copilot/sdk/json/PostToolUseHookInput.java

@@ -16,6 +16,9 @@
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class PostToolUseHookInput {
 
+    @JsonProperty("sessionId")
+    private String sessionId;
+
     @JsonProperty("timestamp")
     private long timestamp;
 
@@ -31,6 +34,27 @@ public class PostToolUseHookInput {
     @JsonProperty("toolResult")
     private JsonNode toolResult;
 
+    /**
+     * Gets the runtime session ID of the session that triggered the hook.
+     *
+     * @return the session ID
+     */
+    public String getSessionId() {
+        return sessionId;
+    }
+
+    /**
+     * Sets the runtime session ID of the session that triggered the hook.
+     *
+     * @param sessionId
+     *            the session ID
+     * @return this instance for method chaining
+     */
+    public PostToolUseHookInput setSessionId(String sessionId) {
+        this.sessionId = sessionId;
+        return this;
+    }
+
     /**
      * Gets the timestamp of the hook invocation.
      *

src/main/java/com/github/copilot/sdk/json/PreToolUseHookInput.java

@@ -16,6 +16,9 @@
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class PreToolUseHookInput {
 
+    @JsonProperty("sessionId")
+    private String sessionId;
+
     @JsonProperty("timestamp")
     private long timestamp;
 
@@ -28,6 +31,27 @@ public class PreToolUseHookInput {
     @JsonProperty("toolArgs")
     private JsonNode toolArgs;
 
+    /**
+     * Gets the runtime session ID of the session that triggered the hook.
+     *
+     * @return the session ID
+     */
+    public String getSessionId() {
+        return sessionId;
+    }
+
+    /**
+     * Sets the runtime session ID of the session that triggered the hook.
+     *
+     * @param sessionId
+     *            the session ID
+     * @return this instance for method chaining
+     */
+    public PreToolUseHookInput setSessionId(String sessionId) {
+        this.sessionId = sessionId;
+        return this;
+    }
+
     /**
      * Gets the timestamp of the hook invocation.
      *

src/main/java/com/github/copilot/sdk/json/SessionConfig.java

@@ -72,6 +72,7 @@ public class SessionConfig {
     private AutoModeSwitchHandler onAutoModeSwitch;
     private String gitHubToken;
     private String remoteSession;
+    private CloudSessionOptions cloud;
 
     /**
      * Gets the custom session ID.
@@ -979,6 +980,35 @@ public SessionConfig setRemoteSession(String remoteSession) {
         return this;
     }
 
+    /**
+     * Gets the cloud session options.
+     * <p>
+     * When set, creates a remote session in the cloud instead of a local session.
+     * The optional repository is associated with the cloud session.
+     *
+     * @return the cloud session options, or {@code null} if not set
+     * @since 1.5.0
+     */
+    public CloudSessionOptions getCloud() {
+        return cloud;
+    }
+
+    /**
+     * Sets the cloud session options.
+     * <p>
+     * When set, creates a remote session in the cloud instead of a local session.
+     * The optional repository is associated with the cloud session.
+     *
+     * @param cloud
+     *            the cloud session options
+     * @return this config instance for method chaining
+     * @since 1.5.0
+     */
+    public SessionConfig setCloud(CloudSessionOptions cloud) {
+        this.cloud = cloud;
+        return this;
+    }
+
     /**
      * Creates a shallow clone of this {@code SessionConfig} instance.
      * <p>
@@ -1029,6 +1059,7 @@ public SessionConfig clone() {
         copy.onAutoModeSwitch = this.onAutoModeSwitch;
         copy.gitHubToken = this.gitHubToken;
         copy.remoteSession = this.remoteSession;
+        copy.cloud = this.cloud;
         return copy;
     }
 }

src/main/java/com/github/copilot/sdk/json/SessionEndHookInput.java

@@ -13,6 +13,8 @@
  * This hook is invoked when a session ends, allowing you to perform cleanup or
  * logging.
  *
+ * @param sessionId
+ *            the runtime session ID of the session that triggered the hook
  * @param timestamp
  *            the timestamp in milliseconds since epoch when the session ended
  * @param cwd
@@ -27,7 +29,8 @@
  * @since 1.0.7
  */
 @JsonIgnoreProperties(ignoreUnknown = true)
-public record SessionEndHookInput(@JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd,
+public record SessionEndHookInput(@JsonProperty("sessionId") String sessionId,
+        @JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd,
         @JsonProperty("reason") String reason, @JsonProperty("finalMessage") String finalMessage,
         @JsonProperty("error") String error) {
 }

src/main/java/com/github/copilot/sdk/json/SessionStartHookInput.java

@@ -13,6 +13,8 @@
  * This hook is invoked when a session starts, allowing you to perform
  * initialization or modify the session configuration.
  *
+ * @param sessionId
+ *            the runtime session ID of the session that triggered the hook
  * @param timestamp
  *            the timestamp in milliseconds since epoch when the session started
  * @param cwd
@@ -24,6 +26,7 @@
  * @since 1.0.7
  */
 @JsonIgnoreProperties(ignoreUnknown = true)
-public record SessionStartHookInput(@JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd,
+public record SessionStartHookInput(@JsonProperty("sessionId") String sessionId,
+        @JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd,
         @JsonProperty("source") String source, @JsonProperty("initialPrompt") String initialPrompt) {
 }