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

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.120",
-  "commit": "080f07fb4224786b965b9ea0a35f0cff594f2eb6",
-  "buildDate": "2026-04-24T21:51:03Z",
+  "version": "2.1.122",
+  "commit": "70046c58fb1c720f82bcbf39a3447dadf5bd33b2",
+  "buildDate": "2026-04-28T01:50:47Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "fad8faf49c7b1b454c38d785b75e17edbdadc7ffaf450b31349aafc6560b8ef6",
-      "size": 213981440
+      "checksum": "4b01075bd923084fe56124bfb647f5eca98c2b1fa34cb039d2e75ccc84af4b86",
+      "size": 215880320
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "ad68f225e96db8b7d12d0c31f0343bc3227ea2886ecefae2f483cb32310b0004",
-      "size": 215529168
+      "checksum": "8c56cd72093c4b0002c7ec04ad69c0f0d04f0042c9fe399c194639f2d350934d",
+      "size": 217444560
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "a6d0d25946c32a24b4e04471af70845a45428ca069fb3b489345f2a683262279",
-      "size": 246024768
+      "checksum": "ec608f447cf8d8a323e174a7b95f664d4835a77562c31f8562fa35b01e326d07",
+      "size": 247925312
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "12c0d6eb6d39dc2597fd131d8ea4f12ed8bf25b47dadd9173878e6d025959c9f",
-      "size": 245832320
+      "checksum": "5525f482dd1fa6e3fe5fa48ae7a82dd9e2db7293af165a56c95fcc7899cd8468",
+      "size": 247732864
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "8b8d02e87c842f90d5ad47321ea6f42b581fafe7cd50cd9fba5b27fe89ff51df",
-      "size": 238750080
+      "checksum": "9faa638e6613adc80af412f4896e9a289d9eb8c90e437030883d1193a64a75c2",
+      "size": 240650624
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "5406ef30a37413e9e6fdac1c641742e8c2b88f033256e8ba1ece0b4419d30157",
-      "size": 240097664
+      "checksum": "a1fb02167a8eac04721f072148244a6954705529bc0bd428d10d002e84ef8e4d",
+      "size": 241998208
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "987d99dfae28c9a554bbb15a9d432cfa75df7c175db523c232ef68950068df4c",
-      "size": 251858080
+      "checksum": "65c4534c59e25cf3d490f1109e55e8193317489848c6e834cea21ceff2a5e4b4",
+      "size": 253690528
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "2bf424fe9772eadae4dc814126b5a1184d5d1d63be9f342fde251580d678fd04",
-      "size": 247922336
+      "checksum": "179030909886e384edadbb8538615c88d8d259f879b56f0747abf5a3772b83f0",
+      "size": 249753248
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.120",
-  "commit": "080f07fb4224786b965b9ea0a35f0cff594f2eb6",
-  "buildDate": "2026-04-24T21:58:09Z",
+  "version": "2.1.122",
+  "commit": "70046c58fb1c720f82bcbf39a3447dadf5bd33b2",
+  "buildDate": "2026-04-28T01:58:09Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "adcdcaf24ae240fdc59a2c5e790c2d1eb3d93cb729ff9ba9993a3801553c7201",
-      "size": 44236339,
+      "checksum": "de5f482f640d24554e402c5ccaa9ae11c922ff4467a4eec31ea1b44385f0eec7",
+      "size": 44626967,
       "bundle": {
-        "checksum": "cf5f610c299ce7eddc8b83a32aff1aba4308b93e9d25539549f3c52c2315b5bb",
-        "size": 44244892
+        "checksum": "da7354edbd69af353c195b9c9b2a0dea32aa5f777c6287211148da2999135bee",
+        "size": 44632790
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "b2cbcbe5e57a7fbd89d73fdc1f6488116034aaa3c85b59530552cae50b478451",
-      "size": 45941282,
+      "checksum": "16b2a3c3f2a4fab48558881ec3cb055d959c573b96e3f3ff068a750fd7695d77",
+      "size": 46355778,
       "bundle": {
-        "checksum": "ad46d2cb1134bde351eb95406f07f33be2b27410b8e1029fc028b86f95a969fb",
-        "size": 45945061
+        "checksum": "70cb14bd507175bc2f2786cfc594b0805ac743c2f4e46ca526d5f3740f1937a1",
+        "size": 46362451
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "be345830447e7ac70aee331f1faae49c1f0c621aae0dfcec5f4555635a723691",
-      "size": 53802919
+      "checksum": "39e80b05bcc39fe36a3e2be4d06b38e6995eebc4ac1f03dba0eef306c8e48b86",
+      "size": 54153349
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "9a00a29b1acc0c18e214e18d435176baaab24ab49f33b67c25d30a8689378325",
-      "size": 54375672
+      "checksum": "1eab939d384f3cf2f7f7c667ceeb5e59297377b7df64fd854f185a2000492074",
+      "size": 54752600
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "db04f97ee06c0e6ec43cfeb1b78f76fafc245a9dc2107a821bdca6c451cccc02",
-      "size": 52412046
+      "checksum": "b012fe945ce7a0ce44cf84cce5e97431a7757c17efad615b12828939f7ae3450",
+      "size": 52792068
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "ac0c7ebb578d0502cd35e1384eadf3a16307ab8c6a35ca9fb7af35ce0c9dd9ed",
-      "size": 53073404
+      "checksum": "84c55cc4a14646e6e5fb1b484cfb8c1d098bf6b27dbfa5cb59b455d2838ea7ec",
+      "size": 53459786
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "573e670be41609ef16e34ff686a8e4aeb3249fca6166fd0978d2ba49750955d8",
-      "size": 55443349
+      "checksum": "3b1bf92de8c1d955ec9da8450cc8f66234ad1ee791cf136d678544c0842b70e6",
+      "size": 55812105
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "4713446d69307b5a026e6553ae64e6518ef82727ebaa1a8a9b09f80e5637b73b",
-      "size": 53562966
+      "checksum": "4dd5c1f3aec4f350bc6a9b3c537df64db3ec27bbd6991b5fe0c406bf503f829d",
+      "size": 53919684
     }
   }
 }

package/package.json

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

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;
 };
 
 /**
@@ -1737,6 +1757,7 @@ export declare type Options = {
      */
     title?: string;
 
+
     /**
      * Custom function to spawn the Claude Code process.
      * Use this to run Claude Code in VMs, containers, or remote environments.
@@ -1917,6 +1938,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 +2114,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,
@@ -2552,6 +2582,7 @@ declare type SDKControlInitializeRequest = {
      * When provided, only skills whose names match an entry are loaded into the main session system prompt, using the same rules as AgentDefinition.skills: exact name, plugin-qualified name, or ":name" suffix. Omit to load every discovered skill. Applies to the main session only; subagents use AgentDefinition.skills.
      */
     skills?: string[];
+
     promptSuggestions?: boolean;
     agentProgressSummaries?: boolean;
     forwardSubagentText?: boolean;
@@ -2666,6 +2697,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 +2710,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 +4111,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 +5106,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';
     /**