@anthropic-ai/sdk 0.114.0 → 0.116.0

package/src/resources/beta/sessions/sessions.ts

@@ -32,6 +32,7 @@ import {
   BetaManagedAgentsModelRateLimitedError,
   BetaManagedAgentsModelRequestFailedError,
   BetaManagedAgentsPlainTextDocumentSource,
+  BetaManagedAgentsRedactedBlock,
   BetaManagedAgentsRetryStatusExhausted,
   BetaManagedAgentsRetryStatusRetrying,
   BetaManagedAgentsRetryStatusTerminal,
@@ -39,6 +40,7 @@ import {
   BetaManagedAgentsSearchResultCitations,
   BetaManagedAgentsSearchResultContent,
   BetaManagedAgentsSendSessionEvents,
+  BetaManagedAgentsSessionBudgetReached,
   BetaManagedAgentsSessionDeletedEvent,
   BetaManagedAgentsSessionEndTurn,
   BetaManagedAgentsSessionErrorEvent,
@@ -55,6 +57,7 @@ import {
   BetaManagedAgentsSessionThreadStatusRescheduledEvent,
   BetaManagedAgentsSessionThreadStatusRunningEvent,
   BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+  BetaManagedAgentsSessionUsageSnapshot,
   BetaManagedAgentsSpanModelRequestEndEvent,
   BetaManagedAgentsSpanModelRequestStartEvent,
   BetaManagedAgentsSpanModelUsage,
@@ -293,6 +296,21 @@ export class Sessions extends APIResource {
 export type BetaManagedAgentsSessionsBidirectionalPageCursor =
   BidirectionalPageCursor<BetaManagedAgentsSession>;
 
+/**
+ * Platform advisor roster entry: a model the session's primary thread may consult
+ * mid-turn. At most one per roster; the entry occupies the roster name
+ * `anthropic.advisor`.
+ */
+export interface BetaManagedAgentsAdvisorParams {
+  /**
+   * A Claude model id. The model must be permitted as an advisor for this agent's
+   * model — see the sessions/threads/advisor spec.
+   */
+  model: string;
+
+  type: 'advisor';
+}
+
 export interface BetaManagedAgentsAgentMessagePreview {
   /**
    * The id the buffered agent.message will carry if it is emitted. Matches the
@@ -394,6 +412,19 @@ export interface BetaManagedAgentsBranchCheckout {
   type: 'branch';
 }
 
+/**
+ * A hard spend ceiling. The session stops issuing new model requests once the
+ * tracked list cost reaches `max_list_cost`.
+ */
+export interface BetaManagedAgentsBudgetLimit {
+  /**
+   * A monetary amount in a specific currency.
+   */
+  max_list_cost: BetaAPI.BetaMonetaryAmount;
+
+  type: 'limit';
+}
+
 /**
  * Prompt-cache creation token usage broken down by cache lifetime.
  */
@@ -549,7 +580,7 @@ export interface BetaManagedAgentsMultiagent {
    * Agents the coordinator may spawn as session threads, each resolved to a specific
    * version.
    */
-  agents: Array<AgentsAPI.BetaManagedAgentsAgentReference>;
+  agents: Array<AgentsAPI.BetaManagedAgentsAgentReference | AgentsAPI.BetaManagedAgentsAdvisor>;
 
   type: 'coordinator';
 }
@@ -579,7 +610,8 @@ export interface BetaManagedAgentsMultiagentParams {
 export type BetaManagedAgentsMultiagentRosterEntryParams =
   | string
   | BetaManagedAgentsAgentParams
-  | AgentsAPI.BetaManagedAgentsMultiagentSelfParams;
+  | AgentsAPI.BetaManagedAgentsMultiagentSelfParams
+  | BetaManagedAgentsAdvisorParams;
 
 /**
  * Evaluation state for a single outcome defined via a define_outcome event.
@@ -622,6 +654,21 @@ export interface BetaManagedAgentsOutcomeEvaluationResource {
   type: 'outcome_evaluation';
 }
 
+/**
+ * Cumulative count of server-executed tool invocations, broken down by tool.
+ */
+export interface BetaManagedAgentsServerToolUsage {
+  /**
+   * Number of server-executed web fetch requests.
+   */
+  web_fetch_requests?: number;
+
+  /**
+   * Number of server-executed web search requests.
+   */
+  web_search_requests?: number;
+}
+
 /**
  * A Managed Agents `session`.
  */
@@ -639,6 +686,12 @@ export interface BetaManagedAgentsSession {
    */
   archived_at: string | null;
 
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget: BetaManagedAgentsBudgetLimit | null;
+
   /**
    * A timestamp in RFC 3339 format
    */
@@ -763,7 +816,7 @@ export interface BetaManagedAgentsSessionMultiagentCoordinator {
   /**
    * Full `agent` definitions the coordinator may spawn as session threads.
    */
-  agents: Array<AgentsAPI.BetaManagedAgentsSessionThreadAgent>;
+  agents: Array<AgentsAPI.BetaManagedAgentsSessionThreadAgent | AgentsAPI.BetaManagedAgentsAdvisor>;
 
   type: 'coordinator';
 }
@@ -809,6 +862,12 @@ export interface BetaManagedAgentsSessionUpdatedEvent {
    */
   agent?: BetaManagedAgentsSessionAgent | null;
 
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit | null;
+
   /**
    * The session's full metadata bag after the update. Present when the update set
    * non-empty metadata; absent when metadata was unchanged or cleared to empty.
@@ -825,6 +884,14 @@ export interface BetaManagedAgentsSessionUpdatedEvent {
  * Cumulative token usage for a session across all turns.
  */
 export interface BetaManagedAgentsSessionUsage {
+  /**
+   * Cumulative time in seconds during which the session had at least one thread in
+   * running status. Overlapping activity from concurrent threads is counted once,
+   * unlike `stats.active_seconds`, which sums each thread's own active time. This is
+   * the duration the session's runtime cost is priced on.
+   */
+  active_seconds?: number;
+
   /**
    * Prompt-cache creation token usage broken down by cache lifetime.
    */
@@ -840,10 +907,48 @@ export interface BetaManagedAgentsSessionUsage {
    */
   input_tokens?: number;
 
+  /**
+   * A monetary amount in a specific currency.
+   */
+  list_cost?: BetaAPI.BetaMonetaryAmount | null;
+
   /**
    * Total output tokens generated across all turns.
    */
   output_tokens?: number;
+
+  /**
+   * Cumulative count of server-executed tool invocations, broken down by tool.
+   */
+  server_tool_use?: BetaManagedAgentsServerToolUsage | null;
+}
+
+/**
+ * Periodic snapshot of the session's cumulative usage and tracked list cost.
+ */
+export interface BetaManagedAgentsSessionUsageEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  type: 'session.usage';
+
+  /**
+   * Point-in-time snapshot of a session's cumulative usage.
+   */
+  usage: EventsAPI.BetaManagedAgentsSessionUsageSnapshot;
+
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit | null;
 }
 
 /**
@@ -967,6 +1072,12 @@ export interface SessionCreateParams {
    */
   environment_id: string;
 
+  /**
+   * Body param: A hard spend ceiling. The session stops issuing new model requests
+   * once the tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit;
+
   /**
    * Body param: Initial events to send to the `session` at creation, processed in
    * order. Supports `user.message` and `user.define_outcome` events. Maximum 50
@@ -1026,6 +1137,12 @@ export interface SessionUpdateParams {
    */
   agent?: BetaManagedAgentsSessionAgentUpdate;
 
+  /**
+   * Body param: A hard spend ceiling. The session stops issuing new model requests
+   * once the tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit | null;
+
   /**
    * Body param: Metadata patch. Set a key to a string to upsert it, or to null to
    * delete it. Omit the field to preserve.
@@ -1135,11 +1252,13 @@ Sessions.Threads = Threads;
 
 export declare namespace Sessions {
   export {
+    type BetaManagedAgentsAdvisorParams as BetaManagedAgentsAdvisorParams,
     type BetaManagedAgentsAgentMessagePreview as BetaManagedAgentsAgentMessagePreview,
     type BetaManagedAgentsAgentParams as BetaManagedAgentsAgentParams,
     type BetaManagedAgentsAgentThinkingPreview as BetaManagedAgentsAgentThinkingPreview,
     type BetaManagedAgentsAgentWithOverridesParams as BetaManagedAgentsAgentWithOverridesParams,
     type BetaManagedAgentsBranchCheckout as BetaManagedAgentsBranchCheckout,
+    type BetaManagedAgentsBudgetLimit as BetaManagedAgentsBudgetLimit,
     type BetaManagedAgentsCacheCreationUsage as BetaManagedAgentsCacheCreationUsage,
     type BetaManagedAgentsCommitCheckout as BetaManagedAgentsCommitCheckout,
     type BetaManagedAgentsDeletedSession as BetaManagedAgentsDeletedSession,
@@ -1153,6 +1272,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsMultiagentParams as BetaManagedAgentsMultiagentParams,
     type BetaManagedAgentsMultiagentRosterEntryParams as BetaManagedAgentsMultiagentRosterEntryParams,
     type BetaManagedAgentsOutcomeEvaluationResource as BetaManagedAgentsOutcomeEvaluationResource,
+    type BetaManagedAgentsServerToolUsage as BetaManagedAgentsServerToolUsage,
     type BetaManagedAgentsSession as BetaManagedAgentsSession,
     type BetaManagedAgentsSessionAgent as BetaManagedAgentsSessionAgent,
     type BetaManagedAgentsSessionAgentUpdate as BetaManagedAgentsSessionAgentUpdate,
@@ -1160,6 +1280,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
     type BetaManagedAgentsSessionUpdatedEvent as BetaManagedAgentsSessionUpdatedEvent,
     type BetaManagedAgentsSessionUsage as BetaManagedAgentsSessionUsage,
+    type BetaManagedAgentsSessionUsageEvent as BetaManagedAgentsSessionUsageEvent,
     type BetaManagedAgentsStartEvent as BetaManagedAgentsStartEvent,
     type BetaManagedAgentsStartEventPreview as BetaManagedAgentsStartEventPreview,
     type BetaManagedAgentsSystemContentBlock as BetaManagedAgentsSystemContentBlock,
@@ -1203,6 +1324,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsModelRateLimitedError as BetaManagedAgentsModelRateLimitedError,
     type BetaManagedAgentsModelRequestFailedError as BetaManagedAgentsModelRequestFailedError,
     type BetaManagedAgentsPlainTextDocumentSource as BetaManagedAgentsPlainTextDocumentSource,
+    type BetaManagedAgentsRedactedBlock as BetaManagedAgentsRedactedBlock,
     type BetaManagedAgentsRetryStatusExhausted as BetaManagedAgentsRetryStatusExhausted,
     type BetaManagedAgentsRetryStatusRetrying as BetaManagedAgentsRetryStatusRetrying,
     type BetaManagedAgentsRetryStatusTerminal as BetaManagedAgentsRetryStatusTerminal,
@@ -1210,6 +1332,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsSearchResultCitations as BetaManagedAgentsSearchResultCitations,
     type BetaManagedAgentsSearchResultContent as BetaManagedAgentsSearchResultContent,
     type BetaManagedAgentsSendSessionEvents as BetaManagedAgentsSendSessionEvents,
+    type BetaManagedAgentsSessionBudgetReached as BetaManagedAgentsSessionBudgetReached,
     type BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,
     type BetaManagedAgentsSessionErrorEvent as BetaManagedAgentsSessionErrorEvent,
@@ -1225,6 +1348,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsSessionThreadStatusRescheduledEvent as BetaManagedAgentsSessionThreadStatusRescheduledEvent,
     type BetaManagedAgentsSessionThreadStatusRunningEvent as BetaManagedAgentsSessionThreadStatusRunningEvent,
     type BetaManagedAgentsSessionThreadStatusTerminatedEvent as BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+    type BetaManagedAgentsSessionUsageSnapshot as BetaManagedAgentsSessionUsageSnapshot,
     type BetaManagedAgentsSpanModelRequestEndEvent as BetaManagedAgentsSpanModelRequestEndEvent,
     type BetaManagedAgentsSpanModelRequestStartEvent as BetaManagedAgentsSpanModelRequestStartEvent,
     type BetaManagedAgentsSpanModelUsage as BetaManagedAgentsSpanModelUsage,

package/src/resources/beta/sessions/threads/threads.ts

@@ -117,11 +117,9 @@ export interface BetaManagedAgentsSessionThread {
   id: string;
 
   /**
-   * Resolved `agent` definition for a single `session_thread`. Snapshot of the agent
-   * at thread creation time. The multiagent roster is not repeated here; read it
-   * from `Session.agent`.
+   * A session-resolved multiagent roster entry.
    */
-  agent: AgentsAPI.BetaManagedAgentsSessionThreadAgent;
+  agent: AgentsAPI.BetaManagedAgentsSessionThreadAgent | AgentsAPI.BetaManagedAgentsAdvisor;
 
   /**
    * A timestamp in RFC 3339 format
@@ -198,6 +196,13 @@ export type BetaManagedAgentsSessionThreadStatus = 'running' | 'idle' | 'resched
  * Cumulative token usage for a session thread across all turns.
  */
 export interface BetaManagedAgentsSessionThreadUsage {
+  /**
+   * Cumulative time in seconds this thread spent in running status. Equal to
+   * `stats.active_seconds`; surfaced here so a thread's usage carries every quantity
+   * its cost is priced on.
+   */
+  active_seconds?: number;
+
   /**
    * Prompt-cache creation token usage broken down by cache lifetime.
    */
@@ -213,10 +218,20 @@ export interface BetaManagedAgentsSessionThreadUsage {
    */
   input_tokens?: number;
 
+  /**
+   * A monetary amount in a specific currency.
+   */
+  list_cost?: BetaAPI.BetaMonetaryAmount | null;
+
   /**
    * Total output tokens generated across all turns.
    */
   output_tokens?: number;
+
+  /**
+   * Cumulative count of server-executed tool invocations, broken down by tool.
+   */
+  server_tool_use?: SessionsAPI.BetaManagedAgentsServerToolUsage | null;
 }
 
 /**
@@ -258,7 +273,8 @@ export type BetaManagedAgentsStreamSessionThreadEvents =
   | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
   | SessionsAPI.BetaManagedAgentsStartEvent
   | SessionsAPI.BetaManagedAgentsDeltaEvent
-  | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent
+  | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
 
 export interface ThreadRetrieveParams {
   /**

package/src/resources/beta/webhooks.ts

@@ -301,7 +301,8 @@ export type BetaWebhookEventData =
   | BetaWebhookEnvironmentDeletedEventData
   | BetaWebhookMemoryStoreCreatedEventData
   | BetaWebhookMemoryStoreArchivedEventData
-  | BetaWebhookMemoryStoreDeletedEventData;
+  | BetaWebhookMemoryStoreDeletedEventData
+  | BetaWebhookSessionBudgetReachedEventData;
 
 export interface BetaWebhookMemoryStoreArchivedEventData {
   /**
@@ -355,6 +356,19 @@ export interface BetaWebhookSessionArchivedEventData {
   workspace_id: string;
 }
 
+export interface BetaWebhookSessionBudgetReachedEventData {
+  /**
+   * ID of the session that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.budget_reached';
+
+  workspace_id: string;
+}
+
 export interface BetaWebhookSessionCreatedEventData {
   /**
    * ID of the session that triggered the event.
@@ -720,6 +734,7 @@ export declare namespace Webhooks {
     type BetaWebhookMemoryStoreCreatedEventData as BetaWebhookMemoryStoreCreatedEventData,
     type BetaWebhookMemoryStoreDeletedEventData as BetaWebhookMemoryStoreDeletedEventData,
     type BetaWebhookSessionArchivedEventData as BetaWebhookSessionArchivedEventData,
+    type BetaWebhookSessionBudgetReachedEventData as BetaWebhookSessionBudgetReachedEventData,
     type BetaWebhookSessionCreatedEventData as BetaWebhookSessionCreatedEventData,
     type BetaWebhookSessionDeletedEventData as BetaWebhookSessionDeletedEventData,
     type BetaWebhookSessionIdledEventData as BetaWebhookSessionIdledEventData,

package/src/resources/index.ts

@@ -7,10 +7,12 @@ export {
   type BetaAPIError,
   type BetaAuthenticationError,
   type BetaBillingError,
+  type BetaCurrency,
   type BetaError,
   type BetaErrorResponse,
   type BetaGatewayTimeoutError,
   type BetaInvalidRequestError,
+  type BetaMonetaryAmount,
   type BetaNotFoundError,
   type BetaOverloadedError,
   type BetaPermissionError,

package/src/resources/messages/messages.ts

@@ -1260,6 +1260,7 @@ export type Model =
   | 'claude-sonnet-5'
   | 'claude-fable-5'
   | 'claude-mythos-5'
+  | 'claude-opus-5'
   | 'claude-opus-4-8'
   | 'claude-opus-4-7'
   | 'claude-mythos-preview'
@@ -1271,8 +1272,6 @@ export type Model =
   | 'claude-opus-4-5-20251101'
   | 'claude-sonnet-4-5'
   | 'claude-sonnet-4-5-20250929'
-  | 'claude-opus-4-1'
-  | 'claude-opus-4-1-20250805'
   | (string & {});
 
 export interface OutputConfig {
@@ -1303,28 +1302,7 @@ export interface OutputTokensDetails {
 }
 const DEPRECATED_MODELS: {
   [K in Model]?: string;
-} = {
-  'claude-1.3': 'November 6th, 2024',
-  'claude-1.3-100k': 'November 6th, 2024',
-  'claude-instant-1.1': 'November 6th, 2024',
-  'claude-instant-1.1-100k': 'November 6th, 2024',
-  'claude-instant-1.2': 'November 6th, 2024',
-  'claude-3-sonnet-20240229': 'July 21st, 2025',
-  'claude-3-opus-20240229': 'January 5th, 2026',
-  'claude-2.1': 'July 21st, 2025',
-  'claude-2.0': 'July 21st, 2025',
-  'claude-3-7-sonnet-latest': 'February 19th, 2026',
-  'claude-3-7-sonnet-20250219': 'February 19th, 2026',
-  'claude-3-5-haiku-latest': 'February 19th, 2026',
-  'claude-3-5-haiku-20241022': 'February 19th, 2026',
-  'claude-opus-4-0': 'June 15th, 2026',
-  'claude-opus-4-20250514': 'June 15th, 2026',
-  'claude-sonnet-4-0': 'June 15th, 2026',
-  'claude-sonnet-4-20250514': 'June 15th, 2026',
-  'claude-opus-4-1': 'August 5th, 2026',
-  'claude-opus-4-1-20250805': 'August 5th, 2026',
-  'claude-mythos-preview': 'June 30th, 2026',
-};
+} = {};
 
 const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-mythos-preview', 'claude-opus-4-6'];
 
@@ -1443,12 +1421,28 @@ export type RawMessageStreamEvent =
   | RawContentBlockStopEvent;
 
 export interface RedactedThinkingBlock {
+  /**
+   * The contents of this redacted thinking block, returned when portions of the
+   * model's thinking were safety-redacted. This field is opaque and encrypted, with
+   * no readable content.
+   *
+   * Pass `redacted_thinking` blocks back to the API unchanged when continuing a
+   * multi-turn conversation.
+   *
+   * See
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#redacted-thinking-blocks)
+   * for details.
+   */
   data: string;
 
   type: 'redacted_thinking';
 }
 
 export interface RedactedThinkingBlockParam {
+  /**
+   * The `data` value of this redacted thinking block, exactly as returned by the API
+   * in a previous response. Opaque and encrypted; pass it back unchanged.
+   */
   data: string;
 
   type: 'redacted_thinking';
@@ -1583,6 +1577,11 @@ export interface ServerToolUseBlockParam {
 }
 
 export interface SignatureDelta {
+  /**
+   * The `signature` for this thinking block: an opaque value used to verify that the
+   * block was generated by Claude when it is passed back to the API. Delivered in a
+   * `signature_delta` event just before the block's `content_block_stop` event.
+   */
   signature: string;
 
   type: 'signature_delta';
@@ -1766,16 +1765,41 @@ export interface TextEditorCodeExecutionViewResultBlockParam {
 }
 
 export interface ThinkingBlock {
+  /**
+   * A value used to verify that this thinking block was generated by Claude when it
+   * is passed back to the API.
+   *
+   * This is an opaque field and should not be interpreted or parsed. When passing
+   * thinking blocks back to the API (required when using tools with extended
+   * thinking), pass them back exactly as received, with this field intact.
+   *
+   * See
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
+   * for details.
+   */
   signature: string;
 
+  /**
+   * The text of Claude's thinking process for this block.
+   */
   thinking: string;
 
   type: 'thinking';
 }
 
 export interface ThinkingBlockParam {
+  /**
+   * The `signature` value of this thinking block, exactly as returned by the API in
+   * a previous response. Used to verify that the block was generated by Claude.
+   *
+   * Thinking blocks must be passed back unmodified and in their original order; a
+   * modified block results in a 400 `invalid_request_error`.
+   */
   signature: string;
 
+  /**
+   * The `thinking` text of this block as returned by the API.
+   */
   thinking: string;
 
   type: 'thinking';
@@ -1836,6 +1860,11 @@ export interface ThinkingConfigEnabled {
 export type ThinkingConfigParam = ThinkingConfigEnabled | ThinkingConfigDisabled | ThinkingConfigAdaptive;
 
 export interface ThinkingDelta {
+  /**
+   * The incremental `thinking` text for this content block. Concatenate the
+   * `thinking` values of successive `thinking_delta` events to assemble the block's
+   * full `thinking` value.
+   */
   thinking: string;
 
   type: 'thinking_delta';

package/src/tools/agent-toolset/node.browser.ts

@@ -44,6 +44,20 @@ export function resolvePath(_ctx: AgentToolContext, _p: string): Promise<string>
   return nodeOnly('resolvePath');
 }
 
+/**
+ * A bash command exceeded its `timeoutMs`. Carries the timeout so a caller can
+ * tell it apart from an abort without matching on the message text.
+ */
+export class BashTimeoutError extends AnthropicError {
+  readonly timeoutMs: number;
+
+  constructor(timeoutMs: number) {
+    super(`bash command timed out after ${timeoutMs}ms`);
+    this.name = 'BashTimeoutError';
+    this.timeoutMs = timeoutMs;
+  }
+}
+
 export class BashSession {
   constructor(_dir: string, _env?: NodeJS.ProcessEnv) {
     nodeOnly('BashSession');

package/src/tools/agent-toolset/node.ts

@@ -55,6 +55,20 @@ const GREP_OUTPUT_LIMIT = 100 * 1024;
 const GREP_MAX_LINE_LENGTH = 2000;
 const GLOB_RESULT_LIMIT = 200;
 
+/**
+ * A bash command exceeded its `timeoutMs`. Carries the timeout so a caller can
+ * tell it apart from an abort without matching on the message text.
+ */
+export class BashTimeoutError extends AnthropicError {
+  readonly timeoutMs: number;
+
+  constructor(timeoutMs: number) {
+    super(`bash command timed out after ${timeoutMs}ms`);
+    this.name = 'BashTimeoutError';
+    this.timeoutMs = timeoutMs;
+  }
+}
+
 const ANSI_RE = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
 
 // `fs.glob` is Node 22+. `@types/node` may still target an older line, so the
@@ -271,9 +285,9 @@ export class BashSession {
     }
     const timeoutMs = opts.timeoutMs ?? BASH_DEFAULT_TIMEOUT_MS;
     const signal = opts.signal;
-    if (signal?.aborted) {
-      throw new AnthropicError('bash command aborted');
-    }
+    // Reject with the signal's own reason, so a caller telling a user cancel
+    // apart from an `AbortSignal.timeout()` sees the platform's name intact.
+    signal?.throwIfAborted();
     this.#buf = '';
     this.#truncated = false;
     // Per-call nonce so a command that prints a fixed marker can't spoof the
@@ -298,14 +312,11 @@ export class BashSession {
         await Promise.race([
           sentinelSeen,
           new Promise<never>((_, reject) => {
-            timer = setTimeout(
-              () => reject(new AnthropicError(`bash command timed out after ${timeoutMs}ms`)),
-              timeoutMs,
-            );
+            timer = setTimeout(() => reject(new BashTimeoutError(timeoutMs)), timeoutMs);
           }),
           new Promise<never>((_, reject) => {
             if (!signal) return;
-            onAbort = () => reject(new AnthropicError('bash command aborted'));
+            onAbort = () => reject(signal.reason);
             signal.addEventListener('abort', onAbort, { once: true });
           }),
         ]);

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.114.0'; // x-release-please-version
+export const VERSION = '0.116.0'; // x-release-please-version

package/tools/agent-toolset/node.browser.d.mts

@@ -12,6 +12,7 @@
  * exports are re-exported from the real module (erased at build time), so
  * type-level usage is unaffected.
  */
+import { AnthropicError } from "../../core/error.mjs";
 import type { Anthropic } from "../../client.mjs";
 import type { BetaRunnableTool } from "../../lib/tools/BetaRunnableTool.mjs";
 import type { AgentToolContext } from "./node.mjs";
@@ -21,6 +22,14 @@ export declare function resolveSkillVersion(_client: Anthropic, _skillId: string
 export declare function extractSkillArchive(_resp: Response, _dest: string): Promise<void>;
 export declare function betaAgentToolset20260401(_ctx: AgentToolContext): BetaRunnableTool[];
 export declare function resolvePath(_ctx: AgentToolContext, _p: string): Promise<string>;
+/**
+ * A bash command exceeded its `timeoutMs`. Carries the timeout so a caller can
+ * tell it apart from an abort without matching on the message text.
+ */
+export declare class BashTimeoutError extends AnthropicError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
 export declare class BashSession {
     constructor(_dir: string, _env?: NodeJS.ProcessEnv);
     get closed(): boolean;

package/tools/agent-toolset/node.browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node.browser.d.mts","sourceRoot":"","sources":["../../src/tools/agent-toolset/node.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,yBAAqB;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,6CAAyC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAe;AAE/C,YAAY,EAAE,gBAAgB,EAAE,mBAAe;AAM/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAEnF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/E;AAED,qBAAa,WAAW;gBACV,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU;IAIlD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;KAAO,GAC1E,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAEtE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE"}
+{"version":3,"file":"node.browser.d.mts","sourceRoot":"","sources":["../../src/tools/agent-toolset/node.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,yBAAqB;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,6CAAyC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAe;AAE/C,YAAY,EAAE,gBAAgB,EAAE,mBAAe;AAM/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAEnF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/E;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B;AAED,qBAAa,WAAW;gBACV,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU;IAIlD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;KAAO,GAC1E,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAEtE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE"}

package/tools/agent-toolset/node.browser.d.ts

@@ -12,6 +12,7 @@
  * exports are re-exported from the real module (erased at build time), so
  * type-level usage is unaffected.
  */
+import { AnthropicError } from "../../core/error.js";
 import type { Anthropic } from "../../client.js";
 import type { BetaRunnableTool } from "../../lib/tools/BetaRunnableTool.js";
 import type { AgentToolContext } from "./node.js";
@@ -21,6 +22,14 @@ export declare function resolveSkillVersion(_client: Anthropic, _skillId: string
 export declare function extractSkillArchive(_resp: Response, _dest: string): Promise<void>;
 export declare function betaAgentToolset20260401(_ctx: AgentToolContext): BetaRunnableTool[];
 export declare function resolvePath(_ctx: AgentToolContext, _p: string): Promise<string>;
+/**
+ * A bash command exceeded its `timeoutMs`. Carries the timeout so a caller can
+ * tell it apart from an abort without matching on the message text.
+ */
+export declare class BashTimeoutError extends AnthropicError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
 export declare class BashSession {
     constructor(_dir: string, _env?: NodeJS.ProcessEnv);
     get closed(): boolean;

package/tools/agent-toolset/node.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.browser.d.ts","sourceRoot":"","sources":["../../src/tools/agent-toolset/node.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,wBAAqB;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,4CAAyC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAe;AAE/C,YAAY,EAAE,gBAAgB,EAAE,kBAAe;AAM/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAEnF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/E;AAED,qBAAa,WAAW;gBACV,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU;IAIlD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;KAAO,GAC1E,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAEtE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE"}
+{"version":3,"file":"node.browser.d.ts","sourceRoot":"","sources":["../../src/tools/agent-toolset/node.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,4BAAyB;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,wBAAqB;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,4CAAyC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAe;AAE/C,YAAY,EAAE,gBAAgB,EAAE,kBAAe;AAM/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAEnF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/E;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B;AAED,qBAAa,WAAW;gBACV,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU;IAIlD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;KAAO,GAC1E,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAEtE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAErE"}