@ra3orblade/swarm 0.8.0 → 0.9.0

package/dist/swarmd.js

@@ -3,9 +3,33 @@
 
 // packages/client/src/daemon.ts
 import { randomBytes } from "crypto";
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
+
+// packages/client/src/bins.ts
+import { existsSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+var SRC = {
+  swarm: "cli",
+  swarmd: "daemon",
+  "swarm-hook": "hook",
+  "swarm-mcp": "mcp"
+};
+function resolveBin(name, from = import.meta.url) {
+  const here = dirname(fileURLToPath(from));
+  const candidates = [
+    resolve(here, `../../${SRC[name]}/src/bin.ts`),
+    resolve(here, `${name}.js`)
+  ];
+  for (const c of candidates)
+    if (existsSync(c))
+      return ["bun", c];
+  return [name];
+}
+
+// packages/client/src/daemon.ts
 function swarmHome() {
   return process.env.SWARM_HOME ?? join(homedir(), ".swarm");
 }
@@ -41,6 +65,9 @@ function ensureToken(home = swarmHome()) {
 function clearDaemonInfo() {
   rmSync(infoFile(), { force: true });
 }
+function daemonCommand() {
+  return resolveBin("swarmd");
+}
 // packages/core/src/actor.ts
 var HUMAN_ALIASES = new Set(["cli", "dashboard", "me", "desktop", "human"]);
 var DAEMON_ALIASES = new Set(["daemon", "system", "swarm"]);
@@ -218,6 +245,79 @@ function parseCodexRollout(chunk) {
   return out;
 }
 
+// packages/core/src/adapters/gemini/chats.ts
+function partText(content) {
+  if (typeof content === "string")
+    return content.slice(0, 400);
+  const parts = Array.isArray(content) ? content : [content];
+  let out = "";
+  for (const p of parts) {
+    if (typeof p === "string")
+      out += p;
+    else if (p && typeof p === "object" && typeof p.text === "string")
+      out += p.text;
+    if (out.length >= 400)
+      break;
+  }
+  return out.slice(0, 400);
+}
+function parseGeminiChat(chunk) {
+  const out = { turns: [], sessionId: null, model: null, cwd: null, title: null };
+  let subagent = false;
+  for (const raw of chunk.split(`
+`)) {
+    if (!raw.trim())
+      continue;
+    let d = null;
+    try {
+      d = JSON.parse(raw);
+    } catch {
+      continue;
+    }
+    if (d.$set) {
+      const set = d.$set;
+      if (typeof set.summary === "string")
+        out.title = set.summary;
+      continue;
+    }
+    if (d.sessionId && d.projectHash !== undefined) {
+      out.sessionId = d.sessionId;
+      if (Array.isArray(d.directories) && typeof d.directories[0] === "string")
+        out.cwd = d.directories[0];
+      if (typeof d.summary === "string")
+        out.title = d.summary;
+      if (d.kind === "subagent")
+        subagent = true;
+      continue;
+    }
+    if (d.type !== "gemini" || !d.id)
+      continue;
+    const t = d.tokens ?? {};
+    const cacheRead = t.cached ?? 0;
+    const turn = {
+      id: `${out.sessionId ?? "gemini"}-${d.id}`,
+      ts: d.timestamp ?? new Date(0).toISOString(),
+      model: d.model ?? out.model ?? "gemini-2.5-pro",
+      usage: {
+        input: Math.max(0, (t.input ?? 0) - cacheRead),
+        output: (t.output ?? 0) + (t.tool ?? 0),
+        cacheWrite: 0,
+        cacheWrite1h: 0,
+        cacheRead,
+        thinking: t.thoughts ?? 0
+      },
+      text: partText(d.content),
+      tools: (d.toolCalls ?? []).map((c) => c.name ?? c.displayName ?? c.tool ?? "").filter(Boolean),
+      effort: null,
+      sidechain: subagent
+    };
+    if (d.model)
+      out.model = d.model;
+    out.turns.push(turn);
+  }
+  return out;
+}
+
 // packages/core/src/adapters/grok/updates.ts
 function parseGrokUpdates(chunk) {
   const out = { turns: [], sessionId: null, model: null, cwd: null, title: null };
@@ -421,7 +521,9 @@ var AUDIT_TYPES = new Set([
   "permission.resolved",
   "incident.opened",
   "incident.acked",
-  "run.result"
+  "run.result",
+  "workflow.started",
+  "workflow.finished"
 ]);
 var isAuditType = (t) => AUDIT_TYPES.has(t);
 var AUDIT_TYPES_SQL = [...AUDIT_TYPES].map((t) => `'${t}'`).join(", ");
@@ -594,16 +696,82 @@ function runProfile(name) {
   return RUN_PROFILES[name] ?? null;
 }
 // packages/core/src/config.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+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;
+}
+function workflowStepPrompt(step, task, ctx) {
+  if (step.prompt)
+    return step.prompt.replaceAll("{task}", task.id).replaceAll("{title}", task.title ?? "");
+  return [
+    `Task ${task.id}: ${task.title}`,
+    "",
+    `You are the "${step.name}" step of the "${ctx.workflow}" workflow. Work only inside this worktree; commit and push as you go.`,
+    ctx.remaining.length ? `After you finish, the workflow itself runs: ${ctx.remaining.join(" \u2192 ")}. Do not do those yourself.` : "You are the last step.",
+    "When done, call swarm_handoff with what was done and what remains."
+  ].join(`
+`);
+}
+function stepLabel(s) {
+  return s.kind === "run" ? s.name : s.kind === "gate" ? `gate:${s.gate}` : "pr";
+}
+
+// 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() : "";
@@ -626,6 +794,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 },
@@ -650,11 +819,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))
@@ -721,6 +890,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)
     },
@@ -760,7 +930,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)
@@ -770,7 +940,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];
   }
@@ -780,7 +950,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];
   }
@@ -788,7 +958,7 @@ function setPath(obj, path, value) {
 }
 var isLockedBy = (path, lock) => path === lock || path.startsWith(`${lock}.`);
 function readLayer(path) {
-  return existsSync2(path) ? parseToml(readFileSync2(path, "utf8"), path) : null;
+  return existsSync3(path) ? parseToml(readFileSync2(path, "utf8"), path) : null;
 }
 function loadConfigDetailed(opts = {}) {
   const home = opts.home ?? process.env.SWARM_HOME ?? join2(process.env.HOME ?? "", ".swarm");
@@ -1274,11 +1444,11 @@ ${shown.map((f) => `- \`${f.path}\`${f.added >= 0 ? ` +${f.added} \u2212${f.dele
 `) };
 }
 // packages/core/src/gates.ts
-var NAME_RE = /^[a-z0-9][a-z0-9_.-]{0,39}$/i;
+var NAME_RE2 = /^[a-z0-9][a-z0-9_.-]{0,39}$/i;
 function validateGateRun(input) {
   if (!input.task?.trim())
     return { ok: false, reason: "task is required" };
-  if (!NAME_RE.test(input.gate ?? ""))
+  if (!NAME_RE2.test(input.gate ?? ""))
     return { ok: false, reason: "gate must be a short name (letters, digits, _ . -)" };
   if (input.verdict !== "pass" && input.verdict !== "fail")
     return { ok: false, reason: 'verdict must be "pass" or "fail"' };
@@ -1639,6 +1809,35 @@ function parseMemoryQuery(q) {
   }
   return { match: terms.join(" "), kind, task };
 }
+// packages/core/src/messages.ts
+var MESSAGE_MAX = 4000;
+function validateMessage(text) {
+  if (typeof text !== "string" || !text.trim())
+    return { ok: false, reason: "message text is required" };
+  const t = text.trim();
+  if (t.length > MESSAGE_MAX)
+    return { ok: false, reason: `message is over ${MESSAGE_MAX} chars` };
+  return { ok: true, text: t };
+}
+function parseTo(to) {
+  if (typeof to !== "string" || !to.trim())
+    return null;
+  const t = to.trim();
+  if (t === "lead")
+    return { kind: "lead" };
+  if (/^[0-9a-f]{8}(-[0-9a-f-]{4,28})?$/i.test(t))
+    return { kind: "session", id: t };
+  return { kind: "task", task: t };
+}
+function formatMessages(ms) {
+  if (!ms.length)
+    return null;
+  const lines = ms.map((m) => `- from ${m.from ?? "unknown"}${m.task ? ` (re ${m.task})` : ""}: ${m.text}`);
+  return `[swarm] While you were working, message${ms.length === 1 ? "" : "s"} arrived:
+${lines.join(`
+`)}
+Reply with swarm_send if a reply is expected.`;
+}
 // packages/core/src/policy.ts
 import { createHash } from "crypto";
 var HOOK_MARK = "swarm-hook";
@@ -2212,10 +2411,10 @@ function planGc(worktrees, claims) {
   return out;
 }
 // packages/daemon/src/app.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync4, realpathSync as realpathSync3 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync4, realpathSync as realpathSync3 } from "fs";
 import { homedir as homedir4 } from "os";
-import { dirname as dirname3, join as join9 } from "path";
-import { fileURLToPath } from "url";
+import { dirname as dirname4, join as join9 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // node_modules/.bun/hono@4.13.3/node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
@@ -4088,7 +4287,7 @@ class Dispatcher {
 }
 
 // packages/daemon/src/forge.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join4 } from "path";
 var EXTRA_BIN_DIRS = [
@@ -4106,7 +4305,7 @@ function findBin(name) {
     return onPath;
   for (const d of EXTRA_BIN_DIRS) {
     const p = join4(d, name);
-    if (existsSync3(p))
+    if (existsSync4(p))
       return p;
   }
   return null;
@@ -4805,7 +5004,7 @@ class Runner {
 import { Database } from "bun:sqlite";
 import {
   closeSync,
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   mkdirSync as mkdirSync4,
   openSync as openSync3,
   readdirSync,
@@ -4818,11 +5017,11 @@ import {
   writeFileSync as writeFileSync2
 } from "fs";
 import { homedir as homedir3, tmpdir, userInfo } from "os";
-import { basename, dirname as dirname2, join as join8 } from "path";
+import { basename, dirname as dirname3, join as join8 } from "path";
 
 // packages/daemon/src/bootstrap.ts
-import { cpSync, existsSync as existsSync4, mkdirSync as mkdirSync3, openSync as openSync2 } from "fs";
-import { dirname, join as join7 } from "path";
+import { cpSync, existsSync as existsSync5, mkdirSync as mkdirSync3, openSync as openSync2 } from "fs";
+import { dirname as dirname2, join as join7 } from "path";
 function runBootstrap(plan, opts) {
   const logDir = join7(opts.home, "logs", opts.projectId);
   mkdirSync3(logDir, { recursive: true });
@@ -4830,12 +5029,12 @@ function runBootstrap(plan, opts) {
   const copied = [];
   const skipped = [];
   for (const c of plan.copies) {
-    if (!existsSync4(c.from)) {
+    if (!existsSync5(c.from)) {
       skipped.push(c.rel);
       continue;
     }
     try {
-      mkdirSync3(dirname(c.to), { recursive: true });
+      mkdirSync3(dirname2(c.to), { recursive: true });
       cpSync(c.from, c.to, { recursive: true, force: true });
       copied.push(c.rel);
     } catch (e) {
@@ -4997,6 +5196,12 @@ CREATE TABLE IF NOT EXISTS messages (
   answer TEXT, answered_by TEXT, answered_at TEXT, delivered_at TEXT
 );
 CREATE INDEX IF NOT EXISTS messages_open ON messages(project_id, answered_at, delivered_at);
+CREATE TABLE IF NOT EXISTS workflow_runs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT, project_id TEXT, task TEXT, workflow TEXT,
+  step INTEGER, step_label TEXT, steps TEXT, state TEXT, detail TEXT, run_id TEXT,
+  started_at TEXT, updated_at TEXT, ended_at TEXT, actor_kind TEXT, actor_id TEXT
+);
+CREATE INDEX IF NOT EXISTS workflow_runs_proj ON workflow_runs(project_id, id);
 CREATE TABLE IF NOT EXISTS claims (
   project_id TEXT, task TEXT, owner TEXT, worktree TEXT, branch TEXT,
   acquired_at TEXT, expires_at TEXT, released_at TEXT, state TEXT,
@@ -5027,6 +5232,8 @@ class Store {
     this.ensureColumn("projects", "sort_order", "INTEGER");
     this.ensureColumn("projects", "icon", "TEXT");
     this.ensureColumn("projects", "color", "TEXT");
+    this.ensureColumn("messages", "to_kind", "TEXT");
+    this.ensureColumn("messages", "from_session", "TEXT");
     this.migrate();
     this.migrateProjectsJson(join8(home, "projects.json"));
     this.reconcileMovedProjects();
@@ -5076,9 +5283,9 @@ class Store {
   reconcileMovedProjects() {
     const all = this.projects();
     for (const stale of all) {
-      if (existsSync5(stale.root))
+      if (existsSync6(stale.root))
         continue;
-      const live = all.filter((p) => p.id !== stale.id && p.name === stale.name && existsSync5(p.root));
+      const live = all.filter((p) => p.id !== stale.id && p.name === stale.name && existsSync6(p.root));
       if (live.length !== 1)
         continue;
       this.mergeProject(stale.id, live[0].id);
@@ -5162,7 +5369,7 @@ class Store {
     return actorFrom(owner, sessionId, { user: osUser(), runId });
   }
   migrateProjectsJson(file) {
-    if (!existsSync5(file))
+    if (!existsSync6(file))
       return;
     try {
       const list = JSON.parse(readFileSync3(file, "utf8"));
@@ -5177,7 +5384,7 @@ class Store {
     const hit = this.topCache.get(cwd);
     if (hit && Date.now() - hit.t < 1e4)
       return hit.v;
-    const v = cwd && existsSync5(cwd) ? gitToplevel(cwd) : null;
+    const v = cwd && existsSync6(cwd) ? gitToplevel(cwd) : null;
     this.topCache.set(cwd, { v, t: Date.now() });
     return v;
   }
@@ -5383,7 +5590,7 @@ class Store {
     }));
   }
   sessionContext(cwd) {
-    if (!cwd || !existsSync5(cwd))
+    if (!cwd || !existsSync6(cwd))
       return null;
     const toplevel = this.toplevel(cwd);
     const project = this.resolveProject(cwd);
@@ -5523,7 +5730,160 @@ class Store {
     return qs;
   }
   answerContext(sessionId) {
-    return formatAnswers(this.inbox(sessionId));
+    const parts = [
+      formatAnswers(this.inbox(sessionId)),
+      formatMessages(this.messageInbox(sessionId))
+    ];
+    const out = parts.filter(Boolean);
+    return out.length ? out.join(`
+`) : null;
+  }
+  wfInsert(projectId, task, workflow, steps, actor2) {
+    const now = new Date().toISOString();
+    const r = this.db.query(`INSERT INTO workflow_runs (project_id, task, workflow, step, step_label, steps, state, started_at, updated_at, actor_kind, actor_id)
+         VALUES (?, ?, ?, 0, ?, ?, 'running', ?, ?, ?, ?)`).run(projectId, task, workflow, steps[0] ?? "", JSON.stringify(steps), now, now, actor2.kind, actor2.id);
+    this.touch();
+    return Number(r.lastInsertRowid);
+  }
+  wfUpdate(id, patch) {
+    const sets = ["updated_at = ?"];
+    const args = [new Date().toISOString()];
+    if (patch.step !== undefined) {
+      sets.push("step = ?");
+      args.push(patch.step);
+    }
+    if (patch.stepLabel !== undefined) {
+      sets.push("step_label = ?");
+      args.push(patch.stepLabel);
+    }
+    if (patch.state !== undefined) {
+      sets.push("state = ?");
+      args.push(patch.state);
+    }
+    if (patch.detail !== undefined) {
+      sets.push("detail = ?");
+      args.push(patch.detail);
+    }
+    if (patch.runId !== undefined) {
+      sets.push("run_id = ?");
+      args.push(patch.runId);
+    }
+    if (patch.ended) {
+      sets.push("ended_at = ?");
+      args.push(new Date().toISOString());
+    }
+    this.db.query(`UPDATE workflow_runs SET ${sets.join(", ")} WHERE id = ?`).run(...args, id);
+    this.touch();
+  }
+  wfRuns(projectId, limit = 50) {
+    return this.db.query("SELECT * FROM workflow_runs WHERE project_id = ? ORDER BY id DESC LIMIT ?").all(projectId, limit).map(rowToWorkflowRun);
+  }
+  wfActive(projectId, task) {
+    const r = this.db.query("SELECT * FROM workflow_runs WHERE project_id = ? AND task = ? AND state = 'running' ORDER BY id DESC LIMIT 1").get(projectId, task);
+    return r ? rowToWorkflowRun(r) : null;
+  }
+  wfSweepOrphans() {
+    this.db.query("UPDATE workflow_runs SET state = 'stopped', detail = COALESCE(detail, 'daemon restarted mid-workflow'), ended_at = ? WHERE state = 'running'").run(new Date().toISOString());
+  }
+  send(projectId, input) {
+    if (!this.project(projectId))
+      return { ok: false, error: "unknown project" };
+    const v = validateMessage(input.text);
+    if (!v.ok)
+      return { ok: false, error: v.reason };
+    const to = parseTo(input.to);
+    if (!to)
+      return { ok: false, error: 'to must be a session id, a task, or "lead"' };
+    let sessionId = null;
+    let task = null;
+    if (to.kind === "session") {
+      sessionId = this.knownSession(to.id) ?? this.sessionByPrefix(to.id);
+      if (!sessionId)
+        return { ok: false, error: `unknown session ${to.id}` };
+    } else if (to.kind === "task") {
+      task = to.task;
+      sessionId = this.sessionForTask(projectId, to.task);
+    } else {
+      sessionId = this.leadSession(projectId);
+    }
+    const createdAt = new Date().toISOString();
+    const from = input.from ?? (input.fromSession ? `agent ${input.fromSession.slice(0, 8)}` : null);
+    const r = this.db.query(`INSERT INTO messages (project_id, session_id, task, kind, text, asked_by, created_at, to_kind, from_session)
+         VALUES (?, ?, ?, 'message', ?, ?, ?, ?, ?)`).run(projectId, sessionId, task, v.text, from, createdAt, to.kind, input.fromSession ?? null);
+    const message = this.message(Number(r.lastInsertRowid));
+    this.append({
+      ts: createdAt,
+      type: "message.sent",
+      projectId,
+      sessionId: input.fromSession ?? null,
+      actor: this.actorFor(input.from ?? null, input.fromSession ?? null),
+      payload: {
+        id: message.id,
+        to: input.to,
+        task,
+        recipient: sessionId,
+        text: v.text.slice(0, 400),
+        summary: `message to ${String(input.to)}: ${v.text.slice(0, 120)}`
+      }
+    });
+    return { ok: true, message };
+  }
+  message(id) {
+    const r = this.db.query("SELECT * FROM messages WHERE id = ? AND kind = 'message'").get(id);
+    return r ? rowToMessage(r) : null;
+  }
+  messages(opts = {}) {
+    const where = ["kind = 'message'"];
+    const args = [];
+    if (opts.projectId) {
+      where.push("project_id = ?");
+      args.push(opts.projectId);
+    }
+    if (opts.sessionId) {
+      where.push("(session_id = ? OR from_session = ?)");
+      args.push(opts.sessionId, opts.sessionId);
+    }
+    if (opts.task) {
+      where.push("task = ?");
+      args.push(opts.task);
+    }
+    args.push(opts.limit ?? 100);
+    return this.db.query(`SELECT * FROM messages WHERE ${where.join(" AND ")} ORDER BY id DESC LIMIT ?`).all(...args).map(rowToMessage);
+  }
+  messageInbox(sessionId, opts = {}) {
+    if (!sessionId)
+      return [];
+    const s = this.db.query("SELECT project_id, kind, cwd FROM sessions WHERE id = ?").get(sessionId);
+    if (!s)
+      return [];
+    const task = this.heldClaimsWithWorktree().find((c) => isInside(s.cwd, c.worktree))?.task ?? null;
+    const rows = this.db.query(`SELECT * FROM messages WHERE kind = 'message' AND delivered_at IS NULL AND from_session IS NOT ?
+           AND (session_id = ?
+             OR (to_kind = 'task' AND project_id = ? AND task IS ?)
+             OR (to_kind = 'lead' AND project_id = ? AND ? = 'interactive'))
+         ORDER BY id`).all(sessionId, sessionId, s.project_id, task, s.project_id, s.kind);
+    const ms = rows.map(rowToMessage);
+    if (ms.length && !opts.peek)
+      this.db.query(`UPDATE messages SET delivered_at = ?, session_id = ? WHERE id IN (${ms.map(() => "?").join(",")})`).run(new Date().toISOString(), sessionId, ...ms.map((m) => m.id));
+    return ms;
+  }
+  markMessageDelivered(id, sessionId) {
+    this.db.query("UPDATE messages SET delivered_at = ?, session_id = COALESCE(?, session_id) WHERE id = ? AND delivered_at IS NULL").run(new Date().toISOString(), sessionId, id);
+  }
+  leadSession(projectId) {
+    const r = this.db.query("SELECT id FROM sessions WHERE project_id = ? AND kind = 'interactive' AND state != 'ended' ORDER BY last_seen_at DESC LIMIT 1").get(projectId);
+    return r?.id ?? null;
+  }
+  sessionByPrefix(prefix) {
+    const rows = this.db.query("SELECT id FROM sessions WHERE id LIKE ? ORDER BY last_seen_at DESC LIMIT 2").all(`${prefix}%`);
+    return rows.length === 1 ? rows[0]?.id ?? null : null;
+  }
+  sessionForTask(projectId, task) {
+    const claim = this.claims(projectId).find((c) => c.task === task && c.state === "held");
+    if (!claim?.worktree)
+      return null;
+    const rows = this.db.query("SELECT id, cwd FROM sessions WHERE project_id = ? AND state != 'ended' ORDER BY last_seen_at DESC").all(projectId);
+    return rows.find((r) => isInside(r.cwd, claim.worktree))?.id ?? null;
   }
   questionContext(task, projectId) {
     if (!task)
@@ -5600,13 +5960,13 @@ class Store {
       };
     const claim = this.claims(projectId).find((c) => c.task === task && c.state === "held");
     const worktree2 = claim?.worktree;
-    if (!worktree2 || !existsSync5(worktree2))
+    if (!worktree2 || !existsSync6(worktree2))
       return {
         ok: false,
         reason: `${task} has no held worktree to run ${gate} in \u2014 claim it first`
       };
     const cwd = def.cwd ? join8(worktree2, def.cwd) : worktree2;
-    if (!existsSync5(cwd))
+    if (!existsSync6(cwd))
       return { ok: false, reason: `gate cwd ${cwd} does not exist` };
     const key = `${projectId}:${task}:${gate}`;
     if (this.gateJobs.has(key))
@@ -5947,7 +6307,7 @@ ${err}
       error = e.error;
     } else {
       const path = join8(p.root, source);
-      if (!existsSync5(path))
+      if (!existsSync6(path))
         return { source, required: this.requiredGates(projectId), tasks: [] };
       const mtime = statSync(path).mtimeMs;
       let md = this.taskCache.get(projectId);
@@ -5996,7 +6356,7 @@ ${err}
     const file = join8(this.home, POLICY_CACHE_FILE);
     try {
       if (!hasLockedRules(loaded)) {
-        if (existsSync5(file))
+        if (existsSync6(file))
           unlinkSync(file);
         return;
       }
@@ -6012,13 +6372,13 @@ ${err}
   claudeSettings() {
     const p = process.env.CLAUDE_SETTINGS ?? join8(homedir3(), ".claude", "settings.json");
     try {
-      return existsSync5(p) ? JSON.parse(readFileSync3(p, "utf8")) : null;
+      return existsSync6(p) ? JSON.parse(readFileSync3(p, "utf8")) : null;
     } catch {
       return null;
     }
   }
   checkPolicy(cwd, sessionId) {
-    const project = existsSync5(cwd) ? this.resolveProject(cwd) : null;
+    const project = existsSync6(cwd) ? this.resolveProject(cwd) : null;
     const repoRoot = project?.root ?? null;
     const loaded = this.policyFor(repoRoot);
     const settings = this.claudeSettings();
@@ -6043,7 +6403,7 @@ ${err}
     return findings;
   }
   evaluateTool(tool, input, sessionId, cwd, recordIncident = true) {
-    if (BUDGET_ASK_TOOLS.has(tool) && cwd && existsSync5(cwd)) {
+    if (BUDGET_ASK_TOOLS.has(tool) && cwd && existsSync6(cwd)) {
       const project = this.resolveProject(cwd);
       const b = this.budgetFor(project.id);
       if (b && b.status.level === "exceeded" && b.config.on_exceed === "ask") {
@@ -6134,7 +6494,7 @@ ${err}
     return this.openIncident(d, cwd, id, cmd);
   }
   openIncident(d, cwd, sessionId, command) {
-    const project = cwd && existsSync5(cwd) ? this.resolveProject(cwd) : null;
+    const project = cwd && existsSync6(cwd) ? this.resolveProject(cwd) : null;
     this.append({
       ts: new Date().toISOString(),
       type: "incident.opened",
@@ -6185,7 +6545,7 @@ ${err}
       }
     }
     const report = dryRunRules(calls, modes, {
-      toplevel: (cwd) => cwd && existsSync5(cwd) ? this.toplevel(cwd) : null,
+      toplevel: (cwd) => cwd && existsSync6(cwd) ? this.toplevel(cwd) : null,
       claims: this.heldWorktrees()
     });
     return { ...report, modes };
@@ -6201,7 +6561,7 @@ ${err}
     this.prices = { ...PRICES };
     for (const f of ["pricing.litellm.json", "pricing.json"]) {
       const p = join8(this.home, f);
-      if (!existsSync5(p))
+      if (!existsSync6(p))
         continue;
       try {
         const j = JSON.parse(readFileSync3(p, "utf8"));
@@ -6426,10 +6786,10 @@ ${err}
     if (typeof raw2.cwd === "string")
       this.autoRenewFor(typeof raw2.session_id === "string" ? raw2.session_id : null, raw2.cwd);
     const cwd = typeof raw2.cwd === "string" ? raw2.cwd : process.cwd();
-    const project = existsSync5(cwd) ? this.resolveProject(cwd) : null;
+    const project = existsSync6(cwd) ? this.resolveProject(cwd) : null;
     const e = this.append(normalizeHook(event, raw2, project?.id ?? "p_unknown"));
     if ((event === "Stop" || event === "SessionEnd") && e.sessionId) {
-      if (existsSync5(cwd)) {
+      if (existsSync6(cwd)) {
         this.autoHandoff(e.sessionId, cwd);
         this.autoGate(event, e.sessionId, cwd);
       }
@@ -6475,7 +6835,7 @@ ${err}
       return;
     const p = e.payload;
     const row = this.db.query("SELECT id, tool_counts FROM sessions WHERE id = ?").get(e.sessionId);
-    const branch = p.cwd && existsSync5(p.cwd) ? currentBranch(p.cwd) : null;
+    const branch = p.cwd && existsSync6(p.cwd) ? currentBranch(p.cwd) : null;
     if (!row) {
       this.db.query("INSERT INTO sessions (id, project_id, kind, cwd, branch, started_at, last_seen_at, last, last_type, state) VALUES (?, ?, 'interactive', ?, ?, ?, ?, ?, ?, 'active')").run(e.sessionId, e.projectId, p.cwd ?? "", branch, e.ts, e.ts, p.summary ?? e.type, e.type);
     }
@@ -6547,10 +6907,10 @@ ${err}
   }
   tailSession(sessionId) {
     const s = this.db.query("SELECT transcript_path FROM sessions WHERE id = ?").get(sessionId);
-    if (!s?.transcript_path || !existsSync5(s.transcript_path))
+    if (!s?.transcript_path || !existsSync6(s.transcript_path))
       return 0;
     let n = this.tailFile(s.transcript_path, sessionId, null);
-    const subDir = join8(dirname2(s.transcript_path), basename(s.transcript_path, ".jsonl"), "subagents");
+    const subDir = join8(dirname3(s.transcript_path), basename(s.transcript_path, ".jsonl"), "subagents");
     for (const f of this.subagentFiles(subDir)) {
       n += this.tailFile(join8(subDir, f), sessionId, f.replace(/^agent-|\.jsonl$/g, ""));
     }
@@ -6618,7 +6978,7 @@ ${err}
     return out;
   }
   tailCodex(windowMs = 3 * 24 * 60 * 60000) {
-    if (!existsSync5(this.codexRoot()))
+    if (!existsSync6(this.codexRoot()))
       return 0;
     let n = 0;
     for (const path of this.codexRolloutFiles(Date.now() - windowMs)) {
@@ -6630,9 +6990,54 @@ ${err}
     return process.env.SWARM_GROK_DIR ?? join8(homedir3(), ".grok", "sessions");
   }
   grokSummary = new Map;
+  tailGemini(windowMs = 3 * 24 * 60 * 60000) {
+    const root = process.env.SWARM_GEMINI_ROOT ?? join8(homedir3(), ".gemini", "tmp");
+    if (!existsSync6(root))
+      return 0;
+    const since = Date.now() - windowMs;
+    const ls = (p) => {
+      try {
+        return readdirSync(p);
+      } catch {
+        return [];
+      }
+    };
+    let n = 0;
+    const ingestDir = (dir) => {
+      for (const f of ls(dir)) {
+        const path = join8(dir, f);
+        if (!f.endsWith(".jsonl")) {
+          try {
+            if (statSync(path).isDirectory()) {
+              for (const g of ls(path))
+                if (g.endsWith(".jsonl"))
+                  ingestFile(join8(path, g));
+            }
+          } catch {}
+          continue;
+        }
+        ingestFile(path);
+      }
+    };
+    const ingestFile = (path) => {
+      try {
+        if (statSync(path).mtimeMs < since)
+          return;
+      } catch {
+        return;
+      }
+      n += this.ingestLog(path, "gemini", parseGeminiChat);
+    };
+    for (const hash of ls(root)) {
+      const chats = join8(root, hash, "chats");
+      if (existsSync6(chats))
+        ingestDir(chats);
+    }
+    return n;
+  }
   tailGrok(windowMs = 3 * 24 * 60 * 60000) {
     const root = this.grokRoot();
-    if (!existsSync5(root))
+    if (!existsSync6(root))
       return 0;
     const since = Date.now() - windowMs;
     const ls = (p) => {
@@ -6655,7 +7060,7 @@ ${err}
       const cwdDir = join8(root, enc);
       for (const sid of ls(cwdDir)) {
         const path = join8(cwdDir, sid, "updates.jsonl");
-        if (!existsSync5(path))
+        if (!existsSync6(path))
           continue;
         try {
           if (statSync(path).mtimeMs < since)
@@ -6714,9 +7119,9 @@ ${err}
   ensureAgentSession(sid, agent, cwd, mtime) {
     if (this.db.query("SELECT 1 FROM sessions WHERE id = ?").get(sid))
       return;
-    const project = cwd && existsSync5(cwd) ? this.resolveProject(cwd) : null;
+    const project = cwd && existsSync6(cwd) ? this.resolveProject(cwd) : null;
     const ts = new Date(mtime).toISOString();
-    this.db.query("INSERT INTO sessions (id, project_id, kind, agent, cwd, branch, started_at, last_seen_at, last, last_type, state) VALUES (?, ?, 'interactive', ?, ?, ?, ?, ?, '', '', 'active')").run(sid, project?.id ?? "p_unknown", agent, cwd, cwd && existsSync5(cwd) ? currentBranch(cwd) : null, ts, ts);
+    this.db.query("INSERT INTO sessions (id, project_id, kind, agent, cwd, branch, started_at, last_seen_at, last, last_type, state) VALUES (?, ?, 'interactive', ?, ?, ?, ?, ?, '', '', 'active')").run(sid, project?.id ?? "p_unknown", agent, cwd, cwd && existsSync6(cwd) ? currentBranch(cwd) : null, ts, ts);
   }
   claimRows(projectId) {
     return this.db.query("SELECT * FROM claims WHERE project_id = ?").all(projectId).map((r) => ({
@@ -6762,9 +7167,9 @@ ${err}
       return { ok: false, error: claimRefusalMessage(decision, task) };
     const branch = `task/${task}`;
     const worktree2 = this.worktreePath(projectId, task);
-    if (existsSync5(worktree2))
+    if (existsSync6(worktree2))
       return { ok: false, error: `${worktree2} already exists; release ${task} first` };
-    mkdirSync4(dirname2(worktree2), { recursive: true });
+    mkdirSync4(dirname3(worktree2), { recursive: true });
     const created = worktreeAdd(p.root, worktree2, branch, baseRef);
     if (!created)
       return { ok: false, error: `git worktree add failed for ${task}` };
@@ -6874,7 +7279,7 @@ ${err}
       for (const c of this.claimRows(p.id)) {
         if (c.state !== "held" || isActive(c, now))
           continue;
-        const exists = c.worktree ? existsSync5(c.worktree) : false;
+        const exists = c.worktree ? existsSync6(c.worktree) : false;
         const work = exists ? heldWork(c.worktree) : null;
         if (reapAction(c, now, exists, work) !== "keep-orphaned")
           continue;
@@ -6930,7 +7335,7 @@ ${err}
     if (!row)
       return { ok: false, error: `no claim on ${task}` };
     const worktree2 = row.worktree ?? "";
-    if (worktree2 && existsSync5(worktree2)) {
+    if (worktree2 && existsSync6(worktree2)) {
       const work = heldWork(worktree2);
       const can = canRelease(work, force);
       if (!can.ok)
@@ -6965,7 +7370,7 @@ ${err}
           continue;
         if (isActive({ ...c, state: "held" }, now))
           continue;
-        const exists = c.worktree ? existsSync5(c.worktree) : false;
+        const exists = c.worktree ? existsSync6(c.worktree) : false;
         const work = exists ? heldWork(c.worktree) : null;
         const action = reapAction({ ...c, state: "held" }, now, exists, work);
         if (action === "not-expired")
@@ -7064,9 +7469,9 @@ ${err}
     if (!slug || slug === "." || slug === "..")
       return { ok: false, error: "bad worktree name" };
     const path = this.worktreePath(projectId, slug);
-    if (existsSync5(path))
+    if (existsSync6(path))
       return { ok: false, error: `${path} already exists` };
-    mkdirSync4(dirname2(path), { recursive: true });
+    mkdirSync4(dirname3(path), { recursive: true });
     const br = branch?.trim() || `wt/${slug}`;
     const created = worktreeAdd(p.root, path, br, baseRef);
     if (!created)
@@ -7751,6 +8156,48 @@ ${err}
   seq() {
     return this.db.query("SELECT COALESCE(MAX(seq),0) AS seq FROM events").get().seq;
   }
+  timelineDetail(hours, projectId) {
+    const from = new Date(Date.now() - Math.min(Math.max(hours, 1), 168) * 3600000).toISOString();
+    const args = [from];
+    let filter = "";
+    if (projectId) {
+      filter = " AND s.project_id = ?";
+      args.push(projectId);
+    }
+    const rows = this.db.query(`SELECT t.session_id AS sid, t.ts FROM turns t JOIN sessions s ON s.id = t.session_id
+         WHERE t.ts >= ? AND t.sidechain = 0${filter} ORDER BY t.ts LIMIT 20000`).all(...args);
+    const turns = {};
+    for (const r of rows) {
+      turns[r.sid] ??= [];
+      turns[r.sid]?.push(new Date(r.ts).getTime());
+    }
+    const claims = this.claims().filter((c) => (!projectId || c.projectId === projectId) && c.state !== "released").map((c) => ({
+      projectId: c.projectId,
+      task: c.task,
+      owner: c.owner,
+      state: c.state,
+      acquiredAt: c.acquiredAt,
+      expiresAt: c.expiresAt
+    }));
+    return { turns, claims };
+  }
+  spendSparks() {
+    const from = localDayIso(-13);
+    const rows = this.db.query(`SELECT s.project_id AS pid, substr(t.ts, 1, 10) AS day, SUM(t.cost_usd) AS usd
+         FROM turns t JOIN sessions s ON s.id = t.session_id WHERE t.ts >= ? GROUP BY pid, day`).all(from);
+    const days2 = [];
+    for (let i = 13;i >= 0; i--)
+      days2.push(localDayIso(-i).slice(0, 10));
+    const out = {};
+    for (const r of rows) {
+      out[r.pid] ??= new Array(14).fill(0);
+      const arr = out[r.pid];
+      const i = days2.indexOf(r.day);
+      if (i >= 0)
+        arr[i] = (arr[i] ?? 0) + (r.usd ?? 0);
+    }
+    return out;
+  }
   snapshot() {
     const worktrees = {};
     const projects = this.projects().filter((p) => !(p.discovered && isScratchRoot(p.root)));
@@ -7761,6 +8208,7 @@ ${err}
       worktrees,
       sessions: this.memoised("sessions", 2000, () => this.sessions()),
       spend: this.memoised("spend", 30000, () => this.spend()),
+      spendSparks: this.memoised("spendSparks", 60000, () => this.spendSparks()),
       claims: this.claims(),
       processes: this.memoised("processes", 5000, () => this.processes()),
       incidents: this.memoised("incidents", 30000, () => this.incidents(20, { open: true })),
@@ -7858,15 +8306,242 @@ function isScratchRoot(root) {
   const tmp = [tmpdir(), "/tmp", "/private/tmp", "/private/var/folders", "/var/folders"];
   return tmp.some((t) => root === t || root.startsWith(`${t}/`));
 }
+function rowToMessage(r) {
+  return {
+    id: r.id,
+    projectId: r.project_id,
+    task: r.task ?? null,
+    sessionId: r.session_id ?? null,
+    toKind: r.to_kind ?? "session",
+    from: r.asked_by ?? null,
+    fromSession: r.from_session ?? null,
+    text: r.text,
+    createdAt: r.created_at,
+    deliveredAt: r.delivered_at ?? null
+  };
+}
+function rowToWorkflowRun(r) {
+  return {
+    id: r.id,
+    projectId: r.project_id,
+    task: r.task,
+    workflow: r.workflow,
+    step: r.step,
+    stepLabel: r.step_label ?? "",
+    steps: JSON.parse(r.steps ?? "[]"),
+    state: r.state,
+    detail: r.detail ?? null,
+    runId: r.run_id ?? null,
+    startedAt: r.started_at,
+    updatedAt: r.updated_at,
+    endedAt: r.ended_at ?? null
+  };
+}
+function localDayIso(offsetDays) {
+  const d = new Date;
+  d.setHours(0, 0, 0, 0);
+  d.setDate(d.getDate() + offsetDays);
+  return d.toISOString();
+}
+
+// packages/daemon/src/workflow.ts
+class WorkflowEngine {
+  store;
+  runner;
+  forge;
+  active = new Map;
+  constructor(store, runner, forge2) {
+    this.store = store;
+    this.runner = runner;
+    this.forge = forge2;
+    store.wfSweepOrphans();
+    runner.onEnd((run2) => void this.onRunEnd(run2));
+  }
+  start(projectId, task, workflow, opts = {}) {
+    const def = this.store.config(projectId).workflows[workflow];
+    if (!def) {
+      const known = Object.keys(this.store.config(projectId).workflows);
+      return {
+        ok: false,
+        error: `unknown workflow ${workflow}${known.length ? ` \u2014 this repo declares: ${known.join(", ")}` : " \u2014 declare [[workflows]] in .swarm.toml"}`
+      };
+    }
+    const key = `${projectId}:${task}`;
+    if (this.active.has(key) || this.store.wfActive(projectId, task))
+      return { ok: false, error: `a workflow is already running on ${task}` };
+    const title = this.store.tasks(projectId)?.tasks.find((t) => t.id === task)?.title ?? task;
+    const owner = opts.owner ?? "workflow";
+    const id = this.store.wfInsert(projectId, task, workflow, def.steps.map(stepLabel), this.store.actorFor(owner, opts.sessionId ?? null));
+    const w = { id, projectId, task, title, def, step: 0, runId: null, owner };
+    this.active.set(key, w);
+    this.store.append({
+      ts: new Date().toISOString(),
+      type: "workflow.started",
+      projectId,
+      sessionId: opts.sessionId ?? null,
+      payload: {
+        id,
+        task,
+        workflow,
+        steps: def.steps.map(stepLabel),
+        summary: `workflow ${workflow} on ${task}: ${def.steps.map(stepLabel).join(" \u2192 ")}`
+      }
+    });
+    this.advance(w);
+    return { ok: true, id };
+  }
+  status(projectId) {
+    return this.store.wfRuns(projectId);
+  }
+  stop(projectId, task) {
+    const key = `${projectId}:${task}`;
+    const w = this.active.get(key);
+    if (!w)
+      return { ok: false, error: `no running workflow on ${task}` };
+    if (w.runId)
+      this.runner.stop(w.runId);
+    this.finish(w, "stopped", `stopped at ${this.label(w)}`);
+    return { ok: true };
+  }
+  label(w) {
+    const s = w.def.steps[w.step];
+    return s ? stepLabel(s) : "done";
+  }
+  async advance(w) {
+    while (w.step < w.def.steps.length) {
+      const s = w.def.steps[w.step];
+      this.store.wfUpdate(w.id, { step: w.step, stepLabel: stepLabel(s), runId: null });
+      this.step(w, `step ${w.step + 1}/${w.def.steps.length}: ${stepLabel(s)}`);
+      if (s.kind === "run") {
+        const cfg = this.store.config(w.projectId).dispatch;
+        const remaining = w.def.steps.slice(w.step + 1).map(stepLabel);
+        const r = await this.runner.start({
+          projectId: w.projectId,
+          task: w.task,
+          prompt: workflowStepPrompt(s, { id: w.task, title: w.title }, { workflow: w.def.name, remaining }),
+          owner: w.owner,
+          permissionMode: cfg.permission_mode ?? "acceptEdits",
+          model: cfg.model ?? undefined,
+          maxTurns: cfg.max_turns ?? undefined,
+          profile: cfg.profile ?? undefined
+        });
+        if (!r.ok)
+          return this.fail(w, `could not start ${stepLabel(s)}: ${r.reason}`);
+        w.runId = r.run.id;
+        this.store.wfUpdate(w.id, { runId: r.run.id });
+        return;
+      }
+      if (s.kind === "gate") {
+        const r = await this.store.runGates(w.projectId, w.task, [s.gate], { owner: w.owner });
+        const run2 = r.runs.find((x) => x.gate === s.gate);
+        if (!run2)
+          return this.fail(w, `gate ${s.gate} did not run: ${r.skipped[0]?.reason ?? "unknown"}`);
+        if (run2.verdict !== "pass")
+          return this.fail(w, `gate ${s.gate} failed \u2014 ${run2.rubric}`);
+        w.step++;
+        continue;
+      }
+      const d = await this.store.prDraftFor(w.projectId, w.task);
+      if (!d.ok)
+        return this.fail(w, `pr: ${d.error}`);
+      const pr = await this.forge.openPR(w.projectId, d.worktree, {
+        title: d.title,
+        body: d.body,
+        isDraft: false
+      });
+      if (!pr.ok)
+        return this.fail(w, `pr: ${pr.error}`);
+      this.store.recordPrOpened(w.projectId, d.task, d.worktree.path, pr.url);
+      this.store.wfUpdate(w.id, { detail: `PR ${pr.url}` });
+      w.step++;
+    }
+    this.finish(w, "done", null);
+  }
+  async onRunEnd(run2) {
+    const w = this.active.get(`${run2.projectId}:${run2.task}`);
+    if (!w || w.runId !== run2.id)
+      return;
+    w.runId = null;
+    if (run2.stopped)
+      return this.finish(w, "stopped", `stopped during ${this.label(w)}`);
+    if (run2.exitCode !== 0 || run2.result?.isError)
+      return this.fail(w, `${this.label(w)} exited ${run2.exitCode}${run2.result?.isError ? " (error)" : ""} \u2014 log: ${run2.log}`);
+    w.step++;
+    this.advance(w);
+  }
+  step(w, summary) {
+    this.store.append({
+      ts: new Date().toISOString(),
+      type: "workflow.step",
+      projectId: w.projectId,
+      sessionId: null,
+      payload: {
+        id: w.id,
+        task: w.task,
+        workflow: w.def.name,
+        step: w.step,
+        label: this.label(w),
+        summary: `workflow ${w.def.name} on ${w.task} \u2014 ${summary}`
+      }
+    });
+  }
+  fail(w, detail) {
+    this.store.wfUpdate(w.id, { state: "failed", detail, ended: true });
+    this.active.delete(`${w.projectId}:${w.task}`);
+    this.store.append({
+      ts: new Date().toISOString(),
+      type: "workflow.finished",
+      projectId: w.projectId,
+      sessionId: null,
+      payload: {
+        id: w.id,
+        task: w.task,
+        workflow: w.def.name,
+        outcome: "failed",
+        detail,
+        summary: `workflow ${w.def.name} on ${w.task} failed at ${this.label(w)}: ${detail.slice(0, 160)}`
+      }
+    });
+    this.store.append({
+      ts: new Date().toISOString(),
+      type: "incident.opened",
+      projectId: w.projectId,
+      sessionId: null,
+      payload: {
+        rule: "workflow_failed",
+        action: "failed",
+        command: `${w.task} \xB7 ${w.def.name} \xB7 ${this.label(w)}`,
+        reason: detail.slice(0, 400)
+      }
+    });
+  }
+  finish(w, state, detail) {
+    this.store.wfUpdate(w.id, { state, ...detail !== null ? { detail } : {}, ended: true });
+    this.active.delete(`${w.projectId}:${w.task}`);
+    this.store.append({
+      ts: new Date().toISOString(),
+      type: "workflow.finished",
+      projectId: w.projectId,
+      sessionId: null,
+      payload: {
+        id: w.id,
+        task: w.task,
+        workflow: w.def.name,
+        outcome: state,
+        summary: `workflow ${w.def.name} on ${w.task}: ${state}${detail ? ` \u2014 ${detail}` : ""}`
+      }
+    });
+  }
+}
 
 // packages/daemon/src/app.ts
-var VERSION = "0.8.0";
+var VERSION = "0.9.0";
 var WEB_DIR = (() => {
   if (process.env.SWARM_WEB_DIR)
     return process.env.SWARM_WEB_DIR;
-  const here = dirname3(fileURLToPath(import.meta.url));
+  const here = dirname4(fileURLToPath2(import.meta.url));
   const dev = join9(here, "../../web/public");
-  return existsSync6(join9(dev, "index.html")) ? dev : join9(here, "../web");
+  return existsSync7(join9(dev, "index.html")) ? dev : join9(here, "../web");
 })();
 var REPLAY_TAIL = 200;
 var wireCache = new WeakMap;
@@ -7880,13 +8555,39 @@ function wireJson(e) {
 }
 function hookRepoRoot(store, raw2) {
   const cwd = typeof raw2.cwd === "string" ? raw2.cwd : "";
-  return cwd && existsSync6(cwd) ? store.resolveProject(cwd)?.root ?? null : null;
+  return cwd && existsSync7(cwd) ? store.resolveProject(cwd)?.root ?? null : null;
 }
-function createApp(store = new Store) {
+function claudeSettings() {
+  try {
+    const p = process.env.CLAUDE_SETTINGS ?? join9(homedir4(), ".claude", "settings.json");
+    return existsSync7(p) ? JSON.parse(readFileSync4(p, "utf8")) : null;
+  } catch {
+    return null;
+  }
+}
+function diskVersion() {
+  try {
+    const entry = daemonCommand().at(-1);
+    if (!entry || !existsSync7(entry))
+      return null;
+    for (const f of [entry, join9(dirname4(entry), "app.ts")]) {
+      if (!existsSync7(f))
+        continue;
+      const m = /SWARM_VERSION\s*\?\?\s*"(\d+\.\d+\.\d+)"/.exec(readFileSync4(f, "utf8"));
+      if (m?.[1])
+        return m[1];
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function createApp(store = new Store, hooks2 = {}) {
   const app = new Hono2;
   const forge2 = new ForgeService(store);
   const runner = new Runner(store, store.home);
   const dispatcher = new Dispatcher(store, runner, forge2);
+  const workflows2 = new WorkflowEngine(store, runner, forge2);
   store.onBudgetStop((projectId) => {
     dispatcher.clear(projectId);
     for (const run2 of runner.list(projectId))
@@ -7908,6 +8609,8 @@ function createApp(store = new Store) {
     return c.json({ error: "unauthorized: send the daemon token (~/.swarm/token) as Authorization: Bearer" }, 401);
   });
   app.get("/v1/health", (c) => c.json({
+    disk: diskVersion(),
+    hooksInstalled: hookCoverage(claudeSettings()).complete,
     ok: true,
     version: VERSION,
     schema: store.schemaVersion(),
@@ -7942,13 +8645,13 @@ function createApp(store = new Store) {
     const q = c.req.query("path");
     let dir;
     try {
-      dir = realpathSync3(q && existsSync6(q) ? q : homedir4());
+      dir = realpathSync3(q && existsSync7(q) ? q : homedir4());
     } catch {
       dir = homedir4();
     }
     try {
-      const entries = readdirSync2(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".")).map((e) => ({ name: e.name, repo: existsSync6(join9(dir, e.name, ".git")) })).sort((a, b) => a.name.localeCompare(b.name));
-      const parent = dirname3(dir);
+      const entries = readdirSync2(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".")).map((e) => ({ name: e.name, repo: existsSync7(join9(dir, e.name, ".git")) })).sort((a, b) => a.name.localeCompare(b.name));
+      const parent = dirname4(dir);
       return c.json({ path: dir, parent: parent === dir ? null : parent, entries });
     } catch (e) {
       return c.json({ error: e.message, path: dir }, 400);
@@ -7998,6 +8701,12 @@ function createApp(store = new Store) {
     const ct = format === "csv" ? "text/csv; charset=utf-8" : format === "jsonl" ? "application/x-ndjson" : "application/json";
     return c.body(formatAudit(rows, format), 200, { "content-type": ct });
   });
+  app.post("/v1/daemon/restart", (c) => {
+    if (!hooks2.restart)
+      return c.json({ error: "not restartable in this environment" }, 501);
+    setTimeout(() => hooks2.restart?.(), 50);
+    return c.json({ ok: true, restarting: true });
+  });
   app.get("/v1/rules/dryrun", (c) => {
     const projectId = c.req.query("project");
     if (!projectId)
@@ -8132,6 +8841,58 @@ function createApp(store = new Store) {
     return c.json(r, r.ok ? 200 : 409);
   });
   app.get("/v1/inbox", (c) => c.json(store.inbox(c.req.query("session") || null, { peek: c.req.query("peek") === "1" })));
+  app.get("/v1/workflows", (c) => {
+    const project = c.req.query("project");
+    if (!project)
+      return c.json({ error: "project required" }, 400);
+    return c.json({ defs: store.config(project).workflows, runs: workflows2.status(project) });
+  });
+  app.post("/v1/workflows", async (c) => {
+    const b = await c.req.json().catch(() => ({}));
+    if (!b.projectId || !b.task || !b.workflow)
+      return c.json({ ok: false, error: "projectId, task, workflow required" }, 400);
+    const r = workflows2.start(b.projectId, b.task, b.workflow, {
+      ...b.owner ? { owner: b.owner } : {},
+      sessionId: b.sessionId ?? null
+    });
+    return c.json(r, r.ok ? 201 : 409);
+  });
+  app.post("/v1/workflows/stop", async (c) => {
+    const b = await c.req.json().catch(() => ({}));
+    if (!b.projectId || !b.task)
+      return c.json({ ok: false, error: "projectId and task required" }, 400);
+    const r = workflows2.stop(b.projectId, b.task);
+    return c.json(r, r.ok ? 200 : 404);
+  });
+  app.get("/v1/timeline", (c) => c.json(store.timelineDetail(Number(c.req.query("hours")) || 12, c.req.query("project") || null)));
+  app.get("/v1/messages", (c) => c.json(store.messages({
+    ...c.req.query("project") ? { projectId: c.req.query("project") } : {},
+    ...c.req.query("session") ? { sessionId: c.req.query("session") } : {},
+    ...c.req.query("task") ? { task: c.req.query("task") } : {},
+    limit: Number(c.req.query("limit")) || 100
+  })));
+  app.get("/v1/messages/inbox", (c) => c.json(store.messageInbox(c.req.query("session") || null, { peek: c.req.query("peek") === "1" })));
+  app.post("/v1/messages", async (c) => {
+    const b = await c.req.json().catch(() => ({}));
+    if (!b.projectId)
+      return c.json({ ok: false, error: "projectId required" }, 400);
+    const r = store.send(b.projectId, {
+      to: b.to,
+      text: b.text,
+      from: b.from ?? null,
+      fromSession: b.sessionId ?? null
+    });
+    if (!r.ok)
+      return c.json(r, 400);
+    const m = r.message;
+    const run2 = m.task ? runner.get(m.task) : m.sessionId ? runner.get(m.sessionId) : null;
+    if (run2 && !run2.endedAt) {
+      const sent = runner.send(run2.id, `[swarm] message from ${m.from ?? "unknown"}: ${m.text}`);
+      if (sent.ok)
+        store.markMessageDelivered(m.id, run2.sessionId);
+    }
+    return c.json({ ok: true, message: store.message(m.id) }, 201);
+  });
   app.get("/v1/dispatch", (c) => {
     const project = c.req.query("project");
     if (!project)
@@ -8453,7 +9214,7 @@ function createApp(store = new Store) {
         await stream2.writeSSE({ id: String(e.seq), event: e.type, data: JSON.stringify(e) });
       }
       await stream2.writeSSE({ event: "ping", data: "" });
-      await new Promise((resolve) => {
+      await new Promise((resolve2) => {
         const off = store.subscribe((e) => {
           stream2.writeSSE({ id: String(e.seq), event: e.type, data: wireJson(e) });
         });
@@ -8461,7 +9222,7 @@ function createApp(store = new Store) {
         stream2.onAbort(() => {
           clearInterval(beat);
           off();
-          resolve();
+          resolve2();
         });
       });
     });
@@ -8471,18 +9232,107 @@ function createApp(store = new Store) {
   app.get("/:file{[a-z0-9-]+\\.(js|css)}", (c) => {
     const f = c.req.param("file");
     const p = join9(WEB_DIR, f);
-    if (!existsSync6(p))
+    if (!existsSync7(p))
       return c.text(`${f} not built \u2014 run: bun run build:web`, 404);
     return c.body(readFileSync4(p, "utf8"), 200, {
       "content-type": MIME[f.split(".").pop() ?? ""] ?? "text/plain"
     });
   });
-  return { app, store, forge: forge2, runner, dispatcher };
+  return { app, store, forge: forge2, runner, dispatcher, workflows: workflows2 };
+}
+
+// packages/daemon/src/demo.ts
+var H = 3600000;
+var iso = (msAgo) => new Date(Date.now() - msAgo).toISOString();
+function isEmpty(store) {
+  return !store.db.query("SELECT 1 FROM sessions LIMIT 1").get();
+}
+function seedDemo(store) {
+  const db = store.db;
+  const project = (id, name, root, icon, color) => db.query("INSERT OR IGNORE INTO projects (id, root, common_dir, name, discovered, created_at, icon, color) VALUES (?, ?, ?, ?, 0, ?, ?, ?)").run(id, root, `${root}/.git`, name, iso(90 * 24 * H), icon, color);
+  project("p_demo1", "acme-app", "/work/acme-app", "\uD83D\uDED2", "c3");
+  project("p_demo2", "acme-site", "/work/acme-site", "\uD83C\uDF10", "c5");
+  const session = (id, pid, agent, title, cwd, branch, startedAgo, lastAgo, state, model) => {
+    db.query(`INSERT OR IGNORE INTO sessions (id, project_id, kind, agent, cwd, branch, title, model, started_at, last_seen_at, last, last_type, last_text, state, tool_calls)
+       VALUES (?, ?, 'interactive', ?, ?, ?, ?, ?, ?, ?, ?, 'tool.completed', ?, ?, ?)`).run(id, pid, agent, cwd, branch, title, model, iso(startedAgo), iso(lastAgo), state === "active" ? "Bash bun test" : "session ended", state === "active" ? "Running the suite before handing off." : "Done \u2014 PR opened, gates green.", state, 40 + Math.floor(Math.random() * 200));
+    let t = startedAgo;
+    let i = 0;
+    while (t > lastAgo) {
+      const out = 300 + Math.floor(Math.random() * 4000);
+      const read = 50000 + Math.floor(Math.random() * 900000);
+      db.query(`INSERT OR IGNORE INTO turns (id, session_id, agent_id, ts, model, effort, sidechain, input, output, cache_write, cache_write_1h, cache_read, thinking, cost_usd, text, tools)
+         VALUES (?, ?, NULL, ?, ?, NULL, 0, ?, ?, ?, 0, ?, ?, ?, ?, '["Bash","Edit"]')`).run(`${id}-t${i}`, id, iso(t), model, 800 + i * 97 % 2000, out, 12000, read, i % 3 === 0 ? 900 : 0, 0.02 + out / 1e6 * 15 + read / 1e6 * 0.3, i % 4 === 0 ? "Tests are green; tightening the error path next." : "");
+      t -= (8 + i * 13 % 30) * 60000;
+      i++;
+    }
+  };
+  session("demo-s1", "p_demo1", "claude-code", "Checkout flow refactor", "/work/acme-app-wt/checkout", "task/checkout", 5 * H, 2 * 60000, "active", "claude-fable-5");
+  session("demo-s2", "p_demo1", "codex", "Fix flaky cart tests", "/work/acme-app", "main", 7 * H, 3 * H, "ended", "gpt-5.2-codex");
+  session("demo-s3", "p_demo1", "gemini", "Payment webhook audit", "/work/acme-app", "main", 26 * H, 22 * H, "ended", "gemini-2.5-pro");
+  session("demo-s4", "p_demo2", "grok", "Landing page rewrite", "/work/acme-site", "task/landing", 30 * H, 25 * H, "ended", "grok-4");
+  session("demo-s5", "p_demo2", "claude-code", "SEO metadata sweep", "/work/acme-site", "main", 50 * H, 47 * H, "ended", "claude-sonnet-5");
+  db.query(`INSERT OR IGNORE INTO claims (project_id, task, owner, worktree, branch, acquired_at, expires_at, released_at, state, actor_kind, actor_id)
+     VALUES ('p_demo1', 'checkout', 'demo-s1', '/work/acme-app-wt/checkout', 'task/checkout', ?, ?, NULL, 'held', 'agent', 'demo-s1')`).run(iso(5 * H), iso(-30 * 60000));
+  db.query(`INSERT OR IGNORE INTO claims (project_id, task, owner, worktree, branch, acquired_at, expires_at, released_at, state, actor_kind, actor_id)
+     VALUES ('p_demo1', 'webhooks', 'alice', '/work/acme-app-wt/webhooks', 'task/webhooks', ?, ?, NULL, 'orphaned', 'human', 'alice')`).run(iso(26 * H), iso(20 * H));
+  const gate = (task, gate2, verdict, rubric, ago, sid) => db.query(`INSERT OR IGNORE INTO gates (project_id, task, gate, verdict, rubric, evidence, session_id, created_at, actor_kind, actor_id)
+       VALUES ('p_demo1', ?, ?, ?, ?, NULL, ?, ?, 'daemon', 'daemon')`).run(task, gate2, verdict, rubric, sid, iso(ago));
+  gate("checkout", "tests", "fail", "ran `bun test` \u2014 exit 1 in 41s", 3 * H, "demo-s1");
+  gate("checkout", "tests", "pass", "ran `bun test` \u2014 exit 0 in 39s", 1 * H, "demo-s1");
+  gate("checkout", "review", "pass", "review: no blocker/major findings", 40 * 60000, null);
+  gate("webhooks", "tests", "pass", "ran `bun test` \u2014 exit 0 in 22s", 22 * H, "demo-s3");
+  const ev = (type, ago, sid, payload) => store.append({
+    ts: iso(ago),
+    type,
+    projectId: "p_demo1",
+    sessionId: sid,
+    payload
+  });
+  ev("incident.opened", 4 * H, "demo-s1", {
+    rule: "pattern_kill",
+    action: "ask",
+    command: "pkill -f vite",
+    reason: "This kills processes by command pattern \u2014 other agents' dev servers match too."
+  });
+  ev("incident.opened", 26 * H, "demo-s3", {
+    rule: "shared_tree",
+    action: "deny",
+    command: "git reset --hard",
+    reason: "Another session (demo-s2) is active in this same checkout."
+  });
+  ev("claim.acquired", 5 * H, "demo-s1", {
+    task: "checkout",
+    owner: "demo-s1",
+    summary: "claim checkout"
+  });
+  ev("pr.opened", 30 * 60000, "demo-s1", {
+    task: "checkout",
+    url: "https://github.com/acme/app/pull/128",
+    summary: "PR #128 opened for checkout"
+  });
+  ev("question.asked", 20 * 60000, "demo-s1", {
+    id: 1,
+    task: "checkout",
+    text: "Coupon codes: keep the legacy endpoint alive for one release, or cut over now?",
+    options: ["Keep one release", "Cut over"],
+    summary: "question #1"
+  });
+  db.query(`INSERT OR IGNORE INTO messages (project_id, session_id, task, kind, text, options, asked_by, created_at)
+     VALUES ('p_demo1', 'demo-s1', 'checkout', 'question', 'Coupon codes: keep the legacy endpoint alive for one release, or cut over now?', '["Keep one release","Cut over"]', 'demo-s1', ?)`).run(iso(20 * 60000));
+  db.query(`INSERT OR IGNORE INTO messages (project_id, session_id, task, kind, text, asked_by, created_at, to_kind, from_session)
+     VALUES ('p_demo1', 'demo-s1', 'checkout', 'message', 'Cart tests are green again \u2014 rebasing on main is safe now.', 'agent demo-s2', ?, 'task', 'demo-s2')`).run(iso(50 * 60000));
+  db.query(`INSERT OR IGNORE INTO handoffs (project_id, task, done, remaining, files, verify, by, session_id, created_at, actor_kind, actor_id)
+     VALUES ('p_demo1', 'webhooks', 'Signature validation + retries done', 'Dead-letter queue wiring', '["src/webhooks.ts","src/queue.ts"]', 'bun test \u2014 118 pass', 'auto:demo-s3', 'demo-s3', ?, 'daemon', 'daemon')`).run(iso(22 * H));
+  db.query(`INSERT OR IGNORE INTO workflow_runs (project_id, task, workflow, step, step_label, steps, state, detail, started_at, updated_at, ended_at, actor_kind, actor_id)
+     VALUES ('p_demo1', 'checkout', 'ship', 2, 'gate:review', '["implement","gate:tests","gate:review","pr"]', 'running', NULL, ?, ?, NULL, 'human', 'demo')`).run(iso(2 * H), iso(10 * 60000));
 }
 
 // packages/daemon/src/bin.ts
 var DEFAULT_PORT2 = process.env.SWARM_PORT ? DEFAULT_PORT : loadConfig().daemon.port;
-var { app, store, runner } = createApp();
+var appHooks = {};
+var { app, store, runner } = createApp(new Store, appHooks);
+if (process.env.SWARM_DEMO === "1" && isEmpty(store))
+  seedDemo(store);
 function serve() {
   const bind = (p) => Bun.serve({ port: p, hostname: "127.0.0.1", idleTimeout: 0, fetch: app.fetch });
   try {
@@ -8494,21 +9344,50 @@ function serve() {
     return bind(0);
   }
 }
-var server = serve();
+var server;
+var restart = () => {
+  console.error("swarmd: restarting into the version on disk\u2026");
+  try {
+    clearInterval(tailer);
+    clearInterval(wtRefresh);
+    clearInterval(pruner);
+  } catch {}
+  try {
+    server.stop(true);
+  } catch {}
+  clearDaemonInfo();
+  const [cmd, ...args] = daemonCommand();
+  if (cmd)
+    Bun.spawn([cmd, ...args], {
+      stdin: "ignore",
+      stdout: "ignore",
+      stderr: "ignore",
+      env: { ...process.env }
+    }).unref();
+  setTimeout(() => process.exit(0), 100);
+};
+appHooks.restart = restart;
+server = serve();
 var port = server.port ?? DEFAULT_PORT2;
 ensureToken();
 writeDaemonInfo({ port, pid: process.pid, version: VERSION, startedAt: new Date().toISOString() });
 var backfillDays = Number(process.env.SWARM_CODEX_BACKFILL_DAYS ?? 30);
 var backfillMs = backfillDays * 24 * 60 * 60000;
-store.tailCodex(backfillMs);
-store.tailGrok(backfillMs);
+var DEMO = process.env.SWARM_DEMO === "1";
+if (!DEMO) {
+  store.tailCodex(backfillMs);
+  store.tailGrok(backfillMs);
+  store.tailGemini(backfillMs);
+}
 var tick = 0;
 var tailer = setInterval(() => {
   tick++;
-  store.tailActive();
-  if (tick % 3 === 0 || store.hasActiveSessions()) {
+  if (!DEMO)
+    store.tailActive();
+  if (!DEMO && (tick % 3 === 0 || store.hasActiveSessions())) {
     store.tailCodex();
     store.tailGrok();
+    store.tailGemini();
   }
   store.reapResources();
   store.reapProcesses();