@anthropic-ai/claude-agent-sdk 0.3.209 → 0.3.211

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.209",
-  "commit": "0fe048596fd45e79e99353cbe2c3d1b1ac069568",
-  "buildDate": "2026-07-14T03:58:29Z",
+  "version": "2.1.211",
+  "commit": "17a4b6d7b2ee1936b95e595054c7e7d38fddafb7",
+  "buildDate": "2026-07-15T16:42:49Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "59d2de7f49db2f75d5c33bbb46a6b8f288ad24d40b61e30602a502bb7ddc380c",
-      "size": 240377264
+      "checksum": "5a728a76198b6eca7f3c7cdbff43bab44b77b48c2108f7a3107d889773382629",
+      "size": 242445680
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "4cc3f44b905d45bd27a6db9306ec6de928aea758537205329851ae478f2fa2c6",
-      "size": 249886224
+      "checksum": "33049eb14cf4702b992b7eda41ec077fc6e76539f7fd046e6d32538757235da4",
+      "size": 251966736
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "278cb68ef7217cfcc5c949d2573bb8e59a8b1305f76689fba88eb722b0d9e2f0",
-      "size": 256817904
+      "checksum": "1fff7e8f947c07b19d10b1fbf714b7e547e9536253b9b58230d8adbc4624f867",
+      "size": 258849520
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "b882f4b8b27772f897540df50f24000206f43a9426e8f7d19bd065959b69e9dd",
-      "size": 259951416
+      "checksum": "8272c8a474ac9ea1bc35f19b9f7c7e7dc4dc4eb6d5ad3e484b19335ac72446b2",
+      "size": 262023992
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "d5785d7c25f86a00ba5d5fe81d98726c89ea7d6f45dca90fcc4cbabef6a9e0b5",
-      "size": 250066104
+      "checksum": "ca094a85ea464b2ebec2ecfcc9e2c056573d4ca95ebe12ffae2c7dccb722e17b",
+      "size": 252097720
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "7ad8e7d428e1ddef18040fe43f54110541ced063a7b5903091aac8f45c57ee21",
-      "size": 254607744
+      "checksum": "c99bd7934ac841d5be6ee7d3644cb63bccef2cd495c6c1bb982a1b1deac1b466",
+      "size": 256680320
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "b9d5e8542338a0918534e55d046a7c960ae4af5ee214c7e4e80a89067b63ea2c",
-      "size": 251303072
+      "checksum": "3d8509ae7de11d77dbdc711aa320fc6d5064ce795464a8670696611b57093caf",
+      "size": 253293728
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "a29607da80ac0d6f2620553e52026ecc7744b27d49128f143eacd120e5f2ad9d",
-      "size": 245652640
+      "checksum": "a0f9bab0dbdda9b43a8765d54e329e44484d9dd7d4f40cf31db6eee27a2da41c",
+      "size": 247643808
     }
   },
   "sdkCompat": {
@@ -63,7 +63,8 @@
       "0.3.204",
       "0.3.205",
       "0.3.207",
-      "0.3.208"
+      "0.3.208",
+      "0.3.209"
     ],
     "harnessSchema": 1
   }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.209",
-  "commit": "0fe048596fd45e79e99353cbe2c3d1b1ac069568",
-  "buildDate": "2026-07-14T04:00:20Z",
+  "version": "2.1.211",
+  "commit": "17a4b6d7b2ee1936b95e595054c7e7d38fddafb7",
+  "buildDate": "2026-07-15T16:44:23Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "d50df0bdfb3b82edcfe15f806d6d9868f8415252f1ffbef869e4b15a7fcf010e",
-      "size": 49588566,
+      "checksum": "96e6bc497e39cecdb63ac449f26d3eca54870e1d73fe4664c816f5e38440112e",
+      "size": 49913141,
       "bundle": {
-        "checksum": "7edd81deea86886ece5495827f35dfcb20164d675ae96ad35a0bce0edc1d16a9",
-        "size": 49595200
+        "checksum": "6d0cabcaee7f2fdc7c37a14eacd5cffaafaf6fb16d59225c464de426d4634bb4",
+        "size": 49917482
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "9972a35b2ae680fd32ee0753544c5cf539a602b40377afef8236b92ca2e9638f",
-      "size": 54034985,
+      "checksum": "bec7a90b476f28af6d572f07dc553b75bd31215ef13ac470fec30e23636444ee",
+      "size": 54366611,
       "bundle": {
-        "checksum": "e520167d258bf78be789496b1cbfae3d29be51d0eb1b774be2efdd26eaad357f",
-        "size": 54038405
+        "checksum": "d97f221e917e337911e2b6b0897b22fd2361428627b6e0324e0561218858c6d4",
+        "size": 54363292
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "6935096382fad17a819365364a3dadbc179ee1cc2251a50ae3f91b8a79561fa9",
-      "size": 58650439
+      "checksum": "d9c04a9c1ce0e795c9e6de00bb77415fcdd291d2c9e2ef26f9c6d86cb666ddf3",
+      "size": 58963439
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "c490ee9f257a758ba7af399813c2bbc2f0ab612e3d3290dd5bda7c1b206953a0",
-      "size": 59963378
+      "checksum": "f90ff81999ed7d0b509db2a750d1f148d4814eef44cea68ed99c315b02672b6c",
+      "size": 60275709
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "6c123cacac657c87f615cd72de6b98b2f78f8be3337d6e33e5f4536b79e56784",
-      "size": 57364599
+      "checksum": "4435a40b0ec723721a4f974d0afc26877576228ba40368f51f6ae7ef08221dac",
+      "size": 57686071
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "37e6daf37dd6cd26c552b8f0062fb4d6e7a55d575db1e518f936b2a51e569e78",
-      "size": 58758705
+      "checksum": "1b10c1ff37f4aa689c0d87ab929e01b4ecc945f9434767f0ec3b125e217863e3",
+      "size": 59054974
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "d94f36d4465b18948ef36530f9e940fcc8adda22f4c996dd5de09bbe63c9d3e4",
-      "size": 60328620
+      "checksum": "34f136939b7df0a1eca476f58ec8ba00621926963a76f1db8aa132b21042fe2b",
+      "size": 60660958
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "1a3919d021b8cb36f0732fcf55a6b4fd53b6a9ef2a6b4f0e6476be67115ddf1f",
-      "size": 58315564
+      "checksum": "c923a9f914d8667443e8f4ba9ae09c6a674dd0c27f3360cdf0082c9fa28259b3",
+      "size": 58633026
     }
   },
   "sdkCompat": {
@@ -71,7 +71,8 @@
       "0.3.204",
       "0.3.205",
       "0.3.207",
-      "0.3.208"
+      "0.3.208",
+      "0.3.209"
     ],
     "harnessSchema": 1
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.209",
+  "version": "0.3.211",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -57,14 +57,14 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.209",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.209"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.211",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.211"
   },
   "files": [
     "sdk.mjs",
@@ -80,5 +80,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.209"
+  "claudeCodeVersion": "2.1.211"
 }

package/sdk-tools.d.ts

@@ -20,6 +20,7 @@ export type ToolInputSchemas =
   | GrepInput
   | TaskStopInput
   | ListMcpResourcesInput
+  | RefreshMcpToolsInput
   | McpInput
   | NotebookEditInput
   | ReadMcpResourceDirInput
@@ -61,6 +62,7 @@ export type ToolOutputSchemas =
   | GrepOutput
   | TaskStopOutput
   | ListMcpResourcesOutput
+  | RefreshMcpToolsOutput
   | McpOutput
   | NotebookEditOutput
   | ReadMcpResourceDirOutput
@@ -341,6 +343,32 @@ export type ListMcpResourcesOutput = {
    */
   server: string;
 }[];
+export type RefreshMcpToolsOutput = {
+  /**
+   * Server name
+   */
+  server: string;
+  /**
+   * refreshed: tool list re-queried and applied. error: the re-query failed and the previous tool set was kept. not_connected: the server has no live connection to query (this tool never dials).
+   */
+  status: "refreshed" | "error" | "not_connected";
+  /**
+   * Number of tools now available from this server
+   */
+  toolCount?: number;
+  /**
+   * Tool names this refresh added
+   */
+  added?: string[];
+  /**
+   * Tool names this refresh removed
+   */
+  removed?: string[];
+  /**
+   * Why the refresh failed or the server was unavailable
+   */
+  error?: string;
+}[];
 /**
  * MCP tool execution result
  */
@@ -375,8 +403,10 @@ export type ArtifactOutput =
         title: string;
         url: string;
         updatedAt?: string;
+        rel?: "mine" | "shared";
       }[];
       truncated?: boolean;
+      scope?: "shared" | "all";
     };
 export type ProjectsOutput =
   | {
@@ -675,6 +705,12 @@ export interface ListMcpResourcesInput {
    */
   server?: string;
 }
+export interface RefreshMcpToolsInput {
+  /**
+   * Optional server name: refresh only this server. Omit to refresh all connected servers.
+   */
+  server?: string;
+}
 export interface McpInput {
   [k: string]: unknown;
 }
@@ -2609,11 +2645,11 @@ export interface MonitorInput {
 }
 export interface ArtifactInput {
   /**
-   * Omit (or 'publish') to publish file_path. 'list' enumerates the user's published artifacts; only `limit` may accompany it.
+   * Omit (or 'publish') to publish file_path. 'list' enumerates artifacts — the user's own by default, see `scope`; only `limit` and `scope` may accompany it.
    */
   action?: "publish" | "list";
   /**
-   * Path to an .html or .md file to render. Required to publish (the default action). Use a short, distinctive basename — it is the fallback title if the HTML has no <title>.
+   * Path to an .html or .md file to render. Required to publish (the default action). Use a short, distinctive basename — it is the last-resort title when the HTML has no <title> and no `title` parameter is given.
    */
   file_path?: string;
   /**
@@ -2624,6 +2660,14 @@ export interface ArtifactInput {
    * list only: maximum artifacts to return (default 25).
    */
   limit?: number;
+  /**
+   * list only: 'mine' (default) lists artifacts the user owns — the only ones the update flow can target; 'shared' lists artifacts other people shared with the user (read-only); 'all' lists both. Rows are labeled (mine)/(shared) whenever scope is not 'mine'.
+   */
+  scope?: "mine" | "shared" | "all";
+  /**
+   * Title for the artifact — the name shown in the browser tab and gallery. Prefer a <title> tag in the HTML itself; this parameter fills in only when the file lacks one and never overrides the tag. HTML publishes only — Markdown pages keep their filename identity. Content always comes from file_path — there is no inline content parameter.
+   */
+  title?: string;
   /**
    * One-sentence subtitle shown on the gallery card. Say what the page is or does.
    */
@@ -2697,6 +2741,14 @@ export interface BashOutput {
    * True if the user manually backgrounded the command with Ctrl+B
    */
   backgroundedByUser?: boolean;
+  /**
+   * Set when the command hit its timeout and was auto-backgrounded; the timeout value in ms
+   */
+  timedOutAfterMs?: number;
+  /**
+   * Model-facing note that the session cwd was not changed by a backgrounded command containing a directory-change builtin (cd/pushd/popd/chdir)
+   */
+  backgroundCwdHint?: string;
   /**
    * Flag to indicate if sandbox mode was overridden
    */
@@ -2913,6 +2965,7 @@ export interface GrepOutput {
   numLines?: number;
   numMatches?: number;
   totalFiles?: number;
+  totalLines?: number;
   appliedLimit?: number;
   appliedOffset?: number;
 }

package/sdk.d.ts

@@ -1463,7 +1463,7 @@ export declare type Options = {
      * Enable beta features. Currently supported:
      * - `'context-1m-2025-08-07'` - Enable 1M token context window (Sonnet 4/4.5 only)
      *
-     * @see https://docs.anthropic.com/en/api/beta-headers
+     * @see https://platform.claude.com/docs/en/api/beta-headers
      */
     betas?: SdkBeta[];
     /**
@@ -1607,7 +1607,7 @@ export declare type Options = {
      *
      * When set, takes precedence over the deprecated `maxThinkingTokens`.
      *
-     * @see https://docs.anthropic.com/en/docs/build-with-claude/adaptive-thinking
+     * @see https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking
      */
     thinking?: ThinkingConfig;
     /**
@@ -1620,7 +1620,7 @@ export declare type Options = {
      * - `'xhigh'` — Deeper than high (Fable 5, Opus 4.7+, Sonnet 5)
      * - `'max'` — Maximum effort (Fable 5, Opus 4.6+, Sonnet 4.6+)
      *
-     * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
+     * @see https://platform.claude.com/docs/en/build-with-claude/effort
      */
     effort?: EffortLevel;
     /**
@@ -1813,7 +1813,7 @@ export declare type Options = {
      * }
      * ```
      *
-     * @see https://docs.anthropic.com/en/docs/claude-code/settings#sandbox-settings
+     * @see https://code.claude.com/docs/en/settings#sandbox-settings
      */
     sandbox?: SandboxSettings;
     /**
@@ -2014,6 +2014,15 @@ export declare type Options = {
     spawnClaudeCodeProcess?: (options: SpawnOptions) => SpawnedProcess;
 };
 
+/**
+ * Emitted on the same severity:'error' path as the usage-limit bucket, but
+ * the condition is an org policy, not an exhausted limit — consumers route
+ * these to org-disabled presentation, never the usage-limit card.
+ *
+ * @alpha
+ */
+export declare const ORG_POLICY_LIMIT_PREFIXES: readonly ["This service is disabled for your org"];
+
 export declare type OutputFormat = JsonSchemaOutputFormat;
 
 export declare type OutputFormatType = 'json_schema';
@@ -2483,9 +2492,16 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * are managed by the CLI subprocess.
      *
      * Note: This only affects servers added dynamically via this method or the SDK.
-     * Servers configured via settings files are not affected.
+     * Servers configured via settings files are not affected. Servers introduced
+     * by plugins are also exempt: they are managed by the plugin system, so
+     * omitting them from the payload does NOT remove them — they keep running
+     * (unless enterprise policy denies the server) and are simply absent from
+     * the result's `removed` list. In particular, `setMcpServers({})` no longer
+     * guarantees a session has zero dynamic MCP surface when plugins are
+     * loaded. Naming a plugin server explicitly in the payload still replaces
+     * it (ownership is preserved CLI-side).
      *
-     * @param servers - Record of server name to configuration. Pass an empty object to remove all dynamic servers.
+     * @param servers - Record of server name to configuration. Pass an empty object to remove all dynamic servers (except plugin-owned ones, which are retained).
      * @returns Information about which servers were added, removed, and any connection errors
      */
     setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;
@@ -2792,6 +2808,10 @@ export declare type SDKAssistantMessage = {
     uuid: UUID;
     session_id: string;
     request_id?: string;
+    /**
+     * This turn continued the preceding truncated assistant turn inside its trailing signed thinking block (max-output-tokens recovery). Its thinking signatures are cumulative over that preceding thinking-only turn, so a history replayed through the bridge must carry this flag back for the normalizer to keep the run's prefix on the wire. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model.
+     */
+    resumed_from_incomplete_thinking?: true;
     /**
      * Wire uuids of previously-delivered messages that this message replaces (refusal-fallback supersede). The list can include tombstoned tool_result frames from the refused leg, not only assistant frames. Evict the named messages on arrival and treat this frame as their canonical replacement. Idempotent with the end-of-turn model_refusal_fallback notice, whose retracted_message_uuids remains the complete audit record for the turn.
      */
@@ -2805,7 +2825,10 @@ export declare type SDKAssistantMessage = {
      */
     task_description?: string;
 
-
+    /**
+     * ISO timestamp of when this content block finished on the originating process. One API assistant turn may produce several assistant messages sharing a message.id, each with its own timestamp. Uses the originating host's clock, so it's for display only; do not order messages by this field. Older emitters omit it; consumers should fall back to receive time.
+     */
+    timestamp?: string;
 
 
 
@@ -3414,7 +3437,7 @@ declare type SDKControlListModelsRequest = {
 };
 
 /**
- * Invokes an MCP tool via the subprocess MCP client without a model turn. No permission check (control channel is trusted, same as other subtypes). SDK-type MCP servers (config.type === "sdk") are rejected — they are caller-provided, so the caller can invoke them directly without the subprocess round-trip. Result content passes through the same processing as model-turn MCP calls. Session expiry is not retried automatically; callers can mcp_reconnect and retry. UrlElicitationRequired (-32042) tries Elicitation hooks; if no hook resolves, the call errors with the URL in the message — open it out-of-band, then retry mcp_call. STAGED calls (input_files/output_files declared) additionally stage lane rows in/out around the call — see the input_files describe. Staged failures come back as a success-subtype response whose staging field carries a typed error_code; subtype:error is emitted only when the call could not be attempted at all (server not connected, kill switch, dispatch failure) and means nothing ran. Standard RPC semantics: a redelivered request_id supersedes the in-flight run (it is aborted and its response suppressed — exactly one response per request_id); conversion is idempotent, so re-running is safe. Cancellable via control_cancel_request.
+ * Invokes an MCP tool via the subprocess MCP client without a model turn. No permission check (control channel is trusted, same as other subtypes). SDK-type MCP servers (config.type === "sdk") are rejected — they are caller-provided, so the caller can invoke them directly without the subprocess round-trip. Result content passes through the same processing as model-turn MCP calls. Session expiry is not retried automatically; callers can mcp_reconnect and retry. UrlElicitationRequired (-32042) tries Elicitation hooks; if no hook resolves, the call errors with the URL in the message — open it out-of-band, then retry mcp_call. STAGED calls (input_files/output_files declared) additionally stage lane rows in/out around the call — see the input_files describe. Staged failures come back as a success-subtype response whose staging field carries a typed error_code; subtype:error is emitted only when the call could not be attempted at all (server not connected, kill switch, dispatch failure) and means nothing ran. A target server that is not yet connected is brought up on demand: dispatch runs the deferred plugin/MCP startup resolution (the work a first model turn would have done) and waits up to 30s — shortened by expires_at when that is sooner — for the server to connect before answering "MCP server not connected", so a dispatch that races plugin startup (e.g. after an idle-wake reattach) succeeds instead of failing until a turn runs. Standard RPC semantics: a redelivered request_id supersedes the in-flight run (it is aborted and its response suppressed — exactly one response per request_id); conversion is idempotent, so re-running is safe. Cancellable via control_cancel_request.
  */
 declare type SDKControlMcpCallRequest = {
     subtype: 'mcp_call';
@@ -3909,7 +3932,7 @@ export declare type SDKMemoryRecallMessage = {
 export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKControlRequestProgressMessage | SDKModelRefusalFallbackMessage | SDKModelRefusalNoFallbackMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPluginInstallMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskUpdatedMessage | SDKTaskProgressMessage | SDKBackgroundTasksChangedMessage | SDKThinkingTokensMessage | SDKSessionStateChangedMessage | SDKWorkerShuttingDownMessage | SDKCommandsChangedMessage | SDKNotificationMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKMemoryRecallMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPermissionDeniedMessage | SDKPromptSuggestionMessage | SDKMirrorErrorMessage | SDKInformationalMessage | SDKConversationResetMessage;
 
 /**
- * Provenance of a user-role message (peer session, team lead, channel). Absent or `human` means keyboard input from the user.
+ * Provenance of a user-role message (peer session, team lead, channel). A host wrapping keyboard input must stamp {kind:'human'} explicitly — absent origin is treated as unattributed and fails closed at strict isHuman() trust gates.
  */
 export declare type SDKMessageOrigin = {
     kind: 'human';
@@ -4816,6 +4839,10 @@ export declare interface Settings {
      * Command to refresh GCP authentication (e.g., gcloud auth application-default login)
      */
     gcpAuthRefresh?: string;
+    /**
+     * Corporate launcher argv prefix for the background-agent supervisor, the sessions and workers it hosts, and the other covered background processes listed in the Claude Code corporate-launcher documentation. Equivalent to the CLAUDE_CODE_PROCESS_WRAPPER environment variable, which takes precedence when set. Honored from managed settings, a --settings/SDK-supplied settings file, and user settings, in that precedence order; project and local settings are ignored.
+     */
+    processWrapper?: string;
     /**
      * Executable that computes managed settings at startup. Honored only from admin-controlled policy sources.
      */
@@ -6494,6 +6521,12 @@ export declare interface SpawnedProcess {
     readonly killed: boolean;
     /** Exit code if the process has exited, null otherwise */
     readonly exitCode: number | null;
+    /**
+     * Signal that terminated the process, if any. Optional: ChildProcess
+     * provides it; custom spawners may omit it (signal exits then read as
+     * still-running until their 'exit' event delivers the signal).
+     */
+    readonly signalCode?: NodeJS.Signals | null;
     /**
      * Kill the process with the given signal
      * @param signal - The signal to send (e.g., 'SIGTERM', 'SIGKILL')
@@ -6503,6 +6536,11 @@ export declare interface SpawnedProcess {
      * Register a callback for when the process exits
      * @param event - Must be 'exit'
      * @param listener - Callback receiving exit code and signal
+     *
+     * ProcessTransport's built-in local spawn delivers this only after the
+     * child's stderr has also closed (bounded by a short grace), so exit
+     * consumers see a complete stderr tail in exit errors. Custom
+     * `spawnClaudeCodeProcess` implementations emit plain process exit.
      */
     on(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): void;
     /**
@@ -6827,6 +6865,33 @@ export declare interface Transport {
     [Symbol.dispose]?(): void;
 }
 
+/**
+ * Messages meaning "a usage limit was genuinely reached" — the error-path
+ * outputs of getLimitReachedText (rateLimitMessages.ts) and
+ * getFableCreditsRequiredContent (api/errors.ts).
+ *
+ * @alpha
+ */
+export declare const USAGE_LIMIT_ERROR_PREFIXES: readonly ["You've hit your", "You've reached your", "You're out of usage credits", "Your org is out of usage · add funds to continue", "Your org is out of usage · contact your admin", "Your seat type doesn't include usage credits", "Your seat type doesn't include usage", "Your usage allocation has been disabled by your admin", "Your group's usage limit is set to $0", "Fable 5 requires usage credits", "You're out of extra usage", "Your seat type doesn't include extra usage"];
+
+/**
+ * Overage-transition notifications ("now drawing from credits"). Toast only;
+ * these never arrive as API errors.
+ *
+ * @alpha
+ */
+export declare const USAGE_TRANSITION_PREFIXES: readonly ["You're now using usage credits", "You're now using your usage allocation", "Now using your usage allocation", "Now using usage credits", "You're now using extra usage", "Now using extra usage"];
+
+/**
+ * Approaching-limit warnings (severity:'warning'). Footer/toast only; these
+ * never arrive as API errors. ("Approaching …" early warnings are
+ * deliberately unregistered — they render in the footer without
+ * <RateLimitMessage> styling; see the generator-coverage tests.)
+ *
+ * @alpha
+ */
+export declare const USAGE_WARNING_PREFIXES: readonly ["You've used", "You're close to"];
+
 /**
  * A `request_user_dialog` control request from the CLI, asking the SDK
  * consumer to render a blocking dialog and return the user's choice.
@@ -6877,6 +6942,10 @@ export declare type UserPromptExpansionHookSpecificOutput = {
 export declare type UserPromptSubmitHookInput = BaseHookInput & {
     hook_event_name: 'UserPromptSubmit';
     prompt: string;
+    /**
+     * Who authored/injected the prompt: `user` = submitted from the interactive composer, `sdk` = non-interactive entrypoint (`-p` / Agent SDK), `loop_wakeup` = dynamic /loop wakeup, `schedule_wakeup` = scheduled-task fire (CronCreate/routine), `system` = other machine-injected turns (peer/channel messages, task notifications, auto-continuation). Currently only set for Anthropic-internal sessions while the field is trialed; external payloads omit it.
+     */
+    source?: 'user' | 'sdk' | 'system' | 'loop_wakeup' | 'schedule_wakeup';
     session_title?: string;
 };