@anthropic-ai/claude-agent-sdk 0.2.114 → 0.2.116

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,46 +1,47 @@
1
1
  {
2
- "version": "2.1.114",
3
- "buildDate": "2026-04-17T22:43:08Z",
2
+ "version": "2.1.116",
3
+ "commit": "9e176d0772418b8b88475d39fb86c651a12f4aad",
4
+ "buildDate": "2026-04-20T18:41:27Z",
4
5
  "platforms": {
5
6
  "darwin-arm64": {
6
7
  "binary": "claude",
7
- "checksum": "bf1b4da368da7970f0d1d4a1675acea99b6f2ad94f24e9f8ccfcc7940ac67894",
8
- "size": 204534752
8
+ "checksum": "4ecfb5b5c30585d0a3d5b5ef802a39804ddc33a63012ee0d4aee4d4e3db46eb4",
9
+ "size": 205789664
9
10
  },
10
11
  "darwin-x64": {
11
12
  "binary": "claude",
12
- "checksum": "1a30360b6240056a58ba9187c8f9d2e88e949e0f970d5cf81f8d69bc65568f6a",
13
- "size": 206004048
13
+ "checksum": "4586d0c17772a826d0d57e4664b66ffba21a01d11a8611a5566b587bf24c340a",
14
+ "size": 207258960
14
15
  },
15
16
  "linux-arm64": {
16
17
  "binary": "claude",
17
- "checksum": "9556b74e2c912e7dcaef90c91fd0dd5095364f8a9d71398de3c5c669612b828a",
18
- "size": 236653120
18
+ "checksum": "dc3854c271a5323da9047f90c5b1a5bdf78ac03474eb45c9c26b84ecf9f2134c",
19
+ "size": 237898304
19
20
  },
20
21
  "linux-x64": {
21
22
  "binary": "claude",
22
- "checksum": "12bd4b0916deb06be17ffc7b2f0485e140bf00b2db3dcb78469d66723d73c27f",
23
- "size": 236411520
23
+ "checksum": "0d1aea5ce056a5ce491da7e9bbe63f992585e5c24852f023a07c8f18cf292cc5",
24
+ "size": 237652608
24
25
  },
25
26
  "linux-arm64-musl": {
26
27
  "binary": "claude",
27
- "checksum": "20c68c312e76fb81f52cd2006b1461a0eedd470798f44b9b4a833ad583ccc05b",
28
- "size": 229378496
28
+ "checksum": "e7ed54a9dc6aa4ce2b69e8c4eb90838bcf814a9ee50ac29f93f0f80e890a5009",
29
+ "size": 230623680
29
30
  },
30
31
  "linux-x64-musl": {
31
32
  "binary": "claude",
32
- "checksum": "fbbcfa225e948d9263c39f8be29a956ea4bd3a445f79aa9396cdc3263ea05690",
33
- "size": 230676928
33
+ "checksum": "26919d621bee09fda753564ca5ccb594edc1e753a9092e61dec71562a4b7f65c",
34
+ "size": 231918016
34
35
  },
35
36
  "win32-x64": {
36
37
  "binary": "claude.exe",
37
- "checksum": "6f4a961ea8a1d656c41dd71cbef202cb71d13c443f86818c721167c33f8a51fd",
38
- "size": 245966496
38
+ "checksum": "41c82dc1988225938a7d588b157aef3cd3c2fd62ff0661731132404d5bf17258",
39
+ "size": 247174304
39
40
  },
40
41
  "win32-arm64": {
41
42
  "binary": "claude.exe",
42
- "checksum": "acdc5b7004491662f10622124c509b018a6a6c5566adf3e217f2dd4dad64ef34",
43
- "size": 242697888
43
+ "checksum": "1e24e1f042fc45c408663d12c0c9d62cb5dd8955f9efd67f87d7e5305d105535",
44
+ "size": 243905696
44
45
  }
45
46
  }
46
47
  }
package/manifest.zst.json CHANGED
@@ -1,54 +1,55 @@
1
1
  {
2
- "version": "2.1.114",
3
- "buildDate": "2026-04-17T22:49:55Z",
2
+ "version": "2.1.116",
3
+ "commit": "9e176d0772418b8b88475d39fb86c651a12f4aad",
4
+ "buildDate": "2026-04-20T18:48:30Z",
4
5
  "platforms": {
5
6
  "darwin-arm64": {
6
7
  "binary": "claude.zst",
7
- "checksum": "b8220425c5a3e97afe3dc7f3f27de762f676a0a73959a09e897b5167aaf0aee0",
8
- "size": 42277659,
8
+ "checksum": "affc54b1d14b599892cd6fea77a1d8e5de1fbcf8ca99badf4b91201341f68d28",
9
+ "size": 42488115,
9
10
  "bundle": {
10
- "checksum": "83db62e18b915ec6121f042b5a40b268c906f995a49a33867bcd9da46883cce5",
11
- "size": 42276919
11
+ "checksum": "b90230f9d8f6f5af4974aa87e61923af411548675c6eeb001818b14e9083f430",
12
+ "size": 42492497
12
13
  }
13
14
  },
14
15
  "darwin-x64": {
15
16
  "binary": "claude.zst",
16
- "checksum": "dbfb3372a0732fd9f3a320816f36c1dc5178d7fffbf9c91f5f1f6951e5a8334d",
17
- "size": 43963023,
17
+ "checksum": "95893b7e704357d8a4e0ccc1f929393c7fcfa0b9e9987783bff8977a25fde206",
18
+ "size": 44191836,
18
19
  "bundle": {
19
- "checksum": "f9d8d65b0d8d6fc91813117b2964ba21f67628bc4d52a2d2c00d7b1a34408687",
20
- "size": 43974511
20
+ "checksum": "8cb0acc4b9d369a5d624401e69bad1b16fa5cd7c1ba73c27085683b23a92b28f",
21
+ "size": 44186846
21
22
  }
22
23
  },
23
24
  "linux-arm64": {
24
25
  "binary": "claude.zst",
25
- "checksum": "9da1672d9e0841dd456d4d9c6319ec1fd71e131f6c1d91836abc90ef80c37655",
26
- "size": 51918764
26
+ "checksum": "0e108736fe720030900f1012407d2e53fe4e989681af0bf9061a1046a505d0c0",
27
+ "size": 52145149
27
28
  },
28
29
  "linux-x64": {
29
30
  "binary": "claude.zst",
30
- "checksum": "77100932d09474f7e2ef8dad7fabae72d67a7b9a5712f286f78d7b81198c1b90",
31
- "size": 52481765
31
+ "checksum": "8abd364384020742be0ad54e30241c4eebbd1d0a161e3e894ce94394fab1c38c",
32
+ "size": 52687378
32
33
  },
33
34
  "linux-arm64-musl": {
34
35
  "binary": "claude.zst",
35
- "checksum": "c6cff1e1469cf989a6b9ef85b7c4363f332aae6168bd758a13880fba8345e7dc",
36
- "size": 50513429
36
+ "checksum": "c40236d9e4d57dab287b6b4c1398aa521e240aa24c979e09326c72401817a1e9",
37
+ "size": 50748398
37
38
  },
38
39
  "linux-x64-musl": {
39
40
  "binary": "claude.zst",
40
- "checksum": "201ca63bb06c17644b8586b3f0b07a092ecc2e8c4a01c8b9f5a546c7323023f2",
41
- "size": 51163154
41
+ "checksum": "72f4b3ceb8286c822628eac3be2f830a860bf5de1094a35c0c13280321cbdd2f",
42
+ "size": 51379287
42
43
  },
43
44
  "win32-x64": {
44
45
  "binary": "claude.exe.zst",
45
- "checksum": "1f03930bb917b649422185f94585c397542522e2876fe9b5e682579df8994044",
46
- "size": 54151586
46
+ "checksum": "a1a38656f78bb89f66edc11524e571306807b4cccc4554d582a06f8ea9e3e068",
47
+ "size": 54386127
47
48
  },
48
49
  "win32-arm64": {
49
50
  "binary": "claude.exe.zst",
50
- "checksum": "d58a5d87b301d5d1934c804f7b511d75638595ffc253bdb7412d17bd219fae04",
51
- "size": 52298787
51
+ "checksum": "32f3841681855d6cc00ee81880ff195cc054da7f1c8e63d33ef910c999f6e6d8",
52
+ "size": 52520071
52
53
  }
53
54
  }
54
55
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.2.114",
3
+ "version": "0.2.116",
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.114",
59
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.114",
60
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.114",
61
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.114",
62
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.114",
63
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.114",
64
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.114",
65
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.114"
58
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.2.116",
59
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.2.116",
60
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.2.116",
61
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.2.116",
62
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.2.116",
63
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.2.116",
64
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.2.116",
65
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.2.116"
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.114"
81
+ "claudeCodeVersion": "2.1.116"
82
82
  }
package/sdk-tools.d.ts CHANGED
@@ -2231,6 +2231,10 @@ export interface BashOutput {
2231
2231
  * Model-facing note listing readFileState entries whose mtime bumped during this command (set when WRITE_COMMAND_MARKERS matches)
2232
2232
  */
2233
2233
  staleReadFileStateHint?: string;
2234
+ /**
2235
+ * Model-facing system-reminder appended when a gh command reports a GitHub API rate-limit error
2236
+ */
2237
+ ghRateLimitHint?: string;
2234
2238
  }
2235
2239
  export interface ExitPlanModeOutput {
2236
2240
  /**
package/sdk.d.ts CHANGED
@@ -399,6 +399,8 @@ declare namespace coreTypes {
399
399
  ThinkingConfig,
400
400
  ThinkingDisabled,
401
401
  ThinkingEnabled,
402
+ UserPromptExpansionHookInput,
403
+ UserPromptExpansionHookSpecificOutput,
402
404
  UserPromptSubmitHookInput,
403
405
  UserPromptSubmitHookSpecificOutput,
404
406
  WorktreeCreateHookInput,
@@ -682,7 +684,7 @@ export declare type GetSubagentMessagesOptions = {
682
684
  sessionStore?: SessionStore;
683
685
  };
684
686
 
685
- export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "PermissionDenied", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged"];
687
+ export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "UserPromptExpansion", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "PermissionDenied", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged"];
686
688
 
687
689
  /**
688
690
  * Hook callback function for responding to events during execution.
@@ -701,9 +703,9 @@ export declare interface HookCallbackMatcher {
701
703
  timeout?: number;
702
704
  }
703
705
 
704
- export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'StopFailure' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PostCompact' | 'PermissionRequest' | 'PermissionDenied' | 'Setup' | 'TeammateIdle' | 'TaskCreated' | 'TaskCompleted' | 'Elicitation' | 'ElicitationResult' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'InstructionsLoaded' | 'CwdChanged' | 'FileChanged';
706
+ export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'UserPromptExpansion' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'StopFailure' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PostCompact' | 'PermissionRequest' | 'PermissionDenied' | 'Setup' | 'TeammateIdle' | 'TaskCreated' | 'TaskCompleted' | 'Elicitation' | 'ElicitationResult' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'InstructionsLoaded' | 'CwdChanged' | 'FileChanged';
705
707
 
706
- export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | PermissionDeniedHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | StopFailureHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PostCompactHookInput | PermissionRequestHookInput | SetupHookInput | TeammateIdleHookInput | TaskCreatedHookInput | TaskCompletedHookInput | ElicitationHookInput | ElicitationResultHookInput | ConfigChangeHookInput | InstructionsLoadedHookInput | WorktreeCreateHookInput | WorktreeRemoveHookInput | CwdChangedHookInput | FileChangedHookInput;
708
+ export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | PermissionDeniedHookInput | NotificationHookInput | UserPromptSubmitHookInput | UserPromptExpansionHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | StopFailureHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PostCompactHookInput | PermissionRequestHookInput | SetupHookInput | TeammateIdleHookInput | TaskCreatedHookInput | TaskCompletedHookInput | ElicitationHookInput | ElicitationResultHookInput | ConfigChangeHookInput | InstructionsLoadedHookInput | WorktreeCreateHookInput | WorktreeRemoveHookInput | CwdChangedHookInput | FileChangedHookInput;
707
709
 
708
710
  export declare type HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput;
709
711
 
@@ -1960,6 +1962,18 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
1960
1962
  * @returns Context usage breakdown including token counts per category and total usage
1961
1963
  */
1962
1964
  getContextUsage(): Promise<SDKControlGetContextUsageResponse>;
1965
+ /**
1966
+ * Read a file from the session's filesystem for the remote sidebar
1967
+ * viewer. Path is resolved against cwd and gated by the same
1968
+ * read-permission rules as the Read tool. Returns null on permission
1969
+ * denial, missing file, or transport error.
1970
+ *
1971
+ * @param path - File path (relative to cwd or absolute)
1972
+ * @param options - Optional maxBytes cap (default 1MB)
1973
+ */
1974
+ readFile(path: string, options?: {
1975
+ maxBytes?: number;
1976
+ }): Promise<SDKControlReadFileResponse | null>;
1963
1977
  /**
1964
1978
  * Reload plugins from disk and return the refreshed commands, agents,
1965
1979
  * plugins, and MCP server status.
@@ -1999,6 +2013,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
1999
2013
 
2000
2014
 
2001
2015
 
2016
+
2002
2017
  /**
2003
2018
  * Reconnect an MCP server by name.
2004
2019
  * Throws on failure.
@@ -2397,6 +2412,10 @@ declare type SDKControlInitializeRequest = {
2397
2412
  * Custom session title. When provided, the session uses this title and skips automatic title generation. Has no effect on the persisted title when resuming an existing session.
2398
2413
  */
2399
2414
  title?: string;
2415
+ /**
2416
+ * When provided, only skills whose names match an entry are loaded into the main session system prompt, using the same rules as AgentDefinition.skills: exact name, plugin-qualified name, or ":name" suffix. Omit to load every discovered skill. Applies to the main session only; subagents use AgentDefinition.skills.
2417
+ */
2418
+ skills?: string[];
2400
2419
  promptSuggestions?: boolean;
2401
2420
  agentProgressSummaries?: boolean;
2402
2421
  };
@@ -2425,6 +2444,18 @@ declare type SDKControlInterruptRequest = {
2425
2444
  subtype: 'interrupt';
2426
2445
  };
2427
2446
 
2447
+ /**
2448
+ * Invokes an MCP tool via the subprocess MCP client without a model turn. No permission check (control channel is trusted, same as other subtypes). SDK-type MCP servers (config.type === "sdk") are rejected — they are caller-provided, so the caller can invoke them directly without the subprocess round-trip. Result content passes through the same processing as model-turn MCP calls. Session expiry is not retried automatically; callers can mcp_reconnect and retry. UrlElicitationRequired (-32042) tries Elicitation hooks; if no hook resolves, the call errors with the URL in the message — open it out-of-band, then retry mcp_call.
2449
+ */
2450
+ declare type SDKControlMcpCallRequest = {
2451
+ subtype: 'mcp_call';
2452
+ /**
2453
+ * Fully-qualified MCP tool name, e.g. mcp__server__tool_name.
2454
+ */
2455
+ tool: string;
2456
+ arguments?: Record<string, unknown>;
2457
+ };
2458
+
2428
2459
  /**
2429
2460
  * Sends a JSON-RPC message to a specific MCP server.
2430
2461
  */
@@ -2476,6 +2507,14 @@ declare type SDKControlPermissionRequest = {
2476
2507
  permission_suggestions?: coreTypes.PermissionUpdate[];
2477
2508
  blocked_path?: string;
2478
2509
  decision_reason?: string;
2510
+ /**
2511
+ * Structured discriminator for why auto-mode escalated. Lets SDK hosts make policy (e.g. auto-deny safetyCheck) without parsing decision_reason text. For compound bash commands this is "subcommandResults" even when a safetyCheck is nested inside — check classifier_approvable for that case.
2512
+ */
2513
+ decision_reason_type?: 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'sandboxOverride' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
2514
+ /**
2515
+ * Set when a safetyCheck is present anywhere in the decision reason (including nested inside subcommandResults for compound bash). false = at least one safety check requires manual approval (e.g. Windows path bypass, dangerous rm); true = all safety checks MAY be classifier-approved (e.g. sensitive-file paths). Absent when no safetyCheck is involved.
2516
+ */
2517
+ classifier_approvable?: boolean;
2479
2518
  title?: string;
2480
2519
  display_name?: string;
2481
2520
  tool_use_id: string;
@@ -2483,6 +2522,24 @@ declare type SDKControlPermissionRequest = {
2483
2522
  description?: string;
2484
2523
  };
2485
2524
 
2525
+ /**
2526
+ * Read a file from the session filesystem for the remote sidebar viewer. Path is resolved against cwd and gated by the same read-permission rules as the Read tool.
2527
+ */
2528
+ declare type SDKControlReadFileRequest = {
2529
+ subtype: 'read_file';
2530
+ path: string;
2531
+ max_bytes?: number;
2532
+ };
2533
+
2534
+ /**
2535
+ * File contents for the remote sidebar viewer.
2536
+ */
2537
+ export declare type SDKControlReadFileResponse = {
2538
+ contents: string;
2539
+ absPath: string;
2540
+ truncated?: boolean;
2541
+ };
2542
+
2486
2543
  /**
2487
2544
  * Reloads plugins from disk and returns the refreshed session components.
2488
2545
  */
@@ -2519,7 +2576,7 @@ export declare type SDKControlRequest = {
2519
2576
  request: SDKControlRequestInner;
2520
2577
  };
2521
2578
 
2522
- declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
2579
+ declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | 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;
2523
2580
 
2524
2581
  /**
2525
2582
  * 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.
@@ -4455,7 +4512,7 @@ export declare interface Settings {
4455
4512
  sandbox?: {
4456
4513
  enabled?: boolean;
4457
4514
  /**
4458
- * Exit with an error at startup if sandbox.enabled is true but the sandbox cannot start (missing dependencies, unsupported platform, or platform not in enabledPlatforms). When false (default), a warning is shown and commands run unsandboxed. Intended for managed-settings deployments that require sandboxing as a hard gate.
4515
+ * Exit with an error at startup if sandbox.enabled is true but the sandbox cannot start (missing dependencies or unsupported platform). When false (default), a warning is shown and commands run unsandboxed. Intended for managed-settings deployments that require sandboxing as a hard gate.
4459
4516
  */
4460
4517
  failIfUnavailable?: boolean;
4461
4518
  autoAllowBashIfSandboxed?: boolean;
@@ -4646,7 +4703,20 @@ export declare interface Settings {
4646
4703
  * Terminal UI renderer. "fullscreen" uses the flicker-free alt-screen renderer with virtualized scrollback (equivalent to CLAUDE_CODE_NO_FLICKER=1). "default" uses the classic main-screen renderer.
4647
4704
  */
4648
4705
  tui?: 'default' | 'fullscreen';
4649
-
4706
+ /**
4707
+ * Voice mode settings (hold-to-talk / tap-to-toggle dictation)
4708
+ */
4709
+ voice?: {
4710
+ enabled?: boolean;
4711
+ /**
4712
+ * 'hold' (default): hold to talk. 'tap': tap to start, tap to stop+submit.
4713
+ */
4714
+ mode?: 'hold' | 'tap';
4715
+ /**
4716
+ * Submit the prompt when hold-to-talk is released (hold mode only)
4717
+ */
4718
+ autoSubmit?: boolean;
4719
+ };
4650
4720
  /**
4651
4721
  * Teams/Enterprise opt-in for channel notifications (MCP servers with the claude/channel capability pushing inbound messages). Default off. Set true to allow; users then select servers via --channels.
4652
4722
  */
@@ -4882,7 +4952,7 @@ export declare type SyncHookJSONOutput = {
4882
4952
  systemMessage?: string;
4883
4953
  reason?: string;
4884
4954
 
4885
- hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
4955
+ hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | UserPromptExpansionHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
4886
4956
  };
4887
4957
 
4888
4958
  /**
@@ -5052,6 +5122,20 @@ export declare function unstable_v2_prompt(_message: string, _options: SDKSessio
5052
5122
  */
5053
5123
  export declare function unstable_v2_resumeSession(_sessionId: string, _options: SDKSessionOptions): SDKSession;
5054
5124
 
5125
+ export declare type UserPromptExpansionHookInput = BaseHookInput & {
5126
+ hook_event_name: 'UserPromptExpansion';
5127
+ expansion_type: 'slash_command' | 'mcp_prompt';
5128
+ command_name: string;
5129
+ command_args: string;
5130
+ command_source?: string;
5131
+ prompt: string;
5132
+ };
5133
+
5134
+ export declare type UserPromptExpansionHookSpecificOutput = {
5135
+ hookEventName: 'UserPromptExpansion';
5136
+ additionalContext?: string;
5137
+ };
5138
+
5055
5139
  export declare type UserPromptSubmitHookInput = BaseHookInput & {
5056
5140
  hook_event_name: 'UserPromptSubmit';
5057
5141
  prompt: string;