@anthropic-ai/sdk 0.61.0 → 0.63.0

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

@@ -30,6 +30,9 @@ import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import type { Model } from '../../messages/messages';
 import { BetaMessageStream } from '../../../lib/BetaMessageStream';
+import { MODEL_NONSTREAMING_TOKENS } from '../../../internal/constants';
+import { BetaToolRunner, BetaToolRunnerParams } from '../../../lib/tools/BetaToolRunner';
+import { Anthropic } from '../../../client';
 
 const DEPRECATED_MODELS: {
   [K in Model]?: string;
@@ -46,7 +49,6 @@ const DEPRECATED_MODELS: {
   'claude-3-5-sonnet-20241022': 'October 22, 2025',
   'claude-3-5-sonnet-20240620': 'October 22, 2025',
 };
-import { MODEL_NONSTREAMING_TOKENS } from '../../../internal/constants';
 
 export class Messages extends APIResource {
   batches: BatchesAPI.Batches = new BatchesAPI.Batches(this._client);
@@ -148,6 +150,13 @@ export class Messages extends APIResource {
       ]),
     });
   }
+
+  toolRunner(body: BetaToolRunnerParams & { stream?: false }): BetaToolRunner<false>;
+  toolRunner(body: BetaToolRunnerParams & { stream: true }): BetaToolRunner<true>;
+  toolRunner(body: BetaToolRunnerParams): BetaToolRunner<boolean>;
+  toolRunner(body: BetaToolRunnerParams): BetaToolRunner<boolean> {
+    return new BetaToolRunner(this._client as Anthropic, body);
+  }
 }
 
 export type BetaMessageStreamParams = MessageCreateParamsBase;
@@ -305,6 +314,10 @@ export interface BetaCitationCharLocationParam {
   type: 'char_location';
 }
 
+export interface BetaCitationConfig {
+  enabled: boolean;
+}
+
 export interface BetaCitationContentBlockLocation {
   cited_text: string;
 
@@ -601,6 +614,7 @@ export type BetaContentBlock =
   | BetaToolUseBlock
   | BetaServerToolUseBlock
   | BetaWebSearchToolResultBlock
+  | BetaWebFetchToolResultBlock
   | BetaCodeExecutionToolResultBlock
   | BetaBashCodeExecutionToolResultBlock
   | BetaTextEditorCodeExecutionToolResultBlock
@@ -622,6 +636,7 @@ export type BetaContentBlockParam =
   | BetaToolResultBlockParam
   | BetaServerToolUseBlockParam
   | BetaWebSearchToolResultBlockParam
+  | BetaWebFetchToolResultBlockParam
   | BetaCodeExecutionToolResultBlockParam
   | BetaBashCodeExecutionToolResultBlockParam
   | BetaTextEditorCodeExecutionToolResultBlockParam
@@ -637,6 +652,22 @@ export interface BetaContentBlockSource {
 
 export type BetaContentBlockSourceContent = BetaTextBlockParam | BetaImageBlockParam;
 
+export interface BetaDocumentBlock {
+  /**
+   * Citation configuration for the document
+   */
+  citations: BetaCitationConfig | null;
+
+  source: BetaBase64PDFSource | BetaPlainTextSource;
+
+  /**
+   * The title of the document
+   */
+  title: string | null;
+
+  type: 'document';
+}
+
 export interface BetaFileDocumentSource {
   file_id: string;
 
@@ -918,6 +949,7 @@ export interface BetaRawContentBlockStartEvent {
     | BetaToolUseBlock
     | BetaServerToolUseBlock
     | BetaWebSearchToolResultBlock
+    | BetaWebFetchToolResultBlock
     | BetaCodeExecutionToolResultBlock
     | BetaBashCodeExecutionToolResultBlock
     | BetaTextEditorCodeExecutionToolResultBlock
@@ -1020,7 +1052,7 @@ export interface BetaRequestDocumentBlock {
    */
   cache_control?: BetaCacheControlEphemeral | null;
 
-  citations?: BetaCitationsConfigParam;
+  citations?: BetaCitationsConfigParam | null;
 
   context?: string | null;
 
@@ -1078,6 +1110,11 @@ export interface BetaSearchResultBlockParam {
 }
 
 export interface BetaServerToolUsage {
+  /**
+   * The number of web fetch tool requests.
+   */
+  web_fetch_requests: number;
+
   /**
    * The number of web search tool requests.
    */
@@ -1089,7 +1126,7 @@ export interface BetaServerToolUseBlock {
 
   input: unknown;
 
-  name: 'web_search' | 'code_execution' | 'bash_code_execution' | 'text_editor_code_execution';
+  name: 'web_search' | 'web_fetch' | 'code_execution' | 'bash_code_execution' | 'text_editor_code_execution';
 
   type: 'server_tool_use';
 }
@@ -1099,7 +1136,7 @@ export interface BetaServerToolUseBlockParam {
 
   input: unknown;
 
-  name: 'web_search' | 'code_execution' | 'bash_code_execution' | 'text_editor_code_execution';
+  name: 'web_search' | 'web_fetch' | 'code_execution' | 'bash_code_execution' | 'text_editor_code_execution';
 
   type: 'server_tool_use';
 
@@ -1396,7 +1433,7 @@ export namespace BetaTool {
 
     properties?: unknown | null;
 
-    required?: Array<string> | null;
+    required?: string[] | readonly string[] | null;
 
     [k: string]: unknown;
   }
@@ -1569,11 +1606,15 @@ export interface BetaToolResultBlockParam {
    */
   cache_control?: BetaCacheControlEphemeral | null;
 
-  content?: string | Array<BetaTextBlockParam | BetaImageBlockParam | BetaSearchResultBlockParam>;
+  content?:
+    | string
+    | Array<BetaTextBlockParam | BetaImageBlockParam | BetaSearchResultBlockParam | BetaRequestDocumentBlock>;
 
   is_error?: boolean;
 }
 
+export type BetaToolResultContentBlockParam = Extract<BetaToolResultBlockParam['content'], any[]>[number];
+
 export interface BetaToolTextEditor20241022 {
   /**
    * Name of the tool.
@@ -1656,7 +1697,8 @@ export type BetaToolUnion =
   | BetaToolTextEditor20250124
   | BetaToolTextEditor20250429
   | BetaToolTextEditor20250728
-  | BetaWebSearchTool20250305;
+  | BetaWebSearchTool20250305
+  | BetaWebFetchTool20250910;
 
 export interface BetaToolUseBlock {
   id: string;
@@ -1732,6 +1774,124 @@ export interface BetaUsage {
   service_tier: 'standard' | 'priority' | 'batch' | null;
 }
 
+export interface BetaWebFetchBlock {
+  content: BetaDocumentBlock;
+
+  /**
+   * ISO 8601 timestamp when the content was retrieved
+   */
+  retrieved_at: string | null;
+
+  type: 'web_fetch_result';
+
+  /**
+   * Fetched content URL
+   */
+  url: string;
+}
+
+export interface BetaWebFetchBlockParam {
+  content: BetaRequestDocumentBlock;
+
+  type: 'web_fetch_result';
+
+  /**
+   * Fetched content URL
+   */
+  url: string;
+
+  /**
+   * ISO 8601 timestamp when the content was retrieved
+   */
+  retrieved_at?: string | null;
+}
+
+export interface BetaWebFetchTool20250910 {
+  /**
+   * 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_20250910';
+
+  /**
+   * 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;
+
+  /**
+   * 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;
+}
+
+export interface BetaWebFetchToolResultBlock {
+  content: BetaWebFetchToolResultErrorBlock | BetaWebFetchBlock;
+
+  tool_use_id: string;
+
+  type: 'web_fetch_tool_result';
+}
+
+export interface BetaWebFetchToolResultBlockParam {
+  content: BetaWebFetchToolResultErrorBlockParam | BetaWebFetchBlockParam;
+
+  tool_use_id: string;
+
+  type: 'web_fetch_tool_result';
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+}
+
+export interface BetaWebFetchToolResultErrorBlock {
+  error_code: BetaWebFetchToolResultErrorCode;
+
+  type: 'web_fetch_tool_result_error';
+}
+
+export interface BetaWebFetchToolResultErrorBlockParam {
+  error_code: BetaWebFetchToolResultErrorCode;
+
+  type: 'web_fetch_tool_result_error';
+}
+
+export type BetaWebFetchToolResultErrorCode =
+  | 'invalid_tool_input'
+  | 'url_too_long'
+  | 'url_not_allowed'
+  | 'url_not_accessible'
+  | 'unsupported_content_type'
+  | 'too_many_requests'
+  | 'max_uses_exceeded'
+  | 'unavailable';
+
 export interface BetaWebSearchResultBlock {
   encrypted_content: string;
 
@@ -2392,6 +2552,7 @@ export interface MessageCountTokensParams {
     | BetaToolTextEditor20250429
     | BetaToolTextEditor20250728
     | BetaWebSearchTool20250305
+    | BetaWebFetchTool20250910
   >;
 
   /**
@@ -2400,8 +2561,12 @@ export interface MessageCountTokensParams {
   betas?: Array<BetaAPI.AnthropicBeta>;
 }
 
+export { BetaToolRunner, type BetaToolRunnerParams } from '../../../lib/tools/BetaToolRunner';
+
 Messages.Batches = Batches;
 
+Messages.BetaToolRunner = BetaToolRunner;
+
 export declare namespace Messages {
   export {
     type BetaBase64ImageSource as BetaBase64ImageSource,
@@ -2418,6 +2583,7 @@ export declare namespace Messages {
     type BetaCacheCreation as BetaCacheCreation,
     type BetaCitationCharLocation as BetaCitationCharLocation,
     type BetaCitationCharLocationParam as BetaCitationCharLocationParam,
+    type BetaCitationConfig as BetaCitationConfig,
     type BetaCitationContentBlockLocation as BetaCitationContentBlockLocation,
     type BetaCitationContentBlockLocationParam as BetaCitationContentBlockLocationParam,
     type BetaCitationPageLocation as BetaCitationPageLocation,
@@ -2448,6 +2614,7 @@ export declare namespace Messages {
     type BetaContentBlockParam as BetaContentBlockParam,
     type BetaContentBlockSource as BetaContentBlockSource,
     type BetaContentBlockSourceContent as BetaContentBlockSourceContent,
+    type BetaDocumentBlock as BetaDocumentBlock,
     type BetaFileDocumentSource as BetaFileDocumentSource,
     type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,
@@ -2513,6 +2680,7 @@ export declare namespace Messages {
     type BetaToolComputerUse20241022 as BetaToolComputerUse20241022,
     type BetaToolComputerUse20250124 as BetaToolComputerUse20250124,
     type BetaToolResultBlockParam as BetaToolResultBlockParam,
+    type BetaToolResultContentBlockParam as BetaToolResultContentBlockParam,
     type BetaToolTextEditor20241022 as BetaToolTextEditor20241022,
     type BetaToolTextEditor20250124 as BetaToolTextEditor20250124,
     type BetaToolTextEditor20250429 as BetaToolTextEditor20250429,
@@ -2523,6 +2691,14 @@ export declare namespace Messages {
     type BetaURLImageSource as BetaURLImageSource,
     type BetaURLPDFSource as BetaURLPDFSource,
     type BetaUsage as BetaUsage,
+    type BetaWebFetchBlock as BetaWebFetchBlock,
+    type BetaWebFetchBlockParam as BetaWebFetchBlockParam,
+    type BetaWebFetchTool20250910 as BetaWebFetchTool20250910,
+    type BetaWebFetchToolResultBlock as BetaWebFetchToolResultBlock,
+    type BetaWebFetchToolResultBlockParam as BetaWebFetchToolResultBlockParam,
+    type BetaWebFetchToolResultErrorBlock as BetaWebFetchToolResultErrorBlock,
+    type BetaWebFetchToolResultErrorBlockParam as BetaWebFetchToolResultErrorBlockParam,
+    type BetaWebFetchToolResultErrorCode as BetaWebFetchToolResultErrorCode,
     type BetaWebSearchResultBlock as BetaWebSearchResultBlock,
     type BetaWebSearchResultBlockParam as BetaWebSearchResultBlockParam,
     type BetaWebSearchTool20250305 as BetaWebSearchTool20250305,
@@ -2540,6 +2716,8 @@ export declare namespace Messages {
     type MessageCountTokensParams as MessageCountTokensParams,
   };
 
+  export { type BetaToolRunnerParams, BetaToolRunner };
+
   export {
     Batches as Batches,
     type BetaDeletedMessageBatch as BetaDeletedMessageBatch,

package/src/resources/messages/messages.ts

@@ -355,7 +355,7 @@ export interface DocumentBlockParam {
    */
   cache_control?: CacheControlEphemeral | null;
 
-  citations?: CitationsConfigParam;
+  citations?: CitationsConfigParam | null;
 
   context?: string | null;
 
@@ -1000,7 +1000,7 @@ export interface ToolResultBlockParam {
    */
   cache_control?: CacheControlEphemeral | null;
 
-  content?: string | Array<TextBlockParam | ImageBlockParam | SearchResultBlockParam>;
+  content?: string | Array<TextBlockParam | ImageBlockParam | SearchResultBlockParam | DocumentBlockParam>;
 
   is_error?: boolean;
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.61.0'; // x-release-please-version
+export const VERSION = '0.63.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.61.0";
+export declare const VERSION = "0.63.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.61.0";
+export declare const VERSION = "0.63.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.61.0'; // x-release-please-version
+exports.VERSION = '0.63.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.61.0'; // x-release-please-version
+export const VERSION = '0.63.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map