@anthropic-ai/claude-agent-sdk 0.2.91 → 0.2.94

package/extractFromBunfs.js

@@ -13,8 +13,8 @@ import {
   renameSync,
   writeFileSync,
 } from 'fs'
-import { tmpdir } from 'os'
 import { join } from 'path'
+import { tmpdir } from './tempfile.js'
 
 /**
  * If `embeddedPath` is inside Bun's $bunfs virtual filesystem, extract it to a

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.91",
-  "buildDate": "2026-04-02T22:04:30Z",
+  "version": "2.1.94",
+  "buildDate": "2026-04-07T20:31:15Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "7433d76d3ec5d223a340e21d7a05f3d481d89999f228113168ad5d64c66fd376",
-      "size": 198092944
+      "checksum": "cf1c5db5e87610eca1e8f06dc2b2a2a9c0c04c179c55c7e1fcdfc9a2c014b31c",
+      "size": 199397456
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "47409dc476c199711d5c776cf359773f75cb9dc72ce7494a4e4cb100520e8ab4",
-      "size": 199574608
+      "checksum": "e3d29d0febf982112e977b7d732adf3167f229521c8697e5253c90a6d2d4a332",
+      "size": 200870864
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "dddba100b352ea6d06aa7e036d5afe49749edddd1309a4aa22e47049fafcadf9",
-      "size": 230427200
+      "checksum": "b3524791b50b314b17dac9978cb9568fa2e11a46562ae6f798d0dac453a0604a",
+      "size": 231672384
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "01b74e1b02e3330940b3526d2f6e00bf32f7fd9e6b3861be6a61e01cfd7296e6",
-      "size": 230161024
+      "checksum": "7cbc939cb52e09d49fd82092061543d21100b04c321e19fecf06f087dc908667",
+      "size": 231434880
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "3dcaacefb510f6aee3573d35fe65f5dccbbbf4b6fdcca9a5a5455c03556a2f8b",
-      "size": 223480256
+      "checksum": "2ab810a4cecec5ca1d141cadd132afdfc4b49d214156e83d9317c69d1688dd73",
+      "size": 224790976
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "b05d9447b7d9a4fa92f936b2275ca87db3bada52d8589bf4e4c49d437366942a",
-      "size": 224459200
+      "checksum": "a841044e81d09b03b844cf231037430416befdc5e50c74df7d71d72c362db542",
+      "size": 225749440
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "12f69849f6774749718520f41fb94f6fc30779b55d8f9b0acaaf20c755e6b55d",
-      "size": 239873184
+      "checksum": "08d0a5abf80510f1539d242214fdfe16f8b40866875f4ab44e8a5f86f2409aa4",
+      "size": 241112736
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "389de7f1f2b979cb4098f7752ca0099275cedabcfe3908a9886d143ef594972b",
-      "size": 236586144
+      "checksum": "1bc64b539ab98661305ffffe17a005d86d895da8be4de45895f371096d078ab2",
+      "size": 237823136
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.91",
-  "buildDate": "2026-04-02T22:04:31Z",
+  "version": "2.1.94",
+  "buildDate": "2026-04-07T20:31:16Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "3cbce93101acbf4af55025efc443ed38c3605e48d67b93eff79e8feaeb646ee6",
-      "size": 40979083,
+      "checksum": "369163ad5c903eec187d12b208275c0cc034b932efe124dbfa64d0703d07441d",
+      "size": 41242270,
       "bundle": {
-        "checksum": "67979609f28865b77c37a57da948d352f23013afe261c3e06668e28f8957f21c",
-        "size": 40975507
+        "checksum": "1540988376cc72774eb0f5b5451ddcdf2053794459c9ba6301c44e38e0a0cc48",
+        "size": 41246676
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "f14816b97af313694ee025a9398e184b5c10b1f83e4b95279c4e9c7e9852650c",
-      "size": 42669756,
+      "checksum": "8255afacbf9d4d62d14aa8bafdab697a4e8e1458cbb4c6dc81e9533244d8f681",
+      "size": 42927007,
       "bundle": {
-        "checksum": "04b781dd2d84c67f399d93d6430b58757f8b71bbc2548ea6117c6b246cf98436",
-        "size": 42671616
+        "checksum": "5fbe707fd6b751ceebc1a8b8a51b42d8c94e9351abe498c8beff15eaa2384dbf",
+        "size": 42916836
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "787c1311934930180f0b4f06dc879c9727cfb12e350f879a62b5d38fc93a0576",
-      "size": 50673837
+      "checksum": "15a44c976954008731f8156fc558fd65a4e589ba1a742e6e7b1270c291fd6c79",
+      "size": 50915013
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "3fe7f8bd1ec9318d90e497fee3c8a9d24390f70efe199cee6b2853b3f4f4b388",
-      "size": 51210881
+      "checksum": "efd242158c50d2aee32c95ed17777a5ce83b56988b0cc4884252dad9e1e0067d",
+      "size": 51482748
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "28a3bd81a6025594397a6defd32aaab09add5d8113e170bd8b8189a019471776",
-      "size": 49318919
+      "checksum": "fd8dc9488d570826dccbfbac2546ea3e2e2568b473e9db2e1dee2704400ab1d8",
+      "size": 49578715
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "67a921d74c572f2b673209c3eae8a54c73844a496b719f7ad413427c679e6097",
-      "size": 49931358
+      "checksum": "beabe8b9f2108752964f616ff6395e9c0e9576d067c19b3dc64ed1639b80fec4",
+      "size": 50143733
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "fcafda7aa8e8d1b29fd188698d4919d99213fbe3a39561679292d5a3e797b480",
-      "size": 52880797
+      "checksum": "98e3585e5b9b9d7c41ac1f0a22f77e9b0f53da4f06d45d5269939173e30e2d0d",
+      "size": 53117708
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "88af689a81ddb34cdda26be335350afec720de6e41b87180c94ebaaf07059793",
-      "size": 51050547
+      "checksum": "6312426659d67d5d770101aa1346c53618af702e5848be2751405ab16a5304a7",
+      "size": 51266876
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.91",
+  "version": "0.2.94",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -20,6 +20,10 @@
       "types": "./bridge.d.ts",
       "default": "./bridge.mjs"
     },
+    "./assistant": {
+      "types": "./assistant.d.ts",
+      "default": "./assistant.mjs"
+    },
     "./sdk-tools": {
       "types": "./sdk-tools.d.ts"
     },
@@ -73,6 +77,8 @@
     "agentSdkTypes.d.ts",
     "bridge.mjs",
     "bridge.d.ts",
+    "assistant.mjs",
+    "assistant.d.ts",
     "browser-sdk.js",
     "browser-sdk.d.ts",
     "embed.js",
@@ -84,5 +90,5 @@
     "vendor/ripgrep/",
     "vendor/audio-capture/"
   ],
-  "claudeCodeVersion": "2.1.91"
+  "claudeCodeVersion": "2.1.94"
 }

package/sdk.d.ts

@@ -29,7 +29,7 @@ export declare type AccountInfo = {
     /**
      * Active API backend. Anthropic OAuth login only applies when "firstParty"; for 3P providers the other fields are absent and auth is external (AWS creds, gcloud ADC, etc.).
      */
-    apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws';
+    apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws' | 'mantle';
 };
 
 /**
@@ -198,6 +198,56 @@ export declare type ConfigChangeHookInput = BaseHookInput & {
  */
 export declare type ConfigScope = 'local' | 'user' | 'project';
 
+/**
+ * Structured failure from connectRemoteControl.
+ * @alpha
+ */
+export declare type ConnectRemoteControlError = {
+    kind: 'conflict' | 'auth' | 'network' | 'unknown';
+    detail: string;
+};
+
+/**
+ * Options for connectRemoteControl.
+ * @alpha
+ */
+export declare type ConnectRemoteControlOptions = {
+    dir: string;
+    /** Override directory sent to backend for env registration. */
+    registrationDir?: string;
+    name?: string;
+    workerType?: string;
+    branch?: string;
+    gitRepoUrl?: string | null;
+    getAccessToken: () => string | undefined;
+    baseUrl: string;
+    orgUUID: string;
+    model: string;
+    /** Reuse env+session across restarts (reads bridge-pointer.json). */
+    perpetual?: boolean;
+    /** SSE high-water mark so reconnect sends from_sequence_num. */
+    initialSSESequenceNum?: number;
+    /** Called on 401; return true after refreshing token to retry. */
+    onAuth401?: (staleAccessToken: string) => Promise<boolean>;
+    /** Called on 409 conflict; return 'takeover' to deregister + retry. */
+    onConflict?: (detail: {
+        machineName: string;
+        message: string;
+    }) => Promise<'takeover' | 'abort'>;
+};
+
+/**
+ * Discriminated result from connectRemoteControl.
+ * @alpha
+ */
+export declare type ConnectRemoteControlResult = {
+    ok: true;
+    handle: RemoteControlHandle;
+} | {
+    ok: false;
+    error: ConnectRemoteControlError;
+};
+
 declare type ControlErrorResponse = {
     subtype: 'error';
     request_id: string;
@@ -307,6 +357,7 @@ declare namespace coreTypes {
         SDKResultSuccess,
         SDKSessionInfo,
         SDKSessionStateChangedMessage,
+        SDKSettingsParseError,
         SDKStatusMessage,
         SDKStatus,
         SDKSystemMessage,
@@ -421,6 +472,12 @@ export declare type ElicitationRequest = {
     elicitationId?: string;
     /** JSON Schema for the requested input (only for 'form' mode) */
     requestedSchema?: Record<string, unknown>;
+    /** Permission-display title from MCP `_meta['anthropic/permissionDisplay']` — header for elicitation-driven permission prompts */
+    title?: string;
+    /** Short tool/server label from MCP `_meta['anthropic/permissionDisplay'].displayName` */
+    displayName?: string;
+    /** Permission-display subtitle from MCP `_meta['anthropic/permissionDisplay'].description` */
+    description?: string;
 };
 
 /**
@@ -609,6 +666,15 @@ export declare type HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput;
 
 export declare type HookPermissionDecision = 'allow' | 'deny' | 'ask' | 'defer';
 
+/**
+ * A user message typed on claude.ai, extracted from the bridge WS.
+ * @alpha
+ */
+export declare type InboundPrompt = {
+    content: string | unknown[];
+    uuid?: string;
+};
+
 export declare type InferShape<T extends AnyZodRawShape> = {
     [K in keyof T]: T[K] extends {
         _output: infer O;
@@ -1968,6 +2034,18 @@ declare type SDKControlElicitationRequest = {
     url?: string;
     elicitation_id?: string;
     requested_schema?: Record<string, unknown>;
+    /**
+     * Permission-display title from the MCP server's _meta['anthropic/permissionDisplay']. Mirrors can_use_tool.title so SDK consumers can render elicitation-driven permission prompts with structured headers instead of parsing `message`.
+     */
+    title?: string;
+    /**
+     * Short tool/server label from _meta['anthropic/permissionDisplay'].displayName. Mirrors can_use_tool.display_name.
+     */
+    display_name?: string;
+    /**
+     * Permission-display subtitle from _meta['anthropic/permissionDisplay'].description. Mirrors can_use_tool.description.
+     */
+    description?: string;
 };
 
 /**
@@ -2219,7 +2297,7 @@ declare type SDKControlRewindFilesRequest = {
 };
 
 /**
- * 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.
+ * Seeds the readFileState cache with a path+mtime entry. Use when a prior Read was removed from context 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';
@@ -2629,6 +2707,24 @@ export declare type SDKSessionStateChangedMessage = {
     session_id: string;
 };
 
+/**
+ * A settings file parse or validation error. When a settings.json file fails to parse (invalid JSON, JSON comments, schema mismatch), the file is skipped and any rules it contained — including permission allow/deny lists — are not applied.
+ */
+export declare type SDKSettingsParseError = {
+    /**
+     * Path to the settings file that failed to parse or validate.
+     */
+    file?: string;
+    /**
+     * Dot-notation path to the field with the error, or empty string for whole-file errors.
+     */
+    path: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+};
+
 export declare type SDKStatus = 'compacting' | null;
 
 export declare type SDKStatusMessage = {
@@ -3790,6 +3886,10 @@ export declare interface Settings {
      * Organization UUID to require for OAuth login. Accepts a single UUID string or an array of UUIDs (any one is permitted). When set in managed settings, login fails if the authenticated account does not belong to a listed organization.
      */
     forceLoginOrgUUID?: string | string[];
+    /**
+     * When set in managed settings, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails
+     */
+    forceRemoteSettingsRefresh?: boolean;
     /**
      * Path to a script that outputs OpenTelemetry headers
      */
@@ -3987,6 +4087,16 @@ export declare interface Settings {
      * Custom directory for plan files, relative to project root. If not set, defaults to ~/.claude/plans/
      */
     plansDirectory?: string;
+    /**
+     * Autonomous background operation configuration
+     */
+    proactive?: {
+        /**
+         * When true, autonomous background operation is activated automatically at launch (if entitled). When false or null, the user must opt in via the /proactive command or --proactive flag. Existing entitlement gates (GrowthBook flag, ZDR, managed-settings) still apply.
+         */
+        autoEnable?: boolean | null;
+    };
+
     /**
      * 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.
      */
@@ -4176,6 +4286,8 @@ export declare type StopHookInput = BaseHookInput & {
      * Text content of the last assistant message before stopping. Avoids the need to read and parse the transcript file.
      */
     last_assistant_message?: string;
+
+
 };
 
 export declare type SubagentStartHookInput = BaseHookInput & {
@@ -4199,6 +4311,8 @@ export declare type SubagentStopHookInput = BaseHookInput & {
      * Text content of the last assistant message before stopping. Avoids the need to read and parse the transcript file.
      */
     last_assistant_message?: string;
+
+
 };
 
 export declare type SyncHookJSONOutput = {
@@ -4254,6 +4368,7 @@ export declare type TerminalReason = 'blocking_limit' | 'rapid_refill_breaker' |
  */
 export declare type ThinkingAdaptive = {
     type: 'adaptive';
+    display?: 'summarized' | 'omitted';
 };
 
 /**
@@ -4274,6 +4389,7 @@ export declare type ThinkingDisabled = {
 export declare type ThinkingEnabled = {
     type: 'enabled';
     budgetTokens?: number;
+    display?: 'summarized' | 'omitted';
 };
 
 export declare function tool<Schema extends AnyZodRawShape>(_name: string, _description: string, _inputSchema: Schema, _handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>, _extras?: {
@@ -4363,11 +4479,13 @@ export declare function unstable_v2_resumeSession(_sessionId: string, _options:
 export declare type UserPromptSubmitHookInput = BaseHookInput & {
     hook_event_name: 'UserPromptSubmit';
     prompt: string;
+    session_title?: string;
 };
 
 export declare type UserPromptSubmitHookSpecificOutput = {
     hookEventName: 'UserPromptSubmit';
     additionalContext?: string;
+    sessionTitle?: string;
 };
 
 export declare type WorktreeCreateHookInput = BaseHookInput & {