@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/cjs/rubric/compose.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAMPAIGN_TAG = void 0;
+exports.formTerms = formTerms;
+const terms_ts_1 = require("./terms.js");
+exports.CAMPAIGN_TAG = /^[a-z0-9-]{1,64}$/;
+const DEFAULT_METRES = 150;
+/** Words that already promise a photograph, so the title is not told twice. */
+const SAYS_PHOTO = /photo|picture|snap|film|image|shot/i;
+/** The same courtesy for a file — the title says it once or not at all. */
+const SAYS_FILE = /\b(video|film|footage|recording|scan|pdf|document|file|upload)\b/i;
+/** 25 MB, the ceiling `deriveTerms` puts on a file it inferred for itself. */
+const FILE_MAX_BYTES = 26_214_400;
+/** A sentence that already says before-and-after keeps its own words. */
+const SAYS_PAIR = /before[\s-]*(?:and|&)[\s-]*after/i;
+/** What "a written answer" is held to — `deriveRubric`'s own floor for written work. */
+const WORDS_MIN = 20;
+/**
+ * The two blocks that attach to any shape of ask, applied in the order a
+ * reader would say them: tell me exactly where you stood, and use these words.
+ *
+ * Shared by both branches below because they are shared by both kinds of ask.
+ * A before-and-after cleanup can want the exact spot as much as a photograph
+ * can, and the cleanup builder has no business knowing about either.
+ */
+function withLooseBlocks(terms, form) {
+    let built = terms;
+    /*
+     * Words. Alone, the block outranks the sentence exactly as *A file* does:
+     * "photograph the notice board" with only Words added is asking for a
+     * description, not a camera, so the deliverable is text and the photo's
+     * own gates go with it. Beside an attachment it is the note that must come
+     * with it — the claim's `deliverable` text, which is what `min-length`
+     * measures. A sentence that already demands a length keeps its own number:
+     * one rule, never two saying the same thing.
+     */
+    if (form.words) {
+        const attached = Boolean(form.proof && form.proof !== "text");
+        if (!attached && (built.deliverable.type === "photo" || built.deliverable.type === "file")) {
+            built = {
+                ...built,
+                deliverable: { type: "text", prompt: built.task },
+                criteria: built.criteria.filter((criterion) => !(criterion.kind === "measure" && (criterion.gate.id === "file-type" || criterion.gate.id === "max-bytes")))
+            };
+        }
+        if (!built.criteria.some((criterion) => criterion.kind === "measure" && criterion.gate.id === "min-length")) {
+            built = (0, terms_ts_1.addCriterion)(built, { kind: "measure", gate: { id: "min-length", chars: WORDS_MIN } });
+        }
+    }
+    /*
+     * A file with the photograph. The claim carries it beside its primary
+     * file; the gate holds it to the ceiling a file deliverable has, the
+     * capture asks for it (`wantsExtra`) and the checker measures it.
+     */
+    if (form.withFile && (form.proof === "photo" || form.proof === "pair")) {
+        built = (0, terms_ts_1.addCriterion)(built, { kind: "measure", gate: { id: "with-file", bytes: FILE_MAX_BYTES } });
+    }
+    /*
+     * `located` establishes only that a position was reported at all — which is
+     * the whole point when finding the coordinates IS the work. It composes with
+     * a radius rather than replacing it: be somewhere near this, and say where.
+     */
+    if (form.pin)
+        built = (0, terms_ts_1.addCriterion)(built, { kind: "measure", gate: { id: "located" } });
+    /*
+     * The phrases the poster asked for, minus anything the sentence already
+     * demanded. Two `mentions-terms` gates saying overlapping things would read
+     * to a worker as two rules and be one, and the second would be the poster's
+     * own words repeated back at them.
+     */
+    if (form.mentions?.length) {
+        const already = new Set(built.criteria.flatMap((criterion) => (criterion.kind === "measure" && criterion.gate.id === "mentions-terms" ? criterion.gate.terms.map((term) => term.toLowerCase()) : [])));
+        const wanted = [...new Set(form.mentions.map((term) => term.trim()).filter(Boolean))].filter((term) => !already.has(term.toLowerCase()));
+        if (wanted.length)
+            built = (0, terms_ts_1.addCriterion)(built, { kind: "measure", gate: { id: "mentions-terms", terms: wanted } });
+    }
+    return built;
+}
+function formTerms(form) {
+    const task = form.task.trim();
+    if (!task)
+        throw new Error("say what needs doing");
+    if (form.namedPlace?.trim() && !form.place)
+        throw new Error(`this ask names ${form.namedPlace.trim()}. Set where it must be done`);
+    if (form.campaign && !exports.CAMPAIGN_TAG.test(form.campaign))
+        throw new Error("a campaign tag is lowercase letters, digits and dashes");
+    /* All-digit tags are the chain namespace — a spawned child wears its parent
+       ask's collection id as its tag. Reserving them here is what makes a
+       numeric tag mean "this ask has a parent" everywhere, unforgeably. */
+    if (form.campaign && /^\d+$/.test(form.campaign))
+        throw new Error("an all-digit campaign tag names a chained ask's parent. Pick a tag with a letter in it");
+    if (form.series && !exports.CAMPAIGN_TAG.test(form.series))
+        throw new Error("a series name is lowercase letters, digits and dashes");
+    if (form.followUp && form.proof !== "pair")
+        throw new Error("a follow-up only makes sense on a before-and-after ask");
+    if (form.then) {
+        if (!form.then.task.trim())
+            throw new Error("the next ask needs a task");
+        if (!(form.then.targetBase > 0))
+            throw new Error("the next ask needs a funding target above zero");
+    }
+    /*
+     * Before-and-after, as the form means it: two photographs of one place,
+     * framed alike, and the poster's own words for what changed between them.
+     *
+     * This is deliberately not `cleanupTerms`. That builder is the campaign's —
+     * it titles the ask "Clean up …", rules on litter, and needs a place because
+     * a cleanup follows a mapped pin. A desk, a wall, a shelf are before-and-
+     * afters too, and the form used to refuse all of them until a place was
+     * set, then throw the poster's sentence away for the cleanup's. Here the
+     * place is a block like any other: a radius when they set one, nothing
+     * when they do not — the pair gate then rules on order alone and "same
+     * place" is the judge's line. The measure gates are the cleanup's, id for
+     * id, so with a place the machine floor is identical; only the title and
+     * the judged sentences are the poster's instead of the campaign's.
+     */
+    if (form.proof === "pair") {
+        const where = form.place ? form.place.label || `${form.place.lat.toFixed(4)}, ${form.place.lon.toFixed(4)}` : null;
+        const metres = form.place?.metres ?? DEFAULT_METRES;
+        let title = SAYS_PAIR.test(task) ? task : `${task}. Photographed before and after`;
+        if (form.place && where)
+            title = `${title}, within ${(0, terms_ts_1.distanceWords)(metres)} of ${where}`;
+        const criteria = [];
+        const rule = (criterion) => criteria.push({ id: `c${criteria.length + 1}`, ...criterion });
+        if (form.place) {
+            rule({ kind: "measure", gate: { id: "within-radius", lat: form.place.lat, lon: form.place.lon, meters: metres, ...(form.place.label ? { place: form.place.label } : {}) } });
+        }
+        rule({ kind: "measure", gate: { id: "before-after" } });
+        /*
+         * **No place name in a judged sentence, and both lines say what fails
+         * them.** This one ended ", somewhere in the verge" when the poster set a
+         * place, which asks a model to confirm a street from a photograph of a
+         * kerb — it cannot, and it says so, and an honest pair is refused. The
+         * campaign's cleanup had the identical clause removed for the identical
+         * reason; where the work happened is the `within-radius` gate's job, from
+         * the reported point and the photograph's own EXIF, and that gate is
+         * already above when there is a place at all. The rest states its own
+         * refusal, because the oracle's wrapper fails any rule it cannot find
+         * proof for — see `JUDGE_GUIDANCE` in `bridge.ts`.
+         */
+        rule({ kind: "judge", text: "The two photographs are of the same place. Things will have moved between them, so look at what stands still: the ground, the walls, the furniture. Fail this only if they are plainly two different places.", confidence: 0.6 });
+        rule({ kind: "judge", text: "The after photograph shows the work the ask describes done: something visibly changed from the before photograph. Fail this if the two photographs show the same state, or if the change is not the work the ask asked for.", confidence: 0.6 });
+        /* Free, and therefore included rather than sold: see the checker's card. */
+        rule({ kind: "measure", gate: { id: "daylight-consistent" } });
+        /* In the parser's own key order, so a publish → parse round trip is
+           byte-identical — the property the engine bridge leans on. */
+        const terms = {
+            v: 2,
+            task: title,
+            deliverable: { type: "photo-pair", prompt: "Two photographs, framed alike: how you found it, and how you left it." },
+            ...(form.campaign ? { campaign: form.campaign } : {}),
+            ...(form.series ? { series: form.series } : {}),
+            ...(form.followUp ? { followUp: form.followUp } : {}),
+            criteria,
+            judge: { kind: "poster" }
+        };
+        return { terms: withLooseBlocks(terms, form), title };
+    }
+    /* The title is built first and the terms derive from it, so the minted
+       sentence and the published terms can never disagree about the task. */
+    let title = task;
+    if (form.proof === "photo" && !SAYS_PHOTO.test(task))
+        title = `${task}. A photograph`;
+    if (form.proof === "file" && !SAYS_FILE.test(task))
+        title = `${task}. A file`;
+    if (form.place) {
+        const metres = form.place.metres ?? DEFAULT_METRES;
+        const where = form.place.label || `${form.place.lat.toFixed(4)}, ${form.place.lon.toFixed(4)}`;
+        title = `${title}, within ${(0, terms_ts_1.distanceWords)(metres)} of ${where}`;
+    }
+    let terms = (0, terms_ts_1.deriveTerms)(title);
+    /*
+     * The block outranks the sentence. `inferDeliverable` reads a title and
+     * guesses, and it checks photo words before file words — so "send me the
+     * event photos as one archive" guesses a camera. A poster who added the
+     * *A file* block has already said which one it is, and a camera-only
+     * picker would refuse the archive they asked for.
+     */
+    if (form.proof === "file" && terms.deliverable.type !== "file") {
+        terms = {
+            ...terms,
+            deliverable: { type: "file", prompt: title },
+            /* The photo's own gates go with it: an image-only filter on a file ask
+               is the same refusal wearing a different name. */
+            criteria: terms.criteria.filter((criterion) => !(criterion.kind === "measure" && (criterion.gate.id === "file-type" || criterion.gate.id === "max-bytes")))
+        };
+        terms = (0, terms_ts_1.addCriterion)(terms, { kind: "measure", gate: { id: "max-bytes", bytes: FILE_MAX_BYTES } });
+    }
+    if (form.place) {
+        const metres = form.place.metres ?? DEFAULT_METRES;
+        terms = (0, terms_ts_1.addCriterion)(terms, {
+            kind: "measure",
+            gate: {
+                id: "within-radius",
+                lat: form.place.lat,
+                lon: form.place.lon,
+                meters: metres,
+                ...(form.place.label ? { place: form.place.label } : {})
+            }
+        });
+    }
+    terms = withLooseBlocks(terms, form);
+    /* Rebuilt in the parser's own key order, so a publish → parse round trip
+       is byte-identical — the same property the engine bridge leans on. */
+    if (form.campaign || form.series || form.then) {
+        terms = {
+            v: terms.v,
+            task: terms.task,
+            deliverable: terms.deliverable,
+            ...(form.campaign ? { campaign: form.campaign } : {}),
+            ...(form.series ? { series: form.series } : {}),
+            ...(form.then
+                ? {
+                    chain: {
+                        task: form.then.task.trim(),
+                        deliverable: { type: form.then.deliverable, prompt: form.then.task.trim() },
+                        target: { mode: "fixed", base: String(Math.floor(form.then.targetBase)) },
+                        funding: form.then.funding,
+                        ...(form.then.atAnswersPlace ? { atAnswersPlace: true } : {})
+                    }
+                }
+                : {}),
+            criteria: terms.criteria,
+            judge: terms.judge
+        };
+    }
+    return { terms, title };
+}
+//# sourceMappingURL=compose.js.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * How sure we are, and why — instead of the word "verified".
+ *
+ * A boolean cannot be weighed. A model asking the world a question needs to
+ * know whether it is holding "three independent people agreed and physics
+ * backs them" or "one person's phone said it was nearby", and `verified: true`
+ * says neither. Worse, it says the same thing for both, which makes it the
+ * least honest true statement the product could make.
+ *
+ * So an answer comes back **evidenced**: a number, the reasons that produced
+ * it, and — the part that matters most — a list of what nobody checked. That
+ * last list is the one this round exists for. An answer about a square being
+ * empty carries a location that was measured and an emptiness that was not,
+ * and only saying both is honest.
+ *
+ * **This module is pure and has no network.** It takes outcomes that have
+ * already been gathered and returns a score, so the score is replayable by
+ * anyone holding the same published documents — the same property `decide()`
+ * has, and for the same reason: a confidence nobody can recompute is a number
+ * you are asked to take on faith, which is what it was meant to replace.
+ */
+/** One thing that was, or was not, established. */
+export interface Signal {
+    /** What was checked, in the reader's language. */
+    says: string;
+    /**
+     * `pass` — established. `flat` — could not be checked, and that is not the
+     * answerer's fault (`unverifiable`: an archive was down, a gate deferred).
+     * `absent` — never part of the terms at all, so it is named as uncovered.
+     */
+    weight: "pass" | "flat" | "absent";
+    /** How much a pass is worth. Grounding outweighs relevance; taste is 0. */
+    worth?: number;
+    /**
+     * What to say when this is `flat`, if "could not be checked" would be wrong.
+     *
+     * Two different things land on `flat` and only one of them is an outage: an
+     * archive being unreachable, and a first-time answerer simply having no
+     * record yet. Printing "first answer from this address here — could not be
+     * checked" made the second read like a failure of ours, which is both untrue
+     * and unwelcoming to exactly the person the product wants.
+     */
+    whenFlat?: string;
+}
+export interface Evidence {
+    /** 0–1, never presented bare. */
+    confidence: number;
+    /** Why it is that number, in the order a reader would want it. */
+    because: string[];
+    /** What this answer does NOT establish. Never empty in practice. */
+    unverified: string[];
+}
+/**
+ * The weights, written down rather than scattered.
+ *
+ * They encode a claim about evidence, so they belong in one readable place
+ * where the claim can be argued with: **being there outweighs being
+ * relevant, and a track record is worth less than either.** A judged
+ * criterion says an answer is about the right question; it says nothing about
+ * whether the answer is true.
+ */
+export declare const WORTH: {
+    /** A device reported a location inside the radius, or EXIF did. */
+    readonly grounding: 0.45;
+    /** Something independent of the answerer agrees — weather, daylight, OSM. */
+    readonly corroboration: 0.25;
+    /** An AI ruled the answer addresses the question. */
+    readonly relevance: 0.15;
+    /** The answerer has been right here before. */
+    readonly record: 0.1;
+};
+export declare function evidenceFrom(signals: Signal[], unverified: string[]): Evidence;
+/**
+ * The envelope's own words.
+ *
+ * Kept beside the arithmetic so the number and its presentation cannot drift:
+ * every surface that shows a confidence shows it this way, and a bare score
+ * never escapes on its own.
+ */
+export declare function evidenceLines(evidence: Evidence): string[];
+//# sourceMappingURL=confidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../../src/rubric/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK;IAChB,mEAAmE;;IAEnE,6EAA6E;;IAE7E,qDAAqD;;IAErD,+CAA+C;;CAEvC,CAAC;AAcX,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,CAoB9E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAM1D"}

package/dist/cjs/rubric/confidence.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * How sure we are, and why — instead of the word "verified".
+ *
+ * A boolean cannot be weighed. A model asking the world a question needs to
+ * know whether it is holding "three independent people agreed and physics
+ * backs them" or "one person's phone said it was nearby", and `verified: true`
+ * says neither. Worse, it says the same thing for both, which makes it the
+ * least honest true statement the product could make.
+ *
+ * So an answer comes back **evidenced**: a number, the reasons that produced
+ * it, and — the part that matters most — a list of what nobody checked. That
+ * last list is the one this round exists for. An answer about a square being
+ * empty carries a location that was measured and an emptiness that was not,
+ * and only saying both is honest.
+ *
+ * **This module is pure and has no network.** It takes outcomes that have
+ * already been gathered and returns a score, so the score is replayable by
+ * anyone holding the same published documents — the same property `decide()`
+ * has, and for the same reason: a confidence nobody can recompute is a number
+ * you are asked to take on faith, which is what it was meant to replace.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORTH = void 0;
+exports.evidenceFrom = evidenceFrom;
+exports.evidenceLines = evidenceLines;
+/**
+ * The weights, written down rather than scattered.
+ *
+ * They encode a claim about evidence, so they belong in one readable place
+ * where the claim can be argued with: **being there outweighs being
+ * relevant, and a track record is worth less than either.** A judged
+ * criterion says an answer is about the right question; it says nothing about
+ * whether the answer is true.
+ */
+exports.WORTH = {
+    /** A device reported a location inside the radius, or EXIF did. */
+    grounding: 0.45,
+    /** Something independent of the answerer agrees — weather, daylight, OSM. */
+    corroboration: 0.25,
+    /** An AI ruled the answer addresses the question. */
+    relevance: 0.15,
+    /** The answerer has been right here before. */
+    record: 0.1
+};
+/**
+ * The floor.
+ *
+ * An approved answer has passed every criterion its terms carried, so it is
+ * never worthless — but it is also never certain, and a scale that can reach
+ * 1.0 invites exactly the reading this replaces. Nothing here returns more
+ * than `CEILING`: there is no evidence available to us that makes a stranger's
+ * account of a moment certain.
+ */
+const FLOOR = 0.2;
+const CEILING = 0.95;
+function evidenceFrom(signals, unverified) {
+    const scored = signals.filter((signal) => signal.weight !== "absent");
+    /* Only what was actually attempted counts toward the denominator. A gate
+       that could not run must not quietly look like a gate that failed — that
+       is TD3's rule, expressed in arithmetic rather than in prose. */
+    const attempted = scored.reduce((total, signal) => total + (signal.worth ?? 0), 0);
+    const earned = scored.filter((signal) => signal.weight === "pass").reduce((total, signal) => total + (signal.worth ?? 0), 0);
+    const raw = attempted > 0 ? FLOOR + (CEILING - FLOOR) * (earned / attempted) : FLOOR;
+    return {
+        confidence: Math.round(Math.min(CEILING, Math.max(FLOOR, raw)) * 100) / 100,
+        because: scored.map((signal) => signal.weight === "pass" ? signal.says : (signal.whenFlat ?? `${signal.says}. Could not be checked`)),
+        /* Signals that were never in the terms are themselves things nobody
+           checked, so they join the list rather than vanishing from the record. */
+        unverified: [...unverified, ...signals.filter((signal) => signal.weight === "absent").map((signal) => signal.says)]
+    };
+}
+/**
+ * The envelope's own words.
+ *
+ * Kept beside the arithmetic so the number and its presentation cannot drift:
+ * every surface that shows a confidence shows it this way, and a bare score
+ * never escapes on its own.
+ */
+function evidenceLines(evidence) {
+    return [
+        `Confidence: ${evidence.confidence.toFixed(2)}`,
+        ...evidence.because.map((line, index) => `${index === 0 ? "Because:    " : "            "}· ${line}`),
+        ...evidence.unverified.map((line, index) => `${index === 0 ? "Unverified: " : "            "}· ${line}`)
+    ];
+}
+//# sourceMappingURL=confidence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../../src/rubric/confidence.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAmEH,oCAoBC;AASD,sCAMC;AAnED;;;;;;;;GAQG;AACU,QAAA,KAAK,GAAG;IACnB,mEAAmE;IACnE,SAAS,EAAE,IAAI;IACf,6EAA6E;IAC7E,aAAa,EAAE,IAAI;IACnB,qDAAqD;IACrD,SAAS,EAAE,IAAI;IACf,+CAA+C;IAC/C,MAAM,EAAE,GAAG;CACH,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,KAAK,GAAG,GAAG,CAAC;AAClB,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB,SAAgB,YAAY,CAAC,OAAiB,EAAE,UAAoB;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAEtE;;sEAEkE;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7H,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAErF,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QAC3E,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI,wBAAwB,CAAC,CACrG;QACD;mFAC2E;QAC3E,UAAU,EAAE,CAAC,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;KACpH,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,QAAkB;IAC9C,OAAO;QACL,eAAe,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAC/C,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QACrG,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;KACzG,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,224 @@
+import { type AskTerms, type Criterion } from "./terms.ts";
+/**
+ * The drafter's half that is not a model call.
+ *
+ * Turning a sentence into terms takes three things: words to send, a shape to
+ * insist the answer comes back in, and a reader strict enough that nothing a
+ * model invents reaches a contract somebody signs. Only the first two are
+ * about the provider. The third — which gates exist, what a criterion has to
+ * carry to be one, what an offer may say about money — is this network's own
+ * rulebook, and it lived inside a Next.js route handler where exactly one
+ * caller could reach it.
+ *
+ * It now lives here, next to `parseTerms`, because the drafter moved to a
+ * Cloudflare Worker and the Vercel route stayed: two callers, one set of
+ * rules. A prompt that drifts between them is a nuisance; a **clamp** that
+ * drifts between them is somebody's balance.
+ *
+ * Plain TypeScript, no SDK, no fetch — so the Worker bundles it, the route
+ * imports it, and the test runner reads it without a network.
+ */
+export declare const DRAFT_SYSTEM = "You turn a request for work into the whole ask, on Openhands Network, where money moves when work is verified: what gets handed over, where it happens, what it pays, and what the review checks. The person asking reads your draft and chooses whether to use it; nothing you write is posted without them.\n\nWhat they hand over:\n- camera: \"photo\" when the proof is how something looks now. \"pair\" when the work changes something and the proof is how it looked before and after (a cleanup, a repair, a tidy desk). \"none\" when no photograph is needed.\n- file: true when the work produces a file (a document, a recording, a spreadsheet, a video). Beside a photo it is a second file.\n- words: true when the answer is written, or when a photo or file must come with a written note. False when a photograph or a file alone is the answer.\n- where: \"place\" whenever the request names somewhere the work must happen: a town, a village, a street, a square, a building, a shop. Photographing something at a named place is \"place\", never \"pin\". \"pin\" only when finding where is itself the work (a mess, a pothole, wherever they come across it), so they mark exactly where they stood. Otherwise \"none\".\n- placeName: only when where is \"place\", the place exactly as the request names it. Never invent a place and never write coordinates: the person asking sets the exact spot.\n- mentions: at most three words or phrases the answer must contain, only when the request plainly needs them (a reference number, a product name). Usually none.\n\nYou assign every requirement one of three kinds, and the kind is a promise about who may honestly settle it:\n\n- \"measure\". A machine settles it deterministically. Only these gates exist: non-empty; min-length (chars); mentions-url (url); reports-status; mentions-terms (terms); re-measure (url); file-type (accept, e.g. \"image/*\"); max-bytes (bytes). Never invent a gate. There is no gate for when a photo was taken, where it was taken, or who is in it.\n- \"judge\". A model rules on a sentence you write. Use this for things that are checkable by reading or looking but not by measuring: whether a photo shows what was asked, whether a translation reads naturally, whether an answer actually answers.\n- \"attest\". Only the person who asked can say. Use this for taste, preference, brand fit, \"I like it\".\n\nRules:\n- Write each requirement as a short, plain, checkable sentence. A worker reads these before starting.\n- Say in the sentence itself what would make it FAIL: a requirement that only states what would be true reads as a demand to prove it, and refuses honest work.\n- Prefer few requirements. Three is usually plenty; never more than five.\n- Do not restate the task as a requirement. Say what would make it complete.\n- If something matters but no machine can verify it, make it \"judge\" or \"attest\". Never a \"measure\" gate that only pretends to check it.\n- deliverable.type is what gets handed over: url, text, photo, file, or answer.\n\nYou also propose the offer, in US dollars (1 PAY is 1 dollar), because most people asking have no idea what a piece of work is worth:\n- amountUsd: what one accepted answer pays, between 0.10 and 20. Weigh effort and inconvenience. A question answered from a web page is near the floor; going somewhere and photographing something is a few dollars; an hour of physical work is more. Keep it plausible rather than generous.\n- days: how long it stays open. A few days for anything needing someone to physically go somewhere; one or two for desk work.\n- quota: how many people get paid. Almost always 1. More only when the ask genuinely wants several independent answers, and never more than 25.\n- why: one short clause justifying the amount, in the poster's own terms. No hedging, no restating the task.";
+export declare const DRAFT_TOOL_NAME = "draft_terms";
+export declare const DRAFT_TOOL_DESCRIPTION = "Draft the whole ask: what is handed over, where, what it pays, and the requirements used to review it.";
+/**
+ * The shape the answer must arrive in — the same JSON Schema both providers
+ * are handed. Anthropic calls it `input_schema` and OpenRouter calls it
+ * `parameters`; it is one object either way, and there is exactly one copy of
+ * it so the two drafters cannot quietly diverge.
+ */
+export declare const DRAFT_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly deliverableType: {
+            readonly type: "string";
+            readonly enum: readonly ["url", "text", "photo", "file", "answer"];
+            readonly description: "What gets handed over.";
+        };
+        readonly deliverablePrompt: {
+            readonly type: "string";
+            readonly description: "One line telling the worker exactly what to hand over.";
+        };
+        readonly camera: {
+            readonly type: "string";
+            readonly enum: readonly ["photo", "pair", "none"];
+            readonly description: "A photo now, two before and after, or none.";
+        };
+        readonly file: {
+            readonly type: "boolean";
+            readonly description: "A file is handed over.";
+        };
+        readonly words: {
+            readonly type: "boolean";
+            readonly description: "A written answer, or a written note beside the photo or file.";
+        };
+        readonly where: {
+            readonly type: "string";
+            readonly enum: readonly ["none", "pin", "place"];
+            readonly description: "pin: they mark where; place: somewhere the ask names.";
+        };
+        readonly placeName: {
+            readonly type: "string";
+            readonly description: "Only with where = place: the place as the request names it. Never coordinates.";
+        };
+        readonly mentions: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "At most three words the answer must contain. Usually none.";
+        };
+        readonly amountUsd: {
+            readonly type: "number";
+            readonly description: "What one accepted answer pays, in US dollars, 0.10 to 20.";
+        };
+        readonly days: {
+            readonly type: "number";
+            readonly description: "How long the ask stays open.";
+        };
+        readonly quota: {
+            readonly type: "number";
+            readonly description: "How many people get paid. Usually 1.";
+        };
+        readonly why: {
+            readonly type: "string";
+            readonly description: "One short clause justifying the amount.";
+        };
+        readonly criteria: {
+            readonly type: "array";
+            readonly description: "What would make the work complete. Three is usually plenty.";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: readonly ["measure", "judge", "attest"];
+                    };
+                    readonly text: {
+                        readonly type: "string";
+                        readonly description: "For judge/attest: the sentence ruled on. For measure: a short label; the gate decides the meaning.";
+                    };
+                    readonly gate: {
+                        readonly type: "string";
+                        readonly enum: readonly ["non-empty", "min-length", "mentions-url", "reports-status", "mentions-terms", "re-measure", "file-type", "max-bytes"];
+                        readonly description: "For measure only.";
+                    };
+                    readonly chars: {
+                        readonly type: "number";
+                        readonly description: "min-length only.";
+                    };
+                    readonly url: {
+                        readonly type: "string";
+                        readonly description: "mentions-url and re-measure only.";
+                    };
+                    readonly accept: {
+                        readonly type: "string";
+                        readonly description: "file-type only, e.g. image/*";
+                    };
+                    readonly bytes: {
+                        readonly type: "number";
+                        readonly description: "max-bytes only.";
+                    };
+                    readonly terms: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "mentions-terms only.";
+                    };
+                };
+                readonly required: readonly ["kind", "text"];
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly required: readonly ["deliverableType", "deliverablePrompt", "camera", "file", "words", "where", "criteria", "amountUsd", "days", "quota", "why"];
+    readonly additionalProperties: false;
+};
+/** The one sentence the model is asked about. */
+export declare const draftUserMessage: (title: string) => string;
+export interface DraftedCriterion {
+    kind: "measure" | "judge" | "attest";
+    text: string;
+    gate?: string;
+    chars?: number;
+    url?: string;
+    accept?: string;
+    bytes?: number;
+    terms?: string[];
+}
+/** What the tool call claims, before any of it is believed. */
+export interface DraftInput {
+    deliverableType?: string;
+    deliverablePrompt?: string;
+    camera?: string;
+    file?: boolean;
+    words?: boolean;
+    where?: string;
+    placeName?: string;
+    mentions?: unknown[];
+    criteria?: DraftedCriterion[];
+    amountUsd?: number;
+    /** The first drafter's name for the same number, still read from a Worker that has not been redeployed. */
+    amountIxo?: number;
+    days?: number;
+    quota?: number;
+    why?: string;
+}
+/**
+ * The whole ask as the drafter proposes it, in the composer's own terms: the
+ * blocks it would add, the place it would ask for, and the offer.
+ *
+ * A proposal, never a decision. The composer shows it whole and the poster
+ * taps Use or does not, and everything stays editable after. The first
+ * drafter's offer was clamped and then deliberately ignored, because a model
+ * quietly filling in the money fields of a contract is not a feature. A model
+ * saying "I would pay $2 for this, here is why" next to a button the poster
+ * presses is.
+ */
+export interface DraftProposal {
+    camera: "photo" | "pair" | null;
+    file: boolean;
+    /** Alone, the answer is written; beside an attachment, a note must come with it. */
+    words: boolean;
+    where: "none" | "pin" | "place";
+    /** Only with `where: "place"`: the place as the request names it. The poster sets the spot. */
+    placeName: string;
+    mentions: string[];
+    /** What one accepted answer pays, in dollars, to the cent. */
+    amountUsd: number;
+    days: number;
+    quota: number;
+    why: string;
+}
+export interface DraftAnswer {
+    terms: AskTerms;
+    drafted: boolean;
+    proposal?: DraftProposal;
+}
+/** Build a real criterion from a drafted one, dropping anything malformed. */
+export declare function toCriterion(drafted: DraftedCriterion, index: number): Criterion | null;
+/**
+ * The proposal is clamped rather than trusted.
+ *
+ * A model naming $500 for a photograph would be proposing to empty somebody's
+ * balance on a typo, and the poster is the one who signs for it; the ceiling
+ * holds whatever the model says, and the poster still reads the figure beside
+ * a button before it goes anywhere. Blocks are held to the composer's own
+ * rules the same way: one camera thing, a place only as a name the poster
+ * then sets, never coordinates, and a draft that attaches nothing answers in
+ * words, so the form does not infer a photograph the drafter decided against.
+ */
+export declare function clampProposal(input: DraftInput | undefined): DraftProposal;
+/** The answer when nobody drafted: the sentence's own machine-checkable floor. */
+export declare const floorAnswer: (floor: AskTerms) => DraftAnswer;
+/**
+ * A tool call, read into terms — or the floor, when it said nothing usable.
+ *
+ * Validated against the same reader the checker uses, so a draft that would
+ * not parse never reaches the composer. A model that returns no usable
+ * criterion is not an error: the sentence alone still yields the floor, which
+ * is exactly what the composer would have derived anyway.
+ */
+export declare function draftAnswer(input: DraftInput | undefined, title: string, floor: AskTerms): DraftAnswer;
+//# sourceMappingURL=draft.d.ts.map