@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/esm/rubric/confidence.js

@@ -0,0 +1,82 @@
+/**
+ * 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.
+ */
+/**
+ * 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 const 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;
+export 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.
+ */
+export 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/esm/rubric/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../../src/rubric/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAmCH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,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,MAAM,UAAU,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,MAAM,UAAU,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/esm/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../../src/rubric/draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,YAAY,qvHA4BoF,CAAC;AAE9G,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,sBAAsB,2GAA2G,CAAC;AAE/I;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CpB,CAAC;AAEX,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAA6B,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,oFAAoF;IACpF,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAChC,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA2BtF;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,CAuB1E;AAMD,kFAAkF;AAClF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,KAAG,WAAiD,CAAC;AAEhG;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,WAAW,CAuBtG"}

package/dist/esm/rubric/draft.js

@@ -0,0 +1,206 @@
+import { parseTerms } from "./terms.js";
+/**
+ * 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 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.
+
+What they hand over:
+- 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.
+- file: true when the work produces a file (a document, a recording, a spreadsheet, a video). Beside a photo it is a second file.
+- 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.
+- 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".
+- 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.
+- 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.
+
+You assign every requirement one of three kinds, and the kind is a promise about who may honestly settle it:
+
+- "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.
+- "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.
+- "attest". Only the person who asked can say. Use this for taste, preference, brand fit, "I like it".
+
+Rules:
+- Write each requirement as a short, plain, checkable sentence. A worker reads these before starting.
+- 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.
+- Prefer few requirements. Three is usually plenty; never more than five.
+- Do not restate the task as a requirement. Say what would make it complete.
+- If something matters but no machine can verify it, make it "judge" or "attest". Never a "measure" gate that only pretends to check it.
+- deliverable.type is what gets handed over: url, text, photo, file, or answer.
+
+You 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:
+- 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.
+- days: how long it stays open. A few days for anything needing someone to physically go somewhere; one or two for desk work.
+- quota: how many people get paid. Almost always 1. More only when the ask genuinely wants several independent answers, and never more than 25.
+- why: one short clause justifying the amount, in the poster's own terms. No hedging, no restating the task.`;
+export const DRAFT_TOOL_NAME = "draft_terms";
+export 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 const DRAFT_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        deliverableType: { type: "string", enum: ["url", "text", "photo", "file", "answer"], description: "What gets handed over." },
+        deliverablePrompt: { type: "string", description: "One line telling the worker exactly what to hand over." },
+        camera: { type: "string", enum: ["photo", "pair", "none"], description: "A photo now, two before and after, or none." },
+        file: { type: "boolean", description: "A file is handed over." },
+        words: { type: "boolean", description: "A written answer, or a written note beside the photo or file." },
+        where: { type: "string", enum: ["none", "pin", "place"], description: "pin: they mark where; place: somewhere the ask names." },
+        placeName: { type: "string", description: "Only with where = place: the place as the request names it. Never coordinates." },
+        mentions: { type: "array", items: { type: "string" }, description: "At most three words the answer must contain. Usually none." },
+        amountUsd: { type: "number", description: "What one accepted answer pays, in US dollars, 0.10 to 20." },
+        days: { type: "number", description: "How long the ask stays open." },
+        quota: { type: "number", description: "How many people get paid. Usually 1." },
+        why: { type: "string", description: "One short clause justifying the amount." },
+        criteria: {
+            type: "array",
+            description: "What would make the work complete. Three is usually plenty.",
+            items: {
+                type: "object",
+                properties: {
+                    kind: { type: "string", enum: ["measure", "judge", "attest"] },
+                    text: { type: "string", description: "For judge/attest: the sentence ruled on. For measure: a short label; the gate decides the meaning." },
+                    gate: {
+                        type: "string",
+                        enum: ["non-empty", "min-length", "mentions-url", "reports-status", "mentions-terms", "re-measure", "file-type", "max-bytes"],
+                        description: "For measure only."
+                    },
+                    chars: { type: "number", description: "min-length only." },
+                    url: { type: "string", description: "mentions-url and re-measure only." },
+                    /* Lower-case on purpose: the gate compares MIME types as written
+                       (`mime.startsWith("image/")`), so a model that copies a
+                       capitalised example writes a gate no photograph can pass. */
+                    accept: { type: "string", description: "file-type only, e.g. image/*" },
+                    bytes: { type: "number", description: "max-bytes only." },
+                    terms: { type: "array", items: { type: "string" }, description: "mentions-terms only." }
+                },
+                required: ["kind", "text"],
+                additionalProperties: false
+            }
+        }
+    },
+    required: ["deliverableType", "deliverablePrompt", "camera", "file", "words", "where", "criteria", "amountUsd", "days", "quota", "why"],
+    additionalProperties: false
+};
+/** The one sentence the model is asked about. */
+export const draftUserMessage = (title) => `The ask: ${title}`;
+/** Build a real criterion from a drafted one, dropping anything malformed. */
+export function toCriterion(drafted, index) {
+    const id = `d${index + 1}`;
+    if (drafted.kind === "judge" || drafted.kind === "attest") {
+        const text = drafted.text?.trim();
+        return text ? { id, kind: drafted.kind, text } : null;
+    }
+    switch (drafted.gate) {
+        case "non-empty":
+            return { id, kind: "measure", gate: { id: "non-empty" } };
+        case "min-length":
+            return drafted.chars ? { id, kind: "measure", gate: { id: "min-length", chars: Math.round(drafted.chars) } } : null;
+        case "mentions-url":
+            return drafted.url ? { id, kind: "measure", gate: { id: "mentions-url", url: drafted.url } } : null;
+        case "reports-status":
+            return { id, kind: "measure", gate: { id: "reports-status" } };
+        case "mentions-terms":
+            return drafted.terms?.length ? { id, kind: "measure", gate: { id: "mentions-terms", terms: drafted.terms.slice(0, 5) } } : null;
+        case "re-measure":
+            return drafted.url ? { id, kind: "measure", gate: { id: "re-measure", url: drafted.url } } : null;
+        case "file-type":
+            return drafted.accept ? { id, kind: "measure", gate: { id: "file-type", accept: drafted.accept } } : null;
+        case "max-bytes":
+            return drafted.bytes ? { id, kind: "measure", gate: { id: "max-bytes", bytes: Math.round(drafted.bytes) } } : null;
+        default:
+            return null;
+    }
+}
+const clamp = (value, low, high, fallback) => typeof value === "number" && Number.isFinite(value) ? Math.min(high, Math.max(low, value)) : fallback;
+/** "46.05, 14.51" and its kin. A place name that is really coordinates is not a name. */
+const COORDINATES = /-?\d{1,3}\.\d+\s*[,\s]\s*-?\d{1,3}\.\d+/;
+/**
+ * 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 function clampProposal(input) {
+    const camera = input?.camera === "photo" || input?.camera === "pair" ? input.camera : null;
+    const file = input?.file === true;
+    const where = input?.where === "pin" || input?.where === "place" ? input.where : "none";
+    const named = typeof input?.placeName === "string" ? input.placeName.replace(/\s+/g, " ").trim().slice(0, 80) : "";
+    const mentions = [
+        ...new Set((input?.mentions ?? []).filter((one) => typeof one === "string").map((one) => one.replace(/\s+/g, " ").trim().slice(0, 40)).filter(Boolean))
+    ].slice(0, 3);
+    /* The first drafter called the same number `amountIxo`; a Worker not yet
+       redeployed still sends it, and it was only ever a figure on this scale. */
+    const amount = typeof input?.amountUsd === "number" ? input.amountUsd : input?.amountIxo;
+    return {
+        camera,
+        file,
+        words: input?.words === true || (!camera && !file),
+        where,
+        placeName: where === "place" && named && !COORDINATES.test(named) ? named : "",
+        mentions,
+        amountUsd: Math.round(clamp(amount, 0.1, 20, 0.5) * 100) / 100,
+        days: Math.round(clamp(input?.days, 1, 30, 7)),
+        quota: Math.round(clamp(input?.quota, 1, 25, 1)),
+        why: typeof input?.why === "string" ? input.why.trim().slice(0, 160) : ""
+    };
+}
+/** Whether the call said anything about the ask beyond its lines — only then is there a proposal to show. */
+const proposes = (input) => ["camera", "file", "words", "where", "amountUsd", "amountIxo", "days", "quota"].some((key) => input[key] !== undefined);
+/** The answer when nobody drafted: the sentence's own machine-checkable floor. */
+export const floorAnswer = (floor) => ({ terms: floor, drafted: false });
+/**
+ * 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 function draftAnswer(input, title, floor) {
+    /* The blocks and the offer stand whether or not the model wrote a line:
+       a plain ask can need no written check and still need a camera. */
+    const proposal = input && proposes(input) ? { proposal: clampProposal(input) } : {};
+    const criteria = (input?.criteria ?? [])
+        .map(toCriterion)
+        .filter((criterion) => Boolean(criterion))
+        .slice(0, 5);
+    if (criteria.length === 0)
+        return { ...floorAnswer(floor), ...proposal };
+    const drafted = {
+        v: 2,
+        task: title,
+        deliverable: {
+            type: input?.deliverableType ?? floor.deliverable.type,
+            prompt: input?.deliverablePrompt?.trim() || floor.deliverable.prompt
+        },
+        criteria,
+        judge: { kind: "poster" }
+    };
+    const parsed = parseTerms(drafted);
+    return { terms: parsed ?? floor, drafted: Boolean(parsed), ...proposal };
+}
+//# sourceMappingURL=draft.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../../../src/rubric/draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiC,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;6GA4BiF,CAAC;AAE9G,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,wGAAwG,CAAC;AAE/I;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAC5H,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;QAC5G,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE;QACvH,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAChE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+DAA+D,EAAE;QACxG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,uDAAuD,EAAE;QAC/H,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gFAAgF,EAAE;QAC5H,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,4DAA4D,EAAE;QACjI,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;QACvG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;QACrE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;QAC9E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;QAC/E,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,6DAA6D;YAC1E,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE;oBAC9D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oGAAoG,EAAE;oBAC3I,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC;wBAC7H,WAAW,EAAE,mBAAmB;qBACjC;oBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;oBAC1D,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;oBACzE;;mFAE+D;oBAC/D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;oBACzD,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE;iBACzF;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;gBAC1B,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,QAAQ,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IACvI,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,YAAY,KAAK,EAAE,CAAC;AAiE/E,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAyB,EAAE,KAAa;IAClE,MAAM,EAAE,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC;QAC5D,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtH,KAAK,cAAc;YACjB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtG,KAAK,gBAAgB;YACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC;QACjE,KAAK,gBAAgB;YACnB,OAAO,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAClI,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACpG,KAAK,WAAW;YACd,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5G,KAAK,WAAW;YACd,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrH;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,KAAyB,EAAE,GAAW,EAAE,IAAY,EAAE,QAAgB,EAAU,EAAE,CAC/F,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAExG,yFAAyF;AACzF,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,KAAK,OAAO,IAAI,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,KAAK,KAAK,IAAI,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACxF,MAAM,KAAK,GAAG,OAAO,KAAK,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnH,MAAM,QAAQ,GAAG;QACf,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;KACvK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACd;iFAC6E;IAC7E,MAAM,MAAM,GAAG,OAAO,KAAK,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC;IACzF,OAAO;QACL,MAAM;QACN,IAAI;QACJ,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC;QAClD,KAAK;QACL,SAAS,EAAE,KAAK,KAAK,OAAO,IAAI,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC9E,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QAC9D,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAChD,GAAG,EAAE,OAAO,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;KAC1E,CAAC;AACJ,CAAC;AAED,6GAA6G;AAC7G,MAAM,QAAQ,GAAG,CAAC,KAAiB,EAAW,EAAE,CAC9C,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAuB,CAAC,KAAK,SAAS,CAAC,CAAC;AAE9I,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAe,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AAEhG;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAA6B,EAAE,KAAa,EAAE,KAAe;IACvF;wEACoE;IACpE,MAAM,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC;SACrC,GAAG,CAAC,WAAW,CAAC;SAChB,MAAM,CAAC,CAAC,SAAS,EAA0B,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;SACjE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEzE,MAAM,OAAO,GAAa;QACxB,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;YACX,IAAI,EAAG,KAAK,EAAE,eAAmD,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI;YAC3F,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM;SACrE;QACD,QAAQ;QACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B,CAAC;IAEF,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;AAC3E,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * What each gate says when it is met.
+ *
+ * The bridge writes every gate's `reason` in the voice of its failure —
+ * "Nothing was handed over", "No location was reported" — because a reason is
+ * what a rejection quotes. A receipt shows the gates that passed too, and it
+ * was printing those failure sentences beside a pass: "✓ Nothing was handed
+ * over", on the certificate of work that had handed something over. This is
+ * the other half, one sentence per gate, in the voice of the requirement
+ * being met, kept in the package that names the gates so a new one cannot
+ * ship with only half its words (`gateMet.test.ts` reads the bridge to make
+ * sure of that).
+ *
+ * Keyed by the label in a gate's code (`OH-101-LOCATED` is `located`), which
+ * the bridge has never renamed, so it reads the receipts of every ask ever
+ * posted and nothing already published has to be rewritten. Said without the
+ * numbers a reason carries ("20 characters", "within 60 m"), because the
+ * code is all a receipt keeps, and a number guessed is worse than none.
+ */
+export declare const GATE_MET: Readonly<Record<string, string>>;
+/** Gates whose reason is the rule itself, which reads the same met or not. */
+export declare const RULE_IS_REASON: ReadonlySet<string>;
+/** The label in a gate code this estate wrote: `OH-101-LOCATED` is `located`. */
+export declare const gateLabel: (code: string) => string | null;
+/**
+ * The sentence a met gate shows: its own met words, or the rule itself for a
+ * judged line. Null for a code this estate did not write, whose reason there
+ * is no way to turn around; the caller says so rather than printing a
+ * failure under a pass.
+ */
+export declare function metSentence(code: string, reason: string): string | null;
+/**
+ * Each gate in two or three words, for a place that lists the rules at a
+ * glance — the decision trace's chips. Said in the voice of the rule being
+ * met, like `GATE_MET`, and kept beside it so a new gate cannot ship with
+ * its sentence and no label (`gateMet.test.ts` holds the two to each other).
+ *
+ * A judged gate has no label of its own: its rule is a sentence somebody
+ * wrote for that ask, and two words would put words in their mouth. The
+ * trace counts those instead ("2 judged by AI") and the sentences stay in
+ * the full list.
+ */
+export declare const GATE_SHORT: Readonly<Record<string, string>>;
+/** A gate's label for the trace, or null for a judged gate or a code this estate did not write. */
+export declare function ruleShort(code: string): string | null;
+//# sourceMappingURL=gateMet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateMet.d.ts","sourceRoot":"","sources":["../../../src/rubric/gateMet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBrD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAqC,CAAC;AAErF,iFAAiF;AACjF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAAsE,CAAC;AAEzH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBvD,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD"}