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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/manifest.json CHANGED
@@ -1,47 +1,47 @@
1
1
  {
2
- "version": "2.1.118",
3
- "commit": "ef88b5f0a79aac989f53fd18178939a54a48624a",
4
- "buildDate": "2026-04-22T22:43:30Z",
2
+ "version": "2.1.120",
3
+ "commit": "080f07fb4224786b965b9ea0a35f0cff594f2eb6",
4
+ "buildDate": "2026-04-24T21:51:03Z",
5
5
  "platforms": {
6
6
  "darwin-arm64": {
7
7
  "binary": "claude",
8
- "checksum": "54e5d3f65109b89c6046f47440944d52906c662d1e51748f620a430d26ad3665",
9
- "size": 207690848
8
+ "checksum": "fad8faf49c7b1b454c38d785b75e17edbdadc7ffaf450b31349aafc6560b8ef6",
9
+ "size": 213981440
10
10
  },
11
11
  "darwin-x64": {
12
12
  "binary": "claude",
13
- "checksum": "2cd554070f0588de05e9efd88c1f073770cb620ed3e5f45ba7df833fc3414c1b",
14
- "size": 209238608
13
+ "checksum": "ad68f225e96db8b7d12d0c31f0343bc3227ea2886ecefae2f483cb32310b0004",
14
+ "size": 215529168
15
15
  },
16
16
  "linux-arm64": {
17
17
  "binary": "claude",
18
- "checksum": "b77b22fe93c15409f3c64be67950fe11e5fc17d1cd327891596cb87dd9be0492",
19
- "size": 239798848
18
+ "checksum": "a6d0d25946c32a24b4e04471af70845a45428ca069fb3b489345f2a683262279",
19
+ "size": 246024768
20
20
  },
21
21
  "linux-x64": {
22
22
  "binary": "claude",
23
- "checksum": "ba363b2410a47120d2d4b8ece2e11fe0bbc5d59adb1329e8fb87ea0f370f4e46",
24
- "size": 239573632
23
+ "checksum": "12c0d6eb6d39dc2597fd131d8ea4f12ed8bf25b47dadd9173878e6d025959c9f",
24
+ "size": 245832320
25
25
  },
26
26
  "linux-arm64-musl": {
27
27
  "binary": "claude",
28
- "checksum": "dcb27938ed10b7da586b6f7ba0dde768980b5e3d38b258c1f4e9a94e7b3dd6d2",
29
- "size": 232524224
28
+ "checksum": "8b8d02e87c842f90d5ad47321ea6f42b581fafe7cd50cd9fba5b27fe89ff51df",
29
+ "size": 238750080
30
30
  },
31
31
  "linux-x64-musl": {
32
32
  "binary": "claude",
33
- "checksum": "bd05142de3e3ead48313d4215577c9a9c89f05ca286d771cdff025544c52ae29",
34
- "size": 233839040
33
+ "checksum": "5406ef30a37413e9e6fdac1c641742e8c2b88f033256e8ba1ece0b4419d30157",
34
+ "size": 240097664
35
35
  },
36
36
  "win32-x64": {
37
37
  "binary": "claude.exe",
38
- "checksum": "5a05b03b880de26bb78fb9824bacf08e99dcf05c02e3c66546cccaf2f2930b2e",
39
- "size": 249035936
38
+ "checksum": "987d99dfae28c9a554bbb15a9d432cfa75df7c175db523c232ef68950068df4c",
39
+ "size": 251858080
40
40
  },
41
41
  "win32-arm64": {
42
42
  "binary": "claude.exe",
43
- "checksum": "b3d8942b49f672ef2e1394e004f0f53e197caefe30890620b6974a3e8dba63ec",
44
- "size": 245760672
43
+ "checksum": "2bf424fe9772eadae4dc814126b5a1184d5d1d63be9f342fde251580d678fd04",
44
+ "size": 247922336
45
45
  }
46
46
  }
47
47
  }
package/manifest.zst.json CHANGED
@@ -1,55 +1,55 @@
1
1
  {
2
- "version": "2.1.118",
3
- "commit": "ef88b5f0a79aac989f53fd18178939a54a48624a",
4
- "buildDate": "2026-04-22T22:50:17Z",
2
+ "version": "2.1.120",
3
+ "commit": "080f07fb4224786b965b9ea0a35f0cff594f2eb6",
4
+ "buildDate": "2026-04-24T21:58:09Z",
5
5
  "platforms": {
6
6
  "darwin-arm64": {
7
7
  "binary": "claude.zst",
8
- "checksum": "0895347a08fe909e1761d0b73e18cdc8b4c0ad63d159bf422c8e3d49234a3b97",
9
- "size": 43098168,
8
+ "checksum": "adcdcaf24ae240fdc59a2c5e790c2d1eb3d93cb729ff9ba9993a3801553c7201",
9
+ "size": 44236339,
10
10
  "bundle": {
11
- "checksum": "10c7965cd61422b4f81cf2a9b08f023a38e4b24240e0373313ddf2596882db69",
12
- "size": 43107336
11
+ "checksum": "cf5f610c299ce7eddc8b83a32aff1aba4308b93e9d25539549f3c52c2315b5bb",
12
+ "size": 44244892
13
13
  }
14
14
  },
15
15
  "darwin-x64": {
16
16
  "binary": "claude.zst",
17
- "checksum": "b0537677a5aaa0d3e85f44ee6f14e984c6cdf0cf8fe9e2f883067586d591337e",
18
- "size": 44811420,
17
+ "checksum": "b2cbcbe5e57a7fbd89d73fdc1f6488116034aaa3c85b59530552cae50b478451",
18
+ "size": 45941282,
19
19
  "bundle": {
20
- "checksum": "6ac33e23fea2e737a7664ae4e73569e8f21fb08e6f01e4d079eede44116011fb",
21
- "size": 44810879
20
+ "checksum": "ad46d2cb1134bde351eb95406f07f33be2b27410b8e1029fc028b86f95a969fb",
21
+ "size": 45945061
22
22
  }
23
23
  },
24
24
  "linux-arm64": {
25
25
  "binary": "claude.zst",
26
- "checksum": "7eb45089b179a0688de458ccbb0df8c33eacc2183808a8a54d50cee8ea928597",
27
- "size": 52732492
26
+ "checksum": "be345830447e7ac70aee331f1faae49c1f0c621aae0dfcec5f4555635a723691",
27
+ "size": 53802919
28
28
  },
29
29
  "linux-x64": {
30
30
  "binary": "claude.zst",
31
- "checksum": "063d156f8028c20ab84d7ff9188f6ca187920fa8dcca48d1b4d2dd2b831d11cb",
32
- "size": 53288756
31
+ "checksum": "9a00a29b1acc0c18e214e18d435176baaab24ab49f33b67c25d30a8689378325",
32
+ "size": 54375672
33
33
  },
34
34
  "linux-arm64-musl": {
35
35
  "binary": "claude.zst",
36
- "checksum": "3b46a777475682fbfbdfd6ac70e71e627fd9ceb6cd53d71b0ec05e1d8a4be8e3",
37
- "size": 51352015
36
+ "checksum": "db04f97ee06c0e6ec43cfeb1b78f76fafc245a9dc2107a821bdca6c451cccc02",
37
+ "size": 52412046
38
38
  },
39
39
  "linux-x64-musl": {
40
40
  "binary": "claude.zst",
41
- "checksum": "8c45470b73bf2016db60bc0200bc78021adccbd05b0ad266547ac41aad74cd1f",
42
- "size": 51983350
41
+ "checksum": "ac0c7ebb578d0502cd35e1384eadf3a16307ab8c6a35ca9fb7af35ce0c9dd9ed",
42
+ "size": 53073404
43
43
  },
44
44
  "win32-x64": {
45
45
  "binary": "claude.exe.zst",
46
- "checksum": "5ef7753a8aa0ca80f951acc832bde5da46731751fb4f7b9193fb24099823f26a",
47
- "size": 54917824
46
+ "checksum": "573e670be41609ef16e34ff686a8e4aeb3249fca6166fd0978d2ba49750955d8",
47
+ "size": 55443349
48
48
  },
49
49
  "win32-arm64": {
50
50
  "binary": "claude.exe.zst",
51
- "checksum": "af53cf487f65fc168964deb3ed26105965ad78433b438d51e7bbf7b8054c636b",
52
- "size": 53057220
51
+ "checksum": "4713446d69307b5a026e6553ae64e6518ef82727ebaa1a8a9b09f80e5637b73b",
52
+ "size": 53562966
53
53
  }
54
54
  }
55
55
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.2.118",
3
+ "version": "0.2.120",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -55,14 +55,14 @@
55
55
  "zod": "^4.0.0"
56
56
  },
57
57
  "optionalDependencies": {
58
- "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.118",
59
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.118",
60
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.118",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.118",
62
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.118",
63
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.118",
64
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.118",
65
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.118"
58
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.120",
59
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.120",
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.120",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.120",
62
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.120",
63
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.120",
64
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.120",
65
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.120"
66
66
  },
67
67
  "files": [
68
68
  "sdk.mjs",
@@ -78,5 +78,5 @@
78
78
  "manifest.json",
79
79
  "manifest.zst.json"
80
80
  ],
81
- "claudeCodeVersion": "2.1.118"
81
+ "claudeCodeVersion": "2.1.120"
82
82
  }
package/sdk.d.ts CHANGED
@@ -1343,6 +1343,13 @@ export declare type Options = {
1343
1343
  * When true, `SDKPartialAssistantMessage` events will be emitted during streaming.
1344
1344
  */
1345
1345
  includePartialMessages?: boolean;
1346
+ /**
1347
+ * Forward subagent text and thinking blocks as assistant/user messages with
1348
+ * `parent_tool_use_id` set. By default, only tool_use/tool_result blocks from
1349
+ * subagents are emitted (enough for a heartbeat counter). When true, the full
1350
+ * subagent conversation is forwarded so consumers can render a nested transcript.
1351
+ */
1352
+ forwardSubagentText?: boolean;
1346
1353
  /**
1347
1354
  * Controls Claude's thinking/reasoning behavior.
1348
1355
  *
@@ -1606,10 +1613,34 @@ export declare type Options = {
1606
1613
  * - `'project'` - Project settings (`.claude/settings.json`)
1607
1614
  * - `'local'` - Local settings (`.claude/settings.local.json`)
1608
1615
  *
1609
- * When omitted or empty, no filesystem settings are loaded (SDK isolation mode).
1616
+ * When omitted, all sources are loaded (matches CLI defaults).
1617
+ * Pass `[]` to disable filesystem settings (SDK isolation mode).
1610
1618
  * Must include `'project'` to load CLAUDE.md files.
1611
1619
  */
1612
1620
  settingSources?: SettingSource[];
1621
+ /**
1622
+ * Skills to enable for the main session. This is the single place to turn
1623
+ * skills on; you do not need to add `'Skill'` to `allowedTools` yourself
1624
+ * when using this option.
1625
+ *
1626
+ * - omitted (default): no SDK auto-configuration. The CLI's own defaults
1627
+ * still apply, so this is **not** "skills off."
1628
+ * - `'all'`: enable every discovered skill.
1629
+ * - `string[]`: enable only the listed skills. Names match the SKILL.md
1630
+ * `name` / directory name, or `plugin:skill` for plugin-qualified skills.
1631
+ *
1632
+ * This is a context filter, not a sandbox: unlisted skills are hidden from
1633
+ * the model's listing and rejected by the Skill tool, but their files
1634
+ * remain on disk and are reachable via Read/Bash. Do not store secrets in
1635
+ * skill files.
1636
+ *
1637
+ * @example
1638
+ * ```typescript
1639
+ * skills: 'all'
1640
+ * skills: ['pdf', 'docx']
1641
+ * ```
1642
+ */
1643
+ skills?: string[] | 'all';
1613
1644
  /**
1614
1645
  * Enable debug mode for the Claude Code process.
1615
1646
  * When true, enables verbose debug logging (equivalent to `--debug` CLI flag).
@@ -1860,6 +1891,10 @@ export declare type PostToolUseFailureHookInput = BaseHookInput & {
1860
1891
  tool_use_id: string;
1861
1892
  error: string;
1862
1893
  is_interrupt?: boolean;
1894
+ /**
1895
+ * Tool execution time in milliseconds. Excludes permission-prompt and hook time.
1896
+ */
1897
+ duration_ms?: number;
1863
1898
  };
1864
1899
 
1865
1900
  export declare type PostToolUseFailureHookSpecificOutput = {
@@ -1873,6 +1908,10 @@ export declare type PostToolUseHookInput = BaseHookInput & {
1873
1908
  tool_input: unknown;
1874
1909
  tool_response: unknown;
1875
1910
  tool_use_id: string;
1911
+ /**
1912
+ * Tool execution time in milliseconds. Excludes permission-prompt and hook time.
1913
+ */
1914
+ duration_ms?: number;
1876
1915
  };
1877
1916
 
1878
1917
  export declare type PostToolUseHookSpecificOutput = {
@@ -2092,6 +2131,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
2092
2131
 
2093
2132
 
2094
2133
 
2134
+
2095
2135
  /**
2096
2136
  * Reconnect an MCP server by name.
2097
2137
  * Throws on failure.
@@ -2361,6 +2401,13 @@ declare type SDKControlFileSuggestionsRequest = {
2361
2401
  query: string;
2362
2402
  };
2363
2403
 
2404
+ /**
2405
+ * 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.
2406
+ */
2407
+ declare type SDKControlGetBinaryVersionRequest = {
2408
+ subtype: 'get_binary_version';
2409
+ };
2410
+
2364
2411
  /**
2365
2412
  * Requests a breakdown of current context window usage by category.
2366
2413
  */
@@ -2507,6 +2554,7 @@ declare type SDKControlInitializeRequest = {
2507
2554
  skills?: string[];
2508
2555
  promptSuggestions?: boolean;
2509
2556
  agentProgressSummaries?: boolean;
2557
+ forwardSubagentText?: boolean;
2510
2558
  };
2511
2559
 
2512
2560
  /**
@@ -2665,7 +2713,7 @@ export declare type SDKControlRequest = {
2665
2713
  request: SDKControlRequestInner;
2666
2714
  };
2667
2715
 
2668
- 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;
2716
+ 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 | SDKControlSubmitFeedbackRequest;
2669
2717
 
2670
2718
  /**
2671
2719
  * 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 +2967,7 @@ export declare type SDKMessageOrigin = {
2919
2967
  };
2920
2968
 
2921
2969
  /**
2922
- * 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.
2970
+ * 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.
2923
2971
  */
2924
2972
  export declare type SDKMirrorErrorMessage = {
2925
2973
  type: 'system';
@@ -3024,7 +3072,7 @@ export declare type SDKRateLimitInfo = {
3024
3072
  utilization?: number;
3025
3073
  overageStatus?: 'allowed' | 'allowed_warning' | 'rejected';
3026
3074
  overageResetsAt?: number;
3027
- 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';
3075
+ 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';
3028
3076
  isUsingOverage?: boolean;
3029
3077
  surpassedThreshold?: number;
3030
3078
  };
@@ -3172,7 +3220,9 @@ export declare type SDKSessionOptions = {
3172
3220
  cwd?: string;
3173
3221
  /**
3174
3222
  * Which settings sources to load (CLAUDE.md, `.claude/settings.json`).
3175
- * Defaults to `[]` no project/user settings are loaded unless specified.
3223
+ * Defaults to `[]`: no project/user settings are loaded unless specified.
3224
+ * Note that `query()` has the opposite default and loads all sources when
3225
+ * this is omitted.
3176
3226
  */
3177
3227
  settingSources?: SettingSource[];
3178
3228
  /**
@@ -3288,6 +3338,7 @@ export declare type SDKSystemMessage = {
3288
3338
 
3289
3339
  fast_mode_state?: FastModeState;
3290
3340
 
3341
+
3291
3342
  uuid: UUID;
3292
3343
  session_id: string;
3293
3344
  };
@@ -3353,7 +3404,7 @@ export declare type SDKTaskUpdatedMessage = {
3353
3404
  subtype: 'task_updated';
3354
3405
  task_id: string;
3355
3406
  /**
3356
- * Wire-safe subset of TaskState fields that changed. Excludes abortController, unregisterCleanup, messages, result. Clients merge into their local task map.
3407
+ * Wire-safe subset of TaskState fields that changed. Excludes abortController, messages, result. Clients merge into their local task map.
3357
3408
  */
3358
3409
  patch: {
3359
3410
  status?: 'pending' | 'running' | 'completed' | 'failed' | 'killed';
@@ -3522,8 +3573,16 @@ export declare type SessionStore = {
3522
3573
  * Within a single process, persist entries in append-call order; across
3523
3574
  * concurrent processes, order is by storage commit time, not call time.
3524
3575
  *
3525
- * Rejection is logged; the subprocess continues unaffected.
3526
- * At-most-once delivery failed batches are not retried.
3576
+ * Most entries carry a stable `uuid`. Adapters SHOULD treat `uuid` as an
3577
+ * idempotency key (upsert / ignore-duplicate) so that retries and
3578
+ * `importSessionToStore()` replays do not create duplicate rows. Entries
3579
+ * without a `uuid` (e.g. titles, tags, mode markers) should be appended
3580
+ * without dedup.
3581
+ *
3582
+ * Rejection is retried (3 attempts total) with short backoff; timeouts
3583
+ * (60s) are not retried since the in-flight call may still land. After
3584
+ * the final failure the batch is dropped and a `mirror_error` system
3585
+ * message is emitted. The subprocess continues unaffected.
3527
3586
  */
3528
3587
  append(key: SessionKey, entries: SessionStoreEntry[]): Promise<void>;
3529
3588
  /**
@@ -3840,7 +3899,7 @@ export declare interface Settings {
3840
3899
  */
3841
3900
  if?: string;
3842
3901
  /**
3843
- * Shell interpreter. 'bash' uses your $SHELL (bash/zsh/sh); 'powershell' uses pwsh. Defaults to bash.
3902
+ * Shell interpreter. 'bash' uses your $SHELL (bash/zsh/sh); 'powershell' uses pwsh. Defaults to bash (powershell on Windows without Git Bash).
3844
3903
  */
3845
3904
  shell?: 'bash' | 'powershell';
3846
3905
  /**
@@ -4056,7 +4115,15 @@ export declare interface Settings {
4056
4115
  * Re-run the status line command every N seconds in addition to event-driven updates
4057
4116
  */
4058
4117
  refreshInterval?: number;
4118
+ /**
4119
+ * Hide the built-in `-- INSERT --` / `-- VISUAL --` indicator below the prompt. Use this when your status line script renders `vim.mode` itself.
4120
+ */
4121
+ hideVimModeIndicator?: boolean;
4059
4122
  };
4123
+ /**
4124
+ * 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}"
4125
+ */
4126
+ prUrlTemplate?: string;
4060
4127
  /**
4061
4128
  * Custom per-subagent status line shown in the agent panel; receives row context as JSON on stdin
4062
4129
  */
@@ -4235,6 +4302,8 @@ export declare interface Settings {
4235
4302
  * Specific commit SHA to use
4236
4303
  */
4237
4304
  sha?: string;
4305
+ } | {
4306
+ source: 'unsupported';
4238
4307
  };
4239
4308
  description?: string;
4240
4309
  version?: string;
@@ -4423,6 +4492,8 @@ export declare interface Settings {
4423
4492
  * Specific commit SHA to use
4424
4493
  */
4425
4494
  sha?: string;
4495
+ } | {
4496
+ source: 'unsupported';
4426
4497
  };
4427
4498
  description?: string;
4428
4499
  version?: string;
@@ -4601,6 +4672,8 @@ export declare interface Settings {
4601
4672
  * Specific commit SHA to use
4602
4673
  */
4603
4674
  sha?: string;
4675
+ } | {
4676
+ source: 'unsupported';
4604
4677
  };
4605
4678
  description?: string;
4606
4679
  version?: string;
@@ -4937,6 +5010,78 @@ export declare interface Settings {
4937
5010
  * 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.").
4938
5011
  */
4939
5012
  pluginTrustMessage?: string;
5013
+ /**
5014
+ * Color theme for the UI
5015
+ */
5016
+ theme?: ('auto' | 'dark' | 'light' | 'light-daltonized' | 'dark-daltonized' | 'light-ansi' | 'dark-ansi') | string;
5017
+ /**
5018
+ * Key binding mode for the prompt input
5019
+ */
5020
+ editorMode?: 'normal' | 'vim';
5021
+ /**
5022
+ * Show full tool output instead of truncated summaries
5023
+ */
5024
+ verbose?: boolean;
5025
+ /**
5026
+ * Preferred OS notification channel
5027
+ */
5028
+ preferredNotifChannel?: 'auto' | 'iterm2' | 'iterm2_with_bell' | 'terminal_bell' | 'kitty' | 'ghostty' | 'notifications_disabled';
5029
+ /**
5030
+ * Automatically compact conversation when context fills
5031
+ */
5032
+ autoCompactEnabled?: boolean;
5033
+ /**
5034
+ * Auto-scroll the conversation view to bottom (fullscreen mode only)
5035
+ */
5036
+ autoScrollEnabled?: boolean;
5037
+ /**
5038
+ * Snapshot files before edits so /rewind can restore them
5039
+ */
5040
+ fileCheckpointingEnabled?: boolean;
5041
+ /**
5042
+ * Show "Cooked for Nm Ns" after each assistant turn
5043
+ */
5044
+ showTurnDuration?: boolean;
5045
+ /**
5046
+ * Stamp each assistant message with its arrival time
5047
+ */
5048
+ showMessageTimestamps?: boolean;
5049
+ /**
5050
+ * Emit OSC 9;4 progress sequences during long operations
5051
+ */
5052
+ terminalProgressBarEnabled?: boolean;
5053
+ /**
5054
+ * Enable the todo / task tracking panel
5055
+ */
5056
+ todoFeatureEnabled?: boolean;
5057
+ /**
5058
+ * How spawned teammates execute (tmux, in-process, auto)
5059
+ */
5060
+ teammateMode?: 'auto' | 'tmux' | 'in-process';
5061
+ /**
5062
+ * Start Remote Control bridge automatically each session
5063
+ */
5064
+ remoteControlAtStartup?: boolean;
5065
+ /**
5066
+ * When no background daemon is running: 'transient' spawns one for this login session; 'ask' offers to install a persistent service
5067
+ */
5068
+ daemonColdStart?: 'transient' | 'ask';
5069
+ /**
5070
+ * Mirror local sessions to claude.ai as view-only (no remote control)
5071
+ */
5072
+ autoUploadSessions?: boolean;
5073
+ /**
5074
+ * Push to mobile when a permission prompt or question is waiting
5075
+ */
5076
+ inputNeededNotifEnabled?: boolean;
5077
+ /**
5078
+ * Allow Claude to push proactive mobile notifications
5079
+ */
5080
+ agentPushNotifEnabled?: boolean;
5081
+ /**
5082
+ * Prevent claude-cli:// protocol handler registration with the OS
5083
+ */
5084
+ disableDeepLinkRegistration?: 'disable';
4940
5085
  [k: string]: unknown;
4941
5086
  }
4942
5087
 
@@ -4971,6 +5116,10 @@ export declare type SlashCommand = {
4971
5116
  * Hint for skill arguments (e.g., "<file>")
4972
5117
  */
4973
5118
  argumentHint: string;
5119
+ /**
5120
+ * Alternate names that resolve to this command (e.g., /cost and /stats both resolve to /usage)
5121
+ */
5122
+ aliases?: string[];
4974
5123
  };
4975
5124
 
4976
5125
  /**
@@ -5043,7 +5192,7 @@ export declare function startup(_params?: {
5043
5192
  initializeTimeoutMs?: number;
5044
5193
  }): Promise<WarmQuery>;
5045
5194
 
5046
- declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
5195
+ declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTaskSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
5047
5196
 
5048
5197
  export declare type StopFailureHookInput = BaseHookInput & {
5049
5198
  hook_event_name: 'StopFailure';