@anthropic-ai/sdk 0.67.1 → 0.69.0

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

@@ -1,9 +1,26 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { Anthropic } from '../../../client';
+import { APIPromise } from '../../../core/api-promise';
 import { APIResource } from '../../../core/resource';
-import * as MessagesMessagesAPI from './messages';
-import * as BetaAPI from '../beta';
+import { Stream } from '../../../core/streaming';
+import { MODEL_NONSTREAMING_TOKENS } from '../../../internal/constants';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import {
+  parseBetaMessage,
+  type ExtractParsedContentFromBetaParams,
+  type ParsedBetaMessage,
+} from '../../../lib/beta-parser';
+import { BetaMessageStream } from '../../../lib/BetaMessageStream';
+import {
+  BetaToolRunner,
+  BetaToolRunnerParams,
+  BetaToolRunnerRequestOptions,
+} from '../../../lib/tools/BetaToolRunner';
+import type { Model } from '../../messages/messages';
 import * as MessagesAPI from '../../messages/messages';
+import * as BetaAPI from '../beta';
 import * as BatchesAPI from './batches';
 import {
   BatchCancelParams,
@@ -24,19 +41,7 @@ import {
   BetaMessageBatchSucceededResult,
   BetaMessageBatchesPage,
 } from './batches';
-import { APIPromise } from '../../../core/api-promise';
-import { Stream } from '../../../core/streaming';
-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,
-  BetaToolRunnerRequestOptions,
-} from '../../../lib/tools/BetaToolRunner';
-import { Anthropic } from '../../../client';
+import * as MessagesMessagesAPI from './messages';
 
 const DEPRECATED_MODELS: {
   [K in Model]?: string;
@@ -64,7 +69,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)
+   * Learn more about the Messages API in our
+   * [user guide](https://docs.claude.com/en/docs/initial-setup)
    *
    * @example
    * ```ts
@@ -115,10 +121,46 @@ export class Messages extends APIResource {
     }) as APIPromise<BetaMessage> | APIPromise<Stream<BetaRawMessageStreamEvent>>;
   }
 
+  /**
+   * Send a structured list of input messages with text and/or image content, along with an expected `output_format` and
+   * the response will be automatically parsed and available in the `parsed` property of the message.
+   *
+   * @example
+   * ```ts
+   * const message = await client.beta.messages.parse({
+   *   model: 'claude-3-5-sonnet-20241022',
+   *   max_tokens: 1024,
+   *   messages: [{ role: 'user', content: 'What is 2+2?' }],
+   *   output_format: zodOutputFormat(z.object({ answer: z.number() }), 'math'),
+   * });
+   *
+   * console.log(message.parsed?.answer); // 4
+   * ```
+   */
+  parse<Params extends MessageCreateParamsNonStreaming>(
+    params: Params,
+    options?: RequestOptions,
+  ): APIPromise<ParsedBetaMessage<ExtractParsedContentFromBetaParams<Params>>> {
+    options = {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(params.betas ?? []), 'structured-outputs-2025-09-17'].toString() },
+        options?.headers,
+      ]),
+    };
+
+    return this.create(params, options).then((message) => parseBetaMessage(message, params)) as APIPromise<
+      ParsedBetaMessage<ExtractParsedContentFromBetaParams<Params>>
+    >;
+  }
+
   /**
    * Create a Message stream
    */
-  stream(body: BetaMessageStreamParams, options?: RequestOptions): BetaMessageStream {
+  stream<Params extends BetaMessageStreamParams>(
+    body: Params,
+    options?: RequestOptions,
+  ): BetaMessageStream<ExtractParsedContentFromBetaParams<Params>> {
     return BetaMessageStream.createMessage(this, body, options);
   }
 
@@ -129,7 +171,7 @@ export class Messages extends APIResource {
    * including tools, images, and documents, without creating it.
    *
    * Learn more about token counting in our
-   * [user guide](/en/docs/build-with-claude/token-counting)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
    *
    * @example
    * ```ts
@@ -169,6 +211,10 @@ export class Messages extends APIResource {
   }
 }
 
+export interface BetaAllThinkingTurns {
+  type: 'all';
+}
+
 export type BetaMessageStreamParams = MessageCreateParamsBase;
 
 export interface BetaBase64ImageSource {
@@ -459,6 +505,33 @@ export interface BetaCitationsWebSearchResultLocation {
   url: string;
 }
 
+export interface BetaClearThinking20251015Edit {
+  type: 'clear_thinking_20251015';
+
+  /**
+   * Number of most recent assistant turns to keep thinking blocks for. Older turns
+   * will have their thinking blocks removed.
+   */
+  keep?: BetaThinkingTurns | BetaAllThinkingTurns | 'all';
+}
+
+export interface BetaClearThinking20251015EditResponse {
+  /**
+   * Number of input tokens cleared by this edit.
+   */
+  cleared_input_tokens: number;
+
+  /**
+   * Number of thinking turns that were cleared.
+   */
+  cleared_thinking_turns: number;
+
+  /**
+   * The type of context management edit applied.
+   */
+  type: 'clear_thinking_20251015';
+}
+
 export interface BetaClearToolUses20250919Edit {
   type: 'clear_tool_uses_20250919';
 
@@ -556,6 +629,8 @@ export interface BetaCodeExecutionTool20250522 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export interface BetaCodeExecutionTool20250825 {
@@ -572,6 +647,8 @@ export interface BetaCodeExecutionTool20250825 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export interface BetaCodeExecutionToolResultBlock {
@@ -733,14 +810,14 @@ export interface BetaContextManagementConfig {
   /**
    * List of context management edits to apply
    */
-  edits?: Array<BetaClearToolUses20250919Edit>;
+  edits?: Array<BetaClearToolUses20250919Edit | BetaClearThinking20251015Edit>;
 }
 
 export interface BetaContextManagementResponse {
   /**
    * List of context management edits that were applied.
    */
-  applied_edits: Array<BetaClearToolUses20250919EditResponse>;
+  applied_edits: Array<BetaClearToolUses20250919EditResponse | BetaClearThinking20251015EditResponse>;
 }
 
 export interface BetaCountTokensContextManagementResponse {
@@ -807,6 +884,15 @@ export interface BetaInputTokensTrigger {
   value: number;
 }
 
+export interface BetaJSONOutputFormat {
+  /**
+   * The JSON schema of the format
+   */
+  schema: { [key: string]: unknown };
+
+  type: 'json_schema';
+}
+
 export interface BetaMCPToolResultBlock {
   content: string | Array<BetaTextBlock>;
 
@@ -869,6 +955,8 @@ export interface BetaMemoryTool20250818 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export type BetaMemoryTool20250818Command =
@@ -1686,6 +1774,12 @@ export interface BetaThinkingDelta {
   type: 'thinking_delta';
 }
 
+export interface BetaThinkingTurns {
+  type: 'thinking_turns';
+
+  value: number;
+}
+
 export interface BetaTool {
   /**
    * [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
@@ -1717,6 +1811,8 @@ export interface BetaTool {
    */
   description?: string;
 
+  strict?: boolean;
+
   type?: 'custom' | null;
 }
 
@@ -1752,6 +1848,8 @@ export interface BetaToolBash20241022 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export interface BetaToolBash20250124 {
@@ -1768,6 +1866,8 @@ export interface BetaToolBash20250124 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 /**
@@ -1862,6 +1962,8 @@ export interface BetaToolComputerUse20241022 {
    * The X11 display number (e.g. 0, 1) for the display.
    */
   display_number?: number | null;
+
+  strict?: boolean;
 }
 
 export interface BetaToolComputerUse20250124 {
@@ -1893,6 +1995,8 @@ export interface BetaToolComputerUse20250124 {
    * The X11 display number (e.g. 0, 1) for the display.
    */
   display_number?: number | null;
+
+  strict?: boolean;
 }
 
 export interface BetaToolResultBlockParam {
@@ -1928,6 +2032,8 @@ export interface BetaToolTextEditor20241022 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export interface BetaToolTextEditor20250124 {
@@ -1944,6 +2050,8 @@ export interface BetaToolTextEditor20250124 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export interface BetaToolTextEditor20250429 {
@@ -1960,6 +2068,8 @@ export interface BetaToolTextEditor20250429 {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  strict?: boolean;
 }
 
 export interface BetaToolTextEditor20250728 {
@@ -1982,6 +2092,8 @@ export interface BetaToolTextEditor20250728 {
    * defaults to displaying the full file.
    */
   max_characters?: number | null;
+
+  strict?: boolean;
 }
 
 export type BetaToolUnion =
@@ -2159,6 +2271,8 @@ export interface BetaWebFetchTool20250910 {
    * Maximum number of times the tool can be used in the API request.
    */
   max_uses?: number | null;
+
+  strict?: boolean;
 }
 
 export interface BetaWebFetchToolResultBlock {
@@ -2260,6 +2374,8 @@ export interface BetaWebSearchTool20250305 {
    */
   max_uses?: number | null;
 
+  strict?: boolean;
+
   /**
    * Parameters for the user's location. Used to provide more relevant search
    * results.
@@ -2465,6 +2581,11 @@ export interface MessageCreateParamsBase {
    */
   metadata?: BetaMetadata;
 
+  /**
+   * Body param: A schema to specify Claude's output format in responses.
+   */
+  output_format?: BetaJSONOutputFormat | null;
+
   /**
    * Body param: Determines whether to use priority capacity (if available) or
    * standard capacity for this request.
@@ -2759,6 +2880,11 @@ export interface MessageCountTokensParams {
    */
   mcp_servers?: Array<BetaRequestMCPServerURLDefinition>;
 
+  /**
+   * Body param: A schema to specify Claude's output format in responses.
+   */
+  output_format?: BetaJSONOutputFormat | null;
+
   /**
    * Body param: System prompt.
    *
@@ -2895,6 +3021,7 @@ Messages.BetaToolRunner = BetaToolRunner;
 
 export declare namespace Messages {
   export {
+    type BetaAllThinkingTurns as BetaAllThinkingTurns,
     type BetaBase64ImageSource as BetaBase64ImageSource,
     type BetaBase64PDFSource as BetaBase64PDFSource,
     type BetaBashCodeExecutionOutputBlock as BetaBashCodeExecutionOutputBlock,
@@ -2920,6 +3047,8 @@ export declare namespace Messages {
     type BetaCitationsConfigParam as BetaCitationsConfigParam,
     type BetaCitationsDelta as BetaCitationsDelta,
     type BetaCitationsWebSearchResultLocation as BetaCitationsWebSearchResultLocation,
+    type BetaClearThinking20251015Edit as BetaClearThinking20251015Edit,
+    type BetaClearThinking20251015EditResponse as BetaClearThinking20251015EditResponse,
     type BetaClearToolUses20250919Edit as BetaClearToolUses20250919Edit,
     type BetaClearToolUses20250919EditResponse as BetaClearToolUses20250919EditResponse,
     type BetaCodeExecutionOutputBlock as BetaCodeExecutionOutputBlock,
@@ -2953,6 +3082,7 @@ export declare namespace Messages {
     type BetaInputJSONDelta as BetaInputJSONDelta,
     type BetaInputTokensClearAtLeast as BetaInputTokensClearAtLeast,
     type BetaInputTokensTrigger as BetaInputTokensTrigger,
+    type BetaJSONOutputFormat as BetaJSONOutputFormat,
     type BetaMCPToolResultBlock as BetaMCPToolResultBlock,
     type BetaMCPToolUseBlock as BetaMCPToolUseBlock,
     type BetaMCPToolUseBlockParam as BetaMCPToolUseBlockParam,
@@ -3013,6 +3143,7 @@ export declare namespace Messages {
     type BetaThinkingConfigEnabled as BetaThinkingConfigEnabled,
     type BetaThinkingConfigParam as BetaThinkingConfigParam,
     type BetaThinkingDelta as BetaThinkingDelta,
+    type BetaThinkingTurns as BetaThinkingTurns,
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
     type BetaToolBash20250124 as BetaToolBash20250124,

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](/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -50,7 +50,7 @@ export class Batches extends APIResource {
    * `results_url` field in the response.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -68,7 +68,7 @@ export class Batches extends APIResource {
    * returned first.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -92,7 +92,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](/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -116,7 +116,7 @@ export class Batches extends APIResource {
    * non-interruptible.
    *
    * Learn more about the Message Batches API in our
-   * [user guide](/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
    *
    * @example
    * ```ts
@@ -137,7 +137,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](/en/docs/build-with-claude/batch-processing)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
    *
    * @example
    * ```ts

package/src/resources/messages/messages.ts

@@ -35,7 +35,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)
+   * Learn more about the Messages API in our
+   * [user guide](https://docs.claude.com/en/docs/initial-setup)
    *
    * @example
    * ```ts
@@ -93,7 +94,7 @@ export class Messages extends APIResource {
    * including tools, images, and documents, without creating it.
    *
    * Learn more about token counting in our
-   * [user guide](/en/docs/build-with-claude/token-counting)
+   * [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
    *
    * @example
    * ```ts

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.67.1'; // x-release-please-version
+export const VERSION = '0.69.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.67.1";
+export declare const VERSION = "0.69.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.67.1'; // x-release-please-version
+exports.VERSION = '0.69.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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