@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/cjs/data/linked.js

@@ -0,0 +1,142 @@
+"use strict";
+/** Server-side resolution of linked identities. Never imported by client code. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LINK_CHUNK = void 0;
+exports.linkedPrimary = linkedPrimary;
+exports.linkedPrimaries = linkedPrimaries;
+exports.linkedPrimariesStrict = linkedPrimariesStrict;
+const gql_ts_1 = require("./gql.js");
+const didOf = (address) => `did:ixo:${address}`;
+const addressOf = (did) => (did.startsWith("did:ixo:") && !did.startsWith("did:ixo:entity:") ? did.slice("did:ixo:".length) : "");
+/* A short cache: a link is a chain fact and does not change often, and this is
+   read once per address on list pages. */
+const CACHE_SECONDS = 300;
+const controllersOf = (node) => {
+    const raw = node?.controller;
+    if (!raw)
+        return [];
+    /* Blocksync types `iid.controller` as String but returns an array
+       (INFRA §2.2 — a trap worth not rediscovering). */
+    return Array.isArray(raw) ? raw : [raw];
+};
+async function documentsFor(dids) {
+    if (dids.length === 0)
+        return new Map();
+    const list = dids.map((did) => JSON.stringify(did)).join(",");
+    const data = await (0, gql_ts_1.gql)(`query { iids(filter: {id: {in: [${list}]}}, first: ${dids.length}) { nodes { id controller verificationMethod } } }`, CACHE_SECONDS).catch(() => null);
+    return new Map((data?.iids?.nodes ?? []).map((node) => [node.id, node]));
+}
+/**
+ * The account an address belongs to, or null.
+ *
+ * Null covers every honest "no": an address that stands alone, a link claimed
+ * by only one side, and an index that would not answer. None of those is an
+ * error — most addresses are exactly what they appear to be.
+ */
+async function linkedPrimary(address) {
+    const found = await linkedPrimaries([address]);
+    return found.get(address) ?? null;
+}
+/**
+ * The same question for a page full of addresses, in two round trips rather
+ * than two per row. A receipt lists every claim; asking per claim would make
+ * a busy ask a slow page.
+ */
+async function linkedPrimaries(addresses) {
+    const unique = [...new Set(addresses.filter(Boolean))];
+    const out = new Map();
+    if (unique.length === 0)
+        return out;
+    const docs = await documentsFor(unique.map(didOf));
+    /* Each address's claim about who it belongs to — its controllers, minus
+       itself. More than one is not an error; it just means no single answer, and
+       showing an arbitrary one would be a guess. */
+    const claims = new Map();
+    for (const address of unique) {
+        const controllers = controllersOf(docs.get(didOf(address))).filter((did) => did !== didOf(address));
+        if (controllers.length === 1 && controllers[0])
+            claims.set(address, controllers[0]);
+    }
+    if (claims.size === 0)
+        return out;
+    /* Now the other side: does each claimed account actually carry that key? */
+    const mains = await documentsFor([...new Set(claims.values())]);
+    for (const [address, mainDid] of claims) {
+        const main = mains.get(mainDid);
+        if (!main)
+            continue;
+        const carries = (main.verificationMethod ?? []).some((method) => method.blockchainAccountID === address || method.id === `${mainDid}#${address}`);
+        if (!carries)
+            continue;
+        const primaryAddress = addressOf(mainDid);
+        if (primaryAddress)
+            out.set(address, { primaryDid: mainDid, primaryAddress });
+    }
+    return out;
+}
+/* ── the strict read, for a fold that publishes what it concludes ───────── */
+/** Blocksync answers an `in` filter of this many ids comfortably. */
+exports.LINK_CHUNK = 100;
+async function documentsStrict(dids) {
+    const out = new Map();
+    for (let at = 0; at < dids.length; at += exports.LINK_CHUNK) {
+        const chunk = dids.slice(at, at + exports.LINK_CHUNK);
+        const list = chunk.map((did) => JSON.stringify(did)).join(",");
+        /* Uncached, and no catch: an index that will not answer is an error the
+           caller must see, never a page of "nobody is linked". */
+        const data = await (0, gql_ts_1.gql)(`query { iids(filter: {id: {in: [${list}]}}, first: ${chunk.length}) { nodes { id controller verificationMethod } } }`, 0);
+        for (const node of data.iids?.nodes ?? [])
+            out.set(node.id, node);
+    }
+    return out;
+}
+/**
+ * `linkedPrimaries` for somebody who will *publish* the answer: guest address
+ * → primary address, and a throw instead of a shrug.
+ *
+ * The page readers above fail open, rightly — a receipt that cannot learn a
+ * link still renders every claim. A leaderboard fold cannot: taking an index
+ * blip for "no links" would split a merged row back into two, each with its
+ * own creature, and publish that until the next fold. So this throws on any
+ * index error and the fold keeps what it last published.
+ *
+ * The rule is the same two-sided one, exactly: the guest's document names one
+ * controller other than itself, and that account's document carries the
+ * guest's key. One hop only — a primary is never looked through to *its*
+ * primary — and cycle-guarded: an address that is itself somebody's guest is
+ * never used as a primary (so A↔B, or A→B→C, merges nothing rather than
+ * swapping rows or half-merging a chain). The `in` lists go in chunks of at
+ * most `LINK_CHUNK`.
+ */
+async function linkedPrimariesStrict(addresses) {
+    const unique = [...new Set(addresses.filter(Boolean))];
+    const out = new Map();
+    if (unique.length === 0)
+        return out;
+    const docs = await documentsStrict(unique.map(didOf));
+    const claims = new Map();
+    for (const address of unique) {
+        const controllers = controllersOf(docs.get(didOf(address))).filter((did) => did !== didOf(address));
+        if (controllers.length === 1 && controllers[0] && addressOf(controllers[0]))
+            claims.set(address, controllers[0]);
+    }
+    if (claims.size === 0)
+        return out;
+    const mains = await documentsStrict([...new Set(claims.values())]);
+    for (const [address, mainDid] of claims) {
+        const main = mains.get(mainDid);
+        if (!main)
+            continue;
+        const carries = (main.verificationMethod ?? []).some((method) => method.blockchainAccountID === address || method.id === `${mainDid}#${address}`);
+        if (carries)
+            out.set(address, addressOf(mainDid));
+    }
+    /* One hop, and no cycles: a primary that is itself somebody's guest is not
+       a primary this fold will merge into. */
+    const guests = new Set(out.keys());
+    for (const [guest, primary] of [...out])
+        if (guests.has(primary) || primary === guest)
+            out.delete(guest);
+    return out;
+}
+//# sourceMappingURL=linked.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Which chain this deployment talks to — one of three, or a refusal.
+ *
+ * Every endpoint table here (RPC, REST, index, file store, relayer) was keyed
+ * by this string and fell back to testnet for anything it did not recognise.
+ * So `NEXT_PUBLIC_CHAIN_NETWORK=Mainnet` — one capital letter — produced a
+ * deployment that looked configured for mainnet and quietly read and wrote
+ * testnet: real people's asks on a chain with play money (scale review D23).
+ *
+ * Unset (or empty) still means testnet: that is the documented default and
+ * what every local checkout relies on. A value that is set and is not one of
+ * the three throws, at import, where the deployment that carries it fails
+ * its first request with the setting named — rather than running against the
+ * wrong chain for as long as nobody notices.
+ *
+ * Deliberately exact: "Mainnet" is refused rather than lower-cased, because a
+ * deployment whose network was typed by hand should be corrected once, not
+ * guessed at in every module that reads it.
+ */
+export { NETWORKS, chainNetwork, type Network as ChainNetwork } from "../network.ts";
+//# sourceMappingURL=network.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/data/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/cjs/data/network.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainNetwork = exports.NETWORKS = void 0;
+/**
+ * Which chain this deployment talks to — one of three, or a refusal.
+ *
+ * Every endpoint table here (RPC, REST, index, file store, relayer) was keyed
+ * by this string and fell back to testnet for anything it did not recognise.
+ * So `NEXT_PUBLIC_CHAIN_NETWORK=Mainnet` — one capital letter — produced a
+ * deployment that looked configured for mainnet and quietly read and wrote
+ * testnet: real people's asks on a chain with play money (scale review D23).
+ *
+ * Unset (or empty) still means testnet: that is the documented default and
+ * what every local checkout relies on. A value that is set and is not one of
+ * the three throws, at import, where the deployment that carries it fails
+ * its first request with the setting named — rather than running against the
+ * wrong chain for as long as nobody notices.
+ *
+ * Deliberately exact: "Mainnet" is refused rather than lower-cased, because a
+ * deployment whose network was typed by hand should be corrected once, not
+ * guessed at in every module that reads it.
+ */
+/* The definitions live in `../network.ts`, which resolves the network lazily —
+   the throw now happens at the first read, never at import. */
+var network_ts_1 = require("../network.js");
+Object.defineProperty(exports, "NETWORKS", { enumerable: true, get: function () { return network_ts_1.NETWORKS; } });
+Object.defineProperty(exports, "chainNetwork", { enumerable: true, get: function () { return network_ts_1.chainNetwork; } });
+//# sourceMappingURL=network.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/data/network.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH;+DAC+D;AAC/D,4CAAqF;AAA5E,sGAAA,QAAQ,OAAA;AAAE,0GAAA,YAAY,OAAA"}

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

@@ -0,0 +1,93 @@
+/**
+ * Whether an ask is still accepting submissions — the one question every
+ * surface with a submit button has to answer, answered in one place.
+ *
+ * The chain's `state` is not that answer. An ask that has paid every spot it
+ * holds, or whose end date has passed, still carries state 0 ("open") — the
+ * chain never flips it. Three surfaces each read `state === 0` and each told
+ * a person to go do work the gate would refuse: the button was the first lie,
+ * and the refusal after the click was where the truth finally surfaced. The
+ * difference between those two moments is somebody's afternoon.
+ */
+export interface AskWindow {
+    state: number;
+    quota: string | number;
+    approved: number;
+    /**
+     * The chain's own tally of claims **submitted** — `Collection.count`.
+     *
+     * This is what `x/claims` compares against the quota, and it is not
+     * `approved`. Optional only because older callers predate it; when it is
+     * absent this falls back to `approved`, which is the behaviour that was
+     * wrong — see the rule below.
+     */
+    count?: string | number | null;
+    endDate?: string | null;
+}
+export type Openness = {
+    open: true;
+}
+/** In the order a person would want the reason named: the chain said stop
+ *  (closed, paused), the money ran out (filled), the clock ran out (ended). */
+ | {
+    open: false;
+    why: "closed" | "paused" | "filled" | "ended";
+};
+export declare function askOpenness(ask: AskWindow, now?: Date): Openness;
+/**
+ * Why there is no door, including the reason that is not about this ask at
+ * all: it belongs to another application.
+ */
+export type AskDoor = Openness | {
+    open: false;
+    why: "elsewhere";
+};
+/**
+ * Whether **this deployment** can take an answer to this ask — which is the
+ * question a submit button is really asking, and a strictly harder one than
+ * `askOpenness`.
+ *
+ * The board learned this first. The public index returns every claim
+ * collection on the network, and most belong to other projects: an IXO World
+ * invoice, somebody's device telemetry, a protocol nobody here has heard of.
+ * They are open, they pay, they collect answers — through their own
+ * application. Ours cannot make their claims, and the chain agrees: their
+ * escrow account never granted this deployment's gate the right to admit a
+ * stranger, so every submission from here is refused after the work is done.
+ *
+ * That grant is the whole test. It is not a heuristic about naming or
+ * shape — it is the same fact the gate itself re-checks before it signs, so
+ * a door drawn on this answer is a door that opens.
+ *
+ * **Deliberately not tested: published criteria.** An Openhands ask may
+ * carry no `DoneMeans` and be checked by whoever posted it — the submit page
+ * says so in its own footnote. Reading their absence as "foreign" would take
+ * the door off honest asks whose poster reviews by hand.
+ *
+ * `authorized` is the set `takeableAdmins()` returns: admins that granted
+ * this gate. An RPC that fails yields an empty set, which shows no door — the
+ * safe direction, since the gate would refuse anyway.
+ */
+export declare function askDoor(ask: AskWindow & {
+    admin?: string | null;
+}, authorized: ReadonlySet<string>, now?: Date): AskDoor;
+/**
+ * How an ask stands, in the one sentence a worker needs before deciding.
+ *
+ * Lives beside `askOpenness` and not on the page that shows it, for the same
+ * reason: this is a fact about the ask, derived from the same four numbers,
+ * and `/submit` — the page a stranger opens from a chat link — sits exactly on
+ * the app's first-load ceiling. A sentence the server can write is a sentence
+ * the browser should not carry a rulebook to write for itself.
+ *
+ * Deliberately NOT shared with the share card's standing line. That one is an
+ * offer landing in somebody's chat ("Open to anyone with this link"); this one
+ * is a status line on the page they work from, and it counts the answers
+ * already queued ahead of them. Same facts, different audience, different
+ * register — flattening them would be tidiness at the reader's expense.
+ */
+export declare function standingLine(ask: AskWindow & {
+    count: number;
+    rejected: number;
+}, openness?: AskDoor): string;
+//# sourceMappingURL=openness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openness.d.ts","sourceRoot":"","sources":["../../../src/data/openness.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE;AAChB;+EAC+E;GAC7E;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC;AAEnE,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,QAAQ,CAsC5E;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAMpI;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,GAAE,OAA0B,GAAG,MAAM,CA8C/H"}

package/dist/cjs/data/openness.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askOpenness = askOpenness;
+exports.askDoor = askDoor;
+exports.standingLine = standingLine;
+const format_ts_1 = require("./format.js");
+function askOpenness(ask, now = new Date()) {
+    /* The chain's own word wins first: these states are explicit acts. */
+    if (ask.state === 2)
+        return { open: false, why: "closed" };
+    if (ask.state === 1)
+        return { open: false, why: "paused" };
+    /*
+     * **Filled counts submissions, because the chain counts submissions.**
+     *
+     * This counted approvals, and the chain does not. `x/claims` compares the
+     * quota against `Collection.count`, which increments the moment a claim is
+     * submitted — approved, rejected or still waiting. So an ask whose spots had
+     * all been used up by refusals read `open: true` here and answered
+     * *"collection for claim's quota has been reached"* on chain.
+     *
+     * Found the only way this kind of thing is found: on a phone, on a preview
+     * build, by somebody who had already walked to the mess and photographed it.
+     * The submit button was the first lie and the chain's refusal was where the
+     * truth arrived — which is the exact failure this whole function exists to
+     * prevent, in the one direction it had not been pointed.
+     *
+     * `approved` remains the fallback for callers that cannot supply the count:
+     * it under-reports fullness, which is the old bug, but a missing field must
+     * not make a working ask look closed.
+     *
+     * A quota of zero — or the millions some asks use to mean "no limit" — never
+     * fills; the same rule the submit page's spot counter follows.
+     */
+    const limit = Number(ask.quota) || 0;
+    const used = ask.count === undefined || ask.count === null ? ask.approved : Number(ask.count);
+    if (limit > 0 && Number.isFinite(used) && used >= limit)
+        return { open: false, why: "filled" };
+    /* The gate mints authorizations that expire at endDate, so past it every
+       submission fails on chain. Parsed as chain time: blocksync writes these
+       with no zone. */
+    const ends = (0, format_ts_1.chainTime)(ask.endDate);
+    if (ends && ends.getTime() <= now.getTime())
+        return { open: false, why: "ended" };
+    return { open: true };
+}
+/**
+ * Whether **this deployment** can take an answer to this ask — which is the
+ * question a submit button is really asking, and a strictly harder one than
+ * `askOpenness`.
+ *
+ * The board learned this first. The public index returns every claim
+ * collection on the network, and most belong to other projects: an IXO World
+ * invoice, somebody's device telemetry, a protocol nobody here has heard of.
+ * They are open, they pay, they collect answers — through their own
+ * application. Ours cannot make their claims, and the chain agrees: their
+ * escrow account never granted this deployment's gate the right to admit a
+ * stranger, so every submission from here is refused after the work is done.
+ *
+ * That grant is the whole test. It is not a heuristic about naming or
+ * shape — it is the same fact the gate itself re-checks before it signs, so
+ * a door drawn on this answer is a door that opens.
+ *
+ * **Deliberately not tested: published criteria.** An Openhands ask may
+ * carry no `DoneMeans` and be checked by whoever posted it — the submit page
+ * says so in its own footnote. Reading their absence as "foreign" would take
+ * the door off honest asks whose poster reviews by hand.
+ *
+ * `authorized` is the set `takeableAdmins()` returns: admins that granted
+ * this gate. An RPC that fails yields an empty set, which shows no door — the
+ * safe direction, since the gate would refuse anyway.
+ */
+function askDoor(ask, authorized, now = new Date()) {
+    /* The chain's own word and the clock first: an ask that is closed is closed
+       whoever posted it, and "closed" is the more useful thing to be told. */
+    const openness = askOpenness(ask, now);
+    if (!openness.open)
+        return openness;
+    return ask.admin && authorized.has(ask.admin) ? { open: true } : { open: false, why: "elsewhere" };
+}
+/**
+ * How an ask stands, in the one sentence a worker needs before deciding.
+ *
+ * Lives beside `askOpenness` and not on the page that shows it, for the same
+ * reason: this is a fact about the ask, derived from the same four numbers,
+ * and `/submit` — the page a stranger opens from a chat link — sits exactly on
+ * the app's first-load ceiling. A sentence the server can write is a sentence
+ * the browser should not carry a rulebook to write for itself.
+ *
+ * Deliberately NOT shared with the share card's standing line. That one is an
+ * offer landing in somebody's chat ("Open to anyone with this link"); this one
+ * is a status line on the page they work from, and it counts the answers
+ * already queued ahead of them. Same facts, different audience, different
+ * register — flattening them would be tidiness at the reader's expense.
+ */
+function standingLine(ask, openness = askOpenness(ask)) {
+    if (!openness.open) {
+        /*
+         * The one reason that is not about this ask running out of anything. An
+         * ask posted by another application is still open, still paying, still
+         * collecting answers — just not through this door.
+         */
+        if (openness.why === "elsewhere")
+            return "Posted somewhere else. It takes answers there, not here.";
+        /*
+         * "Filled" is two different facts and a worker deserves the right one.
+         *
+         * A quota used up by approvals means the money went out. A quota used up
+         * by refusals means the spots are gone and nobody was paid — the chain
+         * counts a submission whatever became of it. Saying "every payout has been
+         * made" about an ask that paid nobody is a sentence that reads as a
+         * shrug and is actually a falsehood.
+         */
+        if (openness.why === "filled") {
+            return ask.approved > 0
+                ? "Every payout on this ask has been made."
+                : "This ask has taken all the answers it can, and none was approved.";
+        }
+        if (openness.why === "ended")
+            return "This ask ended before being filled.";
+        return "This ask is closed.";
+    }
+    const limit = Number(ask.quota) || 0;
+    /*
+     * Counted down from submissions, not approvals — the same correction the
+     * fill rule needed. A refused answer took a spot with it, and a worker
+     * deciding whether to walk somewhere is entitled to know that before the
+     * walk rather than after.
+     */
+    const spotsLeft = limit > 0 ? limit - ask.count : null;
+    /* What is queued ahead of you is the first thing worth knowing — it is the
+       difference between "the money is there" and "the money is spoken for". */
+    const waiting = ask.count - ask.approved - ask.rejected;
+    const others = waiting > 0 ? `${waiting} ${waiting === 1 ? "answer is" : "answers are"} waiting for review · ` : "";
+    if (spotsLeft === 1)
+        return `${others}first one approved is paid`;
+    /* Some asks set a limit in the millions, which is a way of saying "no
+       limit". Counting down from it is noise dressed as precision. */
+    if (spotsLeft !== null && limit <= 25)
+        return `${others}${spotsLeft} of ${limit} spots still pay`;
+    if (spotsLeft !== null)
+        return `${others}open to more answers`;
+    return others.replace(/ · $/, "");
+}
+//# sourceMappingURL=openness.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * What the oracle charges, asked of the oracle itself.
+ *
+ * An eval-oracle serves `GET /v1/info` with its address and its
+ * `pricing.evaluation` — the smallest evaluation leg a collection may carry
+ * before it refuses to register. Reading it here means the composer quotes
+ * the price the oracle will actually hold an ask to, rather than a number a
+ * deployment typed once. Server-side only; a browser never calls the oracle.
+ */
+export interface OracleInfo {
+    address: string;
+    name: string;
+    /** The minimum evaluation leg, in base units of `denom`. */
+    priceBase: number;
+    denom: string;
+}
+export type FetchJson = (url: string) => Promise<unknown>;
+/** Null when there is no oracle URL, it does not answer, or its answer names no price. */
+export declare function oracleInfo(baseUrl: string, read?: FetchJson): Promise<OracleInfo | null>;
+//# sourceMappingURL=oracleInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oracleInfo.d.ts","sourceRoot":"","sources":["../../../src/data/oracleInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAO1D,0FAA0F;AAC1F,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAqB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAezG"}

package/dist/cjs/data/oracleInfo.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * What the oracle charges, asked of the oracle itself.
+ *
+ * An eval-oracle serves `GET /v1/info` with its address and its
+ * `pricing.evaluation` — the smallest evaluation leg a collection may carry
+ * before it refuses to register. Reading it here means the composer quotes
+ * the price the oracle will actually hold an ask to, rather than a number a
+ * deployment typed once. Server-side only; a browser never calls the oracle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oracleInfo = oracleInfo;
+const TIMEOUT_MS = 5_000;
+const fetchJson = async (url) => {
+    const response = await fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS), headers: { accept: "application/json" } });
+    return response.ok ? response.json() : null;
+};
+/** Null when there is no oracle URL, it does not answer, or its answer names no price. */
+async function oracleInfo(baseUrl, read = fetchJson) {
+    const base = (baseUrl || "").replace(/\/$/, "");
+    if (!/^https?:\/\//.test(base))
+        return null;
+    let doc;
+    try {
+        doc = await read(`${base}/v1/info`);
+    }
+    catch {
+        return null;
+    }
+    const info = doc;
+    const address = typeof info?.address === "string" ? info.address : "";
+    const denom = typeof info?.pricing?.evaluation?.denom === "string" ? info.pricing.evaluation.denom : "";
+    const amount = Number(info?.pricing?.evaluation?.minAmount);
+    if (!address || !denom || !Number.isFinite(amount) || amount < 0)
+        return null;
+    return { address, name: typeof info?.name === "string" && info.name ? info.name : "oracle", priceBase: Math.round(amount), denom };
+}
+//# sourceMappingURL=oracleInfo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oracleInfo.js","sourceRoot":"","sources":["../../../src/data/oracleInfo.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAoBH,gCAeC;AAzBD,MAAM,UAAU,GAAG,KAAK,CAAC;AAIzB,MAAM,SAAS,GAAc,KAAK,EAAE,GAAG,EAAE,EAAE;IACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACxH,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC,CAAC;AAEF,0FAA0F;AACnF,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,OAAkB,SAAS;IAC3E,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAwH,CAAC;IACtI,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;AACrI,CAAC"}

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

@@ -0,0 +1,44 @@
+/** Server-side reads of the oracles on chain. Never imported by client code. */
+import { type CardService } from "../rubric/card.ts";
+/**
+ * Who is offering to work, read from the chain rather than from a deploy.
+ *
+ * The checker used to be one address in `NEXT_PUBLIC_CHECKER_ADDRESS`, which
+ * meant hiring a different one was a redeploy and hiring somebody else's was
+ * impossible. An oracle entity carrying an Agent Card is the shop window: it
+ * says who the agent is, what it will do, and what it charges, and anyone can
+ * read it without asking us.
+ *
+ * "The authorization is the job offer" was the E-round's rule for how an agent
+ * finds work. This is its mirror: the card is how work finds an agent.
+ */
+export interface Oracle {
+    did: string;
+    /** The account that actually signs — the entity's owner, and the grantee named on an ask. */
+    address: string;
+    name: string;
+    description: string;
+    services: CardService[];
+    /** The cheapest service price in uixo, when the card names one. */
+    priceUixo: number | null;
+    /** Which criterion kinds it claims it can settle. */
+    serves: ("measure" | "judge" | "attest")[];
+}
+/**
+ * Every oracle on the network that publishes a card.
+ *
+ * An oracle without a card is not an error and not hidden — it simply has not
+ * said what it offers, so there is nothing honest to render for it. A card that
+ * will not load is the same case: the entity is still on chain, and the next
+ * read may well get it.
+ */
+export declare function loadOracles(limit?: number): Promise<Oracle[]>;
+/**
+ * The oracles that will rule on work. A checker must be able to settle machine-
+ * checked criteria at minimum — an agent that can only judge prose cannot be
+ * trusted with an ask whose terms include a measurement.
+ */
+export declare function loadCheckers(limit?: number): Promise<Oracle[]>;
+/** One oracle by the address that signs for it. */
+export declare function oracleByAddress(address: string): Promise<Oracle | null>;
+//# sourceMappingURL=oracles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oracles.d.ts","sourceRoot":"","sources":["../../../src/data/oracles.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAKhF,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrF;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,MAAM,EAAE,CAAC,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC;CAC5C;AAoDD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuDhE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGjE;AAED,mDAAmD;AACnD,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAI7E"}