@anthropic-ai/claude-agent-sdk 0.3.161 → 0.3.163

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.161",
-  "commit": "6a550aea7c747b1b0ddd8bb61dbe199c4ad41320",
-  "buildDate": "2026-06-02T01:55:49Z",
+  "version": "2.1.163",
+  "commit": "9f38ff86c75e05c94ceee0af5bd0414a1db475f3",
+  "buildDate": "2026-06-04T05:55:05Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "5b4dc79eab05f9756c252c71deb339efa4429dffc1967dd8392cf87fcde4867f",
-      "size": 218040864
+      "checksum": "c7582e926e8fe459dbd9743f19ccb75500e3b455c722902d1aa587a74fb1fa7c",
+      "size": 219526944
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "6f874fecac8a951f5f1991dc1470bc85a5e24f2588859b89cca0f1b6b5592310",
-      "size": 220555024
+      "checksum": "a409fc60ccd6789f47532791ed23ca048774cfbd0b0a16f9f57dbbf9240fda7c",
+      "size": 222041104
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "7dfa0a79a2fc9f332057cdc0302f808cba63df7b75e2ccb5a7c1ab62639804e3",
-      "size": 243316360
+      "checksum": "ca0010a80e3c4749e59c6e8429ec4a4e2ecbaafac36d3535636e04369bbb87c0",
+      "size": 244823688
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "1f6a22f387a3bce496b6d869389a35dffb5a69c97d9831833f3bd6dc0e6c6c28",
-      "size": 243439312
+      "checksum": "5dddcb2c091da60cf9b1bef782e6c78a7fada2f2cd3db4f131c9ebc2478fd447",
+      "size": 244913872
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "8318d4039c60fbb21a53e81f93e46a3b1dcdb9b07462f6fee72d99c9d2b93f83",
-      "size": 236171096
+      "checksum": "e1d7ce941ef42fd812d9fa28d72e04f745e7c4cfba5b91cb9f46f8a97bfb2adb",
+      "size": 237678424
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "f8e09e0b16502c277ca8a296245eb59f421e424763a99fd132551b701a713bcf",
-      "size": 237833264
+      "checksum": "8ac1df465ce3417f517bf4d375876c576d67af41a8795537c9022bdb9af5a600",
+      "size": 239307824
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "3b0b64caf3428fac3751bd1903c350870b34f9e7a4390ac7c2fdb3a711656a04",
-      "size": 239007904
+      "checksum": "99943f399d76e89a435b5e19a15814227bc258ba4afc583ec09c67933fdafd83",
+      "size": 240440992
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "f4a7d910fc5a8b46afc14c36108c46c8b0deeb8f316c6b7e4ede77868ce70acf",
-      "size": 234972832
+      "checksum": "d83903c8e10a95fd8de48b7c185e30320af5b96122eff49edfae7773bb8d8b08",
+      "size": 236405408
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.161",
-  "commit": "6a550aea7c747b1b0ddd8bb61dbe199c4ad41320",
-  "buildDate": "2026-06-02T02:02:00Z",
+  "version": "2.1.163",
+  "commit": "9f38ff86c75e05c94ceee0af5bd0414a1db475f3",
+  "buildDate": "2026-06-04T05:56:48Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "dbcf5e80cca576a2128e65625b1950f91d2b98bacfa6e939f597c75bd0b5602a",
-      "size": 44863384,
+      "checksum": "93af7c96c7995d79e98586f59b014258b2408c9335882d3e25acea81bb8c2cd2",
+      "size": 45149640,
       "bundle": {
-        "checksum": "ea3ad78ffc34f6700f489b3dd2a1e2e35c722d489ca54d62b63afcacb8911b5e",
-        "size": 44871367
+        "checksum": "0c37dca9ae70a477182ec8c321fa935384c05a47e0b80fc5d28f82104653ffb1",
+        "size": 45145341
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "227bcd6d41ed94d6ad6186fa9075f39aae9675ea480e47d5b09a9ea691a0a0a0",
-      "size": 46783803,
+      "checksum": "01a3b52436f38ffee1b9aceb42c116e617181e54ba695b8d3ef11903f6d80f70",
+      "size": 47040142,
       "bundle": {
-        "checksum": "baba937aa2b5f2fee497bbce09bb84f76fd5a076f49aebee32b46e771bbf9b10",
-        "size": 46791947
+        "checksum": "09e84b59e76a1575f376b607aeb98adcf9553a312cacf7223cc25adc5d33e985",
+        "size": 47043608
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "d46ca4ec38fe511d55357dedb9a437a6502627844370f0b548a124d6a1b436d0",
-      "size": 52578824
+      "checksum": "9632c5260f78479e00190fac7f7877ab4ac649d68ddbbd596da2775e61669e10",
+      "size": 52819087
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "65faa42998853bdff28b48f6857627335eb42dddb14c9b3d40fd769352d8f285",
-      "size": 53186973
+      "checksum": "1ed76dea245599a132bd2894bef96e810d2a969d261d9a6d43b0bd5566162cae",
+      "size": 53433603
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "f08efd1c7dcb0af9fcf94c62401307263c8fb17a6ac376b9563b9add74ff0f25",
-      "size": 51204872
+      "checksum": "0d3b2cf2e5e837fc35ecdafb9a4fab97954b409b951e00ca91c5419f13f86dad",
+      "size": 51453599
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "277891cd44e6f35050bce322cc99e13753acdc2d5bb41664d6de9ccfaf161239",
-      "size": 51901930
+      "checksum": "a7fe4d9e3d87419eac7af8ebff5f4080d9a725763f7e2bc830a7639243f1f1de",
+      "size": 52171611
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "7a53001a2a895dfd019ff275134e2cd4332ad21b3016e997c554775bb5737ab3",
-      "size": 53917556
+      "checksum": "1e033a7a2adaaaa1cc6d954e183a192fdd0779abbb346f3b2ac36461ec16723e",
+      "size": 54179611
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "47051d39f2d78603437d5cba03ef2885e9448d84160497b3d2890e7ada96a4ad",
-      "size": 52194218
+      "checksum": "a723c2fb77474adc59f8939435e02065416ffa5f0bbb94f47aabc7969ca9b720",
+      "size": 52448455
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.161",
+  "version": "0.3.163",
   "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.161",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.161",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.161",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.161",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.161",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.161",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.161",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.161"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.163",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.163"
   },
   "files": [
     "sdk.mjs",
@@ -86,5 +86,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.161"
+  "claudeCodeVersion": "2.1.163"
 }

package/sdk.d.ts

@@ -443,9 +443,11 @@ declare namespace coreTypes {
         SlashCommand,
         StopFailureHookInput,
         StopHookInput,
+        StopHookSpecificOutput,
         SubagentStartHookInput,
         SubagentStartHookSpecificOutput,
         SubagentStopHookInput,
+        SubagentStopHookSpecificOutput,
         SyncHookJSONOutput,
         TaskCompletedHookInput,
         TaskCreatedHookInput,
@@ -1000,7 +1002,7 @@ export declare type McpClaudeAIProxyServerConfig = {
     url: string;
     id: string;
     /**
-     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
      */
     timeout?: number;
 };
@@ -1011,7 +1013,7 @@ export declare type McpHttpServerConfig = {
     headers?: Record<string, string>;
     tools?: McpServerToolPolicy[];
     /**
-     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
      */
     timeout?: number;
     /**
@@ -1121,7 +1123,7 @@ export declare type McpSSEServerConfig = {
     headers?: Record<string, string>;
     tools?: McpServerToolPolicy[];
     /**
-     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
      */
     timeout?: number;
     /**
@@ -1137,7 +1139,7 @@ export declare type McpStdioServerConfig = {
     args?: string[];
     env?: Record<string, string>;
     /**
-     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Floored at 1000ms.
+     * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
      */
     timeout?: number;
     /**
@@ -1258,6 +1260,16 @@ export declare type OnElicitation = (request: ElicitationRequest, options: {
     signal: AbortSignal;
 }) => Promise<ElicitationResult>;
 
+/**
+ * Callback for handling `request_user_dialog` control requests.
+ * Called when the CLI asks the host to render a blocking dialog.
+ * If not provided, dialogs are answered as cancelled and the CLI applies
+ * each dialog's default behavior.
+ */
+export declare type OnUserDialog = (request: UserDialogRequest, options: {
+    signal: AbortSignal;
+}) => Promise<UserDialogResult>;
+
 /**
  * Options for the query function.
  * Contains callbacks and other non-serializable fields.
@@ -1367,6 +1379,9 @@ export declare type Options = {
      * - `string[]` - Array of specific tool names (e.g., `['Bash', 'Read', 'Edit']`)
      * - `[]` (empty array) - Disable all built-in tools
      * - `{ type: 'preset'; preset: 'claude_code' }` - Use all default Claude Code tools
+     *
+     * Note: native builds may provide search via Bash `find`/`grep` instead of the
+     * dedicated Grep/Glob tools. List Grep/Glob here or in `allowedTools` to get them.
      */
     tools?: string[] | {
         type: 'preset';
@@ -1480,6 +1495,16 @@ export declare type Options = {
      * ```
      */
     onElicitation?: OnElicitation;
+    /**
+     * Callback for handling `request_user_dialog` control requests — blocking
+     * dialogs the CLI asks the host to render. Each `dialogKind` defines its
+     * own payload and result shape.
+     *
+     * If not provided — or when the host answers `{behavior: 'cancelled'}`,
+     * which is the required answer for an unrecognized `dialogKind` — the CLI
+     * applies the dialog's default behavior.
+     */
+    onUserDialog?: OnUserDialog;
     /**
      * When false, disables session persistence to disk. Sessions will not be
      * saved to ~/.claude/projects/ and cannot be resumed later. Useful for
@@ -2292,6 +2317,12 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * @returns The refreshed session components after plugin reload
      */
     reloadPlugins(): Promise<SDKControlReloadPluginsResponse>;
+    /**
+     * Reload skills from disk and return the refreshed skill list.
+     *
+     * @returns The refreshed skill commands after reload
+     */
+    reloadSkills(): Promise<SDKControlReloadSkillsResponse>;
     /**
      * Get information about the authenticated account.
      *
@@ -2935,6 +2966,7 @@ export declare type SDKControlInitializeResponse = {
     account: coreTypes.AccountInfo;
 
     fast_mode_state?: coreTypes.FastModeState;
+
 };
 
 /**
@@ -3070,6 +3102,20 @@ export declare type SDKControlReloadPluginsResponse = {
     error_count: number;
 };
 
+/**
+ * Reloads skills from disk and returns the refreshed skill list.
+ */
+declare type SDKControlReloadSkillsRequest = {
+    subtype: 'reload_skills';
+};
+
+/**
+ * Refreshed skill commands after reload.
+ */
+export declare type SDKControlReloadSkillsResponse = {
+    skills: coreTypes.SlashCommand[];
+};
+
 /**
  * Sets the user-facing title for the current session.
  */
@@ -3084,7 +3130,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-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 | SDKControlStageFileRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
+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 | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlStageFileRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
 
 /**
  * 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.
@@ -3092,7 +3138,7 @@ declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPer
 declare type SDKControlRequestUserDialogRequest = {
     subtype: 'request_user_dialog';
     /**
-     * Identifier for the dialog the host should render. Open string union — known kinds include "it2_setup", "computer_use_approval", and "refusal_fallback_prompt"; new kinds may be added without bumping the protocol.
+     * Identifier for the dialog the host should render. Open string union — new kinds may be added without bumping the protocol; hosts must answer unrecognized kinds with {behavior: "cancelled"}.
      */
     dialog_kind: string;
     /**
@@ -3506,6 +3552,9 @@ export declare type SDKResultSuccess = {
     duration_ms: number;
     duration_api_ms: number;
     ttft_ms?: number;
+    time_to_request_ms?: number;
+    time_to_request_from_spawn_ms?: number;
+    warm_spare_claimed?: boolean;
     is_error: boolean;
     api_error_status?: number | null;
     num_turns: number;
@@ -5176,9 +5225,10 @@ export declare interface Settings {
      */
     pluginSuggestionMarketplaces?: string[];
     /**
-     * Force a specific login method: "claudeai" for Claude Pro/Max, "console" for Console billing
+     * 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';
+    forceLoginMethod?: 'claudeai' | 'console' | 'gateway';
+
     /**
      * 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).
      */
@@ -5416,6 +5466,14 @@ export declare interface Settings {
      * Minimum version to stay on - prevents downgrades when switching to stable channel
      */
     minimumVersion?: string;
+    /**
+     * Minimum Claude Code version required to start. If the running version is older, Claude Code exits at startup with instructions to update. Only enforced from managed (policy) settings.
+     */
+    requiredMinimumVersion?: string;
+    /**
+     * Maximum Claude Code version allowed to start. If the running version is newer, Claude Code exits at startup with instructions to install an approved version. Only enforced from managed (policy) settings.
+     */
+    requiredMaximumVersion?: string;
     /**
      * Custom directory for plan files, relative to project root. If not set, defaults to ~/.claude/plans/
      */
@@ -5763,6 +5821,14 @@ export declare type StopHookInput = BaseHookInput & {
 
 };
 
+/**
+ * Hook-specific output for the Stop event. additionalContext is non-error feedback delivered to the model; the conversation continues so the model can act on it.
+ */
+export declare type StopHookSpecificOutput = {
+    hookEventName: 'Stop';
+    additionalContext?: string;
+};
+
 export declare type SubagentStartHookInput = BaseHookInput & {
     hook_event_name: 'SubagentStart';
     agent_id: string;
@@ -5796,6 +5862,14 @@ export declare type SubagentStopHookInput = BaseHookInput & {
 
 };
 
+/**
+ * Hook-specific output for the SubagentStop event. additionalContext is non-error feedback delivered to the subagent; the subagent continues so it can act on it.
+ */
+export declare type SubagentStopHookSpecificOutput = {
+    hookEventName: 'SubagentStop';
+    additionalContext?: string;
+};
+
 export declare type SyncHookJSONOutput = {
     continue?: boolean;
     suppressOutput?: boolean;
@@ -5809,7 +5883,7 @@ export declare type SyncHookJSONOutput = {
     reason?: string;
 
 
-    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | UserPromptExpansionHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PostToolBatchHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput | MessageDisplayHookSpecificOutput;
+    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | UserPromptExpansionHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PostToolBatchHookSpecificOutput | StopHookSpecificOutput | SubagentStopHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput | MessageDisplayHookSpecificOutput;
 };
 
 /**
@@ -5951,6 +6025,39 @@ export declare interface Transport {
     [Symbol.dispose]?(): void;
 }
 
+/**
+ * A `request_user_dialog` control request from the CLI, asking the SDK
+ * consumer to render a blocking dialog and return the user's choice.
+ * Each `dialogKind` defines its own payload and result shape; the protocol
+ * transports both opaquely.
+ */
+export declare type UserDialogRequest = {
+    /**
+     * Identifier for the dialog the host should render. Open string union —
+     * new kinds may be added without a protocol bump, so hosts must answer
+     * unrecognized kinds with `{behavior: 'cancelled'}`.
+     */
+    dialogKind: string;
+    /** Dialog-specific data for the host renderer; shape is defined per dialogKind. */
+    payload: Record<string, unknown>;
+    /**
+     * Present when the dialog is tied to a specific tool invocation. Same
+     * value as the `toolUseID` passed to `canUseTool`.
+     */
+    toolUseID?: string;
+};
+
+/**
+ * The host's answer to a {@link UserDialogRequest}. On `cancelled`, the CLI
+ * applies the dialog's default behavior.
+ */
+export declare type UserDialogResult = {
+    behavior: 'completed';
+    result: unknown;
+} | {
+    behavior: 'cancelled';
+};
+
 export declare type UserPromptExpansionHookInput = BaseHookInput & {
     hook_event_name: 'UserPromptExpansion';
     expansion_type: 'slash_command' | 'mcp_prompt';