@ixo/openhands-sdk 0.1.0 → 0.3.0

package/dist/cjs/rubric/marketPlan.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askQuestionFor = exports.readMarketPlan = exports.validatePlan = exports.screenCheck = exports.screenMarket = exports.planCost = exports.planAnswerCount = exports.planAskCount = exports.PLAN_LIMITS = exports.MARKET_PLAN_KIND = exports.PLAN_ACTS = exports.planSlug = exports.slugOfPlanTag = exports.planTag = void 0;
+/** The tag every ask of a plan is filed under. No colon: a tag is `[a-z0-9-]`. */
+const planTag = (slug) => `plan-${slug}`;
+exports.planTag = planTag;
+/** The slug back out of a tag, or null when the tag is not a plan's. */
+const slugOfPlanTag = (tag) => {
+    const match = /^plan-([a-z][a-z0-9-]{2,39})$/.exec(tag ?? "");
+    return match ? match[1] : null;
+};
+exports.slugOfPlanTag = slugOfPlanTag;
+/** A slug from free text: lowercase words joined by dashes, 3–40 characters, starting with a letter. */
+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}`;
+};
+exports.planSlug = planSlug;
+exports.PLAN_ACTS = ["photo", "observation"];
+exports.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. */
+exports.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. */
+const planAskCount = (plan) => plan.checks.reduce((n, check) => n + check.places.length, 0);
+exports.planAskCount = planAskCount;
+/** How many answers a plan buys at most. */
+const planAnswerCount = (plan) => plan.checks.reduce((n, check) => n + check.places.length * check.perPlace, 0);
+exports.planAnswerCount = planAnswerCount;
+/** 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.
+ */
+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) };
+};
+exports.planCost = planCost;
+/*
+ * 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. */
+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;
+};
+exports.screenMarket = screenMarket;
+/** Refusals for one check, read against the market it informs. */
+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 < exports.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;
+};
+exports.screenCheck = screenCheck;
+/** Refusals for the shape of one check: the numbers and lengths a plan must keep. */
+const shapeOfCheck = (check) => {
+    const L = exports.PLAN_LIMITS;
+    const out = [];
+    const bad = (why) => out.push({ rule: "shape", check: check.id, why });
+    if (!exports.PLAN_ACTS.includes(check.act))
+        bad(`The act must be one of ${exports.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.
+ */
+const validatePlan = (plan) => {
+    const L = exports.PLAN_LIMITS;
+    const refusals = [...(0, exports.screenMarket)(plan.market)];
+    const shape = (why) => refusals.push({ rule: "shape", check: null, why });
+    if (plan.kind !== exports.MARKET_PLAN_KIND || plan.v !== 1)
+        shape("This is not a version 1 plan.");
+    if (!(0, exports.slugOfPlanTag)((0, exports.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 ((0, exports.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), ...(0, exports.screenCheck)(check));
+    return refusals;
+};
+exports.validatePlan = validatePlan;
+/** A plan read back from the store, or null when the document is not a version 1 plan. */
+const readMarketPlan = (doc) => {
+    if (!doc || typeof doc !== "object")
+        return null;
+    const plan = doc;
+    if (plan.kind !== exports.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;
+};
+exports.readMarketPlan = readMarketPlan;
+/** The words the asks of one check carry: the check, then its place, then the honest limit of a single look. */
+const askQuestionFor = (check, place) => {
+    const text = check.text.trim().replace(/\s+/g, " ");
+    const at = ` At ${place.name}.`;
+    const room = exports.PLAN_LIMITS.textMax - at.length;
+    return (text.length > room ? `${text.slice(0, room - 1).trimEnd()}…` : text) + at;
+};
+exports.askQuestionFor = askQuestionFor;
+//# sourceMappingURL=marketPlan.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/rubric/observation.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relevanceLine = void 0;
+exports.observationTerms = observationTerms;
+const terms_ts_1 = require("./terms.js");
+/** The relevance line every observation is judged on. */
+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}"`;
+exports.relevanceLine = relevanceLine;
+/**
+ * Terms in the parser's own key order, so they read back byte for byte:
+ * v, task, deliverable, campaign, plan, criteria, judge, via.
+ */
+function observationTerms(input) {
+    const base = (0, terms_ts_1.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: (0, exports.relevanceLine)(input.question), confidence: terms_ts_1.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/cjs/rubric/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../src/rubric/observation.ts"],"names":[],"mappings":";;;AAkDA,4CAuBC;AAzED,yCAA4F;AA0C5F,yDAAyD;AAClD,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAU,EAAE,CACxD,yIAAyI,QAAQ,GAAG,CAAC;AAD1I,QAAA,aAAa,iBAC6H;AAEvJ;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,KAAuB;IACtD,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,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,IAAA,qBAAa,EAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,6BAAkB,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/cjs/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/cjs/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"}

package/dist/cjs/rubric/pingLink.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PING_LINK_MINUTES = void 0;
+exports.mintPingToken = mintPingToken;
+exports.checkPingToken = checkPingToken;
+/** How long a ping's link stays good: long enough to walk there, short enough that a forwarded link dies. */
+exports.PING_LINK_MINUTES = 30;
+const DOMAIN = "openhands-ping:v1";
+const PART = /^[a-z0-9]{1,80}$/;
+const b64url = (bytes) => {
+    let text = "";
+    for (const byte of new Uint8Array(bytes))
+        text += String.fromCharCode(byte);
+    return btoa(text).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+};
+const message = (claim) => [DOMAIN, claim.person, claim.ask, claim.ping, String(claim.exp)].join("|");
+const keyFor = (secret) => crypto.subtle.importKey("raw", new TextEncoder().encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign", "verify"]);
+const mac = async (claim, secret) => b64url(await crypto.subtle.sign("HMAC", await keyFor(secret), new TextEncoder().encode(message(claim))));
+/** A token for one ping. The secret must be the one the app checks with. */
+async function mintPingToken(claim, secret) {
+    if (!secret)
+        throw new Error("No signing secret: a ping link would be unverifiable.");
+    for (const part of [claim.person, claim.ask, claim.ping]) {
+        if (!PART.test(part))
+            throw new Error(`"${part}" cannot go in a ping link.`);
+    }
+    return [claim.person, claim.ask, claim.ping, String(claim.exp), await mac(claim, secret)].join(".");
+}
+/**
+ * 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.
+ */
+async function checkPingToken(token, secret, opts = {}) {
+    if (!secret)
+        return { ok: false, reason: "forged" };
+    const parts = token.split(".");
+    if (parts.length !== 5)
+        return { ok: false, reason: "malformed" };
+    const [person, ask, ping, expText, given] = parts;
+    const exp = Number(expText);
+    if (![person, ask, ping].every((part) => PART.test(part)) || !Number.isInteger(exp))
+        return { ok: false, reason: "malformed" };
+    const claim = { person, ask, ping, exp };
+    const expected = await mac(claim, secret);
+    if (expected.length !== given.length)
+        return { ok: false, reason: "forged" };
+    let diff = 0;
+    for (let i = 0; i < expected.length; i++)
+        diff |= expected.charCodeAt(i) ^ given.charCodeAt(i);
+    if (diff !== 0)
+        return { ok: false, reason: "forged" };
+    if (opts.ask && opts.ask !== ask)
+        return { ok: false, reason: "wrong-ask" };
+    /* The link is theirs for PING_LINK_MINUTES. What it led to can be recorded later: walking to
+       the place and taking the photo can outlast the link, and linking the answer to the ping
+       after that is not opening the link again (`graceSeconds`). */
+    if (Math.floor((opts.now ?? Date.now()) / 1000) >= exp + Math.max(0, opts.graceSeconds ?? 0))
+        return { ok: false, reason: "expired" };
+    return { ok: true, claim };
+}
+//# sourceMappingURL=pingLink.js.map

package/dist/cjs/rubric/pingLink.js.map

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

package/dist/cjs/rubric/pingMatch.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Who to ping when a plan's ask is posted (Ask the World, B9).
+ *
+ * A person in the registry said where they are most days (a coarse cell),
+ * how far they would go, what they know about, when they may be pinged and
+ * how often. An ask has a point, a radius and the plan's topics. The match
+ * is everyone near enough, interested, awake and under their cap, best first,
+ * and three times as many as the ask can pay: people miss pings, and the
+ * first to answer wins the slot.
+ *
+ * Pure and channel-blind: nothing here knows whether the ping goes by
+ * Telegram, WhatsApp or Web Push.
+ */
+/** What a person can say they know about. The onboarding asks the same list. */
+export declare const PING_TOPICS: readonly ["transport", "shops", "prices", "events", "streets", "nature"];
+export type PingTopic = (typeof PING_TOPICS)[number];
+export type PingChannel = "telegram" | "whatsapp" | "webpush";
+/** A person as the matcher reads them from the registry. */
+export interface PingPerson {
+    /** Their address on the chain: claims are filed in this name. */
+    id: string;
+    channel: PingChannel;
+    /** A geohash cell, six characters: never a point. */
+    cell: string;
+    /** How far they would go from the cell, in metres. */
+    radiusM: number;
+    /** Empty means anything. */
+    topics: string[];
+    /** Local hours they may be pinged, [from, to) in 0–24; wraps past midnight when from > to. Absent means any hour. */
+    hours?: {
+        from: number;
+        to: number;
+    };
+    /** Minutes east of UTC for their local hours. */
+    tzOffsetMin?: number;
+    /** Pings a day at most. */
+    dailyCap: number;
+    /** Pings already sent today. */
+    sentToday: number;
+    /** Approved answers so far: the order of who hears first. */
+    approved: number;
+    /** Epoch ms before which they are paused (STOP, or "fewer"). */
+    pausedUntil?: number;
+    /** Asks this person was already pinged for: never twice. */
+    pingedAsks?: string[];
+}
+/** An ask as the matcher reads it. */
+export interface PingAsk {
+    id: string;
+    lat: number;
+    lon: number;
+    /** How close the answer must be taken. */
+    withinM: number;
+    /** The plan's topics; empty means anyone. */
+    topics: string[];
+    /** Answers the ask pays. */
+    quota: number;
+}
+/** How many people to ping per answer the ask can pay. */
+export declare const PINGS_PER_SLOT = 3;
+/** Whether a local hour falls inside a person's window. */
+export declare const inHours: (hours: PingPerson["hours"], now: number, tzOffsetMin?: number) => boolean;
+/** One match: the person and how far their cell's centre is from the ask. */
+export interface PingMatch {
+    person: PingPerson;
+    metres: number;
+}
+/**
+ * The people to ping for an ask, best first: most approved answers, then
+ * nearest. At most `quota × PINGS_PER_SLOT`.
+ */
+export declare function matchPeople(ask: PingAsk, people: PingPerson[], now: number): PingMatch[];
+//# sourceMappingURL=pingMatch.d.ts.map