Skip to content

feat: sync CLI 1.0.100-1 MCP and event contracts - #222

Merged
krukow merged 2 commits into
mainfrom
krukow-upstream-sdk-sync
Oct 19, 2026
Merged

krukow merged 2 commits into
mainfrom
krukow-upstream-sdk-sync

Conversation

@krukow

@krukow krukow commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator

Generated via Copilot on behalf of @krukow

Why

Sync the stable Node SDK surface through b96cd2b, corresponding to CLI 1.0.100-1.

Why does it matter

Hosts can delegate supported MCP credential renewal without confusing acceptance with completed recovery, distinguish connected servers from ready tools, and observe request-compression fallback. Startup directory configuration now documents the repository-hook trust it grants.

How

  • Add capability-gated :runtime-refresh, correct cancellation/token precedence, recovery/readiness events, and compression diagnostics across specs, fdefs, event sets, and the API snapshot.
  • Prove callback behavior across create/resume/join, live/history event contracts, and real-runtime hook scope and MCP readiness using isolated fixtures.
  • Regenerate schemas/docs deterministically and certify all 20 Node source modules, 873 package-root exports, and 122 changed upstream paths. Seal 79 local artifacts to the implementation commit without retargeting historical evidence.

Notes

  • Passed exact-pin upstream validation and bb ci:full on CLI 1.0.100-1, including E2E tests, all portable examples, documentation validation, and the JAR build. All generators produced identical outputs on repeat. GitHub CI and codegen checks passed.
  • Two independent reviews found no material issues. Copilot's first round reported no findings on the final head; it could not independently access upstream or run runtime validation. Those checks were performed locally, with exact-pin source validation also passing in CI. Three pre-existing documentation warnings remain.
  • New experimental and internal surfaces remain excluded. Library version stays 1.0.16.0; no release, tag, or deployment.

krukow and others added 2 commits October 19, 2026 09:49
Sync the stable Node surface at github/copilot-sdk@b96cd2b. Preserve experimental/internal exclusions and keep the library version unchanged.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 10751080-0767-4895-bfed-9f72f2b6982c
Pin the complete local artifact inventory to the validated implementation commit and verify it through immutable Git reads.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 10751080-0767-4895-bfed-9f72f2b6982c
Copilot AI balanced review requested due to automatic review settings October 19, 2026 08:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Exact-pin parity and runtime-sensitive behavior need human confirmation because upstream access and independent runtime validation were unavailable.

No open issues 🎉

What changed in this PR

Updates the Clojure SDK’s stable MCP and event contracts to match upstream snapshot b96cd2b and CLI 1.0.100-1.

Changes:

  • Adds capability-gated OAuth refresh, recovery/readiness events, and compression diagnostics.
  • Adds callback, event-contract, and runtime integration coverage.
  • Updates compatibility pins, API documentation, and repository-hook trust guidance.
File Description
test/​github/​copilot_sdk/​integration/​upstream_1_0_100_1_test.clj Tests OAuth precedence and event contracts.
test/​github/​copilot_sdk/​e2e_test.clj Tests repository hooks and MCP readiness.
test/​github/​copilot_sdk/​codegen_test.clj Adds new event fixtures.
src/​github/​copilot_sdk/​specs.clj Defines new public event fields and specs.
src/​github/​copilot_sdk/​session.clj Implements gated refresh and response precedence.
src/​github/​copilot_sdk/​instrument.clj Registers OAuth dispatcher validation.
src/​github/​copilot_sdk.clj Exposes new public events.
schemas/​README.md Updates schema provenance.
resources/​github/​copilot_sdk/​api_surface.edn Records expanded public contracts.
doc/​reference/​API.md Documents OAuth, diagnostics, readiness, and hook trust.
doc/​mcp/​overview.md Explains refresh delegation and tool readiness.
doc/​index.md Links the new architecture decision.
doc/​api/​topic-manifest.edn Registers the new documentation topic.
doc/​api/​style.html Refreshes generated navigation.
doc/​api/​dynamic-workflows.html Refreshes generated navigation.
doc/​api/​doc-auth-index.html Refreshes generated navigation.
doc/​api/​debugging.html Refreshes generated navigation.
doc/​api/​codegen.html Refreshes generated navigation.
doc/​api/​byok.html Refreshes generated navigation.
doc/​api/​2026-10-19-mcp-recovery-and-readiness.html Renders the new architecture decision.
doc/​api/​2026-10-16-session-hooks-and-compaction.html Refreshes generated navigation.
doc/​api/​2026-10-12-transport-diagnostics-and-opaque-policy.html Refreshes generated navigation.
doc/​api/​2026-10-09-extensible-routing-and-event-contracts.html Refreshes generated navigation.
doc/​api/​2026-08-10-host-owned-inference-boundary.html Refreshes generated navigation.
doc/​api/​2026-08-08-query-seq-scoped-lifecycle.html Refreshes generated navigation.
doc/​adr/​2026-10-19-mcp-recovery-and-readiness.md Records contract decisions and exclusions.
CHANGELOG.md Summarizes additions and behavior corrections.
.github/​workflows/​ci.yml Advances the upstream validation pin.
.copilot-schema-version Pins CLI schema version 1.0.100-1.

Review effort: Balanced

@krukow
krukow merged commit 0124667 into main Oct 19, 2026
3 checks passed
@krukow
krukow deleted the krukow-upstream-sdk-sync branch October 19, 2026 08:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants