@anthropic-ai/sdk 0.106.0 → 0.107.0

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

@@ -84,7 +84,7 @@ export class Messages extends APIResource {
    * conversations.
    *
    * Learn more about the Messages API in our
-   * [user guide](https://docs.claude.com/en/docs/initial-setup)
+   * [user guide](https://platform.claude.com/docs/en/get-started)
    *
    * @example
    * ```ts
@@ -206,7 +206,7 @@ export class Messages extends APIResource {
    * including tools, images, and documents, without creating it.
    *
    * Learn more about token counting in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/token-counting)
    *
    * @example
    * ```ts
@@ -224,12 +224,15 @@ 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;
     return this._client.post('/v1/messages/count_tokens?beta=true', {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString(),
+          ...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -592,7 +595,7 @@ export interface BetaCacheControlEphemeral {
    * - `1h`: 1 hour
    *
    * Defaults to `5m`. See
-   * [prompt caching pricing](https://docs.claude.com/en/docs/build-with-claude/prompt-caching)
+   * [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
    * for details.
    */
   ttl?: '5m' | '1h';
@@ -2993,7 +2996,7 @@ export interface BetaThinkingConfigEnabled {
    * Must be ≥1024 and less than `max_tokens`.
    *
    * See
-   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
    * for details.
    */
   budget_tokens: number;
@@ -3017,7 +3020,7 @@ export interface BetaThinkingConfigEnabled {
  * tokens and counts towards your `max_tokens` limit.
  *
  * See
- * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+ * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
  * for details.
  */
 export type BetaThinkingConfigParam =
@@ -3745,6 +3748,8 @@ export type BetaToolUnion =
   | BetaWebSearchTool20260209
   | BetaWebFetchTool20260209
   | BetaWebFetchTool20260309
+  | BetaWebSearchTool20260318
+  | BetaWebFetchTool20260318
   | BetaAdvisorTool20260301
   | BetaToolSearchToolBm25_20251119
   | BetaToolSearchToolRegex20251119
@@ -4120,6 +4125,81 @@ export interface BetaWebFetchTool20260309 {
   use_cache?: boolean;
 }
 
+export interface BetaWebFetchTool20260318 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in `tool_use` blocks.
+   */
+  name: 'web_fetch';
+
+  type: 'web_fetch_20260318';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * List of domains to allow fetching from
+   */
+  allowed_domains?: Array<string> | null;
+
+  /**
+   * List of domains to block fetching from
+   */
+  blocked_domains?: Array<string> | null;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Citations configuration for fetched documents. Citations are disabled by
+   * default.
+   */
+  citations?: BetaCitationsConfigParam | 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;
+
+  /**
+   * Maximum number of tokens used by including web page text content in the context.
+   * The limit is approximate and does not apply to binary content such as PDFs.
+   */
+  max_content_tokens?: number | null;
+
+  /**
+   * Maximum number of times the tool can be used in the API request.
+   */
+  max_uses?: number | null;
+
+  /**
+   * How this tool's result blocks appear in the API response when the result was
+   * consumed by a completed code_execution call in the same turn. 'full' returns the
+   * complete content (default). 'excluded' drops the nested server_tool_use and
+   * result block pair entirely. Results from direct calls, or from code_execution
+   * calls that paused before completing, are always returned in full so they can be
+   * sent back on the next turn.
+   */
+  response_inclusion?: 'full' | 'excluded';
+
+  /**
+   * When true, guarantees schema validation on tool names and inputs
+   */
+  strict?: boolean;
+
+  /**
+   * Whether to use cached content. Set to false to bypass the cache and fetch fresh
+   * content. Only set to false when the user explicitly requests fresh content or
+   * when fetching rapidly-changing sources.
+   */
+  use_cache?: boolean;
+}
+
 export interface BetaWebFetchToolResultBlock {
   content: BetaWebFetchToolResultErrorBlock | BetaWebFetchBlock;
 
@@ -4306,6 +4386,70 @@ export interface BetaWebSearchTool20260209 {
   user_location?: BetaUserLocation | null;
 }
 
+export interface BetaWebSearchTool20260318 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in `tool_use` blocks.
+   */
+  name: 'web_search';
+
+  type: 'web_search_20260318';
+
+  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
+   * alongside `blocked_domains`.
+   */
+  allowed_domains?: Array<string> | null;
+
+  /**
+   * If provided, these domains will never appear in results. Cannot be used
+   * alongside `allowed_domains`.
+   */
+  blocked_domains?: Array<string> | null;
+
+  /**
+   * 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;
+
+  /**
+   * Maximum number of times the tool can be used in the API request.
+   */
+  max_uses?: number | null;
+
+  /**
+   * How this tool's result blocks appear in the API response when the result was
+   * consumed by a completed code_execution call in the same turn. 'full' returns the
+   * complete content (default). 'excluded' drops the nested server_tool_use and
+   * result block pair entirely. Results from direct calls, or from code_execution
+   * calls that paused before completing, are always returned in full so they can be
+   * sent back on the next turn.
+   */
+  response_inclusion?: 'full' | 'excluded';
+
+  /**
+   * When true, guarantees schema validation on tool names and inputs
+   */
+  strict?: boolean;
+
+  /**
+   * Parameters for the user's location. Used to provide more relevant search
+   * results.
+   */
+  user_location?: BetaUserLocation | null;
+}
+
 export interface BetaWebSearchToolRequestError {
   error_code: BetaWebSearchToolResultErrorCode;
 
@@ -4380,11 +4524,12 @@ export interface MessageCreateParamsBase {
    * only specifies the absolute maximum number of tokens to generate.
    *
    * Set to `0` to populate the
-   * [prompt cache](https://docs.claude.com/en/docs/build-with-claude/prompt-caching#pre-warming-the-cache)
+   * [prompt cache](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pre-warming-the-cache)
    * without generating a response.
    *
    * Different models have different maximum values for this parameter. See
-   * [models](https://docs.claude.com/en/docs/models-overview) for details.
+   * [models](https://platform.claude.com/docs/en/about-claude/models/overview) for
+   * details.
    */
   max_tokens: number;
 
@@ -4446,12 +4591,13 @@ export interface MessageCreateParamsBase {
    * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
    * ```
    *
-   * See [input examples](https://docs.claude.com/en/api/messages-examples).
+   * See
+   * [input examples](https://platform.claude.com/docs/en/build-with-claude/working-with-messages).
    *
    * Note that if you want to include a
-   * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
-   * top-level `system` parameter — there is no `"system"` role for input messages in
-   * the Messages API.
+   * [system prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role),
+   * you can use the top-level `system` parameter — there is no `"system"` role for
+   * input messages in the Messages API.
    *
    * There is a limit of 100,000 messages in a single request.
    */
@@ -4556,7 +4702,8 @@ export interface MessageCreateParamsBase {
    * standard capacity for this request.
    *
    * Anthropic offers different levels of service for your API requests. See
-   * [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
+   * [service-tiers](https://platform.claude.com/docs/en/api/service-tiers) for
+   * details.
    */
   service_tier?: 'auto' | 'standard_only';
 
@@ -4583,7 +4730,8 @@ export interface MessageCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream?: boolean;
 
@@ -4592,7 +4740,7 @@ export interface MessageCreateParamsBase {
    *
    * A system prompt is a way of providing context and instructions to Claude, such
    * as specifying a particular goal or role. See our
-   * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
+   * [guide to system prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role).
    */
   system?: string | Array<BetaTextBlockParam>;
 
@@ -4611,7 +4759,7 @@ export interface MessageCreateParamsBase {
    * tokens and counts towards your `max_tokens` limit.
    *
    * See
-   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
    * for details.
    */
   thinking?: BetaThinkingConfigParam;
@@ -4632,9 +4780,9 @@ export interface MessageCreateParamsBase {
    *
    * There are two types of tools: **client tools** and **server tools**. The
    * behavior described below applies to client tools. For
-   * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * [server tools](https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools),
    * see their individual documentation as each has its own behavior (e.g., the
-   * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   * [web search tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)).
    *
    * Each tool definition includes:
    *
@@ -4697,7 +4845,9 @@ export interface MessageCreateParamsBase {
    * functions, or more generally whenever you want the model to produce a particular
    * JSON structure of output.
    *
-   * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
+   * See our
+   * [guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview)
+   * for more details.
    */
   tools?: Array<BetaToolUnion>;
 
@@ -4737,7 +4887,8 @@ export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream?: false;
 }
@@ -4747,7 +4898,8 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream: true;
 }
@@ -4811,12 +4963,13 @@ export interface MessageCountTokensParams {
    * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
    * ```
    *
-   * See [input examples](https://docs.claude.com/en/api/messages-examples).
+   * See
+   * [input examples](https://platform.claude.com/docs/en/build-with-claude/working-with-messages).
    *
    * Note that if you want to include a
-   * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
-   * top-level `system` parameter — there is no `"system"` role for input messages in
-   * the Messages API.
+   * [system prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role),
+   * you can use the top-level `system` parameter — there is no `"system"` role for
+   * input messages in the Messages API.
    *
    * There is a limit of 100,000 messages in a single request.
    */
@@ -4875,7 +5028,7 @@ export interface MessageCountTokensParams {
    *
    * A system prompt is a way of providing context and instructions to Claude, such
    * as specifying a particular goal or role. See our
-   * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
+   * [guide to system prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role).
    */
   system?: string | Array<BetaTextBlockParam>;
 
@@ -4887,7 +5040,7 @@ export interface MessageCountTokensParams {
    * tokens and counts towards your `max_tokens` limit.
    *
    * See
-   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
    * for details.
    */
   thinking?: BetaThinkingConfigParam;
@@ -4908,9 +5061,9 @@ export interface MessageCountTokensParams {
    *
    * There are two types of tools: **client tools** and **server tools**. The
    * behavior described below applies to client tools. For
-   * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * [server tools](https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools),
    * see their individual documentation as each has its own behavior (e.g., the
-   * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   * [web search tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)).
    *
    * Each tool definition includes:
    *
@@ -4973,7 +5126,9 @@ export interface MessageCountTokensParams {
    * functions, or more generally whenever you want the model to produce a particular
    * JSON structure of output.
    *
-   * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
+   * See our
+   * [guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview)
+   * for more details.
    */
   tools?: Array<
     | BetaTool
@@ -4996,6 +5151,8 @@ export interface MessageCountTokensParams {
     | BetaWebSearchTool20260209
     | BetaWebFetchTool20260209
     | BetaWebFetchTool20260309
+    | BetaWebSearchTool20260318
+    | BetaWebFetchTool20260318
     | BetaAdvisorTool20260301
     | BetaToolSearchToolBm25_20251119
     | BetaToolSearchToolRegex20251119
@@ -5006,6 +5163,13 @@ export interface MessageCountTokensParams {
    * 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 this request to. Use when acting
+   * on behalf of a party other than your organization. Requires the `user-profiles`
+   * beta header.
+   */
+  user_profile_id?: string;
 }
 
 export { BetaToolRunner, type BetaToolRunnerParams } from '../../../lib/tools/BetaToolRunner';
@@ -5230,6 +5394,7 @@ export declare namespace Messages {
     type BetaWebFetchTool20250910 as BetaWebFetchTool20250910,
     type BetaWebFetchTool20260209 as BetaWebFetchTool20260209,
     type BetaWebFetchTool20260309 as BetaWebFetchTool20260309,
+    type BetaWebFetchTool20260318 as BetaWebFetchTool20260318,
     type BetaWebFetchToolResultBlock as BetaWebFetchToolResultBlock,
     type BetaWebFetchToolResultBlockParam as BetaWebFetchToolResultBlockParam,
     type BetaWebFetchToolResultErrorBlock as BetaWebFetchToolResultErrorBlock,
@@ -5239,6 +5404,7 @@ export declare namespace Messages {
     type BetaWebSearchResultBlockParam as BetaWebSearchResultBlockParam,
     type BetaWebSearchTool20250305 as BetaWebSearchTool20250305,
     type BetaWebSearchTool20260209 as BetaWebSearchTool20260209,
+    type BetaWebSearchTool20260318 as BetaWebSearchTool20260318,
     type BetaWebSearchToolRequestError as BetaWebSearchToolRequestError,
     type BetaWebSearchToolResultBlock as BetaWebSearchToolResultBlock,
     type BetaWebSearchToolResultBlockContent as BetaWebSearchToolResultBlockContent,

package/src/resources/completions.ts

@@ -14,10 +14,10 @@ export class Completions extends APIResource {
    * [Legacy] Create a Text Completion.
    *
    * The Text Completions API is a legacy API. We recommend using the
-   * [Messages API](https://docs.claude.com/en/api/messages) going forward.
+   * [Messages API](https://platform.claude.com/docs/en/api/messages) going forward.
    *
    * Future models and features will not be compatible with Text Completions. See our
-   * [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
+   * [migration guide](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
    * for guidance in migrating from Text Completions to Messages.
    *
    * @example
@@ -122,8 +122,10 @@ export interface CompletionCreateParamsBase {
    * "\n\nHuman: {userQuestion}\n\nAssistant:"
    * ```
    *
-   * See [prompt validation](https://docs.claude.com/en/api/prompt-validation) and
-   * our guide to [prompt design](https://docs.claude.com/en/docs/intro-to-prompting)
+   * See
+   * [prompt validation](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
+   * and our guide to
+   * [prompt design](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/overview)
    * for more details.
    */
   prompt: string;
@@ -146,7 +148,8 @@ export interface CompletionCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream?: boolean;
 
@@ -191,7 +194,8 @@ export interface CompletionCreateParamsNonStreaming extends CompletionCreatePara
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream?: false;
 }
@@ -201,7 +205,8 @@ export interface CompletionCreateParamsStreaming extends CompletionCreateParamsB
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream: true;
 }

package/src/resources/index.ts

@@ -173,6 +173,7 @@ export {
   type WebFetchTool20250910,
   type WebFetchTool20260209,
   type WebFetchTool20260309,
+  type WebFetchTool20260318,
   type WebFetchToolResultBlock,
   type WebFetchToolResultBlockParam,
   type WebFetchToolResultErrorBlock,
@@ -182,6 +183,7 @@ export {
   type WebSearchResultBlockParam,
   type WebSearchTool20250305,
   type WebSearchTool20260209,
+  type WebSearchTool20260318,
   type WebSearchToolRequestError,
   type WebSearchToolResultBlock,
   type WebSearchToolResultBlockContent,

package/src/resources/messages/batches.ts

@@ -20,7 +20,7 @@ export class Batches extends APIResource {
    * can take up to 24 hours to complete.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -58,7 +58,7 @@ export class Batches extends APIResource {
    * `results_url` field in the response.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -76,7 +76,7 @@ export class Batches extends APIResource {
    * returned first.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -100,7 +100,7 @@ export class Batches extends APIResource {
    * like to delete an in-progress batch, you must first cancel it.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -124,7 +124,7 @@ export class Batches extends APIResource {
    * non-interruptible.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -145,7 +145,7 @@ export class Batches extends APIResource {
    * requests. Use the `custom_id` field to match results to requests.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -386,7 +386,8 @@ export namespace BatchCreateParams {
     /**
      * Messages API creation parameters for the individual request.
      *
-     * See the [Messages API reference](https://docs.claude.com/en/api/messages) for
+     * See the
+     * [Messages API reference](https://platform.claude.com/docs/en/api/messages) for
      * full documentation on available parameters.
      */
     params: MessagesAPI.MessageCreateParamsNonStreaming;

package/src/resources/messages/index.ts

@@ -164,6 +164,7 @@ export {
   type WebFetchTool20250910,
   type WebFetchTool20260209,
   type WebFetchTool20260309,
+  type WebFetchTool20260318,
   type WebFetchToolResultBlock,
   type WebFetchToolResultBlockParam,
   type WebFetchToolResultErrorBlock,
@@ -173,6 +174,7 @@ export {
   type WebSearchResultBlockParam,
   type WebSearchTool20250305,
   type WebSearchTool20260209,
+  type WebSearchTool20260318,
   type WebSearchToolRequestError,
   type WebSearchToolResultBlock,
   type WebSearchToolResultBlockContent,