Port exit-plan-mode and auto-mode-switch handler APIs from reference implementation

[Copilot]

Resolves #179

---

Before the change?

• Java SDK was 15 commits behind the reference implementation (066a69c..4a0437b)
• No support for exitPlanMode or autoModeSwitch handler APIs (added in ref-impl 671b50a)
• @github/copilot pinned at previous version

After the change?

• New handler types — ExitPlanModeHandler, AutoModeSwitchHandler following existing @FunctionalInterface patterns (8 new files: handler, request, result/response, invocation for each)
• Session lifecycle — SessionConfig/ResumeSessionConfig gain onExitPlanMode and onAutoModeSwitch fields; CopilotSession handles registration, dispatch, and cleanup
• RPC wiring — RpcHandlerDispatcher registers exitPlanMode.request and autoModeSwitch.request; SessionRequestBuilder sets requestExitPlanMode/requestAutoModeSwitch capability flags when handlers are present
• Defaults — no handler → auto-approve exit plan mode (approved=true), decline auto mode switch (NO)
• Finish script — .lastmerge → 4a0437bb, pom.xml and codegen synced to @github/copilot@^1.0.44-3

var session = client.createSession(new SessionConfig()
    .setOnExitPlanMode((request, invocation) -> {
        System.out.println("Plan: " + request.getSummary());
        return CompletableFuture.completedFuture(
            new ExitPlanModeResult().setApproved(true).setSelectedAction("interactive"));
    })
    .setOnAutoModeSwitch((request, invocation) -> {
        return CompletableFuture.completedFuture(AutoModeSwitchResponse.YES);
    })).get();

Skipped commits (not applicable to Java): Rust SDK (4a0437b, 8794594, 55b3b1c, b0d1c8e), Go SDK (d5c8db4, 30a76a5, 4901dff), CI workflows (97f505c, 299ea21), .NET enums (e759700), E2E snapshots (f625779), doc typos (ce56eb8 — no matches in Java docs), Maven badge (f72bf0f — already present), Node pkg update (ac55e9a — handled by finish script).

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

---

[github-actions]

---

Warning

The push_to_pull_request_branch operation failed: Pull request is missing required labels: dependencies. Current labels: . The code changes were not applied.

Codegen Fix Applied ✅

Fixed 3 compilation errors in SessionEventHandlingTest.java caused by record arity changes in the updated schemas:

SessionStartEventData gained 1 new field (detachedFromSpawningParentSessionId): arity 10 → 11

AssistantMessageEventData gained 3 new fields (anthropicAdvisorModel, turnId, parentToolCallId): arity 12 → 15

All three constructor call sites in the test were updated to pass the correct number of null arguments. No code generator changes were needed — the generator already handles these schema additions correctly; only the handwritten test code needed updating.

Warning

⚠️ Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• repo.maven.apache.org

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "repo.maven.apache.org"

See Network Configuration for more information.

Generated by Codegen Agentic Fix · ● 2.4M · ◷

[Copilot]

Pull request overview

Ports the reference implementation’s “mode handler” callback APIs into the Java SDK, wiring them through session configuration, JSON-RPC dispatch, and session lifecycle handling so Java hosts can respond to exitPlanMode and autoModeSwitch requests.

Changes:

• Added ExitPlanMode* and AutoModeSwitch* handler/request/response/invocation types and exposed them on SessionConfig / ResumeSessionConfig.
• Wired new RPC callbacks (exitPlanMode.request, autoModeSwitch.request) through RpcHandlerDispatcher, SessionRequestBuilder, and CopilotSession.
• Updated docs and tests, plus synced reference-impl metadata and codegen inputs/outputs.

Show a summary per file

File	Description
src/main/java/com/github/copilot/sdk/CopilotSession.java	Stores/clears mode handlers and dispatches requests with default behaviors when absent.
src/main/java/com/github/copilot/sdk/RpcHandlerDispatcher.java	Registers and handles the new incoming RPC request methods for mode handlers.
src/main/java/com/github/copilot/sdk/SessionRequestBuilder.java	Sets capability flags and registers handlers when present in session configs.
src/main/java/com/github/copilot/sdk/json/SessionConfig.java	Adds onExitPlanMode / onAutoModeSwitch config hooks and clones them.
src/main/java/com/github/copilot/sdk/json/ResumeSessionConfig.java	Adds onExitPlanMode / onAutoModeSwitch config hooks and clones them.
src/main/java/com/github/copilot/sdk/json/CreateSessionRequest.java	Adds requestExitPlanMode / requestAutoModeSwitch request flags.
src/main/java/com/github/copilot/sdk/json/ResumeSessionRequest.java	Adds requestExitPlanMode / requestAutoModeSwitch request flags.
src/main/java/com/github/copilot/sdk/json/ExitPlanModeHandler.java	New functional interface for exit-plan-mode requests.
src/main/java/com/github/copilot/sdk/json/ExitPlanModeInvocation.java	New invocation context for exit-plan-mode handlers.
src/main/java/com/github/copilot/sdk/json/ExitPlanModeRequest.java	New request DTO for exit-plan-mode callbacks.
src/main/java/com/github/copilot/sdk/json/ExitPlanModeResult.java	New result DTO returned to the CLI for exit-plan-mode decisions.
src/main/java/com/github/copilot/sdk/json/AutoModeSwitchHandler.java	New functional interface for auto-mode-switch requests.
src/main/java/com/github/copilot/sdk/json/AutoModeSwitchInvocation.java	New invocation context for auto-mode-switch handlers.
src/main/java/com/github/copilot/sdk/json/AutoModeSwitchRequest.java	New request DTO for auto-mode-switch callbacks.
src/main/java/com/github/copilot/sdk/json/AutoModeSwitchResponse.java	New wire enum for auto-mode-switch decisions.
src/test/java/com/github/copilot/sdk/ModeHandlersTest.java	New E2E coverage for both handler APIs.
src/test/java/com/github/copilot/sdk/SessionRequestBuilderTest.java	Unit tests ensuring capability flags are set/omitted and serializable.
src/test/java/com/github/copilot/sdk/ConfigCloneTest.java	Verifies handler fields are preserved by config cloning.
src/test/java/com/github/copilot/sdk/SessionEventHandlingTest.java	Updates test event construction to match regenerated event record shapes.
src/site/markdown/advanced.md	Documents both mode handler APIs with examples and default behavior.
src/generated/java/com/github/copilot/sdk/generated/AssistantMessageEvent.java	Regenerated event type with additional fields.
src/generated/java/com/github/copilot/sdk/generated/SessionStartEvent.java	Regenerated event type with an additional field.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsApi.java	Regenerated RPC API including respondToQueuedCommand.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsRespondToQueuedCommandParams.java	New generated params record.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsRespondToQueuedCommandResult.java	New generated result record.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionTasksApi.java	Regenerated RPC API including sendMessage.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionTasksSendMessageParams.java	New generated params record.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionTasksSendMessageResult.java	New generated result record.
src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceResult.java	Regenerated schema removing fields/types no longer present.
scripts/codegen/package.json	Bumps the @github/copilot dependency range used for schema/codegen.
scripts/codegen/package-lock.json	Updates locked Node dependencies for code generation.
pom.xml	Updates the recorded reference-impl @github/copilot version range.
.lastmerge	Advances the recorded reference implementation sync commit.

Copilot's findings

Files not reviewed (1)

• scripts/codegen/package-lock.json: Language not supported

• Files reviewed: 23/33 changed files
• Comments generated: 0