@procedures/llm 0.0.0-stage → 0.2.3

package/dist/anthropic.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 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
+ * 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`.
+ */
+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. */
+export type EnvSource = Readonly<Record<string, string | undefined>>;
+/** The `fetch` that the procedures use. A test gives a fake one. */
+export type FetchFunction = (url: string, init: RequestInit) => Promise<Response>;
+/** The default model of the module. */
+export declare const DEFAULT_MODEL = "claude-sonnet-5-5";
+/** The default environment variable of the API key. */
+export declare const DEFAULT_API_KEY_ENV = "ANTHROPIC_API_KEY";
+/** The default base URL of the API. */
+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. */
+export declare const DEFAULT_TIMEOUT_MS = 600000;
+/** The version header of the Messages API. */
+export declare const ANTHROPIC_VERSION = "2023-06-01";
+/** The beta header of the server-side fallback with `fallbacks: "default"`. */
+export declare const FALLBACK_BETA = "server-side-fallback-2026-07-01";
+/** What the procedures of a module use. */
+export interface LlmSettings {
+    readonly apiKeyEnv: string;
+    /** This function gives the variables at the time of a call. */
+    readonly env: () => EnvSource;
+    readonly fetch: FetchFunction;
+    readonly baseUrl: string;
+    readonly defaultModel: string;
+    /** The default of the `fallback` input. */
+    readonly fallback: boolean;
+}
+/** 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. */
+export interface ContentBlock {
+    readonly type: string;
+    readonly text?: string;
+    readonly [key: string]: unknown;
+}
+/** One message of a request. The content of an assistant turn is the content of the answer, unchanged. */
+export interface MessageParam {
+    readonly role: "user" | "assistant";
+    readonly content: string | readonly ContentBlock[];
+}
+/** The request body of the Messages API, as the procedures send it. */
+export interface MessagesRequest {
+    model: string;
+    max_tokens: number;
+    messages: MessageParam[];
+    system?: string;
+    temperature?: number;
+    output_config?: {
+        effort?: LlmEffort;
+        format?: {
+            type: "json_schema";
+            schema: unknown;
+        };
+    };
+    fallbacks?: "default";
+}
+/** The parts of an answer that the procedures use. */
+export interface MessagesResponse {
+    readonly model: string;
+    readonly content: readonly ContentBlock[];
+    readonly stopReason: string;
+    readonly stopDetails: {
+        readonly category?: string | null;
+        readonly explanation?: string | null;
+    } | undefined;
+    readonly usage: LlmUsage;
+}
+/** The time limit and the stop of one procedure call. */
+export interface CallLimits {
+    readonly path: ProcedurePath;
+    readonly ctx: Pick<ProcedureContext, "signal" | "capability"> | undefined;
+    readonly timeoutMs: number;
+}
+/** The API key, or a `NO_API_KEY` error that names the variable. */
+export declare function apiKey(settings: LlmSettings): string;
+/** The text blocks of an answer, joined. */
+export declare function textOf(content: readonly ContentBlock[]): string;
+/** The sum of two usages. */
+export declare function addUsage(a: LlmUsage, b: LlmUsage): LlmUsage;
+/** A usage of zero tokens. */
+export declare const NO_USAGE: LlmUsage;
+/**
+ * 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>;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/anthropic.d.ts.map

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

package/dist/anthropic.js

@@ -0,0 +1,195 @@
+/**
+ * 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
+ * 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`.
+ */
+import { InvocationError } from "@procedures/client";
+import { LlmError } from "./errors.js";
+/** The default model of the module. */
+export const DEFAULT_MODEL = "claude-sonnet-5-5";
+/** The default environment variable of the API key. */
+export const DEFAULT_API_KEY_ENV = "ANTHROPIC_API_KEY";
+/** The default base URL of the API. */
+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. */
+export const DEFAULT_TIMEOUT_MS = 600_000;
+/** The version header of the Messages API. */
+export const ANTHROPIC_VERSION = "2023-06-01";
+/** The beta header of the server-side fallback with `fallbacks: "default"`. */
+export const FALLBACK_BETA = "server-side-fallback-2026-07-01";
+/** The largest answer that the procedures read, in bytes. */
+const MAX_RESPONSE_BYTES = 32 * 1024 * 1024;
+/** The settings of the default module. */
+export const DEFAULT_LLM_SETTINGS = Object.freeze({
+    apiKeyEnv: DEFAULT_API_KEY_ENV,
+    env: () => process.env,
+    fetch: (url, init) => globalThis.fetch(url, init),
+    baseUrl: DEFAULT_BASE_URL,
+    defaultModel: DEFAULT_MODEL,
+    fallback: true,
+});
+/** The API key, or a `NO_API_KEY` error that names the variable. */
+export function apiKey(settings) {
+    const value = settings.env()[settings.apiKeyEnv];
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new LlmError("NO_API_KEY", `llm: the environment variable ${settings.apiKeyEnv} has no API key`);
+    }
+    return value.trim();
+}
+/** The text blocks of an answer, joined. */
+export function textOf(content) {
+    return content
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join("");
+}
+/** The sum of two usages. */
+export function addUsage(a, b) {
+    return {
+        inputTokens: a.inputTokens + b.inputTokens,
+        outputTokens: a.outputTokens + b.outputTokens,
+        cacheReadInputTokens: a.cacheReadInputTokens + b.cacheReadInputTokens,
+        cacheCreationInputTokens: a.cacheCreationInputTokens + b.cacheCreationInputTokens,
+    };
+}
+/** 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 answer of the API, checked: an answer of another form is a `BAD_RESPONSE`. */
+function parseResponse(text) {
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        throw new LlmError("BAD_RESPONSE", `llm: the answer of the API is not JSON: ${text.slice(0, 200)}`);
+    }
+    const record = body;
+    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"]),
+        },
+    };
+}
+/** 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) {
+    let detail = text.slice(0, 500);
+    try {
+        const error = JSON.parse(text).error;
+        if (error && typeof error.message === "string")
+            detail = `${typeof error.type === "string" ? `${error.type}: ` : ""}${error.message}`;
+    }
+    catch {
+        // The text of the answer stays the detail
+    }
+    // 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;
+}
+/** The body of an answer as text, with a size limit. */
+async function readText(response) {
+    const declared = Number(response.headers.get("content-length") ?? "0");
+    if (declared > MAX_RESPONSE_BYTES)
+        throw new LlmError("BAD_RESPONSE", `llm: the answer of the API is larger than ${MAX_RESPONSE_BYTES} bytes`);
+    const text = await response.text();
+    if (text.length > MAX_RESPONSE_BYTES)
+        throw new LlmError("BAD_RESPONSE", `llm: the answer of the API is larger than ${MAX_RESPONSE_BYTES} bytes`);
+    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.
+ */
+export async function sendMessages(request, settings, limits) {
+    const key = apiKey(settings);
+    const { path, ctx } = limits;
+    const left = deadlineLeft(ctx);
+    if (left !== undefined && left <= 0)
+        throw new InvocationError("TIMEOUT", `The deadline of ${path.join(".")} passed before the call`, path);
+    const timeoutMs = left === undefined ? limits.timeoutMs : Math.min(limits.timeoutMs, left);
+    if (ctx?.signal?.aborted)
+        throw new InvocationError("ABORTED", `Procedure was aborted: ${path.join(".")}`, path);
+    const controller = new AbortController();
+    let stop;
+    const timer = setTimeout(() => {
+        stop ??= "timeout";
+        controller.abort();
+    }, timeoutMs);
+    const onAbort = () => {
+        stop ??= "caller";
+        controller.abort();
+    };
+    ctx?.signal?.addEventListener("abort", onAbort, { once: true });
+    const headers = {
+        "content-type": "application/json",
+        "x-api-key": key,
+        "anthropic-version": ANTHROPIC_VERSION,
+    };
+    if (request.fallbacks !== undefined)
+        headers["anthropic-beta"] = FALLBACK_BETA;
+    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;
+        }
+        const text = await readText(response);
+        if (!response.ok)
+            throw apiError(response.status, text, key);
+        const answer = parseResponse(text);
+        if (answer.stopReason === "refusal") {
+            const category = answer.stopDetails?.category ?? "not given";
+            throw new LlmError("REFUSAL", `llm: a safety classifier declined the request (category: ${category})`);
+        }
+        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;
+    }
+    finally {
+        clearTimeout(timer);
+        ctx?.signal?.removeEventListener("abort", onAbort);
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/anthropic.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The errors of the llm procedures. A stop of the call (its time limit, its deadline, the abort of
+ * the caller) is an `InvocationError` with the code `TIMEOUT` or `ABORTED`.
+ */
+/** The reason of an `LlmError`. */
+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. */
+ | "API_ERROR"
+/** The connection to the API failed. */
+ | "CONNECTION"
+/** The answer of the API does not have the form of a message. */
+ | "BAD_RESPONSE"
+/** A safety classifier declined the request (`stop_reason: "refusal"`). */
+ | "REFUSAL"
+/** `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";
+/** 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`. */
+    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;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +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"}

package/dist/errors.js

@@ -0,0 +1,20 @@
+/**
+ * The errors of the llm procedures. A stop of the call (its time limit, its deadline, the abort of
+ * the caller) is an `InvocationError` with the code `TIMEOUT` or `ABORTED`.
+ */
+/** An error of a call to the model. */
+export class LlmError extends Error {
+    name = "LlmError";
+    code;
+    /** The HTTP status of an `API_ERROR`. */
+    status;
+    /** True when the same call can succeed later: a rate limit, an overload, a server error or a connection error. */
+    retryable;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.code = code;
+        this.status = options.status;
+        this.retryable = options.retryable ?? false;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./module.js";
+export * from "./types.js";
+export { llmComplete, llmStructured, MAX_RETRIES } from "./procedures/llm/index.js";
+export { ANTHROPIC_VERSION, DEFAULT_API_KEY_ENV, DEFAULT_BASE_URL, DEFAULT_LLM_SETTINGS, DEFAULT_MAX_TOKENS, DEFAULT_MODEL, DEFAULT_TIMEOUT_MS, FALLBACK_BETA, type EnvSource, type FetchFunction, type LlmSettings, } from "./anthropic.js";
+export { LlmError, type LlmErrorCode } from "./errors.js";
+export { constrainedSchema, parseAnswer, UNSUPPORTED_KEYWORDS } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// The root registers nothing: import "<package>/register", or give the module to createRegistry()
+export * from "./module.js";
+export * from "./types.js";
+export { llmComplete, llmStructured, MAX_RETRIES } from "./procedures/llm/index.js";
+// The provider (roadmap R46)
+export { ANTHROPIC_VERSION, DEFAULT_API_KEY_ENV, DEFAULT_BASE_URL, DEFAULT_LLM_SETTINGS, DEFAULT_MAX_TOKENS, DEFAULT_MODEL, DEFAULT_TIMEOUT_MS, FALLBACK_BETA, } from "./anthropic.js";
+export { LlmError } from "./errors.js";
+export { constrainedSchema, parseAnswer, UNSUPPORTED_KEYWORDS } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACpF,6BAA6B;AAC7B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,aAAa,GAId,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAqB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The procedures of @procedures/llm as data. Importing this file registers nothing.
+ *
+ * Scaffold a procedure with: mark procedure new <name> --path packages/llm
+ *
+ * `llmModule` sends each request to the Anthropic Messages API with the key of the environment
+ * variable `ANTHROPIC_API_KEY`. `createLlmModule()` gives the same procedures with another
+ * variable, another default model, another base URL or another `fetch` (roadmap R46).
+ */
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+import { type EnvSource, type FetchFunction } from "./anthropic.js";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Each call reads the
+ * key from `ANTHROPIC_API_KEY`. Importing this file registers nothing.
+ */
+export declare const llmModule: ProcedureModule;
+export default llmModule;
+/** The options of `createLlmModule()`. */
+export interface LlmModuleOptions {
+    /** The environment variable of the API key. The default is `ANTHROPIC_API_KEY`. */
+    readonly apiKeyEnv?: string | undefined;
+    /** The model of an input without `model`. The default is `claude-sonnet-5-5`. */
+    readonly defaultModel?: string | undefined;
+    /** The base URL of the API. The default is `https://api.anthropic.com`. */
+    readonly baseUrl?: string | undefined;
+    /** The default of the `fallback` input. The default is true. */
+    readonly fallback?: boolean | undefined;
+    /** The `fetch` of the requests. The default is the global `fetch`. A test gives a fake one. */
+    readonly fetch?: FetchFunction | undefined;
+    /** The variables: a record, or a function that gives them at each call. The default is `process.env`. */
+    readonly env?: EnvSource | (() => EnvSource) | undefined;
+}
+/**
+ * This function gives the module of this package with other settings. Without options, it gives
+ * `llmModule`. A host gives it to `createRegistry()` before its bundles, so it replaces the
+ * `llmModule` that a bundle requires (the first module of a name counts). A bad option throws here.
+ *
+ * ```ts
+ * createRegistry(createLlmModule({ apiKeyEnv: "WORK_ANTHROPIC_KEY", defaultModel: "claude-haiku-5-5" }));
+ * ```
+ */
+export declare function createLlmModule(options?: LlmModuleOptions): ProcedureModule;
+/**
+ * This function registers the procedures of @procedures/llm in a registry. The default is the
+ * global registry. The options are the options of `createLlmModule()`.
+ */
+export declare function registerLlmProcedures(registry?: ProcedureRegistry, options?: LlmModuleOptions): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EASL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAwB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAuG5G;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,eAAsF,CAAC;eAEhG,SAAS;AAExB,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,iFAAiF;IACjF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,yGAAyG;IACzG,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAgB/E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,iBAAsC,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAE5H"}

package/dist/module.js

@@ -0,0 +1,145 @@
+/**
+ * The procedures of @procedures/llm as data. Importing this file registers nothing.
+ *
+ * Scaffold a procedure with: mark procedure new <name> --path packages/llm
+ *
+ * `llmModule` sends each request to the Anthropic Messages API with the key of the environment
+ * variable `ANTHROPIC_API_KEY`. `createLlmModule()` gives the same procedures with another
+ * variable, another default model, another base URL or another `fetch` (roadmap R46).
+ */
+import { z } from "zod";
+import { defineModule, registerModules, PROCEDURE_REGISTRY, createProcedure, zodAdapter, } from "@procedures/client";
+import { llmComplete } from "./procedures/llm/complete.js";
+import { llmStructured, MAX_RETRIES } from "./procedures/llm/structured.js";
+import { DEFAULT_LLM_SETTINGS } from "./anthropic.js";
+// =============================================================================
+// Schemas
+// =============================================================================
+const requestFields = {
+    prompt: z.string().min(1).max(4_000_000).describe("The text of the user"),
+    system: z.string().max(4_000_000).optional().describe("The system text: the instructions to the model"),
+    model: z
+        .string()
+        .min(1)
+        .max(200)
+        .regex(/^[A-Za-z0-9][A-Za-z0-9._:@/-]*$/, "A model ID")
+        .optional()
+        .describe("The model (default: the model of the module, claude-sonnet-5-5)"),
+    maxTokens: z.number().int().min(1).max(64_000).optional().describe("The most tokens of the output, with the thinking (default 16000)"),
+    temperature: z.number().min(0).max(1).optional().describe("The temperature, 0 to 1. Some models accept only the default"),
+    effort: z.enum(["low", "medium", "high", "xhigh", "max"]).optional().describe("The effort of the model (default: the default of the model)"),
+    timeoutMs: z.number().int().positive().max(3_600_000).optional().describe("The time limit of the call, in milliseconds (default 600000)"),
+    fallback: z.boolean().optional().describe("True: the API runs a declined request again on its fallback model (default: the option of the module, true)"),
+};
+const usage = z
+    .object({
+    inputTokens: z.number().int().describe("The tokens of the input that the cache did not have"),
+    outputTokens: z.number().int().describe("The tokens of the output, with the thinking"),
+    cacheReadInputTokens: z.number().int().describe("The tokens of the input from the cache"),
+    cacheCreationInputTokens: z.number().int().describe("The tokens of the input that went into the cache"),
+})
+    .describe("The tokens of the call");
+const LlmCompleteInputSchema = z.object(requestFields);
+const LlmCompleteOutputSchema = z.object({
+    text: z.string().describe("The text of the answer"),
+    model: z.string().describe("The model that answered"),
+    stopReason: z.string().describe("Why the model stopped: end_turn, max_tokens, stop_sequence or another reason"),
+    usage,
+});
+const LlmStructuredInputSchema = z.object({
+    ...requestFields,
+    schema: z.record(z.string(), z.unknown()).describe("The JSON Schema of the value"),
+    constrained: z.boolean().optional().describe("True (default): the API constrains the output to the schema. False: the system text gives the schema"),
+    retries: z.number().int().min(0).max(MAX_RETRIES).optional().describe("The new tries after an answer that is not valid, 0 to 2 (default 2)"),
+});
+const LlmStructuredOutputSchema = z.object({
+    value: z.unknown().describe("The value: the schema accepts it"),
+    model: z.string().describe("The model that gave the value"),
+    attempts: z.number().int().describe("The number of calls to the model"),
+    usage,
+    unchecked: z.array(z.string()).describe("The keywords of the schema that the check does not examine fully"),
+});
+// =============================================================================
+// Procedures
+// =============================================================================
+/**
+ * The effects of each procedure: it sends data to a system outside the host and gets an answer.
+ * A call costs money and can change the state of an account, so it declares a write. It deletes
+ * nothing and a second call is a new call.
+ */
+const SENDS_TO_MODEL = Object.freeze({ reads: Object.freeze(["network"]), writes: Object.freeze(["network"]), destructive: false, idempotent: false });
+/** The two procedures, with handlers that use the settings. */
+function llmProcedures(settings) {
+    const llmCompleteProcedure = createProcedure()
+        .path(["llm", "complete"])
+        .input(zodAdapter(LlmCompleteInputSchema))
+        .output(zodAdapter(LlmCompleteOutputSchema))
+        .meta({
+        description: "Send a prompt to a language model and give the text and the usage",
+        tags: ["llm", "anthropic"],
+        args: ["prompt"],
+        shorts: { model: "m", system: "s" },
+        output: "json",
+        effects: SENDS_TO_MODEL,
+    })
+        .handler(async (input, ctx) => llmComplete(input, ctx, settings))
+        .build();
+    const llmStructuredProcedure = createProcedure()
+        .path(["llm", "structured"])
+        .input(zodAdapter(LlmStructuredInputSchema))
+        .output(zodAdapter(LlmStructuredOutputSchema))
+        .meta({
+        description: "Send a prompt and a JSON Schema to a language model and give a value that the schema accepts",
+        tags: ["llm", "anthropic", "json-schema"],
+        args: ["prompt"],
+        shorts: { model: "m", system: "s" },
+        output: "json",
+        effects: SENDS_TO_MODEL,
+    })
+        .handler(async (input, ctx) => llmStructured(input, ctx, settings))
+        .build();
+    return [llmCompleteProcedure, llmStructuredProcedure];
+}
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Each call reads the
+ * key from `ANTHROPIC_API_KEY`. Importing this file registers nothing.
+ */
+export const llmModule = defineModule("@procedures/llm", llmProcedures(DEFAULT_LLM_SETTINGS));
+export default llmModule;
+/**
+ * This function gives the module of this package with other settings. Without options, it gives
+ * `llmModule`. A host gives it to `createRegistry()` before its bundles, so it replaces the
+ * `llmModule` that a bundle requires (the first module of a name counts). A bad option throws here.
+ *
+ * ```ts
+ * createRegistry(createLlmModule({ apiKeyEnv: "WORK_ANTHROPIC_KEY", defaultModel: "claude-haiku-5-5" }));
+ * ```
+ */
+export function createLlmModule(options = {}) {
+    if (Object.values(options).every((value) => value === undefined))
+        return llmModule;
+    const apiKeyEnv = options.apiKeyEnv ?? DEFAULT_LLM_SETTINGS.apiKeyEnv;
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(apiKeyEnv))
+        throw new TypeError(`createLlmModule: apiKeyEnv must be the name of a variable, not ${JSON.stringify(apiKeyEnv)}`);
+    const baseUrl = options.baseUrl ?? DEFAULT_LLM_SETTINGS.baseUrl;
+    if (!/^https?:\/\//.test(baseUrl))
+        throw new TypeError("createLlmModule: baseUrl must be an http or https URL");
+    const env = options.env;
+    const settings = {
+        apiKeyEnv,
+        env: env === undefined ? DEFAULT_LLM_SETTINGS.env : typeof env === "function" ? env : () => env,
+        fetch: options.fetch ?? DEFAULT_LLM_SETTINGS.fetch,
+        baseUrl,
+        defaultModel: options.defaultModel ?? DEFAULT_LLM_SETTINGS.defaultModel,
+        fallback: options.fallback ?? DEFAULT_LLM_SETTINGS.fallback,
+    };
+    return defineModule("@procedures/llm", llmProcedures(settings));
+}
+/**
+ * This function registers the procedures of @procedures/llm in a registry. The default is the
+ * global registry. The options are the options of `createLlmModule()`.
+ */
+export function registerLlmProcedures(registry = PROCEDURE_REGISTRY, options = {}) {
+    registerModules(registry, [createLlmModule(options)]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,UAAU,GAMX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAwD,MAAM,gBAAgB,CAAC;AAG5G,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACvG,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,KAAK,CAAC,iCAAiC,EAAE,YAAY,CAAC;SACtD,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IACtI,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACzH,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IAC5I,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACzI,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6GAA6G,CAAC;CACzJ,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC;KACZ,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAC7F,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACtF,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACzF,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACxG,CAAC;KACD,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAEtC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAEvD,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IAC/G,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,aAAa;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAClF,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sGAAsG,CAAC;IACpJ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;CAC7I,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACvE,KAAK;IACL,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kEAAkE,CAAC;CAC5G,CAAC,CAAC;AAEH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,cAAc,GAAY,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;AAEhK,+DAA+D;AAC/D,SAAS,aAAa,CAAC,QAAqB;IAC1C,MAAM,oBAAoB,GAAG,eAAe,EAAE;SAC3C,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;SACzB,KAAK,CAAC,UAAU,CAAmB,sBAAsB,CAAC,CAAC;SAC3D,MAAM,CAAC,UAAU,CAAoB,uBAAuB,CAAC,CAAC;SAC9D,IAAI,CAAC;QACJ,WAAW,EAAE,mEAAmE;QAChF,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC;QAC1B,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,cAAc;KACxB,CAAC;SACD,OAAO,CAAC,KAAK,EAAE,KAAuB,EAAE,GAAqB,EAA8B,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;SAChI,KAAK,EAAE,CAAC;IAEX,MAAM,sBAAsB,GAAG,eAAe,EAAE;SAC7C,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;SAC3B,KAAK,CAAC,UAAU,CAAqB,wBAAwB,CAAC,CAAC;SAC/D,MAAM,CAAC,UAAU,CAAsB,yBAAyB,CAAC,CAAC;SAClE,IAAI,CAAC;QACJ,WAAW,EAAE,8FAA8F;QAC3G,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC;QACzC,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,cAAc;KACxB,CAAC;SACD,OAAO,CAAC,KAAK,EAAE,KAAyB,EAAE,GAAqB,EAAgC,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;SACtI,KAAK,EAAE,CAAC;IAEX,OAAO,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB,YAAY,CAAC,iBAAiB,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAE/G,eAAe,SAAS,CAAC;AAkBzB;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAAqB,EAAE;IAC5D,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACnF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,oBAAoB,CAAC,SAAS,CAAC;IACtE,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kEAAkE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpK,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC;IAChE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;IAChH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,QAAQ,GAAgB;QAC5B,SAAS;QACT,GAAG,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG;QAC/F,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,oBAAoB,CAAC,KAAK;QAClD,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,oBAAoB,CAAC,YAAY;QACvE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,oBAAoB,CAAC,QAAQ;KAC5D,CAAC;IACF,OAAO,YAAY,CAAC,iBAAiB,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAQ,GAAsB,kBAAkB,EAAE,OAAO,GAAqB,EAAE;IACpH,eAAe,CAAC,QAAQ,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/procedures/llm/complete.d.ts

@@ -0,0 +1,13 @@
+/**
+ * llm.complete procedure
+ *
+ * Send a prompt to a language model and give the text and the usage. The text is the text
+ * blocks of the answer, joined: the thinking blocks are not in it.
+ */
+import { type CallLimits, type LlmSettings } from "../../anthropic.js";
+import type { LlmCompleteInput, LlmCompleteOutput } from "../../types.js";
+/**
+ * Send a prompt to a language model and give the text and the usage
+ */
+export declare function llmComplete(input: LlmCompleteInput, ctx?: CallLimits["ctx"], settings?: LlmSettings): Promise<LlmCompleteOutput>;
+//# sourceMappingURL=complete.d.ts.map

package/dist/procedures/llm/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../src/procedures/llm/complete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA8C,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEnH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAI1E;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAE,WAAkC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAS5J"}