Port upstream v0.2.1: commands, UI elicitation, COPILOT_CLI_PATH

[krukow]

Summary

Port upstream copilot-sdk changes from v0.2.0 → v0.2.1-preview.1 (PR #906 and related).

Changes

Commands Support

• New :commands option in session config for registering slash commands
• Each command definition: {:name "deploy" :description "Deploy" :command-handler (fn [ctx] ...)}
• Commands sent on wire (name + description only), handlers stored locally
• command.execute broadcast event routing with handlePendingCommand RPC callback
• Error handling for unknown commands and handler exceptions

UI Elicitation Convenience API

• capabilities — accessor for host capabilities from session create/resume response
• elicitation-supported? — predicate checking {:ui {:elicitation true}}
• confirm! — boolean confirmation dialog
• select! — selection from options, returns string or nil
• input! — text input with options, returns string or nil
• ui-elicitation! promoted from experimental, now asserts elicitation support

Other

• COPILOT_CLI_PATH env var — fallback for CLI path resolution when no explicit :cli-path or :cli-url
• session.custom_agents_updated event type added
• Version bump to 0.2.1.0

Files Changed (11 files, +668/-24)

• specs.clj — command, capabilities, elicitation specs
• session.clj — command handling, elicitation convenience API
• client.clj — wire format, capabilities, event routing, CLI path env var
• copilot_sdk.clj — public API delegates, event type sets
• instrument.clj — fdefs for 6 new functions
• integration_test.clj — 8 new tests
• mock_server.clj — handlePendingCommand support, hook response merging
• API.md — Commands section, UI Elicitation section, updated tables
• CHANGELOG.md — v0.2.1 sync entries
• build.clj / README.md — version bump

Testing

• ✅ 106 tests, 361 assertions (including E2E), 0 failures
• ✅ Documentation valid, 0 warnings
• ✅ All examples pass
• ✅ JAR builds successfully

[Copilot]

Pull request overview

Ports upstream copilot-sdk changes from v0.2.0 → v0.2.1-preview.1 into the Clojure SDK, adding new session features (commands, UI elicitation helpers) and a CLI path resolution fallback.

Changes:

• Add per-session slash command registration (:commands) and route command.execute v3 broadcast events to local handlers with handlePendingCommand RPC responses.
• Add UI elicitation convenience APIs (capabilities, elicitation-supported?, confirm!, select!, input!) and promote ui-elicitation! to non-experimental with support assertions.
• Add COPILOT_CLI_PATH environment-variable fallback for resolving the CLI executable when :cli-path/:cli-url aren’t explicitly provided, plus version/docs/changelog updates.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
test/github/copilot_sdk/mock_server.clj	Adds mock support for session.commands.handlePendingCommand and allows request hooks to merge response data.
test/github/copilot_sdk/integration_test.clj	Adds integration coverage for commands-on-wire, v3 command execution routing/errors, and capabilities/elicitation guards.
src/github/copilot_sdk/specs.clj	Introduces new specs for commands, capabilities, and elicitation/input options; expands session config keys; adds new event type.
src/github/copilot_sdk/session.clj	Stores command handlers + capabilities in session state; implements v3 command execution handler and UI elicitation helpers.
src/github/copilot_sdk/instrument.clj	Adds fdefs/instrumentation entries for new public session APIs and tightens ui-elicitation! arg spec.
src/github/copilot_sdk/client.clj	Adds COPILOT_CLI_PATH fallback, wires :commands onto create/resume params, and routes v3 command.execute broadcast events.
src/github/copilot_sdk.clj	Exposes new UI elicitation functions from the public facade and adds session.custom_agents_updated to event sets.
doc/reference/API.md	Documents commands and UI elicitation APIs; updates client option docs for COPILOT_CLI_PATH fallback; adds new event type.
build.clj	Bumps library version to 0.2.1.0.
README.md	Updates dependency version to 0.2.1.0.
CHANGELOG.md	Adds v0.2.1 sync notes under [Unreleased].

Comments suppressed due to low confidence (2)

test/github/copilot_sdk/integration_test.clj:1320

• Same issue here: (.await rpc-latch ...) return value isn’t asserted. If the latch times out, the test may still pass depending on later assertions; assert the boolean result so the test fails fast on timeout.

      (.await rpc-latch 5 java.util.concurrent.TimeUnit/SECONDS)
      (let [cmd-rpcs (filter #(= "session.commands.handlePendingCommand" (:method %)) @requests)]
        (is (= 1 (count cmd-rpcs)))

test/github/copilot_sdk/integration_test.clj:1290

• Same issue here: (.await rpc-latch ...) return value isn’t asserted, so a timeout won’t necessarily fail the test. Assert the return value to make the test reliably catch missing/late RPCs.

      (.await rpc-latch 5 java.util.concurrent.TimeUnit/SECONDS)
      (let [cmd-rpcs (filter #(= "session.commands.handlePendingCommand" (:method %)) @requests)]
        (is (= 1 (count cmd-rpcs)))

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

Comments suppressed due to low confidence (1)

src/github/copilot_sdk/client.clj:1292

• Same as above: wire-commands for resume currently emits :description nil for commands without descriptions, which will serialize to null. Prefer omitting :description when absent to keep wire payloads consistent with other optional fields and reduce risk of protocol validation differences.

        wire-commands (when-let [cmds (:commands config)]
                        (mapv (fn [c] {:name (:name c)
                                       :description (:description c)})
                              cmds))]

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.