@anthropic-ai/claude-agent-sdk 0.2.110 → 0.2.111

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.110",
-  "buildDate": "2026-04-15T19:43:17Z",
+  "version": "2.1.111",
+  "buildDate": "2026-04-16T14:30:47Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "f45cb1b0765f9fc592d36d7153f6c1ff0ecfc3ae9cbc997eaff2b0cd25bff9f6",
-      "size": 202932416
+      "checksum": "2620cc83dbee72c24858b3519ce5de050fef91f0d3d17b309176d61e679f95ee",
+      "size": 203956832
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "d4896277920c253c2bda5e0ae02a3e39486fa203603c2b25cc236533d68518fd",
-      "size": 204376928
+      "checksum": "16d897d570c93b83d100a16a7a33ca3adbd43b1b0f818ab66bef1a364b2460a6",
+      "size": 205442640
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "ff5bf0372d1700cfb4d232021c6e0d417205c16392492da0fabc6b509eeee92a",
-      "size": 235145792
+      "checksum": "99376866bf7ec367142d3be548c17184a79f30a97318441ee9a00f78e51246e7",
+      "size": 236128832
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "7ecdde57b002d5927e704dcbce04eaafb923644d315259ba2e6ac6f0712163a4",
-      "size": 234871424
+      "checksum": "5d4df970040b0f83aac434ae540b409126a4778a379e8c9b4c793560e3bfa060",
+      "size": 235842176
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "d6878d6c32668ffda513218fe2775f6bdfb718575139ac8e6731b6b4cd485d8a",
-      "size": 227805632
+      "checksum": "39f1d4b9c328ced97dae1de8ca000769e935e15aaa89f54f4c6663016c834ff5",
+      "size": 228854208
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "aaaf37cc68acd7a83351f5e788d6a5cede0654b05c6b616ae0c9b6fbacbc1b78",
-      "size": 229120448
+      "checksum": "cb789bbf32c90aa7b658f0cf1cedd7116b45afc5e0438f6fda4af0bac5996c9f",
+      "size": 230107584
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "6d267d4bc70b98436d4e55c0c3a6cd310b2e97bb42d215abb646093fce9ea3bd",
-      "size": 244445344
+      "checksum": "51024dbcd60382b6fb881b5cda6754a0fe445a90d3ad02eb5f13a2733ac3262e",
+      "size": 245423264
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "e1d4914eead2dddb36e84c15bc1dc9655ae92f0b43a1c7964a7c99900b515bf8",
-      "size": 241153696
+      "checksum": "8381c9964a39cb231e4243d5ec7bf0158719fc292de1130f7c0f07e8b3137327",
+      "size": 242154656
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.110",
-  "buildDate": "2026-04-15T19:50:40Z",
+  "version": "2.1.111",
+  "buildDate": "2026-04-16T14:39:11Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "1fb5c689fdaa40b678a3795d309526ab23b84b2b2b38f205f8d7a9d2222aad01",
-      "size": 41942064,
+      "checksum": "06a5fe396c482384d1395baed8762267875fee044f554f9381f4b5cfa389d427",
+      "size": 42157993,
       "bundle": {
-        "checksum": "06aadef14bbdbc13ed357be8448c5df15abeb1dbc111596eeea818d3b2f8e32d",
-        "size": 41946957
+        "checksum": "2283a0f4b65995b48a3ef511ff7e6193b9683791a30fb897c81f316a0ec89ba3",
+        "size": 42162315
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "de6801c997babd684378831681e0a06e57b4e746efeb68210f5358aeb6920b72",
-      "size": 43628781,
+      "checksum": "147798474995aefdfa6c6637182d4195094a19643b81503ca23d2155c66559f1",
+      "size": 43839794,
       "bundle": {
-        "checksum": "b401f944c23c9d6ba3c4133fe778d7df39957ef326431cac95bae3a1341b50f1",
-        "size": 43630090
+        "checksum": "e47b03935637aa828bc8e58f827bcfb2b5e74a27def6e1471a0f2a0eb6e9d293",
+        "size": 43845409
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "cfbd59fc6711d25288500de133a9147e4fc748da0825109a60ab6af3d2c073f8",
-      "size": 51585905
+      "checksum": "a6830c443d1722c882b37c2901b022c3d23c34262de2213c9a5cbeb8391329ea",
+      "size": 51815821
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "d0da2a150be75b11f00a7ddc2af9060655f31a9b9b8eb4a8fa0a9d987c8d8285",
-      "size": 52158838
+      "checksum": "39048ef36dbed45f21251248bfe04c9a5b3d8c32025aa7550537792543d357f4",
+      "size": 52369905
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "603a19ed0ac655df3a45152e9a1747551a49012162728df7ff4dba7fc2f6cedd",
-      "size": 50205097
+      "checksum": "3d4c9721533bcef05218bc56987203ae39dfb96b66b0c408c9330bac041ca3f6",
+      "size": 50414751
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "e09082eb2677bfbd953754f402e8d737c2e2df106fc2aee4c6dc0a9c9540e795",
-      "size": 50842631
+      "checksum": "05eecc13acf12bfaee43ef4679cf288af035070411a4624702e8ac7d7e95e15c",
+      "size": 51067121
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "ed38429823c7751ff385d6cc6ff5ae7bce9a60238d3422f75f2a32963120c9de",
-      "size": 53814271
+      "checksum": "a0089a845fe8e66adbde895a8b270513f6c871c74eabd76c374df2afc943ff5b",
+      "size": 54042832
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "392a074eca73534b056e3303665d93e1955ac688fdd621a7115b3864526460ad",
-      "size": 51977170
+      "checksum": "a19dd40baeb0306b65adab99f711762a06a181b906048c519f3a4b68125d922e",
+      "size": 52180072
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.110",
+  "version": "0.2.111",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -90,5 +90,5 @@
     "vendor/ripgrep/",
     "vendor/audio-capture/"
   ],
-  "claudeCodeVersion": "2.1.110"
+  "claudeCodeVersion": "2.1.111"
 }

package/sdk.d.ts

@@ -84,7 +84,7 @@ export declare type AgentDefinition = {
     /**
      * Reasoning effort level for this agent. Either a named level or an integer
      */
-    effort?: ('low' | 'medium' | 'high' | 'max') | number;
+    effort?: ('low' | 'medium' | 'high' | 'xhigh' | 'max') | number;
     /**
      * Permission mode controlling how tool executions are handled
      */
@@ -304,6 +304,7 @@ declare namespace coreTypes {
         McpServerConfigForProcessTransport,
         McpServerStatusConfig,
         McpServerStatus,
+        McpServerToolPolicy,
         McpSetServersResult,
         McpStdioServerConfig,
         ModelInfo,
@@ -436,9 +437,10 @@ export declare type CwdChangedHookSpecificOutput = {
  * - `'low'` — Minimal thinking, fastest responses
  * - `'medium'` — Moderate thinking
  * - `'high'` — Deep reasoning (default)
+ * - `'xhigh'` — Deeper than high (Opus 4.7 only; falls back to `'high'` elsewhere)
  * - `'max'` — Maximum effort (select models only)
  */
-export declare type EffortLevel = 'low' | 'medium' | 'high' | 'max';
+export declare type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | '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.
@@ -747,9 +749,7 @@ export declare type ListSessionsOptions = {
      * When `dir` is provided and the directory is inside a git repository,
      * include sessions from all git worktree paths. Defaults to `true`.
      *
-     * Only applies to the local-filesystem path. Ignored when `sessionStore`
-     * is provided — worktree enumeration requires inspecting `.git/worktrees`
-     * on disk, which a SessionStore (keyed by projectKey) has no view of.
+     * Only applies when reading from the local filesystem.
      */
     includeWorktrees?: boolean;
 
@@ -786,6 +786,7 @@ export declare type McpHttpServerConfig = {
     type: 'http';
     url: string;
     headers?: Record<string, string>;
+    tools?: McpServerToolPolicy[];
 };
 
 export declare type McpSdkServerConfig = {
@@ -856,6 +857,14 @@ export declare type McpServerStatus = {
 
 export declare type McpServerStatusConfig = McpServerConfigForProcessTransport | McpClaudeAIProxyServerConfig;
 
+/**
+ * Per-tool permission policy carried on mcp_set_servers for remote servers.
+ */
+export declare type McpServerToolPolicy = {
+    name: string;
+    permission_policy: 'always_allow' | 'always_ask' | 'always_deny';
+};
+
 /**
  * Result of a setMcpServers operation.
  */
@@ -878,6 +887,7 @@ export declare type McpSSEServerConfig = {
     type: 'sse';
     url: string;
     headers?: Record<string, string>;
+    tools?: McpServerToolPolicy[];
 };
 
 export declare type McpStdioServerConfig = {
@@ -910,7 +920,7 @@ export declare type ModelInfo = {
     /**
      * Available effort levels for this model
      */
-    supportedEffortLevels?: ('low' | 'medium' | 'high' | 'max')[];
+    supportedEffortLevels?: ('low' | 'medium' | 'high' | 'xhigh' | 'max')[];
     /**
      * Whether this model supports adaptive thinking (Claude decides when and how much to think)
      */
@@ -1048,7 +1058,11 @@ export declare type Options = {
     };
     /**
      * Environment variables to pass to the Claude Code process.
-     * Defaults to `process.env`.
+     * Merged on top of `process.env` — entries here override the parent
+     * process's variables, and anything not set here is inherited.
+     * Set a key to `undefined` to remove an inherited variable. Note:
+     * `GITHUB_ACTIONS` and a few SDK-managed vars are stripped and are
+     * not inherited unless set explicitly here.
      *
      * SDK consumers can identify their app/library to include in the User-Agent header by setting:
      * - `CLAUDE_AGENT_SDK_CLIENT_APP` - Your app/library identifier (e.g., "my-app/1.0.0", "my-library/2.1")
@@ -1192,7 +1206,8 @@ export declare type Options = {
      * - `'low'` — Minimal thinking, fastest responses
      * - `'medium'` — Moderate thinking
      * - `'high'` — Deep reasoning (default)
-     * - `'max'` — Maximum effort (Opus 4.6 only)
+     * - `'xhigh'` — Deeper than high (Opus 4.7 only)
+     * - `'max'` — Maximum effort (Opus 4.6/4.7 only)
      *
      * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
      */
@@ -1243,7 +1258,7 @@ export declare type Options = {
     mcpServers?: Record<string, McpServerConfig>;
     /**
      * Claude model to use. Defaults to the CLI default model.
-     * Examples: 'claude-sonnet-4-6', 'claude-opus-4-6'
+     * Examples: 'claude-sonnet-4-6', 'claude-opus-4-7'
      */
     model?: string;
     /**
@@ -1495,6 +1510,7 @@ export declare type Options = {
         append?: string;
         excludeDynamicSections?: boolean;
     };
+
     /**
      * Custom function to spawn the Claude Code process.
      * Use this to run Claude Code in VMs, containers, or remote environments.
@@ -1847,6 +1863,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
 
 
 
+
     /**
      * Reconnect an MCP server by name.
      * Throws on failure.
@@ -2225,6 +2242,7 @@ declare type SDKControlInitializeRequest = {
     jsonSchema?: Record<string, unknown>;
     systemPrompt?: string[];
     appendSystemPrompt?: 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.
      */
@@ -2352,7 +2370,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | 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;
 
 /**
  * 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.
@@ -2820,7 +2838,11 @@ export declare type SDKSessionOptions = {
     executableArgs?: string[];
     /**
      * Environment variables to pass to the Claude Code process.
-     * Defaults to `process.env`.
+     * Merged on top of `process.env` — entries here override the parent
+     * process's variables, and anything not set here is inherited.
+     * Set a key to `undefined` to remove an inherited variable. Note:
+     * `GITHUB_ACTIONS` and a few SDK-managed vars are stripped and are
+     * not inherited unless set explicitly here.
      *
      * SDK consumers can identify their app/library to include in the User-Agent header by setting:
      * - `CLAUDE_AGENT_SDK_CLIENT_APP` - Your app/library identifier (e.g., "my-app/1.0.0", "my-library/2.1")
@@ -2941,6 +2963,7 @@ export declare type SDKSystemMessage = {
         path: string;
 
     }[];
+
     fast_mode_state?: FastModeState;
 
     uuid: UUID;
@@ -3144,6 +3167,10 @@ export declare interface Settings {
      * Path to a script that outputs authentication values
      */
     apiKeyHelper?: string;
+    /**
+     * Shell command that outputs a Proxy-Authorization header value (EAP)
+     */
+    proxyAuthHelper?: string;
     /**
      * Path to a script that exports AWS credentials
      */
@@ -4262,7 +4289,7 @@ export declare interface Settings {
     /**
      * Persisted effort level for supported models.
      */
-    effortLevel?: 'low' | 'medium' | 'high';
+    effortLevel?: 'low' | 'medium' | 'high' | 'xhigh';
     /**
      * Auto-compact window size
      */
@@ -4516,6 +4543,15 @@ export declare interface SpawnOptions {
     signal: AbortSignal;
 }
 
+/**
+ * Pre-warms the CLI subprocess so the first `query()` resolves immediately.
+ * Returns a {@link WarmQuery} handle.
+ */
+export declare function startup(_params?: {
+    options?: Options;
+    initializeTimeoutMs?: number;
+}): Promise<WarmQuery>;
+
 declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
 
 export declare type StopFailureHookInput = BaseHookInput & {
@@ -4751,6 +4787,25 @@ export declare type UserPromptSubmitHookSpecificOutput = {
     sessionTitle?: string;
 };
 
+/**
+ * A pre-warmed query handle returned by `startup()`. The subprocess has
+ * already been spawned and completed its initialize handshake, so calling
+ * `query()` writes the prompt directly to a ready process — no startup
+ * latency.
+ */
+export declare interface WarmQuery extends AsyncDisposable {
+    /**
+     * Send a prompt to the pre-warmed subprocess and return the Query.
+     * Can only be called once per WarmQuery.
+     */
+    query(prompt: string | AsyncIterable<SDKUserMessage>): Query;
+    /**
+     * Close the subprocess without sending a prompt. Use this to discard a
+     * warm query you no longer need.
+     */
+    close(): void;
+}
+
 export declare type WorktreeCreateHookInput = BaseHookInput & {
     hook_event_name: 'WorktreeCreate';
     name: string;