@ixo/openhands-sdk 0.1.0 → 0.3.0

package/dist/esm/rubric/marketPlan.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Ask the World: a prediction market turned into a plan of checks people can
+ * do in public places (docs/verified-work-ask-the-world-plan.md).
+ *
+ * A **plan** is a frozen document: the market it informs, the checks, where
+ * each happens and how many answers each place buys, what each check beats,
+ * and one line on what the plan cannot tell you. It is written once, stored
+ * at a content address, and named by every ask it spawns (`terms.plan`), so
+ * the report can be rebuilt from the chain alone. The asks are filed under
+ * one tag, `plan-<slug>`, the way a call's legs are filed under `call-<slug>`.
+ *
+ * The agent that calls the MCP is the one that reads the market and drafts
+ * the checks; this module never guesses them. What it does is refuse what
+ * must never be bought (the **market screen**), check that a draft is whole
+ * (`validatePlan`), and price it (`planCost`). All pure, so the MCP, the
+ * worker and the app agree on one answer.
+ */
+/** The tag every ask of a plan is filed under. No colon: a tag is `[a-z0-9-]`. */
+export declare const planTag: (slug: string) => string;
+/** The slug back out of a tag, or null when the tag is not a plan's. */
+export declare const slugOfPlanTag: (tag: string | null | undefined) => string | null;
+/** A slug from free text: lowercase words joined by dashes, 3–40 characters, starting with a letter. */
+export declare const planSlug: (text: string, suffix?: string) => string;
+/** What a person hands over for a check: the same three kinds `ask_the_world` posts. */
+export type PlanAct = "photo" | "observation";
+export declare const PLAN_ACTS: readonly PlanAct[];
+/** Where a check happens. One place becomes one ask. */
+export interface PlanPlace {
+    /** What a person recognises: "Union Square, San Francisco". */
+    name: string;
+    lat: number;
+    lon: number;
+    /** How close the answer must be taken, in metres (20–20 000, as `ask_the_world`). */
+    withinM: number;
+}
+/** One line of the plan: an act, its places, how many answers per place, the pay, and what it beats. */
+export interface PlanCheck {
+    /** Stable within the plan: c1, c2… */
+    id: string;
+    act: PlanAct;
+    /** What the person does, in plain words, 12–300 characters. */
+    text: string;
+    places: PlanPlace[];
+    /** Answers to buy at each place (the ask's quota), 1–10. */
+    perPlace: number;
+    /** What one approved answer earns, in dollars. */
+    payUsd: number;
+    /** How long each ask stays open, in hours. */
+    hours: number;
+    /** The existing feed this check improves on, in one line. Mandatory: no line, no check. */
+    beats: string;
+}
+/** The market a plan informs, as read when the plan was drafted. */
+export interface PlanMarket {
+    venue: "polymarket" | "kalshi" | "other";
+    url: string;
+    question: string;
+    /** The resolution rules as the venue states them, trimmed. */
+    rules?: string;
+    /** When the market closes (ISO), if the venue says. */
+    closes?: string;
+}
+/** The frozen plan document. */
+export interface MarketPlan {
+    kind: "openhands.market-plan";
+    v: 1;
+    slug: string;
+    market: PlanMarket;
+    checks: PlanCheck[];
+    /** What the plan cannot tell the trader. Mandatory. */
+    cannotTell: string;
+    /** ISO time the plan was drafted. */
+    createdAt: string;
+}
+export declare const MARKET_PLAN_KIND: "openhands.market-plan";
+/** The limits a plan is held to. The per-ask cap and the per-plan cap are the MCP's; these are shape. */
+export declare const PLAN_LIMITS: {
+    readonly checks: 12;
+    readonly placesPerCheck: 20;
+    readonly asksPerPlan: 120;
+    readonly perPlace: 10;
+    readonly textMin: 12;
+    readonly textMax: 300;
+    readonly withinMin: 20;
+    readonly withinMax: 20000;
+    readonly hoursMin: 1;
+    readonly hoursMax: 720;
+    /** The smallest pay worth a person's walk, in dollars. */
+    readonly payFloorUsd: 0.05;
+    readonly lineMin: 8;
+    readonly lineMax: 240;
+};
+/** How many asks a plan posts: one per place per check. */
+export declare const planAskCount: (plan: Pick<MarketPlan, "checks">) => number;
+/** How many answers a plan buys at most. */
+export declare const planAnswerCount: (plan: Pick<MarketPlan, "checks">) => number;
+/** The price of a plan, line by line. */
+export interface PlanCost {
+    /** Per check: answers bought, pay, the check's total including the review of each answer. */
+    lines: {
+        id: string;
+        answers: number;
+        payUsd: number;
+        reviewUsd: number;
+        totalUsd: number;
+    }[];
+    /** Σ (pay + review) over every answer the plan can buy. */
+    workUsd: number;
+    /** The platform fee on top. */
+    feeUsd: number;
+    /** What the funder sends. */
+    totalUsd: number;
+}
+/**
+ * Price a plan: every answer it can buy costs its pay plus the review of that
+ * answer (the oracle's check reward), and the fee is a share of that work.
+ */
+export declare const planCost: (plan: Pick<MarketPlan, "checks">, opts: {
+    reviewUsd: number | ((check: PlanCheck) => number);
+    feeRate: number;
+}) => PlanCost;
+/** One refusal: the rule that refused it, where, and a sentence a person can act on. */
+export interface PlanRefusal {
+    rule: PlanRule;
+    /** The check it concerns, or null for the plan as a whole. */
+    check: string | null;
+    why: string;
+}
+export type PlanRule = "shape" | "in-play-sport" | "conflict-zone" | "polling-place" | "resolution-source" | "acts-on-outcome" | "non-public" | "faces" | "no-beats" | "no-cannot-tell";
+/** Refusals for the market as a whole: a sports market or a conflict market is never scoped. */
+export declare const screenMarket: (market: PlanMarket) => PlanRefusal[];
+/** Refusals for one check, read against the market it informs. */
+export declare const screenCheck: (check: PlanCheck) => PlanRefusal[];
+/**
+ * Everything wrong with a plan, in the order a person would fix it: the
+ * market first, then the plan's own shape, then each check. An empty list is
+ * a plan that may be stored and funded.
+ */
+export declare const validatePlan: (plan: MarketPlan) => PlanRefusal[];
+/** A plan read back from the store, or null when the document is not a version 1 plan. */
+export declare const readMarketPlan: (doc: unknown) => MarketPlan | null;
+/** The words the asks of one check carry: the check, then its place, then the honest limit of a single look. */
+export declare const askQuestionFor: (check: PlanCheck, place: PlanPlace) => string;
+//# sourceMappingURL=marketPlan.d.ts.map

package/dist/esm/rubric/marketPlan.d.ts.map

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

package/dist/esm/rubric/marketPlan.js

@@ -0,0 +1,305 @@
+/**
+ * Ask the World: a prediction market turned into a plan of checks people can
+ * do in public places (docs/verified-work-ask-the-world-plan.md).
+ *
+ * A **plan** is a frozen document: the market it informs, the checks, where
+ * each happens and how many answers each place buys, what each check beats,
+ * and one line on what the plan cannot tell you. It is written once, stored
+ * at a content address, and named by every ask it spawns (`terms.plan`), so
+ * the report can be rebuilt from the chain alone. The asks are filed under
+ * one tag, `plan-<slug>`, the way a call's legs are filed under `call-<slug>`.
+ *
+ * The agent that calls the MCP is the one that reads the market and drafts
+ * the checks; this module never guesses them. What it does is refuse what
+ * must never be bought (the **market screen**), check that a draft is whole
+ * (`validatePlan`), and price it (`planCost`). All pure, so the MCP, the
+ * worker and the app agree on one answer.
+ */
+/** The tag every ask of a plan is filed under. No colon: a tag is `[a-z0-9-]`. */
+export const planTag = (slug) => `plan-${slug}`;
+/** The slug back out of a tag, or null when the tag is not a plan's. */
+export const slugOfPlanTag = (tag) => {
+    const match = /^plan-([a-z][a-z0-9-]{2,39})$/.exec(tag ?? "");
+    return match ? match[1] : null;
+};
+/** A slug from free text: lowercase words joined by dashes, 3–40 characters, starting with a letter. */
+export const planSlug = (text, suffix = "") => {
+    const words = text
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    const start = words.replace(/^[^a-z]+/, "") || "plan";
+    const tail = suffix ? `-${suffix}` : "";
+    const room = 40 - tail.length;
+    const body = start.slice(0, room).replace(/-+$/, "");
+    return `${body.length >= 3 ? body : `plan-${body}`.slice(0, room)}${tail}`;
+};
+export const PLAN_ACTS = ["photo", "observation"];
+export const MARKET_PLAN_KIND = "openhands.market-plan";
+/** The limits a plan is held to. The per-ask cap and the per-plan cap are the MCP's; these are shape. */
+export const PLAN_LIMITS = {
+    checks: 12,
+    placesPerCheck: 20,
+    asksPerPlan: 120,
+    perPlace: 10,
+    textMin: 12,
+    textMax: 300,
+    withinMin: 20,
+    withinMax: 20_000,
+    hoursMin: 1,
+    hoursMax: 720,
+    /** The smallest pay worth a person's walk, in dollars. */
+    payFloorUsd: 0.05,
+    lineMin: 8,
+    lineMax: 240,
+};
+/** How many asks a plan posts: one per place per check. */
+export const planAskCount = (plan) => plan.checks.reduce((n, check) => n + check.places.length, 0);
+/** How many answers a plan buys at most. */
+export const planAnswerCount = (plan) => plan.checks.reduce((n, check) => n + check.places.length * check.perPlace, 0);
+/** Cents, so totals add the way a person adds them. */
+const cents = (usd) => Math.round(usd * 100) / 100;
+/**
+ * Price a plan: every answer it can buy costs its pay plus the review of that
+ * answer (the oracle's check reward), and the fee is a share of that work.
+ */
+export const planCost = (plan, opts) => {
+    const lines = plan.checks.map((check) => {
+        const answers = check.places.length * check.perPlace;
+        /* The review is priced per check: a photo is screened, a sentence is not, so the two cost differently. */
+        const reviewUsd = typeof opts.reviewUsd === "function" ? opts.reviewUsd(check) : opts.reviewUsd;
+        return { id: check.id, answers, payUsd: check.payUsd, reviewUsd, totalUsd: cents(answers * (check.payUsd + reviewUsd)) };
+    });
+    const workUsd = cents(lines.reduce((sum, line) => sum + line.totalUsd, 0));
+    const feeUsd = cents(workUsd * Math.max(0, opts.feeRate));
+    return { lines, workUsd, feeUsd, totalUsd: cents(workUsd + feeUsd) };
+};
+/*
+ * The market screen. Each list is a set of words that, found in a check or a
+ * market, mean the thing must not be bought. They are deliberately broad: a
+ * plan refused for a word that was innocent costs the agent one redraft; a
+ * plan that slips through can cost a person their safety or the network its
+ * standing. The refusal names the rule so the redraft is easy.
+ */
+/** Sport and esports markets settled by play. A person at the venue is courtsiding, whatever they look at. */
+const SPORT = [
+    /\bvs\.?\b/i,
+    /\bwin on \d{4}-\d{2}-\d{2}\b/i,
+    /\bo\/u\b/i,
+    /\bover\/under\b/i,
+    /\bspread:/i,
+    /\bhandicap\b/i,
+    /\bmap handicap\b/i,
+    /\bgame \d\b/i,
+    /\b(bo3|bo5)\b/i,
+    /\b(league|cup|open|championship|grand prix|playoffs?|super bowl|world series|stanley cup|nba finals)\b.*\b(win|winner|beat|score|goals?|points|sets?|maps?)\b/i,
+    /\b(counter-strike|dota|league of legends|lol:|valorant|esports?)\b/i,
+];
+/** Places where nobody should be sent to look, whatever the money. */
+const CONFLICT = [
+    /\biran\b/i,
+    /\bisrael\b/i,
+    /\bgaza\b/i,
+    /\bwest bank\b/i,
+    /\blebanon\b/i,
+    /\byemen\b/i,
+    /\bsyria\b/i,
+    /\bsudan\b/i,
+    /\bukrain/i,
+    /\brussia\b/i,
+    /\bhormuz\b/i,
+    /\bkharg\b/i,
+    /\bred sea\b/i,
+    /\btaiwan strait\b/i,
+    /\bceasefire\b/i,
+    /\bblockade\b/i,
+    /\binvade|invasion\b/i,
+];
+/** Polling places: the law differs by state and by distance, and the network does not litigate it per ask. */
+const POLLING = [/\bpolling (place|station|site|location)s?\b/i, /\bvoting (booth|centre|center|location)s?\b/i, /\bballot\b/i, /\bvoters?\b/i];
+/** The thing that settles a market: never visit, touch or photograph it. */
+const SOURCE = [
+    /\bsensor\b/i,
+    /\bweather station\b/i,
+    /\bthermometer\b/i,
+    /\b(rain|river|stream|tide|snow) gauge\b/i,
+    /\bgauge\b/i,
+    /\bofficial (count|counter|tally|scoreboard|reading)\b/i,
+    /\bcounting (room|centre|center)\b/i,
+    /\btally\b/i,
+    /\bscoreboard\b/i,
+];
+/** Acts that change the world the market is about. A check looks; it never moves the outcome. */
+const ACTS = [
+    /\bvote\b/i,
+    /\b(bet|wager)\b/i,
+    /\bprotest\b/i,
+    /\bblock(ade)?\b/i,
+    /\bsabotage\b/i,
+    /\bdamage\b/i,
+    /\bdeface\b/i,
+    /\bdestroy\b/i,
+    /\bremove the\b/i,
+    /\bbribe\b/i,
+    /\bthreaten\b/i,
+    /\bpersuade\b/i,
+    /\bconvince\b/i,
+    /\blobby\b/i,
+    /\binfluence\b/i,
+    /\bcampaign for\b/i,
+];
+/** Places a person has no right to be, and information only an insider has. */
+const PRIVATE = [
+    /\bbehind the counter\b/i,
+    /\bbackstage\b/i,
+    /\bstaff[- ]only\b/i,
+    /\brestricted (area|zone)\b/i,
+    /\bprivate (property|land|area|office)\b/i,
+    /\binside the (office|factory|warehouse|plant)\b/i,
+    /\bask (an? )?(employee|staff member|manager|worker) (for|about|what)\b/i,
+    /\binternal (numbers|figures|data|memo)\b/i,
+    /\bconfidential\b/i,
+    /\btrespass/i,
+];
+/** Faces and anything that identifies a person. */
+const FACES = [/(?<!\bno )\bfaces?\b/i, /\bselfie\b/i, /\bportrait\b/i, /\bidentify (the|a|who)\b/i, /\b(licen[cs]e|number) plates?\b/i, /\bwho (is|was) (inside|driving|in the)\b/i];
+/** Photos of these need to say they take no faces. */
+const CROWD = [/\bqueue\b/i, /\bline (of|outside|at)\b/i, /\bcrowd\b/i, /\bpeople\b/i, /\bshoppers\b/i, /\bcustomers\b/i, /\briders?\b/i, /\bpassengers?\b/i];
+const NO_FACES = /\bno faces\b/i;
+const hit = (patterns, text) => patterns.some((pattern) => pattern.test(text));
+/** The market as one string the screen reads. */
+const marketText = (market) => [market.question, market.rules ?? ""].join("\n");
+/** The place names of a check, as one string. */
+const placeText = (check) => check.places.map((place) => place.name).join("\n");
+/** Refusals for the market as a whole: a sports market or a conflict market is never scoped. */
+export const screenMarket = (market) => {
+    const refusals = [];
+    if (hit(SPORT, market.question)) {
+        refusals.push({ rule: "in-play-sport", check: null, why: "This market is settled by play. Sending people to a venue to report it is courtsiding, so the network does not scope sports markets." });
+    }
+    if (hit(CONFLICT, market.question)) {
+        refusals.push({ rule: "conflict-zone", check: null, why: "This market is about a conflict. The network sends nobody to look where looking can get them hurt." });
+    }
+    return refusals;
+};
+/** Refusals for one check, read against the market it informs. */
+export const screenCheck = (check) => {
+    const refusals = [];
+    const text = check.text;
+    const where = placeText(check);
+    const id = check.id;
+    if (hit(CONFLICT, where)) {
+        refusals.push({ rule: "conflict-zone", check: id, why: "A place in this check is in a conflict area. Choose a place where looking is safe." });
+    }
+    if (hit(POLLING, `${text}\n${where}`)) {
+        refusals.push({ rule: "polling-place", check: id, why: "Polling places are refused: what may be recorded near one differs by state and distance." });
+    }
+    if (hit(SOURCE, text)) {
+        refusals.push({ rule: "resolution-source", check: id, why: "This check goes to an instrument or an official count. Never visit or photograph what settles a market." });
+    }
+    if (hit(ACTS, text)) {
+        refusals.push({ rule: "acts-on-outcome", check: id, why: "This check asks the person to do something that could change the outcome. A check only looks." });
+    }
+    if (hit(PRIVATE, text)) {
+        refusals.push({ rule: "non-public", check: id, why: "This check needs somewhere private or something only an insider knows. Ask only what anyone could see from a public place." });
+    }
+    if (hit(FACES, text)) {
+        refusals.push({ rule: "faces", check: id, why: "This check would record or identify a person. Ask for the thing, not the people." });
+    }
+    else if (check.act === "photo" && hit(CROWD, text) && !NO_FACES.test(text)) {
+        refusals.push({ rule: "faces", check: id, why: "A photo with people in it must say \"no faces\" in the check, so the person taking it frames it that way." });
+    }
+    if (check.beats.trim().length < PLAN_LIMITS.lineMin) {
+        refusals.push({ rule: "no-beats", check: id, why: "Say what existing feed this check improves on. A check that beats nothing is not worth buying." });
+    }
+    return refusals;
+};
+/** Refusals for the shape of one check: the numbers and lengths a plan must keep. */
+const shapeOfCheck = (check) => {
+    const L = PLAN_LIMITS;
+    const out = [];
+    const bad = (why) => out.push({ rule: "shape", check: check.id, why });
+    if (!PLAN_ACTS.includes(check.act))
+        bad(`The act must be one of ${PLAN_ACTS.join(", ")}.`);
+    const text = check.text.trim();
+    if (text.length < L.textMin || text.length > L.textMax)
+        bad(`The check's words must be ${L.textMin}–${L.textMax} characters.`);
+    if (!check.places.length)
+        bad("A check needs at least one place.");
+    if (check.places.length > L.placesPerCheck)
+        bad(`A check holds at most ${L.placesPerCheck} places.`);
+    for (const place of check.places) {
+        if (!place.name?.trim())
+            bad("Every place needs a name a person recognises.");
+        if (!(Math.abs(place.lat) <= 90) || !(Math.abs(place.lon) <= 180) || (place.lat === 0 && place.lon === 0))
+            bad(`"${place.name}" has no usable coordinates.`);
+        if (!(place.withinM >= L.withinMin && place.withinM <= L.withinMax))
+            bad(`"${place.name}": the distance must be ${L.withinMin}–${L.withinMax} m.`);
+    }
+    if (!Number.isInteger(check.perPlace) || check.perPlace < 1 || check.perPlace > L.perPlace)
+        bad(`Answers per place must be a whole number from 1 to ${L.perPlace}.`);
+    if (!(check.payUsd >= L.payFloorUsd))
+        bad(`The pay must be at least $${L.payFloorUsd.toFixed(2)} an answer.`);
+    if (!(check.hours >= L.hoursMin && check.hours <= L.hoursMax))
+        bad(`A check stays open ${L.hoursMin}–${L.hoursMax} hours.`);
+    if (check.beats.trim().length > L.lineMax)
+        bad(`What the check beats fits in ${L.lineMax} characters.`);
+    return out;
+};
+/**
+ * Everything wrong with a plan, in the order a person would fix it: the
+ * market first, then the plan's own shape, then each check. An empty list is
+ * a plan that may be stored and funded.
+ */
+export const validatePlan = (plan) => {
+    const L = PLAN_LIMITS;
+    const refusals = [...screenMarket(plan.market)];
+    const shape = (why) => refusals.push({ rule: "shape", check: null, why });
+    if (plan.kind !== MARKET_PLAN_KIND || plan.v !== 1)
+        shape("This is not a version 1 plan.");
+    if (!slugOfPlanTag(planTag(plan.slug)))
+        shape("The slug must be 3–40 characters of a–z, 0–9 and dashes, starting with a letter.");
+    if (!/^https?:\/\//.test(plan.market.url))
+        shape("The market needs its link.");
+    if (plan.market.question.trim().length < 8)
+        shape("The market needs its question.");
+    if (!plan.checks.length)
+        shape("A plan needs at least one check.");
+    if (plan.checks.length > L.checks)
+        shape(`A plan holds at most ${L.checks} checks.`);
+    if (planAskCount(plan) > L.asksPerPlan)
+        shape(`A plan posts at most ${L.asksPerPlan} asks (one per place per check).`);
+    const ids = new Set();
+    for (const check of plan.checks) {
+        if (ids.has(check.id))
+            shape(`Two checks share the id ${check.id}.`);
+        ids.add(check.id);
+    }
+    if (plan.cannotTell.trim().length < L.lineMin) {
+        refusals.push({ rule: "no-cannot-tell", check: null, why: "Say what this plan cannot tell the trader. A plan without its limit reads as a promise." });
+    }
+    for (const check of plan.checks)
+        refusals.push(...shapeOfCheck(check), ...screenCheck(check));
+    return refusals;
+};
+/** A plan read back from the store, or null when the document is not a version 1 plan. */
+export const readMarketPlan = (doc) => {
+    if (!doc || typeof doc !== "object")
+        return null;
+    const plan = doc;
+    if (plan.kind !== MARKET_PLAN_KIND || plan.v !== 1)
+        return null;
+    if (typeof plan.slug !== "string" || !plan.market || !Array.isArray(plan.checks) || typeof plan.cannotTell !== "string")
+        return null;
+    return plan;
+};
+/** The words the asks of one check carry: the check, then its place, then the honest limit of a single look. */
+export const askQuestionFor = (check, place) => {
+    const text = check.text.trim().replace(/\s+/g, " ");
+    const at = ` At ${place.name}.`;
+    const room = PLAN_LIMITS.textMax - at.length;
+    return (text.length > room ? `${text.slice(0, room - 1).trimEnd()}…` : text) + at;
+};
+//# sourceMappingURL=marketPlan.js.map

package/dist/esm/rubric/marketPlan.js.map

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

package/dist/esm/rubric/observation.d.ts

@@ -0,0 +1,53 @@
+import { type AskTerms } from "./terms.ts";
+/**
+ * The terms of an observation bought from a stranger: what `ask_the_world`
+ * posts, and what every check of an Ask the World plan posts, so that the two
+ * can never drift apart (docs/verified-work-ask-the-world-plan.md, D2).
+ *
+ * A located ask carries the place gate, then the falsifiers (daylight always;
+ * weather on a photo only), then the relevance judge.
+ *
+ * **Weather only where the reviewer can weigh it.** On testnet, 2026-10-15, a
+ * typed observation ("It's dry and the streetlights are working", ask #44040)
+ * came back with location, daylight and the judge passed and the weather gate
+ * `unevaluated`, and the engine declines any decision with a gate it could
+ * not evaluate (reason code `weather`). The falsifier was meant to fail only
+ * an answer the world contradicts; on a typed answer it failed every one. A
+ * photo keeps it. The judge says its refusal
+ * first and the question last: the oracle fails any rule it cannot find proof
+ * for, so a sentence that never names its own failure reads as "prove it", and
+ * the question is a caller's 300 characters that the parser may cut.
+ */
+export type ObservationMode = "observation" | "photo" | "url-check";
+export interface ObservationInput {
+    /** The real-world question, 12–300 characters. */
+    question: string;
+    mode: ObservationMode;
+    /** Where the answer must be taken. Null only for a url-check. */
+    centre: {
+        lat: number;
+        lon: number;
+    } | null;
+    /** How close, in metres. */
+    metres: number;
+    /** A label for the place, frozen beside the coordinates. Never the contract: the gate measures from lat/lon. */
+    place?: string | null;
+    /** Who rules, named in the terms so the ask is a contract about who decides. */
+    oracle: {
+        kind: "oracle";
+        address: string;
+        rewardUixo: number;
+    };
+    /** The tag the ask is filed under. */
+    tag?: string;
+    /** The content address of the plan this ask is one check of. */
+    plan?: string;
+}
+/** The relevance line every observation is judged on. */
+export declare const relevanceLine: (question: string) => string;
+/**
+ * Terms in the parser's own key order, so they read back byte for byte:
+ * v, task, deliverable, campaign, plan, criteria, judge, via.
+ */
+export declare function observationTerms(input: ObservationInput): AskTerms;
+//# sourceMappingURL=observation.d.ts.map

package/dist/esm/rubric/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../src/rubric/observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAE5F;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,OAAO,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,iEAAiE;IACjE,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gFAAgF;IAChF,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MACqG,CAAC;AAEvJ;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,QAAQ,CAuBlE"}

package/dist/esm/rubric/observation.js

@@ -0,0 +1,33 @@
+import { DEFAULT_CONFIDENCE, deriveTerms } from "./terms.js";
+/** The relevance line every observation is judged on. */
+export const relevanceLine = (question) => `The answer addresses the question this ask asked. Fail this only if it answers something else, or is empty or evasive. The question: "${question}"`;
+/**
+ * Terms in the parser's own key order, so they read back byte for byte:
+ * v, task, deliverable, campaign, plan, criteria, judge, via.
+ */
+export function observationTerms(input) {
+    const base = deriveTerms(input.question, input.oracle);
+    const criteria = [...base.criteria];
+    if (input.centre) {
+        criteria.push({
+            id: `c${criteria.length + 1}`,
+            kind: "measure",
+            gate: { id: "within-radius", lat: input.centre.lat, lon: input.centre.lon, meters: input.metres, ...(input.place ? { place: input.place } : {}) }
+        });
+        if (input.mode === "photo")
+            criteria.push({ id: `c${criteria.length + 1}`, kind: "measure", gate: { id: "weather-consistent" } });
+        criteria.push({ id: `c${criteria.length + 1}`, kind: "measure", gate: { id: "daylight-consistent" } });
+    }
+    criteria.push({ id: `c${criteria.length + 1}`, kind: "judge", text: relevanceLine(input.question), confidence: DEFAULT_CONFIDENCE });
+    return {
+        v: base.v,
+        task: input.question,
+        deliverable: { type: input.mode === "photo" ? "photo" : "text", prompt: input.question },
+        ...(input.tag ? { campaign: input.tag } : {}),
+        ...(input.plan ? { plan: input.plan } : {}),
+        criteria,
+        judge: base.judge,
+        via: "mcp"
+    };
+}
+//# sourceMappingURL=observation.js.map

package/dist/esm/rubric/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../src/rubric/observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AA0C5F,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAU,EAAE,CACxD,yIAAyI,QAAQ,GAAG,CAAC;AAEvJ;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAuB;IACtD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAgB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;YAC7B,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SAClJ,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAClI,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACrI,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE;QACxF,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,KAAK;KACX,CAAC;AACJ,CAAC"}

package/dist/esm/rubric/pingLink.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The signed personal link a ping carries (Ask the World, B11).
+ *
+ * A ping says "this ask, for this person, until this time". The link's token
+ * binds those three and the ping's own id under a secret only the network
+ * holds, so opening the link proves the ping was sent to that person: the
+ * submit page can then answer *as* them, reserve their slot, and file the
+ * claim in their name. The token proves who was pinged, nothing more; that
+ * a link is opened once is the registry's to enforce, because only it knows.
+ *
+ * Web Crypto HMAC-SHA-256, so the worker that mints and the app that checks
+ * run the same code.
+ */
+/** How long a ping's link stays good: long enough to walk there, short enough that a forwarded link dies. */
+export declare const PING_LINK_MINUTES = 30;
+/** What a valid token says. */
+export interface PingClaim {
+    /** The person's address. */
+    person: string;
+    /** The ask (collection id). */
+    ask: string;
+    /** The ping's id, so a second open can be refused. */
+    ping: string;
+    /** Expiry, epoch seconds. */
+    exp: number;
+}
+/** A token for one ping. The secret must be the one the app checks with. */
+export declare function mintPingToken(claim: PingClaim, secret: string): Promise<string>;
+export type PingTokenCheck = {
+    ok: true;
+    claim: PingClaim;
+} | {
+    ok: false;
+    reason: "malformed" | "forged" | "expired" | "wrong-ask";
+};
+/**
+ * Read a token back. Forged, expired, malformed or meant for another ask: refused, and the
+ * reason says which, so the page can tell the person something true.
+ */
+export declare function checkPingToken(token: string, secret: string, opts?: {
+    ask?: string;
+    now?: number;
+    graceSeconds?: number;
+}): Promise<PingTokenCheck>;
+//# sourceMappingURL=pingLink.d.ts.map

package/dist/esm/rubric/pingLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pingLink.d.ts","sourceRoot":"","sources":["../../../src/rubric/pingLink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,6GAA6G;AAC7G,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAoBD,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMrF;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;CAAE,CAAC;AAEtI;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB7J"}