switchTo(SessionModelSwitch
return caller.invoke("session.model.switchTo", _p, SessionModelSwitchToResult.class);
}
+ /**
+ * An Auto preference request for the session. This updates Auto configuration only; it does not change the selected model to `auto`.
+ *
+ * Note: the {@code sessionId} field in the params record is overridden
+ * by the session-scoped wrapper; any value provided is ignored.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+ @CopilotExperimental
+ public CompletableFuture switchAutoTier(SessionModelSwitchAutoTierParams params) {
+ com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params);
+ _p.put("sessionId", this.sessionId);
+ return caller.invoke("session.model.switchAutoTier", _p, SessionModelSwitchAutoTierResult.class);
+ }
+
/**
* Managed, repository, and CLI model overrides to overlay onto the session at startup.
*
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java
index a1d25ae7ec..dfb593fd21 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java
@@ -30,6 +30,8 @@ public record SessionModelApplyStartupOverlayParams(
@JsonProperty("deviceManagedModel") String deviceManagedModel,
/** Model required by server-managed policy, when configured. */
@JsonProperty("serverManagedModel") String serverManagedModel,
+ /** Startup default model from the enterprise policy helper, when configured. Weakest of the managed sources: it applies only when neither device nor server policy names a model, and an explicit user selection still wins. */
+ @JsonProperty("policyHelperModel") String policyHelperModel,
/** Model selected by repository settings, when configured. */
@JsonProperty("repoModel") String repoModel,
/** Reasoning effort selected by repository settings, when configured. */
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java
index f29e249c32..53ce443e08 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java
@@ -40,6 +40,8 @@ public record SessionModelApplyStartupOverlayResult(
/** User-facing warning produced while applying the model switch. */
@JsonProperty("warning") String warning,
/** Deprecation warnings associated with the selected model or options. */
- @JsonProperty("deprecationWarnings") List deprecationWarnings
+ @JsonProperty("deprecationWarnings") List deprecationWarnings,
+ /** Authoritative model and Auto preference state after an immediate switch. For deferred switches this remains the current state until the queued change drains. */
+ @JsonProperty("modelState") CurrentModel modelState
) {
}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java
index 21afab2fa4..23a9788540 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java
@@ -14,7 +14,7 @@
import javax.annotation.processing.Generated;
/**
- * The currently selected model, reasoning effort, and context tier for the session. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
+ * The session's authoritative model snapshot. Auto preference fields are configuration for the virtual `auto` model and do not change the selected model identifier. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
*
* @apiNote This method is experimental and may change in a future version.
* @since 1.0.0
@@ -29,6 +29,12 @@ public record SessionModelGetCurrentResult(
/** Reasoning effort level currently applied to the active model, when one is set. Reads `Session.getReasoningEffort()` synchronously after `getSelectedModel()` resolves so the two values are reported as a snapshot. */
@JsonProperty("reasoningEffort") String reasoningEffort,
/** Context tier for models that support multiple context-window sizes. */
- @JsonProperty("contextTier") ContextTier contextTier
+ @JsonProperty("contextTier") ContextTier contextTier,
+ /** Auto preference currently committed for the session. This can remain available while another model is selected so a later switch to `auto` can reuse it. */
+ @JsonProperty("autoTier") AutoTier autoTier,
+ /** Latest unclaimed Auto preference waiting for a future user turn. Null means the pending request is returning to provider-default routing. */
+ @JsonProperty("pendingAutoTier") AutoTier pendingAutoTier,
+ /** Auto preference currently claimed by an in-progress activation. Null means the activation is returning to provider-default routing. */
+ @JsonProperty("activatingAutoTier") AutoTier activatingAutoTier
) {
}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchAutoTierParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchAutoTierParams.java
new file mode 100644
index 0000000000..576df55aa1
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchAutoTierParams.java
@@ -0,0 +1,34 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * An Auto preference request for the session. This updates Auto configuration only; it does not change the selected model to `auto`.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionModelSwitchAutoTierParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId,
+ /** Auto preference to activate when a future user turn using the `auto` model safely mints a replacement model and token pair. Pass null to return to provider-default Auto routing. */
+ @JsonProperty("autoTier") AutoTier autoTier,
+ /** Origin to record on the effective `session.model_change` event. Defaults to `sdk` when omitted. */
+ @JsonProperty("source") ModelChangeSource source
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchAutoTierResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchAutoTierResult.java
new file mode 100644
index 0000000000..7e95695492
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchAutoTierResult.java
@@ -0,0 +1,38 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Immediate acknowledgement and Auto preference snapshot after a switch request. This result never implies that a pending preference committed.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionModelSwitchAutoTierResult(
+ /** Immediate request status. `pending` means accepted but not committed. */
+ @JsonProperty("status") ModelSwitchAutoTierStatus status,
+ /** Auto preference currently committed for the session. */
+ @JsonProperty("effectiveAutoTier") AutoTier effectiveAutoTier,
+ /** Latest unclaimed Auto preference waiting for a future user turn. */
+ @JsonProperty("pendingAutoTier") AutoTier pendingAutoTier,
+ /** Auto preference currently claimed by an in-progress activation. Null means the activation is returning to provider-default routing. */
+ @JsonProperty("activatingAutoTier") AutoTier activatingAutoTier,
+ /** Earlier unclaimed preference replaced by this request. This can be present with either status, including when selecting the effective preference cancels pending work. */
+ @JsonProperty("supersededAutoTier") AutoTier supersededAutoTier
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java
index a7c60d28cd..cfd59bcf36 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java
@@ -28,6 +28,8 @@ public record SessionModelSwitchToParams(
@JsonProperty("sessionId") String sessionId,
/** Model selection id to switch to, as returned by `list`. A bare id (e.g. `claude-sonnet-4.6`) names a Copilot (CAPI) model; a provider-qualified id (`provider/id`, e.g. `acme/claude-sonnet`) targets a registry BYOK model. */
@JsonProperty("modelId") String modelId,
+ /** Optional Auto routing preference to stage atomically with selecting `auto`. Pass null to return to provider-default Auto routing. This field is rejected when `modelId` is not `auto`. */
+ @JsonProperty("autoTier") AutoTier autoTier,
/** Reasoning effort level to use for the model. CAPI values are model-defined and validated against the selected model; BYOK providers may define additional values. "none" disables reasoning. When omitted, no effort override is applied. */
@JsonProperty("reasoningEffort") String reasoningEffort,
/** Reasoning summary mode to request for supported model clients */
@@ -38,7 +40,7 @@ public record SessionModelSwitchToParams(
@JsonProperty("modelCapabilities") ModelCapabilitiesOverride modelCapabilities,
/** Explicit context tier for the selected model. `"default"` / `"long_context"` apply the requested tier; omit this field to use normal model behavior with no explicit tier. */
@JsonProperty("contextTier") ContextTier contextTier,
- /** Origin to record on the effective `session.model_change` event. Defaults to `sdk` when omitted. */
+ /** Origin to record on the effective `session.model_change` event for trusted in-process calls. Transport SDK calls are always recorded as `sdk`, regardless of this value. */
@JsonProperty("source") ModelChangeSource source,
/** When true, defer this switch (enqueue it) if another model change is already queued, even when no turn is active — so it drains last (FIFO) and wins over the already-queued change. Intended for genuine user-initiated model selections; internal restore/reapply switches omit it and apply immediately when no turn is active. When no other model change is queued this has no effect (a switch still applies immediately unless a turn is active). */
@JsonProperty("deferIfModelChangeQueued") Boolean deferIfModelChangeQueued,
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java
index fb143abc30..47099e42ea 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java
@@ -40,6 +40,8 @@ public record SessionModelSwitchToResult(
/** User-facing warning produced while applying the model switch. */
@JsonProperty("warning") String warning,
/** Deprecation warnings associated with the selected model or options. */
- @JsonProperty("deprecationWarnings") List deprecationWarnings
+ @JsonProperty("deprecationWarnings") List deprecationWarnings,
+ /** Authoritative model and Auto preference state after an immediate switch. For deferred switches this remains the current state until the queued change drains. */
+ @JsonProperty("modelState") CurrentModel modelState
) {
}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOpenOptions.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOpenOptions.java
index 34706a68e1..a1c234903e 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOpenOptions.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOpenOptions.java
@@ -37,6 +37,8 @@ public record SessionOpenOptions(
@JsonProperty("verbosity") Verbosity verbosity,
/** Identifier of the client driving the session. */
@JsonProperty("clientName") String clientName,
+ /** OAuth Client ID Metadata Document URL used by this host for MCP authorization. */
+ @JsonProperty("authClientIdMetadataUrl") String authClientIdMetadataUrl,
/** Structured client kind used for runtime behavior gates. */
@JsonProperty("clientKind") String clientKind,
/** Identifier sent to LSP-style integrations. */
@@ -111,6 +113,10 @@ public record SessionOpenOptions(
@JsonProperty("allowAllMcpServerInstructions") Boolean allowAllMcpServerInstructions,
/** Additional directories to search for skills. */
@JsonProperty("skillDirectories") List skillDirectories,
+ /** Whether skill loading is enabled. When omitted, an SDK skill provider enables skills by default. */
+ @JsonProperty("enableSkills") Boolean enableSkills,
+ /** Whether the requesting SDK session has a skill provider. The provider remains ephemeral and is never persisted in session options or history. When enableSkills is false, it remains bound but dormant and receives no callbacks. Cloud, relay, handoff, and raw sessions.open flows reject it because they cannot safely pre-register the callback handler. */
+ @JsonProperty("hasSkillProvider") Boolean hasSkillProvider,
/** Built-in skill names to include in this session. When specified, only these runtime-bundled skills are available. Skills from other sources with the same name remain available. */
@JsonProperty("includedBuiltinSkills") List includedBuiltinSkills,
/** Skill IDs disabled for this session. */
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java
index 2e8a069a4b..27a5c2db06 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java
@@ -140,7 +140,7 @@ public record SessionOptionsUpdateParams(
@JsonProperty("enableHostGitOperations") Boolean enableHostGitOperations,
/** Whether to enable cross-session store writes and reads. */
@JsonProperty("enableSessionStore") Boolean enableSessionStore,
- /** Whether to enable skill directory scanning and loading. Falls back to enableConfigDiscovery when unset. */
+ /** Whether skill loading is enabled. Explicit false disables every source, including a bound SDK provider; changing the value invalidates the loaded skill snapshot. When omitted, creation falls back to enableConfigDiscovery unless an SDK skill provider is registered. */
@JsonProperty("enableSkills") Boolean enableSkills,
/** Context tier for models with tiered pricing. The session uses this to derive effective `modelCapabilitiesOverrides` so compaction, truncation, token display, and request limits honor the selected tier. */
@JsonProperty("contextTier") OptionsUpdateContextTier contextTier,
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java
index b9bd6b8226..cf89d37208 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java
@@ -49,6 +49,8 @@ public final class SessionRpc {
public final SessionPlanApi plan;
/** API methods for the {@code workspaces} namespace. */
public final SessionWorkspacesApi workspaces;
+ /** API methods for the {@code autopilotObjective} namespace. */
+ public final SessionAutopilotObjectiveApi autopilotObjective;
/** API methods for the {@code completions} namespace. */
public final SessionCompletionsApi completions;
/** API methods for the {@code instructions} namespace. */
@@ -127,6 +129,7 @@ public SessionRpc(RpcCaller caller, String sessionId) {
this.name = new SessionNameApi(caller, sessionId);
this.plan = new SessionPlanApi(caller, sessionId);
this.workspaces = new SessionWorkspacesApi(caller, sessionId);
+ this.autopilotObjective = new SessionAutopilotObjectiveApi(caller, sessionId);
this.completions = new SessionCompletionsApi(caller, sessionId);
this.instructions = new SessionInstructionsApi(caller, sessionId);
this.fleet = new SessionFleetApi(caller, sessionId);
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java
index 68f038eb4b..c6ca1335de 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java
@@ -57,6 +57,38 @@ public CompletableFuture list() {
return caller.invoke("session.tasks.list", java.util.Map.of("sessionId", this.sessionId), SessionTasksListResult.class);
}
+ /**
+ * Registers or reclaims a client-owned task.
+ *
+ * Note: the {@code sessionId} field in the params record is overridden
+ * by the session-scoped wrapper; any value provided is ignored.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+ @CopilotExperimental
+ public CompletableFuture register(SessionTasksRegisterParams params) {
+ com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params);
+ _p.put("sessionId", this.sessionId);
+ return caller.invoke("session.tasks.register", _p, SessionTasksRegisterResult.class);
+ }
+
+ /**
+ * Updates a client-owned task.
+ *
+ * Note: the {@code sessionId} field in the params record is overridden
+ * by the session-scoped wrapper; any value provided is ignored.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+ @CopilotExperimental
+ public CompletableFuture update(SessionTasksUpdateParams params) {
+ com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params);
+ _p.put("sessionId", this.sessionId);
+ return caller.invoke("session.tasks.update", _p, SessionTasksUpdateResult.class);
+ }
+
/**
* Identifies the target session.
*
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRegisterParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRegisterParams.java
new file mode 100644
index 0000000000..0b14af08fd
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRegisterParams.java
@@ -0,0 +1,42 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Registers or reclaims a client-owned task.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionTasksRegisterParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId,
+ /** Task kind */
+ @JsonProperty("type") TaskClientType type,
+ /** Owner-scoped idempotency key used for registration and reclaim */
+ @JsonProperty("clientTaskId") String clientTaskId,
+ /** Human-readable description of the external work */
+ @JsonProperty("description") String description,
+ /** Optional short display name for the external work */
+ @JsonProperty("displayName") String displayName,
+ /** Whether the owner supports runtime cancellation requests */
+ @JsonProperty("cancellable") Boolean cancellable,
+ /** Expected current sequence for idempotent registration or orphan reclaim */
+ @JsonProperty("expectedSequence") Long expectedSequence
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRegisterResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRegisterResult.java
new file mode 100644
index 0000000000..f7e25fe885
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRegisterResult.java
@@ -0,0 +1,34 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Result of registering or reclaiming a client-owned task.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionTasksRegisterResult(
+ /** Authoritative registered or reclaimed task */
+ @JsonProperty("task") TaskClientInfo task,
+ /** True only when this invocation created a new task */
+ @JsonProperty("created") Boolean created,
+ /** True only when this invocation reclaimed an orphaned task */
+ @JsonProperty("reclaimed") Boolean reclaimed
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksUpdateParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksUpdateParams.java
new file mode 100644
index 0000000000..ecd06a1b7e
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksUpdateParams.java
@@ -0,0 +1,36 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Updates a client-owned task.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionTasksUpdateParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId,
+ /** Canonical runtime-generated task identifier */
+ @JsonProperty("id") String id,
+ /** Owner update sequence to apply */
+ @JsonProperty("sequence") Long sequence,
+ /** Progress or terminal update payload */
+ @JsonProperty("update") Object update
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksUpdateResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksUpdateResult.java
new file mode 100644
index 0000000000..8a08e87859
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionTasksUpdateResult.java
@@ -0,0 +1,34 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Result of publishing a client-owned task update.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionTasksUpdateResult(
+ /** Authoritative task after processing the update */
+ @JsonProperty("task") TaskClientInfo task,
+ /** Whether this invocation changed task state */
+ @JsonProperty("applied") Boolean applied,
+ /** Whether this invocation repeated the latest accepted update */
+ @JsonProperty("duplicate") Boolean duplicate
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionsReadPersistedEventsParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionsReadPersistedEventsParams.java
new file mode 100644
index 0000000000..4da93409be
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionsReadPersistedEventsParams.java
@@ -0,0 +1,36 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Pagination options for reading an inactive or active local session's persisted event journal.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionsReadPersistedEventsParams(
+ /** Session ID whose persisted event journal should be read. */
+ @JsonProperty("sessionId") String sessionId,
+ /** Opaque cursor returned by a previous persisted-event read. Omit on the first call. */
+ @JsonProperty("cursor") String cursor,
+ /** Maximum number of events to return in this batch (1–1000, default 200). */
+ @JsonProperty("max") Long max,
+ /** Direction to page through persisted history. Forward starts at the beginning; backward starts with the newest events. Events in each page remain chronological. */
+ @JsonProperty("direction") EventsReadDirection direction
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionsReadPersistedEventsResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionsReadPersistedEventsResult.java
new file mode 100644
index 0000000000..f022df5ae2
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionsReadPersistedEventsResult.java
@@ -0,0 +1,38 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import com.github.copilot.generated.SessionEvent;
+import java.util.List;
+import javax.annotation.processing.Generated;
+
+/**
+ * Batch of session events returned by a read, with cursor and continuation metadata.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionsReadPersistedEventsResult(
+ /** Session events for this batch, merged into a single stream in creation order: durable (persisted) events and ephemeral events interleave exactly as they were emitted. Set `includeEphemeral: false` to receive only durable events. Ephemeral events are never replayable once pruned from the in-memory ring, so a consumer that needs them should keep reading with a non-zero `waitMs`. For a backward (tail-first) read, the returned window contains persisted events only, still in chronological (oldest-to-newest) append order. */
+ @JsonProperty("events") List events,
+ /** Opaque cursor for the next read. Pass back unchanged in the next read.cursor to continue from where this read left off. Always present, even when no events were returned. For a backward read this cursor pages toward OLDER events; keep passing `direction: backward` with it (the cursor is also self-describing, so backward paging continues correctly). */
+ @JsonProperty("cursor") String cursor,
+ /** True when more events are available in the read's direction. For a forward read, true means the batch returned `max` events and more are available immediately. For a backward read, true means older persisted events remain before the returned window. */
+ @JsonProperty("hasMore") Boolean hasMore,
+ /** Cursor status: 'ok' means the cursor was applied successfully; 'expired' means the cursor referred to an event that no longer exists in history (e.g. truncated or compacted away) and the read fell back to a boundary of the remaining history. For a forward read the fallback starts from the beginning of the remaining history; for a backward read it falls back to the tail (the newest window). Because the fallback page is a fresh boundary snapshot rather than a continuation of the requested cursor, it may overlap events the consumer has already rendered — a backward fallback to the tail in particular can repeat the newest window. On 'expired', consumers should reset or rebase their local pagination state (or deduplicate by event id) before continuing from the returned cursor rather than blindly appending/prepending the fallback page. */
+ @JsonProperty("cursorStatus") EventsCursorStatus cursorStatus
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderDescriptor.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderDescriptor.java
new file mode 100644
index 0000000000..a678b95fa3
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderDescriptor.java
@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import javax.annotation.processing.Generated;
+
+/**
+ * Catalog-only metadata for one SDK-provided skill. The complete SKILL.md is fetched separately and lazily.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SkillProviderDescriptor(
+ /** Invocation and display name. */
+ @JsonProperty("name") String name,
+ /** Description used in skill catalogs without fetching content. */
+ @JsonProperty("description") String description,
+ /** Whether users may invoke the skill directly. Defaults to true. */
+ @JsonProperty("userInvocable") Boolean userInvocable,
+ /** Whether model invocation is disabled. Defaults to false. */
+ @JsonProperty("disableModelInvocation") Boolean disableModelInvocation,
+ /** Optional freeform argument hint used by slash-command catalogs. */
+ @JsonProperty("argumentHint") String argumentHint
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderListParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderListParams.java
new file mode 100644
index 0000000000..e11fcf0fbd
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderListParams.java
@@ -0,0 +1,30 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Identifies the target session.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SkillProviderListParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderListResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderListResult.java
new file mode 100644
index 0000000000..228ec9240b
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderListResult.java
@@ -0,0 +1,31 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import java.util.List;
+import javax.annotation.processing.Generated;
+
+/**
+ * Catalog metadata returned by an SDK session's skill provider. Catalogs are limited to 1024 descriptors and 1 MiB of aggregate metadata.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SkillProviderListResult(
+ /** Skill descriptors in provider order. Invocation names must be unique under case-insensitive comparison. */
+ @JsonProperty("skills") List skills
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderReadParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderReadParams.java
new file mode 100644
index 0000000000..895078384b
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderReadParams.java
@@ -0,0 +1,32 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Identifies one SDK-provided skill by invocation name.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SkillProviderReadParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId,
+ /** Invocation name of the skill to read. */
+ @JsonProperty("name") String name
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderReadResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderReadResult.java
new file mode 100644
index 0000000000..0f17696565
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillProviderReadResult.java
@@ -0,0 +1,30 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Complete text-only SKILL.md content returned by an SDK session's skill provider. Related files and assets are not supported.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SkillProviderReadResult(
+ /** Complete SKILL.md text. The runtime enforces a 1 MiB UTF-8 byte limit. */
+ @JsonProperty("markdown") String markdown
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java
index 8d723548be..bef1995e6c 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java
@@ -10,7 +10,7 @@
import javax.annotation.processing.Generated;
/**
- * Source location type (e.g., project, personal-copilot, plugin, builtin)
+ * Source location type (e.g., project, personal-copilot, plugin, builtin, sdk)
*
* @since 1.0.0
*/
@@ -29,7 +29,9 @@ public enum SkillSource {
/** The {@code custom} variant. */
CUSTOM("custom"),
/** The {@code builtin} variant. */
- BUILTIN("builtin");
+ BUILTIN("builtin"),
+ /** The {@code sdk} variant. */
+ SDK("sdk");
private final String value;
SkillSource(String value) { this.value = value; }
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java
index a020c89ecf..5e1f6fd90e 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java
@@ -24,12 +24,14 @@
public record SkillsInvokedSkill(
/** Unique identifier for the skill */
@JsonProperty("name") String name,
- /** Path to the SKILL.md file */
+ /** Path to the SKILL.md file, or an empty string for an SDK-provided skill without a filesystem identity */
@JsonProperty("path") String path,
/** Full content of the skill file */
@JsonProperty("content") String content,
/** Tools that should be auto-approved when this skill is active, captured at invocation time */
@JsonProperty("allowedTools") List allowedTools,
+ /** Whether model invocation was disabled when this skill was invoked */
+ @JsonProperty("disableModelInvocation") Boolean disableModelInvocation,
/** Turn number when the skill was invoked */
@JsonProperty("invokedAtTurn") Long invokedAtTurn
) {
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandCompletedResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandCompletedResult.java
index b2a1970a36..c457181435 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandCompletedResult.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandCompletedResult.java
@@ -32,6 +32,10 @@ public final class SlashCommandCompletedResult extends SlashCommandInvocationRes
@JsonProperty("message")
private String message;
+ /** Optional target session mode applied without submitting an agent prompt */
+ @JsonProperty("mode")
+ private SessionMode mode;
+
/** True when the invocation mutated user runtime settings; consumers caching settings should refresh */
@JsonProperty("runtimeSettingsChanged")
private Boolean runtimeSettingsChanged;
@@ -39,6 +43,9 @@ public final class SlashCommandCompletedResult extends SlashCommandInvocationRes
public String getMessage() { return message; }
public void setMessage(String message) { this.message = message; }
+ public SessionMode getMode() { return mode; }
+ public void setMode(SessionMode mode) { this.mode = mode; }
+
public Boolean getRuntimeSettingsChanged() { return runtimeSettingsChanged; }
public void setRuntimeSettingsChanged(Boolean runtimeSettingsChanged) { this.runtimeSettingsChanged = runtimeSettingsChanged; }
}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandTimelineEntry.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandTimelineEntry.java
index a238d7fb67..f8c832e05d 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandTimelineEntry.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SlashCommandTimelineEntry.java
@@ -21,6 +21,8 @@ public record SlashCommandTimelineEntry(
/** Text displayed for the timeline entry. */
@JsonProperty("text") String text,
/** Optional URL associated with the timeline entry. */
- @JsonProperty("url") String url
+ @JsonProperty("url") String url,
+ /** What the user must do to recover, when the entry reports a failure the runtime knows an action for. The `text` never names a client affordance, so a client that offers one renders it from this value. */
+ @JsonProperty("remediation") RemediationAction remediation
) {
}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SubagentSettingsEntry.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SubagentSettingsEntry.java
index 29426d931b..4a366864c3 100644
--- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SubagentSettingsEntry.java
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SubagentSettingsEntry.java
@@ -23,6 +23,8 @@
public record SubagentSettingsEntry(
/** Model override for matching subagents */
@JsonProperty("model") String model,
+ /** Whether the configured model strategy is preferred or required */
+ @JsonProperty("modelPolicy") AgentModelPolicy modelPolicy,
/** Reasoning effort override for matching subagents */
@JsonProperty("effortLevel") String effortLevel,
/** Context tier override for matching subagents */
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientExecutionMode.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientExecutionMode.java
new file mode 100644
index 0000000000..6c948f86e0
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientExecutionMode.java
@@ -0,0 +1,33 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Client-owned tasks always execute outside the runtime in background mode.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum TaskClientExecutionMode {
+ /** The {@code background} variant. */
+ BACKGROUND("background");
+
+ private final String value;
+ TaskClientExecutionMode(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static TaskClientExecutionMode fromValue(String value) {
+ for (TaskClientExecutionMode v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown TaskClientExecutionMode value: " + value);
+ }
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientInfo.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientInfo.java
new file mode 100644
index 0000000000..6a221303eb
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientInfo.java
@@ -0,0 +1,70 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.time.OffsetDateTime;
+import javax.annotation.processing.Generated;
+
+/**
+ * Tracked client-owned task metadata.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record TaskClientInfo(
+ /** Task kind */
+ @JsonProperty("type") TaskClientType type,
+ /** Canonical runtime-generated task identifier */
+ @JsonProperty("id") String id,
+ /** Owner-scoped registration and reclaim key */
+ @JsonProperty("clientTaskId") String clientTaskId,
+ /** Optional task display name */
+ @JsonProperty("displayName") String displayName,
+ /** Task description */
+ @JsonProperty("description") String description,
+ /** Client task lifecycle status */
+ @JsonProperty("status") TaskClientStatus status,
+ /** Public attribution and presence for the task owner */
+ @JsonProperty("owner") TaskClientOwner owner,
+ /** ISO 8601 timestamp when the task started */
+ @JsonProperty("startedAt") OffsetDateTime startedAt,
+ /** ISO 8601 timestamp of the latest accepted lifecycle change */
+ @JsonProperty("updatedAt") OffsetDateTime updatedAt,
+ /** ISO 8601 timestamp when the task reached a terminal status */
+ @JsonProperty("completedAt") OffsetDateTime completedAt,
+ /** Accumulated active execution time in milliseconds */
+ @JsonProperty("activeTimeMs") Long activeTimeMs,
+ /** ISO 8601 timestamp when the current active segment started */
+ @JsonProperty("activeStartedAt") OffsetDateTime activeStartedAt,
+ /** ISO 8601 timestamp when the connected owner entered idle status */
+ @JsonProperty("idleSince") OffsetDateTime idleSince,
+ /** ISO 8601 timestamp of the most recent orphan transition */
+ @JsonProperty("orphanedAt") OffsetDateTime orphanedAt,
+ /** ISO 8601 timestamp of the most recent successful reclaim */
+ @JsonProperty("reclaimedAt") OffsetDateTime reclaimedAt,
+ /** Execution mode, which is always background for client-owned tasks */
+ @JsonProperty("executionMode") TaskClientExecutionMode executionMode,
+ /** Whether the currently bound owner can receive a cancellation request */
+ @JsonProperty("canCancel") Boolean canCancel,
+ /** Sequence number of the latest accepted owner update */
+ @JsonProperty("sequence") Long sequence,
+ /** Opaque successful terminal result supplied by the task owner */
+ @JsonProperty("result") Object result,
+ /** Human-readable terminal failure message */
+ @JsonProperty("error") String error,
+ /** Optional owner-supplied terminal failure code */
+ @JsonProperty("errorCode") String errorCode,
+ /** Human-readable reason for terminal cancellation */
+ @JsonProperty("cancellationReason") String cancellationReason
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwner.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwner.java
new file mode 100644
index 0000000000..e2ce54019b
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwner.java
@@ -0,0 +1,40 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.time.OffsetDateTime;
+import javax.annotation.processing.Generated;
+
+/**
+ * Public owner attribution for a client-owned task. Identifiers are opaque and never authorize requests.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record TaskClientOwner(
+ /** Opaque session-scoped participant identity */
+ @JsonProperty("participantId") String participantId,
+ /** Opaque identity of the currently or most recently bound session join */
+ @JsonProperty("joinId") String joinId,
+ /** Class of the task owner */
+ @JsonProperty("kind") TaskClientOwnerKind kind,
+ /** Display-only owner name */
+ @JsonProperty("displayName") String displayName,
+ /** Display-only owner source */
+ @JsonProperty("source") String source,
+ /** Whether this task's bound join is currently connected */
+ @JsonProperty("presence") TaskClientOwnerPresence presence,
+ /** ISO 8601 timestamp when the bound join disconnected */
+ @JsonProperty("disconnectedAt") OffsetDateTime disconnectedAt
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwnerKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwnerKind.java
new file mode 100644
index 0000000000..92518264a5
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwnerKind.java
@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Connection class owning a client task.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum TaskClientOwnerKind {
+ /** The {@code extension} variant. */
+ EXTENSION("extension"),
+ /** The {@code sdk} variant. */
+ SDK("sdk");
+
+ private final String value;
+ TaskClientOwnerKind(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static TaskClientOwnerKind fromValue(String value) {
+ for (TaskClientOwnerKind v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown TaskClientOwnerKind value: " + value);
+ }
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwnerPresence.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwnerPresence.java
new file mode 100644
index 0000000000..282cc69206
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientOwnerPresence.java
@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Presence of the task's bound join.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum TaskClientOwnerPresence {
+ /** The {@code connected} variant. */
+ CONNECTED("connected"),
+ /** The {@code disconnected} variant. */
+ DISCONNECTED("disconnected");
+
+ private final String value;
+ TaskClientOwnerPresence(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static TaskClientOwnerPresence fromValue(String value) {
+ for (TaskClientOwnerPresence v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown TaskClientOwnerPresence value: " + value);
+ }
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientStatus.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientStatus.java
new file mode 100644
index 0000000000..a72daddc41
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientStatus.java
@@ -0,0 +1,43 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Lifecycle status of a client-owned task.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum TaskClientStatus {
+ /** The {@code running} variant. */
+ RUNNING("running"),
+ /** The {@code idle} variant. */
+ IDLE("idle"),
+ /** The {@code completed} variant. */
+ COMPLETED("completed"),
+ /** The {@code failed} variant. */
+ FAILED("failed"),
+ /** The {@code cancelled} variant. */
+ CANCELLED("cancelled"),
+ /** The {@code orphaned} variant. */
+ ORPHANED("orphaned");
+
+ private final String value;
+ TaskClientStatus(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static TaskClientStatus fromValue(String value) {
+ for (TaskClientStatus v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown TaskClientStatus value: " + value);
+ }
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientType.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientType.java
new file mode 100644
index 0000000000..42f74cf3dd
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskClientType.java
@@ -0,0 +1,33 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Discriminator for a client-owned task.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum TaskClientType {
+ /** The {@code client} variant. */
+ CLIENT("client");
+
+ private final String value;
+ TaskClientType(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static TaskClientType fromValue(String value) {
+ for (TaskClientType v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown TaskClientType value: " + value);
+ }
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskKind.java
new file mode 100644
index 0000000000..413859db20
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskKind.java
@@ -0,0 +1,37 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Closed set of public task kinds a connection can negotiate.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum TaskKind {
+ /** The {@code agent} variant. */
+ AGENT("agent"),
+ /** The {@code shell} variant. */
+ SHELL("shell"),
+ /** The {@code client} variant. */
+ CLIENT("client");
+
+ private final String value;
+ TaskKind(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static TaskKind fromValue(String value) {
+ for (TaskKind v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown TaskKind value: " + value);
+ }
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TasksCancelParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TasksCancelParams.java
new file mode 100644
index 0000000000..57cbd5e6e0
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TasksCancelParams.java
@@ -0,0 +1,38 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Runtime-to-owner cancellation request for a client-owned task.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record TasksCancelParams(
+ /** Session that owns the client task */
+ @JsonProperty("sessionId") String sessionId,
+ /** Canonical runtime-generated task identifier */
+ @JsonProperty("id") String id,
+ /** Owner-scoped task key included for correlation */
+ @JsonProperty("clientTaskId") String clientTaskId,
+ /** Opaque identifier shared by coalesced cancellation callers */
+ @JsonProperty("cancellationId") String cancellationId,
+ /** Reason the runtime requests cancellation */
+ @JsonProperty("reason") ClientTaskCancelReason reason
+) {
+}
diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TasksCancelResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TasksCancelResult.java
new file mode 100644
index 0000000000..bd549d1df4
--- /dev/null
+++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TasksCancelResult.java
@@ -0,0 +1,30 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.CopilotExperimental;
+import javax.annotation.processing.Generated;
+
+/**
+ * Whether the client authoritatively confirmed its external work stopped.
+ *
+ * @apiNote This method is experimental and may change in a future version.
+ * @since 1.0.0
+ */
+@CopilotExperimental
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record TasksCancelResult(
+ /** True only when the owner confirms that external work stopped before responding */
+ @JsonProperty("cancelled") Boolean cancelled
+) {
+}
diff --git a/java/sdk/src/main/java/com/github/copilot/CopilotClient.java b/java/sdk/src/main/java/com/github/copilot/CopilotClient.java
index 661fe6dab4..9f7d8ebcf8 100644
--- a/java/sdk/src/main/java/com/github/copilot/CopilotClient.java
+++ b/java/sdk/src/main/java/com/github/copilot/CopilotClient.java
@@ -221,7 +221,10 @@ public CopilotClient(CopilotClientOptions options) {
// Parse CliUrl if provided
if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty()) {
URI uri = CliServerManager.parseCliUrl(this.options.getCliUrl());
- this.optionsHost = uri.getHost();
+ String host = uri.getHost();
+ this.optionsHost = host != null && host.startsWith("[") && host.endsWith("]")
+ ? host.substring(1, host.length() - 1)
+ : host;
this.optionsPort = uri.getPort();
} else {
this.optionsHost = null;
@@ -550,6 +553,7 @@ private Connection startCoreBody() {
JsonRpcClient connectedRpc = rpc;
Connection connection = new Connection(connectedRpc, process, new ServerRpc(connectedRpc::invoke),
inProcessTransport == null ? null : inProcessTransport.host());
+ connectedRpc.setCloseHandler(() -> sessions.values().forEach(CopilotSession::cancelPendingExternalTools));
// Register handlers for server-to-client calls
RpcHandlerDispatcher dispatcher = new RpcHandlerDispatcher(sessions, lifecycleManager::dispatch, executor,
@@ -635,6 +639,7 @@ private void verifyProtocolVersion(Connection connection) throws Exception {
if (effectiveConnectionToken != null) {
connectParams.put("token", effectiveConnectionToken);
}
+ connectParams.put("supportedTaskKinds", List.of("agent", "client", "shell"));
// Opt into GitHub telemetry forwarding at the connection level when a handler
// is registered, so the runtime can forward the first session's un-replayable
// start event. Also sent on session create/resume for backward compatibility
@@ -642,6 +647,13 @@ private void verifyProtocolVersion(Connection connection) throws Exception {
if (this.options.getOnGitHubTelemetry() != null) {
connectParams.put("enableGitHubTelemetryForwarding", true);
}
+ // Declare the integrating application's identity so the runtime attributes the
+ // telemetry it emits on this connection to a consistent surface instead of
+ // its own build. Omitted when the app didn't supply it (or supplied no fields).
+ var clientInfo = this.options.getClientInfo();
+ if (clientInfo != null && !clientInfo.isEmpty()) {
+ connectParams.put("clientInfo", clientInfo);
+ }
var connectResponse = connection.rpc.invoke("connect", connectParams, ConnectResult.class).get(30,
TimeUnit.SECONDS);
serverVersion = connectResponse.protocolVersion() != null
@@ -735,7 +747,9 @@ public CompletableFuture stop() {
*/
public CompletableFuture forceStop() {
disposed = true;
+ var activeSessions = new ArrayList<>(sessions.values());
sessions.clear();
+ activeSessions.forEach(CopilotSession::cancelPendingExternalTools);
gitHubTokenProviders.clear();
// Dispatch the blocking shutdownOwnedExecutor() on a dedicated thread:
// cleanupConnection() is chained off async work running on the owned
@@ -1007,6 +1021,7 @@ public CompletableFuture createSession(SessionConfig config) {
CopilotSession session = preRegisteredSessionHolder[0] != null
? preRegisteredSessionHolder[0]
: initializeSession.apply(returnedId);
+ preRegisteredSessionHolder[0] = session;
if (tokenRegistration != null) {
session.setGitHubTokenProviderRegistration(tokenRegistration);
}
@@ -1038,6 +1053,9 @@ public CompletableFuture createSession(SessionConfig config) {
return session;
});
}).exceptionally(ex -> {
+ if (preRegisteredSessionHolder[0] != null) {
+ preRegisteredSessionHolder[0].cancelPendingExternalTools();
+ }
if (registeredIdHolder[0] != null) {
sessions.remove(registeredIdHolder[0]);
}
@@ -1218,6 +1236,7 @@ public CompletableFuture resumeSession(String sessionId, ResumeS
return session;
});
}).exceptionally(ex -> {
+ session.cancelPendingExternalTools();
sessions.remove(sessionId);
// Also remove the re-keyed entry if the server returned a different ID
String activeId = session.getSessionId();
diff --git a/java/sdk/src/main/java/com/github/copilot/CopilotSession.java b/java/sdk/src/main/java/com/github/copilot/CopilotSession.java
index f3a35967d3..c072e31ec1 100644
--- a/java/sdk/src/main/java/com/github/copilot/CopilotSession.java
+++ b/java/sdk/src/main/java/com/github/copilot/CopilotSession.java
@@ -20,6 +20,7 @@
import java.util.concurrent.ScheduledThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;
+import java.util.concurrent.atomic.AtomicInteger;
import java.util.concurrent.atomic.AtomicReference;
import java.util.function.Consumer;
import java.util.logging.Level;
@@ -29,7 +30,9 @@
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.node.ObjectNode;
import com.github.copilot.generated.AssistantMessageEvent;
+import com.github.copilot.generated.ExternalToolCompletedEvent;
import com.github.copilot.generated.rpc.SessionCommandsHandlePendingCommandParams;
import com.github.copilot.generated.rpc.SessionLogParams;
import com.github.copilot.generated.rpc.SessionLogLevel;
@@ -37,6 +40,8 @@
import com.github.copilot.generated.rpc.ModelCapabilitiesOverride;
import com.github.copilot.generated.rpc.ModelCapabilitiesOverrideLimits;
import com.github.copilot.generated.rpc.ModelCapabilitiesOverrideSupports;
+import com.github.copilot.generated.rpc.SessionModelSwitchAutoTierParams;
+import com.github.copilot.generated.rpc.SessionModelSwitchAutoTierResult;
import com.github.copilot.generated.rpc.SessionModelSwitchToParams;
import com.github.copilot.generated.rpc.SessionPermissionsHandlePendingPermissionRequestParams;
import com.github.copilot.generated.rpc.SessionRpc;
@@ -184,6 +189,8 @@ public final class CopilotSession implements AutoCloseable {
private volatile SessionRpc sessionRpc;
private final Set> eventHandlers = ConcurrentHashMap.newKeySet();
private final Map toolHandlers = new ConcurrentHashMap<>();
+ private final Map pendingExternalTools = new ConcurrentHashMap<>();
+ private boolean externalToolsClosed;
private final Map commandHandlers = new ConcurrentHashMap<>();
private final Map bearerTokenProviders = new ConcurrentHashMap<>();
private final AtomicReference permissionHandler = new AtomicReference<>();
@@ -204,6 +211,46 @@ public final class CopilotSession implements AutoCloseable {
/** Tracks whether this session instance has been terminated via close(). */
private volatile boolean isTerminated = false;
+ private static final class PendingExternalTool {
+ private static final int WAITING = 0;
+ private static final int STARTED = 1;
+ private static final int CANCELLED = 2;
+
+ private final AtomicInteger state = new AtomicInteger(WAITING);
+ private final AtomicReference> future = new AtomicReference<>();
+
+ T join(CompletableFuture operation) {
+ future.set(operation);
+ if (state.get() == CANCELLED) {
+ operation.cancel(true);
+ }
+ try {
+ return operation.join();
+ } finally {
+ future.compareAndSet(operation, null);
+ }
+ }
+
+ boolean tryStart() {
+ return state.compareAndSet(WAITING, STARTED);
+ }
+
+ void attach(CompletableFuture