@ixo/openhands-sdk 0.2.0 → 0.4.0

package/dist/cjs/rubric/leg.js

@@ -6,6 +6,7 @@ exports.evaluationLegFor = evaluationLegFor;
 exports.checkerLegBase = checkerLegBase;
 const given_ts_1 = require("../given.js");
 const envRead_ts_1 = require("../envRead.js");
+const money_ts_1 = require("../chain/money.js");
 /** Their Partner Standard card, as published. Overridable by env at the caller. */
 exports.PARTNER_STANDARD = { baseUsd: 0.3, aiRuleUsd: 0.01, photoUsd: 0.1, agentClaimUsd: 0.05 };
 /** 1 PAY = 1 USD, six decimals — the whole reason this arithmetic closes. */
@@ -55,8 +56,9 @@ function evaluationLegQuote(terms, spots = 1, price = exports.PARTNER_STANDARD)
  * honest answer, and it is the whole finding of the engine audit's §13.
  */
 function evaluationLegFor(denom, terms, spots = 1, price) {
-    if (denom !== "upay") {
-        throw new Error(`an engine-live ask must pay its evaluation leg in PAY, not ${denom}. Their FX values everything except USD-stables at market rate, so a ${denom} leg cannot cover their price`);
+    /* Their FX values USD-stables at face: PAY, and Noble USDC on mainnet. */
+    if (denom !== "upay" && denom !== money_ts_1.USDC_MAINNET) {
+        throw new Error(`an engine-live ask must pay its evaluation leg in PAY or USDC, not ${denom}. Their FX values everything except USD-stables at market rate, so a ${denom} leg cannot cover their price`);
     }
     return evaluationLegQuote(terms, spots, price);
 }
@@ -111,13 +113,13 @@ exports.OPENHANDS_CARD = {
 /**
  * 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
+ * `denom` is the checker-fee denom (`checkerFeeDenom`): PAY on devnet/testnet,
+ * USDC on mainnet. Both wear a dollar face, so the card prices it. 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.
  */
 function checkerLegBase(denom, terms, flatFallbackBase) {
-    if (denom !== "upay")
+    if (denom !== "upay" && denom !== money_ts_1.USDC_MAINNET)
         return flatFallbackBase;
     /*
      * **Never below what the checker says it will take.**

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

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

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

@@ -0,0 +1,182 @@
+/**
+ * Ask the World: a prediction market turned into a plan of checks people can
+ * do in public places (docs/verified-work-ask-the-world-plan.md).
+ *
+ * A **plan** is a frozen document: the market it informs, the checks, where
+ * each happens and how many answers each place buys, what each check beats,
+ * and one line on what the plan cannot tell you. It is written once, stored
+ * at a content address, and named by every ask it spawns (`terms.plan`), so
+ * the report can be rebuilt from the chain alone. The asks are filed under
+ * one tag, `plan-<slug>`, the way a call's legs are filed under `call-<slug>`.
+ *
+ * The agent that calls the MCP is the one that reads the market and drafts
+ * the checks; this module never guesses them. What it does is refuse what
+ * must never be bought (the **market screen**), check that a draft is whole
+ * (`validatePlan`), and price it (`planCost`). All pure, so the MCP, the
+ * worker and the app agree on one answer.
+ */
+/** The tag every ask of a plan is filed under. No colon: a tag is `[a-z0-9-]`. */
+export declare const planTag: (slug: string) => string;
+/**
+ * The memo a plan's funding carries: the slug for anyone reading the chain,
+ * and the document's address so the money can be spent on that document
+ * only. A slug is a free string inside whichever document a registrant
+ * names, so a memo that carried the slug alone would let a second document
+ * with the same slug claim the funding; the address is the hash of the bytes
+ * and names exactly one plan.
+ */
+export declare const planFundingMemo: (slug: string, cid: string) => string;
+/** The slug back out of a tag, or null when the tag is not a plan's. */
+export declare const slugOfPlanTag: (tag: string | null | undefined) => string | null;
+/** A slug from free text: lowercase words joined by dashes, 3–40 characters, starting with a letter. */
+export declare const planSlug: (text: string, suffix?: string) => string;
+/** What a person hands over for a check: the same three kinds `ask_the_world` posts. */
+export type PlanAct = "photo" | "observation" | "survey";
+/**
+ * photo: a picture taken at the place. observation: what the person saw, in
+ * words, located by their phone. survey: what people at the place think, one
+ * option of a few, a reason, and what they expect most people to say
+ * (rubric/survey.ts) — for markets where the signal is a crowd's opinion, not
+ * something to look at.
+ */
+export declare const PLAN_ACTS: readonly PlanAct[];
+/** Where a check happens. One place becomes one ask. */
+export interface PlanPlace {
+    /** What a person recognises: "Union Square, San Francisco". */
+    name: string;
+    lat: number;
+    lon: number;
+    /** How close the answer must be taken, in metres (20–20 000, as `ask_the_world`). */
+    withinM: number;
+}
+/** One line of the plan: an act, its places, how many answers per place, the pay, and what it beats. */
+export interface PlanCheck {
+    /** Stable within the plan: c1, c2… */
+    id: string;
+    act: PlanAct;
+    /** What the person does, in plain words, 12–300 characters. */
+    text: string;
+    places: PlanPlace[];
+    /** Answers to buy at each place (the ask's quota), 1–10. */
+    perPlace: number;
+    /** What one approved answer earns, in dollars. */
+    payUsd: number;
+    /** How long each ask stays open, in hours. */
+    hours: number;
+    /** The existing feed this check improves on, in one line. Mandatory: no line, no check. */
+    beats: string;
+    /** A survey's options, 2–6 (rubric/survey.ts). Present only on a survey. */
+    options?: string[];
+    /** Why this check informs the market, in one line: the agent's reasoning, shown before anything is funded. */
+    why?: string;
+    /** How its answers will be read, written before any arrive: "if most say X, that leans Yes, because…". */
+    readAs?: string;
+}
+/** The market a plan informs, as read when the plan was drafted. */
+export interface PlanMarket {
+    venue: "polymarket" | "kalshi" | "other";
+    url: string;
+    question: string;
+    /** The resolution rules as the venue states them, trimmed. */
+    rules?: string;
+    /** When the market closes (ISO), if the venue says. */
+    closes?: string;
+}
+/** The frozen plan document. */
+export interface MarketPlan {
+    kind: "openhands.market-plan";
+    v: 1;
+    slug: string;
+    market: PlanMarket;
+    checks: PlanCheck[];
+    /** What the plan cannot tell the trader. Mandatory. */
+    cannotTell: string;
+    /** What the whole plan should tell the trader, and by when, before the market does. The agent's thesis. */
+    thesis?: string;
+    /** ISO time the plan was drafted. */
+    createdAt: string;
+}
+export declare const MARKET_PLAN_KIND: "openhands.market-plan";
+/** The limits a plan is held to. The per-ask cap and the per-plan cap are the MCP's; these are shape. */
+export declare const PLAN_LIMITS: {
+    readonly checks: 12;
+    readonly placesPerCheck: 20;
+    readonly asksPerPlan: 120;
+    readonly perPlace: 10;
+    /** A survey asks more people at each place: one opinion is no signal. */
+    readonly surveyPerPlace: 50;
+    /** The plan's thesis: a few sentences at most. */
+    readonly thesisMax: 600;
+    readonly textMin: 12;
+    readonly textMax: 300;
+    readonly withinMin: 20;
+    readonly withinMax: 20000;
+    readonly hoursMin: 1;
+    readonly hoursMax: 720;
+    /** The smallest pay worth a person's walk, in dollars. */
+    readonly payFloorUsd: 0.05;
+    readonly lineMin: 8;
+    readonly lineMax: 240;
+};
+/** How many asks a plan posts: one per place per check. */
+export declare const planAskCount: (plan: Pick<MarketPlan, "checks">) => number;
+/** How many answers a plan buys at most. */
+export declare const planAnswerCount: (plan: Pick<MarketPlan, "checks">) => number;
+/** The price of a plan, line by line. */
+export interface PlanCost {
+    /** Per check: answers bought, pay, the check's total including the review of each answer. */
+    lines: {
+        id: string;
+        answers: number;
+        payUsd: number;
+        reviewUsd: number;
+        totalUsd: number;
+    }[];
+    /** Σ (pay + review) over every answer the plan can buy. */
+    workUsd: number;
+    /** The platform fee on top. */
+    feeUsd: number;
+    /** What the funder sends. */
+    totalUsd: number;
+}
+/**
+ * Price a plan: every answer it can buy costs its pay plus the review of that
+ * answer (the oracle's check reward), and the fee is a share of that work.
+ */
+export declare const planCost: (plan: Pick<MarketPlan, "checks">, opts: {
+    reviewUsd: number | ((check: PlanCheck) => number);
+    feeRate: number;
+}) => PlanCost;
+/** One refusal: the rule that refused it, where, and a sentence a person can act on. */
+export interface PlanRefusal {
+    rule: PlanRule;
+    /** The check it concerns, or null for the plan as a whole. */
+    check: string | null;
+    why: string;
+}
+export type PlanRule = "shape" | "in-play-sport" | "conflict-zone" | "polling-place" | "resolution-source" | "acts-on-outcome" | "non-public" | "faces" | "no-beats" | "no-cannot-tell" | "sensitive-survey";
+/** Refusals for the market as a whole: a sports market or a conflict market is never scoped. */
+export declare const screenMarket: (market: PlanMarket) => PlanRefusal[];
+/** Refusals for one check, read against the market it informs. */
+export declare const screenCheck: (check: PlanCheck) => PlanRefusal[];
+/**
+ * How many characters a check's words run past what an ask can carry once a
+ * place is added after them, or 0 when they fit. Drafting refuses any overrun,
+ * so a stored plan is posted word for word.
+ */
+export declare const askOverrun: (check: PlanCheck, place: PlanPlace) => number;
+/**
+ * Everything wrong with a plan, in the order a person would fix it: the
+ * market first, then the plan's own shape, then each check. An empty list is
+ * a plan that may be stored and funded.
+ */
+export declare const validatePlan: (plan: MarketPlan) => PlanRefusal[];
+/** A plan read back from the store, or null when the document is not a version 1 plan. */
+export declare const readMarketPlan: (doc: unknown) => MarketPlan | null;
+/**
+ * The words the asks of one check carry: the check, then its place. Drafting
+ * refuses words that overrun beside any place (askOverrun), so the cut below
+ * only ever reaches a plan stored before that rule, and marks itself with "…".
+ */
+export declare const askQuestionFor: (check: PlanCheck, place: PlanPlace) => string;
+//# sourceMappingURL=marketPlan.d.ts.map

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

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