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

package/manifest.json

@@ -1,52 +1,51 @@
 {
-  "version": "2.1.246",
-  "commit": "1ba9d2211ae14e591bd1d60451c217c51f415e86",
-  "buildDate": "2026-08-25T18:46:33Z",
+  "version": "2.1.247",
+  "commit": "89c726188daf6407b6b57bf67d312f2958e5b9f2",
+  "buildDate": "2026-08-26T06:08:58Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "7b09f01cb76a38e0e3a7c47c5d698d382162a5ff26538fc778683770caf9218b",
-      "size": 230824016
+      "checksum": "5086b9b64d8bb842e1f599cdd3767ab08c6b2266e462fcc5686ae4b019cca8f7",
+      "size": 233073008
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "336625850986371487de7ece776d583f36cc3b3bc7178fcfbde3656d010289fb",
-      "size": 239710512
+      "checksum": "162e65d7bf8735dbcdc75b0122dbb126d5704a00e682bbdfc413749188a20cfd",
+      "size": 241972656
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "f98296e6e61c507589d1a973b262976b734700ec4e055cb64afdbf6d9a337db7",
-      "size": 247389632
+      "checksum": "a68bb633f85e4a0e73465952ea624cf18992c3fa4db615feeb942ffad57d082a",
+      "size": 249617856
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "1a0a662dc1bb938eaec38545abce9a4a69113d7d7f7c5e1a553ea276617b906a",
-      "size": 247905800
+      "checksum": "5fb321bf417ffc5cd4e3f36e7c9c7e029bf47aaa36d5621db979fcc5e6eabe15",
+      "size": 250162696
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "8f7d77a91b95dbeda31393463b2ac7d2b490c577486829b732ce1ac41a747034",
-      "size": 240072248
+      "checksum": "7c776ebf17adf53a1a6c844356e9713c0a40826b563df6fd670bce00c3f768f8",
+      "size": 242300472
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "81de46c50d987b99d2a1b4f3b11f3acf8c6deb57bef2a41f8e770837ddcf52fb",
-      "size": 241667960
+      "checksum": "8bb6b5b1c6c4f08f9c5047153425c32d5041180065537f3da78f6fadf42b40ee",
+      "size": 243924856
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "9f07f1ecaf26231fc2fac489e7c5214140d38fd14764938a2c8c46f31931d204",
-      "size": 250948768
+      "checksum": "00e5be0a8b69893cad9259a1e8b80d59be8f3eb367d4a16c19f91bcd279423b7",
+      "size": 253204128
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "911036439b49e81c5801092764e803207fc56b4e690afadb743f51220c2f8201",
-      "size": 242062496
+      "checksum": "a6b097f8cfb742f66cced452fc9260a6302637379813c06a4f4516aa2c4917f7",
+      "size": 244317344
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.209",
       "0.3.210",
       "0.3.211",
       "0.3.212",

package/manifest.zst.json

@@ -1,60 +1,59 @@
 {
-  "version": "2.1.246",
-  "commit": "1ba9d2211ae14e591bd1d60451c217c51f415e86",
-  "buildDate": "2026-08-25T18:47:52Z",
+  "version": "2.1.247",
+  "commit": "89c726188daf6407b6b57bf67d312f2958e5b9f2",
+  "buildDate": "2026-08-26T06:10:18Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "1978b0b0167e7c077ae2536ed757a4dc22226540e3390bbc0884dc2ed3b9a0e3",
-      "size": 68186320,
+      "checksum": "8ca071dbb165f818b1091d0756932aa7307d19a80c2db540b3e9c501c39bcf7a",
+      "size": 68851450,
       "bundle": {
-        "checksum": "beec443ec1fc0f6989e5ddcf25b032cdccceb8ca76e86b4ce90808ce88aacc89",
-        "size": 68190259
+        "checksum": "5298653b09fe0f382fd79f8fbe5a48d474b6df563665b40b160153ab156cd35f",
+        "size": 68850320
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "b6269818f05c61f86029a018c39ed0903a5d69ad0eed6c0f05df7a79dd10c6ae",
-      "size": 72456477,
+      "checksum": "c739be8ab289e634bf8a8a2028a68284b32e4ac46e2ee4424227ef46133ee687",
+      "size": 73132830,
       "bundle": {
-        "checksum": "0f2691f9212e25422ed694d2eb6890030f27d1574b46af7d92d8b239127d3cba",
-        "size": 72465121
+        "checksum": "f413c2596ffc2b7cb188b581e7e5105b34dbca7a7d5147c2621f344b9197d89e",
+        "size": 73136601
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "68915f3c07ad0090466282d580df4f4a11b339cee26888ed25f9446bbbef5c91",
-      "size": 77461718
+      "checksum": "8e0d209f53fbe56d6b3202015e2551195c98b3c1a945b4c0c0727a398df6c879",
+      "size": 78087034
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "7fb5cc4ea9eb02c777a4d6363907957253fec6ee79617d145a142fbcc7e8c438",
-      "size": 78105392
+      "checksum": "5bff56908157f2dde2bd0577d282da70e0be7f49284a6e89975aa1246505054c",
+      "size": 78728740
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "74583317118d09d3a263593b18420e7c67cd49844f59cc6b403377b2bf27bbe6",
-      "size": 75912733
+      "checksum": "7c09aa7ac6e4361d4c5cc2f05a2f8a46d8338b1f8f8477674205f35aaeb755ea",
+      "size": 76536663
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "8527572efb30d0e23a84f0871cc61d586f21400fcd3ca9e82f30c754bf6dfa10",
-      "size": 76577839
+      "checksum": "55faf4b75c8d565be5912857ff8b3b20451d70cadcce427c332b51263ea64754",
+      "size": 77199333
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "4b49b5f1c4227009a57886d94f41fa887dafe0eaa4cb36252aed3954da663418",
-      "size": 80499903
+      "checksum": "6762311bd9602259cf8e98bda35cb37f15b4c884e7032cf99a2c18984d02efb1",
+      "size": 81115442
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "d01182540877177cdf600be238069a11479f31b2fb4f76b736108b38e0e1ccd0",
-      "size": 77290190
+      "checksum": "6b3b4e4ac6bfdf2515cb6cb7d0bc2640c7375d6bd4c9a5500e8bfdd9c0db3ddd",
+      "size": 77905662
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.209",
       "0.3.210",
       "0.3.211",
       "0.3.212",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.246",
+  "version": "0.3.247",
   "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.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"
+    "@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"
   },
   "files": [
     "sdk.mjs",
@@ -80,5 +80,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.246"
+  "claudeCodeVersion": "2.1.247"
 }

package/sdk-tools.d.ts

@@ -103,22 +103,6 @@ export type ToolOutputSchemas =
 export type AgentOutput =
   | {
       agentId: string;
-      /**
-       * @internal Count of leading harness-authored content blocks (hand-back provenance bookkeeping; not a stable consumer field)
-       */
-      harnessNoteCount?: number;
-      /**
-       * @internal Count of trailing harness-authored content blocks (hand-back provenance bookkeeping; not a stable consumer field)
-       */
-      harnessTailCount?: number;
-      /**
-       * @internal Fingerprint binding the harness section counts to the exact content they were computed against; a hook rewrite invalidates the counts rather than misplacing rewritten bytes
-       */
-      harnessSectionHash?: string;
-      /**
-       * @internal The handoff review was skipped because the provenance frame covers this delivery (tengu_auto_mode_config.classifyHandoff: false); the tool_result mapper MUST compose the frame when set, regardless of a fresh flag read
-       */
-      handoffReviewSkipped?: boolean;
       agentType?: string;
       content: {
         type: "text";
@@ -3237,7 +3221,7 @@ export interface BashOutput {
    */
   ghRateLimitHint?: string;
   /**
-   * @internal Structured classification of git/gh operations detected in this command (commit/push/merge/rebase/PR). Client-facing — lets clients render git activity without re-parsing stdout; not surfaced to the model.
+   * Structured classification of git/gh operations detected in this command (commit/push/merge/rebase/PR). Client-facing — lets clients render git activity without re-parsing stdout; not surfaced to the model.
    */
   gitOperation?: {
     commit?: {

package/sdk.d.ts

@@ -3154,7 +3154,7 @@ export declare type SDKAuthStatusMessage = {
 };
 
 /**
- * The full set of live background tasks, emitted whenever membership changes (start, completion, kill, a foreground agent being backgrounded). A level signal, unlike the task_started/task_notification edge bookends: consumers that only need 'is background work running' should replace their set with each payload rather than pairing edges, so a missed bookend cannot wedge a stale running indicator. Ordering relative to the bookends for the same transition is unspecified (in practice the level precedes them) and the payload carries ids only, so do not correlate it with the edge stream. The level is per-process: nothing is emitted at startup, so consumers must reset to the empty set whenever the session's CLI process (re)starts and let the next membership change repopulate it. A host that re-initializes an already-running process (a repeated `initialize` control request, e.g. after reconnecting) is sent a snapshot of the current set right behind the success response to that request, even when it is empty, so it need not wait for a change; CLIs that predate this send nothing there.
+ * The full set of live background tasks, emitted whenever membership changes (start, completion, kill, a foreground agent being backgrounded) or an entry's `ambient` flag flips. A level signal, unlike the task_started/task_notification edge bookends: consumers that only need 'is background work running' should replace their set with each payload rather than pairing edges, so a missed bookend cannot wedge a stale running indicator. Ordering relative to the bookends for the same transition is unspecified (in practice the level precedes them) and the payload carries ids only, so do not correlate it with the edge stream. The level is per-process: nothing is emitted at startup, so consumers must reset to the empty set whenever the session's CLI process (re)starts and let the next membership change repopulate it. A host that re-initializes an already-running process (a repeated `initialize` control request, e.g. after reconnecting) is sent a snapshot of the current set right behind the success response to that request, even when it is empty, so it need not wait for a change; CLIs that predate this send nothing there.
  */
 export declare type SDKBackgroundTasksChangedMessage = {
     type: 'system';
@@ -3166,6 +3166,10 @@ export declare type SDKBackgroundTasksChangedMessage = {
         task_id: string;
         task_type: string;
         description: string;
+        /**
+         * True for housekeeping tasks the CLI does not surface as user work (every skip_transcript task, plus auto-started live-update watchers); hosts should exclude them from activity indicators.
+         */
+        ambient?: boolean;
     }[];
     uuid: UUID;
     session_id: string;
@@ -4877,6 +4881,7 @@ export declare type SDKSystemMessage = {
 
 
 
+
     uuid: UUID;
     session_id: string;
 };
@@ -4895,6 +4900,10 @@ export declare type SDKTaskNotificationMessage = {
         duration_ms: number;
     };
     skip_transcript?: boolean;
+    /**
+     * True for housekeeping tasks the CLI does not surface as user work (every skip_transcript task, plus auto-started live-update watchers); hosts should exclude them from activity indicators.
+     */
+    ambient?: boolean;
     uuid: UUID;
     session_id: string;
 };
@@ -4949,6 +4958,10 @@ export declare type SDKTaskStartedMessage = {
      * Ambient/housekeeping task. Consumers should hide this from the inline transcript; it may still appear in a tasks panel.
      */
     skip_transcript?: boolean;
+    /**
+     * True for housekeeping tasks the CLI does not surface as user work (every skip_transcript task, plus auto-started live-update watchers); hosts should exclude them from activity indicators.
+     */
+    ambient?: boolean;
     uuid: UUID;
     session_id: string;
 };
@@ -7469,11 +7482,22 @@ export declare interface Settings {
         verbs: string[];
     };
     /**
-     * Override spinner tips. tips: array of tip strings. excludeDefault: if true, only show custom tips (default: false).
+     * Add your organization's own tips to the spinner tip rotation. tips: strings or {id, text, cooldownSessions?, priority?} objects; tipsFile: a JSON file of the same; label: prefix shown before your tips; excludeDefault: if true, only show your tips (default: false).
      */
     spinnerTipsOverride?: {
         excludeDefault?: boolean;
-        tips: string[];
+        tips?: (string | {
+            [k: string]: unknown;
+        })[];
+        /**
+         * Absolute or ~/ local path to a JSON file holding an array of tips (same shapes as `tips`); honored from user, --settings and on-disk managed settings only. Read once per CLI process (restart to pick up edits).
+         */
+        tipsFile?: string;
+        /**
+         * Prefix shown before your tips in the spinner (default "Tip")
+         */
+        label?: string;
+        [k: string]: unknown;
     };
     /**
      * Whether to disable syntax highlighting in diffs