Upstream sync: post-v1.0.0-beta.4 round 4 (schema 1.0.52-1, #1366)

.copilot-schema-version

@@ -1 +1 @@
-1.0.51
+1.0.52-1

CHANGELOG.md

@@ -3,6 +3,63 @@ All notable changes to this project will be documented in this file. This change
 
 ## [Unreleased]
 
+### Added (post-v1.0.0-beta.4 sync, round 4)
+- **`:on-pre-mcp-tool-call` hook** — New lifecycle hook in the `:hooks` map
+  that fires before an MCP tool call is dispatched to its server (upstream
+  PR #1366, wire `hookType: "preMcpToolCall"`). The handler receives an
+  input map with kebab-cased base fields (`:server-name`, `:tool-name`,
+  `:tool-call-id`, `:session-id`, `:timestamp`) plus two opaque,
+  source-defined fields that are preserved verbatim through wire
+  normalization: `:arguments` (the MCP tool arguments) and `:_meta` (the
+  MCP request metadata; the leading underscore is preserved — not
+  collapsed by kebab-case conversion). The handler return value supports
+  a tri-state `:meta-to-use` field controlling the outgoing MCP request
+  `_meta`:
+  - absent (`nil` / `{}`): preserve the existing `_meta`
+  - `{:meta-to-use {...}}`: replace `_meta` with the given map (inner
+    keys are preserved opaquely — not camelCased)
+  - `{:meta-to-use nil}`: serialize as JSON `null`, removing `_meta`.
+
+  Note: PR #1366 also renamed hook-input `cwd` to `workingDirectory` in
+  the Node.js public API. Existing Clojure hook handlers (`:on-pre-tool-use`,
+  `:on-post-tool-use`, etc.) currently receive the field as `:cwd`. For
+  internal consistency, `:on-pre-mcp-tool-call` also exposes `:cwd`; the
+  coordinated `:cwd` → `:working-directory` rename across all hooks is
+  tracked with the deferred PR #1357 work below.
+
+  (upstream PR #1366)
+- **Schema bump** — `.copilot-schema-version` advanced from `1.0.51` to
+  `1.0.52-1`. Additive changes only:
+  - `session.compaction_complete-data` gains optional `:custom-instructions`.
+  - `tool.execution_complete-data` gains optional `:sandboxed`.
+  - `session.shutdown-data` relaxes `:total-premium-requests` from
+    required to optional. The hand-curated idiom spec
+    `::specs/session.shutdown-data` matches.
+
+  Most of the remaining schema diff is `x-opaque-json` / description
+  annotations that do not affect the generated specs.
+
+### Tracked-but-not-ported (post-v1.0.0-beta.4 sync, round 4)
+- **PR #1357 (TypeScript SDK API review fixes)** — Pure naming/API-shape
+  changes in the JS public API: `onExitPlanMode → onExitPlanModeRequest`,
+  `onAutoModeSwitch → onAutoModeSwitchRequest`,
+  `ResumeSessionConfig.disableResume → suppressResumeEvent`,
+  `cwd → workingDirectory` across config types, `getMessages → getEvents`,
+  `InputOptions → UiInputOptions`, `maxInputTokens → maxPromptTokens`
+  (drops wire shim), and removal of `autoStart` / `autoRestart` from
+  `CopilotClientOptions`. The Clojure SDK already uses idiomatic kebab-case
+  names that are independent of upstream's JS naming, and the
+  `:max-input-tokens` → `maxPromptTokens` wire shim was explicit in
+  Clojure from the start (mirrors upstream's pre-#1357 behavior), so
+  dropping the JS shim has no effect on Clojure. The remaining renames
+  (`:cwd` → `:working-directory` on hook inputs, `:disable-resume?` →
+  `:suppress-resume-event?`, etc.) are breaking and are deferred to a
+  separate PR that can introduce deprecation aliases.
+- **PRs #1370 / #1371 (1.0.52-x schema bumps)** — Picked up by the
+  schema regen in this PR.
+
+
+
 ### Changed (post-v1.0.0-beta.4 sync, round 3)
 - **`ping` `:timestamp` field type changed in CLI 1.0.51** — Upstream PR #1340
   changed the `ping` RPC result `timestamp` field from epoch-millis number to

doc/reference/API.md

@@ -2250,6 +2250,21 @@ Lifecycle hooks allow custom logic at various points during the session:
                    (println "Tool completed:" (:tool-name input))
                    nil)
 
+                 :on-pre-mcp-tool-call
+                 (fn [input invocation]
+                   ;; Called before each MCP tool call is dispatched (upstream PR #1366).
+                   ;; input contains
+                   ;;   {:server-name "..." :tool-name "..." :arguments {...}
+                   ;;    :tool-call-id "..." :_meta {...} :session-id "..."
+                   ;;    :timestamp 12345}
+                   ;; :arguments and :_meta are opaque MCP payloads and are
+                   ;; passed through verbatim (NOT kebab-cased recursively).
+                   ;; Return nil/{} to preserve the existing _meta on the
+                   ;; outgoing MCP request, {:meta-to-use {...}} to replace
+                   ;; it, or {:meta-to-use nil} to remove it.
+                   (println "Pre-MCP call:" (:server-name input) (:tool-name input))
+                   {:meta-to-use {:traceId "my-trace-id"}})
+
                  :on-user-prompt-submitted
                  (fn [input invocation]
                    ;; Called when user sends a prompt

schemas/README.md

@@ -4,4 +4,4 @@ These files are fetched verbatim from the `@github/copilot` npm package at the v
 
 **Do not edit by hand.** To update, run `bb schemas:fetch` after bumping `.copilot-schema-version`.
 
-Currently pinned version: `1.0.51`
+Currently pinned version: `1.0.52-1`