@oneie/sdk 0.10.0 → 0.11.0

package/dist/market.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+// ── Stages (locked — rename breaks KV-persisted deals) ──────────────────────
+export const StageSchema = z.enum([
+    "OFFER", // terms proposed; counter/accept/reject legal
+    "ESCROW", // accepted; payment being locked
+    "EXECUTE", // escrow confirmed; work in progress
+    "VERIFY", // work delivered; rubric scoring in progress
+    "SETTLE", // rubric passed; payment releasing
+    "RECEIPT", // terminal — success
+    "DISPUTE", // terminal — contested; refund in flight
+    "FADE", // terminal — rejected or expired
+]);
+// ── Deal schema ──────────────────────────────────────────────────────────────
+export const RubricSchema = z.object({
+    fit: z.number().min(0).max(1),
+    form: z.number().min(0).max(1),
+    truth: z.number().min(0).max(1),
+    taste: z.number().min(0).max(1),
+});
+export const DealSchema = z.object({
+    id: z.string().uuid(),
+    buyer: z.string().min(1),
+    seller: z.string().min(1),
+    skill: z.string().min(1),
+    price: z.number().nonnegative(),
+    currency: z.string().default("credits"),
+    deadline: z.string().datetime(), // ISO-8601
+    rubric: RubricSchema.optional(), // thresholds (not scores) — set by buyer
+    stage: StageSchema,
+    version: z.number().int().nonnegative().default(0),
+    escrowRef: z.string().optional(), // pay.one.ie quote/claim id
+    result: z.record(z.string(), z.unknown()).optional(), // delivered work blob
+    scores: RubricSchema.optional(), // actual scores set by market:verify
+});
+// ── VALID — legal verbs per stage ────────────────────────────────────────────
+const TERMINAL = new Set(["RECEIPT", "DISPUTE", "FADE"]);
+export const VALID = {
+    OFFER: new Set(["counter", "accept", "reject", "dispute"]),
+    ESCROW: new Set(["escrow", "dispute"]),
+    EXECUTE: new Set(["deliver", "dispute"]),
+    VERIFY: new Set(["verify", "dispute"]),
+    SETTLE: new Set(["settle", "dispute"]),
+    RECEIPT: new Set(),
+    DISPUTE: new Set(),
+    FADE: new Set(),
+};
+// ── Errors ───────────────────────────────────────────────────────────────────
+export class InvalidTransition extends Error {
+    stage;
+    verb;
+    constructor(stage, verb) {
+        super(`invalid transition: ${verb} is not legal in stage ${stage}`);
+        this.stage = stage;
+        this.verb = verb;
+        this.name = "InvalidTransition";
+    }
+}
+// ── advance() — the only way to mutate stage ─────────────────────────────────
+const RUBRIC_PASS_THRESHOLD = 0.65;
+function composite(scores) {
+    return (scores.fit + scores.form + scores.truth + scores.taste) / 4;
+}
+export function advance(deal, verb, scores) {
+    if (!VALID[deal.stage].has(verb)) {
+        throw new InvalidTransition(deal.stage, verb);
+    }
+    switch (verb) {
+        case "counter":
+            return { ...deal, version: deal.version + 1 };
+        case "accept":
+            return { ...deal, stage: "ESCROW", version: deal.version + 1 };
+        case "reject":
+            return { ...deal, stage: "FADE", version: deal.version + 1 };
+        case "escrow":
+            return { ...deal, stage: "EXECUTE", version: deal.version + 1 };
+        case "deliver":
+            return { ...deal, stage: "VERIFY", version: deal.version + 1 };
+        case "verify": {
+            if (!scores)
+                throw new Error("verify requires scores");
+            const next = composite(scores) >= RUBRIC_PASS_THRESHOLD ? "SETTLE" : "DISPUTE";
+            return { ...deal, stage: next, scores, version: deal.version + 1 };
+        }
+        case "settle":
+            return { ...deal, stage: "RECEIPT", version: deal.version + 1 };
+        case "dispute":
+            if (TERMINAL.has(deal.stage))
+                throw new InvalidTransition(deal.stage, verb);
+            return { ...deal, stage: "DISPUTE", version: deal.version + 1 };
+    }
+}
+//# sourceMappingURL=market.js.map

package/dist/market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,OAAO,EAAK,8CAA8C;IAC1D,QAAQ,EAAI,iCAAiC;IAC7C,SAAS,EAAG,qCAAqC;IACjD,QAAQ,EAAI,6CAA6C;IACzD,QAAQ,EAAI,mCAAmC;IAC/C,SAAS,EAAG,qBAAqB;IACjC,SAAS,EAAG,yCAAyC;IACrD,MAAM,EAAM,iCAAiC;CAC9C,CAAC,CAAC;AAeH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAU,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,KAAK,EAAO,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,MAAM,EAAM,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,KAAK,EAAO,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,KAAK,EAAO,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACpC,QAAQ,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACzC,QAAQ,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAW,WAAW;IACvD,MAAM,EAAM,YAAY,CAAC,QAAQ,EAAE,EAAS,yCAAyC;IACrF,KAAK,EAAO,WAAW;IACvB,OAAO,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,SAAS,EAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAW,4BAA4B;IACxE,MAAM,EAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,sBAAsB;IAChF,MAAM,EAAM,YAAY,CAAC,QAAQ,EAAE,EAAS,qCAAqC;CAClF,CAAC,CAAC;AAGH,gFAAgF;AAEhF,MAAM,QAAQ,GAAuB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,KAAK,GAA+C;IAC/D,KAAK,EAAI,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,EAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,EAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,EAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,EAAE,IAAI,GAAG,EAAE;IAClB,OAAO,EAAE,IAAI,GAAG,EAAE;IAClB,IAAI,EAAK,IAAI,GAAG,EAAE;CACnB,CAAC;AAEF,gFAAgF;AAEhF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IACA;IAFlB,YACkB,KAAY,EACZ,IAAU;QAE1B,KAAK,CAAC,uBAAuB,IAAI,0BAA0B,KAAK,EAAE,CAAC,CAAC;QAHpD,UAAK,GAAL,KAAK,CAAO;QACZ,SAAI,GAAJ,IAAI,CAAM;QAG1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,gFAAgF;AAEhF,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,IAAU,EAAE,MAAe;IAC7D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAEhD,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAEjE,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAE/D,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAElE,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAEjE,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACvD,MAAM,IAAI,GAAU,SAAS,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YACtF,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACrE,CAAC;QAED,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAElE,KAAK,SAAS;YACZ,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5E,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/meta.d.ts

@@ -4,7 +4,7 @@ import { type ReceiverName, type RecipeName } from "./receivers.js";
  * catalog: an agent reads these to discover what it can call, each capability's
  * cost/reversibility/settlement, and one receiver's exact request schema —
  * before it acts. Handlers in the service bind these to a caller's role; the
- * functions themselves carry no runtime dependency. See `plans/agent-first-spec.md`.
+ * functions themselves carry no runtime dependency. See `text/agent-first-spec-plan.md`.
  */
 /** One catalog row — the agent-facing slice of a receiver declaration. */
 export interface CatalogEntry {

package/dist/openapi.d.ts

@@ -4,7 +4,7 @@
  * payload; here we derive a real `oneOf` over every receiver's request schema
  * (via `z.toJSONSchema`), each member tagged with the agent-ergonomic metadata
  * as `x-` extensions. Pure functions — the CLI (`scripts/generate-openapi.ts`)
- * does the file I/O. See `plans/agent-first-spec.md`.
+ * does the file I/O. See `text/agent-first-spec-plan.md`.
  */
 export declare const RECEIVER_REGION_BEGIN = "    # BEGIN generated:receivers \u2014 bun run generate:openapi (do not edit by hand)";
 export declare const RECEIVER_REGION_END = "    # END generated:receivers";

package/dist/openapi.js

@@ -6,7 +6,7 @@ import { RECEIVERS } from "./receivers.js";
  * payload; here we derive a real `oneOf` over every receiver's request schema
  * (via `z.toJSONSchema`), each member tagged with the agent-ergonomic metadata
  * as `x-` extensions. Pure functions — the CLI (`scripts/generate-openapi.ts`)
- * does the file I/O. See `plans/agent-first-spec.md`.
+ * does the file I/O. See `text/agent-first-spec-plan.md`.
  */
 export const RECEIVER_REGION_BEGIN = "    # BEGIN generated:receivers — bun run generate:openapi (do not edit by hand)";
 export const RECEIVER_REGION_END = "    # END generated:receivers";