@anthropic-ai/sdk 0.114.0 → 0.116.0

package/src/resources/beta/agents/agents.ts

@@ -148,6 +148,19 @@ export class Agents extends APIResource {
 
 export type BetaManagedAgentsAgentsPageCursor = PageCursor<BetaManagedAgentsAgent>;
 
+/**
+ * Platform advisor roster entry: a model the session's primary thread may consult
+ * mid-turn.
+ */
+export interface BetaManagedAgentsAdvisor {
+  /**
+   * The advisor model id.
+   */
+  model: string;
+
+  type: 'advisor';
+}
+
 /**
  * A Managed Agents `agent`.
  */
@@ -537,7 +550,7 @@ export interface BetaManagedAgentsCustomToolInputSchema {
 export interface BetaManagedAgentsCustomToolParams {
   /**
    * Description of what the tool does, shown to the agent to help it decide when to
-   * use the tool. 1-4096 characters.
+   * use the tool.
    */
   description: string;
 
@@ -707,6 +720,7 @@ export interface BetaManagedAgentsMCPToolsetParams {
 export type BetaManagedAgentsModel =
   | 'claude-sonnet-5'
   | 'claude-fable-5'
+  | 'claude-opus-5'
   | 'claude-opus-4-8'
   | 'claude-opus-4-7'
   | 'claude-opus-4-6'
@@ -742,6 +756,12 @@ export interface BetaManagedAgentsModelConfig {
     | BetaManagedAgentsEffortXhigh
     | BetaManagedAgentsEffortMax;
 
+  /**
+   * Geographic region for model inference. When unset, requests fall through to the
+   * workspace's default_inference_geo.
+   */
+  inference_geo?: string;
+
   /**
    * Inference speed mode. `fast` provides significantly faster output token
    * generation at premium pricing. Not all models support `fast`; invalid
@@ -780,6 +800,13 @@ export interface BetaManagedAgentsModelConfigParams {
     | BetaManagedAgentsEffortMax
     | null;
 
+  /**
+   * Geographic region for model inference. When unset, requests fall through to the
+   * workspace's default_inference_geo. On update, `model` is whole-object
+   * replacement — omitting inference_geo clears it.
+   */
+  inference_geo?: string | null;
+
   /**
    * Inference speed mode. `fast` provides significantly faster output token
    * generation at premium pricing. Not all models support `fast`; invalid
@@ -796,7 +823,7 @@ export interface BetaManagedAgentsMultiagentCoordinator {
    * Agents the coordinator may spawn as session threads, each resolved to a specific
    * version.
    */
-  agents: Array<BetaManagedAgentsAgentReference>;
+  agents: Array<BetaManagedAgentsAgentReference | BetaManagedAgentsAdvisor>;
 
   type: 'coordinator';
 }
@@ -1075,6 +1102,7 @@ Agents.Versions = Versions;
 
 export declare namespace Agents {
   export {
+    type BetaManagedAgentsAdvisor as BetaManagedAgentsAdvisor,
     type BetaManagedAgentsAgent as BetaManagedAgentsAgent,
     type BetaManagedAgentsAgentReference as BetaManagedAgentsAgentReference,
     type BetaManagedAgentsAgentToolConfig as BetaManagedAgentsAgentToolConfig,

package/src/resources/beta/agents/index.ts

@@ -2,6 +2,7 @@
 
 export {
   Agents,
+  type BetaManagedAgentsAdvisor,
   type BetaManagedAgentsAgent,
   type BetaManagedAgentsAgentReference,
   type BetaManagedAgentsAgentToolConfig,

package/src/resources/beta/beta.ts

@@ -161,6 +161,7 @@ import {
   BetaWebhookMemoryStoreCreatedEventData,
   BetaWebhookMemoryStoreDeletedEventData,
   BetaWebhookSessionArchivedEventData,
+  BetaWebhookSessionBudgetReachedEventData,
   BetaWebhookSessionCreatedEventData,
   BetaWebhookSessionDeletedEventData,
   BetaWebhookSessionIdledEventData,
@@ -194,6 +195,7 @@ import {
   AgentRetrieveParams,
   AgentUpdateParams,
   Agents,
+  BetaManagedAgentsAdvisor,
   BetaManagedAgentsAgent,
   BetaManagedAgentsAgentReference,
   BetaManagedAgentsAgentToolConfig,
@@ -363,11 +365,16 @@ import {
   BetaEncryptedCodeExecutionResultBlockParam,
   BetaFallbackBlock,
   BetaFallbackBlockParam,
+  BetaFallbackCreditNotApplied,
+  BetaFallbackCreditRedeemed,
+  BetaFallbackCreditTokenParam,
+  BetaFallbackCreditUsage,
   BetaFallbackInfo,
   BetaFallbackInfoParam,
   BetaFallbackMessageIterationUsage,
   BetaFallbackParam,
   BetaFallbackRefusalTrigger,
+  BetaFallbacksParam,
   BetaFileDocumentSource,
   BetaFileImageSource,
   BetaImageBlockParam,
@@ -412,6 +419,8 @@ import {
   BetaRequestMCPServerToolConfiguration,
   BetaRequestMCPServerURLDefinition,
   BetaRequestMCPToolResultBlockParam,
+  BetaRequestToolAdditionBlock,
+  BetaRequestToolRemovalBlock,
   BetaSearchResultBlockParam,
   BetaServerToolCaller,
   BetaServerToolCaller20260120,
@@ -449,6 +458,9 @@ import {
   BetaTool,
   BetaToolBash20241022,
   BetaToolBash20250124,
+  BetaToolChangeMCPToolReference,
+  BetaToolChangeMCPToolsetReference,
+  BetaToolChangeToolReference,
   BetaToolChoice,
   BetaToolChoiceAny,
   BetaToolChoiceAuto,
@@ -506,11 +518,13 @@ import {
 } from './messages/messages';
 import * as SessionsAPI from './sessions/sessions';
 import {
+  BetaManagedAgentsAdvisorParams,
   BetaManagedAgentsAgentMessagePreview,
   BetaManagedAgentsAgentParams,
   BetaManagedAgentsAgentThinkingPreview,
   BetaManagedAgentsAgentWithOverridesParams,
   BetaManagedAgentsBranchCheckout,
+  BetaManagedAgentsBudgetLimit,
   BetaManagedAgentsCacheCreationUsage,
   BetaManagedAgentsCommitCheckout,
   BetaManagedAgentsDeletedSession,
@@ -524,6 +538,7 @@ import {
   BetaManagedAgentsMultiagentParams,
   BetaManagedAgentsMultiagentRosterEntryParams,
   BetaManagedAgentsOutcomeEvaluationResource,
+  BetaManagedAgentsServerToolUsage,
   BetaManagedAgentsSession,
   BetaManagedAgentsSessionAgent,
   BetaManagedAgentsSessionAgentUpdate,
@@ -531,6 +546,7 @@ import {
   BetaManagedAgentsSessionStats,
   BetaManagedAgentsSessionUpdatedEvent,
   BetaManagedAgentsSessionUsage,
+  BetaManagedAgentsSessionUsageEvent,
   BetaManagedAgentsSessionsBidirectionalPageCursor,
   BetaManagedAgentsStartEvent,
   BetaManagedAgentsStartEventPreview,
@@ -633,8 +649,11 @@ export type AnthropicBeta =
   | 'dreaming-2026-04-21'
   | 'thinking-token-count-2026-05-13'
   | 'server-side-fallback-2026-06-01'
+  | 'server-side-fallback-2026-07-01'
   | 'fallback-credit-2026-06-01'
-  | 'agent-memory-2026-07-22';
+  | 'fallback-credit-2026-07-01'
+  | 'agent-memory-2026-07-22'
+  | 'mid-conversation-tool-changes-2026-07-01';
 
 export interface BetaAPIError {
   message: string;
@@ -654,6 +673,8 @@ export interface BetaBillingError {
   type: 'billing_error';
 }
 
+export type BetaCurrency = 'USD';
+
 export type BetaError =
   | BetaInvalidRequestError
   | BetaAuthenticationError
@@ -685,6 +706,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;
 
@@ -731,10 +771,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,
@@ -842,11 +884,16 @@ export declare namespace Beta {
     type BetaEncryptedCodeExecutionResultBlockParam as BetaEncryptedCodeExecutionResultBlockParam,
     type BetaFallbackBlock as BetaFallbackBlock,
     type BetaFallbackBlockParam as BetaFallbackBlockParam,
+    type BetaFallbackCreditNotApplied as BetaFallbackCreditNotApplied,
+    type BetaFallbackCreditRedeemed as BetaFallbackCreditRedeemed,
+    type BetaFallbackCreditTokenParam as BetaFallbackCreditTokenParam,
+    type BetaFallbackCreditUsage as BetaFallbackCreditUsage,
     type BetaFallbackInfo as BetaFallbackInfo,
     type BetaFallbackInfoParam as BetaFallbackInfoParam,
     type BetaFallbackMessageIterationUsage as BetaFallbackMessageIterationUsage,
     type BetaFallbackParam as BetaFallbackParam,
     type BetaFallbackRefusalTrigger as BetaFallbackRefusalTrigger,
+    type BetaFallbacksParam as BetaFallbacksParam,
     type BetaFileDocumentSource as BetaFileDocumentSource,
     type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,
@@ -893,6 +940,8 @@ export declare namespace Beta {
     type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
     type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
     type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
+    type BetaRequestToolAdditionBlock as BetaRequestToolAdditionBlock,
+    type BetaRequestToolRemovalBlock as BetaRequestToolRemovalBlock,
     type BetaSearchResultBlockParam as BetaSearchResultBlockParam,
     type BetaServerToolCaller as BetaServerToolCaller,
     type BetaServerToolCaller20260120 as BetaServerToolCaller20260120,
@@ -930,6 +979,9 @@ export declare namespace Beta {
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
     type BetaToolBash20250124 as BetaToolBash20250124,
+    type BetaToolChangeMCPToolReference as BetaToolChangeMCPToolReference,
+    type BetaToolChangeMCPToolsetReference as BetaToolChangeMCPToolsetReference,
+    type BetaToolChangeToolReference as BetaToolChangeToolReference,
     type BetaToolChoice as BetaToolChoice,
     type BetaToolChoiceAny as BetaToolChoiceAny,
     type BetaToolChoiceAuto as BetaToolChoiceAuto,
@@ -986,6 +1038,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,
@@ -1062,11 +1115,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,
@@ -1080,6 +1135,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,
@@ -1087,6 +1143,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,
@@ -1252,6 +1309,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,

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/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,
@@ -292,11 +295,16 @@ export {
   type BetaEncryptedCodeExecutionResultBlockParam,
   type BetaFallbackBlock,
   type BetaFallbackBlockParam,
+  type BetaFallbackCreditNotApplied,
+  type BetaFallbackCreditRedeemed,
+  type BetaFallbackCreditTokenParam,
+  type BetaFallbackCreditUsage,
   type BetaFallbackInfo,
   type BetaFallbackInfoParam,
   type BetaFallbackMessageIterationUsage,
   type BetaFallbackParam,
   type BetaFallbackRefusalTrigger,
+  type BetaFallbacksParam,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,
@@ -344,6 +352,8 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaRequestToolAdditionBlock,
+  type BetaRequestToolRemovalBlock,
   type BetaSearchResultBlockParam,
   type BetaServerToolCaller,
   type BetaServerToolCaller20260120,
@@ -381,6 +391,9 @@ export {
   type BetaTool,
   type BetaToolBash20241022,
   type BetaToolBash20250124,
+  type BetaToolChangeMCPToolReference,
+  type BetaToolChangeMCPToolsetReference,
+  type BetaToolChangeToolReference,
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,
@@ -458,11 +471,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,
@@ -476,6 +491,7 @@ export {
   type BetaManagedAgentsMultiagentParams,
   type BetaManagedAgentsMultiagentRosterEntryParams,
   type BetaManagedAgentsOutcomeEvaluationResource,
+  type BetaManagedAgentsServerToolUsage,
   type BetaManagedAgentsSession,
   type BetaManagedAgentsSessionAgent,
   type BetaManagedAgentsSessionAgentUpdate,
@@ -483,6 +499,7 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsSessionUsageEvent,
   type BetaManagedAgentsStartEvent,
   type BetaManagedAgentsStartEventPreview,
   type BetaManagedAgentsSystemContentBlock,
@@ -569,6 +586,7 @@ export {
   type BetaWebhookMemoryStoreCreatedEventData,
   type BetaWebhookMemoryStoreDeletedEventData,
   type BetaWebhookSessionArchivedEventData,
+  type BetaWebhookSessionBudgetReachedEventData,
   type BetaWebhookSessionCreatedEventData,
   type BetaWebhookSessionDeletedEventData,
   type BetaWebhookSessionIdledEventData,

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

@@ -607,14 +607,15 @@ export namespace BatchCreateParams {
        * When the appended-assistant form is used on a model that otherwise disallows
        * assistant-turn prefill, this token also authorizes that one prefill.
        */
-      fallback_credit_token?: string | null;
+      fallback_credit_token?: string | BetaMessagesAPI.BetaFallbackCreditTokenParam | null;
 
       /**
        * Opt-in server-side retry on one or more substitute models when the requested
        * model declines for policy reasons. Tried in order: if the first entry also
-       * declines, the second is tried, and so on.
+       * declines, the second is tried, and so on. The string "default" requests the
+       * requested model's server-defined default fallback configuration.
        */
-      fallbacks?: Array<BetaMessagesAPI.BetaFallbackParam> | null;
+      fallbacks?: BetaMessagesAPI.BetaFallbacksParam | null;
 
       /**
        * Specifies the geographic region for inference processing. If not specified, the

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

@@ -106,11 +106,16 @@ export {
   type BetaEncryptedCodeExecutionResultBlockParam,
   type BetaFallbackBlock,
   type BetaFallbackBlockParam,
+  type BetaFallbackCreditNotApplied,
+  type BetaFallbackCreditRedeemed,
+  type BetaFallbackCreditTokenParam,
+  type BetaFallbackCreditUsage,
   type BetaFallbackInfo,
   type BetaFallbackInfoParam,
   type BetaFallbackMessageIterationUsage,
   type BetaFallbackParam,
   type BetaFallbackRefusalTrigger,
+  type BetaFallbacksParam,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,
@@ -156,6 +161,8 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaRequestToolAdditionBlock,
+  type BetaRequestToolRemovalBlock,
   type BetaSearchResultBlockParam,
   type BetaServerToolCaller,
   type BetaServerToolCaller20260120,
@@ -193,6 +200,9 @@ export {
   type BetaTool,
   type BetaToolBash20241022,
   type BetaToolBash20250124,
+  type BetaToolChangeMCPToolReference,
+  type BetaToolChangeMCPToolsetReference,
+  type BetaToolChangeToolReference,
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,