@anthropic-ai/sdk 0.30.1 → 0.32.0

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

@@ -1,57 +1,61 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
-  BetaCacheControlEphemeral,
-  BetaContentBlock,
-  BetaContentBlockParam,
-  BetaImageBlockParam,
-  BetaInputJSONDelta,
-  BetaMessage,
-  BetaMessageDeltaUsage,
-  BetaMessageParam,
-  BetaMetadata,
-  BetaRawContentBlockDeltaEvent,
-  BetaRawContentBlockStartEvent,
-  BetaRawContentBlockStopEvent,
-  BetaRawMessageDeltaEvent,
-  BetaRawMessageStartEvent,
-  BetaRawMessageStopEvent,
-  BetaRawMessageStreamEvent,
-  BetaTextBlock,
-  BetaTextBlockParam,
-  BetaTextDelta,
-  BetaTool,
-  BetaToolBash20241022,
-  BetaToolChoice,
-  BetaToolChoiceAny,
-  BetaToolChoiceAuto,
-  BetaToolChoiceTool,
-  BetaToolComputerUse20241022,
-  BetaToolResultBlockParam,
-  BetaToolTextEditor20241022,
-  BetaToolUnion,
-  BetaToolUseBlock,
-  BetaToolUseBlockParam,
-  BetaUsage,
-  MessageCreateParams,
-  MessageCreateParamsNonStreaming,
-  MessageCreateParamsStreaming,
-  Messages,
-} from "./messages.js";
-export {
-  BetaMessageBatch,
-  BetaMessageBatchCanceledResult,
-  BetaMessageBatchErroredResult,
-  BetaMessageBatchExpiredResult,
-  BetaMessageBatchIndividualResponse,
-  BetaMessageBatchRequestCounts,
-  BetaMessageBatchResult,
-  BetaMessageBatchSucceededResult,
-  BatchCreateParams,
-  BatchRetrieveParams,
-  BatchListParams,
-  BatchCancelParams,
-  BatchResultsParams,
   BetaMessageBatchesPage,
   Batches,
+  type BetaMessageBatch,
+  type BetaMessageBatchCanceledResult,
+  type BetaMessageBatchErroredResult,
+  type BetaMessageBatchExpiredResult,
+  type BetaMessageBatchIndividualResponse,
+  type BetaMessageBatchRequestCounts,
+  type BetaMessageBatchResult,
+  type BetaMessageBatchSucceededResult,
+  type BatchCreateParams,
+  type BatchRetrieveParams,
+  type BatchListParams,
+  type BatchCancelParams,
+  type BatchResultsParams,
 } from "./batches.js";
+export {
+  Messages,
+  type BetaBase64PDFBlock,
+  type BetaBase64PDFSource,
+  type BetaCacheControlEphemeral,
+  type BetaContentBlock,
+  type BetaContentBlockParam,
+  type BetaImageBlockParam,
+  type BetaInputJSONDelta,
+  type BetaMessage,
+  type BetaMessageDeltaUsage,
+  type BetaMessageParam,
+  type BetaMessageTokensCount,
+  type BetaMetadata,
+  type BetaRawContentBlockDeltaEvent,
+  type BetaRawContentBlockStartEvent,
+  type BetaRawContentBlockStopEvent,
+  type BetaRawMessageDeltaEvent,
+  type BetaRawMessageStartEvent,
+  type BetaRawMessageStopEvent,
+  type BetaRawMessageStreamEvent,
+  type BetaTextBlock,
+  type BetaTextBlockParam,
+  type BetaTextDelta,
+  type BetaTool,
+  type BetaToolBash20241022,
+  type BetaToolChoice,
+  type BetaToolChoiceAny,
+  type BetaToolChoiceAuto,
+  type BetaToolChoiceTool,
+  type BetaToolComputerUse20241022,
+  type BetaToolResultBlockParam,
+  type BetaToolTextEditor20241022,
+  type BetaToolUnion,
+  type BetaToolUseBlock,
+  type BetaToolUseBlockParam,
+  type BetaUsage,
+  type MessageCreateParams,
+  type MessageCreateParamsNonStreaming,
+  type MessageCreateParamsStreaming,
+  type MessageCountTokensParams,
+} from "./messages.js";

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

@@ -7,6 +7,23 @@ import * as MessagesMessagesAPI from "./messages.js";
 import * as MessagesAPI from "../../messages.js";
 import * as BetaAPI from "../beta.js";
 import * as BatchesAPI from "./batches.js";
+import {
+  BatchCancelParams,
+  BatchCreateParams,
+  BatchListParams,
+  BatchResultsParams,
+  BatchRetrieveParams,
+  Batches,
+  BetaMessageBatch,
+  BetaMessageBatchCanceledResult,
+  BetaMessageBatchErroredResult,
+  BetaMessageBatchExpiredResult,
+  BetaMessageBatchIndividualResponse,
+  BetaMessageBatchRequestCounts,
+  BetaMessageBatchResult,
+  BetaMessageBatchSucceededResult,
+  BetaMessageBatchesPage,
+} from "./batches.js";
 import { Stream } from "../../../streaming.js";
 
 export class Messages extends APIResource {
@@ -44,6 +61,43 @@ export class Messages extends APIResource {
       stream: params.stream ?? false,
     }) as APIPromise<BetaMessage> | APIPromise<Stream<BetaRawMessageStreamEvent>>;
   }
+
+  /**
+   * Count the number of tokens in a Message.
+   *
+   * The Token Count API can be used to count the number of tokens in a Message,
+   * including tools, images, and documents, without creating it.
+   */
+  countTokens(
+    params: MessageCountTokensParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<BetaMessageTokensCount> {
+    const { betas, ...body } = params;
+    return this._client.post('/v1/messages/count_tokens?beta=true', {
+      body,
+      ...options,
+      headers: {
+        'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString(),
+        ...options?.headers,
+      },
+    });
+  }
+}
+
+export interface BetaBase64PDFBlock {
+  source: BetaBase64PDFSource;
+
+  type: 'document';
+
+  cache_control?: BetaCacheControlEphemeral | null;
+}
+
+export interface BetaBase64PDFSource {
+  data: string;
+
+  media_type: 'application/pdf';
+
+  type: 'base64';
 }
 
 export interface BetaCacheControlEphemeral {
@@ -56,7 +110,8 @@ export type BetaContentBlockParam =
   | BetaTextBlockParam
   | BetaImageBlockParam
   | BetaToolUseBlockParam
-  | BetaToolResultBlockParam;
+  | BetaToolResultBlockParam
+  | BetaBase64PDFBlock;
 
 export interface BetaImageBlockParam {
   source: BetaImageBlockParam.Source;
@@ -200,6 +255,14 @@ export interface BetaMessageParam {
   role: 'user' | 'assistant';
 }
 
+export interface BetaMessageTokensCount {
+  /**
+   * The total number of tokens across the provided list of messages, system prompt,
+   * and tools.
+   */
+  input_tokens: number;
+}
+
 export interface BetaMetadata {
   /**
    * An external identifier for the user who is associated with the request.
@@ -310,6 +373,11 @@ export interface BetaTool {
    */
   input_schema: BetaTool.InputSchema;
 
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in tool_use blocks.
+   */
   name: string;
 
   cache_control?: BetaCacheControlEphemeral | null;
@@ -343,6 +411,11 @@ export namespace BetaTool {
 }
 
 export interface BetaToolBash20241022 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in tool_use blocks.
+   */
   name: 'bash';
 
   type: 'bash_20241022';
@@ -407,16 +480,30 @@ export interface BetaToolChoiceTool {
 }
 
 export interface BetaToolComputerUse20241022 {
+  /**
+   * 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_20241022';
 
   cache_control?: BetaCacheControlEphemeral | null;
 
+  /**
+   * The X11 display number (e.g. 0, 1) for the display.
+   */
   display_number?: number | null;
 }
 
@@ -433,6 +520,11 @@ export interface BetaToolResultBlockParam {
 }
 
 export interface BetaToolTextEditor20241022 {
+  /**
+   * 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_20241022';
@@ -784,55 +876,258 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
   stream: true;
 }
 
-export namespace Messages {
-  export import BetaCacheControlEphemeral = MessagesMessagesAPI.BetaCacheControlEphemeral;
-  export import BetaContentBlock = MessagesMessagesAPI.BetaContentBlock;
-  export import BetaContentBlockParam = MessagesMessagesAPI.BetaContentBlockParam;
-  export import BetaImageBlockParam = MessagesMessagesAPI.BetaImageBlockParam;
-  export import BetaInputJSONDelta = MessagesMessagesAPI.BetaInputJSONDelta;
-  export import BetaMessage = MessagesMessagesAPI.BetaMessage;
-  export import BetaMessageDeltaUsage = MessagesMessagesAPI.BetaMessageDeltaUsage;
-  export import BetaMessageParam = MessagesMessagesAPI.BetaMessageParam;
-  export import BetaMetadata = MessagesMessagesAPI.BetaMetadata;
-  export import BetaRawContentBlockDeltaEvent = MessagesMessagesAPI.BetaRawContentBlockDeltaEvent;
-  export import BetaRawContentBlockStartEvent = MessagesMessagesAPI.BetaRawContentBlockStartEvent;
-  export import BetaRawContentBlockStopEvent = MessagesMessagesAPI.BetaRawContentBlockStopEvent;
-  export import BetaRawMessageDeltaEvent = MessagesMessagesAPI.BetaRawMessageDeltaEvent;
-  export import BetaRawMessageStartEvent = MessagesMessagesAPI.BetaRawMessageStartEvent;
-  export import BetaRawMessageStopEvent = MessagesMessagesAPI.BetaRawMessageStopEvent;
-  export import BetaRawMessageStreamEvent = MessagesMessagesAPI.BetaRawMessageStreamEvent;
-  export import BetaTextBlock = MessagesMessagesAPI.BetaTextBlock;
-  export import BetaTextBlockParam = MessagesMessagesAPI.BetaTextBlockParam;
-  export import BetaTextDelta = MessagesMessagesAPI.BetaTextDelta;
-  export import BetaTool = MessagesMessagesAPI.BetaTool;
-  export import BetaToolBash20241022 = MessagesMessagesAPI.BetaToolBash20241022;
-  export import BetaToolChoice = MessagesMessagesAPI.BetaToolChoice;
-  export import BetaToolChoiceAny = MessagesMessagesAPI.BetaToolChoiceAny;
-  export import BetaToolChoiceAuto = MessagesMessagesAPI.BetaToolChoiceAuto;
-  export import BetaToolChoiceTool = MessagesMessagesAPI.BetaToolChoiceTool;
-  export import BetaToolComputerUse20241022 = MessagesMessagesAPI.BetaToolComputerUse20241022;
-  export import BetaToolResultBlockParam = MessagesMessagesAPI.BetaToolResultBlockParam;
-  export import BetaToolTextEditor20241022 = MessagesMessagesAPI.BetaToolTextEditor20241022;
-  export import BetaToolUnion = MessagesMessagesAPI.BetaToolUnion;
-  export import BetaToolUseBlock = MessagesMessagesAPI.BetaToolUseBlock;
-  export import BetaToolUseBlockParam = MessagesMessagesAPI.BetaToolUseBlockParam;
-  export import BetaUsage = MessagesMessagesAPI.BetaUsage;
-  export import MessageCreateParams = MessagesMessagesAPI.MessageCreateParams;
-  export import MessageCreateParamsNonStreaming = MessagesMessagesAPI.MessageCreateParamsNonStreaming;
-  export import MessageCreateParamsStreaming = MessagesMessagesAPI.MessageCreateParamsStreaming;
-  export import Batches = BatchesAPI.Batches;
-  export import BetaMessageBatch = BatchesAPI.BetaMessageBatch;
-  export import BetaMessageBatchCanceledResult = BatchesAPI.BetaMessageBatchCanceledResult;
-  export import BetaMessageBatchErroredResult = BatchesAPI.BetaMessageBatchErroredResult;
-  export import BetaMessageBatchExpiredResult = BatchesAPI.BetaMessageBatchExpiredResult;
-  export import BetaMessageBatchIndividualResponse = BatchesAPI.BetaMessageBatchIndividualResponse;
-  export import BetaMessageBatchRequestCounts = BatchesAPI.BetaMessageBatchRequestCounts;
-  export import BetaMessageBatchResult = BatchesAPI.BetaMessageBatchResult;
-  export import BetaMessageBatchSucceededResult = BatchesAPI.BetaMessageBatchSucceededResult;
-  export import BetaMessageBatchesPage = BatchesAPI.BetaMessageBatchesPage;
-  export import BatchCreateParams = BatchesAPI.BatchCreateParams;
-  export import BatchRetrieveParams = BatchesAPI.BatchRetrieveParams;
-  export import BatchListParams = BatchesAPI.BatchListParams;
-  export import BatchCancelParams = BatchesAPI.BatchCancelParams;
-  export import BatchResultsParams = BatchesAPI.BatchResultsParams;
+export interface MessageCountTokensParams {
+  /**
+   * Body param: Input messages.
+   *
+   * Our models are trained to operate on alternating `user` and `assistant`
+   * conversational turns. When creating a new `Message`, you specify the prior
+   * conversational turns with the `messages` parameter, and the model then generates
+   * the next `Message` in the conversation. Consecutive `user` or `assistant` turns
+   * in your request will be combined into a single turn.
+   *
+   * Each input message must be an object with a `role` and `content`. You can
+   * specify a single `user`-role message, or you can include multiple `user` and
+   * `assistant` messages.
+   *
+   * If the final message uses the `assistant` role, the response content will
+   * continue immediately from the content in that message. This can be used to
+   * constrain part of the model's response.
+   *
+   * Example with a single `user` message:
+   *
+   * ```json
+   * [{ "role": "user", "content": "Hello, Claude" }]
+   * ```
+   *
+   * Example with multiple conversational turns:
+   *
+   * ```json
+   * [
+   *   { "role": "user", "content": "Hello there." },
+   *   { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
+   *   { "role": "user", "content": "Can you explain LLMs in plain English?" }
+   * ]
+   * ```
+   *
+   * Example with a partially-filled response from Claude:
+   *
+   * ```json
+   * [
+   *   {
+   *     "role": "user",
+   *     "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"
+   *   },
+   *   { "role": "assistant", "content": "The best answer is (" }
+   * ]
+   * ```
+   *
+   * Each input message `content` may be either a single `string` or an array of
+   * content blocks, where each block has a specific `type`. Using a `string` for
+   * `content` is shorthand for an array of one content block of type `"text"`. The
+   * following input messages are equivalent:
+   *
+   * ```json
+   * { "role": "user", "content": "Hello, Claude" }
+   * ```
+   *
+   * ```json
+   * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
+   * ```
+   *
+   * Starting with Claude 3 models, you can also send image content blocks:
+   *
+   * ```json
+   * {
+   *   "role": "user",
+   *   "content": [
+   *     {
+   *       "type": "image",
+   *       "source": {
+   *         "type": "base64",
+   *         "media_type": "image/jpeg",
+   *         "data": "/9j/4AAQSkZJRg..."
+   *       }
+   *     },
+   *     { "type": "text", "text": "What is in this image?" }
+   *   ]
+   * }
+   * ```
+   *
+   * We currently support the `base64` source type for images, and the `image/jpeg`,
+   * `image/png`, `image/gif`, and `image/webp` media types.
+   *
+   * See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
+   * more input examples.
+   *
+   * Note that if you want to include a
+   * [system prompt](https://docs.anthropic.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.
+   */
+  messages: Array<BetaMessageParam>;
+
+  /**
+   * Body param: The model that will complete your prompt.\n\nSee
+   * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
+  /**
+   * Body param: System prompt.
+   *
+   * 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.anthropic.com/en/docs/system-prompts).
+   */
+  system?: string | Array<BetaTextBlockParam>;
+
+  /**
+   * Body param: How the model should use the provided tools. The model can use a
+   * specific tool, any available tool, or decide by itself.
+   */
+  tool_choice?: BetaToolChoice;
+
+  /**
+   * Body param: Definitions of tools that the model may use.
+   *
+   * If you include `tools` in your API request, the model may return `tool_use`
+   * content blocks that represent the model's use of those tools. You can then run
+   * those tools using the tool input generated by the model and then optionally
+   * return results back to the model using `tool_result` content blocks.
+   *
+   * Each tool definition includes:
+   *
+   * - `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.
+   *
+   * For example, if you defined `tools` as:
+   *
+   * ```json
+   * [
+   *   {
+   *     "name": "get_stock_price",
+   *     "description": "Get the current stock price for a given ticker symbol.",
+   *     "input_schema": {
+   *       "type": "object",
+   *       "properties": {
+   *         "ticker": {
+   *           "type": "string",
+   *           "description": "The stock ticker symbol, e.g. AAPL for Apple Inc."
+   *         }
+   *       },
+   *       "required": ["ticker"]
+   *     }
+   *   }
+   * ]
+   * ```
+   *
+   * And then asked the model "What's the S&P 500 at today?", the model might produce
+   * `tool_use` content blocks in the response like this:
+   *
+   * ```json
+   * [
+   *   {
+   *     "type": "tool_use",
+   *     "id": "toolu_01D7FLrfh4GYq7yT1ULFeyMV",
+   *     "name": "get_stock_price",
+   *     "input": { "ticker": "^GSPC" }
+   *   }
+   * ]
+   * ```
+   *
+   * You might then run your `get_stock_price` tool with `{"ticker": "^GSPC"}` as an
+   * input, and return the following back to the model in a subsequent `user`
+   * message:
+   *
+   * ```json
+   * [
+   *   {
+   *     "type": "tool_result",
+   *     "tool_use_id": "toolu_01D7FLrfh4GYq7yT1ULFeyMV",
+   *     "content": "259.75 USD"
+   *   }
+   * ]
+   * ```
+   *
+   * Tools can be used for workflows that include running client-side tools and
+   * functions, or more generally whenever you want the model to produce a particular
+   * JSON structure of output.
+   *
+   * See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+   */
+  tools?: Array<BetaTool | BetaToolComputerUse20241022 | BetaToolBash20241022 | BetaToolTextEditor20241022>;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+Messages.Batches = Batches;
+Messages.BetaMessageBatchesPage = BetaMessageBatchesPage;
+
+export declare namespace Messages {
+  export {
+    type BetaBase64PDFBlock as BetaBase64PDFBlock,
+    type BetaBase64PDFSource as BetaBase64PDFSource,
+    type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
+    type BetaContentBlock as BetaContentBlock,
+    type BetaContentBlockParam as BetaContentBlockParam,
+    type BetaImageBlockParam as BetaImageBlockParam,
+    type BetaInputJSONDelta as BetaInputJSONDelta,
+    type BetaMessage as BetaMessage,
+    type BetaMessageDeltaUsage as BetaMessageDeltaUsage,
+    type BetaMessageParam as BetaMessageParam,
+    type BetaMessageTokensCount as BetaMessageTokensCount,
+    type BetaMetadata as BetaMetadata,
+    type BetaRawContentBlockDeltaEvent as BetaRawContentBlockDeltaEvent,
+    type BetaRawContentBlockStartEvent as BetaRawContentBlockStartEvent,
+    type BetaRawContentBlockStopEvent as BetaRawContentBlockStopEvent,
+    type BetaRawMessageDeltaEvent as BetaRawMessageDeltaEvent,
+    type BetaRawMessageStartEvent as BetaRawMessageStartEvent,
+    type BetaRawMessageStopEvent as BetaRawMessageStopEvent,
+    type BetaRawMessageStreamEvent as BetaRawMessageStreamEvent,
+    type BetaTextBlock as BetaTextBlock,
+    type BetaTextBlockParam as BetaTextBlockParam,
+    type BetaTextDelta as BetaTextDelta,
+    type BetaTool as BetaTool,
+    type BetaToolBash20241022 as BetaToolBash20241022,
+    type BetaToolChoice as BetaToolChoice,
+    type BetaToolChoiceAny as BetaToolChoiceAny,
+    type BetaToolChoiceAuto as BetaToolChoiceAuto,
+    type BetaToolChoiceTool as BetaToolChoiceTool,
+    type BetaToolComputerUse20241022 as BetaToolComputerUse20241022,
+    type BetaToolResultBlockParam as BetaToolResultBlockParam,
+    type BetaToolTextEditor20241022 as BetaToolTextEditor20241022,
+    type BetaToolUnion as BetaToolUnion,
+    type BetaToolUseBlock as BetaToolUseBlock,
+    type BetaToolUseBlockParam as BetaToolUseBlockParam,
+    type BetaUsage as BetaUsage,
+    type MessageCreateParams as MessageCreateParams,
+    type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
+    type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
+    type MessageCountTokensParams as MessageCountTokensParams,
+  };
+
+  export {
+    Batches as Batches,
+    type BetaMessageBatch as BetaMessageBatch,
+    type BetaMessageBatchCanceledResult as BetaMessageBatchCanceledResult,
+    type BetaMessageBatchErroredResult as BetaMessageBatchErroredResult,
+    type BetaMessageBatchExpiredResult as BetaMessageBatchExpiredResult,
+    type BetaMessageBatchIndividualResponse as BetaMessageBatchIndividualResponse,
+    type BetaMessageBatchRequestCounts as BetaMessageBatchRequestCounts,
+    type BetaMessageBatchResult as BetaMessageBatchResult,
+    type BetaMessageBatchSucceededResult as BetaMessageBatchSucceededResult,
+    BetaMessageBatchesPage as BetaMessageBatchesPage,
+    type BatchCreateParams as BatchCreateParams,
+    type BatchRetrieveParams as BatchRetrieveParams,
+    type BatchListParams as BatchListParams,
+    type BatchCancelParams as BatchCancelParams,
+    type BatchResultsParams as BatchResultsParams,
+  };
 }

package/src/resources/beta/prompt-caching/index.ts

@@ -1,20 +1,20 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { PromptCaching } from "./prompt-caching.js";
 export {
-  PromptCachingBetaCacheControlEphemeral,
-  PromptCachingBetaImageBlockParam,
-  PromptCachingBetaMessage,
-  PromptCachingBetaMessageParam,
-  PromptCachingBetaTextBlockParam,
-  PromptCachingBetaTool,
-  PromptCachingBetaToolResultBlockParam,
-  PromptCachingBetaToolUseBlockParam,
-  PromptCachingBetaUsage,
-  RawPromptCachingBetaMessageStartEvent,
-  RawPromptCachingBetaMessageStreamEvent,
-  MessageCreateParams,
-  MessageCreateParamsNonStreaming,
-  MessageCreateParamsStreaming,
   Messages,
+  type PromptCachingBetaCacheControlEphemeral,
+  type PromptCachingBetaImageBlockParam,
+  type PromptCachingBetaMessage,
+  type PromptCachingBetaMessageParam,
+  type PromptCachingBetaTextBlockParam,
+  type PromptCachingBetaTool,
+  type PromptCachingBetaToolResultBlockParam,
+  type PromptCachingBetaToolUseBlockParam,
+  type PromptCachingBetaUsage,
+  type RawPromptCachingBetaMessageStartEvent,
+  type RawPromptCachingBetaMessageStreamEvent,
+  type MessageCreateParams,
+  type MessageCreateParamsNonStreaming,
+  type MessageCreateParamsStreaming,
 } from "./messages.js";
+export { PromptCaching } from "./prompt-caching.js";

package/src/resources/beta/prompt-caching/messages.ts

@@ -213,6 +213,11 @@ export interface PromptCachingBetaTool {
    */
   input_schema: PromptCachingBetaTool.InputSchema;
 
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in tool_use blocks.
+   */
   name: string;
 
   cache_control?: PromptCachingBetaCacheControlEphemeral | null;
@@ -617,19 +622,21 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
   stream: true;
 }
 
-export namespace Messages {
-  export import PromptCachingBetaCacheControlEphemeral = PromptCachingMessagesAPI.PromptCachingBetaCacheControlEphemeral;
-  export import PromptCachingBetaImageBlockParam = PromptCachingMessagesAPI.PromptCachingBetaImageBlockParam;
-  export import PromptCachingBetaMessage = PromptCachingMessagesAPI.PromptCachingBetaMessage;
-  export import PromptCachingBetaMessageParam = PromptCachingMessagesAPI.PromptCachingBetaMessageParam;
-  export import PromptCachingBetaTextBlockParam = PromptCachingMessagesAPI.PromptCachingBetaTextBlockParam;
-  export import PromptCachingBetaTool = PromptCachingMessagesAPI.PromptCachingBetaTool;
-  export import PromptCachingBetaToolResultBlockParam = PromptCachingMessagesAPI.PromptCachingBetaToolResultBlockParam;
-  export import PromptCachingBetaToolUseBlockParam = PromptCachingMessagesAPI.PromptCachingBetaToolUseBlockParam;
-  export import PromptCachingBetaUsage = PromptCachingMessagesAPI.PromptCachingBetaUsage;
-  export import RawPromptCachingBetaMessageStartEvent = PromptCachingMessagesAPI.RawPromptCachingBetaMessageStartEvent;
-  export import RawPromptCachingBetaMessageStreamEvent = PromptCachingMessagesAPI.RawPromptCachingBetaMessageStreamEvent;
-  export import MessageCreateParams = PromptCachingMessagesAPI.MessageCreateParams;
-  export import MessageCreateParamsNonStreaming = PromptCachingMessagesAPI.MessageCreateParamsNonStreaming;
-  export import MessageCreateParamsStreaming = PromptCachingMessagesAPI.MessageCreateParamsStreaming;
+export declare namespace Messages {
+  export {
+    type PromptCachingBetaCacheControlEphemeral as PromptCachingBetaCacheControlEphemeral,
+    type PromptCachingBetaImageBlockParam as PromptCachingBetaImageBlockParam,
+    type PromptCachingBetaMessage as PromptCachingBetaMessage,
+    type PromptCachingBetaMessageParam as PromptCachingBetaMessageParam,
+    type PromptCachingBetaTextBlockParam as PromptCachingBetaTextBlockParam,
+    type PromptCachingBetaTool as PromptCachingBetaTool,
+    type PromptCachingBetaToolResultBlockParam as PromptCachingBetaToolResultBlockParam,
+    type PromptCachingBetaToolUseBlockParam as PromptCachingBetaToolUseBlockParam,
+    type PromptCachingBetaUsage as PromptCachingBetaUsage,
+    type RawPromptCachingBetaMessageStartEvent as RawPromptCachingBetaMessageStartEvent,
+    type RawPromptCachingBetaMessageStreamEvent as RawPromptCachingBetaMessageStreamEvent,
+    type MessageCreateParams as MessageCreateParams,
+    type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
+    type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
+  };
 }