Port reference implementation SDK changes (2026-05-04)

[Copilot]

Resolves #298

---

Before the change?

• Java SDK was missing features added in reference implementation commits e42b726→e8dabaf (14 commits): configurable data directory, TCP connection token, instruction directories, continue-pending-work on resume, and MCP OAuth fields.

After the change?

• copilotHome on CopilotClientOptions — sets COPILOT_HOME env var on spawned CLI process
• tcpConnectionToken on CopilotClientOptions — sets COPILOT_CONNECTION_TOKEN env var for TCP authentication
• instructionDirectories on SessionConfig and ResumeSessionConfig — additional directories for custom instruction files
• continuePendingWork on ResumeSessionConfig — continue pending tool calls/permission prompts on resume
• OAuth fields on McpHttpServerConfig — oauthClientId, oauthPublicClient, oauthGrantType

// Instruction directories example
var session = client.createSession(
    new SessionConfig()
        .setWorkingDirectory("/path/to/project")
        .setInstructionDirectories(List.of("/path/to/extra-instructions"))
        .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)
).get();

// TCP connection token example
var client = new CopilotClient(
    new CopilotClientOptions()
        .setUseStdio(false)
        .setTcpConnectionToken("my-secret-token")
        .setCopilotHome("/custom/copilot/data")
);

Not ported (intentionally):

• 155e887 Replace StreamJsonRpc — .NET-internal refactoring
• 6a0e065 Version update logic — tooling/workflow only
• npm package updates (e8dabaf, fcdd615, ffe4f01, 58ab82c, f8cf846) — handled by update-copilot-dependency.yml
• Python/Docker/CLI docs — not applicable

Pull request checklist

• Tests for the changes have been added (for bug fixes / features)
• Docs have been reviewed and added / updated if needed (for bug fixes / features)
• mvn spotless:apply has been run to format the code
• mvn clean verify passes locally

Does this introduce a breaking change?

• Yes
• No

---

[edburns]

Closing: the agent did not follow the deterministic scripts (merge-reference-impl-start.sh / finish.sh), resulting in missing .lastmerge update, codegen version sync, and pom.xml CLI version sync. The issue body prompt has been strengthened to prevent this. Will re-trigger after landing the fix.