@anthropic-ai/claude-agent-sdk 0.3.236 → 0.3.238

package/manifest.json

@@ -1,54 +1,51 @@
 {
-  "version": "2.1.236",
-  "commit": "82959839e9405dd642b4e3eaa6ef4101bf285fee",
-  "buildDate": "2026-08-19T16:49:51Z",
+  "version": "2.1.238",
+  "commit": "46283063a4c23f7afadb8440f549264ad93b7c06",
+  "buildDate": "2026-08-20T15:26:31Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "6bc4ba992d2786cbf0237c4453ca53c1fdf0c3b3d83ffa0025c0d8190ed27848",
-      "size": 317044624
+      "checksum": "1c196c456373b57818ae87df84aecee96cb659448c0d6a6bbb401ac5758431b2",
+      "size": 321263536
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "3ce6a8e016fcae45ad3f2dc78f1980600d3908c302355396a0d6bc17b5d43333",
-      "size": 325726960
+      "checksum": "d10bc7bb1720435f8830aa3ee74085f09348d2b1a2a152bdee251b770d76cc73",
+      "size": 329970544
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "c38d37deaf1643083326c48a6acc0afb09dada126e6bda77ef1a4410ae60ca12",
-      "size": 331798760
+      "checksum": "28d736120a6b14c5eae1ad1470e73371818c9c2fa41e0b3c7040207aa2d4edee",
+      "size": 335993064
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "6c8818fa22187aa555c242be4abbacc44d6b71a32ac9631ee7b2b5d12f51f752",
-      "size": 334645552
+      "checksum": "0933b286cf94e1b2504b35ac165ab76b8f822735d53371c56393988c23040d58",
+      "size": 338860336
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "56fe9241267b0187538a9cf7dafa0df12d94fd27789fa7207a59c2a0b4121b8f",
-      "size": 324943640
+      "checksum": "a47d45149ea7c74e4474bce3c7628c4643b0541801b42053d6e26fd5e3203fdd",
+      "size": 329137944
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "979acf4877fa3dca24d6d15043022b5005cc8502fdb4c68992dd91651af31731",
-      "size": 328769504
+      "checksum": "33546c2f7947bbfdb46a969123c5329e607c414045cd3645a29aa3cfe023c6ab",
+      "size": 332988384
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "647e736f20c9ff0553c754624cbf8a6dcac196e8595509d8f63dce8bbe818757",
-      "size": 330097824
+      "checksum": "223bc058b5aef48138876e28de5d00387e4fd7362a18e733143bf00819c01aab",
+      "size": 334150816
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "95726b1cb3bd6541a695e4d3ee00716b4e1e5157cdef0a3cbce614d5cc140e9d",
-      "size": 317997728
+      "checksum": "645800d24201c93e5fd6f4308e0292bba9a75900693667401cdffb4361f8e616",
+      "size": 322051744
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.198",
-      "0.3.199",
-      "0.3.200",
       "0.3.201",
       "0.3.202",
       "0.3.204",
@@ -69,6 +66,7 @@
       "0.3.220",
       "0.3.221",
       "0.3.222",
+      "0.3.223",
       "0.3.226",
       "0.3.227"
     ],

package/manifest.zst.json

@@ -1,62 +1,59 @@
 {
-  "version": "2.1.236",
-  "commit": "82959839e9405dd642b4e3eaa6ef4101bf285fee",
-  "buildDate": "2026-08-19T16:52:17Z",
+  "version": "2.1.238",
+  "commit": "46283063a4c23f7afadb8440f549264ad93b7c06",
+  "buildDate": "2026-08-20T15:28:38Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "2a36013e5d16f39ab372317f2a78fb90a66fe363a9489ce9d55cc1a22871e30e",
-      "size": 63375100,
+      "checksum": "d9b3b89dd4a0ce4deb9b35eff326e8aceef957b59ea8170afbbe29e0801d6a22",
+      "size": 63807531,
       "bundle": {
-        "checksum": "fa2acd9865513c216648bbeb7bd8132ca362b24b8833b9a6727b7ed6991d8b79",
-        "size": 63368478
+        "checksum": "f01e093504e89c6fb3724417f2ebf9a615f1f46770cc6a8fced0daccff55aa47",
+        "size": 63810771
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "d9792583dfcbad6a75030fe7ad7aad95767ff9cda2e2daaa1f4d843c5e2b4285",
-      "size": 68033390,
+      "checksum": "c9f5de6fefd0394b21c0e7e037a5471482c440a7780e21fffae512d5fdbcdc30",
+      "size": 68484623,
       "bundle": {
-        "checksum": "d6ebae7a8f672889bdbfb23279657edb11cd7bd0022ba6a041c00781e01e318d",
-        "size": 68033703
+        "checksum": "ef80b7b9e5ef8c9b2a7735782a0ecd67655cb3c847af55215d9cf6bb366b8325",
+        "size": 68483882
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "78bf0f46b9349c28150a308fbf9a25ebd1de412052cb5a0b317437c375aefbb0",
-      "size": 72310411
+      "checksum": "9b4d5e5598b71420a2e31bab26325dacd3b2b2ad7c5c388c6430855ced6a81fe",
+      "size": 72698452
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "944815ef17d3ee89b04d352bc68217835d45fa32b7906adbe223153159f8411d",
-      "size": 73511767
+      "checksum": "0af6c2cf837dd6c8805f465581718d89b943921f427a2c13fb2577ec8c69e249",
+      "size": 73796765
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "cadb7751ff700503bcd45d5cf960b5902d7b0d9719cd3b7e8e1af3997ca7f5f8",
-      "size": 70879003
+      "checksum": "db85271f2cc0e6040318b6e8bbd8c3e812829c1c8c50c964f80a76ac83c75a8a",
+      "size": 71209714
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "a62354366445d6ea49c30fa44a51ce523c4cae22c5742284416127949f081f03",
-      "size": 72013109
+      "checksum": "e43e05792a1c034dd54ac7c4f43ae2df01c00181c67d362879bdf119a8098e96",
+      "size": 72251647
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "d5b1d5853ce26a6bb2e0bcc85afa780edc27c0a3eb4ecc1de8c3bb9b83d30d34",
-      "size": 75849923
+      "checksum": "b558a80984d13bd3bc8fc2eb011f44051b61078367a91f2458b10beaeee55c96",
+      "size": 76157543
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "e45b3d379bc0ad2dd4432adbb3549b3d5f0a4b98cb099731ed142e618db19acb",
-      "size": 72271473
+      "checksum": "912b8524477193d0340cc438cd66cea379441dc815efdcfe262e3c39bcf41ed7",
+      "size": 72467187
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.198",
-      "0.3.199",
-      "0.3.200",
       "0.3.201",
       "0.3.202",
       "0.3.204",
@@ -77,6 +74,7 @@
       "0.3.220",
       "0.3.221",
       "0.3.222",
+      "0.3.223",
       "0.3.226",
       "0.3.227"
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.236",
+  "version": "0.3.238",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -57,14 +57,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.236",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.236"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.238",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.238"
   },
   "files": [
     "sdk.mjs",
@@ -80,5 +80,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.236"
+  "claudeCodeVersion": "2.1.238"
 }

package/sdk.d.ts

@@ -1831,6 +1831,9 @@ export declare type Options = {
      *   `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false` env var, and when the user
      *   has `promptSuggestionEnabled: false` in settings.json (the env var wins
      *   over the setting).
+     * - Also suppressed while the account is near or at its plan usage limit.
+     *   `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=true` keeps them on in the
+     *   near-limit case; at the limit they stay off.
      * - Suggestions piggyback on the parent's prompt cache, making them nearly free.
      */
     promptSuggestions?: boolean;
@@ -2496,6 +2499,15 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * SDK-side, but callbacks should be idempotent per request_id since a
      * request whose response was lost in the gap will be dispatched again.
      *
+     * Over stdio the CLI also re-registers this query's hooks from the
+     * re-sent request (the response reports `hooks_applied: true`; CLIs that
+     * predate that field ignore hooks here) and resolves any hook callback it
+     * was still waiting on itself — cancelling it at this host, denying a
+     * pending PreToolUse with a retry notice and blocking a pending prompt —
+     * since it cannot tell whether the re-sent callback ids still name the
+     * same hooks. Expect one denied-then-retried tool call or one prompt to
+     * re-send if the call races an unanswered hook.
+     *
      * Unlike {@link Query.initializationResult}, this always sends a fresh request
      * rather than returning the cached first-connect result.
      *
@@ -3734,6 +3746,11 @@ export declare type SDKControlInitializeResponse = {
 
 
 
+    /**
+     * Whether the `hooks` this initialize carried were registered: true on a session's first initialize, and on a repeated initialize from the process that owns the CLI's stdin (its set replaces the one registered earlier); false when a repeated initialize's hooks were ignored (a client joining a remote session another client configured). Absent when the request carried no hooks, and on CLIs that predate the field — those ignored `hooks` on every repeated initialize.
+     */
+    hooks_applied?: boolean;
+
 
 
     fast_mode_state?: coreTypes.FastModeState;
@@ -4601,6 +4618,7 @@ export declare type SDKResultError = {
      * Per-model totals for every model call made through the query pipeline during this query() call — main loop, Task subagents, sidechains, and internal calls such as compaction and Workflow agents. Cumulative across turns in streaming-input sessions: each result carries the running total so far, so read the latest result rather than summing across results. Internal helper calls outside the query pipeline (e.g. the permission classifier, token-count probes) are excluded; crash/startup-error results may carry zeroed usage, resumed sessions start fresh, and a mid-session /clear resets the running total. The correct field for token/cost accounting; treat it as an estimate, not a billing statement.
      */
     modelUsage: Record<string, ModelUsage>;
+
     permission_denials: SDKPermissionDenial[];
     errors: string[];
     terminal_reason?: TerminalReason;
@@ -4646,6 +4664,7 @@ export declare type SDKResultSuccess = {
      * Per-model totals for every model call made through the query pipeline during this query() call — main loop, Task subagents, sidechains, and internal calls such as compaction and Workflow agents. Cumulative across turns in streaming-input sessions: each result carries the running total so far, so read the latest result rather than summing across results. Internal helper calls outside the query pipeline (e.g. the permission classifier, token-count probes) are excluded; crash/startup-error results may carry zeroed usage, resumed sessions start fresh, and a mid-session /clear resets the running total. The correct field for token/cost accounting; treat it as an estimate, not a billing statement.
      */
     modelUsage: Record<string, ModelUsage>;
+
     permission_denials: SDKPermissionDenial[];
     structured_output?: unknown;
     deferred_tool_use?: SDKDeferredToolUse;
@@ -4858,6 +4877,14 @@ export declare type SDKTaskStartedMessage = {
      * Subagent type for Task tool subagents.
      */
     subagent_type?: string;
+    /**
+     * Whether the task was registered in the background (true) or in the foreground with the spawning tool call blocking on it (false). A resumed subagent is always registered in the background. A later move to the background arrives as task_updated patch.is_backgrounded. Set for local_agent and local_bash tasks.
+     */
+    is_backgrounded?: boolean;
+    /**
+     * Nesting depth of a spawned subagent (local_agent) task: 1 for a top-level spawn, N+1 when spawned from inside a depth-N agent. Not set on other tasks.
+     */
+    spawn_depth?: number;
     task_type?: string;
     /**
      * meta.name from the workflow script (e.g. 'spec'). Only set when task_type is 'local_workflow'.
@@ -5893,6 +5920,10 @@ export declare interface Settings {
                 headers?: {
                     [k: string]: string;
                 };
+                /**
+                 * Command that prints a JSON object of HTTP headers (e.g. a short-lived auth token). Its output overrides `headers` and, like `headers`, is inherited by same-origin archive downloads from this marketplace. Runs from a fixed directory (the Claude config home, never the session's), so give a bare command found via PATH or an absolute path; it is re-run on later refreshes of this marketplace.
+                 */
+                headersHelper?: string;
             } | {
                 source: 'github';
                 /**
@@ -6077,6 +6108,16 @@ export declare interface Settings {
                     description?: string;
                     version?: string;
                     strict?: boolean;
+                    /**
+                     * HTTP headers sent when downloading this entry's `archive` source.
+                     */
+                    headers?: {
+                        [k: string]: string;
+                    };
+                    /**
+                     * Command that prints a JSON object of HTTP headers for downloading this entry's `archive` source. Runs only when a user explicitly installs or updates this plugin. Unlike a catalog entry, an entry written here does not need `strict: false`: it is declared in a settings file, which has no manifest fields to inline. A declaration in project settings is not operator-authored, so request-routing and client-identity header names are still filtered there. Use an absolute path.
+                     */
+                    headersHelper?: string;
                 }[];
                 owner?: {
                     /**
@@ -6123,6 +6164,10 @@ export declare interface Settings {
                 headers?: {
                     [k: string]: string;
                 };
+                /**
+                 * Command that prints a JSON object of HTTP headers (e.g. a short-lived auth token). Its output overrides `headers` and, like `headers`, is inherited by same-origin archive downloads from this marketplace. Runs from a fixed directory (the Claude config home, never the session's), so give a bare command found via PATH or an absolute path; it is re-run on later refreshes of this marketplace.
+                 */
+                headersHelper?: string;
             } | {
                 source: 'github';
                 /**
@@ -6307,6 +6352,16 @@ export declare interface Settings {
                     description?: string;
                     version?: string;
                     strict?: boolean;
+                    /**
+                     * HTTP headers sent when downloading this entry's `archive` source.
+                     */
+                    headers?: {
+                        [k: string]: string;
+                    };
+                    /**
+                     * Command that prints a JSON object of HTTP headers for downloading this entry's `archive` source. Runs only when a user explicitly installs or updates this plugin. Unlike a catalog entry, an entry written here does not need `strict: false`: it is declared in a settings file, which has no manifest fields to inline. A declaration in project settings is not operator-authored, so request-routing and client-identity header names are still filtered there. Use an absolute path.
+                     */
+                    headersHelper?: string;
                 }[];
                 owner?: {
                     /**
@@ -6348,6 +6403,10 @@ export declare interface Settings {
         headers?: {
             [k: string]: string;
         };
+        /**
+         * Command that prints a JSON object of HTTP headers (e.g. a short-lived auth token). Its output overrides `headers` and, like `headers`, is inherited by same-origin archive downloads from this marketplace. Runs from a fixed directory (the Claude config home, never the session's), so give a bare command found via PATH or an absolute path; it is re-run on later refreshes of this marketplace.
+         */
+        headersHelper?: string;
     } | {
         source: 'github';
         /**
@@ -6532,6 +6591,16 @@ export declare interface Settings {
             description?: string;
             version?: string;
             strict?: boolean;
+            /**
+             * HTTP headers sent when downloading this entry's `archive` source.
+             */
+            headers?: {
+                [k: string]: string;
+            };
+            /**
+             * Command that prints a JSON object of HTTP headers for downloading this entry's `archive` source. Runs only when a user explicitly installs or updates this plugin. Unlike a catalog entry, an entry written here does not need `strict: false`: it is declared in a settings file, which has no manifest fields to inline. A declaration in project settings is not operator-authored, so request-routing and client-identity header names are still filtered there. Use an absolute path.
+             */
+            headersHelper?: string;
         }[];
         owner?: {
             /**
@@ -6563,6 +6632,10 @@ export declare interface Settings {
         headers?: {
             [k: string]: string;
         };
+        /**
+         * Command that prints a JSON object of HTTP headers (e.g. a short-lived auth token). Its output overrides `headers` and, like `headers`, is inherited by same-origin archive downloads from this marketplace. Runs from a fixed directory (the Claude config home, never the session's), so give a bare command found via PATH or an absolute path; it is re-run on later refreshes of this marketplace.
+         */
+        headersHelper?: string;
     } | {
         source: 'github';
         /**
@@ -6747,6 +6820,16 @@ export declare interface Settings {
             description?: string;
             version?: string;
             strict?: boolean;
+            /**
+             * HTTP headers sent when downloading this entry's `archive` source.
+             */
+            headers?: {
+                [k: string]: string;
+            };
+            /**
+             * Command that prints a JSON object of HTTP headers for downloading this entry's `archive` source. Runs only when a user explicitly installs or updates this plugin. Unlike a catalog entry, an entry written here does not need `strict: false`: it is declared in a settings file, which has no manifest fields to inline. A declaration in project settings is not operator-authored, so request-routing and client-identity header names are still filtered there. Use an absolute path.
+             */
+            headersHelper?: string;
         }[];
         owner?: {
             /**
@@ -6778,6 +6861,10 @@ export declare interface Settings {
         headers?: {
             [k: string]: string;
         };
+        /**
+         * Command that prints a JSON object of HTTP headers (e.g. a short-lived auth token). Its output overrides `headers` and, like `headers`, is inherited by same-origin archive downloads from this marketplace. Runs from a fixed directory (the Claude config home, never the session's), so give a bare command found via PATH or an absolute path; it is re-run on later refreshes of this marketplace.
+         */
+        headersHelper?: string;
     } | {
         source: 'github';
         /**
@@ -6962,6 +7049,16 @@ export declare interface Settings {
             description?: string;
             version?: string;
             strict?: boolean;
+            /**
+             * HTTP headers sent when downloading this entry's `archive` source.
+             */
+            headers?: {
+                [k: string]: string;
+            };
+            /**
+             * Command that prints a JSON object of HTTP headers for downloading this entry's `archive` source. Runs only when a user explicitly installs or updates this plugin. Unlike a catalog entry, an entry written here does not need `strict: false`: it is declared in a settings file, which has no manifest fields to inline. A declaration in project settings is not operator-authored, so request-routing and client-identity header names are still filtered there. Use an absolute path.
+             */
+            headersHelper?: string;
         }[];
         owner?: {
             /**
@@ -7521,6 +7618,10 @@ export declare interface Settings {
      * Key binding mode for the prompt input
      */
     editorMode?: 'normal' | 'vim';
+    /**
+     * Which conventions the prompt's editing keys follow: "readline" matches Bash and other readline programs (Ctrl+W deletes back to the previous whitespace); "classic" (default) keeps Claude Code's long-standing behavior (Ctrl+W deletes the previous word)
+     */
+    keybindingFlavor?: 'classic' | 'readline';
     /**
      * Vim INSERT-mode key-sequence remaps, e.g. {"jj": "<Esc>"}. Each key is exactly two printable characters typed in sequence; "<Esc>" (return to NORMAL mode) is the only supported target. Applies when editorMode is "vim".
      */
@@ -8096,6 +8197,10 @@ export declare type UserPromptExpansionHookInput = BaseHookInput & {
 export declare type UserPromptExpansionHookSpecificOutput = {
     hookEventName: 'UserPromptExpansion';
     additionalContext?: string;
+    /**
+     * When decision is "block", omit the original prompt from the block message
+     */
+    suppressOriginalPrompt?: boolean;
 };
 
 export declare type UserPromptSubmitHookInput = BaseHookInput & {