@anthropic-ai/claude-agent-sdk 0.3.169 → 0.3.172

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.169",
-  "commit": "eb44edf196b8a320135d5a27a3cfba37773ce0cd",
-  "buildDate": "2026-06-08T03:29:19Z",
+  "version": "2.1.172",
+  "commit": "1b719ca2781a2dccc4a769b66bc35b4a60509ad7",
+  "buildDate": "2026-06-10T16:38:17Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "86d8b820ad7eed50e50a130706d3dc5ef70696f91194de1b3897a842182afe3a",
-      "size": 221921184
+      "checksum": "3c31f345575bf6f261c7e19981f6491bb93eeb0ffb499e95033610a7184831ce",
+      "size": 223390752
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "6d8d510c715b899307b7d29a1062d43e62c99370c55330dac3ec1851a2fbf7c8",
-      "size": 224435344
+      "checksum": "c507f98750c5230e4247f7eadff38e4db04c006904f85379e31c5d5e82e1c384",
+      "size": 225892528
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "341072395844b2b6d2846d8d61d551752b12a44433c920d0cc7fe6e7b5692a9b",
-      "size": 247182984
+      "checksum": "4ef0d735bd4180c3bffc381f6dc38df979229a8637d294be751c6043d93d12e1",
+      "size": 248624776
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "cf066bf360cbf7b51abeb8cb230012fc0f2fed4253b2ce305de48ccd6d49a39c",
-      "size": 247297744
+      "checksum": "c0915dd1691d569aeebc7978b12e029718323685ec0dd4b5c6a453108d6be1f7",
+      "size": 248743632
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "75a3cde99622b8315eacaa148905715da38f1e3359f950ec9348336579e8cb25",
-      "size": 240037720
+      "checksum": "6b10aad4270348175206bd2475f82ef3c56007dfb55d7b90f1950dfa8fb9eb40",
+      "size": 241479512
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "bd6fe38a55103d2c5bb8254a193a13829f18834e1c4a2739ac54d35770c79b5f",
-      "size": 241691696
+      "checksum": "58f2c60711f95e51d86d1af5b915cbdd0458710f1830b7c26d59b78f1ad1f861",
+      "size": 243153968
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "b4b4bbedc86c6b4ad617f4e5fe59f299c9909d068b25b6916c5f6701451cdf12",
-      "size": 242764960
+      "checksum": "07132ca4bbef551c92c1ae6ca0220a5e523092c9fa9cf402f65f428450687455",
+      "size": 244181152
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "29360b804dba89eae9927c6161b3d35023a349119b6e5086377f29bed77e89ff",
-      "size": 238729888
+      "checksum": "1e3e165c03de2af83c1e3516b73890b56e9785a2382338adcc28f41918bf4d2f",
+      "size": 240146080
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.169",
-  "commit": "eb44edf196b8a320135d5a27a3cfba37773ce0cd",
-  "buildDate": "2026-06-08T03:31:02Z",
+  "version": "2.1.172",
+  "commit": "1b719ca2781a2dccc4a769b66bc35b4a60509ad7",
+  "buildDate": "2026-06-10T16:40:02Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "fa5f68ad6243bfb59659ccffb9764e918d8d999abbe7cba6f3513d5c5b585e0b",
-      "size": 45588498,
+      "checksum": "759bbc3536d1a718cac24dfdd08a368bc63b64f64d199e64b354d101a4542050",
+      "size": 45892652,
       "bundle": {
-        "checksum": "4320c7b4c1663fcb1175dcac9719e450d58e4caf053443db10150006923c140d",
-        "size": 45584839
+        "checksum": "8ed897263049f1dc5d7eff8b70bd2a08cdd459a07e11702a9a51fa68e4b44130",
+        "size": 45888336
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "1c26144457e43516e04180c473a78b3619423fac0977579be6259422793e20a3",
-      "size": 47529757,
+      "checksum": "f8207869e2d8969e4df23d59a0ba619c9b782ba647622e5567ddd9daf3c68996",
+      "size": 47796942,
       "bundle": {
-        "checksum": "179a62a62ef550a45f7f3cd0e6ada8d553a0dc69ddccc6487714c7f1aa9f1477",
-        "size": 47538891
+        "checksum": "f63edc2de24311b5baad57225f354a62622b611e3ccb009c9a4928ab1973be4b",
+        "size": 47794444
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "2449ac49a90fb6ec698c8349df9e9e4ed66fa5e499f051a25e707ba016d41186",
-      "size": 53264356
+      "checksum": "bfb5b7972cd5b6e8409e3f1dd259f2bb56ccbd3faa78420c030d9c1bd2c589b2",
+      "size": 53537540
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "267841db28454f9d9b84fce19c90e0997bc5c82f523c0817e70bd39a74716aba",
-      "size": 53883389
+      "checksum": "cccc4486cb1c536918c1f54ff8509524633380f741253b00e29ce0db67fc1003",
+      "size": 54221669
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "7571613991d774a90178dc2e839846ba695c510fe9f3e2893c073abc69bf3473",
-      "size": 51895594
+      "checksum": "e3e80acadc3d75733ebfdd196e3fa8d6d189ec938a28b6cb361a99a1b49beec5",
+      "size": 52160799
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "4c30837e6a594cfa3ef85030509b6e0ca3e99b273fb1fb642721a829dbe0c7c8",
-      "size": 52605126
+      "checksum": "f88dba6370ab59cf918806dfae856e52c53595fca27072b78ee2a5757219dae3",
+      "size": 52864871
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "688e6b3a9fa0efd3a5e6902b5fa55cc6c2b0df258c05185291e1944bfbeaab43",
-      "size": 54621429
+      "checksum": "94297aa5ba27fcc918e5401b6894b9690a6671c35224f8eafb6915de4271d7ec",
+      "size": 54883060
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "8f9b77e0b85133ca0899556b31ac5767e4a0e7f0479f4c36d5f4b7d56443c871",
-      "size": 52884497
+      "checksum": "e10be49737ca3feab22bd88ecfb017f32eb06978e8237daebbce8f84f79a2eb3",
+      "size": 53155326
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.169",
+  "version": "0.3.172",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -61,14 +61,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.169",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.169"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.172",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.172"
   },
   "files": [
     "sdk.mjs",
@@ -86,5 +86,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.169"
+  "claudeCodeVersion": "2.1.172"
 }

package/sdk-tools.d.ts

@@ -39,7 +39,9 @@ export type ToolInputSchemas =
   | CronListInput
   | ScheduleWakeupInput
   | RemoteTriggerInput
+  | ShowOnboardingRolePickerInput
   | MonitorInput
+  | ArtifactInput
   | PushNotificationInput
   | EnterWorktreeInput
   | ExitWorktreeInput
@@ -68,7 +70,9 @@ export type ToolOutputSchemas =
   | TaskGetOutput
   | TaskUpdateOutput
   | TaskListOutput
+  | ArtifactOutput
   | RemoteTriggerOutput
+  | ShowOnboardingRolePickerOutput
   | ScheduleWakeupOutput
   | MonitorOutput
   | EnterPlanModeOutput
@@ -318,7 +322,7 @@ export interface AgentInput {
   /**
    * Optional model override for this agent. Takes precedence over the agent definition's model frontmatter. If omitted, uses the agent definition's model, or inherits from the parent.
    */
-  model?: "sonnet" | "opus" | "haiku";
+  model?: "sonnet" | "opus" | "haiku" | "fable";
   /**
    * Set to true to run this agent in the background. You will be notified when it completes.
    */
@@ -2348,6 +2352,7 @@ export interface RemoteTriggerInput {
     [k: string]: unknown;
   };
 }
+export interface ShowOnboardingRolePickerInput {}
 export interface MonitorInput {
   /**
    * Short human-readable description of what you are monitoring (shown in notifications).
@@ -2366,6 +2371,24 @@ export interface MonitorInput {
    */
   command: string;
 }
+export interface ArtifactInput {
+  /**
+   * Path to an .html or .md file to render. Use a short, distinctive basename — it is the fallback title if the HTML has no <title>.
+   */
+  file_path: string;
+  /**
+   * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Keep stable across redeploys; change only on a hard topic pivot.
+   */
+  favicon: string;
+  /**
+   * Short human-readable name for this version (e.g. "fixed-background"). Shown in the version picker instead of the raw version id.
+   */
+  label?: string;
+  /**
+   * Existing artifact URL to redeploy to. Pass when the user gives you a URL for an artifact not published in this session; omit for new artifacts or same-session redeploys. Must be an artifact the user owns.
+   */
+  url?: string;
+}
 export interface PushNotificationInput {
   /**
    * The notification body. Keep it under 200 characters; mobile OSes truncate.
@@ -2711,6 +2734,10 @@ export interface ReadMcpResourceOutput {
      */
     blobSavedTo?: string;
   }[];
+  /**
+   * Human-readable error when the server could not read the resource
+   */
+  error?: string;
 }
 export interface TodoWriteOutput {
   /**
@@ -3028,11 +3055,21 @@ export interface TaskListOutput {
     blockedBy: string[];
   }[];
 }
+export interface ArtifactOutput {
+  url: string;
+  path: string;
+  title?: string;
+  mcpDropped?: string;
+}
 export interface RemoteTriggerOutput {
   status: number;
   json: string;
   summary?: string;
 }
+export interface ShowOnboardingRolePickerOutput {
+  role?: string;
+  dismissed?: boolean;
+}
 export interface ScheduleWakeupOutput {
   /**
    * Epoch ms timestamp when the next wakeup will fire

package/sdk.d.ts

@@ -53,7 +53,7 @@ export declare type AgentDefinition = {
      */
     prompt: string;
     /**
-     * Model alias (e.g. 'sonnet', 'opus', 'haiku') or full model ID (e.g. 'claude-opus-4-5'). If omitted or 'inherit', uses the main model
+     * Model alias (e.g. 'fable', 'opus', 'sonnet', 'haiku') or full model ID (e.g. 'claude-fable-5'). If omitted or 'inherit', uses the main model
      */
     model?: string;
     mcpServers?: AgentMcpServerSpec[];
@@ -413,6 +413,7 @@ declare namespace coreTypes {
         SDKMessageOrigin,
         SDKMessage,
         SDKMirrorErrorMessage,
+        SDKModelRefusalFallbackMessage,
         SDKNotificationMessage,
         SDKPartialAssistantMessage,
         SDKPermissionDenial,
@@ -537,7 +538,7 @@ export declare function deleteSession(_sessionId: string, _options?: SessionMuta
  * - `'low'` — Minimal thinking, fastest responses
  * - `'medium'` — Moderate thinking
  * - `'high'` — Deep reasoning (default)
- * - `'xhigh'` — Deeper than high (Opus 4.7+; falls back to `'high'` elsewhere)
+ * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+; falls back to `'high'` elsewhere)
  * - `'max'` — Maximum effort (select models only)
  */
 export declare type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
@@ -1518,7 +1519,28 @@ export declare type Options = {
      * park deadline.
      */
     onUserDialog?: OnUserDialog;
-
+    /**
+     * Dialog kinds this consumer's `onUserDialog` can actually render
+     * (`request_user_dialog` `dialog_kind` values, e.g.
+     * 'refusal_fallback_prompt'). Declare only kinds your UI genuinely
+     * displays and answers. Providing `onUserDialog` alone does NOT opt the
+     * consumer into receiving dialogs — the CLI only emits a dialog kind
+     * declared here.
+     *
+     * The CLI fails closed on absence: a dialog kind not declared here is
+     * never emitted to this session — the flow behind it degrades to its
+     * no-dialog behavior instead (for 'refusal_fallback_prompt', the classic
+     * refusal error message ends the turn). Omitting the option entirely
+     * means no dialogs are emitted, even with `onUserDialog` wired.
+     *
+     * Requires `onUserDialog`; passing a non-empty list without the callback
+     * throws at option intake. On multi-client (remote) sessions the first
+     * attached client's declaration wins for the worker's lifetime, and the
+     * winning declaration is persisted to worker metadata so it survives
+     * worker restarts (restored as a default that the next epoch's first
+     * explicit declaration overrides).
+     */
+    supportedDialogKinds?: string[];
     /**
      * When false, disables session persistence to disk. Sessions will not be
      * saved to ~/.claude/projects/ and cannot be resumed later. Useful for
@@ -1599,8 +1621,8 @@ export declare type Options = {
      * - `'low'` — Minimal thinking, fastest responses
      * - `'medium'` — Moderate thinking
      * - `'high'` — Deep reasoning (default)
-     * - `'xhigh'` — Deeper than high (Opus 4.7+)
-     * - `'max'` — Maximum effort (Opus 4.6+, Sonnet 4.6)
+     * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+)
+     * - `'max'` — Maximum effort (Fable 5, Opus 4.6+, Sonnet 4.6)
      *
      * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
      */
@@ -1651,7 +1673,7 @@ export declare type Options = {
     mcpServers?: Record<string, McpServerConfig>;
     /**
      * Claude model to use. Defaults to the CLI default model.
-     * Examples: 'claude-sonnet-4-6', 'claude-opus-4-8'
+     * Examples: 'claude-sonnet-4-6', 'claude-opus-4-8', 'claude-fable-5'
      */
     model?: string;
     /**
@@ -2675,7 +2697,10 @@ export declare type SDKAssistantMessage = {
     uuid: UUID;
     session_id: string;
     request_id?: string;
-
+    /**
+     * Wire uuids of previously-delivered messages that this message replaces (refusal-fallback supersede). The list can include tombstoned tool_result frames from the refused leg, not only assistant frames. Evict the named messages on arrival and treat this frame as their canonical replacement. Idempotent with the end-of-turn model_refusal_fallback notice, whose retracted_message_uuids remains the complete audit record for the turn.
+     */
+    supersedes?: UUID[];
     /**
      * Subagent type that produced this message.
      */
@@ -3193,7 +3218,10 @@ declare type SDKControlInitializeRequest = {
     promptSuggestions?: boolean;
     agentProgressSummaries?: boolean;
     forwardSubagentText?: boolean;
-
+    /**
+     * 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[];
 };
 
 /**
@@ -3220,6 +3248,7 @@ export declare type SDKControlInitializeResponse = {
  */
 declare type SDKControlInterruptRequest = {
     subtype: 'interrupt';
+
 };
 
 /**
@@ -3620,7 +3649,7 @@ export declare type SDKMemoryRecallMessage = {
     session_id: string;
 };
 
-export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPluginInstallMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskUpdatedMessage | SDKTaskProgressMessage | SDKThinkingTokensMessage | SDKSessionStateChangedMessage | SDKCommandsChangedMessage | SDKNotificationMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKMemoryRecallMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPermissionDeniedMessage | SDKPromptSuggestionMessage | SDKMirrorErrorMessage;
+export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelRefusalFallbackMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPluginInstallMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskUpdatedMessage | SDKTaskProgressMessage | SDKThinkingTokensMessage | SDKSessionStateChangedMessage | SDKCommandsChangedMessage | SDKNotificationMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKMemoryRecallMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPermissionDeniedMessage | SDKPromptSuggestionMessage | SDKMirrorErrorMessage;
 
 /**
  * Provenance of a user-role message (peer session, team lead, channel). Absent or `human` means keyboard input from the user.
@@ -3658,6 +3687,34 @@ export declare type SDKMirrorErrorMessage = {
     session_id: string;
 };
 
+/**
+ * Emitted when the primary model ends the stream with stop_reason "refusal" and the turn is retried once on a fallback model with the swap made persistent for the session (direction: "retry"). "revert" and "sticky" are retained in the enum for SDK-consumer compat and are no longer emitted.
+ */
+export declare type SDKModelRefusalFallbackMessage = {
+    type: 'system';
+    subtype: 'model_refusal_fallback';
+    trigger: 'refusal';
+    direction: 'retry' | 'revert' | 'sticky';
+    original_model: string;
+    fallback_model: string;
+    request_id: string | null;
+    /**
+     * stop_details.category from the refused API response ("cyber", "bio", …). Open string — new categories ship on the wire ahead of schema updates. null when the response carried no category (normal, not an error). Absent when emitted by an older CLI.
+     */
+    api_refusal_category?: string | null;
+    /**
+     * stop_details.explanation from the refused API response. Unstable human prose — display only, never parse. null/absent under the same rules as api_refusal_category.
+     */
+    api_refusal_explanation?: string | null;
+    /**
+     * Wire uuids of the messages this fallback retracted — the refused partial as the consumer received it (one uuid per normalized SDK message; multi-block messages carry per-block derived uuids) plus any tombstoned tool_results. Emitted AFTER the retraction, so this is a resolution-time eviction signal: remove these messages from transcript state on receipt. Eviction is idempotent — unknown or already-removed uuids are a no-op. Absent when emitted by an older CLI.
+     */
+    retracted_message_uuids?: string[];
+    content: string;
+    uuid: UUID;
+    session_id: string;
+};
+
 /**
  * Loop-side text notification. Mirrors the interactive REPL notification queue (key/priority/timeout). JSX notifications are not emitted on this channel.
  */
@@ -3728,6 +3785,10 @@ export declare type SdkPluginConfig = {
      * Absolute or relative path to the plugin directory
      */
     path: string;
+    /**
+     * When true, the engine loads skills/hooks/agents/commands from this plugin but does NOT read its .mcp.json or manifest mcpServers. Use when the SDK host owns this plugin's MCP connections.
+     */
+    skipMcpDiscovery?: boolean;
 };
 
 /**
@@ -3778,6 +3839,7 @@ export declare type SDKRateLimitInfo = {
     overageResetsAt?: number;
     overageDisabledReason?: 'overage_not_provisioned' | 'org_level_disabled' | 'org_level_disabled_until' | 'out_of_credits' | 'seat_tier_level_disabled' | 'member_level_disabled' | 'seat_tier_zero_credit_limit' | 'group_zero_credit_limit' | 'member_zero_credit_limit' | 'org_service_level_disabled' | 'no_limits_configured' | 'fetch_error' | 'unknown';
     isUsingOverage?: boolean;
+    overageInUse?: boolean;
     surpassedThreshold?: number;
 };
 
@@ -4822,6 +4884,10 @@ export declare interface Settings {
      * Disable the Workflows feature (also via CLAUDE_CODE_DISABLE_WORKFLOWS).
      */
     disableWorkflows?: boolean;
+    /**
+     * Disable the Artifact tool (also via CLAUDE_CODE_DISABLE_ARTIFACT).
+     */
+    disableArtifact?: boolean;
     /**
      * Enable or disable the Workflows feature for this user. Unset = default by plan once the feature is available.
      */