@anthropic-ai/claude-agent-sdk 0.3.225 → 0.3.227

package/manifest.json

@@ -1,53 +1,51 @@
 {
-  "version": "2.1.225",
-  "commit": "d4b76e8c52c2391af51b60cc71a513246c40a129",
-  "buildDate": "2026-08-07T20:01:17Z",
+  "version": "2.1.227",
+  "commit": "5ecc7d5389d8b682652d0ea32eadd3e0eb537ee8",
+  "buildDate": "2026-08-10T19:04:57Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "08d6e85dd2b80883bb8da93cbeae3dc79b4704d6b84a05d614bf1ff4a5155b69",
-      "size": 279661952
+      "checksum": "7432511ba3be818e01f23f6eef8630d214a8b618451e188c3c7d61a987eef6c7",
+      "size": 285046400
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "0065d7155f83a3a5b0e0153ca3b70ad902b33dc06747c8b4e4d0bad58c6e0ec5",
-      "size": 289284768
+      "checksum": "14484fb9a0480b6b638230685a7d9a248a5339b384a162e0df127e4a4a07249b",
+      "size": 294700704
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "209d4279c0a3dbb48bee6017d99430269ec6aba59cd8735b1fda0f9664139a45",
-      "size": 294566840
+      "checksum": "db47335532cbcab67a4b3ab16d8f3f77976bf85d53c7d79f8296538aa22bfce6",
+      "size": 300923832
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "0a3be8d18cb0f5357d38ce2d588601753a60b44cc9c622579ed8b8405dee231e",
-      "size": 297831432
+      "checksum": "6832dc3f1797b890b71116e5f2dbbf9a83fd3d0498c235b4b0f9cd0e6e499ad6",
+      "size": 304282632
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "9189e2776d4120288b85a6682d2b26910daa4e937baa48bd75afb3fe3115291e",
-      "size": 287880552
+      "checksum": "8284d20a5d61e71502e69836b1598ba03f688f4d8de6c22105055fbf0af118f6",
+      "size": 294237544
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "ae2258be1a2d4eeef291514195af5b50a55801cc0561347c3873c4df5c9646f8",
-      "size": 292438608
+      "checksum": "da7b62210da0000c09c7c29b217e166ccc66dad4c79c9e2bc8d52fc7b66f590d",
+      "size": 298885712
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "234a59d6ea4262bb4af65d28acf19d795906295d11249750161875fbede3576d",
-      "size": 287053472
+      "checksum": "a5d8bcc6549cf99a2ea35451f8034a12f0db919e63334477c72d42fc8e0d5c09",
+      "size": 292227232
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "1152d683ed9ae20d7140ddc2db04d48e5f16ed214e2b07a8bc95c363c7e63bff",
-      "size": 281726112
+      "checksum": "68935d2c971ad417e90f1d5bb503c8773b218c7f7049fe35e502f0180232ff18",
+      "size": 286900384
     }
   },
   "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.225",
-  "commit": "d4b76e8c52c2391af51b60cc71a513246c40a129",
-  "buildDate": "2026-08-07T20:03:23Z",
+  "version": "2.1.227",
+  "commit": "5ecc7d5389d8b682652d0ea32eadd3e0eb537ee8",
+  "buildDate": "2026-08-10T19:07:09Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "7cef5c083019c8ed8e58505c8987388fca2b97cbd3b156b6be77d3a3b8ae10eb",
-      "size": 55963833,
+      "checksum": "256afdff806d28d027008c351f83986f11b7751fff1e44a52f66480361831542",
+      "size": 56884882,
       "bundle": {
-        "checksum": "11f2aa153892c0c72b42de714f8b83b5fb65f969649f3c9f594e89d6845245c1",
-        "size": 55954834
+        "checksum": "3b86d1a8f29a404dca144faf0ba1d155ef12f24c08606080a6c7eb85143ca117",
+        "size": 56888900
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "3d2774dc46981cf10056bd7dd5adfce9a001d7ad6e46088f90c0e4846071f39e",
-      "size": 60638677,
+      "checksum": "d4299135b0596df5ed10bbf4930995c2a9f0b660c405d119dac783141e9d5778",
+      "size": 61653275,
       "bundle": {
-        "checksum": "3333a5d1127541eecc8ec0273ee2dd238b35443faa90ba1969276083e6243482",
-        "size": 60635363
+        "checksum": "933dd4335d3db811d863c86b7b2a22d38519d14a46efbbfe207330c5355e15d1",
+        "size": 61647726
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "15907252edb6577bda10482e2aa1677928aa243e823ccb6577c5158bbae7f272",
-      "size": 64830045
+      "checksum": "7bc21154bf75a98bb7a2ae6b47f7d2ea8b75e86ef749749519af1fda5a73c7b9",
+      "size": 66000031
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "56f6febbbda34e715dcecdc5ad9a2ef8b65f678e735675881f84ecb0ca79a610",
-      "size": 66133582
+      "checksum": "5eebaa5625c306f6c5737b86f6e64f3fa5657269fd8434aea9c00803f97d1547",
+      "size": 67310589
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "cc449538fb17e65223c531fdd4b319078c8ed3067356a5df48b64672697eb0fc",
-      "size": 63542121
+      "checksum": "d5300c37aa78600838387fa9b61ed9c5b47d5277706dd832372fe7d9ea24dd0a",
+      "size": 64750207
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "74a5cc57c143ef730e284c5b4351bdb26da2f3436be54835a4e3acea29cb3377",
-      "size": 64976182
+      "checksum": "86f3903699da0a604bbaf04d977794207f1a4c2a63b3e2729a6abe342a7a095c",
+      "size": 66159367
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "0e62dd09aeccceefade7dee10c2d390718e38da4f61258fe8313d9e687afa67e",
-      "size": 66322446
+      "checksum": "3c0328fc224b2c2e433d144f1c4817a9d92006d97fa747a191f973873cb1cfd3",
+      "size": 67271619
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "0dbe13b41228e85c14d9dc6f47b42eeaaaa027d77ce669f4ae9ac01a724a5812",
-      "size": 64477363
+      "checksum": "9850e3fd889489166614e360f9aea02d679062971cbbe489a652bffe8a8bb40c",
+      "size": 65421569
     }
   },
   "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.225",
+  "version": "0.3.227",
   "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.225",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.225",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.225",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.225",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.225",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.225",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.225",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.225"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.227",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.227"
   },
   "files": [
     "sdk.mjs",
@@ -80,5 +80,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.225"
+  "claudeCodeVersion": "2.1.227"
 }

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
@@ -499,7 +501,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 +2663,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 +2860,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 +2892,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. 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 +2904,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 +2976,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 +3019,7 @@ export interface BashOutput {
     commit?: {
       sha: string;
       kind: "committed" | "amended" | "cherry-picked";
+      branch?: string;
     };
     push?: {
       branch: string;
@@ -3709,6 +3734,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

@@ -6322,7 +6322,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 +6659,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)
      */