@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/cjs/data/shortName.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * The short form of somebody's account name: "Peter B.", never more.
+ *
+ * A leaderboard is read by strangers, and the board's promise is that it
+ * names nobody who did not ask to be named. When somebody *does* ask — the
+ * opt-in on /me — what they get is this: a given name and an initial. Enough
+ * for a friend to find them, not enough for a stranger to search for them.
+ * Only this form is ever stored or published; the full display name is read,
+ * shortened, and dropped on the spot.
+ *
+ * The source is a Matrix display name, which is a string somebody typed and
+ * nobody checked, and the data says what that means in practice: "peter
+ * bulovec gmail", "Graeme Leighton test 6", an address, a whole email. So
+ * the rules below are less about formatting than about refusing:
+ *
+ * - `cleanName` first, so everything the estate already refuses as a name —
+ *   address-shaped, sentence-long, a wallet's own default label — is refused
+ *   here too, by the same rule.
+ * - Invisible characters go before anything is judged. A zero-width space is
+ *   how an address slips past a pattern that looks for one; a bidi override
+ *   is how a name renders as something other than what it is.
+ * - An email keeps only its local part, and a trailing mail-provider word
+ *   ("… gmail") is the sign of one typed out by hand. When what is left of
+ *   either is a single word, it is a mail handle, not a name, and it is
+ *   refused rather than printed.
+ * - A handle joins its words with punctuation instead of a space —
+ *   "peter.bulovec", "peter_bulovec", "Peter/Bulovec" — and printing that
+ *   whole would publish the surname the short form exists to drop. So those
+ *   joins are split into words before anything is chosen, and a single
+ *   word written as two ("PeterBulovec") is split at its capital. Only a
+ *   single word: "DeShawn Smith" has a surname already and keeps its given
+ *   name whole, while a lone "DeShawn" becomes "De S." — a clumsier short
+ *   name, never a longer one. A hyphen and an apostrophe stay: Jean-Luc
+ *   and O'Brien are names, not joins.
+ * - The given name that is left must be letters, joined only by a hyphen or
+ *   an apostrophe. Anything else is refused rather than printed.
+ * - Whatever survives must contain no "@", no digit, no "ixo1" and no
+ *   "did-ixo". A digit is almost never part of somebody's given name and very
+ *   often part of a handle, a birth year or a test account.
+ *
+ * Null is the ordinary answer, and it is not a failure: the board then shows
+ * a generated name, which is what it shows for everybody who never chose one.
+ *
+ * Idempotent — the short form of a short form is itself — so a stored value
+ * can be run through this again on the way out without drifting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shortName = shortName;
+const format_ts_1 = require("./format.js");
+/* Zero-width and bidi-control characters, plus the soft hyphen and the
+   Mongolian vowel separator, which render as nothing and split a pattern. */
+const INVISIBLE = /[\u00ad\u061c\u180e\u200b-\u200f\u202a-\u202e\u2060-\u2069\ufeff]/g;
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/* Words a hand-typed email leaves at the end of a name: "peter bulovec gmail",
+   "jsmith yahoo com". Matched whole and case-insensitively. */
+const PROVIDERS = new Set([
+    "gmail", "googlemail", "yahoo", "ymail", "outlook", "hotmail", "live", "msn", "icloud", "me", "mac",
+    "proton", "protonmail", "aol", "gmx", "yandex", "zoho", "mail", "com", "net", "org", "ixo"
+]);
+/* What a handle joins words with. Not "-" or an apostrophe, which names use;
+   not "@", which is refused outright below. */
+const JOINS = /[._/\\,+|:;~*#&=!?()[\]{}<>"^%$]+/g;
+/* Letters, joined only as names join them. */
+const GIVEN = /^[\p{L}\p{M}]+(?:['’-][\p{L}\p{M}]+)*$/u;
+const GIVEN_MAX = 24;
+const SEGMENTER = (() => {
+    try {
+        const Segmenter = Intl.Segmenter;
+        return Segmenter ? new Segmenter(undefined, { granularity: "grapheme" }) : null;
+    }
+    catch {
+        return null;
+    }
+})();
+/** User-perceived characters, so "Ž" written as Z plus a caron is one of them. */
+const graphemes = (text) => (SEGMENTER ? Array.from(SEGMENTER.segment(text), (part) => part.segment) : Array.from(text));
+const REFUSED = /@|\p{N}|ixo1|did-ixo/iu;
+/**
+ * "Given L." from a display name, or null when there is no honest short name
+ * in it. See the module comment for every rule and why.
+ */
+function shortName(raw) {
+    const cleaned = (0, format_ts_1.cleanName)(raw);
+    if (!cleaned)
+        return null;
+    let text = cleaned.normalize("NFC").replace(INVISIBLE, "").replace(/\s+/g, " ").trim();
+    if (EMAIL.test(text))
+        text = text.slice(0, text.indexOf("@")).replace(/[._+-]+/g, " ").trim();
+    text = text.replace(/^@+/, "").trim();
+    text = text.replace(JOINS, " ").replace(/\s+/g, " ").trim();
+    let words = text.split(" ").filter(Boolean);
+    let providerDropped = false;
+    while (words.length > 1) {
+        const last = words[words.length - 1];
+        const isProvider = PROVIDERS.has(last.toLowerCase());
+        if (!isProvider && !/^\p{Nd}+$/u.test(last))
+            break;
+        if (isProvider)
+            providerDropped = true;
+        words = words.slice(0, -1);
+    }
+    words = words.filter((word) => /^\p{L}/u.test(word));
+    if (words.length === 0)
+        return null;
+    if (providerDropped && words.length === 1)
+        return null;
+    /* One word left that is two written together: split at the capital, after
+       everything else is trimmed, so the short form of a short form is itself. */
+    if (words.length === 1)
+        words = words[0].replace(/(\p{Ll})(\p{Lu})/gu, "$1 $2").split(" ");
+    let given = graphemes(words[0]).slice(0, GIVEN_MAX).join("").replace(/[\p{P}\p{S}]+$/u, "");
+    if (!given || !GIVEN.test(given))
+        return null;
+    if (given === given.toLowerCase() && given !== given.toUpperCase()) {
+        const [first = "", ...rest] = graphemes(given);
+        given = first.toUpperCase() + rest.join("");
+    }
+    const result = words.length === 1 ? given : `${given} ${(graphemes(words[words.length - 1])[0] ?? "").toUpperCase()}.`;
+    return REFUSED.test(result) ? null : result;
+}
+//# sourceMappingURL=shortName.js.map

package/dist/cjs/data/shortName.js.map

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

package/dist/cjs/data/threads.d.ts

@@ -0,0 +1,97 @@
+import type { ReceiptData } from "./receipt.ts";
+/**
+ * Threads are claim collections wearing their real face: an ask, an amount,
+ * and a record of what happened. The list reads two indexes — recent
+ * collections and recent claims — and stitches a last-event line per thread.
+ */
+export interface ThreadListItem {
+    id: string;
+    title: string;
+    state: number;
+    pays: {
+        value: number;
+        symbol: string;
+    } | null;
+    /**
+     * Its pool pays, not `pays`: the approval leg is the one base unit a pool
+     * ask escrows to be payable at all (see `paysFromPool`). `pays` still holds
+     * that unit, so the ask stays takeable, but it is not a price and nothing
+     * should print it as one.
+     */
+    pool?: true;
+    count: number;
+    approved: number;
+    disputed: number;
+    /** What the board needs to know whether there is still anything to earn —
+     *  see `askOpenness`. Fetched all along; dropped here until the day a
+     *  filled ask sat in the money group inviting a click it would refuse. */
+    quota: string;
+    endDate: string | null;
+    lastEventAt: string | null;
+    lastEventLine: string;
+    /** Who the last event was about, when it was about somebody. Kept as an
+     *  address rather than baked into the line so the app can put a name and a
+     *  mark in front of it — the data layer has no idea who anyone is. */
+    lastEventActor?: string;
+    /**
+     * Who posted it — the ask entity's admin account.
+     *
+     * On the board this is the answer to the first question a stranger asks
+     * about money on the internet: who is offering it. Carried as an address
+     * because the data layer has no idea who anyone is; the app puts a mark and
+     * a name in front of it.
+     */
+    admin: string;
+    /** False when the chain gave this ask no name and `title` is standing in.
+     *  The substitution used to happen here and vanish, which left the app
+     *  unable to treat "Ask #43748" differently from a real sentence. */
+    named: boolean;
+    /** The campaign tag frozen into the ask's published terms, when one is.
+     *  Resolved from the same cached documents the map reads; absence is the
+     *  ordinary case and a failed fetch leaves the field absent, never wrong. */
+    campaign?: string;
+    /**
+     * Where the ask says the work must happen, when it says so at all.
+     *
+     * Read from the same published terms as `campaign`, in the same pass — the
+     * documents were already being fetched and the geometry thrown away, which
+     * is why a map of every placed ask costs nothing new. The label is the name
+     * frozen at posting; the numbers are the contract, and a gate whose numbers
+     * do not survive validation leaves this absent rather than plotting an ask
+     * somewhere it is not.
+     */
+    place?: {
+        lat: number;
+        lon: number;
+        metres: number;
+        label?: string;
+    };
+    /** What the ask wants handed over — the deliverable's `type` off the same
+     *  published terms as `campaign` and `place`, in the same pass. The board's
+     *  cards wear it as a glyph so a reader can see what a job takes before
+     *  opening it; absence simply draws no glyph. */
+    deliverable?: string;
+}
+export declare function loadThreads(limit?: number): Promise<ThreadListItem[]>;
+export type ThreadEventKind = "opened" | "submitted" | "approved" | "rejected" | "flagged" | "checked" | "paid" | "refunded" | "disputed" | "closed";
+export interface ThreadEvent {
+    kind: ThreadEventKind;
+    actor?: string;
+    amount?: {
+        value: number;
+        symbol: string;
+    } | null;
+    at: string | null;
+    /**
+     * The claim this event is about, when it is about one.
+     *
+     * Carried so a surface can show the work itself beside the line that says it
+     * arrived. The id IS the address of the envelope — claims are
+     * content-addressed — so nothing else has to be looked up to find what
+     * somebody handed over.
+     */
+    claimId?: string;
+}
+/** The typed record of a thread, oldest first, derived from chain facts only. */
+export declare function deriveEvents(receipt: ReceiptData): ThreadEvent[];
+//# sourceMappingURL=threads.d.ts.map

package/dist/cjs/data/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/data/threads.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB;;8EAE0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB;;0EAEsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;yEAEqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf;;iFAE6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE;;;qDAGiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmBD,wBAAsB,WAAW,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwIvE;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAErJ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,EAAE,CAuChE"}

package/dist/cjs/data/threads.js

@@ -0,0 +1,214 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadThreads = loadThreads;
+exports.deriveEvents = deriveEvents;
+const gql_ts_1 = require("./gql.js");
+const granters_ts_1 = require("./granters.js");
+const profiles_ts_1 = require("./profiles.js");
+const format_ts_1 = require("./format.js");
+const types_ts_1 = require("./types.js");
+const facts_ts_1 = require("./board/facts.js");
+/* The fields every collection row needs, written once because two queries
+   ask for them: the network's newest, and our own. */
+const COLLECTION_FIELDS = "id state entity protocol admin startDate endDate quota count evaluated approved rejected disputed payments";
+const CLAIM_FIELDS = "collectionId agentAddress submissionDate evaluationByClaimId { status evaluationDate }";
+/** How many of our own asks to carry, however old they are. Bounded so one
+ *  prolific poster cannot become the whole board. */
+const OURS_REACH = 40;
+async function loadThreads(limit = 30) {
+    /*
+     * Two lists, not one.
+     *
+     * The first is the network's newest `limit` collections — the lobby, which
+     * is what a stranger comes to see. The second is every collection posted by
+     * an admin who granted this deployment's gate, fetched by name so it cannot
+     * be crowded out. Mainnet adds around thirty collections a day from other
+     * projects, so a recency page alone loses our own asks inside a day; it did,
+     * on 2026-09-16. See `gateGranters`.
+     *
+     * A failed gate read leaves `ours` empty and the board falls back to exactly
+     * the old behaviour: fewer rows, never wrong ones.
+     */
+    const ours = await (0, granters_ts_1.gateGranters)().catch(() => []);
+    const oursList = JSON.stringify(ours);
+    const data = await (0, gql_ts_1.gql)(`query {
+      recent: claimCollections(orderBy: START_DATE_DESC, filter: {startDate: {isNull: false}}, first: ${limit}) {
+        nodes { ${COLLECTION_FIELDS} }
+      }
+      ${ours.length ? `ours: claimCollections(orderBy: START_DATE_DESC, filter: {admin: {in: ${oursList}}}, first: ${OURS_REACH}) {
+        nodes { ${COLLECTION_FIELDS} }
+      }` : ""}
+      claims(orderBy: SUBMISSION_DATE_DESC, first: 120) {
+        nodes { ${CLAIM_FIELDS} }
+      }
+    }`, 15);
+    /* Our own rows first-class, the network's newest behind them, each id once. */
+    const collections = [];
+    const seen = new Set();
+    for (const collection of [...data.recent.nodes, ...(data.ours?.nodes ?? [])]) {
+        const id = String(collection.id);
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        collections.push(collection);
+    }
+    const claimsByCollection = new Map();
+    const remember = (claim) => {
+        const list = claimsByCollection.get(String(claim.collectionId)) ?? [];
+        list.push(claim);
+        claimsByCollection.set(String(claim.collectionId), list);
+    };
+    for (const claim of data.claims.nodes)
+        remember(claim);
+    /*
+     * The newest 120 claims on the whole chain need not contain any of ours —
+     * the same crowding-out, one level down — which would leave a row that has
+     * seen work reading "opened". So our own asks get their claims read by id,
+     * and that answer replaces rather than appends. Only when there are rows the
+     * first read did not already cover.
+     */
+    const oursIds = (data.ours?.nodes ?? []).map((collection) => String(collection.id));
+    const uncovered = oursIds.filter((id) => !claimsByCollection.has(id));
+    if (uncovered.length > 0) {
+        const oursClaims = await (0, gql_ts_1.gql)(`query {
+        claims(orderBy: SUBMISSION_DATE_DESC, filter: {collectionId: {in: ${JSON.stringify(oursIds)}}}, first: 120) {
+          nodes { ${CLAIM_FIELDS} }
+        }
+      }`, 15).catch(() => null);
+        if (oursClaims) {
+            for (const id of oursIds)
+                claimsByCollection.delete(id);
+            for (const claim of oursClaims.claims.nodes)
+                remember(claim);
+        }
+    }
+    /* Every row on the board, not the first twenty of them — the list asks for
+       thirty, so ten of them were falling back to "Ask #id" with a real name
+       sitting unread in the index. */
+    const names = await (0, profiles_ts_1.entityNames)(collections.map((collection) => collection.protocol));
+    /*
+     * Which campaign each ask belongs to, off its published terms — the same
+     * per-entity cached fetch the map's state fold uses (`spots.termsOf`,
+     * revalidate 3600), run in parallel across the board's rows. The board is
+     * bounded (~30) and the documents cache for an hour, so the steady state is
+     * all cache hits. Measured once (2026-08-29, 30 rows, bare node so no Next
+     * data cache): cold 1971ms in parallel, warm 476ms — inside the page's
+     * 15s revalidate window either way, and the app's fetch cache does better.
+     */
+    const termsCache = new Map();
+    const { termsOf } = await Promise.resolve().then(() => __importStar(require("../campaign/spots.js")));
+    const campaigns = new Map();
+    const places = new Map();
+    const deliverables = new Map();
+    await Promise.all([...new Set(collections.map((collection) => collection.entity))].map(async (entity) => {
+        const terms = await termsOf(entity, termsCache).catch(() => null);
+        const tag = terms && typeof terms["campaign"] === "string" ? terms["campaign"] : null;
+        if (tag)
+            campaigns.set(entity, tag);
+        const place = (0, facts_ts_1.placeIn)(terms);
+        if (place)
+            places.set(entity, place);
+        /* Same suspicion as everything else off a content address: a string,
+           bounded, or nothing. The card only maps known kinds to glyphs. */
+        const kind = terms?.["deliverable"]?.type;
+        if (typeof kind === "string" && kind.length <= 24)
+            deliverables.set(entity, kind);
+    }));
+    const threads = collections.map((collection) => {
+        const last = (0, facts_ts_1.lastEventOf)(claimsByCollection.get(String(collection.id)) ?? []);
+        return {
+            id: String(collection.id),
+            title: names.get(collection.protocol) ?? `Ask #${collection.id}`,
+            named: Boolean(names.get(collection.protocol)),
+            admin: collection.admin,
+            state: collection.state,
+            pays: (0, format_ts_1.approvalAmount)(collection.payments),
+            ...((0, format_ts_1.paysFromPool)(collection.payments) ? { pool: true } : {}),
+            count: collection.count,
+            approved: collection.approved,
+            disputed: collection.disputed,
+            quota: String(collection.quota ?? ""),
+            endDate: collection.endDate ?? null,
+            lastEventAt: last?.at ?? collection.startDate ?? null,
+            lastEventLine: last?.line ?? "opened",
+            ...(last?.actor ? { lastEventActor: last.actor } : {}),
+            ...(campaigns.has(collection.entity) ? { campaign: campaigns.get(collection.entity) } : {}),
+            ...(places.has(collection.entity) ? { place: places.get(collection.entity) } : {}),
+            ...(deliverables.has(collection.entity) ? { deliverable: deliverables.get(collection.entity) } : {})
+        };
+    });
+    return threads.sort((a, b) => (b.lastEventAt ?? "").localeCompare(a.lastEventAt ?? ""));
+}
+/** The typed record of a thread, oldest first, derived from chain facts only. */
+function deriveEvents(receipt) {
+    const events = [];
+    if (receipt.startDate)
+        events.push({ kind: "opened", at: receipt.startDate });
+    const checkPays = (0, format_ts_1.evaluationAmount)(receipt.payments);
+    for (const claim of [...receipt.claims].reverse()) {
+        events.push({ kind: "submitted", actor: claim.agentAddress, at: claim.submissionDate ?? null, claimId: claim.claimId });
+        const evaluation = claim.evaluationByClaimId;
+        if (!evaluation?.status)
+            continue;
+        const kind = evaluation.status === 1 ? "approved" : evaluation.status === 3 ? "disputed" : evaluation.status === 5 ? "flagged" : "rejected";
+        /* The claim rides on the verdict — the field above promised as much and
+           nothing ever set it, which is why a thread with three submissions could
+           say "rejected" without saying of what (IXO thread rethink, 2026-09-02). */
+        events.push({ kind, actor: evaluation.agentAddress ?? evaluation.oracle ?? undefined, at: evaluation.evaluationDate ?? null, claimId: claim.claimId });
+        /*
+         * The checker being paid is its own event, because it is its own fact: the
+         * chain settles the evaluation leg to whoever signed the verdict, in the
+         * same transaction, whether the verdict was yes or no. A flag pays nobody —
+         * it is not a terminal answer, so the work is not finished.
+         */
+        if (checkPays && evaluation.status !== 5 && evaluation.agentAddress) {
+            events.push({ kind: "checked", actor: evaluation.agentAddress, amount: checkPays, at: evaluation.evaluationDate ?? null, claimId: claim.claimId });
+        }
+        if (evaluation.status === 1 && (0, types_ts_1.approvalPaid)(claim)) {
+            events.push({
+                kind: "paid",
+                actor: claim.agentAddress,
+                amount: (0, format_ts_1.coinDisplay)(evaluation.amount) ?? (0, format_ts_1.approvalAmount)(receipt.payments),
+                at: evaluation.evaluationDate ?? null,
+                claimId: claim.claimId
+            });
+        }
+    }
+    if (receipt.state === 2)
+        events.push({ kind: "closed", at: receipt.endDate ?? null });
+    return events.sort((a, b) => (a.at ?? "9999").localeCompare(b.at ?? "9999"));
+}
+//# sourceMappingURL=threads.js.map

package/dist/cjs/data/threads.js.map

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

package/dist/cjs/data/trace.d.ts

@@ -0,0 +1,133 @@
+import type { EngineCheck, EngineDecision, EngineVerdict } from "./engine.ts";
+import { type Claim, type PaymentsInfo } from "./types.ts";
+/**
+ * How one piece of work was decided and paid, step by step.
+ *
+ * A receipt used to say *that* work was approved and list the rules it met.
+ * The question a stranger actually brings to it is *how*: who looked, what
+ * they measured, who decided, whether anyone can check the decision, and
+ * when the money moved. Every one of those is already on the public record,
+ * split across the chain (when the work landed, when the verdict was cast,
+ * whether the payment executed) and the decision engine's signed receipt
+ * (when the facts were frozen, what was measured, which rules held, who
+ * signed). This puts them back in the order they happened.
+ *
+ * **Facts only.** No sentences are written here; `./traceWords.ts` holds the
+ * voice, shared by the receipt page and the agent tools, so an agent can
+ * take the steps as data or as the same sentences a person reads.
+ *
+ * **Ordered by step, never by clock.** The chain's block time and the
+ * engine's clock are two clocks. On mainnet cleanup 8250 the block that
+ * recorded the verdict is stamped a second *before* the engine says it
+ * decided, though the decision came first. So a step whose clock reads
+ * earlier than the step before it keeps its place and loses its time:
+ * `offsetMs` is null, and nothing on the page claims an order the record
+ * cannot support.
+ */
+export type RuleOutcome = "met" | "failed" | "not-reached";
+export interface TraceRule {
+    code: string;
+    outcome: RuleOutcome;
+    /** Two or three words, for a chip. Null for a judged rule. */
+    short: string | null;
+    /** The rule in full: met words when met, the rule's own reason otherwise. */
+    sentence: string;
+    /** Judged by a model rather than measured. */
+    judged: boolean;
+}
+interface At {
+    /** ISO time from whichever record holds the step. */
+    at: string | null;
+    /** Milliseconds after the work landed, or null when no honest number exists. */
+    offsetMs: number | null;
+}
+export type TraceStep = (At & {
+    kind: "submitted";
+    actor: string;
+    claimId: string;
+}) | (At & {
+    kind: "gathered";
+    actor: string | null;
+    checks: EngineCheck[];
+    factsDigest: string | null;
+}) | (At & {
+    kind: "decided";
+    verdict: EngineVerdict;
+    verdictClass: string | null;
+    action: string | null;
+    /** Share of the rules' weight met, 0–10000, as the engine scores it. */
+    totalBps: number | null;
+    rules: TraceRule[];
+    /** A person's review was folded in before the engine decided. */
+    reviewFolded: boolean;
+}) | (At & {
+    kind: "signed";
+    issuer: string;
+    verified: boolean | null;
+    receiptUrl: string | null;
+})
+/** A verdict with no engine receipt behind it: the poster, or a checker that signed its own. */
+ | (At & {
+    kind: "reviewed";
+    actor: string | null;
+    status: number;
+    byPoster: boolean;
+    signed: boolean;
+}) | (At & {
+    kind: "paid";
+    to: string;
+    amount: {
+        value: number;
+        symbol: string;
+    } | null;
+    from: "pool" | "escrow";
+    payer: string | null;
+    /** What the check itself was paid, when its leg executed. */
+    checkFee: {
+        value: number;
+        symbol: string;
+    } | null;
+    checker: string | null;
+})
+/** The chain recorded a verdict and nothing was released. */
+ | (At & {
+    kind: "recorded";
+    status: number;
+});
+export type TraceOutcome = "approved" | "rejected" | "review" | "disputed" | "pending";
+export interface Trace {
+    claimId: string;
+    outcome: TraceOutcome;
+    steps: TraceStep[];
+    /** When the work landed. */
+    startedAt: string | null;
+    /** From the work landing to the last step with a time, in milliseconds. */
+    settledMs: number | null;
+    /** Steps 2–4 came from the decision engine's signed receipt. */
+    engine: boolean;
+    /** The engine's own trace, pinned by hash. */
+    fullTrace: {
+        uri: string | null;
+        digest: string;
+    } | null;
+    /**
+     * The verdict names an engine receipt that could not be read this time. The
+     * page says so rather than drawing a trace that looks complete.
+     */
+    incomplete: boolean;
+}
+export interface TraceInput {
+    claim: Claim;
+    payments?: PaymentsInfo;
+    /** Whoever posted the ask (the entity's owner): who pays from escrow, and who judges an ask with no oracle. */
+    poster: string | null;
+    /** The engine's decision behind this claim's verdict, with gate reasons already joined. */
+    decision: EngineDecision | null;
+    /** Where the decision can be fetched and its signature checked. */
+    receiptUrl?: string | null;
+    /** The verdict names an engine receipt (a bare content address and an engine is wired). */
+    engineExpected?: boolean;
+}
+export declare function buildTrace(input: TraceInput): Trace;
+export {};
+//# sourceMappingURL=trace.d.ts.map

package/dist/cjs/data/trace.d.ts.map

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