@loomwork/llm 0.0.0-stage → 0.1.1

package/dist/errors.js

@@ -0,0 +1,280 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamLimiter = exports.LlmResponseInvalidError = exports.LlmResponseLimitError = exports.DEFAULT_MAX_LINE_BYTES = exports.DEFAULT_MAX_STREAM_BYTES = exports.DEFAULT_MAX_RESPONSE_BYTES = exports.LlmStreamError = exports.ERROR_BODY_READ_TIMEOUT_MS = exports.MAX_ERROR_BODY_BYTES = exports.LlmHttpError = void 0;
+exports.drainBody = drainBody;
+exports.readBoundedErrorJson = readBoundedErrorJson;
+exports.resolveLimit = resolveLimit;
+exports.readBoundedJson = readBoundedJson;
+const LABEL = {
+    anthropic: "Anthropic",
+    openai: "OpenAI",
+    gemini: "Gemini",
+};
+/**
+ * Release the body of a non-2xx response without reading it: an unconsumed body keeps the
+ * connection (undici) busy. Never reads the text, and a failing cancel must not mask the status.
+ */
+async function drainBody(resp) {
+    await resp.body?.cancel().catch(() => undefined);
+}
+/**
+ * A provider's HTTP API answered with a non-2xx status. `status` is what a caller should branch
+ * on. The response body is deliberately NOT kept: it can echo the prompt, so it is never put in
+ * the message or on the error.
+ */
+class LlmHttpError extends Error {
+    status;
+    provider;
+    /** Set to `false` for a 3xx (a redirect, never followed): retrying cannot help. */
+    retryable;
+    /**
+     * Why the request failed, when the status alone cannot say. Closed: `"auth"` means the
+     * credential was refused (401/403, or a 400 the provider's own error code names as a bad key), a
+     * configuration fault rather than a malformed request. Absent otherwise.
+     */
+    kind;
+    constructor(provider, status, kind) {
+        super(`${LABEL[provider]} API error ${status}`);
+        this.name = "LlmHttpError";
+        this.status = status;
+        this.provider = provider;
+        // A redirect is never followed (it would re-send the body and credentials elsewhere), and
+        // asking again changes nothing: the base URL is misconfigured or the path is intercepted.
+        if (status >= 300 && status < 400)
+            this.retryable = false;
+        if (kind === "auth" || status === 401 || status === 403)
+            this.kind = "auth";
+    }
+}
+exports.LlmHttpError = LlmHttpError;
+/** The most of a non-2xx body that is ever read to look for a provider error code. */
+exports.MAX_ERROR_BODY_BYTES = 16 * 1024;
+/** The longest the error-body read may take; a server that stalls after the headers is given up on. */
+exports.ERROR_BODY_READ_TIMEOUT_MS = 2000;
+/**
+ * Read at most `maxBytes` of a non-2xx body, for at most `timeoutMs` (and no longer than `signal`
+ * allows), and parse it as JSON. The body is always consumed or cancelled and its reader released
+ * before this returns, so the caller need not drain it. Returns `undefined` for anything else (over
+ * the bound, too slow, aborted, unreadable, not JSON): the caller only ever looks for a fixed error
+ * code in the result and keeps nothing of it.
+ */
+async function readBoundedErrorJson(resp, signal, maxBytes = exports.MAX_ERROR_BODY_BYTES, timeoutMs = exports.ERROR_BODY_READ_TIMEOUT_MS) {
+    const reader = resp.body?.getReader?.();
+    if (!reader) {
+        await drainBody(resp);
+        return undefined;
+    }
+    let onAbort;
+    const stop = new Promise((resolve) => {
+        onAbort = () => resolve("stop");
+        if (signal?.aborted)
+            onAbort();
+        else
+            signal?.addEventListener("abort", onAbort, { once: true });
+    });
+    const timer = setTimeout(() => onAbort?.(), timeoutMs);
+    let finished = false;
+    try {
+        const parts = [];
+        let total = 0;
+        while (true) {
+            const next = await Promise.race([reader.read(), stop]);
+            if (next === "stop")
+                return undefined;
+            if (next.done) {
+                finished = true;
+                break;
+            }
+            total += next.value.byteLength;
+            if (total > maxBytes)
+                return undefined;
+            parts.push(next.value);
+        }
+        const all = new Uint8Array(total);
+        let off = 0;
+        for (const p of parts) {
+            all.set(p, off);
+            off += p.byteLength;
+        }
+        return JSON.parse(new TextDecoder().decode(all));
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timer);
+        if (onAbort)
+            signal?.removeEventListener("abort", onAbort);
+        // Not awaited: a stalled source must not delay the caller's throw.
+        if (!finished)
+            reader.cancel().catch(() => undefined);
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            // A read is still pending on an older runtime; the cancel above settles it.
+        }
+    }
+}
+/**
+ * A provider reported an error INSIDE a 200 stream (Anthropic `event: error`, an OpenAI-compatible
+ * `{"error": ...}` chunk). Carries only the provider and the error type or code, and only when it is
+ * a plain identifier: the message text can echo the prompt, so it is never kept.
+ */
+class LlmStreamError extends Error {
+    provider;
+    code;
+    constructor(provider, code) {
+        const safe = typeof code === "string" && /^[A-Za-z0-9_.-]{1,64}$/.test(code) ? code : "unknown";
+        super(`${LABEL[provider]} stream error: ${safe}`);
+        this.name = "LlmStreamError";
+        this.provider = provider;
+        this.code = safe;
+    }
+}
+exports.LlmStreamError = LlmStreamError;
+/** Default cap on a complete response body (bytes), and on the total bytes of a stream. */
+exports.DEFAULT_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
+/**
+ * Default cap on the TOTAL bytes of a stream. Much larger than the complete-body cap: an SSE
+ * chunk is ~250-300 B per token on the wire, so a long answer legitimately needs tens of MiB, and
+ * memory is bounded by the per-line cap, not by this.
+ */
+exports.DEFAULT_MAX_STREAM_BYTES = 128 * 1024 * 1024;
+/** Default cap on one line of a stream, in UTF-8 bytes. */
+exports.DEFAULT_MAX_LINE_BYTES = 1024 * 1024;
+/** UTF-8 byte length of a string, without allocating. */
+function utf8Length(str) {
+    let n = 0;
+    for (let i = 0; i < str.length; i++) {
+        const c = str.charCodeAt(i);
+        if (c < 0x80)
+            n += 1;
+        else if (c < 0x800)
+            n += 2;
+        else if (c >= 0xd800 && c <= 0xdbff && i + 1 < str.length) {
+            n += 4;
+            i++;
+        }
+        else
+            n += 3;
+    }
+    return n;
+}
+/**
+ * A provider's response exceeded the configured size cap (`maxResponseBytes` / `maxStreamBytes` / `maxLineBytes`).
+ * Carries only the provider and which limit was hit: never any of the body.
+ */
+class LlmResponseLimitError extends Error {
+    provider;
+    reason;
+    constructor(provider, reason) {
+        super(`${LABEL[provider]} response too large (${reason})`);
+        this.name = "LlmResponseLimitError";
+        this.provider = provider;
+        this.reason = reason;
+    }
+}
+exports.LlmResponseLimitError = LlmResponseLimitError;
+/**
+ * A 2xx response whose body is not valid JSON. Fixed message, no `cause`: the parser's own error
+ * quotes the start of the body, which can hold anything the endpoint sent.
+ */
+class LlmResponseInvalidError extends Error {
+    provider;
+    constructor(provider) {
+        super(`${LABEL[provider]} response is not valid JSON`);
+        this.name = "LlmResponseInvalidError";
+        this.provider = provider;
+    }
+}
+exports.LlmResponseInvalidError = LlmResponseInvalidError;
+/** Reject a non-positive or non-integer cap at construction. */
+function resolveLimit(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isInteger(value) || value < 1)
+        throw new RangeError(`${name} must be a positive integer`);
+    return value;
+}
+/**
+ * Read a complete JSON body with a byte cap. Over the cap the body is cancelled and an
+ * {@link LlmResponseLimitError} is thrown (no body text). Streams the bytes, so a hostile endpoint
+ * cannot make the process buffer more than the cap (plus one chunk).
+ */
+async function readBoundedJson(resp, provider, maxBytes) {
+    const declared = Number(resp.headers?.get("content-length"));
+    if (Number.isFinite(declared) && declared > maxBytes) {
+        await drainBody(resp);
+        throw new LlmResponseLimitError(provider, "body");
+    }
+    // No stream to read (an empty body, or a non-network `Response` stand-in): nothing to bound.
+    if (!resp.body) {
+        try {
+            return await resp.json();
+        }
+        catch {
+            throw new LlmResponseInvalidError(provider);
+        }
+    }
+    const reader = resp.body.getReader();
+    const parts = [];
+    let total = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.byteLength;
+            if (total > maxBytes) {
+                await reader.cancel().catch(() => undefined);
+                throw new LlmResponseLimitError(provider, "body");
+            }
+            parts.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock?.();
+    }
+    const all = new Uint8Array(total);
+    let off = 0;
+    for (const p of parts) {
+        all.set(p, off);
+        off += p.byteLength;
+    }
+    try {
+        return JSON.parse(new TextDecoder().decode(all));
+    }
+    catch {
+        throw new LlmResponseInvalidError(provider);
+    }
+}
+/** Byte and line accounting for an SSE stream; each check throws {@link LlmResponseLimitError}. */
+class StreamLimiter {
+    provider;
+    maxBytes;
+    maxLine;
+    total = 0;
+    constructor(provider, maxBytes, maxLine) {
+        this.provider = provider;
+        this.maxBytes = maxBytes;
+        this.maxLine = maxLine;
+    }
+    chunk(value) {
+        this.total += value.byteLength;
+        if (this.total > this.maxBytes)
+            throw new LlmResponseLimitError(this.provider, "stream");
+    }
+    /** `lines` are the complete lines of this chunk, `rest` the unfinished tail. */
+    lines(lines, rest) {
+        // UTF-8 is at most 3 bytes per UTF-16 unit: only measure what could be over the cap.
+        const over = (l) => l.length * 3 > this.maxLine && utf8Length(l) > this.maxLine;
+        if (over(rest))
+            throw new LlmResponseLimitError(this.provider, "line");
+        for (const l of lines)
+            if (over(l))
+                throw new LlmResponseLimitError(this.provider, "line");
+    }
+}
+exports.StreamLimiter = StreamLimiter;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { LlmHttpError, LlmResponseInvalidError, LlmResponseLimitError, LlmStreamError, } from "./errors";
+export type { LlmHttpErrorKind, LlmHttpProvider, LlmResponseLimitReason } from "./errors";
+export type { LlmContent, LlmMessage, LlmMessageInput, LlmToolSpec, LlmToolSpecInput, LlmRequest, LlmRequestInput, LlmToolCall, LlmResponse, LlmCapturedResponse, LlmStreamChunk, LlmProvider, LlmReasoning, LlmReasoningKind, LlmReasoningPart, } from "./types";
+export type { CapturedReasoningPart, LlmReasoningCaptured, LlmReasoningOptions, ReasoningAttemptRead, ReasoningLogReader, ReasoningPartRead, ReasoningPartStatus, ReasoningQuery, ReasoningReadLimits, ReasoningReader, ReasoningStepRead, ReasoningStore, } from "./reasoning";
+export { LLM_REASONING_CAPTURED, captureReasoning, readReasoning, readReasoningBounded, openReasoningText, reasoningDigest, reasoningStoreResolver, sealReasoningText, textFreeReasoning, } from "./reasoning";
+export type { LlmAudioPart, LlmBinarySource, LlmContentPart, LlmContentPartInput, LlmContentRef, LlmFilePart, LlmImagePart, LlmLayoutEntry, LlmMediaPart, LlmMediaPartInput, LlmMessageContent, LlmMessageContentInput, LlmModality, LlmResultPart, LlmResultPartInput, LlmTextPart, LlmTextPartInput, LlmToolResultPart, LlmToolResultPartInput, LlmToolUsePart, } from "./parts";
+export { TaintedContentError, assistantMessageOf, base64ByteLength, hasReasoningParts, hasStructuredParts, layoutOf, textOf, toParts, withoutReasoningParts, } from "./parts";
+export type { LlmCapabilities, MediaTypeSet } from "./capabilities";
+export { UnsupportedModalityError, assertRequestSupported, capabilitiesForModel, mediaTypeAccepted, requestMediaParts, } from "./capabilities";
+export type { ContentResolveContext, ContentResolver } from "./resolveContent";
+export { MAX_RESOLVED_BYTES, UnresolvedContentError, inlineData, resolveRequestContent, } from "./resolveContent";
+export { InvalidLlmRequestError, MAX_INLINE_BYTES, MAX_INLINE_TOTAL_BYTES, TOOL_INPUT_NODE_CAP, OversizedInlinePartError, UNTRUSTED_CONTENT_SYSTEM_NOTE, UntrustedContentError, exceedsNodeCap, fence, fenceUntrustedMedia, guardRequest, stripUntrusted, untrustedFence, validateMediaPart, } from "./untrusted";
+export type { GuardOptions } from "./untrusted";
+export { AnthropicProvider } from "./providers/AnthropicProvider";
+export type { AnthropicProviderConfig } from "./providers/AnthropicProvider";
+export { OpenAiProvider } from "./providers/OpenAiProvider";
+export type { OpenAiProviderConfig } from "./providers/OpenAiProvider";
+export { GEMINI_CAPABILITIES, GEMINI_MEDIA_MODELS, GeminiProvider, } from "./providers/GeminiProvider";
+export type { GeminiProviderConfig } from "./providers/GeminiProvider";
+export { LLM_INTERRUPTED, MalformedStreamError, assembleStream, collectStream, } from "./assembleStream";
+export type { CollectStreamOptions, InterruptedGeneration, StreamProgress, } from "./assembleStream";
+export { createLlmEffect } from "./createLlmEffect";
+export type { CreateLlmEffectOptions } from "./createLlmEffect";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiProvider = exports.GEMINI_MEDIA_MODELS = exports.GEMINI_CAPABILITIES = exports.OpenAiProvider = exports.AnthropicProvider = exports.validateMediaPart = exports.untrustedFence = exports.stripUntrusted = exports.guardRequest = exports.fenceUntrustedMedia = exports.fence = exports.exceedsNodeCap = exports.UntrustedContentError = exports.UNTRUSTED_CONTENT_SYSTEM_NOTE = exports.OversizedInlinePartError = exports.TOOL_INPUT_NODE_CAP = exports.MAX_INLINE_TOTAL_BYTES = exports.MAX_INLINE_BYTES = exports.InvalidLlmRequestError = exports.resolveRequestContent = exports.inlineData = exports.UnresolvedContentError = exports.MAX_RESOLVED_BYTES = exports.requestMediaParts = exports.mediaTypeAccepted = exports.capabilitiesForModel = exports.assertRequestSupported = exports.UnsupportedModalityError = exports.withoutReasoningParts = exports.toParts = exports.textOf = exports.layoutOf = exports.hasStructuredParts = exports.hasReasoningParts = exports.base64ByteLength = exports.assistantMessageOf = exports.TaintedContentError = exports.textFreeReasoning = exports.sealReasoningText = exports.reasoningStoreResolver = exports.reasoningDigest = exports.openReasoningText = exports.readReasoningBounded = exports.readReasoning = exports.captureReasoning = exports.LLM_REASONING_CAPTURED = exports.LlmStreamError = exports.LlmResponseLimitError = exports.LlmResponseInvalidError = exports.LlmHttpError = void 0;
+exports.createLlmEffect = exports.collectStream = exports.assembleStream = exports.MalformedStreamError = exports.LLM_INTERRUPTED = void 0;
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "LlmHttpError", { enumerable: true, get: function () { return errors_1.LlmHttpError; } });
+Object.defineProperty(exports, "LlmResponseInvalidError", { enumerable: true, get: function () { return errors_1.LlmResponseInvalidError; } });
+Object.defineProperty(exports, "LlmResponseLimitError", { enumerable: true, get: function () { return errors_1.LlmResponseLimitError; } });
+Object.defineProperty(exports, "LlmStreamError", { enumerable: true, get: function () { return errors_1.LlmStreamError; } });
+var reasoning_1 = require("./reasoning");
+Object.defineProperty(exports, "LLM_REASONING_CAPTURED", { enumerable: true, get: function () { return reasoning_1.LLM_REASONING_CAPTURED; } });
+Object.defineProperty(exports, "captureReasoning", { enumerable: true, get: function () { return reasoning_1.captureReasoning; } });
+Object.defineProperty(exports, "readReasoning", { enumerable: true, get: function () { return reasoning_1.readReasoning; } });
+Object.defineProperty(exports, "readReasoningBounded", { enumerable: true, get: function () { return reasoning_1.readReasoningBounded; } });
+Object.defineProperty(exports, "openReasoningText", { enumerable: true, get: function () { return reasoning_1.openReasoningText; } });
+Object.defineProperty(exports, "reasoningDigest", { enumerable: true, get: function () { return reasoning_1.reasoningDigest; } });
+Object.defineProperty(exports, "reasoningStoreResolver", { enumerable: true, get: function () { return reasoning_1.reasoningStoreResolver; } });
+Object.defineProperty(exports, "sealReasoningText", { enumerable: true, get: function () { return reasoning_1.sealReasoningText; } });
+Object.defineProperty(exports, "textFreeReasoning", { enumerable: true, get: function () { return reasoning_1.textFreeReasoning; } });
+var parts_1 = require("./parts");
+Object.defineProperty(exports, "TaintedContentError", { enumerable: true, get: function () { return parts_1.TaintedContentError; } });
+Object.defineProperty(exports, "assistantMessageOf", { enumerable: true, get: function () { return parts_1.assistantMessageOf; } });
+Object.defineProperty(exports, "base64ByteLength", { enumerable: true, get: function () { return parts_1.base64ByteLength; } });
+Object.defineProperty(exports, "hasReasoningParts", { enumerable: true, get: function () { return parts_1.hasReasoningParts; } });
+Object.defineProperty(exports, "hasStructuredParts", { enumerable: true, get: function () { return parts_1.hasStructuredParts; } });
+Object.defineProperty(exports, "layoutOf", { enumerable: true, get: function () { return parts_1.layoutOf; } });
+Object.defineProperty(exports, "textOf", { enumerable: true, get: function () { return parts_1.textOf; } });
+Object.defineProperty(exports, "toParts", { enumerable: true, get: function () { return parts_1.toParts; } });
+Object.defineProperty(exports, "withoutReasoningParts", { enumerable: true, get: function () { return parts_1.withoutReasoningParts; } });
+var capabilities_1 = require("./capabilities");
+Object.defineProperty(exports, "UnsupportedModalityError", { enumerable: true, get: function () { return capabilities_1.UnsupportedModalityError; } });
+Object.defineProperty(exports, "assertRequestSupported", { enumerable: true, get: function () { return capabilities_1.assertRequestSupported; } });
+Object.defineProperty(exports, "capabilitiesForModel", { enumerable: true, get: function () { return capabilities_1.capabilitiesForModel; } });
+Object.defineProperty(exports, "mediaTypeAccepted", { enumerable: true, get: function () { return capabilities_1.mediaTypeAccepted; } });
+Object.defineProperty(exports, "requestMediaParts", { enumerable: true, get: function () { return capabilities_1.requestMediaParts; } });
+var resolveContent_1 = require("./resolveContent");
+Object.defineProperty(exports, "MAX_RESOLVED_BYTES", { enumerable: true, get: function () { return resolveContent_1.MAX_RESOLVED_BYTES; } });
+Object.defineProperty(exports, "UnresolvedContentError", { enumerable: true, get: function () { return resolveContent_1.UnresolvedContentError; } });
+Object.defineProperty(exports, "inlineData", { enumerable: true, get: function () { return resolveContent_1.inlineData; } });
+Object.defineProperty(exports, "resolveRequestContent", { enumerable: true, get: function () { return resolveContent_1.resolveRequestContent; } });
+var untrusted_1 = require("./untrusted");
+Object.defineProperty(exports, "InvalidLlmRequestError", { enumerable: true, get: function () { return untrusted_1.InvalidLlmRequestError; } });
+Object.defineProperty(exports, "MAX_INLINE_BYTES", { enumerable: true, get: function () { return untrusted_1.MAX_INLINE_BYTES; } });
+Object.defineProperty(exports, "MAX_INLINE_TOTAL_BYTES", { enumerable: true, get: function () { return untrusted_1.MAX_INLINE_TOTAL_BYTES; } });
+Object.defineProperty(exports, "TOOL_INPUT_NODE_CAP", { enumerable: true, get: function () { return untrusted_1.TOOL_INPUT_NODE_CAP; } });
+Object.defineProperty(exports, "OversizedInlinePartError", { enumerable: true, get: function () { return untrusted_1.OversizedInlinePartError; } });
+Object.defineProperty(exports, "UNTRUSTED_CONTENT_SYSTEM_NOTE", { enumerable: true, get: function () { return untrusted_1.UNTRUSTED_CONTENT_SYSTEM_NOTE; } });
+Object.defineProperty(exports, "UntrustedContentError", { enumerable: true, get: function () { return untrusted_1.UntrustedContentError; } });
+Object.defineProperty(exports, "exceedsNodeCap", { enumerable: true, get: function () { return untrusted_1.exceedsNodeCap; } });
+Object.defineProperty(exports, "fence", { enumerable: true, get: function () { return untrusted_1.fence; } });
+Object.defineProperty(exports, "fenceUntrustedMedia", { enumerable: true, get: function () { return untrusted_1.fenceUntrustedMedia; } });
+Object.defineProperty(exports, "guardRequest", { enumerable: true, get: function () { return untrusted_1.guardRequest; } });
+Object.defineProperty(exports, "stripUntrusted", { enumerable: true, get: function () { return untrusted_1.stripUntrusted; } });
+Object.defineProperty(exports, "untrustedFence", { enumerable: true, get: function () { return untrusted_1.untrustedFence; } });
+Object.defineProperty(exports, "validateMediaPart", { enumerable: true, get: function () { return untrusted_1.validateMediaPart; } });
+var AnthropicProvider_1 = require("./providers/AnthropicProvider");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return AnthropicProvider_1.AnthropicProvider; } });
+var OpenAiProvider_1 = require("./providers/OpenAiProvider");
+Object.defineProperty(exports, "OpenAiProvider", { enumerable: true, get: function () { return OpenAiProvider_1.OpenAiProvider; } });
+var GeminiProvider_1 = require("./providers/GeminiProvider");
+Object.defineProperty(exports, "GEMINI_CAPABILITIES", { enumerable: true, get: function () { return GeminiProvider_1.GEMINI_CAPABILITIES; } });
+Object.defineProperty(exports, "GEMINI_MEDIA_MODELS", { enumerable: true, get: function () { return GeminiProvider_1.GEMINI_MEDIA_MODELS; } });
+Object.defineProperty(exports, "GeminiProvider", { enumerable: true, get: function () { return GeminiProvider_1.GeminiProvider; } });
+var assembleStream_1 = require("./assembleStream");
+Object.defineProperty(exports, "LLM_INTERRUPTED", { enumerable: true, get: function () { return assembleStream_1.LLM_INTERRUPTED; } });
+Object.defineProperty(exports, "MalformedStreamError", { enumerable: true, get: function () { return assembleStream_1.MalformedStreamError; } });
+Object.defineProperty(exports, "assembleStream", { enumerable: true, get: function () { return assembleStream_1.assembleStream; } });
+Object.defineProperty(exports, "collectStream", { enumerable: true, get: function () { return assembleStream_1.collectStream; } });
+var createLlmEffect_1 = require("./createLlmEffect");
+Object.defineProperty(exports, "createLlmEffect", { enumerable: true, get: function () { return createLlmEffect_1.createLlmEffect; } });
+//# 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,mCAKkB;AAJhB,sGAAA,YAAY,OAAA;AACZ,iHAAA,uBAAuB,OAAA;AACvB,+GAAA,qBAAqB,OAAA;AACrB,wGAAA,cAAc,OAAA;AAkChB,yCAUqB;AATnB,mHAAA,sBAAsB,OAAA;AACtB,6GAAA,gBAAgB,OAAA;AAChB,0GAAA,aAAa,OAAA;AACb,iHAAA,oBAAoB,OAAA;AACpB,8GAAA,iBAAiB,OAAA;AACjB,4GAAA,eAAe,OAAA;AACf,mHAAA,sBAAsB,OAAA;AACtB,8GAAA,iBAAiB,OAAA;AACjB,8GAAA,iBAAiB,OAAA;AAwBnB,iCAUiB;AATf,4GAAA,mBAAmB,OAAA;AACnB,2GAAA,kBAAkB,OAAA;AAClB,yGAAA,gBAAgB,OAAA;AAChB,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,iGAAA,QAAQ,OAAA;AACR,+FAAA,MAAM,OAAA;AACN,gGAAA,OAAO,OAAA;AACP,8GAAA,qBAAqB,OAAA;AAGvB,+CAMwB;AALtB,wHAAA,wBAAwB,OAAA;AACxB,sHAAA,sBAAsB,OAAA;AACtB,oHAAA,oBAAoB,OAAA;AACpB,iHAAA,iBAAiB,OAAA;AACjB,iHAAA,iBAAiB,OAAA;AAGnB,mDAK0B;AAJxB,oHAAA,kBAAkB,OAAA;AAClB,wHAAA,sBAAsB,OAAA;AACtB,4GAAA,UAAU,OAAA;AACV,uHAAA,qBAAqB,OAAA;AAEvB,yCAeqB;AAdnB,mHAAA,sBAAsB,OAAA;AACtB,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,gHAAA,mBAAmB,OAAA;AACnB,qHAAA,wBAAwB,OAAA;AACxB,0HAAA,6BAA6B,OAAA;AAC7B,kHAAA,qBAAqB,OAAA;AACrB,2GAAA,cAAc,OAAA;AACd,kGAAA,KAAK,OAAA;AACL,gHAAA,mBAAmB,OAAA;AACnB,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,8GAAA,iBAAiB,OAAA;AAGnB,mEAAkE;AAAzD,sHAAA,iBAAiB,OAAA;AAE1B,6DAA4D;AAAnD,gHAAA,cAAc,OAAA;AAEvB,6DAIoC;AAHlC,qHAAA,mBAAmB,OAAA;AACnB,qHAAA,mBAAmB,OAAA;AACnB,gHAAA,cAAc,OAAA;AAGhB,mDAK0B;AAJxB,iHAAA,eAAe,OAAA;AACf,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AACd,+GAAA,aAAa,OAAA;AAOf,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}

package/dist/parts.d.ts

@@ -0,0 +1,220 @@
+import { type TaintedValue } from "@loomwork/classify";
+/**
+ * A claim-check for large bytes held in a content store (ADR 0046).
+ *
+ * Deliberately NOT the store's own `{ __loomContent }` marker: the resolving event
+ * store would substitute that marker with a JSON-decoded value on read, which is
+ * wrong for raw media bytes. This is an opaque address the caller resolves (see
+ * `CreateLlmEffectOptions.resolveContent`) at call time, so the log carries the
+ * address and never the bytes.
+ */
+export interface LlmContentRef {
+    /** The content address, e.g. `"sha256:<hex>"`. */
+    readonly address: string;
+    /** Byte length, informational. */
+    readonly size?: number;
+}
+/** Where a media part's bytes are. */
+export type LlmBinarySource = {
+    readonly kind: "ref";
+    readonly ref: LlmContentRef;
+}
+/** Small inline bytes, base64. Capped (see `MAX_INLINE_BYTES`) so the log never carries real media. */
+ | {
+    readonly kind: "data";
+    readonly data: string;
+};
+export interface LlmTextPart {
+    type: "text";
+    text: string;
+}
+/** Provenance for a media part whose bytes came from an untrusted party (see `guardRequest`). */
+export interface LlmUntrustedMark {
+    untrusted?: {
+        origin: string;
+    };
+}
+export interface LlmImagePart extends LlmUntrustedMark {
+    type: "image";
+    /** e.g. `image/png`. */
+    mediaType: string;
+    source: LlmBinarySource;
+}
+export interface LlmAudioPart extends LlmUntrustedMark {
+    type: "audio";
+    mediaType: string;
+    source: LlmBinarySource;
+}
+export interface LlmFilePart extends LlmUntrustedMark {
+    type: "file";
+    mediaType: string;
+    source: LlmBinarySource;
+    name?: string;
+}
+export type LlmMediaPart = LlmImagePart | LlmAudioPart | LlmFilePart;
+export type LlmModality = LlmMediaPart["type"];
+/** A tool call the model made (assistant messages only). */
+export interface LlmToolUsePart {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+    /** Provider-opaque continuation bytes that belong to this call (Gemini `thoughtSignature`). Sent back unchanged; never dropped with reasoning parts (ADR 0133 D5). */
+    signature?: string;
+}
+/**
+ * What the model returned as reasoning, in its RECORDED form (ADR 0133 D2): kind, provider,
+ * opaque signature, and a reference to the readable text in a sidecar store. Never readable text
+ * in a step value or a transcript. Assistant messages only.
+ */
+export interface LlmReasoningPart {
+    type: "reasoning";
+    kind: LlmReasoningKind;
+    /** The provider that produced it: a part is only sent back to this provider. */
+    provider: string;
+    signature?: string;
+    /** Where the text lives (sidecar store), when it was captured and is non-empty. */
+    textRef?: LlmContentRef;
+    /** SHA-256 hex of the text, so a resolved text can be checked. */
+    digest?: string;
+    /** The model returned readable text that was NOT kept (no store, or capture off). Such a part cannot be reproduced for continuation, so the drop rule (ADR 0133 D5) drops it. */
+    omitted?: true;
+    /**
+     * REQUEST-TIME ONLY: the readable text `resolveRequestContent` fetched from `textRef`, for the
+     * provider to map back unchanged. Never present on a recorded value.
+     */
+    text?: string;
+}
+/** What the provider returned. Never upgrade a `summary` to `text` (ADR 0133 D2). */
+export type LlmReasoningKind = "text" | "summary" | "redacted";
+/** Reasoning on a response, as the provider returned it. Lives only on `LlmResponse`, never in a step value. */
+export interface LlmReasoning {
+    kind: LlmReasoningKind;
+    /** Readable text; "" for an omitted-display block; absent for `redacted`. */
+    text?: string;
+    /** Provider-opaque continuation bytes (signature, redacted data). Never read by loom. */
+    signature?: string;
+    /** The provider that produced it (`"anthropic"`, `"gemini"`, ...): parts are only sent back to it. */
+    provider: string;
+}
+/** What a tool result may contain: text and media. */
+export type LlmResultPart = LlmTextPart | LlmMediaPart;
+/** The answer to a tool call (user messages only). */
+export interface LlmToolResultPart {
+    type: "tool_result";
+    /** The `id` of the `tool_use` this answers. */
+    toolUseId: string;
+    content: string | LlmResultPart[];
+    isError?: boolean;
+}
+export type LlmContentPart = LlmTextPart | LlmMediaPart | LlmToolUsePart | LlmToolResultPart | LlmReasoningPart;
+export type LlmMessageContent = string | LlmContentPart[];
+/** A content slot that may still carry provenance. */
+export type LlmContent = string | TaintedValue<string>;
+export interface LlmTextPartInput {
+    type: "text";
+    text: LlmContent;
+}
+/**
+ * A media part whose bytes came from an untrusted party. `untrusted` is the media
+ * analogue of `tainted()` on text: `guardRequest` refuses it outside a `user`
+ * message, refuses one that names a stored `ref`, and leaves the mark on the part; the provider
+ * mappers bracket it with the same fence tags as text (`fenceUntrustedMedia`) where their wire
+ * shape allows — the fence must travel with the media, which not every wire keeps in one message.
+ */
+export type LlmMediaPartInput = LlmMediaPart;
+export type LlmResultPartInput = LlmTextPartInput | LlmMediaPartInput;
+export interface LlmToolResultPartInput {
+    type: "tool_result";
+    toolUseId: string;
+    content: LlmContent | LlmResultPartInput[];
+    isError?: boolean;
+}
+export type LlmContentPartInput = LlmTextPartInput | LlmMediaPartInput | LlmToolUsePart | LlmToolResultPartInput | LlmReasoningPart;
+export type LlmMessageContentInput = LlmContent | LlmContentPartInput[];
+/** Normalise message content to its parts form (a string becomes one text part). */
+export declare function toParts(content: LlmMessageContent): LlmContentPart[];
+/**
+ * Thrown by {@link textOf} when handed a `tainted()` wrapper (`{ __loomTainted, value }`) instead
+ * of message content. A wrapper is neither a string nor parts; reading it as text would either
+ * crash obscurely or, worse, silently drop the provenance. The message never echoes the content.
+ */
+export declare class TaintedContentError extends Error {
+    /** The `origin` recorded when the content was tainted. */
+    readonly origin: string;
+    constructor(origin: string);
+}
+/**
+ * The text of a message: the string itself, or its text parts joined (including text
+ * inside `tool_result`s, which is what a text-only consumer wants to read). Media and
+ * `tool_use` parts contribute nothing.
+ *
+ * Throws {@link TaintedContentError} on a `tainted()` wrapper - at the top level, in a text part's
+ * `text`, or in a `tool_result`'s `content` (or its text parts): unwrap it on purpose first.
+ */
+export declare function textOf(content: LlmMessageContent): string;
+/** Whether a message carries any non-text part. */
+export declare function hasStructuredParts(content: LlmMessageContent): boolean;
+/**
+ * ADR 0133 D5 - where each block sat in the vendor's response, when that is NOT the canonical order
+ * (reasoning parts, then ONE text, then the tool calls). A provider whose signatures bind block
+ * order (Anthropic preserved thinking) needs the sequence back exactly: `thinking, text, tool_use,
+ * thinking, tool_use` must not become `thinking, thinking, text, tool_use, tool_use`.
+ *
+ * An entry is `"reasoning"` (the next recorded reasoning part), `{ call }` (the tool call with that
+ * id) or `{ text }` (the next `n` characters of the response's `content`). Positions only, no new
+ * content, so nothing readable is added to a step value.
+ */
+export type LlmLayoutEntry = "reasoning" | {
+    call: string;
+} | {
+    text: number;
+};
+/**
+ * The layout to record for a response, or `undefined` when none is needed: no reasoning (the shape
+ * stays exactly today's, G2) or the canonical order. Zero-length text blocks are dropped (a provider
+ * rejects an empty text block, so there is nothing to reproduce).
+ */
+export declare function layoutOf(entries: readonly LlmLayoutEntry[]): LlmLayoutEntry[] | undefined;
+/**
+ * The `assistant` message that records a model response — text (when any) then one
+ * `tool_use` part per call — so the next turn's `tool_result`s have something to
+ * answer. A response with neither text nor calls yields an empty text part rather than
+ * an empty array (providers reject empty content).
+ *
+ * With a `layout` (ADR 0133 D5) the parts come back in the vendor's own order, text blocks at their
+ * positions. A layout that does not fit the response (malformed, text lengths not summing to `content`,
+ * or a reasoning count that differs) drops every reasoning part rather than reorder them; a named call
+ * that is missing drops the reasoning parts after it; calls it does not name go at the end.
+ */
+export declare function assistantMessageOf(response: {
+    content: string;
+    toolCalls?: readonly {
+        id: string;
+        name: string;
+        input: unknown;
+        signature?: string;
+    }[];
+    /** ADR 0133 - recorded reasoning parts (`LlmReasoningPart`), carried first. Raw `LlmReasoning` is not accepted: readable text never enters a transcript. */
+    reasoning?: readonly object[];
+    /** ADR 0133 D5 - the vendor's block order, when not canonical. */
+    layout?: readonly LlmLayoutEntry[];
+}): {
+    role: "assistant";
+    content: LlmContentPart[];
+};
+/**
+ * ADR 0133 D5 - the same message without its `reasoning` parts (the edit-point drop). Returns the
+ * SAME object when it holds none, so callers can compare by identity; tool-call signatures are never
+ * touched. A message left empty keeps the shape `assistantMessageOf` gives an empty turn.
+ */
+export declare function withoutReasoningParts<M extends {
+    content: unknown;
+}>(message: M): M;
+/** Whether a message holds a `reasoning` part. */
+export declare function hasReasoningParts(message: {
+    content: unknown;
+}): boolean;
+/** Decoded byte length of a base64 string, or `undefined` if it is not valid base64. */
+export declare function base64ByteLength(data: string): number | undefined;
+//# sourceMappingURL=parts.d.ts.map

package/dist/parts.d.ts.map

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