@smartmemory/stratum 0.4.5 → 0.5.0

package/dist/connectors/foreground_registry.js

@@ -0,0 +1,589 @@
+import { readdir, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { atomicWriteJson, newRunDir } from "./background.js";
+import { cancellationGraceMs } from "./cancellation.js";
+import { processGroupId, processIdentity, procStartTime } from "./proc_identity.js";
+/** Deliberately a SIBLING of the background registry, never a member of it (C8). `loadMeta`
+ *  (background.ts) accepts any meta.json whose runId matches its directory, so a foreground
+ *  codex record dropped into `agent_runs` would be loadable by `cancelBackgroundRun` and
+ *  killed as if it were a detached background run. */
+export function agentForegroundRoot() {
+    return join(homedir(), ".stratum", "ts", "agent_fg");
+}
+const REGISTRY_ID = /^[0-9a-f]{12}$/;
+const REAL_PROBES = {
+    startTime: procStartTime,
+    groupId: processGroupId,
+    groupState: (pid) => realGroupState(pid),
+    kill: (pid, signal) => { process.kill(-pid, signal); },
+};
+function resolveProbes(options) {
+    return options.probes === undefined ? REAL_PROBES : { ...REAL_PROBES, ...options.probes };
+}
+function resolveRoot(options) {
+    return options.registryRoot ?? process.env.STRATUM_AGENT_FG_ROOT ?? agentForegroundRoot();
+}
+// ── Records ───────────────────────────────────────────────────────────────────
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function metaPath(root, registryId) {
+    if (!REGISTRY_ID.test(registryId))
+        throw new Error(`invalid foreground registry id ${JSON.stringify(registryId)}`);
+    return join(root, registryId, "meta.json");
+}
+async function readMeta(root, registryId) {
+    if (!REGISTRY_ID.test(registryId))
+        return undefined;
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(join(root, registryId, "meta.json"), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(raw) || raw.runId !== registryId || raw.foreground !== true)
+        return undefined;
+    if (raw.agent !== "claude" && raw.agent !== "codex")
+        return undefined;
+    if (!isRecord(raw.flow) || typeof raw.flow.runId !== "string")
+        return undefined;
+    if (!Array.isArray(raw.groups))
+        return undefined;
+    if (raw.state !== "starting" && raw.state !== "running" && raw.state !== "settled")
+        return undefined;
+    return raw;
+}
+/** Writes the `starting` record. Throws on failure — the caller must not proceed to a spawn
+ *  it could not record, which is the uncancellable-orphan hazard `background.ts:191-196`
+ *  already refuses to accept on the durable path. */
+export async function createForegroundRun(meta, options = {}) {
+    const root = resolveRoot(options);
+    const { runId, runDir } = await newRunDir(root);
+    await atomicWriteJson(join(runDir, "meta.json"), { ...meta, runId });
+    return runId;
+}
+/** Appends one spawned group and promotes the record to `running`. Serialised by the caller
+ *  (one promise chain per run), so no lock is needed. Returns what it wrote so the caller can
+ *  check `procStartTime` without re-reading the file (R3-8). Throws on failure. */
+export async function recordForegroundGroup(registryId, pid, options = {}) {
+    const root = resolveRoot(options);
+    const meta = await readMeta(root, registryId);
+    if (!meta)
+        throw Object.assign(new Error(`foreground registry entry ${registryId} is missing or unreadable`), { code: "REGISTRY_WRITE_FAILED" });
+    const startTime = await procStartTime(pid);
+    const group = { childPid: pid, ...(startTime !== undefined ? { procStartTime: startTime } : {}) };
+    const next = { ...meta, state: "running", groups: [...meta.groups, group] };
+    await atomicWriteJson(metaPath(root, registryId), next);
+    return group;
+}
+/** Stamps `settled`. Never deletes the directory: a reader that raced the settle must see a
+ *  stamped record rather than an ENOENT it would have to interpret. */
+export async function settleForegroundRun(registryId, options = {}) {
+    const root = resolveRoot(options);
+    const meta = await readMeta(root, registryId);
+    if (!meta)
+        throw Object.assign(new Error(`foreground registry entry ${registryId} is missing or unreadable`), { code: "REGISTRY_WRITE_FAILED" });
+    if (meta.state === "settled")
+        return;
+    await atomicWriteJson(metaPath(root, registryId), { ...meta, state: "settled", settledAt: new Date().toISOString() });
+}
+// ── Killing ───────────────────────────────────────────────────────────────────
+/** Only ESRCH means dead. EPERM means "exists, not ours" — reported as unreachable, never as
+ *  reaped. The lifecycle test helper's bare catch
+ *  (ts/tests/connectors/background-codex-lifecycle.test.ts:34-41) gets this wrong and must not
+ *  be copied here (invariant 13). */
+function realGroupState(pid) {
+    try {
+        process.kill(-pid, 0);
+        return "alive";
+    }
+    catch (error) {
+        return error.code === "ESRCH" ? "gone" : "unknown";
+    }
+}
+/** Every probe on the signal path is an `await` on another process, and an unbounded one turns
+ *  the caller's absolute deadline into a suggestion (F6). A probe that has not answered by the
+ *  deadline yields no verdict at all — `undefined` — and the caller stops rather than acting on
+ *  an answer nobody is still waiting for. */
+async function bounded(work, deadline) {
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) {
+        void work.catch(() => undefined);
+        return undefined;
+    }
+    let timer;
+    const expiry = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(undefined), remaining);
+        timer.unref?.();
+    });
+    try {
+        return await Promise.race([work.then((value) => ({ value })), expiry]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function identityVerdict(probes, pid, expected, deadline) {
+    if (!expected)
+        return "mismatch";
+    const probed = await bounded(probes.startTime(pid), deadline);
+    if (probed === undefined)
+        return "deadline";
+    return probed.value === expected ? "match" : "mismatch";
+}
+/**
+ * The four gates from `background.ts:444-452`, plus the prior question they never asked.
+ *
+ * TRI-STATE, because "we did not signal it" is two different facts. A group that is already
+ * gone (ESRCH on the group probe) is RESOLVED — the thing we wanted dead is dead — while a
+ * group whose identity does not match, or cannot be read, is UNREACHABLE and can never be
+ * acknowledged. The old boolean collapsed both into `false` and recorded both as unreachable,
+ * so an agent that exited a moment before the cancel arrived permanently blocked the
+ * acknowledgement of a teardown that had already happened.
+ */
+async function signalGroup(probes, pid, expected, deadline) {
+    if (Date.now() >= deadline)
+        return "deadline";
+    if (probes.groupState(pid) === "gone")
+        return "gone";
+    const first = await identityVerdict(probes, pid, expected, deadline);
+    if (first === "deadline")
+        return "deadline";
+    if (first === "mismatch") {
+        // Re-probe: the identity may have failed to read BECAUSE the process exited between the
+        // group probe above and here, which is a `gone`, not an unreachable.
+        return probes.groupState(pid) === "gone" ? "gone" : "unreachable";
+    }
+    const leader = await bounded(probes.groupId(pid), deadline);
+    if (leader === undefined)
+        return "deadline";
+    if (leader.value !== pid)
+        return "unreachable";
+    // Verify the start-time identity a second time immediately before the only signal.
+    const second = await identityVerdict(probes, pid, expected, deadline);
+    if (second === "deadline")
+        return "deadline";
+    // Re-probe, exactly as the FIRST mismatch branch does (F6). An exit between the group-leader
+    // probe and here leaves no readable start time, which reads as a mismatch — so a teardown that
+    // demonstrably completed was reported `unreachable` and could never be acknowledged.
+    if (second === "mismatch")
+        return probes.groupState(pid) === "gone" ? "gone" : "unreachable";
+    // The LAST word before the signal is the clock (F6). A SIGTERM sent after the caller's
+    // deadline has no grace window left to run in and no reap pass left to confirm it: it is a
+    // signal delivered to a child nobody is waiting on.
+    if (Date.now() >= deadline)
+        return "deadline";
+    try {
+        probes.kill(pid, "SIGTERM");
+    }
+    catch (error) {
+        return error.code === "ESRCH" ? "gone" : "unreachable";
+    }
+    return "signalled";
+}
+/**
+ * SIGKILL escalation, through the SAME gates as the SIGTERM — re-run here, immediately before
+ * the signal, never inherited from the earlier pass.
+ *
+ * The escalation used to be a bare `process.kill(-pid, "SIGKILL")` on the recorded number. The
+ * gap between SIGTERM and SIGKILL is the grace window, by construction the longest pause in the
+ * whole teardown, and it is exactly the window in which the group leader exits and its pid is
+ * handed to something else. A kill by pid alone at the end of it is a SIGKILL delivered to a
+ * stranger's process group.
+ */
+async function escalateGroup(probes, pid, expected, deadline) {
+    if (Date.now() >= deadline)
+        return "deadline";
+    if (probes.groupState(pid) === "gone")
+        return "gone";
+    const first = await identityVerdict(probes, pid, expected, deadline);
+    if (first === "deadline")
+        return "deadline";
+    if (first === "mismatch") {
+        return probes.groupState(pid) === "gone" ? "gone" : "unreachable";
+    }
+    const leader = await bounded(probes.groupId(pid), deadline);
+    if (leader === undefined)
+        return "deadline";
+    if (leader.value !== pid)
+        return "unreachable";
+    // F5: the identity is checked AGAIN after the group-leader probe, immediately before the
+    // SIGKILL — never inherited across that await. The whole reason the escalation re-runs the
+    // gates is that a pid can be reissued while they run; a check that stops one await short of
+    // the signal reintroduces exactly the window it was added to close.
+    const second = await identityVerdict(probes, pid, expected, deadline);
+    if (second === "deadline")
+        return "deadline";
+    // Same re-probe as the first branch (F6): the grace window is the longest pause in the whole
+    // teardown, so the leader exiting DURING this second check is the expected case, not an edge.
+    if (second === "mismatch")
+        return probes.groupState(pid) === "gone" ? "gone" : "unreachable";
+    if (Date.now() >= deadline)
+        return "deadline";
+    try {
+        probes.kill(pid, "SIGKILL");
+    }
+    catch (error) {
+        return error.code === "ESRCH" ? "gone" : "unreachable";
+    }
+    return "escalated";
+}
+const REAP_POLL_MS = 10;
+/** SIGTERM → grace → SIGKILL → reap, for ONE group, using its RECORDED identity (R3-8). A
+ *  `process.kill(-pid, …)` without the start-time token is a kill by pid alone, which is the
+ *  recycled-pid hazard the four gates exist to close — so a call with no `startTime` signals
+ *  nothing and reports `unreachable`. */
+export async function killAndReapGroup(pid, options = {}) {
+    const probes = resolveProbes(options);
+    const deadline = resolveDeadline(options);
+    const grace = requireDuration(options.graceMs ?? cancellationGraceMs(), "graceMs");
+    // No recorded identity, a mismatched one, a non-leader or a refused signal: there is no
+    // group we can honestly claim to have killed (invariant 15b). A group already gone is a
+    // different answer entirely, and a resolved one.
+    //
+    // The deadline goes IN (F6). Without it this call could send its SIGTERM after the caller's
+    // budget had already expired, then report a timeout for a signal it had just issued.
+    const signal = await signalGroup(probes, pid, options.startTime, deadline);
+    if (signal === "deadline")
+        return "timeout";
+    if (signal !== "signalled")
+        return signal;
+    // The grace clock starts at OUR SIGTERM, not at the top of the call.
+    const escalateAt = Date.now() + grace;
+    let escalated = false;
+    let last = "alive";
+    while (Date.now() < deadline) {
+        const state = probes.groupState(pid);
+        if (state === "gone")
+            return "reaped";
+        last = state;
+        if (!escalated && Date.now() >= escalateAt) {
+            escalated = true;
+            const result = await escalateGroup(probes, pid, options.startTime, deadline);
+            if (result === "gone")
+                return "reaped";
+            if (result === "unreachable")
+                return "unreachable";
+        }
+        await delay(REAP_POLL_MS);
+    }
+    const final = probes.groupState(pid);
+    if (final === "gone")
+        return "reaped";
+    return final === "unknown" || last === "unknown" ? "unreachable" : "timeout";
+}
+export function cancelTimeoutMs(env = process.env) {
+    const value = Number(env.STRATUM_CANCEL_TIMEOUT_MS ?? 15000);
+    if (!Number.isFinite(value) || value < 0)
+        throw new Error("STRATUM_CANCEL_TIMEOUT_MS must be a nonnegative number");
+    return value;
+}
+/** A caller-supplied budget gets the same treatment as an env one (F6): `Date.now() + NaN` is
+ *  NaN, `Date.now() >= NaN` is false forever, and the reap loop that trusts it never ends. */
+function requireDuration(value, name) {
+    if (!Number.isFinite(value) || value < 0)
+        throw new Error(`${name} must be a nonnegative finite number`);
+    return value;
+}
+/** THE one place a teardown deadline is resolved (F3). `deadlineAt` used to bypass
+ *  `requireDuration` entirely — it is an absolute instant, not a duration, so no validator ever
+ *  saw it — and a NaN one is exactly as fatal: every `Date.now() >= deadline` test against it is
+ *  false, so the reap loop that trusts it runs forever. Every entry point resolves through here,
+ *  so neither shape can reach a loop unvalidated. */
+function resolveDeadline(options) {
+    if (options.deadlineAt === undefined) {
+        return Date.now() + requireDuration(options.timeoutMs ?? cancelTimeoutMs(), "timeoutMs");
+    }
+    if (!Number.isFinite(options.deadlineAt)) {
+        throw new Error("deadlineAt must be a finite epoch-millisecond timestamp");
+    }
+    return options.deadlineAt;
+}
+// ── The sweep ─────────────────────────────────────────────────────────────────
+async function scan(root, flowRunId) {
+    let names;
+    try {
+        names = await readdir(root);
+    }
+    catch (error) {
+        // An empty registry is the normal case: most flows never dispatch a foreground agent.
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const found = [];
+    for (const name of names) {
+        if (!REGISTRY_ID.test(name))
+            continue;
+        const meta = await readMeta(root, name);
+        if (!meta || meta.flow.runId !== flowRunId)
+            continue;
+        found.push({ id: name, meta });
+    }
+    return found;
+}
+function absorb(accumulated, id, meta) {
+    let entry = accumulated.entries.get(id);
+    if (!entry) {
+        entry = {
+            groups: new Map(),
+            state: meta.state,
+            settled: meta.state === "settled",
+            alreadySettled: meta.state === "settled",
+            ...(typeof meta.serverPid === "number" ? { serverPid: meta.serverPid } : {}),
+            ...(typeof meta.serverProcStartTime === "string" ? { serverProcStartTime: meta.serverProcStartTime } : {}),
+        };
+        accumulated.entries.set(id, entry);
+    }
+    entry.state = meta.state;
+    if (meta.state === "settled")
+        entry.settled = true;
+    // Re-read the owner every pass rather than trusting the first observation: the record a
+    // sweep first sees may be a `starting` one whose fields are still being filled in.
+    if (typeof meta.serverPid === "number")
+        entry.serverPid = meta.serverPid;
+    else
+        delete entry.serverPid;
+    if (typeof meta.serverProcStartTime === "string")
+        entry.serverProcStartTime = meta.serverProcStartTime;
+    else
+        delete entry.serverProcStartTime;
+    for (const group of meta.groups) {
+        if (typeof group.childPid !== "number")
+            continue;
+        if (entry.groups.has(group.childPid))
+            continue;
+        entry.groups.set(group.childPid, {
+            ...(group.procStartTime !== undefined ? { startTime: group.procStartTime } : {}),
+            everSignalled: false,
+        });
+    }
+    return entry;
+}
+/** Steps 1-2 of §2.4: enumerate the flow's unsettled entries and send each recorded group its
+ *  one SIGTERM, through the four identity gates. The bookkeeping it returns is carried into
+ *  `reapFlowAgents` so nothing is double-counted across the rescan passes. */
+export async function signalFlowAgents(flowRunId, options = {}) {
+    const accumulated = { entries: new Map() };
+    // The SIGNAL pass shares the caller's one absolute deadline (R3-5). Without it a slow scan
+    // can hand the reap a budget that is already spent, and — worse — keep sending SIGTERMs
+    // after the caller has given up waiting for anything to answer them.
+    await sweepPass(resolveRoot(options), flowRunId, accumulated, {
+        escalate: false,
+        deadline: resolveDeadline(options),
+        graceMs: requireDuration(options.graceMs ?? cancellationGraceMs(), "graceMs"),
+        probes: resolveProbes(options),
+    });
+    return accumulated;
+}
+async function sweepPass(root, flowRunId, accumulated, options) {
+    const { probes } = options;
+    for (const { id, meta } of await scan(root, flowRunId)) {
+        const entry = absorb(accumulated, id, meta);
+        for (const [pid, group] of entry.groups) {
+            if (group.outcome === "reaped" || group.outcome === "gone" || group.outcome === "unreachable")
+                continue;
+            // A settled entry is never SIGNALLED again (invariant 14) — but its already-signalled
+            // groups are still PROBED below. Skipping a settled entry outright leaves the probe
+            // taken during the signal pass as the final verdict, and that probe is `unknown` for
+            // the whole window in which the leader is dead but not yet reaped by its parent — so
+            // an agent whose teardown demonstrably completed would be reported `unreachable` and
+            // could never be acknowledged.
+            if (entry.settled && !group.everSignalled)
+                continue;
+            if (!group.everSignalled) {
+                // Past the deadline nothing new is signalled: a SIGTERM sent now has no grace window
+                // left to run in and no reap pass left to confirm it. The group stays unresolved and
+                // is reported as such, which is the honest answer.
+                if (Date.now() >= options.deadline)
+                    continue;
+                const signal = await signalGroup(probes, pid, group.startTime, options.deadline);
+                // The deadline expired inside the gates: no signal was sent, so the group is left
+                // unresolved and reported as such rather than given a verdict nobody probed for.
+                if (signal === "deadline")
+                    continue;
+                if (signal === "gone") {
+                    group.outcome = "gone";
+                    delete group.lastProbe;
+                    continue;
+                }
+                if (signal === "unreachable") {
+                    // An identity mismatch means the pid is now some other process: the group we
+                    // recorded is gone too, but we never signalled it, and we cannot prove which — so
+                    // it is `unreachable`, not `gone`. Collapsing the two would let a recycled pid read
+                    // as a teardown.
+                    group.outcome = "unreachable";
+                    continue;
+                }
+                group.everSignalled = true;
+                group.outcome = "signalled";
+                // Per-group grace, clocked from THIS SIGTERM (F5).
+                group.escalateAt = Date.now() + options.graceMs;
+            }
+            const state = probes.groupState(pid);
+            if (state === "gone") {
+                group.outcome = "reaped";
+                delete group.lastProbe;
+                continue;
+            }
+            group.lastProbe = state;
+            const escalateAt = group.escalateAt ?? options.deadline;
+            if (options.escalate && !entry.settled && Date.now() >= escalateAt && Date.now() < options.deadline) {
+                // F6: the identity and group-leader gates are re-run here, immediately before the
+                // SIGKILL. The grace window is long enough for the leader to exit and its pid to be
+                // reissued, and a kill by bare pgid at the end of it lands on a stranger.
+                const result = await escalateGroup(probes, pid, group.startTime, options.deadline);
+                if (result === "deadline")
+                    continue;
+                if (result === "gone") {
+                    group.outcome = "reaped";
+                    delete group.lastProbe;
+                    continue;
+                }
+                if (result === "unreachable") {
+                    group.outcome = "unreachable";
+                    delete group.lastProbe;
+                }
+            }
+        }
+    }
+}
+function resolvedOutcome(outcome) {
+    return outcome === "reaped" || outcome === "gone" || outcome === "unreachable";
+}
+function entryResolved(entry) {
+    // Multi-group Claude entries (C9) follow the same rule: every pid must be resolved.
+    for (const group of entry.groups.values()) {
+        // A group this sweep never signalled belongs to an entry that was already settled when we
+        // arrived: it is not ours to tear down and never blocks resolution. A group we DID signal
+        // blocks it until the probe answers, settled entry or not — the entry settling says the
+        // dispatcher unwound, not that the process group is gone.
+        if (entry.settled && !group.everSignalled)
+            continue;
+        if (!resolvedOutcome(group.outcome))
+            return false;
+    }
+    // Reaping the groups is not the same as the entry being over, and `summarise` says so:
+    // it counts every unsettled entry as `unsettled` whatever its groups did (R3-6). Breaking
+    // the poll here would stop watching an entry the owning dispatcher is still unwinding and
+    // then report that as a teardown failure — so an unsettled entry keeps the poll alive until
+    // it settles or the deadline answers for it.
+    return entry.settled;
+}
+/** Steps 3-5 of §2.4: grace, escalation, reap and rescan, all under ONE absolute deadline.
+ *  The loop re-reads the directory rather than trusting one snapshot, because an entry can
+ *  move `starting → running` while the sweep is in progress. */
+export async function reapFlowAgents(flowRunId, signalled, options = {}) {
+    const root = resolveRoot(options);
+    const deadline = resolveDeadline(options);
+    const graceMs = requireDuration(options.graceMs ?? cancellationGraceMs(), "graceMs");
+    const identity = options.identity ?? processIdentity;
+    const probes = resolveProbes(options);
+    while (true) {
+        // `escalate: true` unconditionally: each group carries its OWN escalation instant now, so
+        // the pass decides per group rather than off one clock that started before some of them
+        // had even been signalled.
+        await sweepPass(root, flowRunId, signalled, { escalate: true, deadline, graceMs, probes });
+        await applyDeadOwnerException(root, signalled, identity, deadline);
+        if ([...signalled.entries.values()].every(entryResolved))
+            break;
+        if (Date.now() >= deadline)
+            break;
+        await delay(REAP_POLL_MS);
+    }
+    // At the deadline a standing `unknown` is the final answer: EPERM means "exists, not ours",
+    // which is never a reap and never a licence to acknowledge (invariant 13).
+    for (const entry of signalled.entries.values()) {
+        for (const group of entry.groups.values()) {
+            if (group.outcome === "signalled" && group.lastProbe === "unknown")
+                group.outcome = "unreachable";
+        }
+    }
+    return summarise(signalled);
+}
+/** Convenience for callers that do not need to interleave a local teardown between the two
+ *  phases (S03 does; the CLI and the tests mostly do not). */
+export async function cancelFlowAgents(flowRunId, options = {}) {
+    // ONE deadline, resolved here and handed to BOTH phases (F7). Passing `options` through gave
+    // each phase its own `timeoutMs` budget, so a slow signal pass did not eat into the reap's
+    // time — it doubled the total, and a caller that configured 15s could wait 30.
+    const shared = { ...options, deadlineAt: resolveDeadline(options) };
+    return reapFlowAgents(flowRunId, await signalFlowAgents(flowRunId, shared), shared);
+}
+/** The sweep stamps `settled` itself ONLY when the owning server is PROVABLY dead and every
+ *  recorded group is resolved (R3-6, R4-3). A pid-only check would read a recycled pid as "the
+ *  server is gone" and stamp a live dispatcher's entry settled, so the owner's start time is
+ *  required — an entry written without `serverProcStartTime` is never eligible. And the probe
+ *  is the TRI-STATE one: `unknown` (EPERM, or a start time we could not read) is never a
+ *  licence to reclaim another process's record. */
+async function applyDeadOwnerException(root, accumulated, identity, deadline) {
+    for (const [id, entry] of accumulated.entries) {
+        if (entry.settled || entry.state === "starting")
+            continue;
+        if (entry.serverPid === undefined || entry.serverProcStartTime === undefined)
+            continue;
+        if (entry.groups.size === 0)
+            continue;
+        let resolved = true;
+        for (const group of entry.groups.values()) {
+            if (!resolvedOutcome(group.outcome)) {
+                resolved = false;
+                break;
+            }
+        }
+        if (!resolved)
+            continue;
+        // Bounded like every other probe on this path (F6): the owner probe is a shell-out on
+        // darwin, and an unbounded one lets a single slow answer run the reap loop past the
+        // caller's deadline.
+        const owner = await bounded(identity(entry.serverPid, entry.serverProcStartTime), deadline);
+        if (owner === undefined || owner.value !== "dead")
+            continue;
+        try {
+            await settleForegroundRun(id, { registryRoot: root });
+            entry.settled = true;
+        }
+        catch { /* a stale entry is reported as unsettled rather than claimed */ }
+    }
+}
+function summarise(accumulated) {
+    const summary = { signalled: 0, reaped: 0, gone: 0, unreachable: 0, alreadySettled: 0, unresolved: 0, unsettled: 0, unreaped: 0 };
+    for (const entry of accumulated.entries.values()) {
+        if (entry.alreadySettled) {
+            summary.alreadySettled += 1;
+            continue;
+        }
+        for (const group of entry.groups.values()) {
+            // F7: the SAME exclusion `sweepPass` and `entryResolved` already apply. A group belonging
+            // to an entry that settled before we signalled it is not ours to tear down — the sweep
+            // deliberately never signals it and `entryResolved` deliberately ignores it — so counting
+            // its absent outcome as `unreaped` here contradicted both and turned an entry that went
+            // `starting → settled` mid-sweep into a teardown timeout for a group nobody touched.
+            //
+            // ONLY the outcome-less ones. A group that was probed and found `gone` on a settled entry
+            // is a real, reported verdict; dropping it too would hide the very counter that lets a
+            // flow whose agent exited on its own be acknowledged.
+            if (entry.settled && !group.everSignalled && group.outcome === undefined)
+                continue;
+            if (group.everSignalled)
+                summary.signalled += 1;
+            if (group.outcome === "reaped")
+                summary.reaped += 1;
+            else if (group.outcome === "gone")
+                summary.gone += 1;
+            else if (group.outcome === "unreachable")
+                summary.unreachable += 1;
+            else
+                summary.unreaped += 1;
+        }
+        if (entry.state === "starting" && !entry.settled)
+            summary.unresolved += 1;
+        if (!entry.settled)
+            summary.unsettled += 1;
+    }
+    return summary;
+}
+//# sourceMappingURL=foreground_registry.js.map

package/dist/connectors/foreground_registry.js.map

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

package/dist/connectors/index.js

@@ -2,6 +2,7 @@ export * from "./background.js";
 export * from "./base.js";
 export * from "./claude.js";
 export * from "./codex.js";
+export * from "./foreground_registry.js";
 export * from "./proc_identity.js";
 export * from "./runner.js";
 //# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}