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

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.94",
-  "buildDate": "2026-04-07T20:31:15Z",
+  "version": "2.1.97",
+  "buildDate": "2026-04-08T20:52:51Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "cf1c5db5e87610eca1e8f06dc2b2a2a9c0c04c179c55c7e1fcdfc9a2c014b31c",
-      "size": 199397456
+      "checksum": "9104eba60ca82c590ababc5eee0d01f2dc5440d7cf2d668e4c48d6485e41cfeb",
+      "size": 199579088
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "e3d29d0febf982112e977b7d732adf3167f229521c8697e5253c90a6d2d4a332",
-      "size": 200870864
+      "checksum": "d6e6ee329dbf1cd0222cd710039086aab9621bc85d65d314adee421446dda08c",
+      "size": 201052496
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "b3524791b50b314b17dac9978cb9568fa2e11a46562ae6f798d0dac453a0604a",
-      "size": 231672384
+      "checksum": "85167cb721655fdd90b002012a28eca273c89dc2fd709be49afe2a7724c365a0",
+      "size": 231868992
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "7cbc939cb52e09d49fd82092061543d21100b04c321e19fecf06f087dc908667",
-      "size": 231434880
+      "checksum": "0d43fcd11d29206563eeef3a1f787f0615c21cd703cc91f3a180915fd5797ef6",
+      "size": 231615104
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "2ab810a4cecec5ca1d141cadd132afdfc4b49d214156e83d9317c69d1688dd73",
-      "size": 224790976
+      "checksum": "b0cfda67d7dbfadb37c0f2f8714a2694958f988e29785d5bcf00d6f3968ab611",
+      "size": 224987584
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "a841044e81d09b03b844cf231037430416befdc5e50c74df7d71d72c362db542",
-      "size": 225749440
+      "checksum": "ab1e66323397e1687ca6a074d471af44ba3cee7ac839632e6b3dbf55dfa75f0d",
+      "size": 225929664
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "08d0a5abf80510f1539d242214fdfe16f8b40866875f4ab44e8a5f86f2409aa4",
-      "size": 241112736
+      "checksum": "b678e7827fdcfcd9ac9b0eb7c7b1dda4f06b7ecbff4fd89c7fd22be3578f79ea",
+      "size": 241307296
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "1bc64b539ab98661305ffffe17a005d86d895da8be4de45895f371096d078ab2",
-      "size": 237823136
+      "checksum": "78db7edd6de917d733bdcb55560d0f8f7543666254ea3a66b05053a45c549f3b",
+      "size": 238017696
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.94",
-  "buildDate": "2026-04-07T20:31:16Z",
+  "version": "2.1.97",
+  "buildDate": "2026-04-08T20:52:52Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "369163ad5c903eec187d12b208275c0cc034b932efe124dbfa64d0703d07441d",
-      "size": 41242270,
+      "checksum": "6b837fd78aba5651f91837229160d314bb631f9417e15d06825b444ead5d820e",
+      "size": 41265456,
       "bundle": {
-        "checksum": "1540988376cc72774eb0f5b5451ddcdf2053794459c9ba6301c44e38e0a0cc48",
-        "size": 41246676
+        "checksum": "e181dd9d3ab1a3811fbcf2557e4050ffd8a65e5bd95f8fae9f84880794927d1a",
+        "size": 41269433
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "8255afacbf9d4d62d14aa8bafdab697a4e8e1458cbb4c6dc81e9533244d8f681",
-      "size": 42927007,
+      "checksum": "09402b9404720fbefdadd217a97a6bdb1adda727f7ce88b4ac6e83a8d34cdda5",
+      "size": 42909357,
       "bundle": {
-        "checksum": "5fbe707fd6b751ceebc1a8b8a51b42d8c94e9351abe498c8beff15eaa2384dbf",
-        "size": 42916836
+        "checksum": "fad27030988c9661f7aada299f385fd3ddccaa2b872b424e9038c7d552f00c15",
+        "size": 42903159
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "15a44c976954008731f8156fc558fd65a4e589ba1a742e6e7b1270c291fd6c79",
-      "size": 50915013
+      "checksum": "c279887ac0487995c2de36bc9671b1c8ac33e7e9491869b47f10b73a8bd3c7fb",
+      "size": 50940314
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "efd242158c50d2aee32c95ed17777a5ce83b56988b0cc4884252dad9e1e0067d",
-      "size": 51482748
+      "checksum": "828d7849d7da4c0bcd5d0f7bf1193ad4e1058b8a42ea2543630fff55272bc2c4",
+      "size": 51505208
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "fd8dc9488d570826dccbfbac2546ea3e2e2568b473e9db2e1dee2704400ab1d8",
-      "size": 49578715
+      "checksum": "4a1f5e67ab363ffc7a6983bf9f6b96a3441f75e4307340d8a5c48ee90c9c38b8",
+      "size": 49583713
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "beabe8b9f2108752964f616ff6395e9c0e9576d067c19b3dc64ed1639b80fec4",
-      "size": 50143733
+      "checksum": "4a6696cfeefc7f7dc5390847206169493180d71b7609c21dc5a285f303ba9e16",
+      "size": 50195927
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "98e3585e5b9b9d7c41ac1f0a22f77e9b0f53da4f06d45d5269939173e30e2d0d",
-      "size": 53117708
+      "checksum": "8e880cc9adc0bb1f380318421783aa40e4482429f76d232839d4ef0fcc95d34d",
+      "size": 53133673
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "6312426659d67d5d770101aa1346c53618af702e5848be2751405ab16a5304a7",
-      "size": 51266876
+      "checksum": "0ccbabbb66937a97002610508abade12d7d699879488bf2bc74fdd824bdf8f42",
+      "size": 51309267
     }
   }
 }

package/package.json

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

package/sdk-tools.d.ts

@@ -78,6 +78,15 @@ export type AgentOutput =
           ephemeral_5m_input_tokens: number;
         } | null;
       };
+      toolStats?: {
+        readCount: number;
+        searchCount: number;
+        bashCount: number;
+        editFileCount: number;
+        linesAdded: number;
+        linesRemoved: number;
+        otherToolCount: number;
+      };
       status: "completed";
       prompt: string;
     }
@@ -2262,7 +2271,7 @@ export interface FileEditOutput {
   /**
    * The original file contents before editing
    */
-  originalFile: string;
+  originalFile: string | null;
   /**
    * Diff patch showing the changes
    */

package/sdk.d.ts

@@ -1420,6 +1420,19 @@ export declare type Options = {
      * - `string` - Use a custom system prompt
      * - `{ type: 'preset', preset: 'claude_code' }` - Use Claude Code's default system prompt
      * - `{ type: 'preset', preset: 'claude_code', append: '...' }` - Use default prompt with appended instructions
+     * - `{ type: 'preset', preset: 'claude_code', excludeDynamicSections: true }` -
+     *   Strip per-user dynamic sections (working directory, auto-memory, git
+     *   status) from the system prompt so it stays static and cacheable across
+     *   users. The stripped content is re-injected as the first user message so
+     *   the model still has access to it.
+     *
+     *   Use this when many users in your fleet share the same system prompt and
+     *   you want the prompt-caching prefix to hit cross-user. Tradeoffs:
+     *   - The working-directory, memory-path, and git-status context is
+     *     marginally less authoritative for steering the model (it appears in
+     *     a user message instead of the system prompt).
+     *   - The first user message becomes slightly larger.
+     *   - Has no effect when `systemPrompt` is a string (custom prompt).
      *
      * @example Custom prompt
      * ```typescript
@@ -1434,11 +1447,21 @@ export declare type Options = {
      *   append: 'Always explain your reasoning.'
      * }
      * ```
+     *
+     * @example Cacheable prompt for multi-user fleets
+     * ```typescript
+     * systemPrompt: {
+     *   type: 'preset',
+     *   preset: 'claude_code',
+     *   excludeDynamicSections: true,
+     * }
+     * ```
      */
     systemPrompt?: string | {
         type: 'preset';
         preset: 'claude_code';
         append?: string;
+        excludeDynamicSections?: boolean;
     };
     /**
      * Custom function to spawn the Claude Code process.
@@ -1903,6 +1926,7 @@ declare const SandboxNetworkConfigSchema: () => z.ZodOptional<z.ZodObject<{
     allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString>>;
     allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
     allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
+    allowMachLookup: z.ZodOptional<z.ZodArray<z.ZodString>>;
     httpProxyPort: z.ZodOptional<z.ZodNumber>;
     socksProxyPort: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
@@ -1923,6 +1947,7 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
         allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString>>;
         allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
         allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
+        allowMachLookup: z.ZodOptional<z.ZodArray<z.ZodString>>;
         httpProxyPort: z.ZodOptional<z.ZodNumber>;
         socksProxyPort: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -2130,6 +2155,7 @@ export declare type SDKControlGetContextUsageResponse = {
         attachmentTokens: number;
         assistantMessageTokens: number;
         userMessageTokens: number;
+        redirectedContextTokens: number;
         toolCallsByType: {
             name: string;
             callTokens: number;
@@ -2165,6 +2191,10 @@ 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.
+     */
+    excludeDynamicSections?: boolean;
     agents?: Record<string, coreTypes.AgentDefinition>;
     promptSuggestions?: boolean;
     agentProgressSummaries?: boolean;
@@ -3278,6 +3308,10 @@ export declare interface Settings {
         type: 'command';
         command: string;
         padding?: number;
+        /**
+         * Re-run the status line command every N seconds in addition to event-driven updates
+         */
+        refreshInterval?: number;
     };
     /**
      * Enabled plugins using plugin-id\@marketplace-id format. Example: { "formatter\@anthropic-tools": true }. Also supports extended format with version constraints.
@@ -3898,6 +3932,10 @@ export declare interface Settings {
      * Controls the output style for assistant responses
      */
     outputStyle?: string;
+    /**
+     * Default transcript view mode on startup
+     */
+    viewMode?: 'default' | 'verbose' | 'focus';
     /**
      * Preferred language for Claude responses and voice dictation (e.g., "japanese", "spanish")
      */
@@ -3932,6 +3970,10 @@ export declare interface Settings {
              */
             allowAllUnixSockets?: boolean;
             allowLocalBinding?: boolean;
+            /**
+             * macOS only: Additional XPC/Mach service names to allow looking up. Supports trailing-wildcard prefix matching (e.g., "com.apple.coresimulator.*"). Needed for tools that communicate via XPC such as the iOS Simulator or Playwright.
+             */
+            allowMachLookup?: string[];
             httpProxyPort?: number;
             socksProxyPort?: number;
         };
@@ -4270,7 +4312,7 @@ export declare interface SpawnOptions {
     signal: AbortSignal;
 }
 
-declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
 
 export declare type StopFailureHookInput = BaseHookInput & {
     hook_event_name: 'StopFailure';