agent-rooms 0.1.8 → 0.2.0

package/dist/dashboard/ui.js

@@ -7,82 +7,108 @@ export function dashboardHtml() {
   <title>Agent Rooms Control</title>
   <style>
     :root {
-      color-scheme: light;
-      --bg: #f6f5f2;
-      --panel: #ffffff;
-      --ink: #181715;
-      --muted: #69645c;
-      --line: #ded8ce;
-      --green: #207a4c;
-      --amber: #9a6417;
-      --red: #a33a32;
-      --blue: #2364a8;
-      --gold: #a97913;
-      --shadow: 0 14px 35px rgba(24, 23, 21, 0.08);
+      color-scheme: dark;
+      --bg: #05070F;
+      --bg2: #0B1020;
+      --panel: rgba(255,255,255,.022);
+      --ink: #EAEFF8;
+      --muted: #8A93A6;
+      --faint: #5E6678;
+      --line: rgba(255,255,255,.07);
+      --line2: rgba(255,255,255,.12);
+      --cyan: #38BDF8;
+      --cyan2: #7DD3FC;
+      --purple: #A78BFA;
+      --green: #22C55E;
+      --amber: #FBBF24;
+      --red: #F87171;
+      --gold: #FACC15;
+      --blue: #38BDF8;
+      --shadow: 0 24px 60px -28px rgba(0,0,0,.85);
       font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
     }
     * { box-sizing: border-box; }
-    body { margin: 0; background: var(--bg); color: var(--ink); }
+    body {
+      margin: 0; color: var(--ink);
+      background:
+        radial-gradient(1100px 620px at 78% -8%, rgba(56,189,248,.10), transparent 60%),
+        radial-gradient(900px 560px at -6% 8%, rgba(167,139,250,.09), transparent 55%),
+        var(--bg);
+      -webkit-font-smoothing: antialiased;
+    }
+    .mono, pre, .event, input, select { font-family: ui-monospace, "SF Mono", SFMono-Regular, Consolas, "Liberation Mono", monospace; }
     button, input, select { font: inherit; }
-    .shell { min-height: 100vh; display: grid; grid-template-columns: 250px 1fr; }
-    aside { border-right: 1px solid var(--line); padding: 24px 18px; background: #fbfaf8; }
-    main { padding: 26px; max-width: 1180px; width: 100%; }
-    .brand { font-size: 15px; font-weight: 800; letter-spacing: 0; margin-bottom: 4px; }
-    .sub { color: var(--muted); font-size: 13px; line-height: 1.4; margin-bottom: 22px; }
-    .nav { display: grid; gap: 6px; }
-    .nav button { border: 0; background: transparent; text-align: left; padding: 10px 11px; border-radius: 8px; color: var(--muted); cursor: pointer; }
-    .nav button.active { background: #ece7dd; color: var(--ink); font-weight: 700; }
-    .top { display: flex; align-items: flex-start; justify-content: space-between; gap: 18px; margin-bottom: 18px; }
-    h1 { font-size: 25px; margin: 0 0 6px; letter-spacing: 0; }
-    .meta { color: var(--muted); font-size: 13px; }
-    .banner { background: var(--panel); border: 1px solid var(--line); border-left: 5px solid var(--blue); box-shadow: var(--shadow); border-radius: 8px; padding: 15px 16px; display: flex; align-items: center; justify-content: space-between; gap: 16px; margin-bottom: 18px; }
-    .banner.ready { border-left-color: var(--green); }
-    .banner strong { display: block; margin-bottom: 3px; }
+    ::selection { background: rgba(56,189,248,.28); }
+    ::-webkit-scrollbar { width: 9px; height: 9px; }
+    ::-webkit-scrollbar-thumb { background: rgba(255,255,255,.1); border-radius: 99px; }
+    .shell { min-height: 100vh; display: grid; grid-template-columns: 248px 1fr; }
+    aside { border-right: 1px solid var(--line); padding: 22px 16px; background: linear-gradient(180deg, rgba(11,16,32,.55), rgba(5,7,15,.2)); position: sticky; top: 0; height: 100vh; }
+    main { padding: 28px 30px; max-width: 1200px; width: 100%; }
+    .brand { display: flex; align-items: center; gap: 9px; font-size: 14.5px; font-weight: 700; letter-spacing: -.01em; margin-bottom: 5px; color: #F8FAFC; }
+    .brand::before { content: ""; width: 19px; height: 19px; border-radius: 6px; flex: none; background: linear-gradient(140deg, var(--cyan), var(--purple)); box-shadow: 0 0 16px -3px rgba(56,189,248,.7); }
+    .sub { color: var(--faint); font-size: 12px; line-height: 1.5; margin-bottom: 22px; }
+    .nav { display: grid; gap: 3px; }
+    .nav button { display: flex; align-items: center; gap: 9px; border: 0; background: transparent; text-align: left; padding: 9px 11px; border-radius: 9px; color: var(--muted); cursor: pointer; font-size: 13.5px; transition: background .12s, color .12s; }
+    .nav button:hover { background: rgba(255,255,255,.04); color: var(--ink); }
+    .nav button.active { background: linear-gradient(90deg, rgba(56,189,248,.14), rgba(56,189,248,.04)); color: #F8FAFC; font-weight: 600; box-shadow: inset 2px 0 0 var(--cyan); }
+    .top { display: flex; align-items: flex-start; justify-content: space-between; gap: 18px; margin-bottom: 20px; }
+    h1 { font-size: 23px; margin: 0 0 5px; letter-spacing: -.02em; font-weight: 650; }
+    .meta { color: var(--faint); font-size: 12px; }
+    .banner { background: var(--panel); border: 1px solid var(--line2); backdrop-filter: blur(10px); border-radius: 13px; padding: 15px 17px; display: flex; align-items: center; justify-content: space-between; gap: 16px; margin-bottom: 18px; position: relative; overflow: hidden; }
+    .banner::before { content: ""; position: absolute; left: 0; top: 0; bottom: 0; width: 3px; background: var(--cyan); }
+    .banner.ready::before { background: var(--green); }
+    .banner strong { display: block; margin-bottom: 3px; font-weight: 600; color: #F8FAFC; }
     .grid { display: grid; gap: 16px; }
-    .two { grid-template-columns: minmax(0, 1.2fr) minmax(320px, .8fr); align-items: start; }
-    .panel { background: var(--panel); border: 1px solid var(--line); border-radius: 8px; box-shadow: var(--shadow); }
-    .panel h2 { font-size: 16px; padding: 15px 16px 0; margin: 0; }
-    .step { display: grid; grid-template-columns: 26px minmax(0, 1fr) auto; gap: 12px; padding: 13px 16px; border-top: 1px solid var(--line); align-items: center; }
+    .two { grid-template-columns: minmax(0, 1.25fr) minmax(330px, .75fr); align-items: start; }
+    .panel { background: var(--panel); border: 1px solid var(--line); border-radius: 14px; box-shadow: var(--shadow); overflow: hidden; }
+    .panel h2 { font-size: 10.5px; letter-spacing: .14em; text-transform: uppercase; color: var(--faint); padding: 15px 16px 9px; margin: 0; font-weight: 600; }
+    .step { display: grid; grid-template-columns: 22px minmax(0, 1fr) auto; gap: 13px; padding: 14px 16px; border-top: 1px solid var(--line); align-items: center; }
     .step:first-of-type { border-top: 0; }
-    .step.done { color: var(--muted); padding-top: 9px; padding-bottom: 9px; }
-    .step.frontier { background: #f2f7fb; outline: 2px solid rgba(35, 100, 168, .18); outline-offset: -2px; }
-    .dot { width: 14px; height: 14px; border-radius: 50%; margin-top: 3px; background: var(--muted); }
-    .ready .dot { background: var(--green); }
-    .action_needed .dot { background: var(--amber); }
-    .blocked .dot { background: var(--red); }
-    .working .dot { background: var(--blue); animation: pulse 1.2s infinite; }
-    .attention .dot { background: var(--gold); }
-    .absent .dot { background: #a7a29a; }
-    @keyframes pulse { 0%,100% { opacity: .45; } 50% { opacity: 1; } }
-    .label { font-weight: 750; margin-bottom: 3px; }
-    .hint { color: var(--muted); font-size: 13px; line-height: 1.4; }
-    .btn { border: 1px solid #25211b; background: #25211b; color: white; border-radius: 7px; min-height: 36px; padding: 0 12px; cursor: pointer; white-space: nowrap; }
-    .btn.secondary { background: #fff; color: var(--ink); border-color: var(--line); }
-    .btn.gold { background: var(--gold); border-color: var(--gold); }
-    .btn:disabled { opacity: .45; cursor: not-allowed; }
-    .kv { display: grid; gap: 9px; padding: 15px 16px; }
-    .row { display: flex; align-items: center; justify-content: space-between; gap: 12px; border-top: 1px solid var(--line); padding: 11px 16px; }
-    .row:first-child { border-top: 0; }
-    .pill { border: 1px solid var(--line); border-radius: 999px; padding: 3px 8px; font-size: 12px; color: var(--muted); white-space: nowrap; }
-    .pill.ready { color: var(--green); border-color: rgba(32,122,76,.25); background: rgba(32,122,76,.08); }
-    .pill.warn { color: var(--amber); border-color: rgba(154,100,23,.25); background: rgba(154,100,23,.08); }
-    .pill.bad { color: var(--red); border-color: rgba(163,58,50,.25); background: rgba(163,58,50,.08); }
-    .activity { max-height: 460px; overflow: auto; padding: 8px 0; }
-    .event { padding: 10px 16px; border-top: 1px solid var(--line); font-family: ui-monospace, SFMono-Regular, Consolas, monospace; font-size: 12px; color: #37332d; }
+    .step.done { opacity: .62; padding-top: 11px; padding-bottom: 11px; }
+    .step.frontier { background: linear-gradient(90deg, rgba(56,189,248,.07), transparent); box-shadow: inset 2px 0 0 var(--cyan); }
+    .dot { width: 11px; height: 11px; border-radius: 50%; margin-top: 3px; background: var(--faint); box-shadow: 0 0 0 4px rgba(255,255,255,.03); }
+    .ready .dot { background: var(--green); box-shadow: 0 0 10px -1px var(--green); }
+    .action_needed .dot { background: var(--amber); box-shadow: 0 0 10px -1px var(--amber); }
+    .blocked .dot { background: var(--red); box-shadow: 0 0 10px -1px var(--red); }
+    .working .dot { background: var(--cyan); animation: pulse 1.2s infinite; box-shadow: 0 0 10px -1px var(--cyan); }
+    .attention .dot { background: var(--gold); box-shadow: 0 0 10px -1px var(--gold); }
+    .absent .dot { background: var(--faint); }
+    @keyframes pulse { 0%,100% { opacity: .4; } 50% { opacity: 1; } }
+    .label { font-weight: 600; margin-bottom: 3px; color: #EAEFF8; font-size: 13.5px; display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+    .hint { color: var(--muted); font-size: 12.5px; line-height: 1.5; }
+    .btn { border: 1px solid var(--cyan); background: var(--cyan); color: #05070F; border-radius: 9px; min-height: 35px; padding: 0 14px; cursor: pointer; white-space: nowrap; font-weight: 600; font-size: 12.5px; transition: filter .12s, transform .04s; box-shadow: 0 0 20px -8px rgba(56,189,248,.9); }
+    .btn:hover { filter: brightness(1.08); }
+    .btn:active { transform: translateY(1px); }
+    .btn.secondary { background: rgba(255,255,255,.04); color: var(--ink); border-color: var(--line2); box-shadow: none; }
+    .btn.secondary:hover { background: rgba(255,255,255,.08); }
+    .btn.gold { background: var(--gold); border-color: var(--gold); color: #1A1404; box-shadow: 0 0 20px -8px rgba(250,204,21,.9); }
+    .btn:disabled { opacity: .4; cursor: not-allowed; box-shadow: none; filter: none; }
+    .kv { display: grid; gap: 9px; padding: 13px 16px; }
+    .row { display: flex; align-items: center; justify-content: space-between; gap: 12px; border-top: 1px solid var(--line); padding: 12px 16px; font-size: 13px; }
+    .row:first-of-type { border-top: 0; }
+    .pill { border: 1px solid var(--line2); border-radius: 999px; padding: 3px 9px; font-size: 10.5px; letter-spacing: .04em; color: var(--muted); white-space: nowrap; font-weight: 600; }
+    .pill.ready { color: var(--green); border-color: rgba(34,197,94,.3); background: rgba(34,197,94,.1); }
+    .pill.warn { color: var(--amber); border-color: rgba(251,191,36,.3); background: rgba(251,191,36,.1); }
+    .pill.bad { color: var(--red); border-color: rgba(248,113,113,.3); background: rgba(248,113,113,.1); }
+    .activity { max-height: 520px; overflow: auto; padding: 4px 0; }
+    .event { padding: 9px 16px; border-top: 1px solid var(--line); font-size: 11.5px; color: #B6C0D4; line-height: 1.5; }
     .event:first-child { border-top: 0; }
     .form { display: grid; gap: 12px; padding: 16px; }
-    label { display: grid; gap: 5px; font-size: 13px; color: var(--muted); }
-    input, select { width: 100%; border: 1px solid var(--line); border-radius: 7px; padding: 10px 11px; background: #fff; color: var(--ink); }
-    pre { margin: 0; padding: 14px 16px; overflow: auto; border-top: 1px solid var(--line); font-size: 12px; background: #fbfaf8; }
+    label { display: grid; gap: 6px; font-size: 12px; color: var(--muted); }
+    input, select { width: 100%; border: 1px solid var(--line2); border-radius: 9px; padding: 10px 12px; background: rgba(5,7,15,.6); color: var(--ink); font-size: 12.5px; }
+    input:focus, select:focus { outline: none; border-color: var(--cyan); box-shadow: 0 0 0 3px rgba(56,189,248,.14); }
+    input::placeholder { color: var(--faint); }
+    option { background: #0B1020; }
+    pre { margin: 0; padding: 14px 16px; overflow: auto; border-top: 1px solid var(--line); font-size: 11.5px; background: rgba(5,7,15,.5); color: #9FB0C8; line-height: 1.55; }
     .hidden { display: none !important; }
-    .toast { position: fixed; right: 18px; bottom: 18px; width: min(560px, calc(100vw - 36px)); background: #25211b; color: white; border-radius: 8px; padding: 12px 14px; box-shadow: var(--shadow); font-size: 13px; white-space: pre-wrap; }
+    .toast { position: fixed; right: 20px; bottom: 20px; width: min(560px, calc(100vw - 40px)); background: rgba(11,16,32,.96); backdrop-filter: blur(14px); color: #EAEFF8; border: 1px solid var(--line2); border-radius: 12px; padding: 13px 15px; box-shadow: var(--shadow); font-size: 12.5px; white-space: pre-wrap; line-height: 1.5; }
     @media (max-width: 850px) {
       .shell { grid-template-columns: 1fr; }
-      aside { border-right: 0; border-bottom: 1px solid var(--line); }
+      aside { border-right: 0; border-bottom: 1px solid var(--line); position: static; height: auto; }
       main { padding: 18px; }
       .two { grid-template-columns: 1fr; }
       .top, .banner, .row { flex-direction: column; align-items: stretch; }
-      .step { grid-template-columns: 22px minmax(0, 1fr); }
+      .step { grid-template-columns: 18px minmax(0, 1fr); }
       .step .btn { grid-column: 2; justify-self: start; }
     }
   </style>
@@ -145,6 +171,24 @@ export function dashboardHtml() {
       }
     }
 
+    // No-code pairing: once pairing has started (the approval page is open in the
+    // browser), poll quietly until the device is approved — the human just clicks
+    // Approve over there, never copies a code, never clicks "Check approval" here.
+    let pairPoller = null;
+    async function pollPairSilently() {
+      try {
+        const result = await api("/api/actions", { method: "POST", body: JSON.stringify({ action: "pair.poll" }) });
+        snapshot = result.snapshot;
+        if (!snapshot.pendingPair) showToast("Device paired. Connecting your listener…");
+        render();
+      } catch (err) { /* keep polling; transient */ }
+    }
+    function ensurePairPolling() {
+      const pending = snapshot && snapshot.pendingPair;
+      if (pending && !pairPoller) pairPoller = setInterval(pollPairSilently, 3000);
+      else if (!pending && pairPoller) { clearInterval(pairPoller); pairPoller = null; }
+    }
+
     function statusText(status) {
       return {
         ready: "READY",
@@ -168,6 +212,7 @@ export function dashboardHtml() {
       }
       app.innerHTML = '<div class="shell"><aside>' + nav() + '</aside><main>' + page(r) + '</main></div>' + '<div id="toast" class="toast hidden"></div>';
       bind();
+      ensurePairPolling();
     }
 
     function nav() {
@@ -192,7 +237,7 @@ export function dashboardHtml() {
     function homePage(r) {
       const next = r.nextAction;
       const pair = snapshot.pendingPair
-        ? '<div class="banner"><div><strong>Approve this device: ' + esc(snapshot.pendingPair.user_code) + '</strong><div class="meta">The approval page was opened. After approving it in Agent Rooms, check status here.</div></div><button class="btn" data-action="' + encodeURIComponent(JSON.stringify({ id: "pair.poll", label: "Check approval" })) + '">Check approval</button></div>'
+        ? '<div class="banner"><div><strong>Waiting for approval — code ' + esc(snapshot.pendingPair.user_code) + '</strong><div class="meta">We opened the approval page in your browser. Click <b>Approve &amp; pair</b> there (you\'re already signed in) — this pairs automatically, no code to copy.</div></div><button class="btn secondary" data-action="' + encodeURIComponent(JSON.stringify({ id: "pair.poll", label: "Check now" })) + '">Check now</button></div>'
         : "";
       const banner = next
         ? '<div class="banner"><div><strong>Next: ' + esc(next.label) + '</strong><div class="meta">' + esc(next.hint) + '</div></div>' + actionButton(next.action) + '</div>'
@@ -209,7 +254,7 @@ export function dashboardHtml() {
       return '<section class="panel"><h2>Local Truth</h2>' +
         '<div class="row"><span>Device</span><span class="pill ' + (r.device.paired ? "ready" : "warn") + '">' + (r.device.paired ? "PAIRED" : "NOT PAIRED") + '</span></div>' +
         '<div class="row"><span>Listener<br><span class="meta">' + (r.listener.running ? 'Serving ' + esc(r.listener.servingCount) + ' instance(s)' : 'Stopped') + '</span></span><span>' + listenerControls(r) + '</span></div>' +
-        '<div class="row"><span>Dashboard</span><span class="pill ' + (r.dashboard.updateAvailable ? "warn" : "ready") + '">' + (r.dashboard.updateAvailable ? "UPDATE AVAILABLE" : "UP TO DATE") + '</span></div>' +
+        '<div class="row"><span>Dashboard</span><span>' + (r.dashboard.updateAvailable ? actionButton({ id: "dashboard.update", label: "Update" }, "gold") + ' ' : '') + '<span class="pill ' + (r.dashboard.updateAvailable ? "warn" : "ready") + '">' + (r.dashboard.updateAvailable ? "UPDATE AVAILABLE" : "UP TO DATE") + '</span></span></div>' +
         Object.values(r.hosts).map((h) => '<div class="row"><span>' + esc(h.label) + '<br><span class="meta">' + esc(h.version || h.detail) + '</span></span><span class="pill ' + (!h.detected ? "bad" : h.versionOk ? "ready" : "warn") + '">' + (!h.detected ? "MISSING" : h.versionOk ? "DETECTED" : "UPDATE") + '</span></div>').join("") +
         '<h2>Diagnose</h2>' + r.diagnostics.map((d) => '<div class="row"><span><strong>' + esc(d.symptom) + '</strong><br><span class="meta">' + esc(d.cause) + '</span></span>' + actionButton(d.action, "secondary") + '</div>').join("") +
         '</section>';
@@ -232,7 +277,7 @@ export function dashboardHtml() {
         '<label>Agent plate<input name="agent" placeholder="BRNL-AGT-XXXXXXXX" required /></label>' +
         '<label>Room id(s)<input name="rooms" placeholder="room_1, room_2" required /></label>' +
         '<label>Workspace path<input name="workspace" placeholder="D:\\\\your-project" required /></label>' +
-        '<label>Host<select name="host"><option value="claude_code">Claude Code</option><option value="codex">Codex</option></select></label>' +
+        '<label>Host<select name="host"><option value="claude_code">Claude Code</option><option value="codex">Codex</option><option value="gemini">Gemini CLI</option><option value="cursor">Cursor CLI</option><option value="openclaw">OpenClaw</option></select></label>' +
         '<button class="btn" type="submit">Save binding</button></form></section></div>';
     }
 

package/dist/dashboard/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/dashboard/ui.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoTX,CAAC;AACT,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/dashboard/ui.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiWX,CAAC;AACT,CAAC"}

package/dist/hosts.js

@@ -101,11 +101,15 @@ export const codexAdapter = {
     name: "codex",
     bin: "codex",
     allowedTools: ROOM_TOOLS,
-    // TODO: confirm the Codex on-disk skills dir before auto-installing there.
-    skillDir: null,
+    // Codex adopted the Agent Skills standard; it loads skills from ~/.codex/skills
+    // (the $skill-installer convention). Installing the bundled folder here makes a
+    // woken Codex agent room-fluent and shortens its wake prompt.
+    skillDir: join(homedir(), ".codex", "skills"),
     buildWake(spec) {
         // `codex exec -` reads the prompt from stdin. Keep the multi-line wake
-        // prompt out of argv so Windows shell resolution cannot split it.
+        // prompt out of argv so Windows shell resolution cannot split it. The sandbox
+        // is Codex's own (workspace-write); we don't override the agent's isolation
+        // (spec 14: that's the vendor's job, not the broker's).
         const base = ["exec", "--json", "--skip-git-repo-check", "--sandbox", "workspace-write"];
         if (spec.sessionId) {
             base.push("resume", spec.sessionId);
@@ -127,9 +131,111 @@ export const codexAdapter = {
         return firstJsonField(stdout, ["session_id", "thread_id"]);
     }
 };
+// ── Additional wakeable hosts (native spec §4.3–4.5) ────────────────────────
+// These follow the documented per-host commands from Spec 1. Exact flag names
+// drift across CLI versions (the spec flags this explicitly); where a behavior
+// is version-dependent we take the safe floor — prompt via stdin (never argv,
+// the mangling bug), fresh-spawn when headless resume isn't reliably emitted —
+// and annotate what to re-verify against the user's installed build.
+export const geminiAdapter = {
+    name: "gemini",
+    bin: "gemini",
+    allowedTools: ROOM_TOOLS,
+    // Gemini CLI adopted Agent Skills; loads from ~/.gemini/skills.
+    skillDir: join(homedir(), ".gemini", "skills"),
+    buildWake(spec) {
+        // Piping the prompt on stdin makes the run non-TTY → headless, and keeps the
+        // multi-line prompt out of argv. `--yolo` is Gemini's auto-approve (verify the
+        // flag name on the installed version — older builds used --approval-mode).
+        // Headless resume-by-id was historically not emitted in JSON output, so we
+        // take the universal floor: fresh spawn + injected thread context.
+        const args = ["--output-format", "json", "--yolo"];
+        return { command: this.bin, args, cwd: spec.workspace, stdin: spec.prompt, env: spec.env };
+    },
+    buildMcpAdd(apiBase) {
+        // Bearer parity with the wake path; some builds want the header in
+        // ~/.gemini/settings.json instead of a flag — verify on install.
+        return {
+            command: this.bin,
+            args: ["mcp", "add", "--transport", "http", "agent-rooms", `${apiBase}/mcp`, "--header", "Authorization: Bearer ${AGENT_ROOMS_TOKEN}"],
+            cwd: process.cwd()
+        };
+    },
+    buildMcpRemove() {
+        return { command: this.bin, args: ["mcp", "remove", "agent-rooms"], cwd: process.cwd() };
+    },
+    parseSessionId(stdout) {
+        return firstJsonField(stdout, ["session_id", "sessionId"]);
+    }
+};
+export const cursorAdapter = {
+    name: "cursor",
+    bin: "cursor-agent",
+    allowedTools: ROOM_TOOLS,
+    skillDir: join(homedir(), ".cursor", "skills"),
+    buildWake(spec) {
+        // `-p` is print/headless. `--force` is REQUIRED: without it, `-p` hangs
+        // indefinitely when workspace trust is required (spec §4.4 gotcha). Prompt on
+        // stdin to dodge argv mangling.
+        const args = ["-p", "--output-format", "json", "--force"];
+        if (spec.sessionId) {
+            args.push("--resume", spec.sessionId);
+        }
+        return { command: this.bin, args, cwd: spec.workspace, stdin: spec.prompt, env: spec.env };
+    },
+    buildMcpAdd(apiBase) {
+        return {
+            command: this.bin,
+            args: ["mcp", "add", "agent-rooms", "--transport", "http", `${apiBase}/mcp`],
+            cwd: process.cwd()
+        };
+    },
+    buildMcpRemove() {
+        return { command: this.bin, args: ["mcp", "remove", "agent-rooms"], cwd: process.cwd() };
+    },
+    parseSessionId(stdout) {
+        return firstJsonField(stdout, ["session_id", "sessionId", "resume_session"]);
+    }
+};
+export const openclawAdapter = {
+    name: "openclaw",
+    bin: "openclaw",
+    allowedTools: ROOM_TOOLS,
+    // OpenClaw skills come from ClawHub; on-disk dir ~/.openclaw/skills.
+    skillDir: join(homedir(), ".openclaw", "skills"),
+    buildWake(spec) {
+        // NOTE (spec §10.5, OPEN DECISION): OpenClaw is a gateway/meta-host. The clean
+        // integration dispatches a session via the running gateway (ACP/acpx with
+        // resumeSessionId), NOT a one-shot exec. This engine-level `run` form is the
+        // best-effort floor so a bound OpenClaw agent still wakes; revisit once the
+        // gateway-vs-engine decision lands. Gateway process must be alive.
+        const args = ["run", "--json"];
+        if (spec.sessionId) {
+            args.push("--resume", spec.sessionId);
+        }
+        args.push("-");
+        return { command: this.bin, args, cwd: spec.workspace, stdin: spec.prompt, env: spec.env };
+    },
+    buildMcpAdd(apiBase) {
+        return {
+            command: this.bin,
+            args: ["mcp", "add", "agent-rooms", "--transport", "streamable-http", "--url", `${apiBase}/mcp`],
+            cwd: process.cwd()
+        };
+    },
+    buildMcpRemove() {
+        return { command: this.bin, args: ["mcp", "remove", "agent-rooms"], cwd: process.cwd() };
+    },
+    parseSessionId(stdout) {
+        return firstJsonField(stdout, ["session_id", "sessionId", "resumeSessionId"]);
+    }
+};
 const ADAPTERS = {
     claude_code: claudeAdapter,
-    codex: codexAdapter
+    codex: codexAdapter,
+    gemini: geminiAdapter,
+    cursor: cursorAdapter,
+    openclaw: openclawAdapter
 };
 export function getAdapter(host) {
     return ADAPTERS[host] ?? null;

package/dist/hosts.js.map

@@ -1 +1 @@
-{"version":3,"file":"hosts.js","sourceRoot":"","sources":["../src/hosts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosts.js","sourceRoot":"","sources":["../src/hosts.ts"],"names":[],"mappings":"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"}

package/dist/listener.js

@@ -5,10 +5,23 @@ import { platform } from "node:os";
 import { loadConfig, saveConfig, sessionKey } from "./config.js";
 import { listenerPost } from "./api.js";
 import { getAdapter, isSkillInstalled } from "./hosts.js";
+import { ensureClaudeMdBridge, writeRoomMd } from "./bridge.js";
 import { runWake } from "./spawn.js";
 import { DaemonSocket } from "./socket.js";
 import { log } from "./log.js";
 const HEARTBEAT_MS = 60_000;
+// §5.5 — spawn-rate / concurrency caps. A wake storm (a malicious collaborator
+// hammering @mentions, or a chatter loop) must not fork-bomb the machine or blow
+// up model cost (#41). Caps sit far above any real workload; tune via env.
+const MAX_CONCURRENT_SPAWNS = clampInt(process.env.AGENT_ROOMS_MAX_CONCURRENT_SPAWNS, 3, 1, 32);
+const MAX_SPAWNS_PER_MIN = clampInt(process.env.AGENT_ROOMS_MAX_SPAWNS_PER_MIN, 20, 1, 600);
+const RATE_WINDOW_MS = 60_000;
+function clampInt(raw, fallback, min, max) {
+    const n = raw != null ? Number.parseInt(raw, 10) : NaN;
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.min(max, Math.max(min, n));
+}
 export class ListenerRuntime {
     options;
     config = null;
@@ -19,6 +32,15 @@ export class ListenerRuntime {
     instanceIds = [];
     instanceByAgentWorkspace = new Map();
     bindingByInstanceId = new Map();
+    // §5.5 spawn caps: in-flight count + rolling window of recent spawn starts.
+    inFlightSpawns = 0;
+    recentSpawns = [];
+    // Spec3 §15.7 self-update hot-handoff: while draining we refuse NEW wakes but let
+    // in-flight runs finish — so a dashboard self-update never hard-kills a working agent.
+    draining = false;
+    // Running spawns keyed by agent target, so an owner stop can terminate the
+    // real process mid-run (consent model: "stop your agent, instantly").
+    running = new Map();
     status = {
         running: false,
         cloudConnected: false,
@@ -91,6 +113,7 @@ export class ListenerRuntime {
             platform: platform(),
             agents,
             onWake: (wake) => this.onWake(wake),
+            onStop: (target) => this.stopTarget(target),
             onActivity: (activity) => this.onSocketActivity(activity)
         });
         this.socket.start();
@@ -138,7 +161,32 @@ export class ListenerRuntime {
         }
         return await this.start();
     }
+    /** Spec3 §15.7: stop taking new wakes and wait for in-flight runs to finish so a
+     *  self-update hands off cleanly instead of hard-killing a working agent. The
+     *  refused wakes stay queued server-side and deliver after the new version
+     *  reconnects. Returns whether it drained before the timeout. */
+    async drain(timeoutMs = 90_000) {
+        this.draining = true;
+        this.emit("info", "Draining: refusing new wakes, waiting for in-flight runs to finish.", "drain_start");
+        const deadline = Date.now() + timeoutMs;
+        while (this.inFlightSpawns > 0 && Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        const remaining = this.inFlightSpawns;
+        this.emit(remaining === 0 ? "info" : "warn", remaining === 0 ? "Drained — no runs in flight." : `Drain timed out with ${remaining} run(s) still active.`, "drain_done");
+        return { drained: remaining === 0, remaining };
+    }
+    /** Abort a drain (update cancelled) and resume normal wake handling. */
+    resumeFromDrain() {
+        this.draining = false;
+    }
     async onWake(wake) {
+        if (this.draining) {
+            // Draining for an update — don't start new work; the mention stays queued
+            // server-side and is delivered after the new version reconnects.
+            this.emit("info", `Draining for update; deferring wake for ${wake.target}.`, "wake_draining");
+            return { status: "error" };
+        }
         const config = this.config ?? loadConfig();
         if (config.pausedAgents.includes(wake.target)) {
             const message = `${wake.target} is paused locally; ignoring wake.`;
@@ -160,18 +208,61 @@ export class ListenerRuntime {
             this.emit("warn", message, "wake_no_adapter");
             return { status: "error" };
         }
+        // §5.5: refuse the spawn if we're over the concurrency or rate cap. This is
+        // the local brake on a wake storm — it returns an error rather than forking.
+        const throttle = this.spawnThrottleReason();
+        if (throttle) {
+            log.warn(throttle);
+            this.emit("warn", throttle, "wake_throttled");
+            return { status: "error" };
+        }
+        // Spec 05: deterministic instruction bridge + room pointer in the workspace,
+        // assembled from facts just before the agent runs. Best-effort — a write
+        // failure must never block the wake.
+        try {
+            if (binding.host === "claude_code") {
+                const bridge = ensureClaudeMdBridge(binding.workspace);
+                if (bridge.claudeMdAction === "created") {
+                    this.emit("info", `Bridged AGENTS.md → CLAUDE.md (@import) in ${binding.workspace}.`, "bridge");
+                }
+            }
+            writeRoomMd({
+                roomId: wake.room,
+                selfPlate: wake.target,
+                workspace: binding.workspace,
+                roommates: (wake.context_messages ?? []).map((m) => m.from)
+            });
+        }
+        catch (error) {
+            this.emit("warn", `workspace bridge/ROOM.md write failed: ${error.message}`, "bridge_failed");
+        }
         const key = sessionKey(wake.target, binding.workspace);
         const sessionId = wake.session_id ?? config.sessions[key];
         const prompt = selectWakePrompt(wake, isSkillInstalled(adapter));
         const env = binding.host === "codex" && config.hostTokens.codex
             ? { AGENT_ROOMS_TOKEN: config.hostTokens.codex }
             : undefined;
-        const outcome = await runWake(adapter, { prompt, workspace: binding.workspace, sessionId, maxTurns: this.maxTurns, env });
+        // Register an abort handle so an owner stop can terminate this run mid-flight.
+        const abort = new AbortController();
+        this.trackSpawn(wake.target, abort);
+        this.inFlightSpawns += 1;
+        this.recentSpawns.push(Date.now());
+        let outcome;
+        try {
+            outcome = await runWake(adapter, { prompt, workspace: binding.workspace, sessionId, maxTurns: this.maxTurns, env }, undefined, abort.signal);
+        }
+        finally {
+            this.inFlightSpawns -= 1;
+            this.untrackSpawn(wake.target, abort);
+        }
         if (outcome.sessionId) {
             config.sessions[key] = outcome.sessionId;
             saveConfig(config);
             this.config = config;
         }
+        // The wire protocol carries replied/timeout/error; an owner-stopped run
+        // reports as error (the run did not complete) while we log it as stopped.
+        const reported = outcome.status === "stopped" ? "error" : outcome.status;
         const instanceId = wake.instance_id ?? this.instanceByAgentWorkspace.get(bindingKey(binding.agent, binding.workspace));
         if (instanceId && config.device) {
             await listenerPost(this.apiBase, config.device.token, {
@@ -180,12 +271,50 @@ export class ListenerRuntime {
                 id: rid(),
                 instance_id: instanceId,
                 room: wake.room,
-                status: outcome.status,
+                status: reported,
                 session_id: outcome.sessionId ?? undefined
             }).catch((error) => this.emit("warn", `wake_result post failed: ${error.message}`, "wake_result_failed"));
         }
         this.emit(outcome.status === "error" ? "warn" : "info", `${adapter.name} wake finished with ${outcome.status}.`, "wake_finished");
-        return { status: outcome.status };
+        return { status: reported };
+    }
+    trackSpawn(target, abort) {
+        const set = this.running.get(target) ?? new Set();
+        set.add(abort);
+        this.running.set(target, set);
+    }
+    untrackSpawn(target, abort) {
+        const set = this.running.get(target);
+        if (!set)
+            return;
+        set.delete(abort);
+        if (set.size === 0)
+            this.running.delete(target);
+    }
+    /** Owner stop: abort every spawn currently running for this agent, which kills
+     *  the real process tree (see runWake/terminateChild). Pausing prevents future
+     *  wakes; this ends the one in flight. */
+    stopTarget(target) {
+        const set = this.running.get(target);
+        if (!set || set.size === 0)
+            return 0;
+        const count = set.size;
+        for (const abort of set)
+            abort.abort();
+        this.emit("warn", `Stopped ${count} running spawn(s) for ${target}.`, "spawn_stopped");
+        return count;
+    }
+    /** §5.5: returns a reason string if a spawn must be refused, else null. */
+    spawnThrottleReason() {
+        if (this.inFlightSpawns >= MAX_CONCURRENT_SPAWNS) {
+            return `Spawn refused: ${this.inFlightSpawns} agent run(s) already in flight (cap ${MAX_CONCURRENT_SPAWNS}).`;
+        }
+        const cutoff = Date.now() - RATE_WINDOW_MS;
+        this.recentSpawns = this.recentSpawns.filter((t) => t > cutoff);
+        if (this.recentSpawns.length >= MAX_SPAWNS_PER_MIN) {
+            return `Spawn refused: rate cap reached (${MAX_SPAWNS_PER_MIN}/min). Backing off.`;
+        }
+        return null;
     }
     resolveBinding(bindings, wake) {
         if (wake.instance_id) {