Upstream sync: copilot-sdk v1.0.0-beta.12 (schema 1.0.57)

[krukow]

_{Generated via Copilot on behalf of @krukow}

Syncs the Clojure SDK from upstream github/copilot-sdk v1.0.0-beta.10 (schema 1.0.56-1 + PR #1428) up to v1.0.0-beta.12 / npm @github/copilot ^1.0.57.

Changes

• feat(session) — :context-tier (:default / :long-context) and :reasoning-summary ("none" / "concise" / "detailed") on switch-model! / set-model!, matching the upstream setModel() API (upstream PR #1522). context-tier->wire moved from client.clj (private) to util.clj (shared, avoids a circular dependency). fdefs + specs updated.
• feat(events) — :model optional field on ::tool.execution_start-data (npm 1.0.57, mirroring ::tool.execution_complete-data); preserve opaque :payload on extension_context attachments (reachable on user.message via session.getMessages and on session.extensions.attachments_pushed) so wire->clj doesn't kebab-case caller-supplied keys.
• chore(codegen) — schema bump 1.0.56-1 → 1.0.57; regenerated event_specs.clj (new session.extensions.attachments_pushed event, extension_context attachment branch) (upstream PR #1517).
• chore(release) — version 1.0.0-beta.4.1 → 1.0.0-beta.12.0.
• docs — doc/reference/API.md + CHANGELOG.md.

contextTier wire semantics

Unlike create/resume config patching, switch-model! omits contextTier when :context-tier is nil rather than sending contextTier: null — upstream setModel spreads ...options (drops undefined) and ModelSwitchToRequest.contextTier has no null variant in the schema ("omit this field"). Caught by multi-model review (see below).

Validation

• bb test — 344 tests / 1597 assertions, 0 failures (instrumented).
• bb validate-docs ✓ · bb jar ✓ (1.0.0-beta.12.0) · ./run-all-examples.sh ✓ (real E2E).
• bb codegen output committed and stable (no drift).

Multi-model review (Claude Opus 4.8 + GPT-5.3-codex)

#	Finding	Source	Severity	Decision
1	switch-model! sent contextTier: null for :context-tier nil; switchTo schema has no null tier	GPT	Medium	Valid — fixed (omit-when-nil) + test added
2	restore-extension-context-payloads mapv could truncate on length mismatch	GPT	High	False positive — raw/converted attachment vectors are the same event pre/post wire->clj, which preserves count/order (confirmed by Opus)
3	Full review of wire/spec/test/idioms	Opus	—	No significant issues; both notification + getMessages paths and event-type coverage confirmed

Out of scope (API parity / existing surface)

• extensionSdkPath / canvas-extension host config — Clojure has intentionally not ported the cohesive extension/canvas host surface; exposing only extensionSdkPath would be inert/misleading.
• suppressCustomAgentPrompt (rpc field not in Node public config), brand-casing cosmetics (TS identifiers; wire unchanged), disableResume wire fix (Clojure already correct).
• The pre-existing inbound-attachment idiom-spec :type keyword/string mismatch is tracked separately.

This PR is backed by a session plan.md (commit classification table + scope decisions); its contents are reflected in the sections above.

[Copilot]

Pull request overview

Syncs the Clojure Copilot SDK to upstream v1.0.0-beta.12 (schema 1.0.57), extending model-switch options for parity with upstream setModel() and updating event/schema handling for new attachment and event shapes.

Changes:

• Add :context-tier and :reasoning-summary support to switch-model! / set-model!, including correct wire encoding and omit-when-nil behavior for contextTier.
• Extend event/spec support for schema 1.0.57, including optional :model on tool.execution_start and generated support for session.extensions.attachments_pushed.
• Preserve opaque extension_context attachment :payload during wire->clj normalization so caller-supplied keys are not kebab-cased.

Show a summary per file

File	Description
test/github/copilot_sdk/integration_test.clj	Adds regression/coverage tests for :model in tool start events, extension attachment payload preservation, and contextTier semantics in model switching.
src/github/copilot_sdk/util.clj	Introduces shared context-tier->wire mapping to produce correct underscore wire values.
src/github/copilot_sdk/specs.clj	Updates curated specs to allow optional :model on ::tool.execution_start-data.
src/github/copilot_sdk/session.clj	Forwards reasoningSummary and contextTier on session.model.switchTo, omitting contextTier when unset.
src/github/copilot_sdk/protocol.clj	Restores opaque extension_context attachment payloads post-wire->clj for both live and historical event paths.
src/github/copilot_sdk/instrument.clj	Extends fdefs for switch-model! / set-model! to include :reasoning-summary and :context-tier.
src/github/copilot_sdk/generated/event_specs.clj	Regenerates wire event specs for schema 1.0.57 (new event type + updated fields).
src/github/copilot_sdk/client.clj	Routes :context-tier wire conversion through util/context-tier->wire (avoids circular deps).
schemas/session-events.schema.json	Bumps pinned upstream session-events schema and incorporates new attachment/event definitions.
schemas/api.schema.json	Bumps pinned upstream API schema (new RPCs/types, updated contextTier semantics, attachment unification).
schemas/README.md	Updates pinned schema version note to 1.0.57.
.copilot-schema-version	Updates the pinned schema version to 1.0.57.
doc/reference/API.md	Documents the new switch-model! options and the new optional :model event field.
CHANGELOG.md	Adds v1.0.0-beta.12 sync notes for added/fixed/changed behavior.
README.md	Updates dependency version to 1.0.0-beta.12.0.
build.clj	Bumps project version to 1.0.0-beta.12.0.

Copilot's findings

• Files reviewed: 14/16 changed files
• Comments generated: 0