@anthropic-ai/claude-agent-sdk 0.3.206 → 0.3.208

package/manifest.json

@@ -1,47 +1,69 @@
 {
-  "version": "2.1.206",
-  "commit": "edc8ebf7f852d3abffad32a5bf8e49e439f92afb",
-  "buildDate": "2026-07-09T01:48:20Z",
+  "version": "2.1.208",
+  "commit": "1ee05a7fb989fe19c9aed959c5762daf14ca2ffb",
+  "buildDate": "2026-07-13T20:37:45Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "3197aba4442dbd5b3df42b6f35e6d7bd03b5e48ce18b7a3c5c6f5f8c28e03b7f",
-      "size": 240395024
+      "checksum": "051c7f28871b158132ac03a6140f2f2ab4046b18ecc4f7a91a2ac4d54774551e",
+      "size": 240245936
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "b1e1636917a12c7d4e1fa54cd13f7f76ba3779fb988180610b6ca483258c2f46",
-      "size": 248431568
+      "checksum": "804ea81cb1e2b5f883c2490fc668fd19ce185e37b9b9991f5832d38dc62e2ff4",
+      "size": 249754128
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "cb8ccaf4ae6beb558747227a362010c6b32b4f4a5868c3a7e96aa9972fc6ef58",
-      "size": 255376112
+      "checksum": "81e5dd48377bfd3cb733820e4e23f2294c925cba1e52dbeada69f46929f0c4a6",
+      "size": 256686832
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "d131494be407ff56a62f4e99a96ba60102002d01e3b6b1494db16bef4b7f060f",
-      "size": 258566968
+      "checksum": "125372839bc827ca24dd72382627b291fbca615408d732fe3291bc16723ce7f3",
+      "size": 259820344
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "b1920556c3b077694d52397f4e5221df2419ad9b44af641be0f49647b51f87ad",
-      "size": 248624312
+      "checksum": "7dbc2aafb229adfa1f92828f4eb947797e1682f99d61426e9a905e5d9187aa05",
+      "size": 249935032
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "b0d780783401de979024c25f14a2cae665873afbcfe718c090b73e13c4cd08a0",
-      "size": 253251968
+      "checksum": "2740ca0ecb0160b5ab107883b8040be0d3434a52a3f45685b481509a788e7583",
+      "size": 254480768
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "d5072b25b9a20bffb24625d36129a05ed2be4d2eb7e35625aad6aa35596892c2",
-      "size": 248682144
+      "checksum": "629e8a370f81c749d1b0d773e14ce2d92096b70be42fd64a93aff55ab6155d74",
+      "size": 251177632
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "c17ac3a5a8edf5cfa658e82bd41fcf83170af21538e51cc9d4cbaeefe382aba3",
-      "size": 243149984
+      "checksum": "6ce020558d53c993646d923c350719f585ee6fffcd88d32408c5e4481d0a9bd7",
+      "size": 245527200
     }
+  },
+  "sdkCompat": {
+    "testedWrapperVersions": [
+      "0.3.181",
+      "0.3.182",
+      "0.3.183",
+      "0.3.185",
+      "0.3.186",
+      "0.3.187",
+      "0.3.190",
+      "0.3.191",
+      "0.3.195",
+      "0.3.196",
+      "0.3.197",
+      "0.3.198",
+      "0.3.201",
+      "0.3.202",
+      "0.3.204",
+      "0.3.205",
+      "0.3.207"
+    ],
+    "harnessSchema": 1
   }
 }

package/manifest.zst.json

@@ -1,55 +1,77 @@
 {
-  "version": "2.1.206",
-  "commit": "edc8ebf7f852d3abffad32a5bf8e49e439f92afb",
-  "buildDate": "2026-07-09T01:50:10Z",
+  "version": "2.1.208",
+  "commit": "1ee05a7fb989fe19c9aed959c5762daf14ca2ffb",
+  "buildDate": "2026-07-13T20:39:36Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "f82b3ad6293ce2c991e63a7e5af05ad7d8b78c6a5f454838b928116ea8506b45",
-      "size": 50458380,
+      "checksum": "b220d6bb4516024dab068317ce21d498b62b19b354730ebb81ba49f5866574ec",
+      "size": 49565873,
       "bundle": {
-        "checksum": "6a7ff1b3d4fc5739a9befc4df3a6419dedab342579f9f9fb4c26a356dddec052",
-        "size": 50456788
+        "checksum": "d7ce2a03069b7ded0988c1deebcdfcf25b7c63357a98f2e3884ecf1b992510b6",
+        "size": 49569854
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "25419961c3d901b18b0d63bb2efe3e68c47629239f9872ac08139f8f7559216e",
-      "size": 53474125,
+      "checksum": "07d2a301f0ef29939aee05d7591494664a73b21bb85d8613e0f1223a8652ced7",
+      "size": 54015986,
       "bundle": {
-        "checksum": "6cbf6ee82fedf869ccde175ae739ed8740e517a5caad1f2c5a9aa400ec5b0161",
-        "size": 53484346
+        "checksum": "a6034ffaf810ee9dc10f08a2e0396b106c4df9fa9999017ea03eb0e3ec3e8e3a",
+        "size": 54021305
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "a6a1698b6dc9438deab622618756e735f29e22a624bdf5d382e9a9dd835438fd",
-      "size": 58141512
+      "checksum": "6f8c4b8ba2d2dbec060f9ca4ce98ba693eda22b3db14fd00708c2759d4d115f7",
+      "size": 58629933
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "a224eb404540adc8f3bbd29165ff3c070c1550c1e629e62d7effd6c673d1d79b",
-      "size": 59407746
+      "checksum": "a8c707e2f018248cf0127eba5ec5634d3c0681d0d313762876c09ff0c2301e86",
+      "size": 59938110
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "ef98d868f5695fbd05fdf3b83f1df52e81a5024022b22fb999a1f3e48d5b3d3b",
-      "size": 56828247
+      "checksum": "7fe926d8cbb794cc9e250bb55af4c3dcb1aa7c81f070002e3ae75984ad149350",
+      "size": 57348271
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "316fdfb584e22897aea3c6532f93f00f93b86f9af64d2422295a7a93da809758",
-      "size": 58218590
+      "checksum": "e9bafb2e112a7445e7f37503569d9860311095423a72299b0c9464dc59963e85",
+      "size": 58724333
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "a5733df130abe206b7ba95d1c1c8bcc40c661a8284b1c11409cc072eb41944bd",
-      "size": 59528232
+      "checksum": "4d6b9b426e94963691908b3a98c96a36ee13570fac19bf8e44532e663aaf1ab1",
+      "size": 60323765
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "e2f74a9b7c5bc2ba9b9650cc654c87b4a71f1df453f99ab427788bd081ba681e",
-      "size": 57558450
+      "checksum": "7e1f02ccda540039e9b39cd95e5fa2c5d0d72063b9ca2e89301f9b862d5382cd",
+      "size": 58291430
     }
+  },
+  "sdkCompat": {
+    "testedWrapperVersions": [
+      "0.3.181",
+      "0.3.182",
+      "0.3.183",
+      "0.3.185",
+      "0.3.186",
+      "0.3.187",
+      "0.3.190",
+      "0.3.191",
+      "0.3.195",
+      "0.3.196",
+      "0.3.197",
+      "0.3.198",
+      "0.3.201",
+      "0.3.202",
+      "0.3.204",
+      "0.3.205",
+      "0.3.207"
+    ],
+    "harnessSchema": 1
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.206",
+  "version": "0.3.208",
   "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.206",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.206",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.206",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.206",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.206",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.206",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.206",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.206"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.208",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.208"
   },
   "files": [
     "sdk.mjs",
@@ -80,5 +80,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.206"
+  "claudeCodeVersion": "2.1.208"
 }

package/sdk-tools.d.ts

@@ -97,6 +97,7 @@ export type AgentOutput =
       content: {
         type: "text";
         text: string;
+        citations?: unknown[] | null;
       }[];
       resolvedModel?: string;
       totalToolUseCount: number;
@@ -111,11 +112,14 @@ export type AgentOutput =
           web_search_requests: number;
           web_fetch_requests: number;
         } | null;
-        service_tier: ("standard" | "priority" | "batch") | null;
+        service_tier: string | null;
         cache_creation: {
           ephemeral_1h_input_tokens: number;
           ephemeral_5m_input_tokens: number;
         } | null;
+        inference_geo?: string | null;
+        speed?: string | null;
+        iterations?: unknown;
       };
       toolStats?: {
         readCount: number;
@@ -125,12 +129,16 @@ export type AgentOutput =
         linesAdded: number;
         linesRemoved: number;
         otherToolCount: number;
+        frameCount?: number;
       };
       status: "completed";
       prompt: string;
+      worktreePath?: string;
+      worktreeBranch?: string;
     }
   | {
       status: "async_launched";
+      isAsync?: true;
       /**
        * The ID of the async agent
        */
@@ -2904,6 +2912,7 @@ export interface GrepOutput {
   content?: string;
   numLines?: number;
   numMatches?: number;
+  totalFiles?: number;
   appliedLimit?: number;
   appliedOffset?: number;
 }
@@ -3102,7 +3111,7 @@ export interface WebFetchOutput {
   url: string;
   artifactRead?: {
     slug: string;
-    ver: string;
+    ver?: string;
   };
 }
 export interface WebSearchOutput {

package/sdk.d.ts

@@ -462,7 +462,8 @@ declare namespace coreTypes {
  * Creates an MCP server instance that can be used with the SDK transport.
  * This allows SDK users to define custom tools that run in the same process.
  *
- * If your SDK MCP calls will run longer than 60s, override CLAUDE_CODE_STREAM_CLOSE_TIMEOUT
+ * Tool calls are bounded by the MCP tool-call timeout — the MCP_TOOL_TIMEOUT
+ * env var (ms), effectively unbounded by default.
  */
 export declare function createSdkMcpServer(_options: CreateSdkMcpServerOptions): McpSdkServerConfigWithInstance;
 
@@ -3688,11 +3689,11 @@ declare type SDKControlSetColorRequest = {
 };
 
 /**
- * Sets the maximum number of thinking tokens for extended thinking. thinking_display optionally sets the thinking display mode for the rest of the session: a value replaces the session display mode, null clears it back to the API default, and when omitted the display mode from session start (--thinking-display) is kept.
+ * Sets the maximum number of thinking tokens for extended thinking. When max_thinking_tokens is omitted or null, thinking resets to the session default: any mid-session budget override is cleared (back to the spawn-time budget, if one was set), and thinking stays off for sessions that have it disabled. thinking_display optionally sets the thinking display mode for the rest of the session: a value replaces the session display mode, null clears it back to the API default, and when omitted the display mode from session start (--thinking-display) is kept.
  */
 declare type SDKControlSetMaxThinkingTokensRequest = {
     subtype: 'set_max_thinking_tokens';
-    max_thinking_tokens: number | null;
+    max_thinking_tokens?: number | null;
     thinking_display?: ('summarized' | 'omitted') | null;
 };
 
@@ -3994,7 +3995,7 @@ export declare type SDKModelRefusalFallbackMessage = {
 };
 
 /**
- * Emitted when the model ends the stream with stop_reason "refusal" and no retry runs: no fallback model is configured, or per-category routing declined the retry (the refusal category has no fallback map entry). The structured counterpart to detecting stop_reason "refusal" on the assistant error frame. Not emitted when the retry ran or the user declined the retry dialog (model_refusal_fallback covers the retry case). Absent from older CLIs.
+ * Emitted when the model ends the stream with stop_reason "refusal" and no retry runs: no fallback model is configured, or per-category routing declined the retry (the mapped fallback target is unresolvable, or CLAUDE_CODE_REFUSAL_FALLBACK_CATCH_ALL is explicitly disabled and the refusal category has no fallback map entry). The structured counterpart to detecting stop_reason "refusal" on the assistant error frame. Not emitted when the retry ran or the user declined the retry dialog (model_refusal_fallback covers the retry case). Absent from older CLIs.
  */
 export declare type SDKModelRefusalNoFallbackMessage = {
     type: 'system';
@@ -4441,6 +4442,9 @@ export declare type SDKUserMessage = {
     message: MessageParam;
     parent_tool_use_id: string | null;
     isSynthetic?: boolean;
+    /**
+     * Structured tool output — the tool's full Output object, not the string content sent to the model. The shape is per-tool, keyed by the matching tool_use block's name (see the *Output types in toolTypes); MCP and dynamic tools carry their own shapes, so the field stays unknown-typed. For the Agent/Task tool the completed shape is AgentToolCompletedOutput: the subagent's final report without the model-directed agentId/usage trailer, plus run totals — render from it instead of parsing the tool_result text.
+     */
     tool_use_result?: unknown;
     priority?: 'now' | 'next' | 'later';
     origin?: SDKMessageOrigin;
@@ -4483,6 +4487,9 @@ export declare type SDKUserMessageReplay = {
     message: MessageParam;
     parent_tool_use_id: string | null;
     isSynthetic?: boolean;
+    /**
+     * Structured tool output — the tool's full Output object, not the string content sent to the model. The shape is per-tool, keyed by the matching tool_use block's name (see the *Output types in toolTypes); MCP and dynamic tools carry their own shapes, so the field stays unknown-typed. For the Agent/Task tool the completed shape is AgentToolCompletedOutput: the subagent's final report without the model-directed agentId/usage trailer, plus run totals — render from it instead of parsing the tool_result text.
+     */
     tool_use_result?: unknown;
     priority?: 'now' | 'next' | 'later';
     origin?: SDKMessageOrigin;
@@ -6346,6 +6353,12 @@ export declare interface Settings {
      * Key binding mode for the prompt input
      */
     editorMode?: 'normal' | 'vim';
+    /**
+     * 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".
+     */
+    vimInsertModeRemaps?: {
+        [k: string]: unknown;
+    };
     /**
      * Show full tool output instead of truncated summaries
      */
@@ -6353,7 +6366,7 @@ export declare interface Settings {
     /**
      * Preferred OS notification channel
      */
-    preferredNotifChannel?: 'auto' | 'iterm2' | 'iterm2_with_bell' | 'terminal_bell' | 'kitty' | 'ghostty' | 'notifications_disabled';
+    preferredNotifChannel?: 'auto' | 'iterm2' | 'terminal_bell' | 'iterm2_with_bell' | 'kitty' | 'ghostty' | 'notifications_disabled';
     /**
      * Automatically compact conversation when context fills
      */