@anthropic-ai/claude-agent-sdk 0.2.138 → 0.2.140

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.138",
-  "commit": "d6d494651eb469be2ff763ef8d1b882aba8ca635",
-  "buildDate": "2026-05-09T04:12:33Z",
+  "version": "2.1.140",
+  "commit": "89b4b3854fac52fdb8f9970133c4afe00174b6b9",
+  "buildDate": "2026-05-12T18:36:21Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "759d23ce626193c89bc8b35c5c6ca8a9e33b9c2e504ee143e4cd119988774097",
-      "size": 205062416
+      "checksum": "087ce732fb79658cd3e828cc377291dc56835fc5318cd519123b0880a09149c0",
+      "size": 206069664
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "d99d3a7afd63841943906b11ed8791b0ee47fe5cf95601a8b805c20900014f54",
-      "size": 207568336
+      "checksum": "2616b1e775ec0520228cd99135d07ef99e4b93b4532a03ef019e0a8e81cc7729",
+      "size": 208583824
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "693ecca41a62d58fee660884bd982ca5cdeab5b277925fcdfe880cdf02f98671",
-      "size": 230471304
+      "checksum": "0ec6fc062e99aa95a6edbb5308a563262d27a0772b107d01d4fa61110fb44472",
+      "size": 231454344
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "c3c56ffbc12cf16e40c33687c9fe6361ed250c35a9e1718d0c38d49049f5f8c3",
-      "size": 230577872
+      "checksum": "807a5d6ca063f5e03e4b7283934036a3122723b28c28e1a6978e98cf2d43d0b5",
+      "size": 231577296
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "55652a05de92d2e374b5252834f013263df92450f0d9d43dbb7594fc33f448d4",
-      "size": 223326040
+      "checksum": "b840a07551c3e1baecff728eb6b9a849483be87bf1fdaed5da22d0b3427a88cf",
+      "size": 224309080
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "98c58173ea8237177ba82655c179b5ca9d2b011ecfb42e8fd5f7e1f227dac81b",
-      "size": 224971824
+      "checksum": "7db8946293de9ec11d2b02472f715f18ea9a346238d472605b5d9a4dc7bfd3f1",
+      "size": 225971248
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "dc693422b5323196042459ce3eeb6d4b8dcded302ec30f4fad4c10340231f708",
-      "size": 226494624
+      "checksum": "fcfe90297861b1bcfa581d7db645ec8a71984baed3b1c44d28032650baa2617c",
+      "size": 227456160
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "ebf483b9cee98d13f65f9ea16ac5bdeaef3a6dae8f203242cc84379cda3308f0",
-      "size": 222451872
+      "checksum": "3f782467ec6e593a5e23522b678cf4268965e4ec6fe904e41729a12d64232c40",
+      "size": 223420576
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.138",
-  "commit": "d6d494651eb469be2ff763ef8d1b882aba8ca635",
-  "buildDate": "2026-05-09T04:19:32Z",
+  "version": "2.1.140",
+  "commit": "89b4b3854fac52fdb8f9970133c4afe00174b6b9",
+  "buildDate": "2026-05-12T18:43:34Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "fb16e3f334f0559b6e0991200aac12aab8029bd48ff0dfb2b62c995de3aa614f",
-      "size": 42518731,
+      "checksum": "d9b6bdb0b8f271b344f19885179bcb0ef13fd66314607fdcfbe83cb85de77eb7",
+      "size": 42718061,
       "bundle": {
-        "checksum": "b87e6184067fbf545379d858f0f23020aefb80a72eb6e5adea1c4047982ec83b",
-        "size": 42529459
+        "checksum": "6742fbb491b6cef7feb8aaee8672a52dd9c158d3b3534282351a760f16fa9aa2",
+        "size": 42722106
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "ede90b99127583a32fbea48ebb4f53e93eaa0b6102f7328b5f69fc9f3df1fa1e",
-      "size": 44428293,
+      "checksum": "91a7324c7163375a93995217ecfb814a49da83f82ef8ef6f0369fef6e0a2dee4",
+      "size": 44628262,
       "bundle": {
-        "checksum": "e3018b1635e4c2f35ebeb5fcadaeabb4d7e5cc4f2e570451ab9017bad10ed4b9",
-        "size": 44431155
+        "checksum": "a6038ac7599463370aaf02a0deb89f1d063faab1c39203522828ea01af2f3952",
+        "size": 44635470
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "80f4bf5187c9e7471b9812e730d0bd42316a385170e20cd348870800b4320963",
-      "size": 50298207
+      "checksum": "26bd23cebfe608abbb6a564e9bbee8b969805d2fec566640ec986922f4da050f",
+      "size": 50527860
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "46045545a5d15a5f7775cf56ae805621786f188a2d1c6bc78c04c97b260cc137",
-      "size": 50936906
+      "checksum": "e704d23a8b015a1156749f763f5eae8449a07fc01089923cf52483a9e811a9cc",
+      "size": 51130420
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "5bde1ef158e590334c509f75e57b68805243a62a0b094c4b87d899e6c76b6eb7",
-      "size": 48947923
+      "checksum": "aea9f89cfdfca9268f598106b2cca98045495959552d0732f6dd42c7ac69c173",
+      "size": 49145878
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "4ffbb67c6097d82a662c717436629165803f37ca886020eeb568e18d6f962a28",
-      "size": 49659023
+      "checksum": "7a330e14ae68b55a69d6480db19027a0fc25bcd315053a82ff04dd369192a8fa",
+      "size": 49840553
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "13bd79797b0a89337b108c59d369b6d07e1dd3c0db2b5bdbc3ea7e05d1f625d8",
-      "size": 51642933
+      "checksum": "196bca09220a94b4e93ab654dd509ff87a02fc1eeedfa51a5dd710a9cb3d25dc",
+      "size": 51861421
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "9714429f2213c6fe9cd022b7d3710d093eb643a05af0098b7b4f75fd1073ea0d",
-      "size": 49928401
+      "checksum": "8b9ed012b85c45aa4bef85e1db3eb2ccf60ed3d413eda6d90ac9f136947bcd33",
+      "size": 50151271
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.138",
+  "version": "0.2.140",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -55,14 +55,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.138",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.138"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.140",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.140"
   },
   "files": [
     "sdk.mjs",
@@ -78,5 +78,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.138"
+  "claudeCodeVersion": "2.1.140"
 }

package/sdk.d.ts

@@ -27,9 +27,9 @@ export declare type AccountInfo = {
     tokenSource?: string;
     apiKeySource?: string;
     /**
-     * Active API backend. Anthropic OAuth login only applies when "firstParty"; for 3P providers the other fields are absent and auth is external (AWS creds, gcloud ADC, etc.).
+     * Active API backend. Anthropic OAuth login only applies when "firstParty"; for 3P providers the other fields are absent and auth is external (AWS creds, gcloud ADC, etc.). "gateway" means the CLI is authenticated against an enterprise gateway.
      */
-    apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws' | 'mantle';
+    apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws' | 'mantle' | 'gateway';
 };
 
 /**
@@ -344,9 +344,6 @@ declare namespace coreTypes {
         PreCompactHookInput,
         PreToolUseHookInput,
         PreToolUseHookSpecificOutput,
-        PromptRequestOption,
-        PromptRequest,
-        PromptResponse,
         RewindFilesResult,
         SDKAPIRetryMessage,
         SDKAssistantMessageError,
@@ -2007,47 +2004,6 @@ export declare type PreToolUseHookSpecificOutput = {
     additionalContext?: string;
 };
 
-export declare type PromptRequest = {
-    /**
-     * Request ID. Presence of this key marks the line as a prompt request.
-     */
-    prompt: string;
-    /**
-     * The prompt message to display to the user
-     */
-    message: string;
-    /**
-     * Available options for the user to choose from
-     */
-    options: PromptRequestOption[];
-};
-
-export declare type PromptRequestOption = {
-    /**
-     * Unique key for this option, returned in the response
-     */
-    key: string;
-    /**
-     * Display text for this option
-     */
-    label: string;
-    /**
-     * Optional description shown below the label
-     */
-    description?: string;
-};
-
-export declare type PromptResponse = {
-    /**
-     * The request ID from the corresponding prompt request
-     */
-    prompt_response: string;
-    /**
-     * The key of the selected option
-     */
-    selected: string;
-};
-
 /**
  * Per-key provenance entry.
  * @alpha
@@ -2269,6 +2225,19 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * @param taskId - The task ID from task_notification events
      */
     stopTask(taskId: string): Promise<void>;
+    /**
+     * Background in-flight foreground tasks (Bash commands and subagents).
+     * With `toolUseId`, targets the single task started by that tool_use
+     * block; without it, backgrounds all foreground tasks — equivalent to
+     * pressing Ctrl+B in the terminal. Each blocking tool call returns
+     * immediately with a "running in the background" tool_result and the
+     * turn continues; the task keeps running and emits a task_notification
+     * when it settles.
+     * @param toolUseId - Optional tool_use block id to target a single task
+     * @returns true when at least one task was backgrounded; false only
+     *   when `toolUseId` was given and it matched no foreground task
+     */
+    backgroundTasks(toolUseId?: string): Promise<boolean>;
     /**
      * Close the query and terminate the underlying process.
      * This forcefully ends the query, cleaning up all resources including
@@ -2424,6 +2393,10 @@ declare const SandboxNetworkConfigSchema: () => z.ZodOptional<z.ZodObject<{
     allowMachLookup: z.ZodOptional<z.ZodArray<z.ZodString>>;
     httpProxyPort: z.ZodOptional<z.ZodNumber>;
     socksProxyPort: z.ZodOptional<z.ZodNumber>;
+    tlsTerminate: z.ZodOptional<z.ZodObject<{
+        caCertPath: z.ZodOptional<z.ZodString>;
+        caKeyPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>>;
 
 export declare type SandboxSettings = z.infer<ReturnType<typeof SandboxSettingsSchema>>;
@@ -2446,6 +2419,10 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
         allowMachLookup: z.ZodOptional<z.ZodArray<z.ZodString>>;
         httpProxyPort: z.ZodOptional<z.ZodNumber>;
         socksProxyPort: z.ZodOptional<z.ZodNumber>;
+        tlsTerminate: z.ZodOptional<z.ZodObject<{
+            caCertPath: z.ZodOptional<z.ZodString>;
+            caKeyPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     filesystem: z.ZodOptional<z.ZodObject<{
         allowWrite: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2532,6 +2509,17 @@ declare type SDKControlApplyFlagSettingsRequest = {
     settings: Record<string, unknown>;
 };
 
+/**
+ * Backgrounds in-flight foreground tasks (Bash commands and subagents). With tool_use_id, targets the single task started by that tool_use block; without it, backgrounds all foreground tasks — the control-request equivalent of pressing Ctrl+B in the terminal. Each blocking tool call returns immediately with a "running in the background" tool_result and the turn continues; the task keeps running and emits a task_notification when it settles.
+ */
+declare type SDKControlBackgroundTasksRequest = {
+    subtype: 'background_tasks';
+    /**
+     * When set, backgrounds only the task whose originating tool_use block has this id. When omitted, backgrounds all foreground tasks (Ctrl+B semantics).
+     */
+    tool_use_id?: string;
+};
+
 /**
  * Drops a pending async user message from the command queue by uuid. No-op if already dequeued for execution.
  */
@@ -2902,7 +2890,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
 
 /**
  * Requests the SDK consumer to render a tool-driven blocking dialog and return the user choice. Used by tools that previously rendered Ink JSX via setToolJSX with an onDone callback.
@@ -3557,6 +3545,7 @@ export declare type SDKSystemMessage = {
 
     }[];
 
+
     fast_mode_state?: FastModeState;
 
 
@@ -4140,6 +4129,10 @@ export declare interface Settings {
                  * Shell command to execute
                  */
                 command: string;
+                /**
+                 * Argument list for exec form. When present, `command` is resolved as an executable and spawned directly with these arguments — no shell. Path placeholders like ${CLAUDE_PLUGIN_ROOT} are substituted per-element as plain strings, so paths with quotes, $, or backticks never reach a shell parser. When absent, `command` runs through a shell (bash on POSIX, PowerShell on Windows without Git Bash).
+                 */
+                args?: string[];
                 /**
                  * Permission rule syntax to filter when this hook runs (e.g., "Bash(git *)"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.
                  */
@@ -4191,6 +4184,10 @@ export declare interface Settings {
                  * Model to use for this prompt hook (e.g., "claude-sonnet-4-6"). If not specified, uses the default small fast model.
                  */
                 model?: string;
+                /**
+                 * Sets the continue value for the decision:"block" produced when ok is false. Default false (turn ends). Whether continue:true lets the turn proceed depends on the event's decision:"block" semantics. On PostToolUse, the reason is fed back to Claude and the turn continues.
+                 */
+                continueOnBlock?: boolean;
                 /**
                  * Custom status message to display in spinner while hook runs
                  */
@@ -4323,9 +4320,9 @@ export declare interface Settings {
      */
     disableAllHooks?: boolean;
     /**
-     * Disable the background-agents fleet (`claude agents`, `--bg`, /background, the on-demand daemon). Typically set in managed settings. Equivalent to CLAUDE_CODE_DISABLE_AGENTS_FLEET=1.
+     * Disable agent view (`claude agents`, `--bg`, /background, the on-demand daemon). Typically set in managed settings. Equivalent to CLAUDE_CODE_DISABLE_AGENT_VIEW=1.
      */
-    disableBackgroundAgents?: boolean;
+    disableAgentView?: boolean;
     /**
      * Disable Remote Control (claude.ai/code, `claude remote-control`, `--remote-control`/`--rc`, auto-start, and the in-session toggle). Typically set in managed settings.
      */
@@ -5024,6 +5021,13 @@ export declare interface Settings {
             allowMachLookup?: string[];
             httpProxyPort?: number;
             socksProxyPort?: number;
+            /**
+             * [EXPERIMENTAL] Enable in-process TLS termination so the per-request filter can see HTTPS request bodies. Provide a CA cert+key, or omit both to have sandbox-runtime generate an ephemeral one for the session.
+             */
+            tlsTerminate?: {
+                caCertPath?: string;
+                caKeyPath?: string;
+            };
         };
         filesystem?: {
             /**
@@ -5273,6 +5277,10 @@ export declare interface Settings {
          */
         startDirectory?: string;
     }[];
+    /**
+     * CLAUDE.md-style instructions injected as organization-managed memory. Only honored from managed/policy settings.
+     */
+    claudeMd?: string;
     /**
      * Glob patterns or absolute paths of CLAUDE.md files to exclude from loading. Patterns are matched against absolute file paths using picomatch. Only applies to User, Project, and Local memory types (Managed/policy files cannot be excluded). Examples: "/home/user/monorepo/CLAUDE.md", "** /code/CLAUDE.md", "** /some-dir/.claude/rules/**"
      */
@@ -5524,6 +5532,7 @@ export declare type SyncHookJSONOutput = {
     systemMessage?: string;
     reason?: string;
 
+
     hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | UserPromptExpansionHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PostToolBatchHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
 };