@anthropic-ai/sdk 0.36.3 → 0.38.0

package/src/internal/decoders/line.ts

@@ -13,52 +13,58 @@ export class LineDecoder {
   static NEWLINE_CHARS = new Set(['\n', '\r']);
   static NEWLINE_REGEXP = /\r\n|[\n\r]/g;
 
-  buffer: string[];
-  trailingCR: boolean;
+  buffer: Uint8Array;
+  #carriageReturnIndex: number | null;
   textDecoder: any; // TextDecoder found in browsers; not typed to avoid pulling in either "dom" or "node" types.
 
   constructor() {
-    this.buffer = [];
-    this.trailingCR = false;
+    this.buffer = new Uint8Array();
+    this.#carriageReturnIndex = null;
   }
 
   decode(chunk: Bytes): string[] {
-    let text = this.decodeText(chunk);
-
-    if (this.trailingCR) {
-      text = '\r' + text;
-      this.trailingCR = false;
-    }
-    if (text.endsWith('\r')) {
-      this.trailingCR = true;
-      text = text.slice(0, -1);
-    }
-
-    if (!text) {
+    if (chunk == null) {
       return [];
     }
 
-    const trailingNewline = LineDecoder.NEWLINE_CHARS.has(text[text.length - 1] || '');
-    let lines = text.split(LineDecoder.NEWLINE_REGEXP);
+    const binaryChunk =
+      chunk instanceof ArrayBuffer ? new Uint8Array(chunk)
+      : typeof chunk === 'string' ? new TextEncoder().encode(chunk)
+      : chunk;
+
+    let newData = new Uint8Array(this.buffer.length + binaryChunk.length);
+    newData.set(this.buffer);
+    newData.set(binaryChunk, this.buffer.length);
+    this.buffer = newData;
+
+    const lines: string[] = [];
+    let patternIndex;
+    while ((patternIndex = findNewlineIndex(this.buffer, this.#carriageReturnIndex)) != null) {
+      if (patternIndex.carriage && this.#carriageReturnIndex == null) {
+        // skip until we either get a corresponding `\n`, a new `\r` or nothing
+        this.#carriageReturnIndex = patternIndex.index;
+        continue;
+      }
 
-    // if there is a trailing new line then the last entry will be an empty
-    // string which we don't care about
-    if (trailingNewline) {
-      lines.pop();
-    }
+      // we got double \r or \rtext\n
+      if (
+        this.#carriageReturnIndex != null &&
+        (patternIndex.index !== this.#carriageReturnIndex + 1 || patternIndex.carriage)
+      ) {
+        lines.push(this.decodeText(this.buffer.slice(0, this.#carriageReturnIndex - 1)));
+        this.buffer = this.buffer.slice(this.#carriageReturnIndex);
+        this.#carriageReturnIndex = null;
+        continue;
+      }
 
-    if (lines.length === 1 && !trailingNewline) {
-      this.buffer.push(lines[0]!);
-      return [];
-    }
+      const endIndex =
+        this.#carriageReturnIndex !== null ? patternIndex.preceding - 1 : patternIndex.preceding;
 
-    if (this.buffer.length > 0) {
-      lines = [this.buffer.join('') + lines[0], ...lines.slice(1)];
-      this.buffer = [];
-    }
+      const line = this.decodeText(this.buffer.slice(0, endIndex));
+      lines.push(line);
 
-    if (!trailingNewline) {
-      this.buffer = [lines.pop() || ''];
+      this.buffer = this.buffer.slice(patternIndex.index);
+      this.#carriageReturnIndex = null;
     }
 
     return lines;
@@ -102,13 +108,69 @@ export class LineDecoder {
   }
 
   flush(): string[] {
-    if (!this.buffer.length && !this.trailingCR) {
+    if (!this.buffer.length) {
       return [];
     }
+    return this.decode('\n');
+  }
+}
 
-    const lines = [this.buffer.join('')];
-    this.buffer = [];
-    this.trailingCR = false;
-    return lines;
+/**
+ * This function searches the buffer for the end patterns, (\r or \n)
+ * and returns an object with the index preceding the matched newline and the
+ * index after the newline char. `null` is returned if no new line is found.
+ *
+ * ```ts
+ * findNewLineIndex('abc\ndef') -> { preceding: 2, index: 3 }
+ * ```
+ */
+function findNewlineIndex(
+  buffer: Uint8Array,
+  startIndex: number | null,
+): { preceding: number; index: number; carriage: boolean } | null {
+  const newline = 0x0a; // \n
+  const carriage = 0x0d; // \r
+
+  for (let i = startIndex ?? 0; i < buffer.length; i++) {
+    if (buffer[i] === newline) {
+      return { preceding: i, index: i + 1, carriage: false };
+    }
+
+    if (buffer[i] === carriage) {
+      return { preceding: i, index: i + 1, carriage: true };
+    }
   }
+
+  return null;
+}
+
+export function findDoubleNewlineIndex(buffer: Uint8Array): number {
+  // This function searches the buffer for the end patterns (\r\r, \n\n, \r\n\r\n)
+  // and returns the index right after the first occurrence of any pattern,
+  // or -1 if none of the patterns are found.
+  const newline = 0x0a; // \n
+  const carriage = 0x0d; // \r
+
+  for (let i = 0; i < buffer.length - 1; i++) {
+    if (buffer[i] === newline && buffer[i + 1] === newline) {
+      // \n\n
+      return i + 2;
+    }
+    if (buffer[i] === carriage && buffer[i + 1] === carriage) {
+      // \r\r
+      return i + 2;
+    }
+    if (
+      buffer[i] === carriage &&
+      buffer[i + 1] === newline &&
+      i + 3 < buffer.length &&
+      buffer[i + 2] === carriage &&
+      buffer[i + 3] === newline
+    ) {
+      // \r\n\r\n
+      return i + 4;
+    }
+  }
+
+  return -1;
 }

package/src/lib/BetaMessageStream.ts

@@ -21,6 +21,8 @@ export interface MessageStreamEvents {
   text: (textDelta: string, textSnapshot: string) => void;
   citation: (citation: BetaTextCitation, citationsSnapshot: BetaTextCitation[]) => void;
   inputJson: (partialJson: string, jsonSnapshot: unknown) => void;
+  thinking: (thinkingDelta: string, thinkingSnapshot: string) => void;
+  signature: (signature: string) => void;
   message: (message: BetaMessage) => void;
   contentBlock: (content: BetaContentBlock) => void;
   finalMessage: (message: BetaMessage) => void;
@@ -434,6 +436,18 @@ export class BetaMessageStream implements AsyncIterable<BetaMessageStreamEvent>
             }
             break;
           }
+          case 'thinking_delta': {
+            if (content.type === 'thinking') {
+              this._emit('thinking', event.delta.thinking, content.thinking);
+            }
+            break;
+          }
+          case 'signature_delta': {
+            if (content.type === 'thinking') {
+              this._emit('signature', content.signature);
+            }
+            break;
+          }
           default:
             checkNever(event.delta);
         }
@@ -557,6 +571,18 @@ export class BetaMessageStream implements AsyncIterable<BetaMessageStreamEvent>
             }
             break;
           }
+          case 'thinking_delta': {
+            if (snapshotContent?.type === 'thinking') {
+              snapshotContent.thinking += event.delta.thinking;
+            }
+            break;
+          }
+          case 'signature_delta': {
+            if (snapshotContent?.type === 'thinking') {
+              snapshotContent.signature = event.delta.signature;
+            }
+            break;
+          }
           default:
             checkNever(event.delta);
         }

package/src/lib/MessageStream.ts

@@ -21,6 +21,8 @@ export interface MessageStreamEvents {
   text: (textDelta: string, textSnapshot: string) => void;
   citation: (citation: TextCitation, citationsSnapshot: TextCitation[]) => void;
   inputJson: (partialJson: string, jsonSnapshot: unknown) => void;
+  thinking: (thinkingDelta: string, thinkingSnapshot: string) => void;
+  signature: (signature: string) => void;
   message: (message: Message) => void;
   contentBlock: (content: ContentBlock) => void;
   finalMessage: (message: Message) => void;
@@ -434,6 +436,18 @@ export class MessageStream implements AsyncIterable<MessageStreamEvent> {
             }
             break;
           }
+          case 'thinking_delta': {
+            if (content.type === 'thinking') {
+              this._emit('thinking', event.delta.thinking, content.thinking);
+            }
+            break;
+          }
+          case 'signature_delta': {
+            if (content.type === 'thinking') {
+              this._emit('signature', content.signature);
+            }
+            break;
+          }
           default:
             checkNever(event.delta);
         }
@@ -557,6 +571,18 @@ export class MessageStream implements AsyncIterable<MessageStreamEvent> {
             }
             break;
           }
+          case 'thinking_delta': {
+            if (snapshotContent?.type === 'thinking') {
+              snapshotContent.thinking += event.delta.thinking;
+            }
+            break;
+          }
+          case 'signature_delta': {
+            if (snapshotContent?.type === 'thinking') {
+              snapshotContent.signature = event.delta.signature;
+            }
+            break;
+          }
           default:
             checkNever(event.delta);
         }

package/src/pagination.ts

@@ -45,6 +45,14 @@ export class Page<Item> extends AbstractPage<Item> implements PageResponse<Item>
     return this.data ?? [];
   }
 
+  override hasNextPage(): boolean {
+    if (this.has_more === false) {
+      return false;
+    }
+
+    return super.hasNextPage();
+  }
+
   // @deprecated Please use `nextPageInfo()` instead
   nextPageParams(): Partial<PageParams> | null {
     const info = this.nextPageInfo();

package/src/resources/beta/beta.ts

@@ -5,6 +5,7 @@ import * as ModelsAPI from "./models.js";
 import { BetaModelInfo, BetaModelInfosPage, ModelListParams, Models } from "./models.js";
 import * as MessagesAPI from "./messages/messages.js";
 import {
+  BetaBase64ImageSource,
   BetaBase64PDFBlock,
   BetaBase64PDFSource,
   BetaCacheControlEphemeral,
@@ -35,23 +36,37 @@ import {
   BetaRawMessageStartEvent,
   BetaRawMessageStopEvent,
   BetaRawMessageStreamEvent,
+  BetaRedactedThinkingBlock,
+  BetaRedactedThinkingBlockParam,
+  BetaSignatureDelta,
   BetaTextBlock,
   BetaTextBlockParam,
   BetaTextCitation,
   BetaTextCitationParam,
   BetaTextDelta,
+  BetaThinkingBlock,
+  BetaThinkingBlockParam,
+  BetaThinkingConfigDisabled,
+  BetaThinkingConfigEnabled,
+  BetaThinkingConfigParam,
+  BetaThinkingDelta,
   BetaTool,
   BetaToolBash20241022,
+  BetaToolBash20250124,
   BetaToolChoice,
   BetaToolChoiceAny,
   BetaToolChoiceAuto,
   BetaToolChoiceTool,
   BetaToolComputerUse20241022,
+  BetaToolComputerUse20250124,
   BetaToolResultBlockParam,
   BetaToolTextEditor20241022,
+  BetaToolTextEditor20250124,
   BetaToolUnion,
   BetaToolUseBlock,
   BetaToolUseBlockParam,
+  BetaURLImageSource,
+  BetaURLPDFSource,
   BetaUsage,
   MessageCountTokensParams,
   MessageCreateParams,
@@ -70,8 +85,11 @@ export type AnthropicBeta =
   | 'message-batches-2024-09-24'
   | 'prompt-caching-2024-07-31'
   | 'computer-use-2024-10-22'
+  | 'computer-use-2025-01-24'
   | 'pdfs-2024-09-25'
-  | 'token-counting-2024-11-01';
+  | 'token-counting-2024-11-01'
+  | 'token-efficient-tools-2025-02-19'
+  | 'output-128k-2025-02-19';
 
 export interface BetaAPIError {
   message: string;
@@ -173,6 +191,7 @@ export declare namespace Beta {
 
   export {
     Messages as Messages,
+    type BetaBase64ImageSource as BetaBase64ImageSource,
     type BetaBase64PDFBlock as BetaBase64PDFBlock,
     type BetaBase64PDFSource as BetaBase64PDFSource,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
@@ -203,23 +222,37 @@ export declare namespace Beta {
     type BetaRawMessageStartEvent as BetaRawMessageStartEvent,
     type BetaRawMessageStopEvent as BetaRawMessageStopEvent,
     type BetaRawMessageStreamEvent as BetaRawMessageStreamEvent,
+    type BetaRedactedThinkingBlock as BetaRedactedThinkingBlock,
+    type BetaRedactedThinkingBlockParam as BetaRedactedThinkingBlockParam,
+    type BetaSignatureDelta as BetaSignatureDelta,
     type BetaTextBlock as BetaTextBlock,
     type BetaTextBlockParam as BetaTextBlockParam,
     type BetaTextCitation as BetaTextCitation,
     type BetaTextCitationParam as BetaTextCitationParam,
     type BetaTextDelta as BetaTextDelta,
+    type BetaThinkingBlock as BetaThinkingBlock,
+    type BetaThinkingBlockParam as BetaThinkingBlockParam,
+    type BetaThinkingConfigDisabled as BetaThinkingConfigDisabled,
+    type BetaThinkingConfigEnabled as BetaThinkingConfigEnabled,
+    type BetaThinkingConfigParam as BetaThinkingConfigParam,
+    type BetaThinkingDelta as BetaThinkingDelta,
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
+    type BetaToolBash20250124 as BetaToolBash20250124,
     type BetaToolChoice as BetaToolChoice,
     type BetaToolChoiceAny as BetaToolChoiceAny,
     type BetaToolChoiceAuto as BetaToolChoiceAuto,
     type BetaToolChoiceTool as BetaToolChoiceTool,
     type BetaToolComputerUse20241022 as BetaToolComputerUse20241022,
+    type BetaToolComputerUse20250124 as BetaToolComputerUse20250124,
     type BetaToolResultBlockParam as BetaToolResultBlockParam,
     type BetaToolTextEditor20241022 as BetaToolTextEditor20241022,
+    type BetaToolTextEditor20250124 as BetaToolTextEditor20250124,
     type BetaToolUnion as BetaToolUnion,
     type BetaToolUseBlock as BetaToolUseBlock,
     type BetaToolUseBlockParam as BetaToolUseBlockParam,
+    type BetaURLImageSource as BetaURLImageSource,
+    type BetaURLPDFSource as BetaURLPDFSource,
     type BetaUsage as BetaUsage,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,

package/src/resources/beta/index.ts

@@ -18,6 +18,7 @@ export {
 export { BetaModelInfosPage, Models, type BetaModelInfo, type ModelListParams } from "./models.js";
 export {
   Messages,
+  type BetaBase64ImageSource,
   type BetaBase64PDFBlock,
   type BetaBase64PDFSource,
   type BetaCacheControlEphemeral,
@@ -48,23 +49,37 @@ export {
   type BetaRawMessageStartEvent,
   type BetaRawMessageStopEvent,
   type BetaRawMessageStreamEvent,
+  type BetaRedactedThinkingBlock,
+  type BetaRedactedThinkingBlockParam,
+  type BetaSignatureDelta,
   type BetaTextBlock,
   type BetaTextBlockParam,
   type BetaTextCitation,
   type BetaTextCitationParam,
   type BetaTextDelta,
+  type BetaThinkingBlock,
+  type BetaThinkingBlockParam,
+  type BetaThinkingConfigDisabled,
+  type BetaThinkingConfigEnabled,
+  type BetaThinkingConfigParam,
+  type BetaThinkingDelta,
   type BetaTool,
   type BetaToolBash20241022,
+  type BetaToolBash20250124,
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,
   type BetaToolChoiceTool,
   type BetaToolComputerUse20241022,
+  type BetaToolComputerUse20250124,
   type BetaToolResultBlockParam,
   type BetaToolTextEditor20241022,
+  type BetaToolTextEditor20250124,
   type BetaToolUnion,
   type BetaToolUseBlock,
   type BetaToolUseBlockParam,
+  type BetaURLImageSource,
+  type BetaURLPDFSource,
   type BetaUsage,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,

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

@@ -16,6 +16,9 @@ export class Batches extends APIResource {
    * 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.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   create(params: BatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<BetaMessageBatch> {
     const { betas, ...body } = params;
@@ -33,6 +36,9 @@ export class Batches extends APIResource {
    * 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.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   retrieve(
     messageBatchId: string,
@@ -61,6 +67,9 @@ export class Batches extends APIResource {
   /**
    * List all Message Batches within a Workspace. Most recently created batches are
    * returned first.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   list(
     params?: BatchListParams,
@@ -90,6 +99,9 @@ export class Batches extends APIResource {
    *
    * 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.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   delete(
     messageBatchId: string,
@@ -125,6 +137,9 @@ export class Batches extends APIResource {
    * 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.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   cancel(
     messageBatchId: string,
@@ -156,6 +171,9 @@ export class Batches extends APIResource {
    * 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.
+   *
+   * Learn more about the Message Batches API in our
+   * [user guide](/en/docs/build-with-claude/batch-processing)
    */
   async results(
     messageBatchId: string,

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

@@ -21,6 +21,7 @@ export {
 } from "./batches.js";
 export {
   Messages,
+  type BetaBase64ImageSource,
   type BetaBase64PDFBlock,
   type BetaBase64PDFSource,
   type BetaCacheControlEphemeral,
@@ -51,23 +52,37 @@ export {
   type BetaRawMessageStartEvent,
   type BetaRawMessageStopEvent,
   type BetaRawMessageStreamEvent,
+  type BetaRedactedThinkingBlock,
+  type BetaRedactedThinkingBlockParam,
+  type BetaSignatureDelta,
   type BetaTextBlock,
   type BetaTextBlockParam,
   type BetaTextCitation,
   type BetaTextCitationParam,
   type BetaTextDelta,
+  type BetaThinkingBlock,
+  type BetaThinkingBlockParam,
+  type BetaThinkingConfigDisabled,
+  type BetaThinkingConfigEnabled,
+  type BetaThinkingConfigParam,
+  type BetaThinkingDelta,
   type BetaTool,
   type BetaToolBash20241022,
+  type BetaToolBash20250124,
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,
   type BetaToolChoiceTool,
   type BetaToolComputerUse20241022,
+  type BetaToolComputerUse20250124,
   type BetaToolResultBlockParam,
   type BetaToolTextEditor20241022,
+  type BetaToolTextEditor20250124,
   type BetaToolUnion,
   type BetaToolUseBlock,
   type BetaToolUseBlockParam,
+  type BetaURLImageSource,
+  type BetaURLPDFSource,
   type BetaUsage,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,