@anthropic-ai/sdk 0.104.2 → 0.106.0

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

@@ -9,7 +9,7 @@ import { Stream } from '../../../core/streaming';
 import { MODEL_NONSTREAMING_TOKENS } from '../../../internal/constants';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
-import { stainlessHelperHeader } from '../../../lib/stainless-helper-header';
+import { stainlessHelperHeader } from '../../../internal/stainless-helper-header';
 import {
   parseBetaMessage,
   type ExtractParsedContentFromBetaParams,
@@ -111,7 +111,7 @@ export class Messages extends APIResource {
     // Transform deprecated output_format to output_config.format
     const modifiedParams = transformOutputFormat(params);
 
-    const { betas, ...body } = modifiedParams;
+    const { betas, user_profile_id, ...body } = modifiedParams;
 
     if (body.model in DEPRECATED_MODELS) {
       console.warn(
@@ -145,7 +145,10 @@ export class Messages extends APIResource {
       timeout: timeout ?? 600000,
       ...options,
       headers: buildHeaders([
-        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
+        {
+          ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
+          ...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined),
+        },
         helperHeader,
         options?.headers,
       ]),
@@ -382,7 +385,9 @@ export interface BetaAdvisorTool20260301 {
 
   type: 'advisor_20260301';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -586,7 +591,9 @@ export interface BetaCacheControlEphemeral {
    * - `5m`: 5 minutes
    * - `1h`: 1 hour
    *
-   * Defaults to `5m`.
+   * Defaults to `5m`. See
+   * [prompt caching pricing](https://docs.claude.com/en/docs/build-with-claude/prompt-caching)
+   * for details.
    */
   ttl?: '5m' | '1h';
 }
@@ -1024,7 +1031,9 @@ export interface BetaCodeExecutionTool20250522 {
 
   type: 'code_execution_20250522';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -1053,7 +1062,9 @@ export interface BetaCodeExecutionTool20250825 {
 
   type: 'code_execution_20250825';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -1086,7 +1097,43 @@ export interface BetaCodeExecutionTool20260120 {
 
   type: 'code_execution_20260120';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * If true, tool will not be included in initial system prompt. Only loaded when
+   * returned via tool_reference from tool search.
+   */
+  defer_loading?: boolean;
+
+  /**
+   * When true, guarantees schema validation on tool names and inputs
+   */
+  strict?: boolean;
+}
+
+/**
+ * Code execution tool with REPL state persistence.
+ */
+export interface BetaCodeExecutionTool20260521 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in `tool_use` blocks.
+   */
+  name: 'code_execution';
+
+  type: 'code_execution_20260521';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -1515,10 +1562,10 @@ export interface BetaEncryptedCodeExecutionResultBlockParam {
  * Marks the point in `content` where one model's output gives way to the next.
  *
  * One block appears per hop where a preceding model actually ran this turn and
- * declined. A turn routed directly by the sticky decision has no such boundary and
- * carries no block — the signal for whether a fallback model served the response
- * is the presence of a `fallback_message` entry in `usage.iterations`, not this
- * block.
+ * declined. A turn where no preceding model ran and declined has no such boundary
+ * and carries no block — the signal for whether a fallback model served the
+ * response is the presence of a `fallback_message` entry in `usage.iterations`,
+ * not this block.
  *
  * The block is treated like a server-tool content block for streaming: it arrives
  * via the standard `content_block_start` / `content_block_stop` pair and carries
@@ -1539,25 +1586,27 @@ export interface BetaFallbackBlock {
    */
   to: BetaFallbackInfo;
 
+  /**
+   * What caused the `from` model to hand over at this hop.
+   */
+  trigger: BetaFallbackRefusalTrigger;
+
   type: 'fallback';
 }
 
 /**
  * A `fallback` block echoed back from a prior response.
  *
- * Accepted in `messages[].content` and never rendered into the prompt, not
- * validated against the request's `fallbacks` chain or top-level `model`, and
- * stripped before the sticky-routing cache key is computed.
+ * Accepted in `messages[].content` and not rendered into the prompt; not validated
+ * against the request's `fallbacks` chain or top-level `model`.
  *
- * Callers should echo the assistant turn verbatim — block included. The block's
- * position is load-bearing for thinking verification: the thinking runs on either
- * side of a fallback hop carry independently-rooted verification hash chains, and
- * this block is the only record of where one chain ends and the next begins. When
- * thinking runs flank the boundary, omitting the block merges the runs into one
- * contiguous span whose hashes cannot verify (the request is rejected), and moving
- * it into the middle of a single run splits that run's chain and is likewise
- * rejected; between non-thinking blocks the block's placement has no verification
- * effect.
+ * Echo the assistant turn back verbatim, including this block in its original
+ * position. The block marks the boundary between content produced before and after
+ * a fallback hop, and the server relies on that boundary to validate the turn:
+ * when thinking runs flank the boundary, omitting the block merges them into one
+ * span the server cannot validate (the request is rejected), and moving it into
+ * the middle of a single run is likewise rejected; between non-thinking blocks the
+ * block's placement has no validation effect.
  */
 export interface BetaFallbackBlockParam {
   /**
@@ -1571,6 +1620,12 @@ export interface BetaFallbackBlockParam {
   to: BetaFallbackInfoParam;
 
   type: 'fallback';
+
+  /**
+   * The response block's `trigger`, echoed verbatim. Accepted and ignored by the
+   * server; any object or `null` is allowed.
+   */
+  trigger?: unknown;
 }
 
 /**
@@ -1675,6 +1730,18 @@ export interface BetaFallbackParam {
   [k: string]: unknown;
 }
 
+/**
+ * The `from` model declined for policy reasons.
+ */
+export interface BetaFallbackRefusalTrigger {
+  /**
+   * The policy category that triggered a refusal.
+   */
+  category: 'cyber' | 'bio' | 'frontier_llm' | 'reasoning_extraction' | 'military_weapons' | null;
+
+  type: 'refusal';
+}
+
 export interface BetaFileDocumentSource {
   file_id: string;
 
@@ -1848,7 +1915,9 @@ export interface BetaMemoryTool20250818 {
 
   type: 'memory_20250818';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2438,11 +2507,9 @@ export interface BetaRedactedThinkingBlockParam {
  */
 export interface BetaRefusalStopDetails {
   /**
-   * The policy category that triggered the refusal.
-   *
-   * `null` when the refusal doesn't map to a named category.
+   * The policy category that triggered a refusal.
    */
-  category: 'cyber' | 'bio' | 'frontier_llm' | 'reasoning_extraction' | null;
+  category: 'cyber' | 'bio' | 'frontier_llm' | 'reasoning_extraction' | 'military_weapons' | null;
 
   /**
    * Human-readable explanation of the refusal.
@@ -3019,7 +3086,9 @@ export interface BetaTool {
    */
   name: string;
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3089,7 +3158,9 @@ export interface BetaToolBash20241022 {
 
   type: 'bash_20241022';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3120,7 +3191,9 @@ export interface BetaToolBash20250124 {
 
   type: 'bash_20250124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3224,7 +3297,9 @@ export interface BetaToolComputerUse20241022 {
 
   type: 'computer_20241022';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3270,7 +3345,9 @@ export interface BetaToolComputerUse20250124 {
 
   type: 'computer_20250124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3316,7 +3393,9 @@ export interface BetaToolComputerUse20251124 {
 
   type: 'computer_20251124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3400,7 +3479,9 @@ export interface BetaToolSearchToolBm25_20251119 {
 
   type: 'tool_search_tool_bm25_20251119' | 'tool_search_tool_bm25';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3429,7 +3510,9 @@ export interface BetaToolSearchToolRegex20251119 {
 
   type: 'tool_search_tool_regex_20251119' | 'tool_search_tool_regex';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3509,7 +3592,9 @@ export interface BetaToolTextEditor20241022 {
 
   type: 'text_editor_20241022';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3540,7 +3625,9 @@ export interface BetaToolTextEditor20250124 {
 
   type: 'text_editor_20250124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3571,7 +3658,9 @@ export interface BetaToolTextEditor20250429 {
 
   type: 'text_editor_20250429';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3602,7 +3691,9 @@ export interface BetaToolTextEditor20250728 {
 
   type: 'text_editor_20250728';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3640,6 +3731,7 @@ export type BetaToolUnion =
   | BetaCodeExecutionTool20250522
   | BetaCodeExecutionTool20250825
   | BetaCodeExecutionTool20260120
+  | BetaCodeExecutionTool20260521
   | BetaToolComputerUse20241022
   | BetaMemoryTool20250818
   | BetaToolComputerUse20250124
@@ -3854,7 +3946,9 @@ export interface BetaWebFetchTool20250910 {
 
   type: 'web_fetch_20250910';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * List of domains to allow fetching from
@@ -3910,7 +4004,9 @@ export interface BetaWebFetchTool20260209 {
 
   type: 'web_fetch_20260209';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * List of domains to allow fetching from
@@ -3969,7 +4065,9 @@ export interface BetaWebFetchTool20260309 {
 
   type: 'web_fetch_20260309';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * List of domains to allow fetching from
@@ -4110,7 +4208,9 @@ export interface BetaWebSearchTool20250305 {
 
   type: 'web_search_20250305';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * If provided, only these domains will be included in results. Cannot be used
@@ -4162,7 +4262,9 @@ export interface BetaWebSearchTool20260209 {
 
   type: 'web_search_20260209';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * If provided, only these domains will be included in results. Cannot be used
@@ -4613,15 +4715,16 @@ export interface MessageCreateParamsBase {
   top_p?: number;
 
   /**
-   * Body param: The user profile ID to attribute this request to. Use when acting on
-   * behalf of a party other than your organization.
+   * Header param: Optional header to specify the beta version(s) you want to use.
    */
-  user_profile_id?: string | null;
+  betas?: Array<BetaAPI.AnthropicBeta>;
 
   /**
-   * Header param: Optional header to specify the beta version(s) you want to use.
+   * Header param: The user profile ID to attribute this request to. Use when acting
+   * on behalf of a party other than your organization. Requires the `user-profiles`
+   * beta header.
    */
-  betas?: Array<BetaAPI.AnthropicBeta>;
+  user_profile_id?: string;
 }
 
 export namespace MessageCreateParams {
@@ -4879,6 +4982,7 @@ export interface MessageCountTokensParams {
     | BetaCodeExecutionTool20250522
     | BetaCodeExecutionTool20250825
     | BetaCodeExecutionTool20260120
+    | BetaCodeExecutionTool20260521
     | BetaToolComputerUse20241022
     | BetaMemoryTool20250818
     | BetaToolComputerUse20250124
@@ -4967,6 +5071,7 @@ export declare namespace Messages {
     type BetaCodeExecutionTool20250522 as BetaCodeExecutionTool20250522,
     type BetaCodeExecutionTool20250825 as BetaCodeExecutionTool20250825,
     type BetaCodeExecutionTool20260120 as BetaCodeExecutionTool20260120,
+    type BetaCodeExecutionTool20260521 as BetaCodeExecutionTool20260521,
     type BetaCodeExecutionToolResultBlock as BetaCodeExecutionToolResultBlock,
     type BetaCodeExecutionToolResultBlockContent as BetaCodeExecutionToolResultBlockContent,
     type BetaCodeExecutionToolResultBlockParam as BetaCodeExecutionToolResultBlockParam,
@@ -5002,6 +5107,7 @@ export declare namespace Messages {
     type BetaFallbackInfoParam as BetaFallbackInfoParam,
     type BetaFallbackMessageIterationUsage as BetaFallbackMessageIterationUsage,
     type BetaFallbackParam as BetaFallbackParam,
+    type BetaFallbackRefusalTrigger as BetaFallbackRefusalTrigger,
     type BetaFileDocumentSource as BetaFileDocumentSource,
     type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,

package/src/resources/beta/webhooks.ts

@@ -59,7 +59,8 @@ export type BetaWebhookEventData =
   | BetaWebhookVaultCredentialCreatedEventData
   | BetaWebhookVaultCredentialArchivedEventData
   | BetaWebhookVaultCredentialDeletedEventData
-  | BetaWebhookVaultCredentialRefreshFailedEventData;
+  | BetaWebhookVaultCredentialRefreshFailedEventData
+  | BetaWebhookSessionUpdatedEventData;
 
 export interface BetaWebhookSessionArchivedEventData {
   /**
@@ -271,6 +272,19 @@ export interface BetaWebhookSessionThreadTerminatedEventData {
   workspace_id: string;
 }
 
+export interface BetaWebhookSessionUpdatedEventData {
+  /**
+   * ID of the session that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.updated';
+
+  workspace_id: string;
+}
+
 export interface BetaWebhookVaultArchivedEventData {
   /**
    * ID of the vault that triggered the event.
@@ -420,6 +434,7 @@ export declare namespace Webhooks {
     type BetaWebhookSessionThreadCreatedEventData as BetaWebhookSessionThreadCreatedEventData,
     type BetaWebhookSessionThreadIdledEventData as BetaWebhookSessionThreadIdledEventData,
     type BetaWebhookSessionThreadTerminatedEventData as BetaWebhookSessionThreadTerminatedEventData,
+    type BetaWebhookSessionUpdatedEventData as BetaWebhookSessionUpdatedEventData,
     type BetaWebhookVaultArchivedEventData as BetaWebhookVaultArchivedEventData,
     type BetaWebhookVaultCreatedEventData as BetaWebhookVaultCreatedEventData,
     type BetaWebhookVaultCredentialArchivedEventData as BetaWebhookVaultCredentialArchivedEventData,

package/src/resources/index.ts

@@ -58,6 +58,7 @@ export {
   type CodeExecutionTool20250522,
   type CodeExecutionTool20250825,
   type CodeExecutionTool20260120,
+  type CodeExecutionTool20260521,
   type CodeExecutionToolResultBlock,
   type CodeExecutionToolResultBlockContent,
   type CodeExecutionToolResultBlockParam,

package/src/resources/messages/batches.ts

@@ -40,8 +40,16 @@ export class Batches extends APIResource {
    * });
    * ```
    */
-  create(body: BatchCreateParams, options?: RequestOptions): APIPromise<MessageBatch> {
-    return this._client.post('/v1/messages/batches', { body, ...options });
+  create(params: BatchCreateParams, options?: RequestOptions): APIPromise<MessageBatch> {
+    const { user_profile_id, ...body } = params;
+    return this._client.post('/v1/messages/batches', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined) },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -350,10 +358,19 @@ export interface MessageBatchSucceededResult {
 
 export interface BatchCreateParams {
   /**
-   * List of requests for prompt completion. Each is an individual request to create
-   * a Message.
+   * Body param: List of requests for prompt completion. Each is an individual
+   * request to create a Message.
    */
   requests: Array<BatchCreateParams.Request>;
+
+  /**
+   * Header param: The user profile ID to attribute the requests in this batch to.
+   * Use when acting on behalf of a party other than your organization. Requires the
+   * `user-profiles` beta header. Applies to every request in the batch; an
+   * individual request whose `user_profile_id` body field conflicts with this header
+   * is errored.
+   */
+  user_profile_id?: string;
 }
 
 export namespace BatchCreateParams {

package/src/resources/messages/index.ts

@@ -50,6 +50,7 @@ export {
   type CodeExecutionTool20250522,
   type CodeExecutionTool20250825,
   type CodeExecutionTool20260120,
+  type CodeExecutionTool20260521,
   type CodeExecutionToolResultBlock,
   type CodeExecutionToolResultBlockContent,
   type CodeExecutionToolResultBlockParam,