@anthropic-ai/sdk 0.115.0 → 0.117.1

package/src/resources/beta/beta.ts

@@ -89,6 +89,9 @@ import {
   BetaDreamStatus,
   BetaDreamUsage,
   BetaDreamsPageCursor,
+  BetaOutputBehavior,
+  BetaOutputBehaviorCreateNew,
+  BetaOutputBehaviorUpdateExisting,
   DreamArchiveParams,
   DreamCancelParams,
   DreamCreateParams,
@@ -161,6 +164,7 @@ import {
   BetaWebhookMemoryStoreCreatedEventData,
   BetaWebhookMemoryStoreDeletedEventData,
   BetaWebhookSessionArchivedEventData,
+  BetaWebhookSessionBudgetReachedEventData,
   BetaWebhookSessionCreatedEventData,
   BetaWebhookSessionDeletedEventData,
   BetaWebhookSessionIdledEventData,
@@ -194,6 +198,7 @@ import {
   AgentRetrieveParams,
   AgentUpdateParams,
   Agents,
+  BetaManagedAgentsAdvisor,
   BetaManagedAgentsAgent,
   BetaManagedAgentsAgentReference,
   BetaManagedAgentsAgentToolConfig,
@@ -516,11 +521,13 @@ import {
 } from './messages/messages';
 import * as SessionsAPI from './sessions/sessions';
 import {
+  BetaManagedAgentsAdvisorParams,
   BetaManagedAgentsAgentMessagePreview,
   BetaManagedAgentsAgentParams,
   BetaManagedAgentsAgentThinkingPreview,
   BetaManagedAgentsAgentWithOverridesParams,
   BetaManagedAgentsBranchCheckout,
+  BetaManagedAgentsBudgetLimit,
   BetaManagedAgentsCacheCreationUsage,
   BetaManagedAgentsCommitCheckout,
   BetaManagedAgentsDeletedSession,
@@ -534,6 +541,7 @@ import {
   BetaManagedAgentsMultiagentParams,
   BetaManagedAgentsMultiagentRosterEntryParams,
   BetaManagedAgentsOutcomeEvaluationResource,
+  BetaManagedAgentsServerToolUsage,
   BetaManagedAgentsSession,
   BetaManagedAgentsSessionAgent,
   BetaManagedAgentsSessionAgentUpdate,
@@ -541,6 +549,7 @@ import {
   BetaManagedAgentsSessionStats,
   BetaManagedAgentsSessionUpdatedEvent,
   BetaManagedAgentsSessionUsage,
+  BetaManagedAgentsSessionUsageEvent,
   BetaManagedAgentsSessionsBidirectionalPageCursor,
   BetaManagedAgentsStartEvent,
   BetaManagedAgentsStartEventPreview,
@@ -646,7 +655,8 @@ export type AnthropicBeta =
   | 'server-side-fallback-2026-07-01'
   | 'fallback-credit-2026-06-01'
   | 'fallback-credit-2026-07-01'
-  | 'agent-memory-2026-07-22';
+  | 'agent-memory-2026-07-22'
+  | 'mid-conversation-tool-changes-2026-07-01';
 
 export interface BetaAPIError {
   message: string;
@@ -666,6 +676,8 @@ export interface BetaBillingError {
   type: 'billing_error';
 }
 
+export type BetaCurrency = 'USD';
+
 export type BetaError =
   | BetaInvalidRequestError
   | BetaAuthenticationError
@@ -697,6 +709,25 @@ export interface BetaInvalidRequestError {
   type: 'invalid_request_error';
 }
 
+/**
+ * A monetary amount in a specific currency.
+ */
+export interface BetaMonetaryAmount {
+  /**
+   * Amount in minor units of the currency, as an integer decimal string with no
+   * leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a
+   * number so no float rounding is ever applied.
+   */
+  amount: string;
+
+  /**
+   * Uppercase ISO-4217 currency code. `USD` is the only currency currently
+   * supported; the accepted set is closed and grows only when a new currency is
+   * priced.
+   */
+  currency: BetaCurrency;
+}
+
 export interface BetaNotFoundError {
   message: string;
 
@@ -743,10 +774,12 @@ export declare namespace Beta {
     type BetaAPIError as BetaAPIError,
     type BetaAuthenticationError as BetaAuthenticationError,
     type BetaBillingError as BetaBillingError,
+    type BetaCurrency as BetaCurrency,
     type BetaError as BetaError,
     type BetaErrorResponse as BetaErrorResponse,
     type BetaGatewayTimeoutError as BetaGatewayTimeoutError,
     type BetaInvalidRequestError as BetaInvalidRequestError,
+    type BetaMonetaryAmount as BetaMonetaryAmount,
     type BetaNotFoundError as BetaNotFoundError,
     type BetaOverloadedError as BetaOverloadedError,
     type BetaPermissionError as BetaPermissionError,
@@ -1008,6 +1041,7 @@ export declare namespace Beta {
 
   export {
     Agents as Agents,
+    type BetaManagedAgentsAdvisor as BetaManagedAgentsAdvisor,
     type BetaManagedAgentsAgent as BetaManagedAgentsAgent,
     type BetaManagedAgentsAgentReference as BetaManagedAgentsAgentReference,
     type BetaManagedAgentsAgentToolConfig as BetaManagedAgentsAgentToolConfig,
@@ -1084,11 +1118,13 @@ export declare namespace Beta {
 
   export {
     Sessions as Sessions,
+    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,
@@ -1102,6 +1138,7 @@ export declare namespace Beta {
     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,
@@ -1109,6 +1146,7 @@ export declare namespace Beta {
     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,
@@ -1274,6 +1312,7 @@ export declare namespace Beta {
     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,
@@ -1325,6 +1364,9 @@ export declare namespace Beta {
     type BetaDreamSessionsInput as BetaDreamSessionsInput,
     type BetaDreamStatus as BetaDreamStatus,
     type BetaDreamUsage as BetaDreamUsage,
+    type BetaOutputBehavior as BetaOutputBehavior,
+    type BetaOutputBehaviorCreateNew as BetaOutputBehaviorCreateNew,
+    type BetaOutputBehaviorUpdateExisting as BetaOutputBehaviorUpdateExisting,
     type BetaDreamsPageCursor as BetaDreamsPageCursor,
     type DreamCreateParams as DreamCreateParams,
     type DreamRetrieveParams as DreamRetrieveParams,

package/src/resources/beta/deployments.ts

@@ -384,6 +384,12 @@ export interface BetaManagedAgentsDeployment {
    * deployment.
    */
   vault_ids: Array<string>;
+
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget?: SessionsAPI.BetaManagedAgentsBudgetLimit | null;
 }
 
 /**
@@ -482,6 +488,7 @@ export interface BetaManagedAgentsDeploymentUserMessageEvent {
     | EventsAPI.BetaManagedAgentsTextBlock
     | EventsAPI.BetaManagedAgentsImageBlock
     | EventsAPI.BetaManagedAgentsDocumentBlock
+    | EventsAPI.BetaManagedAgentsRedactedBlock
   >;
 
   type: 'user.message';
@@ -755,6 +762,12 @@ export interface DeploymentCreateParams {
    */
   name: string;
 
+  /**
+   * Body param: A hard spend ceiling. The session stops issuing new model requests
+   * once the tracked list cost reaches `max_list_cost`.
+   */
+  budget?: SessionsAPI.BetaManagedAgentsBudgetLimit | null;
+
   /**
    * Body param: Description of what the deployment does.
    */
@@ -809,6 +822,12 @@ export interface DeploymentUpdateParams {
    */
   agent?: string | SessionsAPI.BetaManagedAgentsAgentParams;
 
+  /**
+   * Body param: A hard spend ceiling. The session stops issuing new model requests
+   * once the tracked list cost reaches `max_list_cost`.
+   */
+  budget?: SessionsAPI.BetaManagedAgentsBudgetLimit | null;
+
   /**
    * Body param: Description. Omit to preserve; send empty string or null to clear.
    */

package/src/resources/beta/dreams.ts

@@ -138,9 +138,10 @@ export type BetaDreamsPageCursor = PageCursor<BetaDream>;
 
 /**
  * An asynchronous memory-consolidation job that reads a memory store plus a set of
- * session transcripts and writes consolidated memories into a new output memory
- * store. The Dreams API is in research preview: the request and response shapes
- * are volatile and may change without the deprecation period that applies to
+ * session transcripts and writes consolidated memories into an output memory store
+ * — a new store by default, or an existing store chosen via output_behavior. The
+ * Dreams API is in research preview: the request and response shapes are volatile
+ * and may change without the deprecation period that applies to
  * generally-available endpoints.
  */
 export interface BetaDream {
@@ -176,6 +177,13 @@ export interface BetaDream {
    */
   model: BetaDreamModelConfig;
 
+  /**
+   * The default destination: the job creates a new output memory store as a clone of
+   * the memory_store input and writes the consolidated memories into it. The input
+   * store is never mutated.
+   */
+  output_behavior: BetaOutputBehavior;
+
   outputs: Array<BetaDreamOutput>;
 
   session_id: string | null;
@@ -203,12 +211,16 @@ export interface BetaDreamError {
 }
 
 /**
- * An input memory store the dream reads from. The dream never mutates this store.
+ * An input memory store the dream reads from. The dream never mutates this store
+ * unless it is also the destination: with output_behavior {type:
+ * "update_existing"} the job consolidates this store in place.
  */
 export type BetaDreamInput = BetaDreamMemoryStoreInput | BetaDreamSessionsInput;
 
 /**
- * An input memory store the dream reads from. The dream never mutates this store.
+ * An input memory store the dream reads from. The dream never mutates this store
+ * unless it is also the destination: with output_behavior {type:
+ * "update_existing"} the job consolidates this store in place.
  */
 export interface BetaDreamMemoryStoreInput {
   memory_store_id: string;
@@ -308,6 +320,33 @@ export interface BetaDreamUsage {
   output_tokens: number;
 }
 
+/**
+ * The default destination: the job creates a new output memory store as a clone of
+ * the memory_store input and writes the consolidated memories into it. The input
+ * store is never mutated.
+ */
+export type BetaOutputBehavior = BetaOutputBehaviorCreateNew | BetaOutputBehaviorUpdateExisting;
+
+/**
+ * The default destination: the job creates a new output memory store as a clone of
+ * the memory_store input and writes the consolidated memories into it. The input
+ * store is never mutated.
+ */
+export interface BetaOutputBehaviorCreateNew {
+  type: 'create_new';
+}
+
+/**
+ * The job writes the consolidated memories into this existing memory store instead
+ * of creating one. In EAP the store must be the job's own memory_store input, so
+ * the job consolidates the store in place.
+ */
+export interface BetaOutputBehaviorUpdateExisting {
+  memory_store_id: string;
+
+  type: 'update_existing';
+}
+
 export interface DreamCreateParams {
   /**
    * Body param
@@ -324,6 +363,13 @@ export interface DreamCreateParams {
    */
   instructions?: string | null;
 
+  /**
+   * Body param: The default destination: the job creates a new output memory store
+   * as a clone of the memory_store input and writes the consolidated memories into
+   * it. The input store is never mutated.
+   */
+  output_behavior?: BetaOutputBehavior;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -394,6 +440,9 @@ export declare namespace Dreams {
     type BetaDreamSessionsInput as BetaDreamSessionsInput,
     type BetaDreamStatus as BetaDreamStatus,
     type BetaDreamUsage as BetaDreamUsage,
+    type BetaOutputBehavior as BetaOutputBehavior,
+    type BetaOutputBehaviorCreateNew as BetaOutputBehaviorCreateNew,
+    type BetaOutputBehaviorUpdateExisting as BetaOutputBehaviorUpdateExisting,
     type BetaDreamsPageCursor as BetaDreamsPageCursor,
     type DreamCreateParams as DreamCreateParams,
     type DreamRetrieveParams as DreamRetrieveParams,

package/src/resources/beta/index.ts

@@ -2,6 +2,7 @@
 
 export {
   Agents,
+  type BetaManagedAgentsAdvisor,
   type BetaManagedAgentsAgent,
   type BetaManagedAgentsAgentReference,
   type BetaManagedAgentsAgentToolConfig,
@@ -59,10 +60,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,
@@ -153,6 +156,9 @@ export {
   type BetaDreamSessionsInput,
   type BetaDreamStatus,
   type BetaDreamUsage,
+  type BetaOutputBehavior,
+  type BetaOutputBehaviorCreateNew,
+  type BetaOutputBehaviorUpdateExisting,
   type DreamCreateParams,
   type DreamRetrieveParams,
   type DreamListParams,
@@ -468,11 +474,13 @@ export {
 } from './models';
 export {
   Sessions,
+  type BetaManagedAgentsAdvisorParams,
   type BetaManagedAgentsAgentMessagePreview,
   type BetaManagedAgentsAgentParams,
   type BetaManagedAgentsAgentThinkingPreview,
   type BetaManagedAgentsAgentWithOverridesParams,
   type BetaManagedAgentsBranchCheckout,
+  type BetaManagedAgentsBudgetLimit,
   type BetaManagedAgentsCacheCreationUsage,
   type BetaManagedAgentsCommitCheckout,
   type BetaManagedAgentsDeletedSession,
@@ -486,6 +494,7 @@ export {
   type BetaManagedAgentsMultiagentParams,
   type BetaManagedAgentsMultiagentRosterEntryParams,
   type BetaManagedAgentsOutcomeEvaluationResource,
+  type BetaManagedAgentsServerToolUsage,
   type BetaManagedAgentsSession,
   type BetaManagedAgentsSessionAgent,
   type BetaManagedAgentsSessionAgentUpdate,
@@ -493,6 +502,7 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsSessionUsageEvent,
   type BetaManagedAgentsStartEvent,
   type BetaManagedAgentsStartEventPreview,
   type BetaManagedAgentsSystemContentBlock,
@@ -579,6 +589,7 @@ export {
   type BetaWebhookMemoryStoreCreatedEventData,
   type BetaWebhookMemoryStoreDeletedEventData,
   type BetaWebhookSessionArchivedEventData,
+  type BetaWebhookSessionBudgetReachedEventData,
   type BetaWebhookSessionCreatedEventData,
   type BetaWebhookSessionDeletedEventData,
   type BetaWebhookSessionIdledEventData,

package/src/resources/beta/messages/messages.ts

@@ -48,28 +48,7 @@ import {
 
 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'];
 
@@ -131,7 +110,7 @@ export class Messages extends APIResource {
       );
     }
 
-    let timeout = (this._client as any)._options.timeout as number | null;
+    let timeout = options?.timeout ?? ((this._client as any)._options.timeout as number | null);
     if (!body.stream && timeout == null) {
       const maxNonstreamingTokens = MODEL_NONSTREAMING_TOKENS[body.model] ?? undefined;
       timeout = this._client.calculateNonstreamingTimeout(body.max_tokens, maxNonstreamingTokens);
@@ -2618,12 +2597,28 @@ export type BetaRawMessageStreamEvent =
   | BetaRawContentBlockStopEvent;
 
 export interface BetaRedactedThinkingBlock {
+  /**
+   * 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 BetaRedactedThinkingBlockParam {
+  /**
+   * 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';
@@ -2912,6 +2907,11 @@ export interface BetaServerToolUseBlockParam {
 }
 
 export interface BetaSignatureDelta {
+  /**
+   * 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';
@@ -3139,16 +3139,41 @@ export interface BetaTextEditorCodeExecutionViewResultBlockParam {
 }
 
 export interface BetaThinkingBlock {
+  /**
+   * 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 BetaThinkingBlockParam {
+  /**
+   * 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';
@@ -3224,6 +3249,11 @@ export interface BetaThinkingDelta {
    */
   estimated_tokens: number | null;
 
+  /**
+   * 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';