@ra3orblade/swarm 0.8.0 → 0.9.0

package/dist/swarm-hook.js

@@ -77,7 +77,9 @@ var AUDIT_TYPES = new Set([
   "permission.resolved",
   "incident.opened",
   "incident.acked",
-  "run.result"
+  "run.result",
+  "workflow.started",
+  "workflow.finished"
 ]);
 var AUDIT_TYPES_SQL = [...AUDIT_TYPES].map((t) => `'${t}'`).join(", ");
 // packages/core/src/budget.ts

package/dist/swarm-mcp.js

@@ -19952,15 +19952,44 @@ ${lines.join(`
     return ok(`asked as question #${r.question?.id}. A human will see it on the dashboard; the answer arrives as [swarm] context on a later tool call, or via swarm_inbox. Continue with what doesn't depend on it, or stop and say you're waiting.`, r.question);
   });
   server.registerTool("swarm_inbox", {
-    title: "Answers waiting for you",
-    description: "Answers a human has given to your swarm_ask questions that you haven't received yet.",
+    title: "What's waiting for you",
+    description: "Answers to your swarm_ask questions and messages other agents or the human sent you (swarm_send) that you haven't received yet.",
     inputSchema: {}
   }, async () => {
     const qs = await api2(`/v1/inbox?session=${encodeURIComponent(SESSION ?? "")}`);
-    if (!qs.length)
-      return ok("no new answers", []);
-    return ok(qs.map((q) => `#${q.id} "${q.text}" \u2192 ${q.answeredBy ?? "a human"}: ${q.answer}`).join(`
-`), qs);
+    const ms = await api2(`/v1/messages/inbox?session=${encodeURIComponent(SESSION ?? "")}`);
+    if (!qs.length && !ms.length)
+      return ok("nothing new", []);
+    const lines = [
+      ...qs.map((q) => `answer #${q.id} "${q.text}" \u2192 ${q.answeredBy ?? "a human"}: ${q.answer}`),
+      ...ms.map((m) => `message #${m.id} from ${m.from ?? "unknown"}${m.task ? ` (re ${m.task})` : ""}: ${m.text}`)
+    ];
+    return ok(lines.join(`
+`), { answers: qs, messages: ms });
+  });
+  server.registerTool("swarm_send", {
+    title: "Message another agent (or the human)",
+    description: `Send a short message to another session (session id), to whoever holds a task (task id), or to "lead" \u2014 the human's interactive session in this project. Delivery is on their next tool call (or immediately to a spawned run); replies come back via swarm_inbox.`,
+    inputSchema: {
+      to: exports_external.string().describe('session id, task id, or "lead"'),
+      text: exports_external.string().max(4000)
+    }
+  }, async ({ to, text }) => {
+    const pid = await projectId();
+    const r = await api2("/v1/messages", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        projectId: pid,
+        to,
+        text,
+        sessionId: SESSION,
+        from: OWNER === "agent" && SESSION ? `agent ${SESSION.slice(0, 8)}` : OWNER
+      })
+    });
+    if (!r.ok)
+      return fail(r.error ?? "send failed");
+    return ok(`sent #${r.message?.id}${r.message?.sessionId ? "" : " (queued until the target appears)"}`, r.message);
   });
   server.registerTool("swarm_dispatch", {
     title: "Dispatch tasks to spawned agents",

package/dist/swarm.js

@@ -2,7 +2,7 @@
 // @bun
 
 // packages/cli/src/bin.ts
-import { resolve as resolve3 } from "path";
+import { join as join5, resolve as resolve3 } from "path";
 
 // packages/client/src/daemon.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -189,7 +189,9 @@ var AUDIT_TYPES = new Set([
   "permission.resolved",
   "incident.opened",
   "incident.acked",
-  "run.result"
+  "run.result",
+  "workflow.started",
+  "workflow.finished"
 ]);
 var AUDIT_TYPES_SQL = [...AUDIT_TYPES].map((t) => `'${t}'`).join(", ");
 var DEFAULT_PRIVACY = {
@@ -202,14 +204,65 @@ var BUDGET_ASK_TOOLS = new Set(["Bash", "Edit", "Write", "MultiEdit", "NotebookE
 // packages/core/src/config.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { join as join2 } from "path";
+
+// packages/core/src/workflows.ts
+var NAME_RE = /^[a-z0-9][a-z0-9_.-]{0,39}$/i;
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function parseWorkflows(raw) {
+  const out = {};
+  if (!Array.isArray(raw))
+    return out;
+  for (const w of raw) {
+    if (!isRecord(w) || typeof w.name !== "string" || !NAME_RE.test(w.name))
+      continue;
+    if (!Array.isArray(w.steps) || !w.steps.length)
+      continue;
+    const prompts = isRecord(w.prompts) ? w.prompts : {};
+    const steps = [];
+    for (const s of w.steps) {
+      if (typeof s !== "string" || !s.trim()) {
+        steps.length = 0;
+        break;
+      }
+      const t = s.trim();
+      if (t === "pr")
+        steps.push({ kind: "pr" });
+      else if (t.startsWith("gate:")) {
+        const gate = t.slice(5);
+        if (!NAME_RE.test(gate)) {
+          steps.length = 0;
+          break;
+        }
+        steps.push({ kind: "gate", gate });
+      } else if (NAME_RE.test(t)) {
+        const p = prompts[t];
+        steps.push({
+          kind: "run",
+          name: t,
+          prompt: typeof p === "string" && p.trim() ? p.trim() : null
+        });
+      } else {
+        steps.length = 0;
+        break;
+      }
+    }
+    if (steps.length)
+      out[w.name] = { name: w.name, steps };
+  }
+  return out;
+}
+
+// packages/core/src/config.ts
 var DEFAULT_GATE_TIMEOUT_S = 900;
 var AUTO_MODES = ["session-end", "stop", "off"];
 function parseGateDefs(gates) {
   const out = {};
-  if (!isRecord(gates))
+  if (!isRecord2(gates))
     return out;
   for (const [name, v] of Object.entries(gates)) {
-    if (!isRecord(v))
+    if (!isRecord2(v))
       continue;
     const builtin = v.builtin === "review" ? "review" : null;
     const cmd = typeof v.cmd === "string" ? v.cmd.trim() : "";
@@ -232,6 +285,7 @@ var DEFAULT_CONFIG = {
   daemon: { port: 7777, auth: "loopback-optional" },
   tasks: { source: null, labels: [], team: null },
   gates: { required: [], auto: "session-end", defs: {} },
+  workflows: {},
   budget: { daily: null, weekly: null, warn_at: 0.8, on_exceed: "warn" },
   events: { retain_days: 30 },
   audit: { retain_days: 0 },
@@ -256,11 +310,11 @@ var DEFAULT_CONFIG = {
   }
 };
 var MODES = ["ask", "deny", "off"];
-function isRecord(v) {
+function isRecord2(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 function merge(a, b) {
-  if (!isRecord(a) || !isRecord(b))
+  if (!isRecord2(a) || !isRecord2(b))
     return b === undefined ? a : b;
   const out = { ...a };
   for (const [k, v] of Object.entries(b))
@@ -327,6 +381,7 @@ function validate(c) {
       warn_at: Number.isFinite(warnAt) && warnAt > 0 && warnAt < 1 ? warnAt : 0.8,
       on_exceed: b.on_exceed === "ask" || b.on_exceed === "stop" ? b.on_exceed : "warn"
     },
+    workflows: parseWorkflows(c.workflows),
     events: {
       retain_days: days(c.events?.retain_days, 30)
     },
@@ -366,7 +421,7 @@ function validate(c) {
   };
 }
 function leafPaths(v, prefix = "") {
-  if (!isRecord(v))
+  if (!isRecord2(v))
     return prefix ? [prefix] : [];
   const keys = Object.keys(v);
   if (keys.length === 0)
@@ -376,7 +431,7 @@ function leafPaths(v, prefix = "") {
 function getPath(v, path) {
   let cur = v;
   for (const seg of path.split(".")) {
-    if (!isRecord(cur))
+    if (!isRecord2(cur))
       return;
     cur = cur[seg];
   }
@@ -386,7 +441,7 @@ function setPath(obj, path, value) {
   const segs = path.split(".");
   let cur = obj;
   for (const seg of segs.slice(0, -1)) {
-    if (!isRecord(cur[seg]))
+    if (!isRecord2(cur[seg]))
       cur[seg] = {};
     cur = cur[seg];
   }
@@ -851,6 +906,10 @@ var help = `swarm \u2014 control plane for AI-agent development
   stats [-p] [--json]     all-time totals, streak, records (the dashboard's Stats view)
   search <query\u2026> [-p] [--kind handoff|incident|gate|session] [--json]   memory over Swarm's own data (handoffs, incidents, gates, what sessions said)
   rules dryrun [--set rule=mode,\u2026] [--limit n] [--json]   replay this repo's history under rule modes; shows what would fire + flaky signals
+  workflow <name> <task> | workflow ls | workflow stop <task>   run a [[workflows]] sequence on a task (M7.8)
+  msg send <to> <text\u2026> [-p]    message a session id, a task's holder, or "lead" (M7.6)
+  msg ls [-p] [--json]          recent messages
+  demo                    open a seeded demo dashboard (own home + port; your real data is untouched)
   audit export [--since 30d|ISO] [-p] [--type claim.acquired] [--format jsonl|csv|json] [--limit n]   the audit log (ledger changes + decisions, with actor) to stdout
 
   install | uninstall     add/remove Swarm hooks in ~/.claude/settings.json
@@ -1660,6 +1719,95 @@ ${flag("--body") ?? d.body}`);
          session ${h.sessionId}` : ""}`);
       break;
     }
+    case "workflow": {
+      await ensureDaemon({ quiet: true });
+      const proj = await api("/v1/projects", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ path: resolve3(".") })
+      });
+      if (rest[0] === "ls" || !rest[0]) {
+        const w = await api(`/v1/workflows?project=${proj.id}`);
+        const names = Object.keys(w.defs);
+        console.log(names.length ? `declared: ${names.join(", ")}` : "no [[workflows]] declared in .swarm.toml");
+        for (const r2 of w.runs.slice(0, 20))
+          console.log(`#${r2.id} ${r2.task} \xB7 ${r2.workflow} \xB7 ${r2.state === "running" ? `${r2.stepLabel} (${r2.step + 1}/${r2.steps.length})` : r2.state}${r2.detail ? ` \u2014 ${r2.detail.slice(0, 80)}` : ""}`);
+        break;
+      }
+      if (rest[0] === "stop") {
+        const task2 = rest[1];
+        if (!task2)
+          throw new Error("usage: swarm workflow stop <task>");
+        const r2 = await api("/v1/workflows/stop", {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ projectId: proj.id, task: task2 })
+        });
+        if (!r2.ok)
+          throw new Error(r2.error ?? "stop failed");
+        console.log(`stopped the workflow on ${task2}`);
+        break;
+      }
+      const [name, task] = rest;
+      if (!name || !task)
+        throw new Error("usage: swarm workflow <name> <task>");
+      const r = await api("/v1/workflows", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          projectId: proj.id,
+          task,
+          workflow: name,
+          owner: process.env.USER ?? "cli"
+        })
+      });
+      if (!r.ok)
+        throw new Error(r.error ?? "workflow failed to start");
+      console.log(`workflow ${name} started on ${task} (#${r.id}) \u2014 watch the Board`);
+      break;
+    }
+    case "msg": {
+      await ensureDaemon({ quiet: true });
+      const proj = await api("/v1/projects", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ path: resolve3(".") })
+      });
+      if (rest[0] === "send") {
+        const [to, ...words] = rest.slice(1).filter((a) => a !== "-p");
+        if (!to || !words.length)
+          throw new Error('usage: swarm msg send <session|task|"lead"> <text\u2026>');
+        const r = await api("/v1/messages", {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            projectId: proj.id,
+            to,
+            text: words.join(" "),
+            from: process.env.USER ?? "me"
+          })
+        });
+        if (!r.ok)
+          throw new Error(r.error ?? "send failed");
+        console.log(`sent #${r.message?.id}${r.message?.sessionId ? "" : " (queued until the target appears)"}`);
+        break;
+      }
+      if (rest[0] === "ls" || !rest[0]) {
+        const ms = await api(`/v1/messages?project=${proj.id}&limit=50`);
+        if (rest.includes("--json")) {
+          console.log(JSON.stringify(ms, null, 2));
+          break;
+        }
+        if (!ms.length) {
+          console.log("no messages");
+          break;
+        }
+        for (const m of ms)
+          console.log(`#${m.id} ${m.deliveredAt ? "\u2713" : "\xB7"} ${m.from ?? "?"} \u2192 ${m.task ?? m.toKind}: ${m.text.slice(0, 100)}`);
+        break;
+      }
+      throw new Error("usage: swarm msg send <to> <text\u2026> | swarm msg ls");
+    }
     case "audit": {
       if (rest[0] !== "export")
         throw new Error("usage: swarm audit export [--since 30d] [-p] [--type t] [--format jsonl|csv|json] [--limit n]");
@@ -2004,6 +2152,33 @@ would have fired (newest last):`);
       }
       break;
     }
+    case "demo": {
+      const home = join5(swarmHome(), "demo");
+      const port = "7799";
+      const [cmd2, ...args] = daemonCommand();
+      if (!cmd2)
+        throw new Error("could not resolve the daemon command");
+      const env = { ...process.env, SWARM_HOME: home, SWARM_PORT: port, SWARM_DEMO: "1" };
+      const up = await authedFetch(`http://127.0.0.1:${port}/v1/health`).then((r) => r.ok).catch(() => false);
+      if (!up) {
+        Bun.spawn([cmd2, ...args], {
+          stdin: "ignore",
+          stdout: "ignore",
+          stderr: "ignore",
+          env
+        }).unref();
+        for (let i = 0;i < 40; i++) {
+          await new Promise((r) => setTimeout(r, 250));
+          if (await authedFetch(`http://127.0.0.1:${port}/v1/health`).then((r) => r.ok).catch(() => false))
+            break;
+        }
+      }
+      const tok = readToken(home);
+      const url = `http://127.0.0.1:${port}/${tok ? `?token=${tok}` : ""}`;
+      Bun.spawn(["open", url]).unref?.();
+      console.log(`demo dashboard: http://127.0.0.1:${port} (home ${home} \u2014 delete it to reset)`);
+      break;
+    }
     case "ui": {
       const base = await ensureDaemon();
       const tok = readToken();