@anthropic-ai/claude-agent-sdk 0.2.118 → 0.2.119

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.118",
-  "commit": "ef88b5f0a79aac989f53fd18178939a54a48624a",
-  "buildDate": "2026-04-22T22:43:30Z",
+  "version": "2.1.119",
+  "commit": "6f68554839756189e277b8285a18fe47acd9a5a1",
+  "buildDate": "2026-04-23T20:45:14Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "54e5d3f65109b89c6046f47440944d52906c662d1e51748f620a430d26ad3665",
-      "size": 207690848
+      "checksum": "31db3444309d5d0f8b85e8782e2dcd86f31f7e48c1a1e83d69b09268c7b4f9a2",
+      "size": 213404000
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "2cd554070f0588de05e9efd88c1f073770cb620ed3e5f45ba7df833fc3414c1b",
-      "size": 209238608
+      "checksum": "52b3b75cfe80c626982b2ffb3a6ce1c797824f257dc275cf0a3c32c202b6a3df",
+      "size": 214951760
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "b77b22fe93c15409f3c64be67950fe11e5fc17d1cd327891596cb87dd9be0492",
-      "size": 239798848
+      "checksum": "382aa73ea4b07fd8d698e3159b5ef9e1b8739fae7505ba8ddd28b8a6a62819ce",
+      "size": 245500480
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "ba363b2410a47120d2d4b8ece2e11fe0bbc5d59adb1329e8fb87ea0f370f4e46",
-      "size": 239573632
+      "checksum": "cca43053f062949495596b11b6fd1b59cf79102adb13bacbe66997e6fae41e4a",
+      "size": 245230208
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "dcb27938ed10b7da586b6f7ba0dde768980b5e3d38b258c1f4e9a94e7b3dd6d2",
-      "size": 232524224
+      "checksum": "e09bfaedd8bfdeaebe5f1cf9bb81ebeb718312c68fffce379fb51786263143d0",
+      "size": 238225856
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "bd05142de3e3ead48313d4215577c9a9c89f05ca286d771cdff025544c52ae29",
-      "size": 233839040
+      "checksum": "ef41a11653b39c14db2d343f1f5e2a3af7eb9871c63e64deb6e65919670a4e0b",
+      "size": 239495616
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "5a05b03b880de26bb78fb9824bacf08e99dcf05c02e3c66546cccaf2f2930b2e",
-      "size": 249035936
+      "checksum": "e18c7dcfad4a3f5d33d202ec2dde630b648cf5b41622154d6210e793c7cceadc",
+      "size": 254478496
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "b3d8942b49f672ef2e1394e004f0f53e197caefe30890620b6974a3e8dba63ec",
-      "size": 245760672
+      "checksum": "9e0deb10c45108612484ce558fad378206d5ac23feb203067450e6c38d001241",
+      "size": 251203232
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.118",
-  "commit": "ef88b5f0a79aac989f53fd18178939a54a48624a",
-  "buildDate": "2026-04-22T22:50:17Z",
+  "version": "2.1.119",
+  "commit": "6f68554839756189e277b8285a18fe47acd9a5a1",
+  "buildDate": "2026-04-23T20:53:09Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "0895347a08fe909e1761d0b73e18cdc8b4c0ad63d159bf422c8e3d49234a3b97",
-      "size": 43098168,
+      "checksum": "d36dfe6670e3fa7e4e6e7a3fd6f707b3946947a825f4070ed2b7e706e2651df0",
+      "size": 44111332,
       "bundle": {
-        "checksum": "10c7965cd61422b4f81cf2a9b08f023a38e4b24240e0373313ddf2596882db69",
-        "size": 43107336
+        "checksum": "4feab18b2073311b24e487ada0a582020304147121a1195deef57a0a7b7833a0",
+        "size": 44117376
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "b0537677a5aaa0d3e85f44ee6f14e984c6cdf0cf8fe9e2f883067586d591337e",
-      "size": 44811420,
+      "checksum": "72d7cbe250a5601aadc308b3355f71c529c903a99c1394cebd8e55c1adedbc37",
+      "size": 45861493,
       "bundle": {
-        "checksum": "6ac33e23fea2e737a7664ae4e73569e8f21fb08e6f01e4d079eede44116011fb",
-        "size": 44810879
+        "checksum": "96d2cfd075d23b18578b145d02fb78a72d552557d8d6e4228ba7bfafe8a69139",
+        "size": 45864968
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "7eb45089b179a0688de458ccbb0df8c33eacc2183808a8a54d50cee8ea928597",
-      "size": 52732492
+      "checksum": "afa715684e2a6bdf906d6019f47991a56fc9f2810493856a56e0da61d434b6b5",
+      "size": 53778693
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "063d156f8028c20ab84d7ff9188f6ca187920fa8dcca48d1b4d2dd2b831d11cb",
-      "size": 53288756
+      "checksum": "cd5df914e202388aebffcd09d46a994108c9c7ed485497124a501db2868b8bf6",
+      "size": 54299477
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "3b46a777475682fbfbdfd6ac70e71e627fd9ceb6cd53d71b0ec05e1d8a4be8e3",
-      "size": 51352015
+      "checksum": "f6b994b3d3926c4993c646b86fd2139e1047a44151edff659c28b56635941771",
+      "size": 52351846
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "8c45470b73bf2016db60bc0200bc78021adccbd05b0ad266547ac41aad74cd1f",
-      "size": 51983350
+      "checksum": "40b166987615e99b3d7222d99a0463e7e6da9e4e5ab22d2a6c256e5dc38ab4a9",
+      "size": 52970715
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "5ef7753a8aa0ca80f951acc832bde5da46731751fb4f7b9193fb24099823f26a",
-      "size": 54917824
+      "checksum": "f28aeaa9ce80c77fff046d9298092f32f5db24eae6db41aa51b7a329f178e824",
+      "size": 55932587
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "af53cf487f65fc168964deb3ed26105965ad78433b438d51e7bbf7b8054c636b",
-      "size": 53057220
+      "checksum": "4c481b40ae9e9ce3ceff4d371ad5974f7cd3c206387204a1b8dbbb9b221e9798",
+      "size": 54060686
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.118",
+  "version": "0.2.119",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -55,14 +55,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.118",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.118"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.119",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.119"
   },
   "files": [
     "sdk.mjs",
@@ -78,5 +78,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.118"
+  "claudeCodeVersion": "2.1.119"
 }

package/sdk.d.ts

@@ -1343,6 +1343,7 @@ export declare type Options = {
      * When true, `SDKPartialAssistantMessage` events will be emitted during streaming.
      */
     includePartialMessages?: boolean;
+
     /**
      * Controls Claude's thinking/reasoning behavior.
      *
@@ -1606,7 +1607,8 @@ export declare type Options = {
      * - `'project'` - Project settings (`.claude/settings.json`)
      * - `'local'` - Local settings (`.claude/settings.local.json`)
      *
-     * When omitted or empty, no filesystem settings are loaded (SDK isolation mode).
+     * When omitted, all sources are loaded (matches CLI defaults).
+     * Pass `[]` to disable filesystem settings (SDK isolation mode).
      * Must include `'project'` to load CLAUDE.md files.
      */
     settingSources?: SettingSource[];
@@ -1860,6 +1862,10 @@ export declare type PostToolUseFailureHookInput = BaseHookInput & {
     tool_use_id: string;
     error: string;
     is_interrupt?: boolean;
+    /**
+     * Tool execution time in milliseconds. Excludes permission-prompt and hook time.
+     */
+    duration_ms?: number;
 };
 
 export declare type PostToolUseFailureHookSpecificOutput = {
@@ -1873,6 +1879,10 @@ export declare type PostToolUseHookInput = BaseHookInput & {
     tool_input: unknown;
     tool_response: unknown;
     tool_use_id: string;
+    /**
+     * Tool execution time in milliseconds. Excludes permission-prompt and hook time.
+     */
+    duration_ms?: number;
 };
 
 export declare type PostToolUseHookSpecificOutput = {
@@ -2361,6 +2371,13 @@ declare type SDKControlFileSuggestionsRequest = {
     query: string;
 };
 
+/**
+ * Requests the responder's CLI binary version. Used by /version in --remote mode so the thin client can show both its own and the remote container's version.
+ */
+declare type SDKControlGetBinaryVersionRequest = {
+    subtype: 'get_binary_version';
+};
+
 /**
  * Requests a breakdown of current context window usage by category.
  */
@@ -2507,6 +2524,7 @@ declare type SDKControlInitializeRequest = {
     skills?: string[];
     promptSuggestions?: boolean;
     agentProgressSummaries?: boolean;
+    forwardSubagentText?: boolean;
 };
 
 /**
@@ -2665,7 +2683,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
 
 /**
  * Requests the SDK consumer to render a tool-driven blocking dialog and return the user choice. Used by tools that previously rendered Ink JSX via setToolJSX with an onDone callback.
@@ -2919,7 +2937,7 @@ export declare type SDKMessageOrigin = {
 };
 
 /**
- * Emitted when SessionStore.append() rejects or times out for a transcript-mirror batch. The batch is dropped (at-most-once delivery); this surfaces the failure so consumers are not silent on data loss.
+ * Emitted when SessionStore.append() rejects or times out for a transcript-mirror batch after bounded retry (3 attempts with short backoff; timeouts are not retried). The batch is then dropped; this surfaces the failure so consumers are not silent on data loss.
  */
 export declare type SDKMirrorErrorMessage = {
     type: 'system';
@@ -3024,7 +3042,7 @@ export declare type SDKRateLimitInfo = {
     utilization?: number;
     overageStatus?: 'allowed' | 'allowed_warning' | 'rejected';
     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' | 'org_service_zero_credit_limit' | 'no_limits_configured' | 'unknown';
+    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;
     surpassedThreshold?: number;
 };
@@ -3172,7 +3190,9 @@ export declare type SDKSessionOptions = {
     cwd?: string;
     /**
      * Which settings sources to load (CLAUDE.md, `.claude/settings.json`).
-     * Defaults to `[]` — no project/user settings are loaded unless specified.
+     * Defaults to `[]`: no project/user settings are loaded unless specified.
+     * Note that `query()` has the opposite default and loads all sources when
+     * this is omitted.
      */
     settingSources?: SettingSource[];
     /**
@@ -3288,6 +3308,7 @@ export declare type SDKSystemMessage = {
 
     fast_mode_state?: FastModeState;
 
+
     uuid: UUID;
     session_id: string;
 };
@@ -3522,8 +3543,16 @@ export declare type SessionStore = {
      * Within a single process, persist entries in append-call order; across
      * concurrent processes, order is by storage commit time, not call time.
      *
-     * Rejection is logged; the subprocess continues unaffected.
-     * At-most-once delivery — failed batches are not retried.
+     * Most entries carry a stable `uuid`. Adapters SHOULD treat `uuid` as an
+     * idempotency key (upsert / ignore-duplicate) so that retries and
+     * `importSessionToStore()` replays do not create duplicate rows. Entries
+     * without a `uuid` (e.g. titles, tags, mode markers) should be appended
+     * without dedup.
+     *
+     * Rejection is retried (3 attempts total) with short backoff; timeouts
+     * (60s) are not retried since the in-flight call may still land. After
+     * the final failure the batch is dropped and a `mirror_error` system
+     * message is emitted. The subprocess continues unaffected.
      */
     append(key: SessionKey, entries: SessionStoreEntry[]): Promise<void>;
     /**
@@ -4057,6 +4086,10 @@ export declare interface Settings {
          */
         refreshInterval?: number;
     };
+    /**
+     * URL template for PR links in the footer badge and inline messages. Placeholders: {host} {owner} {repo} {number} {url}. Example: "https://reviews.example.com/{owner}/{repo}/pull/{number}"
+     */
+    prUrlTemplate?: string;
     /**
      * Custom per-subagent status line shown in the agent panel; receives row context as JSON on stdin
      */
@@ -4937,6 +4970,70 @@ export declare interface Settings {
      * Custom message to append to the plugin trust warning shown before installation. Only read from policy settings (managed-settings.json / MDM). Useful for enterprise administrators to add organization-specific context (e.g., "All plugins from our internal marketplace are vetted and approved.").
      */
     pluginTrustMessage?: string;
+    /**
+     * Color theme for the UI
+     */
+    theme?: ('auto' | 'dark' | 'light' | 'light-daltonized' | 'dark-daltonized' | 'light-ansi' | 'dark-ansi') | string;
+    /**
+     * Key binding mode for the prompt input
+     */
+    editorMode?: 'normal' | 'vim';
+    /**
+     * Show full tool output instead of truncated summaries
+     */
+    verbose?: boolean;
+    /**
+     * Preferred OS notification channel
+     */
+    preferredNotifChannel?: 'auto' | 'iterm2' | 'iterm2_with_bell' | 'terminal_bell' | 'kitty' | 'ghostty' | 'notifications_disabled';
+    /**
+     * Automatically compact conversation when context fills
+     */
+    autoCompactEnabled?: boolean;
+    /**
+     * Auto-scroll the conversation view to bottom (fullscreen mode only)
+     */
+    autoScrollEnabled?: boolean;
+    /**
+     * Snapshot files before edits so /rewind can restore them
+     */
+    fileCheckpointingEnabled?: boolean;
+    /**
+     * Show "Cooked for Nm Ns" after each assistant turn
+     */
+    showTurnDuration?: boolean;
+    /**
+     * Stamp each assistant message with its arrival time
+     */
+    showMessageTimestamps?: boolean;
+    /**
+     * Emit OSC 9;4 progress sequences during long operations
+     */
+    terminalProgressBarEnabled?: boolean;
+    /**
+     * Enable the todo / task tracking panel
+     */
+    todoFeatureEnabled?: boolean;
+    /**
+     * How spawned teammates execute (tmux, in-process, auto)
+     */
+    teammateMode?: 'auto' | 'tmux' | 'in-process';
+    /**
+     * Start Remote Control bridge automatically each session
+     */
+    remoteControlAtStartup?: boolean;
+    /**
+     * Mirror local sessions to claude.ai as view-only (no remote control)
+     */
+    autoUploadSessions?: boolean;
+    /**
+     * Push to mobile when a permission prompt or question is waiting
+     */
+    inputNeededNotifEnabled?: boolean;
+    /**
+     * Allow Claude to push proactive mobile notifications
+     */
+    agentPushNotifEnabled?: boolean;
     [k: string]: unknown;
 }
 
@@ -4971,6 +5068,10 @@ export declare type SlashCommand = {
      * Hint for skill arguments (e.g., "<file>")
      */
     argumentHint: string;
+    /**
+     * Alternate names that resolve to this command (e.g., /cost and /stats both resolve to /usage)
+     */
+    aliases?: string[];
 };
 
 /**
@@ -5043,7 +5144,7 @@ export declare function startup(_params?: {
     initializeTimeoutMs?: number;
 }): Promise<WarmQuery>;
 
-declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTaskSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
 
 export declare type StopFailureHookInput = BaseHookInput & {
     hook_event_name: 'StopFailure';