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

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.96",
-  "buildDate": "2026-04-08T03:19:21Z",
+  "version": "2.1.97",
+  "buildDate": "2026-04-08T20:52:51Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "31bad8c237dd561566620595227a734d9736c979a7ddb52c6c65d9ef93b300e3",
-      "size": 199397456
+      "checksum": "9104eba60ca82c590ababc5eee0d01f2dc5440d7cf2d668e4c48d6485e41cfeb",
+      "size": 199579088
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "666aad5da68e8623b31834e65ae6a14144c45af538c7329df228a95ce99a3349",
-      "size": 200887376
+      "checksum": "d6e6ee329dbf1cd0222cd710039086aab9621bc85d65d314adee421446dda08c",
+      "size": 201052496
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "c8876673205945df1bcb33415827d169785b22ac10150cfaf3a7f5e2d58bf08e",
-      "size": 231672384
+      "checksum": "85167cb721655fdd90b002012a28eca273c89dc2fd709be49afe2a7724c365a0",
+      "size": 231868992
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "9bcad6249b4e9c1a4db52430e2834f14b59349c87de0ecb0b9278cf1f4a20534",
-      "size": 231438976
+      "checksum": "0d43fcd11d29206563eeef3a1f787f0615c21cd703cc91f3a180915fd5797ef6",
+      "size": 231615104
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "2b885b783e135aba182bd6d8c2ba8a1f7d985ff28b37f73d493c014fb02638cb",
-      "size": 224790976
+      "checksum": "b0cfda67d7dbfadb37c0f2f8714a2694958f988e29785d5bcf00d6f3968ab611",
+      "size": 224987584
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "bee422fc8edf4092f00808393829673dd5d1931bfb85e85229e31ba6e5d50a97",
-      "size": 225753536
+      "checksum": "ab1e66323397e1687ca6a074d471af44ba3cee7ac839632e6b3dbf55dfa75f0d",
+      "size": 225929664
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "76bdd00a6bf3df3059987e5b3a29c09e6ab773201d17a2ac1d4a29884c3a17c8",
-      "size": 241115296
+      "checksum": "b678e7827fdcfcd9ac9b0eb7c7b1dda4f06b7ecbff4fd89c7fd22be3578f79ea",
+      "size": 241307296
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "6ce3005f5c7cf3a30227995c681b7dc50f0ef28e2ba29eaf263f56d09e81ed66",
-      "size": 237825696
+      "checksum": "78db7edd6de917d733bdcb55560d0f8f7543666254ea3a66b05053a45c549f3b",
+      "size": 238017696
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.96",
-  "buildDate": "2026-04-08T03:19:22Z",
+  "version": "2.1.97",
+  "buildDate": "2026-04-08T20:52:52Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "c74c3b13227c6fbf90ca2d2651e4a988b18bae4a3ab1768bc7f93214347c745d",
-      "size": 41255366,
+      "checksum": "6b837fd78aba5651f91837229160d314bb631f9417e15d06825b444ead5d820e",
+      "size": 41265456,
       "bundle": {
-        "checksum": "e69b3c02097657e59f1f9b76680023d05252fcb6f2f863055783008bedc9a706",
-        "size": 41258108
+        "checksum": "e181dd9d3ab1a3811fbcf2557e4050ffd8a65e5bd95f8fae9f84880794927d1a",
+        "size": 41269433
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "0c060b29ccce65de3add81ec78fed1543602dfd78b79e003fb9a6f35a056df13",
-      "size": 42916033,
+      "checksum": "09402b9404720fbefdadd217a97a6bdb1adda727f7ce88b4ac6e83a8d34cdda5",
+      "size": 42909357,
       "bundle": {
-        "checksum": "33aa5e5c47b879c022b99dd407a2531f8442386179358d305fd39c7bffc2d0eb",
-        "size": 42920527
+        "checksum": "fad27030988c9661f7aada299f385fd3ddccaa2b872b424e9038c7d552f00c15",
+        "size": 42903159
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "118ee4b04ee04751d54fb8d8809c7ce1ce8682737d9bef1c925671502c83c810",
-      "size": 50886938
+      "checksum": "c279887ac0487995c2de36bc9671b1c8ac33e7e9491869b47f10b73a8bd3c7fb",
+      "size": 50940314
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "ea7c305616209627a1622e7b88d017e5db1902e352fa9e9d53c66b89c7a6ca9a",
-      "size": 51462888
+      "checksum": "828d7849d7da4c0bcd5d0f7bf1193ad4e1058b8a42ea2543630fff55272bc2c4",
+      "size": 51505208
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "a14c4ceaabce0e81a32e680bbc5c0d89ca1d24240edaa826985639ba78b63e58",
-      "size": 49565315
+      "checksum": "4a1f5e67ab363ffc7a6983bf9f6b96a3441f75e4307340d8a5c48ee90c9c38b8",
+      "size": 49583713
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "1da4260a8ea89f3667f8183eb40a4ebd20a4f77a2252939915218f6ac89706d6",
-      "size": 50137864
+      "checksum": "4a6696cfeefc7f7dc5390847206169493180d71b7609c21dc5a285f303ba9e16",
+      "size": 50195927
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "a2409bfa25d04c0ce514019bbe859352acc0132cb6fb2e5b5eb83f85e3330136",
-      "size": 53125331
+      "checksum": "8e880cc9adc0bb1f380318421783aa40e4482429f76d232839d4ef0fcc95d34d",
+      "size": 53133673
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "4fa17572d34c4445ab5e017c14c0e907b98cdc7eb23679f169f8cc98f32005e6",
-      "size": 51284762
+      "checksum": "0ccbabbb66937a97002610508abade12d7d699879488bf2bc74fdd824bdf8f42",
+      "size": 51309267
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.96",
+  "version": "0.2.97",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -90,5 +90,5 @@
     "vendor/ripgrep/",
     "vendor/audio-capture/"
   ],
-  "claudeCodeVersion": "2.1.96"
+  "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';