@oneie/sdk 0.14.6 → 0.14.8

package/dist/receivers.js

@@ -518,7 +518,7 @@ export const RECEIVERS = {
     }),
     "world:in": receiver({
         receiver: "world:in",
-        summary: "The one front door: a message enters the world inbox, a guard quarantines toxic content, the router classifies the destination (private/fanout/public), and delivers into each destined workspace. Opt-in delivery — a workspace receives only tags it subscribed.",
+        summary: "The one front door: a message enters the world inbox, a guard quarantines toxic content, the router classifies the destination (private/fanout/public), and delivers into each destined workspace. Delivery is opt-in (a workspace receives only tags it subscribed) with one exception: a caller may always direct to a workspace it owns. A directed message that can't be delivered fails closed (ok:false) — it never falls back to the public feed.",
         request: z.object({
             content: z.string().min(1),
             tags: z.array(z.string()).optional(),
@@ -668,28 +668,39 @@ export const RECEIVERS = {
     }),
     "world:announce": receiver({
         receiver: "world:announce",
-        summary: "Broadcast a tagged signal; the world fans it to every subscriber whose follow-tags intersect",
+        summary: "Broadcast a tagged signal; the world fans it to every subscriber whose follow-tags intersect. reply:true also invokes up to 5 of the matched actors and returns their answers inline (repliesTruncated:true if more matched)",
         request: z.object({
             tags: z.array(z.string()),
             content: z.string().optional(),
+            limit: z.number().optional(),
+            reply: z.boolean().optional(),
             board: z.literal("marketplace").optional(),
             slug: z.string().optional(),
             workspace: z.string().optional(),
+        }).catchall(z.unknown()), // extra keys = the message payload — carried through to every fanned-out actor, never stripped
+        response: z.object({
+            ok: z.boolean(),
+            matched: z.number().optional(),
+            actors: z.array(z.string()).optional(),
+            replies: z.array(z.object({
+                actorId: z.string(), ok: z.boolean(), text: z.string().optional(), error: z.string().optional(),
+            })).optional(),
+            repliesTruncated: z.boolean().optional(),
         }),
-        response: z.object({ ok: z.boolean(), matched: z.number().optional(), actors: z.array(z.string()).optional() }),
         effect: "ask",
     }),
     "world": receiver({
         receiver: "world",
-        summary: "THE door — say it once, the world decides. Routes a tagged signal via the ladder (learned path → staked subscribers → CEO); fan:'all' broadcasts to every matching subscriber instead. Address form world:<tag-expr> carries tags in the receiver",
+        summary: "THE door — say it once, the world decides. Routes a tagged signal via the ladder (learned path → staked subscribers → CEO); fan:'all' broadcasts to every matching subscriber instead. Address form world:<tag-expr> carries tags in the receiver. reply:true also invokes the resolved actor and returns its answer inline (single-actor routes only, not fan:'all')",
         request: z.object({
             tags: z.array(z.string()).optional(),
             fan: z.enum(["one", "all"]).optional(),
             deliver: z.boolean().optional(),
+            reply: z.boolean().optional(),
             board: z.literal("marketplace").optional(),
             slug: z.string().optional(),
             workspace: z.string().optional(),
-        }),
+        }).catchall(z.unknown()), // extra keys = the message payload (e.g. content) — carried through to the resolved actor, never stripped
         response: z.object({
             ok: z.boolean(),
             routed: z.enum(["learned", "staked", "explore", "ceo"]).optional(),
@@ -697,6 +708,7 @@ export const RECEIVERS = {
             matched: z.number().optional(),
             actors: z.array(z.string()).optional(),
             tags: z.array(z.string()).optional(),
+            reply: z.object({ ok: z.boolean(), text: z.string().optional(), error: z.string().optional() }).optional(),
         }),
         effect: "ask",
     }),
@@ -722,19 +734,21 @@ export const RECEIVERS = {
     }),
     "world:route": receiver({
         receiver: "world:route",
-        summary: "Route a tagged signal to THE handler via the ladder: learned tag-node path (follow_route) → staked subscribers (reputation-ranked) → CEO standing workflow; marks the delivery path so the next route is smarter",
+        summary: "Route a tagged signal to THE handler via the ladder: learned tag-node path (follow_route) → staked subscribers (reputation-ranked) → CEO standing workflow; marks the delivery path so the next route is smarter. reply:true also invokes the resolved actor and returns its answer inline",
         request: z.object({
             tags: z.array(z.string()),
             deliver: z.boolean().optional(),
+            reply: z.boolean().optional(),
             board: z.literal("marketplace").optional(),
             slug: z.string().optional(),
             workspace: z.string().optional(),
-        }),
+        }).catchall(z.unknown()), // extra keys = the message payload (e.g. content) — carried through to the resolved actor, never stripped
         response: z.object({
             ok: z.boolean(),
             routed: z.enum(["learned", "staked", "explore", "ceo"]).optional(),
             actor: z.string().optional(),
             tags: z.array(z.string()).optional(),
+            reply: z.object({ ok: z.boolean(), text: z.string().optional(), error: z.string().optional() }).optional(),
         }),
         effect: "ask",
     }),
@@ -766,6 +780,22 @@ export const RECEIVERS = {
         }),
         effect: "ask", idempotent: true,
     }),
+    "tasks:create": receiver({
+        receiver: "tasks:create",
+        summary: "Write one open task to the substrate and announce it by its tags in the same act — the quick-add entry point",
+        request: z.object({
+            title: z.string(),
+            tags: z.array(z.string()).optional(),
+            assignee: z.string().optional(),
+            // The viewed /u/<slug> workspace to file the task under. Honored only when the
+            // caller is authorized for it (attested staff or owner-tree control); otherwise
+            // the resolver falls back to the caller's own slug. Reconciles the create tag
+            // with the /api/things read filter so a created task survives reload.
+            workspace: z.string().optional(),
+        }),
+        response: z.object({ ok: z.boolean(), tid: z.string().optional(), tags: z.array(z.string()).optional() }),
+        effect: "ask", idempotent: false,
+    }),
     // ── agents (TRADE / lifecycle) ──
     "agents:register": receiver({
         receiver: "agents:register",
@@ -1893,7 +1923,14 @@ export const RECEIVERS = {
         response: z.object({ ok: z.boolean(), threadId: z.string().optional(), error: z.string().optional() }),
         effect: "ask", cost: "free", reversible: false, idempotent: false, auth: "member",
     }),
-    // ── billing — handlers in resolvers/market.ts ──────────────────────────────────
+    "pages:view": receiver({
+        receiver: "pages:view",
+        summary: "Read one published page's Puck render data by workspace + page slug (public) — the read an external site's page-editor plugin renders through; drafts are invisible (see pages:get for the member-scoped editor read)",
+        request: z.object({ slug: z.string(), page: z.string() }),
+        response: z.object({ ok: z.boolean(), slug: z.string().optional(), title: z.string().optional(), data: z.unknown().optional(), url: z.string().optional(), error: z.string().optional() }),
+        effect: "ask", cost: "free", reversible: true, idempotent: true, auth: "public",
+    }),
+    // ──billing — handlers in resolvers/market.ts ──────────────────────────────────
     "billing:plan": receiver({
         receiver: "billing:plan",
         summary: "Change a workspace's plan — returns a checkout URL to complete the upgrade",
@@ -2294,13 +2331,21 @@ export const RECEIVERS = {
     "skills:list": receiver({
         receiver: "skills:list",
         summary: "List the caller's workspace skill catalog (R2) — powers the canvas SkillPicker",
-        request: z.object({}),
+        request: z.object({ name: z.string().optional() }),
         response: z.object({
-            skills: z.array(z.object({ name: z.string(), size: z.number(), sealed: z.boolean().optional() })),
+            skills: z.array(z.object({ name: z.string(), size: z.number(), sealed: z.boolean().optional(), description: z.string().optional(), inputs: z.array(z.object({ name: z.string(), label: z.string(), required: z.boolean().optional() })).optional() })),
         }),
         effect: "ask", cost: "free", idempotent: true, simulatable: false, auth: "view_workflows",
         examples: [{}],
     }),
+    "skill:save": receiver({
+        receiver: "skill:save",
+        summary: "Write a skill body into a workspace's R2 catalog — the store skill:run/skills:list read; explicit-slug, ownership-walk authorized (mirrors world:publish-agent)",
+        request: z.object({ slug: z.string(), name: z.string(), content: z.string() }),
+        response: z.object({ ok: z.boolean(), name: z.string(), bytes: z.number() }),
+        effect: "ask", auth: "update_group", idempotent: true,
+        examples: [{ slug: "elitemoversca", name: "quote-estimate", content: "---\nname: quote-estimate\n---\n…" }],
+    }),
     "skill:run": receiver({
         receiver: "skill:run",
         summary: "Run a workspace skill — loads its body from R2, runs one bounded turn via channels, returns { text }",