@anthropic-ai/claude-agent-sdk 0.3.197 → 0.3.198

package/manifest.json

@@ -1,47 +1,47 @@
 {
-  "version": "2.1.197",
-  "commit": "c8fd8048f30950a21d28734718275aa7e97f5143",
-  "buildDate": "2026-06-29T19:16:30Z",
+  "version": "2.1.198",
+  "commit": "b80c496480ebf28e6dfe755cf0b8e3dd1d7cba1f",
+  "buildDate": "2026-07-01T06:17:25Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "8cc0c4d1e4eb1dca3b0cc92ab02ee3505de764e023f8c901761c167b72041fb8",
-      "size": 227251472
+      "checksum": "ab6f7ee109816ede414f7c285446633f805b623aa609f425609a64266451d61e",
+      "size": 229328464
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "5e8a57cc7a92377f0744fa4c79191cf93d4b26c79cb919b07a407511fed1be26",
-      "size": 235288016
+      "checksum": "280b6cfc60dacc4caed31af1249e53c259c01759556e60633944c02405c82dd0",
+      "size": 238706000
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "fb48473c467c27615ac799a754f4ef0b68c363e4596cefbb59c3815d51a0cc8a",
-      "size": 242334448
+      "checksum": "99b50a6f2b1f3ef07bcaf1e58a2f9883c470c84e428afa321972b1aa20372e9a",
+      "size": 245742320
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "f54e69cbc89b2da61a415700af7ff52a147e862517d4f1b0eecf768448cf7f83",
-      "size": 245517112
+      "checksum": "7066af42a5fe93038c13af5072d4c034dc3928092cb121fdd892c76b94b6b84d",
+      "size": 248900408
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "acb885610ba06d90c46206ded9b14121bc30e96affecbfb3c37d511bf02af2bd",
-      "size": 235582648
+      "checksum": "88cb391085e419457569bcc57a672f734f30b424e17df7323f3bbb421238e801",
+      "size": 238990520
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "2f610c0f81341052426981b5dc59277a33e6ec3df924071b24edbc05e6a096dc",
-      "size": 240202112
+      "checksum": "42892159a03bee492926b616b1270313544f7a52b68d32cb680e91984a4c6659",
+      "size": 243589504
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "038bd9fe90c60304601e19751269a50d62925c541dd6a2b3da5274549e9416ee",
-      "size": 236121248
+      "checksum": "6afd07cb03aa981c5e918808f53a1e2b729015b695122a944f6e41aaf5393933",
+      "size": 239292064
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "8d2baeaf77b0e79ea33cf5ce78a37e64804c3a26d63d35355a830fda404a4f61",
-      "size": 230588064
+      "checksum": "10a6d21332f674c87f52b1dc09926945d0169f1bb82aced84ada100639ab70bc",
+      "size": 233758880
     }
   }
 }

package/manifest.zst.json

@@ -1,55 +1,55 @@
 {
-  "version": "2.1.197",
-  "commit": "c8fd8048f30950a21d28734718275aa7e97f5143",
-  "buildDate": "2026-06-29T19:18:17Z",
+  "version": "2.1.198",
+  "commit": "b80c496480ebf28e6dfe755cf0b8e3dd1d7cba1f",
+  "buildDate": "2026-07-01T06:19:10Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "9b11f0d6c9ce73434bf75440eb19f339c47e099da6d53c481cda1a9c6e693a7d",
-      "size": 47889227,
+      "checksum": "7bc5ee873344f53ca0ea0d7ae48c77c3787aa8f437d5aeb33a6a6d83ab8d813f",
+      "size": 47036104,
       "bundle": {
-        "checksum": "c921aa65eb8f10a3f387a86526f97b94dee721f26b741dadf0d2357ac376c437",
-        "size": 47903450
+        "checksum": "e84cec46ebd581937b5128e7be4f3e8788b13947bf4040a699d3404478f4bc57",
+        "size": 47034441
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "a1dc9d160ae29aff4373dec60623111080fe2c645a21f25c96dd2b443ee184e6",
-      "size": 50919995,
+      "checksum": "b70b7a3d9f3fdb675e119bca0c1632d810aacdefadee1da5e82ebb77cbabd124",
+      "size": 51377668,
       "bundle": {
-        "checksum": "f2d6011db80732e4f0850d5c27e0ce83bb4d2c4a66374072134232214dddedab",
-        "size": 50915693
+        "checksum": "c8eb65cce724f80d4467c9850e0643cbab91e1d66fa88b21ea17f398c7835d50",
+        "size": 51390885
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "e5f4307ad01f9720878ce4088331f33722cdd610aaa1d0026260ca9ced498030",
-      "size": 55692187
+      "checksum": "4d9f42ab338ead6a6e9b9738a6d1ec7ba9a0737acbc8cf7f09099172b6ff16d7",
+      "size": 56120743
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "bbb773dbaaa24c20d564ae83ce906d9b676c3ccb8f092176722bcbc5016d957b",
-      "size": 56956227
+      "checksum": "dc7986a7fad5958bfe4bf9eaf14936da2bafb283de7b80ca3e2e1878620873fe",
+      "size": 57376892
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "55464849825a33e23de886656a1b7e2bdaa0edc21854c88f9e5468ac97997f1d",
-      "size": 54362236
+      "checksum": "55c5691e89c947a04777a7e2711c7bfe1589cf1783ff47ae25ad277bef9f4aeb",
+      "size": 54805858
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "506a64a81005e1cd7b4b540061b10f6de62297a456a47070894faa994e1cf5eb",
-      "size": 55764001
+      "checksum": "d0eecbaa59489d9282fbfccabf010feadb3c212e6a40b7e3e112d1c07c6cf300",
+      "size": 56180603
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "e5a97e820e244ddfef2f3fd61e7dbc15daed49615ab9ec7f7946256aca565456",
-      "size": 57090391
+      "checksum": "f9ce31065214cba9a1838b4eafd00f004002389a1ee87c45ca00d901fbc03129",
+      "size": 57521925
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "e75b4797151ea6eba808d353759b28a22d6c1cf12cc327f349fdeef414607ecc",
-      "size": 55093687
+      "checksum": "f4c7b7c80da3f07dea7d13530eeea321db4380a9da4bc1a1010c13e7e8ea6736",
+      "size": 55546586
     }
   }
 }

package/package.json

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

package/sdk-tools.d.ts

@@ -428,7 +428,7 @@ export interface AgentInput {
    */
   model?: "sonnet" | "opus" | "haiku" | "fable";
   /**
-   * Set to true to run this agent in the background. You will be notified when it completes.
+   * Agents run in the background by default; you will be notified when one completes. Set to false to run this agent synchronously when you need its result before continuing.
    */
   run_in_background?: boolean;
   /**
@@ -630,7 +630,7 @@ export interface GrepInput {
 }
 export interface TaskStopInput {
   /**
-   * The ID of the background task to stop
+   * The ID of the background task to stop. Agent-team teammates and named background agents are also accepted by agent ID or name.
    */
   task_id?: string;
   /**
@@ -3271,6 +3271,10 @@ export interface AskUserQuestionOutput {
       notes?: string;
     };
   };
+  /**
+   * Set when the dialog auto-resolved after this many milliseconds of idle (user away from keyboard). Absent on every human-resolved path.
+   */
+  afkTimeoutMs?: number;
 }
 export interface EnterWorktreeOutput {
   worktreePath: string;
@@ -3327,7 +3331,13 @@ export interface ArtifactOutput {
   path: string;
   title?: string;
   version?: string;
-  mcpDropped?: string;
+  capabilities?: unknown;
+  stored?: {
+    contract: string;
+    capabilities?: {
+      [k: string]: unknown;
+    };
+  };
 }
 export interface RemoteTriggerOutput {
   status: number;

package/sdk.d.ts

@@ -985,6 +985,7 @@ export declare type McpHttpServerConfig = {
      * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
      */
     timeout?: number;
+
     /**
      * When true, all tools from this server are always included in the prompt and never deferred behind tool search. Equivalent to setting defer_loading: false on the API. Default: tools are deferred when tool search is enabled. As a side effect this also blocks startup until the server is connected (capped at the standard 5s connect timeout) even though MCP startup is otherwise non-blocking by default, since the tools must be present when the turn-1 prompt is built.
      */
@@ -1099,6 +1100,7 @@ export declare type McpSSEServerConfig = {
      * Per-server tool-call timeout in milliseconds. Overrides the MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock limit per call; progress notifications do not extend it. Values below 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
      */
     timeout?: number;
+
     /**
      * When true, all tools from this server are always included in the prompt and never deferred behind tool search. Equivalent to setting defer_loading: false on the API. Default: tools are deferred when tool search is enabled. As a side effect this also blocks startup until the server is connected (capped at the standard 5s connect timeout) even though MCP startup is otherwise non-blocking by default, since the tools must be present when the turn-1 prompt is built.
      */
@@ -3302,6 +3304,13 @@ declare type SDKControlInterruptRequest = {
 
 };
 
+/**
+ * Requests the worker's selectable model catalog. Fulfills the caps.modelCatalog capability: in a remote thin-client session the worker's provider, settings cascade, and enforcement policy decide which models the session can run, so the thin client must ask rather than read its own getModelOptions().
+ */
+declare type SDKControlListModelsRequest = {
+    subtype: 'list_models';
+};
+
 /**
  * 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.
  */
@@ -3467,7 +3476,7 @@ export declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlSetColorRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetSessionCostRequest | SDKControlGetUsageRequest | SDKControlGetBinaryVersionRequest | SDKControlMcpCallRequest | SDKControlFileSuggestionsRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlReadFileRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlRegisterRepoRootRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlSetMcpPermissionModeOverrideRequest | SDKControlRewindConversationRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlStageFileRequest | SDKControlAddDirectoryRequest | 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 | SDKControlSetMcpPermissionModeOverrideRequest | SDKControlRewindConversationRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlUltrareviewLaunchRequest | SDKControlStageFileRequest | SDKControlAddDirectoryRequest | SDKControlMessageRatedRequest | SDKControlOAuthTokenRefreshRequest | SDKControlHostAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest | SDKControlSubmitFeedbackRequest;
 
 /**
  * Requests the SDK consumer to render a tool-driven blocking dialog and return the user choice. Used by tools that previously rendered Ink JSX via setToolJSX with an onDone callback.
@@ -3724,7 +3733,7 @@ export declare type SDKMemoryRecallMessage = {
     session_id: string;
 };
 
-export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | 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;
+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;
 
 /**
  * Provenance of a user-role message (peer session, team lead, channel). Absent or `human` means keyboard input from the user.
@@ -5023,7 +5032,7 @@ export declare interface Settings {
      */
     disableArtifact?: boolean;
     /**
-     * Enable or disable the Artifact tool for this user. Unset = default by plan once the feature is available.
+     * Enable or disable the Artifact tool for this user. Unset defaults to enabled once the feature is available.
      */
     enableArtifact?: boolean;
     /**
@@ -6340,7 +6349,7 @@ export declare function startup(_params?: {
     initializeTimeoutMs?: number;
 }): Promise<WarmQuery>;
 
-declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTaskSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKPostTurnSummaryMessage | coreTypes.SDKTaskSummaryMessage | coreTypes.SDKTranscriptMirrorMessage | coreTypes.SDKActiveGoalMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
 
 export declare type StopFailureHookInput = BaseHookInput & {
     hook_event_name: 'StopFailure';