@ixo/decision-oracle 0.0.0-stage → 0.2.0

package/dist/lib/facts/stock/unique.js

@@ -0,0 +1,327 @@
+/**
+ * The duplicate-detection resolver (dup-detection spec §3 — order is normative) — the stock
+ * producer's `unique` fact — detection lives in the oracle (docs/ENGINE-CONTRACT.md "Fact
+ * coverage + manifest"): canonicalize → register self FIRST → collect siblings → pHash the
+ * attachment lanes → score → gray-zone AI judge → score again with the judgements folded in.
+ * Runs once, inside the resolve phase; the returned `UniqueFact` freezes into the FactSet, the
+ * ENGINE's `decide()` branches on its `band` (and on `aiOutcome: "failed"` in the AI zone), and
+ * nothing about `unique` touches network/DB/AI after.
+ *
+ * NOT ported: the PDF-render lane (eval-engine's `pdf-render.ts`, Cloudflare Browser Run). The
+ * kit has no `browser` binding, so a PDF attachment registers with its CID only (`phash: null`) —
+ * the body-digest + CID lanes still catch a resubmitted PDF byte-for-byte; a re-exported one is
+ * caught only when its text answers match. `pdfPagesRendered`/`pdfsScreened` stay on the fact,
+ * always 0, so the engine's trace shape is the same as eval-engine's.
+ *
+ * Degrade-not-throw for evidence lanes (an unfetchable attachment, a garbage judge answer
+ * contribute nothing); fail LOUDLY for our own faults (missing HMAC key or DB) — a rule the owner
+ * declared must never silently not run.
+ */
+import { AppError } from "../../errors.js";
+import { base64Of } from "../../hash.js";
+import { fetchAttachmentBytes } from "../../ixo/attachments.js";
+import { EXONERATION_MAX_SAME_CONFIDENCE, judgeSameEvent, } from "./ai-unique.js";
+import { canonicalBody, hmacDigest, normalizeScalar } from "./normalize.js";
+import { phashImage } from "./phash.js";
+import { resolveFieldPath, rootQuestionName } from "./send.js";
+import { scoreUnique } from "./unique-score.js";
+import { registerAndFetchSiblings } from "./unique-store.js";
+/** The pHash lanes only decode what phash.ts can — same 10 MB guard as the AI inline lanes. */
+const MAX_PHASH_BYTES = 10 * 1024 * 1024;
+/** The cap for an image riding to the judge as base64 (ai-check.ts's MAX_AI_ATTACHMENT_BYTES). */
+const MAX_JUDGE_IMAGE_BYTES = 10 * 1024 * 1024;
+/** Judge evidence caps: ≤2 tagged images per claim per pair; the PRIOR side's re-fetch is
+ *  best-effort under a short per-image timeout — a miss degrades that pair to text-only. */
+const JUDGE_IMAGES_PER_CLAIM = 2;
+const JUDGE_IMAGE_TIMEOUT_MS = 5_000;
+/** Registry mediaTypes worth re-fetching for the judge (NULL = a row written without one ⇒ try it). */
+const JUDGE_IMAGE_TYPES = new Set(["image/png", "image/jpeg"]);
+/** The judge's provider spend, summed per run — the same dust-kill the ai transcripts' sum gets. */
+const round6 = (usd) => Math.round(usd * 1e6) / 1e6;
+/**
+ * The same-event judgements this claim already paid for, by candidate claimId. A retried evaluate
+ * step (the engine's INSUFFICIENT_CREDITS / RATE_LIMITED / UNAVAILABLE, up to eight times) rebuilds
+ * the unique lane, and every gray-zone pair was judged — and billed — again. A pair's verdict is a
+ * question about two fixed bodies (and their images), so it is cached per (claim, candidate) — and
+ * per work order, like every cache row (a repin judges again: its `unique` rule may differ) — in
+ * `fact_cache` (`unique-judge`) for the step's lifetime, like a connector's fact. Read BEFORE the
+ * pairs are built, so a cached pair never re-fetches its images either. The candidate SET is never
+ * cached: the registry is read fresh every time.
+ */
+async function cachedJudgements(deps, claimId) {
+    const cached = new Map();
+    for (const row of deps.factCache ? await deps.factCache.read(claimId) : []) {
+        if (row.kind === "unique-judge")
+            cached.set(row.name, row.fact);
+    }
+    return cached;
+}
+/**
+ * The judge over the pairs not in `cached`, the cache filled as it answers. Only a `valid` answer
+ * made on the evidence the pair was meant to carry is kept: an unavailable judge is asked again
+ * next attempt, and a pair `degraded` to text-only (its images could not be fetched) is judged
+ * again too — next time the images may arrive, and a text-only verdict must not stand in for one
+ * made with them. A hit makes no call, so it adds no `ai_calls` row and no spend; it keeps the
+ * `costUsd` its one paid call reported.
+ */
+async function judgePairs(deps, claimId, pairs, cached, degraded) {
+    const fresh = pairs.filter((p) => !cached.has(p.candidateClaimId));
+    if (fresh.length < pairs.length) {
+        deps.logger.info("unique.ai-judge.cache-hit", {
+            claimId,
+            cached: pairs.length - fresh.length,
+            fresh: fresh.length,
+        });
+    }
+    const judged = fresh.length > 0 ? await judgeSameEvent(deps, fresh, claimId) : [];
+    for (const j of judged) {
+        if (j.valid && !degraded.has(j.candidateClaimId)) {
+            await deps.factCache?.write(claimId, "unique-judge", j.candidateClaimId, j);
+        }
+    }
+    const byCandidate = new Map(judged.map((j) => [j.candidateClaimId, j]));
+    return pairs.flatMap((p) => {
+        const j = cached.get(p.candidateClaimId) ?? byCandidate.get(p.candidateClaimId);
+        return j ? [j] : [];
+    });
+}
+/** Only PNG/JPEG bytes can ride an `image_url` part. Sniffed even though the registry records a
+ *  mediaType, because that column may be NULL and the claim's own label is the submitter's word. */
+const sniffImageMime = (b) => b.length >= 4 && b[0] === 0x89 && b[1] === 0x50
+    ? "image/png"
+    : b.length >= 3 && b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff
+        ? "image/jpeg"
+        : null;
+/**
+ * The PRIOR claim's image evidence, re-fetched by CID from THIS claim's store (the registry stores
+ * the CID; `media.cidUrl` rebuilds the URL a bare CID resolves to there — for the bot, the same
+ * authenticated URL the claim body's `serviceEndpoint` carries, the file returned decrypted). A
+ * prior claim whose files live in a different store simply misses. Best-effort: ANY miss (no media
+ * store, HTTP failure, over-cap, non-image bytes) returns `ok: false` and the caller judges that
+ * pair TEXT-ONLY — half-tagged evidence would bias the judge, and a flaky store must never fail the
+ * evaluation.
+ */
+async function fetchJudgeImages(deps, cids) {
+    if (!deps.media)
+        return { ok: false, images: [] };
+    const images = [];
+    for (const cid of cids) {
+        const url = deps.media.cidUrl(cid);
+        const body = await fetchAttachmentBytes(deps, deps.media, url, MAX_JUDGE_IMAGE_BYTES, JUDGE_IMAGE_TIMEOUT_MS);
+        const mime = body.ok ? sniffImageMime(body.bytes) : null;
+        if (!body.ok || !mime)
+            return { ok: false, images: [] };
+        images.push(`data:${mime};base64,${base64Of(body.bytes)}`);
+    }
+    return { ok: true, images };
+}
+/**
+ * §6 hybrid identity key: one canonical value per `by` entry. Text components normalize the
+ * answer (dates at the entry's granularity); a file component's canonical value IS its
+ * attachment CID (sorted + joined when the question holds several). Whole-body mode instead
+ * digests the key-sorted canonical JSON (§4 L1) — the caller handles that branch.
+ */
+function identityParts(rule, body, attachments) {
+    return (rule.by ?? []).map((entry) => {
+        const ref = typeof entry === "string" ? entry : entry.ref;
+        const granularity = typeof entry === "string" ? undefined : entry.granularity;
+        const path = ref.startsWith("$") ? ref : `$${ref.replace(/^~/, "")}`;
+        const root = rootQuestionName(path);
+        const cids = attachments
+            .filter((a) => a.question === root && a.cid)
+            .map((a) => a.cid);
+        if (cids.length > 0)
+            return cids.sort().join(",");
+        return normalizeScalar(resolveFieldPath(body, path), granularity ? { granularity } : undefined);
+    });
+}
+/** The owner's field names behind `by` — for the L1 sentence only ("same Invoice"). */
+const keyFieldsOf = (rule) => rule.by?.map((e) => (typeof e === "string" ? e : e.ref).replace(/^[~$]/, ""));
+export async function resolveUnique(deps, input) {
+    const { rule } = input;
+    const key = deps.config.UNIQUE_HMAC_KEY;
+    if (!key)
+        throw AppError.internal("UNIQUE_HMAC_KEY not configured (required for unique rules)");
+    const db = deps.db;
+    if (!db)
+        throw AppError.internal("unique rule declared but ProducerDeps.db is not wired");
+    // §3.1 — canonicalize. The digest is the identity key when `by` is declared (that is what
+    // "unique by …" means), the whole canonical body otherwise.
+    const { canonical, normalizedText } = canonicalBody(input.body);
+    const digest = await hmacDigest(key, rule.by ? identityParts(rule, input.body, input.attachments) : [JSON.stringify(canonical)]);
+    // The attachment lanes (§4 L2/L4): every CID registers; images pHash directly; a PDF registers
+    // with no hash (header — no render lane here). The first two images double as the judge's
+    // NEW-claim evidence — bytes already in hand. Each self hash carries the media type it came
+    // from: scoring's distance tiers differ for a rendered document and a photo, and the pool rows
+    // carry the same tag from the registry.
+    const selfPhashes = [];
+    const selfJudgeImages = [];
+    const registryAttachments = [];
+    if (rule.attachments) {
+        for (const att of input.attachments) {
+            if (!att.cid)
+                continue;
+            const mime = (att.mediaType.split(";")[0] ?? "").trim().toLowerCase();
+            let phash = null;
+            if (mime === "image/jpeg" || mime === "image/png") {
+                const bytes = await fetchAttachmentBytes(deps, deps.media, att.url, MAX_PHASH_BYTES);
+                if (bytes.ok) {
+                    phash = phashImage(bytes.bytes, mime);
+                    if (selfJudgeImages.length < JUDGE_IMAGES_PER_CLAIM &&
+                        bytes.bytes.length <= MAX_JUDGE_IMAGE_BYTES) {
+                        selfJudgeImages.push(`data:${mime};base64,${base64Of(bytes.bytes)}`);
+                    }
+                }
+            }
+            if (phash)
+                selfPhashes.push({ phash, mediaType: mime });
+            registryAttachments.push({ cid: att.cid, phash, mediaType: mime || null });
+        }
+    }
+    // §3.2/§3.3 — insert self FIRST, then read candidates (the race guard lives in the store).
+    const siblings = await registerAndFetchSiblings(db, {
+        collectionId: input.collectionId,
+        claimId: input.claimId,
+        agentAddress: input.agentAddress,
+        digest,
+        normalizedText,
+        attachments: registryAttachments,
+        countPrior: rule.countPrior,
+    });
+    const keyFields = keyFieldsOf(rule);
+    const scoreInput = {
+        ruleId: rule.id,
+        digest,
+        agentAddress: input.agentAddress,
+        siblings,
+        selfPhashes,
+        // Candidate-side identity/residual splits aren't in the registry (it stores whole-text
+        // only), so the §4 L3 quadrant runs on the store's whole-text similarity — and MUST stay
+        // that way for repetitive collections (spec §15.0's anti-recommendation).
+        identity: undefined,
+        trigramSim: () => null,
+        thresholds: rule.thresholds,
+        // The owner's field names, for the L1 sentence only ("same Invoice" beats "identical canonical
+        // body", which described the wrong thing entirely whenever `by` was declared).
+        ...(keyFields ? { keyFields } : {}),
+    };
+    let fact = scoreUnique(scoreInput);
+    // §7 — the gray-zone judge, only when ALL of these hold: the rule's ai.enabled AND the oracle's
+    // own `allowAiChecks` policy (a disabled lane is the operator's informed opt-out, like the
+    // rubric's `enabled: false` — `aiOutcome: "skipped"`, never a fail-closed "failed"); nothing
+    // already at reject band; a candidate worth judging (the near-text lane is ≥ 0.5 by
+    // construction AND carries the stored body the prompt needs); capped at maxPairs (the store
+    // returns sims descending). The gate's outcome always freezes as `aiOutcome` (the engine fails
+    // the pass band closed on "failed"), and judged pairs carry TAGGED image evidence: the NEW
+    // claim's images fetched above, the PRIOR claim's re-fetched by registry CID — a miss degrades
+    // that pair to text-only.
+    let aiOutcome = "skipped";
+    if (rule.ai.enabled && !deps.settings.allowAiChecks) {
+        deps.logger.info("unique.ai-judge.disabled", { claimId: input.claimId, reason: "policy" });
+    }
+    if (rule.ai.enabled &&
+        deps.settings.allowAiChecks &&
+        fact.scoreBps < rule.thresholds.rejectAtBps) {
+        const shortlisted = siblings.trigram
+            .filter((t) => typeof t.normalizedText === "string" && t.normalizedText.length > 0)
+            .slice(0, rule.ai.maxPairs);
+        if (shortlisted.length > 0) {
+            // The PRIOR side's image cids ride the registry rows already in hand (cid-reuse hits + the
+            // pHash pool) — never an extra registry read; ≤2 per side, like the self images. Rows the
+            // vision lane provably can't take (a PDF) are skipped rather than fetched and rejected by
+            // the sniff.
+            const priorCidsOf = (claimId) => {
+                const cids = [];
+                for (const row of [...siblings.cidHits, ...siblings.phashPool]) {
+                    const judgeable = !row.mediaType || JUDGE_IMAGE_TYPES.has(row.mediaType);
+                    if (row.claimId === claimId && judgeable && !cids.includes(row.cid))
+                        cids.push(row.cid);
+                }
+                return cids.slice(0, JUDGE_IMAGES_PER_CLAIM);
+            };
+            const cached = await cachedJudgements(deps, input.claimId);
+            const degraded = new Set();
+            const pairs = [];
+            for (const t of shortlisted) {
+                const pair = {
+                    candidateClaimId: t.claimId,
+                    selfBody: normalizedText,
+                    candidateBody: t.normalizedText,
+                };
+                // Image evidence rides the same opt-in as every attachment lane (`unique.attachments`) —
+                // and is fetched only for a pair the judge will actually be asked about.
+                if (rule.attachments && !cached.has(t.claimId)) {
+                    const cids = priorCidsOf(t.claimId);
+                    const prior = cids.length > 0 ? await fetchJudgeImages(deps, cids) : { ok: true, images: [] };
+                    if (!prior.ok) {
+                        // Text-only for the WHOLE pair (self images withheld too — half-tagged evidence
+                        // would bias the judge toward "different"); recorded on the fact, never thrown.
+                        degraded.add(t.claimId);
+                        deps.logger.warn("unique.ai-judge.images-degraded", {
+                            claimId: input.claimId,
+                            candidateClaimId: t.claimId,
+                        });
+                    }
+                    else {
+                        if (selfJudgeImages.length > 0)
+                            pair.selfImages = selfJudgeImages;
+                        if (prior.images.length > 0)
+                            pair.candidateImages = prior.images;
+                    }
+                }
+                pairs.push(pair);
+            }
+            const judged = await judgePairs(deps, input.claimId, pairs, cached, degraded);
+            // §15.2 — "confidently different" clears that pair's TEXT-similarity component only, and only
+            // in the review band (unique-score.ts owns both bounds). `valid` is the fail-closed guard: an
+            // unavailable judge (which is what makes aiOutcome "failed") can never exonerate anything.
+            const exonerated = new Set(judged
+                .filter((j) => j.valid && !j.sameEvent && j.rawConfidence <= EXONERATION_MAX_SAME_CONFIDENCE)
+                .map((j) => j.candidateClaimId));
+            fact = {
+                ...scoreUnique({
+                    ...scoreInput,
+                    exonerated,
+                    ai: judged.map((j) => ({
+                        candidateClaimId: j.candidateClaimId,
+                        confidence: j.confidence,
+                    })),
+                }),
+                // Provider spend rides the frozen fact when the provider said it at call time (OpenRouter);
+                // the gateway's arrives later, into `ai_calls` — omitted here, never a fake zero.
+                ...(judged.some((j) => j.costUsd !== null)
+                    ? { aiCostUsd: round6(judged.reduce((sum, j) => sum + (j.costUsd ?? 0), 0)) }
+                    : {}),
+                aiPairs: judged.map((j) => ({
+                    candidateClaimId: j.candidateClaimId,
+                    valid: j.valid,
+                    confidence: j.confidence,
+                    ...(degraded.has(j.candidateClaimId) ? { pairDegradedToText: true } : {}),
+                })),
+            };
+            // flagged ⟺ an ai component recorded (unique-score owns the 0.7 floor); a parsed
+            // sameEvent:false is a VALID judgement (cleared); zero valid responses means the
+            // adjudicator was UNAVAILABLE (failed) — never conflate the two.
+            aiOutcome = judged.every((j) => !j.valid)
+                ? "failed"
+                : fact.components.some((c) => c.kind === "ai_same_event")
+                    ? "flagged"
+                    : "cleared";
+        }
+    }
+    deps.logger.info("unique.resolved", {
+        claimId: input.claimId,
+        collectionId: input.collectionId,
+        ruleId: rule.id,
+        scoreBps: fact.scoreBps,
+        band: fact.band,
+        winner: fact.winner
+            ? { kind: fact.winner.kind, candidateClaimId: fact.winner.candidateClaimId }
+            : null,
+        candidates: fact.candidates.length,
+        aiOutcome,
+    });
+    // The render counters ride the fact for the engine's trace shape — always 0 here (header).
+    return { ...fact, aiOutcome, pdfPagesRendered: 0, pdfsScreened: 0 };
+}
+//# sourceMappingURL=unique.js.map

package/dist/lib/facts/stock/unique.js.map

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

package/dist/lib/facts/tools.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `FactTools` — the kit's machinery handed to every handler, built per fact — plus the stock lanes
+ * and the ONE wiring both the stock producer and a provider's `defineFacts({...})` run through
+ * (`producerOf`). This is where the runner's abstract deps meet the runtime: it is the only module
+ * that turns a `FactTarget` into real HTTP, a real UCAN signature, a real model call.
+ *
+ * WORKERS-ONLY, deliberately: it reaches the UCAN signer, the C2PA WASM, the D1 registries and the
+ * engine client, none of which load in plain node. The `./facts` subpath (src/facts/*) and the
+ * runner must never import it — they take `tools` and `stock` as deps for exactly that reason, and
+ * `bun run test:node` is the tripwire. The import direction is: stock/index.ts, define-oracle.ts
+ * and builder.ts import THIS; nothing here imports them back.
+ *
+ * The tools are built per fact so `stock()` can mean "the stock lane for THIS fact": a handler
+ * wraps its own source or check (`const base = await tools.stock()`), falls back to it, or ignores
+ * it. Everything else is target-independent — the same batteries whichever fact is asking.
+ */
+import type { FactsConfig, FactTools } from "../../facts/types.js";
+import type { Agreement, Manifest } from "../engine/types.js";
+import type { PulledClaim } from "../ixo/index.js";
+import type { FactsProducer, ProducerDeps } from "./producer.js";
+import { type FactTarget, type StockLanes } from "./runner.js";
+/**
+ * The four stock lanes as handlers — thin adapters from the runner's input to each connector
+ * (stock/). `~derived` refs are the one thing they cannot answer: the ENGINE computes derived
+ * values, so a source or check naming one is an `error` fact, never a guess. A custom handler gets
+ * the refs as `input.unresolved` and may compute them from `manifest.derived`.
+ */
+export declare function stockLanes(pdeps: ProducerDeps): StockLanes;
+/**
+ * The ONE agreement read of a build, keyed by the counterparty actually asked for. Held by
+ * `producerOf` for the whole claim and handed to every fact's tools, so two handlers that both need
+ * the buyer statement cost one engine round trip AND — the part that matters — judge against the
+ * SAME snapshot, which is the one the engine records on its receipt. Never a handler-private cache:
+ * the runner's fact cache is still the only place an ANSWER is kept.
+ */
+export type AgreementCache = Map<string | null, Promise<Agreement | null>>;
+/** The tools for ONE fact — `stock()` is that fact's lane; the rest is the kit's machinery. */
+export declare function realTools(target: FactTarget, claim: PulledClaim, manifest: Manifest, pdeps: ProducerDeps, stock: StockLanes, 
+/** The build's shared agreement read (`producerOf`). Omitted ⇒ this fact's own, for a caller
+ *  building tools outside a producer run. */
+agreements?: AgreementCache): FactTools;
+/**
+ * The ONE producer wiring: a `defineFacts({...})` table (or nothing at all) becomes a producer that
+ * runs the runner with the real tools and the stock lanes as every unlisted name's default; a
+ * whole-producer function is returned untouched. Both `defineOracle({ facts })` (define-oracle.ts)
+ * and the stock producer (stock/index.ts) come through here, which is what makes the runner's
+ * guarantees identical for a provider's handler and for the stock lane.
+ */
+export declare function producerOf(facts?: FactsConfig | FactsProducer, 
+/**
+ * Per-lane replacements for the STOCK defaults — what an unlisted name (and `tools.stock()`) runs
+ * instead. The oracle itself never passes any; the CLI's dry run (`facts run`) does, for the one
+ * lane it cannot honestly run off a laptop: `unique` reads this oracle's D1 registries. A
+ * whole-producer function ignores them — it owns its own wiring.
+ */
+stockOverrides?: Partial<StockLanes>): FactsProducer;
+//# sourceMappingURL=tools.d.ts.map

package/dist/lib/facts/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/lib/facts/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAGV,WAAW,EACX,SAAS,EAGV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAM1C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAGL,KAAK,UAAU,EAKf,KAAK,UAAU,EAChB,MAAM,UAAU,CAAC;AAgClB;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAkD1D;AAYD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;AAE3E,+FAA+F;AAC/F,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU;AACjB;6CAC6C;AAC7C,UAAU,GAAE,cAA0B,GACrC,SAAS,CAiNX;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,CAAC,EAAE,WAAW,GAAG,aAAa;AACnC;;;;;GAKG;AACH,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GACnC,aAAa,CAoBf"}