Port SetForegroundSessionRequest bug fix and add COPILOT_HOME to test harness

Agent-Logs-Url: https://github.com/github/copilot-sdk-java/sessions/a61a1c47-9550-486c-800b-6deeeadaadbf

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

Author: Copilot

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;