@anthropic-ai/sdk 0.36.3 → 0.38.0

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

@@ -52,6 +52,8 @@ export class Messages extends APIResource {
    *
    * The Messages API can be used for either single queries or stateless multi-turn
    * conversations.
+   *
+   * Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
    */
   create(params: MessageCreateParamsNonStreaming, options?: Core.RequestOptions): APIPromise<BetaMessage>;
   create(
@@ -78,7 +80,9 @@ export class Messages extends APIResource {
 
     return this._client.post('/v1/messages?beta=true', {
       body,
-      timeout: (this._client as any)._options.timeout ?? 600000,
+      timeout:
+        (this._client as any)._options.timeout ??
+        (body.stream ? 600000 : this._client._calculateNonstreamingTimeout(body.max_tokens)),
       ...options,
       headers: {
         ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
@@ -100,6 +104,9 @@ export class Messages extends APIResource {
    *
    * The Token Count API can be used to count the number of tokens in a Message,
    * including tools, images, and documents, without creating it.
+   *
+   * Learn more about token counting in our
+   * [user guide](/en/docs/build-with-claude/token-counting)
    */
   countTokens(
     params: MessageCountTokensParams,
@@ -119,8 +126,16 @@ export class Messages extends APIResource {
 
 export type BetaMessageStreamParams = MessageCreateParamsBase;
 
+export interface BetaBase64ImageSource {
+  data: string;
+
+  media_type: 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
+
+  type: 'base64';
+}
+
 export interface BetaBase64PDFBlock {
-  source: BetaBase64PDFSource | BetaPlainTextSource | BetaContentBlockSource;
+  source: BetaBase64PDFSource | BetaPlainTextSource | BetaContentBlockSource | BetaURLPDFSource;
 
   type: 'document';
 
@@ -239,14 +254,20 @@ export interface BetaCitationsDelta {
   type: 'citations_delta';
 }
 
-export type BetaContentBlock = BetaTextBlock | BetaToolUseBlock;
+export type BetaContentBlock =
+  | BetaTextBlock
+  | BetaToolUseBlock
+  | BetaThinkingBlock
+  | BetaRedactedThinkingBlock;
 
 export type BetaContentBlockParam =
   | BetaTextBlockParam
   | BetaImageBlockParam
   | BetaToolUseBlockParam
   | BetaToolResultBlockParam
-  | BetaBase64PDFBlock;
+  | BetaBase64PDFBlock
+  | BetaThinkingBlockParam
+  | BetaRedactedThinkingBlockParam;
 
 export interface BetaContentBlockSource {
   content: string | Array<BetaContentBlockSourceContent>;
@@ -257,23 +278,13 @@ export interface BetaContentBlockSource {
 export type BetaContentBlockSourceContent = BetaTextBlockParam | BetaImageBlockParam;
 
 export interface BetaImageBlockParam {
-  source: BetaImageBlockParam.Source;
+  source: BetaBase64ImageSource | BetaURLImageSource;
 
   type: 'image';
 
   cache_control?: BetaCacheControlEphemeral | null;
 }
 
-export namespace BetaImageBlockParam {
-  export interface Source {
-    data: string;
-
-    media_type: 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
-
-    type: 'base64';
-  }
-}
-
 export interface BetaInputJSONDelta {
   partial_json: string;
 
@@ -381,6 +392,9 @@ export interface BetaMessage {
    *
    * For example, `output_tokens` will be non-zero, even for an empty string response
    * from Claude.
+   *
+   * Total input tokens in a request is the summation of `input_tokens`,
+   * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
    */
   usage: BetaUsage;
 }
@@ -426,7 +440,7 @@ export interface BetaPlainTextSource {
 }
 
 export interface BetaRawContentBlockDeltaEvent {
-  delta: BetaTextDelta | BetaInputJSONDelta | BetaCitationsDelta;
+  delta: BetaTextDelta | BetaInputJSONDelta | BetaCitationsDelta | BetaThinkingDelta | BetaSignatureDelta;
 
   index: number;
 
@@ -434,7 +448,7 @@ export interface BetaRawContentBlockDeltaEvent {
 }
 
 export interface BetaRawContentBlockStartEvent {
-  content_block: BetaTextBlock | BetaToolUseBlock;
+  content_block: BetaTextBlock | BetaToolUseBlock | BetaThinkingBlock | BetaRedactedThinkingBlock;
 
   index: number;
 
@@ -465,6 +479,9 @@ export interface BetaRawMessageDeltaEvent {
    *
    * For example, `output_tokens` will be non-zero, even for an empty string response
    * from Claude.
+   *
+   * Total input tokens in a request is the summation of `input_tokens`,
+   * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
    */
   usage: BetaMessageDeltaUsage;
 }
@@ -495,6 +512,24 @@ export type BetaRawMessageStreamEvent =
   | BetaRawContentBlockDeltaEvent
   | BetaRawContentBlockStopEvent;
 
+export interface BetaRedactedThinkingBlock {
+  data: string;
+
+  type: 'redacted_thinking';
+}
+
+export interface BetaRedactedThinkingBlockParam {
+  data: string;
+
+  type: 'redacted_thinking';
+}
+
+export interface BetaSignatureDelta {
+  signature: string;
+
+  type: 'signature_delta';
+}
+
 export interface BetaTextBlock {
   /**
    * Citations supporting the text block.
@@ -536,9 +571,65 @@ export interface BetaTextDelta {
   type: 'text_delta';
 }
 
+export interface BetaThinkingBlock {
+  signature: string;
+
+  thinking: string;
+
+  type: 'thinking';
+}
+
+export interface BetaThinkingBlockParam {
+  signature: string;
+
+  thinking: string;
+
+  type: 'thinking';
+}
+
+export interface BetaThinkingConfigDisabled {
+  type: 'disabled';
+}
+
+export interface BetaThinkingConfigEnabled {
+  /**
+   * Determines how many tokens Claude can use for its internal reasoning process.
+   * Larger budgets can enable more thorough analysis for complex problems, improving
+   * response quality.
+   *
+   * Must be ≥1024 and less than `max_tokens`.
+   *
+   * See
+   * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+   * for details.
+   */
+  budget_tokens: number;
+
+  type: 'enabled';
+}
+
+/**
+ * Configuration for enabling Claude's extended thinking.
+ *
+ * When enabled, responses include `thinking` content blocks showing Claude's
+ * thinking process before the final answer. Requires a minimum budget of 1,024
+ * tokens and counts towards your `max_tokens` limit.
+ *
+ * See
+ * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+ * for details.
+ */
+export type BetaThinkingConfigParam = BetaThinkingConfigEnabled | BetaThinkingConfigDisabled;
+
+export interface BetaThinkingDelta {
+  thinking: string;
+
+  type: 'thinking_delta';
+}
+
 export interface BetaTool {
   /**
-   * [JSON schema](https://json-schema.org/) for this tool's input.
+   * [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
    *
    * This defines the shape of the `input` that your tool accepts and that the model
    * will produce.
@@ -569,7 +660,7 @@ export interface BetaTool {
 
 export namespace BetaTool {
   /**
-   * [JSON schema](https://json-schema.org/) for this tool's input.
+   * [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
    *
    * This defines the shape of the `input` that your tool accepts and that the model
    * will produce.
@@ -595,6 +686,19 @@ export interface BetaToolBash20241022 {
   cache_control?: BetaCacheControlEphemeral | null;
 }
 
+export interface BetaToolBash20250124 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in tool_use blocks.
+   */
+  name: 'bash';
+
+  type: 'bash_20250124';
+
+  cache_control?: BetaCacheControlEphemeral | null;
+}
+
 /**
  * How the model should use the provided tools. The model can use a specific tool,
  * any available tool, or decide by itself.
@@ -679,6 +783,34 @@ export interface BetaToolComputerUse20241022 {
   display_number?: number | null;
 }
 
+export interface BetaToolComputerUse20250124 {
+  /**
+   * The height of the display in pixels.
+   */
+  display_height_px: number;
+
+  /**
+   * The width of the display in pixels.
+   */
+  display_width_px: number;
+
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in tool_use blocks.
+   */
+  name: 'computer';
+
+  type: 'computer_20250124';
+
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * The X11 display number (e.g. 0, 1) for the display.
+   */
+  display_number?: number | null;
+}
+
 export interface BetaToolResultBlockParam {
   tool_use_id: string;
 
@@ -704,11 +836,27 @@ export interface BetaToolTextEditor20241022 {
   cache_control?: BetaCacheControlEphemeral | null;
 }
 
+export interface BetaToolTextEditor20250124 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in tool_use blocks.
+   */
+  name: 'str_replace_editor';
+
+  type: 'text_editor_20250124';
+
+  cache_control?: BetaCacheControlEphemeral | null;
+}
+
 export type BetaToolUnion =
   | BetaTool
   | BetaToolComputerUse20241022
   | BetaToolBash20241022
-  | BetaToolTextEditor20241022;
+  | BetaToolTextEditor20241022
+  | BetaToolComputerUse20250124
+  | BetaToolBash20250124
+  | BetaToolTextEditor20250124;
 
 export interface BetaToolUseBlock {
   id: string;
@@ -732,6 +880,18 @@ export interface BetaToolUseBlockParam {
   cache_control?: BetaCacheControlEphemeral | null;
 }
 
+export interface BetaURLImageSource {
+  type: 'url';
+
+  url: string;
+}
+
+export interface BetaURLPDFSource {
+  type: 'url';
+
+  url: string;
+}
+
 export interface BetaUsage {
   /**
    * The number of input tokens used to create the cache entry.
@@ -913,6 +1073,19 @@ export interface MessageCreateParamsBase {
    */
   temperature?: number;
 
+  /**
+   * Body param: Configuration for enabling Claude's extended thinking.
+   *
+   * When enabled, responses include `thinking` content blocks showing Claude's
+   * thinking process before the final answer. Requires a minimum budget of 1,024
+   * tokens and counts towards your `max_tokens` limit.
+   *
+   * See
+   * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+   * for details.
+   */
+  thinking?: BetaThinkingConfigParam;
+
   /**
    * Body param: How the model should use the provided tools. The model can use a
    * specific tool, any available tool, or decide by itself.
@@ -931,8 +1104,9 @@ export interface MessageCreateParamsBase {
    *
    * - `name`: Name of the tool.
    * - `description`: Optional, but strongly-recommended description of the tool.
-   * - `input_schema`: [JSON schema](https://json-schema.org/) for the tool `input`
-   *   shape that the model will produce in `tool_use` output content blocks.
+   * - `input_schema`: [JSON schema](https://json-schema.org/draft/2020-12) for the
+   *   tool `input` shape that the model will produce in `tool_use` output content
+   *   blocks.
    *
    * For example, if you defined `tools` as:
    *
@@ -1155,6 +1329,19 @@ export interface MessageCountTokensParams {
    */
   system?: string | Array<BetaTextBlockParam>;
 
+  /**
+   * Body param: Configuration for enabling Claude's extended thinking.
+   *
+   * When enabled, responses include `thinking` content blocks showing Claude's
+   * thinking process before the final answer. Requires a minimum budget of 1,024
+   * tokens and counts towards your `max_tokens` limit.
+   *
+   * See
+   * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+   * for details.
+   */
+  thinking?: BetaThinkingConfigParam;
+
   /**
    * Body param: How the model should use the provided tools. The model can use a
    * specific tool, any available tool, or decide by itself.
@@ -1173,8 +1360,9 @@ export interface MessageCountTokensParams {
    *
    * - `name`: Name of the tool.
    * - `description`: Optional, but strongly-recommended description of the tool.
-   * - `input_schema`: [JSON schema](https://json-schema.org/) for the tool `input`
-   *   shape that the model will produce in `tool_use` output content blocks.
+   * - `input_schema`: [JSON schema](https://json-schema.org/draft/2020-12) for the
+   *   tool `input` shape that the model will produce in `tool_use` output content
+   *   blocks.
    *
    * For example, if you defined `tools` as:
    *
@@ -1231,7 +1419,15 @@ export interface MessageCountTokensParams {
    *
    * See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
    */
-  tools?: Array<BetaTool | BetaToolComputerUse20241022 | BetaToolBash20241022 | BetaToolTextEditor20241022>;
+  tools?: Array<
+    | BetaTool
+    | BetaToolComputerUse20241022
+    | BetaToolBash20241022
+    | BetaToolTextEditor20241022
+    | BetaToolComputerUse20250124
+    | BetaToolBash20250124
+    | BetaToolTextEditor20250124
+  >;
 
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
@@ -1244,6 +1440,7 @@ Messages.BetaMessageBatchesPage = BetaMessageBatchesPage;
 
 export declare namespace Messages {
   export {
+    type BetaBase64ImageSource as BetaBase64ImageSource,
     type BetaBase64PDFBlock as BetaBase64PDFBlock,
     type BetaBase64PDFSource as BetaBase64PDFSource,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
@@ -1274,23 +1471,37 @@ export declare namespace Messages {
     type BetaRawMessageStartEvent as BetaRawMessageStartEvent,
     type BetaRawMessageStopEvent as BetaRawMessageStopEvent,
     type BetaRawMessageStreamEvent as BetaRawMessageStreamEvent,
+    type BetaRedactedThinkingBlock as BetaRedactedThinkingBlock,
+    type BetaRedactedThinkingBlockParam as BetaRedactedThinkingBlockParam,
+    type BetaSignatureDelta as BetaSignatureDelta,
     type BetaTextBlock as BetaTextBlock,
     type BetaTextBlockParam as BetaTextBlockParam,
     type BetaTextCitation as BetaTextCitation,
     type BetaTextCitationParam as BetaTextCitationParam,
     type BetaTextDelta as BetaTextDelta,
+    type BetaThinkingBlock as BetaThinkingBlock,
+    type BetaThinkingBlockParam as BetaThinkingBlockParam,
+    type BetaThinkingConfigDisabled as BetaThinkingConfigDisabled,
+    type BetaThinkingConfigEnabled as BetaThinkingConfigEnabled,
+    type BetaThinkingConfigParam as BetaThinkingConfigParam,
+    type BetaThinkingDelta as BetaThinkingDelta,
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
+    type BetaToolBash20250124 as BetaToolBash20250124,
     type BetaToolChoice as BetaToolChoice,
     type BetaToolChoiceAny as BetaToolChoiceAny,
     type BetaToolChoiceAuto as BetaToolChoiceAuto,
     type BetaToolChoiceTool as BetaToolChoiceTool,
     type BetaToolComputerUse20241022 as BetaToolComputerUse20241022,
+    type BetaToolComputerUse20250124 as BetaToolComputerUse20250124,
     type BetaToolResultBlockParam as BetaToolResultBlockParam,
     type BetaToolTextEditor20241022 as BetaToolTextEditor20241022,
+    type BetaToolTextEditor20250124 as BetaToolTextEditor20250124,
     type BetaToolUnion as BetaToolUnion,
     type BetaToolUseBlock as BetaToolUseBlock,
     type BetaToolUseBlockParam as BetaToolUseBlockParam,
+    type BetaURLImageSource as BetaURLImageSource,
+    type BetaURLPDFSource as BetaURLPDFSource,
     type BetaUsage as BetaUsage,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,

package/src/resources/index.ts

@@ -25,6 +25,7 @@ export {
 } from "./completions.js";
 export {
   Messages,
+  type Base64ImageSource,
   type Base64PDFSource,
   type CacheControlEphemeral,
   type CitationCharLocation,
@@ -47,6 +48,7 @@ export {
   type InputJsonDelta,
   type InputJSONDelta,
   type Message,
+  type MessageCountTokensTool,
   type MessageDeltaEvent,
   type MessageDeltaUsage,
   type MessageParam,
@@ -65,19 +67,33 @@ export {
   type RawMessageStartEvent,
   type RawMessageStopEvent,
   type RawMessageStreamEvent,
+  type RedactedThinkingBlock,
+  type RedactedThinkingBlockParam,
+  type SignatureDelta,
   type TextBlock,
   type TextBlockParam,
   type TextCitation,
   type TextCitationParam,
   type TextDelta,
+  type ThinkingBlock,
+  type ThinkingBlockParam,
+  type ThinkingConfigDisabled,
+  type ThinkingConfigEnabled,
+  type ThinkingConfigParam,
+  type ThinkingDelta,
   type Tool,
+  type ToolBash20250124,
   type ToolChoice,
   type ToolChoiceAny,
   type ToolChoiceAuto,
   type ToolChoiceTool,
   type ToolResultBlockParam,
+  type ToolTextEditor20250124,
+  type ToolUnion,
   type ToolUseBlock,
   type ToolUseBlockParam,
+  type URLImageSource,
+  type URLPDFSource,
   type Usage,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,

package/src/resources/messages/batches.ts

@@ -16,6 +16,9 @@ export class Batches extends APIResource {
    * The Message Batches API can be used to process multiple Messages API requests at
    * once. Once a Message Batch is created, it begins processing immediately. Batches
    * can take up to 24 hours to complete.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   create(body: BatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
     return this._client.post('/v1/messages/batches', { body, ...options });
@@ -25,6 +28,9 @@ export class Batches extends APIResource {
    * This endpoint is idempotent and can be used to poll for Message Batch
    * completion. To access the results of a Message Batch, make a request to the
    * `results_url` field in the response.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   retrieve(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
     return this._client.get(`/v1/messages/batches/${messageBatchId}`, options);
@@ -33,6 +39,9 @@ export class Batches extends APIResource {
   /**
    * List all Message Batches within a Workspace. Most recently created batches are
    * returned first.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   list(
     query?: BatchListParams,
@@ -54,6 +63,9 @@ export class Batches extends APIResource {
    *
    * Message Batches can only be deleted once they've finished processing. If you'd
    * like to delete an in-progress batch, you must first cancel it.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   delete(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<DeletedMessageBatch> {
     return this._client.delete(`/v1/messages/batches/${messageBatchId}`, options);
@@ -69,6 +81,9 @@ export class Batches extends APIResource {
    * which requests were canceled, check the individual results within the batch.
    * Note that cancellation may not result in any canceled requests if they were
    * non-interruptible.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   cancel(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
     return this._client.post(`/v1/messages/batches/${messageBatchId}/cancel`, options);
@@ -80,6 +95,9 @@ export class Batches extends APIResource {
    * Each line in the file is a JSON object containing the result of a single request
    * in the Message Batch. Results are not guaranteed to be in the same order as
    * requests. Use the `custom_id` field to match results to requests.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   async results(
     messageBatchId: string,

package/src/resources/messages/index.ts

@@ -17,6 +17,7 @@ export {
 } from "./batches.js";
 export {
   Messages,
+  type Base64ImageSource,
   type Base64PDFSource,
   type CacheControlEphemeral,
   type CitationCharLocation,
@@ -38,6 +39,7 @@ export {
   type ImageBlockParam,
   type InputJSONDelta,
   type Message,
+  type MessageCountTokensTool,
   type MessageDeltaEvent,
   type MessageDeltaUsage,
   type MessageParam,
@@ -55,19 +57,33 @@ export {
   type RawMessageStartEvent,
   type RawMessageStopEvent,
   type RawMessageStreamEvent,
+  type RedactedThinkingBlock,
+  type RedactedThinkingBlockParam,
+  type SignatureDelta,
   type TextBlock,
   type TextBlockParam,
   type TextCitation,
   type TextCitationParam,
   type TextDelta,
+  type ThinkingBlock,
+  type ThinkingBlockParam,
+  type ThinkingConfigDisabled,
+  type ThinkingConfigEnabled,
+  type ThinkingConfigParam,
+  type ThinkingDelta,
   type Tool,
+  type ToolBash20250124,
   type ToolChoice,
   type ToolChoiceAny,
   type ToolChoiceAuto,
   type ToolChoiceTool,
   type ToolResultBlockParam,
+  type ToolTextEditor20250124,
+  type ToolUnion,
   type ToolUseBlock,
   type ToolUseBlockParam,
+  type URLImageSource,
+  type URLPDFSource,
   type Usage,
   type MessageCreateParams,
   type MessageCreateParamsBase,