@anthropic-ai/claude-agent-sdk 0.2.85 → 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.85",
-  "buildDate": "2026-03-26T21:00:08Z",
+  "version": "2.1.86",
+  "buildDate": "2026-03-27T20:34:42Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "bad5882c5fcd97e39f8c2f2b9a4c3fa3890d1a39eecaa94a16fd75d6701ad7b3",
-      "size": 196110320
+      "checksum": "76fafee995269784b1bf80b514c3b354394288fb794bed01ef20168874e088ea",
+      "size": 196638704
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "ab4ca23bca1c70a3e0bbfd8cde1ce8e0f768665988be1ddb7ecbb6a9f3b9fc78",
-      "size": 197604432
+      "checksum": "de96f6966648ecd93c345fab4b3be944e93ba4140f1cda7fe45ffed93133b67e",
+      "size": 198132816
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "b23709a394d1e3d977f9f3025bdaa1b1285715d10a48957e587952d8ef3a27f4",
-      "size": 227936832
+      "checksum": "c04aebe3de140679b4cce158812d6f011b7e9c483496ccb0472cf38cc1714afe",
+      "size": 228461120
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "ff0b23dba11c97a53386c61ebe47d46d768a8ad33f98c7d22186c9a63f179f4d",
-      "size": 227760768
+      "checksum": "adce02c5f94a85b6ca231c8aeef533707597cd387e8934776455b87d10a3051b",
+      "size": 228280960
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "c559f0e8855ec141c0dd672801936e55db630f077e5878b5b2de75062b065517",
-      "size": 221055424
+      "checksum": "ded1933ce0f2bb55156b397fa622ca2782caa48ed99ed117ee20481f638e0293",
+      "size": 221579712
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "a12200b8d23f5053fbf211291c0fdac413fc61b0e054c5dee159244d1a3fd927",
-      "size": 222386624
+      "checksum": "fb86c40f52a39c71393db93b9fa5f5c048be67c5a087a03e35e1e304c127c8c5",
+      "size": 222906816
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "4a336dc188dc44289c801a33ba1868fa2b2b39d345e9a3316327218048c91669",
-      "size": 237718176
+      "checksum": "9b9281621d0d5aa4aba3e3e9c5a6efdfe37a897fb9ba33a87e4562ec9df6453f",
+      "size": 238222496
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "9092664f15973a6946dbd874c3b7c6f83b25a2a1b46e04a76b9b2df4d8322d54",
-      "size": 234281632
+      "checksum": "4f6eaa82b5eefd79b1ed56d6d6ffa3229c508c974f51ae43b6c38f5e2fdafe5f",
+      "size": 234785440
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.85",
-  "buildDate": "2026-03-26T21:00:09Z",
+  "version": "2.1.86",
+  "buildDate": "2026-03-27T20:34:43Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "e89596d6a6186fa7f6cbb0f4d126f543cba1061ceb716df27d1de50288407259",
-      "size": 40615285,
+      "checksum": "fe4d250299ff4789e4c3a1172c97720c62fefed52496b66652325815fec58949",
+      "size": 40735714,
       "bundle": {
-        "checksum": "12ee8fd61eb7ac81ceea42f06f7e51f0c77283fcff980e2d6b33d894a94239f0",
-        "size": 40632487
+        "checksum": "0315d453553df95189f14ddfb15d7d0d9df97121673cc685bb3b1bdcfe0214fb",
+        "size": 40733484
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "6e4f4713f3bb4c05a5f1b501eb096674ee74006ab5219a4917d2ca0dcae38a3c",
-      "size": 42292192,
+      "checksum": "8b1ef96634369e58cd480276c030a55c39bd66cb33b703a5f35c818a922c4d69",
+      "size": 42395229,
       "bundle": {
-        "checksum": "58823769d33ff8125bc6e2dc8037dd4b398bdf84a36f2e160381045d295d8e4a",
-        "size": 42289250
+        "checksum": "4fe4d244397a50ccb33f2a3600cc342f0f6ec1731983c748ec6ebe8b57342488",
+        "size": 42396667
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "3242468aae4e828486780e4d22b13f38fd3a1e165c6c8eba99396d92a3766063",
-      "size": 50312754
+      "checksum": "480cf52b5380fb9013902fe893ec58553f848f34bd979788f20106ff0ee61b1b",
+      "size": 50420732
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "741f96194547c57df8da6b435f95c179211b23a852153fbf0dfc81cc44d29008",
-      "size": 50847081
+      "checksum": "0866db2a7ef4ccaad987f834639770299a9a740ed82a5cc53eb2db304e881986",
+      "size": 50935311
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "2b27848bf8ac75bea68d8afaae57c64ed04edbf6fdbd8a408ae7d50370166146",
-      "size": 48942238
+      "checksum": "05e6b45654b57c6cd26e80157c8112f0d24abfee053c0aa926b297ec608fcd78",
+      "size": 49030009
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "ff02aec645d1117963419bbbb5a0c4733f50a23ea6e92b062f4bb202f5ce271f",
-      "size": 49609940
+      "checksum": "5154b2d20634a180b6d7b4e74afcf87125663d6fe5ccfc0553a6a6dd6e7b17ab",
+      "size": 49670272
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "0723eb9b887b20bdefcf26bb6b84a597a59b616037649029b3ad325f82d9d851",
-      "size": 52493582
+      "checksum": "a231ea48462175772d5af60bb13b70ef1f0748f63e426edf05f0b50d88c70e6c",
+      "size": 52576784
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "6f69a560a2e9bf492ad3d75d5162bd10b1e440ba3c0ab57276898384a037f6c9",
-      "size": 50666606
+      "checksum": "d566cde2014177d00862b66dc971121cf4569e11f7763ce28e5f34132308cb73",
+      "size": 50754734
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.85",
+  "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.85"
+  "claudeCodeVersion": "2.1.86"
 }

package/sdk-tools.d.ts

@@ -218,6 +218,15 @@ export type FileReadOutput =
          */
         outputDir: string;
       };
+    }
+  | {
+      type: "file_unchanged";
+      file: {
+        /**
+         * The path to the file
+         */
+        filePath: string;
+      };
     };
 export type ListMcpResourcesOutput = {
   /**

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,13 @@ 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.
@@ -1615,6 +1622,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
 
 
 
+
     /**
      * Reconnect an MCP server by name.
      * Throws on failure.
@@ -1858,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.
  */
@@ -1990,7 +2098,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | 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;
+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';
@@ -2532,7 +2640,7 @@ export declare type SDKUserMessage = {
      */
     timestamp?: string;
     uuid?: UUID;
-    session_id: string;
+    session_id?: string;
 };
 
 export declare type SDKUserMessageReplay = {
@@ -4044,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>;
 
 /**