trellis-hgl 0.6.0-beta.18

package/dist/commands/channel/supervisor/warning.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Supervisor pre-timeout warning scheduler.
+ *
+ * Emits a one-shot `supervisor_warning` channel event when the worker
+ * is approaching its lifetime timeout, so observers (dispatchers /
+ * `trellis channel messages`) can see the impending kill without
+ * having to poll. The event is observability-only — it never replaces
+ * the eventual `killed` / `done` / `error` terminal event, and is
+ * not part of the meaningful-event set so plain `wait` does not wake
+ * on it unless `--kind supervisor_warning` is explicit.
+ *
+ * Scheduling lives outside `createShutdown()` because the warning is a
+ * pre-terminal observability event, not a terminal one — the shutdown
+ * funnel deliberately only owns kill ladder + `killed` append.
+ */
+/** Default lead time before the supervisor timeout (ms) to fire the warning. */
+export declare const SUPERVISOR_TIMEOUT_WARNING_REMAINING_MS: number;
+export interface SupervisorShutdownProbe {
+    isShuttingDown(): boolean;
+    hasTerminalEvent(): boolean;
+}
+export interface ScheduleSupervisorTimeoutWarningArgs {
+    channelName: string;
+    workerName: string;
+    timeoutMs: number;
+    /** Warning lead time in ms. `<= 0` disables the pre-timeout warning. */
+    warnBeforeMs?: number;
+    shutdown: SupervisorShutdownProbe;
+    /** Returns true once the child process has exited (exitCode/signalCode set). */
+    isChildExited: () => boolean;
+    log: {
+        write: (data: string) => void;
+    };
+    project?: string;
+}
+/**
+ * Schedule a single `supervisor_warning` append at `timeoutMs - warnBeforeMs`
+ * (clamped at 0 when the warning lead time is greater than the timeout).
+ * Guarded so the warning is emitted at most once, never after shutdown
+ * has been requested, never after a terminal event has been emitted,
+ * and never after the worker child has exited.
+ *
+ * Returns a cancel handle that callers can invoke to drop the pending
+ * timer (e.g. on supervisor teardown). Append failures are logged via
+ * `log.write` only and do not affect worker lifecycle.
+ */
+export declare function scheduleSupervisorTimeoutWarning(args: ScheduleSupervisorTimeoutWarningArgs): () => void;
+//# sourceMappingURL=warning.d.ts.map

package/dist/commands/channel/supervisor/warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.d.ts","sourceRoot":"","sources":["../../../../src/commands/channel/supervisor/warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,gFAAgF;AAChF,eAAO,MAAM,uCAAuC,QAAa,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,cAAc,IAAI,OAAO,CAAC;IAC1B,gBAAgB,IAAI,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,oCAAoC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,gFAAgF;IAChF,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,GAAG,EAAE;QAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,oCAAoC,GACzC,MAAM,IAAI,CAuDZ"}

package/dist/commands/channel/supervisor/warning.js

@@ -0,0 +1,77 @@
+/**
+ * Supervisor pre-timeout warning scheduler.
+ *
+ * Emits a one-shot `supervisor_warning` channel event when the worker
+ * is approaching its lifetime timeout, so observers (dispatchers /
+ * `trellis channel messages`) can see the impending kill without
+ * having to poll. The event is observability-only — it never replaces
+ * the eventual `killed` / `done` / `error` terminal event, and is
+ * not part of the meaningful-event set so plain `wait` does not wake
+ * on it unless `--kind supervisor_warning` is explicit.
+ *
+ * Scheduling lives outside `createShutdown()` because the warning is a
+ * pre-terminal observability event, not a terminal one — the shutdown
+ * funnel deliberately only owns kill ladder + `killed` append.
+ */
+import { appendEvent } from "../store/events.js";
+/** Default lead time before the supervisor timeout (ms) to fire the warning. */
+export const SUPERVISOR_TIMEOUT_WARNING_REMAINING_MS = 5 * 60_000;
+/**
+ * Schedule a single `supervisor_warning` append at `timeoutMs - warnBeforeMs`
+ * (clamped at 0 when the warning lead time is greater than the timeout).
+ * Guarded so the warning is emitted at most once, never after shutdown
+ * has been requested, never after a terminal event has been emitted,
+ * and never after the worker child has exited.
+ *
+ * Returns a cancel handle that callers can invoke to drop the pending
+ * timer (e.g. on supervisor teardown). Append failures are logged via
+ * `log.write` only and do not affect worker lifecycle.
+ */
+export function scheduleSupervisorTimeoutWarning(args) {
+    const { channelName, workerName, timeoutMs, shutdown, isChildExited, log } = args;
+    if (timeoutMs <= 0)
+        return () => undefined;
+    const warnBeforeMs = args.warnBeforeMs ?? SUPERVISOR_TIMEOUT_WARNING_REMAINING_MS;
+    if (warnBeforeMs <= 0)
+        return () => undefined;
+    const remaining = Math.min(timeoutMs, warnBeforeMs);
+    const delay = Math.max(0, timeoutMs - remaining);
+    let warningEmitted = false;
+    let cancelled = false;
+    const fire = () => {
+        if (cancelled || warningEmitted)
+            return;
+        if (shutdown.isShuttingDown() ||
+            shutdown.hasTerminalEvent() ||
+            isChildExited()) {
+            return;
+        }
+        // Claim the slot synchronously so a re-entrant fire (or future
+        // caller wiring) cannot race two appends.
+        warningEmitted = true;
+        void (async () => {
+            try {
+                await appendEvent(channelName, {
+                    kind: "supervisor_warning",
+                    by: `supervisor:${workerName}`,
+                    worker: workerName,
+                    reason: "approaching_timeout",
+                    timeout_ms: timeoutMs,
+                    remaining_ms: remaining,
+                }, args.project);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                log.write(`[supervisor] warning append failed: ${msg}\n`);
+            }
+        })();
+    };
+    const timer = setTimeout(fire, delay);
+    // Don't keep the supervisor alive solely for the warning timer.
+    timer.unref?.();
+    return () => {
+        cancelled = true;
+        clearTimeout(timer);
+    };
+}
+//# sourceMappingURL=warning.js.map

package/dist/commands/channel/supervisor/warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.js","sourceRoot":"","sources":["../../../../src/commands/channel/supervisor/warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,gFAAgF;AAChF,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,GAAG,MAAM,CAAC;AAoBlE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAA0C;IAE1C,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,GACxE,IAAI,CAAC;IACP,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC3C,MAAM,YAAY,GAChB,IAAI,CAAC,YAAY,IAAI,uCAAuC,CAAC;IAC/D,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAE9C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IAEjD,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,SAAS,IAAI,cAAc;YAAE,OAAO;QACxC,IACE,QAAQ,CAAC,cAAc,EAAE;YACzB,QAAQ,CAAC,gBAAgB,EAAE;YAC3B,aAAa,EAAE,EACf,CAAC;YACD,OAAO;QACT,CAAC;QACD,+DAA+D;QAC/D,0CAA0C;QAC1C,cAAc,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,WAAW,CACf,WAAW,EACX;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,EAAE,EAAE,cAAc,UAAU,EAAE;oBAC9B,MAAM,EAAE,UAAU;oBAClB,MAAM,EAAE,qBAAqB;oBAC7B,UAAU,EAAE,SAAS;oBACrB,YAAY,EAAE,SAAS;iBACxB,EACD,IAAI,CAAC,OAAO,CACb,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,GAAG,CAAC,KAAK,CAAC,uCAAuC,GAAG,IAAI,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,gEAAgE;IAChE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAEhB,OAAO,GAAG,EAAE;QACV,SAAS,GAAG,IAAI,CAAC;QACjB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}

package/dist/commands/channel/supervisor.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Supervisor process: owns a single worker (claude or codex) and bridges
+ * worker ↔ channel events.jsonl.
+ *
+ * Run as: `trellis channel __supervisor <channel> <worker> <config-path>`
+ *
+ * Three concurrent loops:
+ *   1. stdout reader  — parse worker stdout → adapter → append events
+ *   2. inbox watcher  — read events.jsonl for `to=<worker>` say events,
+ *                       translate via adapter.encodeUserMessage → worker stdin
+ *   3. signal handler — SIGTERM → close worker stdin → 3s → SIGTERM → 3s → SIGKILL
+ *                       → write `killed` event → exit
+ */
+import { type InboxPolicy } from "trellis-hgl-core/channel";
+import { type Provider } from "./adapters/index.js";
+export interface SupervisorConfig {
+    provider: Provider;
+    cwd: string;
+    /** Combined worker system prompt: channel protocol prefix + agent body.
+     *  Injected via Claude `--append-system-prompt` or Codex `developerInstructions`.
+     *  No "initial user prompt" — the worker stays idle until the first
+     *  inbox `send --to <worker>` arrives. */
+    systemPrompt: string;
+    /** Extra env vars (TRELLIS_HOOKS=0 etc. are added automatically). */
+    env?: Record<string, string>;
+    /** Optional model override. */
+    model?: string;
+    /** Resume an existing session/thread if id is provided. */
+    resume?: string;
+    /** Auto-kill worker after this many ms (anti-zombie). */
+    timeoutMs?: number;
+    /** Emit supervisor_warning this many ms before timeout. `<=0` disables it. */
+    warnBeforeMs?: number;
+    /** Caller identity recorded on the `spawned` event (default "main"). */
+    spawnedBy?: string;
+    /** Agent definition name loaded for this worker, if any (recorded on `spawned`). */
+    agent?: string;
+    /** Relative paths injected via --file / --jsonl (recorded on `spawned`). */
+    contextFiles?: string[];
+    /** Relative paths of every `--jsonl` manifest processed, even if empty
+     *  (recorded on `spawned` for observability — "I passed --jsonl X but
+     *  X contained no real entries"). */
+    contextManifests?: string[];
+    /** Worker inbox delivery policy (recorded on `spawned`; default
+     *  `explicitOnly`). */
+    inboxPolicy?: InboxPolicy;
+}
+/**
+ * Entry point invoked by `trellis channel __supervisor <channel> <worker> <config>`.
+ */
+export declare function runSupervisor(channelName: string, workerName: string, configPath: string): Promise<void>;
+export declare function writeSupervisorConfig(channelName: string, workerName: string, config: SupervisorConfig, project?: string): string;
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/commands/channel/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../src/commands/channel/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAShE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ;;;8CAG0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;yCAEqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;2BACuB;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAMD;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Rf;AA+BD,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAKR"}

package/dist/commands/channel/supervisor.js

@@ -0,0 +1,304 @@
+/**
+ * Supervisor process: owns a single worker (claude or codex) and bridges
+ * worker ↔ channel events.jsonl.
+ *
+ * Run as: `trellis channel __supervisor <channel> <worker> <config-path>`
+ *
+ * Three concurrent loops:
+ *   1. stdout reader  — parse worker stdout → adapter → append events
+ *   2. inbox watcher  — read events.jsonl for `to=<worker>` say events,
+ *                       translate via adapter.encodeUserMessage → worker stdin
+ *   3. signal handler — SIGTERM → close worker stdin → 3s → SIGTERM → 3s → SIGKILL
+ *                       → write `killed` event → exit
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { DEFAULT_INBOX_POLICY, } from "trellis-hgl-core/channel";
+import { getAdapter } from "./adapters/index.js";
+import { appendEvent } from "./store/events.js";
+import { workerFile } from "./store/paths.js";
+import { runInboxWatcher } from "./supervisor/inbox.js";
+import { createShutdown } from "./supervisor/shutdown.js";
+import { startStdoutPump } from "./supervisor/stdout.js";
+import { TurnTracker } from "./supervisor/turns.js";
+import { scheduleSupervisorTimeoutWarning } from "./supervisor/warning.js";
+const SHUTDOWN_GRACE_MS = 3000;
+/**
+ * Entry point invoked by `trellis channel __supervisor <channel> <worker> <config>`.
+ */
+export async function runSupervisor(channelName, workerName, configPath) {
+    const config = readConfig(configPath);
+    // Self-pid file lets `trellis channel kill` find us.
+    const project = process.env.TRELLIS_CHANNEL_PROJECT;
+    fs.writeFileSync(workerFile(channelName, workerName, "pid", project), String(process.pid));
+    // ── adapter selection ──
+    const adapter = getAdapter(config.provider);
+    const adapterCtx = adapter.createCtx();
+    const view = {
+        resume: config.resume,
+        model: config.model,
+        systemPrompt: config.systemPrompt,
+        cwd: config.cwd,
+    };
+    const args = adapter.buildArgs(view);
+    const env = {
+        ...process.env,
+        ...config.env,
+        TRELLIS_HOOKS: "0",
+        TRELLIS_CHANNEL: channelName,
+        TRELLIS_CHANNEL_AS: workerName,
+    };
+    const logPath = workerFile(channelName, workerName, "log", project);
+    const log = fs.createWriteStream(logPath);
+    log.write(`[supervisor] starting ${adapter.provider} ${args.join(" ")}\n`);
+    const child = spawn(adapter.provider, args, {
+        cwd: config.cwd,
+        env,
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    // ── shutdown controller declared before listener attachment ──
+    // Node fires `error` on next tick when spawn fails (ENOENT / EACCES);
+    // create the controller and attach listeners synchronously, with no
+    // await between spawn() and child.on("error").
+    const shutdown = createShutdown({
+        channelName,
+        workerName,
+        log,
+        getChild: () => child,
+        graceMs: SHUTDOWN_GRACE_MS,
+        timeoutMs: config.timeoutMs,
+    });
+    // Gate the `spawned` event behind whichever child lifecycle event fires
+    // first: `spawn` (success) or `error` (launch failure, e.g. ENOENT).
+    // Without this gate the post-spawn path writes `spawned` even when the
+    // process never actually started — and the racing error append makes
+    // `spawned` vs `error` ordering non-deterministic. Both rounds of CR
+    // converged on this.
+    let spawnFailed = false;
+    let settleSpawn = () => undefined;
+    const spawnSettled = new Promise((resolve) => {
+        settleSpawn = resolve;
+    });
+    // Attach listeners SYNCHRONOUSLY — no awaits between spawn() and these
+    // lines. Node fires `error` on next tick when spawn fails (ENOENT etc.),
+    // and if no listener is attached by then the supervisor dies with an
+    // unhandled error and leaves a stale .pid behind.
+    child.stderr.on("data", (b) => log.write(b));
+    child.once("spawn", () => {
+        settleSpawn();
+    });
+    child.on("error", (err) => {
+        // L1 fix: guard against double-fire of `error` (Node can re-emit it
+        // during pipe teardown). The startup-failed path runs an IIFE that
+        // owns process.exit; subsequent fires must be no-ops or we'd queue
+        // duplicate error events.
+        if (spawnFailed)
+            return;
+        log.write(`[supervisor] worker error: ${err.message}\n`);
+        if (!child.pid) {
+            // Pre-spawn failure (ENOENT / EACCES): emit ONE `error` event,
+            // skip the misleading `spawned{pid:undefined}`, clean up, and exit
+            // so the supervisor doesn't linger as a zombie waiting for an
+            // `exit` event that Node won't deliver.
+            spawnFailed = true;
+            settleSpawn();
+            void (async () => {
+                try {
+                    await appendEvent(channelName, {
+                        kind: "error",
+                        by: `supervisor:${workerName}`,
+                        message: `worker spawn failed: ${err.message}`,
+                        provider: config.provider,
+                    }, project);
+                }
+                catch {
+                    // ignore — we're exiting anyway
+                }
+                await cleanup(channelName, workerName).catch(() => undefined);
+                process.exit(1);
+            })();
+            return;
+        }
+        // Post-spawn error (worker already running). Claude M2 fix: await
+        // the `error` append BEFORE requesting shutdown so `killed` can't
+        // land first in events.jsonl.
+        //
+        // Sync-claim the shutdown reason FIRST so other code paths (e.g.
+        // the `await spawnSettled` re-check, future inbox-handler probes)
+        // observe `isShuttingDown=true` immediately, before the IIFE
+        // suspends on its first await.
+        shutdown.claim("crash");
+        void (async () => {
+            try {
+                await appendEvent(channelName, {
+                    kind: "error",
+                    by: `supervisor:${workerName}`,
+                    message: `worker process error: ${err.message}`,
+                    provider: config.provider,
+                }, project);
+            }
+            catch {
+                // ignore
+            }
+            await shutdown.request("SIGTERM", "crash");
+        })();
+    });
+    child.on("exit", (code, sig) => {
+        // Codex #1 + #2 fix: synthesise a fallback terminal event when the
+        // adapter never produced one (otherwise `wait --kind done` hangs),
+        // and await any in-flight `killed` append from a concurrent shutdown
+        // before exiting so the event doesn't race the process death.
+        void (async () => {
+            await shutdown.finalizeOnExit(code, sig).catch(() => undefined);
+            await cleanup(channelName, workerName).catch(() => undefined);
+            process.exit(0);
+        })();
+    });
+    // Signal handlers MUST be registered before any await so a SIGTERM
+    // arriving during the spawn-settle / spawned-append window funnels
+    // into `shutdown.request` instead of using Node's default behaviour
+    // (which would orphan the child and skip the `killed` event).
+    process.on("SIGTERM", () => void shutdown.request("SIGTERM", "explicit-kill"));
+    process.on("SIGINT", () => void shutdown.request("SIGINT", "explicit-kill"));
+    // SIGHUP arrives when the parent terminal closes — without this
+    // handler Node's default behaviour exits the supervisor before the
+    // killed-append lands.
+    process.on("SIGHUP", () => void shutdown.request("SIGHUP", "explicit-kill"));
+    // Wait until either `spawn` or pre-spawn `error` fires before writing
+    // the `spawned` event. The error handler exits the process directly,
+    // so reaching this point with `spawnFailed=true` means we already kicked
+    // off cleanup and can bail cleanly.
+    await spawnSettled;
+    if (spawnFailed)
+        return;
+    // Codex #3 fix: if a signal/timeout requested shutdown while we were
+    // waiting for spawn-settled, don't write a misleading `spawned` event;
+    // let the in-flight `killed` append complete and bail.
+    if (shutdown.isShuttingDown()) {
+        await shutdown.awaitFinalize();
+        return;
+    }
+    fs.writeFileSync(workerFile(channelName, workerName, "worker-pid", project), String(child.pid));
+    const turnTracker = new TurnTracker();
+    await appendEvent(channelName, {
+        kind: "spawned",
+        by: config.spawnedBy ?? "main",
+        as: workerName,
+        provider: config.provider,
+        pid: child.pid,
+        inboxPolicy: config.inboxPolicy ?? DEFAULT_INBOX_POLICY,
+        ...(config.agent ? { agent: config.agent } : {}),
+        ...(config.contextFiles && config.contextFiles.length > 0
+            ? { files: config.contextFiles }
+            : {}),
+        ...(config.contextManifests && config.contextManifests.length > 0
+            ? { manifests: config.contextManifests }
+            : {}),
+    }, project);
+    // ── 1. stdout reader ──
+    startStdoutPump({
+        channelName,
+        workerName,
+        child,
+        adapter,
+        adapterCtx,
+        log,
+        shutdown,
+        turnTracker,
+    });
+    // ── timeout guard (anti-zombie) ──
+    if (config.timeoutMs && config.timeoutMs > 0) {
+        setTimeout(() => {
+            log.write(`[supervisor] timeout ${config.timeoutMs}ms reached, killing worker\n`);
+            // shutdown.request emits a single `killed{reason:"timeout"}` event;
+            // no need to emit a separate one here.
+            void shutdown.request("SIGTERM", "timeout");
+        }, config.timeoutMs).unref();
+        // Fire-and-forget pre-timeout observability warning. One-shot, guarded
+        // by shutdown/terminal/exit state so it stays quiet once the worker is
+        // already on its way out.
+        scheduleSupervisorTimeoutWarning({
+            channelName,
+            workerName,
+            timeoutMs: config.timeoutMs,
+            warnBeforeMs: config.warnBeforeMs,
+            shutdown,
+            isChildExited: () => child.exitCode !== null || child.signalCode !== null,
+            log,
+            project,
+        });
+    }
+    // ── 3. inbox watcher ──
+    // Start BEFORE adapter.handshake() so messages arriving during the
+    // handshake window are captured. The adapter's `isReady()` is checked
+    // inside runInboxWatcher; codex blocks there until thread/start lands.
+    const abort = new AbortController();
+    process.on("exit", () => abort.abort());
+    void runInboxWatcher({
+        channelName,
+        workerName,
+        adapter,
+        ctx: adapterCtx,
+        child,
+        signal: abort.signal,
+        inboxPolicy: config.inboxPolicy ?? DEFAULT_INBOX_POLICY,
+        turnTracker,
+    });
+    // ── adapter handshake (no initial user prompt) ──
+    if (adapter.handshake) {
+        try {
+            await adapter.handshake({ child, ctx: adapterCtx, view });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log.write(`[supervisor] adapter handshake failed: ${msg}\n`);
+            // Codex #4 fix: emit an `error` event with the handshake message
+            // BEFORE requesting shutdown — otherwise the channel only sees a
+            // `killed{reason:"crash"}` with no detail on what went wrong.
+            void (async () => {
+                try {
+                    await appendEvent(channelName, {
+                        kind: "error",
+                        by: `supervisor:${workerName}`,
+                        message: `handshake failed: ${msg}`,
+                        provider: config.provider,
+                        detail: { source: "handshake" },
+                    }, project);
+                }
+                catch {
+                    // ignore
+                }
+                await shutdown.request("SIGTERM", "crash");
+            })();
+        }
+    }
+}
+async function cleanup(channelName, workerName) {
+    // Remove ephemeral runtime files. Keep `log` (forensic), `session-id` /
+    // `thread-id` (future resume). The .spawnlock should already be gone
+    // because `withLock` released it; we delete it defensively in case the
+    // CLI crashed mid-spawn and left a stale one.
+    // Keep `log` (forensic), `session-id` / `thread-id` (future resume).
+    // `inbox-cursor` is kept so a respawn (same worker name without
+    // killing the channel) doesn't replay messages.
+    for (const suffix of ["pid", "worker-pid", "config", "spawnlock"]) {
+        try {
+            fs.unlinkSync(workerFile(channelName, workerName, suffix, process.env.TRELLIS_CHANNEL_PROJECT));
+        }
+        catch {
+            // already gone
+        }
+    }
+}
+function readConfig(p) {
+    return JSON.parse(fs.readFileSync(p, "utf-8"));
+}
+// Helper to write a fresh config file before forking the supervisor.
+export function writeSupervisorConfig(channelName, workerName, config, project) {
+    const p = workerFile(channelName, workerName, "config", project);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, JSON.stringify(config, null, 2), "utf-8");
+    return p;
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/commands/channel/supervisor.js.map

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

package/dist/commands/channel/text-body.d.ts

@@ -0,0 +1,13 @@
+export interface ChannelTextBodyOptions {
+    text?: string;
+    stdin?: boolean;
+    textFile?: string;
+}
+interface ResolveChannelTextBodyOptions {
+    required: boolean;
+    missingMessage: string;
+    emptyMessage: string;
+}
+export declare function resolveChannelTextBody(opts: ChannelTextBodyOptions, resolveOpts: ResolveChannelTextBodyOptions): Promise<string | undefined>;
+export {};
+//# sourceMappingURL=text-body.d.ts.map

package/dist/commands/channel/text-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-body.d.ts","sourceRoot":"","sources":["../../../src/commands/channel/text-body.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,6BAA6B;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,sBAAsB,EAC5B,WAAW,EAAE,6BAA6B,GACzC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B"}

package/dist/commands/channel/text-body.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+export async function resolveChannelTextBody(opts, resolveOpts) {
+    const raw = await readChannelTextBody(opts);
+    if (raw === undefined) {
+        if (resolveOpts.required)
+            throw new Error(resolveOpts.missingMessage);
+        return undefined;
+    }
+    const text = raw.trimEnd();
+    if (!text)
+        throw new Error(resolveOpts.emptyMessage);
+    return text;
+}
+async function readChannelTextBody(opts) {
+    if (opts.text !== undefined && opts.text !== "")
+        return opts.text;
+    if (opts.textFile)
+        return fs.readFileSync(opts.textFile, "utf-8");
+    if (opts.stdin)
+        return await readStdin();
+    return undefined;
+}
+async function readStdin() {
+    return await new Promise((resolve, reject) => {
+        let buf = "";
+        const onData = (chunk) => {
+            buf += chunk.toString("utf-8");
+        };
+        const cleanup = () => {
+            process.stdin.off("data", onData);
+            process.stdin.off("end", onEnd);
+            process.stdin.off("error", onError);
+        };
+        const onEnd = () => {
+            cleanup();
+            resolve(buf);
+        };
+        const onError = (err) => {
+            cleanup();
+            reject(err);
+        };
+        process.stdin.on("data", onData);
+        process.stdin.once("end", onEnd);
+        process.stdin.once("error", onError);
+    });
+}
+//# sourceMappingURL=text-body.js.map

package/dist/commands/channel/text-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-body.js","sourceRoot":"","sources":["../../../src/commands/channel/text-body.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAczB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAA4B,EAC5B,WAA0C;IAE1C,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,IAAI,WAAW,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,IAA4B;IAE5B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAClE,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,SAAS,EAAE,CAAC;IACzC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnD,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;YACrC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,GAAS,EAAE;YACvB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,GAAU,EAAQ,EAAE;YACnC,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC;QAEF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/channel/threads.d.ts

@@ -0,0 +1,39 @@
+export interface ThreadPostOptions {
+    as: string;
+    action: string;
+    thread?: string;
+    title?: string;
+    text?: string;
+    stdin?: boolean;
+    textFile?: string;
+    description?: string;
+    status?: string;
+    labels?: string;
+    assignees?: string;
+    summary?: string;
+    scope?: string;
+    /** New canonical flag list. */
+    contextFile?: string[];
+    contextRaw?: string[];
+    /** Legacy aliases accepted while users migrate scripts. */
+    linkedContextFile?: string[];
+    linkedContextRaw?: string[];
+}
+export interface ForumOptions {
+    scope?: string;
+    status?: string;
+    raw?: boolean;
+}
+export interface ThreadShowOptions {
+    scope?: string;
+    raw?: boolean;
+}
+export interface ThreadRenameOptions {
+    as: string;
+    scope?: string;
+}
+export declare function channelThreadPost(channelName: string, opts: ThreadPostOptions): Promise<void>;
+export declare function channelForumList(channelName: string, opts: ForumOptions): Promise<void>;
+export declare function channelThreadShow(channelName: string, threadKey: string, opts: ThreadShowOptions): Promise<void>;
+export declare function channelThreadRename(channelName: string, oldThread: string, newThread: string, opts: ThreadRenameOptions): Promise<void>;
+//# sourceMappingURL=threads.d.ts.map

package/dist/commands/channel/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/commands/channel/threads.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAWf"}