@ixo/openhands-sdk 0.2.0 → 0.4.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pingMatch.d.ts","sourceRoot":"","sources":["../../../src/rubric/pingMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,gFAAgF;AAChF,eAAO,MAAM,WAAW,0EAA2E,CAAC;AACpG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,CAAC;IACrB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qHAAqH;IACrH,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,sCAAsC;AACtC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,2DAA2D;AAC3D,eAAO,MAAM,OAAO,GAAI,OAAO,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,MAAM,EAAE,oBAAe,KAAG,OAOlF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAiBxF"}

package/dist/cjs/rubric/pingMatch.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inHours = exports.PINGS_PER_SLOT = exports.PING_TOPICS = void 0;
+exports.matchPeople = matchPeople;
+const box_ts_1 = require("../geo/box.js");
+const geohash_ts_1 = require("../geo/geohash.js");
+/** What a person can say they know about. The onboarding asks the same list. */
+exports.PING_TOPICS = ["transport", "shops", "prices", "events", "streets", "nature"];
+/** How many people to ping per answer the ask can pay. */
+exports.PINGS_PER_SLOT = 3;
+/** Whether a local hour falls inside a person's window. */
+const inHours = (hours, now, tzOffsetMin = 0) => {
+    if (!hours)
+        return true;
+    const local = new Date(now + tzOffsetMin * 60_000);
+    const hour = local.getUTCHours() + local.getUTCMinutes() / 60;
+    const { from, to } = hours;
+    if (from === to)
+        return true;
+    return from < to ? hour >= from && hour < to : hour >= from || hour < to;
+};
+exports.inHours = inHours;
+/**
+ * The people to ping for an ask, best first: most approved answers, then
+ * nearest. At most `quota × PINGS_PER_SLOT`.
+ */
+function matchPeople(ask, people, now) {
+    const wanted = new Set(ask.topics);
+    const matches = [];
+    for (const person of people) {
+        if (person.pausedUntil && person.pausedUntil > now)
+            continue;
+        if (person.sentToday >= person.dailyCap)
+            continue;
+        if (person.pingedAsks?.includes(ask.id))
+            continue;
+        if (wanted.size && person.topics.length && !person.topics.some((topic) => wanted.has(topic)))
+            continue;
+        if (!(0, exports.inHours)(person.hours, now, person.tzOffsetMin))
+            continue;
+        const centre = (0, geohash_ts_1.geohashCentre)(person.cell);
+        if (!centre)
+            continue;
+        const metres = (0, box_ts_1.haversineMetres)(centre, { lat: ask.lat, lon: ask.lon });
+        if (metres > person.radiusM + ask.withinM)
+            continue;
+        matches.push({ person, metres });
+    }
+    matches.sort((a, b) => b.person.approved - a.person.approved || a.metres - b.metres);
+    return matches.slice(0, Math.max(1, ask.quota) * exports.PINGS_PER_SLOT);
+}
+//# sourceMappingURL=pingMatch.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * A survey check's answer: one of a few options, the reason in the person's
+ * own words, and what they expect most people around them to say
+ * (docs/verified-work-ask-the-world-plan.md, "Surveys").
+ *
+ * Some markets have nothing to photograph — a jury's vote, a crowd's mood —
+ * and the honest signal there is what people think, asked of real people in
+ * the right place. Asking what they expect *others* to say beside their own
+ * answer is the "surprisingly popular" read: an option chosen more often than
+ * people predicted is the one the crowd knows something about.
+ *
+ * The answer travels as plain text in one fixed shape, written by the answer
+ * page and read back here, so the judge reads what the person said and the
+ * tally needs no second format.
+ */
+export declare const SURVEY_LIMITS: {
+    readonly optionsMin: 2;
+    readonly optionsMax: 6;
+    readonly optionMax: 60;
+    readonly whyMax: 400;
+};
+/** The options a survey check may carry, or the reason they may not. */
+export declare function surveyOptionsProblem(options: unknown): string | null;
+/** The answer as the page files it. */
+export declare function surveyAnswerText(answer: {
+    choice: string;
+    why: string;
+    others: string;
+}): string;
+/** An answer read back: which option, what they expect others to say, and why. Options outside the list read as none. */
+export declare function readSurveyAnswer(text: string, options: readonly string[]): {
+    choice: string | null;
+    others: string | null;
+    why: string;
+};
+/**
+ * The judge's one rule for a survey answer: a real pick with a real reason.
+ * It names its refusal first, as every judged line here does. It lists
+ * neither the question (the judge is sent the ask's task) nor the options:
+ * the answer page offers only the listed ones and the tally counts nothing
+ * else, and six options would not fit the 300 characters a criterion keeps.
+ */
+export declare const SURVEY_JUDGE_LINE = "The answer gives one choice and a reason in the person's own words. Fail this only if it gives no choice, or the reason is empty, copied from the question or unrelated to it.";
+/** One option's line in a tally. */
+export interface SurveyLine {
+    option: string;
+    /** Approved answers that picked it. */
+    answers: number;
+    /** Approved answers that expected most people to pick it. */
+    predicted: number;
+}
+/**
+ * The tally of a survey's approved answers, and the option chosen more often
+ * than people predicted (by share), when there is one and enough answers to
+ * mean anything (5 or more).
+ */
+export declare function tallySurvey(options: readonly string[], answers: readonly {
+    choice: string | null;
+    others: string | null;
+}[]): {
+    lines: SurveyLine[];
+    total: number;
+    surprisinglyPopular: string | null;
+};
+//# sourceMappingURL=survey.d.ts.map

package/dist/cjs/rubric/survey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey.d.ts","sourceRoot":"","sources":["../../../src/rubric/survey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,aAAa;;;;;CAAwE,CAAC;AAMnG,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAapE;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEhG;AAOD,yHAAyH;AACzH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAIxI;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,mLACoJ,CAAC;AAEnL,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAwBxM"}

package/dist/cjs/rubric/survey.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * A survey check's answer: one of a few options, the reason in the person's
+ * own words, and what they expect most people around them to say
+ * (docs/verified-work-ask-the-world-plan.md, "Surveys").
+ *
+ * Some markets have nothing to photograph — a jury's vote, a crowd's mood —
+ * and the honest signal there is what people think, asked of real people in
+ * the right place. Asking what they expect *others* to say beside their own
+ * answer is the "surprisingly popular" read: an option chosen more often than
+ * people predicted is the one the crowd knows something about.
+ *
+ * The answer travels as plain text in one fixed shape, written by the answer
+ * page and read back here, so the judge reads what the person said and the
+ * tally needs no second format.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SURVEY_JUDGE_LINE = exports.SURVEY_LIMITS = void 0;
+exports.surveyOptionsProblem = surveyOptionsProblem;
+exports.surveyAnswerText = surveyAnswerText;
+exports.readSurveyAnswer = readSurveyAnswer;
+exports.tallySurvey = tallySurvey;
+exports.SURVEY_LIMITS = { optionsMin: 2, optionsMax: 6, optionMax: 60, whyMax: 400 };
+const ANSWER = "Answer: ";
+const WHY = "Why: ";
+const OTHERS = "Most people here will say: ";
+/** The options a survey check may carry, or the reason they may not. */
+function surveyOptionsProblem(options) {
+    const L = exports.SURVEY_LIMITS;
+    if (!Array.isArray(options))
+        return "A survey needs its options.";
+    if (options.length < L.optionsMin || options.length > L.optionsMax)
+        return `A survey has ${L.optionsMin}–${L.optionsMax} options.`;
+    const seen = new Set();
+    for (const option of options) {
+        if (typeof option !== "string" || !option.trim() || option.trim().length > L.optionMax)
+            return `Every option is 1–${L.optionMax} characters.`;
+        if (/[\n\r]/.test(option))
+            return "An option is one line.";
+        const key = option.trim().toLowerCase();
+        if (seen.has(key))
+            return `"${option.trim()}" is listed twice.`;
+        seen.add(key);
+    }
+    return null;
+}
+/** The answer as the page files it. */
+function surveyAnswerText(answer) {
+    return [`${ANSWER}${answer.choice.trim()}`, `${WHY}${answer.why.trim().replace(/\s+/g, " ").slice(0, exports.SURVEY_LIMITS.whyMax)}`, `${OTHERS}${answer.others.trim()}`].join("\n");
+}
+const optionOf = (said, options) => {
+    const wanted = (said ?? "").trim().toLowerCase();
+    return options.find((option) => option.trim().toLowerCase() === wanted) ?? null;
+};
+/** An answer read back: which option, what they expect others to say, and why. Options outside the list read as none. */
+function readSurveyAnswer(text, options) {
+    const lines = text.split(/\r?\n/);
+    const field = (prefix) => lines.find((line) => line.startsWith(prefix))?.slice(prefix.length);
+    return { choice: optionOf(field(ANSWER), options), others: optionOf(field(OTHERS), options), why: (field(WHY) ?? "").trim() };
+}
+/**
+ * The judge's one rule for a survey answer: a real pick with a real reason.
+ * It names its refusal first, as every judged line here does. It lists
+ * neither the question (the judge is sent the ask's task) nor the options:
+ * the answer page offers only the listed ones and the tally counts nothing
+ * else, and six options would not fit the 300 characters a criterion keeps.
+ */
+exports.SURVEY_JUDGE_LINE = "The answer gives one choice and a reason in the person's own words. Fail this only if it gives no choice, or the reason is empty, copied from the question or unrelated to it.";
+/**
+ * The tally of a survey's approved answers, and the option chosen more often
+ * than people predicted (by share), when there is one and enough answers to
+ * mean anything (5 or more).
+ */
+function tallySurvey(options, answers) {
+    const lines = options.map((option) => ({ option, answers: 0, predicted: 0 }));
+    let total = 0;
+    for (const answer of answers) {
+        const picked = lines.find((line) => line.option === answer.choice);
+        if (!picked)
+            continue;
+        picked.answers += 1;
+        total += 1;
+        const expected = lines.find((line) => line.option === answer.others);
+        if (expected)
+            expected.predicted += 1;
+    }
+    let surprisinglyPopular = null;
+    if (total >= 5) {
+        const predictedTotal = lines.reduce((sum, line) => sum + line.predicted, 0) || 1;
+        let best = 0;
+        for (const line of lines) {
+            const lift = line.answers / total - line.predicted / predictedTotal;
+            if (lift > best + 1e-9) {
+                best = lift;
+                surprisinglyPopular = line.option;
+            }
+        }
+    }
+    return { lines, total, surprisinglyPopular };
+}
+//# sourceMappingURL=survey.js.map

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

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

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

@@ -233,6 +233,11 @@ export interface Deliverable {
     type: DeliverableType;
     /** What the worker is being asked to hand over, in the poster's words. */
     prompt: string;
+    /**
+     * A survey's options (rubric/survey.ts): the answer page offers them, and
+     * the answer is filed as text in one fixed shape. 2–6 one-line options.
+     */
+    choices?: string[];
 }
 export type CriterionKind = "measure" | "judge" | "attest";
 /**
@@ -321,6 +326,14 @@ export interface AskTerms {
      * escrow; the tag only says they belong together.
      */
     series?: string;
+    /**
+     * The Ask the World plan this ask is one check of: the content address of
+     * the frozen plan document (docs/verified-work-ask-the-world-plan.md, D1).
+     * It names the market the answer informs, the check, what the check beats
+     * and what the plan cannot tell, so a report can be rebuilt from the chain
+     * alone. Frozen at posting, like the campaign it sits beside.
+     */
+    plan?: string;
     /**
      * This ask is a site: cleared by several people, a patch at a time.
      *
@@ -597,6 +610,8 @@ export declare function parseTerms(value: unknown): AskTerms | null;
  * difference between a file picker and the camera opening.
  */
 export declare function inferDeliverable(title: string): Deliverable;
+/** The gates a deliverable implies on its own — a file's shape, not its content. */
+export declare function deliverableGates(deliverable: Deliverable): Gate[];
 /**
  * The floor, in v2 clothing — what an ask means when nothing else is said.
  *

package/dist/cjs/rubric/terms.d.ts.map

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

package/dist/cjs/rubric/terms.js

@@ -23,8 +23,10 @@ exports.normalizeTerms = normalizeTerms;
 exports.callOf = callOf;
 exports.parseTerms = parseTerms;
 exports.inferDeliverable = inferDeliverable;
+exports.deliverableGates = deliverableGates;
 exports.deriveTerms = deriveTerms;
 exports.addCriterion = addCriterion;
+const survey_ts_1 = require("./survey.js");
 /** Evidence no text-only worker can produce: no camera, no hands, no address. */
 const PHYSICAL = /\b(photo|photograph|picture|snap|image of|screenshot|screen shot|selfie|video|film|scan|handwritten|sticky note|poster|in person|visit|go to|walk|drive|deliver|pick up|drop off|knock|doorstep|on ?site|meet|queue|shelf|receipt)\b/i;
 const URL_PATTERN = /\bhttps?:\/\/[^\s"'<>)]+|\b(?:[a-z0-9-]+\.)+(?:com|org|net|io|dev|app|earth|xyz|co|ai|me|so|sh|eu|uk|de)(?:\/[^\s"'<>)]*)?/i;
@@ -645,6 +647,15 @@ function disposalOf(raw) {
         .map((one) => ({ lat: Number(one.lat), lon: Number(one.lon), ...(one.label ? { label: trim(String(one.label), 60) } : {}) }));
     return { disposal: { points, metres: Math.floor(Number(raw.metres)) } };
 }
+/**
+ * The deliverable as kept: the prompt trimmed, and a survey's choices only when
+ * they are a real survey's (rubric/survey.ts) — named here or dropped here, like
+ * every other field.
+ */
+function deliverableOf(deliverable) {
+    const { choices, ...rest } = deliverable;
+    return { ...rest, prompt: trim(deliverable.prompt, PROMPT_MAX), ...(choices !== undefined && (0, survey_ts_1.surveyOptionsProblem)(choices) === null ? { choices: choices.map((one) => one.trim()) } : {}) };
+}
 function parseTerms(value) {
     const doc = value;
     if (!doc || typeof doc !== "object")
@@ -684,9 +695,11 @@ function parseTerms(value) {
     return {
         v: 2,
         task: trim(doc.task, TASK_MAX),
-        deliverable: { ...deliverable, prompt: trim(deliverable.prompt, PROMPT_MAX) },
+        deliverable: deliverableOf(deliverable),
         ...(typeof doc.campaign === "string" && doc.campaign ? { campaign: trim(doc.campaign, 64) } : {}),
         ...(typeof doc.series === "string" && /^[a-z0-9-]{1,64}$/.test(doc.series) ? { series: doc.series } : {}),
+        /* Named here or dropped here. Only a content address: the plan is a document, never a label. */
+        ...(typeof doc.plan === "string" && /^baf[a-z2-7]{20,}$/.test(doc.plan) ? { plan: doc.plan } : {}),
         ...(chainOf(doc.chain) ?? {}),
         ...(callOf(doc.call) ?? {}),
         ...(doc.followUp && Number(doc.followUp.days) > 0 && doc.followUp.pay