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

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.120",
-  "commit": "080f07fb4224786b965b9ea0a35f0cff594f2eb6",
-  "buildDate": "2026-04-24T21:51:03Z",
+  "version": "2.1.121",
+  "commit": "16ffea721a0a39bc787a236dc19fb62307180b75",
+  "buildDate": "2026-04-27T01:51:03Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "fad8faf49c7b1b454c38d785b75e17edbdadc7ffaf450b31349aafc6560b8ef6",
-      "size": 213981440
+      "checksum": "3810e55d47ed4d413de6dc037e34d58948f779a4c6bdeeacf1748d850c5daad6",
+      "size": 215417984
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "ad68f225e96db8b7d12d0c31f0343bc3227ea2886ecefae2f483cb32310b0004",
-      "size": 215529168
+      "checksum": "59d817dde54eeef0d752e7bd3869586e6eb5fa2b1d785c06fb9cda8804166037",
+      "size": 216982224
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "a6d0d25946c32a24b4e04471af70845a45428ca069fb3b489345f2a683262279",
-      "size": 246024768
+      "checksum": "71b78e6364f97a227b17be40dfcc237461f8d2b1d109444d24b42af0fdefac31",
+      "size": 247466560
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "12c0d6eb6d39dc2597fd131d8ea4f12ed8bf25b47dadd9173878e6d025959c9f",
-      "size": 245832320
+      "checksum": "b4b684bbcb3a88029ec419dbc08824b2f3c69656a0aa2374860f9525fc67c98f",
+      "size": 247265920
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "8b8d02e87c842f90d5ad47321ea6f42b581fafe7cd50cd9fba5b27fe89ff51df",
-      "size": 238750080
+      "checksum": "2f8e2a81f7d41a9cf3e9269fb3237df968194cc7bf8ba478392cd5217d55e8d1",
+      "size": 240191872
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "5406ef30a37413e9e6fdac1c641742e8c2b88f033256e8ba1ece0b4419d30157",
-      "size": 240097664
+      "checksum": "d5ad436e256291df5e2248d1026a971229dde43544db3267892afd5c89934eb1",
+      "size": 241531264
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "987d99dfae28c9a554bbb15a9d432cfa75df7c175db523c232ef68950068df4c",
-      "size": 251858080
+      "checksum": "0a85980a38e9d8fbb2ba51f1d27c3425c7870f75e053ae4be266d23e10edde4a",
+      "size": 253241504
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "2bf424fe9772eadae4dc814126b5a1184d5d1d63be9f342fde251580d678fd04",
-      "size": 247922336
+      "checksum": "9c9e1c68d50bb80f5e8d4a91645f042d4802a4fb0f87c34a504ecbb69a54860a",
+      "size": 249304224
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.120",
-  "commit": "080f07fb4224786b965b9ea0a35f0cff594f2eb6",
-  "buildDate": "2026-04-24T21:58:09Z",
+  "version": "2.1.121",
+  "commit": "16ffea721a0a39bc787a236dc19fb62307180b75",
+  "buildDate": "2026-04-27T01:58:07Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "adcdcaf24ae240fdc59a2c5e790c2d1eb3d93cb729ff9ba9993a3801553c7201",
-      "size": 44236339,
+      "checksum": "794387f97195b7aff15193e88a260ea8718213c7f1a50ce6165bed77af435d3d",
+      "size": 44532566,
       "bundle": {
-        "checksum": "cf5f610c299ce7eddc8b83a32aff1aba4308b93e9d25539549f3c52c2315b5bb",
-        "size": 44244892
+        "checksum": "54cb26c375f61ff3d4f6ed57e91135d324c2bd13186788fd0ac95b6882c6c103",
+        "size": 44529587
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "b2cbcbe5e57a7fbd89d73fdc1f6488116034aaa3c85b59530552cae50b478451",
-      "size": 45941282,
+      "checksum": "8c4163a2647a0da489ed7ccb78408f90603913f7b821e098b794c6ad60ba8985",
+      "size": 46240905,
       "bundle": {
-        "checksum": "ad46d2cb1134bde351eb95406f07f33be2b27410b8e1029fc028b86f95a969fb",
-        "size": 45945061
+        "checksum": "0afd90ee954cde23a1e8d53ffb4479bb327e82dec3605afb0b718f5a8d7e2f02",
+        "size": 46246963
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "be345830447e7ac70aee331f1faae49c1f0c621aae0dfcec5f4555635a723691",
-      "size": 53802919
+      "checksum": "ebdb26ee2f63a2f0fa3da7b4e5acdb313a91648400f5e7ef89148761f6eb905d",
+      "size": 54069121
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "9a00a29b1acc0c18e214e18d435176baaab24ab49f33b67c25d30a8689378325",
-      "size": 54375672
+      "checksum": "49ab2b321de1c278d510129856bfd8c9ab735d5eb27496baf4d6c2159875eaa4",
+      "size": 54642591
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "db04f97ee06c0e6ec43cfeb1b78f76fafc245a9dc2107a821bdca6c451cccc02",
-      "size": 52412046
+      "checksum": "3487670ab9fc8918240e025d177e7cb56559efd1fb1056782c8701736ee07345",
+      "size": 52700328
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "ac0c7ebb578d0502cd35e1384eadf3a16307ab8c6a35ca9fb7af35ce0c9dd9ed",
-      "size": 53073404
+      "checksum": "dac2d3b20520dd3a7308074ff779f0981bc7caec07c853725898aae532b22db2",
+      "size": 53385809
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "573e670be41609ef16e34ff686a8e4aeb3249fca6166fd0978d2ba49750955d8",
-      "size": 55443349
+      "checksum": "c40e505e1b90c631fb48cf060eee43da12a4be1030735c5cd6e4c0c387b2eafc",
+      "size": 55720411
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "4713446d69307b5a026e6553ae64e6518ef82727ebaa1a8a9b09f80e5637b73b",
-      "size": 53562966
+      "checksum": "00c14cbbf8ab6a7711d8c3ec5e04466d16e841fccead240b75e581e6442ea39d",
+      "size": 53850938
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.120",
+  "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.120",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.120",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.120",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.120",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.120",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.120",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.120",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.120"
+    "@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.120"
+  "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;
 };
 
 /**
@@ -1917,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;
 };
 
@@ -2086,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,
@@ -2666,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';
 };
 
 /**
@@ -2675,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';
 };
 
 /**
@@ -4072,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.
      */
@@ -5063,7 +5104,7 @@ export declare interface Settings {
      */
     remoteControlAtStartup?: boolean;
     /**
-     * When no background daemon is running: 'transient' spawns one for this login session; 'ask' offers to install a persistent service
+     * When no background service is running: 'transient' spawns one for this login session; 'ask' offers to install it persistently
      */
     daemonColdStart?: 'transient' | 'ask';
     /**