@bill10/agent-007 0.9.3000 → 0.11.0

package/.env.example

@@ -35,6 +35,11 @@
 # same kind of mode.
 # AGENT_MESSAGING=open
 
+# After a restart, the board brings back each worker on one of Billion's cards
+# that is still In progress (the worker resumes its own worktree and
+# conversation). 0 leaves them in the orphans list for you to re-spawn.
+# RESPAWN_BOARD_WORKERS=0
+
 # Billion, the always-on agent you talk to (docs/BILLION.md). On by default;
 # 0/false/off/no turns it off. It is also off whenever user accounts exist.
 # BILLION=0

package/README.md

@@ -51,7 +51,7 @@ Uncomment what you want, then restart. The ones people change:
 | Setting | What it does |
 |---------|--------------|
 | `BILLION=0` | Turns off Billion, the always-on agent |
-| `TELEGRAM_BOT_TOKEN` + `TELEGRAM_CHAT_ID` | Billion's questions reach your phone, and you answer from there ([setup](docs/BILLION.md#telegram)) |
+| `TELEGRAM_BOT_TOKEN` + `TELEGRAM_CHAT_ID` | Billion's questions reach your phone as well as the Waiting on you tab, and you answer from either, with a tap when it is a pick ([setup](docs/BILLION.md#telegram)) |
 | `HOST=0.0.0.0` + `ALLOWED_ORIGINS=<tailnet name>` | Reach it from your phone or another machine (behind Tailscale only, see [docs/REMOTE.md](docs/REMOTE.md)) |
 | `CLAUDE_PERMISSION_MODE` | Mode Claude Code agents start in, e.g. `bypassPermissions` |
 | `CODEX_PERMISSION_MODE` | The same for Codex |
@@ -83,14 +83,15 @@ up a stale local base or whatever unrelated branch you happen to have checked
 out. Override it per agent with **Advanced -> Start from** when you want to
 branch off work in progress.
 
-The job board reuses that same machinery: a dispatched job is an ordinary agent, with a real terminal you can type into and take over at any point. Each job gets its own worktree and branch, so a job maps one-to-one onto a branch and a pull request. When the agent finishes it calls the board's `finish_job` tool (a card that requires a pull request hands over the PR it opened; one that does not hands over a summary), and the card moves to Review with the agent still running, so you can click straight into it to ask about the work. When the card reaches Done the board closes the agent and releases its worktree and local branch; the PR itself is untouched, and work that was never pushed is kept as an orphan rather than deleted. **Re-spawn** on an orphan picks that conversation back up with the CLI it ran, `codex resume <session-id>` (the newest Codex session recorded in that exact worktree) or `claude --continue`, under the permission mode its job card was dispatched with (a board agent whose card is already finished or deleted follows the board's current setting), or, for an agent you spawned by hand, under the permission flags you started it with. A board worker re-spawned after a restart is its card's worker again: it counts toward the cap, sends its approvals where the card says, is told once to carry on if its card is still In progress, and leaves like any other board worker when the card is filed. When the PR merges the job is filed away as finished -- the record is kept, the card is not.
+The job board reuses that same machinery: a dispatched job is an ordinary agent, with a real terminal you can type into and take over at any point. Each job gets its own worktree and branch, so a job maps one-to-one onto a branch and a pull request. When the agent finishes it calls the board's `finish_job` tool (a card that requires a pull request hands over the PR it opened; one that does not hands over a summary), and the card moves to Review with the agent still running, so you can click straight into it to ask about the work. When the card reaches Done the board closes the agent and releases its worktree and local branch; the PR itself is untouched, and work that was never pushed is kept as an orphan rather than deleted. **Re-spawn** on an orphan picks that conversation back up with the CLI it ran, `codex resume <session-id>` (the newest Codex session recorded in that exact worktree) or `claude --continue`, under the permission mode its job card was dispatched with (a board agent whose card is already finished or deleted follows the board's current setting), or, for an agent you spawned by hand, under the permission flags you started it with. A board worker re-spawned after a restart is its card's worker again: it counts toward the cap, sends its approvals where the card says, is told once to carry on if its card is still In progress, and leaves like any other board worker when the card is filed. Workers on Billion's own cards still In progress come back by themselves after a restart, one every couple of seconds within the per-repo cap (`RESPAWN_BOARD_WORKERS=0` turns that off), and Billion can bring back an orphan on one of its cards with its `respawn_agent` tool. When the PR merges the job is filed away as finished -- the record is kept, the card is not.
 
 ```
 ┌─────────────┬──────────────┬────────────────────┐
 │  Explorer   │  Pixel       │  Jobs + Terminals   │
-│  (repos,    │  Office      │  (job board tab,    │
-│   files,    │  (canvas,    │   xterm.js, one     │
-│   diffs)    │   agents)    │   tab per agent)    │
+│  (repos,    │  Office      │  (job board and     │
+│   files,    │  (canvas,    │   Waiting on you    │
+│   diffs)    │   agents)    │   tabs, xterm.js,   │
+│             │              │   one tab per agent)│
 └─────────────┴──────────────┴────────────────────┘
 ```
 
@@ -120,6 +121,7 @@ ALLOWED_ORIGINS=mac-mini.tailXXXX.ts.net npm start   # Allow a remote browser or
 | `CLAUDE_PERMISSION_MODE` | *(the CLI's own)* | Permission mode every Claude Code agent the app starts runs in (`auto`, `acceptEdits`, `bypassPermissions`, `manual`, `dontAsk`, `plan`). Flags in the command, a card's own mode or a mode picked in the board's dropdown win over it |
 | `CODEX_PERMISSION_MODE` | *(the CLI's own)* | The same for Codex agents, mapped onto Codex's sandbox and approval flags |
 | `AGENT_MESSAGING` | *(guarded)* | `open` lets any of your agents message any other. By default an agent that asks before acting cannot message one that never asks |
+| `RESPAWN_BOARD_WORKERS` | *(on)* | `0` leaves Billion's workers orphaned after a restart. On, each one whose card is still In progress comes back by itself, resuming its own worktree and conversation, within the board's per-repo cap |
 | `BILLION` | *(on)* | `0` (or `false`/`off`/`no`) turns Billion off. It is also off whenever user accounts exist, since it would belong to everyone |
 | `BILLION_DIR` | `~/.agent-007/billion` | Billion's own folder and git repo. Point it at a new or empty folder |
 | `TELEGRAM_BOT_TOKEN` | *(off)* | A Telegram bot's token. Billion's `notify_owner` questions are sent through it, and replies come back into Billion's terminal. See [docs/BILLION.md](docs/BILLION.md#telegram) |
@@ -220,6 +222,7 @@ public/
     terminal.js    xterm.js terminals, clipboard paste, tab management
     explorer.js    File tree, diff viewer, repo management
     jobs.js        Job board UI (columns, cards, the job form)
+    waiting.js     The Waiting on you tab (Billion's questions, answered by a click or a typed line)
     ws.js          WebSocket client with auto-reload on reconnect
     state.js       Shared client state (agents, repos, viewer identity, server platform, the panel a phone shows)
     shortcuts.js   Keyboard shortcuts

package/VERSION

@@ -1 +1 @@
-0.9.3.0
+0.11.0.0

package/bin/agent-007.js

@@ -39,6 +39,7 @@ Settings (default in brackets):
                           bypassPermissions, manual, dontAsk, plan [Claude's own]
   CODEX_PERMISSION_MODE   The same for Codex agents [Codex's own]
   AGENT_MESSAGING         open = any agent may message any other [guarded]
+  RESPAWN_BOARD_WORKERS   0 = Billion's workers stay orphaned after a restart [on]
   BILLION                 0 turns off Billion, the always-on agent [on]
   BILLION_DIR             Billion's folder and repo [~/.agent-007/billion]
   TELEGRAM_BOT_TOKEN      Bot token for Billion's questions on your phone [off]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bill10/agent-007",
-  "version": "0.9.3000",
+  "version": "0.11.0",
   "description": "From web terminals for your coding agents to a self-running agent company: Claude Code and Codex in parallel git worktrees, a job board they pick work from, and one agent that runs the board from a goal.",
   "license": "MIT",
   "repository": {

package/public/app.js

@@ -1,5 +1,5 @@
 // Main init + message routing
-import { agents, repos, selfUserId, setSelf, shellPreset, setView, setBillionEnabled, setWaitingItems } from './modules/state.js';
+import { agents, repos, selfUserId, setSelf, shellPreset, setView, setBillionEnabled, setWaitingItems, waitingActive } from './modules/state.js';
 import { connect, send } from './modules/ws.js';
 import {
   handleSessionCreated, handlePtyOutput, handlePtySize, handleStateChange,
@@ -22,6 +22,7 @@ import { setupShortcuts } from './modules/shortcuts.js';
 import { setupVoice, stopVoice } from './modules/voice.js';
 import { setupJobBoard, handleJobsList, renderBoard, closeJobForm } from './modules/jobs.js';
 import { isAbsolutePath, joinBrowsePath } from './modules/paths.js';
+import { renderWaiting, handleWaitingError, showWaiting, leaveWaiting } from './modules/waiting.js';
 import { captureTokenFromUrl, authHeaders, showLogin, renderPresence, escapeHtml } from './modules/auth.js';
 
 // Cross-module coordination: when sessions change, re-render office + explorer
@@ -461,11 +462,14 @@ function setupResize() {
   });
   // Phone bottom nav. The shown panel changes size from 0, so refit after reflow.
   document.getElementById('mobile-nav').onclick = (e) => {
-    const view = e.target.dataset.view;
+    const view = e.target.closest('button')?.dataset.view;
     if (!view) return;
     // The mic's only "recording" cue lives in the terminal panel.
     if (view !== 'terminal') stopVoice({ notice: 'Voice input stopped — left the terminal' });
-    setView(view);
+    // Waiting is the terminal panel showing the Waiting tab.
+    if (view === 'waiting') { showWaiting(); updateTabs(); }
+    else if (view === 'terminal' && waitingActive) { leaveWaiting(); updateTabs(); }
+    setView(view === 'waiting' ? 'terminal' : view);
     requestAnimationFrame(() => { renderOffice(); fitActiveTerminal(); });
   };
 }
@@ -533,7 +537,8 @@ function onMessage(msg) {
     case 'file-diff': handleFileDiff(msg); break;
     case 'full-tree': handleFullTree(msg); break;
     case 'orphans-list': handleOrphansList(msg); break;
-    case 'waiting-list': setWaitingItems(msg.items); renderExplorer(); break;
+    case 'waiting-list': setWaitingItems(msg.items); renderWaiting(); updateTabs(); break;
+    case 'waiting-error': handleWaitingError(msg); break;
     // The office canvas pins one paper per job, so a jobs-list broadcast has
     // to repaint it too — the animation loop skips frames with no live agent.
     case 'jobs-list': handleJobsList(msg); noteJobsUpdate(); renderOffice(); break;

package/public/index.html

@@ -214,6 +214,10 @@
             <div class="job-cards" id="job-finished-cards"></div>
           </div>
         </div>
+        <!-- Waiting on you: Billion's questions (public/modules/waiting.js) -->
+        <div class="waiting-board" id="waiting-board" style="display:none">
+          <div class="waiting-list" id="waiting-list" aria-label="Waiting on you"></div>
+        </div>
         <div class="voice-indicator" id="voice-indicator" aria-hidden="true" style="display:none">
           <span class="voice-indicator-dot"></span><span class="voice-indicator-text"></span>
         </div>
@@ -230,6 +234,7 @@
     <button data-view="files">Files</button>
     <button data-view="office" aria-current="true">Office</button>
     <button data-view="terminal">Terminal</button>
+    <button data-view="waiting" class="mobile-nav-waiting" aria-label="Waiting on you"><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.2" stroke-linejoin="round" aria-hidden="true"><path d="M3 8.5V5.5a3 3 0 0 1 6 0v3l1 1H2z"/><path d="M5 11h2"/></svg>Waiting<span class="board-tab-badge" id="mobile-nav-waiting-count" hidden></span></button>
   </nav>
 
   <!-- Reconnecting banner -->

package/public/modules/explorer.js

@@ -1,5 +1,5 @@
 // File explorer panel — repo sections, branch trees, inline diffs
-import { agents, repos, orphans, activeSessionId, setView, billionEnabled, waitingItems } from './state.js';
+import { agents, repos, orphans, activeSessionId, setView, billionEnabled } from './state.js';
 import { send } from './ws.js';
 import { switchToSession } from './terminal.js';
 
@@ -326,32 +326,6 @@ function renderBillionRow(content) {
     entry.appendChild(start);
   }
   section.appendChild(entry);
-  // What Billion asked the owner with notify_owner, until they dismiss it.
-  if (waitingItems.length) {
-    const list = document.createElement('ul');
-    list.className = 'explorer-waiting';
-    list.setAttribute('aria-label', 'Waiting on you');
-    const head = document.createElement('li');
-    head.className = 'explorer-waiting-head';
-    head.textContent = 'Waiting on you';
-    list.appendChild(head);
-    for (const item of waitingItems) {
-      const li = document.createElement('li');
-      li.className = 'explorer-waiting-item';
-      const text = document.createElement('span');
-      text.textContent = item.text;
-      text.title = item.text;
-      const dismiss = document.createElement('button');
-      dismiss.className = 'explorer-icon-btn';
-      dismiss.textContent = '\u00d7';
-      dismiss.title = 'Dismiss';
-      dismiss.setAttribute('aria-label', 'Dismiss');
-      dismiss.onclick = () => send({ type: 'waiting-dismiss', id: item.id });
-      li.append(text, dismiss);
-      list.appendChild(li);
-    }
-    section.appendChild(list);
-  }
   content.appendChild(section);
 }
 

package/public/modules/jobs.js

@@ -13,6 +13,8 @@
 // it was written.
 
 import { agents, jobs, boardSettings, setBoardSettings, boardActive, setBoardActive, activeSessionId, repos } from './state.js';
+// Circular with waiting.js, which is fine: each calls the other only at event time.
+import { hideWaiting } from './waiting.js';
 import { send } from './ws.js';
 import { escapeHtml, getToken } from './auth.js';
 import { switchToSession } from './terminal.js';
@@ -871,6 +873,7 @@ export function closeJobForm() {
 // --- Show / hide ---
 
 export function showJobBoard() {
+  hideWaiting();
   // Always open on the columns. Opening the board is the user asking for the
   // live work; the archive is somewhere you go on purpose, not somewhere the
   // Jobs tab can strand you.

package/public/modules/state.js

@@ -28,9 +28,13 @@ export let serverPlatform = ''; // process.platform of the server, from the welc
 export let billionEnabled = false;
 export function setBillionEnabled(on) { billionEnabled = !!on; }
 
-// Billion's notify_owner messages the owner has not dismissed (server/owner.js).
+// Billion's notify_owner questions, open and answered, not dismissed
+// (server/owner.js). The "Waiting on you" tab shows them in the terminal
+// viewport, like the job board, and activeSessionId stays put meanwhile too.
 export let waitingItems = [];
 export function setWaitingItems(items) { waitingItems = Array.isArray(items) ? items : []; }
+export let waitingActive = false;
+export function setWaitingActive(on) { waitingActive = !!on; }
 
 // Billion's tab first, then the rest in their own order.
 export function billionFirst(entries) {
@@ -62,9 +66,11 @@ export function canControlAgent(agent) {
 
 // Which panel a phone shows (body[data-view], see .mobile-nav in style.css).
 // Set unconditionally: desktop CSS ignores it, so no width check is needed.
+// The Waiting button is the terminal panel showing the Waiting tab.
 export function setView(view) {
   document.body.dataset.view = view;
-  for (const b of document.querySelectorAll('.mobile-nav button')) b.setAttribute('aria-current', b.dataset.view === view);
+  const lit = view === 'terminal' && waitingActive ? 'waiting' : view;
+  for (const b of document.querySelectorAll('.mobile-nav button')) b.setAttribute('aria-current', b.dataset.view === lit);
 }
 
 export function stateColor(state) {

package/public/modules/terminal.js

@@ -1,10 +1,11 @@
 // Terminal (xterm.js) lifecycle, tabs, session switching, file upload
-import { agents, activeSessionId, setActiveSession, stateColor, canControlAgent, boardActive, jobs, billionFirst } from './state.js';
+import { agents, activeSessionId, setActiveSession, stateColor, canControlAgent, boardActive, waitingActive, jobs, billionFirst } from './state.js';
 import { send } from './ws.js';
 import { escapeHtml, safeColor } from './auth.js';
 import { isGlobalShortcut } from './shortcuts.js';
 import { stopVoice } from './voice.js';
 import { showJobBoard, hideJobBoard } from './jobs.js';
+import { showWaiting, hideWaiting, openCount } from './waiting.js';
 // Circular with office.js (it imports switchToSession), which is fine: both
 // sides only call the other's functions at event time, never during load.
 import { noteAgentDeparture } from './office.js';
@@ -194,7 +195,7 @@ export async function handleSessionCreated(msg) {
   // spawns open quietly — the tab dot, the office character and the job card
   // still announce them, and clicking any of them jumps here. A window showing
   // nothing takes it, unless that nothing is the job board being worked on.
-  const stealFocus = focus || replacesActive || (!activeSessionId && !boardActive);
+  const stealFocus = focus || replacesActive || (!activeSessionId && !boardActive && !waitingActive);
   if (stealFocus) switchToSession(sessionId);
   updateTabs();
   updateStatusBar();
@@ -312,6 +313,7 @@ export function switchToSession(sessionId) {
   // agent land in another's shell after a tab switch (or auto-switch on kill).
   if (sessionId !== activeSessionId) stopVoice({ notice: 'Voice input stopped — switched agents' });
   hideJobBoard();
+  hideWaiting();
   if (activeSessionId && agents.has(activeSessionId)) {
     agents.get(activeSessionId).termEl.style.display = 'none';
   }
@@ -366,6 +368,16 @@ export function removeSession(sessionId) {
   if (onSessionChanged) onSessionChanged();
 }
 
+export const BELL_ICON = '<svg class="board-tab-icon" width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.2" stroke-linejoin="round"><path d="M3 8.5V5.5a3 3 0 0 1 6 0v3l1 1H2z"/><path d="M5 11h2"/></svg>';
+
+// The phone's bottom bar carries the same count.
+function updateNavBadge(open) {
+  const badge = document.getElementById('mobile-nav-waiting-count');
+  if (!badge) return;
+  badge.textContent = open > 0 ? String(open) : '';
+  badge.hidden = open === 0;
+}
+
 export function updateTabs() {
   const container = document.getElementById('terminal-tabs');
   container.innerHTML = '';
@@ -392,6 +404,24 @@ export function updateTabs() {
   boardTab.onclick = () => { showJobBoard(); updateTabs(); };
   container.appendChild(boardTab);
 
+  // Pinned next to it: Billion's questions to the owner, counted like Jobs.
+  const waitingTab = document.createElement('div');
+  waitingTab.className = `terminal-tab board-tab waiting-tab${waitingActive ? ' active' : ''}`;
+  waitingTab.title = 'Waiting on you: Billion\'s questions';
+  waitingTab.innerHTML = BELL_ICON;
+  waitingTab.appendChild(document.createTextNode('Waiting'));
+  const open = openCount();
+  if (open > 0) {
+    const badge = document.createElement('span');
+    badge.className = 'board-tab-badge';
+    badge.textContent = String(open);
+    badge.title = `${open} question${open === 1 ? '' : 's'} waiting on you`;
+    waitingTab.appendChild(badge);
+  }
+  waitingTab.onclick = () => { showWaiting(); updateTabs(); };
+  container.appendChild(waitingTab);
+  updateNavBadge(open);
+
   for (const [sessionId, agent] of billionFirst(agents)) {
     const tab = document.createElement('div');
     tab.className = `terminal-tab${sessionId === activeSessionId ? ' active' : ''}`;

package/public/modules/waiting.js

@@ -0,0 +1,164 @@
+// The "Waiting on you" tab: Billion's notify_owner questions, answered here
+// with a choice or a typed line (server/owner.js answerWaiting). Shares the
+// terminal viewport with the terminals and the job board, like Jobs does.
+import { agents, activeSessionId, waitingItems, waitingActive, setWaitingActive, setView } from './state.js';
+import { send } from './ws.js';
+import { hideJobBoard } from './jobs.js';
+
+const ANSWERED_SHOWN = 20;
+const drafts = new Map();   // item id -> reply typed but not sent, kept across re-renders
+const errors = new Map();   // item id -> why the last answer did not go through
+const pending = new Set();  // item ids answered, waiting for the server to say so
+let answeredOpen = false;   // the Answered section, as the owner left it
+
+export const openCount = () => waitingItems.filter(item => item.status === 'open').length;
+
+export function showWaiting() {
+  hideJobBoard();
+  const agent = activeSessionId ? agents.get(activeSessionId) : null;
+  if (agent) agent.termEl.style.display = 'none';
+  document.getElementById('terminal-empty').style.display = 'none';
+  document.getElementById('waiting-board').style.display = 'flex';
+  setWaitingActive(true);
+  setView(document.body.dataset.view);
+  renderWaiting();
+  if (window._onBoardVisibilityChanged) window._onBoardVisibilityChanged();
+}
+
+// The phone's Terminal button, pressed while this tab is showing: back to
+// the terminal that was open, or to the empty state.
+export function leaveWaiting() {
+  hideWaiting();
+  if (!activeSessionId || !agents.has(activeSessionId)) document.getElementById('terminal-empty').style.display = 'flex';
+  else agents.get(activeSessionId).termEl.style.display = 'block';
+}
+
+export function hideWaiting() {
+  const board = document.getElementById('waiting-board');
+  if (board) board.style.display = 'none';
+  setWaitingActive(false);
+  setView(document.body.dataset.view);
+}
+
+function answer(item, text) {
+  const body = text.trim();
+  if (!body || pending.has(item.id)) return;
+  errors.delete(item.id);
+  if (send({ type: 'waiting-answer', id: item.id, answer: body })) pending.add(item.id);
+  else errors.set(item.id, 'Not connected to the server; try again in a moment.');
+  renderWaiting();
+}
+
+export function handleWaitingError(msg) {
+  pending.delete(msg.id);
+  errors.set(msg.id, msg.error);
+  renderWaiting();
+}
+
+const el = (tag, className, text) => {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text !== undefined) node.textContent = text;
+  return node;
+};
+
+function ago(iso) {
+  const s = Math.max(0, (Date.now() - Date.parse(iso)) / 1000);
+  if (!Number.isFinite(s)) return '';
+  if (s < 60) return 'just now';
+  if (s < 3600) return `${Math.floor(s / 60)}m ago`;
+  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+  return `${Math.floor(s / 86400)}d ago`;
+}
+
+function openCard(item) {
+  const busy = pending.has(item.id);
+  const card = el('article', 'waiting-card');
+  card.dataset.id = item.id;
+  const head = el('div', 'waiting-card-head');
+  head.append(el('span', 'waiting-card-n', `Q${item.n}`), el('span', 'waiting-card-time', ago(item.at)));
+  const dismiss = el('button', 'explorer-icon-btn waiting-dismiss', '×');
+  dismiss.title = 'Dismiss';
+  dismiss.setAttribute('aria-label', `Dismiss Q${item.n}`);
+  dismiss.onclick = () => send({ type: 'waiting-dismiss', id: item.id });
+  head.appendChild(dismiss);
+  card.append(head, el('p', 'waiting-card-text', item.text));
+
+  if (Array.isArray(item.choices) && item.choices.length) {
+    const choices = el('div', 'waiting-choices');
+    for (const choice of item.choices) {
+      const btn = el('button', `waiting-choice${choice === item.recommended ? ' recommended' : ''}`, choice);
+      if (choice === item.recommended) {
+        btn.appendChild(el('span', 'waiting-choice-tag', 'recommended'));
+        btn.setAttribute('aria-label', `${choice} (recommended)`);
+      }
+      btn.disabled = busy;
+      btn.onclick = () => answer(item, choice);
+      choices.appendChild(btn);
+    }
+    card.appendChild(choices);
+  }
+
+  const form = el('form', 'waiting-reply');
+  const input = el('input');
+  input.type = 'text';
+  input.placeholder = item.choices?.length ? 'Or type an answer' : 'Type an answer';
+  input.setAttribute('aria-label', `Answer Q${item.n}`);
+  input.value = drafts.get(item.id) || '';
+  input.disabled = busy;
+  input.oninput = () => drafts.set(item.id, input.value);
+  const sendBtn = el('button', 'waiting-send', busy ? 'Sending' : 'Send');
+  sendBtn.type = 'submit';
+  sendBtn.disabled = busy;
+  form.onsubmit = (e) => {
+    e.preventDefault();
+    answer(item, input.value);
+  };
+  form.append(input, sendBtn);
+  card.appendChild(form);
+
+  if (errors.has(item.id)) {
+    const error = el('p', 'waiting-error', errors.get(item.id));
+    error.setAttribute('role', 'alert');
+    card.appendChild(error);
+  }
+  return card;
+}
+
+function answeredRow(item) {
+  const li = el('li', 'waiting-answered-item');
+  li.append(el('span', 'waiting-card-n', `Q${item.n}`), el('span', 'waiting-answered-text', item.text));
+  const via = item.answeredVia === 'telegram' ? 'Telegram' : 'app';
+  li.appendChild(el('span', 'waiting-answered-answer', `→ ${item.answer} · ${via} · ${ago(item.answeredAt)}`));
+  return li;
+}
+
+export function renderWaiting() {
+  const list = document.getElementById('waiting-list');
+  if (!list) return;
+  // Settled: the server moved it on, so it is no longer ours to wait for.
+  for (const id of new Set([...pending, ...errors.keys(), ...drafts.keys()])) {
+    if (!waitingItems.some(item => item.id === id && item.status === 'open')) { pending.delete(id); drafts.delete(id); errors.delete(id); }
+  }
+  if (!waitingActive) return;
+  const focused = document.activeElement?.closest?.('.waiting-card')?.dataset.id;
+  list.innerHTML = '';
+  const open = waitingItems.filter(item => item.status === 'open').reverse();
+  if (!open.length) list.appendChild(el('p', 'waiting-empty', 'Nothing waiting on you.'));
+  for (const item of open) list.appendChild(openCard(item));
+
+  const answered = waitingItems.filter(item => item.status === 'answered')
+    .sort((a, b) => String(b.answeredAt).localeCompare(String(a.answeredAt))).slice(0, ANSWERED_SHOWN);
+  if (answered.length) {
+    const section = el('details', 'waiting-answered');
+    section.open = answeredOpen;
+    section.ontoggle = () => { answeredOpen = section.open; };
+    section.appendChild(el('summary', null, `Answered (${answered.length})`));
+    const ul = el('ul');
+    for (const item of answered) ul.appendChild(answeredRow(item));
+    section.appendChild(ul);
+    list.appendChild(section);
+  }
+  // A broadcast re-renders under the owner's fingers; keep their place.
+  if (focused) list.querySelector(`.waiting-card[data-id="${CSS.escape(focused)}"] input`)?.focus();
+}

package/public/style.css

@@ -752,11 +752,6 @@ body {
 /* The one way back for a stopped Billion, so it reads as the row's action. */
 .explorer-billion-start { margin-left: auto; color: var(--accent); }
 /* notify_owner's questions, under Billion's row until dismissed */
-.explorer-waiting { list-style: none; margin: 0 0 4px; padding: 0 10px 0 22px; font-size: 11px; }
-.explorer-waiting-head { color: var(--accent); font-weight: 600; padding: 2px 0; }
-.explorer-waiting-item { display: flex; align-items: flex-start; gap: 4px; color: var(--text-muted); padding: 2px 0; }
-.explorer-waiting-item span { flex: 1; min-width: 0; overflow-wrap: anywhere; display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; }
-.explorer-waiting-item button { flex-shrink: 0; }
 
 .explorer-branch-name {
   overflow: hidden;
@@ -1181,7 +1176,7 @@ body {
 .mobile-nav { display: none; }
 @media (max-width: 700px) {
   .divider, .explorer-reopen-btn, #btn-toggle-explorer { display: none !important; }
-  .explorer-billion-start, .explorer-waiting-item button { min-width: 44px; min-height: 44px; }
+  .explorer-billion-start, .waiting-dismiss { min-width: 44px; min-height: 44px; }
   #explorer-panel, #office-panel, #terminal-panel {
     display: none; width: 100% !important; min-width: 0; max-width: none; flex: 1;
   }
@@ -1207,6 +1202,10 @@ body {
     cursor: pointer;
   }
   .mobile-nav button:hover, .mobile-nav button[aria-current="true"] { color: var(--accent); }
+  .mobile-nav-waiting { display: inline-flex; align-items: center; justify-content: center; gap: 5px; }
+  .mobile-nav-waiting .board-tab-badge { letter-spacing: 0; }
+  .waiting-choice, .waiting-send { min-height: 44px; }
+  .waiting-reply input { min-height: 44px; font-size: 16px; }
   /* Overlays sized for desktop */
   .spawn-form-inner, .dir-browser-inner { width: auto; max-width: 100%; }
   .spawn-form-main, .spawn-presets { flex-wrap: wrap; }
@@ -1302,6 +1301,117 @@ body {
   text-align: center;
 }
 
+/* ============================================================
+   Waiting on you
+   Billion's questions to the owner. A pinned tab next to Jobs,
+   same viewport, same badge; each open question is a card with
+   its choices and a reply line.
+   ============================================================ */
+
+.waiting-board {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  flex-direction: column;
+  background: var(--bg-panel);
+  overflow-y: auto;
+  z-index: 5;
+}
+.waiting-list {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  width: 100%;
+  max-width: 720px;
+  padding: 14px 12px 24px;
+}
+.waiting-empty { color: var(--text-dim); font-size: 12px; padding: 24px 2px; }
+
+.waiting-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px 12px;
+  background: var(--bg-dark);
+  border: 1px solid var(--border);
+  border-left: 2px solid var(--state-message);
+  border-radius: 3px;
+}
+.waiting-card-head { display: flex; align-items: center; gap: 8px; }
+.waiting-card-n { color: var(--accent); font-size: 11px; font-weight: 700; flex-shrink: 0; }
+.waiting-card-time { color: var(--text-dim); font-size: 10px; flex: 1; }
+.waiting-card-text {
+  margin: 0;
+  color: var(--text);
+  font-size: 12px;
+  line-height: 1.5;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}
+
+.waiting-choices { display: flex; flex-wrap: wrap; gap: 6px; }
+.waiting-choice {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 5px 12px;
+  font-size: 12px;
+  font-family: inherit;
+  color: var(--text);
+  background: transparent;
+  border: 1px solid var(--border);
+  border-radius: 3px;
+  cursor: pointer;
+}
+.waiting-choice:hover:not(:disabled) { border-color: var(--accent); color: var(--accent); }
+.waiting-choice.recommended { border-color: var(--accent); }
+.waiting-choice-tag {
+  color: var(--accent);
+  font-size: 9px;
+  letter-spacing: 1px;
+  text-transform: uppercase;
+}
+
+.waiting-reply { display: flex; gap: 6px; }
+.waiting-reply input {
+  flex: 1;
+  min-width: 0;
+  padding: 5px 8px;
+  font-size: 12px;
+  font-family: inherit;
+  color: var(--text);
+  background: var(--bg-panel);
+  border: 1px solid var(--border);
+  border-radius: 3px;
+}
+.waiting-reply input:focus { outline: none; border-color: var(--accent); }
+.waiting-send {
+  padding: 5px 12px;
+  font-size: 11px;
+  font-family: inherit;
+  color: var(--accent-contrast);
+  background: var(--accent);
+  border: none;
+  border-radius: 3px;
+  cursor: pointer;
+}
+.waiting-card :disabled { opacity: 0.55; cursor: default; }
+.waiting-error { margin: 0; color: var(--state-disconnected); font-size: 11px; }
+
+.waiting-answered { color: var(--text-muted); font-size: 11px; margin-top: 6px; }
+.waiting-answered summary {
+  cursor: pointer;
+  color: var(--text-dim);
+  font-size: 9px;
+  letter-spacing: 2px;
+  text-transform: uppercase;
+  padding: 4px 0;
+}
+.waiting-answered ul { list-style: none; margin: 4px 0 0; padding: 0; display: flex; flex-direction: column; gap: 6px; }
+.waiting-answered-item { display: grid; grid-template-columns: auto 1fr; column-gap: 8px; row-gap: 2px; }
+.waiting-answered-text { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.waiting-answered-answer { grid-column: 2; color: var(--text-dim); overflow-wrap: anywhere; }
+
 /* An agent the board created, not you. Subtle — it is still an ordinary agent
    you can type into; the marker only explains where it came from. */
 .terminal-tab.board-spawned .dot {

package/server/http.js

@@ -91,7 +91,7 @@ export function requireAgent(req, res, next) {
 }
 
 // --- Routes ---
-export function setupRoutes(app, staticDir, { broadcast, killSession } = {}) {
+export function setupRoutes(app, staticDir, { broadcast, killSession, respawnAgent } = {}) {
   app.use(express_static(staticDir));
 
   // --- POST /mcp — the board's MCP server ---
@@ -130,14 +130,17 @@ export function setupRoutes(app, staticDir, { broadcast, killSession } = {}) {
         answerPermission: ({ id, decision, reason }) => (req.agentSession.isBillion
           ? answerApproval(id, decision, reason)
           : { error: 'Only Billion answers permission requests.' }),
-        notifyOwner: (text) => (req.agentSession.isBillion
-          ? notifyOwner(text, { broadcast })
+        notifyOwner: (text, { choices, recommended } = {}) => (req.agentSession.isBillion
+          ? notifyOwner(text, { choices, recommended, broadcast })
           : { error: 'Only Billion can notify the owner.' }),
         // Never logged: a screen can hold a secret that scrolled by.
         readAgentScreen: ({ name, lines }) => readAgentScreen({
           from: req.agentSession, name, lines, sessions,
           isBillionCard: (jobId) => allJobs().some(job => job.id === jobId && job.postedByBillion),
         }),
+        respawnAgent: ({ name }) => (respawnAgent
+          ? respawnAgent(req.agentSession, name)
+          : { error: 'Re-spawning is not available.' }),
         billionReady: () => {
           const session = req.agentSession;
           if (!session.isBillion) return { error: 'Only Billion has an inbox to open.' };