@anthropic-ai/claude-agent-sdk 0.3.201 → 0.3.203

package/extractFromBunfs.js

@@ -146,7 +146,7 @@ export function extractFromBunfs(embeddedPath) {
     }
     return tmpPath
   } catch (err) {
-    // biome-ignore lint/suspicious/noConsole: intentional user-facing warning in standalone SDK helper
+    // oxlint-disable-next-line no-console -- intentional user-facing warning in standalone SDK helper
     console.warn(
       `[claude-agent-sdk] Failed to extract CLI from $bunfs: ${err.message}. ` +
         `Child processes cannot access $bunfs paths — the CLI will likely fail to start.`,

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.201",
-  "commit": "5bb45156ece6b12214696c88adec695b2dca1338",
-  "buildDate": "2026-07-03T20:01:44Z",
+  "version": "2.1.203",
+  "commit": "b90c3643145ac0c57630235e630824e387389981",
+  "buildDate": "2026-07-07T01:48:15Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "a0852d76afc47b30f5cb0b7625ec9a7714cb189f2eeef6c28c77e2be954fb7fd",
-      "size": 231708784
+      "checksum": "57b5aec68a35f42036bd2f82836d91c2d2990c2d589fb3465e3ee87142af9a1e",
+      "size": 236961904
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "1889287a92d25356ae8bd8d8e67b11456015516ee8ba4277a0c7074786c49bb6",
-      "size": 241100240
+      "checksum": "1481cffd33d5d19219b53d832fb14e4c2c2def781fc4f1db6c5a4b2d1e596763",
+      "size": 246384080
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "86b2eab34d382c7b428fc2e9f4c97f04e46805e950582472a13eb7d48de60516",
-      "size": 248101616
+      "checksum": "59bf43c7fc8c254a2d7a994f26d577a50f17876e4ed180cff6a1cef2f9ebe473",
+      "size": 253344496
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "a34809a6839fdefff21b9347d7fb5b6b58e6a9cc208a5e62853f29c83eb107a3",
-      "size": 251300664
+      "checksum": "85e4d203c5b43c67a778efd25dcc9ae1d239110c87726df5c6ac0774b576cc6c",
+      "size": 256531256
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "5b4cde588b0196c8f88654ca9652c4703788f4d9fbab32a17ab3c444830085ae",
-      "size": 241349816
+      "checksum": "10bd1d71bd07699b701cf4a4c94f63279e7d0df0b5618364b7c4c1d955b60891",
+      "size": 246592696
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "a0f81ec99ac65e8c5919e7aae54b8a496488e0f1311884fc9ffd05c7cbf6bd2f",
-      "size": 245985664
+      "checksum": "5c4ccfdbee42d35c438978d813b6c0b85c857afeec4b6735391abff3ac8f40f6",
+      "size": 251216256
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "fb804ee019bfbb8d7e85abf965e528e53b5aa5a4e4ebc0f164139dc10a9e0320",
-      "size": 241591968
+      "checksum": "678bc5f62fecb3e1dea2f23735313e61c07970c357271b0f81874ce439e158bf",
+      "size": 246702240
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "a3ad78a0b593dea94c3ee787b1f5b17a173a7679203a296acf9aae7ef4705d42",
-      "size": 236058784
+      "checksum": "e8f5c228393caf8e58643e7553fa379f1ce84838fa3bfa2ca0f50c76a852fd2b",
+      "size": 241169056
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.201",
-  "commit": "5bb45156ece6b12214696c88adec695b2dca1338",
-  "buildDate": "2026-07-03T20:03:32Z",
+  "version": "2.1.203",
+  "commit": "b90c3643145ac0c57630235e630824e387389981",
+  "buildDate": "2026-07-07T01:50:02Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "18e2b15bbf0333a88a65cd2e3020cf52ae6d415f39ed588afc331d8473190154",
-      "size": 47431348,
+      "checksum": "59cd3b99db356422320cad9d2d1ea715e900d09bccc34207b2932b84857bccbc",
+      "size": 48687006,
       "bundle": {
-        "checksum": "add99ff8b25ef856b3d8695fdeef344048fe712bdc5708629a984787ba3c9188",
-        "size": 47428744
+        "checksum": "d206e286fe29b4cf07d780db392255bdec309b28a888f182652e48333f75c736",
+        "size": 48690684
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "4b2050debc0e3d510b94239b8626fe6a869789cf724fa42c5015a5d4b9fec114",
-      "size": 51796127,
+      "checksum": "c6cb953021daff3e346bc60ce103740c57e58cdcc45c20e611d95e59899c521a",
+      "size": 53070087,
       "bundle": {
-        "checksum": "0044c4c2ce846f1972a2ab956751d81fbba0f3568979154f2faf629a44d79c15",
-        "size": 51801449
+        "checksum": "74be7c98065ad4629ed792482983ae1a305c3ba4e39d275ae66b98c64176639e",
+        "size": 53072940
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "4658386a325d60fcb0131e57dc039504b851e3d99ff1f5bb0ac9316976b08729",
-      "size": 56535728
+      "checksum": "334b264dfb77c1e704e5734a8dc9e28e7731691991a224f2d950bdf568f394b3",
+      "size": 57760880
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "52c34ff3734e0908c49c59eccbb97182d86912fb598c09196071e7dcbd067320",
-      "size": 57783888
+      "checksum": "d2300a581f1ae03c5b40ec298d4f55e7eaf1c15b2a4c3690f6876b631b7f6b1d",
+      "size": 59002865
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "c9520418ef28daa25f304e969f63f9fe3889d9ed53659b0d9ce357b8ff6ee361",
-      "size": 55209060
+      "checksum": "4eb5c59800b4f2b7ba35a2b53348bcca9b561b9873de798ebf231b6abe0f740a",
+      "size": 56439201
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "c44e0e4614c71a2e900f0ce369af0fdb4e416184f1211b31a787e5e2f39c2793",
-      "size": 56589666
+      "checksum": "9ffb50eca34325462b3eb96c2a2e26401f78b4f21e7738428354a2f21c118e21",
+      "size": 57829849
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "ee8a3b36e6d4104f5b8ce716beb1a9584016d22ce12a813a55020379727358d3",
-      "size": 57924143
+      "checksum": "6536041ffdb1e6ce354a2edbe80c98c09a246845f7273710e143cc82008d4a0a",
+      "size": 59158319
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "96aba507c1e1baa3062f009eedef1f9f8084d9b263de72c7a4e834f8e528bbf2",
-      "size": 55958009
+      "checksum": "b48002cfce5ca9dba2804ecc7fccee51fbfd34d4eb938e40a383ceca5cef3cfc",
+      "size": 57184577
     }
   }
 }

package/package.json

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

package/sdk-tools.d.ts

@@ -345,6 +345,30 @@ export type McpOutput =
   | {
       [k: string]: unknown;
     };
+export type ArtifactOutput =
+  | {
+      url: string;
+      path: string;
+      title?: string;
+      version?: string;
+      capabilities?: unknown;
+      stored?: {
+        contract: string;
+        capabilities?: {
+          [k: string]: unknown;
+        };
+      };
+      warnings?: string[];
+      contract?: string;
+    }
+  | {
+      artifacts: {
+        title: string;
+        url: string;
+        updatedAt?: string;
+      }[];
+      truncated?: boolean;
+    };
 export type ProjectsOutput =
   | {
       method: "project_info";
@@ -399,6 +423,7 @@ export type ProjectsOutput =
       doc_uuid: string;
       replaced: boolean;
       present_to_user?: boolean;
+      local_path?: string;
     }
   | {
       method: "project_delete";
@@ -2518,17 +2543,21 @@ export interface CronDeleteInput {
 export interface CronListInput {}
 export interface ScheduleWakeupInput {
   /**
-   * Seconds from now to wake up. Clamped to [60, 3600] by the runtime.
+   * Seconds from now to wake up. Clamped to [60, 3600] by the runtime. Required unless `stop` is true.
    */
-  delaySeconds: number;
+  delaySeconds?: number;
   /**
-   * One short sentence explaining the chosen delay. Goes to telemetry and is shown to the user. Be specific.
+   * One short sentence explaining the chosen delay. Goes to telemetry and is shown to the user. Be specific. Required unless `stop` is true.
    */
-  reason: string;
+  reason?: string;
   /**
-   * The /loop input to fire on wake-up. Pass the same /loop input verbatim each turn so the next firing re-enters the skill and continues the loop. For autonomous /loop (no user prompt), pass the literal sentinel `<<autonomous-loop-dynamic>>` instead (the dynamic-pacing variant, not the CronCreate-mode `<<autonomous-loop>>`).
+   * The /loop input to fire on wake-up. Pass the same /loop input verbatim each turn so the next firing re-enters the skill and continues the loop. For autonomous /loop (no user prompt), pass the literal sentinel `<<autonomous-loop-dynamic>>` instead (the dynamic-pacing variant, not the CronCreate-mode `<<autonomous-loop>>`). Required unless `stop` is true.
    */
-  prompt: string;
+  prompt?: string;
+  /**
+   * Set to true to end the dynamic loop immediately instead of scheduling another wakeup. When true, all other fields are ignored and no further wakeups fire.
+   */
+  stop?: boolean;
 }
 export interface RemoteTriggerInput {
   action: "list" | "get" | "create" | "update" | "run";
@@ -2571,13 +2600,21 @@ export interface MonitorInput {
 }
 export interface ArtifactInput {
   /**
-   * Path to an .html or .md file to render. Use a short, distinctive basename — it is the fallback title if the HTML has no <title>.
+   * Omit (or 'publish') to publish file_path. 'list' enumerates the user's published artifacts; only `limit` may accompany it.
    */
-  file_path: string;
+  action?: "publish" | "list";
   /**
-   * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Keep stable across redeploys; change only on a hard topic pivot.
+   * 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>.
    */
-  favicon: string;
+  file_path?: string;
+  /**
+   * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Required to publish. Keep stable across redeploys; change only on a hard topic pivot.
+   */
+  favicon?: string;
+  /**
+   * list only: maximum artifacts to return (default 25).
+   */
+  limit?: number;
   /**
    * One-sentence subtitle shown on the gallery card. Say what the page is or does.
    */
@@ -2587,7 +2624,7 @@ export interface ArtifactInput {
    */
   label?: string;
   /**
-   * Existing artifact URL to redeploy to. Pass when the user gives you a URL for an artifact not published in this session; omit for new artifacts or same-session redeploys. Must be an artifact the user owns.
+   * Existing artifact URL to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" if you don't have it; without this, a conversation that didn't publish the artifact always mints a new URL. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns.
    */
   url?: string;
   /**
@@ -2608,7 +2645,7 @@ export interface EnterWorktreeInput {
    */
   name?: string;
   /**
-   * Path to an existing worktree of the current repository to switch into instead of creating a new one. Must appear in `git worktree list` for the current repo. Mutually exclusive with `name`.
+   * Path to an existing worktree to switch into instead of creating a new one. Must appear in `git worktree list` for the current repo — or, on first entry from the launch directory, for a repo nested inside it (multi-repo workspace). Mutually exclusive with `name`.
    */
   path?: string;
 }
@@ -3343,19 +3380,6 @@ export interface TaskListOutput {
     blockedBy: string[];
   }[];
 }
-export interface ArtifactOutput {
-  url: string;
-  path: string;
-  title?: string;
-  version?: string;
-  capabilities?: unknown;
-  stored?: {
-    contract: string;
-    capabilities?: {
-      [k: string]: unknown;
-    };
-  };
-}
 export interface RemoteTriggerOutput {
   status: number;
   json: string;
@@ -3378,6 +3402,10 @@ export interface ScheduleWakeupOutput {
    * True if the requested delaySeconds was outside [60, 3600]
    */
   wasClamped: boolean;
+  /**
+   * True when the model ended the loop via `stop: true`
+   */
+  stopped?: boolean;
 }
 export interface MonitorOutput {
   /**

package/sdk.d.ts

@@ -372,11 +372,15 @@ declare namespace coreTypes {
         PreToolUseHookSpecificOutput,
         RewindFilesResult,
         SDKAPIRetryMessage,
+        SDKActiveGoalMessage,
         SDKAssistantMessageError,
         SDKAssistantMessage,
         SDKAuthStatusMessage,
+        SDKBackgroundTasksChangedMessage,
         SDKCommandsChangedMessage,
         SDKCompactBoundaryMessage,
+        SDKControlRequestProgressMessage,
+        SDKConversationResetMessage,
         SDKDeferredToolUse,
         SDKElicitationCompleteMessage,
         SDKFilesPersistedEvent,
@@ -2744,6 +2748,22 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
     socatPath: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<string, unknown>, z.ZodString>>>;
 }, z.core.$loose>;
 
+/**
+ * Emitted when the user's /goal Stop hook reports met (clears) or not-yet-met (bumps iterations + last_reason). Any surface with a goal indicator re-renders from this. value is null when the goal is cleared. From internal QueryEvent 'active_goal'.
+ */
+export declare type SDKActiveGoalMessage = {
+    type: 'active_goal';
+    value: {
+        condition: string;
+        iterations: number;
+        set_at: number;
+        tokens_at_start: number;
+        last_reason?: string;
+    } | null;
+    uuid: UUID;
+    session_id: string;
+};
+
 /**
  * Emitted when an API request fails with a retryable error and will be retried after a delay. error_status is null for connection errors (e.g. timeouts) that had no HTTP response.
  */
@@ -2806,6 +2826,24 @@ export declare type SDKAuthStatusMessage = {
     session_id: string;
 };
 
+/**
+ * The full set of live background tasks, emitted whenever membership changes (start, completion, kill, a foreground agent being backgrounded). A level signal, unlike the task_started/task_notification edge bookends: consumers that only need 'is background work running' should replace their set with each payload rather than pairing edges, so a missed bookend cannot wedge a stale running indicator. Ordering relative to the bookends for the same transition is unspecified (in practice the level precedes them) and the payload carries ids only, so do not correlate it with the edge stream. The level is per-process: nothing is emitted at startup, so consumers must reset to the empty set whenever the session's CLI process (re)starts and let the next membership change repopulate it.
+ */
+export declare type SDKBackgroundTasksChangedMessage = {
+    type: 'system';
+    subtype: 'background_tasks_changed';
+    /**
+     * Every live background task after the change. REPLACE semantics: swap your set for this payload.
+     */
+    tasks: {
+        task_id: string;
+        task_type: string;
+        description: string;
+    }[];
+    uuid: UUID;
+    session_id: string;
+};
+
 export declare type SdkBeta = 'context-1m-2025-08-07';
 
 /**
@@ -3031,6 +3069,13 @@ export declare type SDKControlGetContextUsageResponse = {
     } | null;
 };
 
+/**
+ * Read the session's current plan-mode plan. Unlike read_file, the caller does not need to know the plan file's path — the worker resolves its own plan slug. Never creates a plan slug or file.
+ */
+declare type SDKControlGetPlanRequest = {
+    subtype: 'get_plan';
+};
+
 /**
  * Requests the formatted session cost summary (the same text /usage prints in non-interactive mode). Used by the thin-client /usage dialog to show the remote container cost instead of the local $0.00.
  */
@@ -3265,6 +3310,13 @@ export declare type SDKControlGetUsageResponse = {
     } | null;
 };
 
+/**
+ * Requests the workspace git diff for the thin-client /diff dialog. The worker resolves one base ref for both stats and hunks (working tree vs HEAD, falling back to branch-vs-default-merge-base when the tree is clean) and applies the standard caps (5s git timeout, 50 files, 1MB/file).
+ */
+declare type SDKControlGetWorkspaceDiffRequest = {
+    subtype: 'get_workspace_diff';
+};
+
 /**
  * Initializes the SDK session with hooks, MCP servers, and agent configuration.
  */
@@ -3326,6 +3378,9 @@ export declare type SDKControlInitializeResponse = {
 
     fast_mode_state?: coreTypes.FastModeState;
 
+
+
+
 };
 
 /**
@@ -3512,7 +3567,26 @@ export declare type SDKControlRequest = {
     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 | SDKControlGetWorkspaceDiffRequest | SDKControlGetPlanRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlSetMcpPermissionModeOverrideRequest | SDKControlRewindConversationRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlStageFileRequest | SDKControlAddDirectoryRequest | SDKControlSetCwdRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlListModelsRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlGetWorkspaceDiffRequest | SDKControlGetPlanRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
+
+/**
+ * Progress for a long-running client-originated control_request (currently only side_question), correlated by request_id. status 'started' means the worker accepted the request and launched the work; 'api_retry' carries the same retry counters as SDKAPIRetryMessage and is present only for that status.
+ */
+export declare type SDKControlRequestProgressMessage = {
+    type: 'system';
+    subtype: 'control_request_progress';
+    /**
+     * request_id of the in-flight control_request this progress belongs to.
+     */
+    request_id: string;
+    status: 'started' | 'api_retry';
+    attempt?: number;
+    max_retries?: number;
+    retry_delay_ms?: number;
+    error_status?: number | null;
+    uuid: UUID;
+    session_id: string;
+};
 
 /**
  * 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.
@@ -3598,6 +3672,16 @@ declare type SDKControlStopTaskRequest = {
     task_id: string;
 };
 
+/**
+ * Emitted by /clear, plan-mode exit, and fresh-session flows. The surface should mount a fresh transcript under new_conversation_id and reset any cached session title. From internal QueryEvent 'conversation_reset'.
+ */
+export declare type SDKConversationResetMessage = {
+    type: 'conversation_reset';
+    new_conversation_id: UUID;
+    uuid: UUID;
+    session_id: string;
+};
+
 export declare type SDKDeferredToolUse = {
     id: string;
     name: string;
@@ -3769,7 +3853,7 @@ export declare type SDKMemoryRecallMessage = {
     session_id: string;
 };
 
-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 | SDKThinkingTokensMessage | SDKSessionStateChangedMessage | SDKWorkerShuttingDownMessage | SDKCommandsChangedMessage | SDKNotificationMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKMemoryRecallMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPermissionDeniedMessage | SDKPromptSuggestionMessage | SDKMirrorErrorMessage | SDKInformationalMessage | SDKConversationResetMessage;
+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.
@@ -4431,6 +4515,13 @@ export declare type SessionMessage = {
     session_id: string;
     message: unknown;
     parent_tool_use_id: string | null;
+    /**
+     * agentId of the subagent that spawned this subagent, or null when this
+     * message belongs to a depth-1 subagent (spawned by the main loop) or to
+     * the main session itself. Sessions whose metadata lacks the field report
+     * null.
+     */
+    parent_agent_id: string | null;
 };
 
 /**
@@ -6117,6 +6208,7 @@ export declare interface Settings {
 
 
 
+
     /**
      * Enable auto-memory for this project. When false, Claude will not read from or write to the auto-memory directory.
      */
@@ -6403,7 +6495,7 @@ export declare function startup(_params?: {
     initializeTimeoutMs?: number;
 }): Promise<WarmQuery>;
 
-declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTaskSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | coreTypes.SDKActiveGoalMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKActiveGoalMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
 
 export declare type StopFailureHookInput = BaseHookInput & {
     hook_event_name: 'StopFailure';