Upstream sync: post-v1.0.0-beta.4 round 5 (schema 1.0.52, #1378, #1377, #1393, #1405)

[krukow]

Syncs copilot-sdk-clojure with upstream github/copilot-sdk through commit e89a8914.

Upstream commits

Commit	PR	Status	Notes
e89a8914	#1393	Ported	Schema bump 1.0.52-1 → 1.0.52-4. Adds mcp_app.tool_call_complete event (SEP-1865) and several optional event-data fields.
24d5ff64	#1378	Ported — BREAKING	Drops v2 protocol back-compat. Minimum supported protocol version is now 3.
85d91caa	#1377	Ported	Adds runtime_instructions system message section. Upstream also renamed SystemPromptSection → SystemMessageSection; Clojure side adds aliases and keeps existing name.
d99871cf	#1359	Skipped	Java/TS-internal: x-opaque-json mapping annotations only.
0c7886c7	#1379	Skipped	TS E2E flaky test fixes.
dbe9d27d	#1367	Skipped	Rust SDK only.

Changes

BREAKING

• Minimum protocol version raised from 2 to 3. The SDK now rejects CLI servers reporting protocol version 2. Removes the v2 tool.call / permission.request RPC dispatcher cases and the v2 tool.call arguments escape hatch from protocol/normalize-incoming. v3 broadcast handlers cover the same behaviour. Requires Copilot CLI 1.0.46 or later.

Added

• :runtime-instructions system message section (wire: runtime_instructions)
• specs/system-message-sections and ::specs/system-message-section aliases
• :copilot/mcp_app.tool_call_complete in sdk/event-types and ::specs/event-type
• protocol/preserve-event-opaque-fields case for mcp_app.tool_call_complete so :arguments and :result keep source-defined keys verbatim
• Passive opt-un coverage (via schema regen) for: :service-request-id, :context-tier, :transport/:plugin-name/:plugin-version, :error on mcp-server-status, :source/:trigger, :tool-description/:ui-resource

Removed

• 7 v2-only deftests (replaced by v3 broadcast tests)

Tests

• 8 new red/green tests covering each schema 1.0.52-4 addition and the v3 minimum-protocol-version rejection
• Mock server gained a per-instance :protocol-version atom so a negative test can configure a v2 server

Validation

• bb test — 275 tests, 1319 assertions, 0 failures, 0 errors
• bb validate-docs — 13 files, 0 warnings

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

[Copilot]

Pull request overview

Syncs the Clojure SDK with upstream github/copilot-sdk through commit e89a8914, including a schema bump to 1.0.52-4, adding new session event coverage, and applying the upstream breaking change that drops protocol v2 back-compat (minimum protocol version is now 3).

Changes:

• Bump pinned schemas to 1.0.52-4 and regenerate wire event specs, adding mcp_app.tool_call_complete plus multiple optional event-data fields.
• Add :runtime-instructions system message section and introduce system-message-sections / ::system-message-section aliases while preserving existing system-prompt-* names.
• Remove v2 server→client RPC back-compat (tool/permission) and update client/mock server + integration tests to enforce protocol version ≥ 3.

Show a summary per file

File	Description
test/github/copilot_sdk/mock_server.clj	Adds per-server configurable :protocol-version and defaults mock protocol to v3 for new minimum-version behavior.
test/github/copilot_sdk/integration_test.clj	Updates ping/status assertions to v3, removes v2-only dispatcher tests, and adds schema 1.0.52-4 + min-protocol-version coverage.
src/github/copilot_sdk/util.clj	Extends system section keyword↔wire mapping to include :runtime-instructions (runtime_instructions).
src/github/copilot_sdk/specs.clj	Adds :runtime-instructions to section specs and introduces system-message-* aliases for the upstream rename.
src/github/copilot_sdk/protocol.clj	Adds opaque-field preservation for mcp_app.tool_call_complete and removes v2 tool.call argument preservation path.
src/github/copilot_sdk/generated/event_specs.clj	Regenerated schema-driven event specs for 1.0.52-4 (new event + opt fields).
src/github/copilot_sdk/client.clj	Raises min protocol version to 3 and removes v2 RPC dispatcher cases from the request handler.
src/github/copilot_sdk.clj	Adds :copilot/mcp_app.tool_call_complete to the public event-types set.
schemas/session-events.schema.json	Updates upstream session event schema with new event + new optional properties.
schemas/README.md	Updates pinned schema version text to 1.0.52-4.
schemas/api.schema.json	Updates upstream API schema (incl. MCP Apps API surface + other schema tweaks).
doc/reference/API.md	Documents new event type and updates system section examples/notes (but currently has a key list mismatch—see PR comments).
CHANGELOG.md	Adds Unreleased entries describing the sync, including the breaking protocol v3 minimum and schema-driven additions.
.copilot-schema-version	Bumps pinned schema version from 1.0.52-1 to 1.0.52-4.

Copilot's findings

Comments suppressed due to low confidence (1)

src/github/copilot_sdk/util.clj:72

• wire->section-key's docstring still says "system prompt sections", but the surrounding mapping and specs have moved to the "system message sections" terminology. Consider updating this docstring for consistency (and to avoid confusion with the upstream rename).

   :last-instructions    "last_instructions"})

(def wire->section-key
  "Map from wire string to Clojure keyword for system prompt sections."
  (into {} (map (fn [[k v]] [v k])) section-key->wire))

• Files reviewed: 13/14 changed files
• Comments generated: 1

[krukow]

Fixed in 78f6464. Both the 'Customize Mode' table (lines 1709-1722) and the 'Available section keys' paragraph (line 1764) now mirror github.copilot-sdk.specs/system-prompt-sections verbatim — eleven sections including :tool-efficiency, :environment-context, :code-change-rules, :guidelines, :tool-instructions, :custom-instructions, :runtime-instructions (PR #1377), and :last-instructions. The previously documented :proactiveness/:formatting/:tools/:context-collection/:task-management/:agent-mode/:additional-instructions keys (which never matched the spec) are removed. Section count corrected from 'Ten' to 'Eleven'.