symbiot 0.54.1 → 0.54.3

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 What each Symbiot release brought, newest first. When Approve bumps the version, it writes that release here from the tasks it approved, worded as release notes by your connected AI (or in the tasks' own words without one). The app shows the releases newer than yours under "What's new" when it offers an update, and once more after you update.
 
+## 0.54.3 — 2026-10-07
+
+- Added questions on Home for stuck or failed agent runs, so you can allow access, skip, or run them again right there.
+- Added a ready picture to post drafts whose idea is a screen of an app you run locally; keep it or remove it.
+- Changed post drafting to try once more by itself when every draft gets dropped for claiming things git doesn't show.
+- Added a separate sandbox for trying Symbiot's first-run setup without touching your real settings, drafts or files.
+- Fixed Orca losing track of a repo when a handover renames its folder; Symbiot now adds it again at the new location.
+- Fixed reply tracking treating a signed-out inbox as watched; Home now asks you to sign in again so replies aren't missed.
+- Added a "Where your files disagree" alert under Watching on Home when your files contradict each other on something important.
+
+## 0.54.2
+
+- **Lighter without a graphics card.** When the liquid is drawn by the CPU (no GPU, or a headless browser like the ones agents check Symbiot's screens in), it used 6 cores or more. Now it draws at a third of the resolution, without the breathing, and only when something actually moved, at most 20 times a second: about a third of the CPU. It does the same when your system asks for less motion. With a graphics card, Home also draws half as often at rest and a sixth as often behind an open panel, where it barely shows.
+
 ## 0.54.1
 
 - **No more lag from a big agent log.** An agent's log keeps every run and everything it reads, screenshots included; one reached 144 MB, and Symbiot reread all of it on almost every refresh, so the app stalled for 5–28 seconds at a time and ate a core. Now it reads only the newest run, from the end of the file, and keeps it until the file changes. A log past 8 MB starts afresh at the next run, with the old one kept as `agent.log.old`.

package/README.md

@@ -387,7 +387,10 @@ preset only fills in the command box; the saved command is what runs.
 - **Orca IDE** (any OS): opens the repo in Orca — either just the repo, to use
   Orca's own agent, or with Claude running in a new tab (allowed `npm test` and
   `node` like the Claude preset, and upgraded the same way). It launches Orca if
-  it's closed and waits for it to be ready first.
+  it's closed and waits for it to be ready first. When a handover renames a
+  repo's folder, Symbiot adds it to Orca again at its new path (matched by its
+  GitHub remote, else its name). Orca keeps the old entry, marked missing, until
+  you remove it there.
 - **Editors — opens only, no review:** VS Code, Cursor, Windsurf, Zed, Sublime
   Text, IntelliJ IDEA, Neovim (on macOS, also found as `.app` bundles when the CLI
   isn't on your PATH). They just open the repo. Nothing comes back for review unless
@@ -575,6 +578,15 @@ and the blob dissolves. More than fit across go on a second page. Clicking the o
 questions and its Approve under **Needs you here** at the top of its tasks, with its
 handovers that are waiting; an ops run's question on its block in Agents.
 
+What stopped and can't go on without you is a question there too, on its lane.
+A handover that couldn't start (an ops run, limited to its own folder, handed
+"needs a run that can edit `~/Company`" to ops) asks **Allow this run access to
+~/Company?**: **Allow** starts a run of its own on it, allowed to read, edit and
+move files in that folder (that run only), and what it does goes back to the agent
+that asked; **Skip** lets it go, and that agent reads that you skipped it. It asks
+for 3 days, or until the same thing goes through another way. A run that ended in
+an error asks **Run it again?** for a day, until another run starts there.
+
 Under the band, around the core, are the parts of the app, grouped the
 **P.A.R.A.** way, each group a row with its name at its start, always in the same
 place and order:
@@ -678,10 +690,22 @@ and nothing else. **It never posts by itself**, and it doesn't schedule.
   recent posts in Symbiot's signed-in browser. Without examples it doesn't draft.
 - **Only what git shows.** Your AI gets the week as numbered facts and must say
   which ones each post uses. A post that names a number, version, name or user
-  count the facts don't show is sent back once, then dropped.
+  count the facts don't show is sent back once, then dropped. When every draft is
+  dropped, Symbiot tries once more from the start by itself before giving up.
 - **You approve each one.** The drafts wait on the **Dashboard** with **Approve**,
   **Edit** and **Skip**. Approve copies the post to your clipboard and opens
   LinkedIn's share box: you paste it and post it yourself.
+- **Pictures and videos.** Each draft says in a line what picture or short video
+  would show it best. Add one of yours (**Add picture or video**: PNG, JPG, GIF,
+  MP4, MOV, WebM), or click **From a page** and give a web address (your app on
+  `localhost` works) to **Take a picture** of it, sharp enough for a feed, or
+  **Record a clip**: 5–30 seconds of it, scrolling slowly down, as an MP4 (needs
+  `ffmpeg`). A post takes a video or up to 20 pictures, as LinkedIn does. They're
+  copies, kept in `~/.config/symbiot/post-media/`; Approve opens their folder for
+  you to add them with LinkedIn's photo or video button. A draft whose idea is a
+  screen of an app you run here (listening on `localhost`, started in that repo's
+  folder, or Symbiot's own app: "the new Reports view" opens Reports) arrives with
+  its picture already on it: keep it or remove it.
 - **Everything is logged** in `~/.config/symbiot/posts-log.jsonl`: each draft,
   edit, approval and skip, with its text, date and platform.
 - **Replies.** Linked LinkedIn is watched like an inbox: new comments and mentions
@@ -695,6 +719,9 @@ symbiot post                    # draft this week's 3 posts
 symbiot post list               # the drafts waiting on you
 symbiot post approve <id>       # copy it, and get LinkedIn's share box (--open opens it)
 symbiot post edit <id> "text"   # change a draft's words
+symbiot post add <id> <file>    # put a picture or video of yours on it
+symbiot post page <id> <page>   # a picture of a web page on it (--clip: a short video)
+symbiot post remove <id> <m>    # take a picture or video off it
 symbiot post skip <id>          # drop one
 symbiot post log                # everything that happened
 ```
@@ -765,7 +792,9 @@ Every brief also tells the agent what else it can leave in `.symbiot/`:
   gets it as a task and its agent starts, told what was asked for and what to do
   next. The task it's for says so in its chat, and you get a notification. The
   Dashboard lists **Waiting on replies**, with **Stop waiting** on each. Anything
-  the reply leaves for you to decide comes back as that agent's question.
+  the reply leaves for you to decide comes back as that agent's question. While
+  one waits and nothing can see the reply (no inbox watched and Email off, or the
+  watched inbox signed out), Home and the Dashboard say so.
 - **A report** (findings, an audit, a plan, a pitch): any `.md` named for what it
   is, with a `# ` title. **Reports** in the app lists every one your runs left,
   in your repos and in runs of their own, newest first, unread ones marked; click
@@ -861,6 +890,8 @@ CSV and Markdown tables, front matter and "Owner:" lines, and examples are never
 used as facts. The list, most pressing first and each with its files, is under
 **Settings → Knowledge folders**; it's checked again whenever a file changes, and
 **Check again** does it now. It's kept in `~/.config/symbiot/checks.json`, yours only.
+A clash that matters (a deadline on someone's leave or a holiday, a renewal or
+price told two ways) also shows on Home, under Watching, until you open it.
 
 - **Examples aren't facts.** Say which paths in a folder hold worked examples
   (`--examples templates/,active/`, or the second box in Settings; `templates/`

package/agents.mjs

@@ -885,8 +885,8 @@ function agentsList() {
     const { tail, work, progress } = workOf(e.path, readRunLog(e.log));
     const first = !seen.has(e.path); seen.add(e.path);
     const facts = first && e.status !== "running" ? factsOf(e.path) : [];
-    return { id: e.id, name: e.name, path: e.path, status: e.status, elapsed: (e.endedAt || Date.now()) - e.startedAt, exitCode: e.exitCode, tail, work, progress, changed: agentChanges(e.path, e.startedAt), ask: first ? agentQuestions(e.path, e.name) : null, held: first ? heldTasks(e.path) : null, waiting: first && e.status !== "running" ? waitingFor(e.path) : null, remember: facts.length ? facts : null, fromHeld: !!e.fromHeld };
+    return { id: e.id, name: e.name, path: e.path, status: e.status, startedAt: e.startedAt, endedAt: e.endedAt, elapsed: (e.endedAt || Date.now()) - e.startedAt, exitCode: e.exitCode, tail, work, progress, changed: agentChanges(e.path, e.startedAt), ask: first ? agentQuestions(e.path, e.name) : null, held: first ? heldTasks(e.path) : null, waiting: first && e.status !== "running" ? waitingFor(e.path) : null, remember: facts.length ? facts : null, fromHeld: !!e.fromHeld };
   }).concat(earlierRuns());
 }
 
-export { FACTS, factsOf, knownRun, withStream, workOf, HANDOFFS, HANDOFF_PROMPT, QUESTIONS_MAX, OPTIONS_SHOWN, IDEAS_SHOWN, shSingle, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, grantAgent, grantRule, allowTool, claudeConnectors, withConnectors, linkedConnectors, connectorsLine, connectorsInfo, fillHandoff, runHandoff, PARKED_NOTE, parkedPaths, isParked, parkLane, agentMissing, blockedAgain, runningHandoff, loadRuns, earlierRuns, namedFiles, waitingFor, startWaiting, writeTasks, droppedTasks, releaseHeldTasks, startHeldTasks, detectHandoffs, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, track, agentChanges, parseQuestions, suggestionTarget, skipIdea, agentQuestions, answerQuestions, agentsList , autoAllow, autoAllowSweep, allowlistInWork, inWork, withScope , withTrust, resumeFor, noteSession, trustFull, GUARD_SETTINGS };
+export { FACTS, factsOf, knownRun, withStream, workOf, HANDOFFS, HANDOFF_PROMPT, QUESTIONS_MAX, OPTIONS_SHOWN, IDEAS_SHOWN, shSingle, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, grantAgent, grantRule, allowTool, claudeConnectors, withConnectors, linkedConnectors, connectorsLine, connectorsInfo, fillHandoff, runHandoff, PARKED_NOTE, parkedPaths, isParked, parkLane, agentMissing, blockedAgain, runningHandoff, loadRuns, earlierRuns, namedFiles, waitingFor, startWaiting, writeTasks, droppedTasks, releaseHeldTasks, startHeldTasks, detectHandoffs, findOrcaCli, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, track, agentChanges, parseQuestions, suggestionTarget, skipIdea, agentQuestions, answerQuestions, agentsList , autoAllow, autoAllowSweep, allowlistInWork, installAllowlist, inWork, withScope , withTrust, resumeFor, noteSession, trustFull, GUARD_SETTINGS };

package/checks.mjs

@@ -647,5 +647,20 @@ function checksState({ file = CHECKS_FILE } = {}) {
   try { const d = JSON.parse(readFileSync(file, "utf8")); return { at: d.at || 0, clashes: d.clashes || [], counts: d.counts || {}, officeDays: d.officeDays || [], folders: d.folders || [], ms: d.ms || 0 }; }
   catch { return { at: 0, clashes: [], counts: {}, officeDays: [], folders: [], ms: 0 }; }
 }
+// Home's "Where your files disagree" droplet: the high clashes (a deadline on
+// someone's leave or a holiday, a renewal or price told two ways) you haven't
+// opened from it yet. Opening it marks them seen (checks-seen.json), so the same
+// clash reaches you once; a new one, or one that changes, comes back.
+const SEEN_FILE = join(CONFIG_DIR, "checks-seen.json");
+const clashKey = (c) => c.kind + "|" + c.text;
+function seenClashes({ file = SEEN_FILE } = {}) { try { const d = JSON.parse(readFileSync(file, "utf8")); return Array.isArray(d) ? d : []; } catch { return []; } }
+function newClashes({ state = checksState(), seen = seenClashes() } = {}) {
+  const s = new Set(seen);
+  return (state.clashes || []).filter((c) => c.severity === "high" && !s.has(clashKey(c)));
+}
+function markClashesSeen({ state = checksState(), file = SEEN_FILE } = {}) {
+  const keys = [...new Set([...seenClashes({ file }), ...(state.clashes || []).filter((c) => c.severity === "high").map(clashKey)])].slice(-MAX_CLASHES);
+  try { mkdirSync(join(file, ".."), { recursive: true }); writeFileSync(file, JSON.stringify(keys), { mode: 0o600 }); return { ok: true }; } catch { return { error: "Couldn't write " + file + "." }; }
+}
 
-export { CHECKS_FILE, parseDates, timeOf, loadFiles, extractFacts, findClashes, runChecks, checksState };
+export { CHECKS_FILE, parseDates, timeOf, loadFiles, extractFacts, findClashes, runChecks, checksState, newClashes, markClashesSeen, seenClashes };

package/handback.mjs

@@ -30,7 +30,7 @@ import { CONFIG_DIR, loadConfig, loadTasks, saveTasks, sameTask, clipWords } fro
 import { OPS, parseAwaiting } from "./handover.mjs";
 import { FACTS, factsOf, knownRun, loadRuns, HANDOFFS, runningHandoff } from "./agents.mjs";
 import { remember, actIn } from "./mind.mjs";
-import { newsSince, watchState, isMail } from "./watch.mjs";
+import { newsSince, watchState, isMail, isSignedOut } from "./watch.mjs";
 import { inboxMail } from "./mail.mjs";
 import { desktopNotify } from "./desktop.mjs";
 import { repoPathMap } from "./scan.mjs";
@@ -163,11 +163,21 @@ function awaitTick({ map = repoPathMap(), now = Date.now(), news, inbox, act, no
   if (added.length || replied.length) saveWaits(d);
   return { added, replied };
 }
-// The Dashboard's list: what's still waiting, then what came in lately, newest first.
-function awaitingState() {
+// Can a reply be noticed? Email on (the inbox on this computer), or a watched
+// inbox that's signed in: a signed-out one reads nothing, so it doesn't count.
+// { sees, signedOut: [the signed-out inboxes' names] }
+function inboxSight({ mail, watches } = {}) {
+  if (!mail) { try { mail = loadConfig().mail || {}; } catch { mail = {}; } }
+  if (!watches) { try { watches = watchState().watches; } catch { watches = []; } }
+  const inboxes = watches.filter((w) => isMail(w.url)), out = inboxes.filter(isSignedOut);
+  return { sees: !!mail.enabled || inboxes.length > out.length, signedOut: out.map((w) => w.name) };
+}
+// The Dashboard's list: what's still waiting, then what came in lately, newest
+// first; and, while one waits, whether anything can see the reply arrive.
+function awaitingState({ sight = inboxSight } = {}) {
   const view = (w) => ({ id: w.id, from: w.from.lane, to: w.to, subject: w.subject, asked: w.asked, task: w.task, lane: w.lane, sent: w.sent, status: w.status, ...(w.reply ? { reply: w.reply } : {}), ...(w.handed ? { handed: w.handed } : {}), ...(w.error ? { error: w.error } : {}) });
-  const all = loadWaits().waits.slice().reverse();
-  return { waits: [...all.filter((w) => w.status === "waiting"), ...all.filter((w) => w.status !== "waiting" && w.status !== "stopped").slice(0, 10)].map(view) };
+  const all = loadWaits().waits.slice().reverse(), open = all.filter((w) => w.status === "waiting");
+  return { waits: [...open, ...all.filter((w) => w.status !== "waiting" && w.status !== "stopped").slice(0, 10)].map(view), ...(open.length ? { sight: sight() } : {}) };
 }
 // Stop waiting (its button): it stays in the file, so the run's AWAITING.json doesn't bring it back.
 function stopWaiting(id) {
@@ -175,4 +185,4 @@ function stopWaiting(id) {
   w.status = "stopped"; return saveWaits(d) ? { ok: true, ...awaitingState() } : { error: "Couldn't write " + AWAIT_FILE + "." };
 }
 
-export { AWAIT_FILE, RUNS_DIR, runFolders, laneOf, runTitle, subjectCore, keepFacts, skipFacts, loadWaits, collectWaits, answers, replyTo, nextRequest, awaitTick, awaitingState, stopWaiting };
+export { AWAIT_FILE, RUNS_DIR, runFolders, laneOf, runTitle, subjectCore, keepFacts, skipFacts, loadWaits, collectWaits, answers, replyTo, nextRequest, awaitTick, inboxSight, awaitingState, stopWaiting };

package/headless.mjs

@@ -80,7 +80,7 @@ function connect(proc) {
     function done(v) { clearTimeout(t); listeners.delete(f); resolve(v); }
     listeners.add(f);
   });
-  return { send, until, on: (f) => listeners.add(f), closed: () => closed };
+  return { send, until, on: (f) => { listeners.add(f); return () => listeners.delete(f); }, closed: () => closed };
 }
 
 // One browser at a time: they share a profile, and Chrome locks it.
@@ -139,7 +139,9 @@ async function launch() {
       // Sites serve "HeadlessChrome" something else (or a block page): look like the browser it is.
       const { userAgent } = await c.send("Browser.getVersion");
       if (userAgent) await send("Network.setUserAgentOverride", { userAgent: userAgent.replace(/HeadlessChrome/g, "Chrome") });
-      b.page = { send, until, idle };
+      // every `method` event on this tab, until the function it gives is called
+      const on = (method, f) => c.on((m) => { if (m && m.sessionId === sessionId && m.method === method) f(m.params || {}); });
+      b.page = { send, until, idle, on };
       return b;
     })();
     return await Promise.race([run, failed]);
@@ -497,6 +499,56 @@ function readTexts(input, selector, { scrolls = 3 } = {}) {
   }, false)).catch((e) => ({ error: String((e && e.message) || e) }));
 }
 
+// A picture, or a short clip, of a page, for a post (post.mjs): only on your
+// click, and it only looks, like readPage. The picture is the window at twice its
+// pixels, so it stays sharp in a feed: { png, url, title }. The clip records the
+// window for `seconds` (the DevTools screencast: a frame each time the page
+// changes, with its time), scrolling slowly down a page longer than the window,
+// so even a still page moves: { frames: [{ ts, jpeg }], end, url, title }, the
+// times in seconds. post.mjs makes it a video.
+const CLIP = { min: 3, max: 30, speed: 450 }; // seconds; pixels a second, scrolling
+const SCROLL_THROUGH = (ms) => `(() => { ${SCROLLER}
+  const sc = scroller(); if (!sc) return 0;
+  const hold = 800, run = Math.max(500, ${ms} - 2 * hold), dist = Math.min(sc.scrollHeight - sc.clientHeight, run / 1000 * ${CLIP.speed}), t0 = performance.now();
+  const ease = (x) => x < 0.5 ? 2 * x * x : 1 - Math.pow(-2 * x + 2, 2) / 2;
+  (function step(now) { const k = Math.min(1, Math.max(0, (now - t0 - hold) / run)); sc.scrollTop = Math.round(dist * ease(k)); if (k < 1) requestAnimationFrame(step); })(t0);
+  return Math.round(dist);
+})()`;
+function pagePicture(input) {
+  const url = siteUrl(input);
+  if (!url) return Promise.resolve({ error: "Give a page: a web address (localhost:3000 works), a host (github.com/you) or a site's name." });
+  return oneAtATime(() => withPage(async (page) => {
+    await page.send("Emulation.setDeviceMetricsOverride", { width: VIEW.w, height: VIEW.h, deviceScaleFactor: 2, mobile: false });
+    try {
+      await open(page, url);
+      const { data } = await page.send("Page.captureScreenshot", { format: "png" });
+      return { png: Buffer.from(data, "base64"), url: String((await evaluate(page, "location.href")) || url), title: String((await evaluate(page, "document.title")) || "") };
+    } finally { await page.send("Emulation.setDeviceMetricsOverride", { width: VIEW.w, height: VIEW.h, deviceScaleFactor: 1, mobile: false }).catch(() => {}); }
+  })).catch((e) => ({ error: String((e && e.message) || e) }));
+}
+function pageClip(input, seconds = 8) {
+  const url = siteUrl(input);
+  if (!url) return Promise.resolve({ error: "Give a page: a web address (localhost:3000 works), a host (github.com/you) or a site's name." });
+  const ms = Math.round(Math.min(CLIP.max, Math.max(CLIP.min, Number(seconds) || 8)) * 1000);
+  return oneAtATime(() => withPage(async (page) => {
+    await open(page, url);
+    const frames = [];
+    const off = page.on("Page.screencastFrame", (p) => {
+      frames.push({ ts: (p.metadata && p.metadata.timestamp) || Date.now() / 1000, jpeg: Buffer.from(p.data, "base64") });
+      page.send("Page.screencastFrameAck", { sessionId: p.sessionId }).catch(() => {});
+    });
+    try {
+      await page.send("Page.startScreencast", { format: "jpeg", quality: 88, maxWidth: VIEW.w, maxHeight: VIEW.h, everyNthFrame: 1 });
+      await evaluate(page, SCROLL_THROUGH(ms));
+      await sleep(ms);
+      await page.send("Page.stopScreencast").catch(() => {});
+    } finally { off(); }
+    const end = frames.length ? Math.max(frames[frames.length - 1].ts, frames[0].ts + ms / 1000) : 0;
+    if (!frames.length) return { error: "The page showed nothing to record." };
+    return { frames, end, url: String((await evaluate(page, "location.href")) || url), title: String((await evaluate(page, "document.title")) || "") };
+  })).catch((e) => ({ error: String((e && e.message) || e) }));
+}
+
 // Trusted sites (Settings → Screens): on a page from one of these, press and type
 // go ahead without asking, for you and for agents. Anywhere else each one asks.
 // A host covers its subdomains (google.com covers mail.google.com). Only the app's
@@ -662,4 +714,4 @@ async function signIn(input) {
   return { ok: true, url };
 }
 
-export { siteUrl, browserArgs, mapPage, wholePage, readPage, readTexts, isSend, pressRegion, typeRegion, scrollPage, SCROLLS, signIn, keepBrowserOpen, closeBrowser, browserOpen, trustedSites, isTrusted, trustSite, untrustSite, PROFILE };
+export { siteUrl, browserArgs, mapPage, wholePage, readPage, readTexts, pagePicture, pageClip, CLIP, isSend, pressRegion, typeRegion, scrollPage, SCROLLS, signIn, keepBrowserOpen, closeBrowser, browserOpen, trustedSites, isTrusted, trustSite, untrustSite, PROFILE };

package/home.mjs

@@ -4,24 +4,27 @@
 //   folders), always out front;
 // - feeds: what's new on the sites you watch (watch.mjs), sized by how much;
 // - lanes: work handed between agents (lanes.mjs), the latest few.
-// Reports agents wrote up that you haven't read (reports.mjs) are a feed too.
+// Reports agents wrote up that you haven't read (reports.mjs) are a feed too, and
+// so is a clash in your company folder that matters (checks.mjs newClashes).
 // The app's sections (Map, Tasks, Agents, Week…) are shaped by adapt.mjs from
 // how you use them; this is the live data around them. Home's talk goes to the
 // same Symbiot as every chat (mind.mjs converse), told what home shows.
 import { join } from "node:path";
-import { readFileSync } from "node:fs";
-import { watchBoard, watchState, isMail } from "./watch.mjs";
+import { homedir } from "node:os";
+import { readFileSync, writeFileSync } from "node:fs";
+import { watchBoard } from "./watch.mjs";
 import { pendingReview, pushTasks } from "./tasks.mjs";
-import { agentsList, runHandoff, handoffCmd, connectorsInfo, parkedPaths, agentMissing } from "./agents.mjs";
+import { agentsList, runHandoff, runningHandoff, handoffCmd, connectorsInfo, parkedPaths, agentMissing } from "./agents.mjs";
 import { linksState } from "./links.mjs";
 import { knowledgeState } from "./knowledge.mjs";
-import { CONFIG_DIR, loadConfig, loadTasks } from "./core.mjs";
-import { lanesState } from "./lanes.mjs";
+import { CONFIG_DIR, loadTasks } from "./core.mjs";
+import { lanesState, stuckHandovers, allowHandover, skipHandover } from "./lanes.mjs";
 import { converse, actIn, actNow, taskIn } from "./mind.mjs";
 import { repoPathMap } from "./scan.mjs";
 import { resolveProvider } from "./ai.mjs";
 import { reportsNews } from "./reports.mjs";
-import { awaitingState } from "./handback.mjs";
+import { awaitingState, inboxSight } from "./handback.mjs";
+import { newClashes } from "./checks.mjs";
 
 const KEEP = 15000; // the slower reads (git per repo awaiting review) are cached this long
 let cached = null;
@@ -46,6 +49,32 @@ function displayName(path, folder) {
 // The lane a folder is: the repo it is (by the scan's map), or an ops run.
 const laneOfPath = (path, map) => Object.keys(map || {}).find((n) => map[n] === path) || (String(path || "").startsWith(RUNS) ? "" : null);
 
+// A run that failed shows for a day, until you run it again or skip it; one
+// that's been followed by another run in its folder is past.
+const FAILED_FOR = 86400000, dropped = new Set();
+const firstLine = (t) => String(t || "").split("\n").find((l) => l.trim()) || "";
+// What stopped and can't go on without you, as questions: a handover that couldn't
+// start (lanes.mjs stuckHandovers: "Allow this run access to ~/Company?"), and a run
+// that ended in an error. Each is answered on its blob (homeAnswer), on Home and on
+// its lane in Tasks. repo: its lane ("" for an ops run).
+function troubles({ stuck = [], list = [], map = {}, named = displayName, now = Date.now() } = {}) {
+  const out = [], seen = new Set();
+  for (const t of stuck) {
+    const lane = t.from.lane === RUNS_LANE ? "" : t.from.lane;
+    out.push({ kind: "ask", fix: "handover", id: "stuck:" + t.id, path: lane ? map[lane] || t.from.path : t.from.path, repo: lane, name: lane ? named(map[lane], lane) : "Agent runs",
+      title: `${lane || "An agent run"} is stuck`, sub: plain(firstLine(t.text), 90), q: t.q, options: t.options, why: plain(t.error, 160), shape: "agents" });
+  }
+  for (const a of list) {
+    if (seen.has(a.path)) continue; seen.add(a.path); // the newest run in each folder (agentsList: newest first)
+    if (a.status !== "failed" || dropped.has(a.id) || (a.endedAt && now - a.endedAt > FAILED_FOR)) continue;
+    if (a.ask && a.ask.questions && a.ask.questions.length) continue; // it asked: that's its question
+    const lane = laneOfPath(a.path, map), repo = lane || "", nm = repo ? named(map[lane], repo) : plain(String(a.name || "an agent").replace(/^Agent:\s*/, ""), 60);
+    const said = plain(String(a.tail || "").split(/\n+/).filter((l) => l.trim()).pop() || "", 140);
+    out.push({ kind: "ask", fix: "failed", id: "failed:" + a.id, path: a.path, repo, name: nm, title: `${nm}'s run stopped`, sub: said || `it exited with code ${a.exitCode}`,
+      q: `Its run stopped with an error${said ? `: ${said}` : ` (exit code ${a.exitCode})`}. Run it again?`, options: ["Run it again (recommended)", "Skip"], shape: "agents" });
+  }
+  return out;
+}
 // { you: [{ kind, id, title, sub, shape, … }], feeds: [{ id, title, sub, count, shape }],
 //   lanes: [{ from, to, text, status, times }], working: n, at }
 // An ask carries what its blob on home needs: the lane (repo, or "" for an ops
@@ -60,11 +89,13 @@ function homeState({ now = Date.now(), fresh = false, deps = {} } = {}) {
   const connected = deps.connected || (() => !!resolveProvider());
   const repos = deps.repos || (() => { try { return repoPathMap(); } catch { return {}; } });
   const waits = deps.waits || (() => { try { return awaitingState().waits; } catch { return []; } });
-  // can a reply be noticed? Email on (mail on this computer), or an inbox watched
-  const seesInbox = deps.seesInbox || (() => { try { return !!(loadConfig().mail || {}).enabled || watchState().watches.some((w) => isMail(w.url)); } catch { return true; } });
+  const clashes = deps.clashes || (() => { try { return newClashes(); } catch { return []; } });
+  // can a reply be noticed? Email on (mail on this computer), or an inbox watched and signed in
+  const seesInbox = deps.seesInbox || (() => { try { return inboxSight(); } catch { return true; } });
   // the agent the handoff command runs, gone from this computer; Claude connectors linked here but signed out
   const agentGone = deps.agentGone || (() => { try { return handoffCmd() ? agentMissing() : ""; } catch { return ""; } });
   const signedOut = deps.signedOut || (() => { try { const c = connectorsInfo(); return c.claude ? (c.links || []).filter((x) => x.connector && !x.ready) : []; } catch { return []; } });
+  const stuck = deps.stuck || (() => { try { return stuckHandovers({ now }); } catch { return []; } });
   const named = deps.name || displayName;
   const you = [], map = repos() || {};
   // What Symbiot works through (an AI, your agent, the connectors runs use) shows
@@ -89,10 +120,22 @@ function homeState({ now = Date.now(), fresh = false, deps = {} } = {}) {
     you.push({ kind: "ask", id: "ask:" + a.path, path: a.path, repo, name: repo ? named(lane ? map[lane] : a.path, repo) : plain(String(a.name || "an agent").replace(/^Agent:\s*/, ""), 60),
       title: `${a.name} asks`, sub: String(q.q || "").slice(0, 90), q: String(q.q || ""), options: (q.options || []).slice(0, 2), ...(qs.length > 1 ? { more: qs.length - 1 } : {}), shape: "agents" });
   }
+  // What stopped and can't go on without you, as a question too: a handover that
+  // couldn't start (lanes.mjs stuckHandovers: "Allow this run access to ~/Company?"),
+  // and a run that ended in an error. Answered on its blob (homeAnswer).
+  you.push(...troubles({ stuck: stuck(), list, map, named, now }));
   // A run is waiting on an emailed reply that nothing will see: say so, once,
-  // until an inbox is watched or Email is on (handback.mjs looks in either).
-  if (waits().some((w) => w.status === "waiting") && !seesInbox()) you.push({ kind: "setup", id: "setup:inbox", title: "Let me see your inbox", sub: "so I notice their reply", shape: "settings", focus: "links" });
+  // until an inbox is watched (and signed in) or Email is on (handback.mjs looks in either).
+  if (waits().some((w) => w.status === "waiting")) {
+    const s = seesInbox(), sight = s && typeof s === "object" ? s : { sees: !!s, signedOut: [] };
+    if (!sight.sees) you.push(sight.signedOut.length
+      ? { kind: "setup", id: "setup:inbox", signin: true, title: `Sign in to ${sight.signedOut[0]} again`, sub: "it's signed out, so I won't notice their reply", shape: "settings", focus: "links" }
+      : { kind: "setup", id: "setup:inbox", title: "Let me see your inbox", sub: "so I notice their reply", shape: "settings", focus: "links" });
+  }
   const feeds = ((board() || {}).cards || []).filter((c) => c.count > 0).map((c) => ({ id: "feed:" + c.id, title: c.name, sub: c.label, count: c.count, shape: "board" }));
+  // a clash in your files that matters (checks.mjs: high), first under Watching, until you've opened it
+  const clash = clashes();
+  if (clash.length) feeds.unshift({ id: "feed:clash", title: "Where your files disagree", sub: `${clash.length} clash${clash.length > 1 ? "es" : ""} to look at`, latest: plain(clash[0].text, 140), count: clash.length, shape: "settings" });
   const rep = reports();
   if (rep.count) feeds.push({ id: "feed:reports", title: "Reports", sub: `${rep.count} unread`, latest: rep.latest, count: rep.count, shape: "reports" });
   const hs = ((lanes() || {}).handoffs || []).slice(0, 5).map((h) => ({ from: h.from, to: h.to, text: h.text, status: h.status, ...(h.times > 1 ? { times: h.times } : {}) }));
@@ -102,6 +145,33 @@ function homeState({ now = Date.now(), fresh = false, deps = {} } = {}) {
   return out;
 }
 
+// An answer on a stuck handover's or a failed run's blob. pick: the option's place
+// (0 goes ahead, 1 skips); text: your own words, which go ahead with them unless
+// they say no. The handover's run (lanes.mjs allowHandover) reports back to the
+// agent that asked; a failed run starts again in its folder, with your words in its
+// ANSWERS.md. { ok, said } or { error }.
+const SAYS_NO = /^\s*(skip|no|nope|don'?t|do not|cancel|leave it|never ?mind|stop)\b/i;
+function homeAnswer(id, { pick, text = "" } = {}, deps = {}) {
+  id = String(id || ""); text = String(text || "").trim().slice(0, 2000);
+  const go = text ? !SAYS_NO.test(text) : Number(pick) === 0, ref = id.replace(/^\w+:/, "");
+  cached = null;
+  if (id.startsWith("stuck:")) {
+    if (!go) { const r = (deps.skip || skipHandover)(ref); return r.error ? r : { ok: true, said: "Skipped. Its agent knows." }; }
+    const r = (deps.allow || allowHandover)(ref, { note: text }); if (r.error) return r;
+    return { ok: true, said: `Started a run on it${r.dirs && r.dirs.length ? `, allowed into ${r.dirs.map((d) => (d.startsWith(homedir() + "/") ? "~" + d.slice(homedir().length) : d)).join(" and ")}` : ""}. What it does goes back to the agent that asked.` };
+  }
+  if (id.startsWith("failed:")) {
+    const a = (deps.agents || agentsList)().find((x) => x.id === ref); if (!a) return { error: "That run isn't here any more." };
+    if (!go) { dropped.add(ref); return { ok: true, said: "Skipped." }; }
+    if ((deps.running || runningHandoff)(a.path)) return { ok: true, said: "An agent is already at work there." };
+    if (text) { const f = join(a.path, ".symbiot", "ANSWERS.md"); let had = ""; try { had = readFileSync(f, "utf8"); } catch {}
+      try { writeFileSync(f, `${(had || "# Answers\n").replace(/\s*$/, "")}\n\n### Your last run stopped with an error\n${text}\n_answered ${new Date().toISOString().slice(0, 10)}_\n`); } catch {} }
+    const e = (deps.run || runHandoff)(a.path, { force: true }); dropped.add(ref);
+    return e && e.id && !e.blocked ? { ok: true, said: "Running it again.", rerun: e.id } : { error: (e && e.note) || "It didn't start. Check your agent in Settings." };
+  }
+  return { error: "Answer that one on its block in Agents." };
+}
+
 // Settings' first steps, in the order they matter (FIRST-RUN-AUDIT.md: a new user
 // found Settings one long page with nothing saying what comes first). Each is
 // done or not from what's set up, so it ticks itself; the company folder is
@@ -136,7 +206,7 @@ function firstSteps({ deps = {} } = {}) {
 // One line per thing home shows, for the talk's context.
 function homeContext(h) {
   return [
-    `Only the user can do (${h.you.length}):`, ...h.you.map((y) => `- ${y.title}: ${y.sub}`),
+    `Only the user can do (${h.you.length}):`, ...h.you.map((y) => `- ${y.title}: ${y.sub}${y.q && y.q !== y.sub ? ` (asks: ${y.q}${(y.options || []).length ? ` ${y.options.join(" / ")}` : ""})` : ""}`),
     `New on what they watch:`, ...(h.feeds.length ? h.feeds.map((f) => `- ${f.title}: ${f.sub}${f.latest ? ` (latest: ${f.latest})` : ""}`) : ["- nothing new"]),
     `Agents working: ${h.working}. Recent handovers:`, ...(h.lanes.length ? h.lanes.map((l) => `- ${l.from} → ${l.to}: ${l.text} (${l.status}${l.times ? `, handed over ${l.times} times` : ""})`) : ["- none"]),
   ].join("\n");
@@ -218,6 +288,11 @@ function workScene({ deps = {} } = {}) {
     for (const q of qs) { p.qs = p.qs || []; if (p.qs.length < 3) p.qs.push({ q: q.q, options: (q.options || []).slice(0, 3), path: a.path }); }
     for (const s of ideas) { p.ideas = p.ideas || []; if (p.ideas.length < 4) p.ideas.push({ text: plain(s.text, 200), full: String(s.text), repo: s.repo || l, path: a.path }); }
   }
+  const stuck = deps.stuck || (() => { try { return stuckHandovers(); } catch { return []; } });
+  for (const t of troubles({ stuck: stuck(), list: AG, map, named })) {
+    const p = at(t.repo || RUNS_LANE); p.asks++; p.qs = p.qs || [];
+    if (p.qs.length < 3) p.qs.unshift({ q: t.q, options: t.options, path: t.path, fix: t.fix, id: t.id, sub: t.sub });
+  }
   for (const p of Object.values(by)) { p.lit = !!(p.asks || p.ready); if (isParked(p.repo)) p.parked = true; }
   const projects = Object.values(by).sort((a, b) => (b.lit ? 1 : 0) - (a.lit ? 1 : 0) || (a.parked ? 1 : 0) - (b.parked ? 1 : 0) || (b.running ? 1 : 0) - (a.running ? 1 : 0) || b.ready - a.ready || b.waiting - a.waiting || b.last - a.last || (a.repo < b.repo ? -1 : 1));
   return { running, ready, waiting: waiting.slice(0, 12), waitingCount: waiting.length, canGo: waiting.filter((w) => !w.busy && !w.parked).length, projects: projects.slice(0, 24), projectCount: projects.length };
@@ -234,4 +309,4 @@ function workGo({ push = pushTasks, run = runHandoff } = {}) {
   return { started, queued, repos, ...(parked.length ? { parked } : {}), ...(r.unresolved && r.unresolved.length ? { unresolved: r.unresolved.map((u) => u.name) } : {}) };
 }
 
-export { homeState, homeContext, homeAsk, workScene, workGo, displayName, firstSteps };
+export { homeState, homeContext, homeAsk, homeAnswer, workScene, workGo, displayName, firstSteps };

package/index.mjs

@@ -25,8 +25,8 @@
 
 import { spawn } from "node:child_process";
 import { homedir } from "node:os";
-import { join } from "node:path";
-import { realpathSync } from "node:fs";
+import { join, basename } from "node:path";
+import { realpathSync, readFileSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 import { EMBEDDED_UI } from "./ui.mjs";
@@ -41,7 +41,7 @@ import { loadScreens, screenImage, blueprint } from "./screens.mjs";
 import { mapPage, wholePage, pressRegion, typeRegion, scrollPage, signIn, isTrusted } from "./headless.mjs";
 import { watchState, addWatch, removeWatch, seenWatch, newsSince, markNews, checkWatch, setBrief, draftReply, watchBoard, boardLine, boardChat, boardTalk, clearBoardChat } from "./watch.mjs";
 import { PORT as PHONE_PORT, phoneState, pairComputer, pollComputer, forgetComputer } from "./phone.mjs";
-import { KIND_LABEL as POST_KIND, PATHS as POST_PATHS, draftPosts, postsState, postLog, approvePost, editPost, skipPost, voiceFromLinkedIn, openUrl } from "./post.mjs";
+import { KIND_LABEL as POST_KIND, PATHS as POST_PATHS, draftPosts, postsState, postLog, approvePost, editPost, skipPost, voiceFromLinkedIn, openUrl, addMedia as addPostMedia, removeMedia as removePostMedia, mediaDir as postMediaDir, pictureOfPage, clipOfPage } from "./post.mjs";
 import { startApp, updateCmd, isAppRunningWeekly } from "./server.mjs";
 import { listReports, readReport } from "./reports.mjs";
 import { runSandbox } from "./sandbox.mjs";
@@ -621,16 +621,20 @@ async function cmdPhone() {
 // Nothing is ever posted by Symbiot: approve copies one post to your clipboard and
 // gives LinkedIn's share box, where you paste it and post it yourself.
 async function cmdPost() {
-  const [sub = "draft", a1, a2] = argv.slice(1).filter((x, i, all) => !x.startsWith("--") && all[i - 1] !== "--since");
+  const [sub = "draft", a1, a2] = argv.slice(1).filter((x, i, all) => !x.startsWith("--") && all[i - 1] !== "--since" && all[i - 1] !== "--seconds");
   const fail = (msg) => { console.log(c.y(msg)); process.exitCode = 1; };
   const show = (p) => {
     console.log(`\n${c.b(POST_KIND[p.kind] || p.kind)}  ${c.d(`${p.id} · ${p.status}${p.edited ? " · edited" : ""}`)}\n${p.text}`);
     if (p.sources && p.sources.length) console.log(c.d("  from git: " + p.sources.slice(0, 4).map((s) => s.replace(/^\[\d+\]\s*/, "")).join("\n            ") + (p.sources.length > 4 ? `\n            …and ${p.sources.length - 4} more` : "")));
+    for (const m of p.media || []) console.log(c.d(`  ${m.kind} ${m.id}: `) + join(postMediaDir(p.id), m.file) + c.d(m.url ? `  (${m.from === "clip" ? "clip" : "picture"} of ${m.url})` : ""));
+    if (p.show && !(p.media || []).length) console.log(c.d("  picture idea: " + p.show));
   };
   if (sub === "draft" || sub === "new") {
     const r = await draftPosts({ days: SINCE_WEEK || 7 });
     if (r.error) return fail(r.error);
     for (const p of r.posts) show(p);
+    if (r.retried) console.log("\n" + c.d("The first try kept none (each claimed what git doesn't show), so Symbiot tried again by itself."));
+    if (r.pictures) console.log(c.d(`${r.pictures === 1 ? "One draft names" : `${r.pictures} drafts name`} a screen of an app you run here, so ${r.pictures === 1 ? "it has its picture" : "they have their pictures"} already: keep or remove (symbiot post remove <id> <media id>).`));
     if (r.dropped.length) console.log("\n" + c.y(`Dropped ${r.dropped.length}: `) + r.dropped.map((x) => `${POST_KIND[x.kind] || x.kind} (${x.cited ? "claimed " + x.unsupported.join(", ") + ", which git doesn't show" : "cited nothing from git"})`).join("; "));
     console.log("\n" + c.d(`${r.posts.length} draft${r.posts.length === 1 ? "" : "s"} from ${r.facts} things git shows this week, in the voice of your ${r.voice} example${r.voice === 1 ? "" : "s"}. They wait on the app's Dashboard too.`));
     console.log(c.d("Nothing is posted until you approve one:  symbiot post approve <id>  (or edit / skip)."));
@@ -648,10 +652,33 @@ async function cmdPost() {
     console.log(`${c.g("✓")} Approved.\n\n${r.post.text}\n`);
     console.log(r.copied ? `${c.g("✓")} Copied to your clipboard (${r.copied}).` : c.y("No clipboard tool found (wl-copy, xclip, xsel, pbcopy or clip): copy it from above."));
     console.log(`Paste it into LinkedIn's share box: ${c.b(r.share)}` + (has("open") ? "" : c.d("  (--open opens it)")));
-    if (has("open")) openUrl(r.share);
+    if (r.files.length) console.log(`Then add ${r.files.length === 1 ? "this" : "these"} with its photo or video button:\n${r.files.map((f) => "  " + f).join("\n")}` + (has("open") ? "" : c.d("  (--open opens their folder)")));
+    if (has("open")) { openUrl(r.share); if (r.folder) openUrl(r.folder); }
     console.log(c.d(r.note));
     return;
   }
+  // pictures and video on a draft: a file of yours, or a picture or clip of a page
+  if (sub === "add") {
+    if (!a2) return fail("Give the draft and the file:  symbiot post add <id> <picture or video>");
+    let data; try { data = readFileSync(a2); } catch (e) { return fail(`Can't read ${a2}: ${e.message}`); }
+    const r = addPostMedia(a1, data, { name: basename(a2) });
+    if (r.error) return fail(r.error);
+    show(r.post); return;
+  }
+  if (sub === "page") {
+    if (!a2) return fail("Give the draft and the page:  symbiot post page <id> <web address> [--clip] [--seconds 8]");
+    const clip = has("clip"), i = argv.indexOf("--seconds"), seconds = i >= 0 ? Number(argv[i + 1]) || 8 : 8;
+    console.log(c.d(clip ? `Recording ${seconds} s of ${a2}…` : `Taking a picture of ${a2}…`));
+    // through the app when it runs: its hidden browser and this one share a profile
+    const r = (await viaApp("/api/posts/media/page", { id: a1, url: a2, clip, seconds })) || await (clip ? clipOfPage(a1, a2, { seconds }) : pictureOfPage(a1, a2));
+    if (r.error) return fail(r.error);
+    show(r.post); return;
+  }
+  if (sub === "unadd" || sub === "remove") {
+    const r = removePostMedia(a1, a2);
+    if (r.error) return fail(r.error);
+    console.log(`${c.g("✓")} Taken off ${r.post.id}.`); return;
+  }
   if (sub === "edit") {
     if (!a2) return fail('Give the new text:  symbiot post edit <id> "the post"');
     const r = editPost(a1, a2);
@@ -685,6 +712,14 @@ async function cmdPost() {
                                    copy it to your clipboard, and give (--open:
                                    open) LinkedIn's share box to paste it into
   symbiot post edit <id> "text"    change a draft's words
+  symbiot post add <id> <file>     put a picture or video of yours on a draft
+                                   (PNG, JPG, GIF, MP4, MOV, WebM)
+  symbiot post page <id> <page> [--clip] [--seconds 8]
+                                   a picture of a web page (localhost too) on a
+                                   draft; --clip records a short video of it,
+                                   scrolling down (needs ffmpeg)
+  symbiot post remove <id> <media id>
+                                   take a picture or video off a draft
   symbiot post skip <id>           drop a draft
   symbiot post log                 everything drafted, edited, approved, skipped
   symbiot post voice [--linkedin]  your example posts (voice.md), or read your