@oneie/sdk 0.10.0 → 0.12.0

package/dist/receivers.d.ts

@@ -11,7 +11,7 @@ import { z } from "zod";
  * Consumers: typed `ask<R>`/`signal<R>` (inference, no codegen) · OpenAPI
  * generator · MCP tool descriptions · `meta:catalog` discovery.
  *
- * See `plans/agent-first-spec.md`.
+ * See `text/agent-first-spec-plan.md`.
  */
 /** Role gate — mirrors the web route's `gateSignalByRole` action. Kept as a loose
  *  string so the contract layer carries no web runtime dependency. */
@@ -41,6 +41,10 @@ export interface Receiver<Req extends z.ZodTypeAny = z.ZodTypeAny, Res extends z
     effect: ReceiverEffect;
     /** Role gate — documents the existing `gateSignalByRole` check. */
     auth?: RoleAction;
+    /** Minimum world-key scope to call this receiver via an `osk_` bearer key
+     *  ('read' | 'write' | 'admin'). Discovery metadata — enforcement lives in the
+     *  service (`world-receivers.ts` assertScope). Omitted ⇒ defaults to 'write'. */
+    scope?: "read" | "write" | "admin";
     /** What it costs, so an agent budgets before acting. */
     cost?: ReceiverCost;
     /** Default true; false ⇒ should be dry-run first. */
@@ -77,6 +81,16 @@ export declare function receiver<Req extends z.ZodTypeAny, Res extends z.ZodType
  * C4 = remaining families with metadata; C5 = the `meta:` family.
  */
 export declare const RECEIVERS: {
+    "agent:enroll": Receiver<z.ZodObject<{
+        name: z.ZodString;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        actorId: z.ZodString;
+        slug: z.ZodString;
+        apiKey: z.ZodString;
+        credits: z.ZodNumber;
+    }, z.core.$strip>>;
     "auth:agent": Receiver<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         uid: z.ZodOptional<z.ZodString>;
@@ -219,6 +233,40 @@ export declare const RECEIVERS: {
     }, z.core.$strip>, z.ZodObject<{
         ok: z.ZodBoolean;
     }, z.core.$strip>>;
+    "world:update-contact": Receiver<z.ZodObject<{
+        aid: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        firstName: z.ZodOptional<z.ZodString>;
+        lastName: z.ZodOptional<z.ZodString>;
+        nickname: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
+        bio: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodString>;
+        jobTitle: z.ZodOptional<z.ZodString>;
+        company: z.ZodOptional<z.ZodString>;
+        department: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        gender: z.ZodOptional<z.ZodString>;
+        nationality: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        postcode: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodNumber>;
+        fitScore: z.ZodOptional<z.ZodNumber>;
+        nps: z.ZodOptional<z.ZodNumber>;
+        csat: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
     "world:remove-actor": Receiver<z.ZodObject<{
         aid: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -226,11 +274,28 @@ export declare const RECEIVERS: {
     }, z.core.$strip>>;
     "world:create-key": Receiver<z.ZodObject<{
         actor: z.ZodString;
-        scope: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            read: "read";
+            write: "write";
+            admin: "admin";
+        }>>;
         label: z.ZodOptional<z.ZodString>;
+        expiresIn: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         key: z.ZodString;
         keyId: z.ZodString;
+        scope: z.ZodString;
+    }, z.core.$strip>>;
+    "world:list-keys": Receiver<z.ZodObject<{
+        actor: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        keys: z.ZodArray<z.ZodObject<{
+            keyId: z.ZodString;
+            label: z.ZodNullable<z.ZodString>;
+            scope: z.ZodString;
+            createdAt: z.ZodNumber;
+            validTo: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     "world:revoke-key": Receiver<z.ZodObject<{
         keyId: z.ZodString;
@@ -311,39 +376,9 @@ export declare const RECEIVERS: {
         uid: z.ZodString;
         address: z.ZodString;
     }, z.core.$strip>>;
-    "auth:sign-in": Receiver<z.ZodObject<{
-        email: z.ZodString;
-        password: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        sessionId: z.ZodString;
-        userId: z.ZodString;
-    }, z.core.$strip>>;
     "auth:sign-out": Receiver<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
         ok: z.ZodBoolean;
     }, z.core.$strip>>;
-    "board:join": Receiver<z.ZodObject<{
-        uid: z.ZodString;
-        group: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodBoolean;
-        uid: z.ZodString;
-        group: z.ZodString;
-        role: z.ZodString;
-    }, z.core.$strip>>;
-    "agency:push:complete": Receiver<z.ZodObject<{
-        agents: z.ZodNumber;
-        skills: z.ZodNumber;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodBoolean;
-    }, z.core.$strip>>;
-    "agency:friction": Receiver<z.ZodObject<{
-        agency: z.ZodString;
-        cycle: z.ZodNullable<z.ZodString>;
-        wave: z.ZodNullable<z.ZodString>;
-        reason: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodBoolean;
-    }, z.core.$strip>>;
     "groups:join": Receiver<z.ZodObject<{
         gid: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -391,25 +426,12 @@ export declare const RECEIVERS: {
             cap: z.ZodNullable<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    "paths:bridge": Receiver<z.ZodObject<{
-        from: z.ZodString;
-        to: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodOptional<z.ZodBoolean>;
-        status: z.ZodOptional<z.ZodEnum<{
-            pending: "pending";
-            bridged: "bridged";
-        }>>;
-        key: z.ZodOptional<z.ZodString>;
-        gid: z.ZodOptional<z.ZodString>;
-        awaiting: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     "subscriptions:register": Receiver<z.ZodObject<{
         receiver: z.ZodString;
         tags: z.ZodArray<z.ZodString>;
         scope: z.ZodOptional<z.ZodEnum<{
-            private: "private";
             public: "public";
+            private: "private";
         }>>;
     }, z.core.$strip>, z.ZodObject<{
         ok: z.ZodBoolean;
@@ -462,19 +484,6 @@ export declare const RECEIVERS: {
         price: z.ZodNumber;
         currency: z.ZodString;
     }, z.core.$strip>>>;
-    "agents:deploy-on-behalf": Receiver<z.ZodObject<{
-        owner: z.ZodString;
-        spec: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodBoolean;
-        uid: z.ZodString;
-        owner: z.ZodString;
-        inheritedPaths: z.ZodArray<z.ZodObject<{
-            from: z.ZodString;
-            to: z.ZodString;
-            strength: z.ZodNumber;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
     "pay:weight": Receiver<z.ZodObject<{
         from: z.ZodString;
         to: z.ZodString;
@@ -488,6 +497,147 @@ export declare const RECEIVERS: {
         amount: z.ZodNumber;
         sui: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
+    "market:offer": Receiver<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        seller: z.ZodString;
+        skill: z.ZodString;
+        price: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+        deadline: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:counter": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+        price: z.ZodOptional<z.ZodNumber>;
+        deadline: z.ZodOptional<z.ZodString>;
+        skill: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:accept": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:reject": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:deliver": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+        result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:verify": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+        fit: z.ZodNumber;
+        form: z.ZodNumber;
+        truth: z.ZodNumber;
+        taste: z.ZodNumber;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+        scores: z.ZodObject<{
+            fit: z.ZodNumber;
+            form: z.ZodNumber;
+            truth: z.ZodNumber;
+            taste: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:settle": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:dispute": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+    "market:escrow": Receiver<z.ZodObject<{
+        dealId: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        deal: z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+        escrowRef: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+        deal: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            stage: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
     "market:hire": Receiver<z.ZodObject<{
         providerUid: z.ZodString;
         skillId: z.ZodString;
@@ -537,6 +687,16 @@ export declare const RECEIVERS: {
         deadline: z.ZodOptional<z.ZodString>;
         status: z.ZodString;
     }, z.core.$strip>>>;
+    "market:claim": Receiver<z.ZodObject<{
+        bountyId: z.ZodString;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        bountyId: z.ZodString;
+        claimantUid: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
     "market:list": Receiver<z.ZodObject<{
         tag: z.ZodOptional<z.ZodString>;
         maxPrice: z.ZodOptional<z.ZodNumber>;
@@ -562,26 +722,6 @@ export declare const RECEIVERS: {
         sid: z.ZodString;
         scope: z.ZodString;
     }, z.core.$strip>>;
-    "loop:close": Receiver<z.ZodObject<{
-        session: z.ZodString;
-        outcome: z.ZodEnum<{
-            timeout: "timeout";
-            result: "result";
-            dissolved: "dissolved";
-            failure: "failure";
-        }>;
-        rubric: z.ZodOptional<z.ZodNumber>;
-        reason: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodLiteral<true>;
-        stages: z.ZodArray<z.ZodUnknown>;
-        highways: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            strength: z.ZodNumber;
-            resistance: z.ZodNumber;
-            net: z.ZodNumber;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
     "signals:list": Receiver<z.ZodObject<{
         limit: z.ZodOptional<z.ZodNumber>;
         since: z.ZodOptional<z.ZodNumber>;
@@ -715,6 +855,618 @@ export declare const RECEIVERS: {
         reply: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    "booking:list-slots": Receiver<z.ZodObject<{
+        slug: z.ZodString;
+        service: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        days: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        service: z.ZodNullable<z.ZodObject<{
+            service_id: z.ZodString;
+            name: z.ZodString;
+            duration_min: z.ZodNumber;
+            price: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        slots: z.ZodArray<z.ZodObject<{
+            date: z.ZodString;
+            times: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "booking:create": Receiver<z.ZodObject<{
+        slug: z.ZodString;
+        service: z.ZodString;
+        slotDate: z.ZodString;
+        slotTime: z.ZodString;
+        customer: z.ZodObject<{
+            name: z.ZodString;
+            email: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        paymentRail: z.ZodOptional<z.ZodEnum<{
+            sui: "sui";
+            stripe: "stripe";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        ref: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            confirmed: "confirmed";
+        }>>;
+        paymentRail: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            sui: "sui";
+            stripe: "stripe";
+        }>>>;
+        paymentIntent: z.ZodOptional<z.ZodObject<{
+            clientSecret: z.ZodString;
+            amount: z.ZodNumber;
+        }, z.core.$strip>>;
+        escrow: z.ZodOptional<z.ZodObject<{
+            escrowId: z.ZodString;
+            bounty: z.ZodNumber;
+            deadline: z.ZodString;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "booking:configure": Receiver<z.ZodObject<{
+        slug: z.ZodString;
+        actorId: z.ZodOptional<z.ZodString>;
+        service: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        duration_min: z.ZodNumber;
+        price: z.ZodOptional<z.ZodNumber>;
+        currency: z.ZodOptional<z.ZodString>;
+        hours_json: z.ZodArray<z.ZodArray<z.ZodObject<{
+            start: z.ZodString;
+            end: z.ZodString;
+        }, z.core.$strip>>>;
+        tz: z.ZodOptional<z.ZodString>;
+        active: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        service_id: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "booking:list-bookings": Receiver<z.ZodObject<{
+        slug: z.ZodString;
+        month: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        bookings: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            ref: z.ZodString;
+            service_name: z.ZodString;
+            slot_date: z.ZodString;
+            slot_time: z.ZodString;
+            customer_name: z.ZodString;
+            status: z.ZodString;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "booking:cancel": Receiver<z.ZodObject<{
+        slug: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:list": Receiver<z.ZodObject<{
+        slug: z.ZodOptional<z.ZodString>;
+        templates: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        workflows: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            step_count: z.ZodNumber;
+            status: z.ZodString;
+            last_run_status: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:get": Receiver<z.ZodObject<{
+        workflowId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                agent: "agent";
+                skill: "skill";
+                trigger: "trigger";
+                tool: "tool";
+                condition: "condition";
+                human: "human";
+                delay: "delay";
+                sell: "sell";
+            }>;
+            name: z.ZodString;
+            config: z.ZodString;
+            position: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        edges: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            target: z.ZodString;
+            strength: z.ZodNumber;
+            resistance: z.ZodNumber;
+            condition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:runs": Receiver<z.ZodObject<{
+        workflowId: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        runs: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodString;
+            started_at: z.ZodNumber;
+            finished_at: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            step_id: z.ZodString;
+            kind: z.ZodString;
+            status: z.ZodNullable<z.ZodString>;
+            latency_ms: z.ZodNullable<z.ZodNumber>;
+            at: z.ZodNumber;
+        }, z.core.$strip>>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:create": Receiver<z.ZodObject<{
+        slug: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        fromTemplate: z.ZodOptional<z.ZodString>;
+        simulate: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        workflowId: z.ZodString;
+    }, z.core.$strip>>;
+    "workflow:apply-diff": Receiver<z.ZodObject<{
+        workflowId: z.ZodString;
+        diff: z.ZodObject<{
+            add: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tempId: z.ZodString;
+                kind: z.ZodEnum<{
+                    agent: "agent";
+                    skill: "skill";
+                    trigger: "trigger";
+                    tool: "tool";
+                    condition: "condition";
+                    human: "human";
+                    delay: "delay";
+                    sell: "sell";
+                }>;
+                name: z.ZodString;
+                config: z.ZodString;
+                position: z.ZodOptional<z.ZodString>;
+                afterStepId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            connect: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                target: z.ZodString;
+                condition: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            disconnect: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                target: z.ZodString;
+            }, z.core.$strip>>>;
+            update: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                stepId: z.ZodString;
+                field: z.ZodEnum<{
+                    name: "name";
+                    config: "config";
+                    position: "position";
+                    "exit-condition": "exit-condition";
+                    owner: "owner";
+                }>;
+                value: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        simulate: z.ZodOptional<z.ZodBoolean>;
+        version: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        stepCount: z.ZodOptional<z.ZodNumber>;
+        idMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:run": Receiver<z.ZodObject<{
+        workflowId: z.ZodString;
+        triggerPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        runId: z.ZodString;
+        status: z.ZodString;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "human:resolve": Receiver<z.ZodObject<{
+        runId: z.ZodString;
+        stepId: z.ZodString;
+        decision: z.ZodOptional<z.ZodEnum<{
+            approved: "approved";
+            rejected: "rejected";
+        }>>;
+        formPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        slug: z.ZodOptional<z.ZodString>;
+        attestation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "checkout:create": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        ppid: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        stepId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        clientSecret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        applicationFeeAmount: z.ZodOptional<z.ZodNumber>;
+        stripeAccount: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "checkout:resume": Receiver<z.ZodObject<{
+        runId: z.ZodString;
+        stepId: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "human:notify": Receiver<z.ZodObject<{
+        runId: z.ZodString;
+        stepId: z.ZodString;
+        stepName: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        group: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:stop": Receiver<z.ZodObject<{
+        runId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:trigger": Receiver<z.ZodObject<{
+        source: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        triggerPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        started: z.ZodNumber;
+        runIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:delete": Receiver<z.ZodObject<{
+        workflowId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "workflow:update": Receiver<z.ZodObject<{
+        workflowId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            draft: "draft";
+            active: "active";
+            paused: "paused";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "skills:list": Receiver<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+        skills: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    "skill:run": Receiver<z.ZodObject<{
+        skill: z.ZodString;
+    }, z.core.$catchall<z.ZodUnknown>>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        text: z.ZodOptional<z.ZodString>;
+        skill: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "agent:run": Receiver<z.ZodObject<{
+        actorId: z.ZodString;
+        skill: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        text: z.ZodOptional<z.ZodString>;
+        actorId: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:create-room": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<{
+            meeting: "meeting";
+            classroom: "classroom";
+            webinar: "webinar";
+        }>>;
+        region: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        room: z.ZodOptional<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodString;
+            type: z.ZodString;
+            hmsRoomId: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:delete-room": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:contact-call": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        actorId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        roomSlug: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        guestJoinUrl: z.ZodOptional<z.ZodString>;
+        hostJoinUrl: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:invite": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+        actorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        goUrl: z.ZodOptional<z.ZodString>;
+        destination: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:schedule-webinar": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        actorIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        roomUrl: z.ZodOptional<z.ZodString>;
+        invited: z.ZodOptional<z.ZodNumber>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            actorId: z.ZodString;
+            goUrl: z.ZodString;
+        }, z.core.$strip>>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:create-session": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            meeting: "meeting";
+            classroom: "classroom";
+            webinar: "webinar";
+        }>>;
+        region: z.ZodOptional<z.ZodString>;
+        guestActorId: z.ZodOptional<z.ZodString>;
+        scheduledAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        room: z.ZodOptional<z.ZodObject<{
+            slug: z.ZodString;
+            hmsRoomId: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strip>>;
+        hostJoinUrl: z.ZodOptional<z.ZodString>;
+        guestJoinUrl: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:summary": Receiver<z.ZodObject<{
+        threadId: z.ZodString;
+        transcript: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        threadId: z.ZodOptional<z.ZodString>;
+        skipped: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:quick-room": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        threadId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        roomSlug: z.ZodOptional<z.ZodString>;
+        guestJoinUrl: z.ZodOptional<z.ZodString>;
+        hostJoinUrl: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:join-event": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        actorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:start-recording": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        recordingId: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "video:start-stream": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        roomSlug: z.ZodString;
+        hlsConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        hlsUrl: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "connect:channel": Receiver<z.ZodObject<{
+        channel: z.ZodString;
+        token: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodString>;
+        account: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "connect:status": Receiver<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            channel: z.ZodString;
+            account: z.ZodString;
+            status: z.ZodString;
+            runtime: z.ZodString;
+            connected_at: z.ZodNumber;
+        }, z.core.$strip>>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    "broadcast:create": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        subject: z.ZodOptional<z.ZodString>;
+        body_md: z.ZodOptional<z.ZodString>;
+        audience_tag: z.ZodOptional<z.ZodString>;
+        channel: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            sms: "sms";
+            whatsapp: "whatsapp";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        broadcastId: z.ZodString;
+    }, z.core.$strip>>;
+    "broadcast:update": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        broadcastId: z.ZodString;
+        subject: z.ZodOptional<z.ZodString>;
+        body_md: z.ZodOptional<z.ZodString>;
+        audience_tag: z.ZodOptional<z.ZodString>;
+        scheduled_at: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "broadcast:list": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            draft: "draft";
+            scheduled: "scheduled";
+            sending: "sending";
+            sent: "sent";
+            cancelled: "cancelled";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        broadcasts: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            subject: z.ZodString;
+            status: z.ZodString;
+            sent_at: z.ZodNullable<z.ZodNumber>;
+            audience_tag: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    "broadcast:get": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        broadcastId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        broadcast: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    "broadcast:test": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        broadcastId: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "broadcast:send": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        broadcastId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        enqueued: z.ZodNumber;
+    }, z.core.$strip>>;
+    "broadcast:schedule": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        broadcastId: z.ZodString;
+        scheduled_at: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "broadcast:cancel": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        broadcastId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "audience:subscribe": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        address: z.ZodString;
+        list: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "audience:unsubscribe": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        channel: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            sms: "sms";
+            whatsapp: "whatsapp";
+        }>>;
+        address: z.ZodString;
+        token: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "audience:confirm": Receiver<z.ZodObject<{
+        token: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
+    "audience:winback": Receiver<z.ZodObject<{
+        days: z.ZodOptional<z.ZodNumber>;
+        campaign: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+        sent: z.ZodNumber;
+        scanned: z.ZodNumber;
+    }, z.core.$strip>>;
+    "message:send": Receiver<z.ZodObject<{
+        workspace: z.ZodString;
+        channel: z.ZodEnum<{
+            email: "email";
+            sms: "sms";
+            whatsapp: "whatsapp";
+        }>;
+        to: z.ZodString;
+        subject: z.ZodOptional<z.ZodString>;
+        body: z.ZodString;
+        campaign: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>>;
 };
 /** A declared receiver name — `keyof` the catalog. */
 export type ReceiverName = keyof typeof RECEIVERS;
@@ -726,7 +1478,7 @@ export type ResOf<R extends ReceiverName> = (typeof RECEIVERS)[R] extends Receiv
  * RECIPES — the four agent journeys as typed, ordered receiver sequences (C6).
  * Each entry is `readonly ReceiverName[]`, so a typo or a renamed receiver is a
  * compile error. `meta:catalog?goal=` returns one of these; the MCP server
- * groups its tools by them. See `plans/agent-first-spec.md`.
+ * groups its tools by them. See `text/agent-first-spec-plan.md`.
  */
 export declare const RECIPES: {
     /** Onboard: become an actor → mint a key → join a group → declare capability. */
@@ -737,6 +1489,8 @@ export declare const RECIPES: {
     trade: ("pay:weight" | "market:hire" | "market:list" | "capabilities:publish")[];
     /** Transact: post a bounty → settle it onchain. */
     transact: ("pay:weight" | "market:bounty")[];
+    /** SOP: define a workflow → shape it with a diff → run it. */
+    sop: ("workflow:create" | "workflow:apply-diff" | "workflow:run")[];
 };
 /** A declared recipe name. */
 export type RecipeName = keyof typeof RECIPES;