@agentproto/apps 0.6.0 → 0.8.0

package/dist/bin/sync.mjs

@@ -1566,13 +1566,1320 @@ var mediaViewer = defineApp({
     tools: [...MEDIA_VIEWER_TOOLS]
   }
 });
+var MANAGER_LABEL = "Sessions Manager";
+var manager = {
+  agent: defineAgent({
+    schema: "agent/v1",
+    id: "@agentproto/sessions-manager",
+    description: "Durable coordinator over the daemon's sessions \u2014 routes questions to the right session, re-prompts stalled work, restarts dead sessions, reports status.",
+    model: "claude-sonnet-5",
+    boundaries: [
+      "Never kill a session unless the human explicitly asks for that session by id/label",
+      "Never merge PRs or bypass a repo's declared review flow from a supervised session",
+      "Prefer re-prompting an existing session over spawning a duplicate for the same task"
+    ],
+    tools: [
+      "session_list",
+      "conversation_read",
+      "agent_prompt",
+      "session_restart",
+      "agent_start",
+      "session_events_poll"
+    ]
+  }),
+  body: [
+    "You are the manager of this agentproto daemon's sessions: the human talks to you, and you talk",
+    "to the other sessions. You are durable \u2014 the same session across many turns \u2014 so keep a working",
+    "memory of who is doing what and don't re-derive it from scratch every turn.",
+    "",
+    "What you do:",
+    "- Locate: given a task or question, find the relevant session (`session_list`, labels, cwd,",
+    "  recency) and read its transcript (`conversation_read`) before answering \u2014 never guess status.",
+    "- Drive: re-prompt an idle/parked session onto its task with `agent_prompt`; restart a",
+    "  killed/exited session with `session_restart` when its work is clearly unfinished.",
+    "- Spawn: only when no existing session owns the task \u2014 check for duplicates first.",
+    "- Report: answer with short, concrete status (who, doing what, since when, blocked on what).",
+    "",
+    "Boundaries:",
+    "- Never kill a session unless the human explicitly asks for that session.",
+    "- A session's own repo conventions (review flow, merge policy) always win \u2014 you coordinate,",
+    "  you don't override.",
+    "- If a session awaits a human decision, surface the question to the human instead of answering",
+    "  in their place."
+  ].join("\n")
+};
+var WATCHDOG_LABEL = "Session Watchdog";
+var WATCHDOG_TICK_LABEL = "watchdog-tick";
+var WATCHDOG_TICK_SCHEDULE = "*/5 * * * *";
+var WATCHDOG_TICK_PROMPT = "Run your maintenance check now.";
+var watchdog = {
+  agent: defineAgent({
+    schema: "agent/v1",
+    id: "@agentproto/session-watchdog",
+    description: "Durable daemon-health watchdog \u2014 classifies sessions (needs-you, stalled, duplicated, abandonable), corrects flags, archives dead rows. Never kills or spawns.",
+    model: "claude-sonnet-5",
+    boundaries: [
+      "NEVER kill a live session, message/interrupt another session's conversation, or spawn new sessions",
+      "Housekeeping only on terminal-status sessions (exited/killed/error) \u2014 never touches a live one",
+      "Report only what's NEW since the last tick \u2014 no padding, no repeats unless something got worse"
+    ],
+    tools: [
+      "session_list",
+      "session_events_poll",
+      "session_flag_status",
+      "session_archive",
+      "session_gc"
+    ]
+  }),
+  body: [
+    "You are the Session Watchdog for this agentproto daemon. You run on a recurring cron tick",
+    "(~every 5 minutes) as the SAME durable session, re-prompted each time \u2014 you retain memory of",
+    "what you already flagged, so don't repeat an alert unless something got meaningfully worse or new.",
+    "",
+    "Each tick:",
+    "1. Call `session_list` to see current session state (status, awaitingInput/awaitingQuestion,",
+    "   stalledSinceMs, busy, blockedOn, childrenBusy).",
+    "2. Call `session_events_poll` for events since your last tick (stalled, exited, awaiting-input)",
+    "   to catch anything between ticks.",
+    "3. Classify:",
+    "   - Needs you: `awaitingInput: true` with a real unanswered question, older than ~10 minutes.",
+    "   - Stalled: busy but silent well past normal turn latency, no legitimate blockedOn excuse.",
+    "   - Possibly duplicated: two or more live sessions share workspace/cwd and a highly similar",
+    "     recent prompt/label \u2014 use judgment, not exact string matching.",
+    "   - Looks done/abandonable: idle/parked with no plausible remaining purpose.",
+    "4. Correct misclassifications when confident: if `session_flag_status` is available and you can",
+    "   tell a session is actually waiting on a human (or isn't, despite being flagged), call it with",
+    "   a clear `reason`. If that tool is unknown on this daemon build, skip silently.",
+    "5. Autonomous housekeeping (reversible, so no need to ask): `session_archive` or `session_gc` on",
+    "   sessions already terminal-status (exited/killed/error) and old. Never touches a live session.",
+    "6. NEVER: kill a live session, message/interrupt another session's conversation, or spawn new",
+    "   sessions. You only have these five tools on purpose \u2014 if you'd want another one, report the",
+    "   suggestion instead of working around it.",
+    "7. Report only what's NEW since last tick \u2014 one line per finding. If nothing new, reply with a",
+    `   short "nothing new" \u2014 don't pad it.`,
+    "",
+    "You are not a general coding assistant across ticks \u2014 stay scoped to this watchdog role."
+  ].join("\n")
+};
+
+// src/ops-panel/ui.ts
+var OPS_PANEL_TOOLS = [
+  "daemon_health",
+  "session_list",
+  "agent_start",
+  "agent_prompt",
+  "agent_kill",
+  "session_restart",
+  "session_archive",
+  "session_gc",
+  "cron_list",
+  "cron_create",
+  "cron_delete",
+  "cron_run",
+  "worktree_gc"
+];
+var APP_ID3 = "@agentproto/ops-panel";
+var SPECIALS = [
+  {
+    key: "watchdog",
+    label: WATCHDOG_LABEL,
+    tagline: "Health ticks every 5 min \u2014 flags, archives, never kills.",
+    prompt: watchdog.body ?? "",
+    cron: {
+      label: WATCHDOG_TICK_LABEL,
+      schedule: WATCHDOG_TICK_SCHEDULE,
+      prompt: WATCHDOG_TICK_PROMPT
+    }
+  },
+  {
+    key: "manager",
+    label: MANAGER_LABEL,
+    tagline: "You talk to it, it drives the other sessions.",
+    prompt: manager.body ?? "",
+    cron: null
+  }
+];
+var OPS_PANEL_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Ops Panel</title>
+<style>
+*{box-sizing:border-box;margin:0;padding:0}
+:root{
+  --bg:#0d1117;--bg2:#161b22;--bg3:#21262d;--border:#30363d;
+  --text:#e6edf3;--text2:#8b949e;--text3:#6e7681;
+  --green:#3fb950;--yellow:#d29922;--red:#f85149;--blue:#58a6ff;--purple:#bc8cff;
+}
+html,body{height:100%;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;font-size:13px;background:var(--bg);color:var(--text)}
+#app{display:flex;flex-direction:column;height:100%;overflow:hidden}
+
+#topbar{display:flex;align-items:center;gap:10px;padding:10px 14px;background:var(--bg2);border-bottom:1px solid var(--border);flex-shrink:0}
+#topbar h1{font-size:13px;font-weight:700;letter-spacing:.02em}
+.chip{display:inline-flex;align-items:center;gap:5px;font-size:10.5px;font-weight:600;background:var(--bg3);border:1px solid var(--border);color:var(--text2);padding:3px 9px;border-radius:999px}
+.chip .d{width:7px;height:7px;border-radius:50%;background:var(--text3);flex:none}
+.chip.ok .d{background:var(--green)}
+.chip.bad .d{background:var(--red)}
+#ws-select{margin-left:auto;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:6px;padding:4px 8px;font-size:11.5px;font-family:inherit}
+#refresh-btn{background:none;border:1px solid var(--border);cursor:pointer;color:var(--text2);font-size:13px;line-height:1;padding:4px 8px;border-radius:6px;font-family:inherit}
+#refresh-btn:hover{color:var(--text);background:var(--bg3)}
+
+#body{flex:1;overflow-y:auto;padding:14px;display:flex;flex-direction:column;gap:16px}
+.sect h2{font-size:11px;font-weight:700;color:var(--text2);text-transform:uppercase;letter-spacing:.06em;margin-bottom:8px;display:flex;align-items:center;gap:8px}
+.sect h2 .count{font-weight:600;color:var(--text3);text-transform:none;letter-spacing:0}
+
+#specials{display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:10px}
+.card{background:var(--bg2);border:1px solid var(--border);border-radius:10px;padding:12px}
+.card .ct{display:flex;align-items:center;gap:8px;font-size:13px;font-weight:700}
+.card .tagline{font-size:11px;color:var(--text2);margin-top:3px}
+.card .meta{font-size:10.5px;color:var(--text3);margin-top:7px;display:flex;flex-wrap:wrap;gap:5px 10px}
+.card .cronline{font-size:10.5px;margin-top:7px;display:flex;align-items:center;gap:6px;color:var(--text2)}
+.card .actions{display:flex;gap:6px;margin-top:10px;flex-wrap:wrap}
+
+.badge{display:inline-block;padding:1px 6px;border-radius:10px;font-size:9.5px;font-weight:700;text-transform:uppercase;letter-spacing:.02em}
+.b-run{background:rgba(63,185,80,.15);color:var(--green)}
+.b-busy{background:rgba(63,185,80,.25);color:var(--green)}
+.b-wait{background:rgba(88,166,255,.15);color:var(--blue)}
+.b-idle{background:rgba(139,148,158,.12);color:var(--text2)}
+.b-end{background:rgba(139,148,158,.1);color:var(--text3)}
+.b-err{background:rgba(248,81,73,.15);color:var(--red)}
+.b-warn{background:rgba(210,153,34,.15);color:var(--yellow)}
+
+button.act{background:var(--bg3);border:1px solid var(--border);color:var(--text);font-size:11px;font-weight:600;padding:4px 10px;border-radius:6px;cursor:pointer;font-family:inherit}
+button.act:hover{border-color:var(--text3)}
+button.act.primary{background:rgba(88,166,255,.15);border-color:rgba(88,166,255,.4);color:var(--blue)}
+button.act.danger{color:var(--red)}
+button.act.danger:hover{border-color:var(--red)}
+button.act.confirm{background:rgba(248,81,73,.2);border-color:var(--red);color:var(--red)}
+button.act:disabled{opacity:.45;cursor:default}
+
+table{width:100%;border-collapse:collapse}
+th{font-size:10px;font-weight:700;color:var(--text3);text-transform:uppercase;letter-spacing:.04em;text-align:left;padding:4px 8px;border-bottom:1px solid var(--border)}
+td{font-size:11.5px;padding:6px 8px;border-bottom:1px solid var(--bg3);vertical-align:middle}
+tr:hover td{background:var(--bg2)}
+td .sn{font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:260px;display:block}
+td .sid{font-size:10px;color:var(--text3);font-family:Menlo,Monaco,monospace}
+.ws-tag{display:inline-block;font-size:10px;font-weight:600;background:var(--bg3);border:1px solid var(--border);border-radius:5px;padding:1px 6px;color:var(--text2)}
+td.actions{white-space:nowrap;text-align:right}
+td.actions button{margin-left:4px}
+
+.hk{display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:10px}
+.hk .card .nums{display:flex;gap:14px;margin-top:8px}
+.hk .num{display:flex;flex-direction:column}
+.hk .num b{font-size:17px;font-weight:700}
+.hk .num span{font-size:10px;color:var(--text3);text-transform:uppercase;letter-spacing:.04em}
+
+#toast{position:fixed;bottom:14px;left:50%;transform:translateX(-50%);background:var(--bg3);border:1px solid var(--border);border-radius:8px;padding:8px 14px;font-size:11.5px;display:none;max-width:80%;z-index:10}
+#toast.err{border-color:var(--red);color:var(--red)}
+.empty{color:var(--text3);font-size:11.5px;padding:8px}
+</style>
+</head>
+<body>
+<div id="app">
+  <div id="topbar">
+    <h1>Agentproto Ops</h1>
+    <span class="chip" id="daemon-chip"><span class="d"></span><span id="daemon-txt">daemon&hellip;</span></span>
+    <select id="ws-select"><option value="">all workspaces</option></select>
+    <button id="refresh-btn" title="Refresh" type="button">&#8635; refresh</button>
+  </div>
+  <div id="body">
+    <div class="sect">
+      <h2>Special sessions</h2>
+      <div id="specials"></div>
+    </div>
+    <div class="sect">
+      <h2>Sessions <span class="count" id="sess-count"></span></h2>
+      <div id="sessions"></div>
+    </div>
+    <div class="sect">
+      <h2>Housekeeping</h2>
+      <div class="hk" id="housekeeping"></div>
+    </div>
+    <div class="sect">
+      <h2>Crons <span class="count" id="cron-count"></span></h2>
+      <div id="crons"></div>
+    </div>
+  </div>
+</div>
+<div id="toast"></div>
+<script>
+var callTool = null;
+var APP_ID = ${JSON.stringify(APP_ID3)};
+var SPECIALS = ${JSON.stringify(SPECIALS)};
+
+// app_tool_call wraps its dispatch result at least once (its own text-result
+// body is the JSON-stringified inner MCP tool result); peel back through
+// nested {content:[{type:"text",text:...}]} shells until the payload stops
+// looking like one \u2014 same convention as session-viewer.
+function unwrapText(result) {
+  var cur = result;
+  for (var i = 0; i < 4; i++) {
+    if (typeof cur === "string") {
+      try { cur = JSON.parse(cur); continue; } catch (e) { return cur; }
+    }
+    if (cur && Array.isArray(cur.content) && cur.content[0] && typeof cur.content[0].text === "string") {
+      cur = cur.content[0].text;
+      continue;
+    }
+    break;
+  }
+  return cur;
+}
+
+function callApp(tool, args) {
+  return callTool("app_tool_call", { appId: APP_ID, tool: tool, args: args || {} }).then(unwrapText);
+}
+
+function escHtml(s) {
+  return String(s == null ? "" : s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+function fmtRelative(iso) {
+  if (!iso) return "";
+  var ms = Date.now() - new Date(iso).getTime();
+  if (!isFinite(ms)) return "";
+  var s = Math.round(ms / 1000);
+  if (s < 5) return "just now";
+  if (s < 60) return s + "s ago";
+  var m = Math.round(s / 60);
+  if (m < 60) return m + "m ago";
+  var h = Math.round(m / 60);
+  if (h < 24) return h + "h ago";
+  return Math.round(h / 24) + "d ago";
+}
+
+var toastTimer = null;
+function toast(msg, isErr) {
+  var el = document.getElementById("toast");
+  el.textContent = msg;
+  el.className = isErr ? "err" : "";
+  el.style.display = "block";
+  if (toastTimer) clearTimeout(toastTimer);
+  toastTimer = setTimeout(function () { el.style.display = "none"; }, isErr ? 6000 : 3000);
+}
+
+// Two-click confirm: first click arms the button, second within 4s fires.
+var armed = {};
+function confirmClick(key, btn, fn) {
+  if (armed[key]) {
+    clearTimeout(armed[key].t);
+    delete armed[key];
+    fn();
+    return;
+  }
+  var prev = btn.textContent;
+  btn.classList.add("confirm");
+  btn.textContent = "sure?";
+  armed[key] = { t: setTimeout(function () {
+    delete armed[key];
+    btn.classList.remove("confirm");
+    btn.textContent = prev;
+  }, 4000) };
+}
+
+// ============================================================
+// state
+// ============================================================
+
+var sessions = [];
+var crons = [];
+var wsFilter = "";
+var pollTimer = null;
+var busyActions = false;
+
+function isLive(s) { return !!s && (s.status === "running" || s.status === "starting"); }
+
+function displayBadge(s) {
+  if (s.status === "running") {
+    if (s.busy) return { label: "working", cls: "b-busy" };
+    if (s.awaitingInput) return { label: "waiting", cls: "b-wait" };
+    return { label: "idle", cls: "b-idle" };
+  }
+  if (s.status === "starting") return { label: "starting", cls: "b-wait" };
+  if (s.status === "error" || s.status === "killed") return { label: s.status, cls: "b-err" };
+  return { label: s.status || "exited", cls: "b-end" };
+}
+
+function labelOf(s) {
+  return s.label || s.title || s.name || (s.command ? String(s.command).split("/").pop() : null) || s.id;
+}
+
+function specialSessionFor(sp) {
+  var best = null;
+  for (var i = 0; i < sessions.length; i++) {
+    var s = sessions[i];
+    if ((s.label || s.title) !== sp.label) continue;
+    if (!best) { best = s; continue; }
+    // Prefer a live one; among equals prefer the newest.
+    if (isLive(s) && !isLive(best)) { best = s; continue; }
+    if (isLive(s) === isLive(best) && String(s.startedAt) > String(best.startedAt)) best = s;
+  }
+  return best;
+}
+
+function cronByLabel(label) {
+  var hits = [];
+  for (var i = 0; i < crons.length; i++) if (crons[i].label === label) hits.push(crons[i]);
+  return hits;
+}
+
+// ============================================================
+// data loading
+// ============================================================
+
+function loadAll() {
+  return Promise.all([
+    callApp("session_list", { kind: "all" }).then(function (d) {
+      sessions = (d && d.sessions) || (Array.isArray(d) ? d : []);
+    }),
+    callApp("cron_list", {}).then(function (d) {
+      crons = Array.isArray(d) ? d : (d && d.jobs) || [];
+    }).catch(function () { crons = []; }),
+  ]).then(function () {
+    renderWorkspaces();
+    renderSpecials();
+    renderSessions();
+    renderCrons();
+    updateHousekeepingNums();
+  });
+}
+
+function loadHealth() {
+  return callApp("daemon_health", {}).then(function (d) {
+    var chip = document.getElementById("daemon-chip");
+    chip.className = "chip ok";
+    var v = (d && (d.version || (d.build && d.build.sha) || d.status)) || "ok";
+    document.getElementById("daemon-txt").textContent = "daemon " + String(v).slice(0, 16);
+  }).catch(function (e) {
+    var chip = document.getElementById("daemon-chip");
+    chip.className = "chip bad";
+    document.getElementById("daemon-txt").textContent = "daemon unreachable";
+  });
+}
+
+// Housekeeping card is built ONCE (so the worktree plan text and armed
+// confirm buttons survive the 5s poll); only the counters re-render \u2014 see
+// updateHousekeepingNums. The worktree plan is a separate dry-run call, on
+// demand only (it walks git state \u2014 not something to hammer on every poll).
+function buildHousekeeping() {
+  var el = document.getElementById("housekeeping");
+  el.innerHTML =
+    '<div class="card"><div class="ct">Sessions GC</div>'
+    + '<div class="nums" id="gc-nums"></div>'
+    + '<div class="actions">'
+    + '<button class="act" id="gc-archive">Archive &gt;7d</button>'
+    + '<button class="act danger" id="gc-forget">Forget &gt;30d</button>'
+    + '</div></div>'
+    + '<div class="card"><div class="ct">Worktrees</div>'
+    + '<div class="meta" id="wt-plan">No plan yet \u2014 run a dry run.</div>'
+    + '<div class="actions">'
+    + '<button class="act" id="wt-dry">Dry run</button>'
+    + '<button class="act danger" id="wt-apply" disabled>Reclaim now</button>'
+    + '</div></div>';
+
+  document.getElementById("gc-archive").addEventListener("click", function () {
+    runAction("session_gc", { olderThanDays: 7 }, "GC: archived old terminal sessions");
+  });
+  var forgetBtn = document.getElementById("gc-forget");
+  forgetBtn.addEventListener("click", function () {
+    confirmClick("gc-forget", forgetBtn, function () {
+      runAction("session_gc", { olderThanDays: 30, forget: true }, "GC: forgot >30d terminal sessions");
+    });
+  });
+  document.getElementById("wt-dry").addEventListener("click", function () { worktreePlan(false); });
+  var applyBtn = document.getElementById("wt-apply");
+  applyBtn.addEventListener("click", function () {
+    confirmClick("wt-apply", applyBtn, function () { worktreePlan(true); });
+  });
+  updateHousekeepingNums();
+}
+
+function updateHousekeepingNums() {
+  var el = document.getElementById("gc-nums");
+  if (!el) return;
+  var terminal = 0, live = 0;
+  for (var i = 0; i < sessions.length; i++) {
+    if (isLive(sessions[i])) live++;
+    else terminal++;
+  }
+  el.innerHTML =
+    '<div class="num"><b>' + live + '</b><span>live</span></div>'
+    + '<div class="num"><b>' + terminal + '</b><span>terminal</span></div>';
+}
+
+function worktreePlan(apply) {
+  var el = document.getElementById("wt-plan");
+  el.textContent = apply ? "reclaiming\\u2026" : "planning\\u2026";
+  callApp("worktree_gc", apply ? { apply: true } : {}).then(function (d) {
+    var entries = (d && (d.plan || d.entries || d.worktrees)) || [];
+    var counts = { reclaim: 0, salvage: 0, hold: 0 };
+    for (var i = 0; i < entries.length; i++) {
+      var c = entries[i].classification || entries[i].class || entries[i].action;
+      if (counts[c] != null) counts[c]++;
+    }
+    el.textContent = (apply ? "applied \u2014 " : "dry run \u2014 ")
+      + counts.reclaim + " reclaim / " + counts.salvage + " salvage / " + counts.hold + " hold"
+      + (entries.length === 0 ? " (no linked worktrees)" : "");
+    document.getElementById("wt-apply").disabled = counts.reclaim === 0 || apply;
+    if (apply) toast("Worktree GC applied");
+  }).catch(function (e) {
+    el.textContent = "worktree_gc: " + e.message;
+  });
+}
+
+// ============================================================
+// rendering
+// ============================================================
+
+function renderWorkspaces() {
+  var sel = document.getElementById("ws-select");
+  var seen = {};
+  var slugs = [];
+  for (var i = 0; i < sessions.length; i++) {
+    var w = sessions[i].workspaceSlug;
+    if (w && !seen[w]) { seen[w] = true; slugs.push(w); }
+  }
+  slugs.sort();
+  var cur = wsFilter;
+  var html = '<option value="">all workspaces</option>';
+  for (var j = 0; j < slugs.length; j++) {
+    html += '<option value="' + escHtml(slugs[j]) + '"' + (slugs[j] === cur ? " selected" : "") + '>' + escHtml(slugs[j]) + "</option>";
+  }
+  sel.innerHTML = html;
+}
+
+function renderSpecials() {
+  var el = document.getElementById("specials");
+  var html = "";
+  for (var i = 0; i < SPECIALS.length; i++) {
+    var sp = SPECIALS[i];
+    var s = specialSessionFor(sp);
+    var badge = s ? displayBadge(s) : { label: "not running", cls: "b-end" };
+    var meta = "";
+    if (s) {
+      meta += "<span>" + escHtml(s.id) + "</span>";
+      if (s.startedAt) meta += "<span>started " + escHtml(fmtRelative(s.startedAt)) + "</span>";
+      if (s.costUsd != null) meta += "<span>$" + Number(s.costUsd).toFixed(2) + "</span>";
+    }
+    var cronline = "";
+    if (sp.cron) {
+      var jobs = cronByLabel(sp.cron.label);
+      if (jobs.length === 0) {
+        cronline = '<span class="badge b-end">no cron</span> tick not scheduled';
+      } else {
+        var job = jobs[0];
+        var ok = !job.lastResult || job.lastResult.ok;
+        var pointsAt = job.action && job.action.sessionId;
+        var stale = s && isLive(s) && pointsAt && pointsAt !== s.id;
+        cronline = '<span class="badge ' + (job.active ? (ok && !stale ? "b-run" : "b-warn") : "b-end") + '">'
+          + (job.active ? (ok && !stale ? "tick ok" : (stale ? "tick stale" : "tick failing")) : "tick off") + "</span> "
+          + escHtml(job.schedule) + (pointsAt ? " &rarr; " + escHtml(pointsAt) : "")
+          + (!ok && job.lastResult && job.lastResult.summary ? " &middot; " + escHtml(String(job.lastResult.summary).slice(0, 60)) : "");
+      }
+    }
+    var actions = "";
+    if (!s || !isLive(s)) {
+      actions += '<button class="act primary" data-sp="' + sp.key + '" data-do="launch">Launch</button>';
+      if (s) actions += '<button class="act" data-sp="' + sp.key + '" data-do="restart">Restart last</button>';
+    } else {
+      if (sp.cron) {
+        actions += '<button class="act" data-sp="' + sp.key + '" data-do="tick">Tick now</button>';
+        actions += '<button class="act" data-sp="' + sp.key + '" data-do="fixcron">Re-wire cron</button>';
+      } else {
+        actions += '<button class="act" data-sp="' + sp.key + '" data-do="tick">Ping</button>';
+      }
+      actions += '<button class="act danger" data-sp="' + sp.key + '" data-do="kill">Kill</button>';
+    }
+    html += '<div class="card">'
+      + '<div class="ct">' + escHtml(sp.label) + ' <span class="badge ' + badge.cls + '">' + escHtml(badge.label) + "</span></div>"
+      + '<div class="tagline">' + escHtml(sp.tagline) + "</div>"
+      + (meta ? '<div class="meta">' + meta + "</div>" : "")
+      + (cronline ? '<div class="cronline">' + cronline + "</div>" : "")
+      + '<div class="actions">' + actions + "</div>"
+      + "</div>";
+  }
+  el.innerHTML = html;
+  var btns = el.querySelectorAll("button[data-sp]");
+  for (var k = 0; k < btns.length; k++) {
+    (function (btn) {
+      btn.addEventListener("click", function () { specialAction(btn.getAttribute("data-sp"), btn.getAttribute("data-do"), btn); });
+    })(btns[k]);
+  }
+}
+
+function renderSessions() {
+  var el = document.getElementById("sessions");
+  var rows = [];
+  for (var i = 0; i < sessions.length; i++) {
+    var s = sessions[i];
+    if (wsFilter && s.workspaceSlug !== wsFilter) continue;
+    rows.push(s);
+  }
+  rows.sort(function (a, b) {
+    var la = isLive(a) ? 1 : 0, lb = isLive(b) ? 1 : 0;
+    if (la !== lb) return lb - la;
+    return String(b.startedAt || "").localeCompare(String(a.startedAt || ""));
+  });
+  var liveCount = 0;
+  for (var c = 0; c < rows.length; c++) if (isLive(rows[c])) liveCount++;
+  document.getElementById("sess-count").textContent = liveCount + " live / " + rows.length + " shown";
+  if (rows.length === 0) {
+    el.innerHTML = '<div class="empty">No sessions' + (wsFilter ? " in " + escHtml(wsFilter) : "") + ".</div>";
+    return;
+  }
+  var html = "<table><thead><tr><th>Session</th><th>Workspace</th><th>Status</th><th>Started</th><th>Cost</th><th></th></tr></thead><tbody>";
+  var shown = rows.slice(0, 80);
+  for (var j = 0; j < shown.length; j++) {
+    var s2 = shown[j];
+    var db = displayBadge(s2);
+    var acts = "";
+    if (isLive(s2)) {
+      acts += '<button class="act danger" data-id="' + escHtml(s2.id) + '" data-do="kill">Kill</button>';
+    } else {
+      acts += '<button class="act" data-id="' + escHtml(s2.id) + '" data-do="restart">Restart</button>';
+      if (!s2.archived) acts += '<button class="act" data-id="' + escHtml(s2.id) + '" data-do="archive">Archive</button>';
+    }
+    html += "<tr>"
+      + '<td><span class="sn" title="' + escHtml(labelOf(s2)) + '">' + escHtml(labelOf(s2)) + '</span><span class="sid">' + escHtml(s2.id) + "</span></td>"
+      + "<td>" + (s2.workspaceSlug ? '<span class="ws-tag">' + escHtml(s2.workspaceSlug) + "</span>" : "") + "</td>"
+      + '<td><span class="badge ' + db.cls + '">' + escHtml(db.label) + "</span></td>"
+      + "<td>" + escHtml(fmtRelative(s2.startedAt)) + "</td>"
+      + "<td>" + (s2.costUsd != null ? "$" + Number(s2.costUsd).toFixed(2) : "") + "</td>"
+      + '<td class="actions">' + acts + "</td>"
+      + "</tr>";
+  }
+  html += "</tbody></table>";
+  if (rows.length > shown.length) html += '<div class="empty">&hellip; ' + (rows.length - shown.length) + " more (narrow with the workspace filter)</div>";
+  el.innerHTML = html;
+  var btns = el.querySelectorAll("button[data-id]");
+  for (var k = 0; k < btns.length; k++) {
+    (function (btn) {
+      btn.addEventListener("click", function () { sessionAction(btn.getAttribute("data-id"), btn.getAttribute("data-do"), btn); });
+    })(btns[k]);
+  }
+}
+
+function renderCrons() {
+  var el = document.getElementById("crons");
+  document.getElementById("cron-count").textContent = crons.length ? crons.length + " jobs" : "";
+  if (crons.length === 0) {
+    el.innerHTML = '<div class="empty">No cron jobs.</div>';
+    return;
+  }
+  var html = "<table><thead><tr><th>Label</th><th>Schedule</th><th>State</th><th>Last</th><th>Next</th><th></th></tr></thead><tbody>";
+  for (var i = 0; i < crons.length; i++) {
+    var c = crons[i];
+    var last = c.lastResult == null ? "" : (c.lastResult.ok ? "ok" : "failed");
+    var lastCls = c.lastResult == null ? "b-end" : (c.lastResult.ok ? "b-run" : "b-err");
+    html += "<tr>"
+      + '<td><span class="sn">' + escHtml(c.label || c.id) + "</span></td>"
+      + "<td>" + escHtml(c.schedule) + "</td>"
+      + '<td><span class="badge ' + (c.active ? "b-run" : "b-end") + '">' + (c.active ? "active" : "off") + "</span></td>"
+      + "<td>" + (last ? '<span class="badge ' + lastCls + '" title="' + escHtml((c.lastResult && c.lastResult.summary) || "") + '">' + last + "</span>" : "") + "</td>"
+      + "<td>" + escHtml(c.nextRunAt ? fmtRelative(c.nextRunAt).replace(" ago", "") : "") + "</td>"
+      + '<td class="actions">'
+      + '<button class="act" data-cron="' + escHtml(c.id) + '" data-do="run">Run</button>'
+      + '<button class="act danger" data-cron="' + escHtml(c.id) + '" data-do="delete">Delete</button>'
+      + "</td></tr>";
+  }
+  html += "</tbody></table>";
+  el.innerHTML = html;
+  var btns = el.querySelectorAll("button[data-cron]");
+  for (var k = 0; k < btns.length; k++) {
+    (function (btn) {
+      btn.addEventListener("click", function () { cronAction(btn.getAttribute("data-cron"), btn.getAttribute("data-do"), btn); });
+    })(btns[k]);
+  }
+}
+
+// ============================================================
+// actions
+// ============================================================
+
+function runAction(tool, args, okMsg) {
+  if (busyActions) return Promise.resolve();
+  busyActions = true;
+  return callApp(tool, args).then(function (d) {
+    busyActions = false;
+    if (okMsg) toast(okMsg);
+    return loadAll().then(function () { return d; });
+  }).catch(function (e) {
+    busyActions = false;
+    toast(tool + ": " + e.message, true);
+    throw e;
+  });
+}
+
+function findSpecial(key) {
+  for (var i = 0; i < SPECIALS.length; i++) if (SPECIALS[i].key === key) return SPECIALS[i];
+  return null;
+}
+
+function rewireTickCron(sp, sessionId) {
+  if (!sp.cron) return Promise.resolve();
+  var stale = cronByLabel(sp.cron.label);
+  var chain = Promise.resolve();
+  for (var i = 0; i < stale.length; i++) {
+    (function (jobId) {
+      chain = chain.then(function () { return callApp("cron_delete", { jobId: jobId }); });
+    })(stale[i].id);
+  }
+  return chain.then(function () {
+    return callApp("cron_create", {
+      schedule: sp.cron.schedule,
+      recurring: true,
+      label: sp.cron.label,
+      action: { kind: "prompt-session", sessionId: sessionId, prompt: sp.cron.prompt },
+    });
+  });
+}
+
+function specialAction(key, what, btn) {
+  var sp = findSpecial(key);
+  if (!sp) return;
+  var s = specialSessionFor(sp);
+  if (what === "launch") {
+    btn.disabled = true;
+    callApp("agent_start", {
+      adapter: "claude-code",
+      label: sp.label,
+      prompt: sp.prompt,
+      keepAlive: true,
+    }).then(function (d) {
+      var id = d && d.id;
+      toast(sp.label + " launched" + (id ? " (" + id + ")" : ""));
+      return id && sp.cron ? rewireTickCron(sp, id) : null;
+    }).then(function () { return loadAll(); })
+      .catch(function (e) { toast("launch: " + e.message, true); btn.disabled = false; });
+    return;
+  }
+  if (what === "restart" && s) {
+    btn.disabled = true;
+    callApp("session_restart", { idOrName: s.id }).then(function (d) {
+      var id = (d && d.id) || s.id;
+      toast(sp.label + " restarted");
+      return sp.cron ? rewireTickCron(sp, id) : null;
+    }).then(function () { return loadAll(); })
+      .catch(function (e) { toast("restart: " + e.message, true); btn.disabled = false; });
+    return;
+  }
+  if (what === "tick" && s) {
+    var prompt = sp.cron ? sp.cron.prompt : "Status check: report where things stand, briefly.";
+    runAction("agent_prompt", { sessionId: s.id, prompt: prompt }, sp.label + " prompted");
+    return;
+  }
+  if (what === "fixcron" && s) {
+    btn.disabled = true;
+    rewireTickCron(sp, s.id).then(function () {
+      toast("Cron re-wired to " + s.id);
+      return loadAll();
+    }).catch(function (e) { toast("cron: " + e.message, true); btn.disabled = false; });
+    return;
+  }
+  if (what === "kill" && s) {
+    confirmClick("kill-" + s.id, btn, function () {
+      runAction("agent_kill", { sessionId: s.id }, sp.label + " killed");
+    });
+  }
+}
+
+function sessionAction(id, what, btn) {
+  if (what === "kill") {
+    confirmClick("kill-" + id, btn, function () {
+      runAction("agent_kill", { sessionId: id }, "Killed " + id);
+    });
+    return;
+  }
+  if (what === "restart") { runAction("session_restart", { idOrName: id }, "Restarted " + id); return; }
+  if (what === "archive") { runAction("session_archive", { idOrName: id }, "Archived " + id); }
+}
+
+function cronAction(jobId, what, btn) {
+  if (what === "run") { runAction("cron_run", { jobId: jobId }, "Cron fired"); return; }
+  if (what === "delete") {
+    confirmClick("cron-" + jobId, btn, function () {
+      runAction("cron_delete", { jobId: jobId }, "Cron deleted");
+    });
+  }
+}
+
+// ============================================================
+// boot
+// ============================================================
+
+document.getElementById("refresh-btn").addEventListener("click", function () { loadHealth(); loadAll(); });
+document.getElementById("ws-select").addEventListener("change", function (e) {
+  wsFilter = e.target.value;
+  renderSessions();
+});
+
+window.McpApp.connect()
+  .then(function (bridge) {
+    callTool = bridge.callTool;
+    buildHousekeeping();
+    loadHealth();
+    return loadAll();
+  })
+  .then(function () {
+    pollTimer = setInterval(loadAll, 5000);
+  })
+  .catch(function (err) {
+    document.getElementById("body").innerHTML =
+      '<div class="empty">Standalone mode \\u2014 no host bridge (' + escHtml(err.message) + ")</div>";
+  });
+</script>
+</body>
+</html>`;
+
+// src/ops-panel/index.ts
+var opsPanel = defineApp({
+  id: "@agentproto/ops-panel",
+  name: "Ops Panel",
+  version: "0.1.0",
+  description: "Daemon ops cockpit \u2014 watchdog & manager sessions, workspace-filtered session list, GC and cron housekeeping.",
+  agents: [watchdog, manager],
+  ui: {
+    html: OPS_PANEL_HTML,
+    title: "Ops Panel",
+    tools: [...OPS_PANEL_TOOLS]
+  }
+});
+var narrator = {
+  agent: defineAgent({
+    schema: "agent/v1",
+    id: "@agentproto/session-narrator",
+    description: "Reads a daemon session's transcript and narrates it in plain English \u2014 what happened, what was decided, what's left.",
+    model: "claude-sonnet-5",
+    boundaries: [
+      "Read-only \u2014 never spawn, kill, resume, or write to any session",
+      "Narrate only what the transcript actually shows, never speculate about intent"
+    ],
+    tools: ["conversation_read", "session_list"],
+    workflows: [{ ref: "narrate-session" }]
+  }),
+  body: [
+    "You narrate a daemon session's conversation for a human who doesn't want to read the raw transcript.",
+    "",
+    'Given a session id or name, call `conversation_read` with `format: "json"` to get the',
+    "structured turn list (`meta` + `messages`, each `{ role, text, toolCalls?, ts }`). If the",
+    "session id is ambiguous or unknown, call `session_list` first to resolve it by label.",
+    "",
+    "Write a short plain-English narration:",
+    "- What the user asked for.",
+    "- What the assistant did, grouped into a few natural beats (not a line-by-line tool log).",
+    "- Any open question, decision point, or unfinished step at the end of the transcript.",
+    "",
+    "Skip tool-call plumbing details unless they're the point (e.g. a failing command, a real",
+    "decision). If `conversation.conversation` comes back null, say plainly that this session has",
+    "no readable conversation (e.g. a bare shell PTY) instead of guessing."
+  ].join("\n")
+};
+var narrateSession = defineWorkflow({
+  id: "narrate-session",
+  name: "Narrate Session",
+  description: "Read a daemon session's transcript and narrate it in plain English.",
+  version: "0.1.0",
+  inputs: {},
+  outputs: {},
+  steps: [
+    {
+      id: "narrate",
+      kind: "agent",
+      agent: { ref: "@agentproto/session-narrator" },
+      prompt: "Narrate the session named in the run input (or the most recently started session if none was given): what the user asked for, what the assistant did, and what \u2014 if anything \u2014 is still open at the end of the transcript."
+    }
+  ]
+});
+
+// src/session-viewer/ui.ts
+var SESSION_VIEWER_TOOLS = ["session_list", "conversation_read"];
+var APP_ID4 = "@agentproto/session-viewer";
+var SESSION_VIEWER_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Session Viewer</title>
+<style>
+*{box-sizing:border-box;margin:0;padding:0}
+:root{
+  --bg:#0d1117;--bg2:#161b22;--bg3:#21262d;--border:#30363d;
+  --text:#e6edf3;--text2:#8b949e;--text3:#6e7681;
+  --green:#3fb950;--yellow:#d29922;--red:#f85149;--blue:#58a6ff;--purple:#bc8cff;
+}
+html,body{height:100%;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;font-size:13px;background:var(--bg);color:var(--text)}
+#app{display:flex;height:100%;overflow:hidden}
+
+/* sidebar */
+#sidebar{width:250px;min-width:190px;background:var(--bg2);border-right:1px solid var(--border);display:flex;flex-direction:column;flex-shrink:0}
+#sidebar-hdr{padding:10px 12px;border-bottom:1px solid var(--border);display:flex;align-items:center;gap:8px}
+#sidebar-hdr h1{font-size:11px;font-weight:700;color:var(--text2);text-transform:uppercase;letter-spacing:.06em;flex:1}
+#archived-toggle{display:flex;align-items:center;gap:5px;font-size:10.5px;color:var(--text2);padding:6px 12px;border-bottom:1px solid var(--border);cursor:pointer;user-select:none}
+#archived-toggle input{cursor:pointer}
+#refresh-btn{background:none;border:none;cursor:pointer;color:var(--text2);font-size:14px;line-height:1;padding:2px 4px;border-radius:4px;font-family:inherit}
+#refresh-btn:hover{color:var(--text);background:var(--bg3)}
+#session-list{flex:1;overflow-y:auto;padding:4px 0}
+.si{padding:8px 12px;cursor:pointer;border-left:2px solid transparent}
+.si:hover{background:var(--bg3)}
+.si.active{background:var(--bg3);border-left-color:var(--blue)}
+.si .sn{font-size:12px;font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.si .sm{font-size:10.5px;color:var(--text2);margin-top:3px;display:flex;gap:5px;align-items:center;flex-wrap:wrap}
+.badge{display:inline-block;padding:1px 6px;border-radius:10px;font-size:9.5px;font-weight:700;text-transform:uppercase;letter-spacing:.02em}
+.b-run{background:rgba(63,185,80,.15);color:var(--green)}
+.b-wait{background:rgba(88,166,255,.15);color:var(--blue)}
+.b-idle{background:rgba(139,148,158,.12);color:var(--text2)}
+.b-end{background:rgba(139,148,158,.1);color:var(--text3)}
+.b-err{background:rgba(248,81,73,.15);color:var(--red)}
+#empty-sidebar{padding:14px 12px;color:var(--text2);font-size:11.5px}
+
+/* main */
+#main{flex:1;display:flex;flex-direction:column;overflow:hidden;min-width:0}
+#header{padding:12px 18px;border-bottom:1px solid var(--border);background:var(--bg2);flex-shrink:0}
+#header .htitle{font-size:14px;font-weight:700;display:flex;align-items:center;gap:8px}
+.pulse{width:7px;height:7px;border-radius:50%;background:var(--green);flex:none;box-shadow:0 0 0 0 rgba(63,185,80,.4);animation:pulse 2s infinite}
+@keyframes pulse{70%{box-shadow:0 0 0 6px rgba(63,185,80,0)}100%{box-shadow:0 0 0 0 rgba(63,185,80,0)}}
+#header .hfacts{display:flex;flex-wrap:wrap;gap:6px;margin-top:8px}
+.fact{font-size:10.5px;font-weight:600;background:var(--bg3);border:1px solid var(--border);color:var(--text2);padding:3px 9px;border-radius:999px}
+#empty-main,#loading-main,#error-main{flex:1;display:flex;flex-direction:column;align-items:center;justify-content:center;color:var(--text2);gap:8px;text-align:center;padding:24px}
+#empty-main .ico,#loading-main .ico{font-size:30px}
+#error-main{color:var(--red)}
+
+/* transcript */
+#transcript{flex:1;overflow-y:auto;padding:14px 18px;display:flex;flex-direction:column;gap:10px}
+.msg{display:flex;flex-direction:column;max-width:78%}
+.msg.role-user{align-self:flex-end;align-items:flex-end}
+.msg.role-assistant,.msg.role-tool{align-self:flex-start;align-items:flex-start}
+.msg.role-system{align-self:center;max-width:90%}
+.bubble{border-radius:10px;padding:9px 12px;font-size:13px;line-height:1.55;white-space:pre-wrap;word-break:break-word}
+.role-user .bubble{background:var(--blue);color:#04101c;border-bottom-right-radius:3px}
+.role-assistant .bubble{background:var(--bg2);border:1px solid var(--border);border-bottom-left-radius:3px}
+.role-system .bubble{background:transparent;border:1px dashed var(--border);color:var(--text2);font-size:11.5px;text-align:center}
+.mrow{display:flex;align-items:center;gap:6px;margin-bottom:3px}
+.mrole{font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.04em;color:var(--text3)}
+.mtime{font-size:10px;color:var(--text3);font-variant-numeric:tabular-nums}
+
+.chip{margin-top:6px;border:1px solid var(--border);border-radius:8px;background:var(--bg3);overflow:hidden;cursor:pointer;width:100%}
+.chip .ch{padding:6px 10px;font-size:11.5px;display:flex;align-items:center;gap:7px;color:var(--text2)}
+.chip .ch .ci{color:var(--yellow);flex:none}
+.chip.tool-result .ch .ci{color:var(--purple)}
+.chip .ch .cname{font-weight:600;color:var(--text)}
+.chip .ch .cprev{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--text3)}
+.chip .ch .cchev{flex:none;transition:transform .12s;color:var(--text3);font-size:10px}
+.chip.open .ch .cchev{transform:rotate(90deg)}
+.chip pre{display:none;margin:0;border-top:1px solid var(--border);padding:9px 11px;font-family:Menlo,Monaco,'Courier New',monospace;font-size:11px;line-height:1.5;color:var(--text2);white-space:pre-wrap;word-break:break-word;max-height:320px;overflow:auto}
+.chip.open pre{display:block}
+.reasoning{margin-bottom:6px;font-size:11.5px;font-style:italic;color:var(--text2);border-left:2px solid var(--border);padding-left:8px}
+
+#statusbar{padding:5px 18px;font-size:10.5px;color:var(--text2);border-top:1px solid var(--border);background:var(--bg2);flex-shrink:0;display:flex;justify-content:space-between}
+</style>
+</head>
+<body>
+<div id="app">
+  <div id="sidebar">
+    <div id="sidebar-hdr">
+      <h1>Sessions</h1>
+      <button id="refresh-btn" title="Refresh" type="button">&#8635;</button>
+    </div>
+    <label id="archived-toggle"><input type="checkbox" id="archived-check"> show archived</label>
+    <div id="session-list"></div>
+  </div>
+  <div id="main">
+    <div id="header" style="display:none"></div>
+    <div id="empty-main"><div class="ico">&#128172;</div><div>Pick a session to read its conversation</div></div>
+    <div id="transcript" style="display:none"></div>
+    <div id="statusbar" style="display:none">
+      <span id="status-left"></span>
+      <span id="status-right"></span>
+    </div>
+  </div>
+</div>
+<script>
+var callTool = null;
+var APP_ID = ${JSON.stringify(APP_ID4)};
+
+// app_tool_call wraps its dispatch result at least once (its own text-result
+// body is the JSON-stringified inner MCP tool result); peel back through
+// nested {content:[{type:"text",text:...}]} shells until the payload stops
+// looking like one \u2014 works whichever layer the host's bridge already
+// unwrapped. With conversation_read's format:"json" this resolves straight
+// to the { meta, messages } object; with session_list, straight to
+// { sessions: [...] }.
+function unwrapText(result) {
+  var cur = result;
+  for (var i = 0; i < 4; i++) {
+    if (typeof cur === "string") {
+      try { cur = JSON.parse(cur); continue; } catch (e) { return cur; }
+    }
+    if (cur && Array.isArray(cur.content) && cur.content[0] && typeof cur.content[0].text === "string") {
+      cur = cur.content[0].text;
+      continue;
+    }
+    break;
+  }
+  return cur;
+}
+
+function callApp(tool, args) {
+  return callTool("app_tool_call", { appId: APP_ID, tool: tool, args: args || {} }).then(unwrapText);
+}
+
+function escHtml(s) {
+  return String(s == null ? "" : s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+function fmtTime(ts) {
+  if (!ts) return "";
+  try { return new Date(ts).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", second: "2-digit" }); }
+  catch (e) { return ""; }
+}
+
+function fmtClock(iso) {
+  if (!iso) return "";
+  try { return new Date(iso).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" }); }
+  catch (e) { return ""; }
+}
+
+function fmtRelative(iso) {
+  if (!iso) return "";
+  var ms = Date.now() - new Date(iso).getTime();
+  if (!isFinite(ms)) return "";
+  var s = Math.round(ms / 1000);
+  if (s < 5) return "just now";
+  if (s < 60) return s + "s ago";
+  var m = Math.round(s / 60);
+  if (m < 60) return m + "m ago";
+  var h = Math.round(m / 60);
+  if (h < 24) return h + "h ago";
+  return Math.round(h / 24) + "d ago";
+}
+
+function fmtDuration(startIso, endIso) {
+  var end = endIso ? new Date(endIso).getTime() : Date.now();
+  var start = new Date(startIso).getTime();
+  if (!isFinite(start) || !isFinite(end)) return "";
+  var s = Math.max(0, Math.round((end - start) / 1000));
+  if (s < 60) return s + "s";
+  var m = Math.floor(s / 60);
+  if (m < 60) return m + "m " + (s % 60) + "s";
+  var h = Math.floor(m / 60);
+  return h + "h " + (m % 60) + "m";
+}
+
+function prettyArgs(raw) {
+  if (raw == null) return "";
+  if (typeof raw !== "string") return JSON.stringify(raw, null, 2);
+  try { return JSON.stringify(JSON.parse(raw), null, 2); } catch (e) { return raw; }
+}
+
+function firstLine(s, max) {
+  var t = String(s == null ? "" : s).split("\\n")[0];
+  return t.length > max ? t.slice(0, max) + "\\u2026" : t;
+}
+
+// ============================================================
+// state
+// ============================================================
+
+var sessions = [];
+var activeId = null;
+var includeArchived = false;
+var currentMeta = null;
+var lastMessageCount = -1;
+var sidebarTimer = null;
+var convoTimer = null;
+
+function findSession(id) {
+  for (var i = 0; i < sessions.length; i++) if (sessions[i].id === id) return sessions[i];
+  return null;
+}
+
+function isLive(s) {
+  return !!s && (s.status === "running" || s.status === "starting");
+}
+
+// ============================================================
+// sidebar
+// ============================================================
+
+function displayBadge(s) {
+  if (s.status === "running") {
+    if (s.busy) return { label: "working", cls: "b-run" };
+    if (s.awaitingInput) return { label: "waiting", cls: "b-wait" };
+    return { label: "idle", cls: "b-idle" };
+  }
+  if (s.status === "starting") return { label: "starting", cls: "b-wait" };
+  if (s.status === "error" || s.status === "killed") return { label: s.status, cls: "b-err" };
+  return { label: s.status || "exited", cls: "b-end" };
+}
+
+function renderSidebar() {
+  var el = document.getElementById("session-list");
+  if (sessions.length === 0) {
+    el.innerHTML = '<div id="empty-sidebar">No sessions yet.</div>';
+    return;
+  }
+  var html = "";
+  for (var i = 0; i < sessions.length; i++) {
+    var s = sessions[i];
+    var label = s.label || s.title || s.name || (s.command ? String(s.command).split("/").pop() : null) || s.id.slice(0, 10);
+    var db = displayBadge(s);
+    var active = s.id === activeId ? " active" : "";
+    html += '<div class="si' + active + '" data-id="' + escHtml(s.id) + '">'
+      + '<div class="sn">' + escHtml(label) + "</div>"
+      + '<div class="sm">'
+      + '<span class="badge ' + db.cls + '">' + escHtml(db.label) + "</span>"
+      + "<span>" + escHtml(s.kind || "") + "</span>"
+      + "<span>" + escHtml(fmtRelative(s.startedAt)) + "</span>"
+      + "</div></div>";
+  }
+  el.innerHTML = html;
+  var rows = el.querySelectorAll(".si");
+  for (var j = 0; j < rows.length; j++) {
+    rows[j].addEventListener("click", (function (id) { return function () { selectSession(id); }; })(rows[j].getAttribute("data-id")));
+  }
+}
+
+function loadSessions() {
+  return callApp("session_list", { kind: "all", includeArchived: includeArchived }).then(function (data) {
+    sessions = (data && data.sessions) || [];
+    renderSidebar();
+    if (activeId) {
+      var hdr = document.getElementById("header");
+      if (hdr.style.display !== "none") renderHeader();
+    }
+  }).catch(function (e) {
+    document.getElementById("status-left").textContent = "sessions: " + e.message;
+  });
+}
+
+// ============================================================
+// header
+// ============================================================
+
+function renderHeader() {
+  var s = findSession(activeId);
+  var meta = currentMeta || {};
+  var el = document.getElementById("header");
+  el.style.display = "block";
+
+  var title = meta.title || (s && (s.label || s.title)) || activeId;
+  var live = s && isLive(s);
+  var pulse = live ? '<span class="pulse"></span>' : "";
+
+  var facts = [];
+  if (meta.model || (s && s.model)) facts.push(escHtml(meta.model || (s && s.model)));
+  if (s && s.adapterSlug) facts.push(escHtml(s.adapterSlug));
+  if (s && s.kind) facts.push(escHtml(s.kind));
+  if (s) { var db = displayBadge(s); facts.push(escHtml(db.label)); }
+  if (s && s.cwd) facts.push('<span title="' + escHtml(s.cwd) + '">' + escHtml(s.cwd.length > 46 ? "\\u2026" + s.cwd.slice(-44) : s.cwd) + "</span>");
+  var started = (meta.startedAt || (s && s.startedAt));
+  if (started) facts.push("started " + escHtml(fmtClock(started)) + " (" + escHtml(fmtRelative(started)) + ")");
+  var ended = meta.endedAt || (s && s.endedAt);
+  if (ended) facts.push("ran " + escHtml(fmtDuration(started, ended)));
+  else if (started) facts.push("running " + escHtml(fmtDuration(started)));
+  if (meta.messageCount != null) facts.push(meta.messageCount + " messages");
+  if (meta.toolCallCount != null) facts.push(meta.toolCallCount + " tool calls");
+  if (meta.tokens && (meta.tokens.input != null || meta.tokens.output != null)) {
+    facts.push("tokens " + (meta.tokens.input || 0) + "\\u2192" + (meta.tokens.output || 0));
+  }
+  if (meta.costUsd != null) facts.push("$" + Number(meta.costUsd).toFixed(4));
+
+  el.innerHTML = '<div class="htitle">' + pulse + escHtml(title) + "</div>"
+    + '<div class="hfacts">' + facts.map(function (f) { return '<span class="fact">' + f + "</span>"; }).join("") + "</div>";
+}
+
+// ============================================================
+// transcript
+// ============================================================
+
+function renderToolCallChip(tc) {
+  var args = prettyArgs(tc.args);
+  return '<div class="chip tool-call"><div class="ch"><span class="ci">&#9656;</span>'
+    + '<span class="cname">' + escHtml(tc.name || "tool") + "</span>"
+    + '<span class="cprev">' + escHtml(firstLine(args, 64)) + "</span>"
+    + '<span class="cchev">&#9656;</span></div><pre>' + escHtml(args) + "</pre></div>";
+}
+
+function renderToolResultChip(m) {
+  var text = m.text || "";
+  return '<div class="chip tool-result"><div class="ch"><span class="ci">&#128295;</span>'
+    + '<span class="cname">' + escHtml(m.toolName || "result") + "</span>"
+    + '<span class="cprev">' + escHtml(firstLine(text, 64)) + "</span>"
+    + '<span class="cchev">&#9656;</span></div><pre>' + escHtml(text) + "</pre></div>";
+}
+
+function renderMessage(m) {
+  var time = m.ts ? '<span class="mtime">' + fmtTime(m.ts) + "</span>" : "";
+  if (m.role === "system") {
+    return '<div class="msg role-system"><div class="bubble">' + escHtml(m.text || "") + "</div></div>";
+  }
+  if (m.role === "tool") {
+    return '<div class="msg role-tool">' + renderToolResultChip(m) + "</div>";
+  }
+  if (m.role === "user") {
+    return '<div class="msg role-user"><div class="mrow"><span class="mrole">You</span>' + time + "</div>"
+      + '<div class="bubble">' + escHtml(m.text || "") + "</div></div>";
+  }
+  // assistant
+  var inner = "";
+  if (m.reasoning) inner += '<div class="reasoning">' + escHtml(m.reasoning) + "</div>";
+  if (m.text) inner += escHtml(m.text);
+  var body = inner ? '<div class="bubble">' + inner + "</div>" : "";
+  var chips = (m.toolCalls || []).map(renderToolCallChip).join("");
+  return '<div class="msg role-assistant"><div class="mrow"><span class="mrole">Assistant</span>' + time + "</div>"
+    + body + chips + "</div>";
+}
+
+function renderTranscript(messages) {
+  var el = document.getElementById("transcript");
+  var atBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 80;
+  el.style.display = "flex";
+  document.getElementById("empty-main").style.display = "none";
+  var errEl = document.getElementById("error-main");
+  if (errEl) errEl.style.display = "none";
+  if (messages.length === 0) {
+    el.innerHTML = '<div style="color:var(--text2);text-align:center;padding:20px">(empty conversation)</div>';
+    return;
+  }
+  el.innerHTML = messages.map(renderMessage).join("");
+  if (atBottom) el.scrollTop = el.scrollHeight;
+
+  var chips = el.querySelectorAll(".chip");
+  for (var i = 0; i < chips.length; i++) {
+    chips[i].querySelector(".ch").addEventListener("click", (function (chip) {
+      return function () { chip.classList.toggle("open"); };
+    })(chips[i]));
+  }
+}
+
+function renderNoConversation(reason) {
+  document.getElementById("transcript").style.display = "none";
+  document.getElementById("empty-main").style.display = "none";
+  var el = document.getElementById("error-main");
+  el.style.display = "flex";
+  el.innerHTML = '<div class="ico">&#128683;</div><div>No readable conversation for this session'
+    + (reason ? '<br><span style="font-size:11px;color:var(--text3)">' + escHtml(reason) + "</span>" : "")
+    + "</div>";
+}
+
+// ============================================================
+// selection + polling
+// ============================================================
+
+function clearConvoPoll() {
+  if (convoTimer) { clearTimeout(convoTimer); convoTimer = null; }
+}
+
+function scheduleConvoPoll() {
+  clearConvoPoll();
+  var s = findSession(activeId);
+  if (!isLive(s)) return;
+  convoTimer = setTimeout(function () {
+    loadConversation(activeId, { silent: true });
+  }, 3500);
+}
+
+function loadConversation(id, opts) {
+  opts = opts || {};
+  var requestedId = id;
+  if (!opts.silent) {
+    document.getElementById("transcript").style.display = "none";
+    document.getElementById("empty-main").style.display = "none";
+    var errEl = document.getElementById("error-main");
+    errEl.style.display = "flex";
+    errEl.innerHTML = '<div class="ico">&#8987;</div><div>Loading\\u2026</div>';
+  }
+  document.getElementById("status-left").textContent = "loading\\u2026";
+  return callApp("conversation_read", { idOrName: id, format: "json" }).then(function (data) {
+    if (activeId !== requestedId) return; // switched away meanwhile
+    if (!data || !Array.isArray(data.messages)) {
+      currentMeta = null;
+      renderHeader();
+      renderNoConversation(data && data.reason);
+      clearConvoPoll();
+      document.getElementById("status-left").textContent = "no conversation";
+      return;
+    }
+    currentMeta = data.meta || {};
+    lastMessageCount = data.messages.length;
+    renderHeader();
+    renderTranscript(data.messages);
+    document.getElementById("status-left").textContent = data.messages.length + " messages";
+    document.getElementById("status-right").textContent = "updated " + fmtTime(Date.now());
+    scheduleConvoPoll();
+  }).catch(function (e) {
+    if (activeId !== requestedId) return;
+    document.getElementById("status-left").textContent = "error: " + e.message;
+    if (!opts.silent) renderNoConversation(e.message);
+  });
+}
+
+function selectSession(id) {
+  if (activeId === id) return;
+  activeId = id;
+  currentMeta = null;
+  lastMessageCount = -1;
+  clearConvoPoll();
+  renderSidebar();
+  document.getElementById("statusbar").style.display = "flex";
+  renderHeader();
+  loadConversation(id, {});
+}
+
+// ============================================================
+// boot
+// ============================================================
+
+document.getElementById("refresh-btn").addEventListener("click", function () {
+  loadSessions();
+  if (activeId) loadConversation(activeId, {});
+});
+document.getElementById("archived-check").addEventListener("change", function (e) {
+  includeArchived = !!e.target.checked;
+  loadSessions();
+});
+
+window.McpApp.connect()
+  .then(function (bridge) {
+    callTool = bridge.callTool;
+    return loadSessions();
+  })
+  .then(function () {
+    sidebarTimer = setInterval(loadSessions, 5000);
+    if (!activeId && sessions.length > 0) selectSession(sessions[0].id);
+  })
+  .catch(function (err) {
+    document.getElementById("empty-main").innerHTML =
+      '<div class="ico">&#9888;</div><div>Standalone mode \\u2014 no host bridge (' + escHtml(err.message) + ")</div>";
+  });
+</script>
+</body>
+</html>`;
+
+// src/session-viewer/index.ts
+var sessionViewer = defineApp({
+  id: "@agentproto/session-viewer",
+  name: "Session Viewer",
+  version: "0.1.0",
+  description: "Read a daemon session as a clean conversation \u2014 turns, tool calls, timestamps.",
+  agents: [narrator],
+  workflows: [narrateSession],
+  ui: {
+    html: SESSION_VIEWER_HTML,
+    title: "Session Viewer",
+    tools: [...SESSION_VIEWER_TOOLS]
+  }
+});
 
 // src/bin/sync.ts
 var APPS = [
   { slug: "code-team", category: "team", handle: codeTeam },
   { slug: "content-team", category: "team", handle: contentTeam },
   { slug: "mail-triage", category: "app", handle: mailTriage },
-  { slug: "media-viewer", category: "app", handle: mediaViewer }
+  { slug: "media-viewer", category: "app", handle: mediaViewer },
+  { slug: "ops-panel", category: "app", handle: opsPanel },
+  { slug: "session-viewer", category: "app", handle: sessionViewer }
 ];
 async function syncApps(baseDir) {
   const catalog = [];