@oneie/sdk 0.10.0 → 0.12.0

package/dist/gateway.js

@@ -0,0 +1,94 @@
+/**
+ * GatewayClient — direct TypeDB access via api.one.ie.
+ *
+ * Use when you need raw TypeQL, authority checks, or path queries that aren't
+ * covered by SubstrateClient (which routes through one.ie/api/*).
+ *
+ * In CF Workers use subpath import: `@oneie/sdk/gateway`
+ */
+const DEFAULT_GATEWAY = 'https://api.one.ie';
+// Allowlist for identifiers that may appear in authority TypeQL — deny anything
+// outside this charset rather than trying to escape arbitrary input into a query.
+const SAFE_ID = /^[A-Za-z0-9_.:@+-]+$/;
+const esc = (s) => s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+export class GatewayClient {
+    base;
+    key;
+    constructor(env = {}) {
+        this.base = env.GATEWAY_URL ?? DEFAULT_GATEWAY;
+        this.key = env.GATEWAY_API_KEY ?? '';
+    }
+    headers() {
+        const h = { 'Content-Type': 'application/json' };
+        if (this.key)
+            h['Authorization'] = `Bearer ${this.key}`;
+        return h;
+    }
+    /** Run a TypeQL query against the gateway. Retries once on 429/5xx. */
+    async query(tql, write = false) {
+        const doFetch = () => fetch(`${this.base}/typedb/query`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({ query: tql, transactionType: write ? 'write' : 'read', commit: write }),
+        });
+        let res = await doFetch();
+        if (!res.ok && [429, 502, 503, 504].includes(res.status)) {
+            await new Promise((r) => setTimeout(r, 500));
+            res = await doFetch();
+        }
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        return data.answers ?? [];
+    }
+    /**
+     * Walk-up authority check — mirrors `web/src/lib/authority.ts`.
+     * Returns false on missing actor/slug, malformed identifiers, or gateway error (fail closed).
+     */
+    async canWalk(actorId, slug, capability) {
+        if (!actorId || !slug)
+            return false;
+        if (!SAFE_ID.test(actorId) || !SAFE_ID.test(slug) || !SAFE_ID.test(capability))
+            return false;
+        const rows = await this.query(`match
+        $me isa actor, has aid "${esc(actorId)}";
+        $g isa group, has gid $gid;
+        { $gid == "${esc(slug)}"; } or { $gid == "group:${esc(slug)}"; };
+        let $ok = can($me, $g, "${esc(capability)}");
+        $ok == true;
+      select $me; limit 1;`).catch(() => []);
+        return rows.length > 0;
+    }
+    /**
+     * Find the best agent actors for a skill, ranked by path strength from `from`.
+     * Returns actor aids in descending strength order (up to 5).
+     */
+    async suggestRoute(from, skill) {
+        const rows = await this.query(`match
+        $from isa actor, has aid "${esc(from)}";
+        (source: $from, target: $to) isa path, has strength $s;
+        (provider: $to, offered: $sk) isa capability;
+        $sk has skill-id "${esc(skill)}";
+        $to has aid $aid;
+      sort $s desc; limit 5;
+      select $aid;`);
+        return rows.map((r) => r.aid);
+    }
+    /**
+     * Top paths originating from a specific actor, ranked by strength.
+     * Use SubstrateClient.highways(limit, from) for the same result over the HTTP substrate API.
+     */
+    async actorHighways(actorUid, limit = 10) {
+        const rows = await this.query(`match
+        $from isa actor, has aid "${esc(actorUid)}";
+        $e (source: $from, target: $to) isa path, has strength $s;
+        $to has aid $tid;
+      sort $s desc; limit ${limit};
+      select $tid, $s;`);
+        return rows.map((r) => {
+            const row = r;
+            return { to: row.tid, strength: row.s };
+        });
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { SubstrateClient } from "./client.js";
 export { SubstrateClient as OneieClient } from "./client.js";
 export { BrainClient } from "./brain.js";
 export type { BrainEnv } from "./brain.js";
+export { GatewayClient } from "./gateway.js";
+export type { GatewayEnv } from "./gateway.js";
 export { emit as telemetryEmit, isDisabled as isTelemetryDisabled, sessionId } from "./telemetry.js";
 export * from "./errors.js";
 export * from "./schemas.js";
@@ -20,6 +22,7 @@ export type { CatalogEntry } from "./meta.js";
 export { buildReceiverPayload, generatedRegion, injectRegion } from "./openapi.js";
 export * from "./pay.js";
 export * from "./skills.js";
+export * from "./broadcast.js";
 export { readWorkspaceSoul, buildSoulSuffix } from "./soul.js";
 export type { SoulDb } from "./soul.js";
 export { oneFetch, createAgent } from "./fetch.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnJ,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,UAAU,IAAI,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7I,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnF,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGjF,eAAO,MAAM,WAAW,EAAE,MAA6C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnJ,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,UAAU,IAAI,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7I,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnF,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGjF,eAAO,MAAM,WAAW,EAAE,MAA6C,CAAA"}

package/dist/index.js

@@ -7,6 +7,7 @@ export { launchToken } from "./launch.js";
 export { SubstrateClient } from "./client.js";
 export { SubstrateClient as OneieClient } from "./client.js";
 export { BrainClient } from "./brain.js";
+export { GatewayClient } from "./gateway.js";
 export { emit as telemetryEmit, isDisabled as isTelemetryDisabled, sessionId } from "./telemetry.js";
 export * from "./errors.js";
 export * from "./schemas.js";
@@ -15,6 +16,7 @@ export { metaCatalog, metaRecipe, metaSchema, ownerOnly } from "./meta.js";
 export { buildReceiverPayload, generatedRegion, injectRegion } from "./openapi.js";
 export * from "./pay.js";
 export * from "./skills.js";
+export * from "./broadcast.js";
 export { readWorkspaceSoul, buildSoulSuffix } from "./soul.js";
 export { oneFetch, createAgent } from "./fetch.js";
 export { PaymentError, BudgetExceededError, X402NetworkError } from "./fetch.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,UAAU,IAAI,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnF,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACvD,MAAM,CAAC,MAAM,WAAW,GAAY,GAA2B,CAAC,OAAO,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,UAAU,IAAI,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnF,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACvD,MAAM,CAAC,MAAM,WAAW,GAAY,GAA2B,CAAC,OAAO,CAAA"}

package/dist/market.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+export declare const StageSchema: z.ZodEnum<{
+    OFFER: "OFFER";
+    ESCROW: "ESCROW";
+    EXECUTE: "EXECUTE";
+    VERIFY: "VERIFY";
+    SETTLE: "SETTLE";
+    RECEIPT: "RECEIPT";
+    DISPUTE: "DISPUTE";
+    FADE: "FADE";
+}>;
+export type Stage = z.infer<typeof StageSchema>;
+export type Verb = "counter" | "accept" | "reject" | "escrow" | "deliver" | "verify" | "settle" | "dispute";
+export declare const RubricSchema: z.ZodObject<{
+    fit: z.ZodNumber;
+    form: z.ZodNumber;
+    truth: z.ZodNumber;
+    taste: z.ZodNumber;
+}, z.core.$strip>;
+export type Rubric = z.infer<typeof RubricSchema>;
+export declare const DealSchema: z.ZodObject<{
+    id: z.ZodString;
+    buyer: z.ZodString;
+    seller: z.ZodString;
+    skill: z.ZodString;
+    price: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    deadline: z.ZodString;
+    rubric: z.ZodOptional<z.ZodObject<{
+        fit: z.ZodNumber;
+        form: z.ZodNumber;
+        truth: z.ZodNumber;
+        taste: z.ZodNumber;
+    }, z.core.$strip>>;
+    stage: z.ZodEnum<{
+        OFFER: "OFFER";
+        ESCROW: "ESCROW";
+        EXECUTE: "EXECUTE";
+        VERIFY: "VERIFY";
+        SETTLE: "SETTLE";
+        RECEIPT: "RECEIPT";
+        DISPUTE: "DISPUTE";
+        FADE: "FADE";
+    }>;
+    version: z.ZodDefault<z.ZodNumber>;
+    escrowRef: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scores: z.ZodOptional<z.ZodObject<{
+        fit: z.ZodNumber;
+        form: z.ZodNumber;
+        truth: z.ZodNumber;
+        taste: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Deal = z.infer<typeof DealSchema>;
+export declare const VALID: Readonly<Record<Stage, ReadonlySet<Verb>>>;
+export declare class InvalidTransition extends Error {
+    readonly stage: Stage;
+    readonly verb: Verb;
+    constructor(stage: Stage, verb: Verb);
+}
+export declare function advance(deal: Deal, verb: Verb, scores?: Rubric): Deal;
+//# sourceMappingURL=market.d.ts.map

package/dist/market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,WAAW;;;;;;;;;EAStB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAIhD,MAAM,MAAM,IAAI,GACZ,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAId,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAM9C,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAS5D,CAAC;AAIF,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,KAAK,EAAE,KAAK;aACZ,IAAI,EAAE,IAAI;gBADV,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI;CAK7B;AAUD,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAkCrE"}

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":"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"}

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";