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

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.110",
-  "buildDate": "2026-04-15T19:43:17Z",
+  "version": "2.1.112",
+  "buildDate": "2026-04-16T18:39:33Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "f45cb1b0765f9fc592d36d7153f6c1ff0ecfc3ae9cbc997eaff2b0cd25bff9f6",
-      "size": 202932416
+      "checksum": "b05381f382754012b95984016000f7062a2f127a6a3a843afc37ebd7d4672340",
+      "size": 203956832
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "d4896277920c253c2bda5e0ae02a3e39486fa203603c2b25cc236533d68518fd",
-      "size": 204376928
+      "checksum": "a2a7fea41acee4c889b30132dd490ac00b1cb86c6e25755a224d91b1cba97734",
+      "size": 205442640
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "ff5bf0372d1700cfb4d232021c6e0d417205c16392492da0fabc6b509eeee92a",
-      "size": 235145792
+      "checksum": "1015ef5747767cdac58376de4ec990253dcac49314d54e19750d5512fa7422f6",
+      "size": 236128832
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "7ecdde57b002d5927e704dcbce04eaafb923644d315259ba2e6ac6f0712163a4",
-      "size": 234871424
+      "checksum": "57be9406d3e5cae259552790bf7288dd6496675430ec93dbed76a33a57580d3d",
+      "size": 235846272
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "d6878d6c32668ffda513218fe2775f6bdfb718575139ac8e6731b6b4cd485d8a",
-      "size": 227805632
+      "checksum": "dcf16fc8ab6e4b504af6c66d5e5afc113a9a5da2a9d7e555cac0b301873a84f6",
+      "size": 228854208
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "aaaf37cc68acd7a83351f5e788d6a5cede0654b05c6b616ae0c9b6fbacbc1b78",
-      "size": 229120448
+      "checksum": "4b629f61a1e280a5e3c22bad8e1ea3118f4aebcde7e6754f18331c500e5b3fe0",
+      "size": 230111680
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "6d267d4bc70b98436d4e55c0c3a6cd310b2e97bb42d215abb646093fce9ea3bd",
-      "size": 244445344
+      "checksum": "7eb4916245c797f89ae7905c4cd211429264ec38b1b8164b7babdfa7746eb839",
+      "size": 245424288
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "e1d4914eead2dddb36e84c15bc1dc9655ae92f0b43a1c7964a7c99900b515bf8",
-      "size": 241153696
+      "checksum": "79336ca966d89d844eb8b198b8423cd8f75e0407d16359c1b492cc9decbbc999",
+      "size": 242155680
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.110",
-  "buildDate": "2026-04-15T19:50:40Z",
+  "version": "2.1.112",
+  "buildDate": "2026-04-16T18:46:37Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "1fb5c689fdaa40b678a3795d309526ab23b84b2b2b38f205f8d7a9d2222aad01",
-      "size": 41942064,
+      "checksum": "a8217b265ca2618e1c47f1c294c77a540caba32e70f3d7c037614e65c57b124a",
+      "size": 42163665,
       "bundle": {
-        "checksum": "06aadef14bbdbc13ed357be8448c5df15abeb1dbc111596eeea818d3b2f8e32d",
-        "size": 41946957
+        "checksum": "26893767a6f177549aa80530dc8dfb9b95e6890bf16a1877d70db66f3ce7d88c",
+        "size": 42165042
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "de6801c997babd684378831681e0a06e57b4e746efeb68210f5358aeb6920b72",
-      "size": 43628781,
+      "checksum": "11e7bd62a925e9a0db87295d632e6f9ce261b924498c48b459e06ea53eea5863",
+      "size": 43834050,
       "bundle": {
-        "checksum": "b401f944c23c9d6ba3c4133fe778d7df39957ef326431cac95bae3a1341b50f1",
-        "size": 43630090
+        "checksum": "738f3f963939a11b94853a853ebf87ae3f2dcb91b806fbc2ba9396393b652ce0",
+        "size": 43835842
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "cfbd59fc6711d25288500de133a9147e4fc748da0825109a60ab6af3d2c073f8",
-      "size": 51585905
+      "checksum": "e011d6ddfaaf0a342506a0210e3b7ab1f3e96dd7272f3e02c98151c2492883e6",
+      "size": 51801672
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "d0da2a150be75b11f00a7ddc2af9060655f31a9b9b8eb4a8fa0a9d987c8d8285",
-      "size": 52158838
+      "checksum": "10b22a9ced0140ef301d185b98cf308d2d18fdfd09e9cb58c275fb93b1a2a344",
+      "size": 52370027
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "603a19ed0ac655df3a45152e9a1747551a49012162728df7ff4dba7fc2f6cedd",
-      "size": 50205097
+      "checksum": "60ccee17d1498a853d97e900d85e5fcddc13f811b0c0cef374e13f34306d5454",
+      "size": 50418347
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "e09082eb2677bfbd953754f402e8d737c2e2df106fc2aee4c6dc0a9c9540e795",
-      "size": 50842631
+      "checksum": "92f9c3e08fe052a10811d86f014b5edc84906e10576b1002e88ddd068f9e4c3b",
+      "size": 51050348
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "ed38429823c7751ff385d6cc6ff5ae7bce9a60238d3422f75f2a32963120c9de",
-      "size": 53814271
+      "checksum": "aca902df1721b9ce7f857931d506bd5a313a35279939da47ef4c3d8776dd32af",
+      "size": 54047032
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "392a074eca73534b056e3303665d93e1955ac688fdd621a7115b3864526460ad",
-      "size": 51977170
+      "checksum": "9965dff6f3c638639818a7a3358e34c5caa9ffa3efb264e4ba421ee4b3bfb1d2",
+      "size": 52182523
     }
   }
 }

package/package.json

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

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;