@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/cjs/data/board/coverage.d.ts

@@ -0,0 +1,112 @@
+import { type ClaimLite } from "./facts.ts";
+import type { CatalogAsk } from "./types.ts";
+/**
+ * How well a place is answered — the buyer's view (Part G of
+ * docs/verified-work-marketplace-volume-plan.md).
+ *
+ * Somebody about to pay strangers to go and look somewhere, an agent most
+ * often, wants one thing first: does anybody answer here, and how soon? So
+ * over the asks posted near a point in the last ninety days this says how
+ * many were asked, how many got a verified answer, how long the first
+ * verified answer usually took, and what an ask there usually paid. Every
+ * figure is the catalogue's own (`board_asks`) except the timing, which needs
+ * each answered ask's first approval, read from the index.
+ *
+ * What counts: asks with a place, since only a place can be near anything;
+ * paying at approval, since a pool holds its pay until a site is clean and
+ * its timing would measure that instead; not stopped by the screen; posted
+ * inside the window. An ask posted in the last day with no verified answer
+ * yet is still running, not unanswered, and waits a day before it counts.
+ */
+export declare const COVERAGE_DAYS = 90;
+/** Fewer timed answers than this, and "usually" would be a guess. */
+export declare const TIMED_MIN = 3;
+/**
+ * Both posting paths (packages/openhands-sdk/src/chain/ask.ts and
+ * services/worker-agent/src/chain.ts) backdate a collection's start by five
+ * minutes, so a validator whose clock runs slow cannot refuse it. The ask
+ * was posted five minutes after the start it carries.
+ */
+export declare const POSTING_BACKDATE_MS: number;
+export interface Coverage {
+    /** Asks counted: near the point, in the window, as above. */
+    asked: number;
+    /** Of those, how many got at least one verified answer. */
+    answered: number;
+    /** Median minutes from posting to the first verified answer; null under `TIMED_MIN` timed answers. */
+    medianMinutes: number | null;
+    /** How many answered asks the median is taken over. */
+    timed: number;
+    /** What an ask here usually pays: the median approval leg, in the coin most of them use. */
+    typicalPay: {
+        value: number;
+        symbol: string;
+    } | null;
+}
+/** `GET /board/coverage?near=&km=`, as the worker answers it. */
+export interface CoverageAnswer extends Coverage {
+    v: 1;
+    at: string;
+    days: number;
+    near: {
+        lat: number;
+        lon: number;
+    };
+    km: number;
+    /** "12 of 14 answered, usually within 9 minutes, around $0.80". */
+    words: string;
+}
+/** `GET /board/coverage/places`: the busiest places, each figured. */
+export interface CoveragePlacesAnswer {
+    v: 1;
+    at: string;
+    days: number;
+    places: (CoveragePlace & {
+        words: string;
+    })[];
+}
+/** The asks a coverage figure is taken over, anywhere. */
+export declare function countedAsks(all: CatalogAsk[], now: Date): CatalogAsk[];
+/** Counted asks whose place is within `km` of a point. */
+export declare const asksNear: (asks: CatalogAsk[], point: {
+    lat: number;
+    lon: number;
+}, km: number) => CatalogAsk[];
+/** The asks worth asking the index about: answered ones, newest first, as many as one request should carry. */
+export declare const toTime: (asks: CatalogAsk[], max?: number) => string[];
+/** Each ask's first verified answer, as epoch milliseconds, from its claims. */
+export declare function firstApprovals(claims: ClaimLite[]): Map<string, number>;
+/**
+ * The figures over some counted asks. Without their first approvals — the
+ * index did not answer — the counts and the pay still stand and the timing
+ * says nothing: less, never wrong.
+ */
+export declare function coverageOf(asks: CatalogAsk[], approvals?: ReadonlyMap<string, number>): Coverage;
+/** A wait, said the way a person would: minutes, then hours, then days. */
+export declare function waitWords(minutes: number): string;
+/** "12 of 14 answered, usually within 9 minutes, around $0.80" — only what is known. */
+export declare function coverageWords(coverage: Coverage): string;
+export interface CoveragePlace extends Coverage {
+    /** The town most of its asks name. */
+    label: string;
+    lat: number;
+    lon: number;
+}
+export declare const PLACES_MAX = 5;
+/** A part of the map with fewer counted asks than this says too little to list. */
+export declare const PLACE_MIN = 3;
+/** The town in a place's name: "Acre Road, Milnerton" is in Milnerton; a name with no comma is its own town. */
+export declare function townOf(label: string | undefined): string | null;
+/**
+ * The busiest parts of the map: counted asks in cells about a city across,
+ * the most asked first, each named for the town most of its asks name. A
+ * part whose asks name no town is left out: a place nobody can say is not a
+ * place a sentence can offer.
+ */
+export declare function busiestPlaces(asks: CatalogAsk[], limit?: number): {
+    label: string;
+    lat: number;
+    lon: number;
+    asks: CatalogAsk[];
+}[];
+//# sourceMappingURL=coverage.d.ts.map

package/dist/cjs/data/board/coverage.d.ts.map

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

package/dist/cjs/data/board/coverage.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLACE_MIN = exports.PLACES_MAX = exports.toTime = exports.asksNear = exports.POSTING_BACKDATE_MS = exports.TIMED_MIN = exports.COVERAGE_DAYS = void 0;
+exports.countedAsks = countedAsks;
+exports.firstApprovals = firstApprovals;
+exports.coverageOf = coverageOf;
+exports.waitWords = waitWords;
+exports.coverageWords = coverageWords;
+exports.townOf = townOf;
+exports.busiestPlaces = busiestPlaces;
+const format_ts_1 = require("../format.js");
+const assemble_ts_1 = require("./assemble.js");
+const facts_ts_1 = require("./facts.js");
+const rank_ts_1 = require("./rank.js");
+const trust_ts_1 = require("./trust.js");
+/**
+ * How well a place is answered — the buyer's view (Part G of
+ * docs/verified-work-marketplace-volume-plan.md).
+ *
+ * Somebody about to pay strangers to go and look somewhere, an agent most
+ * often, wants one thing first: does anybody answer here, and how soon? So
+ * over the asks posted near a point in the last ninety days this says how
+ * many were asked, how many got a verified answer, how long the first
+ * verified answer usually took, and what an ask there usually paid. Every
+ * figure is the catalogue's own (`board_asks`) except the timing, which needs
+ * each answered ask's first approval, read from the index.
+ *
+ * What counts: asks with a place, since only a place can be near anything;
+ * paying at approval, since a pool holds its pay until a site is clean and
+ * its timing would measure that instead; not stopped by the screen; posted
+ * inside the window. An ask posted in the last day with no verified answer
+ * yet is still running, not unanswered, and waits a day before it counts.
+ */
+exports.COVERAGE_DAYS = 90;
+const DAY_MS = 24 * 3600 * 1000;
+/** Fewer timed answers than this, and "usually" would be a guess. */
+exports.TIMED_MIN = 3;
+/**
+ * Both posting paths (packages/openhands-sdk/src/chain/ask.ts and
+ * services/worker-agent/src/chain.ts) backdate a collection's start by five
+ * minutes, so a validator whose clock runs slow cannot refuse it. The ask
+ * was posted five minutes after the start it carries.
+ */
+exports.POSTING_BACKDATE_MS = 5 * 60_000;
+/** The asks a coverage figure is taken over, anywhere. */
+function countedAsks(all, now) {
+    const at = now.getTime();
+    const since = at - exports.COVERAGE_DAYS * DAY_MS;
+    return all.filter((ask) => {
+        if (!ask.place || ask.pool || ask.payBase <= 0)
+            return false;
+        if (ask.screen === "hold" || ask.screen === "refuse")
+            return false;
+        const posted = (0, facts_ts_1.chainMs)(ask.startDate);
+        if (!Number.isFinite(posted) || posted < since || posted > at)
+            return false;
+        return ask.approved > 0 || at - posted >= DAY_MS;
+    });
+}
+/** Counted asks whose place is within `km` of a point. */
+const asksNear = (asks, point, km) => asks.filter((ask) => ask.place && (0, rank_ts_1.distanceKm)(point, ask.place) <= km);
+exports.asksNear = asksNear;
+/** The asks worth asking the index about: answered ones, newest first, as many as one request should carry. */
+const toTime = (asks, max = 200) => asks
+    .filter((ask) => ask.approved > 0)
+    .sort((a, b) => Number(b.id) - Number(a.id))
+    .slice(0, max)
+    .map((ask) => ask.id);
+exports.toTime = toTime;
+/** Each ask's first verified answer, as epoch milliseconds, from its claims. */
+function firstApprovals(claims) {
+    const first = new Map();
+    for (const claim of claims) {
+        const evaluation = claim.evaluationByClaimId;
+        if (evaluation?.status !== 1)
+            continue;
+        const at = (0, facts_ts_1.chainMs)(evaluation.evaluationDate);
+        if (!Number.isFinite(at))
+            continue;
+        const id = String(claim.collectionId);
+        const known = first.get(id);
+        if (known === undefined || at < known)
+            first.set(id, at);
+    }
+    return first;
+}
+/**
+ * The figures over some counted asks. Without their first approvals — the
+ * index did not answer — the counts and the pay still stand and the timing
+ * says nothing: less, never wrong.
+ */
+function coverageOf(asks, approvals = new Map()) {
+    const answered = asks.filter((ask) => ask.approved > 0);
+    const minutes = [];
+    for (const ask of answered) {
+        const first = approvals.get(ask.id);
+        const posted = (0, facts_ts_1.chainMs)(ask.startDate) + exports.POSTING_BACKDATE_MS;
+        if (first !== undefined && Number.isFinite(posted))
+            minutes.push(Math.max(0, (first - posted) / 60_000));
+    }
+    const median = minutes.length >= exports.TIMED_MIN ? (0, trust_ts_1.medianOf)(minutes) : null;
+    const pays = asks.map(assemble_ts_1.payOf).filter((pay) => pay !== null);
+    const coins = new Map();
+    for (const pay of pays)
+        coins.set(pay.symbol, (coins.get(pay.symbol) ?? 0) + 1);
+    const symbol = [...coins].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))[0]?.[0];
+    const typical = symbol ? (0, trust_ts_1.medianOf)(pays.filter((pay) => pay.symbol === symbol).map((pay) => pay.value)) : null;
+    return {
+        asked: asks.length,
+        answered: answered.length,
+        medianMinutes: median === null ? null : Math.max(1, Math.round(median)),
+        timed: minutes.length,
+        typicalPay: symbol && typical !== null ? { value: typical >= 0.01 ? Math.round(typical * 100) / 100 : typical, symbol } : null
+    };
+}
+/** A wait, said the way a person would: minutes, then hours, then days. */
+function waitWords(minutes) {
+    if (minutes <= 1)
+        return "a minute";
+    if (minutes < 90)
+        return `${Math.round(minutes)} minutes`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 48)
+        return `${hours} hours`;
+    return `${Math.round(hours / 24)} days`;
+}
+/** "12 of 14 answered, usually within 9 minutes, around $0.80" — only what is known. */
+function coverageWords(coverage) {
+    if (coverage.asked === 0)
+        return `nothing asked in the last ${exports.COVERAGE_DAYS} days`;
+    const parts = [`${coverage.answered} of ${coverage.asked} answered`];
+    if (coverage.medianMinutes !== null)
+        parts.push(`usually within ${waitWords(coverage.medianMinutes)}`);
+    const pay = (0, format_ts_1.faceOf)(coverage.typicalPay);
+    if (pay)
+        parts.push(`around ${pay.text}`);
+    return parts.join(", ");
+}
+/** How much of the map one place stands for: about a city and its edges. */
+const CELL_DEGREES = 0.25;
+exports.PLACES_MAX = 5;
+/** A part of the map with fewer counted asks than this says too little to list. */
+exports.PLACE_MIN = 3;
+/** The town in a place's name: "Acre Road, Milnerton" is in Milnerton; a name with no comma is its own town. */
+function townOf(label) {
+    const parts = (label ?? "")
+        .split(",")
+        .map((one) => one.trim())
+        .filter(Boolean);
+    const town = parts[parts.length - 1];
+    return town && /\p{L}/u.test(town) && !/^\d/.test(town) ? town : null;
+}
+const round2 = (value) => Math.round(value * 100) / 100;
+/**
+ * The busiest parts of the map: counted asks in cells about a city across,
+ * the most asked first, each named for the town most of its asks name. A
+ * part whose asks name no town is left out: a place nobody can say is not a
+ * place a sentence can offer.
+ */
+function busiestPlaces(asks, limit = exports.PLACES_MAX) {
+    const cells = new Map();
+    for (const ask of asks) {
+        if (!ask.place)
+            continue;
+        const key = `${Math.floor(ask.place.lat / CELL_DEGREES)},${Math.floor(ask.place.lon / CELL_DEGREES)}`;
+        const members = cells.get(key);
+        if (members)
+            members.push(ask);
+        else
+            cells.set(key, [ask]);
+    }
+    const newest = (members) => Math.max(...members.map((ask) => Number(ask.id) || 0));
+    const out = [];
+    for (const members of [...cells.values()].filter((one) => one.length >= exports.PLACE_MIN).sort((a, b) => b.length - a.length || newest(b) - newest(a))) {
+        const towns = new Map();
+        for (const ask of members) {
+            const town = townOf(ask.place?.label);
+            if (town)
+                towns.set(town, (towns.get(town) ?? 0) + 1);
+        }
+        const label = [...towns].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))[0]?.[0];
+        if (!label)
+            continue;
+        const lat = members.reduce((sum, ask) => sum + ask.place.lat, 0) / members.length;
+        const lon = members.reduce((sum, ask) => sum + ask.place.lon, 0) / members.length;
+        out.push({ label, lat: round2(lat), lon: round2(lon), asks: members });
+        if (out.length === limit)
+            break;
+    }
+    return out;
+}
+//# sourceMappingURL=coverage.js.map

package/dist/cjs/data/board/coverage.js.map

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

package/dist/cjs/data/board/facts.d.ts

@@ -0,0 +1,63 @@
+import { type BoardPlace, type Kind, type PosterStats } from "./types.ts";
+/**
+ * What an ask's published terms and its claims say, read once — shared by the
+ * board's recency read (`threads.ts`) and the worker's catalogue, so the two
+ * can never disagree about where an ask is, what it wants, or what happened
+ * on it last.
+ */
+/**
+ * The place an ask names, out of its published terms — or nothing.
+ *
+ * Deliberately suspicious of its own input. These documents are fetched from
+ * a content address anybody can publish to, and a map plots what it is given:
+ * a gate carrying a string where a latitude should be, or a longitude of 900,
+ * would put somebody's ask in the ocean and look exactly like a fact. So the
+ * numbers are checked before they are believed, and anything that fails
+ * leaves the ask place-less — which the board and the map both handle, having
+ * to handle it for the many asks that never named one.
+ */
+export declare function placeIn(terms: Record<string, unknown> | null | undefined): BoardPlace | undefined;
+/** Everything the board needs out of one terms document, each field checked before it is believed. */
+export declare function askFacts(terms: Record<string, unknown> | null | undefined): {
+    deliverable: string | null;
+    kind: Kind;
+    campaign: string | null;
+    series: string | null;
+    place: BoardPlace | null;
+};
+/** How much of an ask's terms the screen reads beyond its title. Enough for every line a poster writes. */
+export declare const SCREEN_TEXT_MAX = 1500;
+/**
+ * The words in an ask's terms that a person wrote — the deliverable's prompt
+ * and every judged or attested line — for the screen to read beside the title
+ * (Part C). A harmful ask can keep a polite title and put its point in a line
+ * like "the number plate is readable", so the screen reads those too.
+ */
+export declare function screenTextOf(terms: Record<string, unknown> | null | undefined): string;
+/** How an ask came, as its terms say (Part D): only our own MCP's mark is read; anything else is nothing. */
+export declare const viaOf: (terms: Record<string, unknown> | null | undefined) => string | null;
+export interface ClaimLite {
+    collectionId: string;
+    agentAddress?: string | null;
+    submissionDate?: string | null;
+    evaluationByClaimId?: {
+        status?: number | null;
+        evaluationDate?: string | null;
+    } | null;
+}
+/** The last thing that happened on an ask, as the board's foot line says it. */
+export declare function lastEventOf(claims: ClaimLite[]): {
+    at: string;
+    line: string;
+    actor?: string;
+} | null;
+/** A chain time as epoch milliseconds, or NaN. Chain times carry no zone; they are UTC. */
+export declare const chainMs: (iso: string | null | undefined) => number;
+/**
+ * One poster's record from the claims on their asks (D1 of the plan): how
+ * many answers they approved in the window, and the median minutes from an
+ * answer to its approval — over the asks that pay at approval, which a pool
+ * does not (it holds a patch's pay until the site is clear).
+ */
+export declare function posterStatsOf(owner: string, claims: ClaimLite[], poolIds: ReadonlySet<string>, windowStart: number): PosterStats;
+//# sourceMappingURL=facts.d.ts.map

package/dist/cjs/data/board/facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../../../src/data/board/facts.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAiBjG;AAID,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,CAMhM;AAED,2GAA2G;AAC3G,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAWtF;AAED,6GAA6G;AAC7G,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,IAAiD,CAAC;AAErI,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mBAAmB,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACzF;AAOD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAepG;AAED,2FAA2F;AAC3F,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAIxD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAchI"}

package/dist/cjs/data/board/facts.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainMs = exports.viaOf = exports.SCREEN_TEXT_MAX = void 0;
+exports.placeIn = placeIn;
+exports.askFacts = askFacts;
+exports.screenTextOf = screenTextOf;
+exports.lastEventOf = lastEventOf;
+exports.posterStatsOf = posterStatsOf;
+const trust_ts_1 = require("./trust.js");
+const types_ts_1 = require("./types.js");
+/**
+ * What an ask's published terms and its claims say, read once — shared by the
+ * board's recency read (`threads.ts`) and the worker's catalogue, so the two
+ * can never disagree about where an ask is, what it wants, or what happened
+ * on it last.
+ */
+/**
+ * The place an ask names, out of its published terms — or nothing.
+ *
+ * Deliberately suspicious of its own input. These documents are fetched from
+ * a content address anybody can publish to, and a map plots what it is given:
+ * a gate carrying a string where a latitude should be, or a longitude of 900,
+ * would put somebody's ask in the ocean and look exactly like a fact. So the
+ * numbers are checked before they are believed, and anything that fails
+ * leaves the ask place-less — which the board and the map both handle, having
+ * to handle it for the many asks that never named one.
+ */
+function placeIn(terms) {
+    const criteria = Array.isArray(terms?.["criteria"]) ? terms["criteria"] : [];
+    for (const criterion of criteria) {
+        const gate = criterion?.["gate"];
+        if (!gate || gate["id"] !== "within-radius")
+            continue;
+        const lat = Number(gate["lat"]);
+        const lon = Number(gate["lon"]);
+        const metres = Number(gate["meters"]);
+        if (!Number.isFinite(lat) || Math.abs(lat) > 90)
+            continue;
+        if (!Number.isFinite(lon) || Math.abs(lon) > 180)
+            continue;
+        if (!Number.isFinite(metres) || metres <= 0)
+            continue;
+        const label = typeof gate["place"] === "string" ? gate["place"].trim().slice(0, 80) : "";
+        return { lat, lon, metres, ...(label ? { label } : {}) };
+    }
+    return undefined;
+}
+const TAG = /^[a-z0-9-]{1,64}$/;
+/** Everything the board needs out of one terms document, each field checked before it is believed. */
+function askFacts(terms) {
+    const raw = terms?.["deliverable"]?.type;
+    const deliverable = typeof raw === "string" && raw.length <= 24 ? raw : null;
+    const campaign = typeof terms?.["campaign"] === "string" && TAG.test(terms["campaign"]) ? terms["campaign"] : null;
+    const series = typeof terms?.["series"] === "string" && TAG.test(terms["series"]) ? terms["series"] : null;
+    return { deliverable, kind: (0, types_ts_1.kindOf)(deliverable, terms?.["criteria"]), campaign, series, place: placeIn(terms) ?? null };
+}
+/** How much of an ask's terms the screen reads beyond its title. Enough for every line a poster writes. */
+exports.SCREEN_TEXT_MAX = 1500;
+/**
+ * The words in an ask's terms that a person wrote — the deliverable's prompt
+ * and every judged or attested line — for the screen to read beside the title
+ * (Part C). A harmful ask can keep a polite title and put its point in a line
+ * like "the number plate is readable", so the screen reads those too.
+ */
+function screenTextOf(terms) {
+    const lines = [];
+    const prompt = terms?.["deliverable"]?.prompt;
+    if (typeof prompt === "string")
+        lines.push(prompt);
+    const criteria = Array.isArray(terms?.["criteria"]) ? terms["criteria"] : [];
+    for (const criterion of criteria)
+        if (typeof criterion?.["text"] === "string")
+            lines.push(criterion["text"]);
+    return lines
+        .map((line) => line.replace(/\s+/g, " ").trim())
+        .filter(Boolean)
+        .join("\n")
+        .slice(0, exports.SCREEN_TEXT_MAX);
+}
+/** How an ask came, as its terms say (Part D): only our own MCP's mark is read; anything else is nothing. */
+const viaOf = (terms) => (terms?.["via"] === "mcp" ? "mcp" : null);
+exports.viaOf = viaOf;
+/* 5 (FLAGGED) is legacy: nothing has produced it since the oracle migration
+   (plan D6/T-A6), and the word is kept only so rows ruled before it still
+   read as what they were. */
+const EVALUATION_WORD = { 1: "approved", 2: "rejected", 3: "disputed", 4: "invalidated", 5: "needs a person" };
+/** The last thing that happened on an ask, as the board's foot line says it. */
+function lastEventOf(claims) {
+    let best = null;
+    for (const claim of claims) {
+        if (claim.submissionDate && (!best || claim.submissionDate > best.at)) {
+            best = { at: claim.submissionDate, line: "answered", ...(claim.agentAddress ? { actor: claim.agentAddress } : {}) };
+        }
+        const evaluation = claim.evaluationByClaimId;
+        if (evaluation?.evaluationDate && (!best || evaluation.evaluationDate > best.at)) {
+            /* "checked — pending" stated two states at once. A verdict names itself;
+               an evaluation row with no verdict yet is simply still being checked. */
+            const word = EVALUATION_WORD[evaluation.status ?? 0];
+            best = { at: evaluation.evaluationDate, line: word ? `reviewed. ${word}` : "in review" };
+        }
+    }
+    return best;
+}
+/** A chain time as epoch milliseconds, or NaN. Chain times carry no zone; they are UTC. */
+const chainMs = (iso) => {
+    if (!iso)
+        return NaN;
+    const text = iso.trim();
+    return Date.parse(/(?:Z|[+-]\d{2}:?\d{2})$/i.test(text) ? text : `${text}Z`);
+};
+exports.chainMs = chainMs;
+/**
+ * One poster's record from the claims on their asks (D1 of the plan): how
+ * many answers they approved in the window, and the median minutes from an
+ * answer to its approval — over the asks that pay at approval, which a pool
+ * does not (it holds a patch's pay until the site is clear).
+ */
+function posterStatsOf(owner, claims, poolIds, windowStart) {
+    let paid = 0;
+    const minutes = [];
+    for (const claim of claims) {
+        const evaluation = claim.evaluationByClaimId;
+        if (evaluation?.status !== 1)
+            continue;
+        const submitted = (0, exports.chainMs)(claim.submissionDate);
+        if (!Number.isFinite(submitted) || submitted < windowStart)
+            continue;
+        paid += 1;
+        if (poolIds.has(String(claim.collectionId)))
+            continue;
+        const approved = (0, exports.chainMs)(evaluation.evaluationDate);
+        if (Number.isFinite(approved) && approved >= submitted)
+            minutes.push((approved - submitted) / 60_000);
+    }
+    return { owner, paid, medianMinutes: (0, trust_ts_1.medianOf)(minutes), timed: minutes.length };
+}
+//# sourceMappingURL=facts.js.map

package/dist/cjs/data/board/facts.js.map

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

package/dist/cjs/data/board/fixtures.d.ts

@@ -0,0 +1,21 @@
+import type { CatalogAsk, PosterStats } from "./types.ts";
+/**
+ * A catalogue row with every field sensible, for the tests — overridden per
+ * case. Not imported by anything that ships.
+ */
+export declare function ask(id: string | number, over?: Partial<CatalogAsk>): CatalogAsk;
+export declare const poster: (owner: string, paid: number, medianMinutes?: number | null, timed?: number) => PosterStats;
+/** Ljubljana's centre, and places a known distance from it. */
+export declare const CENTRE: {
+    lat: number;
+    lon: number;
+};
+/** About `km` kilometres due north of the centre. */
+export declare const north: (km: number, metres?: number, label?: string) => {
+    label?: string | undefined;
+    lat: number;
+    lon: number;
+    metres: number;
+};
+export declare const NOW: Date;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/cjs/data/board/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../../src/data/board/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CA4BnF;AAED,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,EAAE,gBAAe,MAAM,GAAG,IAAW,EAAE,cAAY,KAAG,WAAsD,CAAC;AAE/J,+DAA+D;AAC/D,eAAO,MAAM,MAAM;;;CAA6B,CAAC;AACjD,qDAAqD;AACrD,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,EAAE,eAAY,EAAE,QAAQ,MAAM;;;;;CAA6F,CAAC;AAE5J,eAAO,MAAM,GAAG,MAAmC,CAAC"}

package/dist/cjs/data/board/fixtures.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOW = exports.north = exports.CENTRE = exports.poster = void 0;
+exports.ask = ask;
+/**
+ * A catalogue row with every field sensible, for the tests — overridden per
+ * case. Not imported by anything that ships.
+ */
+function ask(id, over = {}) {
+    return {
+        id: String(id),
+        title: `Ask ${id}`,
+        named: true,
+        admin: `ixo1admin${id}`,
+        owner: "ixo1ownerana",
+        state: 0,
+        payDenom: "upay",
+        payBase: 1_000_000,
+        pool: false,
+        quota: 1,
+        count: 0,
+        approved: 0,
+        disputed: 0,
+        startDate: "2026-09-29T10:00:00",
+        endDate: "2026-10-29T10:00:00",
+        lastEventAt: null,
+        lastEventLine: "opened",
+        lastEventActor: null,
+        deliverable: "photo",
+        kind: "photo",
+        campaign: null,
+        series: null,
+        place: null,
+        ours: true,
+        ...over
+    };
+}
+const poster = (owner, paid, medianMinutes = null, timed = paid) => ({ owner, paid, medianMinutes, timed });
+exports.poster = poster;
+/** Ljubljana's centre, and places a known distance from it. */
+exports.CENTRE = { lat: 46.05, lon: 14.51 };
+/** About `km` kilometres due north of the centre. */
+const north = (km, metres = 150, label) => ({ lat: exports.CENTRE.lat + km / 111.2, lon: exports.CENTRE.lon, metres, ...(label ? { label } : {}) });
+exports.north = north;
+exports.NOW = new Date("2026-09-29T12:00:00Z");
+//# sourceMappingURL=fixtures.js.map

package/dist/cjs/data/board/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../../src/data/board/fixtures.ts"],"names":[],"mappings":";;;AAMA,kBA4BC;AAhCD;;;GAGG;AACH,SAAgB,GAAG,CAAC,EAAmB,EAAE,OAA4B,EAAE;IACrE,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;QACd,KAAK,EAAE,OAAO,EAAE,EAAE;QAClB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,YAAY,EAAE,EAAE;QACvB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,OAAO;QACpB,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;QACV,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAEM,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,gBAA+B,IAAI,EAAE,KAAK,GAAG,IAAI,EAAe,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;AAAlJ,QAAA,MAAM,UAA4I;AAE/J,+DAA+D;AAClD,QAAA,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACjD,qDAAqD;AAC9C,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,MAAM,GAAG,GAAG,EAAE,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,cAAM,CAAC,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,cAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAA/I,QAAA,KAAK,SAA0I;AAE/I,QAAA,GAAG,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/cjs/data/board/query.d.ts

@@ -0,0 +1,12 @@
+import { type Activity, type BoardQuery, type Kind } from "./types.ts";
+export { DEFAULT_KM, DEFAULT_SIZE, EMPTY_QUERY, MAX_KM, MAX_Q, MAX_SIZE, queryString, roundPoint } from "./url.ts";
+export declare function parsePoint(raw: string | null | undefined): {
+    lat: number;
+    lon: number;
+} | null;
+export declare function parseQuery(params: URLSearchParams): BoardQuery;
+/** Kinds as a set, for the rail and the sheet. */
+export declare const kindSet: (kinds: readonly Kind[]) => Set<Kind>;
+/** Activities as a set. */
+export declare const activitySet: (does: readonly Activity[]) => Set<Activity>;
+//# sourceMappingURL=query.d.ts.map

package/dist/cjs/data/board/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/data/board/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,QAAQ,EAAmB,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAGpH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAwBnH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM9F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,CA4B9D;AAED,kDAAkD;AAClD,eAAO,MAAM,OAAO,GAAI,OAAO,SAAS,IAAI,EAAE,KAAG,GAAG,CAAC,IAAI,CAAmB,CAAC;AAE7E,2BAA2B;AAC3B,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,QAAQ,EAAE,KAAG,GAAG,CAAC,QAAQ,CAAkB,CAAC"}