@ixo/decision-oracle 0.0.0-stage → 0.2.1

package/dist/testing/fake-tools.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `fakeTools()` — the kit's machinery (facts/types.ts `FactTools`) with every lane answered from a
+ * literal instead of the network: canned HTTP by URL, a judge that says yes, no C2PA, no buyer
+ * statement, and a logger that collects into `logs` so a test can assert on what a handler said.
+ * Every default is the BORING one, so a test only spells out the lane it is actually about.
+ *
+ * What it deliberately does NOT do is decide anything: an error carries `onError: "review"` here,
+ * but the runner re-stamps the rubric's own fallback over it (lib/facts/runner.ts) exactly as in
+ * production — the fake cannot make a handler's failure read differently than it will on chain.
+ *
+ * Node-safe (the `./testing` subpath): plain objects, zod via `loadConfig`, and types.
+ */
+import type { AiSendEntry, FactTools, HttpJsonInit } from "../facts/types.js";
+import type { Agreement } from "../lib/engine/types.js";
+import type { AiFact, ExtFact, Provenance } from "../lib/facts/factset.js";
+import type { ClaimIntent, LinkedResource } from "../lib/ixo/blocksync/types.js";
+import type { QueryClient } from "../lib/ixo/chain.js";
+import type { LogFields } from "../lib/logger.js";
+/** One line a handler logged, in order — `fakeTools().logs`. */
+export interface LogRecord {
+    level: "debug" | "info" | "warn" | "error";
+    msg: string;
+    data?: LogFields;
+}
+/** The brand `httpResponse()` stamps. Module-local, so nothing else can forge an envelope. */
+declare const ENVELOPE: unique symbol;
+export interface HttpResponseEnvelope {
+    readonly [ENVELOPE]: true;
+    status: number;
+    body: unknown;
+}
+/**
+ * The canned answer for a URL whose STATUS matters — `httpResponse(503, { error: "down" })`.
+ * Everything else in an `http` map is the response body VERBATIM under a 200, which is why the
+ * envelope is branded and not guessed at: `{ body: "hello", sender: "bob" }` is a body, not a
+ * status/body pair, and a handler must see it whole.
+ */
+export declare function httpResponse(status: number, body: unknown): HttpResponseEnvelope;
+/**
+ * What one URL answers: an `httpResponse(...)` envelope, a function of the request (`init`)
+ * returning either, or any value at all — the body, under a 200. The union is DOCUMENTATION;
+ * `unknown` swallows its siblings at the type level, and the runtime tells the three apart by the
+ * brand and by `typeof route === "function"`.
+ */
+export type FakeHttpRoute = HttpResponseEnvelope | ((init: HttpJsonInit) => unknown) | unknown;
+/** What `tools.chain.claimIntent` was asked — recorded on `chainCalls`, and given to a fn answer. */
+export interface ClaimIntentQuery {
+    agentAddress: string;
+    collectionId: string;
+    before: string;
+    /** The search floor — the agreement's consent time, when the handler knows it. */
+    after?: string;
+}
+/** One `tools.chain` call a handler made, in order — `fakeTools().chainCalls`. */
+export type ChainCall = {
+    call: "linkedResources";
+    entityDid: string;
+} | {
+    call: "claimIntent";
+    params: ClaimIntentQuery;
+} | {
+    call: "query";
+};
+/** What the chain answers under test. Every lane defaults to the honest empty answer. */
+export interface FakeChain {
+    /** entity DID → what it anchors. A DID the test did not describe anchors nothing, as on chain. */
+    linkedResources?: Record<string, LinkedResource[]>;
+    /**
+     * The agent's commitment, or null (the default) for an agent that filed none. A FUNCTION gets the
+     * query — which is how a test asserts on what was asked, or throws to stand in for a blocksync
+     * outage, the case a handler must let through rather than read as "no intent".
+     */
+    claimIntent?: ClaimIntent | null | ((params: ClaimIntentQuery) => ClaimIntent | null);
+    /** There is no chain behind a test — supply a client (or a stub of the calls you make) to use one. */
+    query?: QueryClient;
+}
+export interface FakeToolsOverrides {
+    /** url → canned answer. An unmatched URL is a network failure (`ok: false`, `status: null`). */
+    http?: Record<string, FakeHttpRoute>;
+    /** What `tools.stock()` answers — a wrapping handler's base fact. */
+    stock?: ExtFact | AiFact | (() => ExtFact | AiFact | Promise<ExtFact | AiFact>);
+    ai?: {
+        judge?: (instructions: string[], inputs: AiSendEntry[], opts?: {
+            model?: string;
+        }) => AiFact | Promise<AiFact>;
+    };
+    /** attachment url → its bytes (`sampleClaim` gives an attachment a url). */
+    attachments?: Record<string, Uint8Array>;
+    c2pa?: Provenance | null;
+    agreement?: Agreement | null;
+    /** What `tools.chain` reads — every call is recorded on `chainCalls` either way. */
+    chain?: FakeChain;
+    /** The provider's own bindings and secrets, as `tools.env`. */
+    env?: Record<string, unknown>;
+}
+export type FakeTools = FactTools & {
+    logs: LogRecord[];
+    chainCalls: ChainCall[];
+};
+/** One of the stubs above — the ONLY thing `runFacts` replaces; a provider's own survives. */
+export declare const isClaimStub: (value: unknown) => boolean;
+export declare function fakeTools(over?: FakeToolsOverrides): FakeTools;
+export {};
+//# sourceMappingURL=fake-tools.d.ts.map

package/dist/testing/fake-tools.d.ts.map

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

package/dist/testing/fake-tools.js

@@ -0,0 +1,213 @@
+/**
+ * `fakeTools()` — the kit's machinery (facts/types.ts `FactTools`) with every lane answered from a
+ * literal instead of the network: canned HTTP by URL, a judge that says yes, no C2PA, no buyer
+ * statement, and a logger that collects into `logs` so a test can assert on what a handler said.
+ * Every default is the BORING one, so a test only spells out the lane it is actually about.
+ *
+ * What it deliberately does NOT do is decide anything: an error carries `onError: "review"` here,
+ * but the runner re-stamps the rubric's own fallback over it (lib/facts/runner.ts) exactly as in
+ * production — the fake cannot make a handler's failure read differently than it will on chain.
+ *
+ * Node-safe (the `./testing` subpath): plain objects, zod via `loadConfig`, and types.
+ */
+import { loadConfig } from "../config.js";
+import { fact } from "../facts/fact.js";
+import { redactHeaders, redactUrl, transcriptBody } from "../lib/facts/stock/call.js";
+import { assertExternalCapability, urlAudience } from "../lib/facts/stock/capability.js";
+import { assertPublicHttpUrl } from "../lib/http/client.js";
+/** The brand `httpResponse()` stamps. Module-local, so nothing else can forge an envelope. */
+const ENVELOPE = Symbol("fakeHttpResponse");
+/**
+ * The canned answer for a URL whose STATUS matters — `httpResponse(503, { error: "down" })`.
+ * Everything else in an `http` map is the response body VERBATIM under a 200, which is why the
+ * envelope is branded and not guessed at: `{ body: "hello", sender: "bob" }` is a body, not a
+ * status/body pair, and a handler must see it whole.
+ */
+export function httpResponse(status, body) {
+    return { [ENVELOPE]: true, status, body };
+}
+const isEnvelope = (value) => typeof value === "object" && value !== null && ENVELOPE in value;
+/** One route entry read as a response: a function is called, an envelope unwrapped, the rest IS the body. */
+async function cannedResponse(route, init) {
+    const answer = typeof route === "function" ? await route(init) : route;
+    return isEnvelope(answer)
+        ? { status: answer.status, body: answer.body }
+        : { status: 200, body: answer };
+}
+function collectingLogger(logs) {
+    const write = (level) => (msg, fields) => {
+        logs.push({ level, msg, ...(fields ? { data: fields } : {}) });
+    };
+    return {
+        debug: write("debug"),
+        info: write("info"),
+        warn: write("warn"),
+        error: write("error"),
+        // The same collector: a test asserts on ONE `logs` array, and bound fields are noise in it.
+        child() {
+            return this;
+        },
+    };
+}
+/** The tag `runFacts` looks for — module-local, so only the stubs below are ever rebound. */
+const NEEDS_CLAIM = Symbol("fakeToolsNeedsClaim");
+/**
+ * `attachments.on` and `ai.inputsFor` are pure functions OF THE CLAIM — and there is no claim
+ * until `runFacts` is called with one, so it binds them there (index.ts `bindToClaim`) rather than
+ * making a provider hand the same claim to `fakeTools` as well. Called outside that, they say so.
+ */
+function claimStub(what) {
+    const stub = () => {
+        throw new Error(`${what}: fakeTools has no claim — call your handler through runFacts()`);
+    };
+    return Object.assign(stub, { [NEEDS_CLAIM]: true });
+}
+/** One of the stubs above — the ONLY thing `runFacts` replaces; a provider's own survives. */
+export const isClaimStub = (value) => typeof value === "function" &&
+    value[NEEDS_CLAIM] === true;
+/**
+ * Shaped like the real header pair (lib/facts/tools.ts), and the token spells out what was asked
+ * for — a test asserts on the audience and capability its handler addressed. The real refusal
+ * (stock/capability.ts), so a handler's test sees what production does.
+ */
+function fakeUcan(audience, capability) {
+    if (capability)
+        assertExternalCapability(capability);
+    const token = capability
+        ? `fake-ucan-for-${audience}-${capability.can}-${capability.with}`
+        : `fake-ucan-for-${audience}`;
+    return { authorization: `Bearer ${token}`, "x-auth-type": "ucan" };
+}
+export function fakeTools(over = {}) {
+    const logs = [];
+    const routes = over.http ?? {};
+    const bytes = over.attachments ?? {};
+    const chainCalls = [];
+    const chain = over.chain ?? {};
+    return {
+        logs,
+        chainCalls,
+        async stock() {
+            if (typeof over.stock === "function")
+                return over.stock();
+            // The honest default: there is no external source and no model behind a test. A handler
+            // that WRAPS its stock lane gets a per-fact answer by passing `runFacts({ stock })` instead.
+            return (over.stock ?? {
+                status: "error",
+                onError: "review",
+                detail: "stock lane is not available in tests",
+            });
+        },
+        http: {
+            async json(url, init = {}) {
+                try {
+                    // The real lane's SSRF guard, FIRST (lib/facts/tools.ts): an unparseable or private URL
+                    // is the same refused outcome here as in production, never a throw.
+                    assertPublicHttpUrl(url);
+                }
+                catch {
+                    return {
+                        ok: false,
+                        status: null,
+                        body: null,
+                        transcript: {
+                            request: {
+                                url: redactUrl(url),
+                                body: init.body ?? null,
+                                headers: redactHeaders(init.headers ?? {}),
+                            },
+                            response: null,
+                            attempts: 0,
+                            elapsedMs: 0,
+                        },
+                    };
+                }
+                if (init.ucan) {
+                    // The real lane signs for the URL's own host (lib/facts/tools.ts); a canned route sees
+                    // the same readable fake token `ucanHeaders` returns for that audience.
+                    const cap = init.ucan === true ? undefined : init.ucan.capability;
+                    init = { ...init, headers: { ...init.headers, ...fakeUcan(urlAudience(url), cap) } };
+                }
+                const request = {
+                    url: redactUrl(url),
+                    body: init.body ?? null,
+                    headers: redactHeaders(init.headers ?? {}),
+                };
+                const route = routes[url];
+                if (route === undefined) {
+                    // Nothing was sent — `attempts: 0`, the same shape the real lane produces for a URL it
+                    // refused to call (lib/facts/tools.ts).
+                    return {
+                        ok: false,
+                        status: null,
+                        body: null,
+                        transcript: { request, response: null, attempts: 0, elapsedMs: 0 },
+                    };
+                }
+                const { status, body } = await cannedResponse(route, init);
+                return {
+                    ok: status >= 200 && status < 300,
+                    status,
+                    body: body,
+                    transcript: {
+                        request,
+                        // Production's 64 KiB rule (stock/call.ts), measured on the body as it would travel.
+                        response: {
+                            status,
+                            body: await transcriptBody(new TextEncoder().encode(typeof body === "string" ? body : JSON.stringify(body)), body),
+                        },
+                        attempts: 1,
+                        elapsedMs: 0,
+                    },
+                };
+            },
+            ucanHeaders: async (audience, capability) => fakeUcan(audience, capability),
+        },
+        ai: {
+            judge: async (instructions, inputs, opts) => over.ai?.judge ? over.ai.judge(instructions, inputs, opts) : fact.ai.ok(true),
+            inputsFor: claimStub("tools.ai.inputsFor"),
+        },
+        attachments: {
+            on: claimStub("tools.attachments.on"),
+            bytes: async (att) => {
+                const found = bytes[att.url];
+                return found ? { ok: true, bytes: found } : { ok: false, reason: "unfetchable" };
+            },
+            size: async (att) => bytes[att.url]?.byteLength ?? null,
+        },
+        c2pa: { screen: async () => over.c2pa ?? null },
+        chain: {
+            linkedResources: async (entityDid) => {
+                chainCalls.push({ call: "linkedResources", entityDid });
+                // The real read's own answer for an entity that anchors nothing — a handler's "no card on
+                // chain" branch is a case worth testing, not a throw a test has to arrange around.
+                return chain.linkedResources?.[entityDid] ?? [];
+            },
+            claimIntent: async (params) => {
+                chainCalls.push({ call: "claimIntent", params });
+                const answer = chain.claimIntent;
+                // Undefined ⇒ the real read's own answer for an agent that committed to nothing: null.
+                return typeof answer === "function" ? answer(params) : (answer ?? null);
+            },
+            query: async () => {
+                chainCalls.push({ call: "query" });
+                if (!chain.query) {
+                    throw new Error("tools.chain.query(): the chain RPC is not available in tests — pass `chain: { query }` with a client, or a stub of the calls your handler makes");
+                }
+                return chain.query;
+            },
+        },
+        agreement: async () => over.agreement ?? null,
+        logger: collectingLogger(logs),
+        // The real thing, from the same zod schema the Worker validates at boot — a handler reading
+        // `tools.config.IXO_NETWORK` (devnet by default) gets a value, not a stub with holes.
+        config: loadConfig({
+            ORACLE_HOSTNAME: "oracle.test",
+            ORACLE_DID: "did:ixo:ixo1test",
+            ORACLE_ADDRESS: "ixo1test",
+            ORACLE_MATRIX_USER_ID: "@did-ixo-ixo1test:devmx.ixo.earth",
+        }),
+        env: (over.env ?? {}),
+    };
+}
+//# sourceMappingURL=fake-tools.js.map

package/dist/testing/fake-tools.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `@ixo/decision-oracle/testing` — run your fact handlers in plain node, with no Worker and no
+ * network. `runFacts` is the SAME runner production uses (lib/facts/runner.ts), minus the fact
+ * cache and D1, followed by the SAME `validateFacts` the workflow runs before it freezes a
+ * FactSet: a handler that passes here answers the work order on chain too.
+ *
+ * ```ts
+ * import { fakeTools, runFacts, sampleClaim, sampleManifest } from "@ixo/decision-oracle/testing";
+ *
+ * const out = await runFacts(facts, {
+ *   claim: sampleClaim({ reference: "ABC" }),
+ *   manifest: sampleManifest({ ext: { deliveryConfirmed: { expect: "boolean" } } }),
+ *   tools: fakeTools({ http: { "https://courier.example/deliveries/ABC": { status: "delivered" } } }),
+ * });
+ * expect(out.issues).toEqual([]);
+ * ```
+ *
+ * Node-safe, like `./facts`: nothing here may reach `cloudflare:*`, a `.wasm`, D1 or KV —
+ * `test/node/testing.test.ts` is the tripwire.
+ */
+import type { FactsConfig, FactTools } from "../facts/types.js";
+import type { Manifest } from "../lib/engine/types.js";
+import type { CtxFacts, FactSettings } from "../lib/facts/factset.js";
+import type { ProducedFacts } from "../lib/facts/producer.js";
+import { type StockLanes } from "../lib/facts/runner.js";
+import { type FactIssue } from "../lib/facts/validate.js";
+import type { PulledClaim } from "../lib/ixo/index.js";
+/** So a provider can name what `runFacts` hands back. */
+export type { ProducedFacts } from "../lib/facts/producer.js";
+export type { FactIssue } from "../lib/facts/validate.js";
+export type { PulledClaim } from "../lib/ixo/index.js";
+export type { ChainCall, ClaimIntentQuery, FakeChain, FakeHttpRoute, FakeTools, FakeToolsOverrides, HttpResponseEnvelope, LogRecord, } from "./fake-tools.js";
+export { fakeTools, httpResponse } from "./fake-tools.js";
+export type { SampleClaimOptions, SampleManifestDecl } from "./samples.js";
+export { sampleClaim, sampleCtx, sampleManifest } from "./samples.js";
+export interface RunFactsInput {
+    claim: PulledClaim;
+    manifest: Manifest;
+    /** Defaults to `fakeTools()` — pass one you configured, or read its `logs` afterwards. */
+    tools?: FactTools;
+    ctx?: CtxFacts;
+    settings?: FactSettings;
+    /** Per-lane stock overrides — what an unlisted name (and `tools.stock()`) runs instead. */
+    stock?: Partial<StockLanes>;
+}
+/**
+ * Produce the facts the work order names, then hold them to it: `issues` is empty iff the engine
+ * would accept this FactSet (`validateFacts` — every declared name answered, of the declared type,
+ * an error carrying the rubric's own `onError`, and nothing undeclared).
+ */
+export declare function runFacts(facts: FactsConfig, input: RunFactsInput): Promise<ProducedFacts & {
+    issues: FactIssue[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAW,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,yDAAyD;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7B;AAuCD;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,GAAG;IAAE,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CAoClD"}

package/dist/testing/index.js

@@ -0,0 +1,104 @@
+/**
+ * `@ixo/decision-oracle/testing` — run your fact handlers in plain node, with no Worker and no
+ * network. `runFacts` is the SAME runner production uses (lib/facts/runner.ts), minus the fact
+ * cache and D1, followed by the SAME `validateFacts` the workflow runs before it freezes a
+ * FactSet: a handler that passes here answers the work order on chain too.
+ *
+ * ```ts
+ * import { fakeTools, runFacts, sampleClaim, sampleManifest } from "@ixo/decision-oracle/testing";
+ *
+ * const out = await runFacts(facts, {
+ *   claim: sampleClaim({ reference: "ABC" }),
+ *   manifest: sampleManifest({ ext: { deliveryConfirmed: { expect: "boolean" } } }),
+ *   tools: fakeTools({ http: { "https://courier.example/deliveries/ABC": { status: "delivered" } } }),
+ * });
+ * expect(out.issues).toEqual([]);
+ * ```
+ *
+ * Node-safe, like `./facts`: nothing here may reach `cloudflare:*`, a `.wasm`, D1 or KV —
+ * `test/node/testing.test.ts` is the tripwire.
+ */
+import { runHandlers } from "../lib/facts/runner.js";
+import { unresolvedFrequencyFact } from "../lib/facts/stock/frequency-fact.js";
+import { aiEntries, resolveSendPayload } from "../lib/facts/stock/send.js";
+import { validateFacts } from "../lib/facts/validate.js";
+import { fakeTools, isClaimStub } from "./fake-tools.js";
+import { sampleCtx } from "./samples.js";
+export { fakeTools, httpResponse } from "./fake-tools.js";
+export { sampleClaim, sampleCtx, sampleManifest } from "./samples.js";
+/**
+ * `tools.attachments.on` and `tools.ai.inputsFor` are pure functions of the CLAIM, which
+ * `fakeTools()` does not have — so they are bound here, where it exists, instead of asking a
+ * provider to hand the same claim over twice. ONLY the `fakeTools` stubs are replaced
+ * (`isClaimStub`): an implementation a provider wrote themselves is theirs, and survives.
+ *
+ * Members are copied one by one rather than spread because `env` is a GETTER on the real tools
+ * that throws when the build carries no worker env (lib/facts/tools.ts) — wrapping a tools object
+ * must never be what triggers that.
+ */
+function bindToClaim(tools, claim, ctx) {
+    const inputsFor = isClaimStub(tools.ai.inputsFor)
+        ? (check) => aiEntries(claim, check, resolveSendPayload(check.send, claim.body, ctx))
+        : tools.ai.inputsFor;
+    const on = isClaimStub(tools.attachments.on)
+        ? (question) => claim.attachments.filter((att) => att.question === question)
+        : tools.attachments.on;
+    return {
+        stock: () => tools.stock(),
+        http: tools.http,
+        ai: { judge: (...args) => tools.ai.judge(...args), inputsFor },
+        attachments: {
+            on,
+            bytes: (...args) => tools.attachments.bytes(...args),
+            size: (...args) => tools.attachments.size(...args),
+        },
+        c2pa: tools.c2pa,
+        chain: tools.chain,
+        agreement: (counterparty) => tools.agreement(counterparty),
+        logger: tools.logger,
+        config: tools.config,
+        get env() {
+            return tools.env;
+        },
+    };
+}
+/**
+ * Produce the facts the work order names, then hold them to it: `issues` is empty iff the engine
+ * would accept this FactSet (`validateFacts` — every declared name answered, of the declared type,
+ * an error carrying the rubric's own `onError`, and nothing undeclared).
+ */
+export async function runFacts(facts, input) {
+    const ctx = input.ctx ?? sampleCtx();
+    const tools = bindToClaim(input.tools ?? fakeTools(), input.claim, ctx);
+    const stock = {
+        ext: () => tools.stock(),
+        // A fake `stock()` is target-blind — it has no manifest entry to dispatch on, so an override
+        // is trusted to be the shape of the lane it lands in, and the tools are narrowed to that lane
+        // here exactly as production narrows them per target (lib/facts/tools.ts). The default, an
+        // error fact, is valid in both unions.
+        ai: () => tools.stock(),
+        unique: () => {
+            throw new Error("no stock unique lane in tests — pass stock.unique or a facts.unique handler");
+        },
+        frequency: ({ rule }) => {
+            // The runner only routes here with a resolved rule — a `{ ruleId }`-only declaration is
+            // omitted from the FactSet rather than run (runner.ts), exactly as in production.
+            if (!rule)
+                throw new Error("no stock frequency lane in tests — the manifest declares no max/per");
+            return unresolvedFrequencyFact({ ruleId: rule.id, max: rule.max, per: rule.per });
+        },
+        ...input.stock,
+    };
+    const produced = await runHandlers(facts, input.claim, input.manifest, {
+        logger: tools.logger,
+        ctx,
+        // Both lanes open by default: a handler under test should run, not be gated by a policy the
+        // test never mentioned. Pass `settings` to exercise the gated path.
+        settings: input.settings ?? { allowAiChecks: true, allowImageChecks: true },
+        tools: () => tools,
+        stock,
+    });
+    const validated = validateFacts(produced, input.manifest);
+    return { ...produced, issues: validated.ok ? [] : validated.issues };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/testing/samples.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The three sample builders — a claim, a work order and a ctx, each complete enough to run the
+ * runner against and short enough to write inline in a test. They exist so a handler test says
+ * what it is ABOUT ("a claim whose `reference` is ABC", "a rubric declaring one scored source")
+ * and nothing else: every field a handler doesn't care about gets a valid, boring default.
+ *
+ * Node-safe, like the rest of `./testing`: `PulledClaim` and `Attachment` arrive as TYPES only —
+ * their modules reach the chain and must never be pulled into a provider's node test suite.
+ */
+import type { CoinSDKType } from "@ixo/impactxclient-sdk/types/codegen/cosmos/base/v1beta1/coin.js";
+import type { Manifest, ManifestAi, ManifestExt } from "../lib/engine/types.js";
+import type { CtxFacts } from "../lib/facts/factset.js";
+import type { PulledClaim } from "../lib/ixo/index.js";
+export interface SampleClaimOptions {
+    claimId?: string;
+    collectionId?: string;
+    /** The payout target the dup/rate lanes key on — null (the default) means "no agent on chain". */
+    agentAddress?: string | null;
+    /** The claim's on-chain submission timestamp (metadata.submissionDate) — distinct from `ctx.claim.submissionDate`, which `sampleCtx()` sets on its own. Default `null` — "no submission time on chain". */
+    submissionDate?: string | null;
+    /** The claim's on-chain payout coins (metadata.amount, echoed onto `payment.amount` — payment.ts). Default `[]`. */
+    amount?: CoinSDKType[];
+    /** Escrow-governed (payment.ts): `MsgClaimIntent` fixed the payout before the claim existed. Default `false`. */
+    useIntent?: boolean;
+    attachments?: {
+        question: string;
+        name: string;
+        mediaType: string;
+        /**
+         * What `tools.attachments.bytes()` is keyed by — give one to hand a handler real bytes.
+         * Omitted, it is `""`, which every url-less attachment shares: give each its own url as soon
+         * as more than one of them needs bytes.
+         */
+        url?: string;
+        cid?: string;
+    }[];
+}
+/**
+ * A pulled claim whose body is `answers`. `lane: "cellnode"`, `media: null` (the no-store posture):
+ * there is no store to fetch bytes from in a test — `fakeTools`'s `attachments` map is where bytes
+ * come from instead.
+ */
+export declare function sampleClaim(answers: Record<string, unknown>, opts?: SampleClaimOptions): PulledClaim;
+export interface SampleManifestDecl {
+    ext?: Record<string, Partial<ManifestExt> & {
+        expect: "boolean" | "score";
+    }>;
+    ai?: Record<string, Partial<ManifestAi> & {
+        instructions: string[];
+    }>;
+    unique?: Partial<NonNullable<Manifest["unique"]>> & {
+        ruleId: string;
+    };
+    frequency?: Partial<NonNullable<Manifest["frequency"]>> & {
+        ruleId: string;
+    };
+    fields?: Manifest["fields"];
+    derived?: Manifest["derived"];
+    ctx?: string[];
+}
+/**
+ * The engine's work order for a rubric that declares exactly the names you list — the shape
+ * `validateFacts` holds a producer to. Only `expect` (a source) and `instructions` (a check) have
+ * to be given: the rest is the call detail the STOCK lane would need, and a handler under test
+ * usually ignores it.
+ */
+export declare function sampleManifest(decl?: SampleManifestDecl): Manifest;
+/** The build's frozen clock read and collection window — one fixed instant, so digests repeat. */
+export declare function sampleCtx(over?: Partial<CtxFacts>): CtxFacts;
+//# sourceMappingURL=samples.d.ts.map

package/dist/testing/samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../src/testing/samples.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kEAAkE,CAAC;AACpG,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2MAA2M;IAC3M,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oHAAoH;IACpH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,iHAAiH;IACjH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB;;;;WAIG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;CACL;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,GAAE,kBAAuB,GAC5B,WAAW,CA+Bb;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,QAAQ,CA6BtE;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,IAAI,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAOhE"}