@anthropic-ai/claude-agent-sdk 0.2.81 → 0.2.84

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.81",
-  "buildDate": "2026-03-20T21:31:30Z",
+  "version": "2.1.84",
+  "buildDate": "2026-03-25T23:54:35Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "d014162177fc18bfeb7f93d942130dd964f7424e4101f6ad569de66e6eddca03",
-      "size": 193286000
+      "checksum": "c02d911ff13f8ceccb1f6662bf211f3cd9f29d5a46f031c3cc40654eb759aa29",
+      "size": 203606768
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "3c63d8173d4a86ab3985aead73c4699e42956d10c2f946179274be76ec657099",
-      "size": 199366256
+      "checksum": "da5ed2ee1b0bcf65c2088e79bc65388ec85edc41041fc6ca7c27330f2e201085",
+      "size": 205199952
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "ccfc3845c8d1a2ded9656a3a517694a844a1b7005b87c784a66f7a60cc58012c",
-      "size": 235183215
+      "checksum": "5c868174b44439e51c74ff084c306856c41779615250d5bbdaa5d10056362814",
+      "size": 235473472
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "047e3f5591d6238b08dd9518729ac335b0e8df1c80fe985e5d7fbda2c18fc281",
-      "size": 237954904
+      "checksum": "c6872aa8db94f303bc6a4482664e40d3288dfc989c89ba268473ed32e3055878",
+      "size": 235657856
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "eab144605b0b0cc7d41325ef4dc9d553cdee853234da8bd7cd8187552b875399",
-      "size": 225718687
+      "checksum": "6e42aee87a00ab8e6fb3db3fc409ab969f12758bacc2a0c9f622d8e97445a0a8",
+      "size": 228592064
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "480a961630459c0790e38d4860a2653fd39ae96aadc38044f669e1c2db686254",
-      "size": 228552392
+      "checksum": "0109e76af6261f6fd37ae1deefc7ee3bc58b0ad786086d198a981275979c549a",
+      "size": 230283712
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "6d34836bf4d62f4bd5221fb69899ed5b2edc380d35fb0f23218c62fae94e28b9",
-      "size": 242411680
+      "checksum": "64b28630ec4f4aaa6cc0e225379cf59cdb95828cbb4ce700a0ae4401b1999ecd",
+      "size": 245196960
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "18352be0d91c690b0fe2ed6841e4908c266c06eb7000555118e91966b67b9ea5",
-      "size": 238605472
+      "checksum": "e7f5d18d470f0345ee18bb368f8ea7d43e791e17f0de7b69cdc40e42a9a9398e",
+      "size": 241350304
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.81",
-  "buildDate": "2026-03-20T21:31:31Z",
+  "version": "2.1.84",
+  "buildDate": "2026-03-25T23:54:36Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "daaa46988395c254a933f76c6d1e120caf647fb93d746372b9ce421d87d7d3b2",
-      "size": 41085748,
+      "checksum": "a0e577c1ca84302c5de1e6498d047149ba44a710ea51ff303986fd47f1c0eb83",
+      "size": 43366416,
       "bundle": {
-        "checksum": "7172c446022862e58d0c46e33ad0f27ca130fbeabff9e36153779fc3f66af4b2",
-        "size": 41085968
+        "checksum": "4111e9be5214eb3e2e97d7fc133dbb13b51fc8978fff23d26578021fa84b7c30",
+        "size": 43377661
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "929247cb00b2de41c74c74f221a615f07b53e92fe1bc10569909d7e867395d67",
-      "size": 43512291,
+      "checksum": "d852a6245edfb235dd73bdffef79012ab18ee075ef3ded5abf602b17812bc82a",
+      "size": 45050362,
       "bundle": {
-        "checksum": "8588a7c0a75d21c900d2709b59665809d21f2fc901578bcc35ed8b1171d72037",
-        "size": 43515586
+        "checksum": "10bcd37cb20f82861ed710292821927d7f8e1549ca1dbc9e248769409c62f22b",
+        "size": 45050626
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "ca80b6bceb380a971334dedfc5c032b14779e4e69775a21b3ced33f970d67a77",
-      "size": 52977626
+      "checksum": "fb0a0db9e8ceb414563fe776b9035b0827548d8e94bfab23f5c58a63d9c5f7b4",
+      "size": 53002601
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "fe51a059c7840c571b201e6943c0aa1f502ff738bbedc86fbb5e63f938dacbcc",
-      "size": 53708186
+      "checksum": "8476f46fb0422be1fc2cafe82c1b4b51226c07b5b73b40dd40b203cc5c8ad90a",
+      "size": 53582657
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "7b7cf79deaa20720941400899863ebf0a691d5db10e3359c2fce03765ef31a20",
-      "size": 50903082
+      "checksum": "7523be8411a2fef9bb4d93c59707d5497f5bf8229fb528fbc9ba5fc146480dee",
+      "size": 51604167
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "5566d29e1a31c515fb4f0879223647bd6f3f2bbe73dad1e34d3665add5c8a8b2",
-      "size": 51699949
+      "checksum": "e670e1468f01946a822d1526276f2f9de566987d89bbd52186a505f88763714f",
+      "size": 52327014
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "3d986f1ae2be61fa6e1be7ff1105ffb36bdb71f2a2927acc24f3312a9fc038c9",
-      "size": 54472548
+      "checksum": "e83814324697073fe6462eafcca9c354af1dc22e9689e5f3c0788dd1021ef414",
+      "size": 55192345
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "2816c6f4eb351bb596f513f13c76bdbf2f32545df1d813f28633ceb3354d956e",
-      "size": 52521404
+      "checksum": "dc7c0d74e5ae0704c4745d350f0afc5c2044b4b3fe553fb808252b9f2957af87",
+      "size": 53246192
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.81",
+  "version": "0.2.84",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -62,5 +62,5 @@
     "@img/sharp-win32-arm64": "^0.34.2",
     "@img/sharp-win32-x64": "^0.34.2"
   },
-  "claudeCodeVersion": "2.1.81"
+  "claudeCodeVersion": "2.1.84"
 }

package/sdk-tools.d.ts

@@ -63,6 +63,7 @@ export type ToolOutputSchemas =
 export type AgentOutput =
   | {
       agentId: string;
+      agentType?: string;
       content: {
         type: "text";
         text: string;
@@ -315,7 +316,7 @@ export interface BashInput {
    */
   description?: string;
   /**
-   * Set to true to run this command in the background. Use TaskOutput to read the output later.
+   * Set to true to run this command in the background. Use Read to read the output later.
    */
   run_in_background?: boolean;
   /**
@@ -455,7 +456,7 @@ export interface GrepInput {
    */
   type?: string;
   /**
-   * Limit output to first N lines/entries, equivalent to "| head -N". Works across all output modes: content (limits output lines), files_with_matches (limits file paths), count (limits count entries). Defaults to 0 (unlimited).
+   * Limit output to first N lines/entries, equivalent to "| head -N". Works across all output modes: content (limits output lines), files_with_matches (limits file paths), count (limits count entries). Defaults to 250 when unspecified. Pass 0 for unlimited (use sparingly — large result sets waste context).
    */
   head_limit?: number;
   /**
@@ -2215,7 +2216,7 @@ export interface ConfigInput {
 }
 export interface EnterWorktreeInput {
   /**
-   * Optional name for the worktree (letters, digits, dots, underscores, dashes only; max 64 chars). A random name is generated if not provided.
+   * Optional name for the worktree. Each "/"-separated segment may contain only letters, digits, dots, underscores, and dashes; max 64 chars total. A random name is generated if not provided.
    */
   name?: string;
 }
@@ -2286,10 +2287,6 @@ export interface BashOutput {
    * Total size of the output in bytes (set when output is too large for inline)
    */
   persistedOutputSize?: number;
-  /**
-   * Compressed output sent to model when token-saver is active (UI still uses stdout)
-   */
-  tokenSaverOutput?: string;
 }
 export interface ExitPlanModeOutput {
   /**
@@ -2305,6 +2302,10 @@ export interface ExitPlanModeOutput {
    * Whether the Agent tool is available in the current context
    */
   hasTaskTool?: boolean;
+  /**
+   * True when the user edited the plan (CCR web UI or Ctrl+G); determines whether the plan is echoed back in tool_result
+   */
+  planWasEdited?: boolean;
   /**
    * When true, the teammate has sent a plan approval request to the team leader
    */

package/sdk.d.ts

@@ -65,6 +65,10 @@ export declare type AgentDefinition = {
      * Array of skill names to preload into the agent context
      */
     skills?: string[];
+    /**
+     * Auto-submitted as the first user turn when this agent is the main thread agent. Slash commands are processed. Prepended to any user-provided prompt.
+     */
+    initialPrompt?: string;
     /**
      * Maximum number of agentic turns (API round-trips) before stopping
      */
@@ -210,12 +214,16 @@ declare namespace coreTypes {
         BaseOutputFormat,
         ConfigChangeHookInput,
         ConfigScope,
+        CwdChangedHookInput,
+        CwdChangedHookSpecificOutput,
         ElicitationHookInput,
         ElicitationHookSpecificOutput,
         ElicitationResultHookInput,
         ElicitationResultHookSpecificOutput,
         ExitReason,
         FastModeState,
+        FileChangedHookInput,
+        FileChangedHookSpecificOutput,
         HookEvent,
         HookInput,
         HookJSONOutput,
@@ -237,6 +245,7 @@ declare namespace coreTypes {
         OutputFormat,
         OutputFormatType,
         PermissionBehavior,
+        PermissionDecisionClassification,
         PermissionMode,
         PermissionRequestHookInput,
         PermissionRequestHookSpecificOutput,
@@ -277,6 +286,7 @@ declare namespace coreTypes {
         SDKResultMessage,
         SDKResultSuccess,
         SDKSessionInfo,
+        SDKSessionStateChangedMessage,
         SDKStatusMessage,
         SDKStatus,
         SDKSystemMessage,
@@ -303,6 +313,7 @@ declare namespace coreTypes {
         SubagentStopHookInput,
         SyncHookJSONOutput,
         TaskCompletedHookInput,
+        TaskCreatedHookInput,
         TeammateIdleHookInput,
         ThinkingAdaptive,
         ThinkingConfig,
@@ -311,6 +322,7 @@ declare namespace coreTypes {
         UserPromptSubmitHookInput,
         UserPromptSubmitHookSpecificOutput,
         WorktreeCreateHookInput,
+        WorktreeCreateHookSpecificOutput,
         WorktreeRemoveHookInput
     }
 }
@@ -329,6 +341,27 @@ declare type CreateSdkMcpServerOptions = {
     tools?: Array<SdkMcpToolDefinition<any>>;
 };
 
+export declare type CwdChangedHookInput = BaseHookInput & {
+    hook_event_name: 'CwdChanged';
+    old_cwd: string;
+    new_cwd: string;
+};
+
+export declare type CwdChangedHookSpecificOutput = {
+    hookEventName: 'CwdChanged';
+    watchPaths?: string[];
+};
+
+/**
+ * Effort level for controlling how much thinking/reasoning Claude applies.
+ *
+ * - `'low'` — Minimal thinking, fastest responses
+ * - `'medium'` — Moderate thinking
+ * - `'high'` — Deep reasoning (default)
+ * - `'max'` — Maximum effort (select models only)
+ */
+export declare type EffortLevel = 'low' | 'medium' | 'high' | 'max';
+
 /**
  * Hook input for the Elicitation event. Fired when an MCP server requests user input. Hooks can auto-respond (accept/decline) instead of showing the dialog.
  */
@@ -405,6 +438,17 @@ export declare type ExitReason = 'clear' | 'resume' | 'logout' | 'prompt_input_e
  */
 export declare type FastModeState = 'off' | 'cooldown' | 'on';
 
+export declare type FileChangedHookInput = BaseHookInput & {
+    hook_event_name: 'FileChanged';
+    file_path: string;
+    event: 'change' | 'add' | 'unlink';
+};
+
+export declare type FileChangedHookSpecificOutput = {
+    hookEventName: 'FileChanged';
+    watchPaths?: string[];
+};
+
 /**
  * Fork a session into a new branch with fresh UUIDs.
  *
@@ -485,7 +529,7 @@ export declare type GetSessionMessagesOptions = {
     offset?: number;
 };
 
-export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded"];
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged"];
 
 /**
  * Hook callback function for responding to events during execution.
@@ -504,9 +548,9 @@ export declare interface HookCallbackMatcher {
     timeout?: number;
 }
 
-export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'StopFailure' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PostCompact' | 'PermissionRequest' | 'Setup' | 'TeammateIdle' | 'TaskCompleted' | 'Elicitation' | 'ElicitationResult' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'InstructionsLoaded';
+export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'StopFailure' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PostCompact' | 'PermissionRequest' | 'Setup' | 'TeammateIdle' | 'TaskCreated' | 'TaskCompleted' | 'Elicitation' | 'ElicitationResult' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'InstructionsLoaded' | 'CwdChanged' | 'FileChanged';
 
-export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | StopFailureHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PostCompactHookInput | PermissionRequestHookInput | SetupHookInput | TeammateIdleHookInput | TaskCompletedHookInput | ElicitationHookInput | ElicitationResultHookInput | ConfigChangeHookInput | InstructionsLoadedHookInput | WorktreeCreateHookInput | WorktreeRemoveHookInput;
+export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | StopFailureHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PostCompactHookInput | PermissionRequestHookInput | SetupHookInput | TeammateIdleHookInput | TaskCreatedHookInput | TaskCompletedHookInput | ElicitationHookInput | ElicitationResultHookInput | ConfigChangeHookInput | InstructionsLoadedHookInput | WorktreeCreateHookInput | WorktreeRemoveHookInput | CwdChangedHookInput | FileChangedHookInput;
 
 export declare type HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput;
 
@@ -651,6 +695,7 @@ export declare type McpServerStatus = {
             openWorld?: boolean;
         };
     }[];
+
 };
 
 export declare type McpServerStatusConfig = McpServerConfigForProcessTransport | McpClaudeAIProxyServerConfig;
@@ -983,7 +1028,7 @@ export declare type Options = {
      *
      * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
      */
-    effort?: 'low' | 'medium' | 'high' | 'max';
+    effort?: EffortLevel;
     /**
      * Maximum number of tokens the model can use for its thinking/reasoning process.
      * Helps control cost and latency for complex tasks.
@@ -1003,6 +1048,16 @@ export declare type Options = {
      * budget is exceeded, returning an `error_max_budget_usd` result.
      */
     maxBudgetUsd?: number;
+    /**
+     * API-side task budget in tokens. When set, the model is made aware of
+     * its remaining token budget so it can pace tool use and wrap up before
+     * the limit. Sent as `output_config.task_budget` with the
+     * `task-budgets-2026-03-13` beta header.
+     * @alpha
+     */
+    taskBudget?: {
+        total: number;
+    };
     /**
      * MCP (Model Context Protocol) server configurations.
      * Keys are server names, values are server configurations.
@@ -1077,6 +1132,7 @@ export declare type Options = {
 
 
 
+
     /**
      * Enable prompt suggestions. When true, the agent emits a `prompt_suggestion`
      * message after each turn with a predicted next user prompt.
@@ -1252,6 +1308,11 @@ export declare type OutputFormatType = 'json_schema';
 
 export declare type PermissionBehavior = 'allow' | 'deny' | 'ask';
 
+/**
+ * Classification of this permission decision for telemetry. SDK hosts that prompt users (desktop apps, IDEs) should set this to reflect what actually happened: user_temporary for allow-once, user_permanent for always-allow (both the click and later cache hits), user_reject for deny. If unset, the CLI infers conservatively (temporary for allow, reject for deny). The vocabulary matches tool_decision OTel events (monitoring-usage docs).
+ */
+export declare type PermissionDecisionClassification = 'user_temporary' | 'user_permanent' | 'user_reject';
+
 /**
  * Permission mode for controlling how tool executions are handled. 'default' - Standard behavior, prompts for dangerous operations. 'acceptEdits' - Auto-accept file edit operations. 'bypassPermissions' - Bypass all permission checks (requires allowDangerouslySkipPermissions). 'plan' - Planning mode, no actual tool execution. 'dontAsk' - Don't prompt for permissions, deny if not pre-approved.
  */
@@ -1282,11 +1343,13 @@ export declare type PermissionResult = {
     updatedInput?: Record<string, unknown>;
     updatedPermissions?: PermissionUpdate[];
     toolUseID?: string;
+    decisionClassification?: PermissionDecisionClassification;
 } | {
     behavior: 'deny';
     message: string;
     interrupt?: boolean;
     toolUseID?: string;
+    decisionClassification?: PermissionDecisionClassification;
 };
 
 export declare type PermissionRuleValue = {
@@ -1377,7 +1440,7 @@ export declare type PreToolUseHookInput = BaseHookInput & {
 
 export declare type PreToolUseHookSpecificOutput = {
     hookEventName: 'PreToolUse';
-    permissionDecision?: 'allow' | 'deny' | 'ask';
+    permissionDecision?: PermissionBehavior;
     permissionDecisionReason?: string;
     updatedInput?: Record<string, unknown>;
     additionalContext?: string;
@@ -1531,6 +1594,17 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
     rewindFiles(userMessageId: string, options?: {
         dryRun?: boolean;
     }): Promise<RewindFilesResult>;
+    /**
+     * Seed the CLI's readFileState cache with a path+mtime entry. Use when
+     * the client observed a Read that has since been removed from context
+     * (e.g. by snip), so a subsequent Edit won't fail "file not read yet".
+     * If the file changed on disk since the given mtime, the seed is skipped
+     * and Edit will correctly require a fresh Read.
+     *
+     * @param path - Path to the file that was previously Read
+     * @param mtime - File mtime (floored ms) at the time of the observed Read
+     */
+    seedReadState(path: string, mtime: number): Promise<void>;
 
 
 
@@ -1655,6 +1729,7 @@ export declare type SandboxSettings = z.infer<ReturnType<typeof SandboxSettingsS
  */
 declare const SandboxSettingsSchema: () => z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
+    failIfUnavailable: z.ZodOptional<z.ZodBoolean>;
     autoAllowBashIfSandboxed: z.ZodOptional<z.ZodBoolean>;
     allowUnsandboxedCommands: z.ZodOptional<z.ZodBoolean>;
     network: z.ZodOptional<z.ZodObject<{
@@ -1886,7 +1961,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlSetProactiveRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlSetProactiveRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest;
 
 export declare type SDKControlResponse = {
     type: 'control_response';
@@ -1902,6 +1977,15 @@ declare type SDKControlRewindFilesRequest = {
     dry_run?: boolean;
 };
 
+/**
+ * Seeds the readFileState cache with a path+mtime entry. Use when a prior Read was removed from context (e.g. by snip) so Edit validation would fail despite the client having observed the Read. The mtime lets the CLI detect if the file changed since the seeded Read — same staleness check as the normal path.
+ */
+declare type SDKControlSeedReadStateRequest = {
+    subtype: 'seed_read_state';
+    path: string;
+    mtime: number;
+};
+
 /**
  * Sets the maximum number of thinking tokens for extended thinking.
  */
@@ -1927,6 +2011,7 @@ declare type SDKControlSetPermissionModeRequest = {
      * Permission mode for controlling how tool executions are handled. 'default' - Standard behavior, prompts for dangerous operations. 'acceptEdits' - Auto-accept file edit operations. 'bypassPermissions' - Bypass all permission checks (requires allowDangerouslySkipPermissions). 'plan' - Planning mode, no actual tool execution. 'dontAsk' - Don't prompt for permissions, deny if not pre-approved.
      */
     mode: coreTypes.PermissionMode;
+
 };
 
 /**
@@ -2050,10 +2135,11 @@ export declare type SdkMcpToolDefinition<Schema extends AnyZodRawShape = AnyZodR
     description: string;
     inputSchema: Schema;
     annotations?: ToolAnnotations;
+    _meta?: Record<string, unknown>;
     handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>;
 };
 
-export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage;
+export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKSessionStateChangedMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage;
 
 export declare type SDKPartialAssistantMessage = {
     type: 'stream_event';
@@ -2282,6 +2368,17 @@ export declare type SDKSessionOptions = {
     permissionMode?: PermissionMode;
 };
 
+/**
+ * Mirrors notifySessionStateChanged. 'idle' fires after heldBackResult flushes and the bg-agent do-while exits — authoritative turn-over signal.
+ */
+export declare type SDKSessionStateChangedMessage = {
+    type: 'system';
+    subtype: 'session_state_changed';
+    state: 'idle' | 'running' | 'requires_action';
+    uuid: UUID;
+    session_id: string;
+};
+
 export declare type SDKStatus = 'compacting' | null;
 
 export declare type SDKStatusMessage = {
@@ -2317,6 +2414,7 @@ export declare type SDKSystemMessage = {
     plugins: {
         name: string;
         path: string;
+
     }[];
     fast_mode_state?: FastModeState;
     uuid: UUID;
@@ -2365,6 +2463,10 @@ export declare type SDKTaskStartedMessage = {
     tool_use_id?: string;
     description: string;
     task_type?: string;
+    /**
+     * meta.name from the workflow script (e.g. 'spec'). Only set when task_type is 'local_workflow'.
+     */
+    workflow_name?: string;
     prompt?: string;
     uuid: UUID;
     session_id: string;
@@ -2460,6 +2562,7 @@ export declare type SessionStartHookSpecificOutput = {
     hookEventName: 'SessionStart';
     additionalContext?: string;
     initialUserMessage?: string;
+    watchPaths?: string[];
 };
 
 /**
@@ -3434,6 +3537,10 @@ export declare interface Settings {
     skipWebFetchPreflight?: boolean;
     sandbox?: {
         enabled?: boolean;
+        /**
+         * 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.
+         */
+        failIfUnavailable?: boolean;
         autoAllowBashIfSandboxed?: boolean;
         /**
          * Allow commands to run outside the sandbox via the dangerouslyDisableSandbox parameter. When false, the dangerouslyDisableSandbox parameter is completely ignored and all commands must run sandboxed. Default: true.
@@ -3535,6 +3642,10 @@ export declare interface Settings {
      * Persisted effort level for supported models.
      */
     effortLevel?: 'low' | 'medium' | 'high';
+    /**
+     * Advisor model for the server-side advisor tool.
+     */
+    advisorModel?: string;
     /**
      * When true, fast mode is enabled. When absent or false, fast mode is off.
      */
@@ -3601,6 +3712,17 @@ export declare interface Settings {
      * Custom directory for plan files, relative to project root. If not set, defaults to ~/.claude/plans/
      */
     plansDirectory?: string;
+    /**
+     * 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.
+     */
+    channelsEnabled?: boolean;
+    /**
+     * Teams/Enterprise allowlist of channel plugins. When set, replaces the default Anthropic allowlist — admins decide which plugins may push inbound messages. Undefined falls back to the default. Requires channelsEnabled: true.
+     */
+    allowedChannelPlugins?: {
+        marketplace: string;
+        plugin: string;
+    }[];
     /**
      * Reduce or disable animations for accessibility (spinner shimmer, flash effects, etc.)
      */
@@ -3812,7 +3934,7 @@ export declare type SyncHookJSONOutput = {
     systemMessage?: string;
     reason?: string;
 
-    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput;
+    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
 };
 
 /**
@@ -3832,6 +3954,15 @@ export declare type TaskCompletedHookInput = BaseHookInput & {
     team_name?: string;
 };
 
+export declare type TaskCreatedHookInput = BaseHookInput & {
+    hook_event_name: 'TaskCreated';
+    task_id: string;
+    task_subject: string;
+    task_description?: string;
+    teammate_name?: string;
+    team_name?: string;
+};
+
 export declare type TeammateIdleHookInput = BaseHookInput & {
     hook_event_name: 'TeammateIdle';
     teammate_name: string;
@@ -3867,6 +3998,7 @@ export declare type ThinkingEnabled = {
 
 export declare function tool<Schema extends AnyZodRawShape>(_name: string, _description: string, _inputSchema: Schema, _handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>, _extras?: {
     annotations?: ToolAnnotations;
+    searchHint?: string;
 }): SdkMcpToolDefinition<Schema>;
 
 /**
@@ -3962,6 +4094,14 @@ export declare type WorktreeCreateHookInput = BaseHookInput & {
     name: string;
 };
 
+/**
+ * Hook-specific output for the WorktreeCreate event. Provides the absolute path to the created worktree directory. Command hooks print the path on stdout instead.
+ */
+export declare type WorktreeCreateHookSpecificOutput = {
+    hookEventName: 'WorktreeCreate';
+    worktreePath: string;
+};
+
 export declare type WorktreeRemoveHookInput = BaseHookInput & {
     hook_event_name: 'WorktreeRemove';
     worktree_path: string;