@oneie/sdk 0.16.4 → 0.16.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/receivers.js CHANGED
@@ -97,6 +97,7 @@ export const RECEIVERS = {
97
97
  }),
98
98
  "agent:provision": receiver({
99
99
  receiver: "agent:provision",
100
+ canonical: "agent:enroll",
100
101
  summary: "Zero-to-live in one unauthenticated call — register + workspace + publish agent + import skills + invite owner",
101
102
  request: () => z.object({
102
103
  name: z.string().optional(),
@@ -116,6 +117,7 @@ export const RECEIVERS = {
116
117
  }),
117
118
  "agent:bootstrap": receiver({
118
119
  receiver: "agent:bootstrap",
120
+ canonical: "agent:enroll",
119
121
  summary: "Atomically provision a workspace + actor + scoped key; optionally invite an initial human owner",
120
122
  request: () => z.object({
121
123
  name: z.string(),
@@ -134,10 +136,12 @@ export const RECEIVERS = {
134
136
  }),
135
137
  "auth:agent": receiver({
136
138
  receiver: "auth:agent",
139
+ canonical: "agent:enroll",
137
140
  // `wallet` is a PUBLIC receiving address the caller derived in its own process.
138
- // Nothing here generates keys: the address is stored on the TypeDB actor and
139
- // registered through wallet:create, which is first-write-wins per chain.
140
- summary: "Become an actor — mint a uid and a scoped API key, and register a wallets row (a public address if you supply one, an empty shell if not)",
141
+ // Nothing here generates keys. The address is stored on the TypeDB actor but NOT
142
+ // on the wallets row: an agent address needs a wallet:challenge proof, so the
143
+ // row is a shell until the agent registers by signature through wallet:create.
144
+ summary: "Become an actor — mint a uid and a scoped API key, and register an empty wallets row; addresses are registered afterwards by wallet:challenge proof",
141
145
  request: () => z.object({ name: z.string().optional(), uid: z.string().optional(), kind: z.string().optional(), wallet: z.string().optional() }),
142
146
  response: () => z.object({
143
147
  uid: z.string(), name: z.string(), kind: z.string(),
@@ -231,6 +235,7 @@ export const RECEIVERS = {
231
235
  }),
232
236
  "world:invite-agent": receiver({
233
237
  receiver: "world:invite-agent",
238
+ canonical: "agent:enroll",
234
239
  summary: "Create an agent actor in a workspace and return its key once — no email",
235
240
  request: () => z.object({ workspace: z.string(), name: z.string(), role: z.string().optional() }),
236
241
  response: () => z.object({ aid: z.string(), key: z.string() }),
@@ -368,6 +373,7 @@ export const RECEIVERS = {
368
373
  */
369
374
  "world:set-brand-tokens": receiver({
370
375
  receiver: "world:set-brand-tokens",
376
+ canonical: "brand:set",
371
377
  summary: "Write validated colour tokens to a workspace's brand (site.md)",
372
378
  request: () => z.object({
373
379
  /** The workspace being rebranded. The ONLY workspace field: authority is
@@ -1246,6 +1252,7 @@ export const RECEIVERS = {
1246
1252
  }),
1247
1253
  "attention:follow": receiver({
1248
1254
  receiver: "attention:follow",
1255
+ canonical: "world:subscribe",
1249
1256
  summary: "Subscribe to a do-event axis; writes ws-scoped mark so fan-out stays tenant-isolated",
1250
1257
  request: () => z.object({ axis: z.string().min(1) }),
1251
1258
  response: () => z.object({ ok: z.boolean(), target: z.string().optional() }),
@@ -1415,6 +1422,7 @@ export const RECEIVERS = {
1415
1422
  // ── groups ──
1416
1423
  "groups:join": receiver({
1417
1424
  receiver: "groups:join",
1425
+ canonical: "world:request-access",
1418
1426
  surfaces: { mcp: true },
1419
1427
  summary: "Join a group",
1420
1428
  request: () => z.object({ gid: z.string() }),
@@ -1423,6 +1431,7 @@ export const RECEIVERS = {
1423
1431
  }),
1424
1432
  "groups:leave": receiver({
1425
1433
  receiver: "groups:leave",
1434
+ canonical: "world:remove-member",
1426
1435
  surfaces: { mcp: true },
1427
1436
  summary: "Leave a group",
1428
1437
  request: () => z.object({ gid: z.string() }),
@@ -1431,6 +1440,7 @@ export const RECEIVERS = {
1431
1440
  }),
1432
1441
  "groups:invite": receiver({
1433
1442
  receiver: "groups:invite",
1443
+ canonical: "world:invite-member",
1434
1444
  summary: "Invite an actor to a group",
1435
1445
  request: () => z.object({ gid: z.string(), uid: z.string(), role: z.string().optional() }),
1436
1446
  response: () => ok,
@@ -1442,6 +1452,7 @@ export const RECEIVERS = {
1442
1452
  // awareness, not membership: no role, no read, never a world:route target.
1443
1453
  "groups:follow": receiver({
1444
1454
  receiver: "groups:follow",
1455
+ canonical: "world:subscribe",
1445
1456
  summary: "Watch a public group — its world:announce fan-out reaches your inbox",
1446
1457
  request: () => z.object({
1447
1458
  group: z.string().describe("slug or gid of the group to watch"),
@@ -1458,6 +1469,7 @@ export const RECEIVERS = {
1458
1469
  }),
1459
1470
  "groups:unfollow": receiver({
1460
1471
  receiver: "groups:unfollow",
1472
+ canonical: "world:unsubscribe",
1461
1473
  summary: "Stop watching a group — removes the watch row only, never a declared subscription",
1462
1474
  request: () => z.object({ group: z.string().describe("slug or gid") }),
1463
1475
  response: () => z.object({
@@ -1471,6 +1483,7 @@ export const RECEIVERS = {
1471
1483
  }),
1472
1484
  "groups:members": receiver({
1473
1485
  receiver: "groups:members",
1486
+ canonical: "world:list-actors",
1474
1487
  surfaces: { mcp: true },
1475
1488
  summary: "List a group's members",
1476
1489
  request: () => z.object({ gid: z.string() }),
@@ -1560,6 +1573,7 @@ export const RECEIVERS = {
1560
1573
  // ── subscriptions ──
1561
1574
  "subscriptions:register": receiver({
1562
1575
  receiver: "subscriptions:register",
1576
+ canonical: "world:subscribe",
1563
1577
  summary: "Subscribe to a receiver's events by tag",
1564
1578
  request: () => z.object({
1565
1579
  // OPTIONAL, and the default is the common case. `subscriptions.ts` reads
@@ -2845,6 +2859,7 @@ export const RECEIVERS = {
2845
2859
  assignee: z.string().optional().describe("Actor slug. '' = unassigned only."),
2846
2860
  parent: z.string().optional().describe("Only direct children of this task id. '' = top-level rows (no parent)."),
2847
2861
  search: z.string().optional().describe("Case-insensitive substring on the task name."),
2862
+ tid: z.string().optional().describe("Exactly this task id (any `task:` prefix doubling ignored). How a `?task=<tid>` link opens a row that is not on the first page."),
2848
2863
  ready: z.boolean().optional().describe("true = only rows claimable now (open, and every blocker closed). false = only rows that are NOT claimable now (not open, or at least one blocker still open). Omit for both."),
2849
2864
  include: z.array(z.enum(["notes", "graph", "dates", "thread"])).optional()
2850
2865
  .describe("Widen each row. notes = the prose goal, WHOLE and unclipped (it was silently cut at 2000 chars until 2026-09-21, mid-word, while `truncated` named the tag budget beside it and stayed silent about this one; the escape hatch its comment named, tasks:get, was never built, so no door returned a longer note at all). Pass `notesClip` for a bound and the response reports `truncated.notes`; graph = children + blocks (the reverse edges); dates = startAt/createdAt/closedAt; thread = the task's inbox conversation (id, comment count, last message). Compact rows already carry parent, blockedBy, dueAt."),
@@ -3061,6 +3076,7 @@ export const RECEIVERS = {
3061
3076
  }),
3062
3077
  "tasks:follow": receiver({
3063
3078
  receiver: "tasks:follow",
3079
+ canonical: "world:subscribe",
3064
3080
  surfaces: { mcp: true },
3065
3081
  summary: "Follow one task — a task-grain subscription (a `follows` row with receiver `tasks:announce`), so its announcements reach the caller's inbox. Refused across tenants",
3066
3082
  request: () => z.object({
@@ -3078,6 +3094,7 @@ export const RECEIVERS = {
3078
3094
  }),
3079
3095
  "tasks:unfollow": receiver({
3080
3096
  receiver: "tasks:unfollow",
3097
+ canonical: "world:unsubscribe",
3081
3098
  surfaces: { mcp: true },
3082
3099
  summary: "Stop following one task — deletes exactly that task-grain subscription row, leaving tag-level subscriptions alone",
3083
3100
  request: () => z.object({
@@ -3183,6 +3200,7 @@ export const RECEIVERS = {
3183
3200
  // That is the whole IDOR rule: the subject is derived, never declared.
3184
3201
  "agents:register": receiver({
3185
3202
  receiver: "agents:register",
3203
+ canonical: "agent:enroll",
3186
3204
  surfaces: { mcp: { name: "register" } },
3187
3205
  summary: "Register as a sellable actor with capabilities. Public: call it with no credential and it mints a scoped identity (returns actorId + apiKey, compute float locked until one x402 payment).",
3188
3206
  request: () => z.object({
@@ -3214,6 +3232,7 @@ export const RECEIVERS = {
3214
3232
  }),
3215
3233
  "agents:status": receiver({
3216
3234
  receiver: "agents:status",
3235
+ canonical: "world:update-actor",
3217
3236
  summary: "Set an agent active or inactive",
3218
3237
  request: () => z.object({ uid: z.string(), status: z.string() }),
3219
3238
  response: () => AgentStatusResponseSchema,
@@ -3924,6 +3943,7 @@ export const RECEIVERS = {
3924
3943
  }),
3925
3944
  "space:join": receiver({
3926
3945
  receiver: "space:join",
3946
+ canonical: "world:request-access",
3927
3947
  summary: "Join a public Space — caller begins receiving its signals and their posts are stamped with the space tag",
3928
3948
  request: () => z.object({ space: z.string() }),
3929
3949
  response: () => z.object({
@@ -3935,6 +3955,7 @@ export const RECEIVERS = {
3935
3955
  }),
3936
3956
  "space:invite": receiver({
3937
3957
  receiver: "space:invite",
3958
+ canonical: "world:invite-member",
3938
3959
  summary: "Invite an actor to a private Space — grants membership so they can read and post; requires the caller to be a member or admin of the Space",
3939
3960
  request: () => z.object({
3940
3961
  space: z.string(),
@@ -4043,6 +4064,7 @@ export const RECEIVERS = {
4043
4064
  // frequent browse becomes a one-name re-run / a feed to follow.
4044
4065
  "lens:save": receiver({
4045
4066
  receiver: "lens:save",
4067
+ canonical: "view:create",
4046
4068
  summary: "Save a named tag-query lens for the workspace (upsert by name) — a reusable browse / followable feed",
4047
4069
  request: () => z.object({
4048
4070
  name: z.string(),
@@ -4057,6 +4079,7 @@ export const RECEIVERS = {
4057
4079
  // lens:list — the workspace's saved lenses.
4058
4080
  "lens:list": receiver({
4059
4081
  receiver: "lens:list",
4082
+ canonical: "view:list",
4060
4083
  summary: "List the workspace's saved lenses",
4061
4084
  request: () => z.object({}),
4062
4085
  response: () => z.object({ ok: z.boolean(), lenses: z.array(z.unknown()).optional(), error: z.string().optional() }),
@@ -4065,6 +4088,7 @@ export const RECEIVERS = {
4065
4088
  // lens:delete — remove a saved lens by name.
4066
4089
  "lens:delete": receiver({
4067
4090
  receiver: "lens:delete",
4091
+ canonical: "view:delete",
4068
4092
  summary: "Delete a saved lens by name",
4069
4093
  request: () => z.object({ name: z.string() }),
4070
4094
  response: () => z.object({ ok: z.boolean(), removed: z.number().optional(), error: z.string().optional() }),
@@ -4270,6 +4294,7 @@ export const RECEIVERS = {
4270
4294
  // entity:meta — editable profile fields for an entity (website, industry, location, …).
4271
4295
  "entity:meta": receiver({
4272
4296
  receiver: "entity:meta",
4297
+ canonical: "world:update-contact",
4273
4298
  summary: "Patch an entity's profile fields (website, industry, location, city, country, size, description, phone, email) — empty value clears the field",
4274
4299
  request: () => z.object({ id: z.string(), meta: z.record(z.string(), z.unknown()) }),
4275
4300
  response: () => z.object({ ok: z.boolean(), meta: z.record(z.string(), z.string()).optional(), error: z.string().optional() }),
@@ -4781,6 +4806,16 @@ export const RECEIVERS = {
4781
4806
  solana: z.string().nullable().optional(),
4782
4807
  btc: z.string().nullable().optional(),
4783
4808
  }).optional(),
4809
+ // An AGENT's addresses are written only with proof of control: the token
4810
+ // wallet:challenge issued, and one signature per address over
4811
+ // addressProofMessage (@oneie/sdk/address-proof). Public bytes only.
4812
+ challenge: z.string().optional(),
4813
+ proofs: z.object({
4814
+ sui: z.object({ publicKey: z.string().optional(), signature: z.string() }).optional(),
4815
+ evm: z.object({ publicKey: z.string().optional(), signature: z.string() }).optional(),
4816
+ solana: z.object({ publicKey: z.string().optional(), signature: z.string() }).optional(),
4817
+ btc: z.object({ publicKey: z.string().optional(), signature: z.string() }).optional(),
4818
+ }).optional(),
4784
4819
  }),
4785
4820
  response: () => z.object({
4786
4821
  ok: z.boolean().optional(),
@@ -4799,6 +4834,24 @@ export const RECEIVERS = {
4799
4834
  effect: "ask", cost: "free", reversible: false, idempotent: true, settles: "none", auth: "member",
4800
4835
  examples: [{ workspace: "acme", kind: "human", addresses: { sui: "0xabc", evm: "0xdef" } }],
4801
4836
  }),
4837
+ "wallet:challenge": receiver({
4838
+ receiver: "wallet:challenge",
4839
+ summary: "Issue a fresh, single-use challenge an agent signs to prove it holds the keys behind the addresses it registers with wallet:create",
4840
+ request: () => z.object({
4841
+ workspace: z.string().optional(),
4842
+ actor: z.string().optional(),
4843
+ }),
4844
+ response: () => z.object({
4845
+ ok: z.boolean().optional(),
4846
+ challenge: z.string().optional(),
4847
+ workspace: z.string().optional(),
4848
+ actor: z.string().optional(),
4849
+ expiresAt: z.number().optional(),
4850
+ error: z.string().optional(),
4851
+ }),
4852
+ effect: "ask", cost: "free", reversible: true, idempotent: false, settles: "none", auth: "member",
4853
+ examples: [{ workspace: "acme", actor: "acme" }],
4854
+ }),
4802
4855
  // ── wallet:rehearse — READ a TESTNET transaction back (handler: resolvers/wallet.ts) ──
4803
4856
  // The rehearsal step of the /u/one funnel: a visitor sends play money on Sui
4804
4857
  // testnet from their own derived address, and this reads the digest back so the
@@ -6190,6 +6243,7 @@ export const RECEIVERS = {
6190
6243
  // ── people / companies / conversation — handlers in resolvers/groups.ts ────────
6191
6244
  "people:create": receiver({
6192
6245
  receiver: "people:create",
6246
+ canonical: "world:create-actor",
6193
6247
  summary: "Create a person actor in the workspace",
6194
6248
  request: () => z.object({ name: z.string(), email: z.string().optional() }),
6195
6249
  response: () => z.object({ ok: z.boolean(), aid: z.string().optional(), name: z.string().optional(), error: z.string().optional() }),
@@ -6197,6 +6251,7 @@ export const RECEIVERS = {
6197
6251
  }),
6198
6252
  "companies:create": receiver({
6199
6253
  receiver: "companies:create",
6254
+ canonical: "world:create-group",
6200
6255
  summary: "Create a company group in the workspace",
6201
6256
  request: () => z.object({ name: z.string() }),
6202
6257
  response: () => z.object({ ok: z.boolean(), gid: z.string().optional(), name: z.string().optional(), error: z.string().optional() }),
@@ -7269,6 +7324,7 @@ export const RECEIVERS = {
7269
7324
  }),
7270
7325
  "segment:create": receiver({
7271
7326
  receiver: "segment:create",
7327
+ canonical: "view:create",
7272
7328
  summary: "Create an audience segment from a rule definition (SegmentDef: {all, any?})",
7273
7329
  request: () => z.object({ workspace: z.string(), name: z.string(), description: z.string().optional(), definition: z.record(z.string(), z.unknown()) }),
7274
7330
  response: () => z.object({ id: z.string() }),
@@ -7276,6 +7332,7 @@ export const RECEIVERS = {
7276
7332
  }),
7277
7333
  "segment:update": receiver({
7278
7334
  receiver: "segment:update",
7335
+ canonical: "view:update",
7279
7336
  summary: "Update an audience segment — name, description, or definition",
7280
7337
  request: () => z.object({ workspace: z.string(), id: z.string(), name: z.string().optional(), description: z.string().optional(), definition: z.record(z.string(), z.unknown()).optional() }),
7281
7338
  response: () => z.object({ ok: z.boolean() }),
@@ -7283,6 +7340,7 @@ export const RECEIVERS = {
7283
7340
  }),
7284
7341
  "segment:list": receiver({
7285
7342
  receiver: "segment:list",
7343
+ canonical: "view:list",
7286
7344
  surfaces: { mcp: true },
7287
7345
  summary: "List audience segments for a workspace",
7288
7346
  request: () => z.object({ workspace: z.string() }),
@@ -7291,6 +7349,7 @@ export const RECEIVERS = {
7291
7349
  }),
7292
7350
  "segment:get": receiver({
7293
7351
  receiver: "segment:get",
7352
+ canonical: "view:get",
7294
7353
  surfaces: { mcp: true },
7295
7354
  summary: "Get one audience segment with its rule definition",
7296
7355
  request: () => z.object({ workspace: z.string(), id: z.string() }),
@@ -7307,6 +7366,7 @@ export const RECEIVERS = {
7307
7366
  }),
7308
7367
  "segment:delete": receiver({
7309
7368
  receiver: "segment:delete",
7369
+ canonical: "view:delete",
7310
7370
  summary: "Delete an audience segment and its membership snapshot",
7311
7371
  request: () => z.object({ workspace: z.string(), id: z.string() }),
7312
7372
  response: () => z.object({ ok: z.boolean() }),
@@ -8239,6 +8299,428 @@ export const RECEIVERS = {
8239
8299
  effect: "ask", cost: "variable", idempotent: false, reversible: false, settles: "none", auth: "member",
8240
8300
  examples: [{ workspace: "one", prompt: "a wide banner of a quiet harbour at dawn, muted palette" }],
8241
8301
  }),
8302
+ // ── Declared 2026-09-30 (text/receivers.md deliverable 2): handlers that ran with no contract.
8303
+ // Requests are passthrough so the edge strips nothing a handler reads; labels copied from each body.
8304
+ "activity:announce": receiver({
8305
+ receiver: "activity:announce",
8306
+ summary: "Broadcasts a system event to matched subscribers via tag-intersection fan-out",
8307
+ request: () => z.object({ event: z.unknown().optional(), tags: z.unknown().optional() }).passthrough(),
8308
+ response: () => z.unknown(),
8309
+ effect: "ask", auth: "session", reversible: false,
8310
+ }),
8311
+ "affiliate:approve": receiver({
8312
+ receiver: "affiliate:approve",
8313
+ summary: "Approve or reject a pending affiliate join request",
8314
+ request: () => z.object({ decision: z.unknown().optional(), requestId: z.unknown().optional() }).passthrough(),
8315
+ response: () => z.unknown(),
8316
+ effect: "ask", auth: "owner", reversible: false,
8317
+ }),
8318
+ "affiliate:join-request": receiver({
8319
+ receiver: "affiliate:join-request",
8320
+ summary: "Submit a request to join an affiliate program",
8321
+ request: () => z.object({ program: z.unknown().optional(), reason: z.unknown().optional() }).passthrough(),
8322
+ response: () => z.unknown(),
8323
+ effect: "ask", auth: "session", reversible: false,
8324
+ }),
8325
+ "affiliate:ppc-payout": receiver({
8326
+ receiver: "affiliate:ppc-payout",
8327
+ summary: "Drains unpaid PPC accrual for a budget to affiliate payout addresses via pay.one.ie",
8328
+ request: () => z.object({ budgetId: z.unknown().optional(), chain: z.unknown().optional(), refToAddress: z.unknown().optional(), treasuryAddress: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8329
+ response: () => z.unknown(),
8330
+ effect: "ask", auth: "owner", reversible: false,
8331
+ }),
8332
+ "agent:draft": receiver({
8333
+ receiver: "agent:draft",
8334
+ summary: "Draft an agent's reply into a thread the caller's workspace owns, for a human to review before it is sent",
8335
+ request: () => z.object({}).passthrough(),
8336
+ response: () => z.unknown(),
8337
+ effect: "ask", auth: "session", reversible: false,
8338
+ }),
8339
+ "agent:schedule": receiver({
8340
+ receiver: "agent:schedule",
8341
+ summary: "Writes a scheduled job row for an actor to be woken later",
8342
+ request: () => z.object({ actorId: z.unknown().optional(), cron: z.unknown().optional(), instructions: z.unknown().optional(), skill: z.unknown().optional() }).passthrough(),
8343
+ response: () => z.unknown(),
8344
+ effect: "ask", auth: "owner", reversible: false,
8345
+ }),
8346
+ "calendar:schedule-meeting": receiver({
8347
+ receiver: "calendar:schedule-meeting",
8348
+ summary: "Sends a scheduling email to a contact and returns status",
8349
+ request: () => z.object({ amountLabel: z.unknown().optional(), email: z.unknown().optional(), name: z.unknown().optional(), stepName: z.unknown().optional() }).passthrough(),
8350
+ response: () => z.unknown(),
8351
+ effect: "signal", auth: "session", reversible: false,
8352
+ }),
8353
+ "campaign:brief": receiver({
8354
+ receiver: "campaign:brief",
8355
+ summary: "Creates a campaign group from a brief, fires async channels BUILD, and returns the group ID and slug",
8356
+ request: () => z.object({ brief: z.unknown().optional(), name: z.unknown().optional(), url: z.unknown().optional() }).passthrough(),
8357
+ response: () => z.unknown(),
8358
+ effect: "ask", auth: "member", reversible: false,
8359
+ }),
8360
+ "campaign:update": receiver({
8361
+ receiver: "campaign:update",
8362
+ summary: "Updates a campaign's name or a specific section's content, and returns the updated campaign info",
8363
+ request: () => z.object({ campaignId: z.unknown().optional(), content: z.unknown().optional(), name: z.unknown().optional(), stageKey: z.unknown().optional(), stageName: z.unknown().optional() }).passthrough(),
8364
+ response: () => z.unknown(),
8365
+ effect: "ask", auth: "member", reversible: false,
8366
+ }),
8367
+ "chat:delete-template": receiver({
8368
+ receiver: "chat:delete-template",
8369
+ summary: "Deletes a chat template for a chip_id in the workspace",
8370
+ request: () => z.object({ agent_id: z.unknown().optional(), chip_id: z.unknown().optional() }).passthrough(),
8371
+ response: () => z.unknown(),
8372
+ effect: "ask", auth: "session", reversible: false,
8373
+ }),
8374
+ "chat:list-templates": receiver({
8375
+ receiver: "chat:list-templates",
8376
+ summary: "Lists chat templates for the workspace, optionally filtered by agent_id",
8377
+ request: () => z.object({ agent_id: z.unknown().optional() }).passthrough(),
8378
+ response: () => z.unknown(),
8379
+ effect: "ask", auth: "session", reversible: false,
8380
+ }),
8381
+ "chat:set-template": receiver({
8382
+ receiver: "chat:set-template",
8383
+ summary: "Saves or updates a chat template for a chip_id in the workspace",
8384
+ request: () => z.object({ agent_id: z.unknown().optional(), chip_id: z.unknown().optional(), response_text: z.unknown().optional() }).passthrough(),
8385
+ response: () => z.unknown(),
8386
+ effect: "ask", auth: "session", reversible: false,
8387
+ }),
8388
+ "checkout:link": receiver({
8389
+ receiver: "checkout:link",
8390
+ summary: "Mints a shareable payment link for a product price",
8391
+ request: () => z.object({ chain: z.unknown().optional(), network: z.unknown().optional(), ppid: z.unknown().optional(), slug: z.unknown().optional() }).passthrough(),
8392
+ response: () => z.unknown(),
8393
+ effect: "ask", auth: "owner", reversible: false,
8394
+ }),
8395
+ "checkout:notify": receiver({
8396
+ receiver: "checkout:notify",
8397
+ summary: "Posts a pay link into the conversation for a sell step",
8398
+ request: () => z.object({ amountLabel: z.unknown().optional(), group: z.unknown().optional(), runId: z.unknown().optional(), stepId: z.unknown().optional(), stepName: z.unknown().optional(), url: z.unknown().optional() }).passthrough(),
8399
+ response: () => z.unknown(),
8400
+ effect: "signal", auth: "session", reversible: false,
8401
+ }),
8402
+ "content:draft": receiver({
8403
+ receiver: "content:draft",
8404
+ summary: "Generate or retrieve a cached content draft for a given workspace, function, channel, and lifecycle stage",
8405
+ request: () => z.object({ channel: z.unknown().optional(), fn: z.unknown().optional(), lifecycle: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8406
+ response: () => z.unknown(),
8407
+ effect: "ask", auth: "owner", reversible: false,
8408
+ }),
8409
+ "content:list": receiver({
8410
+ receiver: "content:list",
8411
+ summary: "List recent content drafts for a workspace, optionally filtered by function",
8412
+ request: () => z.object({ fn: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8413
+ response: () => z.unknown(),
8414
+ effect: "ask", auth: "owner", reversible: false,
8415
+ }),
8416
+ "conversation:autonomy": receiver({
8417
+ receiver: "conversation:autonomy",
8418
+ summary: "Read a conversation's autonomy level from tags, defaulting to 'auto' when missing, for the channels worker to decide send vs draft",
8419
+ request: () => z.object({ entityId: z.unknown().optional(), group: z.unknown().optional(), id: z.unknown().optional() }).passthrough(),
8420
+ response: () => z.unknown(),
8421
+ effect: "ask", auth: "session", reversible: false,
8422
+ }),
8423
+ "conversation:route": receiver({
8424
+ receiver: "conversation:route",
8425
+ summary: "Runs the 5-rung turn-taking ladder to route a conversation message to an agent",
8426
+ request: () => z.object({ authorKind: z.unknown().optional(), entityId: z.unknown().optional(), messageId: z.unknown().optional(), replyTo: z.unknown().optional(), sender: z.unknown().optional(), tags: z.unknown().optional(), text: z.unknown().optional() }).passthrough(),
8427
+ response: () => z.unknown(),
8428
+ effect: "ask", auth: "session", reversible: false,
8429
+ }),
8430
+ "credits:balance": receiver({
8431
+ receiver: "credits:balance",
8432
+ summary: "Returns the credits balance for the authenticated caller's slug",
8433
+ request: () => z.object({}).passthrough(),
8434
+ response: () => z.unknown(),
8435
+ effect: "ask", auth: "session", reversible: false,
8436
+ }),
8437
+ "email:send": receiver({
8438
+ receiver: "email:send",
8439
+ summary: "Sends a transactional email on behalf of the workspace",
8440
+ request: () => z.object({ body: z.unknown().optional(), html: z.unknown().optional(), subject: z.unknown().optional(), to: z.unknown().optional() }).passthrough(),
8441
+ response: () => z.unknown(),
8442
+ effect: "signal", auth: "session", reversible: false,
8443
+ }),
8444
+ "enrollment:demote-on-suspend": receiver({
8445
+ receiver: "enrollment:demote-on-suspend",
8446
+ summary: "Demotes all members of a workspace group on suspension",
8447
+ request: () => z.object({ workspace: z.unknown().optional() }).passthrough(),
8448
+ response: () => z.unknown(),
8449
+ effect: "ask", auth: "platform", reversible: false,
8450
+ }),
8451
+ "enrollment:restore-on-resume": receiver({
8452
+ receiver: "enrollment:restore-on-resume",
8453
+ summary: "Restores all members of a workspace group on resume with the provided plan",
8454
+ request: () => z.object({ plan: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8455
+ response: () => z.unknown(),
8456
+ effect: "ask", auth: "platform", reversible: false,
8457
+ }),
8458
+ "inbox": receiver({
8459
+ receiver: "inbox",
8460
+ summary: "Reads an actor's own message history from D1 and channels",
8461
+ request: () => z.object({ _suffix: z.unknown().optional(), limit: z.unknown().optional() }).passthrough(),
8462
+ response: () => z.unknown(),
8463
+ effect: "ask", auth: "session", reversible: false,
8464
+ }),
8465
+ "lead:capture": receiver({
8466
+ receiver: "lead:capture",
8467
+ summary: "Captures a form submit from any standalone page as a lead, resolving workspace from the page slug, and returns the leadId",
8468
+ request: () => z.object({ fields: z.unknown().optional(), page: z.unknown().optional(), visitorHash: z.unknown().optional() }).passthrough(),
8469
+ response: () => z.unknown(),
8470
+ effect: "ask", auth: "public", reversible: false,
8471
+ }),
8472
+ "learning:complete": receiver({
8473
+ receiver: "learning:complete",
8474
+ summary: "Grants credits and records pending reward when a learner completes a course stage. FINDING: falls back to data.workspace when the caller is unattested",
8475
+ request: () => z.object({ courseId: z.unknown().optional(), kind: z.unknown().optional(), stageId: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8476
+ response: () => z.unknown(),
8477
+ effect: "ask", auth: "session", reversible: false,
8478
+ }),
8479
+ "learning:dream": receiver({
8480
+ receiver: "learning:dream",
8481
+ summary: "Creates hypotheses from hardened paths and evidence edges, idempotently",
8482
+ request: () => z.object({}).passthrough(),
8483
+ response: () => z.unknown(),
8484
+ effect: "ask", auth: "platform", reversible: false,
8485
+ }),
8486
+ "learning:eval": receiver({
8487
+ receiver: "learning:eval",
8488
+ summary: "Evaluates dream-sourced hypotheses against new deal signals, updating confidence and status",
8489
+ request: () => z.object({}).passthrough(),
8490
+ response: () => z.unknown(),
8491
+ effect: "ask", auth: "platform", reversible: false,
8492
+ }),
8493
+ "lifecycle:mine": receiver({
8494
+ receiver: "lifecycle:mine",
8495
+ summary: "Read the caller's own lifecycle stage transitions",
8496
+ request: () => z.object({ lifecycle: z.unknown().optional() }).passthrough(),
8497
+ response: () => z.unknown(),
8498
+ effect: "ask", auth: "session", reversible: false,
8499
+ }),
8500
+ "market:quote": receiver({
8501
+ receiver: "market:quote",
8502
+ summary: "Prices a blended deal and optionally creates an offer deal in KV",
8503
+ request: () => z.object({ seller: z.unknown().optional(), skill: z.unknown().optional(), steps: z.unknown().optional() }).passthrough(),
8504
+ response: () => z.unknown(),
8505
+ effect: "ask", auth: "session", reversible: false,
8506
+ }),
8507
+ "market:stake": receiver({
8508
+ receiver: "market:stake",
8509
+ summary: "Bridges an on-chain stake event into routing reputation by calling mark()",
8510
+ request: () => z.object({ amountMist: z.unknown().optional(), seller: z.unknown().optional(), taskId: z.unknown().optional() }).passthrough(),
8511
+ response: () => z.unknown(),
8512
+ effect: "signal", auth: "platform", reversible: false,
8513
+ }),
8514
+ "member:invited": receiver({
8515
+ receiver: "member:invited",
8516
+ summary: "Send an invite email to a member after an invite_member action, checking authorization and generating a signed token",
8517
+ request: () => z.object({ email: z.unknown().optional(), role: z.unknown().optional(), slug: z.unknown().optional() }).passthrough(),
8518
+ response: () => z.unknown(),
8519
+ effect: "ask", auth: "owner", reversible: false,
8520
+ }),
8521
+ "memory:assert": receiver({
8522
+ receiver: "memory:assert",
8523
+ summary: "Writes a hypothesis from a statement or claim to TypeDB. FINDING: no authority check: an anonymous caller writes a hypothesis into workspace \"default\"",
8524
+ request: () => z.object({ claim: z.unknown().optional(), statement: z.unknown().optional() }).passthrough(),
8525
+ response: () => z.unknown(),
8526
+ effect: "ask", auth: "session", reversible: false,
8527
+ }),
8528
+ "memory:remember": receiver({
8529
+ receiver: "memory:remember",
8530
+ summary: "Writes an agent-asserted hypothesis linked to the workspace group",
8531
+ request: () => z.object({ actorId: z.unknown().optional(), key: z.unknown().optional(), value: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8532
+ response: () => z.unknown(),
8533
+ effect: "ask", auth: "owner", reversible: false,
8534
+ }),
8535
+ "memory:reveal": receiver({
8536
+ receiver: "memory:reveal",
8537
+ summary: "Returns all six memory types (hypotheses, paths, memberships, episodic, semantic, social, procedural) for an actor",
8538
+ request: () => z.object({ actorId: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8539
+ response: () => z.unknown(),
8540
+ effect: "ask", auth: "owner", reversible: false,
8541
+ }),
8542
+ "movers:funnel-claim": receiver({
8543
+ receiver: "movers:funnel-claim",
8544
+ summary: "Claims a sponsored preview workspace for the signed-in user, binding them as owner",
8545
+ request: () => z.object({ token: z.unknown().optional() }).passthrough(),
8546
+ response: () => z.unknown(),
8547
+ effect: "ask", auth: "session", reversible: false,
8548
+ }),
8549
+ "pages:chat-generate": receiver({
8550
+ receiver: "pages:chat-generate",
8551
+ summary: "Generates a deterministic chat pack for a page, updates the database, and returns the pack and its hash",
8552
+ request: () => z.object({ page: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8553
+ response: () => z.unknown(),
8554
+ effect: "ask", auth: "member", reversible: false,
8555
+ }),
8556
+ "payout:get": receiver({
8557
+ receiver: "payout:get",
8558
+ summary: "Retrieve a merchant's payout treasury addresses (sui/evm) and Stripe connect status after workspace ownership check",
8559
+ request: () => z.object({ workspace: z.unknown().optional() }).passthrough(),
8560
+ response: () => z.unknown(),
8561
+ effect: "ask", auth: "owner", reversible: false,
8562
+ }),
8563
+ "payout:set": receiver({
8564
+ receiver: "payout:set",
8565
+ summary: "Set a merchant's crypto payout treasury addresses (sui/evm) after workspace ownership check and human presence confirmation",
8566
+ request: () => z.object({ confirm: z.unknown().optional(), treasury_evm: z.unknown().optional(), treasury_sui: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8567
+ response: () => z.unknown(),
8568
+ effect: "ask", auth: "owner", reversible: false,
8569
+ }),
8570
+ "plugins:buy-with-credits": receiver({
8571
+ receiver: "plugins:buy-with-credits",
8572
+ summary: "Buy a plugin using workspace credits, granting entitlement synchronously",
8573
+ request: () => z.object({ name: z.unknown().optional() }).passthrough(),
8574
+ response: () => z.unknown(),
8575
+ effect: "ask", auth: "member", reversible: false,
8576
+ }),
8577
+ "plugins:buy-with-one-token": receiver({
8578
+ receiver: "plugins:buy-with-one-token",
8579
+ summary: "Buys a plugin by verifying a Sui ONE token transfer and granting entitlement with no credit mint",
8580
+ request: () => z.object({ name: z.unknown().optional(), tx: z.unknown().optional(), txDigest: z.unknown().optional() }).passthrough(),
8581
+ response: () => z.unknown(),
8582
+ effect: "ask", auth: "member", reversible: false,
8583
+ }),
8584
+ "plugins:credit-balance": receiver({
8585
+ receiver: "plugins:credit-balance",
8586
+ summary: "Returns the spendable credit balance and funding slug for the caller's workspace",
8587
+ request: () => z.object({}).passthrough(),
8588
+ response: () => z.unknown(),
8589
+ effect: "ask", auth: "member", reversible: false,
8590
+ }),
8591
+ "promise:get": receiver({
8592
+ receiver: "promise:get",
8593
+ summary: "Read a promise's terms and state publicly by slug",
8594
+ request: () => z.object({ slug: z.unknown().optional() }).passthrough(),
8595
+ response: () => z.unknown(),
8596
+ effect: "ask", auth: "public", reversible: false,
8597
+ }),
8598
+ "remote:resolve": receiver({
8599
+ receiver: "remote:resolve",
8600
+ summary: "Resume a run parked at a remote step \u2014 the remote system's attested answer wakes the run (sibling of human:resolve)",
8601
+ request: () => z.object({}).passthrough(),
8602
+ response: () => z.unknown(),
8603
+ effect: "ask", auth: "manage_workflows", reversible: false,
8604
+ }),
8605
+ "reply:discord": receiver({
8606
+ receiver: "reply:discord",
8607
+ summary: "Round-trips a human inbox reply back to the originating Discord surface",
8608
+ request: () => z.object({ entityId: z.unknown().optional(), text: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8609
+ response: () => z.unknown(),
8610
+ effect: "signal", auth: "owner", reversible: false,
8611
+ }),
8612
+ "reply:telegram": receiver({
8613
+ receiver: "reply:telegram",
8614
+ summary: "Round-trips a human inbox reply back to the originating Telegram surface",
8615
+ request: () => z.object({ entityId: z.unknown().optional(), text: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8616
+ response: () => z.unknown(),
8617
+ effect: "signal", auth: "owner", reversible: false,
8618
+ }),
8619
+ "reply:web": receiver({
8620
+ receiver: "reply:web",
8621
+ summary: "Round-trips a human inbox reply back to the originating web surface",
8622
+ request: () => z.object({ entityId: z.unknown().optional(), text: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8623
+ response: () => z.unknown(),
8624
+ effect: "signal", auth: "owner", reversible: false,
8625
+ }),
8626
+ "sdk:init": receiver({
8627
+ receiver: "sdk:init",
8628
+ summary: "Resolves the developer's workspace slug from actor membership and records the sdk.init lifecycle event",
8629
+ request: () => z.object({}).passthrough(),
8630
+ response: () => z.unknown(),
8631
+ effect: "ask", auth: "public", reversible: false,
8632
+ }),
8633
+ "social:refine": receiver({
8634
+ receiver: "social:refine",
8635
+ summary: "Adapt a master post into per-platform draft variants via refine core",
8636
+ request: () => z.object({ postId: z.unknown().optional(), targets: z.unknown().optional() }).passthrough(),
8637
+ response: () => z.unknown(),
8638
+ effect: "ask", auth: "update_group", reversible: false,
8639
+ }),
8640
+ "ssr:calibrate": receiver({
8641
+ receiver: "ssr:calibrate",
8642
+ summary: "Compare strategy PMFs against a human fixture, mark/warn paths, write hypothesis if KS-sim >= 0.85. FINDING: falls back to data.slug when the caller is unattested",
8643
+ request: () => z.object({ concept: z.unknown().optional(), human_pmf: z.unknown().optional(), slug: z.unknown().optional(), strategies: z.unknown().optional() }).passthrough(),
8644
+ response: () => z.unknown(),
8645
+ effect: "ask", auth: "session", reversible: false,
8646
+ }),
8647
+ "ssr:rate": receiver({
8648
+ receiver: "ssr:rate",
8649
+ summary: "Project text onto a PMF using embedding, without LLM turn (test seam + re-rating)",
8650
+ request: () => z.object({ skill_body: z.unknown().optional(), text: z.unknown().optional() }).passthrough(),
8651
+ response: () => z.unknown(),
8652
+ effect: "ask", auth: "public", reversible: false,
8653
+ }),
8654
+ "storefront:balance": receiver({
8655
+ receiver: "storefront:balance",
8656
+ summary: "Fetches the seller's account balance for the workspace",
8657
+ request: () => z.object({ slug: z.unknown().optional() }).passthrough(),
8658
+ response: () => z.unknown(),
8659
+ effect: "ask", auth: "owner", reversible: false,
8660
+ }),
8661
+ "subscriptions:list": receiver({
8662
+ receiver: "subscriptions:list",
8663
+ summary: "Returns all subscriptions for the attested caller",
8664
+ request: () => z.object({}).passthrough(),
8665
+ response: () => z.unknown(),
8666
+ effect: "ask", auth: "session", reversible: false,
8667
+ }),
8668
+ "subscriptions:presence": receiver({
8669
+ receiver: "subscriptions:presence",
8670
+ summary: "Returns agents and workflows following a workspace's view tags",
8671
+ request: () => z.object({ slug: z.unknown().optional(), tags: z.unknown().optional() }).passthrough(),
8672
+ response: () => z.unknown(),
8673
+ effect: "ask", auth: "member", reversible: false,
8674
+ }),
8675
+ "subscriptions:unregister": receiver({
8676
+ receiver: "subscriptions:unregister",
8677
+ summary: "Removes a subscription or all subscriptions for the attested caller",
8678
+ request: () => z.object({ receiver: z.unknown().optional() }).passthrough(),
8679
+ response: () => z.unknown(),
8680
+ effect: "ask", auth: "session", reversible: false,
8681
+ }),
8682
+ "view:preview": receiver({
8683
+ receiver: "view:preview",
8684
+ summary: "Live-preview a view query without saving it, returning rows and metadata",
8685
+ request: () => z.object({ query: z.unknown().optional(), slug: z.unknown().optional() }).passthrough(),
8686
+ response: () => z.unknown(),
8687
+ effect: "ask", auth: "member", reversible: false,
8688
+ }),
8689
+ "workflow:resumed-notify": receiver({
8690
+ receiver: "workflow:resumed-notify",
8691
+ summary: "Posts a short status line into the conversation when a delayed workflow resumes",
8692
+ request: () => z.object({ group: z.unknown().optional(), runId: z.unknown().optional(), stepId: z.unknown().optional(), stepName: z.unknown().optional(), workflowName: z.unknown().optional() }).passthrough(),
8693
+ response: () => z.unknown(),
8694
+ effect: "signal", auth: "session", reversible: false,
8695
+ }),
8696
+ "world:create-client": receiver({
8697
+ receiver: "world:create-client",
8698
+ summary: "Provision a client workspace under a parent, with auth check on parentSlug",
8699
+ request: () => z.object({ handle: z.unknown().optional(), name: z.unknown().optional(), parentSlug: z.unknown().optional(), plan: z.unknown().optional(), slug: z.unknown().optional() }).passthrough(),
8700
+ response: () => z.unknown(),
8701
+ effect: "ask", auth: "owner", reversible: false,
8702
+ }),
8703
+ "world:do-event": receiver({
8704
+ receiver: "world:do-event",
8705
+ summary: "Emit a do-event (build cycle phase) to a workspace's build inbox",
8706
+ request: () => z.object({ axis: z.unknown().optional(), composite: z.unknown().optional(), cycle: z.unknown().optional(), deliverable: z.unknown().optional(), model: z.unknown().optional(), shape: z.unknown().optional(), slug: z.unknown().optional(), success: z.unknown().optional(), type: z.unknown().optional(), wave: z.unknown().optional(), worktags: z.unknown().optional() }).passthrough(),
8707
+ response: () => z.unknown(),
8708
+ effect: "ask", auth: "session", reversible: false,
8709
+ }),
8710
+ "world:set-favicon": receiver({
8711
+ receiver: "world:set-favicon",
8712
+ summary: "Fetch a favicon URL and store as workspace logo with SSRF guard, auth on slug",
8713
+ request: () => z.object({ slug: z.unknown().optional(), url: z.unknown().optional(), workspace: z.unknown().optional() }).passthrough(),
8714
+ response: () => z.unknown(),
8715
+ effect: "ask", auth: "owner", reversible: false,
8716
+ }),
8717
+ "world:sync-subscriptions": receiver({
8718
+ receiver: "world:sync-subscriptions",
8719
+ summary: "Backfill subscription records for all agents in a workspace's R2 content",
8720
+ request: () => z.object({ workspace: z.unknown().optional() }).passthrough(),
8721
+ response: () => z.unknown(),
8722
+ effect: "ask", auth: "owner", reversible: false,
8723
+ }),
8242
8724
  };
8243
8725
  /**
8244
8726
  * RECIPES — the four agent journeys as typed, ordered receiver sequences (C6).