@anthropic-ai/claude-agent-sdk 0.3.247 → 0.3.248

package/manifest.json

@@ -1,52 +1,51 @@
 {
-  "version": "2.1.247",
-  "commit": "89c726188daf6407b6b57bf67d312f2958e5b9f2",
-  "buildDate": "2026-08-26T06:08:58Z",
+  "version": "2.1.248",
+  "commit": "8c9482ad0510ad5e3c88f0ebe6f035ec148f73e2",
+  "buildDate": "2026-08-27T19:38:50Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "5086b9b64d8bb842e1f599cdd3767ab08c6b2266e462fcc5686ae4b019cca8f7",
-      "size": 233073008
+      "checksum": "a3f276daa51919f378bcd797d44f8e3d09653c2858123157d272de38952efeef",
+      "size": 206463136
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "162e65d7bf8735dbcdc75b0122dbb126d5704a00e682bbdfc413749188a20cfd",
-      "size": 241972656
+      "checksum": "35c21b09d049a4d040c511cd9f73de01df83aa1d4b35a43ae1353bde413b42bc",
+      "size": 215124048
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "a68bb633f85e4a0e73465952ea624cf18992c3fa4db615feeb942ffad57d082a",
-      "size": 249617856
+      "checksum": "76655a3731274f36236632b9acbcb9bef7055de20041c411b761856043fbc0df",
+      "size": 223141128
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "5fb321bf417ffc5cd4e3f36e7c9c7e029bf47aaa36d5621db979fcc5e6eabe15",
-      "size": 250162696
+      "checksum": "3edee3cb054bd6823674fd60d5c0e442825b28ee8fbf815af2d16bf0de072e16",
+      "size": 223599960
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "7c776ebf17adf53a1a6c844356e9713c0a40826b563df6fd670bce00c3f768f8",
-      "size": 242300472
+      "checksum": "ca9cabd7c636889de73c399d31be4f115fd2737c64482ada7bf4b1c0d51448f3",
+      "size": 215889472
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "8bb6b5b1c6c4f08f9c5047153425c32d5041180065537f3da78f6fadf42b40ee",
-      "size": 243924856
+      "checksum": "155e1aa56d0c7e2aaae92788c414e7c43315220289bbd38f7a89ba33d07ff48f",
+      "size": 217575288
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "00e5be0a8b69893cad9259a1e8b80d59be8f3eb367d4a16c19f91bcd279423b7",
-      "size": 253204128
+      "checksum": "c322169422b45ec4bbfeae3aae6cfd6367a622b0d12f06ba9766e18bb8eca2af",
+      "size": 226708128
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "a6b097f8cfb742f66cced452fc9260a6302637379813c06a4f4516aa2c4917f7",
-      "size": 244317344
+      "checksum": "d3ee9756700a4e7642216e04f1a57baba9633732de9d85a4b7918c4731e4b572",
+      "size": 217812640
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.210",
       "0.3.211",
       "0.3.212",
       "0.3.214",

package/manifest.zst.json

@@ -1,60 +1,59 @@
 {
-  "version": "2.1.247",
-  "commit": "89c726188daf6407b6b57bf67d312f2958e5b9f2",
-  "buildDate": "2026-08-26T06:10:18Z",
+  "version": "2.1.248",
+  "commit": "8c9482ad0510ad5e3c88f0ebe6f035ec148f73e2",
+  "buildDate": "2026-08-27T19:40:05Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "8ca071dbb165f818b1091d0756932aa7307d19a80c2db540b3e9c501c39bcf7a",
-      "size": 68851450,
+      "checksum": "b29c2c80dd0e93a692fdfd910204b04b61cc98983634bfb7d7ee3882809b4568",
+      "size": 63732872,
       "bundle": {
-        "checksum": "5298653b09fe0f382fd79f8fbe5a48d474b6df563665b40b160153ab156cd35f",
-        "size": 68850320
+        "checksum": "19cdcfee1314ed0958a7805ce4dd000b4651d0cecca5f6bbcd9ef68976628a32",
+        "size": 63735676
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "c739be8ab289e634bf8a8a2028a68284b32e4ac46e2ee4424227ef46133ee687",
-      "size": 73132830,
+      "checksum": "bb04d8fa542d01b96b6ddee76560667c50eeefb4cfb3b7ad5b9dc58d36dbfa5f",
+      "size": 67819333,
       "bundle": {
-        "checksum": "f413c2596ffc2b7cb188b581e7e5105b34dbca7a7d5147c2621f344b9197d89e",
-        "size": 73136601
+        "checksum": "2db3fd3b76a70a421703ebfc23afee17cb40dfbf8b0bd46a5288dc041723e3d6",
+        "size": 67817366
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "8e0d209f53fbe56d6b3202015e2551195c98b3c1a945b4c0c0727a398df6c879",
-      "size": 78087034
+      "checksum": "eb1343b9092ddfbaf39bc44afeaf596e0d62516aadcf00c32626753c267cd90d",
+      "size": 73072310
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "5bff56908157f2dde2bd0577d282da70e0be7f49284a6e89975aa1246505054c",
-      "size": 78728740
+      "checksum": "c6e7e88189b5c8319e32b92ea53813eec683dcdfe187257d502b7e57d8e0f33a",
+      "size": 73704780
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "7c09aa7ac6e4361d4c5cc2f05a2f8a46d8338b1f8f8477674205f35aaeb755ea",
-      "size": 76536663
+      "checksum": "68ef3296006335ab24a0eca03332e97d2e0e92909773c6629b559f2bb5d04503",
+      "size": 71555622
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "55faf4b75c8d565be5912857ff8b3b20451d70cadcce427c332b51263ea64754",
-      "size": 77199333
+      "checksum": "28dee5aabacf56bd7d0a984c89da642fae2e37e6782951efadcebe160fba00e5",
+      "size": 72211859
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "6762311bd9602259cf8e98bda35cb37f15b4c884e7032cf99a2c18984d02efb1",
-      "size": 81115442
+      "checksum": "efd339adce351a3406b9583c1ce1c2cace7c2745000d8adcb420477459edfc83",
+      "size": 76106262
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "6b3b4e4ac6bfdf2515cb6cb7d0bc2640c7375d6bd4c9a5500e8bfdd9c0db3ddd",
-      "size": 77905662
+      "checksum": "d11e5d07414acaa8afd744bcc042da56406091a1b6ed9783591abeddd9f32272",
+      "size": 72889557
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.210",
       "0.3.211",
       "0.3.212",
       "0.3.214",

package/package.json

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

package/sdk-tools.d.ts

@@ -448,6 +448,7 @@ export type ArtifactOutput =
       artifacts: {
         title: string;
         url: string;
+        favicon?: string;
         updatedAt?: string;
         rel?: "mine" | "shared";
       }[];
@@ -3062,7 +3063,7 @@ export interface ArtifactInput {
    */
   file_path?: string;
   /**
-   * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Required to publish. Keep stable across redeploys; change only on a hard topic pivot.
+   * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Required on a page's first publish; omit on a redeploy (same file path this session, or `url`) to keep the artifact's icon — pass a new one only when the user asks.
    */
   favicon?: string;
   /**

package/sdk.d.ts

@@ -499,8 +499,9 @@ 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.
  *
- * Tool calls are bounded by the MCP tool-call timeout — the MCP_TOOL_TIMEOUT
- * env var (ms), effectively unbounded by default.
+ * Tool calls are bounded by the MCP tool-call timeout — `options.timeout`
+ * (ms) for this server, else the MCP_TOOL_TIMEOUT env var, effectively
+ * unbounded by default.
  */
 export declare function createSdkMcpServer(_options: CreateSdkMcpServerOptions): McpSdkServerConfigWithInstance;
 
@@ -523,6 +524,15 @@ declare type CreateSdkMcpServerOptions = {
      * works and is OR'd with this.
      */
     alwaysLoad?: boolean;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the
+     * MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock
+     * limit per call; progress notifications do not extend it. Values below
+     * 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
+     * Applies when the server is first registered; changing it for an
+     * already-registered server has no effect until it is removed and re-added.
+     */
+    timeout?: number;
 };
 
 export declare type CwdChangedHookInput = BaseHookInput & {
@@ -1075,6 +1085,10 @@ export declare type McpHttpServerConfig = {
 export declare type McpSdkServerConfig = {
     type: 'sdk';
     name: string;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default). Applies when the server is first registered; changing it for an already-registered server has no effect until it is removed and re-added.
+     */
+    timeout?: number;
 };
 
 /**
@@ -3725,6 +3739,15 @@ declare type SDKControlInitializeRequest = {
     subtype: 'initialize';
     hooks?: Partial<Record<coreTypes.HookEvent, SDKHookCallbackMatcher[]>>;
     sdkMcpServers?: string[];
+    /**
+     * Settings for the SDK-hosted MCP servers named in sdkMcpServers, keyed by server name. Sent as a separate field so a CLI that predates it ignores it; entries whose name is not in sdkMcpServers, and values that do not match this shape, are ignored rather than rejected. Applied when the server is first registered.
+     */
+    sdkMcpServerConfigs?: Record<string, {
+        /**
+         * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default). Applies when the server is first registered; changing it for an already-registered server has no effect until it is removed and re-added.
+         */
+        timeout?: number;
+    }>;
     jsonSchema?: Record<string, unknown>;
     systemPrompt?: string[];
     appendSystemPrompt?: string;
@@ -3797,6 +3820,7 @@ export declare type SDKControlInitializeResponse = {
 
 
 
+
 };
 
 /**
@@ -4868,6 +4892,7 @@ export declare type SDKSystemMessage = {
 
     fast_mode_state?: FastModeState;
     fast_mode_disabled_reason?: FastModeDisabledReason;
+
     /**
      * The effort level the session will send on its next request — after env overrides, session state, org caps and model-support downgrades; the same value get_settings reports as applied.effort. null when no effort parameter will be sent (a model without effort, CLAUDE_CODE_EFFORT_LEVEL=unset, or an internal numeric budget). Present on Remote Control bridge init frames (terminal- and Desktop/VS Code-hosted sessions); absent on hosts that do not publish it and on CLIs that predate the field. Re-emitted inits carry the current value — the newest frame wins.
      */
@@ -4882,6 +4907,7 @@ export declare type SDKSystemMessage = {
 
 
 
+
     uuid: UUID;
     session_id: string;
 };
@@ -5068,6 +5094,7 @@ export declare type SDKUserMessage = {
 
 
 
+
     uuid?: UUID;
     session_id?: string;
     /**
@@ -5118,6 +5145,7 @@ export declare type SDKUserMessageReplay = {
 
 
 
+
     uuid: UUID;
     session_id: string;
     isReplay: true;
@@ -5453,6 +5481,10 @@ export declare interface Settings {
      * Number of days to retain chat transcripts before automatic cleanup (default: 30). Minimum 1. Use a large value for long retention; use --no-session-persistence to disable transcript writes entirely.
      */
     cleanupPeriodDays?: number;
+    /**
+     * Retention ceiling in days for session transcripts created or last written by a desktop-host surface (Claude Desktop, Cowork), which are otherwise exempt from the cleanupPeriodDays sweep. 0 (the default) means no ceiling: such transcripts are kept until deleted another way. Unlike cleanupPeriodDays, 0 is allowed because this setting never disables writes — it only bounds an exemption from deletion. The ceiling is a hard cap: it also bounds an active archive grace, so the grace window of a release marker never keeps files past the ceiling. Ignored when cleanupPeriodDays is managed by org policy. A ceiling at or below cleanupPeriodDays effectively disables the exemption: those transcripts age out on the regular cleanupPeriodDays schedule, so the effective retention is whichever of the two periods is longer.
+     */
+    desktopSessionCleanupPeriodDays?: number;
     /**
      * Set to false to turn off syncing of the skills you have enabled on claude.ai. In your user settings (or managed settings): nothing more is downloaded, previously synced skills (~/.claude/skills/synced) can no longer be run, are hidden from every session started afterwards, and are moved to ~/.claude/skills/.trash at the next launch (deleted after cleanupPeriodDays; re-downloaded, not restored, if you re-enable). In .claude/settings.local.json or --settings: downloads stop and synced skills are blocked and hidden for sessions in that workspace or invocation only (nothing is moved). Not read from project settings (.claude/settings.json). Only false is honored — the feature is enabled server-side for your account, so setting true does not turn it on early. While it is on, synced skills are available in every session, re-synced every 10 minutes, and removed when you disable them on claude.ai. Only applies when signed in with your Claude account.
      */