@anthropic-ai/claude-agent-sdk 0.3.245 → 0.3.246

package/manifest.json

@@ -1,52 +1,51 @@
 {
-  "version": "2.1.245",
-  "commit": "28b7e8c41235a9e2fcb24248e60c4cc2d29c853a",
-  "buildDate": "2026-08-25T04:08:50Z",
+  "version": "2.1.246",
+  "commit": "1ba9d2211ae14e591bd1d60451c217c51f415e86",
+  "buildDate": "2026-08-25T18:46:33Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "9f7c2260251765a18d0b35198669dacc1912f6e8129a3b01f6b58d93365ff1f1",
-      "size": 376109392
+      "checksum": "7b09f01cb76a38e0e3a7c47c5d698d382162a5ff26538fc778683770caf9218b",
+      "size": 230824016
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "de044bb543e826352f31587a74356e1b2dae94dc1b9c960a362d9f07df96c2a7",
-      "size": 385137136
+      "checksum": "336625850986371487de7ece776d583f36cc3b3bc7178fcfbde3656d010289fb",
+      "size": 239710512
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "d0da299303d710a7cc5cdece9629958f5128ce1a727e15463c651ed5cf385c7f",
-      "size": 389077224
+      "checksum": "f98296e6e61c507589d1a973b262976b734700ec4e055cb64afdbf6d9a337db7",
+      "size": 247389632
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "16ad2b94deaf7b29abed966d981c9991a47af0420f5be8ed4a3f83bea9f678bc",
-      "size": 391948592
+      "checksum": "1a0a662dc1bb938eaec38545abce9a4a69113d7d7f7c5e1a553ea276617b906a",
+      "size": 247905800
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "8707fbe629fdd9876d9c356baa833a697dac76cd9a7157088f667199b8492851",
-      "size": 382222104
+      "checksum": "8f7d77a91b95dbeda31393463b2ac7d2b490c577486829b732ce1ac41a747034",
+      "size": 240072248
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "d25564bc5d84ec988a762cfe25fe51cb706b96eaec614f704ddbf653ab08ba00",
-      "size": 386060256
+      "checksum": "81de46c50d987b99d2a1b4f3b11f3acf8c6deb57bef2a41f8e770837ddcf52fb",
+      "size": 241667960
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "d1649bf5261792fee7e1a1b63fdd2197082adec36ce9701aa0c1723bdcd2348a",
-      "size": 384213664
+      "checksum": "9f07f1ecaf26231fc2fac489e7c5214140d38fd14764938a2c8c46f31931d204",
+      "size": 250948768
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "9cff8169be24a8b3e59e89e58d9e3d37f3c17ca1b3a149e60666fe53c789d80a",
-      "size": 372111520
+      "checksum": "911036439b49e81c5801092764e803207fc56b4e690afadb743f51220c2f8201",
+      "size": 242062496
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.208",
       "0.3.209",
       "0.3.210",
       "0.3.211",

package/manifest.zst.json

@@ -1,60 +1,59 @@
 {
-  "version": "2.1.245",
-  "commit": "28b7e8c41235a9e2fcb24248e60c4cc2d29c853a",
-  "buildDate": "2026-08-25T04:10:59Z",
+  "version": "2.1.246",
+  "commit": "1ba9d2211ae14e591bd1d60451c217c51f415e86",
+  "buildDate": "2026-08-25T18:47:52Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "2fcaad2a263142d718bef1802f096d0a6485678d24af373a2aba990375f330d9",
-      "size": 76482671,
+      "checksum": "1978b0b0167e7c077ae2536ed757a4dc22226540e3390bbc0884dc2ed3b9a0e3",
+      "size": 68186320,
       "bundle": {
-        "checksum": "bc9a9b736151e143c43067e4b8a52a7d09ebe51da28c0531eb11545dfe816d45",
-        "size": 76483812
+        "checksum": "beec443ec1fc0f6989e5ddcf25b032cdccceb8ca76e86b4ce90808ce88aacc89",
+        "size": 68190259
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "0cf787c9abba73569f1b20df7709703b48319c8b816f29cbdef6919670a7d8f0",
-      "size": 80306963,
+      "checksum": "b6269818f05c61f86029a018c39ed0903a5d69ad0eed6c0f05df7a79dd10c6ae",
+      "size": 72456477,
       "bundle": {
-        "checksum": "d8ca0b4b84bcdc355c778ed14e353949b3688d8140f4eeae1029b13db4a4a188",
-        "size": 80311603
+        "checksum": "0f2691f9212e25422ed694d2eb6890030f27d1574b46af7d92d8b239127d3cba",
+        "size": 72465121
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "01f6f7535d0d90322f60305ef748ecef8767eb662c31e5357b87481b8df5599c",
-      "size": 83546630
+      "checksum": "68915f3c07ad0090466282d580df4f4a11b339cee26888ed25f9446bbbef5c91",
+      "size": 77461718
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "11fa8433b06d700f1555ebbac1f1b7b25cb48cd202bac1147be766340dca14dd",
-      "size": 85457200
+      "checksum": "7fb5cc4ea9eb02c777a4d6363907957253fec6ee79617d145a142fbcc7e8c438",
+      "size": 78105392
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "533cc6a65a87f5fe458345fa6c31ff3197a3a5bb960cc4765667306049bab7e3",
-      "size": 83134954
+      "checksum": "74583317118d09d3a263593b18420e7c67cd49844f59cc6b403377b2bf27bbe6",
+      "size": 75912733
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "fe584dde417877d995638ccd181c145dc352ac3d1625b7fda331849d2104179e",
-      "size": 84426135
+      "checksum": "8527572efb30d0e23a84f0871cc61d586f21400fcd3ca9e82f30c754bf6dfa10",
+      "size": 76577839
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "752236e50aebdd764d869c8b5632b1aab87cce67a09baa473d663f78a2ffdffe",
-      "size": 87024225
+      "checksum": "4b49b5f1c4227009a57886d94f41fa887dafe0eaa4cb36252aed3954da663418",
+      "size": 80499903
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "e81e7e1219fbef1695e5f1d1cee8fb603df10f6357c6ed1fa5fc22ea3e011405",
-      "size": 83140027
+      "checksum": "d01182540877177cdf600be238069a11479f31b2fb4f76b736108b38e0e1ccd0",
+      "size": 77290190
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.208",
       "0.3.209",
       "0.3.210",
       "0.3.211",

package/package.json

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

package/sdk-tools.d.ts

@@ -3060,7 +3060,7 @@ export interface ProposeGoalInput {
 }
 export interface ArtifactInput {
   /**
-   * Omit (or 'publish') to publish file_path. 'list' enumerates artifacts — the user's own by default, see `scope`; only `limit` and `scope` may accompany it. 'read' returns the content of the published artifact at `url` (raw HTML for the user's own; an isolated summary, steered by the optional `prompt`, for one shared with them, though a page published in this session's own Slack channel can come back in full as untrusted content) — see **To read an existing artifact's content**. 'watch', 'unwatch', and 'status' manage live-update subscriptions that notify a session when an artifact is republished elsewhere, and those aren't available in this session: 'watch' only reports that — no republish notification reaches this session — and 'status' lists this session's artifact watches (pass `url` to check one). 'upload_asset' adds one local media, PDF, or font file to an existing artifact — pass `url` and `file_path`. 'list_assets' lists the files in an artifact's asset store (pass `url`; `after` continues a listing), 'read_asset' saves one of them to a local file named by its id (pass `url` and `asset_id`, optionally `out_dir`), and 'delete_asset' permanently removes one (pass `url` and `asset_id`). See **Artifact assets** above.
+   * Omit (or 'publish') to publish file_path. 'list' enumerates artifacts — the user's own by default, see `scope`; only `limit` and `scope` may accompany it. 'read' returns the content of the published artifact at `url` (raw HTML for the user's own; an isolated summary, steered by the optional `prompt`, for one shared with them, though a page published in this session's own Slack channel can come back in full as untrusted content) — see **To read an existing artifact's content**. 'watch', 'unwatch', and 'status' manage live-update subscriptions that notify a session when an artifact is republished elsewhere, and those aren't available in this session: 'watch' only reports that — no republish notification reaches this session — and 'status' lists this session's artifact watches (pass `url` to check one). 'upload_asset' adds one local media, PDF, font, or text file to an existing artifact — pass `url` and `file_path`. 'list_assets' lists the files in an artifact's asset store (pass `url`; `after` continues a listing), 'read_asset' saves one of them to a local file named by its id (pass `url` and `asset_id`, optionally `out_dir`), and 'delete_asset' permanently removes one (pass `url` and `asset_id`). See **Artifact assets** above.
    */
   action?:
     | "publish"
@@ -3074,7 +3074,7 @@ export interface ArtifactInput {
     | "read_asset"
     | "delete_asset";
   /**
-   * Path to the .html file to render. Required to publish (the default action). Use a short, distinctive basename — it is the last-resort title when the HTML has no <title> and no `title` parameter is given. For 'upload_asset', the local image, video, PDF, or font file to upload.
+   * Path to the .html file to render. Required to publish (the default action). Use a short, distinctive basename — it is the last-resort title when the HTML has no <title> and no `title` parameter is given. For 'upload_asset', the local image, video, PDF, font, or text (CSV, Markdown, JSON, plain text) file to upload.
    */
   file_path?: string;
   /**
@@ -3358,7 +3358,7 @@ export interface FileWriteOutput {
    */
   content: string;
   /**
-   * Diff patch showing the changes
+   * Diff patch showing the changes (empty when nothing changed, the diff timed out, or — with originalFile null on an update — the previous content was too large to diff)
    */
   structuredPatch: {
     oldStart: number;
@@ -3368,7 +3368,7 @@ export interface FileWriteOutput {
     lines: string[];
   }[];
   /**
-   * The original file content before the write (null for new files)
+   * The original file content before the write (null for new files, or when the previous content was too large to include)
    */
   originalFile: string | null;
   gitDiff?: {

package/sdk.d.ts

@@ -1302,6 +1302,10 @@ export declare type ModelUsage = {
      * API provider that served this model (e.g. 'firstParty', 'bedrock', 'vertex', 'foundry', 'anthropicAws', 'mantle', 'gateway').
      */
     provider?: string;
+    /**
+     * Which price table the most recent request for this model was priced at: Claude Code's built-in list prices ('list'), the organization's managed-settings modelPricing rates or multiplier ('managed'), or neither ('unknown' — no pricing row and no built-in price matched the model ID, so costUSD is a guess at the default model's rate). Overwritten per request like canonicalModel, so a consumer that differences the cumulative costUSD per turn gets that turn's basis. Absent until this process has priced a request for the model (e.g. right after --resume) and on builds that predate the field; treat as 'list'.
+     */
+    costBasis?: 'list' | 'managed' | 'unknown';
 };
 
 export declare type NonNullableUsage = {
@@ -1623,6 +1627,26 @@ export declare type Options = {
      * explicit declaration overrides).
      */
     supportedDialogKinds?: string[];
+    /**
+     * Declares that this consumer renders a per-task stop control wired to
+     * the `stop_task` control request, so the user can stop an individual
+     * background task.
+     *
+     * When declared, an interrupt on an open-input (interactive
+     * stream-json) session spares running background agents/workflows —
+     * Stop only aborts the current turn, and tasks are stopped one at a
+     * time through the consumer's own affordance. Closed-input exception:
+     * on a one-shot run (the string `prompt` form and `-p`, which close
+     * stdin), hold-back tasks are still killed when the held result is
+     * released, regardless of this declaration — with stdin closed, a
+     * `stop_task` control could never be delivered, so the fail-closed
+     * kill stands. The CLI also fails closed on absence: without the
+     * declaration, an interrupt kills background tasks, because a spared
+     * runaway task would otherwise be unstoppable from this consumer short
+     * of ending the session. First-attached-client
+     * wins on multi-client sessions; later initializes do not change it.
+     */
+    perTaskStopAffordance?: boolean;
     /**
      * When false, disables session persistence to disk. Sessions will not be
      * saved to ~/.claude/projects/ and cannot be resumed later. Useful for
@@ -3070,6 +3094,10 @@ export declare type SDKAssistantMessage = {
     uuid: UUID;
     session_id: string;
     request_id?: string;
+    /**
+     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on the turn's FIRST reply frame only — the first assistant message in complete-message mode; with --include-partial-messages the stamp normally rides the first non-ping stream event instead (see SDKPartialAssistantMessage), and a turn that produces no stream events still stamps its first assistant message — so a consumer can bind the reply to the send it answers without waiting for the result. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model. Absent on every later frame of the turn, on subagent frames (parent_tool_use_id set), on synthetic/scheduled (meta) turns, on turns without a client uuid, and from older producers.
+     */
+    user_message_uuid?: string;
     /**
      * This turn continued the preceding truncated assistant turn inside its trailing signed thinking block (max-output-tokens recovery). Its thinking signatures are cumulative over that preceding thinking-only turn, so a history replayed through the bridge must carry this flag back for the normalizer to keep the run's prefix on the wire. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model.
      */
@@ -3726,6 +3754,10 @@ declare type SDKControlInitializeRequest = {
      * Dialog kinds (request_user_dialog `dialog_kind` values) this consumer's onUserDialog can actually render. The CLI treats ABSENCE as 'cannot display' and fails closed: without the kind declared here, a dialog-gated flow degrades to its no-dialog behavior (for 'refusal_fallback_prompt', the classic refusal error) instead of parking a dialog the consumer may mishandle. First-attached-client-wins on multi-client sessions; later initializes do not change it.
      */
     supportedDialogKinds?: string[];
+    /**
+     * Declares that this consumer renders a per-task stop control wired to the `stop_task` control request, so the user can stop an individual background task. When declared, an interrupt on an open-input (interactive stream-json) session spares running background agents/workflows (Stop only aborts the turn). Closed-input exception: a one-shot run (string prompt / -p closes stdin) still kills hold-back tasks at the held-result release regardless of the declaration — with stdin closed, a stop_task control could never be delivered, so the fail-closed kill stands. ABSENCE also fails closed: the interrupt kills background tasks, since the user would otherwise have no way to stop a runaway one. First-attached-client-wins on multi-client sessions; later initializes do not change it.
+     */
+    perTaskStopAffordance?: boolean;
 
 };
 
@@ -4491,6 +4523,10 @@ export declare type SDKPartialAssistantMessage = {
     uuid: UUID;
     session_id: string;
     ttft_ms?: number;
+    /**
+     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on the turn's FIRST non-ping stream event only (the frame that triggers the turn's initial ack) so a consumer can bind the reply stream to the send it answers without waiting for the result. Absent on every later stream event of the turn, on synthetic/scheduled (meta) turns, on turns without a client uuid, and from older producers.
+     */
+    user_message_uuid?: string;
 };
 
 export declare type SDKPermissionDenial = {
@@ -4631,6 +4667,10 @@ export declare type SDKResultError = {
      */
     queued_turn_count?: number;
     errors: string[];
+    /**
+     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), echoed back so a consumer can link this error result to the send it answers — the same join key the success variant echoes, carried alone (error turns have no request_sent_wall_ms to report). A delivery-failure result from the remote-session client echoes the failed send's queue key, which is client-minted when the host sent no uuid of its own. Absent on synthetic/scheduled (meta) turns, on turns without a client uuid, on session-scoped failures with no single triggering send (a crashed worker's zeroed result), and from older producers.
+     */
+    user_message_uuid?: string;
     terminal_reason?: TerminalReason;
     fast_mode_state?: FastModeState;
     fast_mode_disabled_reason?: FastModeDisabledReason;
@@ -5404,6 +5444,10 @@ export declare interface Settings {
      * 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.
      */
     syncClaudeAiSkills?: boolean;
+    /**
+     * Set to false to turn off syncing of the plugins you have enabled on claude.ai. In your user settings (or managed settings): nothing more is downloaded, previously synced plugins (~/.claude/plugins/synced) are hidden from every session started afterwards and moved to ~/.claude/plugins/.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 plugins are 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 plugins load in every session like plugins you installed yourself (a plugin you installed with the same name takes precedence), are re-synced at each launch, and are removed when you disable them on claude.ai. Only applies when signed in with your Claude account.
+     */
+    syncClaudeAiPlugins?: boolean;
     /**
      * Per-skill description character cap in the skill listing sent to Claude (default: 1536). Descriptions longer than this are truncated. Raise to opt in to higher per-turn context cost.
      */
@@ -5527,7 +5571,7 @@ export declare interface Settings {
         replaceBuiltInOptions?: boolean;
     };
     /**
-     * Price usage at your organization's contracted rates instead of list price. Affects every spend figure Claude Code reports — /cost, the status line, the SDK total_cost_usd, --max-budget-usd, and the OpenTelemetry cost metric and events — which remain USD estimates, not an invoice (the per-Mtok price labels in /model stay at list). "overrides" maps a model ID to its USD-per-million-token rates (input, output, cacheRead, cacheWrite — all four required, each 0 to 10000; cacheWrite prices both 5-minute and 1-hour cache writes). A matching row is charged exactly as written; fast-mode and US-data-residency surcharges are not added on top. A key Claude Code itself uses for a built-in model — its ID such as "claude-sonnet-4-6", or its first-party, Bedrock (any or no region prefix), Vertex or Foundry ID — covers every dated and provider form of that model; any other key — a gateway model alias, or a spelling Claude Code does not itself use — matches that model ID only (case-insensitive), and such an exact match wins over a built-in row. On Bedrock an application inference profile is matched by its backing model. An invalid row or multiplier is reported and skipped; the rest still apply. "multiplier" in (0, 1] scales every computed cost, overridden or not (0.85 = 85% of the price). Only honored from managed settings (server-managed, MDM / OS policy, or managed-settings.json); ignored in user, project, local and --settings sources.
+     * Price usage at your organization's contracted rates instead of list price. Affects every spend figure Claude Code reports — /cost, the status line, the SDK total_cost_usd, --max-budget-usd, and the OpenTelemetry cost metric and events — which remain USD estimates, not an invoice (the per-Mtok price labels in /model stay at list). "overrides" maps a model ID to its USD-per-million-token rates (input, output, cacheRead, cacheWrite — all four required, each 0 to 10000; cacheWrite prices both 5-minute and 1-hour cache writes). A matching row is charged exactly as written; fast-mode and US-data-residency surcharges are not added on top. A key Claude Code itself uses for a built-in model — its ID such as "claude-sonnet-4-6", or its first-party, Bedrock (any or no region prefix), Vertex or Foundry ID — covers every dated and provider form of that model; any other key — a gateway model alias, or a spelling Claude Code does not itself use — matches that model ID only (case-insensitive), and such an exact match wins over a built-in row. On Bedrock an application inference profile is matched by its backing model. An invalid row or multiplier is reported and skipped; the rest still apply. "multiplier" in (0, 1] scales every computed cost, overridden or not (0.85 = 85% of the price). Only honored from managed settings (server-managed, MDM / OS policy, or managed-settings.json), or — when none of those sets it — when supplied by a host application that manages the model provider; ignored in user, project, local and --settings sources.
      */
     modelPricing?: {
         multiplier?: number;