hub-runner 0.2.3 → 0.2.5

package/check.mjs

@@ -6,18 +6,18 @@ import { tmpdir } from "node:os";
 import { join as join3, resolve } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
 
-// ../../lib/clean-env.mjs
+// ../../hosted-hub/lib/clean-env.mjs
 var INHERITED_ENV = /^(EVE_|WORKFLOW_)/;
 function cleanEnv(env = process.env) {
   return Object.fromEntries(Object.entries(env).filter(([key]) => !INHERITED_ENV.test(key)));
 }
 
-// ../../lib/processes.mjs
-import { spawn, execFile, execFileSync } from "node:child_process";
-import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, renameSync, rmSync, readdirSync, statSync, writeFileSync, writeSync } from "node:fs";
+// ../../hosted-hub/lib/processes.mjs
+import { spawn } from "node:child_process";
+import { closeSync as closeSync2, existsSync, mkdirSync, openSync as openSync2, readFileSync, renameSync, rmSync, readdirSync, statSync as statSync2, writeFileSync, writeSync } from "node:fs";
 import { join } from "node:path";
 
-// ../../lib/fingerprint.mjs
+// ../../hosted-hub/lib/fingerprint.mjs
 var TREE_SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", ".DS_Store"]);
 function fingerprintDiff(recorded, current) {
   if (!recorded?.hash) return "it was started without a fingerprint (by an older registry)";
@@ -36,22 +36,44 @@ function fingerprintDiff(recorded, current) {
 }
 var BUILD_SKIP = /* @__PURE__ */ new Set([...TREE_SKIP, ".eve", ".output"]);
 
-// ../../lib/processes.mjs
-var num = (key, fallback) => {
-  const raw = process.env[key];
-  return raw === void 0 || raw === "" || !Number.isFinite(Number(raw)) ? fallback : Number(raw);
-};
+// ../../hosted-hub/lib/log-tail.mjs
+import { closeSync, openSync, readSync, statSync } from "node:fs";
+function createLogTail(log) {
+  const tails = /* @__PURE__ */ new Map();
+  function follow(name, file, offset) {
+    tails.set(name, { file, offset, carry: "", prefix: `[${name}]`.padEnd(20) });
+  }
+  function pump() {
+    for (const tail of tails.values()) {
+      let size;
+      try {
+        size = statSync(tail.file).size;
+      } catch {
+        continue;
+      }
+      if (size < tail.offset) tail.offset = 0;
+      if (size === tail.offset) continue;
+      const length = Math.min(size - tail.offset, 1e6);
+      const buffer = Buffer.alloc(length);
+      const fd = openSync(tail.file, "r");
+      try {
+        readSync(fd, buffer, 0, length, tail.offset);
+      } finally {
+        closeSync(fd);
+      }
+      tail.offset += length;
+      const lines = (tail.carry + buffer.toString("utf8")).split("\n");
+      tail.carry = lines.pop();
+      for (const line of lines) if (line.trim() && !line.startsWith("Migration file of version")) log(`${tail.prefix} ${line}`);
+    }
+  }
+  return { follow, pump };
+}
+
+// ../../hosted-hub/lib/process-tree.mjs
+import { execFile, execFileSync } from "node:child_process";
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-var CRASH_LIMIT = num("ROSTER_CRASH_LIMIT", 5);
-var CRASH_WINDOW_MS = num("ROSTER_CRASH_WINDOW_MS", 10 * 6e4);
-var BACKOFF_BASE_MS = num("ROSTER_BACKOFF_BASE_MS", 1e3);
-var BACKOFF_MAX_MS = num("ROSTER_BACKOFF_MAX_MS", 6e4);
-var HEALTH_TIMEOUT_MS = num("ROSTER_START_HEALTH_TIMEOUT_MS", 12e4);
-var PORT_RECHECK_MS = num("ROSTER_PORT_RECHECK_MS", 5e3);
 var KILL_GRACE_MS = 3e3;
-var WATCH_MS = 1e3;
-var TREE_MS = 5e3;
-var LOG_ROTATE_BYTES = 2e7;
 function groupAlive(pgid) {
   if (!(pgid > 1)) return false;
   try {
@@ -74,7 +96,7 @@ var C = { ...process.env, LC_ALL: "C" };
 var SLOW_MS = 1e3;
 function slow(what, started) {
   const ms = Date.now() - started;
-  if (ms >= SLOW_MS) console.warn(`[registry] ${what} took ${ms}ms`);
+  if (ms >= SLOW_MS) console.warn(`[runner] ${what} took ${ms}ms`);
 }
 var LSTART = String.raw`(\w{3}\s+\w{3}\s+\d+\s+[\d:]+\s+\d{4})`;
 function table() {
@@ -137,6 +159,73 @@ async function healthy(port, ms = 1e3) {
   }
 }
 var merge = (...lists) => [...new Map(lists.flat().map((m) => [m.pid, m])).values()];
+var treeAlive = (pgid, tree) => groupAlive(pgid) || liveMembers(tree, table()).length > 0;
+async function untilTreeGone(pgid, tree, ms) {
+  const deadline = Date.now() + ms;
+  while (treeAlive(pgid, tree)) {
+    if (Date.now() >= deadline) return false;
+    await sleep(200);
+  }
+  return true;
+}
+function killTree(pgid, tree) {
+  signalGroup(pgid, "SIGKILL");
+  for (const g of new Set(liveMembers(tree, table()).map((m) => m.pgid))) signalGroup(g, "SIGKILL");
+}
+async function stopTree(pgid, tree, { name, timeoutMs, warn }) {
+  if (!treeAlive(pgid, tree)) return true;
+  let membersTermed = false;
+  const termMembers = () => {
+    membersTermed = true;
+    for (const g of new Set(liveMembers(tree, table()).map((m) => m.pgid))) if (g !== pgid) signalGroup(g, "SIGTERM");
+  };
+  if (groupAlive(pgid)) signalGroup(pgid, "SIGTERM");
+  else termMembers();
+  const deadline = Date.now() + timeoutMs;
+  let gone = true;
+  while (treeAlive(pgid, tree)) {
+    if (!membersTermed && !groupAlive(pgid)) termMembers();
+    if (Date.now() >= deadline) {
+      gone = false;
+      break;
+    }
+    await sleep(200);
+  }
+  if (gone) return true;
+  warn(`[runner] ${name} didn't stop within ${timeoutMs / 1e3}s of SIGTERM; sending SIGKILL`);
+  killTree(pgid, tree);
+  return untilTreeGone(pgid, tree, KILL_GRACE_MS);
+}
+function ownsLeader(record, rows, signature) {
+  if (!(record.pid > 1) || record.pgid !== record.pid) return false;
+  const row = rows.find((r) => r.pid === record.pid);
+  if (!row || row.pgid !== record.pgid) return false;
+  if (!` ${row.command} `.includes(signature)) return false;
+  const member = record.tree?.find((m) => m.pid === record.pid);
+  if (member) return member.startedAt === row.startedAt;
+  const recorded = Date.parse(record.startedAt);
+  return !(Number.isFinite(row.startedAt) && Number.isFinite(recorded) && Math.abs(row.startedAt - recorded) > 5e3);
+}
+function ourTree(record, rows, signature) {
+  const leader = ownsLeader(record, rows, signature);
+  return { leader, tree: merge(leader ? treeOf(record.pid, rows) : [], liveMembers(record.tree, rows)) };
+}
+
+// ../../hosted-hub/lib/processes.mjs
+var num = (key, fallback) => {
+  const raw = process.env[key];
+  return raw === void 0 || raw === "" || !Number.isFinite(Number(raw)) ? fallback : Number(raw);
+};
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
+var CRASH_LIMIT = num("ROSTER_CRASH_LIMIT", 5);
+var CRASH_WINDOW_MS = num("ROSTER_CRASH_WINDOW_MS", 10 * 6e4);
+var BACKOFF_BASE_MS = num("ROSTER_BACKOFF_BASE_MS", 1e3);
+var BACKOFF_MAX_MS = num("ROSTER_BACKOFF_MAX_MS", 6e4);
+var HEALTH_TIMEOUT_MS = num("ROSTER_START_HEALTH_TIMEOUT_MS", 12e4);
+var PORT_RECHECK_MS = num("ROSTER_PORT_RECHECK_MS", 5e3);
+var WATCH_MS = 1e3;
+var TREE_MS = 5e3;
+var LOG_ROTATE_BYTES = 2e7;
 function createSupervisor({
   root,
   // the workspace: eve dev's cwd
@@ -149,18 +238,12 @@ function createSupervisor({
   isCurrent = () => true,
   // is this agent object still on the roster?
   // ({ agent, env, argv }) -> what a server spawned now runs with
-  // (lib/fingerprint.mjs), or null. A previous registry's server is
+  // (lib/fingerprint.mjs), or null. A previous runner's server is
   // adopted only if its recorded fingerprint matches.
   fingerprint = null,
   onChange = () => {
   },
   // status changed (broadcast)
-  onUsage = () => {
-  },
-  // a running tree's memory changed (status() reports rssKb)
-  onRecovered = () => {
-  },
-  // healthy again after a crash restart
   onUp = () => {
   },
   // a server is serving: adopted, spawned, or respawned ({ startedAt, adopted, recovered })
@@ -188,10 +271,7 @@ function createSupervisor({
       status: e.status,
       ...e.tree?.length ? { tree: e.tree } : {},
       ...e.lastExit ? { lastExit: e.lastExit } : {},
-      ...e.fingerprint ? { fingerprint: e.fingerprint } : {},
-      // The daemon token it was spawned with (HUB_INSTANCE): an adopted bot
-      // keeps its spawner's, and lib/daemon.mjs selfStopRefusal checks it here.
-      ...e.instance ? { instance: e.instance } : {}
+      ...e.fingerprint ? { fingerprint: e.fingerprint } : {}
     }));
     mkdirSync(stateDir, { recursive: true });
     const tmp = `${recordsPath}.${process.pid}.tmp`;
@@ -212,34 +292,7 @@ function createSupervisor({
     persist();
     onChange(entry.name);
   }
-  const tails = /* @__PURE__ */ new Map();
-  function follow(name, file, offset) {
-    tails.set(name, { file, offset, carry: "", prefix: `[${name}]`.padEnd(20) });
-  }
-  function pump() {
-    for (const tail of tails.values()) {
-      let size;
-      try {
-        size = statSync(tail.file).size;
-      } catch {
-        continue;
-      }
-      if (size < tail.offset) tail.offset = 0;
-      if (size === tail.offset) continue;
-      const length = Math.min(size - tail.offset, 1e6);
-      const buffer = Buffer.alloc(length);
-      const fd = openSync(tail.file, "r");
-      try {
-        readSync(fd, buffer, 0, length, tail.offset);
-      } finally {
-        closeSync(fd);
-      }
-      tail.offset += length;
-      const lines = (tail.carry + buffer.toString("utf8")).split("\n");
-      tail.carry = lines.pop();
-      for (const line of lines) if (line.trim() && !line.startsWith("Migration file of version")) log(`${tail.prefix} ${line}`);
-    }
-  }
+  const { follow, pump } = createLogTail(log);
   const pumpTimer = setInterval(pump, 250);
   pumpTimer.unref();
   function refreshTree(entry, rows = table()) {
@@ -247,10 +300,8 @@ function createSupervisor({
     const before = JSON.stringify(entry.tree ?? []);
     entry.tree = merge(treeOf(entry.pid, rows), liveMembers(entry.tree, rows));
     const own = rows.filter((r) => r.pid === entry.pid || r.ppid === entry.pid);
-    const rss = entry.rssKb;
     if (own.length) entry.rssKb = own.reduce((sum, r) => sum + (r.rssKb || 0), 0);
     if (JSON.stringify(entry.tree) !== before) persist();
-    if (entry.rssKb !== rss) onUsage(entry.name);
   }
   const treeTimer = setInterval(() => {
     const live = [...entries.values()].filter((e) => e.pid && !e.stopping);
@@ -259,45 +310,8 @@ function createSupervisor({
     for (const e of live) refreshTree(e, rows);
   }, TREE_MS);
   treeTimer.unref();
-  const treeAlive = (pgid, tree) => groupAlive(pgid) || liveMembers(tree, table()).length > 0;
-  async function untilTreeGone(pgid, tree, ms) {
-    const deadline = Date.now() + ms;
-    while (treeAlive(pgid, tree)) {
-      if (Date.now() >= deadline) return false;
-      await sleep(200);
-    }
-    return true;
-  }
-  function killTree(pgid, tree) {
-    signalGroup(pgid, "SIGKILL");
-    for (const g of new Set(liveMembers(tree, table()).map((m) => m.pgid))) signalGroup(g, "SIGKILL");
-  }
-  async function stopTree(pgid, tree, name) {
-    if (!treeAlive(pgid, tree)) return true;
-    let membersTermed = false;
-    const termMembers = () => {
-      membersTermed = true;
-      for (const g of new Set(liveMembers(tree, table()).map((m) => m.pgid))) if (g !== pgid) signalGroup(g, "SIGTERM");
-    };
-    if (groupAlive(pgid)) signalGroup(pgid, "SIGTERM");
-    else termMembers();
-    const deadline = Date.now() + stopTimeoutMs;
-    let gone = true;
-    while (treeAlive(pgid, tree)) {
-      if (!membersTermed && !groupAlive(pgid)) termMembers();
-      if (Date.now() >= deadline) {
-        gone = false;
-        break;
-      }
-      await sleep(200);
-    }
-    if (gone) return true;
-    warn(`[registry] ${name} didn't stop within ${stopTimeoutMs / 1e3}s of SIGTERM; sending SIGKILL`);
-    killTree(pgid, tree);
-    return untilTreeGone(pgid, tree, KILL_GRACE_MS);
-  }
   const logFile = (name) => join(logDir, `${name}.log`);
-  const sizeOf = (file) => existsSync(file) ? statSync(file).size : 0;
+  const sizeOf = (file) => existsSync(file) ? statSync2(file).size : 0;
   function entryFor(agent) {
     let entry = entries.get(agent.name);
     if (!entry) {
@@ -308,33 +322,19 @@ function createSupervisor({
     entry.port = agent.port;
     return entry;
   }
-  function ownsLeader(record, rows) {
-    if (!(record.pid > 1) || record.pgid !== record.pid) return false;
-    const row = rows.find((r) => r.pid === record.pid);
-    if (!row || row.pgid !== record.pgid) return false;
-    if (!` ${row.command} `.includes(signature(record.agent, record.port))) return false;
-    const member = record.tree?.find((m) => m.pid === record.pid);
-    if (member) return member.startedAt === row.startedAt;
-    const recorded = Date.parse(record.startedAt);
-    return !(Number.isFinite(row.startedAt) && Number.isFinite(recorded) && Math.abs(row.startedAt - recorded) > 5e3);
-  }
-  function ourTree(record, rows) {
-    const leader = ownsLeader(record, rows);
-    return { leader, tree: merge(leader ? treeOf(record.pid, rows) : [], liveMembers(record.tree, rows)) };
-  }
   async function killStale(record, why) {
     const rows = table();
-    const { leader, tree } = ourTree(record, rows);
+    const { leader, tree } = ourTree(record, rows, signature(record.agent, record.port));
     if (!leader && !tree.length) {
-      if (groupAlive(record.pgid)) warn(`[registry] ! ${record.agent}: process group ${record.pgid} from processes.json is no longer its server; leaving it alone`);
+      if (groupAlive(record.pgid)) warn(`[runner] ! ${record.agent}: process group ${record.pgid} from processes.json is no longer its server; leaving it alone`);
       return true;
     }
-    warn(`[registry] ${record.agent}: stopping its stale server (pid ${record.pid}): ${why}`);
-    return stopTree(leader ? record.pgid : null, tree, record.agent);
+    warn(`[runner] ${record.agent}: stopping its stale server (pid ${record.pid}): ${why}`);
+    return stopTree(leader ? record.pgid : null, tree, { name: record.agent, timeoutMs: stopTimeoutMs, warn });
   }
   async function vetAdoption(agent, record) {
     const rows = table();
-    const { leader, tree } = ourTree(record, rows);
+    const { leader, tree } = ourTree(record, rows, signature(record.agent, record.port));
     if (!leader && !tree.length) return { adopted: false };
     if (!leader) return { adopted: false, stale: true, why: "its leader is gone" };
     if (record.port !== agent.port) return { adopted: false, stale: true, why: `its port moved from ${record.port} to ${agent.port}` };
@@ -366,7 +366,7 @@ function createSupervisor({
     const { tree } = vetted;
     if (closed) return carry(agent, record, tree);
     const entry = entryFor(agent);
-    Object.assign(entry, { pid: record.pid, pgid: record.pgid, startedAt: record.startedAt, restarts: record.restarts ?? 0, status: "up", adopted: true, child: null, stopping: false, error: void 0, tree, fingerprint: record.fingerprint, instance: record.instance, rssKb: void 0 });
+    Object.assign(entry, { pid: record.pid, pgid: record.pgid, startedAt: record.startedAt, restarts: record.restarts ?? 0, status: "up", adopted: true, child: null, stopping: false, error: void 0, tree, fingerprint: record.fingerprint, rssKb: void 0 });
     const gen = ++entry.gen;
     follow(agent.name, logFile(agent.name), sizeOf(logFile(agent.name)));
     entry.watch = setInterval(() => {
@@ -377,14 +377,14 @@ function createSupervisor({
       }
     }, WATCH_MS);
     entry.watch.unref();
-    log(`[registry] adopted ${agent.name} (pid ${record.pid}, port ${agent.port})`);
+    log(`[runner] adopted ${agent.name} (pid ${record.pid}, port ${agent.port})`);
     changed(entry);
     onUp(agent, { startedAt: entry.startedAt, adopted: true, recovered: false });
     return { adopted: true };
   }
   function carry(agent, record, tree = record.tree ?? []) {
     const entry = entryFor(agent);
-    Object.assign(entry, { pid: record.pid, pgid: record.pgid, startedAt: record.startedAt, restarts: record.restarts ?? 0, status: record.status ?? "up", adopted: true, child: null, stopping: false, tree, fingerprint: record.fingerprint, instance: record.instance });
+    Object.assign(entry, { pid: record.pid, pgid: record.pgid, startedAt: record.startedAt, restarts: record.restarts ?? 0, status: record.status ?? "up", adopted: true, child: null, stopping: false, tree, fingerprint: record.fingerprint });
     entry.gen++;
     return { adopted: true, carried: true };
   }
@@ -410,7 +410,7 @@ function createSupervisor({
         return spawnAgent(entry, { recovered });
       }
       const error = `port ${port} is held by another process (${holders.map((pid) => describe(pid, rows)).join("; ")}), not by ${name}'s server; not touching it. ${name} starts once the port is free.`;
-      if (entry.error !== error || entry.status !== "blocked") warn(`[registry] ! ${error}`);
+      if (entry.error !== error || entry.status !== "blocked") warn(`[runner] ! ${error}`);
       Object.assign(entry, { status: "blocked", error, pid: null, pgid: null });
       entry.timer = setTimeout(() => spawnAgent(entry, { recovered }), PORT_RECHECK_MS);
       entry.timer.unref();
@@ -419,7 +419,7 @@ function createSupervisor({
     mkdirSync(logDir, { recursive: true });
     const file = logFile(name);
     if (sizeOf(file) > LOG_ROTATE_BYTES) renameSync(file, `${file}.1`);
-    const fd = openSync(file, "a");
+    const fd = openSync2(file, "a");
     writeSync(fd, `
 --- ${(/* @__PURE__ */ new Date()).toISOString()} hub: starting ${name} on port ${port}
 `);
@@ -429,7 +429,7 @@ function createSupervisor({
     try {
       fp = fingerprintFor(agent, spawnEnv);
     } catch (error) {
-      warn(`[registry] ! ${name}: couldn't fingerprint its inputs (${error.message}); the next registry respawns it instead of adopting it`);
+      warn(`[runner] ! ${name}: couldn't fingerprint its inputs (${error.message}); the next runner respawns it instead of adopting it`);
     }
     let child;
     try {
@@ -437,17 +437,17 @@ function createSupervisor({
         cwd: root,
         env: spawnEnv,
         detached: true,
-        // own process group; survives the registry
+        // own process group; survives the runner
         stdio: ["ignore", fd, fd]
       });
     } finally {
-      closeSync(fd);
+      closeSync2(fd);
     }
     const gen = ++entry.gen;
-    Object.assign(entry, { child, pid: child.pid ?? null, pgid: child.pid ?? null, startedAt: (/* @__PURE__ */ new Date()).toISOString(), status: "starting", adopted: false, stopping: false, error: void 0, nextRestartAt: void 0, tree: [], slowWarned: false, fingerprint: fp ?? void 0, instance: spawnEnv?.HUB_INSTANCE || void 0, rssKb: void 0 });
+    Object.assign(entry, { child, pid: child.pid ?? null, pgid: child.pid ?? null, startedAt: (/* @__PURE__ */ new Date()).toISOString(), status: "starting", adopted: false, stopping: false, error: void 0, nextRestartAt: void 0, tree: [], slowWarned: false, fingerprint: fp ?? void 0, rssKb: void 0 });
     follow(name, file, sizeOf(file));
     child.once("error", (error) => {
-      warn(`[registry] ! couldn't start ${name}: ${error.message}`);
+      warn(`[runner] ! couldn't start ${name}: ${error.message}`);
       exited(entry, gen, { code: null, signal: null, error: error.message });
     });
     child.once("exit", (code, signal) => exited(entry, gen, { code, signal }));
@@ -472,15 +472,14 @@ function createSupervisor({
           entry.status = "up";
           changed(entry);
           onUp(entry.agent, { startedAt: entry.startedAt, adopted: false, recovered });
-          if (recovered) onRecovered(entry.agent);
           return;
         }
       }
       if (Date.now() - started > HEALTH_TIMEOUT_MS && !entry.slowWarned) {
-        warn(`[registry] ! ${entry.name} isn't healthy ${HEALTH_TIMEOUT_MS / 1e3}s after starting; see ${logFile(entry.name)}`);
+        warn(`[runner] ! ${entry.name} isn't healthy ${HEALTH_TIMEOUT_MS / 1e3}s after starting; see ${logFile(entry.name)}`);
         entry.slowWarned = true;
       }
-      await sleep(500);
+      await sleep2(500);
     }
   }
   function exited(entry, gen, { code, signal, error }) {
@@ -506,13 +505,13 @@ function createSupervisor({
     if (entry.crashes.length >= CRASH_LIMIT) {
       entry.status = "crashed";
       entry.error = `exited ${entry.crashes.length} times within ${Math.round(CRASH_WINDOW_MS / 6e4)} min (last: ${how}); not restarting until restart_agent. Log: ${logFile(entry.name)}`;
-      warn(`[registry] ! ${entry.name} crashed: ${entry.error}`);
+      warn(`[runner] ! ${entry.name} crashed: ${entry.error}`);
       return changed(entry);
     }
     const delay2 = Math.min(BACKOFF_BASE_MS * 2 ** (entry.crashes.length - 1), BACKOFF_MAX_MS);
     entry.status = "down";
     entry.nextRestartAt = new Date(now + delay2).toISOString();
-    warn(`[registry] ${entry.name} exited unexpectedly (${how}); restarting in ${delay2 / 1e3}s`);
+    warn(`[runner] ${entry.name} exited unexpectedly (${how}); restarting in ${delay2 / 1e3}s`);
     entry.timer = setTimeout(async () => {
       await untilTreeGone(pgid, tree, KILL_GRACE_MS);
       if (entry.status !== "down" || entry.stopping) return;
@@ -524,7 +523,7 @@ function createSupervisor({
     changed(entry);
   }
   return {
-    // Startup: adopt what's still running from a previous registry, start the rest.
+    // Startup: adopt what's still running from a previous runner, start the rest.
     startAll(agents) {
       starting = (async () => {
         const records = readRecords();
@@ -542,7 +541,7 @@ function createSupervisor({
               const result = results.get(agent.name);
               if (result.adopted) return;
               if (closed && !result.superseded) {
-                if (ourTree(record, table()).tree.length) carry(agent, record);
+                if (ourTree(record, table(), signature(record.agent, record.port)).tree.length) carry(agent, record);
                 return;
               }
               await killStale(record, result.why ?? "it isn't serving");
@@ -586,7 +585,7 @@ function createSupervisor({
       }
       entry.status = "stopping";
       changed(entry);
-      const gone = await stopTree(pgid, tree, agent.name);
+      const gone = await stopTree(pgid, tree, { name: agent.name, timeoutMs: stopTimeoutMs, warn });
       if (gone) {
         if (entry.pgid === pgid) {
           entry.gen++;
@@ -608,42 +607,6 @@ function createSupervisor({
       pump();
       persist();
     },
-    // Exit without stopping any bot (a `hub restart` that keeps them): nothing
-    // new starts, pending (re)starts are cancelled, each tree is re-read and
-    // saved, and no signal is sent. The next registry vets every record
-    // (vetAdoption) and adopts what still matches. Returns the bots left running.
-    async detach() {
-      closed = true;
-      await starting.catch(() => {
-      });
-      clearInterval(pumpTimer);
-      clearInterval(treeTimer);
-      const rows = table();
-      for (const e of entries.values()) {
-        clearTimeout(e.timer);
-        e.timer = void 0;
-        e.claim = (e.claim ?? 0) + 1;
-        clearInterval(e.watch);
-        e.gen++;
-        if (e.pid) refreshTree(e, rows);
-      }
-      pump();
-      persist();
-      return [...entries.values()].filter((e) => e.pid).map((e) => ({ name: e.name, pid: e.pid }));
-    },
-    // Drop a removed bot's record (after its server is confirmed down).
-    forget(name) {
-      const entry = entries.get(name);
-      if (entry) {
-        clearTimeout(entry.timer);
-        clearInterval(entry.watch);
-        entry.gen++;
-        entry.claim = (entry.claim ?? 0) + 1;
-      }
-      entries.delete(name);
-      tails.delete(name);
-      persist();
-    },
     // Resolves true once the bot is up (spawned by us and healthy); false
     // once it can't be: it crashed, left the roster, or this supervisor closed.
     async waitUp(agent, timeoutMs) {
@@ -653,21 +616,10 @@ function createSupervisor({
         if (closed || !isCurrent(agent)) return false;
         if (entry?.agent === agent && entry.status === "up") return true;
         if (entry?.status === "crashed") return false;
-        await sleep(250);
+        await sleep2(250);
       }
       return false;
     },
-    // A running bot's memory as of the last tree refresh (eve dev + its
-    // server) and its uptime (an adopted one keeps its start). Kept out of
-    // status(): that's in every state snapshot, and these change constantly.
-    usage(name) {
-      const e = entries.get(name);
-      if (!e?.pid || e.status !== "up") return void 0;
-      return {
-        ...e.rssKb ? { rssMb: Math.round(e.rssKb / 1024) } : {},
-        ...e.startedAt ? { uptimeS: Math.max(0, Math.round((Date.now() - Date.parse(e.startedAt)) / 1e3)) } : {}
-      };
-    },
     status(name) {
       const e = entries.get(name);
       if (!e) return null;
@@ -742,7 +694,7 @@ async function createSession(fetchFn, eve, operationId) {
   return sessionId;
 }
 
-// ../../lib/v26-facts.mjs
+// ../../hosted-hub/lib/v26-facts.mjs
 function factsOfV26(event) {
   if (!event || typeof event.type !== "string") return { facts: [], progress: false };
   const data = isRecord(event.data) ? event.data : {};
@@ -962,7 +914,8 @@ function fact(type, data, source) {
 }
 var NO_RUN_SCOPE = /* @__PURE__ */ new Set(["context.started", "context.settled", "interaction.opened", "interaction.settled", "response.submitted", "response.settled"]);
 function content(data, kind, phase, value) {
-  return fact("content.completed", { partId: partIdOf(data, kind), runId: runIdOf(data), kind, phase, value }, data);
+  const run = typeof data.stepIndex === "number" ? { runId: runIdOf(data) } : {};
+  return fact("content.completed", { partId: partIdOf(data, kind), ...run, kind, phase, value }, data);
 }
 function turnSettled(data, settled) {
   const turnId = str(data.turnId);
@@ -1072,7 +1025,7 @@ var str = (value) => typeof value === "string" ? value : void 0;
 var num2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
 var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 
-// ../../lib/session-stream.mjs
+// ../../hosted-hub/lib/session-stream.mjs
 async function* readSessionLines(body, startIndex) {
   let line = startIndex;
   let lastAt = null;
@@ -1155,9 +1108,19 @@ async function* streamLines(eve, sessionId, o) {
     }
     const idle = new AbortController(), signal = o.signal ? AbortSignal.any([o.signal, idle.signal]) : idle.signal;
     let timer = setTimeout(() => idle.abort(), idleMs);
+    const opened = Date.now();
+    let firstByte = false, lineAt = opened;
     const quiet = () => {
       clearTimeout(timer);
       timer = setTimeout(() => idle.abort(), idleMs);
+      if (!firstByte) {
+        firstByte = true;
+        console.log(JSON.stringify({ event: "hub.stream_first_byte", sessionId, startIndex: next, ms: Date.now() - opened }));
+      }
+      if (Date.now() - lineAt >= idleMs) {
+        console.log(JSON.stringify({ event: "hub.stream_no_lines", sessionId, next, ms: Date.now() - lineAt }));
+        lineAt = Date.now();
+      }
     };
     let renewed = false;
     try {
@@ -1185,6 +1148,7 @@ async function* streamLines(eve, sessionId, o) {
               break;
             }
             yield record;
+            lineAt = Date.now();
             next = record.line + 1;
             reopens = o.reopens ?? 3;
           }