@anthropic-ai/claude-agent-sdk 0.3.226 → 0.3.228

package/manifest.json

@@ -1,53 +1,51 @@
 {
-  "version": "2.1.226",
-  "commit": "e140b3281c1e8d834468889bd0a5c3fd2f15507c",
-  "buildDate": "2026-08-08T01:00:56Z",
+  "version": "2.1.228",
+  "commit": "4a2077e9c39676b5c335919018dda18f476a7f70",
+  "buildDate": "2026-08-11T01:54:41Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "013a1cf17df5ff1dcc189d5d6fd3fdd5f097ddc3cd41aa9992e99805574febbe",
-      "size": 279661952
+      "checksum": "43484b1352cef03a08346f36ef0437755b1aad646ab9313ce187857b794b7247",
+      "size": 289298144
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "773b095876f13ddb8336bfae202a57c62e358b1882746f1d55e3680601a32c59",
-      "size": 289284768
+      "checksum": "7852f1ae0efb64d46d77a57d8852daddc4a6ffb58aeda6267bd3f3428adc09b3",
+      "size": 298977312
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "feb715ee066d02a400c9d83941592f11c8e8fa6628c1e3c14262bc529f950498",
-      "size": 294566840
+      "checksum": "2664006219497bf7021ac43156519cd42eda64ceb2a66f434ecab83e7831f942",
+      "size": 305118136
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "4e9bec1177ce9690e8bd988b710ac24105e70da428dd094c5adcbbe786a55555",
-      "size": 297831432
+      "checksum": "d535985e6941a3eb00179ccd7f52ceb0c6623a0305a518ebc4e6514f84a94c99",
+      "size": 308521992
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "8c58e37c14e09f0be1b5b42e1fc4f409f1124ccc584a8633b99b7e8e63d79bd0",
-      "size": 287880552
+      "checksum": "1b8034fb30c90ea7471d6403bc610cb5173b7dedab3a92e89f6a91430c481876",
+      "size": 298431848
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "d199d62f2ce2fca6138256f788ecd6157cacc40edb3b50ce22b8f974f816111a",
-      "size": 292438608
+      "checksum": "0285be21af52692e5d1ea2199171b45fc85d9ca62fb4a2d9f2c244c2bbca8de7",
+      "size": 303129168
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "cec4e772e8237357554a8a5a86f821db9081e9fb05499bc4e5fd14b73f48708c",
-      "size": 287053472
+      "checksum": "841efce70b048ae03c752f79000cb6be5c2c2c4d0478f3eaaa762494ade9daf5",
+      "size": 296308896
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "6512422580a1f705301f7a1f6cebe436b207ed4f8a3fc23caf23295b7e8745bd",
-      "size": 281726112
+      "checksum": "e1d23400b3eef8f7b2ddde782ce4d3153aa88b5397d0f42813b8abbe0b47cbcd",
+      "size": 290981024
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.185",
-      "0.3.186",
       "0.3.187",
       "0.3.190",
       "0.3.191",
@@ -73,9 +71,11 @@
       "0.3.216",
       "0.3.217",
       "0.3.218",
+      "0.3.219",
       "0.3.220",
       "0.3.221",
-      "0.3.222"
+      "0.3.222",
+      "0.3.226"
     ],
     "harnessSchema": 1
   }

package/manifest.zst.json

@@ -1,61 +1,59 @@
 {
-  "version": "2.1.226",
-  "commit": "e140b3281c1e8d834468889bd0a5c3fd2f15507c",
-  "buildDate": "2026-08-08T01:03:06Z",
+  "version": "2.1.228",
+  "commit": "4a2077e9c39676b5c335919018dda18f476a7f70",
+  "buildDate": "2026-08-11T01:56:29Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "6dc9312381e5d68645864121037b7143bdaab6fd4f3c808bcfce6e0b8d507342",
-      "size": 56020044,
+      "checksum": "21df99480ffce8781bd357d6f3f2844b03a81ac3f71727ffd1d3e0d6cc765bbf",
+      "size": 57935761,
       "bundle": {
-        "checksum": "6caab5729f74a0f4b49527f1e2299511d62c3023d6d2c6d4954e58b90a96cac5",
-        "size": 56017628
+        "checksum": "95d8bc5a12b9c21564c55709295a1d8de9a7532bcd2e7dc031b33a6f8eceee4d",
+        "size": 57935873
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "a5460eac3acbdc8b4c549dd5a4fbdbcd6acc1e8442bc8510e2040ae85fac1476",
-      "size": 60662642,
+      "checksum": "5266fd1abe8b8cea84c1a4f859a0adeffd23beb99b8d85b1539ca2449a3df008",
+      "size": 62783370,
       "bundle": {
-        "checksum": "8c4d2d76a4e2ecb7d6de675549682ca4fa00977b9b77cf7dfd14f3a5d9626aac",
-        "size": 60658255
+        "checksum": "b8ae6943413bf0051dc36ba247b8fc93bca1627788ee943dd8551cfcf3a87a3f",
+        "size": 62791085
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "4b93a92c7604583d5cede463212d50d650c7fa73fe24986532cc6b90f8b28417",
-      "size": 64773738
+      "checksum": "271ec60acbb9b5a2aa7ed0377efe5b59bc5f886abcb18641a9e658326e9b62c4",
+      "size": 67104530
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "b36fed0065ec4a1ea68cda8227842ee04edbf140bf5cd628e67c7d5131c937b4",
-      "size": 66134389
+      "checksum": "7d8f14807313c7e49391def5437e8d0114ac8e6bbe37d69de19b6a820721e78f",
+      "size": 68448270
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "e827ad149ac6162c94999e1ee5b4310820675316ea3ea7f9614a2d8586a5e47f",
-      "size": 63548327
+      "checksum": "4fdea2b6f3a078db41fdd4683e7662fe6fd546a678e0f6d7d8085c73a8b466b3",
+      "size": 65900011
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "dd91233775c9aff5b51473aecb8097afb0468db83c019536996fb2eccfd1e696",
-      "size": 64943293
+      "checksum": "4be5575eaae712ee5a3215104837bc24b92856454e14fa00c3e3fa8e13da085a",
+      "size": 67280962
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "6a640ec9418707e47edd394dc169cde3e67a738ed2aca6fc0fd532c0903cbfdc",
-      "size": 66256320
+      "checksum": "9dfbd1c18bab440bd92f1aac6080e81b20ef37b9042b64b0dd9ce73961abdca8",
+      "size": 68451362
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "8a1b005c7dbdccf430868e407302beec8629cf3f00dbb451d097f955e4984ee3",
-      "size": 64367219
+      "checksum": "135dc669e2edbe2edab2d262316fd07e0fff0b554547050d08091c412ee2e8e7",
+      "size": 66489564
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.185",
-      "0.3.186",
       "0.3.187",
       "0.3.190",
       "0.3.191",
@@ -81,9 +79,11 @@
       "0.3.216",
       "0.3.217",
       "0.3.218",
+      "0.3.219",
       "0.3.220",
       "0.3.221",
-      "0.3.222"
+      "0.3.222",
+      "0.3.226"
     ],
     "harnessSchema": 1
   }

package/package.json

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

package/sdk-tools.d.ts

@@ -48,6 +48,7 @@ export type ToolInputSchemas =
   | ShowOnboardingRolePickerInput
   | MonitorInput
   | ProposeSkillsInput
+  | ProposeGoalInput
   | ArtifactInput
   | PushNotificationInput
   | EnterWorktreeInput
@@ -87,6 +88,7 @@ export type ToolOutputSchemas =
   | ScheduleWakeupOutput
   | MonitorOutput
   | ProposeSkillsOutput
+  | ProposeGoalOutput
   | EnterPlanModeOutput
   | REPLOutput
   | WorkflowOutput
@@ -127,6 +129,9 @@ export type AgentOutput =
         inference_geo?: string | null;
         speed?: string | null;
         iterations?: unknown;
+        output_tokens_details?: {
+          thinking_tokens?: number | null;
+        } | null;
       };
       toolStats?: {
         readCount: number;
@@ -499,7 +504,7 @@ export interface AgentInput {
    */
   model?: "sonnet" | "opus" | "haiku" | "fable";
   /**
-   * Agents run in the background by default; you will be notified when one completes. Set to false to run this agent synchronously when you need its result before continuing.
+   * Agents run in the background by default; you will be notified when one completes. Set to false only when your very next action depends on this agent's result and nothing else could usefully happen while it runs — otherwise leave it in the background so the user can hand you other work.
    */
   run_in_background?: boolean;
   /**
@@ -2661,11 +2666,19 @@ export interface ScheduleWakeupInput {
   stop?: boolean;
 }
 export interface RemoteTriggerInput {
-  action: "list" | "get" | "create" | "update" | "run" | "create_webhook_trigger";
+  action: "list" | "get" | "create" | "update" | "run" | "create_webhook_trigger" | "list_runs" | "get_run_log";
   /**
-   * Required for get, update, and run
+   * Required for get, update, run, and list_runs
    */
   trigger_id?: string;
+  /**
+   * Required for get_run_log: a run session id (cse_… or session_…, from list_runs)
+   */
+  session_id?: string;
+  /**
+   * next_cursor from a previous list_runs or get_run_log page
+   */
+  cursor?: string;
   /**
    * Required for create and update; optional for run
    */
@@ -2850,6 +2863,16 @@ export interface ProposeSkillsInput {
         }
       ];
 }
+export interface ProposeGoalInput {
+  /**
+   * The completion condition to propose, written so a separate evaluator can verify it from the conversation (e.g. "all tests in test/auth pass (bun test exits 0)"). At most 500 characters — the user must be able to read the whole condition in the approval dialog.
+   */
+  condition: string;
+  /**
+   * Whether to ask the user for approval before the goal is set. Defaults to true — an approval dialog is shown. Set false ONLY when the user's own words in this conversation stated this outcome as what they want; the goal is then set directly, with a visible notice in the transcript, and the user can clear it with /goal clear.
+   */
+  ask_user?: boolean;
+}
 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.
@@ -2872,7 +2895,7 @@ export interface ArtifactInput {
    */
   scope?: "mine" | "shared" | "all";
   /**
-   * Title for the artifact — the name shown in the browser tab and gallery. Prefer a <title> tag in the HTML itself; this parameter fills in only when the file lacks one and never overrides the tag. HTML publishes only — Markdown pages keep their filename identity. Content always comes from file_path — there is no inline content parameter.
+   * Title for the artifact — the name shown in the browser tab and gallery. A short, distinctive noun-phrase name — not a generic label, a summary, or a name with an appended explainer. Prefer a <title> tag at the top of the HTML itself; this parameter fills in only when the file lacks one in the first 8KB of the file, and never overrides the tag. HTML publishes only — Markdown pages keep their filename identity. Content always comes from file_path — there is no inline content parameter.
    */
   title?: string;
   /**
@@ -2884,7 +2907,7 @@ export interface ArtifactInput {
    */
   label?: string;
   /**
-   * Existing artifact URL to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" if you don't have it; without this, a conversation that didn't publish the artifact always mints a new URL. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns.
+   * Existing artifact URL to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" or ask the user for the link if you don't have it; without this, the publish creates a separate artifact instead of updating the existing one. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns.
    */
   url?: string;
   /**
@@ -2956,6 +2979,10 @@ export interface BashOutput {
    * Model-facing note that the session cwd was not changed by a backgrounded command containing a directory-change builtin (cd/pushd/popd/chdir)
    */
   backgroundCwdHint?: string;
+  /**
+   * True when this backgrounded command is owned by a synchronous subagent and is therefore terminated when that agent gives its final response; absent when the command survives (main loop, async subagents)
+   */
+  backgroundEndsWithFinalResponse?: true;
   /**
    * Flag to indicate if sandbox mode was overridden
    */
@@ -2995,6 +3022,7 @@ export interface BashOutput {
     commit?: {
       sha: string;
       kind: "committed" | "amended" | "cherry-picked";
+      branch?: string;
     };
     push?: {
       branch: string;
@@ -3709,6 +3737,16 @@ export interface ProposeSkillsOutput {
    */
   proposalCount: number;
 }
+export interface ProposeGoalOutput {
+  /**
+   * The condition shown to the user for approval, or set directly when ask_user was false
+   */
+  condition: string;
+  /**
+   * Whether the user was asked for approval (true) or the goal was set directly (false)
+   */
+  askUser: boolean;
+}
 export interface EnterPlanModeOutput {
   /**
    * Confirmation that plan mode was entered

package/sdk.d.ts

@@ -2716,7 +2716,7 @@ export declare type ResolvedSettingSource = SettingSource | 'managed' | 'flag';
  * - **The policy tier matches CLI startup** (managed-settings.json,
  *   remote-cached managed settings, MDM via macOS plist / Windows
  *   HKLM/HKCU, and `managedSettings`) **except** the admin-configured
- *   `policyHelper` subprocess is not executed. MDM resolution may invoke
+ *   `policyHelper`/`policyHelpers` subprocess is not executed. MDM resolution may invoke
  *   `plutil` (macOS, when an MDM plist exists) or `reg.exe` (Windows/WSL)
  *   on the first call per process. If your deployment relies on
  *   policyHelper to inject managed settings, results will differ.
@@ -5166,6 +5166,43 @@ export declare interface Settings {
         timeoutMs?: number;
         refreshIntervalMs?: 0 | number;
     };
+    /**
+     * Per-OS variant of policyHelper, keyed by platform: macos, linux, windows, wsl. The entry for the current platform wins over policyHelper; a platform with no entry falls back to policyHelper (wsl falls back to the linux entry first). Honored only from admin-controlled policy sources.
+     */
+    policyHelpers?: {
+        macos?: {
+            /**
+             * Absolute path to the helper executable
+             */
+            path: string;
+            timeoutMs?: number;
+            refreshIntervalMs?: 0 | number;
+        };
+        linux?: {
+            /**
+             * Absolute path to the helper executable
+             */
+            path: string;
+            timeoutMs?: number;
+            refreshIntervalMs?: 0 | number;
+        };
+        windows?: {
+            /**
+             * Absolute path to the helper executable
+             */
+            path: string;
+            timeoutMs?: number;
+            refreshIntervalMs?: 0 | number;
+        };
+        wsl?: {
+            /**
+             * Absolute path to the helper executable
+             */
+            path: string;
+            timeoutMs?: number;
+            refreshIntervalMs?: 0 | number;
+        };
+    };
     /**
      * Custom file suggestion configuration for \@ mentions
      */
@@ -6322,7 +6359,10 @@ export declare interface Settings {
      * Force a specific login method: "claudeai" for Claude Pro/Max, "console" for Console billing, "gateway" for the Cloud gateway OIDC device flow
      */
     forceLoginMethod?: 'claudeai' | 'console' | 'gateway';
-
+    /**
+     * Cloud gateway URL to pre-fill and auto-connect to during login, alongside forceLoginMethod: "gateway". Honored only from admin-controlled managed settings (MDM / managed-settings.json / policy helper); ignored in user, project, and remote-delivered settings.
+     */
+    forceLoginGatewayUrl?: string;
     /**
      * Controls whether the SDK parent tier (Options.managedSettings / --managed-settings) layers under this admin tier. "first-wins" (default): parent is dropped — admin tiers are the only policy source. "merge": parent's restrictive-only-filtered settings union under the admin winner. Has no effect when no admin tier exists (parent applies as the sole policy tier, still filtered restrictive-only).
      */
@@ -6656,6 +6696,7 @@ export declare interface Settings {
      * Name of an agent (built-in or custom) to use for the main thread. Applies the agent's system prompt, tool restrictions, and model.
      */
     agent?: string;
+
     /**
      * Company announcements to display at startup (one will be randomly selected if multiple are provided)
      */