@bill10/agent-007 0.10.0 → 0.12.0

package/README.md

@@ -13,7 +13,7 @@ Use it as far along as you need:
 
 1. **One task: one agent in a web terminal.** Start Claude Code, Codex or any CLI agent in the browser. Add a repo once; every agent gets its own git worktree and branch, so you never set one up by hand.
 2. **Many tasks across projects: many terminals, one window.** Every repo and every agent in one place, with live terminals, a file explorer, inline diffs, and a pixel office where each agent faces its screen while it works and turns to you when it needs you.
-3. **Stop watching them: a job board.** Put tasks on the board and Claude Code or Codex workers pick them up, each in its own worktree, and move them To do -> In progress -> Review on their own, landing as a pull request (or a summary, for work that isn't code). Cards can run on a cron schedule, and agents can post cards and message each other.
+3. **Stop watching them: a job board.** Put tasks on the board and Claude Code or Codex workers pick them up, each in its own worktree, and move them To do -> In progress -> Review on their own, landing as a pull request (or a summary, for work that isn't code). Cards can run on a cron schedule and pick their model (strong for hard code, fast for docs), from the models the board finds installed, and agents can post cards and message each other.
 4. **Stop posting jobs: give Billion a goal.** Billion is one always-on agent that plans, posts the jobs, reviews what comes back and merges the PRs. It only asks you about money, access or anything irreversible.
 
 Claude Code, Codex, any terminal agent is supported -- use your existing subscriptions, no extra charge.
@@ -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 |
@@ -88,9 +88,10 @@ The job board reuses that same machinery: a dispatched job is an ordinary agent,
 ```
 ┌─────────────┬──────────────┬────────────────────┐
 │  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)│
 └─────────────┴──────────────┴────────────────────┘
 ```
 
@@ -221,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.10.0.0
+0.12.0.0

package/lib/jobs.js

@@ -395,17 +395,48 @@ export function isCodexSessionId(value) {
 // known — it is the board's current word. With neither, the CLI's own
 // default applies. Both go through their allowlists here, so this is the one
 // place that guarantees nothing but a permission reaches the argv.
-export function resumeCommand(agent, mode, flags, sessionId) {
+//
+// `model` is the card's model, so a worker picked for a strong model does not
+// come back on the CLI's default.
+export function resumeCommand(agent, mode, flags, sessionId, model = null) {
   const validMode = isValidPermissionMode(mode) ? mode : null;
   const own = validMode ? '' : normalizePermissionFlags(agent === 'codex' ? 'codex' : 'claude', flags).join(' ');
+  const m = modelFlag(agent === 'codex' ? 'codex' : 'claude', model);
   if (agent === 'codex') {
     const flag = validMode ? CODEX_MODE_FLAGS[validMode] : own;
     // The id reaches the argv, so only a real session id passes.
     const target = isCodexSessionId(sessionId) ? ` ${sessionId}` : '';
-    return `codex resume${target}${flag ? ` ${flag}` : ''}`;
+    return `codex resume${target}${flag ? ` ${flag}` : ''}${m ? ` ${m}` : ''}`;
   }
   const flag = validMode ? `--permission-mode ${validMode}` : own;
-  return `claude --continue${flag ? ` ${flag}` : ''}`;
+  return `claude --continue${flag ? ` ${flag}` : ''}${m ? ` ${m}` : ''}`;
+}
+
+// A card's model: a name its CLI's --model / -m takes. It reaches the argv, so
+// besides being one the server discovered (server/models.js) it must be a
+// single plain token — no space, quote or leading dash.
+export function isSafeModelName(model) {
+  return typeof model === 'string' && /^[A-Za-z0-9][A-Za-z0-9._:\[\]-]{0,99}$/.test(model);
+}
+
+// Empty is null: the CLI's own default. `available` is the discovered list per
+// CLI; left out (a schedule's run, copying a model its schedule already
+// passed), only the shape is checked.
+export function resolveJobModel(model, agent, available) {
+  if (model === undefined || model === null || model === '') return { model: null };
+  const list = available ? (available[agent] || []) : null;
+  if (!isSafeModelName(model) || (list && !list.includes(model))) {
+    const shown = typeof model === 'string' ? `"${model.slice(0, 40)}"` : `a ${typeof model}`;
+    return { error: `Unknown model ${shown} for ${agent} \u2014 expected one of: ${list?.length ? list.join(', ') : '(none discovered; leave it empty for the CLI default)'}` };
+  }
+  return { model };
+}
+
+// The model flag for that CLI, or nothing for the default. Quoted though the
+// name is already a plain token, the same as every other value put on the argv.
+export function modelFlag(agent, model) {
+  if (!isSafeModelName(model)) return '';
+  return `${agent === 'codex' ? '-m' : '--model'} ${quote(model)}`;
 }
 
 export function resolveJobAgent(agent) {
@@ -468,7 +499,7 @@ export function newJobId() {
 export const MAX_TITLE_LEN = 200;
 export const MAX_DETAIL_LEN = 20000;
 
-export function createJob({ title, detail, repoPath, type, schedule, permissionMode, agent, requiresPr, postedBy, postedByName, postedByAgent, postedByBillion }) {
+export function createJob({ title, detail, repoPath, type, schedule, permissionMode, agent, model, availableModels, requiresPr, postedBy, postedByName, postedByAgent, postedByBillion }) {
   const cleanTitle = String(title || '').trim().slice(0, MAX_TITLE_LEN);
   if (!cleanTitle) return { error: 'Title is required' };
   if (!repoPath) return { error: 'Repository is required' };
@@ -481,6 +512,8 @@ export function createJob({ title, detail, repoPath, type, schedule, permissionM
   if (mode.error) return { error: mode.error };
   const cli = resolveJobAgent(agent);
   if (cli.error) return { error: cli.error };
+  const chosen = resolveJobModel(model, cli.agent, availableModels);
+  if (chosen.error) return { error: chosen.error };
   return {
     job: {
       id: newJobId(),
@@ -504,7 +537,8 @@ export function createJob({ title, detail, repoPath, type, schedule, permissionM
       // Which CLI is spawned for it. Cards written before this existed have no
       // field, which jobAgent reads as claude.
       agent: cli.agent,
-      // See jobRequiresPr. Only false when the poster said so.
+      // The model its CLI runs, or null for the CLI's default. See resolveJobModel.
+      model: chosen.model,
       // See jobRequiresPr. Unset takes the type's default.
       requiresPr: typeof requiresPr === 'boolean' ? requiresPr : defaultRequiresPr(resolved.type),
       detail: String(detail || '').trim().slice(0, MAX_DETAIL_LEN),
@@ -742,10 +776,11 @@ export function buildJobCommand(job, { permissionMode = DEFAULT_PERMISSION_MODE
   if (jobAgent(job) === 'codex') {
     // No --add-dir: every Codex sandbox, read-only included, reads anywhere
     // on disk and gates only writes, and attachments are only ever read.
-    const flags = permissionModeFlags('codex', mode).join(' ');
+    const flags = [...permissionModeFlags('codex', mode), modelFlag('codex', job.model)].filter(Boolean).join(' ');
     return `codex ${flags ? `${flags} ` : ''}${quote(buildJobPrompt(job))}`;
   }
-  return `claude ${permissionModeFlags('claude', mode).join(' ')} ${quote(buildJobPrompt(job))}${dirs.map(d => ` --add-dir ${quote(d)}`).join('')}`;
+  const m = modelFlag('claude', job.model);
+  return `claude ${permissionModeFlags('claude', mode).join(' ')}${m ? ` ${m}` : ''} ${quote(buildJobPrompt(job))}${dirs.map(d => ` --add-dir ${quote(d)}`).join('')}`;
 }
 
 // --- Live status (derived, never stored) ---
@@ -849,6 +884,7 @@ export function createRunJob(schedule) {
     type: 'one-time',
     permissionMode: schedule.permissionMode,
     agent: schedule.agent,
+    model: schedule.model,
     requiresPr: jobRequiresPr(schedule),
     postedBy: schedule.postedBy,
     postedByName: schedule.postedByName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bill10/agent-007",
-  "version": "0.10.0",
+  "version": "0.12.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

@@ -167,6 +167,11 @@
                   <option value="codex">Codex</option>
                 </select>
               </label>
+              <label title="Which model this job's agent runs. The list is what the board found for the chosen CLI on this computer; CLI default leaves the choice to the CLI.">Model
+                <select id="job-model">
+                  <option value="">CLI default</option>
+                </select>
+              </label>
               <label title="How much this job's agent may do without asking. Leave it on the board default unless this one job needs something different. A Codex card offers auto (Codex's own default) and bypassPermissions (--dangerously-bypass-approvals-and-sandbox); a board set to another mode maps onto Codex's nearest flag: plan is read-only, manual asks before every command, dontAsk never asks.">Permissions
                 <select id="job-permission-mode-field">
                   <option value="">Board default</option>
@@ -214,6 +219,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 +239,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';
@@ -282,6 +284,13 @@ function renderCard(job) {
     chip.title = 'Finishes with a summary from its agent instead of a pull request';
     title.appendChild(chip);
   }
+  if (job.model) {
+    const chip = document.createElement('span');
+    chip.className = 'job-card-type';
+    chip.textContent = job.model;
+    chip.title = `Runs on the ${job.model} model instead of the CLI's default`;
+    title.appendChild(chip);
+  }
   if (job.permissionMode) {
     // Only when the card overrides the board. The mode decides how much its
     // agent may do unasked, so a card carrying its own must say so on its face
@@ -728,6 +737,32 @@ function syncAgentField() {
     opt.textContent = codex ? opt.dataset.codexLabel : opt.dataset.claudeLabel;
   }
   markDangerousMode(permEl);
+  syncModelField();
+}
+
+// The discovered models for the chosen CLI (server/models.js), plus the one
+// the card already holds if discovery no longer lists it, so opening the form
+// never silently changes it.
+let models = { claude: [], codex: [] };
+let formModel = '';
+let formAgent = 'claude';
+function syncModelField() {
+  const el = document.getElementById('job-model');
+  if (!el) return;
+  const agent = document.getElementById('job-agent')?.value === 'codex' ? 'codex' : 'claude';
+  const list = [...(models[agent] || [])];
+  if (formModel && agent === formAgent && !list.includes(formModel)) list.push(formModel);
+  // The card's own value on open; after that, whatever is picked.
+  const keep = el.dataset.filled ? el.value : formModel;
+  el.dataset.filled = '1';
+  el.innerHTML = '<option value="">CLI default</option>';
+  for (const m of list) {
+    const opt = document.createElement('option');
+    opt.value = m;
+    opt.textContent = m;
+    el.appendChild(opt);
+  }
+  el.value = list.includes(keep) ? keep : '';
 }
 
 // A shape check only — five whitespace-separated fields, or a known @shorthand.
@@ -799,6 +834,12 @@ function openForm(jobId) {
   // which would silently freeze the card onto today's setting.
   if (permEl) permEl.value = job && job.permissionMode ? job.permissionMode : '';
   if (agentEl) agentEl.value = job && job.agent === 'codex' ? 'codex' : 'claude';
+  formModel = job && job.model ? job.model : '';
+  formAgent = agentEl ? agentEl.value : 'claude';
+  const modelEl = document.getElementById('job-model');
+  if (modelEl) delete modelEl.dataset.filled;
+  // The server looks again if its list is over 10 minutes old.
+  send({ type: 'models-refresh' });
   prPicked = false;
   prEl.value = job ? (job.requiresPr === false || (isScheduled(job) && job.requiresPr !== true) ? 'no' : 'yes') : 'yes';
   syncAgentField();   // also marks the danger colour on the permission select
@@ -847,7 +888,11 @@ function saveForm() {
   // The form always holds the complete list; an empty one on an edit means
   // "none left".
   const attachments = pendingAttachments.map(a => ({ name: a.name, data: a.data }));
+  const model = document.getElementById('job-model')?.value || '';
   const fields = { title, detail, repoPath, jobType, schedule, permissionMode, agent, requiresPr, attachments };
+  // An edit that leaves the model alone does not send it, so a card whose
+  // model discovery no longer lists can still be retitled.
+  if (!editingJobId || model !== formModel) fields.model = model;
   if (editingJobId) send({ type: 'job-update', jobId: editingJobId, ...fields });
   else send({ type: 'job-create', ...fields });
   closeForm();
@@ -871,6 +916,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.
@@ -896,6 +942,7 @@ export function handleJobsList(msg) {
   jobs.clear();
   for (const job of msg.jobs || []) jobs.set(job.id, job);
   if (msg.settings) setBoardSettings(msg.settings);
+  if (msg.models) { models = msg.models; syncModelField(); }
   renderToolbar();
   renderBoard();
   if (window._onBoardVisibilityChanged) window._onBoardVisibilityChanged();

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();
+}