@anthropic-ai/claude-agent-sdk 0.3.261 → 0.3.265

package/manifest.json

@@ -1,55 +1,52 @@
 {
-  "version": "2.1.261",
+  "version": "2.1.265",
   "manifestSignatureEnforcement": "flag",
-  "commit": "1349cf9c224caea8b7721f717418645e28ebacb8",
-  "buildDate": "2026-09-04T17:00:27Z",
+  "commit": "b08ec8ffb5055fe2e5ecbacfbf8f0b744e62ea51",
+  "buildDate": "2026-09-08T18:30:16Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "5efecaff231b798be3c66def9be54183623b328b80eaef17f93c43987024e82a",
-      "size": 199241568
+      "checksum": "164b09eb800dedb9bb06304129fbf07743ab9db972ae07333ef4f18cde0cb8d5",
+      "size": 199422144
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "2cbc002b32778bd70aa2e668ada920c54d9aacd91b71dbd5619c01ca148ae533",
-      "size": 208009440
+      "checksum": "42c267a37f3db40af9e453a315edf91d423cb96ad147353e2c187769931b1af8",
+      "size": 208075488
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "7bbed5a9b0fc2e4ec67bad3490d06ca91b86d6b037d47520b7898951757d1b8a",
-      "size": 215211432
+      "checksum": "fc1f75b115d6a398f6437df0e00142b073c23633b040618758a935f634427c88",
+      "size": 215670184
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "4ae40dd1784e85753e742e09f267d29ecbb82890361ad3817d27560866d364a6",
-      "size": 215641584
+      "checksum": "e14738e3a58d1fc6ccc23b9c919451b4846bc27074a3fb48db976a7d595bdeeb",
+      "size": 215940592
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "53b58ffbeb3f9325f0ca5eb54fd03cd0346bd197328fa1e68a700ac8e097e6c1",
-      "size": 208090776
+      "checksum": "2ca881fe49749e616d579be1f7260bfe3f8d9195f0b8517d24c0be5476581c7a",
+      "size": 208615064
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "df6502c5978420d71fb32fe41b4ca956a7eb3f6245fc11a03ca2cde7f03b8f93",
-      "size": 209661904
+      "checksum": "77b792470cd157517fbeedb349f31c8f9c40adb3aa0f21ef6086f54b007a2223",
+      "size": 209956816
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "f2f5d1a155167488aeb32cd263e15436253c7b1681ae147c9e73e4d6bbc3c852",
-      "size": 218728608
+      "checksum": "b3d39d4a7e63629e4675a72066eec5e7334225ac1a28432e6f4325b72782631d",
+      "size": 218972320
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "df26e336df846f4b68edda1021af5aecc1f8172d9f045ee33a480916385b35f9",
-      "size": 209778336
+      "checksum": "ad007cd51d4be86138e22f5c5528c433ef843c2e1aa5ec35c51a486064b0ca5d",
+      "size": 210214560
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.221",
-      "0.3.222",
-      "0.3.223",
       "0.3.224",
       "0.3.225",
       "0.3.226",

package/manifest.zst.json

@@ -1,63 +1,60 @@
 {
-  "version": "2.1.261",
+  "version": "2.1.265",
   "manifestSignatureEnforcement": "flag",
-  "commit": "1349cf9c224caea8b7721f717418645e28ebacb8",
-  "buildDate": "2026-09-04T17:01:36Z",
+  "commit": "b08ec8ffb5055fe2e5ecbacfbf8f0b744e62ea51",
+  "buildDate": "2026-09-08T18:31:22Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "c7960a08d4b6a683618a3e739b8338bffa98429fa7806cb3ae31652003e487d0",
-      "size": 66087089,
+      "checksum": "642b819f97a1cf4e077ffae736a0685ccaace5e3b1d95939f11ed19195865d82",
+      "size": 66234051,
       "bundle": {
-        "checksum": "7974c6771c050a3fadfd1a9e5845e01fb4e9019ed3b7e688f1b6d66778d977c4",
-        "size": 66087548
+        "checksum": "f113381f3d56c0a5eecab25e22e8384e0404e7148cb4551584bd1374ef07730a",
+        "size": 66237229
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "2da572c51ea00b509ee88a889ce6bb3a099e8210e09a9177d9fb0764c3387997",
-      "size": 70138940,
+      "checksum": "033c5e797753a95058c3a1db5c11e86215325da36796152da2454e684678a683",
+      "size": 70277960,
       "bundle": {
-        "checksum": "679d975a18f9e8d0dfb75c95e0d869b8210fbdf55abfab693fbe6942c3e2bad8",
-        "size": 70139346
+        "checksum": "2f7985ec46cbc300ab5d11500f169b8aa668b838be19571e7689502745ced444",
+        "size": 70275602
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "60c4ce1b6106119ff2a6e992d2782dd5973da6919c41f505b672535eadd47bbb",
-      "size": 75288745
+      "checksum": "1a7ab5cb59a8e4e3283efcb013dbd182e7e26ddc621a0ccf73d4fab4b50ea80f",
+      "size": 75445590
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "e8b1875243a27ab69fff4c11ced3714b14ec1124b00512833abd250302c3a10a",
-      "size": 75918589
+      "checksum": "386afbffee3a2062886d4d43e7dbe9cf9f86bbf9c4870edc51043bb1f1f83dfd",
+      "size": 76050824
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "94384f0961399cbb3f0b24106fa1a9cfdabf5d7d3dcd80016a8da98e1617a28f",
-      "size": 73768803
+      "checksum": "a5d918f25938eb5f4e20f13881b61df76966df0d422d6095e935cfa62a96de60",
+      "size": 73931669
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "0d25aebb0f24a940ee51029823c119be913e890fa94ba72122f502d0627b5092",
-      "size": 74428966
+      "checksum": "19439c453a1507ed21706d3ee75311c4a5c5549be826e7e2db6c1c9d52c279c7",
+      "size": 74565088
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "346599390837b93f1750b2eb67d1694e29a6053f5ed5831ca82620010f6c26ab",
-      "size": 78332715
+      "checksum": "3c77665ca1437a107bf09576dfe1c4747e677ae07b26ba9b56ff2610db198d43",
+      "size": 78433429
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "a02be72aaf9ef51bae69a9d5dd6a6dc581af3bcc32c53499c2d03ea7773be191",
-      "size": 75072314
+      "checksum": "6aae23fca7139bdc76fb808516807c4e50376cdd48aa88b09fafffc065a1a8fa",
+      "size": 75210939
     }
   },
   "sdkCompat": {
     "testedWrapperVersions": [
-      "0.3.221",
-      "0.3.222",
-      "0.3.223",
       "0.3.224",
       "0.3.225",
       "0.3.226",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.3.261",
+  "version": "0.3.265",
   "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.261",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.261",
-    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.261",
-    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.261",
-    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.261",
-    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.261",
-    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.261",
-    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.261"
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.265",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.265"
   },
   "files": [
     "sdk.mjs",
@@ -80,5 +80,5 @@
     "manifest.json",
     "manifest.zst.json"
   ],
-  "claudeCodeVersion": "2.1.261"
+  "claudeCodeVersion": "2.1.265"
 }

package/sdk-tools.d.ts

@@ -657,6 +657,27 @@ export type ProjectsOutput =
       notice?: string;
       path: string;
       deleted: boolean;
+    }
+  | {
+      method: "project_memory_list";
+      notice?: string;
+      files: {
+        path: string;
+        size_bytes: number;
+        updated_at: string | null;
+        truncated: boolean;
+      }[];
+      truncated: boolean;
+    }
+  | {
+      method: "project_memory_read";
+      notice?: string;
+      path: string;
+      content?: string;
+      local_file?: string;
+      size_bytes: number;
+      updated_at: string | null;
+      truncated: boolean;
     };
 
 export interface AgentInput {
@@ -2655,9 +2676,16 @@ export interface ClaudeDesignInput {
   };
 }
 export interface ProjectsInput {
-  method: "project_info" | "project_read" | "project_search" | "project_write" | "project_delete";
-  /**
-   * project_read/project_write/project_delete: doc path. project_write: an existing path is replaced in place; a new bare filename (no "/") is namespaced to "claude/<name>".
+  method:
+    | "project_info"
+    | "project_read"
+    | "project_search"
+    | "project_write"
+    | "project_delete"
+    | "project_memory_list"
+    | "project_memory_read";
+  /**
+   * project_read/project_write/project_delete: doc path. project_write: an existing path is replaced in place; a new bare filename (no "/") is namespaced to "claude/<name>". project_memory_read: memory file path as listed by project_memory_list.
    */
   path?: string;
   /**

package/sdk.d.ts

@@ -1670,6 +1670,7 @@ export declare type Options = {
      * wins on multi-client sessions; later initializes do not change it.
      */
     perTaskStopAffordance?: boolean;
+
     /**
      * When false, disables session persistence to disk. Sessions will not be
      * saved to ~/.claude/projects/ and cannot be resumed later. Useful for
@@ -2200,18 +2201,17 @@ export declare type Options = {
      * prefix stable.)
      *
      * How it interacts with `append` (and a custom `prompt`):
-     * - **Omitted (default):** passing an `append` or a custom prompt turns the
-     *   recording off, so your appended text is applied fresh on every launch —
-     *   today's behavior. Only the bare `claude_code` preset is recorded by
-     *   default.
-     * - **`snapshot: true`:** if the conversation already has a recorded prompt,
-     *   that record is sent as-is (a different `append` or `prompt` passed on a
-     *   later launch of the same session is ignored until compaction or a new
-     *   session); otherwise Claude Code renders its prompt with your `append`
-     *   included, sends that, and records it for the rest of the conversation.
-     * - **`snapshot: false`:** never record; render fresh every request.
-     * A bare string / `string[]` prompt is always `false`; use
-     * `{ type: 'custom', prompt, snapshot: true }` to opt a custom prompt in.
+     * - **Omitted or `snapshot: true` (the default):** Claude Code renders its
+     *   prompt with your `append` (or your custom `prompt`) on the
+     *   conversation's first request, sends that, and records it; every later
+     *   request and `resume` / `continue` sends the record as-is — a different
+     *   `append` or `prompt` passed on a later launch of the same session is
+     *   ignored until compaction or a new session.
+     * - **`snapshot: false`:** never record; render fresh every request — for
+     *   iterating on prompt text, or a host that must change its append within
+     *   a session.
+     * A bare string / `string[]` prompt follows the default; use
+     * `{ type: 'custom', prompt, snapshot: false }` to opt it out.
      * With a recorded prompt, a mid-session model switch or `set_settings`
      * agent/system-prompt change does not change the prompt either; it takes
      * effect at the next compaction or in a new session. System-prompt
@@ -3324,14 +3324,15 @@ export declare type SDKAssistantMessage = {
     parent_tool_use_id: string | null;
     error?: SDKAssistantMessageError;
     uuid: UUID;
+
     session_id: string;
     request_id?: string;
     /**
-     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on the turn's FIRST reply frame only — the first assistant message in complete-message mode; with --include-partial-messages the stamp normally rides the first non-ping stream event instead (see SDKPartialAssistantMessage), and a turn that produces no stream events still stamps its first assistant message — so a consumer can bind the reply to the send it answers without waiting for the result. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model. Absent on every later frame of the turn, on subagent frames (parent_tool_use_id set), on synthetic/scheduled (meta) turns, on turns without a client uuid, and from older producers.
+     * Client uuid of the user message this turn is answering (submitMessage options.uuid), stamped on a reply frame each time that send changes — the turn's FIRST reply frame, and then, for a turn started by a synthetic (meta) prompt, the first reply frame after each queued user message folded in mid-turn takes the echo over. In complete-message mode the frame is the first assistant message; with --include-partial-messages the stamp normally rides the first non-ping stream event instead (see SDKPartialAssistantMessage), and a turn that produces no stream events still stamps its first assistant message — so a consumer can bind the reply to the send it answers without waiting for the result; the server keeps the first stamp it sees per uuid. A turn started by a typed prompt keeps that uuid for its whole turn, so it stamps its first reply frame only. A meta turn's own uuid is stamped only when the host vouches it is the client event's own (on a hosted session, the uuid the session server persisted: delivered content such as a Slack owner ping, a Slack-bot observation or a client-injected synthetic turn), never for a prompt the CLI minted itself such as the boot-time rescue turn; either way a user message folded into a meta turn takes the echo over from it (the rescue turn absorbing messages sent while the session was down; a bot-observation turn absorbing a human's post), and the first reply frame after that fold carries the folded message's uuid — the first reply that message got. Wrapper-level sibling — never inside `message.content` — so it is not replayed to the model. Absent on every other frame of the turn, on subagent frames (parent_tool_use_id set), on turns that neither had a client uuid nor folded a user message in, and from older producers.
      */
     user_message_uuid?: string;
     /**
-     * Client uuids of every user message whose prompt this turn has consumed so far, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), so a consumer that sent any of them can bind this reply to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries. Present exactly when user_message_uuid is, on the same first reply frame only; absent from older producers (fall back to user_message_uuid).
+     * Client uuids of every user message whose prompt this turn has consumed so far, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), then any user message folded into the turn before this frame — so a consumer that sent any of them can bind this reply to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries. Present exactly when user_message_uuid is, on the same frames; absent from older producers (fall back to user_message_uuid).
      */
     user_message_uuids?: string[];
     /**
@@ -3379,6 +3380,7 @@ export declare type SDKAssistantMessage = {
 
 
 
+
 };
 
 export declare type SDKAssistantMessageError = 'authentication_failed' | 'oauth_org_not_allowed' | 'account_on_hold' | 'billing_error' | 'rate_limit' | 'overloaded' | 'invalid_request' | 'model_not_found' | 'server_error' | 'unknown' | 'max_output_tokens';
@@ -3460,6 +3462,7 @@ export declare type SDKCompactBoundaryMessage = {
 
     uuid: UUID;
     session_id: string;
+
 };
 
 /**
@@ -3981,11 +3984,24 @@ declare type SDKControlInitializeRequest = {
          */
         timeout?: number;
     }>;
+    /**
+     * Optional, keyed by sdk server name (each key should also appear in sdkMcpServers; other keys are ignored). Unlike sdkMcpServerConfigs — host-declared settings the CLI keeps for the server's lifetime, same shape inline on mcp_set_servers — this is a one-shot cache of the servers' own handshake output: sent on initialize only, consumed by the connect that follows it, never retained. MCP handshake results the host already obtained from its in-process servers by delivering initialize + notifications/initialized (+ tools/list) to them itself before writing this request. For each such server the CLI answers its own MCP client's initialize and first tools/list from these results and skips the notifications/initialized round trip, so registering N in-process servers costs no mcp_message control round trips before the first turn; tools/call and everything after the handshake still flow as mcp_message exactly as before. The host MUST keep answering mcp_message for every server as if this field were absent: a CLI that predates the field ignores it and performs the full per-server handshake over the control channel, and a newer CLI does the same for any server whose entry is missing or malformed, whose initializeResult.protocolVersion differs from the MCP protocol version the CLI's client requests, or that the CLI had already connected. Entries apply only to the connect that follows this initialize; they are never retained for later reconnects. Absent (older hosts, the Python SDK, browser clients): unchanged behaviour.
+     */
+    sdkMcpServerManifests?: Record<string, {
+        /**
+         * The server's verbatim JSON-RPC `initialize` result object (protocolVersion, capabilities, serverInfo, instructions, ...), exactly as the in-process server produced it when the host initialized it with no client capabilities — not re-serialized or schema-parsed by the host.
+         */
+        initializeResult: Record<string, unknown>;
+        /**
+         * The server's verbatim JSON-RPC `tools/list` result object. Omit when the initialize result does not advertise the tools capability, when the listing is paginated (nextCursor present), or when it could not be captured — the CLI then lists over the control channel as before.
+         */
+        toolsListResult?: Record<string, unknown>;
+    }>;
     jsonSchema?: Record<string, unknown>;
     systemPrompt?: string[];
     appendSystemPrompt?: string;
     /**
-     * Record the conversation's system prompt once and reuse it verbatim on every later request and resume (recommended: true). Omitted: setting systemPrompt or appendSystemPrompt turns recording off so the appended text applies fresh each launch; only the bare claude_code preset is recorded. true: an existing record in the conversation is sent as-is (a later launch's different systemPrompt/appendSystemPrompt is ignored until compaction); otherwise the prompt is rendered with appendSystemPrompt included, sent, and recorded. false: never record. With a record, a mid-session model switch or set_settings agent/system-prompt change does not alter the prompt until compaction or a new session.
+     * Record the conversation's system prompt once and reuse it verbatim on every later request and resume. Omitted or true (the default): the prompt is rendered on the first request, systemPrompt or appendSystemPrompt included, and the record is sent as-is afterwards — even when a later launch passes different text — until compaction. false: never record; the prompt is rendered fresh every request. No effect where system-prompt recording is not yet enabled.
      */
     systemPromptSnapshot?: boolean;
     /**
@@ -4027,6 +4043,7 @@ declare type SDKControlInitializeRequest = {
      */
     plugins?: coreTypes.SdkPluginConfig[];
 
+
 };
 
 /**
@@ -4057,6 +4074,7 @@ export declare type SDKControlInitializeResponse = {
 
 
 
+
     fast_mode_state?: coreTypes.FastModeState;
     fast_mode_disabled_reason?: coreTypes.FastModeDisabledReason;
 
@@ -4178,6 +4196,9 @@ declare type SDKControlMcpReconnectRequest = {
 declare type SDKControlMcpSetServersRequest = {
     subtype: 'mcp_set_servers';
     servers: Record<string, coreTypes.McpServerConfigForProcessTransport>;
+
+
+
 };
 
 /**
@@ -4353,6 +4374,8 @@ export declare type SDKControlRequest = {
      */
     request_id: string;
     request: SDKControlRequestInner;
+
+
 };
 
 declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlListModelsRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlReloadOutputStylesRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlUpdateSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
@@ -4398,6 +4421,9 @@ declare type SDKControlRequestUserDialogRequest = {
 export declare type SDKControlResponse = {
     type: 'control_response';
     response: ControlResponse | ControlErrorResponse;
+
+
+
 };
 
 /**
@@ -4834,11 +4860,11 @@ export declare type SDKPartialAssistantMessage = {
     session_id: string;
     ttft_ms?: number;
     /**
-     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on the turn's FIRST non-ping stream event only (the frame that triggers the turn's initial ack) so a consumer can bind the reply stream to the send it answers without waiting for the result. Absent on every later stream event of the turn, on synthetic/scheduled (meta) turns, on turns without a client uuid, and from older producers.
+     * Client uuid of the user message this turn is answering (submitMessage options.uuid), stamped on a non-ping stream event each time that send changes: the turn's FIRST non-ping stream event (normally the frame that triggers the turn's initial ack), and, for a turn started by a synthetic (meta) prompt, the first non-ping stream event after each queued user message folded in mid-turn takes the echo over (see SDKAssistantMessage.user_message_uuid for the rule) — so a consumer can bind the reply stream to the send it answers without waiting for the result. A turn started by a typed prompt stamps its first non-ping stream event only. Absent on every other stream event of the turn, on turns that neither had a client uuid nor folded a user message in, and from older producers.
      */
     user_message_uuid?: string;
     /**
-     * Client uuids of every user message whose prompt this turn has consumed so far, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), so a consumer that sent any of them can bind this reply to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries. Present exactly when user_message_uuid is, on the same first non-ping stream event only; absent from older producers (fall back to user_message_uuid).
+     * Client uuids of every user message whose prompt this turn has consumed so far, in consumption order — all members of a prompt batch the host merged into this one turn (several messages sent close together run as one turn whose user_message_uuid is the LAST member's), then any user message folded into the turn before this frame — so a consumer that sent any of them can bind this reply to its own send by finding its uuid anywhere in the list. Always contains user_message_uuid; at most 64 entries. Present exactly when user_message_uuid is, on the same frames; absent from older producers (fall back to user_message_uuid).
      */
     user_message_uuids?: string[];
 };
@@ -4981,8 +5007,9 @@ export declare type SDKResultError = {
      */
     queued_turn_count?: number;
     errors: string[];
+
     /**
-     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), echoed back so a consumer can link this error result to the send it answers — the same join key the success variant echoes, carried alone (error turns have no request_sent_wall_ms to report). A delivery-failure result from the remote-session client echoes the failed send's queue key, which is client-minted when the host sent no uuid of its own. Absent on synthetic/scheduled (meta) turns, on turns without a client uuid, on session-scoped failures with no single triggering send (a crashed worker's zeroed result), and from older producers.
+     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), echoed back so a consumer can link this error result to the send it answers — the same join key the success variant echoes, carried alone (error turns have no request_sent_wall_ms to report). A delivery-failure result from the remote-session client echoes the failed send's queue key, which is client-minted when the host sent no uuid of its own. A synthetic/scheduled (meta) turn's own uuid is echoed only when the host vouches it is the client event's own (delivered content such as a Slack owner ping or a Slack-bot observation); a meta turn that folded queued user messages in mid-turn, vouched or not, echoes the LAST of them. Absent on turns that neither had a client uuid nor folded a user message in, on session-scoped failures with no single triggering send (a crashed worker's zeroed result), and from older producers.
      */
     user_message_uuid?: string;
     /**
@@ -5153,6 +5180,7 @@ export declare type SDKSystemMessage = {
      * Where the credential used for API requests came from: 'ANTHROPIC_API_KEY' (environment variable), 'apiKeyHelper' (the configured helper command), '/login managed key' (an API key created and stored by /login with an Anthropic Console account), or 'none' (no API key in use - e.g. claude.ai OAuth login, a bearer token, or a third-party cloud provider). 'user' | 'project' | 'org' | 'temporary' | 'oauth' are legacy members that current CLIs never emit; they remain only so the type stays backward compatible.
      */
     apiKeySource: ApiKeySource;
+
     betas?: string[];
     claude_code_version: string;
     cwd: string;
@@ -5322,7 +5350,7 @@ export declare type SDKThinkingTokensMessage = {
     estimated_tokens: number;
     estimated_tokens_delta: number;
     /**
-     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on every thinking_tokens frame of a headless (stream-json / Agent SDK) turn so a consumer can attribute thinking progress to the send it answers before any reply frame arrives. Absent on synthetic/scheduled (meta) turns, on turns without a client uuid, on Remote Control (interactive terminal) sessions, and from older producers.
+     * Client uuid of the user message that triggered this turn (submitMessage options.uuid), stamped on every thinking_tokens frame of a headless (stream-json / Agent SDK) turn so a consumer can attribute thinking progress to the send it answers before any reply frame arrives. On a synthetic/scheduled (meta) turn it names the last user message folded into the turn so far once one has been, else the turn's own uuid when the host vouches it is the client event's own (delivered content such as a Slack owner ping). Absent on turns that neither had a client uuid nor folded a user message in, on Remote Control (interactive terminal) sessions, and from older producers.
      */
     user_message_uuid?: string;
     uuid: UUID;
@@ -5378,6 +5406,30 @@ export declare type SDKUserMessage = {
     origin?: SDKMessageOrigin;
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
     /**
      * When false, the message is appended to the transcript without triggering an assistant turn. It will be merged into the next user message that does query.
      */
@@ -5411,6 +5463,7 @@ export declare type SDKUserMessage = {
      * Description of the subagent task that produced this message.
      */
     task_description?: string;
+
 };
 
 export declare type SDKUserMessageReplay = {
@@ -5429,6 +5482,30 @@ export declare type SDKUserMessageReplay = {
     origin?: SDKMessageOrigin;
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
     /**
      * When false, the message is appended to the transcript without triggering an assistant turn. It will be merged into the next user message that does query.
      */
@@ -7595,7 +7672,7 @@ export declare interface Settings {
      */
     parentSettingsBehavior?: 'first-wins' | 'merge';
     /**
-     * Controls how the managed settings sources compose. "first-wins" (default): the highest-priority source present (server-managed > MDM (managed plist / HKLM) > managed-settings.json) is the managed tier alone. "merge": every present source deep-merges with fixed precedence server-managed > MDM > managed-settings.json — scalars take the highest source's value and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry) and the auth pins forceLoginOrgUUID, forceLoginMethod and forceLoginGatewayUrl (highest source only). Honored only from the highest-priority source present; enable it only when every lower source is admin-controlled, since lower sources then contribute entries such as permissions.allow. HKCU and --managed-settings never take part in the merge.
+     * Controls how the managed settings sources compose. "first-wins" (default): the highest-priority source present (server-managed > MDM (managed plist / HKLM) > managed-settings.json) is the managed tier alone. "merge": every present source deep-merges with fixed precedence server-managed > MDM > managed-settings.json — scalars take the highest source's value (a restrictive boolean or enum — the allowManaged*Only locks, the disable* switches, the sandbox lock family — takes the strictest value any source sets) and arrays union, except fallbackModel, the restriction allowlists allowedMcpServers, availableModels, strictKnownMarketplaces and allowedChannelPlugins, and sandbox.credentials.awsPairs and sandbox.ripgrep (the highest source that sets one owns it whole), modelOverrides (the whole map of the highest source that sets it, dropped when that source sits below the one that sets availableModels), managedMcpServers (server names union; a name set by two sources takes the higher source's whole entry), and the keys taken from the highest source only: the auth pins forceLoginOrgUUID, forceLoginMethod and forceLoginGatewayUrl, the credential helpers apiKeyHelper, awsAuthRefresh, awsCredentialExport, gcpAuthRefresh, otelHeadersHelper and proxyAuthHelper, modelPicker, permissions.defaultMode, parentSettingsBehavior and the policyHelper configuration (env keeps its own per-key union). Honored only from the highest-priority source present; enable it only when every lower source is admin-controlled, since lower sources then contribute entries such as permissions.allow. HKCU and --managed-settings never take part in the merge.
      */
     managedSourcesBehavior?: 'first-wins' | 'merge';
     /**