@anthropic-ai/sdk 0.32.0 → 0.33.0

package/src/resources/beta/models.ts

@@ -0,0 +1,78 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from "../../resource.js";
+import { isRequestOptions } from "../../core.js";
+import * as Core from "../../core.js";
+import { Page, type PageParams } from "../../pagination.js";
+
+export class Models extends APIResource {
+  /**
+   * Get a specific model.
+   *
+   * The Models API response can be used to determine information about a specific
+   * model or resolve a model alias to a model ID.
+   */
+  retrieve(modelId: string, options?: Core.RequestOptions): Core.APIPromise<BetaModelInfo> {
+    return this._client.get(`/v1/models/${modelId}?beta=true`, options);
+  }
+
+  /**
+   * List available models.
+   *
+   * The Models API response can be used to determine which models are available for
+   * use in the API. More recently released models are listed first.
+   */
+  list(
+    query?: ModelListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<BetaModelInfosPage, BetaModelInfo>;
+  list(options?: Core.RequestOptions): Core.PagePromise<BetaModelInfosPage, BetaModelInfo>;
+  list(
+    query: ModelListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<BetaModelInfosPage, BetaModelInfo> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.getAPIList('/v1/models?beta=true', BetaModelInfosPage, { query, ...options });
+  }
+}
+
+export class BetaModelInfosPage extends Page<BetaModelInfo> {}
+
+export interface BetaModelInfo {
+  /**
+   * Unique model identifier.
+   */
+  id: string;
+
+  /**
+   * RFC 3339 datetime string representing the time at which the model was released.
+   * May be set to an epoch value if the release date is unknown.
+   */
+  created_at: string;
+
+  /**
+   * A human-readable name for the model.
+   */
+  display_name: string;
+
+  /**
+   * Object type.
+   *
+   * For Models, this is always `"model"`.
+   */
+  type: 'model';
+}
+
+export interface ModelListParams extends PageParams {}
+
+Models.BetaModelInfosPage = BetaModelInfosPage;
+
+export declare namespace Models {
+  export {
+    type BetaModelInfo as BetaModelInfo,
+    BetaModelInfosPage as BetaModelInfosPage,
+    type ModelListParams as ModelListParams,
+  };
+}

package/src/resources/completions.ts

@@ -4,7 +4,7 @@ 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.js";
+import * as MessagesAPI from "./messages/messages.js";
 import { Stream } from "../streaming.js";
 
 export class Completions extends APIResource {

package/src/resources/index.ts

@@ -1,12 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export * from "./shared.js";
 export {
   Beta,
   type AnthropicBeta,
   type BetaAPIError,
   type BetaAuthenticationError,
+  type BetaBillingError,
   type BetaError,
   type BetaErrorResponse,
+  type BetaGatewayTimeoutError,
   type BetaInvalidRequestError,
   type BetaNotFoundError,
   type BetaOverloadedError,
@@ -22,10 +25,14 @@ export {
 } from "./completions.js";
 export {
   Messages,
+  type Base64PDFSource,
+  type CacheControlEphemeral,
   type ContentBlock,
   type ContentBlockDeltaEvent,
+  type ContentBlockParam,
   type ContentBlockStartEvent,
   type ContentBlockStopEvent,
+  type DocumentBlockParam,
   type ImageBlockParam,
   type InputJsonDelta,
   type InputJSONDelta,
@@ -37,6 +44,7 @@ export {
   type MessageStopEvent,
   type MessageStreamEvent,
   type MessageStreamParams,
+  type MessageTokensCount,
   type Metadata,
   type Model,
   type RawContentBlockDeltaEvent,
@@ -61,4 +69,6 @@ export {
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,
-} from "./messages.js";
+  type MessageCountTokensParams,
+} from "./messages/messages.js";
+export { ModelInfosPage, Models, type ModelInfo, type ModelListParams } from "./models.js";

package/src/resources/messages/batches.ts

@@ -0,0 +1,298 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+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 {
+  /**
+   * Send a batch of Message creation requests.
+   *
+   * 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.
+   */
+  create(body: BatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
+    return this._client.post('/v1/messages/batches', { body, ...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.
+   */
+  retrieve(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
+    return this._client.get(`/v1/messages/batches/${messageBatchId}`, options);
+  }
+
+  /**
+   * List all Message Batches within a Workspace. Most recently created batches are
+   * returned first.
+   */
+  list(
+    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 });
+  }
+
+  /**
+   * Batches may be canceled any time before processing ends. Once cancellation is
+   * initiated, the batch enters a `canceling` state, at which time the system may
+   * complete any in-progress, non-interruptible requests before finalizing
+   * cancellation.
+   *
+   * The number of canceled requests is specified in `request_counts`. To determine
+   * 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.
+   */
+  cancel(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<MessageBatch> {
+    return this._client.post(`/v1/messages/batches/${messageBatchId}/cancel`, options);
+  }
+
+  /**
+   * Streams the results of a Message Batch as a `.jsonl` file.
+   *
+   * 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.
+   */
+  async results(
+    messageBatchId: string,
+    options?: Core.RequestOptions,
+  ): Promise<JSONLDecoder<MessageBatchIndividualResponse>> {
+    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}`,
+      );
+    }
+
+    return this._client
+      .get(batch.results_url, { ...options, __binaryResponse: true })
+      ._thenUnwrap((_, props) => JSONLDecoder.fromResponse(props.response, props.controller));
+  }
+}
+
+export class MessageBatchesPage extends Page<MessageBatch> {}
+
+export interface MessageBatch {
+  /**
+   * Unique object identifier.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * RFC 3339 datetime string representing the time at which the Message Batch was
+   * archived and its results became unavailable.
+   */
+  archived_at: string | null;
+
+  /**
+   * RFC 3339 datetime string representing the time at which cancellation was
+   * initiated for the Message Batch. Specified only if cancellation was initiated.
+   */
+  cancel_initiated_at: string | null;
+
+  /**
+   * RFC 3339 datetime string representing the time at which the Message Batch was
+   * created.
+   */
+  created_at: string;
+
+  /**
+   * RFC 3339 datetime string representing the time at which processing for the
+   * Message Batch ended. Specified only once processing ends.
+   *
+   * Processing ends when every request in a Message Batch has either succeeded,
+   * errored, canceled, or expired.
+   */
+  ended_at: string | null;
+
+  /**
+   * RFC 3339 datetime string representing the time at which the Message Batch will
+   * expire and end processing, which is 24 hours after creation.
+   */
+  expires_at: string;
+
+  /**
+   * Processing status of the Message Batch.
+   */
+  processing_status: 'in_progress' | 'canceling' | 'ended';
+
+  /**
+   * Tallies requests within the Message Batch, categorized by their status.
+   *
+   * Requests start as `processing` and move to one of the other statuses only once
+   * processing of the entire batch ends. The sum of all values always matches the
+   * total number of requests in the batch.
+   */
+  request_counts: MessageBatchRequestCounts;
+
+  /**
+   * URL to a `.jsonl` file containing the results of the Message Batch requests.
+   * Specified only once processing ends.
+   *
+   * Results in the file are not guaranteed to be in the same order as requests. Use
+   * the `custom_id` field to match results to requests.
+   */
+  results_url: string | null;
+
+  /**
+   * Object type.
+   *
+   * For Message Batches, this is always `"message_batch"`.
+   */
+  type: 'message_batch';
+}
+
+export interface MessageBatchCanceledResult {
+  type: 'canceled';
+}
+
+export interface MessageBatchErroredResult {
+  error: Shared.ErrorResponse;
+
+  type: 'errored';
+}
+
+export interface MessageBatchExpiredResult {
+  type: 'expired';
+}
+
+export interface MessageBatchIndividualResponse {
+  /**
+   * Developer-provided ID created for each request in a Message Batch. Useful for
+   * matching results to requests, as results may be given out of request order.
+   *
+   * Must be unique for each request within the Message Batch.
+   */
+  custom_id: string;
+
+  /**
+   * Processing result for this request.
+   *
+   * Contains a Message output if processing was successful, an error response if
+   * processing failed, or the reason why processing was not attempted, such as
+   * cancellation or expiration.
+   */
+  result: MessageBatchResult;
+}
+
+export interface MessageBatchRequestCounts {
+  /**
+   * Number of requests in the Message Batch that have been canceled.
+   *
+   * This is zero until processing of the entire Message Batch has ended.
+   */
+  canceled: number;
+
+  /**
+   * Number of requests in the Message Batch that encountered an error.
+   *
+   * This is zero until processing of the entire Message Batch has ended.
+   */
+  errored: number;
+
+  /**
+   * Number of requests in the Message Batch that have expired.
+   *
+   * This is zero until processing of the entire Message Batch has ended.
+   */
+  expired: number;
+
+  /**
+   * Number of requests in the Message Batch that are processing.
+   */
+  processing: number;
+
+  /**
+   * Number of requests in the Message Batch that have completed successfully.
+   *
+   * This is zero until processing of the entire Message Batch has ended.
+   */
+  succeeded: number;
+}
+
+/**
+ * Processing result for this request.
+ *
+ * Contains a Message output if processing was successful, an error response if
+ * processing failed, or the reason why processing was not attempted, such as
+ * cancellation or expiration.
+ */
+export type MessageBatchResult =
+  | MessageBatchSucceededResult
+  | MessageBatchErroredResult
+  | MessageBatchCanceledResult
+  | MessageBatchExpiredResult;
+
+export interface MessageBatchSucceededResult {
+  message: MessagesAPI.Message;
+
+  type: 'succeeded';
+}
+
+export interface BatchCreateParams {
+  /**
+   * List of requests for prompt completion. Each is an individual request to create
+   * a Message.
+   */
+  requests: Array<BatchCreateParams.Request>;
+}
+
+export namespace BatchCreateParams {
+  export interface Request {
+    /**
+     * Developer-provided ID created for each request in a Message Batch. Useful for
+     * matching results to requests, as results may be given out of request order.
+     *
+     * Must be unique for each request within the Message Batch.
+     */
+    custom_id: string;
+
+    /**
+     * Messages API creation parameters for the individual request.
+     *
+     * See the [Messages API reference](/en/api/messages) for full documentation on
+     * available parameters.
+     */
+    params: MessagesAPI.MessageCreateParamsNonStreaming;
+  }
+}
+
+export interface BatchListParams extends PageParams {}
+
+Batches.MessageBatchesPage = MessageBatchesPage;
+
+export declare namespace Batches {
+  export {
+    type MessageBatch as MessageBatch,
+    type MessageBatchCanceledResult as MessageBatchCanceledResult,
+    type MessageBatchErroredResult as MessageBatchErroredResult,
+    type MessageBatchExpiredResult as MessageBatchExpiredResult,
+    type MessageBatchIndividualResponse as MessageBatchIndividualResponse,
+    type MessageBatchRequestCounts as MessageBatchRequestCounts,
+    type MessageBatchResult as MessageBatchResult,
+    type MessageBatchSucceededResult as MessageBatchSucceededResult,
+    MessageBatchesPage as MessageBatchesPage,
+    type BatchCreateParams as BatchCreateParams,
+    type BatchListParams as BatchListParams,
+  };
+}

package/src/resources/messages/index.ts

@@ -0,0 +1,63 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  MessageBatchesPage,
+  Batches,
+  type MessageBatch,
+  type MessageBatchCanceledResult,
+  type MessageBatchErroredResult,
+  type MessageBatchExpiredResult,
+  type MessageBatchIndividualResponse,
+  type MessageBatchRequestCounts,
+  type MessageBatchResult,
+  type MessageBatchSucceededResult,
+  type BatchCreateParams,
+  type BatchListParams,
+} from "./batches.js";
+export {
+  Messages,
+  type Base64PDFSource,
+  type CacheControlEphemeral,
+  type ContentBlock,
+  type ContentBlockDeltaEvent,
+  type ContentBlockParam,
+  type ContentBlockStartEvent,
+  type ContentBlockStopEvent,
+  type DocumentBlockParam,
+  type ImageBlockParam,
+  type InputJSONDelta,
+  type Message,
+  type MessageDeltaEvent,
+  type MessageDeltaUsage,
+  type MessageParam,
+  type MessageStartEvent,
+  type MessageStopEvent,
+  type MessageStreamEvent,
+  type MessageTokensCount,
+  type Metadata,
+  type Model,
+  type RawContentBlockDeltaEvent,
+  type RawContentBlockStartEvent,
+  type RawContentBlockStopEvent,
+  type RawMessageDeltaEvent,
+  type RawMessageStartEvent,
+  type RawMessageStopEvent,
+  type RawMessageStreamEvent,
+  type TextBlock,
+  type TextBlockParam,
+  type TextDelta,
+  type Tool,
+  type ToolChoice,
+  type ToolChoiceAny,
+  type ToolChoiceAuto,
+  type ToolChoiceTool,
+  type ToolResultBlockParam,
+  type ToolUseBlock,
+  type ToolUseBlockParam,
+  type Usage,
+  type MessageCreateParams,
+  type MessageCreateParamsBase,
+  type MessageCreateParamsNonStreaming,
+  type MessageCreateParamsStreaming,
+  type MessageCountTokensParams,
+} from "./messages.js";