@anthropic-ai/claude-agent-sdk 0.3.144 → 0.3.146

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.144",
-  "commit": "32281b6b930f7e2ab4f0b5e2494e263b9c1ffb7e",
-  "buildDate": "2026-05-18T18:52:18Z",
+  "version": "2.1.146",
+  "commit": "c900a8c71aa966a1a8bf14c49139d87fac9ae881",
+  "buildDate": "2026-05-20T01:57:57Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "9886baa4ec4c455f86108464f121732193ee76e5dfceb031005f59f31276a5df",
-      "size": 207919008
+      "checksum": "b16f466a2213a04cecf1ad958201655148a49f42952134e6ae182257ccfc08f3",
+      "size": 211056288
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "d225c07b713615ceda54cebcfb6280942b113c64dccbaa114b12204e917087f8",
-      "size": 210433168
+      "checksum": "6bc14f45e28ea6c8c34220c88327bb72a38c5f978b9aa44d0cb34375cbf78837",
+      "size": 213570448
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "c8ccccbfce12d684588bd3af366394132f614dcf3c86beb2066f86bde2704513",
-      "size": 233289352
+      "checksum": "af25334c7a2632a531b34e3f4c0d69763b997149d31d5f0d748e44813758806f",
+      "size": 236435080
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "147480774472e5720fd5e83617b3e9299344e7213efa84c326b25bd5a0f20b4e",
-      "size": 233404112
+      "checksum": "825d5301380f1f5f466c5268de25a062927be658938fc1d630cfa02c521b8185",
+      "size": 236512976
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "68a92c68f18cd25676259b12cd799ddf1e8bdac24f927ac50defd8be26a1448d",
-      "size": 226144088
+      "checksum": "256703637576ef323b8f87695b81e65a7bdc66327f1512dacc9257b7896e7a0f",
+      "size": 229289816
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "f1f736eb04632ce3f720e04a67ba0209d55726cb88e8e23f6f33b8cd6481b6ca",
-      "size": 227798064
+      "checksum": "e8ab94b1ffb9d9213134d4addfe5d3fe6fd10c524aa2927667e543ac165a7242",
+      "size": 230906928
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "ae150c7d6100e14c67efc90c2b55e0db9cdbcef2b2c7b3cb56998331182e3d2f",
-      "size": 229302432
+      "checksum": "b585bbaf085554757b627e5ed87aa5c153abb90ef408fb43b0311453b72e8bc2",
+      "size": 232326816
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "2871ae906ed83f826ce9fa721ec82418c15315e11ab3cb3fe821f3c056fcff4d",
-      "size": 225266848
+      "checksum": "159488363d937bbac11c55364246513f677e94e681d7431e1622336250091c00",
+      "size": 228292256
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.144",
-  "commit": "32281b6b930f7e2ab4f0b5e2494e263b9c1ffb7e",
-  "buildDate": "2026-05-18T18:59:24Z",
+  "version": "2.1.146",
+  "commit": "c900a8c71aa966a1a8bf14c49139d87fac9ae881",
+  "buildDate": "2026-05-20T02:05:27Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "ee45631e54620b1493a186c3f68737a586bb9743e8bedd7d40d663ef1488ef72",
-      "size": 43055466,
+      "checksum": "36a21463866a850a146ea03a506123424d9ea6a5b8f105b83993466e6c626d98",
+      "size": 43693790,
       "bundle": {
-        "checksum": "ca17f3dffb8230ec6ccedf35bec149e9ab3a616509d2bc55ae90ed84f88d13e3",
-        "size": 43067561
+        "checksum": "d388a11849a8f2576733c572ce55bd4fea25d465b36af4efd85f3e510121d87c",
+        "size": 43694485
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "d4023e18885bda3f0edea593cabe97f1d71912b8f3d1daeebb28551fdca2ccb1",
-      "size": 44977785,
+      "checksum": "d50073947f829a3d1cb7a21efff4f035bd6938852ac7b8c30c4aeacac8830329",
+      "size": 45615774,
       "bundle": {
-        "checksum": "0c04c6b629f308b19e1f4048c37fd6705c8e75c236e8f9350b8b20449f06eb1a",
-        "size": 44989436
+        "checksum": "29c340be5c3255da0cf0f1af126c461a51251d0d6defce7e764ecc5fdb0d884d",
+        "size": 45619469
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "9e1043902191323aa6e2798d6810028241d8ca166d52133e0565a1cb9b3e2f58",
-      "size": 50842663
+      "checksum": "84bd9dd9e85cacaec55dcfd28ec49e05131c3cc0244d906804559cb73cb731e6",
+      "size": 51446658
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "11faccc6f4fc49184d8e4a847eb2feb7cda225722395f47cd6b61a93751f3edc",
-      "size": 51470721
+      "checksum": "8c6c61ca6fc7fafb4936de6a40815bf5d440ddedb477800510f2a2cf7a1595dc",
+      "size": 52071854
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "f9c4091a1ba8664c20c1e6f77e99a5a76e772e2a1ca5bf217f88567fbb29fb0e",
-      "size": 49480624
+      "checksum": "ecd65f1abe5a6b889f81f9e28a572d3e7186dac90ce9fb1deaf8cc97bb33e5a4",
+      "size": 50095507
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "4a9a7daa9ff2e36e476196ecc07c305c3e68f36af5dad1a0decdd158525ff204",
-      "size": 50191473
+      "checksum": "23a02176f38c45ce93440ee4aea6009d614fb7020ce98bb95fe034c1c0d27701",
+      "size": 50779496
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "09ace0211e4eb689df96fca870421a7674ffb15876f1fdb8f887e397141778d1",
-      "size": 52206852
+      "checksum": "5d0cf87f8a331f98397f8a5608e77d5e453ae02c8ee4f6774d91a0755f9e7570",
+      "size": 52800733
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "c061d3098ee1a261375347ffd2350d64d2b8a23a220b68ce3214ebe679395434",
-      "size": 50477031
+      "checksum": "efebea1875409013c62dfe783d6c24590ca7944e69ff33f08ad9a3e169bdddcd",
+      "size": 51081079
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.144",
+  "version": "0.3.146",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -61,14 +61,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.144",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.144"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.146",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.146"
   },
   "files": [
     "sdk.mjs",
@@ -86,5 +86,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.144"
+  "claudeCodeVersion": "2.1.146"
 }

package/sdk-tools.d.ts

@@ -143,6 +143,10 @@ export type FileReadOutput =
          * Total number of lines in the file
          */
         totalLines: number;
+        /**
+         * True when a whole-file read was auto-paginated because it exceeded the token cap (the content is a partial first page). A programmatic signal for internal consumers; survives output reconstruction (unlike the render-time banner).
+         */
+        truncatedByTokenCap?: boolean;
       };
     }
   | {
@@ -310,7 +314,7 @@ export interface AgentInput {
   /**
    * Permission mode for spawned teammate (e.g., "plan" to require plan approval).
    */
-  mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+  mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | "bubble";
   /**
    * Isolation mode. "worktree" creates a temporary git worktree so the agent works on an isolated copy of the repo.
    */

package/sdk.d.ts

@@ -120,6 +120,39 @@ export declare type AsyncHookJSONOutput = {
     asyncTimeout?: number;
 };
 
+export declare type BackgroundTaskSummary = {
+    id: string;
+    /**
+     * Friendly task-type label (e.g. 'shell', 'subagent', 'monitor', 'workflow'). Falls back to the raw discriminant for unknown types.
+     */
+    type: string;
+    status: string;
+    /**
+     * Free-text description. Capped at 1000 chars; clipped values append an in-string "… [+N chars]" marker.
+     */
+    description: string;
+    /**
+     * Shell command line. Only present for 'shell' tasks. Capped at 1000 chars with the same "… [+N chars]" marker.
+     */
+    command?: string;
+    /**
+     * Subagent type name. Only present for 'subagent' tasks.
+     */
+    agent_type?: string;
+    /**
+     * MCP server name. Only present for 'monitor' / 'MCP task' tasks.
+     */
+    server?: string;
+    /**
+     * MCP tool name. Only present for 'monitor' / 'MCP task' tasks.
+     */
+    tool?: string;
+    /**
+     * Workflow name. Only present for 'workflow' tasks.
+     */
+    name?: string;
+};
+
 export declare type BaseHookInput = {
     session_id: string;
     transcript_path: string;
@@ -286,6 +319,7 @@ declare namespace coreTypes {
         AgentMcpServerSpec,
         ApiKeySource,
         AsyncHookJSONOutput,
+        BackgroundTaskSummary,
         BaseHookInput,
         BaseOutputFormat,
         ConfigChangeHookInput,
@@ -388,6 +422,7 @@ declare namespace coreTypes {
         SDKUserMessage,
         SdkBeta,
         SdkPluginConfig,
+        SessionCronSummary,
         SessionEndHookInput,
         SessionStartHookInput,
         SessionStartHookSpecificOutput,
@@ -430,6 +465,13 @@ export declare function createSdkMcpServer(_options: CreateSdkMcpServerOptions):
 declare type CreateSdkMcpServerOptions = {
     name: string;
     version?: string;
+    /**
+     * Server instructions returned from `initialize` and surfaced to the model
+     * as an MCP instructions block. When proxying a real MCP server through the
+     * SDK transport, pass the underlying server's `getInstructions()` here so
+     * it isn't dropped.
+     */
+    instructions?: string;
     tools?: Array<SdkMcpToolDefinition<any>>;
     /**
      * When true, all tools from this server are always included in the prompt
@@ -1563,6 +1605,7 @@ export declare type Options = {
 
 
 
+
     /**
      * Enable prompt suggestions. When true, the agent emits a `prompt_suggestion`
      * message after each turn with a predicted next user prompt.
@@ -1828,6 +1871,9 @@ export declare type Options = {
      * spawnClaudeCodeProcess: (options) => {
      *   // Custom spawn logic for VM execution
      *   // options contains: command, args, cwd, env, signal
+     *   // `signal` is forwarded — it aborts only AFTER the SDK's
+     *   // stdin-EOF + ~2 s grace window, so passing it to spawn()/your
+     *   // VM API is safe (force-kill fires after the graceful chance).
      *   return myVMProcess; // Must satisfy SpawnedProcess interface
      * }
      * ```
@@ -2939,7 +2985,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
 
 /**
  * Requests the SDK consumer to render a tool-driven blocking dialog and return the user choice. Used by tools that previously rendered Ink JSX via setToolJSX with an onDone callback.
@@ -3654,6 +3700,22 @@ export declare type SDKUserMessageReplay = {
     file_attachments?: unknown[];
 };
 
+export declare type SessionCronSummary = {
+    id: string;
+    /**
+     * Cron expression, e.g. "0 9 * * 1-5".
+     */
+    schedule: string;
+    /**
+     * False for one-shot wakeups whose cron field encodes a single fire time; true for tasks that re-fire on every match.
+     */
+    recurring: boolean;
+    /**
+     * Prompt text submitted when the cron fires. Capped at 1000 chars; clipped values append an in-string "… [+N chars]" marker.
+     */
+    prompt: string;
+};
+
 export declare type SessionEndHookInput = BaseHookInput & {
     hook_event_name: 'SessionEnd';
     reason: ExitReason;
@@ -5439,7 +5501,28 @@ export declare interface SpawnOptions {
     env: {
         [envVar: string]: string | undefined;
     };
-    /** Abort signal for cancellation */
+    /**
+     * Abort signal for cancellation.
+     *
+     * This is a **forwarded** signal owned by `ProcessTransport`, not the
+     * caller's `Options.abortController.signal` directly. It aborts only
+     * after the SDK's graceful-close path has run: stdin EOF →
+     * `GRACEFUL_EXIT_TIMEOUT_MS` (~2 s) grace window. Anything you hang on
+     * it (Node `spawn({signal})` → `child.kill()`, VM/container teardown,
+     * fetch cancellation) fires **after** the child has had a chance to
+     * shut down cleanly via stdin close.
+     *
+     * Why: passing the caller's raw signal to Node `spawn()` registers
+     * Node's own abort listener that calls `child.kill()` — on Windows
+     * that's `TerminateProcess` (instant, uncatchable), and AbortSignal
+     * listeners fire synchronously in registration order, so it would race
+     * ahead of the SDK's stdin-EOF + grace path and the CLI's
+     * `gracefulShutdown` would never run.
+     *
+     * If you need the caller's *immediate* signal (no grace), it's the
+     * `AbortController` you passed to `Options.abortController` — capture
+     * it in closure.
+     */
     signal: AbortSignal;
 }
 
@@ -5468,6 +5551,14 @@ 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;
+    /**
+     * In-flight background work (running/pending + backgrounded) registered in this session. Lets hooks distinguish "session is done" from "session is paused waiting for background work to wake it". Empty array when nothing is in flight.
+     */
+    background_tasks?: BackgroundTaskSummary[];
+    /**
+     * Session-scoped cron tasks (CronCreate, ScheduleWakeup, /loop) that will wake this session later. Empty array when none are scheduled.
+     */
+    session_crons?: SessionCronSummary[];
 
 
 };
@@ -5493,6 +5584,14 @@ 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;
+    /**
+     * In-flight background work (running/pending + backgrounded) registered in this session. Lets hooks distinguish "session is done" from "session is paused waiting for background work to wake it". Empty array when nothing is in flight.
+     */
+    background_tasks?: BackgroundTaskSummary[];
+    /**
+     * Session-scoped cron tasks (CronCreate, ScheduleWakeup, /loop) that will wake this session later. Empty array when none are scheduled.
+     */
+    session_crons?: SessionCronSummary[];
 
 
 };