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

package/manifest.json

@@ -1,53 +1,51 @@
 {
-  "version": "2.1.237",
-  "commit": "45590910f0b746ddad3fe7d8135c5c29b33ccf88",
-  "buildDate": "2026-08-19T22:55:17Z",
+  "version": "2.1.238",
+  "commit": "46283063a4c23f7afadb8440f549264ad93b7c06",
+  "buildDate": "2026-08-20T15:26:31Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "338901351d4ff17495738c67fc3e12a32c1b506738ac5e012eb782d3d8b5be43",
-      "size": 317110288
+      "checksum": "1c196c456373b57818ae87df84aecee96cb659448c0d6a6bbb401ac5758431b2",
+      "size": 321263536
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "9f00789754a7b95febc6d4e37a3b6523d4d9c4c2333a2ce4bd596ad82186224e",
-      "size": 325793008
+      "checksum": "d10bc7bb1720435f8830aa3ee74085f09348d2b1a2a152bdee251b770d76cc73",
+      "size": 329970544
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "a701cfb6bb4703abc6f3ce47508c878ca8158ebdbeacd5c35c7d510c7bc70177",
-      "size": 331864296
+      "checksum": "28d736120a6b14c5eae1ad1470e73371818c9c2fa41e0b3c7040207aa2d4edee",
+      "size": 335993064
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "73975167f0108693cf6fd6614994781657ebb8456ebef5d247458734abfb3916",
-      "size": 334715184
+      "checksum": "0933b286cf94e1b2504b35ac165ab76b8f822735d53371c56393988c23040d58",
+      "size": 338860336
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "60d832e81dd5076333e9f91286f660f2aaacc630079863599555caa8fe134eba",
-      "size": 325009176
+      "checksum": "a47d45149ea7c74e4474bce3c7628c4643b0541801b42053d6e26fd5e3203fdd",
+      "size": 329137944
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "b2c81ba8f2b0086b2536a56bf074bbf643043c2bd1aeea6ac8905709ae296168",
-      "size": 328843232
+      "checksum": "33546c2f7947bbfdb46a969123c5329e607c414045cd3645a29aa3cfe023c6ab",
+      "size": 332988384
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "406167231b3636e55a01d0ce93567256c61e7973489e645883302f14808ae668",
-      "size": 330167456
+      "checksum": "223bc058b5aef48138876e28de5d00387e4fd7362a18e733143bf00819c01aab",
+      "size": 334150816
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "35978113ca98721cbf14c3abac90482d467419b9669d849c89d91c5664a5f95d",
-      "size": 318066848
+      "checksum": "645800d24201c93e5fd6f4308e0292bba9a75900693667401cdffb4361f8e616",
+      "size": 322051744
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.199",
-      "0.3.200",
       "0.3.201",
       "0.3.202",
       "0.3.204",
@@ -68,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,61 +1,59 @@
 {
-  "version": "2.1.237",
-  "commit": "45590910f0b746ddad3fe7d8135c5c29b33ccf88",
-  "buildDate": "2026-08-19T22:57:46Z",
+  "version": "2.1.238",
+  "commit": "46283063a4c23f7afadb8440f549264ad93b7c06",
+  "buildDate": "2026-08-20T15:28:38Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "6bdfd8d555fa5e42e7e4f155e5706f03cd47082d093bdcecd2980c9541cba64c",
-      "size": 63485985,
+      "checksum": "d9b3b89dd4a0ce4deb9b35eff326e8aceef957b59ea8170afbbe29e0801d6a22",
+      "size": 63807531,
       "bundle": {
-        "checksum": "766ad312a75062e5761a190cf6d9a91129300f8d58502b1af70e301905004811",
-        "size": 63491494
+        "checksum": "f01e093504e89c6fb3724417f2ebf9a615f1f46770cc6a8fced0daccff55aa47",
+        "size": 63810771
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "c362bc2dbb47a963b2f73ae30766770073fa04dccc08f75646b5f3c1fdbba97f",
-      "size": 68099586,
+      "checksum": "c9f5de6fefd0394b21c0e7e037a5471482c440a7780e21fffae512d5fdbcdc30",
+      "size": 68484623,
       "bundle": {
-        "checksum": "b0ed2bbb50025cdc930c25c210064b23e4e39c784971fb8ddc44f4019dac6cbf",
-        "size": 68104413
+        "checksum": "ef80b7b9e5ef8c9b2a7735782a0ecd67655cb3c847af55215d9cf6bb366b8325",
+        "size": 68483882
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "c0fd5f3d315d7f2e81559f417a44e36dfe60d357f6a940a40cd532e08520fd0e",
-      "size": 72222417
+      "checksum": "9b4d5e5598b71420a2e31bab26325dacd3b2b2ad7c5c388c6430855ced6a81fe",
+      "size": 72698452
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "8901b24ccb274870109f6d89c3477e510565b86be656b31f655b03afcf197132",
-      "size": 73401339
+      "checksum": "0af6c2cf837dd6c8805f465581718d89b943921f427a2c13fb2577ec8c69e249",
+      "size": 73796765
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "01a70d3df6f417ff8dd64ae3ec57200d67abfef2647ae93951caaddd91bc1a8c",
-      "size": 70749737
+      "checksum": "db85271f2cc0e6040318b6e8bbd8c3e812829c1c8c50c964f80a76ac83c75a8a",
+      "size": 71209714
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "56dc1ece68b81ff0e6edc4f4b8437643a0cbad8f2cee84ea02a62cff554795bd",
-      "size": 72063095
+      "checksum": "e43e05792a1c034dd54ac7c4f43ae2df01c00181c67d362879bdf119a8098e96",
+      "size": 72251647
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "85ddfcf80b7a918b6707e6d3d611223f986c2c4e9b9c493206fd9807fa476a6d",
-      "size": 75828267
+      "checksum": "b558a80984d13bd3bc8fc2eb011f44051b61078367a91f2458b10beaeee55c96",
+      "size": 76157543
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "3018bba62073b6dd813aa1aa0ff4133f653ae5fbccd07ae6c6abc56cc64c9968",
-      "size": 72228518
+      "checksum": "912b8524477193d0340cc438cd66cea379441dc815efdcfe262e3c39bcf41ed7",
+      "size": 72467187
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.199",
-      "0.3.200",
       "0.3.201",
       "0.3.202",
       "0.3.204",
@@ -76,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.237",
+  "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.237",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.237",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.237",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.237",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.237",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.237",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.237",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.237"
+    "@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.237"
+  "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 & {