@ixo/decision-oracle 0.0.0-stage → 0.2.0

package/dist/lib/facts/stock/ai-inputs.d.ts.map

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

package/dist/lib/facts/stock/ai-inputs.js

@@ -0,0 +1,332 @@
+/**
+ * AI check input lanes (evaluator-spec §6.1) — one attachment → the block(s) the model can read.
+ *
+ * OpenRouter's `file` content type is the PDF lane ("Images: image_url, PDFs: file content type
+ * with PDF data"), so everything that used to ride it — HTML, ZIP, source — was undocumented
+ * territory: a 400 or a mangled parse, i.e. `onError` review on every claim. Here each attachment is
+ * routed by mediaType (then filename extension, then sniffed magic) to a lane the model actually
+ * supports, and **nothing is ever silently dropped**: a file nothing can read still arrives as a
+ * labelled descriptor, so a rule that needed to read it fails honestly instead of judging an input
+ * it never saw.
+ *
+ * Every lane produces a `sent` input and its transcript twin: the twin carries `cid:…;sha256:…`
+ * refs and the archive's tree, never base64 and never source text (§3 — the bytes are already
+ * content-addressed in Matrix, and one rubric can send the same deliverable to five checks).
+ */
+import { base64Of, sha256Hex } from "../../hash.js";
+import { ARCHIVE_LIMITS, expandArchive, looksLikeZip } from "./archive.js";
+/** Source/text extensions we inline when the mediaType is useless (`application/octet-stream`). */
+const TEXT_EXT = new Set([
+    "astro",
+    "cfg",
+    "cjs",
+    "conf",
+    "css",
+    "csv",
+    "env",
+    "graphql",
+    "htm",
+    "html",
+    "ini",
+    "js",
+    "json",
+    "jsonc",
+    "jsx",
+    "less",
+    "lock",
+    "log",
+    "markdown",
+    "md",
+    "mjs",
+    "properties",
+    "py",
+    "sass",
+    "scss",
+    "sh",
+    "sql",
+    "svelte",
+    "svg",
+    "toml",
+    "ts",
+    "tsv",
+    "tsx",
+    "txt",
+    "vue",
+    "xml",
+    "yaml",
+    "yml",
+]);
+const extOf = (name) => {
+    const base = name.slice(name.lastIndexOf("/") + 1);
+    const dot = base.lastIndexOf(".");
+    return dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
+};
+/**
+ * Which lane an attachment takes. `image/svg+xml` is deliberately NOT the image lane — vision
+ * models don't rasterise SVG, and as text it is exactly the markup a rule wants to read.
+ */
+export function planLane(mediaType, filename) {
+    const type = mediaType.toLowerCase();
+    const ext = extOf(filename);
+    if (type === "image/svg+xml" || ext === "svg")
+        return "text";
+    if (type.startsWith("image/"))
+        return "image";
+    if (type === "application/pdf" || ext === "pdf")
+        return "pdf";
+    if (type.startsWith("video/"))
+        return "video";
+    if (type.startsWith("audio/"))
+        return "audio";
+    if (type === "application/zip" || type === "application/x-zip-compressed" || ext === "zip") {
+        return "archive";
+    }
+    if (type.startsWith("text/") ||
+        type === "application/json" ||
+        type === "application/xml" ||
+        type === "application/javascript" ||
+        type === "application/x-javascript" ||
+        type === "application/typescript" ||
+        type.endsWith("+json") ||
+        type.endsWith("+xml")) {
+        return "text";
+    }
+    return TEXT_EXT.has(ext) ? "text" : "opaque";
+}
+/**
+ * Lanes that cannot use a URL: the engine must read the bytes itself. Video is here because Gemini
+ * on AI Studio accepts only YouTube links as video URLs — a Matrix media URL silently fails, so
+ * video and audio are always inlined.
+ */
+export function laneNeedsBytes(lane) {
+    return (lane === "text" ||
+        lane === "archive" ||
+        lane === "opaque" ||
+        lane === "video" ||
+        lane === "audio");
+}
+/** Lanes that ride to OpenRouter as base64 — they answer to the tighter attachment cap (§6.1). */
+export function laneIsInlined(lane) {
+    return lane === "image" || lane === "pdf" || lane === "video" || lane === "audio";
+}
+/** Refine the lane once bytes are in hand — `application/octet-stream` is the common claim case. */
+export function sniffLane(lane, bytes) {
+    if (looksLikeZip(bytes))
+        return "archive";
+    if (lane !== "opaque")
+        return lane;
+    if (bytes.length >= 5 &&
+        bytes[0] === 0x25 &&
+        bytes[1] === 0x50 &&
+        bytes[2] === 0x44 &&
+        bytes[3] === 0x46) {
+        return "pdf"; // %PDF
+    }
+    if (bytes.length >= 4 && bytes[0] === 0x89 && bytes[1] === 0x50)
+        return "image"; // PNG
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return "image";
+    try {
+        new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(bytes.subarray(0, Math.min(bytes.length, 4096)));
+        return "text";
+    }
+    catch {
+        return "opaque";
+    }
+}
+/** Grouped digits without `Intl` — locale-independent, so the trace stays byte-deterministic. */
+export const fmtBytes = (n) => n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+const short = (hash) => `${hash.slice(0, 8)}…`;
+/** One attachment → the input the model sees plus the twin the trace keeps. */
+export async function renderAttachmentInput(args) {
+    const { attachment: att, bytes, notSent } = args;
+    const filename = att.name;
+    const mediaType = att.mediaType;
+    // The lanes that read the file themselves have nothing to show without bytes — never let that
+    // become a thrown TypeError inside the workflow; it is just another "we couldn't send it".
+    const starved = !bytes && (args.lane === "archive" || args.lane === "text");
+    if (notSent || args.lane === "opaque" || starved) {
+        const size = bytes?.length ?? att.size;
+        const hash = bytes ? await sha256Hex(bytes) : null;
+        const parts = [
+            size !== undefined ? `${fmtBytes(size)} B` : null,
+            hash ? `sha256 ${short(hash)}` : null,
+            `content not sent: ${notSent ?? (starved ? "bytes unavailable" : "unsupported file type")}`,
+        ].filter((p) => p !== null);
+        const summary = parts.join(", ");
+        const descriptor = { kind: "descriptor", filename, mediaType, summary };
+        return {
+            sent: descriptor,
+            recorded: {
+                kind: "descriptor",
+                filename,
+                mediaType,
+                summary: hash ? summary.replace(short(hash), hash) : summary,
+            },
+        };
+    }
+    // Bytes we had to read ourselves ride as base64/text; the transcript twin gets the CID + hash.
+    const ref = bytes ? `cid:${att.cid ?? "unknown"};sha256:${await sha256Hex(bytes)}` : att.url;
+    const dataUrl = bytes ? `data:${mediaType};base64,${base64Of(bytes)}` : att.url;
+    switch (args.lane) {
+        case "image":
+            return {
+                sent: { kind: "image", url: dataUrl, detail: args.imageDetail, filename, mediaType },
+                recorded: { kind: "image", url: ref, detail: args.imageDetail, filename, mediaType },
+            };
+        case "pdf":
+            return {
+                sent: { kind: "file", filename, url: dataUrl, mediaType },
+                recorded: { kind: "file", filename, url: ref, mediaType },
+            };
+        case "video":
+            return {
+                sent: { kind: "video", filename, url: dataUrl, mediaType },
+                recorded: { kind: "video", filename, url: ref, mediaType },
+            };
+        case "audio": {
+            const format = mediaType.slice(mediaType.indexOf("/") + 1).replace("mpeg", "mp3");
+            return {
+                sent: { kind: "audio", filename, mediaType, format, data: bytes ? base64Of(bytes) : "" },
+                recorded: { kind: "audio", filename, mediaType, format, data: ref },
+            };
+        }
+        case "archive":
+            return renderArchive(filename, mediaType, bytes);
+        default:
+            return renderTextFile(filename, mediaType, bytes);
+    }
+}
+/** A text deliverable (HTML, markdown, source) — decoded, not shoved down the PDF lane. */
+async function renderTextFile(filename, mediaType, bytes) {
+    const hash = await sha256Hex(bytes);
+    let text;
+    try {
+        text = new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(bytes);
+    }
+    catch {
+        const summary = `${fmtBytes(bytes.length)} B, sha256 ${hash}, content not sent: not valid UTF-8 text`;
+        return {
+            sent: {
+                kind: "descriptor",
+                filename,
+                mediaType,
+                summary: summary.replace(hash, short(hash)),
+            },
+            recorded: { kind: "descriptor", filename, mediaType, summary },
+        };
+    }
+    // Same ceiling as an archive's whole text budget — one deliverable can't cost more than a tree.
+    const cap = ARCHIVE_LIMITS.maxTextBytesTotal;
+    const truncated = text.length > cap;
+    const shown = truncated ? text.slice(0, cap) : text;
+    const summary = [
+        `${fmtBytes(bytes.length)} B`,
+        `sha256 ${short(hash)}`,
+        truncated ? `truncated: first ${fmtBytes(cap)} of ${fmtBytes(text.length)} chars` : null,
+    ]
+        .filter((p) => p !== null)
+        .join(", ");
+    return {
+        sent: { kind: "textFile", filename, mediaType, summary, text: shown },
+        // Ledger hygiene (§3): the identity and hash, never the content — it is already in Matrix.
+        recorded: {
+            kind: "descriptor",
+            filename,
+            mediaType,
+            summary: `${fmtBytes(bytes.length)} B, sha256 ${hash}, sent as text${truncated ? " (truncated)" : ""}`,
+        },
+    };
+}
+/** ZIP → descriptor + complete tree + the members we chose to show (§6.1). */
+async function renderArchive(filename, mediaType, bytes) {
+    const hash = await sha256Hex(bytes);
+    const expansion = await expandArchive(bytes);
+    const summaryOf = (h) => [
+        `${fmtBytes(bytes.length)} B`,
+        `sha256 ${h}`,
+        `entries: ${expansion.entries.length}${expansion.treeTruncated ? "+" : ""}`,
+        `uncompressed: ${fmtBytes(expansion.uncompressed)} B`,
+        `status: ${expansion.status}${expansion.detail ? ` (${expansion.detail})` : ""}`,
+    ].join(", ");
+    return {
+        sent: {
+            kind: "archive",
+            filename,
+            mediaType,
+            summary: summaryOf(short(hash)),
+            body: renderArchiveBody(expansion, true),
+        },
+        recorded: {
+            kind: "archive",
+            filename,
+            mediaType,
+            summary: summaryOf(hash),
+            // The tree + per-member sha256 IS the audit record; the source itself stays in Matrix.
+            body: renderArchiveBody(expansion, false),
+        },
+    };
+}
+function renderArchiveBody(expansion, withContents) {
+    if (expansion.entries.length === 0)
+        return "(no entries could be listed)";
+    const width = Math.min(64, expansion.entries.reduce((w, e) => Math.max(w, e.path.length), 0));
+    const header = expansion.treeTruncated
+        ? `FILE TREE (TRUNCATED at ${expansion.entries.length} entries — the archive holds more)`
+        : "FILE TREE (complete — a file not listed here is not in the archive)";
+    const rows = expansion.entries.map((e) => {
+        const size = `${fmtBytes(e.size)} B`.padStart(14);
+        const note = e.note ?? "sent";
+        const hash = withContents || e.sha256 === null ? "" : `   sha256 ${e.sha256}`;
+        return `  ${e.path.padEnd(width)}${size}   ${note}${hash}`;
+    });
+    const out = [header, ...rows];
+    if (withContents) {
+        const files = expansion.entries.filter((e) => e.text !== null);
+        if (files.length > 0) {
+            out.push("", "FILES");
+            for (const f of files) {
+                out.push(`--- BEGIN ${f.path} (${fmtBytes(f.size)} B, sha256 ${short(f.sha256)}) ---`, f.text, `--- END ${f.path} ---`);
+            }
+        }
+    }
+    return out.join("\n");
+}
+/** `[INPUT n: …]` — the label a rule targets ("If a rule names an input that was not provided…"). */
+export function labelOf(part, n) {
+    const head = (kind, filename, mediaType, tail) => `[INPUT ${n}: ${kind} — filename: ${JSON.stringify(filename)}, type: ${mediaType}${tail ? `, ${tail}` : ""}]`;
+    switch (part.kind) {
+        case "text":
+            return `[INPUT ${n}: text]`;
+        case "archive":
+            return head("archive", part.filename, part.mediaType, part.summary);
+        case "textFile":
+        case "descriptor":
+            return head("file", part.filename, part.mediaType, part.summary);
+        default:
+            return head(part.kind, part.filename, part.mediaType);
+    }
+}
+/** The OpenRouter content block(s) that follow an input's label. */
+export function blocksOf(part) {
+    switch (part.kind) {
+        case "text":
+            return [{ type: "text", text: part.text }];
+        case "image":
+            return [{ type: "image_url", image_url: { url: part.url, detail: part.detail } }];
+        case "file":
+            return [{ type: "file", file: { filename: part.filename, file_data: part.url } }];
+        case "video":
+            return [{ type: "video_url", video_url: { url: part.url } }];
+        case "audio":
+            return [{ type: "input_audio", input_audio: { data: part.data, format: part.format } }];
+        case "textFile":
+            return [{ type: "text", text: part.text }];
+        case "archive":
+            return [{ type: "text", text: part.body }];
+        // A descriptor's label already says everything there is to say about the file.
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=ai-inputs.js.map

package/dist/lib/facts/stock/ai-inputs.js.map

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

package/dist/lib/facts/stock/ai-provider.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The AI provider seam (spec 2026-10-02 §4) — the ONE place that knows two providers exist. Both
+ * AI lanes (ai-check.ts `judgeWithModel`, ai-unique.ts `judgePair`) build their request in the
+ * chat-completions content shape they always had and hand it here:
+ *
+ * - `openrouter` — that request byte for byte (`provider.sort`, `usage.include`, the PDF
+ *   `file-parser` plugin pinned `native`), POSTed by the caller's fetch.
+ * - `cloudflare` — the same content in the Responses format (every OpenAI model on the gateway
+ *   takes it; some, like `gpt-5.6-luna`, take nothing else), sent through the `AI` binding's `gateway(id).run()` on the
+ *   `compat` route. Unlike `env.AI.run()`, it hands back the raw Response, whose `cf-aig-log-id`
+ *   header is THIS call's log id — the key the cost backfill (cron/ai-cost.ts) reads USD from.
+ *   Answers never sit in the gateway's logs (`collect-log-payload: false`), and no claim is served
+ *   another's cached verdict (`skip-cache`).
+ */
+import type { Config } from "../../../config.js";
+import type { OracleEnv } from "../../../env.js";
+import type { Transport } from "../../http/client.js";
+import { type AlertDeps } from "../../sentry.js";
+import type { AiCall, AiSpend } from "../producer.js";
+export declare const OPENROUTER_ENDPOINT = "https://openrouter.ai/api/v1/chat/completions";
+export type AiProvider = Config["AI_PROVIDER"];
+/** One structured model call, in the lanes' native (chat-completions) content shape. */
+export interface ModelCall {
+    model: string;
+    /** The static prefix — first, so the provider's prompt cache hits across checks. */
+    system: string;
+    /** The user message: a plain string or chat-completions content blocks. */
+    user: string | unknown[];
+    /** Strict JSON-schema output. */
+    schema: {
+        name: string;
+        schema: Record<string, unknown>;
+    };
+    /** Ids only — the gateway log's metadata and the OpenRouter idempotency key. */
+    tag: {
+        claimId: string;
+        fact: string;
+    };
+    /** OpenRouter: send `idempotency-key: <claimId>:<fact>` (the AI check does; the judge never did). */
+    idempotent?: boolean;
+}
+export interface CallUsage {
+    promptTokens: number;
+    completionTokens: number;
+    cachedTokens: number;
+    /** OpenRouter reports it; the gateway does not (null — backfilled from its log). */
+    costUsd: number | null;
+}
+export interface PreparedCall {
+    provider: AiProvider;
+    /** What the transcript records as the endpoint. */
+    url: string;
+    body: Record<string, unknown>;
+    /** Transcript-safe but `authorization` (call.ts `redactHeaders` strips it). */
+    headers: Record<string, string>;
+    /** Set for `cloudflare`: the binding call (fetchClient's `send`). Unset ⇒ POST `url` with fetch. */
+    send?: Transport;
+    /** The answered attempt's id: OpenRouter's generation id, else the gateway log id. */
+    callId(parsed: unknown): string | null;
+    /** Every billed attempt's id (the answered one included) — what the cost ledger needs. */
+    callIds(parsed: unknown): string[];
+    content(parsed: unknown): string | null;
+    usage(parsed: unknown): CallUsage | null;
+}
+/** Missing provider pieces are loud (the step retries), never a verdict — checked before any byte is read. */
+export declare function assertAiProvider(deps: {
+    config: Config;
+    env?: OracleEnv;
+}): void;
+/** The endpoint a transcript names when no call was made (a policy gate, an unfetchable file). */
+export declare const aiEndpointOf: (config: Config) => string;
+/** Chat-completions content → Responses content. Audio and video never get here (config.ts refinement). */
+export declare function toResponsesContent(user: string | unknown[]): unknown[];
+export declare function prepareModelCall(deps: {
+    config: Config;
+    env?: OracleEnv;
+}, call: ModelCall): PreparedCall;
+/**
+ * The spend, whatever the verdict (a failed parse was still billed): tokens always, USD when the
+ * provider said it (micro-USD so the sum stays an integer), and a ledger row for a gateway call
+ * whose USD arrives later (cron/ai-cost.ts). No log id ⇒ no row — there is nothing to look up.
+ */
+export declare function recordSpend(deps: {
+    aiSpend?: AiSpend;
+    aiCalls?: AiCall[];
+}, r: {
+    provider: AiProvider;
+    model: string;
+    fact: string;
+    /** The answered attempt's id — its tokens are the `usage` below. */
+    callId: string | null;
+    /** Every billed attempt's id (PreparedCall.callIds). */
+    callIds: string[];
+    usage: CallUsage | null;
+}): void;
+/** The gateway's "load more credits" refusal, wherever it surfaced (a body or a thrown error). */
+export declare const creditsExhausted: (seen: unknown) => boolean;
+/**
+ * Out of credits is a person's job (top up the account): one deduped page, whichever AI lane saw
+ * it. The calls themselves already went to their fail-closed path — this only tells someone.
+ */
+export declare function alertIfCreditsExhausted(deps: AlertDeps & {
+    config: Config;
+}, provider: AiProvider, ...seen: unknown[]): Promise<void>;
+//# sourceMappingURL=ai-provider.d.ts.map

package/dist/lib/facts/stock/ai-provider.d.ts.map

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