@anthropic-ai/claude-agent-sdk 0.2.119 → 0.2.121

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.119",
-  "commit": "6f68554839756189e277b8285a18fe47acd9a5a1",
-  "buildDate": "2026-04-23T20:45:14Z",
+  "version": "2.1.121",
+  "commit": "16ffea721a0a39bc787a236dc19fb62307180b75",
+  "buildDate": "2026-04-27T01:51:03Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "31db3444309d5d0f8b85e8782e2dcd86f31f7e48c1a1e83d69b09268c7b4f9a2",
-      "size": 213404000
+      "checksum": "3810e55d47ed4d413de6dc037e34d58948f779a4c6bdeeacf1748d850c5daad6",
+      "size": 215417984
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "52b3b75cfe80c626982b2ffb3a6ce1c797824f257dc275cf0a3c32c202b6a3df",
-      "size": 214951760
+      "checksum": "59d817dde54eeef0d752e7bd3869586e6eb5fa2b1d785c06fb9cda8804166037",
+      "size": 216982224
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "382aa73ea4b07fd8d698e3159b5ef9e1b8739fae7505ba8ddd28b8a6a62819ce",
-      "size": 245500480
+      "checksum": "71b78e6364f97a227b17be40dfcc237461f8d2b1d109444d24b42af0fdefac31",
+      "size": 247466560
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "cca43053f062949495596b11b6fd1b59cf79102adb13bacbe66997e6fae41e4a",
-      "size": 245230208
+      "checksum": "b4b684bbcb3a88029ec419dbc08824b2f3c69656a0aa2374860f9525fc67c98f",
+      "size": 247265920
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "e09bfaedd8bfdeaebe5f1cf9bb81ebeb718312c68fffce379fb51786263143d0",
-      "size": 238225856
+      "checksum": "2f8e2a81f7d41a9cf3e9269fb3237df968194cc7bf8ba478392cd5217d55e8d1",
+      "size": 240191872
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "ef41a11653b39c14db2d343f1f5e2a3af7eb9871c63e64deb6e65919670a4e0b",
-      "size": 239495616
+      "checksum": "d5ad436e256291df5e2248d1026a971229dde43544db3267892afd5c89934eb1",
+      "size": 241531264
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "e18c7dcfad4a3f5d33d202ec2dde630b648cf5b41622154d6210e793c7cceadc",
-      "size": 254478496
+      "checksum": "0a85980a38e9d8fbb2ba51f1d27c3425c7870f75e053ae4be266d23e10edde4a",
+      "size": 253241504
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "9e0deb10c45108612484ce558fad378206d5ac23feb203067450e6c38d001241",
-      "size": 251203232
+      "checksum": "9c9e1c68d50bb80f5e8d4a91645f042d4802a4fb0f87c34a504ecbb69a54860a",
+      "size": 249304224
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.119",
-  "commit": "6f68554839756189e277b8285a18fe47acd9a5a1",
-  "buildDate": "2026-04-23T20:53:09Z",
+  "version": "2.1.121",
+  "commit": "16ffea721a0a39bc787a236dc19fb62307180b75",
+  "buildDate": "2026-04-27T01:58:07Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "d36dfe6670e3fa7e4e6e7a3fd6f707b3946947a825f4070ed2b7e706e2651df0",
-      "size": 44111332,
+      "checksum": "794387f97195b7aff15193e88a260ea8718213c7f1a50ce6165bed77af435d3d",
+      "size": 44532566,
       "bundle": {
-        "checksum": "4feab18b2073311b24e487ada0a582020304147121a1195deef57a0a7b7833a0",
-        "size": 44117376
+        "checksum": "54cb26c375f61ff3d4f6ed57e91135d324c2bd13186788fd0ac95b6882c6c103",
+        "size": 44529587
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "72d7cbe250a5601aadc308b3355f71c529c903a99c1394cebd8e55c1adedbc37",
-      "size": 45861493,
+      "checksum": "8c4163a2647a0da489ed7ccb78408f90603913f7b821e098b794c6ad60ba8985",
+      "size": 46240905,
       "bundle": {
-        "checksum": "96d2cfd075d23b18578b145d02fb78a72d552557d8d6e4228ba7bfafe8a69139",
-        "size": 45864968
+        "checksum": "0afd90ee954cde23a1e8d53ffb4479bb327e82dec3605afb0b718f5a8d7e2f02",
+        "size": 46246963
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "afa715684e2a6bdf906d6019f47991a56fc9f2810493856a56e0da61d434b6b5",
-      "size": 53778693
+      "checksum": "ebdb26ee2f63a2f0fa3da7b4e5acdb313a91648400f5e7ef89148761f6eb905d",
+      "size": 54069121
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "cd5df914e202388aebffcd09d46a994108c9c7ed485497124a501db2868b8bf6",
-      "size": 54299477
+      "checksum": "49ab2b321de1c278d510129856bfd8c9ab735d5eb27496baf4d6c2159875eaa4",
+      "size": 54642591
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "f6b994b3d3926c4993c646b86fd2139e1047a44151edff659c28b56635941771",
-      "size": 52351846
+      "checksum": "3487670ab9fc8918240e025d177e7cb56559efd1fb1056782c8701736ee07345",
+      "size": 52700328
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "40b166987615e99b3d7222d99a0463e7e6da9e4e5ab22d2a6c256e5dc38ab4a9",
-      "size": 52970715
+      "checksum": "dac2d3b20520dd3a7308074ff779f0981bc7caec07c853725898aae532b22db2",
+      "size": 53385809
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "f28aeaa9ce80c77fff046d9298092f32f5db24eae6db41aa51b7a329f178e824",
-      "size": 55932587
+      "checksum": "c40e505e1b90c631fb48cf060eee43da12a4be1030735c5cd6e4c0c387b2eafc",
+      "size": 55720411
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "4c481b40ae9e9ce3ceff4d371ad5974f7cd3c206387204a1b8dbbb9b221e9798",
-      "size": 54060686
+      "checksum": "00c14cbbf8ab6a7711d8c3ec5e04466d16e841fccead240b75e581e6442ea39d",
+      "size": 53850938
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.119",
+  "version": "0.2.121",
   "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.119",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.119",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.119",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.119",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.119",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.119",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.119",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.119"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.121",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.121"
   },
   "files": [
     "sdk.mjs",
@@ -78,5 +78,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.119"
+  "claudeCodeVersion": "2.1.121"
 }

package/sdk.d.ts

@@ -424,6 +424,14 @@ declare type CreateSdkMcpServerOptions = {
     name: string;
     version?: string;
     tools?: Array<SdkMcpToolDefinition<any>>;
+    /**
+     * When true, all tools from this server are always included in the prompt
+     * and never deferred behind tool search. Applied via
+     * `_meta['anthropic/alwaysLoad']` on each tool. Equivalent to
+     * `defer_loading: false` on the API. Per-tool `tool({ alwaysLoad })` still
+     * works and is OR'd with this.
+     */
+    alwaysLoad?: boolean;
 };
 
 export declare type CwdChangedHookInput = BaseHookInput & {
@@ -928,6 +936,10 @@ export declare type McpHttpServerConfig = {
     url: string;
     headers?: Record<string, string>;
     tools?: McpServerToolPolicy[];
+    /**
+     * 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.
+     */
+    alwaysLoad?: boolean;
 };
 
 export declare type McpSdkServerConfig = {
@@ -1029,6 +1041,10 @@ export declare type McpSSEServerConfig = {
     url: string;
     headers?: Record<string, string>;
     tools?: McpServerToolPolicy[];
+    /**
+     * 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.
+     */
+    alwaysLoad?: boolean;
 };
 
 export declare type McpStdioServerConfig = {
@@ -1036,6 +1052,10 @@ export declare type McpStdioServerConfig = {
     command: string;
     args?: string[];
     env?: Record<string, string>;
+    /**
+     * 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.
+     */
+    alwaysLoad?: boolean;
 };
 
 /**
@@ -1343,7 +1363,13 @@ export declare type Options = {
      * When true, `SDKPartialAssistantMessage` events will be emitted during streaming.
      */
     includePartialMessages?: boolean;
-
+    /**
+     * Forward subagent text and thinking blocks as assistant/user messages with
+     * `parent_tool_use_id` set. By default, only tool_use/tool_result blocks from
+     * subagents are emitted (enough for a heartbeat counter). When true, the full
+     * subagent conversation is forwarded so consumers can render a nested transcript.
+     */
+    forwardSubagentText?: boolean;
     /**
      * Controls Claude's thinking/reasoning behavior.
      *
@@ -1612,6 +1638,29 @@ export declare type Options = {
      * Must include `'project'` to load CLAUDE.md files.
      */
     settingSources?: SettingSource[];
+    /**
+     * Skills to enable for the main session. This is the single place to turn
+     * skills on; you do not need to add `'Skill'` to `allowedTools` yourself
+     * when using this option.
+     *
+     * - omitted (default): no SDK auto-configuration. The CLI's own defaults
+     *   still apply, so this is **not** "skills off."
+     * - `'all'`: enable every discovered skill.
+     * - `string[]`: enable only the listed skills. Names match the SKILL.md
+     *   `name` / directory name, or `plugin:skill` for plugin-qualified skills.
+     *
+     * This is a context filter, not a sandbox: unlisted skills are hidden from
+     * the model's listing and rejected by the Skill tool, but their files
+     * remain on disk and are reachable via Read/Bash. Do not store secrets in
+     * skill files.
+     *
+     * @example
+     * ```typescript
+     * skills: 'all'
+     * skills: ['pdf', 'docx']
+     * ```
+     */
+    skills?: string[] | 'all';
     /**
      * Enable debug mode for the Claude Code process.
      * When true, enables verbose debug logging (equivalent to `--debug` CLI flag).
@@ -1888,6 +1937,13 @@ export declare type PostToolUseHookInput = BaseHookInput & {
 export declare type PostToolUseHookSpecificOutput = {
     hookEventName: 'PostToolUse';
     additionalContext?: string;
+    /**
+     * Replaces the tool output before it is sent to the model
+     */
+    updatedToolOutput?: unknown;
+    /**
+     * Replaces the output for MCP tools only. Prefer updatedToolOutput, which works for all tools
+     */
     updatedMCPToolOutput?: unknown;
 };
 
@@ -2057,10 +2113,12 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * denial, missing file, or transport error.
      *
      * @param path - File path (relative to cwd or absolute)
-     * @param options - Optional maxBytes cap (default 1MB)
+     * @param options - Optional maxBytes cap (default 1MB) and encoding
+     *   (default utf-8; pass 'base64' for binary files like images)
      */
     readFile(path: string, options?: {
         maxBytes?: number;
+        encoding?: 'utf-8' | 'base64';
     }): Promise<SDKControlReadFileResponse | null>;
     /**
      * Reload plugins from disk and return the refreshed commands, agents,
@@ -2102,6 +2160,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
 
 
 
+
     /**
      * Reconnect an MCP server by name.
      * Throws on failure.
@@ -2636,6 +2695,10 @@ declare type SDKControlReadFileRequest = {
     subtype: 'read_file';
     path: string;
     max_bytes?: number;
+    /**
+     * How to encode the bytes in `contents`. Defaults to utf-8 (lossy for binary); pass 'base64' to read images.
+     */
+    encoding?: 'utf-8' | 'base64';
 };
 
 /**
@@ -2645,6 +2708,10 @@ export declare type SDKControlReadFileResponse = {
     contents: string;
     absPath: string;
     truncated?: boolean;
+    /**
+     * Set when the request asked for base64. Absent means utf-8 — including when an older CLI ignored the request's encoding field.
+     */
+    encoding?: 'base64';
 };
 
 /**
@@ -2683,7 +2750,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;
+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;
 
 /**
  * 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.
@@ -3374,7 +3441,7 @@ export declare type SDKTaskUpdatedMessage = {
     subtype: 'task_updated';
     task_id: string;
     /**
-     * Wire-safe subset of TaskState fields that changed. Excludes abortController, unregisterCleanup, messages, result. Clients merge into their local task map.
+     * Wire-safe subset of TaskState fields that changed. Excludes abortController, messages, result. Clients merge into their local task map.
      */
     patch: {
         status?: 'pending' | 'running' | 'completed' | 'failed' | 'killed';
@@ -3869,7 +3936,7 @@ export declare interface Settings {
                  */
                 if?: string;
                 /**
-                 * Shell interpreter. 'bash' uses your $SHELL (bash/zsh/sh); 'powershell' uses pwsh. Defaults to bash.
+                 * Shell interpreter. 'bash' uses your $SHELL (bash/zsh/sh); 'powershell' uses pwsh. Defaults to bash (powershell on Windows without Git Bash).
                  */
                 shell?: 'bash' | 'powershell';
                 /**
@@ -4042,6 +4109,10 @@ export declare interface Settings {
      * Disable all hooks and statusLine execution
      */
     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.
+     */
+    disableBackgroundAgents?: boolean;
     /**
      * Disable inline shell execution in skills and custom slash commands from user, project, or plugin sources. Commands are replaced with a placeholder instead of being run.
      */
@@ -4085,6 +4156,10 @@ export declare interface Settings {
          * Re-run the status line command every N seconds in addition to event-driven updates
          */
         refreshInterval?: number;
+        /**
+         * Hide the built-in `-- INSERT --` / `-- VISUAL --` indicator below the prompt. Use this when your status line script renders `vim.mode` itself.
+         */
+        hideVimModeIndicator?: boolean;
     };
     /**
      * URL template for PR links in the footer badge and inline messages. Placeholders: {host} {owner} {repo} {number} {url}. Example: "https://reviews.example.com/{owner}/{repo}/pull/{number}"
@@ -4268,6 +4343,8 @@ export declare interface Settings {
                          * Specific commit SHA to use
                          */
                         sha?: string;
+                    } | {
+                        source: 'unsupported';
                     };
                     description?: string;
                     version?: string;
@@ -4456,6 +4533,8 @@ export declare interface Settings {
                  * Specific commit SHA to use
                  */
                 sha?: string;
+            } | {
+                source: 'unsupported';
             };
             description?: string;
             version?: string;
@@ -4634,6 +4713,8 @@ export declare interface Settings {
                  * Specific commit SHA to use
                  */
                 sha?: string;
+            } | {
+                source: 'unsupported';
             };
             description?: string;
             version?: string;
@@ -5022,6 +5103,10 @@ export declare interface Settings {
      * Start Remote Control bridge automatically each session
      */
     remoteControlAtStartup?: boolean;
+    /**
+     * When no background service is running: 'transient' spawns one for this login session; 'ask' offers to install it persistently
+     */
+    daemonColdStart?: 'transient' | 'ask';
     /**
      * Mirror local sessions to claude.ai as view-only (no remote control)
      */
@@ -5034,6 +5119,10 @@ export declare interface Settings {
      * Allow Claude to push proactive mobile notifications
      */
     agentPushNotifEnabled?: boolean;
+    /**
+     * Prevent claude-cli:// protocol handler registration with the OS
+     */
+    disableDeepLinkRegistration?: 'disable';
     [k: string]: unknown;
 }