Merge reference implementation SDK changes (2026-04-30)

.lastmerge

@@ -1 +1 @@
-dd2dcbc439256acfb9feb2cff07c0b9c820091b8
+e42b726ca42bd1b2e099a956c9287ba9435ba3e5

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.36-0</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.40-0</readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync>
 
     </properties>
 

scripts/codegen/package.json

@@ -7,7 +7,7 @@
     "generate:java": "tsx java.ts"
   },
   "dependencies": {
-    "@github/copilot": "^1.0.39",
+    "@github/copilot": "^1.0.40-0",
     "json-schema": "^0.4.0",
     "tsx": "^4.20.6"
   }

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

@@ -744,18 +744,15 @@ public CompletableFuture<String> getForegroundSessionId() {
      *             if the operation fails
      */
     public CompletableFuture<Void> setForegroundSessionId(String sessionId) {
-        return ensureConnected()
-                .thenCompose(
-                        connection -> connection.rpc
-                                .invoke("session.setForeground", Map.of("sessionId", sessionId),
-                                        com.github.copilot.sdk.json.SetForegroundSessionResponse.class)
-                                .thenAccept(response -> {
-                                    if (!response.success()) {
-                                        throw new RuntimeException(response.error() != null
-                                                ? response.error()
-                                                : "Failed to set foreground session");
-                                    }
-                                }));
+        return ensureConnected().thenCompose(connection -> connection.rpc
+                .invoke("session.setForeground", new com.github.copilot.sdk.json.SetForegroundSessionRequest(sessionId),
+                        com.github.copilot.sdk.json.SetForegroundSessionResponse.class)
+                .thenAccept(response -> {
+                    if (!response.success()) {
+                        throw new RuntimeException(
+                                response.error() != null ? response.error() : "Failed to set foreground session");
+                    }
+                }));
     }
 
     /**

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

@@ -0,0 +1,20 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Request body for session.setForeground RPC call.
+ * <p>
+ * Using an explicit record type (rather than an ad-hoc map) ensures correct
+ * JSON serialization in all execution environments.
+ *
+ * @since 1.0.0
+ */
+public record SetForegroundSessionRequest(
+        /** The session ID to bring to the foreground. */
+        @JsonProperty("sessionId") String sessionId) {
+}

src/test/java/com/github/copilot/sdk/DataObjectCoverageTest.java

@@ -18,6 +18,7 @@
 import com.github.copilot.sdk.json.PreToolUseHookInput;
 import com.github.copilot.sdk.json.PreToolUseHookOutput;
 import com.github.copilot.sdk.json.SectionOverride;
+import com.github.copilot.sdk.json.SetForegroundSessionRequest;
 import com.github.copilot.sdk.json.SetForegroundSessionResponse;
 import com.github.copilot.sdk.json.ToolBinaryResult;
 import com.github.copilot.sdk.json.ToolResultObject;
@@ -86,6 +87,14 @@ void getForegroundSessionResponseRecord() {
         assertEquals("/home/user/project", response.workspacePath());
     }
 
+    // ===== SetForegroundSessionRequest record =====
+
+    @Test
+    void setForegroundSessionRequestRecord() {
+        var request = new SetForegroundSessionRequest("session-123");
+        assertEquals("session-123", request.sessionId());
+    }
+
     // ===== SetForegroundSessionResponse record =====
 
     @Test

src/test/java/com/github/copilot/sdk/E2ETestContext.java

@@ -249,6 +249,7 @@ public List<Map<String, Object>> getExchanges() throws IOException, InterruptedE
     public Map<String, String> getEnvironment() {
         Map<String, String> env = new HashMap<>(System.getenv());
         env.put("COPILOT_API_URL", proxyUrl);
+        env.put("COPILOT_HOME", homeDir.toString());
         env.put("XDG_CONFIG_HOME", homeDir.toString());
         env.put("XDG_STATE_HOME", homeDir.toString());
         return env;