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

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.211",
-  "commit": "17a4b6d7b2ee1936b95e595054c7e7d38fddafb7",
-  "buildDate": "2026-07-15T16:42:49Z",
+  "version": "2.1.213",
+  "commit": "0cb94a506376a17c1cfb782bf57aa9e00c02e9da",
+  "buildDate": "2026-07-17T21:09:37Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "5a728a76198b6eca7f3c7cdbff43bab44b77b48c2108f7a3107d889773382629",
-      "size": 242445680
+      "checksum": "21ae9705d81d071e1fd7bbf5c99508bbf59e3e7202f59582e6e5e51a3db43fbc",
+      "size": 247091504
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "33049eb14cf4702b992b7eda41ec077fc6e76539f7fd046e6d32538757235da4",
-      "size": 251966736
+      "checksum": "53007095add4b16e5b028a20a9c096ae35ae7ef2d0af81dc38511bf3160fae39",
+      "size": 256507024
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "1fff7e8f947c07b19d10b1fbf714b7e547e9536253b9b58230d8adbc4624f867",
-      "size": 258849520
+      "checksum": "b4d9fad8d16f1f4c25da4718ebfb824c7e244da4eb325076f3ed1b7489f1440c",
+      "size": 261995424
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "8272c8a474ac9ea1bc35f19b9f7c7e7dc4dc4eb6d5ad3e484b19335ac72446b2",
-      "size": 262023992
+      "checksum": "7999631426e1b6e4444e4ecf9cd8a63a05a0411ccfe503927d4c9d57bc41bc64",
+      "size": 265206768
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "ca094a85ea464b2ebec2ecfcc9e2c056573d4ca95ebe12ffae2c7dccb722e17b",
-      "size": 252097720
+      "checksum": "8d686b38557f784b6fd027406bcc1737a57a8e527471654fe3f4eacd0ed831a3",
+      "size": 255243624
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "c99bd7934ac841d5be6ee7d3644cb63bccef2cd495c6c1bb982a1b1deac1b466",
-      "size": 256680320
+      "checksum": "b9b1eeee76734ba33384e729be01b329fbf924aa121282396f7fd5e31150e829",
+      "size": 259834448
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "3d8509ae7de11d77dbdc711aa320fc6d5064ce795464a8670696611b57093caf",
-      "size": 253293728
+      "checksum": "c4cb68bcf4c440964854cd42a585c5b1b99d090a59ced1c49bfe6709a429dde8",
+      "size": 256217248
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "a0f9bab0dbdda9b43a8765d54e329e44484d9dd7d4f40cf31db6eee27a2da41c",
-      "size": 247643808
+      "checksum": "11dec255633e6f28b7860f0827a309a0c446aa04a2a0b93124b974050ada9ac7",
+      "size": 250592928
     }
   },
   "sdkCompat": {
@@ -58,6 +58,7 @@
       "0.3.196",
       "0.3.197",
       "0.3.198",
+      "0.3.200",
       "0.3.201",
       "0.3.202",
       "0.3.204",

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.211",
-  "commit": "17a4b6d7b2ee1936b95e595054c7e7d38fddafb7",
-  "buildDate": "2026-07-15T16:44:23Z",
+  "version": "2.1.213",
+  "commit": "0cb94a506376a17c1cfb782bf57aa9e00c02e9da",
+  "buildDate": "2026-07-17T21:11:40Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "96e6bc497e39cecdb63ac449f26d3eca54870e1d73fe4664c816f5e38440112e",
-      "size": 49913141,
+      "checksum": "03adc5431aa90a45af3dbf2d7c7f7b834985e8ad51ef285df402ab19b52ef71c",
+      "size": 51095888,
       "bundle": {
-        "checksum": "6d0cabcaee7f2fdc7c37a14eacd5cffaafaf6fb16d59225c464de426d4634bb4",
-        "size": 49917482
+        "checksum": "ad5e39770ff997271a683b12a5e26d2a2c6d2acb63e190fab404c28f02eca530",
+        "size": 51109732
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "bec7a90b476f28af6d572f07dc553b75bd31215ef13ac470fec30e23636444ee",
-      "size": 54366611,
+      "checksum": "7768f3b73319c9021fc54b493140ab165b6e1096f13a0af19c1686b2b2382964",
+      "size": 55511867,
       "bundle": {
-        "checksum": "d97f221e917e337911e2b6b0897b22fd2361428627b6e0324e0561218858c6d4",
-        "size": 54363292
+        "checksum": "055e74c69ec208b26a9a5ac4fa2b05a8cca147e233b13e609aadcd468a554de2",
+        "size": 55516320
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "d9c04a9c1ce0e795c9e6de00bb77415fcdd291d2c9e2ef26f9c6d86cb666ddf3",
-      "size": 58963439
+      "checksum": "622ab983025357ff61c596b534dc5e8f9ac865e290b8ae405e1b5d9997637687",
+      "size": 59892220
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "f90ff81999ed7d0b509db2a750d1f148d4814eef44cea68ed99c315b02672b6c",
-      "size": 60275709
+      "checksum": "e6dbb95c1442c42502f09376379e66cea25329a4b7f90da2cba3a36698b56c96",
+      "size": 61177833
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "4435a40b0ec723721a4f974d0afc26877576228ba40368f51f6ae7ef08221dac",
-      "size": 57686071
+      "checksum": "2941bddf3dc34ec53d719ea6a20689b878c26b85c0dbb3b84a721b33bb49e4c9",
+      "size": 58545838
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "1b10c1ff37f4aa689c0d87ab929e01b4ecc945f9434767f0ec3b125e217863e3",
-      "size": 59054974
+      "checksum": "bb529d4cb52ab574a646ef3a1acba1978ca66d7a6e866ab31c8730e8f5b16744",
+      "size": 59977021
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "34f136939b7df0a1eca476f58ec8ba00621926963a76f1db8aa132b21042fe2b",
-      "size": 60660958
+      "checksum": "a4943d1f718f7b0dd334ef9d2aa4ba40ab99955febd4fe06f14abc74e421939f",
+      "size": 61316825
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "c923a9f914d8667443e8f4ba9ae09c6a674dd0c27f3360cdf0082c9fa28259b3",
-      "size": 58633026
+      "checksum": "881e3bf4797a8f691c10dcec757de566109973c366eb04590c050c5402d36825",
+      "size": 59303495
     }
   },
   "sdkCompat": {
@@ -66,6 +66,7 @@
       "0.3.196",
       "0.3.197",
       "0.3.198",
+      "0.3.200",
       "0.3.201",
       "0.3.202",
       "0.3.204",

package/package.json

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

package/sdk-tools.d.ts

@@ -30,6 +30,7 @@ export type ToolInputSchemas =
   | WebFetchInput
   | WebSearchInput
   | AskUserQuestionInput
+  | SendFeedbackInput
   | ClaudeDesignInput
   | ProjectsInput
   | EnterPlanModeInput
@@ -46,6 +47,7 @@ export type ToolInputSchemas =
   | RemoteTriggerInput
   | ShowOnboardingRolePickerInput
   | MonitorInput
+  | ProposeSkillsInput
   | ArtifactInput
   | PushNotificationInput
   | EnterWorktreeInput
@@ -72,6 +74,7 @@ export type ToolOutputSchemas =
   | WebFetchOutput
   | WebSearchOutput
   | AskUserQuestionOutput
+  | SendFeedbackOutput
   | EnterWorktreeOutput
   | ExitWorktreeOutput
   | TaskCreateOutput
@@ -83,6 +86,7 @@ export type ToolOutputSchemas =
   | ShowOnboardingRolePickerOutput
   | ScheduleWakeupOutput
   | MonitorOutput
+  | ProposeSkillsOutput
   | EnterPlanModeOutput
   | REPLOutput
   | WorkflowOutput
@@ -102,6 +106,7 @@ export type AgentOutput =
         citations?: unknown[] | null;
       }[];
       resolvedModel?: string;
+      modelsUsed?: string[];
       totalToolUseCount: number;
       totalDurationMs: number;
       totalTokens: number;
@@ -150,9 +155,13 @@ export type AgentOutput =
        */
       description: string;
       /**
-       * Model the spawn resolved (may differ from the requested one)
+       * Model in use at the backgrounding transition (a pre-background swap is reflected here)
        */
       resolvedModel?: string;
+      /**
+       * Ordered distinct models used before backgrounding (length > 1 means a mid-run swap)
+       */
+      modelsUsed?: string[];
       /**
        * The prompt for the agent
        */
@@ -501,7 +510,7 @@ export interface AgentInput {
    */
   team_name?: string;
   /**
-   * Permission mode for spawned teammate (e.g., "plan" to require plan approval).
+   * Deprecated; ignored. Subagents inherit the parent session's permission mode; agent-definition frontmatter may override it.
    */
   mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | "bubble";
   /**
@@ -779,6 +788,10 @@ export interface ReportFindingsInput {
      * One-sentence statement of the defect
      */
     summary: string;
+    /**
+     * Compressed label for compact UI (≤60 chars): the claim alone, no rationale or consequence clause
+     */
+    short_summary?: string;
     /**
      * Concrete inputs/state → wrong output/crash
      */
@@ -2408,6 +2421,24 @@ export interface AskUserQuestionInput {
     source?: string;
   };
 }
+export interface SendFeedbackInput {
+  /**
+   * What kind of feedback this is.
+   */
+  type: "bug" | "idea" | "missing_capability";
+  /**
+   * Short, specific one-line summary of the issue.
+   */
+  title: string;
+  /**
+   * Factual, reproducible report: what was attempted, what happened, exact error text if short, repro steps. No speculation, no secrets.
+   */
+  details: string;
+  /**
+   * Optional short tag naming the part of Claude Code this is about (e.g. "hooks config", "/help", "file editing"). Leave blank if unclear.
+   */
+  area?: string;
+}
 export interface ClaudeDesignInput {
   /**
    * Claude Design action to perform. Call with "list" first to discover the available operations and their argument schemas.
@@ -2643,6 +2674,157 @@ export interface MonitorInput {
     protocols?: string[];
   };
 }
+export interface ProposeSkillsInput {
+  /**
+   * @minItems 1
+   * @maxItems 3
+   */
+  proposals:
+    | [
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Existing skill name to amend. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * one line shown on the card
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * complete SKILL.md draft (frontmatter + Trigger/Steps/Verification body)
+           */
+          skillMd: string;
+        }
+      ]
+    | [
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Existing skill name to amend. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * one line shown on the card
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * complete SKILL.md draft (frontmatter + Trigger/Steps/Verification body)
+           */
+          skillMd: string;
+        },
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Existing skill name to amend. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * one line shown on the card
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * complete SKILL.md draft (frontmatter + Trigger/Steps/Verification body)
+           */
+          skillMd: string;
+        }
+      ]
+    | [
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Existing skill name to amend. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * one line shown on the card
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * complete SKILL.md draft (frontmatter + Trigger/Steps/Verification body)
+           */
+          skillMd: string;
+        },
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Existing skill name to amend. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * one line shown on the card
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * complete SKILL.md draft (frontmatter + Trigger/Steps/Verification body)
+           */
+          skillMd: string;
+        },
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Existing skill name to amend. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * one line shown on the card
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * complete SKILL.md draft (frontmatter + Trigger/Steps/Verification body)
+           */
+          skillMd: string;
+        }
+      ];
+}
 export interface ArtifactInput {
   /**
    * 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.
@@ -2681,7 +2863,7 @@ export interface ArtifactInput {
    */
   url?: string;
   /**
-   * Overwrite without a conflict check. Use only after a 409 when you have reconciled with the other session's version and intend to replace it. Omit (or false) to send baseVersion so a concurrent write 409s instead of being silently clobbered.
+   * Overwrite without a conflict check. Use only after a 409 when you have reconciled with the other session's version and intend to replace it. The tracked baseVersion is always sent; with force:true the server treats it as informational and overwrites. Omit (or false) so a concurrent write 409s instead of being silently clobbered.
    */
   force?: boolean;
 }
@@ -3101,6 +3283,10 @@ export interface ReportFindingsOutput {
      * One-sentence statement of the defect
      */
     summary: string;
+    /**
+     * Compressed label for compact UI (≤60 chars): the claim alone, no rationale or consequence clause
+     */
+    short_summary?: string;
     /**
      * Concrete inputs/state → wrong output/crash
      */
@@ -3393,6 +3579,10 @@ export interface AskUserQuestionOutput {
    */
   afkTimeoutMs?: number;
 }
+export interface SendFeedbackOutput {
+  success: boolean;
+  message: string;
+}
 export interface EnterWorktreeOutput {
   worktreePath: string;
   worktreeBranch?: string;
@@ -3488,6 +3678,12 @@ export interface MonitorOutput {
    */
   persistent?: boolean;
 }
+export interface ProposeSkillsOutput {
+  /**
+   * Number of proposals shown on the review card
+   */
+  proposalCount: number;
+}
 export interface EnterPlanModeOutput {
   /**
    * Confirmation that plan mode was entered

package/sdk.d.ts

@@ -29,7 +29,7 @@ export declare type AccountInfo = {
     /**
      * Active API backend. Anthropic OAuth login only applies when "firstParty"; for 3P providers the other fields are absent and auth is external (AWS creds, gcloud ADC, etc.). "gateway" means the CLI is authenticated against an enterprise gateway.
      */
-    apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws' | 'mantle' | 'gateway';
+    apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws' | 'anthropicGoogleCloud' | 'mantle' | 'gateway';
 };
 
 /**
@@ -251,6 +251,18 @@ export declare type CanUseTool = (toolName: string, input: Record<string, unknow
      * must echo this value for the worker to match it.
      */
     requestId: string;
+    /**
+     * Set when a user-configured ask RULE (permissions.ask) forced this
+     * prompt while the ask carries the tool's own decisionReason. Hosts
+     * making policy on the reason (e.g. auto-deny a safetyCheck) or
+     * running host-side auto-approval should treat asks carrying this
+     * field as rule-forced: the user's stated intent is a human prompt.
+     */
+    matchedAskRule?: {
+        source: string;
+        toolName: string;
+        ruleContent?: string;
+    };
 }) => Promise<PermissionResult | null>;
 
 export declare type ConfigChangeHookInput = BaseHookInput & {
@@ -2326,9 +2338,13 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      *
      * @param settings - A partial settings object to merge into the flag settings.
      * Each top-level key also accepts `null` to clear it from the flag layer.
+     * `effortLevel` additionally accepts `'max'`, which is session-scoped: it
+     * applies for the rest of the session on models that support it and is
+     * never persisted to settings files (the persisted
+     * {@link Settings.effortLevel} excludes it for that reason).
      */
     applyFlagSettings(settings: {
-        [K in keyof Settings]?: Settings[K] | null;
+        [K in keyof Settings]?: K extends 'effortLevel' ? EffortLevel | null : Settings[K] | null;
     }): Promise<void>;
     /**
      * Get the full initialization result, including supported commands, models,
@@ -2816,6 +2832,10 @@ export declare type SDKAssistantMessage = {
      * 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.
      */
     supersedes?: UUID[];
+    /**
+     * True when this assistant message was truncated by an interrupt/abort before the stream completed: stop_reason was never received and the content may end mid-word. Absent on normally completed messages.
+     */
+    aborted?: true;
     /**
      * Subagent type that produced this message.
      */
@@ -3536,22 +3556,37 @@ declare type SDKControlPermissionRequest = {
     input: Record<string, unknown>;
     permission_suggestions?: coreTypes.PermissionUpdate[];
     blocked_path?: string;
+    /**
+     * Human-readable reason the ask escalated, for the consent line of the host's dialog. For decision_reason_type "subcommandResults" (compound bash), this is the NESTED safety check's warning text — the wrapper itself has no text — preferring a check that requires manual approval (classifier_approvable false); treat it with the same display/policy care as a "safetyCheck" reason. May carry ANSI escapes; sanitize before rendering.
+     */
     decision_reason?: string;
     /**
-     * Structured discriminator for why auto-mode escalated. Lets SDK hosts make policy (e.g. auto-deny safetyCheck) without parsing decision_reason text. For compound bash commands this is "subcommandResults" even when a safetyCheck is nested inside — check classifier_approvable for that case.
+     * Structured discriminator for why auto-mode escalated. Lets SDK hosts make policy (e.g. auto-deny safetyCheck) without parsing decision_reason text. For compound bash commands this is "subcommandResults" even when a safetyCheck is nested inside — check classifier_approvable for that case, and see decision_reason: for this variant it carries the nested safety check's warning text.
      */
     decision_reason_type?: 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'sandboxOverride' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
     /**
      * Set when a safetyCheck is present anywhere in the decision reason (including nested inside subcommandResults for compound bash). false = at least one safety check requires manual approval (e.g. Windows path bypass, dangerous rm); true = all safety checks MAY be classifier-approved (e.g. sensitive-file paths). Absent when no safetyCheck is involved.
      */
     classifier_approvable?: boolean;
+    /**
+     * True when the dialog must not offer the persistent "don't ask again" row for this ask: accepting it would write a whole-tool allow rule broader than the ask's own verb (PermissionAskDecision.suppressAlwaysAllowRule). Hosts rendering approve options should omit any persistent-rule affordance when set.
+     */
+    suppress_always_allow_rule?: boolean;
+    /**
+     * Set when a user-configured ask RULE (permissions.ask) forced this prompt but the ask carries the tool's own decision_reason — the ask-rule substitution keeps the richer tool-minted ask, so the rule rides here instead of decision_reason_type 'rule'. Hosts making policy on decision_reason_type (e.g. auto-deny safetyCheck) or running host-side auto-approval should treat asks carrying this field as rule-forced: the user's stated intent is a human prompt. Values are producer-authored but render-unsafe like decision_reason; sanitize before display.
+     */
+    matched_ask_rule?: {
+        source: string;
+        tool_name: string;
+        rule_content?: string;
+    };
     title?: string;
     display_name?: string;
     tool_use_id: string;
     agent_id?: string;
     description?: string;
     /**
-     * True when the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction()). SDK hosts must not offer one-tap Approve/Deny for these — the user has to open the session and respond on the card itself.
+     * True when one-tap Approve/Deny must not be offered: the tool's approval card IS the user-interaction surface (Tool.requiresUserInteraction() — the user responds on the card itself), OR the pending ask is localDisplayOnly (its consent disclosure cannot ride this wire and only the local dialog renders it). Either way the user has to open the session to answer.
      */
     requires_user_interaction?: boolean;
 };
@@ -3610,6 +3645,10 @@ export declare type SDKControlReloadPluginsResponse = {
         name: string;
         path: string;
         source?: string;
+        /**
+         * The plugin's version as declared in its plugin.json manifest, emitted verbatim (plugin-author-controlled — validate before trusting). Omitted when the manifest declares no version.
+         */
+        version?: string;
     }[];
     mcpServers: coreTypes.McpServerStatus[];
     error_count: number;
@@ -3726,6 +3765,7 @@ declare type SDKControlSetMaxThinkingTokensRequest = {
 declare type SDKControlSetModelRequest = {
     subtype: 'set_model';
     model?: string;
+
 };
 
 /**
@@ -3957,6 +3997,10 @@ export declare type SDKMessageOrigin = {
     body?: string;
 } | {
     kind: 'task-notification';
+    /**
+     * Present when the delivery is the fired stored prompt of a scheduled task/routine (stamped from server-asserted provenance; the schedule attests storage, not authorship). The harness frames it as the session's assigned task instead of the generic background-notification frame. Absent on webhook, PR-steward, plugin, and background-event deliveries.
+     */
+    subkind?: 'scheduled-trigger';
 } | {
     kind: 'coordinator';
 } | {
@@ -4330,6 +4374,10 @@ export declare type SDKSystemMessage = {
         name: string;
         path: string;
 
+        /**
+         * The plugin's version as declared in its plugin.json manifest, emitted verbatim (plugin-author-controlled — validate before trusting). Omitted when the manifest declares no version.
+         */
+        version?: string;
     }[];
 
 
@@ -4449,6 +4497,16 @@ export declare type SDKToolProgressMessage = {
     task_id?: string;
     uuid: UUID;
     session_id: string;
+    heartbeat?: boolean;
+    subagent_type?: string;
+    subagent_retry?: {
+        agent_id: string;
+        attempt: number;
+        max_retries: number;
+        retry_delay_ms: number;
+        error_status: number | null;
+        error_category: string;
+    };
 };
 
 export declare type SDKToolUseSummaryMessage = {
@@ -4637,7 +4695,7 @@ export declare type SessionMutationOptions = {
 
 export declare type SessionStartHookInput = BaseHookInput & {
     hook_event_name: 'SessionStart';
-    source: 'startup' | 'resume' | 'clear' | 'compact';
+    source: 'startup' | 'resume' | 'clear' | 'compact' | 'fork';
     agent_type?: string;
     model?: string;
     session_title?: string;
@@ -6142,6 +6200,10 @@ export declare interface Settings {
      * Probability (0–1) that the session quality survey appears when eligible. 0.05 is a reasonable starting point.
      */
     feedbackSurveyRate?: number;
+    /**
+     * Model-drafted feedback (the SendFeedback tool). "notify" (default) shows a one-line notice when a draft is queued; "quiet" shows only the footer counter; "off" disables the tool entirely so drafts are never queued.
+     */
+    feedbackDrafts?: 'notify' | 'quiet' | 'off';
     /**
      * Whether to show tips in the spinner
      */