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

package/embed.js

@@ -20,7 +20,7 @@
 // 2. At runtime, extractFromBunfs() copies it to a temp directory so it can be
 //    spawned as a subprocess (child processes cannot access the parent's $bunfs)
 
-import { extractFromBunfs } from './extractFromBunfs.js'
 import embeddedCliPath from './cli.js' with { type: 'file' }
+import { extractFromBunfs } from './extractFromBunfs.js'
 
 export default extractFromBunfs(embeddedCliPath)

package/extractFromBunfs.js

@@ -5,16 +5,16 @@
 // Separated from embed.js so the logic is testable without Bun-specific
 // `import ... with { type: 'file' }` syntax.
 
+import { createHash } from 'crypto'
 import {
-  readFileSync,
-  writeFileSync,
-  mkdirSync,
   chmodSync,
+  mkdirSync,
+  readFileSync,
   renameSync,
+  writeFileSync,
 } from 'fs'
-import { join } from 'path'
 import { tmpdir } from 'os'
-import { createHash } from 'crypto'
+import { join } from 'path'
 
 /**
  * If `embeddedPath` is inside Bun's $bunfs virtual filesystem, extract it to a

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.84",
-  "buildDate": "2026-03-25T23:54:35Z",
+  "version": "2.1.86",
+  "buildDate": "2026-03-27T20:34:42Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "c02d911ff13f8ceccb1f6662bf211f3cd9f29d5a46f031c3cc40654eb759aa29",
-      "size": 203606768
+      "checksum": "76fafee995269784b1bf80b514c3b354394288fb794bed01ef20168874e088ea",
+      "size": 196638704
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "da5ed2ee1b0bcf65c2088e79bc65388ec85edc41041fc6ca7c27330f2e201085",
-      "size": 205199952
+      "checksum": "de96f6966648ecd93c345fab4b3be944e93ba4140f1cda7fe45ffed93133b67e",
+      "size": 198132816
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "5c868174b44439e51c74ff084c306856c41779615250d5bbdaa5d10056362814",
-      "size": 235473472
+      "checksum": "c04aebe3de140679b4cce158812d6f011b7e9c483496ccb0472cf38cc1714afe",
+      "size": 228461120
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "c6872aa8db94f303bc6a4482664e40d3288dfc989c89ba268473ed32e3055878",
-      "size": 235657856
+      "checksum": "adce02c5f94a85b6ca231c8aeef533707597cd387e8934776455b87d10a3051b",
+      "size": 228280960
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "6e42aee87a00ab8e6fb3db3fc409ab969f12758bacc2a0c9f622d8e97445a0a8",
-      "size": 228592064
+      "checksum": "ded1933ce0f2bb55156b397fa622ca2782caa48ed99ed117ee20481f638e0293",
+      "size": 221579712
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "0109e76af6261f6fd37ae1deefc7ee3bc58b0ad786086d198a981275979c549a",
-      "size": 230283712
+      "checksum": "fb86c40f52a39c71393db93b9fa5f5c048be67c5a087a03e35e1e304c127c8c5",
+      "size": 222906816
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "64b28630ec4f4aaa6cc0e225379cf59cdb95828cbb4ce700a0ae4401b1999ecd",
-      "size": 245196960
+      "checksum": "9b9281621d0d5aa4aba3e3e9c5a6efdfe37a897fb9ba33a87e4562ec9df6453f",
+      "size": 238222496
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "e7f5d18d470f0345ee18bb368f8ea7d43e791e17f0de7b69cdc40e42a9a9398e",
-      "size": 241350304
+      "checksum": "4f6eaa82b5eefd79b1ed56d6d6ffa3229c508c974f51ae43b6c38f5e2fdafe5f",
+      "size": 234785440
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.84",
-  "buildDate": "2026-03-25T23:54:36Z",
+  "version": "2.1.86",
+  "buildDate": "2026-03-27T20:34:43Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "a0e577c1ca84302c5de1e6498d047149ba44a710ea51ff303986fd47f1c0eb83",
-      "size": 43366416,
+      "checksum": "fe4d250299ff4789e4c3a1172c97720c62fefed52496b66652325815fec58949",
+      "size": 40735714,
       "bundle": {
-        "checksum": "4111e9be5214eb3e2e97d7fc133dbb13b51fc8978fff23d26578021fa84b7c30",
-        "size": 43377661
+        "checksum": "0315d453553df95189f14ddfb15d7d0d9df97121673cc685bb3b1bdcfe0214fb",
+        "size": 40733484
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "d852a6245edfb235dd73bdffef79012ab18ee075ef3ded5abf602b17812bc82a",
-      "size": 45050362,
+      "checksum": "8b1ef96634369e58cd480276c030a55c39bd66cb33b703a5f35c818a922c4d69",
+      "size": 42395229,
       "bundle": {
-        "checksum": "10bcd37cb20f82861ed710292821927d7f8e1549ca1dbc9e248769409c62f22b",
-        "size": 45050626
+        "checksum": "4fe4d244397a50ccb33f2a3600cc342f0f6ec1731983c748ec6ebe8b57342488",
+        "size": 42396667
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "fb0a0db9e8ceb414563fe776b9035b0827548d8e94bfab23f5c58a63d9c5f7b4",
-      "size": 53002601
+      "checksum": "480cf52b5380fb9013902fe893ec58553f848f34bd979788f20106ff0ee61b1b",
+      "size": 50420732
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "8476f46fb0422be1fc2cafe82c1b4b51226c07b5b73b40dd40b203cc5c8ad90a",
-      "size": 53582657
+      "checksum": "0866db2a7ef4ccaad987f834639770299a9a740ed82a5cc53eb2db304e881986",
+      "size": 50935311
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "7523be8411a2fef9bb4d93c59707d5497f5bf8229fb528fbc9ba5fc146480dee",
-      "size": 51604167
+      "checksum": "05e6b45654b57c6cd26e80157c8112f0d24abfee053c0aa926b297ec608fcd78",
+      "size": 49030009
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "e670e1468f01946a822d1526276f2f9de566987d89bbd52186a505f88763714f",
-      "size": 52327014
+      "checksum": "5154b2d20634a180b6d7b4e74afcf87125663d6fe5ccfc0553a6a6dd6e7b17ab",
+      "size": 49670272
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "e83814324697073fe6462eafcca9c354af1dc22e9689e5f3c0788dd1021ef414",
-      "size": 55192345
+      "checksum": "a231ea48462175772d5af60bb13b70ef1f0748f63e426edf05f0b50d88c70e6c",
+      "size": 52576784
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "dc7c0d74e5ae0704c4745d350f0afc5c2044b4b3fe553fb808252b9f2957af87",
-      "size": 53246192
+      "checksum": "d566cde2014177d00862b66dc971121cf4569e11f7763ce28e5f34132308cb73",
+      "size": 50754734
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.84",
+  "version": "0.2.86",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -47,7 +47,10 @@
     "automation",
     "code-generation"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.74.0",
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
   "peerDependencies": {
     "zod": "^4.0.0"
   },
@@ -62,5 +65,5 @@
     "@img/sharp-win32-arm64": "^0.34.2",
     "@img/sharp-win32-x64": "^0.34.2"
   },
-  "claudeCodeVersion": "2.1.84"
+  "claudeCodeVersion": "2.1.86"
 }

package/sdk-tools.d.ts

@@ -23,10 +23,6 @@ export type ToolInputSchemas =
   | McpInput
   | NotebookEditInput
   | ReadMcpResourceInput
-  | SubscribeMcpResourceInput
-  | UnsubscribeMcpResourceInput
-  | SubscribePollingInput
-  | UnsubscribePollingInput
   | TodoWriteInput
   | WebFetchInput
   | WebSearchInput
@@ -49,10 +45,6 @@ export type ToolOutputSchemas =
   | McpOutput
   | NotebookEditOutput
   | ReadMcpResourceOutput
-  | SubscribeMcpResourceOutput
-  | UnsubscribeMcpResourceOutput
-  | SubscribePollingOutput
-  | UnsubscribePollingOutput
   | TodoWriteOutput
   | WebFetchOutput
   | WebSearchOutput
@@ -226,6 +218,15 @@ export type FileReadOutput =
          */
         outputDir: string;
       };
+    }
+  | {
+      type: "file_unchanged";
+      file: {
+        /**
+         * The path to the file
+         */
+        filePath: string;
+      };
     };
 export type ListMcpResourcesOutput = {
   /**
@@ -519,80 +520,6 @@ export interface ReadMcpResourceInput {
    */
   uri: string;
 }
-export interface SubscribeMcpResourceInput {
-  /**
-   * The MCP server name
-   */
-  server: string;
-  /**
-   * The resource URI to subscribe to
-   */
-  uri: string;
-  /**
-   * Optional reason for subscribing (included in update notifications)
-   */
-  reason?: string;
-}
-export interface UnsubscribeMcpResourceInput {
-  /**
-   * The MCP server name
-   */
-  server?: string;
-  /**
-   * The resource URI to unsubscribe from
-   */
-  uri?: string;
-  /**
-   * The subscription ID to unsubscribe
-   */
-  subscriptionId?: string;
-}
-export interface SubscribePollingInput {
-  /**
-   * The type of subscription: "tool" to poll a tool, "resource" to poll a resource URI
-   */
-  type: "tool" | "resource";
-  /**
-   * The MCP server name
-   */
-  server: string;
-  /**
-   * The tool to call periodically (required when type is "tool")
-   */
-  toolName?: string;
-  /**
-   * Arguments to pass to the tool on each call
-   */
-  arguments?: {
-    [k: string]: unknown;
-  };
-  /**
-   * The resource URI to poll (required when type is "resource")
-   */
-  uri?: string;
-  /**
-   * Polling interval in milliseconds (minimum 1000ms, default 5000ms)
-   */
-  intervalMs: number;
-  /**
-   * Optional reason for subscribing (included in change notifications)
-   */
-  reason?: string;
-}
-export interface UnsubscribePollingInput {
-  /**
-   * The subscription ID to unsubscribe
-   */
-  subscriptionId?: string;
-  /**
-   * The MCP server name
-   */
-  server?: string;
-  /**
-   * The target to unsubscribe (tool name for tool subscriptions, URI for resource subscriptions)
-   */
-  target?: string;
-}
 export interface TodoWriteInput {
   /**
    * The updated todo list
@@ -2507,38 +2434,6 @@ export interface ReadMcpResourceOutput {
     blobSavedTo?: string;
   }[];
 }
-export interface SubscribeMcpResourceOutput {
-  /**
-   * Whether the subscription was successful
-   */
-  subscribed: boolean;
-  /**
-   * Unique identifier for this subscription
-   */
-  subscriptionId: string;
-}
-export interface UnsubscribeMcpResourceOutput {
-  /**
-   * Whether the unsubscription was successful
-   */
-  unsubscribed: boolean;
-}
-export interface SubscribePollingOutput {
-  /**
-   * Whether the subscription was successful
-   */
-  subscribed: boolean;
-  /**
-   * Unique identifier for this subscription
-   */
-  subscriptionId: string;
-}
-export interface UnsubscribePollingOutput {
-  /**
-   * Whether the unsubscription was successful
-   */
-  unsubscribed: boolean;
-}
 export interface TodoWriteOutput {
   /**
    * The todo list before the update

package/sdk.d.ts

@@ -197,10 +197,10 @@ declare type ControlResponse = {
 
 declare namespace coreTypes {
     export {
-        SandboxSettings,
-        SandboxNetworkConfig,
         SandboxFilesystemConfig,
         SandboxIgnoreViolations,
+        SandboxNetworkConfig,
+        SandboxSettings,
         NonNullableUsage,
         HOOK_EVENTS,
         EXIT_REASONS,
@@ -1577,6 +1577,20 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * @returns Array of MCP server statuses (connected, failed, needs-auth, pending)
      */
     mcpServerStatus(): Promise<McpServerStatus[]>;
+    /**
+     * Get a breakdown of current context window usage by category
+     * (system prompt, tools, messages, MCP tools, memory files, etc.).
+     *
+     * @returns Context usage breakdown including token counts per category and total usage
+     */
+    getContextUsage(): Promise<SDKControlGetContextUsageResponse>;
+    /**
+     * Reload plugins from disk and return the refreshed commands, agents,
+     * plugins, and MCP server status.
+     *
+     * @returns The refreshed session components after plugin reload
+     */
+    reloadPlugins(): Promise<SDKControlReloadPluginsResponse>;
     /**
      * Get information about the authenticated account.
      *
@@ -1608,6 +1622,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
 
 
 
+
     /**
      * Reconnect an MCP server by name.
      * Throws on failure.
@@ -1851,6 +1866,106 @@ declare type SDKControlElicitationRequest = {
     requested_schema?: Record<string, unknown>;
 };
 
+/**
+ * Requests a breakdown of current context window usage by category.
+ */
+declare type SDKControlGetContextUsageRequest = {
+    subtype: 'get_context_usage';
+};
+
+/**
+ * Breakdown of current context window usage by category (system prompt, tools, messages, etc.).
+ */
+export declare type SDKControlGetContextUsageResponse = {
+    categories: {
+        name: string;
+        tokens: number;
+        color: string;
+        isDeferred?: boolean;
+    }[];
+    totalTokens: number;
+    maxTokens: number;
+    rawMaxTokens: number;
+    percentage: number;
+    gridRows: {
+        color: string;
+        isFilled: boolean;
+        categoryName: string;
+        tokens: number;
+        percentage: number;
+        squareFullness: number;
+    }[][];
+    model: string;
+    memoryFiles: {
+        path: string;
+        type: string;
+        tokens: number;
+    }[];
+    mcpTools: {
+        name: string;
+        serverName: string;
+        tokens: number;
+        isLoaded?: boolean;
+    }[];
+    deferredBuiltinTools?: {
+        name: string;
+        tokens: number;
+        isLoaded: boolean;
+    }[];
+    systemTools?: {
+        name: string;
+        tokens: number;
+    }[];
+    systemPromptSections?: {
+        name: string;
+        tokens: number;
+    }[];
+    agents: {
+        agentType: string;
+        source: string;
+        tokens: number;
+    }[];
+    slashCommands?: {
+        totalCommands: number;
+        includedCommands: number;
+        tokens: number;
+    };
+    skills?: {
+        totalSkills: number;
+        includedSkills: number;
+        tokens: number;
+        skillFrontmatter: {
+            name: string;
+            source: string;
+            tokens: number;
+        }[];
+    };
+    autoCompactThreshold?: number;
+    isAutoCompactEnabled: boolean;
+    messageBreakdown?: {
+        toolCallTokens: number;
+        toolResultTokens: number;
+        attachmentTokens: number;
+        assistantMessageTokens: number;
+        userMessageTokens: number;
+        toolCallsByType: {
+            name: string;
+            callTokens: number;
+            resultTokens: number;
+        }[];
+        attachmentsByType: {
+            name: string;
+            tokens: number;
+        }[];
+    };
+    apiUsage: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens: number;
+        cache_read_input_tokens: number;
+    } | null;
+};
+
 /**
  * Returns the effective merged settings and the raw per-source settings.
  */
@@ -1876,7 +1991,7 @@ declare type SDKControlInitializeRequest = {
 /**
  * Response from session initialization with available commands, models, and account info.
  */
-declare type SDKControlInitializeResponse = {
+export declare type SDKControlInitializeResponse = {
     commands: coreTypes.SlashCommand[];
     agents: coreTypes.AgentInfo[];
     output_style: string;
@@ -1955,13 +2070,35 @@ declare type SDKControlPermissionRequest = {
     description?: string;
 };
 
+/**
+ * Reloads plugins from disk and returns the refreshed session components.
+ */
+declare type SDKControlReloadPluginsRequest = {
+    subtype: 'reload_plugins';
+};
+
+/**
+ * Refreshed commands, agents, plugins, and MCP server status after reload.
+ */
+export declare type SDKControlReloadPluginsResponse = {
+    commands: coreTypes.SlashCommand[];
+    agents: coreTypes.AgentInfo[];
+    plugins: {
+        name: string;
+        path: string;
+        source?: string;
+    }[];
+    mcpServers: coreTypes.McpServerStatus[];
+    error_count: number;
+};
+
 export declare type SDKControlRequest = {
     type: 'control_request';
     request_id: string;
     request: SDKControlRequestInner;
 };
 
-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;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | 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';
@@ -2503,7 +2640,7 @@ export declare type SDKUserMessage = {
      */
     timestamp?: string;
     uuid?: UUID;
-    session_id: string;
+    session_id?: string;
 };
 
 export declare type SDKUserMessageReplay = {
@@ -2751,6 +2888,10 @@ export declare interface Settings {
                  * Shell command to execute
                  */
                 command: string;
+                /**
+                 * 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;
                 /**
                  * Shell interpreter. 'bash' uses your $SHELL (bash/zsh/sh); 'powershell' uses pwsh. Defaults to bash.
                  */
@@ -2784,6 +2925,10 @@ export declare interface Settings {
                  * Prompt to evaluate with LLM. Use $ARGUMENTS placeholder for hook input JSON.
                  */
                 prompt: string;
+                /**
+                 * 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 prompt evaluation
                  */
@@ -2809,6 +2954,10 @@ export declare interface Settings {
                  * Prompt describing what to verify (e.g. "Verify that unit tests ran and passed."). Use $ARGUMENTS placeholder for hook input JSON.
                  */
                 prompt: string;
+                /**
+                 * 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 agent execution (default 60)
                  */
@@ -2834,6 +2983,10 @@ export declare interface Settings {
                  * URL to POST the hook input JSON to
                  */
                 url: string;
+                /**
+                 * 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 request
                  */
@@ -3885,7 +4038,7 @@ export declare interface SpawnOptions {
     signal: AbortSignal;
 }
 
-declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKStreamlinedTextMessage | coreTypes.SDKStreamlinedToolUseSummaryMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKStreamlinedTextMessage | coreTypes.SDKStreamlinedToolUseSummaryMessage | coreTypes.SDKPostTurnSummaryMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
 
 export declare type StopFailureHookInput = BaseHookInput & {
     hook_event_name: 'StopFailure';
@@ -3999,6 +4152,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;
+    alwaysLoad?: boolean;
 }): SdkMcpToolDefinition<Schema>;
 
 /**