@anthropic-ai/sdk 0.14.1 → 0.15.0

package/resources/messages.d.ts

@@ -9,11 +9,11 @@ export declare class Messages extends APIResource {
     /**
      * Create a Message.
      *
-     * Send a structured list of input messages, and the model will generate the next
-     * message in the conversation.
+     * Send a structured list of input messages with text and/or image content, and the
+     * model will generate the next message in the conversation.
      *
-     * Messages can be used for either single queries to the model or for multi-turn
-     * conversations.
+     * The Messages API can be used for for either single queries or stateless
+     * multi-turn conversations.
      */
     create(body: MessageCreateParamsNonStreaming, options?: Core.RequestOptions): APIPromise<Message>;
     create(body: MessageCreateParamsStreaming, options?: Core.RequestOptions): APIPromise<Stream<MessageStreamEvent>>;
@@ -41,6 +41,17 @@ export interface ContentBlockStopEvent {
     index: number;
     type: 'content_block_stop';
 }
+export interface ImageBlockParam {
+    source: ImageBlockParam.Source;
+    type?: 'image';
+}
+export declare namespace ImageBlockParam {
+    interface Source {
+        data: string;
+        media_type: 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
+        type?: 'base64';
+    }
+}
 export interface Message {
     /**
      * Unique object identifier.
@@ -52,7 +63,7 @@ export interface Message {
      * Content generated by the model.
      *
      * This is an array of content blocks, each of which has a `type` that determines
-     * its shape. Currently, the only `type` available is `"text"`.
+     * its shape. Currently, the only `type` in responses is `"text"`.
      *
      * Example:
      *
@@ -72,10 +83,7 @@ export interface Message {
      *     "role": "user",
      *     "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"
      *   },
-     *   {
-     *     "role": "assistant",
-     *     "content": "The best answer is ("
-     *   }
+     *   { "role": "assistant", "content": "The best answer is (" }
      * ]
      * ```
      *
@@ -113,14 +121,31 @@ export interface Message {
      */
     stop_reason: 'end_turn' | 'max_tokens' | 'stop_sequence' | null;
     /**
-     * Which custom stop sequence was generated.
+     * Which custom stop sequence was generated, if any.
      *
-     * This value will be non-null if one of your custom stop sequences was generated.
+     * This value will be a non-null string if one of your custom stop sequences was
+     * generated.
      */
     stop_sequence: string | null;
+    /**
+     * Object type.
+     *
+     * For Messages, this is always `"message"`.
+     */
     type: 'message';
     /**
-     * Container for the number of tokens used.
+     * Billing and rate-limit usage.
+     *
+     * Anthropic's API bills and rate-limits by token counts, as tokens represent the
+     * underlying cost to our systems.
+     *
+     * Under the hood, the API transforms requests into a format suitable for the
+     * model. The model's output then goes through a parsing stage before becoming an
+     * API response. As a result, the token counts in `usage` will not match one-to-one
+     * with the exact visible content of an API request or response.
+     *
+     * For example, `output_tokens` will be non-zero, even for an empty string response
+     * from Claude.
      */
     usage: Usage;
 }
@@ -128,7 +153,18 @@ export interface MessageDeltaEvent {
     delta: MessageDeltaEvent.Delta;
     type: 'message_delta';
     /**
-     * Container for the number of tokens used.
+     * Billing and rate-limit usage.
+     *
+     * Anthropic's API bills and rate-limits by token counts, as tokens represent the
+     * underlying cost to our systems.
+     *
+     * Under the hood, the API transforms requests into a format suitable for the
+     * model. The model's output then goes through a parsing stage before becoming an
+     * API response. As a result, the token counts in `usage` will not match one-to-one
+     * with the exact visible content of an API request or response.
+     *
+     * For example, `output_tokens` will be non-zero, even for an empty string response
+     * from Claude.
      */
     usage: MessageDeltaUsage;
 }
@@ -145,7 +181,7 @@ export interface MessageDeltaUsage {
     output_tokens: number;
 }
 export interface MessageParam {
-    content: string | Array<TextBlock>;
+    content: string | Array<TextBlock | ImageBlockParam>;
     role: 'user' | 'assistant';
 }
 export interface MessageStartEvent {
@@ -183,8 +219,7 @@ export interface MessageCreateParamsBase {
      * only specifies the absolute maximum number of tokens to generate.
      *
      * Different models have different maximum values for this parameter. See
-     * [input and output sizes](https://docs.anthropic.com/claude/reference/input-and-output-sizes)
-     * for details.
+     * [models](https://docs.anthropic.com/claude/docs/models-overview) for details.
      */
     max_tokens: number;
     /**
@@ -223,15 +258,18 @@ export interface MessageCreateParamsBase {
      *
      * ```json
      * [
-     *   { "role": "user", "content": "Please describe yourself using only JSON" },
-     *   { "role": "assistant", "content": "Here is my JSON description:\n{" }
+     *   {
+     *     "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` is
-     * shorthand for an array of one content block of type `"text"`. The following
-     * input messages are equivalent:
+     * 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" }
@@ -241,26 +279,41 @@ export interface MessageCreateParamsBase {
      * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
      * ```
      *
-     * See our
-     * [guide to prompt design](https://docs.anthropic.com/claude/docs/introduction-to-prompt-design)
-     * for more details on how to best construct prompts.
+     * 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/claude/reference/messages-examples)
+     * for more input examples.
      *
      * Note that if you want to include a
-     * [system prompt](https://docs.anthropic.com/claude/docs/how-to-use-system-prompts),
-     * you can use the top-level `system` parameter — there is no `"system"` role for
-     * input messages in the Messages API.
+     * [system prompt](https://docs.anthropic.com/claude/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<MessageParam>;
     /**
      * The model that will complete your prompt.
      *
-     * As we improve Claude, we develop new versions of it that you can query. The
-     * `model` parameter controls which version of Claude responds to your request.
-     * Right now we offer two model families: Claude, and Claude Instant. You can use
-     * them by setting `model` to `"claude-2.1"` or `"claude-instant-1.2"`,
-     * respectively.
-     *
-     * See [models](https://docs.anthropic.com/claude/reference/selecting-a-model) for
+     * See [models](https://docs.anthropic.com/claude/docs/models-overview) for
      * additional details and options.
      */
     model: string;
@@ -292,14 +345,18 @@ export interface MessageCreateParamsBase {
      *
      * 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/claude/docs/how-to-use-system-prompts).
+     * [guide to system prompts](https://docs.anthropic.com/claude/docs/system-prompts).
      */
     system?: string;
     /**
      * Amount of randomness injected into the response.
      *
-     * Defaults to 1. Ranges from 0 to 1. Use temp closer to 0 for analytical /
-     * multiple choice, and closer to 1 for creative and generative tasks.
+     * Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0`
+     * for analytical / multiple choice, and closer to `1.0` for creative and
+     * generative tasks.
+     *
+     * Note that even with `temperature` of `0.0`, the results will not be fully
+     * deterministic.
      */
     temperature?: number;
     /**
@@ -307,6 +364,9 @@ export interface MessageCreateParamsBase {
      *
      * Used to remove "long tail" low probability responses.
      * [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
      */
     top_k?: number;
     /**
@@ -316,6 +376,9 @@ export interface MessageCreateParamsBase {
      * for each subsequent token in decreasing probability order and cut it off once it
      * reaches a particular probability specified by `top_p`. You should either alter
      * `temperature` or `top_p`, but not both.
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
      */
     top_p?: number;
 }
@@ -362,8 +425,7 @@ export interface MessageStreamParams {
      * only specifies the absolute maximum number of tokens to generate.
      *
      * Different models have different maximum values for this parameter. See
-     * [input and output sizes](https://docs.anthropic.com/claude/reference/input-and-output-sizes)
-     * for details.
+     * [models](https://docs.anthropic.com/claude/docs/models-overview) for details.
      */
     max_tokens: number;
     /**
@@ -402,15 +464,18 @@ export interface MessageStreamParams {
      *
      * ```json
      * [
-     *   { "role": "user", "content": "Please describe yourself using only JSON" },
-     *   { "role": "assistant", "content": "Here is my JSON description:\n{" }
+     *   {
+     *     "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` is
-     * shorthand for an array of one content block of type `"text"`. The following
-     * input messages are equivalent:
+     * 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" }
@@ -420,26 +485,41 @@ export interface MessageStreamParams {
      * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
      * ```
      *
-     * See our
-     * [guide to prompt design](https://docs.anthropic.com/claude/docs/introduction-to-prompt-design)
-     * for more details on how to best construct prompts.
+     * 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/claude/reference/messages-examples)
+     * for more input examples.
      *
      * Note that if you want to include a
-     * [system prompt](https://docs.anthropic.com/claude/docs/how-to-use-system-prompts),
-     * you can use the top-level `system` parameter — there is no `"system"` role for
-     * input messages in the Messages API.
+     * [system prompt](https://docs.anthropic.com/claude/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<MessageParam>;
     /**
      * The model that will complete your prompt.
      *
-     * As we improve Claude, we develop new versions of it that you can query. The
-     * `model` parameter controls which version of Claude responds to your request.
-     * Right now we offer two model families: Claude, and Claude Instant. You can use
-     * them by setting `model` to `"claude-2.1"` or `"claude-instant-1.2"`,
-     * respectively.
-     *
-     * See [models](https://docs.anthropic.com/claude/reference/selecting-a-model) for
+     * See [models](https://docs.anthropic.com/claude/docs/models-overview) for
      * additional details and options.
      */
     model: string;
@@ -464,14 +544,18 @@ export interface MessageStreamParams {
      *
      * 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/claude/docs/how-to-use-system-prompts).
+     * [guide to system prompts](https://docs.anthropic.com/claude/docs/system-prompts).
      */
     system?: string;
     /**
      * Amount of randomness injected into the response.
      *
-     * Defaults to 1. Ranges from 0 to 1. Use temp closer to 0 for analytical /
-     * multiple choice, and closer to 1 for creative and generative tasks.
+     * Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0`
+     * for analytical / multiple choice, and closer to `1.0` for creative and
+     * generative tasks.
+     *
+     * Note that even with `temperature` of `0.0`, the results will not be fully
+     * deterministic.
      */
     temperature?: number;
     /**
@@ -479,6 +563,9 @@ export interface MessageStreamParams {
      *
      * Used to remove "long tail" low probability responses.
      * [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
      */
     top_k?: number;
     /**
@@ -488,6 +575,9 @@ export interface MessageStreamParams {
      * for each subsequent token in decreasing probability order and cut it off once it
      * reaches a particular probability specified by `top_p`. You should either alter
      * `temperature` or `top_p`, but not both.
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
      */
     top_p?: number;
 }
@@ -511,6 +601,7 @@ export declare namespace Messages {
     export import ContentBlockDeltaEvent = MessagesAPI.ContentBlockDeltaEvent;
     export import ContentBlockStartEvent = MessagesAPI.ContentBlockStartEvent;
     export import ContentBlockStopEvent = MessagesAPI.ContentBlockStopEvent;
+    export import ImageBlockParam = MessagesAPI.ImageBlockParam;
     export import Message = MessagesAPI.Message;
     export import MessageDeltaEvent = MessagesAPI.MessageDeltaEvent;
     export import MessageDeltaUsage = MessagesAPI.MessageDeltaUsage;

package/resources/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"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"}

package/resources/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAIrD,yDAAyD;AACzD,uEAAoE;AACpE,qEAAoE;AAA3D,8GAAA,aAAa,OAAA;AAItB,MAAa,QAAS,SAAQ,sBAAW;IAmBvC,MAAM,CACJ,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,OAAO,EAAE,MAAM;YACf,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAiE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAyB,EAAE,OAA6B;QAC7D,OAAO,6BAAa,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AArCD,4BAqCC;AAwiBD,WAAiB,QAAQ;AAmBzB,CAAC,EAnBgB,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAmBxB"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAIrD,yDAAyD;AACzD,uEAAoE;AACpE,qEAAoE;AAA3D,8GAAA,aAAa,OAAA;AAItB,MAAa,QAAS,SAAQ,sBAAW;IAmBvC,MAAM,CACJ,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,OAAO,EAAE,MAAM;YACf,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAiE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAyB,EAAE,OAA6B;QAC7D,OAAO,6BAAa,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AArCD,4BAqCC;AAuoBD,WAAiB,QAAQ;AAoBzB,CAAC,EApBgB,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAoBxB"}

package/resources/messages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"AAAA,qDAAqD;OAI9C,EAAE,WAAW,EAAE,MAAM,4BAA4B;OACjD,EAAE,aAAa,EAAE,MAAM,qCAAqC;OAC5D,EAAE,aAAa,EAAE,MAAM,qCAAqC;AAInE,MAAM,OAAO,QAAS,SAAQ,WAAW;IAmBvC,MAAM,CACJ,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,OAAO,EAAE,MAAM;YACf,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAiE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAyB,EAAE,OAA6B;QAC7D,OAAO,aAAa,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AAwiBD,WAAiB,QAAQ;AAmBzB,CAAC,EAnBgB,QAAQ,KAAR,QAAQ,QAmBxB"}
+{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"AAAA,qDAAqD;OAI9C,EAAE,WAAW,EAAE,MAAM,4BAA4B;OACjD,EAAE,aAAa,EAAE,MAAM,qCAAqC;OAC5D,EAAE,aAAa,EAAE,MAAM,qCAAqC;AAInE,MAAM,OAAO,QAAS,SAAQ,WAAW;IAmBvC,MAAM,CACJ,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;YACvC,IAAI;YACJ,OAAO,EAAE,MAAM;YACf,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAiE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAyB,EAAE,OAA6B;QAC7D,OAAO,aAAa,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AAuoBD,WAAiB,QAAQ;AAoBzB,CAAC,EApBgB,QAAQ,KAAR,QAAQ,QAoBxB"}

package/src/index.ts

@@ -241,6 +241,7 @@ export namespace Anthropic {
   export import ContentBlockDeltaEvent = API.ContentBlockDeltaEvent;
   export import ContentBlockStartEvent = API.ContentBlockStartEvent;
   export import ContentBlockStopEvent = API.ContentBlockStopEvent;
+  export import ImageBlockParam = API.ImageBlockParam;
   export import Message = API.Message;
   export import MessageDeltaEvent = API.MessageDeltaEvent;
   export import MessageDeltaUsage = API.MessageDeltaUsage;

package/src/lib/MessageStream.ts

@@ -468,13 +468,16 @@ export class MessageStream implements AsyncIterable<MessageStreamEvent> {
 
   [Symbol.asyncIterator](): AsyncIterator<MessageStreamEvent> {
     const pushQueue: MessageStreamEvent[] = [];
-    const readQueue: ((chunk: MessageStreamEvent | undefined) => void)[] = [];
+    const readQueue: {
+      resolve: (chunk: MessageStreamEvent | undefined) => void;
+      reject: (error: unknown) => void;
+    }[] = [];
     let done = false;
 
     this.on('streamEvent', (event) => {
       const reader = readQueue.shift();
       if (reader) {
-        reader(event);
+        reader.resolve(event);
       } else {
         pushQueue.push(event);
       }
@@ -483,7 +486,23 @@ export class MessageStream implements AsyncIterable<MessageStreamEvent> {
     this.on('end', () => {
       done = true;
       for (const reader of readQueue) {
-        reader(undefined);
+        reader.resolve(undefined);
+      }
+      readQueue.length = 0;
+    });
+
+    this.on('abort', (err) => {
+      done = true;
+      for (const reader of readQueue) {
+        reader.reject(err);
+      }
+      readQueue.length = 0;
+    });
+
+    this.on('error', (err) => {
+      done = true;
+      for (const reader of readQueue) {
+        reader.reject(err);
       }
       readQueue.length = 0;
     });
@@ -494,9 +513,9 @@ export class MessageStream implements AsyncIterable<MessageStreamEvent> {
           if (done) {
             return { value: undefined, done: true };
           }
-          return new Promise<MessageStreamEvent | undefined>((resolve) => readQueue.push(resolve)).then(
-            (chunk) => (chunk ? { value: chunk, done: false } : { value: undefined, done: true }),
-          );
+          return new Promise<MessageStreamEvent | undefined>((resolve, reject) =>
+            readQueue.push({ resolve, reject }),
+          ).then((chunk) => (chunk ? { value: chunk, done: false } : { value: undefined, done: true }));
         }
         const chunk = pushQueue.shift()!;
         return { value: chunk, done: false };

package/src/resources/completions.ts

@@ -69,6 +69,11 @@ export interface Completion {
    */
   stop_reason: string | null;
 
+  /**
+   * Object type.
+   *
+   * For Text Completions, this is always `"completion"`.
+   */
   type: 'completion';
 }
 
@@ -86,16 +91,10 @@ export interface CompletionCreateParamsBase {
   /**
    * The model that will complete your prompt.
    *
-   * As we improve Claude, we develop new versions of it that you can query. The
-   * `model` parameter controls which version of Claude responds to your request.
-   * Right now we offer two model families: Claude, and Claude Instant. You can use
-   * them by setting `model` to `"claude-2.1"` or `"claude-instant-1.2"`,
-   * respectively.
-   *
-   * See [models](https://docs.anthropic.com/claude/reference/selecting-a-model) for
+   * See [models](https://docs.anthropic.com/claude/docs/models-overview) for
    * additional details and options.
    */
-  model: (string & {}) | 'claude-2.1' | 'claude-instant-1';
+  model: (string & {}) | 'claude-3-opus-20240229' | 'claude-2.1' | 'claude-instant-1';
 
   /**
    * The prompt that you want Claude to complete.
@@ -141,8 +140,12 @@ export interface CompletionCreateParamsBase {
   /**
    * Amount of randomness injected into the response.
    *
-   * Defaults to 1. Ranges from 0 to 1. Use temp closer to 0 for analytical /
-   * multiple choice, and closer to 1 for creative and generative tasks.
+   * Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0`
+   * for analytical / multiple choice, and closer to `1.0` for creative and
+   * generative tasks.
+   *
+   * Note that even with `temperature` of `0.0`, the results will not be fully
+   * deterministic.
    */
   temperature?: number;
 
@@ -151,6 +154,9 @@ export interface CompletionCreateParamsBase {
    *
    * Used to remove "long tail" low probability responses.
    * [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).
+   *
+   * Recommended for advanced use cases only. You usually only need to use
+   * `temperature`.
    */
   top_k?: number;
 
@@ -161,6 +167,9 @@ export interface CompletionCreateParamsBase {
    * for each subsequent token in decreasing probability order and cut it off once it
    * reaches a particular probability specified by `top_p`. You should either alter
    * `temperature` or `top_p`, but not both.
+   *
+   * Recommended for advanced use cases only. You usually only need to use
+   * `temperature`.
    */
   top_p?: number;
 }

package/src/resources/index.ts

@@ -12,6 +12,7 @@ export {
   ContentBlockDeltaEvent,
   ContentBlockStartEvent,
   ContentBlockStopEvent,
+  ImageBlockParam,
   Message,
   MessageDeltaEvent,
   MessageDeltaUsage,