@procedures/llm 0.3.0 → 0.5.0

package/dist/anthropic.d.ts

@@ -2,13 +2,15 @@
  * The Anthropic Messages API over `fetch` (roadmap R46).
  *
  * The procedures send each request with the `fetch` of the module settings, not through
- * `http.request`: the API key goes in a header, and the input of a nested call is visible to the
+ * `http.request`. The API key goes in a header. The input of a nested call is visible to the
  * interceptors and to the traces of the host. The key comes from an environment variable that the
  * module names. An input cannot give a key.
  *
- * A call stops at the earliest of its time limit, the deadline of its capability and the abort of
- * the caller. A stop is an `InvocationError` with the code `TIMEOUT` or `ABORTED`.
+ * A request stops at the earliest of its time limit, the deadline of its capability and the abort
+ * of the caller. A stop is an `InvocationError` with the code `TIMEOUT` or `ABORTED`. A request
+ * that fails with a retryable error gets new tries (`retry.ts`).
  */
+import type { Backoff } from "@mark1russell7/service/backoff";
 import { type ProcedureContext, type ProcedurePath } from "@procedures/client";
 import type { LlmEffort, LlmUsage } from "./types.js";
 /** The variables that the module reads: a name and a value, or undefined for a variable that is not set. */
@@ -23,7 +25,7 @@ export declare const DEFAULT_API_KEY_ENV = "ANTHROPIC_API_KEY";
 export declare const DEFAULT_BASE_URL = "https://api.anthropic.com";
 /** The default of `maxTokens`. */
 export declare const DEFAULT_MAX_TOKENS = 16000;
-/** The default time limit of a call: 10 minutes. */
+/** The default time limit of a request: 10 minutes. */
 export declare const DEFAULT_TIMEOUT_MS = 600000;
 /** The version header of the Messages API. */
 export declare const ANTHROPIC_VERSION = "2023-06-01";
@@ -39,10 +41,14 @@ export interface LlmSettings {
     readonly defaultModel: string;
     /** The default of the `fallback` input. */
     readonly fallback: boolean;
+    /** The default number of new tries after a retryable error. */
+    readonly retries: number;
+    /** The backoff before each new try, when the API does not give `retry-after`. */
+    readonly backoff: Backoff;
 }
 /** The settings of the default module. */
 export declare const DEFAULT_LLM_SETTINGS: LlmSettings;
-/** One content block of a message. The procedures read only the text blocks. */
+/** One content block of a message. The procedures read the text blocks and the `tool_use` blocks. */
 export interface ContentBlock {
     readonly type: string;
     readonly text?: string;
@@ -53,6 +59,19 @@ export interface MessageParam {
     readonly role: "user" | "assistant";
     readonly content: string | readonly ContentBlock[];
 }
+/** A tool definition as the API gets it. */
+export interface ToolParam {
+    readonly name: string;
+    readonly description?: string;
+    readonly input_schema: Record<string, unknown>;
+    readonly strict?: boolean;
+}
+/** The `tool_choice` field as the API gets it. */
+export interface ToolChoiceParam {
+    readonly type: "auto" | "any" | "tool" | "none";
+    readonly name?: string;
+    readonly disable_parallel_tool_use?: boolean;
+}
 /** The request body of the Messages API, as the procedures send it. */
 export interface MessagesRequest {
     model: string;
@@ -68,6 +87,9 @@ export interface MessagesRequest {
         };
     };
     fallbacks?: "default";
+    tools?: ToolParam[];
+    tool_choice?: ToolChoiceParam;
+    stream?: true;
 }
 /** The parts of an answer that the procedures use. */
 export interface MessagesResponse {
@@ -94,9 +116,46 @@ export declare function textOf(content: readonly ContentBlock[]): string;
 export declare function addUsage(a: LlmUsage, b: LlmUsage): LlmUsage;
 /** A usage of zero tokens. */
 export declare const NO_USAGE: LlmUsage;
+/**
+ * This function gives the usage of a `usage` object of the API. A field that the object does not
+ * have keeps its value of `base`: the usage of a `message_delta` event changes only some fields.
+ */
+export declare function usageOf(raw: unknown, base?: LlmUsage): LlmUsage;
+/**
+ * The scope of one request: the key, the signal of the `fetch` and the stop. The signal aborts at
+ * the time limit, at the deadline and at the abort of the caller.
+ */
+export interface RequestScope {
+    readonly key: string;
+    readonly signal: AbortSignal;
+    /** The reason of a stop, or undefined while the request runs. */
+    readonly stopped: () => "timeout" | "caller" | undefined;
+    /** This function gives the error of a stop for an error of the request, or the error unchanged. */
+    readonly translate: (error: unknown) => unknown;
+    /** This function stops the timer and removes the listener of the abort. */
+    readonly close: () => void;
+}
+/**
+ * This function opens the scope of one request. It throws `NO_API_KEY` without a key, `TIMEOUT`
+ * when the deadline passed and `ABORTED` when the caller aborted, before a request goes out.
+ */
+export declare function openScope(settings: LlmSettings, limits: CallLimits): RequestScope;
+/** The message of an error, without the key. */
+export declare function safeMessage(error: unknown, key: string): string;
+/**
+ * This function sends a request to the Messages API in a scope, and gives the answer with a
+ * status from 200 to 299. It throws `CONNECTION` for a failed connection and `API_ERROR` for an
+ * error status.
+ */
+export declare function postMessages(request: MessagesRequest, settings: LlmSettings, scope: RequestScope): Promise<Response>;
 /**
  * This function sends one request to the Messages API and gives the checked answer. It throws a
  * `REFUSAL` error when a safety classifier declined the request.
  */
 export declare function sendMessages(request: MessagesRequest, settings: LlmSettings, limits: CallLimits): Promise<MessagesResponse>;
+/**
+ * This function sends a request with `sendMessages`, and sends it again after a retryable
+ * error, at most `retries` more times.
+ */
+export declare function sendWithRetries(request: MessagesRequest, settings: LlmSettings, limits: CallLimits, retries: number): Promise<MessagesResponse>;
 //# sourceMappingURL=anthropic.d.ts.map

package/dist/anthropic.d.ts.map

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

package/dist/anthropic.js

@@ -2,15 +2,17 @@
  * The Anthropic Messages API over `fetch` (roadmap R46).
  *
  * The procedures send each request with the `fetch` of the module settings, not through
- * `http.request`: the API key goes in a header, and the input of a nested call is visible to the
+ * `http.request`. The API key goes in a header. The input of a nested call is visible to the
  * interceptors and to the traces of the host. The key comes from an environment variable that the
  * module names. An input cannot give a key.
  *
- * A call stops at the earliest of its time limit, the deadline of its capability and the abort of
- * the caller. A stop is an `InvocationError` with the code `TIMEOUT` or `ABORTED`.
+ * A request stops at the earliest of its time limit, the deadline of its capability and the abort
+ * of the caller. A stop is an `InvocationError` with the code `TIMEOUT` or `ABORTED`. A request
+ * that fails with a retryable error gets new tries (`retry.ts`).
  */
 import { InvocationError } from "@procedures/client";
 import { LlmError } from "./errors.js";
+import { DEFAULT_BACKOFF, DEFAULT_REQUEST_RETRIES, deadlineLeft, retryAfterMs, withRetries } from "./retry.js";
 /** The default model of the module. */
 export const DEFAULT_MODEL = "claude-sonnet-5-5";
 /** The default environment variable of the API key. */
@@ -19,7 +21,7 @@ export const DEFAULT_API_KEY_ENV = "ANTHROPIC_API_KEY";
 export const DEFAULT_BASE_URL = "https://api.anthropic.com";
 /** The default of `maxTokens`. */
 export const DEFAULT_MAX_TOKENS = 16_000;
-/** The default time limit of a call: 10 minutes. */
+/** The default time limit of a request: 10 minutes. */
 export const DEFAULT_TIMEOUT_MS = 600_000;
 /** The version header of the Messages API. */
 export const ANTHROPIC_VERSION = "2023-06-01";
@@ -35,6 +37,8 @@ export const DEFAULT_LLM_SETTINGS = Object.freeze({
     baseUrl: DEFAULT_BASE_URL,
     defaultModel: DEFAULT_MODEL,
     fallback: true,
+    retries: DEFAULT_REQUEST_RETRIES,
+    backoff: DEFAULT_BACKOFF,
 });
 /** The API key, or a `NO_API_KEY` error that names the variable. */
 export function apiKey(settings) {
@@ -63,6 +67,26 @@ export function addUsage(a, b) {
 /** A usage of zero tokens. */
 export const NO_USAGE = Object.freeze({ inputTokens: 0, outputTokens: 0, cacheReadInputTokens: 0, cacheCreationInputTokens: 0 });
 const count = (value) => (typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : 0);
+/** The four fields of the usage of the API and their names in `LlmUsage`. */
+const USAGE_FIELDS = [
+    ["input_tokens", "inputTokens"],
+    ["output_tokens", "outputTokens"],
+    ["cache_read_input_tokens", "cacheReadInputTokens"],
+    ["cache_creation_input_tokens", "cacheCreationInputTokens"],
+];
+/**
+ * This function gives the usage of a `usage` object of the API. A field that the object does not
+ * have keeps its value of `base`: the usage of a `message_delta` event changes only some fields.
+ */
+export function usageOf(raw, base = NO_USAGE) {
+    const record = raw !== null && typeof raw === "object" ? raw : {};
+    const usage = { ...base };
+    for (const [from, to] of USAGE_FIELDS) {
+        if (typeof record[from] === "number")
+            usage[to] = count(record[from]);
+    }
+    return usage;
+}
 /** The answer of the API, checked: an answer of another form is a `BAD_RESPONSE`. */
 function parseResponse(text) {
     let body;
@@ -76,23 +100,25 @@ function parseResponse(text) {
     if (record === null || typeof record !== "object" || !Array.isArray(record["content"]) || typeof record["stop_reason"] !== "string") {
         throw new LlmError("BAD_RESPONSE", "llm: the answer of the API is not a message with content and stop_reason");
     }
-    const usage = (record["usage"] ?? {});
     const details = record["stop_details"];
     return {
         model: typeof record["model"] === "string" ? record["model"] : "",
         content: record["content"].filter((block) => block !== null && typeof block === "object" && typeof block.type === "string"),
         stopReason: record["stop_reason"],
         stopDetails: details !== null && typeof details === "object" ? details : undefined,
-        usage: {
-            inputTokens: count(usage["input_tokens"]),
-            outputTokens: count(usage["output_tokens"]),
-            cacheReadInputTokens: count(usage["cache_read_input_tokens"]),
-            cacheCreationInputTokens: count(usage["cache_creation_input_tokens"]),
-        },
+        usage: usageOf(record["usage"]),
     };
 }
-/** The error of an answer with an error status. The message has the type and the message of the API. */
-function apiError(status, text, key) {
+/** True for a status that the same request can pass later: 408, 409, 429 and 5xx, as in the Anthropic SDKs. */
+function retryableStatus(status) {
+    return status === 408 || status === 409 || status === 429 || status >= 500;
+}
+/**
+ * The error of an answer with an error status. The message has the type and the message of the
+ * API. The header `x-should-retry` of the API overrides the rule of the status.
+ */
+function apiError(response, text, key) {
+    const { status } = response;
     let detail = text.slice(0, 500);
     try {
         const error = JSON.parse(text).error;
@@ -104,13 +130,9 @@ function apiError(status, text, key) {
     }
     // The API does not repeat the key, but the message must not carry it in any case
     const safe = detail.split(key).join("[key]");
-    const retryable = status === 408 || status === 409 || status === 429 || status >= 500;
-    return new LlmError("API_ERROR", `llm: the API answered ${status}: ${safe}`, { status, retryable });
-}
-/** The time that is left before the deadline of the capability, or undefined. */
-function deadlineLeft(ctx) {
-    const deadline = ctx?.capability?.deadline;
-    return typeof deadline === "number" ? deadline - Date.now() : undefined;
+    const should = response.headers.get("x-should-retry");
+    const retryable = should === "true" ? true : should === "false" ? false : retryableStatus(status);
+    return new LlmError("API_ERROR", `llm: the API answered ${status}: ${safe}`, { status, retryable, retryAfterMs: retryAfterMs(response.headers) });
 }
 /** The body of an answer as text, with a size limit. */
 async function readText(response) {
@@ -123,10 +145,10 @@ async function readText(response) {
     return text;
 }
 /**
- * This function sends one request to the Messages API and gives the checked answer. It throws a
- * `REFUSAL` error when a safety classifier declined the request.
+ * This function opens the scope of one request. It throws `NO_API_KEY` without a key, `TIMEOUT`
+ * when the deadline passed and `ABORTED` when the caller aborted, before a request goes out.
  */
-export async function sendMessages(request, settings, limits) {
+export function openScope(settings, limits) {
     const key = apiKey(settings);
     const { path, ctx } = limits;
     const left = deadlineLeft(ctx);
@@ -146,34 +168,69 @@ export async function sendMessages(request, settings, limits) {
         controller.abort();
     };
     ctx?.signal?.addEventListener("abort", onAbort, { once: true });
+    return {
+        key,
+        signal: controller.signal,
+        stopped: () => stop,
+        translate: (error) => {
+            if (stop === "timeout")
+                return new InvocationError("TIMEOUT", `${path.join(".")} passed its time limit of ${timeoutMs} ms`, path);
+            if (stop === "caller")
+                return new InvocationError("ABORTED", `Procedure was aborted: ${path.join(".")}`, path);
+            return error;
+        },
+        close: () => {
+            clearTimeout(timer);
+            ctx?.signal?.removeEventListener("abort", onAbort);
+        },
+    };
+}
+/** The message of an error, without the key. */
+export function safeMessage(error, key) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.split(key).join("[key]");
+}
+/**
+ * This function sends a request to the Messages API in a scope, and gives the answer with a
+ * status from 200 to 299. It throws `CONNECTION` for a failed connection and `API_ERROR` for an
+ * error status.
+ */
+export async function postMessages(request, settings, scope) {
     const headers = {
         "content-type": "application/json",
-        "x-api-key": key,
+        "x-api-key": scope.key,
         "anthropic-version": ANTHROPIC_VERSION,
     };
     if (request.fallbacks !== undefined)
         headers["anthropic-beta"] = FALLBACK_BETA;
+    let response;
     try {
-        let response;
-        try {
-            response = await settings.fetch(`${settings.baseUrl.replace(/\/+$/, "")}/v1/messages`, {
-                method: "POST",
-                headers,
-                body: JSON.stringify(request),
-                signal: controller.signal,
-            });
-        }
-        catch (error) {
-            if (stop === undefined) {
-                const message = error instanceof Error ? error.message : String(error);
-                throw new LlmError("CONNECTION", `llm: the connection to the API failed: ${message.split(key).join("[key]")}`, { retryable: true });
-            }
-            throw error;
+        response = await settings.fetch(`${settings.baseUrl.replace(/\/+$/, "")}/v1/messages`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(request),
+            signal: scope.signal,
+        });
+    }
+    catch (error) {
+        if (scope.stopped() === undefined) {
+            throw new LlmError("CONNECTION", `llm: the connection to the API failed: ${safeMessage(error, scope.key)}`, { retryable: true });
         }
-        const text = await readText(response);
-        if (!response.ok)
-            throw apiError(response.status, text, key);
-        const answer = parseResponse(text);
+        throw error;
+    }
+    if (!response.ok)
+        throw apiError(response, await readText(response), scope.key);
+    return response;
+}
+/**
+ * This function sends one request to the Messages API and gives the checked answer. It throws a
+ * `REFUSAL` error when a safety classifier declined the request.
+ */
+export async function sendMessages(request, settings, limits) {
+    const scope = openScope(settings, limits);
+    try {
+        const response = await postMessages(request, settings, scope);
+        const answer = parseResponse(await readText(response));
         if (answer.stopReason === "refusal") {
             const category = answer.stopDetails?.category ?? "not given";
             throw new LlmError("REFUSAL", `llm: a safety classifier declined the request (category: ${category})`);
@@ -181,15 +238,17 @@ export async function sendMessages(request, settings, limits) {
         return answer;
     }
     catch (error) {
-        if (stop === "timeout")
-            throw new InvocationError("TIMEOUT", `${path.join(".")} passed its time limit of ${timeoutMs} ms`, path);
-        if (stop === "caller")
-            throw new InvocationError("ABORTED", `Procedure was aborted: ${path.join(".")}`, path);
-        throw error;
+        throw scope.translate(error);
     }
     finally {
-        clearTimeout(timer);
-        ctx?.signal?.removeEventListener("abort", onAbort);
+        scope.close();
     }
 }
+/**
+ * This function sends a request with `sendMessages`, and sends it again after a retryable
+ * error, at most `retries` more times.
+ */
+export function sendWithRetries(request, settings, limits, retries) {
+    return withRetries(() => sendMessages(request, settings, limits), { backoff: settings.backoff, retries }, limits);
+}
 //# sourceMappingURL=anthropic.js.map

package/dist/anthropic.js.map

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

package/dist/errors.d.ts

@@ -6,29 +6,36 @@
 export type LlmErrorCode = 
 /** The environment variable of the API key has no value. */
 "NO_API_KEY"
-/** The API answered with an error status. `status` has it. */
+/** The API answered with an error status, or sent an error event in a stream. */
  | "API_ERROR"
-/** The connection to the API failed. */
+/** The connection to the API failed, or a stream ended before its end event. */
  | "CONNECTION"
-/** The answer of the API does not have the form of a message. */
+/** The answer of the API does not have the form of a message or of a stream of events. */
  | "BAD_RESPONSE"
 /** A safety classifier declined the request (`stop_reason: "refusal"`). */
  | "REFUSAL"
+/** A tool definition is not valid: a name that two tools have, or a procedure without an object input. */
+ | "BAD_TOOL"
 /** `llm.structured`: the output stopped at `maxTokens`, so the JSON is not complete. */
  | "MAX_TOKENS"
 /** `llm.structured`: no answer gave a value that the schema accepts. */
  | "INVALID_OUTPUT";
+/** The options of an `LlmError`. */
+export interface LlmErrorOptions {
+    readonly status?: number | undefined;
+    readonly retryable?: boolean | undefined;
+    readonly retryAfterMs?: number | undefined;
+}
 /** An error of a call to the model. */
 export declare class LlmError extends Error {
     readonly name = "LlmError";
     readonly code: LlmErrorCode;
-    /** The HTTP status of an `API_ERROR`. */
+    /** The HTTP status of an `API_ERROR`. An error event of a stream has no status. */
     readonly status: number | undefined;
     /** True when the same call can succeed later: a rate limit, an overload, a server error or a connection error. */
     readonly retryable: boolean;
-    constructor(code: LlmErrorCode, message: string, options?: {
-        status?: number | undefined;
-        retryable?: boolean | undefined;
-    });
+    /** The wait that the API asked for with `retry-after-ms` or `retry-after`, in milliseconds. */
+    readonly retryAfterMs: number | undefined;
+    constructor(code: LlmErrorCode, message: string, options?: LlmErrorOptions);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,MAAM,MAAM,YAAY;AACtB,4DAA4D;AAC1D,YAAY;AACd,8DAA8D;GAC5D,WAAW;AACb,wCAAwC;GACtC,YAAY;AACd,iEAAiE;GAC/D,cAAc;AAChB,2EAA2E;GACzE,SAAS;AACX,wFAAwF;GACtF,YAAY;AACd,wEAAwE;GACtE,gBAAgB,CAAC;AAErB,uCAAuC;AACvC,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAkB,IAAI,cAAc;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kHAAkH;IAClH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAO,EAK9H;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,MAAM,MAAM,YAAY;AACtB,4DAA4D;AAC1D,YAAY;AACd,iFAAiF;GAC/E,WAAW;AACb,gFAAgF;GAC9E,YAAY;AACd,0FAA0F;GACxF,cAAc;AAChB,2EAA2E;GACzE,SAAS;AACX,0GAA0G;GACxG,UAAU;AACZ,wFAAwF;GACtF,YAAY;AACd,wEAAwE;GACtE,gBAAgB,CAAC;AAErB,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,uCAAuC;AACvC,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAkB,IAAI,cAAc;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kHAAkH;IAClH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAM7E;CACF"}

package/dist/errors.js

@@ -6,15 +6,18 @@
 export class LlmError extends Error {
     name = "LlmError";
     code;
-    /** The HTTP status of an `API_ERROR`. */
+    /** The HTTP status of an `API_ERROR`. An error event of a stream has no status. */
     status;
     /** True when the same call can succeed later: a rate limit, an overload, a server error or a connection error. */
     retryable;
+    /** The wait that the API asked for with `retry-after-ms` or `retry-after`, in milliseconds. */
+    retryAfterMs;
     constructor(code, message, options = {}) {
         super(message);
         this.code = code;
         this.status = options.status;
         this.retryable = options.retryable ?? false;
+        this.retryAfterMs = options.retryAfterMs;
     }
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,uCAAuC;AACvC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACf,IAAI,GAAG,UAAU,CAAC;IAC3B,IAAI,CAAe;IAC5B,yCAAyC;IAChC,MAAM,CAAqB;IACpC,kHAAkH;IACzG,SAAS,CAAU;IAE5B,YAAY,IAAkB,EAAE,OAAe,EAAE,OAAO,GAAqE,EAAE;QAC7H,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,uCAAuC;AACvC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACf,IAAI,GAAG,UAAU,CAAC;IAC3B,IAAI,CAAe;IAC5B,mFAAmF;IAC1E,MAAM,CAAqB;IACpC,kHAAkH;IACzG,SAAS,CAAU;IAC5B,+FAA+F;IACtF,YAAY,CAAqB;IAE1C,YAAY,IAAkB,EAAE,OAAe,EAAE,OAAO,GAAoB,EAAE;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;CACF"}

package/dist/events.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The streaming Messages API (`"stream": true`): the server-sent events of an answer as stream items.
+ *
+ * `sseEvents` of `@procedures/http` parses the event stream. The first event of the API is
+ * `message_start`. Then each content block comes (`content_block_start`, its
+ * `content_block_delta` events, `content_block_stop`), then one or more `message_delta` events, and
+ * at the end `message_stop`. A `ping` event can come at each time, and an `error` event stops the
+ * stream. The usage of a `message_delta` event is cumulative. Other event types are ignored, as
+ * the versioning policy of the API asks.
+ *
+ * A stream gets a new try only before its first item. After the first item, an error goes to the
+ * caller.
+ */
+import { type CallLimits, type LlmSettings, type MessagesRequest } from "./anthropic.js";
+import type { LlmStreamOutput } from "./types.js";
+/**
+ * This function sends a request with `"stream": true` and gives each item of the answer. Before
+ * the first item, a retryable error gets a new try, at most `retries` times.
+ */
+export declare function streamMessages(request: MessagesRequest, settings: LlmSettings, limits: CallLimits, retries: number): AsyncGenerator<LlmStreamOutput, void, undefined>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAA2D,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGlJ,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,YAAY,CAAC;AAoLxE;;;GAGG;AACH,wBAAuB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAc5K"}