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

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.116",
-  "commit": "9e176d0772418b8b88475d39fb86c651a12f4aad",
-  "buildDate": "2026-04-20T18:41:27Z",
+  "version": "2.1.118",
+  "commit": "ef88b5f0a79aac989f53fd18178939a54a48624a",
+  "buildDate": "2026-04-22T22:43:30Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "4ecfb5b5c30585d0a3d5b5ef802a39804ddc33a63012ee0d4aee4d4e3db46eb4",
-      "size": 205789664
+      "checksum": "54e5d3f65109b89c6046f47440944d52906c662d1e51748f620a430d26ad3665",
+      "size": 207690848
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "4586d0c17772a826d0d57e4664b66ffba21a01d11a8611a5566b587bf24c340a",
-      "size": 207258960
+      "checksum": "2cd554070f0588de05e9efd88c1f073770cb620ed3e5f45ba7df833fc3414c1b",
+      "size": 209238608
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "dc3854c271a5323da9047f90c5b1a5bdf78ac03474eb45c9c26b84ecf9f2134c",
-      "size": 237898304
+      "checksum": "b77b22fe93c15409f3c64be67950fe11e5fc17d1cd327891596cb87dd9be0492",
+      "size": 239798848
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "0d1aea5ce056a5ce491da7e9bbe63f992585e5c24852f023a07c8f18cf292cc5",
-      "size": 237652608
+      "checksum": "ba363b2410a47120d2d4b8ece2e11fe0bbc5d59adb1329e8fb87ea0f370f4e46",
+      "size": 239573632
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "e7ed54a9dc6aa4ce2b69e8c4eb90838bcf814a9ee50ac29f93f0f80e890a5009",
-      "size": 230623680
+      "checksum": "dcb27938ed10b7da586b6f7ba0dde768980b5e3d38b258c1f4e9a94e7b3dd6d2",
+      "size": 232524224
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "26919d621bee09fda753564ca5ccb594edc1e753a9092e61dec71562a4b7f65c",
-      "size": 231918016
+      "checksum": "bd05142de3e3ead48313d4215577c9a9c89f05ca286d771cdff025544c52ae29",
+      "size": 233839040
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "41c82dc1988225938a7d588b157aef3cd3c2fd62ff0661731132404d5bf17258",
-      "size": 247174304
+      "checksum": "5a05b03b880de26bb78fb9824bacf08e99dcf05c02e3c66546cccaf2f2930b2e",
+      "size": 249035936
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "1e24e1f042fc45c408663d12c0c9d62cb5dd8955f9efd67f87d7e5305d105535",
-      "size": 243905696
+      "checksum": "b3d8942b49f672ef2e1394e004f0f53e197caefe30890620b6974a3e8dba63ec",
+      "size": 245760672
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.116",
-  "commit": "9e176d0772418b8b88475d39fb86c651a12f4aad",
-  "buildDate": "2026-04-20T18:48:30Z",
+  "version": "2.1.118",
+  "commit": "ef88b5f0a79aac989f53fd18178939a54a48624a",
+  "buildDate": "2026-04-22T22:50:17Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "affc54b1d14b599892cd6fea77a1d8e5de1fbcf8ca99badf4b91201341f68d28",
-      "size": 42488115,
+      "checksum": "0895347a08fe909e1761d0b73e18cdc8b4c0ad63d159bf422c8e3d49234a3b97",
+      "size": 43098168,
       "bundle": {
-        "checksum": "b90230f9d8f6f5af4974aa87e61923af411548675c6eeb001818b14e9083f430",
-        "size": 42492497
+        "checksum": "10c7965cd61422b4f81cf2a9b08f023a38e4b24240e0373313ddf2596882db69",
+        "size": 43107336
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "95893b7e704357d8a4e0ccc1f929393c7fcfa0b9e9987783bff8977a25fde206",
-      "size": 44191836,
+      "checksum": "b0537677a5aaa0d3e85f44ee6f14e984c6cdf0cf8fe9e2f883067586d591337e",
+      "size": 44811420,
       "bundle": {
-        "checksum": "8cb0acc4b9d369a5d624401e69bad1b16fa5cd7c1ba73c27085683b23a92b28f",
-        "size": 44186846
+        "checksum": "6ac33e23fea2e737a7664ae4e73569e8f21fb08e6f01e4d079eede44116011fb",
+        "size": 44810879
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "0e108736fe720030900f1012407d2e53fe4e989681af0bf9061a1046a505d0c0",
-      "size": 52145149
+      "checksum": "7eb45089b179a0688de458ccbb0df8c33eacc2183808a8a54d50cee8ea928597",
+      "size": 52732492
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "8abd364384020742be0ad54e30241c4eebbd1d0a161e3e894ce94394fab1c38c",
-      "size": 52687378
+      "checksum": "063d156f8028c20ab84d7ff9188f6ca187920fa8dcca48d1b4d2dd2b831d11cb",
+      "size": 53288756
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "c40236d9e4d57dab287b6b4c1398aa521e240aa24c979e09326c72401817a1e9",
-      "size": 50748398
+      "checksum": "3b46a777475682fbfbdfd6ac70e71e627fd9ceb6cd53d71b0ec05e1d8a4be8e3",
+      "size": 51352015
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "72f4b3ceb8286c822628eac3be2f830a860bf5de1094a35c0c13280321cbdd2f",
-      "size": 51379287
+      "checksum": "8c45470b73bf2016db60bc0200bc78021adccbd05b0ad266547ac41aad74cd1f",
+      "size": 51983350
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "a1a38656f78bb89f66edc11524e571306807b4cccc4554d582a06f8ea9e3e068",
-      "size": 54386127
+      "checksum": "5ef7753a8aa0ca80f951acc832bde5da46731751fb4f7b9193fb24099823f26a",
+      "size": 54917824
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "32f3841681855d6cc00ee81880ff195cc054da7f1c8e63d33ef910c999f6e6d8",
-      "size": 52520071
+      "checksum": "af53cf487f65fc168964deb3ed26105965ad78433b438d51e7bbf7b8054c636b",
+      "size": 53057220
     }
   }
 }

package/package.json

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

package/sdk-tools.d.ts

@@ -27,7 +27,6 @@ export type ToolInputSchemas =
   | WebFetchInput
   | WebSearchInput
   | AskUserQuestionInput
-  | ConfigInput
   | EnterWorktreeInput
   | ExitWorktreeInput
   | ToolOutputSchemas;
@@ -49,7 +48,6 @@ export type ToolOutputSchemas =
   | WebFetchOutput
   | WebSearchOutput
   | AskUserQuestionOutput
-  | ConfigOutput
   | EnterWorktreeOutput
   | ExitWorktreeOutput;
 export type AgentOutput =
@@ -2140,16 +2138,6 @@ export interface AskUserQuestionInput {
     source?: string;
   };
 }
-export interface ConfigInput {
-  /**
-   * The setting key (e.g., "theme", "model", "permissions.defaultMode")
-   */
-  setting: string;
-  /**
-   * The new value. Omit to get current value.
-   */
-  value?: string | boolean | number;
-}
 export interface EnterWorktreeInput {
   /**
    * Optional name for a new 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. Mutually exclusive with `path`.
@@ -2718,15 +2706,6 @@ export interface AskUserQuestionOutput {
     };
   };
 }
-export interface ConfigOutput {
-  success: boolean;
-  operation?: "get" | "set";
-  setting?: string;
-  value?: unknown;
-  previousValue?: unknown;
-  newValue?: unknown;
-  error?: string;
-}
 export interface EnterWorktreeOutput {
   worktreePath: string;
   worktreeBranch?: string;

package/sdk.d.ts

@@ -325,6 +325,9 @@ declare namespace coreTypes {
         PermissionUpdateDestination,
         PermissionUpdate,
         PostCompactHookInput,
+        PostToolBatchHookInput,
+        PostToolBatchHookSpecificOutput,
+        PostToolBatchToolCall,
         PostToolUseFailureHookInput,
         PostToolUseFailureHookSpecificOutput,
         PostToolUseHookInput,
@@ -554,6 +557,29 @@ export declare type FileChangedHookSpecificOutput = {
     watchPaths?: string[];
 };
 
+/**
+ * Fold a batch of appended entries into the running summary for `key`.
+ *
+ * Stores call this from inside `append()` to keep a {@link SessionSummaryEntry}
+ * sidecar up to date without re-reading the transcript. `prev` is the previous
+ * summary for the same key (or `undefined` for the first append). The returned
+ * `data` blob is opaque to the store — persist it verbatim.
+ *
+ * Set-once fields (`isSidechain`, `createdAt`, `cwd`, `firstPrompt`) freeze on
+ * first sight; last-wins fields (`customTitle`, `aiTitle`, `lastPrompt`,
+ * `summaryHint`, `gitBranch`, `tag`) overwrite on every appearance.
+ *
+ * `mtime` is NOT derived from entry timestamps — the adapter MUST stamp it at
+ * persist time using the same clock it uses for `listSessions().mtime`. Pass
+ * it via `options.mtime`; when omitted, the previous summary's `mtime` is
+ * preserved (use this only when re-folding the same sidecar without a new
+ * persist). See {@link SessionSummaryEntry.mtime} for the contract.
+ * @alpha
+ */
+export declare function foldSessionSummary(prev: SessionSummaryEntry | undefined, key: SessionKey, entries: SessionStoreEntry[], options?: {
+    mtime?: number;
+}): SessionSummaryEntry;
+
 /**
  * Fork a session into a new branch with fresh UUIDs.
  *
@@ -684,7 +710,7 @@ export declare type GetSubagentMessagesOptions = {
     sessionStore?: SessionStore;
 };
 
-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"];
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "PostToolBatch", "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"];
 
 /**
  * Hook callback function for responding to events during execution.
@@ -703,9 +729,9 @@ export declare interface HookCallbackMatcher {
     timeout?: number;
 }
 
-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';
+export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'PostToolBatch' | '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';
 
-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;
+export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | PostToolBatchHookInput | 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;
 
 export declare type HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput;
 
@@ -774,6 +800,8 @@ export declare type InferShape<T extends AnyZodRawShape> = {
 export declare class InMemorySessionStore implements SessionStore {
     private store;
     private mtimes;
+    private summaries;
+    private lastMtime;
     private keyToString;
     append(key: SessionKey, entries: SessionStoreEntry[]): Promise<void>;
     load(key: SessionKey): Promise<SessionStoreEntry[] | null>;
@@ -781,6 +809,7 @@ export declare class InMemorySessionStore implements SessionStore {
         sessionId: string;
         mtime: number;
     }>>;
+    listSessionSummaries(projectKey: string): Promise<SessionSummaryEntry[]>;
     delete(key: SessionKey): Promise<void>;
     listSubkeys(key: {
         projectKey: string;
@@ -1415,6 +1444,13 @@ export declare type Options = {
      * - `'dontAsk'` - Don't prompt for permissions, deny if not pre-approved
      */
     permissionMode?: PermissionMode;
+    /**
+     * Custom workflow instructions for plan mode. When `permissionMode` is
+     * `'plan'`, this string replaces the default code-implementation workflow
+     * body in the plan-mode system reminder. The CLI still wraps it with the
+     * read-only enforcement preamble and the ExitPlanMode protocol footer.
+     */
+    planModeInstructions?: string;
     /**
      * Must be set to `true` when using `permissionMode: 'bypassPermissions'`.
      * This is a safety measure to ensure intentional bypassing of permissions.
@@ -1542,6 +1578,28 @@ export declare type Options = {
      * ```
      */
     settings?: string | Settings;
+    /**
+     * Policy-tier settings supplied by the spawning parent process. Merged into
+     * the managed-settings layer below IT-controlled sources (server / MDM /
+     * managed-settings.json) but above HKCU. Honors policy-only keys such as
+     * `sandbox.network.allowManagedDomainsOnly`.
+     *
+     * Intended for embedding applications (e.g. desktop apps) that derive
+     * lockdown settings from their own enterprise configuration and need to
+     * enforce them on the spawned subprocess without writing root-owned files.
+     *
+     * Unlike `settings`, this option is loaded into the managed (policy) layer
+     * rather than the user-controlled flag layer, so user/project settings
+     * cannot widen restrictions set here.
+     *
+     * @example
+     * ```typescript
+     * managedSettings: {
+     *   sandbox: { network: { allowManagedDomainsOnly: true } }
+     * }
+     * ```
+     */
+    managedSettings?: Settings;
     /**
      * Control which filesystem settings to load.
      * - `'user'` - Global user settings (`~/.claude/settings.json`)
@@ -1775,6 +1833,26 @@ export declare type PostCompactHookInput = BaseHookInput & {
     compact_summary: string;
 };
 
+/**
+ * Hook input for the PostToolBatch event. Fired once after every tool call in a batch has resolved, before the next model request. PostToolUse fires per-tool and may run concurrently for parallel tool calls; PostToolBatch fires exactly once with the full batch.
+ */
+export declare type PostToolBatchHookInput = BaseHookInput & {
+    hook_event_name: 'PostToolBatch';
+    tool_calls: PostToolBatchToolCall[];
+};
+
+export declare type PostToolBatchHookSpecificOutput = {
+    hookEventName: 'PostToolBatch';
+    additionalContext?: string;
+};
+
+export declare type PostToolBatchToolCall = {
+    tool_name: string;
+    tool_input: unknown;
+    tool_use_id: string;
+    tool_response?: unknown;
+};
+
 export declare type PostToolUseFailureHookInput = BaseHookInput & {
     hook_event_name: 'PostToolUseFailure';
     tool_name: string;
@@ -2385,6 +2463,13 @@ export declare type SDKControlGetContextUsageResponse = {
     } | null;
 };
 
+/**
+ * Requests the formatted session cost summary (the same text /usage prints in non-interactive mode). Used by the thin-client /usage dialog to show the remote container cost instead of the local $0.00.
+ */
+declare type SDKControlGetSessionCostRequest = {
+    subtype: 'get_session_cost';
+};
+
 /**
  * Returns the effective merged settings and the raw per-source settings.
  */
@@ -2402,6 +2487,10 @@ declare type SDKControlInitializeRequest = {
     jsonSchema?: Record<string, unknown>;
     systemPrompt?: string[];
     appendSystemPrompt?: string;
+    /**
+     * Custom workflow body for the plan-mode system reminder. Replaces the default code-implementation phases; the CLI still wraps it with the read-only enforcement preamble and the ExitPlanMode protocol footer.
+     */
+    planModeInstructions?: string;
 
     /**
      * When true, omit per-user dynamic sections (working directory, auto-memory path) from the cached system prompt and re-inject them as the first user message. Lets cross-user prompt caching hit on a static system prompt prefix. Tradeoff: the model sees this context slightly later in the prompt, so steering on the working directory and memory location is marginally less authoritative. Has no effect when a custom (non-preset) system prompt is in use.
@@ -2576,7 +2665,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-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;
+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;
 
 /**
  * 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.
@@ -2617,6 +2706,14 @@ declare type SDKControlSeedReadStateRequest = {
     mtime: number;
 };
 
+/**
+ * Sets the session accent color. Accepts an agent color name or "default" to reset.
+ */
+declare type SDKControlSetColorRequest = {
+    subtype: 'set_color';
+    color: string;
+};
+
 /**
  * Sets the maximum number of thinking tokens for extended thinking.
  */
@@ -2752,7 +2849,7 @@ declare type SDKKeepAliveMessage = {
 };
 
 /**
- * Output from a local slash command (e.g. /voice, /cost). Displayed as assistant-style text in the transcript.
+ * Output from a local slash command (e.g. /voice, /usage). Displayed as assistant-style text in the transcript.
  */
 export declare type SDKLocalCommandOutputMessage = {
     type: 'system';
@@ -3111,6 +3208,13 @@ export declare type SDKSessionOptions = {
      * - `'dontAsk'` - Don't prompt for permissions, deny if not pre-approved
      */
     permissionMode?: PermissionMode;
+    /**
+     * Custom workflow instructions for plan mode. When `permissionMode` is
+     * `'plan'`, this string replaces the default code-implementation workflow
+     * body in the plan-mode system reminder. The CLI still wraps it with the
+     * read-only enforcement preamble and the ExitPlanMode protocol footer.
+     */
+    planModeInstructions?: string;
 };
 
 /**
@@ -3290,6 +3394,7 @@ export declare type SDKUserMessage = {
     tool_use_result?: unknown;
     priority?: 'now' | 'next' | 'later';
     origin?: SDKMessageOrigin;
+
     /**
      * When false, the message is appended to the transcript without triggering an assistant turn. It will be merged into the next user message that does query.
      */
@@ -3310,6 +3415,7 @@ export declare type SDKUserMessageReplay = {
     tool_use_result?: unknown;
     priority?: 'now' | 'next' | 'later';
     origin?: SDKMessageOrigin;
+
     /**
      * When false, the message is appended to the transcript without triggering an assistant turn. It will be merged into the next user message that does query.
      */
@@ -3444,6 +3550,22 @@ export declare type SessionStore = {
         sessionId: string;
         mtime: number;
     }>>;
+    /**
+     * Return incrementally-maintained summaries for all sessions in one call.
+     *
+     * Stores should maintain these via {@link foldSessionSummary} inside
+     * `append()`. When implemented, `listSessions({ sessionStore })` reads
+     * all summary metadata in a single round-trip; when undefined, it falls
+     * back to `listSessions()` + per-session `load()`.
+     *
+     * @remarks
+     * Stores that maintain summaries inside `append()` MUST serialize sidecar
+     * writes if `append()` calls can race for the same session — e.g., wrap the
+     * read-fold-write in a transaction/CAS or hold a per-session lock.
+     * `foldSessionSummary` is pure; concurrency control is the store's responsibility.
+     * @alpha
+     */
+    listSessionSummaries?(projectKey: string): Promise<SessionSummaryEntry[]>;
     /**
      * Delete a session. Optional — if undefined, deletion is a no-op
      * (appropriate for WORM/append-only backends like S3).
@@ -3480,6 +3602,31 @@ export declare type SessionStoreEntry = {
     [k: string]: unknown;
 };
 
+/**
+ * Incrementally-maintained session summary.
+ *
+ * Stores update this on {@link SessionStore.append} via
+ * {@link foldSessionSummary} and return the full set from
+ * {@link SessionStore.listSessionSummaries}. Adapters never re-read
+ * previously appended entries.
+ * @alpha
+ */
+export declare type SessionSummaryEntry = {
+    sessionId: string;
+    /**
+     * Storage write time of the sidecar on the adapter. Must share a clock
+     * source with the `mtime` returned by `listSessions()` for this session —
+     * typically file mtime, S3 LastModified, Postgres `updated_at`, or whatever
+     * native timestamp the adapter surfaces. Do not derive from entry ISO
+     * timestamps — entry timestamps and storage write times can differ by
+     * batching and network latency, and conflating them defeats the staleness
+     * check.
+     */
+    mtime: number;
+    /** Opaque SDK-owned state. Stores MUST persist verbatim and MUST NOT interpret. */
+    data: Record<string, unknown>;
+};
+
 /**
  * AUTO-GENERATED - DO NOT EDIT
  *
@@ -3536,6 +3683,10 @@ export declare interface Settings {
      * Fraction of the context window (in characters) reserved for the skill listing sent to Claude (default: 0.01 = 1%). When the listing exceeds this, descriptions are shortened to fit. Raise to opt in to higher per-turn context cost.
      */
     skillListingBudgetFraction?: number;
+    /**
+     * When set to true in either admin-only Windows source — the HKLM SOFTWARE/Policies/ClaudeCode registry key or C:/Program Files/ClaudeCode/managed-settings.json — WSL reads managed settings from the full Windows policy chain (HKLM, C:/Program Files/ClaudeCode via DrvFs, HKCU) in addition to /etc/claude-code. Windows sources take priority. The flag is also required in HKCU itself for HKCU policy to apply on WSL (double opt-in: admin enables the chain, user confirms HKCU). On native Windows the flag has no effect.
+     */
+    wslInheritsWindowsSettings?: boolean;
     /**
      * Environment variables to set for Claude Code sessions
      */
@@ -3807,6 +3958,41 @@ export declare interface Settings {
                  * If true, hook runs once and is removed after execution
                  */
                 once?: boolean;
+            } | {
+                /**
+                 * MCP tool hook type
+                 */
+                type: 'mcp_tool';
+                /**
+                 * Name of an already-configured MCP server to invoke
+                 */
+                server: string;
+                /**
+                 * Name of the tool on that server to call
+                 */
+                tool: string;
+                /**
+                 * Arguments passed to the MCP tool. String values support ${path} interpolation from the hook input JSON (e.g. "${tool_input.file_path}").
+                 */
+                input?: {
+                    [k: string]: unknown;
+                };
+                /**
+                 * Permission rule syntax to filter when this hook runs (e.g., "Bash(git *)"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.
+                 */
+                if?: string;
+                /**
+                 * Timeout in seconds for this specific tool call
+                 */
+                timeout?: number;
+                /**
+                 * Custom status message to display in spinner while hook runs
+                 */
+                statusMessage?: string;
+                /**
+                 * If true, hook runs once and is removed after execution
+                 */
+                once?: boolean;
             })[];
         }[];
     };
@@ -4003,20 +4189,6 @@ export declare interface Settings {
                          * Custom NPM registry URL (defaults to using system default, likely npmjs.org)
                          */
                         registry?: string;
-                    } | {
-                        source: 'pip';
-                        /**
-                         * Python package name as it appears on PyPI
-                         */
-                        package: string;
-                        /**
-                         * Version specifier (e.g., ==1.0.0, >=2.0.0, <3.0.0)
-                         */
-                        version?: string;
-                        /**
-                         * Custom PyPI registry URL (defaults to using system default, likely pypi.org)
-                         */
-                        registry?: string;
                     } | {
                         source: 'url';
                         /**
@@ -4205,20 +4377,6 @@ export declare interface Settings {
                  * Custom NPM registry URL (defaults to using system default, likely npmjs.org)
                  */
                 registry?: string;
-            } | {
-                source: 'pip';
-                /**
-                 * Python package name as it appears on PyPI
-                 */
-                package: string;
-                /**
-                 * Version specifier (e.g., ==1.0.0, >=2.0.0, <3.0.0)
-                 */
-                version?: string;
-                /**
-                 * Custom PyPI registry URL (defaults to using system default, likely pypi.org)
-                 */
-                registry?: string;
             } | {
                 source: 'url';
                 /**
@@ -4397,20 +4555,6 @@ export declare interface Settings {
                  * Custom NPM registry URL (defaults to using system default, likely npmjs.org)
                  */
                 registry?: string;
-            } | {
-                source: 'pip';
-                /**
-                 * Python package name as it appears on PyPI
-                 */
-                package: string;
-                /**
-                 * Version specifier (e.g., ==1.0.0, >=2.0.0, <3.0.0)
-                 */
-                version?: string;
-                /**
-                 * Custom PyPI registry URL (defaults to using system default, likely pypi.org)
-                 */
-                registry?: string;
             } | {
                 source: 'url';
                 /**
@@ -4952,7 +5096,7 @@ export declare type SyncHookJSONOutput = {
     systemMessage?: string;
     reason?: string;
 
-    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | UserPromptExpansionHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
+    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | UserPromptExpansionHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PostToolBatchHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
 };
 
 /**