symbiot 0.43.1 → 0.44.0

package/README.md

@@ -508,6 +508,29 @@ can't do.
   app, so context carries from page to page without re-sending everything.
   Settings → **What Symbiot remembers** lists it, and forgets any of it.
 
+### Lanes: agents hand work to each other
+
+Each agent has its own lane: a repo, or **ops** for everything outside one (this
+computer, accounts, services, your connectors). When an agent needs something
+that's another lane's job, it doesn't stop and it doesn't ask you to do it. It
+writes it to its `.symbiot/HANDOFF.md`, under the lane's name, and Symbiot:
+
+1. starts that lane's agent on it: a repo gets it as a task, the way **Send to
+   repos** does, and ops gets a run of its own;
+2. when that agent is done, puts what it did into the asking agent's
+   `.symbiot/ANSWERS.md` and starts that agent again, so it carries on.
+
+The Agents tab lists the **Handovers**: who handed what to whom, and where it
+stands. A handover to a lane that doesn't exist, or back to the agent's own lane,
+goes back to the agent, not to you. After 4 handovers in a row, the next one isn't
+started, so two lanes can't pass the same job back and forth.
+
+What still reaches you is only what no agent can do: your body (a phone in your
+hand, a cable, which network you're on), your identity or secrets (signing in, a
+2FA code, a token from a provider's console) or a decision that's yours (closing an
+account, spending money, sending something in your name). Every brief tells the
+agent so, and such a question says which: `👤 You (only you: your Meta token): …`.
+
 ## Connect it (once)
 
 Pick the AI you want it to write with:

package/handover.mjs

@@ -0,0 +1,38 @@
+// symbiot — Handover: what every brief says about lanes, and about the steps
+// only the user can do. Each agent works in its own lane (a repo, or ops for
+// everything outside one), and hands what's another lane's job to that lane
+// instead of stopping or asking the user (lanes.mjs runs it). What reaches the
+// user is only what no agent can do, and the brief makes the agent say which.
+// Text and parsing only, no imports: shared by every brief (tasks.mjs
+// buildTasksMd, mind.mjs actBrief) and by lanes.mjs.
+
+const OPS = "ops";
+const MAX_LANES_LISTED = 40;
+
+// The lines a brief gets about lanes. here: this agent's lane; lanes: the others
+// it can hand to (repo folder names).
+function handoverRules(lanes = [], here = "") {
+  const others = [...new Set(lanes.filter((l) => l && l !== here))].slice(0, MAX_LANES_LISTED);
+  return ["## Hand over what's another lane's job",
+    `Each agent has its own lane${here ? `: this one is \`${here}\`` : ""}. When something you need is another lane's job, don't stop, and don't ask the user to do it: hand it over. Write \`.symbiot/HANDOFF.md\` with a \`### \` heading naming the lane, then what's needed, self-contained (names, paths, links, ids) and why. Symbiot starts that lane's agent on it, and its result comes back to you in \`.symbiot/ANSWERS.md\`. Carry on with what doesn't depend on it, and don't tick what does.`,
+    `- \`${OPS}\`: anything outside a repo: this computer (find or install a tool, a JDK, an SDK), accounts and services (cloud, GitHub, DNS, email), the user's connectors.`,
+    `- A repo, by its folder name, for work that belongs in that project${others.length ? `: ${others.map((l) => `\`${l}\``).join(", ")}` : ""}.`,
+    ""];
+}
+// The rule for options in QUESTIONS.md: the user gets only what no agent can do,
+// and the option says which kind it is.
+const ONLY_YOU = "- Only what no agent can do is the user's: their body (a phone in their hand, a cable, which network they're on), their identity or secrets (signing in, a 2FA code, a token from a provider's console) or a decision that's theirs (closing an account, spending money, sending something in their name). Start such an option with `👤 You (only you: <which>):`, e.g. `👤 You (only you: your Meta token): paste it into .env`. Anything an agent could do, yours or another lane's, is never a 👤 step: do it, or hand it over. An option where picking it is enough starts with `🤖 Agent:`. Tag actions only: an option that just reports what the user saw or decides (`it notified me`, `not tried yet`) gets no tag.";
+
+// What an agent handed over: [{ lane, text }] from its .symbiot/HANDOFF.md.
+function parseHandoffs(md) {
+  const out = []; let cur = null;
+  for (const raw of String(md || "").split(/\r?\n/)) {
+    const m = raw.match(/^###\s+`?([^`\s]+)`?\s*$/);
+    if (m) { cur = { lane: m[1].trim(), text: "" }; out.push(cur); continue; }
+    if (/^#{1,2}\s/.test(raw)) { cur = null; continue; }
+    if (cur) cur.text += raw + "\n";
+  }
+  return out.map((h) => ({ lane: h.lane, text: h.text.trim().slice(0, 4000) })).filter((h) => h.lane && h.text);
+}
+
+export { OPS, handoverRules, ONLY_YOU, parseHandoffs };

package/lanes.mjs

@@ -0,0 +1,142 @@
+// symbiot — Lanes: agents hand work to each other, so it keeps moving without
+// you. Each agent has its own lane: a repo, or ops (everything outside one: this
+// computer, accounts, services, connectors; a run of its own, mind.mjs actNow).
+// When one needs another lane's job done, it writes it to its .symbiot/HANDOFF.md
+// (handover.mjs: a "### <lane>" heading, then what's needed). Every 20 seconds
+// the app (lanesTick) starts that lane's agent on it: a repo lane gets it as a
+// task and a run there, the way Send to repos does; ops gets a run of its own.
+// When the agent that took it over is done, what it did goes back to the agent
+// that asked, in its .symbiot/ANSWERS.md, and that agent is started again to
+// carry on. You only see what no agent can do, as a question in the Agents tab.
+//
+// The ledger, ~/.config/symbiot/lanes.json: { handoffs: [{ id, key, from: { lane,
+// path }, to: { lane, path }, text, at, chain, status, job?, task?, error?,
+// result?, reportedAt? }] }. status: started, held (that lane's agent was busy:
+// it starts when it's free), done (reported back) or error (reported back too).
+// chain: how many handovers in a row led here; past MAX_CHAIN it stops, so two
+// lanes can't hand the same thing back and forth forever.
+import { join, basename } from "node:path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, chmodSync } from "node:fs";
+import { createHash, randomBytes } from "node:crypto";
+import { CONFIG_DIR, loadTasks } from "./core.mjs";
+import { runHandoff, runningHandoff } from "./agents.mjs";
+import { addTask, pushTasks } from "./tasks.mjs";
+import { actNow } from "./mind.mjs";
+import { repoPathMap } from "./scan.mjs";
+import { OPS, parseHandoffs } from "./handover.mjs";
+
+const LEDGER = join(CONFIG_DIR, "lanes.json");
+const ACT_DIR = join(CONFIG_DIR, "drafts");
+const MAX_KEEP = 200, MAX_CHAIN = 4, TAIL = 1500;
+
+function loadLedger() { try { const d = JSON.parse(readFileSync(LEDGER, "utf8")); return { handoffs: Array.isArray(d.handoffs) ? d.handoffs : [] }; } catch { return { handoffs: [] }; } }
+// It can name accounts and what's in them: yours only (0600).
+function saveLedger(d) { try { mkdirSync(CONFIG_DIR, { recursive: true }); writeFileSync(LEDGER, JSON.stringify({ handoffs: d.handoffs.slice(-MAX_KEEP) }, null, 1), { mode: 0o600 }); try { chmodSync(LEDGER, 0o600); } catch {} return true; } catch { return false; } }
+const readSym = (path, f) => { try { return readFileSync(join(path, ".symbiot", f), "utf8"); } catch { return ""; } };
+const firstLine = (t) => String(t || "").split("\n").find((l) => l.trim()) || "";
+
+// A folder's lane: the repo it is, or ops for a run of its own.
+function laneOf(path, map) {
+  if (path.startsWith(ACT_DIR)) return OPS;
+  const hit = Object.entries(map).find(([, p]) => p === path);
+  return hit ? hit[0] : basename(path);
+}
+// The lane a handover names, as a folder: a repo (any case), or ops. null if none.
+function laneTarget(lane, map) {
+  if (lane.toLowerCase() === OPS) return { lane: OPS, path: "" };
+  const name = Object.keys(map).find((n) => n.toLowerCase() === lane.toLowerCase());
+  return name ? { lane: name, path: map[name] } : null;
+}
+
+// Pick up what a folder's agent handed over and start the lanes it named.
+// Each handover is started once (its key: where from, which lane, what).
+function dispatch(path, { map = repoPathMap(), act = actNow, run = runHandoff, add = addTask, push = pushTasks, now = Date.now(), ledger = loadLedger() } = {}) {
+  const asked = parseHandoffs(readSym(path, "HANDOFF.md")); if (!asked.length) return [];
+  const from = { lane: laneOf(path, map), path }, parent = ledger.handoffs.filter((h) => h.to.path === path).pop(), chain = (parent ? parent.chain : 0) + 1;
+  const started = [];
+  for (const h of asked) {
+    const key = createHash("sha1").update(path + "\n" + h.lane.toLowerCase() + "\n" + h.text).digest("hex").slice(0, 16);
+    if (ledger.handoffs.some((x) => x.key === key)) continue;
+    const e = { id: randomBytes(4).toString("hex"), key, from, to: { lane: h.lane, path: "" }, text: h.text, at: now, chain, status: "started" };
+    const to = laneTarget(h.lane, map);
+    if (chain > MAX_CHAIN) Object.assign(e, { status: "error", error: `${MAX_CHAIN} handovers in a row led here, so this one wasn't started. Do it yourself, or ask the user.` });
+    else if (!to) Object.assign(e, { status: "error", error: `There's no lane called ${h.lane}. Lanes: ops, or a repo: ${Object.keys(map).slice(0, 30).join(", ")}.` });
+    else if (to.lane.toLowerCase() === from.lane.toLowerCase()) Object.assign(e, { status: "error", error: `${to.lane} is your own lane: do it yourself.` });
+    else if (to.lane === OPS) {
+      const r = act(h.text, { title: `handed over by ${from.lane}`, context: `${from.lane}'s agent (in ${path}) handed this over, and carries on once it's done.`, now });
+      if (r.error) Object.assign(e, { status: "error", error: r.error });
+      else Object.assign(e, { to: { lane: OPS, path: r.dir }, job: r.job });
+    } else {
+      const t = add(`${h.text.replace(/\s+/g, " ").slice(0, 900)} (handed over by ${from.lane})`, to.lane);
+      if (t.error) Object.assign(e, { status: "error", error: t.error });
+      else {
+        push({ repo: to.lane });
+        const r = run(to.path) || {};
+        Object.assign(e, { to, task: t.id, status: r.id && !r.busy && !r.blocked ? "started" : "held", ...(r.id ? { job: r.id } : {}) });
+      }
+    }
+    ledger.handoffs.push(e); started.push(e);
+  }
+  return started;
+}
+
+// What an agent said last: its log after the newest run's header.
+function lastWords(path) {
+  const log = readSym(path, "agent.log"), at = log.lastIndexOf("\n=== "); if (at < 0) return "";
+  const run = log.slice(at).split("\n").slice(3).join("\n").trim(); // past the header and the command
+  return run.length > TAIL ? "…" + run.slice(-TAIL) : run;
+}
+// When the newest run in a folder started (its log header), or 0.
+function lastRunStart(path) { const log = readSym(path, "agent.log"), m = [...log.matchAll(/^=== .* (\d{4}-\d\d-\d\dT[\d:.]+Z) ===$/gm)].pop(); return m ? Date.parse(m[1]) || 0 : 0; }
+const openQuestions = (path) => /^###\s+/m.test(readSym(path, "QUESTIONS.md").split(/^##\s+Suggestions/m)[0]);
+
+// Is it done? Ops: its run ended (ticked or not). A repo: the task it was given
+// is ticked or its run ended, and no agent is working there. Waiting on the
+// user's answer to a question there isn't done: that's in the Agents tab.
+function outcome(e, { tasks = loadTasks(), running = runningHandoff } = {}) {
+  if (e.status === "error") return { text: `Couldn't hand it over: ${e.error}` };
+  const p = e.to.path; if (!p || running(p)) return null;
+  if (lastRunStart(p) < e.at) return null; // its run hasn't started yet (held while that lane was busy)
+  if (openQuestions(p) && !/^- \[x\]/im.test(readSym(p, "TASKS.md"))) return null; // waiting on the user, in that lane
+  const words = lastWords(p);
+  if (e.to.lane === OPS) {
+    const ticked = /^- \[x\]/im.test(readSym(p, "TASKS.md"));
+    return { text: `${ticked ? "Done" : "It stopped without finishing"} (the ops agent).${words ? `\n\nWhat it said:\n${words}` : ""}` };
+  }
+  const t = tasks.find((x) => x.id === e.task);
+  const done = t && (t.review || t.done || t.archived);
+  return { text: `${done ? `Done in ${e.to.lane}: the task is ticked, and its changes wait for the user's review in Symbiot` : `${e.to.lane}'s agent stopped without ticking it`}.${words ? `\n\nWhat it said:\n${words}` : ""}` };
+}
+// Tell the agent that asked: the result as an answer in its ANSWERS.md, then
+// start it again to carry on (unless it's still running: it reads it next time).
+function report(e, o, { run = runHandoff, running = runningHandoff, now = Date.now() } = {}) {
+  const p = e.from.path, file = join(p, ".symbiot", "ANSWERS.md");
+  try {
+    mkdirSync(join(p, ".symbiot"), { recursive: true });
+    const had = existsSync(file) ? readFileSync(file, "utf8") : "# Answers\nAnswers to your questions, and what other lanes did with what you handed over, newest last.\n";
+    writeFileSync(file, `${had.replace(/\s*$/, "")}\n\n### Handed over to ${e.to.lane}: ${firstLine(e.text).slice(0, 120)}\n${o.text}\n_answered by symbiot (handover) ${new Date(now).toISOString().slice(0, 10)}_\n`);
+  } catch { return false; }
+  if (!running(p)) run(p, { force: true });
+  return true;
+}
+
+// One pass: start what's been handed over, from every lane, then report back
+// what's done. The app runs it every 20 seconds.
+function lanesTick({ map = repoPathMap(), act = actNow, run = runHandoff, running = runningHandoff, add = addTask, push = pushTasks, tasks, now = Date.now() } = {}) {
+  const ledger = loadLedger();
+  let acts = []; try { acts = readdirSync(ACT_DIR).filter((d) => d.startsWith("act-")).map((d) => join(ACT_DIR, d)); } catch {}
+  const started = [];
+  for (const path of [...Object.values(map), ...acts]) if (existsSync(join(path, ".symbiot", "HANDOFF.md"))) started.push(...dispatch(path, { map, act, run, add, push, now, ledger }));
+  const t = tasks || loadTasks(), reported = [];
+  for (const e of ledger.handoffs) {
+    if (e.reportedAt || running(e.from.path)) continue; // the one that asked reads it when it's started again, so not mid-run
+    const o = outcome(e, { tasks: t, running }); if (!o) continue;
+    if (report(e, o, { run, running, now })) { e.reportedAt = now; if (e.status !== "error") e.status = "done"; e.result = o.text.slice(0, 600); reported.push(e); }
+  }
+  if (started.length || reported.length) saveLedger(ledger);
+  return { started, reported };
+}
+// The Agents tab's list: newest first.
+function lanesState() { return { handoffs: loadLedger().handoffs.slice(-30).reverse().map((e) => ({ id: e.id, from: e.from.lane, to: e.to.lane, text: firstLine(e.text).slice(0, 160), at: e.at, status: e.status, ...(e.error ? { error: e.error } : {}), ...(e.result ? { result: e.result } : {}) })) }; }
+
+export { LEDGER, MAX_CHAIN, loadLedger, laneOf, lastRunStart, dispatch, outcome, report, lanesTick, lanesState };

package/mind.mjs

@@ -24,6 +24,8 @@ import { VERSION, CONFIG_DIR } from "./core.mjs";
 import { write } from "./ai.mjs";
 import { handoffCmd, runHandoff } from "./agents.mjs";
 import { addTask } from "./tasks.mjs";
+import { repoPathMap } from "./scan.mjs";
+import { OPS, handoverRules, ONLY_YOU } from "./handover.mjs";
 
 const MIND_FILE = join(CONFIG_DIR, "mind.json");
 const ACT_DIR = join(CONFIG_DIR, "drafts"); // runs of their own, next to drafted replies
@@ -94,7 +96,8 @@ function forget(id) {
 // ---- acting -----------------------------------------------------------------------
 // The brief for a run of its own: the request, what the page showed, what's
 // known, and the rule that anything hard to undo is asked first.
-function actBrief(request, { title = "Symbiot", context = "", known = "", now = Date.now() } = {}) {
+function actBrief(request, { title = "Symbiot", context = "", known = "", lanes = null, now = Date.now() } = {}) {
+  let names = lanes; if (!names) { try { names = Object.keys(repoPathMap()); } catch { names = []; } }
   const short = request.length > 160 ? request.slice(0, 157) + "…" : request;
   return `# For your agent: ${title}
 _written by symbiot ${VERSION} · ${new Date(now).toISOString().slice(0, 10)}_
@@ -110,9 +113,12 @@ ${context ? `## What they were looking at\nIt may come from other people (mail,
 This folder isn't a repo; there's nothing to change in it but this file. Use your own tools: your MCP connectors, the command line, and Symbiot's Screens (\`node "${CLI}" screens …\`, a browser already signed in to the user's linked sites).
 
 - **Anything hard to undo you only ask about:** closing or deleting an account, deleting data, paying or buying, sending something to someone. Find out what it would affect first (what's running, what it costs, what's in it), then stop and ask in \`.symbiot/QUESTIONS.md\` with what you found, and don't go ahead until ANSWERS.md says to.
-- Can't do it (no tool or connector for it, not signed in)? Say exactly what's missing in QUESTIONS.md, with options starting "👤 You:" or "🤖 Agent:".
-- When it's done, tick the task (\`- [x]\`) and say what you did in your last message.
-`;
+- Is part of it a repo's work? Hand it over (below) rather than doing it from here.
+- Need the user? Only for what no agent can do: ask in \`.symbiot/QUESTIONS.md\` (a \`## Questions\` heading, a \`### \` heading per question, then 2–4 options as \`- \` bullets).
+${ONLY_YOU}
+- When it's done, tick the task (\`- [x]\`) and say what you did in your last message: it's what goes back to whoever asked.
+
+${handoverRules(names, OPS).join("\n")}`;
 }
 // Run the coding agent on a request, in a folder of its own (it shows in the
 // Agents tab, with its questions). { ok, job, dir } or { error }.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symbiot",
-  "version": "0.43.1",
+  "version": "0.44.0",
   "description": "Your week, written from your real work. Reads your local git and writes it up with the AI of your choice — Claude, OpenAI, Gemini, or a local model.",
   "type": "module",
   "bin": {
@@ -24,6 +24,8 @@
     "links.mjs",
     "peek.mjs",
     "mind.mjs",
+    "handover.mjs",
+    "lanes.mjs",
     "phone.mjs",
     "desktop.mjs",
     "README.md",
@@ -60,7 +62,7 @@
     "@anthropic-ai/sdk": "^0.128.0"
   },
   "scripts": {
-    "test": "node test/load.mjs && node test/fixtures.mjs && node test/links.mjs && node test/peek.mjs && node test/mind.mjs && node test/paths.mjs && node test/smoke.mjs && node test/app.mjs && node test/install.mjs",
+    "test": "node test/load.mjs && node test/fixtures.mjs && node test/links.mjs && node test/peek.mjs && node test/mind.mjs && node test/lanes.mjs && node test/paths.mjs && node test/smoke.mjs && node test/app.mjs && node test/install.mjs",
     "lint": "eslint ."
   },
   "devDependencies": {

package/server.mjs

@@ -22,6 +22,7 @@ import { weeklyState, setWeekly, runWeekly, startWeekly, autostartState, setAuto
 import { watchState, addWatch, setEvery, removeWatch, clearNews, seenWatch, checkWatch, startWatches, setBrief, draftReply, openChat, watchBoard, boardChat, clearBoardChat } from "./watch.mjs";
 import { linksState, linkSite, checkLink, unlinkSite } from "./links.mjs";
 import { mindState, forget } from "./mind.mjs";
+import { lanesTick, lanesState } from "./lanes.mjs";
 import { phoneState, setPhoneLink, newCode, unpairPhone, pairComputer, forgetComputer, pollComputer, startPhone } from "./phone.mjs";
 
 // The in-app update installs the EXACT newest version (not the `latest` tag, which
@@ -220,6 +221,8 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
       if (u.pathname === "/api/links/link" && req.method === "POST") { const b = await readBody(req); return json(res, await linkSite(String(b.id || ""))); }
       if (u.pathname === "/api/links/check" && req.method === "POST") { const b = await readBody(req); return json(res, await checkLink(String(b.id || ""))); }
       if (u.pathname === "/api/links/unlink" && req.method === "POST") { const b = await readBody(req); return json(res, unlinkSite(String(b.id || ""))); }
+      // Lanes (lanes.mjs): work agents handed to each other, and where it stands.
+      if (u.pathname === "/api/lanes") return json(res, lanesState());
       // Watch (watch.mjs): a mapped page read again every few minutes, and what's new on it.
       if (u.pathname === "/api/watch") return json(res, watchState());
       if (u.pathname === "/api/watch/board") return json(res, watchBoard(Math.min(168, Math.max(1, Number(u.searchParams.get("hours")) || 24))));
@@ -297,6 +300,7 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
   startWatches(); // pages you watch (Screens → Watch), read every few minutes
   startPhone(); // Watch on your phone: the computer listens if it's switched on, the phone asks if it's paired
   setInterval(() => { try { startWaiting(); } catch {} }, 20000).unref(); // a run that waits for your step starts once the file it names changes
+  setInterval(() => { try { lanesTick(); } catch {} }, 20000).unref(); // agents hand work to other lanes, and hear back when it's done
 }
 
 export { updateCmd, BROWSER_KEEP, startApp, askRunningApp, isAppRunningWeekly };

package/tasks.mjs

@@ -7,6 +7,7 @@ import { join } from "node:path";
 import { readFileSync, writeFileSync, existsSync, readdirSync } from "node:fs";
 import { randomBytes } from "node:crypto";
 import { VERSION, LATEST_VERSION, REGISTRY, semverGt, loadConfig, saveConfig, loadTasks, saveTasks, taskWords, sameTask, uniqueTasks, sh, hasCmd, repoState } from "./core.mjs";
+import { handoverRules, ONLY_YOU } from "./handover.mjs";
 import { QUESTIONS_MAX, OPTIONS_SHOWN, IDEAS_SHOWN, handoffCmd, runningHandoff, writeTasks, startHeldTasks } from "./agents.mjs";
 import { gitDefaultBranch } from "./drift.mjs";
 import { repoPathMap, openWork, detectRepo } from "./scan.mjs";
@@ -435,10 +436,11 @@ function buildTasksMd(name, ctx, list) {
   const keys = Object.keys(byType).sort((a, b) => TASK_ORDER.indexOf(a) - TASK_ORDER.indexOf(b));
   for (const ty of keys) { L.push(`### ${ty}`); for (const t of byType[ty]) L.push(`- [ ] ${t.text}`); L.push(""); }
   L.push("## When you finish an item", "- Tick it here (`- [x]`) as soon as it's done — that's how it reaches review. Ticking doesn't archive it: the user approves it in Symbiot, which commits it on a branch and opens a PR.", "- Leave your changes **uncommitted**, and don't tick anything you didn't finish or couldn't verify.", "");
+  L.push(...handoverRules(ctx.lanes || [], name));
   L.push("## If you need a decision, or have ideas", "You may be running unattended, so you can't ask in chat. Write `.symbiot/QUESTIONS.md` instead: Symbiot shows it to the user on your block in its Agents tab, and their answers come back in `.symbiot/ANSWERS.md` (read that first if it exists).",
     `- At most ${QUESTIONS_MAX} questions, under a \`## Questions\` heading. Each is a \`### \` heading, then a line of context, then exactly ${OPTIONS_SHOWN} options as \`- \` bullets, the one you recommend first, marked \`(recommended)\`. Symbiot shows only the first ${OPTIONS_SHOWN}; the user can always answer in their own words.`,
     "- Judge the options before you ask. Most people pick the recommended option without weighing the other, and Symbiot works for a whole company (developers, sales, everyone), not one person, so the choice is really yours. Both options must be good routes to the best solution, never filler or one you wouldn't take. Each says in plain words, with no jargon, what it does and what it changes from then on for the project, the people working on it and the company. Recommend the one that's best for, in this order, the company, the people doing the work, then the task's goal. Base that on evidence you can check here (git history, tests, logs, how it's used, the answers so far), not on what's quickest, and give that evidence in the context line in a sentence.",
-    "- Start every option with who acts, because the user reads it as something they'd be agreeing to do: `👤 You:` when they have to do something (a setting, a click, a command), `🤖 Agent:` when picking it is enough and the next run does the work. If it takes both, put their step first: `👤 You: allow npm install in Settings. 🤖 Agent: the next run adds ESLint`. Tag actions only: an option that just reports what the user saw or decides (`it notified me`, `not tried yet`, `keep it as it is`) gets no tag.",
+    ONLY_YOU,
     "- A `👤 You:` answer holds the next run back until the user's step is done. If their step changes a file, name the file in backticks (`.env`, `~/.termux/termux.properties`): the next run starts once it changes.",
     "- If a step needs a release that isn't out yet, name its version in the question (\"Once 0.41.0 is installed: …\"). Symbiot shows it next to the installed and npm versions, and holds back an answer that starts \"Done\" until that release is out and installed.",
     `- Ideas, options or follow-ups outside these tasks go under \`## Suggestions\` as \`- \` bullets. The user can add them to their tasks in one click, and often adds every one, so judge them the same way: only ideas you'd recommend, best first, each saying what it changes and why it's worth doing. Symbiot shows them ${IDEAS_SHOWN} at a time.`,
@@ -472,7 +474,7 @@ function pushTasks(filter) {
       if (st.behind) risk.push(`${st.behind} behind upstream on ${st.branch}`);
       if (st.dirty && !st.stale) risk.push(`${st.dirty} uncommitted (${st.mod} mod / ${st.del} del / ${st.add} new)`);
       // held: an agent is still running there, so it lands when that one exits
-      const held = writeTasks(path, buildTasksMd(name, { branch: st.branch, commits, open, drift: risk, stack }, list));
+      const held = writeTasks(path, buildTasksMd(name, { branch: st.branch, commits, open, drift: risk, stack, lanes: Object.keys(byName) }, list));
       written.push({ name, file: join(path, ".symbiot", "TASKS.md"), path, count: list.length, held });
     } catch (e) { unresolved.push({ name, count: list.length, error: String((e && e.message) || e) }); }
   }

package/ui.mjs

@@ -220,6 +220,7 @@ label.check input{width:auto}
 <section id="panel-agents" class="hidden">
 <div class="row"><span class="muted">Agents Symbiot has handed work to — live status and output. Questions, options and ideas an agent leaves for you show up on its block, whichever model it runs.</span><button class="ghost" id="agentsrefresh" style="margin-left:auto">Refresh</button></div>
 <div id="agentsmsg"></div>
+<div id="laneslist"></div>
 <div id="agentslist"></div>
 </section>
 <section id="panel-drift" class="hidden">
@@ -564,7 +565,12 @@ return "<div class='aq'><h4>&#9208; Waiting on your step</h4><div class='qt'>&#1
 function wireWaits(el){el.querySelectorAll('.wstart').forEach(function(btn){btn.addEventListener('click',function(){var a=agentById(btn.getAttribute('data-id'));if(!a)return;btn.disabled=true;
 api('/api/open',{path:a.path,force:true}).then(function(x){var msg=document.getElementById('agentsmsg');msg.innerHTML=x&&x.opened?"<div class='note ok'>&#10003; Started your agent in <b>"+esc(a.name)+"</b>.</div>":"<div class='note err'>"+esc(a.name)+": "+(x&&x.busy?"an agent is already running there.":"it didn&#39;t start. Check the command in Settings.")+"</div>";loadAgents();}).catch(function(e){btn.disabled=false;document.getElementById('agentsmsg').innerHTML="<div class='note err'>"+esc(String((e&&e.message)||e))+"</div>";});});});}
 function answering(){var f=document.activeElement;return !!(f&&f.closest&&f.closest('.aq'));}
-function loadAgents(){api('/api/agents').then(function(list){var el=document.getElementById('agentslist');
+// Handovers (lanes.mjs): what one lane's agent handed to another, and where it stands.
+var LANEWORD={started:'working on it',held:'queued: that lane is busy',done:'done, reported back',error:"couldn't hand over"};
+function loadLanes(){api('/api/lanes').then(function(d){var el=document.getElementById('laneslist');if(!el||!d)return;var hs=d.handoffs||[];
+el.innerHTML=hs.length?"<div class='tgroup'>Handovers <span class='tcount'>"+hs.length+"</span></div>"+hs.slice(0,12).map(function(h){
+return "<div class='task' title='"+escQ(h.result||h.error||h.text)+"'><span class='t'><b>"+esc(h.from)+"</b> &rarr; <b>"+esc(h.to)+"</b>: "+esc(h.text)+"</span><span class='rp'"+(h.status==='error'?" style='color:var(--amber)'":"")+">"+esc(LANEWORD[h.status]||h.status)+"</span></div>";}).join(''):'';});}
+function loadAgents(){loadLanes();api('/api/agents').then(function(list){var el=document.getElementById('agentslist');
 if(!list||!list.length){AGENTLIST=[];el.innerHTML="<div class='muted' style='margin-top:12px'>No agents yet. In <b>Tasks</b>, tick ideas and hit <b>Send to repos</b> (with an agent command set in Settings) &mdash; you'll watch it work here.</div>";stopAgentsPoll();return;}
 var anyRunning=list.some(function(a){return a.status==='running';});
 if(answering()){stopAgentsPoll();if(anyRunning&&current==='agents')agentsTimer=setTimeout(loadAgents,2000);return;} // don't re-render under someone typing an answer