sensorium-mcp 3.1.2 → 3.1.3-board.10

package/dist/server/port-holder.js

@@ -0,0 +1,122 @@
+/**
+ * The port holder's end of life (inc68). "The HTTP port is the lock" (inc66 M1):
+ * the exit watcher, the background runner, the keeper, the board orchestrator and the keepAlive
+ * spawn run only in the process that bound the port. This module is what makes
+ * that process let go cleanly, on both of its exits — a signal shutdown and a
+ * legacy self-update hand-over:
+ *
+ *  - {@link PortHolderJobs} starts every port-holder job through ONE gate, and
+ *    {@link PortHolderJobs.release} closes it for good. A start that arrives late
+ *    (after the port was handed over) starts nothing, so the old process cannot
+ *    run a second nightly purge or a second keeper next to the new holder.
+ *  - {@link createPortHolderStop} is the one stop step both exits run: close
+ *    the gate, stop the exit watcher, the runner, the keeper and the board orchestrator, and
+ *    settle once the board tick and the nightly pass in flight are done. A
+ *    keepAlive spawn already running is fire-and-forget and is NOT waited for
+ *    (pre-existing, carded).
+ *  - {@link createShutdown} finishes that in-flight work (a board tick
+ *    mid-spawn, a nightly pass mid-purge) before the teardown frees the port,
+ *    with a bounded wait.
+ */
+/** How long a signal shutdown waits for in-flight port-holder work before it
+ *  frees the port anyway. A board tick can be mid-spawn, and the broker gives a
+ *  spawn 30 s (SPAWN_TIMEOUT_MS in broker-client.ts), so ONE healthy spawn
+ *  settles inside this bound and gets bound to its card. A tick dispatches up
+ *  to globalCap cards one after another, though, so a multi-card tick can be
+ *  cut after its first spawn — that residual is accepted: the next holder's
+ *  reconcile deals with it, a longer Ctrl+C hang would be worse, and the Unix
+ *  supervisor SIGKILLs after 5 s regardless. A nightly pass that outlasts the
+ *  bound is cut the same way and dies with this process. Cutting the wait is
+ *  logged. */
+export const SHUTDOWN_DRAIN_BOUND_MS = 30_000;
+/** One start gate for every job that may run only in the port holder. */
+export class PortHolderJobs {
+    jobs;
+    log;
+    released = false;
+    constructor(jobs, log) {
+        this.jobs = jobs;
+        this.log = log;
+    }
+    /** Start every job, unless the port has already been released. Checked once,
+     *  here, so a job added to the list later is covered without its own latch. */
+    startAll() {
+        if (this.released) {
+            this.log.info("[startup] port already released — port-holder jobs not started");
+            return;
+        }
+        for (const job of this.jobs)
+            job.start();
+    }
+    /** The process is giving the port up (shutdown or hand-over). End-of-life: a
+     *  later startAll() is ignored. Stopping jobs that already run stays with the
+     *  caller, which knows what each one has to finish. */
+    release() {
+        this.released = true;
+    }
+}
+/**
+ * Build the step both ways of giving the port up run (the signal drain and the
+ * self-update hand-over), so neither can skip a job it stops. It closes the
+ * gate, stops the exit watcher, the runner and the keeper (the keeper would otherwise respawn a
+ * thread that exits during the wait), and stops the board — all synchronously,
+ * on the call. Its promise settles once the work in flight has finished: the
+ * board tick (a spawn bound to its card) and the nightly pass (the next holder
+ * starts its own runner, and two purges must not share a thread — inc66 M1).
+ * Each caller awaits it before it frees the port.
+ *
+ * Not every job: a keepAlive spawn already running is fire-and-forget and is
+ * not awaited here — a residual that predates inc68 and is carded.
+ */
+export function createPortHolderStop(deps) {
+    return async () => {
+        deps.gate.release();
+        deps.exitWatcher.stop();
+        deps.backgroundRunner.stop();
+        deps.keeper.stop();
+        await Promise.all([
+            deps.boardOrchestrator.stop(),
+            deps.dailyRotationSettled(),
+            deps.exitWatcher.settled(),
+        ]);
+    };
+}
+/**
+ * Build the signal-shutdown sequence: wait for every drain (bounded by
+ * `boundMs`), then run `teardown`, which frees the port and exits. Returns a
+ * function that runs the sequence ONCE — a second signal while it runs is a
+ * no-op, so each drain is started exactly once.
+ */
+export function createShutdown(deps) {
+    let started = false;
+    return async (reason) => {
+        if (started)
+            return;
+        started = true;
+        deps.log.info(`[shutdown] Graceful shutdown initiated (${reason})…`);
+        await drainWithin(deps.drains, deps.boundMs, deps.log);
+        await deps.teardown();
+    };
+}
+async function drainWithin(drains, boundMs, log) {
+    const settled = await new Promise((resolve) => {
+        const bound = setTimeout(() => resolve(false), boundMs);
+        // Each drain is invoked inside a promise, so one that throws synchronously
+        // settles as a rejection instead of escaping — and allSettled never rejects:
+        // a drain that fails must not keep the teardown from running.
+        const outcomes = drains.map((drain) => Promise.resolve().then(drain));
+        void Promise.allSettled(outcomes).then((results) => {
+            clearTimeout(bound);
+            for (const result of results) {
+                if (result.status === "rejected") {
+                    log.warn(`[shutdown] a drain failed: ${result.reason} — tearing down anyway`);
+                }
+            }
+            resolve(true);
+        });
+    });
+    if (!settled) {
+        log.warn(`[shutdown] in-flight work did not settle within ${boundMs} ms — freeing the port anyway`);
+    }
+}
+//# sourceMappingURL=port-holder.js.map

package/dist/server/port-holder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-holder.js","sourceRoot":"","sources":["../../src/server/port-holder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;cASc;AACd,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAe9C,yEAAyE;AACzE,MAAM,OAAO,cAAc;IAIN;IACA;IAJX,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,IAA8B,EAC9B,GAAgB;QADhB,SAAI,GAAJ,IAAI,CAA0B;QAC9B,QAAG,GAAH,GAAG,CAAa;IAChC,CAAC;IAEJ;mFAC+E;IAC/E,QAAQ;QACN,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED;;2DAEuD;IACvD,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAOpC;IACC,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE;YAC7B,IAAI,CAAC,oBAAoB,EAAE;YAC3B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAK9B;IACC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,2CAA2C,MAAM,IAAI,CAAC,CAAC;QACrE,MAAM,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAA0C,EAC1C,OAAe,EACf,GAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACrD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACxD,2EAA2E;QAC3E,6EAA6E;QAC7E,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,KAAK,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACjD,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBACjC,GAAG,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,MAAM,wBAAwB,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,mDAAmD,OAAO,+BAA+B,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/services/agent-spawn.service.d.ts

@@ -7,6 +7,7 @@
  * importers keep a single entry point.
  */
 import { type AgentType } from "../config/index.js";
+import { type ThreadRegistryEntry } from "../data/memory/thread-registry.js";
 import { type Database } from "../data/memory/schema.js";
 import { type ThreadLifecycleService } from "./thread-lifecycle.service.js";
 import { type SpawnResult } from "./spawn-common.js";
@@ -17,12 +18,56 @@ export { resolveCodexPath, spawnCodexProcess } from "./codex-spawn.service.js";
  * Resolve the right spawn function for `agentType` and call it.
  * Handles CLI path resolution and error reporting internally.
  *
- * When `db` is provided and the thread is in `Created` state, transitions
- * Created → Spawning before the process starts, then Spawning → Active on
- * success. This implements the explicit state machine for newly registered
- * threads without affecting existing restart flows (Exited/Active → Active).
+ * The one place a process is born, and therefore the one place the worker single-use
+ * rule is stated: {@link claimWorkerBirth} runs FIRST, above the state machine and
+ * above every CLI resolution, so a refused birth transitions nothing and starts
+ * nothing. It is a CLAIM and not a question — admitting a worker spends its one launch
+ * window — so this call happens exactly once per dispatch, and a caller that merely
+ * wants to know whether a birth is possible must not route through here. Read
+ * `worker-single-use.ts` before adding a caller — it names the re-exported per-agent
+ * spawn functions as forbidden entry points, because they would bypass this.
+ *
+ * `db` is REQUIRED, which is why the three trailing optionals moved into `opts` with
+ * it: TypeScript cannot put a required parameter after an optional one, so leaving
+ * `opts` eighth would have meant a default — and a refusal that fails open on an
+ * absent handle reopens the hole at the three call sites that used to omit it. Every
+ * caller holds a handle already. Requiring it also makes the two state transitions
+ * below unconditional: the silent no-state-transition mode this function used to have
+ * is gone.
+ *
+ * A thread in `Created` state transitions Created → Spawning before the process
+ * starts, then Spawning → Active on success. This implements the explicit state
+ * machine for newly registered threads without affecting existing restart flows
+ * (Exited/Active → Active).
+ */
+export interface SpawnDispatch {
+    db: Database;
+    workingDirectory?: string;
+    memorySourceThreadId?: number;
+    runtimeThreadType?: "worker" | "branch";
+    modelOverride?: string;
+    /**
+     * The ONE exception to the single-use rule: the born-dead net relaunching a process
+     * that died before it ever read its task. Set at exactly one call site
+     * (`runBirthDeathNet`), and AUDITED rather than trusted — see
+     * `worker-single-use.ts`, which re-derives the net's verdict from state this flag
+     * cannot forge.
+     */
+    relaunchBornDead?: boolean;
+}
+export declare function dispatchSpawn(agentType: AgentType, name: string, threadId: number, threadLifecycle: ThreadLifecycleService, opts: SpawnDispatch): Promise<SpawnResult>;
+/**
+ * Whether boot may put a process back on this thread's id.
+ *
+ * `type !== 'worker'` is the term the keeper's own SQL already carries
+ * (getKeepAliveThreads, thread-registry.ts:256-263) and this filter lacked. A worker
+ * is single-use, so boot must never respawn one on its old id — however its
+ * keep_alive flag came to be set.
+ *
+ * Extracted so the rule is reachable without starting processes; the call site is
+ * the single `filter` in spawnKeepAliveThreads below.
  */
-export declare function dispatchSpawn(agentType: AgentType, name: string, threadId: number, threadLifecycle: ThreadLifecycleService, workingDirectory?: string, memorySourceThreadId?: number, runtimeThreadType?: "worker" | "branch", db?: Database): Promise<SpawnResult>;
+export declare function isKeepAliveSpawnCandidate(thread: ThreadRegistryEntry): boolean;
 export declare function spawnKeepAliveThreads(threadLifecycle: ThreadLifecycleService): Promise<{
     spawned: number;
     errors: string[];

package/dist/services/agent-spawn.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-spawn.service.d.ts","sourceRoot":"","sources":["../../src/services/agent-spawn.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGjF,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKvE,OAAO,EAAe,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKlF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,sBAAsB,EACvC,gBAAgB,CAAC,EAAE,MAAM,EACzB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,iBAAiB,CAAC,EAAE,QAAQ,GAAG,QAAQ,EACvC,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,CAsFtB;AAED,wBAAsB,qBAAqB,CAAC,eAAe,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAgFD"}
+{"version":3,"file":"agent-spawn.service.d.ts","sourceRoot":"","sources":["../../src/services/agent-spawn.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKvE,OAAO,EAAe,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMlF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,sBAAsB,EACvC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAoGtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAM9E;AAED,wBAAsB,qBAAqB,CAAC,eAAe,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAgED"}

package/dist/services/agent-spawn.service.js

@@ -6,32 +6,29 @@
  * The per-agent CLI resolvers and spawn functions are re-exported so existing
  * importers keep a single entry point.
  */
-import { unlinkSync } from "node:fs";
 import { getAgentType, getFableModel } from "../config/index.js";
 import { log } from "../lib/logger.js";
 import { getAllThreads } from "../data/memory/thread-registry.js";
 import { initMemoryDb } from "../data/memory/schema.js";
 import { errorMessage } from "../lib/utils.js";
-import { ensureDirs, isThreadAlive, readPidFiles, spawnedThreads } from "./process.service.js";
+import { ensureDirs, isThreadAlive, readPidFiles } from "./process.service.js";
 import { brokerAdopt } from "./broker-client.js";
 import { ThreadState } from "./thread-lifecycle.service.js";
 import { setStartupCleanupInProgress } from "./spawn-common.js";
 import { resolveClaudePath, spawnAgentProcess } from "./claude-spawn.service.js";
 import { resolveCopilotPath, spawnCopilotProcess } from "./copilot-spawn.service.js";
 import { resolveCodexPath, spawnCodexProcess } from "./codex-spawn.service.js";
+import { claimWorkerBirth } from "./worker-single-use.js";
 export { resolveClaudePath, spawnAgentProcess } from "./claude-spawn.service.js";
 export { resolveCopilotPath, spawnCopilotProcess } from "./copilot-spawn.service.js";
 export { resolveCodexPath, spawnCodexProcess } from "./codex-spawn.service.js";
-/**
- * Resolve the right spawn function for `agentType` and call it.
- * Handles CLI path resolution and error reporting internally.
- *
- * When `db` is provided and the thread is in `Created` state, transitions
- * Created → Spawning before the process starts, then Spawning → Active on
- * success. This implements the explicit state machine for newly registered
- * threads without affecting existing restart flows (Exited/Active → Active).
- */
-export async function dispatchSpawn(agentType, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType, db) {
+export async function dispatchSpawn(agentType, name, threadId, threadLifecycle, opts) {
+    const { db, workingDirectory, memorySourceThreadId, runtimeThreadType, modelOverride, relaunchBornDead = false, } = opts;
+    const refusal = claimWorkerBirth(db, threadId, relaunchBornDead);
+    if (refusal.has()) {
+        log.warn(`[spawn] refusing to start a process on thread ${threadId}: ${refusal.get()}`);
+        return { error: refusal.get() };
+    }
     // Legacy agent types (copilot_claude / copilot_codex) were removed, but threads
     // persisted before the removal may still carry them. Without this, they fall
     // through to the Claude branch below and get relaunched as a different agent on
@@ -41,52 +38,66 @@ export async function dispatchSpawn(agentType, name, threadId, threadLifecycle,
         agentType = "copilot";
     }
     // Created → Spawning when a pre-registered thread is about to start
-    if (db) {
-        const currentState = threadLifecycle.getThreadState(db, threadId);
-        if (currentState === ThreadState.Created) {
-            try {
-                threadLifecycle.transitionThread(db, threadId, ThreadState.Spawning);
-            }
-            catch (err) {
-                log.warn(`[start_thread] Created→Spawning transition failed for ${threadId}: ${errorMessage(err)}`);
-            }
+    const currentState = threadLifecycle.getThreadState(db, threadId);
+    if (currentState === ThreadState.Created) {
+        try {
+            threadLifecycle.transitionThread(db, threadId, ThreadState.Spawning);
+        }
+        catch (err) {
+            log.warn(`[start_thread] Created→Spawning transition failed for ${threadId}: ${errorMessage(err)}`);
         }
     }
     let result;
+    const trimmedModelOverride = modelOverride?.trim() || undefined;
     if (agentType === "copilot") {
         const cliPath = resolveCopilotPath();
         result = cliPath
-            ? await spawnCopilotProcess(cliPath, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType)
+            ? await spawnCopilotProcess(cliPath, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType, trimmedModelOverride)
             : { error: `Thread ${threadId} (${name}): copilot CLI not found` };
     }
     else if (agentType === "codex" || agentType === "openai_codex") {
         const cliPath = resolveCodexPath();
         result = cliPath
-            ? await spawnCodexProcess(cliPath, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType)
+            ? await spawnCodexProcess(cliPath, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType, trimmedModelOverride)
             : { error: `Thread ${threadId} (${name}): codex CLI not found` };
     }
     else {
         // "fable" is a Claude-CLI thread pinned to a distinct (premium) model.
         const cliPath = resolveClaudePath();
-        const modelOverride = agentType === "fable" ? getFableModel() : undefined;
+        // Fable is intentionally pinned to its configured premium model; card-level
+        // overrides apply only to ordinary Claude workers.
+        const providerModelOverride = agentType === "fable" ? getFableModel() : trimmedModelOverride;
         result = cliPath
-            ? await spawnAgentProcess(cliPath, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType, modelOverride)
+            ? await spawnAgentProcess(cliPath, name, threadId, threadLifecycle, workingDirectory, memorySourceThreadId, runtimeThreadType, providerModelOverride)
             : { error: `Thread ${threadId} (${name}): claude CLI not found` };
     }
     // Spawning → Active on successful process start
-    if (db && "pid" in result) {
-        const currentState = threadLifecycle.getThreadState(db, threadId);
-        if (currentState === ThreadState.Spawning) {
-            try {
-                threadLifecycle.transitionThread(db, threadId, ThreadState.Active);
-            }
-            catch (err) {
-                log.warn(`[start_thread] Spawning→Active transition failed for ${threadId}: ${errorMessage(err)}`);
-            }
+    if ("pid" in result && threadLifecycle.getThreadState(db, threadId) === ThreadState.Spawning) {
+        try {
+            threadLifecycle.transitionThread(db, threadId, ThreadState.Active);
+        }
+        catch (err) {
+            log.warn(`[start_thread] Spawning→Active transition failed for ${threadId}: ${errorMessage(err)}`);
         }
     }
     return result;
 }
+/**
+ * Whether boot may put a process back on this thread's id.
+ *
+ * `type !== 'worker'` is the term the keeper's own SQL already carries
+ * (getKeepAliveThreads, thread-registry.ts:256-263) and this filter lacked. A worker
+ * is single-use, so boot must never respawn one on its old id — however its
+ * keep_alive flag came to be set.
+ *
+ * Extracted so the rule is reachable without starting processes; the call site is
+ * the single `filter` in spawnKeepAliveThreads below.
+ */
+export function isKeepAliveSpawnCandidate(thread) {
+    return (thread.keepAlive &&
+        thread.type !== "worker" &&
+        (thread.status === "active" || thread.status === "exited"));
+}
 export async function spawnKeepAliveThreads(threadLifecycle) {
     const result = { spawned: 0, errors: [] };
     setStartupCleanupInProgress(true);
@@ -100,39 +111,22 @@ export async function spawnKeepAliveThreads(threadLifecycle) {
     }
     let threads;
     try {
-        for (const { pid, filePath, threadId, name, threadType, startedAt } of readPidFiles()) {
-            if (spawnedThreads.some((t) => t.threadId === threadId))
-                continue;
+        for (const pidEntry of await readPidFiles()) {
+            const { pid, threadId, threadType, startedAt } = pidEntry;
             // THREAD-scoped (mirror reconcileState): a keepAlive agent that survived a
             // server self-update has a dead launcher pid but a live forked child in its
-            // job. A pid-first isProcessAlive() would read it dead and unlink its pid file
-            // — destroying the reconcile anchor AND skipping brokerAdopt — then the loop
-            // below would spawn a duplicate. Treat-alive on unreachable; known:false falls
-            // back to the pid check (dev mode / pre-broker process).
+            // job. A pid-first isProcessAlive() would read it dead and skip brokerAdopt.
+            // Treat-alive on unreachable; known:false falls back to the pid check (dev
+            // mode / pre-broker process). A dead one's PID file is left to the exit
+            // watcher, which resolves it through the exit path with its exit code.
             if (await isThreadAlive(threadId, pid, startedAt)) {
-                spawnedThreads.push({
-                    pid,
-                    threadId,
-                    name: name ?? `thread-${threadId}`,
-                    startedAt: startedAt ?? Date.now(),
-                    createdAt: startedAt ?? Date.now(),
-                    logFile: "",
-                    ...(threadType ? { threadType } : {}),
-                });
                 // Safe cutover (Phase 3): a process that predates broker-owned spawning
                 // is invisible to jobs/registry — ask the broker to adopt it now instead
                 // of waiting for the next supervisor restart. Idempotent; best-effort.
                 void brokerAdopt(threadId, pid, startedAt, threadType ?? "agent");
             }
-            else
-                try {
-                    unlinkSync(filePath);
-                }
-                catch {
-                    /* stale PID file locked or already gone */
-                }
         }
-        threads = getAllThreads(db).filter((thread) => thread.keepAlive && (thread.status === "active" || thread.status === "exited"));
+        threads = getAllThreads(db).filter(isKeepAliveSpawnCandidate);
     }
     finally {
         setStartupCleanupInProgress(false);
@@ -143,17 +137,16 @@ export async function spawnKeepAliveThreads(threadLifecycle) {
     for (const thread of threads) {
         // THREAD-scoped: findAliveThread is pid-first and would re-declare a surviving
         // keepAlive agent (dead launcher pid) dead, re-spawning a duplicate onto the
-        // live thread every boot. Source the anchor pid from the pid file / in-memory
-        // entry and ask the broker by threadId; treat-alive on unreachable so we never
+        // live thread every boot. Source the anchor pid from the pid file and ask the broker by threadId; treat-alive on unreachable so we never
         // duplicate-spawn on unknown (broker spawn idempotency remains the backstop).
-        const alivePidEntry = readPidFiles().find((e) => e.threadId === thread.threadId);
-        const aliveInMem = spawnedThreads.find((t) => t.threadId === thread.threadId);
-        const aliveFallbackPid = alivePidEntry?.pid ?? aliveInMem?.pid;
-        const aliveStartedAt = alivePidEntry?.startedAt ?? aliveInMem?.startedAt;
-        if (await isThreadAlive(thread.threadId, aliveFallbackPid, aliveStartedAt))
+        const alivePidEntry = (await readPidFiles()).find((e) => e.threadId === thread.threadId);
+        if (await isThreadAlive(thread.threadId, alivePidEntry?.pid, alivePidEntry?.startedAt))
             continue;
         const client = thread.client ?? getAgentType();
-        const spawnResult = await dispatchSpawn(client, thread.name, thread.threadId, threadLifecycle, thread.workingDirectory ?? undefined);
+        const spawnResult = await dispatchSpawn(client, thread.name, thread.threadId, threadLifecycle, {
+            db,
+            ...(thread.workingDirectory ? { workingDirectory: thread.workingDirectory } : {}),
+        });
         if ("error" in spawnResult) {
             result.errors.push(spawnResult.error);
             continue;

package/dist/services/agent-spawn.service.js.map

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

package/dist/services/background-runner.d.ts

@@ -20,7 +20,6 @@ export declare class BackgroundJobRunner {
     start(): void;
     stop(): void;
     private runWorkerCleanup;
-    private runDeadWorkerSweep;
     private runDailyRotationCheck;
 }
 export {};

package/dist/services/background-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-runner.d.ts","sourceRoot":"","sources":["../../src/services/background-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAW5E,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACnD,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,sBAAsB,CAAC;IACxC,GAAG,EAAE;QACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;CACH;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,oBAAoB,CAAuB;gBAEtB,IAAI,EAAE,oBAAoB;IAEvD,KAAK,IAAI,IAAI;IA0Bb,IAAI,IAAI,IAAI;YAOE,gBAAgB;YAuBhB,kBAAkB;YA0DlB,qBAAqB;CAqCpC"}
+{"version":3,"file":"background-runner.d.ts","sourceRoot":"","sources":["../../src/services/background-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAQ5E,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACnD,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,sBAAsB,CAAC;IACxC,GAAG,EAAE;QACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;CACH;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,oBAAoB,CAAuB;gBAEtB,IAAI,EAAE,oBAAoB;IAEvD,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,IAAI;YAOE,gBAAgB;YAuBhB,qBAAqB;CAqCpC"}

package/dist/services/background-runner.js

@@ -1,9 +1,6 @@
 import { rotateAllDailySessions } from "./daily-session.js";
 import { cleanupExpiredWorkers } from "./worker-cleanup.service.js";
 import { errorMessage } from "../lib/utils.js";
-import { getAllThreads } from "../data/memory/thread-registry.js";
-import { isThreadAlive, readPidFiles, spawnedThreads } from "./process.service.js";
-import { decommissionWorker } from "./worker-cleanup.service.js";
 import { hasRunToday } from "../data/daily-marker.js";
 const DAILY_ROTATION_INTERVAL_MS = 5 * 60_000;
 const DAILY_ROTATION_HOUR = 4;
@@ -20,16 +17,12 @@ export class BackgroundJobRunner {
             return;
         void this.runWorkerCleanup();
         void this.runDailyRotationCheck();
-        void this.runDeadWorkerSweep();
         this.intervals.push(setInterval(() => {
             void this.runWorkerCleanup();
         }, WORKER_CLEANUP_INTERVAL_MS));
         this.intervals.push(setInterval(() => {
             void this.runDailyRotationCheck();
         }, DAILY_ROTATION_INTERVAL_MS));
-        this.intervals.push(setInterval(() => {
-            void this.runDeadWorkerSweep();
-        }, WORKER_CLEANUP_INTERVAL_MS));
     }
     stop() {
         for (const interval of this.intervals) {
@@ -55,57 +48,6 @@ export class BackgroundJobRunner {
         // Phase 2). Its replacement is job-membership reconciliation in the broker
         // once Phase 3 spawns agents into named job objects.
     }
-    async runDeadWorkerSweep() {
-        try {
-            const db = this.deps.getMemoryDb();
-            const workers = getAllThreads(db).filter((t) => t.type === "worker" && (t.status === "active" || t.status === "exited"));
-            const pidEntries = readPidFiles();
-            for (const w of workers) {
-                // THREAD-scoped liveness (mirror cleanupExpiredWorkers): a broker-spawned
-                // worker's launcher pid reads dead ~20s after spawn while its forked child
-                // lives on in the job. A pid-first isThreadRunning()/findAliveThread here
-                // would BOTH mis-declare that live worker dead AND splice it out of
-                // spawnedThreads — so the inMemory branch below would fall through to a full
-                // decommissionWorker (job-kill + topic delete + note/DB archive) of a running
-                // worker every sweep. Source the fallback pid + startedAt exactly where
-                // cleanupExpiredWorkers does, then ask the broker by threadId; the broker's
-                // job/registry verdict (or treat-alive-on-unreachable) gates the sweep, and
-                // isThreadAlive never mutates spawnedThreads so the inMemory branch stays
-                // correct for a genuinely-dead worker still tracked in memory.
-                const pidEntry = pidEntries.find((e) => e.threadId === w.threadId);
-                const inMemEntry = spawnedThreads.find((t) => t.threadId === w.threadId);
-                const fallbackPid = pidEntry?.pid ?? inMemEntry?.pid;
-                const startedAt = pidEntry?.startedAt ?? inMemEntry?.startedAt;
-                if (!(await isThreadAlive(w.threadId, fallbackPid, startedAt))) {
-                    const inMemory = spawnedThreads.some((t) => t.threadId === w.threadId);
-                    try {
-                        if (inMemory) {
-                            // Still tracked in spawnedThreads: archive DB record now for dashboard accuracy.
-                            // Full decommission (topic deletion, memory synthesis) happens via TTL cleanup.
-                            this.deps.threadLifecycle.archiveThread(db, w.threadId);
-                        }
-                        else {
-                            // Not in spawnedThreads: the TTL cleanup's SQL path won't reach an already-archived
-                            // thread, so the Telegram topic would leak. Do a full decommission now.
-                            await decommissionWorker({ threadId: w.threadId, name: w.name }, {
-                                db,
-                                telegram: this.deps.telegram,
-                                chatId: this.deps.chatId,
-                                threadLifecycle: this.deps.threadLifecycle,
-                            });
-                        }
-                        this.deps.log.info(`[dead-worker-sweep] Archived dead worker ${w.threadId} (${w.name})`);
-                    }
-                    catch (err) {
-                        this.deps.log.warn(`[dead-worker-sweep] Failed to archive ${w.threadId}: ${errorMessage(err)}`);
-                    }
-                }
-            }
-        }
-        catch (err) {
-            this.deps.log.error(`Dead worker sweep error: ${errorMessage(err)}`);
-        }
-    }
     async runDailyRotationCheck() {
         const now = new Date();
         // Fire once we're at/past the rotation hour for the day, not only inside a

package/dist/services/background-runner.js.map

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

package/dist/services/board/board-signals.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Board awareness signals — exactly four kinds, one line each, no description
+ * (invariant #4). STARTED / DONE / BLOCKED / DECISION_NEEDED reach the board bot
+ * or the configured operator main thread.
+ *
+ * Delivery mode is deliberately isolated in this one function while decision
+ * #2 is with the operator (thread 1327, 2026-08-01):
+ *   - "passive" (default, orchestrator's lean): rides the passive-notice
+ *     channel — seen on the main thread's next delivered turn, never acted on.
+ *   - "mailbox": appended to the main thread's pending-task mailbox
+ *     — wakes it with an FYI-framed line.
+ * Flip via BOARD_SIGNAL_DELIVERY=mailbox; no other code changes.
+ */
+import { TelegramClient } from "../telegram.js";
+import type { BoardCard } from "../../data/board/board-types.js";
+import type { Database } from "../../data/memory/db-types.js";
+import { Optional } from "../../data/optional.js";
+export type BoardSignalKind = "STARTED" | "DONE" | "BLOCKED" | "DECISION_NEEDED";
+type BoardBot = Pick<TelegramClient, "sendMessage">;
+type BoardWarningSink = (message: string) => void;
+export interface BoardSignalDelivery {
+    boardBot: Optional<BoardBot>;
+    boardBotToken: Optional<string>;
+    boardChatId: Optional<string>;
+    warningSink: Optional<BoardWarningSink>;
+    mainThreadId: Optional<number>;
+}
+/** Production delivery: the configured board bot, else the main thread from the environment. */
+export declare const DEFAULT_BOARD_SIGNAL_DELIVERY: BoardSignalDelivery;
+/** One-line, FYI-framed state transition. `detail` is used for BLOCKED and
+ *  DECISION_NEEDED, where it makes the ping actionable for the operator. */
+export declare function sendBoardSignal(db: Database, card: BoardCard, kind: BoardSignalKind, detail?: string, delivery?: BoardSignalDelivery): void;
+/** Resolve the optional operator main thread from the process boundary. */
+export declare function resolveBoardMainThreadId(): Optional<number>;
+/**
+ * Selective escalation (invariant #4): a card the operator hand-flagged
+ * "important to me" mirrors its notable updates (worker reports, block
+ * reasons) into the main thread as passive notices — aware, not commanded.
+ * Deterministic: no agent judges importance; the flag decides, always.
+ */
+export declare function mirrorEscalatedUpdate(db: Database, card: BoardCard, text: string, delivery?: BoardSignalDelivery): void;
+/** A decision cannot proceed without the operator, regardless of card priority. */
+export declare function sendDecisionPing(db: Database, card: BoardCard, question: string, delivery?: BoardSignalDelivery): void;
+export {};
+//# sourceMappingURL=board-signals.d.ts.map

package/dist/services/board/board-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-signals.d.ts","sourceRoot":"","sources":["../../../src/services/board/board-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAMjF,KAAK,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;AACpD,KAAK,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7B,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACxC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,gGAAgG;AAChG,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAkDF;4EAC4E;AAC5E,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,GAAE,mBAAmD,GAC5D,IAAI,CAmCN;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAG3D;AAOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,mBAAmD,GAC5D,IAAI,CAkBN;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,mBAAmD,GAC5D,IAAI,CAaN"}