@ixo/openhands-sdk 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activitySet = exports.kindSet = exports.roundPoint = exports.queryString = exports.MAX_SIZE = exports.MAX_Q = exports.MAX_KM = exports.EMPTY_QUERY = exports.DEFAULT_SIZE = exports.DEFAULT_KM = void 0;
+exports.parsePoint = parsePoint;
+exports.parseQuery = parseQuery;
+const types_ts_1 = require("./types.js");
+const url_ts_1 = require("./url.js");
+var url_ts_2 = require("./url.js");
+Object.defineProperty(exports, "DEFAULT_KM", { enumerable: true, get: function () { return url_ts_2.DEFAULT_KM; } });
+Object.defineProperty(exports, "DEFAULT_SIZE", { enumerable: true, get: function () { return url_ts_2.DEFAULT_SIZE; } });
+Object.defineProperty(exports, "EMPTY_QUERY", { enumerable: true, get: function () { return url_ts_2.EMPTY_QUERY; } });
+Object.defineProperty(exports, "MAX_KM", { enumerable: true, get: function () { return url_ts_2.MAX_KM; } });
+Object.defineProperty(exports, "MAX_Q", { enumerable: true, get: function () { return url_ts_2.MAX_Q; } });
+Object.defineProperty(exports, "MAX_SIZE", { enumerable: true, get: function () { return url_ts_2.MAX_SIZE; } });
+Object.defineProperty(exports, "queryString", { enumerable: true, get: function () { return url_ts_2.queryString; } });
+Object.defineProperty(exports, "roundPoint", { enumerable: true, get: function () { return url_ts_2.roundPoint; } });
+/**
+ * A board query to and from a URL — the one grammar the page, the app's
+ * proxy, the worker and the MCP all speak, so `?kind=photo` means the same
+ * thing wherever it is typed.
+ *
+ * Everything is bounded on the way in, whoever sent it: a query string is
+ * something a stranger writes. And a location is rounded to two decimals
+ * (about a kilometre) before it is ever put in a URL — close enough to rank
+ * by, too coarse to be where somebody lives, and coarse enough that the edge
+ * can cache one answer for everybody in the same square kilometre.
+ */
+const TAG = /^[a-z0-9-]{1,64}$/;
+const ADDRESS = /^ixo1[02-9ac-hj-np-z]{20,80}$/;
+const clampInt = (raw, fallback, low, high) => {
+    /* Absent is the default, not zero: `Number(null)` is 0, which would clamp a missing size to one row. */
+    if (raw === null || raw.trim() === "")
+        return fallback;
+    const value = Math.floor(Number(raw));
+    return Number.isFinite(value) ? Math.min(high, Math.max(low, value)) : fallback;
+};
+function parsePoint(raw) {
+    if (!raw)
+        return null;
+    const [a, b] = raw.split(",").map((part) => Number(part.trim()));
+    if (a === undefined || b === undefined || !Number.isFinite(a) || !Number.isFinite(b))
+        return null;
+    if (Math.abs(a) > 90 || Math.abs(b) > 180)
+        return null;
+    return (0, url_ts_1.roundPoint)({ lat: a, lon: b });
+}
+function parseQuery(params) {
+    const kinds = (params.get("kind") ?? "")
+        .split(",")
+        .map((one) => one.trim())
+        .filter(types_ts_1.isKind);
+    const does = (params.get("does") ?? "")
+        .split(",")
+        .map((one) => one.trim())
+        .filter(types_ts_1.isActivity);
+    const order = params.get("order");
+    const campaign = (params.get("campaign") ?? "").trim();
+    const owner = (params.get("owner") ?? "").trim();
+    const pay = Number(params.get("pay"));
+    return {
+        near: parsePoint(params.get("near")),
+        km: clampInt(params.get("km"), url_ts_1.DEFAULT_KM, 1, url_ts_1.MAX_KM),
+        kinds: [...new Set(kinds)],
+        does: [...new Set(does)],
+        minPay: Number.isFinite(pay) && pay > 0 ? Math.min(pay, 1_000_000) : 0,
+        q: (params.get("q") ?? "").replace(/\s+/g, " ").trim().slice(0, url_ts_1.MAX_Q),
+        order: types_ts_1.ORDERS.includes(order) ? order : "best",
+        campaign: TAG.test(campaign) ? campaign : "",
+        owner: ADDRESS.test(owner) ? owner : "",
+        series: /^[a-z0-9]{1,32}$/.test(params.get("series") ?? "") ? params.get("series") : "",
+        view: params.get("view") === "rest" ? "rest" : "lead",
+        page: clampInt(params.get("page"), 1, 1, 1000),
+        size: clampInt(params.get("size"), url_ts_1.DEFAULT_SIZE, 1, url_ts_1.MAX_SIZE)
+    };
+}
+/** Kinds as a set, for the rail and the sheet. */
+const kindSet = (kinds) => new Set(kinds);
+exports.kindSet = kindSet;
+/** Activities as a set. */
+const activitySet = (does) => new Set(does);
+exports.activitySet = activitySet;
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../src/data/board/query.ts"],"names":[],"mappings":";;;AA2BA,gCAMC;AAED,gCA4BC;AA/DD,yCAAoH;AACpH,qCAAsG;AAEtG,mCAAmH;AAA1G,oGAAA,UAAU,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,gGAAA,MAAM,OAAA;AAAE,+FAAA,KAAK,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,oGAAA,UAAU,OAAA;AAEhG;;;;;;;;;;GAUG;AAEH,MAAM,GAAG,GAAG,mBAAmB,CAAC;AAChC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAEhD,MAAM,QAAQ,GAAG,CAAC,GAAkB,EAAE,QAAgB,EAAE,GAAW,EAAE,IAAY,EAAU,EAAE;IAC3F,wGAAwG;IACxG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClF,CAAC,CAAC;AAEF,SAAgB,UAAU,CAAC,GAA8B;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,IAAA,mBAAU,EAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,UAAU,CAAC,MAAuB;IAChD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SACrC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,iBAAM,CAAC,CAAC;IAClB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SACpC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,qBAAU,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,mBAAU,EAAE,CAAC,EAAE,eAAM,CAAC;QACrD,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAK,CAAC;QACtE,KAAK,EAAE,iBAAM,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC,CAAC,CAAE,KAAoB,CAAC,CAAC,CAAC,MAAM;QAC5E,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC5C,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACvC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,EAAE;QACnG,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACrD,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;QAC9C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,qBAAY,EAAE,CAAC,EAAE,iBAAQ,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,kDAAkD;AAC3C,MAAM,OAAO,GAAG,CAAC,KAAsB,EAAa,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;AAAhE,QAAA,OAAO,WAAyD;AAE7E,2BAA2B;AACpB,MAAM,WAAW,GAAG,CAAC,IAAyB,EAAiB,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AAA1E,QAAA,WAAW,eAA+D"}

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

@@ -0,0 +1,22 @@
+import type { BoardOrder } from "./types.ts";
+/** Great-circle distance in kilometres. */
+export declare function distanceKm(a: {
+    lat: number;
+    lon: number;
+}, b: {
+    lat: number;
+    lon: number;
+}): number;
+export { kmWords } from "./words.ts";
+/** What the ranking reads off a card, however many asks the card stands for. */
+export interface SortKeys {
+    km?: number;
+    /** In display units. A pool pays what backers put in, which is no figure: 0. */
+    pay: number;
+    /** The newest member's collection id. */
+    newest: number;
+    /** The soonest end among members, as epoch ms; Infinity when none ends. */
+    endsAt: number;
+}
+export declare function rankKeys<T extends SortKeys>(cards: T[], order: BoardOrder, near: boolean, reach: number): T[];
+//# sourceMappingURL=rank.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../../../src/data/board/rank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkB7C,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMnG;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAc7G"}

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

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kmWords = void 0;
+exports.distanceKm = distanceKm;
+exports.rankKeys = rankKeys;
+/**
+ * The order of the board, in rules a person can be told in a sentence.
+ *
+ * **Best for you**: when we know where you are, what you can reach soonest —
+ * everything within your radius, closest first; then work you can do from
+ * anywhere, best paid first; then the rest, closest first. When we do not know
+ * where you are, the newest first. Nothing else goes into it, and nothing ever
+ * will that could not be said as plainly.
+ *
+ * `newest` is the posting order — collection ids only ever grow — rather than
+ * a start date, which is whatever the poster wrote (testnet holds one dated
+ * 2027) and so no order at all.
+ */
+const EARTH_KM = 6371;
+/** Great-circle distance in kilometres. */
+function distanceKm(a, b) {
+    const rad = Math.PI / 180;
+    const dLat = (b.lat - a.lat) * rad;
+    const dLon = (b.lon - a.lon) * rad;
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * rad) * Math.cos(b.lat * rad) * Math.sin(dLon / 2) ** 2;
+    return 2 * EARTH_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+var words_ts_1 = require("./words.js");
+Object.defineProperty(exports, "kmWords", { enumerable: true, get: function () { return words_ts_1.kmWords; } });
+function rankKeys(cards, order, near, reach) {
+    const tier = (card) => (card.km === undefined ? 1 : card.km <= reach ? 0 : 2);
+    const byNewest = (a, b) => b.newest - a.newest;
+    const sorted = [...cards];
+    if (order === "new")
+        return sorted.sort(byNewest);
+    if (order === "pay")
+        return sorted.sort((a, b) => b.pay - a.pay || byNewest(a, b));
+    if (order === "ending")
+        return sorted.sort((a, b) => a.endsAt - b.endsAt || byNewest(a, b));
+    if (!near)
+        return sorted.sort(byNewest);
+    return sorted.sort((a, b) => {
+        const t = tier(a) - tier(b);
+        if (t !== 0)
+            return t;
+        if (tier(a) === 1)
+            return b.pay - a.pay || byNewest(a, b);
+        return (a.km ?? 0) - (b.km ?? 0) || byNewest(a, b);
+    });
+}
+//# sourceMappingURL=rank.js.map

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

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

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

@@ -0,0 +1,102 @@
+import type { ThreadListItem } from "../threads.ts";
+import { type BoardGroup, type CampaignMembers } from "./assemble.ts";
+import type { CoverageAnswer, CoveragePlacesAnswer } from "./coverage.ts";
+import { type BoardAnswer, type BoardQuery, type BoardRow, type CatalogAsk, type ClustersAnswer, type Screen, type Trust } from "./types.ts";
+/**
+ * The board, read by the app's server — from the worker's catalogue, or, when
+ * the worker does not answer, from the index directly, the way the board
+ * always read it. Server-only: this pulls the index client. Client code
+ * imports `board/types` and `board/query`, never this.
+ *
+ * **Degraded is normal, not exceptional** (PRODUCT.md). A worker that is
+ * down, not deployed yet, or deployed without its migration answers 503 or
+ * nothing at all, and the page renders from the fallback: fewer rows (the
+ * newest thirty plus forty of ours), no trust figures, no folds it cannot
+ * compute — but never a blank board.
+ */
+export interface WorkerRead {
+    /** The worker's base URL. Empty: go straight to the fallback. */
+    workerUrl: string;
+    /**
+     * The app's proxy secret, so the worker can tell its own app from a stranger.
+     *
+     * The only thing a read may carry (scale review 2026-10, A10): it used to
+     * take arbitrary headers and was handed the caller's address, and Next's
+     * fetch cache keys on headers — one cache entry per visitor. A secret is
+     * the same on every read, so the cache stays shared; a caller is not
+     * representable here at all.
+     */
+    proxySecret?: string;
+    /** How long to wait for the worker before the fallback. Default 2.5 s: an interactive read (B13). */
+    timeoutMs?: number;
+    /** Injected in tests; `loadThreads` + `gateGranters` otherwise. */
+    fallback?: () => Promise<CatalogAsk[]>;
+    fetchImpl?: typeof fetch;
+}
+/** What waits for the worker before the fallback, unless the reader says otherwise. */
+export declare const WORKER_TIMEOUT_MS = 2500;
+/** The headers a worker read carries: what it accepts, and the proxy secret when there is one. Never a caller. */
+export declare const workerHeaders: (read: Pick<WorkerRead, "proxySecret">) => Record<string, string>;
+/** Today's recency read, as catalogue rows. No owner, so no trust and no poster cap beyond the escrow account. */
+export declare function catalogFromThreads(threads: ThreadListItem[], granted: ReadonlySet<string>): CatalogAsk[];
+export declare function loadBoard(query: BoardQuery, read: WorkerRead): Promise<BoardAnswer>;
+export declare function loadClusters(query: BoardQuery, view: {
+    south: number;
+    west: number;
+    north: number;
+    east: number;
+    zoom: number;
+}, read: WorkerRead): Promise<ClustersAnswer>;
+export interface SeriesAnswer {
+    v: 1;
+    key: string;
+    title: string;
+    rows: BoardRow[];
+    open: number;
+    count: number;
+    trust: Trust;
+}
+export declare function loadSeries(key: string, query: BoardQuery, read: WorkerRead): Promise<SeriesAnswer | null>;
+export interface TripAnswer {
+    v: 1;
+    lead: string;
+    title: string;
+    rows: BoardRow[];
+    open: number;
+}
+/** A trip's open members (Part E) — the catalogue's, or drawn here from the index when the worker cannot answer. */
+export declare function loadTrip(lead: string, query: BoardQuery, read: WorkerRead): Promise<TripAnswer | null>;
+export interface CampaignGroupAnswer extends CampaignMembers {
+    v: 1;
+    tag: string;
+}
+/**
+ * One campaign's page (IXO-5270): the worker's catalogue, or — where the
+ * worker has not been deployed with the route yet — the index directly, the
+ * way `loadSeries` falls back.
+ */
+export declare function loadCampaignGroup(tag: string, query: BoardQuery, read: WorkerRead): Promise<CampaignGroupAnswer | null>;
+/**
+ * The group an ask folds into, for its page's way back (IXO-5271). The worker
+ * only: a nicety is never worth reading the whole index for, and the ask page
+ * falls back to the campaign its own terms name.
+ */
+/**
+ * Where one ask sits on the board — the group it folds into, and what the
+ * screen made of it (Part C) — or null when the worker could not say.
+ */
+export declare function loadAskOnBoard(id: string, read: WorkerRead): Promise<{
+    group: BoardGroup | null;
+    screen: Screen | null;
+} | null>;
+/** How many asks agents posted here through our MCP in the last week, or null when the worker cannot say (Part D). */
+export declare function loadAgentWeek(read: WorkerRead): Promise<number | null>;
+/** How the asks near a point were answered over ninety days (Part G), or null when the worker cannot say. */
+export declare function loadCoverage(near: {
+    lat: number;
+    lon: number;
+}, km: number, read: WorkerRead): Promise<CoverageAnswer | null>;
+/** The busiest places' figures, for the agents page (Part G), or null when the worker cannot say. */
+export declare function loadCoveragePlaces(read: WorkerRead): Promise<CoveragePlacesAnswer | null>;
+export declare function loadGroupOf(id: string, read: WorkerRead): Promise<BoardGroup | null>;
+//# sourceMappingURL=read.d.ts.map

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

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

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

@@ -0,0 +1,211 @@
+"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.workerHeaders = exports.WORKER_TIMEOUT_MS = void 0;
+exports.catalogFromThreads = catalogFromThreads;
+exports.loadBoard = loadBoard;
+exports.loadClusters = loadClusters;
+exports.loadSeries = loadSeries;
+exports.loadTrip = loadTrip;
+exports.loadCampaignGroup = loadCampaignGroup;
+exports.loadAskOnBoard = loadAskOnBoard;
+exports.loadAgentWeek = loadAgentWeek;
+exports.loadCoverage = loadCoverage;
+exports.loadCoveragePlaces = loadCoveragePlaces;
+exports.loadGroupOf = loadGroupOf;
+const assemble_ts_1 = require("./assemble.js");
+const query_ts_1 = require("./query.js");
+const types_ts_1 = require("./types.js");
+/** What waits for the worker before the fallback, unless the reader says otherwise. */
+exports.WORKER_TIMEOUT_MS = 2_500;
+/** The headers a worker read carries: what it accepts, and the proxy secret when there is one. Never a caller. */
+const workerHeaders = (read) => ({
+    accept: "application/json",
+    ...(read.proxySecret ? { "x-openhands-proxy": read.proxySecret } : {})
+});
+exports.workerHeaders = workerHeaders;
+/* `seen` hears the worker's response before its body is read — how a reader learns a header such as
+   `x-board-truncated` without every caller of this helper changing shape. */
+async function fromWorker(path, read, seen) {
+    if (!read.workerUrl)
+        return null;
+    try {
+        const response = await (read.fetchImpl ?? fetch)(`${read.workerUrl.replace(/\/$/, "")}${path}`, {
+            headers: (0, exports.workerHeaders)(read),
+            signal: AbortSignal.timeout(read.timeoutMs ?? exports.WORKER_TIMEOUT_MS),
+            /* Fifteen seconds, the board's own clock: the page stays statically
+               revalidated rather than rendering per visitor. `next` is Next's own
+               addition to RequestInit, absent from the plain lib. */
+            next: { revalidate: 15 }
+        });
+        if (!response.ok)
+            return null;
+        seen?.(response);
+        return (await response.json());
+    }
+    catch {
+        return null;
+    }
+}
+/** A symbol back to its base denom, for the fallback's rows. Six decimals, as every coin this board pays in has. */
+const denomFor = (symbol) => `u${symbol.toLowerCase()}`;
+/** Today's recency read, as catalogue rows. No owner, so no trust and no poster cap beyond the escrow account. */
+function catalogFromThreads(threads, granted) {
+    return threads.map((thread) => ({
+        id: thread.id,
+        title: thread.title,
+        named: thread.named,
+        admin: thread.admin,
+        owner: null,
+        state: thread.state,
+        payDenom: thread.pays ? denomFor(thread.pays.symbol) : null,
+        payBase: thread.pool ? 1 : thread.pays ? Math.round(thread.pays.value * 1_000_000) : 0,
+        pool: Boolean(thread.pool),
+        quota: Number(thread.quota) || 0,
+        count: thread.count,
+        approved: thread.approved,
+        disputed: thread.disputed,
+        startDate: thread.lastEventAt,
+        endDate: thread.endDate,
+        lastEventAt: thread.lastEventAt,
+        lastEventLine: thread.lastEventLine,
+        lastEventActor: thread.lastEventActor ?? null,
+        deliverable: thread.deliverable ?? null,
+        kind: (0, types_ts_1.kindOf)(thread.deliverable),
+        campaign: thread.campaign ?? null,
+        series: null,
+        place: thread.place ?? null,
+        ours: granted.has(thread.admin)
+    }));
+}
+async function defaultFallback() {
+    const [{ loadThreads }, { gateGranters }] = await Promise.all([Promise.resolve().then(() => __importStar(require("../threads.js"))), Promise.resolve().then(() => __importStar(require("../granters.js")))]);
+    const [threads, granted] = await Promise.all([loadThreads(), gateGranters().catch(() => [])]);
+    return catalogFromThreads(threads, new Set(granted));
+}
+const fallbackOf = (read) => read.fallback ?? defaultFallback;
+const none = new Map();
+async function loadBoard(query, read) {
+    /* The worker says `x-board-truncated: 1` when the open set held more asks than one read
+       loads; the app read it nowhere (final review 2026-10, WN9e #8). Carried on the
+       payload so the list can say it shows the newest, rather than imply it shows all. */
+    let truncated = false;
+    const answer = await fromWorker(`/board${(0, query_ts_1.queryString)(query)}`, read, (response) => {
+        truncated = response.headers.get("x-board-truncated") === "1";
+    });
+    if (answer?.v === 1)
+        return { ...answer, source: "catalogue", ...(truncated ? { truncated: true } : {}) };
+    const catalog = await fallbackOf(read)().catch(() => []);
+    return { ...(0, assemble_ts_1.assembleBoard)(catalog, none, query, new Date(), { posterCap: 0 }), source: "fallback" };
+}
+async function loadClusters(query, view, read) {
+    const bbox = `bbox=${[view.south, view.west, view.north, view.east].map((one) => Math.round(one * 1000) / 1000).join(",")}&zoom=${Math.floor(view.zoom)}`;
+    const search = (0, query_ts_1.queryString)(query);
+    const answer = await fromWorker(`/board/clusters${search ? `${search}&` : "?"}${bbox}`, read);
+    if (answer?.v === 1)
+        return { ...answer, source: "catalogue" };
+    const catalog = await fallbackOf(read)().catch(() => []);
+    return { ...(0, assemble_ts_1.clustersOf)(catalog, none, query, view), source: "fallback" };
+}
+async function loadSeries(key, query, read) {
+    if (!/^[a-z0-9]{1,32}$/.test(key))
+        return null;
+    const answer = await fromWorker(`/board/series/${key}${(0, query_ts_1.queryString)(query)}`, read);
+    if (answer?.v === 1)
+        return answer;
+    const catalog = await fallbackOf(read)().catch(() => []);
+    const found = (0, assemble_ts_1.seriesMembers)(catalog, none, key, query, new Date());
+    return found ? { v: 1, key, ...found } : null;
+}
+/** A trip's open members (Part E) — the catalogue's, or drawn here from the index when the worker cannot answer. */
+async function loadTrip(lead, query, read) {
+    if (!/^\d{1,12}$/.test(lead))
+        return null;
+    const answer = await fromWorker(`/board/trip/${lead}${(0, query_ts_1.queryString)(query)}`, read);
+    if (answer?.v === 1)
+        return answer;
+    const catalog = await fallbackOf(read)().catch(() => []);
+    const found = (0, assemble_ts_1.tripMembers)(catalog, none, lead, query, new Date());
+    return found ? { v: 1, lead, ...found } : null;
+}
+/**
+ * One campaign's page (IXO-5270): the worker's catalogue, or — where the
+ * worker has not been deployed with the route yet — the index directly, the
+ * way `loadSeries` falls back.
+ */
+async function loadCampaignGroup(tag, query, read) {
+    if (!/^[a-z0-9-]{1,64}$/.test(tag))
+        return null;
+    const answer = await fromWorker(`/board/campaign/${tag}${(0, query_ts_1.queryString)(query)}`, read);
+    if (answer?.v === 1)
+        return answer;
+    const catalog = await fallbackOf(read)().catch(() => []);
+    const found = (0, assemble_ts_1.campaignMembers)(catalog, none, tag, query, new Date());
+    return found ? { v: 1, tag, ...found } : null;
+}
+/**
+ * The group an ask folds into, for its page's way back (IXO-5271). The worker
+ * only: a nicety is never worth reading the whole index for, and the ask page
+ * falls back to the campaign its own terms name.
+ */
+/**
+ * Where one ask sits on the board — the group it folds into, and what the
+ * screen made of it (Part C) — or null when the worker could not say.
+ */
+async function loadAskOnBoard(id, read) {
+    if (!/^\d{1,12}$/.test(id))
+        return null;
+    const answer = await fromWorker(`/board/of/${id}`, read);
+    return answer?.v === 1 ? { group: answer.group, screen: answer.screen ?? null } : null;
+}
+/** How many asks agents posted here through our MCP in the last week, or null when the worker cannot say (Part D). */
+async function loadAgentWeek(read) {
+    const answer = await fromWorker("/board/agents", read);
+    return answer?.v === 1 && typeof answer.asked === "number" ? answer.asked : null;
+}
+/** How the asks near a point were answered over ninety days (Part G), or null when the worker cannot say. */
+async function loadCoverage(near, km, read) {
+    const answer = await fromWorker(`/board/coverage?near=${near.lat},${near.lon}&km=${km}`, read);
+    return answer?.v === 1 && typeof answer.asked === "number" ? answer : null;
+}
+/** The busiest places' figures, for the agents page (Part G), or null when the worker cannot say. */
+async function loadCoveragePlaces(read) {
+    const answer = await fromWorker("/board/coverage/places", read);
+    return answer?.v === 1 && Array.isArray(answer.places) ? answer : null;
+}
+async function loadGroupOf(id, read) {
+    return (await loadAskOnBoard(id, read))?.group ?? null;
+}
+//# sourceMappingURL=read.js.map

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

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

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

@@ -0,0 +1,50 @@
+import type { CatalogAsk } from "./types.ts";
+/**
+ * What a series is (D4 of docs/verified-work-board-volume-plan.md).
+ *
+ * An agent that needs two hundred storefronts photographed posts two hundred
+ * asks, one per address — each its own escrow, each paid on its own approval.
+ * On a board that is two hundred cards saying the same sentence with a
+ * different number in it, which is not a market, it is a wall. So asks that
+ * are plainly one job fold into one card, in one of two ways:
+ *
+ * - **Explicitly**: whoever posted them froze the same `terms.series` tag into
+ *   each (the MCP's `post_ask` takes it). Two or more open members fold.
+ * - **By shape**: `min` or more asks from one poster, of one kind, paying the
+ *   same amount, whose sentences are the same once the numbers and the place
+ *   are taken out, posted within a day of each other. A batch is a batch
+ *   whether or not its poster thought to say so.
+ *
+ * A series card says the same words either way. The key is stable across
+ * requests (it is what `/board/series/<key>` names), and says nothing about
+ * the poster: a short hash, not an address.
+ */
+export declare const SERIES_MIN = 5;
+/** Consecutive members further apart than this are two batches, not one. */
+export declare const BATCH_GAP_MS: number;
+/** FNV-1a over UTF-16 units, as eight hex digits. Stable, dependency-free, not a secret. */
+export declare function shortHash(text: string): string;
+/**
+ * A sentence with its particulars taken out: lower case, no digits, and
+ * nothing from the first place-clause on ("…at Trubarjeva cesta 12",
+ * "…, within 150 m of…", "… — near …"). What is left is the job.
+ */
+export declare function normalizedTitle(title: string): string;
+/**
+ * A series card's own sentence: the words every member starts with, cut back
+ * to a whole word and past any dangling preposition. Falls back to the first
+ * member's sentence when the members share too little to say anything.
+ */
+export declare function seriesTitle(titles: string[]): string;
+/** The part of a member's sentence that the series title does not already say — its address, usually. */
+export declare function memberLabel(title: string, series: string): string;
+/**
+ * Asks grouped into series, and the rest. `asks` may be any set — the open
+ * ones for the board, every known one for a series' own count — and the keys
+ * come out the same for the same members.
+ */
+export declare function groupSeries(asks: CatalogAsk[], min?: number): {
+    groups: Map<string, CatalogAsk[]>;
+    loose: CatalogAsk[];
+};
+//# sourceMappingURL=series.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../../../../src/data/board/series.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,4EAA4E;AAC5E,eAAO,MAAM,YAAY,QAAmB,CAAC;AAE7C,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBpD;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAQD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,GAAE,MAAmB,GAAG;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAqDpI"}