@anthropic-ai/claude-agent-sdk 0.3.145 → 0.3.147

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.145",
-  "commit": "daa4c3755d45ab0cf97bb41db8c03bd2dfd2ff5f",
-  "buildDate": "2026-05-19T01:56:17Z",
+  "version": "2.1.147",
+  "commit": "09432314e83522f23b42b184fb69f0a4bb8a80e0",
+  "buildDate": "2026-05-21T16:18:26Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "368dcd9709c85534f673071e7cc8eb5422bcff367fb9bdf5ce25d9619aab7ef5",
-      "size": 208546464
+      "checksum": "94a81554195edc33c2587f106bfc2e301f450f52a05cbfaed8b20f6f0882697c",
+      "size": 211584672
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "c23dc566214279d0708f4212261f023d8e63d5af5aef91638ebfdc090b3e33de",
-      "size": 211044112
+      "checksum": "91f5a6364d8899860b20c348142fa66e18ee380e6d379b35e3d26b643603c612",
+      "size": 214082320
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "75ad61d690d79440c82b5841444e1b42caae55736af37c97dd0e068ef20ce390",
-      "size": 233944712
+      "checksum": "c7b5b050f9a4cebdc1b369935d3f64078b587b869ae8789c06c437c559d6bb2b",
+      "size": 236959368
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "b3ffbc12689bfe81389d6577787fcea4cab81bd3b6bba9b719e73770b62d720e",
-      "size": 234022608
+      "checksum": "d3e134bf504d6ff7db68d0a6f2206c9a15a6d2f94053845116f3303b0a0d79d4",
+      "size": 237037264
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "3a73f058b2225a4210931362bc9c98e486e3362ca28b339281755737fb375c7c",
-      "size": 226799448
+      "checksum": "060f28ad7857553716a97f9847ea19fb3a6fa3713ba9ed95d9a3ebda19f1ab2e",
+      "size": 229814104
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "cfc95961a41329204405c4b0e257cb467821133eb7bdb1ca0866dfe789d5d442",
-      "size": 228416560
+      "checksum": "d336583d6d65f072dea9ea1874eceb6a25db15c893969b60da0ed3ffa4f0777a",
+      "size": 231431216
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "1da511cee5d3a4968634174498e9148635a5908d7f6ea5ec91b04d531c20c3bc",
-      "size": 229910176
+      "checksum": "1fd537873b6f2573d48be5fef95ae5ae42f8d837b64ee102f36b151de2ff7b79",
+      "size": 232828064
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "b6b920c757e08ff3e4f0dc211360ad7815db539d4915bb691e57ee4d34db31e5",
-      "size": 225875616
+      "checksum": "3bb2d495a87df058cae050400c8815994fe6a50413ad12f726d36fd583ad362e",
+      "size": 228793504
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.145",
-  "commit": "daa4c3755d45ab0cf97bb41db8c03bd2dfd2ff5f",
-  "buildDate": "2026-05-19T02:03:37Z",
+  "version": "2.1.147",
+  "commit": "09432314e83522f23b42b184fb69f0a4bb8a80e0",
+  "buildDate": "2026-05-21T16:25:55Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "7bedcf3a0a6e2f79b3b0008e7a056984a47a30747cc4ef988dd6d7095cff5c2c",
-      "size": 43195831,
+      "checksum": "d44b2eafc9047aaaa9e33b215801f67a830966e9345dcb8b5d6d7fda246ff98c",
+      "size": 43820535,
       "bundle": {
-        "checksum": "815e4f3505e2b005a9510a9427846b5fe55cf0702aa838eb293315133ea3376f",
-        "size": 43200202
+        "checksum": "ca64c67307c9dfd35d808ba34e80fb7afc0a8172b6853dbd739fbf9578b5f96d",
+        "size": 43815620
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "3ba937418f3f2e2155b45e330d2f5d75f09bceb6e3cefc3a6b314e6c806f05e6",
-      "size": 45109754,
+      "checksum": "12eeb0200fc60d6ced6d566d7581ca3a2903ded2937a78466b6330c09c31f749",
+      "size": 45727099,
       "bundle": {
-        "checksum": "c936efab1b00100fb114c2a82c79ac23b9948610adc26b99579ef65606a717ef",
-        "size": 45119954
+        "checksum": "9d3a1da8e687e8499da944e779d0176b8aec5b094479b6b54a9657ce31d70f87",
+        "size": 45738513
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "7bffc295920723dd531ff9937f6dd6e953ac52051d643df69d5aa29cd7d87584",
-      "size": 50982967
+      "checksum": "03ac9583ff487f084144121f39305b41ce09e6751496fa1b27aaae134ec2f801",
+      "size": 51548280
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "5ba6f8e411bd4aa8a967818a5deece65e74ea2c99bb08adf20554070ebdff6db",
-      "size": 51607210
+      "checksum": "db95687a8ade4f38641c5fa29b0a8d0bb87064092aba869eb7d890885b27be63",
+      "size": 52179875
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "1e6e9ddba6e57144b3700a318f944308bfe0887db7c50445e2dc4c912a7b1c20",
-      "size": 49605775
+      "checksum": "f1c0cf829c0abc8d359eca21b1f8317a5014dcce345138535d38cbbd6a90c141",
+      "size": 50160745
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "a14758fa127cc8d02df3f63146e8e6b819252ee3f8618095ab26e6b703b3042e",
-      "size": 50320268
+      "checksum": "5c55ba03b368484f94ddb906983652842d607cf8e19c4a293870ad011bd230a0",
+      "size": 50896557
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "2e359b72a4e8a74e6c2059bd469fb9a7ecc73427f3666ad3b748fd86e01e58a4",
-      "size": 52313300
+      "checksum": "1bdd36b4f0503f460eac798199f4b36fd809a2c71d6e5d056073f45953e3bb4d",
+      "size": 52896816
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "86c1464594dafb9126204a9d853610ba67d85cecdcdbee222e76ec6e8f01c070",
-      "size": 50612912
+      "checksum": "ae4ecb6941a62d52084ee3ce7998645bfffa820a0dd447de36e8a574d3c505b6",
+      "size": 51172676
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.145",
+  "version": "0.3.147",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -61,14 +61,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.145",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.145"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.147",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.147"
   },
   "files": [
     "sdk.mjs",
@@ -86,5 +86,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.145"
+  "claudeCodeVersion": "2.1.147"
 }

package/sdk-tools.d.ts

@@ -314,7 +314,7 @@ export interface AgentInput {
   /**
    * Permission mode for spawned teammate (e.g., "plan" to require plan approval).
    */
-  mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+  mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | "bubble";
   /**
    * Isolation mode. "worktree" creates a temporary git worktree so the agent works on an isolated copy of the repo.
    */

package/sdk.d.ts

@@ -988,6 +988,10 @@ export declare type McpClaudeAIProxyServerConfig = {
     type: 'claudeai-proxy';
     url: string;
     id: string;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     */
+    timeout?: number;
 };
 
 export declare type McpHttpServerConfig = {
@@ -995,6 +999,10 @@ export declare type McpHttpServerConfig = {
     url: string;
     headers?: Record<string, string>;
     tools?: McpServerToolPolicy[];
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     */
+    timeout?: number;
     /**
      * When true, all tools from this server are always included in the prompt and never deferred behind tool search. Equivalent to setting defer_loading: false on the API. Default: tools are deferred when tool search is enabled. As a side effect this also blocks startup until the server is connected (capped at the standard 5s connect timeout) even though MCP startup is otherwise non-blocking by default, since the tools must be present when the turn-1 prompt is built.
      */
@@ -1101,6 +1109,10 @@ export declare type McpSSEServerConfig = {
     url: string;
     headers?: Record<string, string>;
     tools?: McpServerToolPolicy[];
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     */
+    timeout?: number;
     /**
      * When true, all tools from this server are always included in the prompt and never deferred behind tool search. Equivalent to setting defer_loading: false on the API. Default: tools are deferred when tool search is enabled. As a side effect this also blocks startup until the server is connected (capped at the standard 5s connect timeout) even though MCP startup is otherwise non-blocking by default, since the tools must be present when the turn-1 prompt is built.
      */
@@ -1113,6 +1125,10 @@ export declare type McpStdioServerConfig = {
     command: string;
     args?: string[];
     env?: Record<string, string>;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     */
+    timeout?: number;
     /**
      * When true, all tools from this server are always included in the prompt and never deferred behind tool search. Equivalent to setting defer_loading: false on the API. Default: tools are deferred when tool search is enabled. As a side effect this also blocks startup until the server is connected (capped at the standard 5s connect timeout) even though MCP startup is otherwise non-blocking by default, since the tools must be present when the turn-1 prompt is built.
      */
@@ -1871,6 +1887,9 @@ export declare type Options = {
      * spawnClaudeCodeProcess: (options) => {
      *   // Custom spawn logic for VM execution
      *   // options contains: command, args, cwd, env, signal
+     *   // `signal` is forwarded — it aborts only AFTER the SDK's
+     *   // stdin-EOF + ~2 s grace window, so passing it to spawn()/your
+     *   // VM API is safe (force-kill fires after the graceful chance).
      *   return myVMProcess; // Must satisfy SpawnedProcess interface
      * }
      * ```
@@ -3202,12 +3221,12 @@ export declare type SDKMemoryRecallMessage = {
     mode: 'select' | 'synthesize';
     memories: {
         /**
-         * Absolute path to the memory file, or a synthesis sentinel of the form `<synthesis:DIR>` when mode is 'synthesize'.
+         * Absolute path to the memory file, a synthesis sentinel of the form `<synthesis:DIR>` when mode is 'synthesize', or an https URL when scope is 'organization'.
          */
         path: string;
-        scope: 'personal' | 'team';
+        scope: 'personal' | 'team' | 'organization';
         /**
-         * Synthesis paragraph. Only present when mode is 'synthesize'; always absent for 'select' (renderers lazy-load from path).
+         * The surfaced memory body. Always present for 'synthesize' mode and 'organization' scope (neither has an on-disk path to lazy-load from); absent for file-backed 'select' entries (renderers lazy-load from path).
          */
         content?: string;
     }[];
@@ -5498,7 +5517,28 @@ export declare interface SpawnOptions {
     env: {
         [envVar: string]: string | undefined;
     };
-    /** Abort signal for cancellation */
+    /**
+     * Abort signal for cancellation.
+     *
+     * This is a **forwarded** signal owned by `ProcessTransport`, not the
+     * caller's `Options.abortController.signal` directly. It aborts only
+     * after the SDK's graceful-close path has run: stdin EOF →
+     * `GRACEFUL_EXIT_TIMEOUT_MS` (~2 s) grace window. Anything you hang on
+     * it (Node `spawn({signal})` → `child.kill()`, VM/container teardown,
+     * fetch cancellation) fires **after** the child has had a chance to
+     * shut down cleanly via stdin close.
+     *
+     * Why: passing the caller's raw signal to Node `spawn()` registers
+     * Node's own abort listener that calls `child.kill()` — on Windows
+     * that's `TerminateProcess` (instant, uncatchable), and AbortSignal
+     * listeners fire synchronously in registration order, so it would race
+     * ahead of the SDK's stdin-EOF + grace path and the CLI's
+     * `gracefulShutdown` would never run.
+     *
+     * If you need the caller's *immediate* signal (no grace), it's the
+     * `AbortController` you passed to `Options.abortController` — capture
+     * it in closure.
+     */
     signal: AbortSignal;
 }