@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/cjs/campaign/campaigns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../../src/campaign/campaigns.ts"],"names":[],"mappings":";;AAwBA,sCAYC;AApCD,uDAAmD;AACnD,mDAAiD;AAEjD;;;;;;;;;;;;;GAaG;AAEH,yEAAyE;AACzE,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,gFAAgF;AAChF,MAAM,KAAK,GAAG,EAAE,CAAC;AAEV,KAAK,UAAU,aAAa,CAAC,MAAY,IAAI,IAAI,EAAE;IACxD,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAW,EAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,WAAW,GAAG,UAAU,CAAC;IACvD;;;kCAG8B;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,OAAO,IAAA,0BAAW,EAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cjs/campaign/cleanable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Can somebody go and clean this pin right now?
+ *
+ * Its own module, importing nothing at run time, because the browser needs it
+ * (the map's banner, the pin card) and `spots.ts` is the server's: index
+ * queries, the campaign fold, store reads. A client component that imported
+ * this one line from there pulled all of that into its bundle — the same trap
+ * `bandEmoji.ts` was moved out of. The words about WHY a pin is cleanable are
+ * beside the type, in `spots.ts`.
+ */
+import type { Pin } from "./spots.ts";
+export declare const cleanable: (pin: Pick<Pin, "state" | "cleanupId">) => boolean;
+//# sourceMappingURL=cleanable.d.ts.map

package/dist/cjs/campaign/cleanable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanable.d.ts","sourceRoot":"","sources":["../../../src/campaign/cleanable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,SAAS,GAAI,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAAC,KAAG,OACY,CAAC"}

package/dist/cjs/campaign/cleanable.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanable = void 0;
+const cleanable = (pin) => (pin.state === "open" || pin.state === "cleaning") && Boolean(pin.cleanupId);
+exports.cleanable = cleanable;
+//# sourceMappingURL=cleanable.js.map

package/dist/cjs/campaign/cleanable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanable.js","sourceRoot":"","sources":["../../../src/campaign/cleanable.ts"],"names":[],"mappings":";;;AAYO,MAAM,SAAS,GAAG,CAAC,GAAqC,EAAW,EAAE,CAC1E,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AADlE,QAAA,SAAS,aACyD"}

package/dist/cjs/campaign/cleanup.d.ts

@@ -0,0 +1,78 @@
+import type { AskTerms } from "../rubric/terms.ts";
+/**
+ * What a cleanup ask says, in one place.
+ *
+ * These five criteria were being assembled by hand in two files — the campaign
+ * poster and the live smoke — and a third copy was about to appear in the MCP.
+ * That is the drift this estate has already paid for twice in a week: a field
+ * added to the type and not to `parseTerms`, so `photo-pair` terms read as
+ * unparseable and `followUp` was silently dropped. Two hand-built copies of the
+ * *same* document is the same bet with worse odds.
+ *
+ * **The shape is the argument.** Somewhere you must be, a pair that must be in
+ * order, a place that must be the same in both, litter that must be visibly
+ * less, and a sky that must not contradict the hour. The first two a machine
+ * settles; the middle two an AI judges; the last is free. Nothing in here can
+ * say who held the grabber or where the waste went, and the envelope says so.
+ */
+export declare function cleanupTerms(args: {
+    lat: number;
+    lon: number;
+    /** How close the work must be. 150 m is a street corner, not a village. */
+    metres?: number;
+    /** A label, frozen at posting. Never geocoded — see the `near` refusal. */
+    place?: string;
+    campaign?: string;
+    /** The pin this clears, so the map can fold its state from chain. */
+    clears?: string;
+    /**
+     * How many people clear this together.
+     *
+     * A big site is a cluster of small proofs: each participant clears a patch
+     * and hands over their own pair, judged on its own. More than one spot
+     * therefore brings the spread gate with it, or two people could photograph
+     * the same cleared corner and both be paid.
+     */
+    spots?: number;
+    /** How far apart two people's patches must be, when there are several. */
+    apartMetres?: number;
+    /** Where the waste may be taken. Adds the third photograph. */
+    disposal?: {
+        points: {
+            lat: number;
+            lon: number;
+            label?: string;
+        }[];
+        metres: number;
+    };
+    followUp?: {
+        days: number;
+        pay: string;
+    };
+    /** What the mess IS, in the bands' own words ("a car boot of household,
+     *  roadside"). The title speaks of the contents when it can — coordinates
+     *  in an ask's name read like a machine talking to itself, and the
+     *  position already lives in the radius gate and on every map. Absent,
+     *  the place (or, last, the coordinates) still names the work. */
+    what?: string;
+    /**
+     * A site: cleared by many people, patch by patch, over days.
+     *
+     * A one-person cleanup is one pair of photographs and a payout. A site is
+     * too much for anybody alone, so its ask takes two kinds of claim — a
+     * patch (before, after, and the bags) which is checked at once and then
+     * **held**, and a site shot which shows the whole area clear and releases
+     * every held patch, the pot split between them.
+     *
+     * Both kinds are judged against the criteria below; `kind` in the claim's
+     * own body says which one arrived, and the checker holds or releases on
+     * that. The terms carry the flag so the checker learns it from the chain
+     * rather than from a deployment's configuration.
+     */
+    site?: boolean;
+    judge: {
+        address: string;
+        rewardUixo: number;
+    };
+}): AskTerms;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/cjs/campaign/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/campaign/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC;;;;sEAIkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,GAAG,QAAQ,CAiHX"}

package/dist/cjs/campaign/cleanup.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupTerms = cleanupTerms;
+/**
+ * What a cleanup ask says, in one place.
+ *
+ * These five criteria were being assembled by hand in two files — the campaign
+ * poster and the live smoke — and a third copy was about to appear in the MCP.
+ * That is the drift this estate has already paid for twice in a week: a field
+ * added to the type and not to `parseTerms`, so `photo-pair` terms read as
+ * unparseable and `followUp` was silently dropped. Two hand-built copies of the
+ * *same* document is the same bet with worse odds.
+ *
+ * **The shape is the argument.** Somewhere you must be, a pair that must be in
+ * order, a place that must be the same in both, litter that must be visibly
+ * less, and a sky that must not contradict the hour. The first two a machine
+ * settles; the middle two an AI judges; the last is free. Nothing in here can
+ * say who held the grabber or where the waste went, and the envelope says so.
+ */
+function cleanupTerms(args) {
+    const metres = args.metres ?? 150;
+    const where = args.place || `${args.lat.toFixed(4)}, ${args.lon.toFixed(4)}`;
+    /*
+     * The rules below that are about a pair, said so where they are written.
+     *
+     * A site takes two kinds of claim against one rubric, so "the two
+     * photographs show the same place" is also asked of the single wide shot —
+     * and answered no, honestly, because there is only one photograph. On
+     * devnet that rejected a good site claim and left every held patch unpaid.
+     * A criterion that only makes sense for a patch carries `appliesTo: "patch"`
+     * and the bridge skips it for the other kind; nothing has to recognise these
+     * sentences by their wording, which is this file's to change and has
+     * changed.
+     *
+     * Only on a site: where one kind of claim can arrive, every rule is about
+     * it, and a scope nothing would ever act on has no business in a document a
+     * poster signs.
+     */
+    const patchOnly = args.site ? { appliesTo: "patch" } : {};
+    return {
+        v: 2,
+        task: args.site ? `Clear ${args.what || where} together. A patch at a time, then the whole site` : `Clean up ${args.what || where}. Photograph it before and after`,
+        deliverable: {
+            type: "photo-pair",
+            prompt: args.site
+                ? `A patch of ${where}: how you found it, how you left it, and the bags. When the whole area is clear, one wide photograph of it. That one pays everybody who cleared a patch.`
+                : `Two photographs of ${where}: how you found it, and how you left it.`
+        },
+        ...(args.campaign ? { campaign: args.campaign } : {}),
+        ...(args.site ? { site: true } : {}),
+        ...(args.clears ? { clears: args.clears } : {}),
+        ...(args.disposal ? { disposal: args.disposal } : {}),
+        ...(args.followUp ? { followUp: args.followUp } : {}),
+        criteria: [
+            { id: "c1", kind: "measure", gate: { id: "within-radius", lat: args.lat, lon: args.lon, meters: metres, ...(args.place ? { place: args.place } : {}) } },
+            { id: "c2", kind: "measure", gate: { id: "before-after" }, ...patchOnly },
+            /*
+             * The pair is the same place — and NOT which place.
+             *
+             * This line used to end "somewhere in ${where}", and a model asked to
+             * confirm a named street from a photograph of a kerb refuses, honestly:
+             * sand, a wall and some palms do not say which street they are unless a
+             * sign happens to be in frame. Proven on devnet against a real fixture
+             * whose photographs were of the named place — "the photographs do not
+             * establish that the location is somewhere in …" — and it would fail a
+             * real cleaner with a real phone for exactly the same reason.
+             *
+             * Where the work happened is measured, by `within-radius` above, from
+             * the reported point and the photograph's own EXIF. A judged line on
+             * top of that asked a model to do badly what a gate already does well.
+             * What a model CAN see is that the two photographs are of one place,
+             * and that is all this asks now.
+             *
+             * Both of these say what fails them, which they did not. The oracle
+             * wraps a criterion in "if a rule requires something and you cannot
+             * find it, that rule FAILS", so a bare statement of what would be true
+             * is read as a demand to prove it — and a phone photograph of a kerb
+             * proves very little. Ask 43910 lost six of six real claims that way.
+             * Naming the refusal leaves the rest as the judgement it was meant to
+             * be; see `JUDGE_GUIDANCE` in `bridge.ts`, which every judge is now
+             * told first.
+             */
+            { id: "c3", kind: "judge", text: "The two photographs are of the same place. Waste has been taken away between them, so look at the ground, the walls, the kerb and whatever else stands still. Fail this only if they are plainly two different places.", confidence: 0.6, ...patchOnly },
+            { id: "c4", kind: "judge", text: "The after photograph shows less litter on the ground than the before photograph. Fail this if as much waste is still lying there, or more.", confidence: 0.6, ...patchOnly },
+            /*
+             * The one rule a site needs that a single cleanup does not: it has to
+             * be readable for both kinds of claim, because the chain allows one
+             * rubric per ask and both arrive against it. A patch is judged on its
+             * own ground; the site shot is judged on the whole area being clear.
+             */
+            ...(args.site
+                ? [
+                    {
+                        id: "c9",
+                        kind: "judge",
+                        text: "For a patch: the after photograph shows the ground from the before photograph clear, and the third photograph shows that patch's waste bagged or loaded. For the whole site: the photograph shows the area clear. Fail this if waste or full bags are still standing where the work was done.",
+                        confidence: 0.6
+                    }
+                ]
+                : []),
+            /* Free, and therefore included rather than sold: see the checker's card. */
+            { id: "c5", kind: "measure", gate: { id: "daylight-consistent" } },
+            /*
+             * On a shared site, your patch must not be somebody else's patch. The
+             * same gate the mapping ask uses against duplicate pins, pointed at the
+             * cleanup side — without it, each pair is judged alone and two people
+             * photographing one cleared corner would both pass.
+             */
+            ...((args.spots ?? 1) > 1 ? [{ id: "c6", kind: "measure", gate: { id: "not-already-mapped", metres: args.apartMetres ?? 25 } }] : []),
+            /* Where it went — the half a before/after can never show. Both lines are
+               about a patch's own load: the wide shot of a cleared site carries no
+               disposal photograph and its photographer is not at the depot. No
+               caller asks for a site and a disposal point together today; these are
+               marked so that the day one does, it does not reproduce the bug this
+               scope exists to fix. */
+            ...(args.disposal
+                ? [
+                    { id: `c${(args.spots ?? 1) > 1 ? 7 : 6}`, kind: "measure", gate: { id: "at-registered-point", points: args.disposal.points, metres: args.disposal.metres }, ...patchOnly },
+                    {
+                        id: `c${(args.spots ?? 1) > 1 ? 8 : 7}`,
+                        kind: "judge",
+                        text: "The load in the disposal photograph could be the waste shown in the before photograph. Fail this only if it is plainly different waste: a different kind, or far more or far less than was cleared.",
+                        confidence: 0.55,
+                        ...patchOnly
+                    }
+                ]
+                : [])
+        ],
+        judge: { kind: "oracle", address: args.judge.address, rewardUixo: args.judge.rewardUixo }
+    };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/cjs/campaign/cleanup.js.map

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

package/dist/cjs/campaign/commit.d.ts

@@ -0,0 +1,39 @@
+import type { AskTerms } from "../rubric/terms.ts";
+/**
+ * Saying you will come and clean a spot.
+ *
+ * **A commitment was a boolean in one browser and a counter in a file.** The
+ * tap wrote `wcd.helped` locally and incremented an anonymous integer that a
+ * redeploy wiped; nobody could see who was coming, nothing expired, nothing
+ * capped it, and a loop of `curl` could inflate it. Meanwhile the three jobs
+ * a commitment actually has — tell others somebody is coming so a spot is not
+ * cleaned twice, tell the committed person when it is funded, and hold the
+ * spot for them briefly once it is — all need a record with an author.
+ *
+ * So it is a claim: the smallest one this estate can make. One measure
+ * criterion, no judge, no payment worth the name. **Deliberately unjudged** —
+ * the ask carries no checker, so the checker is never invited and the claim
+ * simply stands as filed. A promise is not a thing anybody can verify; what
+ * matters is who made it, about what, and until when, and the chain records
+ * all three the moment it is submitted.
+ *
+ * The gate's one-per-address authorization is what stops a key committing
+ * twice, and gas is the only cost — which is exactly the right price for a
+ * promise: enough that a script does not idly make ten thousand, nothing at
+ * all to a person the gate sponsors.
+ */
+export interface Commitment {
+    /** The mapping claim this is a promise about. */
+    about: string;
+    campaign: string;
+    /** When the promise lapses, so a crew list is who is coming rather than who once said so. */
+    until: string;
+    alias?: string;
+}
+export declare function readCommitment(body: unknown): Commitment | null;
+/** Is this promise still standing? */
+export declare const stillStanding: (commitment: Commitment, now?: number) => boolean;
+export declare function commitTerms(args: {
+    campaign: string;
+}): AskTerms;
+//# sourceMappingURL=commit.d.ts.map

package/dist/cjs/campaign/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../src/campaign/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAW/D;AAED,sCAAsC;AACtC,eAAO,MAAM,aAAa,GAAI,YAAY,UAAU,EAAE,YAAgB,KAAG,OAA6C,CAAC;AAEvH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAkBhE"}

package/dist/cjs/campaign/commit.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stillStanding = void 0;
+exports.readCommitment = readCommitment;
+exports.commitTerms = commitTerms;
+function readCommitment(body) {
+    const doc = body;
+    if (!doc || typeof doc.about !== "string" || typeof doc.campaign !== "string" || typeof doc.until !== "string")
+        return null;
+    if (!/^bafk[a-z2-7]{20,}$/.test(doc.about))
+        return null;
+    if (Number.isNaN(Date.parse(doc.until)))
+        return null;
+    return {
+        about: doc.about,
+        campaign: doc.campaign,
+        until: doc.until,
+        ...(typeof doc.alias === "string" && doc.alias ? { alias: doc.alias.slice(0, 40) } : {})
+    };
+}
+/** Is this promise still standing? */
+const stillStanding = (commitment, now = Date.now()) => Date.parse(commitment.until) > now;
+exports.stillStanding = stillStanding;
+function commitTerms(args) {
+    return {
+        v: 2,
+        task: "Say you'll clean a mapped spot",
+        deliverable: {
+            type: "commitment",
+            prompt: "Which spot you mean to clean, and how long you're promising for."
+        },
+        campaign: args.campaign,
+        /* The crew list is the whole point: a promise nobody can see does none of
+           the three jobs a commitment has. */
+        publish: "on-approval",
+        criteria: [{ id: "c1", kind: "measure", gate: { id: "non-empty" } }],
+        /* The poster, not an oracle — and no evaluate authorization is ever
+           granted, so nothing judges it. A promise is not true or false; it is
+           made or not made, and the submission is the making of it. */
+        judge: { kind: "poster" }
+    };
+}
+//# sourceMappingURL=commit.js.map

package/dist/cjs/campaign/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../../src/campaign/commit.ts"],"names":[],"mappings":";;;AAmCA,wCAWC;AAKD,kCAkBC;AAlCD,SAAgB,cAAc,CAAC,IAAa;IAC1C,MAAM,GAAG,GAAG,IAAkC,CAAC;IAC/C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5H,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC;AAED,sCAAsC;AAC/B,MAAM,aAAa,GAAG,CAAC,UAAsB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;AAA1G,QAAA,aAAa,iBAA6F;AAEvH,SAAgB,WAAW,CAAC,IAA0B;IACpD,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE;YACX,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,kEAAkE;SAC3E;QACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB;8CACsC;QACtC,OAAO,EAAE,aAAa;QACtB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC;QACpE;;uEAE+D;QAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B,CAAC;AACJ,CAAC"}

package/dist/cjs/campaign/field.d.ts

@@ -0,0 +1,50 @@
+import type { AskTerms } from "../rubric/terms.ts";
+/**
+ * What somebody found when they actually went there.
+ *
+ * Three findings, one mechanism, and it is **its own ask** rather than a
+ * verdict on a cleanup — because the chain pays a fixed amount per approval,
+ * so an approved "there is nothing here" sitting on a cleanup ask would
+ * collect the cleanup's payout. Absence is worth paying for, but it is worth
+ * a report's fee and not a day's work.
+ *
+ * Each finding closes something no other layer here could:
+ *
+ *  - **absent** — a pin that was never real, or is gone. Without it a
+ *    fabricated pin sits on the map forever soaking up pledges, and the
+ *    photo-reuse attack has no failure mode. This is what makes a fake pin
+ *    *die*.
+ *  - **hazardous** — the on-site abort. A mapper can frame asbestos out of a
+ *    photograph, so the judge that reads the picture cannot be the last word.
+ *    Reporting it costs the volunteer nothing and routes the pin to
+ *    professionals.
+ *  - **confirmed** — a second person stood here. On a truck-sized site this
+ *    is what strangers' money and a sponsor's match wait for.
+ */
+export declare const FINDINGS: readonly ["absent", "hazardous", "confirmed"];
+export type Finding = (typeof FINDINGS)[number];
+export interface FieldReport {
+    /** The pin this is about: the mapping claim's id. */
+    about: string;
+    finding: Finding;
+    campaign: string;
+}
+export declare const isFinding: (value: unknown) => value is Finding;
+export declare function readReport(body: unknown): FieldReport | null;
+/**
+ * The standing ask people report through.
+ *
+ * Deliberately cheap and deliberately not about a place the terms name: the
+ * reporter says which pin they are talking about, and the gate checks only
+ * that they were somewhere and that the photograph supports what they said.
+ * A tighter rule would make the hazard abort expensive to use, and an abort
+ * nobody reaches for is not a safety mechanism.
+ */
+export declare function fieldTerms(args: {
+    campaign: string;
+    judge: {
+        address: string;
+        rewardUixo: number;
+    };
+}): AskTerms;
+//# sourceMappingURL=field.d.ts.map

package/dist/cjs/campaign/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../src/campaign/field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,QAAQ,+CAAgD,CAAC;AACtE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAA8C,CAAC;AAEnG,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAM5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,QAAQ,CA2C/G"}

package/dist/cjs/campaign/field.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFinding = exports.FINDINGS = void 0;
+exports.readReport = readReport;
+exports.fieldTerms = fieldTerms;
+/**
+ * What somebody found when they actually went there.
+ *
+ * Three findings, one mechanism, and it is **its own ask** rather than a
+ * verdict on a cleanup — because the chain pays a fixed amount per approval,
+ * so an approved "there is nothing here" sitting on a cleanup ask would
+ * collect the cleanup's payout. Absence is worth paying for, but it is worth
+ * a report's fee and not a day's work.
+ *
+ * Each finding closes something no other layer here could:
+ *
+ *  - **absent** — a pin that was never real, or is gone. Without it a
+ *    fabricated pin sits on the map forever soaking up pledges, and the
+ *    photo-reuse attack has no failure mode. This is what makes a fake pin
+ *    *die*.
+ *  - **hazardous** — the on-site abort. A mapper can frame asbestos out of a
+ *    photograph, so the judge that reads the picture cannot be the last word.
+ *    Reporting it costs the volunteer nothing and routes the pin to
+ *    professionals.
+ *  - **confirmed** — a second person stood here. On a truck-sized site this
+ *    is what strangers' money and a sponsor's match wait for.
+ */
+exports.FINDINGS = ["absent", "hazardous", "confirmed"];
+const isFinding = (value) => exports.FINDINGS.includes(value);
+exports.isFinding = isFinding;
+function readReport(body) {
+    const doc = body;
+    if (!doc || typeof doc.about !== "string" || !doc.about)
+        return null;
+    if (!(0, exports.isFinding)(doc.finding))
+        return null;
+    if (typeof doc.campaign !== "string" || !doc.campaign)
+        return null;
+    return { about: doc.about, finding: doc.finding, campaign: doc.campaign };
+}
+/**
+ * The standing ask people report through.
+ *
+ * Deliberately cheap and deliberately not about a place the terms name: the
+ * reporter says which pin they are talking about, and the gate checks only
+ * that they were somewhere and that the photograph supports what they said.
+ * A tighter rule would make the hazard abort expensive to use, and an abort
+ * nobody reaches for is not a safety mechanism.
+ */
+function fieldTerms(args) {
+    return {
+        v: 2,
+        task: "Report what you found at a mapped spot",
+        deliverable: {
+            type: "field-report",
+            prompt: "A photograph of the spot as you found it, and which of the three things it is: nothing here, hazardous, or confirmed."
+        },
+        campaign: args.campaign,
+        publish: "on-approval",
+        criteria: [
+            { id: "c1", kind: "measure", gate: { id: "located" } },
+            /*
+             * **It rules on the words in the answer, not on the `finding` key.**
+             *
+             * The three findings travel twice: as a top-level `finding` field, which
+             * the fold reads to move the pin, and as a sentence in the deliverable —
+             * "Nothing here any more.", "Still here — I stood in front of it." —
+             * which is the only one of the two a judge ever sees. A judge is sent
+             * `task`, the deliverable text and the photograph and nothing else
+             * (`JUDGE_SEND_KEYS.photo`), and the claim form declares no `finding`
+             * question to map, so the vocabulary words themselves never reach the
+             * model. This sentence used to quote them — "an empty place for 'nothing
+             * here'" — and asked a model to match a label it had not been given: the
+             * same defect that made the mapping ask's hazard criterion unsatisfiable
+             * and cost it six of six claims. It now compares the photograph with
+             * what the answer says in its own words, which is a thing the model can
+             * actually do.
+             *
+             * The asbestos list went with them. A reporter who is standing in front
+             * of something dangerous should be filing the abort, not passing a
+             * vocabulary test on their way through it, and the fold has already
+             * routed the pin by then.
+             */
+            {
+                id: "c2",
+                kind: "judge",
+                text: "The photograph is consistent with what the answer says was found at the spot: an empty or cleared place if it says the waste is gone, waste still present if it says it is still there, something dangerous if it says so. Fail this only if the photograph plainly shows the opposite.",
+                confidence: 0.6
+            }
+        ],
+        judge: { kind: "oracle", address: args.judge.address, rewardUixo: args.judge.rewardUixo }
+    };
+}
+//# sourceMappingURL=field.js.map

package/dist/cjs/campaign/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../../src/campaign/field.ts"],"names":[],"mappings":";;;AAqCA,gCAMC;AAWD,gCA2CC;AA/FD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEU,QAAA,QAAQ,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAU/D,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,gBAAQ,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;AAAtF,QAAA,SAAS,aAA6E;AAEnG,SAAgB,UAAU,CAAC,IAAa;IACtC,MAAM,GAAG,GAAG,IAAmC,CAAC;IAChD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,CAAC,IAAA,iBAAS,EAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,IAA0E;IACnG,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,wCAAwC;QAC9C,WAAW,EAAE;YACX,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,uHAAuH;SAChI;QACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,aAAa;QACtB,QAAQ,EAAE;YACR,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE;YACtD;;;;;;;;;;;;;;;;;;;;;eAqBG;YACH;gBACE,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,yRAAyR;gBAC/R,UAAU,EAAE,GAAG;aAChB;SACF;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;KAC1F,CAAC;AACJ,CAAC"}