Port copilot-sdk-java PR #232: reference-impl-sync with EMPTY mode fixes (#1473)

* Port copilot-sdk-java PR #232: reference-impl-sync with EMPTY mode fixes

Copy non-pom changes from github/copilot-sdk-java PR #232:
- EMPTY mode validation in CopilotClient (CopilotHome/CliUrl check)
- resumeSession() validates availableTools in EMPTY mode
- Null-safe hook handler dispatch (prevents NPE on null futures)
- SessionConfig/ResumeSessionConfig Javadoc corrections
- CopilotClientMode enum and BuiltInTools/ToolSet helpers
- PostToolUseFailure hook handler types
- AgentMode updates
- Updated generated files to schema ^1.0.55-5
- Updated .lastmerge to 6010405
- Updated codegen package.json/package-lock.json
- Updated CLI version property to ^1.0.55-5

* Fix session registry leak when server re-keys session ID

When the server returns a different sessionId and a subsequent step
(e.g. updateSessionOptionsForMode) fails, the exceptionally blocks
only removed the original sessionId from the sessions map, leaving
the re-keyed entry behind as a stale/closed session.

Fix: remove both the original and the active (possibly re-keyed)
session ID in createSession/resumeSession exceptionally blocks, and
unregister the session from the registry in updateSessionOptionsForMode
before closing it.

Addresses review comments on PR #1473.

Author: edburns

java/.lastmerge

@@ -1 +1 @@
-f4d22d70016c377881d86e4c77f8a3f93746ffae
+60104052cd914949ddf8c7a31e1856cd6db0a57c

java/pom.xml

@@ -94,7 +94,7 @@
             reference-impl-sync workflow and deal with the subsequent
             PR.
         -->
-        <readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync>^1.0.52-1</readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync>
+        <readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync>^1.0.55-5</readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync>
 
     </properties>
 

java/scripts/codegen/package-lock.json

@@ -7,7 +7,7 @@
     "generate:java": "tsx java.ts"
   },
   "dependencies": {
-    "@github/copilot": "^1.0.52-1",
+    "@github/copilot": "^1.0.55-5",
     "json-schema": "^0.4.0",
     "tsx": "^4.20.6"
   }

java/scripts/codegen/package.json

@@ -58,6 +58,8 @@ public record AssistantMessageEventData(
         @JsonProperty("interactionId") String interactionId,
         /** GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs */
         @JsonProperty("requestId") String requestId,
+        /** Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */
+        @JsonProperty("serviceRequestId") String serviceRequestId,
         /** Raw Anthropic content array with advisor blocks (server_tool_use, advisor_tool_result) for verbatim round-tripping */
         @JsonProperty("anthropicAdvisorBlocks") List<Object> anthropicAdvisorBlocks,
         /** Anthropic advisor model ID used for this response, for timeline display on replay */

java/src/generated/java/com/github/copilot/generated/AssistantMessageEvent.java

@@ -62,6 +62,8 @@ public record AssistantUsageEventData(
         @JsonProperty("apiCallId") String apiCallId,
         /** GitHub request tracing ID (x-github-request-id header) for server-side log correlation */
         @JsonProperty("providerCallId") String providerCallId,
+        /** Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */
+        @JsonProperty("serviceRequestId") String serviceRequestId,
         /** API endpoint used for this model call, matching CAPI supported_endpoints vocabulary */
         @JsonProperty("apiEndpoint") AssistantUsageApiEndpoint apiEndpoint,
         /** Parent tool call ID when this usage originates from a sub-agent */

java/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java

@@ -0,0 +1,37 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: session-events.schema.json
+
+package com.github.copilot.generated;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * The type of operation performed on the autopilot objective state file
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum AutopilotObjectiveChangedOperation {
+    /** The {@code create} variant. */
+    CREATE("create"),
+    /** The {@code update} variant. */
+    UPDATE("update"),
+    /** The {@code delete} variant. */
+    DELETE("delete");
+
+    private final String value;
+    AutopilotObjectiveChangedOperation(String value) { this.value = value; }
+    @com.fasterxml.jackson.annotation.JsonValue
+    public String getValue() { return value; }
+    @com.fasterxml.jackson.annotation.JsonCreator
+    public static AutopilotObjectiveChangedOperation fromValue(String value) {
+        for (AutopilotObjectiveChangedOperation v : values()) {
+            if (v.value.equals(value)) return v;
+        }
+        throw new IllegalArgumentException("Unknown AutopilotObjectiveChangedOperation value: " + value);
+    }
+}

java/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedOperation.java

@@ -0,0 +1,39 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: session-events.schema.json
+
+package com.github.copilot.generated;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Current autopilot objective status, if one exists
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum AutopilotObjectiveChangedStatus {
+    /** The {@code active} variant. */
+    ACTIVE("active"),
+    /** The {@code paused} variant. */
+    PAUSED("paused"),
+    /** The {@code cap_reached} variant. */
+    CAP_REACHED("cap_reached"),
+    /** The {@code completed} variant. */
+    COMPLETED("completed");
+
+    private final String value;
+    AutopilotObjectiveChangedStatus(String value) { this.value = value; }
+    @com.fasterxml.jackson.annotation.JsonValue
+    public String getValue() { return value; }
+    @com.fasterxml.jackson.annotation.JsonCreator
+    public static AutopilotObjectiveChangedStatus fromValue(String value) {
+        for (AutopilotObjectiveChangedStatus v : values()) {
+            if (v.value.equals(value)) return v;
+        }
+        throw new IllegalArgumentException("Unknown AutopilotObjectiveChangedStatus value: " + value);
+    }
+}

java/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedStatus.java

@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: session-events.schema.json
+
+package com.github.copilot.generated;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Runtime-controlled routing state for the instance. "ready" when the provider connection is live; "stale" when the provider has gone away and the instance is awaiting rebinding.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum CanvasOpenedAvailability {
+    /** The {@code ready} variant. */
+    READY("ready"),
+    /** The {@code stale} variant. */
+    STALE("stale");
+
+    private final String value;
+    CanvasOpenedAvailability(String value) { this.value = value; }
+    @com.fasterxml.jackson.annotation.JsonValue
+    public String getValue() { return value; }
+    @com.fasterxml.jackson.annotation.JsonCreator
+    public static CanvasOpenedAvailability fromValue(String value) {
+        for (CanvasOpenedAvailability v : values()) {
+            if (v.value.equals(value)) return v;
+        }
+        throw new IllegalArgumentException("Unknown CanvasOpenedAvailability value: " + value);
+    }
+}

java/src/generated/java/com/github/copilot/generated/CanvasOpenedAvailability.java

@@ -0,0 +1,41 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: session-events.schema.json
+
+package com.github.copilot.generated;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+import java.util.Map;
+import javax.annotation.processing.Generated;
+
+/**
+ * Schema for the `CanvasRegistryChangedCanvas` type.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record CanvasRegistryChangedCanvas(
+    /** Owning provider identifier */
+    @JsonProperty("extensionId") String extensionId,
+    /** Owning extension display name, when available */
+    @JsonProperty("extensionName") String extensionName,
+    /** Provider-local canvas identifier */
+    @JsonProperty("canvasId") String canvasId,
+    /** Human-readable canvas name */
+    @JsonProperty("displayName") String displayName,
+    /** Short, single-sentence description shown to the agent in canvas catalogs. */
+    @JsonProperty("description") String description,
+    /** JSON Schema for canvas open input */
+    @JsonProperty("inputSchema") Map<String, Object> inputSchema,
+    /** Actions the agent or host may invoke */
+    @JsonProperty("actions") List<CanvasRegistryChangedCanvasAction> actions
+) {
+}