@ixo/openhands-sdk 0.0.0-stage → 0.2.0

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

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

package/dist/cjs/rubric/draft.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.floorAnswer = exports.draftUserMessage = exports.DRAFT_TOOL_SCHEMA = exports.DRAFT_TOOL_DESCRIPTION = exports.DRAFT_TOOL_NAME = exports.DRAFT_SYSTEM = void 0;
+exports.toCriterion = toCriterion;
+exports.clampProposal = clampProposal;
+exports.draftAnswer = draftAnswer;
+const terms_ts_1 = require("./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.
+ */
+exports.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.`;
+exports.DRAFT_TOOL_NAME = "draft_terms";
+exports.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.
+ */
+exports.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. */
+const draftUserMessage = (title) => `The ask: ${title}`;
+exports.draftUserMessage = draftUserMessage;
+/** Build a real criterion from a drafted one, dropping anything malformed. */
+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.
+ */
+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. */
+const floorAnswer = (floor) => ({ terms: floor, drafted: false });
+exports.floorAnswer = floorAnswer;
+/**
+ * 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.
+ */
+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 { ...(0, exports.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 = (0, terms_ts_1.parseTerms)(drafted);
+    return { terms: parsed ?? floor, drafted: Boolean(parsed), ...proposal };
+}
+//# sourceMappingURL=draft.js.map

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

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

package/dist/cjs/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/cjs/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"}

package/dist/cjs/rubric/gateMet.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GATE_SHORT = exports.gateLabel = exports.RULE_IS_REASON = exports.GATE_MET = void 0;
+exports.metSentence = metSentence;
+exports.ruleShort = ruleShort;
+/**
+ * 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.
+ */
+exports.GATE_MET = {
+    present: "Something was handed over",
+    length: "Long enough for what the ask asked",
+    "names-site": "Names the site the ask named",
+    "reports-status": "States a status or a failure",
+    terms: "Contains the words the ask asked for",
+    "file-type": "The file is the kind the ask asked for",
+    "file-size": "The file is within the size the ask allows",
+    "extra-file": "A second file came with it",
+    "within-radius": "Within the distance the ask set",
+    located: "A location was reported",
+    "before-after": "The two photographs are of the same place, in order",
+    daylight: "The light fits the place and the time",
+    weather: "The weather fits the record for the place and the time",
+    "not-already-mapped": "Nothing already approved on this ask is this close",
+    "re-measure": "A fresh reading agrees with the answer",
+    "at-point": "Within reach of a registered point",
+    "mapped-grid": "Enough was mapped in the target area",
+    kind: "Says whether it is a patch or the whole site",
+    cooldown: "Nowhere this close was paid for recently",
+    site: "The site marker was recorded",
+    "not-generated": "Nothing in the photograph says an AI generator made it",
+    "not-elsewhere": "Taken at the place reported"
+};
+/** Gates whose reason is the rule itself, which reads the same met or not. */
+exports.RULE_IS_REASON = new Set(["judged", "real-photo"]);
+/** The label in a gate code this estate wrote: `OH-101-LOCATED` is `located`. */
+const gateLabel = (code) => /^OH-\d+-([A-Z0-9-]+)$/.exec(code)?.[1]?.toLowerCase() ?? null;
+exports.gateLabel = gateLabel;
+/**
+ * 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.
+ */
+function metSentence(code, reason) {
+    const label = (0, exports.gateLabel)(code);
+    if (!label)
+        return null;
+    if (exports.RULE_IS_REASON.has(label))
+        return reason;
+    return exports.GATE_MET[label] ?? 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.
+ */
+exports.GATE_SHORT = {
+    present: "Handed over",
+    length: "Long enough",
+    "names-site": "Names the site",
+    "reports-status": "States a status",
+    terms: "Has the words asked for",
+    "file-type": "Right kind of file",
+    "file-size": "Within the size limit",
+    "extra-file": "Second file included",
+    "within-radius": "In the area",
+    located: "Location given",
+    "before-after": "Before, then after",
+    daylight: "Daylight fits",
+    weather: "Weather fits",
+    "not-already-mapped": "Not already mapped",
+    "re-measure": "Re-measured",
+    "at-point": "At the point",
+    "mapped-grid": "Area mapped",
+    kind: "Patch or whole site",
+    cooldown: "Not paid here recently",
+    site: "Site marked",
+    "not-generated": "Not AI-generated",
+    "not-elsewhere": "Taken there"
+};
+/** A gate's label for the trace, or null for a judged gate or a code this estate did not write. */
+function ruleShort(code) {
+    const label = (0, exports.gateLabel)(code);
+    if (!label || exports.RULE_IS_REASON.has(label))
+        return null;
+    return exports.GATE_SHORT[label] ?? null;
+}
+//# sourceMappingURL=gateMet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateMet.js","sourceRoot":"","sources":["../../../src/rubric/gateMet.ts"],"names":[],"mappings":";;;AAwDA,kCAKC;AAuCD,8BAIC;AAxGD;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,QAAQ,GAAqC;IACxD,OAAO,EAAE,2BAA2B;IACpC,MAAM,EAAE,oCAAoC;IAC5C,YAAY,EAAE,8BAA8B;IAC5C,gBAAgB,EAAE,8BAA8B;IAChD,KAAK,EAAE,sCAAsC;IAC7C,WAAW,EAAE,wCAAwC;IACrD,WAAW,EAAE,4CAA4C;IACzD,YAAY,EAAE,4BAA4B;IAC1C,eAAe,EAAE,iCAAiC;IAClD,OAAO,EAAE,yBAAyB;IAClC,cAAc,EAAE,qDAAqD;IACrE,QAAQ,EAAE,uCAAuC;IACjD,OAAO,EAAE,wDAAwD;IACjE,oBAAoB,EAAE,oDAAoD;IAC1E,YAAY,EAAE,wCAAwC;IACtD,UAAU,EAAE,oCAAoC;IAChD,aAAa,EAAE,sCAAsC;IACrD,IAAI,EAAE,8CAA8C;IACpD,QAAQ,EAAE,0CAA0C;IACpD,IAAI,EAAE,8BAA8B;IACpC,eAAe,EAAE,wDAAwD;IACzE,eAAe,EAAE,6BAA6B;CAC/C,CAAC;AAEF,8EAA8E;AACjE,QAAA,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAErF,iFAAiF;AAC1E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAiB,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC;AAA5G,QAAA,SAAS,aAAmG;AAEzH;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,MAAM,KAAK,GAAG,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,sBAAc,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7C,OAAO,gBAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACU,QAAA,UAAU,GAAqC;IAC1D,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,aAAa;IACrB,YAAY,EAAE,gBAAgB;IAC9B,gBAAgB,EAAE,iBAAiB;IACnC,KAAK,EAAE,yBAAyB;IAChC,WAAW,EAAE,oBAAoB;IACjC,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,sBAAsB;IACpC,eAAe,EAAE,aAAa;IAC9B,OAAO,EAAE,gBAAgB;IACzB,cAAc,EAAE,oBAAoB;IACpC,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE,cAAc;IACvB,oBAAoB,EAAE,oBAAoB;IAC1C,YAAY,EAAE,aAAa;IAC3B,UAAU,EAAE,cAAc;IAC1B,aAAa,EAAE,aAAa;IAC5B,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,wBAAwB;IAClC,IAAI,EAAE,aAAa;IACnB,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,aAAa;CAC/B,CAAC;AAEF,mGAAmG;AACnG,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,sBAAc,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,kBAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,106 @@
+import type { AskTerms } from "./terms.ts";
+/**
+ * What the evaluation leg must be worth for the engine to judge for free.
+ *
+ * The engine bills the collection's **owner** for every claim it decides. Their
+ * own billing rule is the way out: *if a reward pot already covers our price,
+ * the owner is never billed at all.* So an ask whose evaluation leg is worth at
+ * least their price costs nobody anything — no subscription, no delegation, no
+ * invoice.
+ *
+ * That only works in a currency their FX values at face. Their precedence
+ * values USD-stables at face and **everything else at real market rate on
+ * every network, testnet included** — so a 0.1 IXO leg is about $0.00018 of
+ * credit against a $0.30 price, and essentially the whole price of every claim
+ * would be invoiced. `upay` is in their registry at `pegUsd: 1`, so PAY is the
+ * only denom this arithmetic works in. `evaluationLegBase` refuses anything
+ * else rather than quietly under-funding a leg.
+ *
+ * The price is per-ask, not a constant: it depends on how many AI-judged rules
+ * the rubric actually carries and whether a photo is screened.
+ *
+ * **The numbers are their published card**, read from `GET /v1/pricing`
+ * (public, no auth) on 2026-08-25:
+ *
+ *   Partner Standard (default) — base $0.30 · AI rule $0.01 · photo $0.10
+ *                              · **agent claim $0.05**
+ *
+ * The agent-claim component is the one the earlier audit missed. It is zero
+ * only on IXO's own relayer; on a partner's — which is us — every claim an
+ * agent submits carries it, and an ask with a quota carries it per spot.
+ */
+export interface EnginePrice {
+    baseUsd: number;
+    aiRuleUsd: number;
+    photoUsd: number;
+    agentClaimUsd: number;
+    /**
+     * AI-judged rules the base already covers.
+     *
+     * Their card charges every AI rule; ours includes the first, because every
+     * checked ask here carries a relevance judge and a base price that does not
+     * cover the standard check is a base price in name only.
+     */
+    includedAiRules?: number;
+}
+/** Their Partner Standard card, as published. Overridable by env at the caller. */
+export declare const PARTNER_STANDARD: EnginePrice;
+export interface LegQuote {
+    /** Base units of `upay`. */
+    base: string;
+    /** The same number as dollars, for anything a person reads. */
+    usd: number;
+    /** How it was reached, so a poster can see what they are paying for. */
+    because: string[];
+}
+/**
+ * What one ask's evaluation leg should hold.
+ *
+ * `spots` is the ask's quota: the engine decides every claim, so a quota of
+ * three is three agent-claim charges even if only one is approved.
+ */
+export declare function evaluationLegQuote(terms: AskTerms | null | undefined, spots?: number, price?: EnginePrice): LegQuote;
+/**
+ * The same quote, or a refusal naming the reason.
+ *
+ * A `uixo` board cannot fund an engine-live ask at all: at market rate the leg
+ * would have to be hundreds of IXO to reach $0.30 of their credit, and the
+ * poster would be paying a checker fee nobody asked for. Refusing is the
+ * honest answer, and it is the whole finding of the engine audit's §13.
+ */
+export declare function evaluationLegFor(denom: string, terms: AskTerms | null | undefined, spots?: number, price?: EnginePrice): LegQuote;
+/**
+ * Our own checker's card — the evaluation leg as a priced service.
+ *
+ * The poster chooses their judge at posting time (themselves, this checker, or
+ * the ixo engine — the chain allows exactly one per claim), and the chosen
+ * judge's card prices the leg. This is ours, and its design argument is the
+ * opposite of a menu of tolls:
+ *
+ * **Everything deterministic rides in the base.** Location, weather, daylight,
+ * re-measuring a URL — these cost us arithmetic and one keyless HTTP call, and
+ * they are the product's differentiator. Priced as add-ons, posters would skip
+ * them and every answer would get worse by default. So the base *includes*
+ * them, plus the standard relevance judge, and the line items are only the
+ * things that genuinely cost per unit: extra AI-judged rules and photo
+ * screening.
+ *
+ * For comparison, read from their public card the same day this was written:
+ * theirs is $0.30 base + $0.01/AI rule + $0.10/photo + $0.05/agent claim, and
+ * their binder defers geo to a human. Same slot, richer checks, a third of the
+ * price — that is the sentence this card exists to make true.
+ */
+export declare const checkerBaseUpay: () => number;
+export declare const checkerAiUpay: () => number;
+export declare const checkerPhotoUpay: () => number;
+export declare const OPENHANDS_CARD: EnginePrice;
+/**
+ * What OUR checker's leg should hold for this ask, in base units of `denom`.
+ *
+ * On a PAY board the card prices it, because the card is in dollars and PAY is
+ * the only denom that honestly wears a dollar face. On anything else the flat
+ * fallback stands — pricing IXO from a USD card would need an exchange rate,
+ * and inventing one is how the engine audit's §13 mistake gets made in reverse.
+ */
+export declare function checkerLegBase(denom: string, terms: AskTerms | null | undefined, flatFallbackBase: number): number;
+//# sourceMappingURL=leg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"leg.d.ts","sourceRoot":"","sources":["../../../src/rubric/leg.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,EAAE,WAAmF,CAAC;AAKnH,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,SAAI,EAAE,KAAK,GAAE,WAA8B,GAAG,QAAQ,CAgCjI;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,SAAI,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,CAO5H;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,eAAO,MAAM,eAAe,QAAO,MAAuH,CAAC;AAC3J,eAAO,MAAM,aAAa,QAAO,MAAkH,CAAC;AACpJ,eAAO,MAAM,gBAAgB,QAAO,MAAwH,CAAC;AAE7J,eAAO,MAAM,cAAc,EAAE,WAa5B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CA0BlH"}