@anthropic-ai/sdk 0.104.2 → 0.106.0

package/src/lib/tools/BetaToolRunner.ts

@@ -8,7 +8,11 @@ import { RequestOptions } from '../../internal/request-options';
 import { buildHeaders } from '../../internal/headers';
 import { promiseWithResolvers } from '../../internal/utils/promise';
 import { CompactionControl, DEFAULT_SUMMARY_PROMPT, DEFAULT_TOKEN_THRESHOLD } from './CompactionControl';
-import { collectStainlessHelpers } from '../stainless-helper-header';
+import {
+  collectStainlessHelpers,
+  helperHeader,
+  STAINLESS_HELPER_HEADER,
+} from '../../internal/stainless-helper-header';
 
 /**
  * A ToolRunner handles the automatic conversation loop between the assistant and tools.
@@ -52,12 +56,17 @@ export class BetaToolRunner<Stream extends boolean> {
       },
     };
 
-    const helpers = collectStainlessHelpers(params.tools, params.messages);
-    const helperValue = ['BetaToolRunner', ...helpers].join(', ');
-
+    // structuredClone drops symbol-keyed properties, so collect helper marks
+    // from the original params here — the create()-side collector won't see
+    // them on the cloned messages.
+    const collected = collectStainlessHelpers(params.tools, params.messages);
     this.#options = {
       ...options,
-      headers: buildHeaders([{ 'x-stainless-helper': helperValue }, options?.headers]),
+      headers: buildHeaders([
+        helperHeader('BetaToolRunner'),
+        collected.length ? { [STAINLESS_HELPER_HEADER]: collected.join(', ') } : undefined,
+        options?.headers,
+      ]),
     };
     this.#completion = promiseWithResolvers();
 
@@ -137,7 +146,7 @@ export class BetaToolRunner<Stream extends boolean> {
       },
       {
         signal: this.#options.signal,
-        headers: buildHeaders([this.#options.headers, { 'x-stainless-helper': 'compaction' }]),
+        headers: buildHeaders([this.#options.headers, helperHeader('compaction')]),
       },
     );
 

package/src/lib/tools/SessionToolRunner.ts

@@ -15,6 +15,7 @@ import { isFatal4xx } from '../../internal/utils/backoff';
 import { linkAbort } from '../../internal/utils/abort';
 import { AsyncQueue } from '../../internal/utils/async-queue';
 import { buildHeaders } from '../../internal/headers';
+import { helperHeader } from '../../internal/stainless-helper-header';
 import type { RequestOptions } from '../../internal/request-options';
 import { runRunnableTool, toolName, type BetaRunnableTool } from './BetaRunnableTool';
 import type { BetaToolRunnerRequestOptions } from './BetaToolRunner';
@@ -22,9 +23,6 @@ import type { BetaToolRunnerRequestOptions } from './BetaToolRunner';
 /** Beta header for the managed-agents API. */
 export const MANAGED_AGENTS_BETA = 'managed-agents-2026-04-01';
 
-/** `x-stainless-helper` value identifying this helper in SDK telemetry. */
-const HELPER_NAME = 'SessionToolRunner';
-
 const STREAM_BACKOFF_START_MS = 500;
 const STREAM_BACKOFF_CAP_MS = 10_000;
 const TOOL_TIMEOUT_MS = 120_000;
@@ -287,7 +285,7 @@ export class SessionToolRunner implements AsyncIterable<DispatchedToolCall> {
   #requestOptions(): RequestOptions {
     return {
       ...this.#requestOpts,
-      headers: buildHeaders([{ 'x-stainless-helper': HELPER_NAME }, this.#requestOpts?.headers]),
+      headers: buildHeaders([helperHeader('session-tool-runner'), this.#requestOpts?.headers]),
       signal: this.#controller.signal,
     };
   }

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

@@ -840,7 +840,9 @@ export interface AgentCreateParams {
 
   /**
    * Body param: MCP servers this agent connects to. Maximum 20. Names must be unique
-   * within the array.
+   * within the array. Every server must be referenced by an `mcp_toolset` in
+   * `tools`; unreferenced servers are rejected. See the
+   * [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
    */
   mcp_servers?: Array<BetaManagedAgentsURLMCPServerParams>;
 
@@ -911,7 +913,10 @@ export interface AgentUpdateParams {
 
   /**
    * Body param: MCP servers. Full replacement. Omit to preserve; send empty array or
-   * null to clear. Names must be unique. Maximum 20.
+   * `null` to clear. Names must be unique. Maximum 20. Every server must be
+   * referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced
+   * servers are rejected. See the
+   * [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
    */
   mcp_servers?: Array<BetaManagedAgentsURLMCPServerParams> | null;
 

package/src/resources/beta/beta.ts

@@ -134,6 +134,7 @@ import {
   BetaWebhookSessionThreadCreatedEventData,
   BetaWebhookSessionThreadIdledEventData,
   BetaWebhookSessionThreadTerminatedEventData,
+  BetaWebhookSessionUpdatedEventData,
   BetaWebhookVaultArchivedEventData,
   BetaWebhookVaultCreatedEventData,
   BetaWebhookVaultCredentialArchivedEventData,
@@ -284,6 +285,7 @@ import {
   BetaCodeExecutionTool20250522,
   BetaCodeExecutionTool20250825,
   BetaCodeExecutionTool20260120,
+  BetaCodeExecutionTool20260521,
   BetaCodeExecutionToolResultBlock,
   BetaCodeExecutionToolResultBlockContent,
   BetaCodeExecutionToolResultBlockParam,
@@ -319,6 +321,7 @@ import {
   BetaFallbackInfoParam,
   BetaFallbackMessageIterationUsage,
   BetaFallbackParam,
+  BetaFallbackRefusalTrigger,
   BetaFileDocumentSource,
   BetaFileImageSource,
   BetaImageBlockParam,
@@ -732,6 +735,7 @@ export declare namespace Beta {
     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,
@@ -767,6 +771,7 @@ export declare namespace Beta {
     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,
@@ -1151,6 +1156,7 @@ export declare namespace Beta {
     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/beta/files.ts

@@ -7,7 +7,7 @@ import { Page, type PageParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
-import { stainlessHelperHeaderFromFile } from '../../lib/stainless-helper-header';
+import { stainlessHelperHeaderFromFile } from '../../internal/stainless-helper-header';
 import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 

package/src/resources/beta/index.ts

@@ -235,6 +235,7 @@ export {
   type BetaCodeExecutionTool20250522,
   type BetaCodeExecutionTool20250825,
   type BetaCodeExecutionTool20260120,
+  type BetaCodeExecutionTool20260521,
   type BetaCodeExecutionToolResultBlock,
   type BetaCodeExecutionToolResultBlockContent,
   type BetaCodeExecutionToolResultBlockParam,
@@ -270,6 +271,7 @@ export {
   type BetaFallbackInfoParam,
   type BetaFallbackMessageIterationUsage,
   type BetaFallbackParam,
+  type BetaFallbackRefusalTrigger,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,
@@ -514,6 +516,7 @@ export {
   type BetaWebhookSessionThreadCreatedEventData,
   type BetaWebhookSessionThreadIdledEventData,
   type BetaWebhookSessionThreadTerminatedEventData,
+  type BetaWebhookSessionUpdatedEventData,
   type BetaWebhookVaultArchivedEventData,
   type BetaWebhookVaultCreatedEventData,
   type BetaWebhookVaultCredentialArchivedEventData,

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

@@ -43,12 +43,15 @@ export class Batches extends APIResource {
    * ```
    */
   create(params: BatchCreateParams, options?: RequestOptions): APIPromise<BetaMessageBatch> {
-    const { betas, ...body } = params;
+    const { betas, user_profile_id, ...body } = params;
     return this._client.post('/v1/messages/batches?beta=true', {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
+          ...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -424,6 +427,15 @@ export interface BatchCreateParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * 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 {
@@ -791,12 +803,6 @@ export namespace BatchCreateParams {
        * other values will be rejected with a 400 error.
        */
       top_p?: number;
-
-      /**
-       * The user profile ID to attribute this request to. Use when acting on behalf of a
-       * party other than your organization.
-       */
-      user_profile_id?: string | null;
     }
   }
 }

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

@@ -74,6 +74,7 @@ export {
   type BetaCodeExecutionTool20250522,
   type BetaCodeExecutionTool20250825,
   type BetaCodeExecutionTool20260120,
+  type BetaCodeExecutionTool20260521,
   type BetaCodeExecutionToolResultBlock,
   type BetaCodeExecutionToolResultBlockContent,
   type BetaCodeExecutionToolResultBlockParam,
@@ -109,6 +110,7 @@ export {
   type BetaFallbackInfoParam,
   type BetaFallbackMessageIterationUsage,
   type BetaFallbackParam,
+  type BetaFallbackRefusalTrigger,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,