@anthropic-ai/sdk 0.34.0-alpha.0 → 0.36.2

package/src/resources/completions.ts

@@ -1,11 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../resource';
-import * as CompletionsAPI from './completions';
-import * as MessagesAPI from './messages/messages';
-import { APIPromise } from '../api-promise';
-import { Stream } from '../streaming';
-import { RequestOptions } from '../internal/request-options';
+import { APIResource } from "../resource.js";
+import { APIPromise } from "../core.js";
+import * as Core from "../core.js";
+import * as CompletionsAPI from "./completions.js";
+import * as MessagesAPI from "./messages/messages.js";
+import { Stream } from "../streaming.js";
 
 export class Completions extends APIResource {
   /**
@@ -18,15 +18,18 @@ export class Completions extends APIResource {
    * [migration guide](https://docs.anthropic.com/en/api/migrating-from-text-completions-to-messages)
    * for guidance in migrating from Text Completions to Messages.
    */
-  create(body: CompletionCreateParamsNonStreaming, options?: RequestOptions): APIPromise<Completion>;
-  create(body: CompletionCreateParamsStreaming, options?: RequestOptions): APIPromise<Stream<Completion>>;
+  create(body: CompletionCreateParamsNonStreaming, options?: Core.RequestOptions): APIPromise<Completion>;
+  create(
+    body: CompletionCreateParamsStreaming,
+    options?: Core.RequestOptions,
+  ): APIPromise<Stream<Completion>>;
   create(
     body: CompletionCreateParamsBase,
-    options?: RequestOptions,
+    options?: Core.RequestOptions,
   ): APIPromise<Stream<Completion> | Completion>;
   create(
     body: CompletionCreateParams,
-    options?: RequestOptions,
+    options?: Core.RequestOptions,
   ): APIPromise<Completion> | APIPromise<Stream<Completion>> {
     return this._client.post('/v1/complete', {
       body,

package/src/resources/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './shared';
+export * from "./shared.js";
 export {
   Beta,
   type AnthropicBeta,
@@ -15,21 +15,31 @@ export {
   type BetaOverloadedError,
   type BetaPermissionError,
   type BetaRateLimitError,
-} from './beta/beta';
+} from "./beta/beta.js";
 export {
   Completions,
   type Completion,
   type CompletionCreateParams,
   type CompletionCreateParamsNonStreaming,
   type CompletionCreateParamsStreaming,
-} from './completions';
+} from "./completions.js";
 export {
   Messages,
   type Base64PDFSource,
   type CacheControlEphemeral,
+  type CitationCharLocation,
+  type CitationCharLocationParam,
+  type CitationContentBlockLocation,
+  type CitationContentBlockLocationParam,
+  type CitationPageLocation,
+  type CitationPageLocationParam,
+  type CitationsConfigParam,
+  type CitationsDelta,
   type ContentBlock,
   type ContentBlockDeltaEvent,
   type ContentBlockParam,
+  type ContentBlockSource,
+  type ContentBlockSourceContent,
   type ContentBlockStartEvent,
   type ContentBlockStopEvent,
   type DocumentBlockParam,
@@ -47,6 +57,7 @@ export {
   type MessageTokensCount,
   type Metadata,
   type Model,
+  type PlainTextSource,
   type RawContentBlockDeltaEvent,
   type RawContentBlockStartEvent,
   type RawContentBlockStopEvent,
@@ -56,6 +67,8 @@ export {
   type RawMessageStreamEvent,
   type TextBlock,
   type TextBlockParam,
+  type TextCitation,
+  type TextCitationParam,
   type TextDelta,
   type Tool,
   type ToolChoice,
@@ -70,5 +83,5 @@ export {
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,
   type MessageCountTokensParams,
-} from './messages/messages';
-export { Models, type ModelInfo, type ModelListParams, type ModelInfosPage } from './models';
+} from "./messages/messages.js";
+export { ModelInfosPage, Models, type ModelInfo, type ModelListParams } from "./models.js";

package/src/resources/messages/batches.ts

@@ -1,13 +1,13 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as Shared from '../shared';
-import * as MessagesAPI from './messages';
-import { APIPromise } from '../../api-promise';
-import { Page, type PageParams, PagePromise } from '../../pagination';
-import { RequestOptions } from '../../internal/request-options';
-import { JSONLDecoder } from '../../internal/decoders/jsonl';
-import { AnthropicError } from '../../error';
+import { APIResource } from "../../resource.js";
+import { isRequestOptions } from "../../core.js";
+import * as Core from "../../core.js";
+import * as Shared from "../shared.js";
+import * as MessagesAPI from "./messages.js";
+import { Page, type PageParams } from "../../pagination.js";
+import { JSONLDecoder } from "../../internal/decoders/jsonl.js";
+import { AnthropicError } from "../../error.js";
 
 export class Batches extends APIResource {
   /**
@@ -17,7 +17,7 @@ export class Batches extends APIResource {
    * once. Once a Message Batch is created, it begins processing immediately. Batches
    * can take up to 24 hours to complete.
    */
-  create(body: BatchCreateParams, options?: RequestOptions): APIPromise<MessageBatch> {
+  create(body: BatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
     return this._client.post('/v1/messages/batches', { body, ...options });
   }
 
@@ -26,8 +26,8 @@ export class Batches extends APIResource {
    * completion. To access the results of a Message Batch, make a request to the
    * `results_url` field in the response.
    */
-  retrieve(messageBatchID: string, options?: RequestOptions): APIPromise<MessageBatch> {
-    return this._client.get(`/v1/messages/batches/${messageBatchID}`, options);
+  retrieve(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
+    return this._client.get(`/v1/messages/batches/${messageBatchId}`, options);
   }
 
   /**
@@ -35,19 +35,28 @@ export class Batches extends APIResource {
    * returned first.
    */
   list(
-    query: BatchListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<MessageBatchesPage, MessageBatch> {
-    return this._client.getAPIList('/v1/messages/batches', Page<MessageBatch>, { query, ...options });
+    query?: BatchListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<MessageBatchesPage, MessageBatch>;
+  list(options?: Core.RequestOptions): Core.PagePromise<MessageBatchesPage, MessageBatch>;
+  list(
+    query: BatchListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<MessageBatchesPage, MessageBatch> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.getAPIList('/v1/messages/batches', MessageBatchesPage, { query, ...options });
   }
 
   /**
-   * 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.
+   * Delete a Message Batch.
+   *
+   * 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.
    */
-  delete(messageBatchID: string, options?: RequestOptions): APIPromise<DeletedMessageBatch> {
-    return this._client.delete(`/v1/messages/batches/${messageBatchID}`, options);
+  delete(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<DeletedMessageBatch> {
+    return this._client.delete(`/v1/messages/batches/${messageBatchId}`, options);
   }
 
   /**
@@ -61,8 +70,8 @@ export class Batches extends APIResource {
    * Note that cancellation may not result in any canceled requests if they were
    * non-interruptible.
    */
-  cancel(messageBatchID: string, options?: RequestOptions): APIPromise<MessageBatch> {
-    return this._client.post(`/v1/messages/batches/${messageBatchID}/cancel`, options);
+  cancel(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
+    return this._client.post(`/v1/messages/batches/${messageBatchId}/cancel`, options);
   }
 
   /**
@@ -73,10 +82,10 @@ export class Batches extends APIResource {
    * requests. Use the `custom_id` field to match results to requests.
    */
   async results(
-    messageBatchID: string,
-    options?: RequestOptions,
+    messageBatchId: string,
+    options?: Core.RequestOptions,
   ): Promise<JSONLDecoder<MessageBatchIndividualResponse>> {
-    const batch = await this.retrieve(messageBatchID);
+    const batch = await this.retrieve(messageBatchId);
     if (!batch.results_url) {
       throw new AnthropicError(
         `No batch \`results_url\`; Has it finished processing? ${batch.processing_status} - ${batch.id}`,
@@ -84,12 +93,19 @@ export class Batches extends APIResource {
     }
 
     return this._client
-      .get(batch.results_url, { ...options, __binaryResponse: true })
+      .get(batch.results_url, {
+        ...options,
+        headers: {
+          Accept: 'application/binary',
+          ...options?.headers,
+        },
+        __binaryResponse: true,
+      })
       ._thenUnwrap((_, props) => JSONLDecoder.fromResponse(props.response, props.controller));
   }
 }
 
-export type MessageBatchesPage = Page<MessageBatch>;
+export class MessageBatchesPage extends Page<MessageBatch> {}
 
 export interface DeletedMessageBatch {
   /**
@@ -294,6 +310,8 @@ export namespace BatchCreateParams {
 
 export interface BatchListParams extends PageParams {}
 
+Batches.MessageBatchesPage = MessageBatchesPage;
+
 export declare namespace Batches {
   export {
     type DeletedMessageBatch as DeletedMessageBatch,
@@ -305,7 +323,7 @@ export declare namespace Batches {
     type MessageBatchRequestCounts as MessageBatchRequestCounts,
     type MessageBatchResult as MessageBatchResult,
     type MessageBatchSucceededResult as MessageBatchSucceededResult,
-    type MessageBatchesPage as MessageBatchesPage,
+    MessageBatchesPage as MessageBatchesPage,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
   };

package/src/resources/messages/index.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
+  MessageBatchesPage,
   Batches,
   type DeletedMessageBatch,
   type MessageBatch,
@@ -13,15 +14,24 @@ export {
   type MessageBatchSucceededResult,
   type BatchCreateParams,
   type BatchListParams,
-  type MessageBatchesPage,
-} from './batches';
+} from "./batches.js";
 export {
   Messages,
   type Base64PDFSource,
   type CacheControlEphemeral,
+  type CitationCharLocation,
+  type CitationCharLocationParam,
+  type CitationContentBlockLocation,
+  type CitationContentBlockLocationParam,
+  type CitationPageLocation,
+  type CitationPageLocationParam,
+  type CitationsConfigParam,
+  type CitationsDelta,
   type ContentBlock,
   type ContentBlockDeltaEvent,
   type ContentBlockParam,
+  type ContentBlockSource,
+  type ContentBlockSourceContent,
   type ContentBlockStartEvent,
   type ContentBlockStopEvent,
   type DocumentBlockParam,
@@ -37,6 +47,7 @@ export {
   type MessageTokensCount,
   type Metadata,
   type Model,
+  type PlainTextSource,
   type RawContentBlockDeltaEvent,
   type RawContentBlockStartEvent,
   type RawContentBlockStopEvent,
@@ -46,6 +57,8 @@ export {
   type RawMessageStreamEvent,
   type TextBlock,
   type TextBlockParam,
+  type TextCitation,
+  type TextCitationParam,
   type TextDelta,
   type Tool,
   type ToolChoice,
@@ -61,4 +74,4 @@ export {
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,
   type MessageCountTokensParams,
-} from './messages';
+} from "./messages.js";

package/src/resources/messages/messages.ts

@@ -1,8 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as MessagesAPI from './messages';
-import * as BatchesAPI from './batches';
+import { APIResource } from "../../resource.js";
+import { APIPromise } from "../../core.js";
+import * as Core from "../../core.js";
+import * as MessagesAPI from "./messages.js";
+import * as BatchesAPI from "./batches.js";
 import {
   BatchCreateParams,
   BatchListParams,
@@ -17,13 +19,11 @@ import {
   MessageBatchResult,
   MessageBatchSucceededResult,
   MessageBatchesPage,
-} from './batches';
-import { APIPromise } from '../../api-promise';
-import { Stream } from '../../streaming';
-import { RequestOptions } from '../../internal/request-options';
-import { MessageStream } from '../../lib/MessageStream';
+} from "./batches.js";
+import { Stream } from "../../streaming.js";
+import { MessageStream } from "../../lib/MessageStream.js";
 
-export { MessageStream } from '../../lib/MessageStream';
+export { MessageStream } from "../../lib/MessageStream.js";
 
 export class Messages extends APIResource {
   batches: BatchesAPI.Batches = new BatchesAPI.Batches(this._client);
@@ -35,18 +35,18 @@ export class Messages extends APIResource {
    * The Messages API can be used for either single queries or stateless multi-turn
    * conversations.
    */
-  create(body: MessageCreateParamsNonStreaming, options?: RequestOptions): APIPromise<Message>;
+  create(body: MessageCreateParamsNonStreaming, options?: Core.RequestOptions): APIPromise<Message>;
   create(
     body: MessageCreateParamsStreaming,
-    options?: RequestOptions,
+    options?: Core.RequestOptions,
   ): APIPromise<Stream<RawMessageStreamEvent>>;
   create(
     body: MessageCreateParamsBase,
-    options?: RequestOptions,
+    options?: Core.RequestOptions,
   ): APIPromise<Stream<RawMessageStreamEvent> | Message>;
   create(
     body: MessageCreateParams,
-    options?: RequestOptions,
+    options?: Core.RequestOptions,
   ): APIPromise<Message> | APIPromise<Stream<RawMessageStreamEvent>> {
     if (body.model in DEPRECATED_MODELS) {
       console.warn(
@@ -66,7 +66,7 @@ export class Messages extends APIResource {
   /**
    * Create a Message stream
    */
-  stream(body: MessageStreamParams, options?: RequestOptions): MessageStream {
+  stream(body: MessageStreamParams, options?: Core.RequestOptions): MessageStream {
     return MessageStream.createMessage(this, body, options);
   }
 
@@ -76,7 +76,10 @@ 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.
    */
-  countTokens(body: MessageCountTokensParams, options?: RequestOptions): APIPromise<MessageTokensCount> {
+  countTokens(
+    body: MessageCountTokensParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MessageTokensCount> {
     return this._client.post('/v1/messages/count_tokens', { body, ...options });
   }
 }
@@ -93,6 +96,100 @@ export interface CacheControlEphemeral {
   type: 'ephemeral';
 }
 
+export interface CitationCharLocation {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_char_index: number;
+
+  start_char_index: number;
+
+  type: 'char_location';
+}
+
+export interface CitationCharLocationParam {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_char_index: number;
+
+  start_char_index: number;
+
+  type: 'char_location';
+}
+
+export interface CitationContentBlockLocation {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_block_index: number;
+
+  start_block_index: number;
+
+  type: 'content_block_location';
+}
+
+export interface CitationContentBlockLocationParam {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_block_index: number;
+
+  start_block_index: number;
+
+  type: 'content_block_location';
+}
+
+export interface CitationPageLocation {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_page_number: number;
+
+  start_page_number: number;
+
+  type: 'page_location';
+}
+
+export interface CitationPageLocationParam {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_page_number: number;
+
+  start_page_number: number;
+
+  type: 'page_location';
+}
+
+export interface CitationsConfigParam {
+  enabled?: boolean;
+}
+
+export interface CitationsDelta {
+  citation: CitationCharLocation | CitationPageLocation | CitationContentBlockLocation;
+
+  type: 'citations_delta';
+}
+
 export type ContentBlock = TextBlock | ToolUseBlock;
 
 export type ContentBlockDeltaEvent = RawContentBlockDeltaEvent;
@@ -104,16 +201,30 @@ export type ContentBlockParam =
   | ToolResultBlockParam
   | DocumentBlockParam;
 
+export interface ContentBlockSource {
+  content: string | Array<ContentBlockSourceContent>;
+
+  type: 'content';
+}
+
+export type ContentBlockSourceContent = TextBlockParam | ImageBlockParam;
+
 export type ContentBlockStartEvent = RawContentBlockStartEvent;
 
 export type ContentBlockStopEvent = RawContentBlockStopEvent;
 
 export interface DocumentBlockParam {
-  source: Base64PDFSource;
+  source: Base64PDFSource | PlainTextSource | ContentBlockSource;
 
   type: 'document';
 
   cache_control?: CacheControlEphemeral | null;
+
+  citations?: CitationsConfigParam;
+
+  context?: string | null;
+
+  title?: string | null;
 }
 
 export interface ImageBlockParam {
@@ -306,20 +417,29 @@ export type Model =
   | 'claude-2.1'
   | 'claude-2.0';
 
-type DeprecatedModelsType = {
+const DEPRECATED_MODELS: {
   [K in Model]?: string;
-};
-
-const DEPRECATED_MODELS: DeprecatedModelsType = {
+} = {
   'claude-1.3': 'November 6th, 2024',
   'claude-1.3-100k': 'November 6th, 2024',
   'claude-instant-1.1': 'November 6th, 2024',
   'claude-instant-1.1-100k': 'November 6th, 2024',
   'claude-instant-1.2': 'November 6th, 2024',
+  'claude-3-sonnet-20240229': 'July 21st, 2025',
+  'claude-2.1': 'July 21st, 2025',
+  'claude-2.0': 'July 21st, 2025',
 };
 
+export interface PlainTextSource {
+  data: string;
+
+  media_type: 'text/plain';
+
+  type: 'text';
+}
+
 export interface RawContentBlockDeltaEvent {
-  delta: TextDelta | InputJSONDelta;
+  delta: TextDelta | InputJSONDelta | CitationsDelta;
 
   index: number;
 
@@ -389,6 +509,15 @@ export type RawMessageStreamEvent =
   | RawContentBlockStopEvent;
 
 export interface TextBlock {
+  /**
+   * Citations supporting the text block.
+   *
+   * The type of citation returned will depend on the type of document being cited.
+   * Citing a PDF results in `page_location`, plain text results in `char_location`,
+   * and content document results in `content_block_location`.
+   */
+  citations: Array<TextCitation> | null;
+
   text: string;
 
   type: 'text';
@@ -400,8 +529,17 @@ export interface TextBlockParam {
   type: 'text';
 
   cache_control?: CacheControlEphemeral | null;
+
+  citations?: Array<TextCitationParam> | null;
 }
 
+export type TextCitation = CitationCharLocation | CitationPageLocation | CitationContentBlockLocation;
+
+export type TextCitationParam =
+  | CitationCharLocationParam
+  | CitationPageLocationParam
+  | CitationContentBlockLocationParam;
+
 export interface TextDelta {
   text: string;
 
@@ -1059,14 +1197,25 @@ export interface MessageCountTokensParams {
 }
 
 Messages.Batches = Batches;
+Messages.MessageBatchesPage = MessageBatchesPage;
 
 export declare namespace Messages {
   export {
     type Base64PDFSource as Base64PDFSource,
     type CacheControlEphemeral as CacheControlEphemeral,
+    type CitationCharLocation as CitationCharLocation,
+    type CitationCharLocationParam as CitationCharLocationParam,
+    type CitationContentBlockLocation as CitationContentBlockLocation,
+    type CitationContentBlockLocationParam as CitationContentBlockLocationParam,
+    type CitationPageLocation as CitationPageLocation,
+    type CitationPageLocationParam as CitationPageLocationParam,
+    type CitationsConfigParam as CitationsConfigParam,
+    type CitationsDelta as CitationsDelta,
     type ContentBlock as ContentBlock,
     type ContentBlockDeltaEvent as ContentBlockDeltaEvent,
     type ContentBlockParam as ContentBlockParam,
+    type ContentBlockSource as ContentBlockSource,
+    type ContentBlockSourceContent as ContentBlockSourceContent,
     type ContentBlockStartEvent as ContentBlockStartEvent,
     type ContentBlockStopEvent as ContentBlockStopEvent,
     type DocumentBlockParam as DocumentBlockParam,
@@ -1083,6 +1232,7 @@ export declare namespace Messages {
     type MessageTokensCount as MessageTokensCount,
     type Metadata as Metadata,
     type Model as Model,
+    type PlainTextSource as PlainTextSource,
     type RawContentBlockDeltaEvent as RawContentBlockDeltaEvent,
     type RawContentBlockStartEvent as RawContentBlockStartEvent,
     type RawContentBlockStopEvent as RawContentBlockStopEvent,
@@ -1092,6 +1242,8 @@ export declare namespace Messages {
     type RawMessageStreamEvent as RawMessageStreamEvent,
     type TextBlock as TextBlock,
     type TextBlockParam as TextBlockParam,
+    type TextCitation as TextCitation,
+    type TextCitationParam as TextCitationParam,
     type TextDelta as TextDelta,
     type Tool as Tool,
     type ToolChoice as ToolChoice,
@@ -1120,7 +1272,7 @@ export declare namespace Messages {
     type MessageBatchRequestCounts as MessageBatchRequestCounts,
     type MessageBatchResult as MessageBatchResult,
     type MessageBatchSucceededResult as MessageBatchSucceededResult,
-    type MessageBatchesPage as MessageBatchesPage,
+    MessageBatchesPage as MessageBatchesPage,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
   };