ai-agentmanager 1.0.1 → 1.1.0

package/public/icons/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><rect width="512" height="512" rx="112" fill="#151821"/><path d="M256 76l180 180-180 180L76 256z" fill="#6d8bff"/><path d="M256 166l90 90-90 90-90-90z" fill="#151821"/></svg>

package/public/index.html

@@ -6,6 +6,9 @@
     <meta name="apple-mobile-web-app-capable" content="yes" />
     <title>AI Agent Manager</title>
     <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 16 16%22%3E%3Cpath d=%22M8 1l7 7-7 7-7-7z%22 fill=%22%233b5bdb%22/%3E%3C/svg%3E" />
+    <link rel="manifest" href="/manifest.webmanifest" crossorigin="use-credentials" />
+    <meta name="theme-color" content="#151821" />
+    <link rel="apple-touch-icon" href="/icons/icon-192.png" />
     <link rel="stylesheet" href="/vendor/xterm/css/xterm.css" />
     <link rel="stylesheet" href="/style.css" />
   </head>
@@ -19,6 +22,7 @@
       </div>
       <div class="top-actions">
         <input id="filter" type="search" placeholder="Filter agents" aria-label="Filter agents" />
+        <button id="cleanup-btn" title="Close agents idle for a while, and delete old closed ones">Clean up</button>
         <button id="alerts-btn" class="local-only" title="Slack alerts when an agent needs you">Alerts</button>
         <button id="remote-btn" class="local-only" title="Open AI Agent Manager from your phone">Remote access</button>
         <button id="ask-btn" title="A general Claude session with no repo or folder">Ask Claude</button>
@@ -35,6 +39,13 @@
         </div>
         <div id="agents-view">
           <div class="counts" id="counts"></div>
+          <div class="recent-bar" id="recent-bar" hidden>
+            <label class="recent-switch" title="Hide agents created before then (they're still there; turn this off to see them)">
+              <input type="checkbox" id="recent-on"> Created in the last
+            </label>
+            <input type="number" id="recent-days" min="1" max="3650" value="7" aria-label="Days"> days
+            <span class="spacer"></span><span id="recent-hidden"></span>
+          </div>
           <ul id="agent-list" class="agent-list" aria-label="Agents"></ul>
         </div>
         <div id="backlog-view" hidden></div>
@@ -44,10 +55,12 @@
           <p>Add one or more intents and a repo or folder to get started.</p>
         </div>
       </aside>
+      <div class="splitter split-side" id="split-side" role="separator" aria-orientation="vertical" title="Drag to resize the list; double-click to reset"></div>
 
       <section class="detail" id="detail">
         <div class="placeholder" id="placeholder">Select an agent to see its session, folder, repo, PRs and bugs.</div>
         <div id="detail-body" hidden></div>
+        <div class="splitter split-term" id="split-term" role="separator" aria-orientation="horizontal" title="Drag to resize the terminal; double-click to reset"></div>
         <div class="term-wrap" id="term-wrap" hidden>
           <div class="term-bar">
             <div class="term-tabs" role="tablist">
@@ -62,6 +75,8 @@
             <button id="term-attach" class="ghost small" title="Attach files or images (you can also drop or paste them into the terminal)">📎 Attach</button>
             <input type="file" id="term-file" multiple hidden>
             <button id="term-fit" class="ghost small" title="Refit the terminal to the panel">Fit</button>
+            <button id="term-max" class="ghost small desk-only" title="Expand to fill the window (Ctrl+Shift+E)">⤢ Expand</button>
+            <button id="term-full" class="ghost small desk-only" title="Full screen (Esc to leave)">⛶ Full screen</button>
             <button id="term-close" class="ghost small" title="Hide the terminal (the agent keeps running)">Hide terminal</button>
           </div>
           <div id="signin-bar" class="signin-bar" hidden></div>
@@ -185,6 +200,7 @@
           <label class="check"><input type="radio" name="when" value="now" checked /> Start now</label>
           <label class="check"><input type="radio" name="when" value="backlog" /> Queue in backlog</label>
           <label class="check" title="Several agents try the same intent; compare and keep the best"><input type="radio" name="when" value="race" /> Race variants</label>
+          <label class="check" title="Agents in roles solve one problem: analyze, critique, implement, test, review"><input type="radio" name="when" value="team" /> Team</label>
           <label class="check">Priority
             <select name="priority" aria-label="Priority">
               <option value="0">P0 urgent</option>
@@ -204,6 +220,48 @@
             <input name="testCommand" placeholder="npm test" />
           </label>
         </div>
+        <div class="team-only" hidden>
+          <p class="hint">An analyst writes the analysis and critics challenge it until they agree; then an implementer builds it, a tester tests it and a reviewer approves it or sends it back. The reviewer also lists what the request asks for that isn't built yet; the team then asks you whether to run a gap round for it. The team stops for you when the reviewer approves, or if they can't agree. No repository yet? Leave the repository and folder empty (or give a new folder) and the team starts a new project. Tip: pick <b>Accept edits</b> or <b>Auto</b> as the permission mode, or the agents stop to ask before each edit or command.</p>
+          <label>
+            How the team runs
+            <select name="teamMode">
+              <option value="lead" selected>One lead session; the roles are its sub-agents</option>
+              <option value="agents">Separate agents, one per role (any engine)</option>
+            </select>
+          </label>
+          <div class="row">
+            <label>
+              Critics
+              <select name="critics">
+                <option value="0">None</option>
+                <option value="1" selected>1</option>
+                <option value="2">2</option>
+              </select>
+            </label>
+            <label>
+              Test command <span class="hint">optional; a hint for the tester</span>
+              <input name="teamTest" placeholder="npm test" />
+            </label>
+          </div>
+          <div class="row three">
+            <label>
+              Analysis rounds <span class="hint">before it stops for you</span>
+              <input name="maxRounds" type="number" min="1" max="10" placeholder="3" />
+            </label>
+            <label>
+              Build rounds <span class="hint">fix rounds per request</span>
+              <input name="maxLoops" type="number" min="1" max="10" placeholder="3" />
+            </label>
+            <label>
+              Gap rounds without asking <span class="hint">0: it asks you first</span>
+              <input name="gapRounds" type="number" min="0" max="10" placeholder="0" />
+            </label>
+          </div>
+          <label>
+            Models by role <span class="hint">optional, e.g. <code>analyst=opus reviewer=opus</code>; others use the model above</span>
+            <input name="roleModels" placeholder="analyst=opus reviewer=opus" />
+          </label>
+        </div>
         <label class="check now-only">
           <input type="checkbox" name="start" checked />
           Launch immediately
@@ -285,6 +343,17 @@
       </div>
     </dialog>
 
+    <dialog id="team-dialog" class="doc-dialog">
+      <div class="doc-head">
+        <h2 id="team-title">Team</h2>
+        <span class="spacer"></span>
+        <button type="button" id="team-stop" class="small ghost" title="Close the team's agents; nothing is deleted">Stop team</button>
+        <button type="button" id="team-delete" class="small ghost" title="Forget this team">Forget team</button>
+        <button type="button" id="team-close" class="small ghost">Close</button>
+      </div>
+      <div id="team-body" class="race-body team-body"></div>
+    </dialog>
+
     <dialog id="race-dialog" class="doc-dialog">
       <div class="doc-head">
         <h2 id="race-title">Race</h2>
@@ -330,6 +399,34 @@
       </form>
     </dialog>
 
+    <dialog id="cleanup-dialog">
+      <form id="cleanup-form" method="dialog" class="alerts-body">
+        <h2>Clean up old agents</h2>
+        <p class="hint">Closing an agent ends its session; resume it any time. Deleting removes it from your list, with the worktree AI Agent Manager created (Claude's own transcripts stay). Never touched: agents marked <b>Keep</b>, agents working or setting up, and members of a team that is still going. Not deleted: agents with an open pull request, or with uncommitted changes or commits that aren't on any other branch.</p>
+        <label>Strategy
+          <select name="strategy">
+            <option value="close-delete">Close, then delete, automatically</option>
+            <option value="close">Close automatically; delete when I say</option>
+            <option value="manual">Nothing automatic; only when I run it</option>
+            <option value="off">Off</option>
+          </select>
+        </label>
+        <div class="row">
+          <label>Close after <span class="hint">days with no activity</span><input name="closeAfterDays" type="number" min="1" /></label>
+          <label>Delete after <span class="hint">days closed</span><input name="deleteAfterDays" type="number" min="1" /></label>
+        </div>
+        <div id="cleanup-plan" class="cleanup-plan"></div>
+        <p id="cleanup-error" class="error" hidden></p>
+        <div class="dialog-actions">
+          <button type="button" id="cleanup-run-close" title="Close the sessions that are due now">Close due now</button>
+          <button type="button" id="cleanup-run" class="danger" title="Close and delete what is due now">Close and delete due now</button>
+          <span class="spacer"></span>
+          <button type="button" id="cleanup-close" class="ghost">Close</button>
+          <button class="primary">Save</button>
+        </div>
+      </form>
+    </dialog>
+
     <dialog id="remote-dialog">
       <div class="remote-body">
         <h2>Remote access</h2>

package/public/manifest.webmanifest

@@ -0,0 +1,16 @@
+{
+  "name": "AI Agent Manager",
+  "short_name": "Agent Manager",
+  "description": "Run many coding agents in parallel without babysitting terminals.",
+  "id": "/",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#0d0f14",
+  "theme_color": "#151821",
+  "icons": [
+    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" },
+    { "src": "/icons/icon.svg", "sizes": "any", "type": "image/svg+xml" }
+  ]
+}

package/public/style.css

@@ -88,7 +88,27 @@ input, select, textarea {
 textarea { resize: vertical; font-family: var(--mono); font-size: 13px; }
 
 /* ---------- layout */
-.layout { flex: 1; display: grid; grid-template-columns: 340px 1fr; min-height: 0; }
+.layout { flex: 1; display: grid; grid-template-columns: var(--side-w, 340px) 0 1fr; min-height: 0; }
+
+/* Drag handles: the list's width, and the brief above the terminal. */
+.splitter { position: relative; z-index: 3; }
+.splitter::after { content: ''; position: absolute; }
+.split-side::after { top: 0; bottom: 0; left: -4px; width: 8px; cursor: col-resize; }
+.split-term { display: none; flex: none; height: 0; }
+.detail.with-term > #detail-body:not([hidden]) + .split-term { display: block; }
+.split-term::after { left: 0; right: 0; top: -4px; height: 8px; cursor: row-resize; }
+.splitter:hover::after, .splitter.dragging::after { background: var(--accent); opacity: .5; }
+body.resizing { user-select: none; }
+body.resizing iframe, body.resizing .terminal { pointer-events: none; }
+body.resizing.cols { cursor: col-resize; }
+body.resizing.rows { cursor: row-resize; }
+
+/* Expanded: the terminal, shell or browser fills the window. */
+body.term-max .topbar, body.term-max .sidebar, body.term-max .split-side,
+body.term-max #detail-body, body.term-max .split-term, body.term-max #placeholder { display: none !important; }
+body.term-max .layout { grid-template-columns: 1fr; }
+.term-wrap:fullscreen { width: 100vw; height: 100vh; }
+.term-bar button.on { background: #262c38; border-color: #58a6ff; }
 .sidebar { border-right: 1px solid var(--border); overflow-y: auto; background: var(--panel); }
 .side-tabs { display: flex; border-bottom: 1px solid var(--border); position: sticky; top: 0; background: var(--panel); z-index: 2; }
 .side-tab { flex: 1; border: 0; border-radius: 0; background: transparent; padding: 9px; font-weight: 600; color: var(--muted); border-bottom: 2px solid transparent; }
@@ -122,6 +142,11 @@ textarea { resize: vertical; font-family: var(--mono); font-size: 13px; }
 .row.when { align-items: center; }
 .row.when select { width: auto; margin-left: 6px; padding: 2px 6px; }
 .counts { display: flex; gap: 12px; padding: 10px 14px; font-size: 12px; color: var(--muted); border-bottom: 1px solid var(--border); }
+.recent-bar { display: flex; align-items: center; gap: 6px; padding: 6px 14px; font-size: 12px; color: var(--muted); border-bottom: 1px solid var(--border); flex-wrap: wrap; }
+.recent-bar .spacer { flex: 1; }
+.recent-switch { display: inline-flex; align-items: center; gap: 6px; cursor: pointer; white-space: nowrap; margin: 0; font-weight: normal; }
+.recent-switch input { width: auto; margin: 0; }
+.recent-bar input[type="number"] { width: 56px; flex: none; padding: 2px 6px; font-size: 12px; }
 .agent-list { list-style: none; margin: 0; padding: 0; }
 .agent-list li.project { border-bottom: 1px solid var(--border); }
 .project-head {
@@ -134,6 +159,8 @@ textarea { resize: vertical; font-family: var(--mono); font-size: 13px; }
 .project-head .caret { width: 12px; color: var(--muted); flex: none; }
 .project-head .pname { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .project-head .pcounts { display: flex; gap: 6px; align-items: center; color: var(--muted); font-weight: 500; font-size: 12px; }
+.project-head .prun { color: var(--green); }
+.project-head .pcount { white-space: nowrap; }
 .project-head .pill { padding: 0 6px; }
 .project-agents { list-style: none; margin: 0; padding: 0; }
 .agent-list li.agent {
@@ -172,7 +199,8 @@ textarea { resize: vertical; font-family: var(--mono); font-size: 13px; }
 .detail { display: flex; flex-direction: column; min-height: 0; min-width: 0; }
 .placeholder { margin: auto; color: var(--muted); padding: 24px; text-align: center; }
 #detail-body { padding: 16px 20px; overflow-y: auto; flex: 0 1 auto; max-height: 100%; }
-.detail.with-term #detail-body { max-height: 42%; border-bottom: 1px solid var(--border); }
+.detail.with-term #detail-body { max-height: var(--brief-h, 42%); border-bottom: 1px solid var(--border); }
+.detail.with-term.brief-sized #detail-body { height: var(--brief-h); flex: none; }
 .d-head { display: flex; align-items: flex-start; gap: 12px; flex-wrap: wrap; }
 .d-title { flex: 1 1 420px; min-width: 0; }
 .d-title h2 { margin: 0 0 4px; font-size: 18px; display: flex; gap: 6px 10px; align-items: center; flex-wrap: wrap; }
@@ -356,6 +384,10 @@ body.remote .local-only { display: none; }
 .alerts-body .check { display: flex; gap: 8px; align-items: center; font-size: 13px; }
 .alerts-body .check input[type=checkbox] { width: auto; }
 .alerts-body .num { width: 64px; padding: 2px 6px; }
+.cleanup-plan { font-size: 13px; max-height: 260px; overflow: auto; }
+.cleanup-plan h4 { margin: 8px 0 4px; font-size: 13px; }
+.cleanup-plan ul { margin: 0; padding-left: 18px; }
+.cleanup-plan li .hint { margin-left: 6px; }
 #login-form { padding: 20px; display: grid; gap: 12px; }
 #login-form h2 { margin: 0; font-size: 17px; }
 
@@ -373,6 +405,8 @@ dialog::backdrop { background: rgba(0, 0, 0, .45); }
 #new-form label.check input { width: auto; }
 .hint { color: var(--muted); font-weight: 400; font-size: 12px; }
 .row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+.row.three { grid-template-columns: 1fr 1fr 1fr; }
+.team-gaps { max-height: 220px; overflow: auto; margin: 6px 0; font-size: 13px; }
 .dialog-actions { display: flex; justify-content: flex-end; gap: 8px; }
 .error { color: var(--red); margin: 0; font-size: 13px; }
 
@@ -399,9 +433,10 @@ dialog::backdrop { background: rgba(0, 0, 0, .45); }
   .term-bar { flex-wrap: wrap; row-gap: 6px; }
   .term-bar > .term-tabs { flex: 1 0 100%; }
   .layout { grid-template-columns: 1fr; grid-template-rows: auto 1fr; }
+  .splitter, .desk-only { display: none !important; }
   .sidebar { max-height: 38vh; border-right: 0; border-bottom: 1px solid var(--border); }
   .top-actions input { width: 130px; }
-  .row { grid-template-columns: 1fr; }
+  .row, .row.three { grid-template-columns: 1fr; }
   .brief-grid { grid-template-columns: 1fr; }
 }
 
@@ -548,3 +583,34 @@ pre.diff .meta { color: var(--muted); font-weight: 600; }
 #import-dialog .import-foot label { display: flex; flex-direction: row; align-items: center; gap: 6px; }
 #import-dialog .import-foot input { width: auto; }
 .judge-line { margin: 14px 12px; line-height: 1.5; }
+
+.agent-list li.agent.idle { opacity: .62; }
+.agent-list li.agent.idle:hover, .agent-list li.agent.idle.selected { opacity: 1; }
+
+/* Agent teams */
+.bl-banner.team { border-color: color-mix(in srgb, var(--accent) 50%, var(--border)); }
+.team-steps { display: flex; flex-wrap: wrap; gap: 4px; align-items: center; font-size: 12px; }
+.team-step { padding: 3px 9px; border-radius: 999px; border: 1px solid var(--border); color: var(--muted); }
+.team-step.done { color: var(--green); border-color: color-mix(in srgb, var(--green) 45%, var(--border)); }
+.team-step.now { color: #fff; background: var(--accent); border-color: var(--accent); }
+.team-step.stop { color: #fff; background: var(--yellow, #c08a1e); border-color: transparent; }
+.team-arrow { color: var(--muted); }
+.team-gate { border: 1px solid var(--accent); border-radius: 6px; padding: 10px 12px; display: flex; flex-direction: column; gap: 8px; }
+.team-gate.blocked { border-color: var(--yellow, #c08a1e); }
+.team-gate textarea { width: 100%; }
+.team-timeline { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 6px; font-size: 13px; }
+.team-body > * { flex-shrink: 0; }
+.team-timeline li { display: grid; grid-template-columns: 160px 80px 1fr; gap: 8px; align-items: baseline; }
+.team-timeline .summary { color: var(--muted); }
+.verdict-word { font-weight: 600; }
+.verdict-word.good { color: var(--green); }
+.verdict-word.bad { color: var(--red); }
+.team-file { border: 1px solid var(--border); border-radius: 6px; padding: 8px 12px; max-height: 50vh; overflow: auto; }
+.need-kind.team { background: var(--accent); color: #fff; }
+.flag.role { font-size: 11px; padding: 0 5px; border: 1px solid var(--border); border-radius: 4px; color: var(--muted); }
+@media (max-width: 800px) { .team-timeline li { grid-template-columns: 1fr; gap: 2px; } }
+.team-ask { border: 1px solid var(--border); border-radius: 6px; padding: 10px 12px; display: flex; flex-direction: column; gap: 6px; }
+.team-ask textarea { width: 100%; }
+.team-quest { border: 1px solid var(--border); border-radius: 6px; padding: 6px 10px; }
+.team-quest summary { cursor: pointer; }
+.team-quest .team-timeline { margin-top: 8px; }

package/src/cleanup.js

@@ -0,0 +1,185 @@
+// Clean up old agents: close sessions nobody has used for a while (they can be resumed), and
+// delete agents that stayed closed long after that, with the worktrees agentmgr created.
+// Strategies: "close-delete" (both, automatically), "close" (close automatically, delete by
+// hand), "manual" (nothing automatic; run it from the Clean up dialog or `agentmgr cleanup`),
+// and "off". Never touched: agents marked Keep, agents still setting up or working, members of a
+// team that is still going, and, for deleting, agents with an open pull request or with work
+// that exists only in their worktree (uncommitted changes or commits on no other branch).
+import fs from 'node:fs';
+import * as git from './git.js';
+
+export const STRATEGIES = ['close-delete', 'close', 'manual', 'off'];
+export const CLEANUP_DEFAULTS = { strategy: 'close', closeAfterDays: 14, deleteAfterDays: 14 };
+const DAY = 86_400_000;
+const TEAM_DONE = new Set(['done', 'stopped']);
+
+const err = (status, message) => Object.assign(new Error(message), { status });
+const days = (ms) => Math.floor(ms / DAY);
+
+/** Settings from config.json's "cleanup", with defaults and sane bounds. */
+export function cleanupSettings(config = {}) {
+  const c = { ...CLEANUP_DEFAULTS, ...config.cleanup };
+  const n = (v, d) => (Number.isFinite(Number(v)) && Number(v) >= 1 ? Math.min(3650, Math.floor(Number(v))) : d);
+  return {
+    strategy: STRATEGIES.includes(c.strategy) ? c.strategy : CLEANUP_DEFAULTS.strategy,
+    closeAfterDays: n(c.closeAfterDays, CLEANUP_DEFAULTS.closeAfterDays),
+    deleteAfterDays: n(c.deleteAfterDays, CLEANUP_DEFAULTS.deleteAfterDays),
+  };
+}
+
+/** Work that would be lost with the worktree: uncommitted changes, or commits on no other branch or remote. */
+export async function unsavedWork(agent) {
+  const dir = agent.workdir;
+  if (!dir || agent.sharedWith || !fs.existsSync(dir)) return null;
+  try {
+    const dirty = await git.run('git', ['status', '--porcelain'], { cwd: dir });
+    if (dirty.trim()) return 'uncommitted changes';
+    const branch = agent.branch ?? (await git.run('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: dir })).trim();
+    const only = await git.run('git', ['rev-list', '--count', 'HEAD', '--not', '--remotes', `--exclude=${branch}`, '--branches'], { cwd: dir });
+    const n = Number(only.trim());
+    return n > 0 ? `${n} commit${n > 1 ? 's' : ''} not pushed or merged` : null;
+  } catch (e) {
+    return `couldn't check its worktree (${e.message.split('\n')[0]})`;
+  }
+}
+
+export class Cleanup {
+  constructor({ manager, store, config = {}, teams = null, log = (m) => console.log(`[agentmgr] ${m}`) }) {
+    this.manager = manager;
+    this.store = store;
+    this.config = config;
+    this.teams = teams;
+    this.log = log;
+    store.data.cleanup ??= {};
+    // A first look a couple of minutes after start, then every few hours.
+    this.firstTimer = setTimeout(() => this.sweep().catch((e) => this.log(`clean up: ${e.message}`)), config.cleanupFirstSec ? config.cleanupFirstSec * 1000 : 120_000);
+    this.firstTimer.unref?.();
+    this.timer = setInterval(() => this.sweep().catch((e) => this.log(`clean up: ${e.message}`)), (config.cleanupEveryMin ?? 360) * 60_000);
+    this.timer.unref?.();
+  }
+
+  close() {
+    clearTimeout(this.firstTimer);
+    clearInterval(this.timer);
+  }
+
+  get settings() {
+    return cleanupSettings(this.config);
+  }
+
+  /** Change the strategy or the days; kept in config.json by the caller. */
+  update(patch = {}) {
+    if (patch.strategy !== undefined && !STRATEGIES.includes(patch.strategy)) throw err(400, `strategy must be one of ${STRATEGIES.join(', ')}`);
+    for (const k of ['closeAfterDays', 'deleteAfterDays']) {
+      if (patch[k] !== undefined && !(Number(patch[k]) >= 1)) throw err(400, `${k} must be 1 or more`);
+    }
+    const next = cleanupSettings({ cleanup: { ...this.config.cleanup, ...patch } });
+    this.config.cleanup = next;
+    return next;
+  }
+
+  /** Why an agent is left alone whatever its age, or null. */
+  protectedBy(agent) {
+    if (agent.keep) return 'marked Keep';
+    if (agent.status === 'preparing') return 'still setting up';
+    const rt = this.manager.runtimes.get(agent.id);
+    if (rt?.pty && rt.busy) return 'working';
+    const team = agent.team && this.store.data.teams?.[agent.team.id];
+    if (team && !TEAM_DONE.has(team.stage)) return 'its team is still going';
+    return null;
+  }
+
+  /**
+   * What a run would do now: agents to close (idle closeAfterDays), agents to delete (closed
+   * deleteAfterDays), and agents left alone with the reason. Deleting checks the worktree.
+   */
+  async plan({ checkWork = true } = {}) {
+    const s = this.settings;
+    const now = Date.now();
+    const close = [];
+    const del = [];
+    const kept = [];
+    for (const agent of this.store.list()) {
+      const rt = this.manager.runtimes.get(agent.id);
+      const running = Boolean(rt?.pty);
+      const activeAt = Date.parse(this.manager.activeAt(agent, rt) ?? agent.createdAt) || now;
+      const idle = now - activeAt;
+      const row = { id: agent.id, name: agent.name, idleDays: days(idle) };
+      if (running) {
+        if (idle < s.closeAfterDays * DAY) continue;
+        const why = this.protectedBy(agent);
+        if (why) kept.push({ ...row, action: 'close', reason: why });
+        else close.push(row);
+        continue;
+      }
+      // Closed since: when it was closed, or its last activity if that is later (or unknown).
+      const closedAt = Math.max(Date.parse(agent.closedAt ?? '') || 0, activeAt);
+      const closedFor = now - closedAt;
+      if (!agent.closedAt || closedFor < s.deleteAfterDays * DAY) continue;
+      const r = { ...row, closedDays: days(closedFor) };
+      const why =
+        this.protectedBy(agent) ??
+        (Object.values(agent.prs ?? {}).some((p) => p.state === 'OPEN') ? 'has an open pull request' : null) ??
+        (checkWork ? await unsavedWork(agent) : null);
+      if (why) kept.push({ ...r, action: 'delete', reason: why });
+      else del.push(r);
+    }
+    return { close, delete: del, kept };
+  }
+
+  /** Close and/or delete what the plan says; `ids` limits it to those agents. */
+  async run({ close = true, delete: del = true, ids = null, by = 'person' } = {}) {
+    const only = ids ? new Set(ids) : null;
+    const plan = await this.plan();
+    const done = { at: new Date().toISOString(), by, closed: [], deleted: [], kept: plan.kept, failed: [] };
+    if (close) {
+      for (const row of plan.close.filter((r) => !only || only.has(r.id))) {
+        try {
+          await this.manager.stop(row.id);
+          this.manager.patch(row.id, { closedBy: 'cleanup' });
+          done.closed.push(row);
+        } catch (e) {
+          done.failed.push({ ...row, reason: e.message });
+        }
+      }
+    }
+    if (del) {
+      for (const row of plan.delete.filter((r) => !only || only.has(r.id))) {
+        try {
+          await this.manager.remove(row.id, { deleteWorkspace: true });
+          done.deleted.push(row);
+        } catch (e) {
+          done.failed.push({ ...row, reason: e.message });
+        }
+      }
+    }
+    if (done.closed.length || done.deleted.length || done.failed.length) {
+      this.log(`clean up (${by}): closed ${done.closed.length}, deleted ${done.deleted.length}${done.failed.length ? `, failed ${done.failed.length}` : ''}`);
+    }
+    this.store.data.cleanup.lastRun = done;
+    this.store.save();
+    return done;
+  }
+
+  /** The automatic pass, as the strategy says. */
+  async sweep() {
+    // Agents closed before clean up existed have no closing time: count from now, so nothing is
+    // deleted the day it is turned on.
+    let marked = false;
+    for (const agent of this.store.list()) {
+      if (!agent.closedAt && !this.manager.runtimes.get(agent.id)?.pty && agent.desired !== 'running') {
+        agent.closedAt = new Date().toISOString();
+        marked = true;
+      }
+    }
+    if (marked) this.store.save();
+    const { strategy } = this.settings;
+    if (strategy === 'off' || strategy === 'manual') return null;
+    return this.run({ close: true, delete: strategy === 'close-delete', by: 'schedule' });
+  }
+
+  async status() {
+    const s = this.settings;
+    return { ...s, ...(await this.plan()), lastRun: this.store.data.cleanup.lastRun ?? null };
+  }
+}