npm - agent-yes - Versions diffs - 1.122.3 → 1.124.0 - Mend

agent-yes 1.122.3 → 1.124.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (56) hide show

package/default.config.yaml +19 -0
package/dist/SUPPORTED_CLIS-Cvm7yo5d.js +8 -0
package/dist/{SUPPORTED_CLIS-BleNYXA2.js → SUPPORTED_CLIS-D_-bIOlW.js} +2 -2
package/dist/{agent-yes.config-z-IPzH5U.js → agent-yes.config-D6ycMApr.js} +2 -65
package/dist/cli.js +6 -6
package/dist/configShared-C5QaNPnz.js +71 -0
package/dist/{globalPidIndex-gZuTvTBs.js → globalPidIndex-C7r2m6s7.js} +19 -20
package/dist/index.js +4 -4
package/dist/pidStore-C4c2O15q.js +5 -0
package/dist/{pidStore-B5vBu8Px.js → pidStore-CGKIhaJO.js} +5 -4
package/dist/reaper-BLVA780B.js +3 -0
package/dist/{reaper-Dj8R7ltI.js → reaper-BkjPN7mw.js} +24 -2
package/dist/{remotes-CpGcTr7A.js → remotes-BRCDVnR7.js} +1 -1
package/dist/{remotes-D2fqaRU8.js → remotes-D8GvSbhf.js} +1 -1
package/dist/{schedule-e4f7NlA2.js → schedule-D2cn8N7o.js} +7 -7
package/dist/{serve-CzztmZ_N.js → serve-Bo3bDXQG.js} +202 -58
package/dist/{setup-CPyRNiIA.js → setup-CvOr258q.js} +3 -3
package/dist/{share-CS9XVrLF.js → share-YuM6-Q6A.js} +71 -13
package/dist/{subcommands-CQowpr1t.js → subcommands-ClVHy-xI.js} +647 -32
package/dist/subcommands-Llf9o8nh.js +7 -0
package/dist/{tray-DjCIyakK.js → tray-BVnJLThD.js} +1 -1
package/dist/{ts-9GThuc3w.js → ts-DGIglR4L.js} +10 -7
package/dist/{versionChecker-Bv9XKddN.js → versionChecker-gaQkM2Hy.js} +2 -2
package/dist/{workspaceConfig-XP2NEWmV.js → workspaceConfig-BJO4fzEn.js} +1 -1
package/lab/ui/console-logic.js +222 -10
package/lab/ui/icon.svg +5 -0
package/lab/ui/index.html +1152 -28
package/lab/ui/landing.html +276 -0
package/lab/ui/manifest.webmanifest +14 -0
package/lab/ui/sw.js +56 -0
package/package.json +5 -1
package/ts/agentTree.spec.ts +92 -0
package/ts/agentTree.ts +149 -0
package/ts/configShared.ts +4 -0
package/ts/globalPidIndex.ts +28 -20
package/ts/idleWaiter.spec.ts +7 -1
package/ts/index.ts +9 -0
package/ts/lsWatch.spec.ts +61 -0
package/ts/lsWatch.ts +94 -0
package/ts/needsInput.spec.ts +55 -0
package/ts/needsInput.ts +68 -0
package/ts/pidStore.ts +3 -0
package/ts/reaper.spec.ts +26 -2
package/ts/reaper.ts +25 -0
package/ts/resultEnvelope.spec.ts +43 -0
package/ts/resultEnvelope.ts +88 -0
package/ts/serve.ts +276 -41
package/ts/share.ts +144 -27
package/ts/subcommands.ts +0 -0
package/ts/todoParse.spec.ts +68 -0
package/ts/todoParse.ts +88 -0
package/ts/utils.spec.ts +4 -1
package/dist/SUPPORTED_CLIS-ClaOErso.js +0 -8
package/dist/pidStore-7y1cTcAE.js +0 -5
package/dist/reaper-HqcUms2d.js +0 -3
package/dist/subcommands-KAbIcd8_.js +0 -6

package/lab/ui/landing.html ADDED Viewed

@@ -0,0 +1,276 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <script>
+      // Backward-compat: share links used to be agent-yes.com/#room:token (the
+      // console lived at /). It now lives at /w/. The # fragment never reaches the
+      // server, so forward old links here, client-side, keeping the exact hash.
+      // No room hash → fall through and show this landing page normally.
+      (function () {
+        var h = location.hash;
+        if (h && /^#[A-Za-z0-9_-]+:.+/.test(h)) location.replace("/w/" + h);
+      })();
+    </script>
+    <title>agent-yes — drive any AI coding CLI on autopilot</title>
+    <meta
+      name="description"
+      content="agent-yes wraps Claude, Codex, Gemini and more, auto-answering their prompts so they run unattended — and ay serve streams a live, end-to-end-encrypted console to your browser."
+    />
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ctext y='14' font-size='14'%3E%E2%9C%93%3C/text%3E%3C/svg%3E"
+    />
+    <style>
+      :root {
+        --bg: #0d1117;
+        --panel: #161b22;
+        --border: #30363d;
+        --fg: #e6edf3;
+        --muted: #9198a1;
+        --accent: #2f81f7;
+        --green: #3fb950;
+        --code: #1f2530;
+      }
+      @media (prefers-color-scheme: light) {
+        :root {
+          --bg: #ffffff;
+          --panel: #f6f8fa;
+          --border: #d0d7de;
+          --fg: #1f2328;
+          --muted: #59636e;
+          --accent: #0969da;
+          --green: #1a7f37;
+          --code: #eff2f5;
+        }
+      }
+      * {
+        box-sizing: border-box;
+      }
+      html,
+      body {
+        margin: 0;
+      }
+      body {
+        background: var(--bg);
+        color: var(--fg);
+        font:
+          15px/1.6 -apple-system,
+          BlinkMacSystemFont,
+          "Segoe UI",
+          Helvetica,
+          Arial,
+          sans-serif;
+        -webkit-font-smoothing: antialiased;
+      }
+      a {
+        color: var(--accent);
+        text-decoration: none;
+      }
+      a:hover {
+        text-decoration: underline;
+      }
+      .wrap {
+        max-width: 760px;
+        margin: 0 auto;
+        padding: 0 20px;
+      }
+      header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: 22px 0;
+      }
+      .brand {
+        font-weight: 700;
+        font-size: 18px;
+        letter-spacing: -0.01em;
+      }
+      .brand .tick {
+        color: var(--green);
+      }
+      nav a {
+        color: var(--muted);
+        margin-left: 18px;
+        font-size: 14px;
+      }
+      .hero {
+        padding: 56px 0 40px;
+      }
+      h1 {
+        font-size: clamp(30px, 6vw, 46px);
+        line-height: 1.1;
+        letter-spacing: -0.02em;
+        margin: 0 0 16px;
+      }
+      .sub {
+        font-size: clamp(16px, 2.4vw, 19px);
+        color: var(--muted);
+        max-width: 60ch;
+        margin: 0 0 28px;
+      }
+      .cta {
+        display: flex;
+        gap: 12px;
+        flex-wrap: wrap;
+        align-items: center;
+      }
+      .btn {
+        display: inline-block;
+        padding: 11px 20px;
+        border-radius: 8px;
+        font-weight: 600;
+        font-size: 15px;
+        background: var(--accent);
+        color: #fff;
+        border: 1px solid transparent;
+      }
+      .btn:hover {
+        text-decoration: none;
+        filter: brightness(1.08);
+      }
+      .btn.ghost {
+        background: transparent;
+        color: var(--fg);
+        border-color: var(--border);
+      }
+      .install {
+        margin: 14px 0 0;
+      }
+      .install code,
+      pre code {
+        font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+      }
+      pre {
+        background: var(--code);
+        border: 1px solid var(--border);
+        border-radius: 8px;
+        padding: 14px 16px;
+        overflow-x: auto;
+        font-size: 13.5px;
+        margin: 8px 0;
+      }
+      .muted {
+        color: var(--muted);
+      }
+      .grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+        gap: 16px;
+        margin: 36px 0;
+      }
+      .card {
+        background: var(--panel);
+        border: 1px solid var(--border);
+        border-radius: 10px;
+        padding: 16px 18px;
+      }
+      .card h3 {
+        margin: 0 0 6px;
+        font-size: 15px;
+      }
+      .card p {
+        margin: 0;
+        color: var(--muted);
+        font-size: 14px;
+      }
+      footer {
+        border-top: 1px solid var(--border);
+        margin-top: 48px;
+        padding: 24px 0 40px;
+        color: var(--muted);
+        font-size: 13px;
+      }
+      .clis {
+        color: var(--muted);
+        font-size: 13px;
+        margin-top: 10px;
+      }
+      .clis b {
+        color: var(--fg);
+        font-weight: 600;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="wrap">
+      <header>
+        <div class="brand"><span class="tick">✓</span> agent-yes</div>
+        <nav>
+          <a href="/w/">Console</a>
+          <a href="/blog/">Blog</a>
+          <a href="https://github.com/snomiao/agent-yes">GitHub</a>
+        </nav>
+      </header>
+      <section class="hero">
+        <h1>Drive any AI coding CLI on autopilot.</h1>
+        <p class="sub">
+          agent-yes wraps Claude, Codex, Gemini, Copilot and more — auto-answering their prompts so
+          they keep working unattended. Then <code>ay serve</code>
+          streams a live, end-to-end-encrypted console to your browser so you can watch, steer, and
+          spawn agents from anywhere.
+        </p>
+        <div class="cta">
+          <a class="btn" href="/w/">Open the console →</a>
+          <a class="btn ghost" href="https://github.com/snomiao/agent-yes">Star on GitHub</a>
+        </div>
+        <div class="install">
+          <pre><code># macOS / Linux
+curl -fsSL https://agent-yes.com/setup.sh | sh
+# Windows (PowerShell)
+powershell -c "irm https://agent-yes.com/setup.ps1 | iex"</code></pre>
+          <div class="clis">
+            Wrappers: <b>claude-yes</b> · <b>codex-yes</b> · <b>gemini-yes</b> ·
+            <b>copilot-yes</b> · <b>cursor-yes</b> · <b>qwen-yes</b> · <b>grok-yes</b> — or just
+            <b>ay</b>.
+          </div>
+        </div>
+      </section>
+      <section class="grid">
+        <div class="card">
+          <h3>Auto-yes the prompts</h3>
+          <p>
+            Trust dialogs, theme pickers, "continue?", overload retries — handled, so the agent
+            never stalls waiting on you.
+          </p>
+        </div>
+        <div class="card">
+          <h3>Live console, anywhere</h3>
+          <p>
+            <code>ay serve</code> shares a WebRTC console at <a href="/w/">/w/</a> — list, tail, and
+            steer every agent from your phone or laptop.
+          </p>
+        </div>
+        <div class="card">
+          <h3>End-to-end encrypted</h3>
+          <p>
+            The share link's secret never reaches the signaling server; traffic is AES-GCM between
+            your browser and your machine.
+          </p>
+        </div>
+        <div class="card">
+          <h3>Many CLIs, one wrapper</h3>
+          <p>
+            One tool across Claude, Codex, Gemini, Copilot, Cursor, Qwen, Grok — same flags, same
+            live console.
+          </p>
+        </div>
+      </section>
+      <footer class="wrap" style="padding-left: 0; padding-right: 0">
+        <div>
+          <a href="/w/">Console</a> · <a href="/blog/">Blog</a> ·
+          <a href="https://github.com/snomiao/agent-yes">GitHub</a> ·
+          <a href="https://www.npmjs.com/package/agent-yes">npm</a>
+        </div>
+        <div style="margin-top: 8px">
+          MIT · made by <a href="https://github.com/snomiao">snomiao</a>
+        </div>
+      </footer>
+    </div>
+  </body>
+</html>

package/lab/ui/manifest.webmanifest ADDED Viewed

@@ -0,0 +1,14 @@
+{
+  "name": "agent-yes console",
+  "short_name": "agent-yes",
+  "description": "Live, end-to-end-encrypted console for your agent-yes agents.",
+  "start_url": "/w/",
+  "scope": "/w/",
+  "display": "standalone",
+  "background_color": "#0d1117",
+  "theme_color": "#0d1117",
+  "icons": [
+    { "src": "./icon.svg", "sizes": "any", "type": "image/svg+xml", "purpose": "any" },
+    { "src": "./icon.svg", "sizes": "any", "type": "image/svg+xml", "purpose": "maskable" }
+  ]
+}

package/lab/ui/sw.js ADDED Viewed

@@ -0,0 +1,56 @@
+// Service worker for the agent-yes console PWA (scope: /w/).
+//
+// Strategy: NETWORK-FIRST for the same-origin /w/ shell. The console speaks a
+// versioned wire protocol to the signaling server, so it must never run stale —
+// online we always fetch fresh (and refresh the cache); the cache is only a
+// fallback when offline, which is what makes the installed app launchable with no
+// network. WebSocket signaling and cross-origin CDN scripts are not GET fetches we
+// own, so they pass straight through.
+const CACHE = "agent-yes-w-v1";
+const SHELL = [
+  "./",
+  "./index.html",
+  "./room-client.js",
+  "./console-logic.js",
+  "./e2e.js",
+  "./manifest.webmanifest",
+  "./icon.svg",
+];
+self.addEventListener("install", (e) => {
+  self.skipWaiting();
+  e.waitUntil(caches.open(CACHE).then((c) => c.addAll(SHELL).catch(() => {})));
+});
+self.addEventListener("activate", (e) => {
+  e.waitUntil(
+    (async () => {
+      const keys = await caches.keys();
+      await Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k)));
+      await self.clients.claim();
+    })(),
+  );
+});
+self.addEventListener("fetch", (e) => {
+  const req = e.request;
+  if (req.method !== "GET") return;
+  const url = new URL(req.url);
+  // Only the same-origin /w/ shell; let everything else (CDN, signaling) be.
+  if (url.origin !== self.location.origin || !url.pathname.startsWith("/w/")) return;
+  e.respondWith(
+    (async () => {
+      try {
+        const res = await fetch(req);
+        if (res && res.ok) {
+          const c = await caches.open(CACHE);
+          c.put(req, res.clone());
+        }
+        return res;
+      } catch {
+        const cached = await caches.match(req);
+        return cached || (await caches.match("./index.html")) || Response.error();
+      }
+    })(),
+  );
+});

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.122.3",
+  "version": "1.124.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",
@@ -58,8 +58,12 @@
     "lab/ui/console-logic.js",
     "lab/ui/e2e.d.ts",
     "lab/ui/e2e.js",
+    "lab/ui/icon.svg",
     "lab/ui/index.html",
+    "lab/ui/landing.html",
+    "lab/ui/manifest.webmanifest",
     "lab/ui/room-client.js",
+    "lab/ui/sw.js",
     "lab/ui/blog/**"
   ],
   "type": "module",

package/ts/agentTree.spec.ts ADDED Viewed

@@ -0,0 +1,92 @@
+import { expect, test } from "vitest";
+import { buildAgentForest, flattenForest, foldLayers } from "./agentTree.ts";
+import type { LayerNode } from "./agentTree.ts";
+import type { GlobalPidRecord } from "./globalPidIndex.ts";
+const mk = (pid: number, wrapper_pid: number, parent_pid?: number): GlobalPidRecord =>
+  ({ pid, wrapper_pid, parent_pid }) as GlobalPidRecord;
+const pidsOf = (recs: GlobalPidRecord[]) =>
+  flattenForest(buildAgentForest(recs))
+    .map((r) => r.record.pid)
+    .sort((a, b) => a - b);
+test("links child under parent via parent_pid === wrapper_pid", () => {
+  const rows = flattenForest(buildAgentForest([mk(1, 10), mk(2, 20, 10)]));
+  expect(rows.map((r) => r.record.pid)).toEqual([1, 2]);
+  expect(rows[1]!.depth).toBe(1); // child indented under root
+});
+test("orphan (parent not present) renders at top level, never vanishes", () => {
+  const rows = flattenForest(buildAgentForest([mk(1, 10), mk(2, 20, 10), mk(3, 30, 999)]));
+  expect(pidsOf([mk(1, 10), mk(2, 20, 10), mk(3, 30, 999)])).toEqual([1, 2, 3]);
+  expect(rows.find((r) => r.record.pid === 3)!.depth).toBe(0); // orphan is a root
+});
+// Regression: a parent_pid cycle (only via pid reuse across a reboot) used to
+// drop every node in the cycle, since none became a root — they'd disappear from
+// `ay ls` entirely. Each node must still render exactly once.
+test("2-node parent_pid cycle still renders both nodes", () => {
+  expect(pidsOf([mk(1, 10, 20), mk(2, 20, 10)])).toEqual([1, 2]);
+});
+test("3-node parent_pid cycle still renders all nodes", () => {
+  expect(pidsOf([mk(1, 10, 30), mk(2, 20, 10), mk(3, 30, 20)])).toEqual([1, 2, 3]);
+});
+test("self-parent is treated as a root, not dropped or self-nested", () => {
+  expect(pidsOf([mk(1, 10, 10)])).toEqual([1]);
+});
+// foldLayers: the VSCode-explorer-style collapse used by the console to nest
+// rooms > peers > agents and fold single-child chains onto one row.
+const ln = (label: string, children: LayerNode[] = []): LayerNode => ({
+  label,
+  kind: "node",
+  children,
+});
+test("foldLayers collapses a single-child chain onto one row", () => {
+  const rows = foldLayers([ln("a", [ln("b", [ln("c")])])]);
+  expect(rows).toHaveLength(1);
+  expect(rows[0]!.segments.map((s) => s.label)).toEqual(["a", "b", "c"]);
+  expect(rows[0]!.depth).toBe(0);
+  expect(rows[0]!.prefix).toBe("");
+});
+test("foldLayers branches a multi-child node into indented ├─/└─ rows", () => {
+  const rows = foldLayers([ln("root", [ln("x"), ln("y")])]);
+  expect(rows.map((r) => r.segments[0]!.label)).toEqual(["root", "x", "y"]);
+  expect(rows[0]!.depth).toBe(0);
+  expect(rows[1]!).toMatchObject({ depth: 1, prefix: "├─ " });
+  expect(rows[2]!).toMatchObject({ depth: 1, prefix: "└─ " }); // last child
+});
+test("foldLayers builds nested prefixes with both ancestor connectors", () => {
+  // root → {a (not last), b (last)}, each with two children, so depth-2 rows
+  // exercise both ancestor connectors: "│  " under a, "   " under the last child b.
+  const rows = foldLayers([
+    ln("root", [ln("a", [ln("a1"), ln("a2")]), ln("b", [ln("b1"), ln("b2")])]),
+  ]);
+  const at = (label: string) => rows.find((r) => r.segments[0]!.label === label)!;
+  expect(at("a1")).toMatchObject({ depth: 2, prefix: "│  ├─ " });
+  expect(at("a2").prefix).toBe("│  └─ ");
+  expect(at("b1").prefix).toBe("   ├─ ");
+  expect(at("b2").prefix).toBe("   └─ ");
+});
+test("foldLayers renders a node shared by two parents only once (visited guard)", () => {
+  // Diamond: root → {a, b}, both pointing at the same leaf c. The visited guard
+  // folds c into whichever branch reaches it first (a), so it isn't duplicated.
+  const c = ln("c");
+  const rows = foldLayers([ln("root", [ln("a", [c]), ln("b", [c])])]);
+  const labelsOf = (i: number) => rows[i]!.segments.map((s) => s.label);
+  expect(labelsOf(0)).toEqual(["root"]);
+  expect(labelsOf(1)).toEqual(["a", "c"]); // c folded into a's chain
+  expect(rows[1]!.prefix).toBe("├─ ");
+  expect(labelsOf(2)).toEqual(["b"]); // b's duplicate c is skipped, not re-rendered
+  expect(rows[2]!.prefix).toBe("└─ ");
+  expect(rows.flatMap((r) => r.segments.map((s) => s.label)).filter((l) => l === "c")).toHaveLength(
+    1,
+  );
+});

package/ts/agentTree.ts ADDED Viewed

@@ -0,0 +1,149 @@
+/**
+ * Agent hierarchy: link the flat pid registry into a parent→child forest and
+ * render it as a tree.
+ *
+ * A nested `ay` launched from inside another agent inherits its parent's
+ * wrapper pid via the AGENT_YES_PID env var (injected by both runtimes — see
+ * ts/index.ts and rs/src/pty_spawner.rs). We record that as `parent_pid`, so a
+ * child links to its parent with:  child.parent_pid === parent.wrapper_pid.
+ *
+ * Used by `ay ls` (CLI table) and the console (the deepest "agents > agents
+ * subtree" layer of signalling-server > rooms > peers > agents > subtree).
+ */
+import type { GlobalPidRecord } from "./globalPidIndex.ts";
+export interface ForestNode {
+  record: GlobalPidRecord;
+  children: ForestNode[];
+}
+/**
+ * Link records into a forest via parent_pid === wrapper_pid. Records whose
+ * parent isn't present in the set (top-level agents, or links into agents
+ * filtered out by a keyword/scope) become roots. Root and sibling order follows
+ * the input order, so a caller that pre-sorts (e.g. newest-first) is preserved.
+ */
+export function buildAgentForest(records: GlobalPidRecord[]): ForestNode[] {
+  const nodes: ForestNode[] = records.map((record) => ({ record, children: [] }));
+  const byWrapper = new Map<number, ForestNode>();
+  for (const n of nodes) {
+    const w = n.record.wrapper_pid;
+    // If two live agents ever share a wrapper pid (pid reuse across a reboot),
+    // last one wins — harmless for display.
+    if (typeof w === "number" && w > 0) byWrapper.set(w, n);
+  }
+  const roots: ForestNode[] = [];
+  for (const n of nodes) {
+    const p = n.record.parent_pid;
+    const parent = typeof p === "number" && p > 0 ? byWrapper.get(p) : undefined;
+    if (parent && parent !== n) parent.children.push(n);
+    else roots.push(n);
+  }
+  // Cycle safety: a 2+ node parent_pid cycle (possible only via pid reuse across a
+  // reboot) links every member as someone's child, so none become roots and they'd
+  // vanish from the output entirely. Mark everything reachable from the current
+  // roots, then append any unreached node as its own root; flattenForest's visited
+  // guard then renders each exactly once. Mirrors the console JS recovery pass
+  // (lab/ui/console-logic.js agentForestNodes).
+  const seen = new Set<ForestNode>();
+  const mark = (n: ForestNode) => {
+    if (seen.has(n)) return;
+    seen.add(n);
+    n.children.forEach(mark);
+  };
+  roots.forEach(mark);
+  for (const n of nodes) if (!seen.has(n)) roots.push(n);
+  return roots;
+}
+export interface FlatRow {
+  record: GlobalPidRecord;
+  /** Box-drawing branch prefix, e.g. "", "├─ ", "│  └─ ". Empty for roots. */
+  prefix: string;
+  depth: number;
+}
+/**
+ * Depth-first flatten a forest into rows carrying a box-drawing branch prefix.
+ * A `visited` guard makes a pathological parent_pid cycle terminate instead of
+ * recursing forever.
+ */
+export function flattenForest(roots: ForestNode[]): FlatRow[] {
+  const rows: FlatRow[] = [];
+  const visited = new Set<ForestNode>();
+  const walk = (node: ForestNode, ancestorsLast: boolean[]) => {
+    if (visited.has(node)) return;
+    visited.add(node);
+    const depth = ancestorsLast.length;
+    let prefix = "";
+    for (let i = 0; i < depth - 1; i++) prefix += ancestorsLast[i] ? "   " : "│  ";
+    if (depth > 0) prefix += ancestorsLast[depth - 1] ? "└─ " : "├─ ";
+    rows.push({ record: node.record, prefix, depth });
+    node.children.forEach((c, i) => walk(c, [...ancestorsLast, i === node.children.length - 1]));
+  };
+  for (const r of roots) walk(r, []);
+  return rows;
+}
+/**
+ * Generic VSCode-explorer-style layered tree node, used by the console to nest
+ * rooms > peers > agents and fold away any layer that has a single child.
+ */
+export interface LayerNode {
+  /** Short label for this layer node, e.g. a room name, host, or agent title. */
+  label: string;
+  /** Layer kind, for styling/icons in the UI (e.g. "room", "peer", "agent"). */
+  kind: string;
+  children: LayerNode[];
+  /** Arbitrary payload (e.g. the agent record) for leaves. */
+  data?: unknown;
+}
+export interface FoldedRow {
+  /** Labels folded onto this one line (a single-child chain), parent→child. */
+  segments: { label: string; kind: string }[];
+  depth: number;
+  prefix: string;
+  node: LayerNode;
+}
+/**
+ * Fold + flatten a layer forest the way VSCode's explorer collapses a chain of
+ * single-child folders (`com/example/app`) onto one row, and only indents into a
+ * tree where a node actually has multiple children.
+ *
+ * - A node with exactly one child is merged with that child: their labels join
+ *   on this row and we descend without adding depth.
+ * - A node with 0 or ≥2 children ends the current row; each child (when ≥2)
+ *   starts a new indented row with ├─ / └─ branches.
+ */
+export function foldLayers(roots: LayerNode[]): FoldedRow[] {
+  const rows: FoldedRow[] = [];
+  const visited = new Set<LayerNode>();
+  const walk = (start: LayerNode, ancestorsLast: boolean[]) => {
+    // Collapse the single-child chain starting at `start`.
+    const segments: { label: string; kind: string }[] = [];
+    let node = start;
+    while (true) {
+      if (visited.has(node)) break;
+      visited.add(node);
+      segments.push({ label: node.label, kind: node.kind });
+      if (node.children.length === 1) {
+        node = node.children[0]!;
+        continue;
+      }
+      break;
+    }
+    const depth = ancestorsLast.length;
+    let prefix = "";
+    for (let i = 0; i < depth - 1; i++) prefix += ancestorsLast[i] ? "   " : "│  ";
+    if (depth > 0) prefix += ancestorsLast[depth - 1] ? "└─ " : "├─ ";
+    rows.push({ segments, depth, prefix, node });
+    // Branch into the children of the chain's tail (only reached when ≥2).
+    node.children.forEach((c, i) => walk(c, [...ancestorsLast, i === node.children.length - 1]));
+  };
+  // A single root collapses away too: only branch the roots when there are ≥2.
+  for (const r of roots) walk(r, []);
+  return rows;
+}

package/ts/configShared.ts CHANGED Viewed

@@ -18,6 +18,7 @@ type RawCliConfig = Omit<
   | "updateAvailable"
   | "exitCommands"
   | "autoRetry"
+  | "needsInput"
 > & {
   ready?: RegexSource[];
   fatal?: RegexSource[];
@@ -28,6 +29,7 @@ type RawCliConfig = Omit<
   restartWithoutContinueArg?: RegexSource[];
   updateAvailable?: RegexSource[];
   autoRetry?: RegexSource[];
+  needsInput?: RegexSource[];
   exitCommands?: string[];
   exitCommand?: string[];
 };
@@ -81,6 +83,7 @@ export function normalizeCliConfig(raw: RawCliConfig): AgentCliConfig {
     restartWithoutContinueArg,
     updateAvailable,
     autoRetry,
+    needsInput,
     exitCommands,
     exitCommand,
     ...rest
@@ -97,6 +100,7 @@ export function normalizeCliConfig(raw: RawCliConfig): AgentCliConfig {
     restartWithoutContinueArg: compileRegexList(restartWithoutContinueArg),
     updateAvailable: compileRegexList(updateAvailable),
     autoRetry: compileRegexList(autoRetry),
+    needsInput: compileRegexList(needsInput),
     exitCommands: exitCommands ?? exitCommand,
   };
 }