agent-bober 0.17.1 → 0.19.0

package/dist/chat/run-spawner.js

@@ -0,0 +1,121 @@
+// ── run-spawner.ts ─────────────────────────────────────────────────────
+//
+// Launches a DETACHED `agent-bober run <task> --run-id <id>` child that
+// survives the REPL exiting. Writes the roster state.json BEFORE spawning
+// so the run is visible the same turn; records the pid in a sidecar.
+import { execa } from "execa";
+import { writeRunState, readRunState } from "../state/run-state.js";
+import { resolveCliEntry } from "../fleet/runner.js";
+import { PidSidecar } from "./pid-sidecar.js";
+// ── RunSpawner ─────────────────────────────────────────────────────────
+export class RunSpawner {
+    projectRoot;
+    sessionId;
+    spawnFn;
+    killFn;
+    cliEntry;
+    nodeBin;
+    now;
+    sidecar;
+    constructor(opts) {
+        this.projectRoot = opts.projectRoot;
+        this.sessionId = opts.sessionId;
+        this.spawnFn =
+            opts.spawn ??
+                // bober: thin execa wrapper; execa returns a ChildProcess-like w/ .pid and .unref
+                ((file, args, options) => execa(file, args, options));
+        this.killFn =
+            opts.kill ??
+                // bober: default delegates to process.kill; swap for a fake in tests (sc-4-9)
+                ((pid, signal) => { process.kill(pid, signal); });
+        this.cliEntry = opts.cliEntry ?? resolveCliEntry();
+        this.nodeBin = opts.nodeBin ?? process.execPath;
+        this.now = opts.now ?? (() => new Date().toISOString());
+        this.sidecar = new PidSidecar(this.projectRoot, this.sessionId);
+    }
+    /**
+     * Write the roster state.json, launch a detached child, record the pid,
+     * and return an immediate SpawnAck without waiting for the child to finish.
+     *
+     * @param opts.careful - When true, appends --approve-gates with the curated
+     *   gate list to the child args. Default false (autopilot — byte-for-byte
+     *   identical to Phase 1 behavior).
+     */
+    async spawn(task, runId, opts = {}) {
+        const cwd = this.projectRoot;
+        // 1. Write roster state.json BEFORE spawning so the run is visible immediately (sc-2-6)
+        const state = {
+            runId,
+            task,
+            status: "running",
+            startedAt: this.now(),
+            progress: { completed: 0, total: 0 },
+            projectRoot: cwd,
+        };
+        await writeRunState(cwd, state);
+        // 2. Launch detached child — do NOT await (sc-2-9, sc-2-6)
+        try {
+            const args = [this.cliEntry, "run", task, "--run-id", runId];
+            if (opts.careful) {
+                args.push("--approve-gates", "post-research,post-plan,post-sprint");
+            }
+            const child = this.spawnFn(this.nodeBin, args, { cwd, detached: true, stdio: "ignore" });
+            child.unref();
+            // 3. Record pid in session sidecar (sc-2-7)
+            await this.sidecar.record(runId, {
+                pid: child.pid,
+                task,
+                spawnedAt: this.now(),
+            });
+            return { runId, task, pid: child.pid, cwd };
+        }
+        catch (err) {
+            return {
+                runId,
+                task,
+                cwd,
+                spawnError: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    /**
+     * Stop a running run by its runId.
+     * Resolves the PID from the session sidecar and sends SIGTERM.
+     * If no sidecar entry is found, flips state to 'aborted' on disk only.
+     * Tolerates ESRCH (already-dead pid) — treat as already stopped.
+     */
+    async stop(runId, reason) {
+        const all = await this.sidecar.readAll();
+        const entry = all[runId];
+        if (entry?.pid !== undefined) {
+            // Try to kill the process; tolerate ESRCH (already dead)
+            try {
+                this.killFn(entry.pid, "SIGTERM");
+            }
+            catch {
+                // Already gone — not an error (mirrors pipeline-lifecycle.ts:316-320)
+            }
+            // Flip disk state to aborted
+            const s = await readRunState(this.projectRoot, runId);
+            if (s) {
+                s.status = "aborted";
+                s.abortedAt = this.now();
+                s.abortReason = reason;
+                await writeRunState(this.projectRoot, s);
+            }
+            return { stopped: true, runId, killedPid: entry.pid };
+        }
+        // No sidecar entry — fall back to disk-only aborted flip
+        const s = await readRunState(this.projectRoot, runId);
+        if (s) {
+            s.status = "aborted";
+            s.abortedAt = this.now();
+            s.abortReason = reason;
+            await writeRunState(this.projectRoot, s);
+            return { stopped: true, runId, fallbackFlagOnly: true };
+        }
+        // Run not found at all
+        return { stopped: false, runId };
+    }
+}
+//# sourceMappingURL=run-spawner.js.map

package/dist/chat/run-spawner.js.map

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

package/dist/chat/slash-commands.d.ts

@@ -0,0 +1,40 @@
+import type { RosterReader } from "./roster-reader.js";
+export type SlashResult = {
+    handled: true;
+    output: string;
+    exit?: false;
+} | {
+    handled: true;
+    output?: undefined;
+    exit: true;
+} | {
+    handled: false;
+};
+/**
+ * Handle a slash command if the input starts with '/'.
+ * Returns { handled: false } for non-slash input.
+ * Never calls the LLMClient.
+ *
+ * @param stopHandler - Optional handler for /stop <runId>. When omitted, /stop
+ *   returns an "unavailable" message. Kept optional so existing 2-arg callers
+ *   are not broken (sc-4-6).
+ * @param carefulHandler - Optional handler for /careful [on|off]. When omitted,
+ *   /careful returns an "unavailable" message. Kept optional so existing 2-/3-arg
+ *   callers are not broken.
+ * @param approveHandler - Optional handler for /approve <id>. When omitted, /approve
+ *   returns an "unavailable" message. Kept optional so existing callers are not broken.
+ * @param rejectHandler - Optional handler for /reject <id> [feedback]. When omitted,
+ *   /reject returns an "unavailable" message. Kept optional so existing callers are not broken.
+ * @param tellHandler - Optional handler for /tell <runId> <text>. When omitted,
+ *   /tell returns an "unavailable" message.
+ * @param pauseHandler - Optional handler for /pause <runId>. When omitted,
+ *   /pause returns an "unavailable" message. Kept optional for back-compat.
+ * @param resumeHandler - Optional handler for /resume <runId>. When omitted,
+ *   /resume returns an "unavailable" message.
+ * @param priorityHandler - Optional handler for /priority (hub team only). When omitted,
+ *   /priority returns an "unavailable" message. Kept optional for back-compat.
+ * @param decideHandler - Optional handler for /decide <X> vs <Y> (hub team only). When omitted,
+ *   /decide returns an "unavailable" message. Last optional param preserves back-compat.
+ */
+export declare function dispatch(input: string, roster: RosterReader, stopHandler?: (runId: string) => Promise<string>, carefulHandler?: (arg: string | undefined) => Promise<string>, approveHandler?: (id: string) => Promise<string>, rejectHandler?: (id: string, feedback: string) => Promise<string>, tellHandler?: (runId: string, text: string) => Promise<string>, pauseHandler?: (runId: string) => Promise<string>, resumeHandler?: (runId: string) => Promise<string>, priorityHandler?: () => Promise<string>, decideHandler?: (expr: string) => Promise<string>): Promise<SlashResult>;
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/chat/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/chat/slash-commands.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/C;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACjD;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAsBvB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAChD,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,EAC7D,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAChD,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACjE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC9D,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAClD,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACvC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAChD,OAAO,CAAC,WAAW,CAAC,CA8GtB"}

package/dist/chat/slash-commands.js

@@ -0,0 +1,153 @@
+// ── slash-commands.ts ────────────────────────────────────────────────
+//
+// Deterministic slash-command dispatcher.
+// Handles /runs, /help, /exit WITHOUT touching the LLMClient.
+// ── Help text ─────────────────────────────────────────────────────────
+const HELP_TEXT = [
+    "Available slash commands:",
+    "  /runs              — List all active and recent runs",
+    "  /stop <runId>      — Stop a run by killing its process (hard stop)",
+    "  /pause <runId>     — Soft-pause a run at the next boundary (process stays alive)",
+    "  /resume <runId>    — Resume a soft-paused run",
+    "  /careful [on|off]  — Toggle approval gates for new runs",
+    "  /approve <id>      — Approve a pending checkpoint (resume the run)",
+    "  /reject <id> [why] — Reject a pending checkpoint with optional feedback",
+    "  /tell <runId> <text> — Queue free-text guidance for a run (applied at next boundary)",
+    "  /help              — Show this help message",
+    "  /exit              — Exit the chat session",
+    "",
+    "Any other input is sent to the AI assistant.",
+].join("\n");
+// ── dispatch ──────────────────────────────────────────────────────────
+/**
+ * Handle a slash command if the input starts with '/'.
+ * Returns { handled: false } for non-slash input.
+ * Never calls the LLMClient.
+ *
+ * @param stopHandler - Optional handler for /stop <runId>. When omitted, /stop
+ *   returns an "unavailable" message. Kept optional so existing 2-arg callers
+ *   are not broken (sc-4-6).
+ * @param carefulHandler - Optional handler for /careful [on|off]. When omitted,
+ *   /careful returns an "unavailable" message. Kept optional so existing 2-/3-arg
+ *   callers are not broken.
+ * @param approveHandler - Optional handler for /approve <id>. When omitted, /approve
+ *   returns an "unavailable" message. Kept optional so existing callers are not broken.
+ * @param rejectHandler - Optional handler for /reject <id> [feedback]. When omitted,
+ *   /reject returns an "unavailable" message. Kept optional so existing callers are not broken.
+ * @param tellHandler - Optional handler for /tell <runId> <text>. When omitted,
+ *   /tell returns an "unavailable" message.
+ * @param pauseHandler - Optional handler for /pause <runId>. When omitted,
+ *   /pause returns an "unavailable" message. Kept optional for back-compat.
+ * @param resumeHandler - Optional handler for /resume <runId>. When omitted,
+ *   /resume returns an "unavailable" message.
+ * @param priorityHandler - Optional handler for /priority (hub team only). When omitted,
+ *   /priority returns an "unavailable" message. Kept optional for back-compat.
+ * @param decideHandler - Optional handler for /decide <X> vs <Y> (hub team only). When omitted,
+ *   /decide returns an "unavailable" message. Last optional param preserves back-compat.
+ */
+export async function dispatch(input, roster, stopHandler, carefulHandler, approveHandler, rejectHandler, tellHandler, pauseHandler, resumeHandler, priorityHandler, decideHandler) {
+    const trimmed = input.trimStart();
+    if (!trimmed.startsWith("/")) {
+        return { handled: false };
+    }
+    const command = trimmed.split(/\s+/)[0]?.toLowerCase() ?? "";
+    switch (command) {
+        case "/runs": {
+            const states = await roster.read();
+            const output = roster.summarize(states);
+            return { handled: true, output };
+        }
+        case "/help": {
+            return { handled: true, output: HELP_TEXT };
+        }
+        case "/stop": {
+            const arg = trimmed.split(/\s+/)[1];
+            if (!arg)
+                return { handled: true, output: "Usage: /stop <runId>" };
+            const output = stopHandler
+                ? await stopHandler(arg)
+                : "Stop is unavailable.";
+            return { handled: true, output };
+        }
+        case "/careful": {
+            const arg = trimmed.split(/\s+/)[1]?.toLowerCase();
+            const output = carefulHandler
+                ? await carefulHandler(arg)
+                : "Careful mode is unavailable.";
+            return { handled: true, output };
+        }
+        case "/approve": {
+            const arg = trimmed.split(/\s+/)[1];
+            if (!arg)
+                return { handled: true, output: "Usage: /approve <checkpointId>" };
+            const output = approveHandler
+                ? await approveHandler(arg)
+                : "Approve is unavailable.";
+            return { handled: true, output };
+        }
+        case "/reject": {
+            const parts = trimmed.split(/\s+/);
+            const id = parts[1];
+            if (!id)
+                return { handled: true, output: "Usage: /reject <checkpointId> [feedback]" };
+            // Everything after the id is feedback (preserve spacing of the remainder)
+            const feedback = trimmed.replace(/^\/reject\s+\S+\s*/, "");
+            const output = rejectHandler
+                ? await rejectHandler(id, feedback)
+                : "Reject is unavailable.";
+            return { handled: true, output };
+        }
+        case "/tell": {
+            const parts = trimmed.split(/\s+/);
+            const runId = parts[1];
+            if (!runId)
+                return { handled: true, output: "Usage: /tell <runId> <text>" };
+            // Capture everything after the runId as the guidance text (preserve spacing)
+            const text = trimmed.replace(/^\/tell\s+\S+\s*/, "");
+            if (!text)
+                return { handled: true, output: "Usage: /tell <runId> <text>" };
+            const output = tellHandler
+                ? await tellHandler(runId, text)
+                : "Tell is unavailable.";
+            return { handled: true, output };
+        }
+        case "/pause": {
+            const arg = trimmed.split(/\s+/)[1];
+            if (!arg)
+                return { handled: true, output: "Usage: /pause <runId>" };
+            const output = pauseHandler ? await pauseHandler(arg) : "Pause is unavailable.";
+            return { handled: true, output };
+        }
+        case "/resume": {
+            const arg = trimmed.split(/\s+/)[1];
+            if (!arg)
+                return { handled: true, output: "Usage: /resume <runId>" };
+            const output = resumeHandler ? await resumeHandler(arg) : "Resume is unavailable.";
+            return { handled: true, output };
+        }
+        case "/priority": {
+            const output = priorityHandler
+                ? await priorityHandler()
+                : "Priority is unavailable.";
+            return { handled: true, output };
+        }
+        case "/decide": {
+            // Capture everything after '/decide' as the 'X vs Y' expression.
+            const expr = trimmed.replace(/^\/decide\s*/i, "").trim();
+            if (!expr)
+                return { handled: true, output: "Usage: /decide <X> vs <Y>" };
+            const output = decideHandler
+                ? await decideHandler(expr)
+                : "Decide is unavailable.";
+            return { handled: true, output };
+        }
+        case "/exit": {
+            return { handled: true, exit: true };
+        }
+        default: {
+            const output = `Unknown command: ${command}\n${HELP_TEXT}`;
+            return { handled: true, output };
+        }
+    }
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/chat/slash-commands.js.map

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

package/dist/chat/steer-cleanup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Remove all disk + RunState steer artifacts for a run that has gone terminal.
+ * Best-effort: each step is individually guarded; the function never throws.
+ *
+ * Steps:
+ * 1. Delete pending approval marker(s) correlated to this runId (by runId field).
+ * 2. Unlink .bober/runs/<runId>/guidance.jsonl + paused.json (tolerate ENOENT).
+ * 3. Clear RunState pending/paused fields (pendingCheckpointId, pendingPrompt,
+ *    pendingSince, pausedAt) while leaving the terminal status (completed/aborted) as-is.
+ */
+export declare function cleanupTerminalRun(projectRoot: string, runId: string): Promise<void>;
+//# sourceMappingURL=steer-cleanup.d.ts.map

package/dist/chat/steer-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steer-cleanup.d.ts","sourceRoot":"","sources":["../../src/chat/steer-cleanup.ts"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/chat/steer-cleanup.js

@@ -0,0 +1,60 @@
+// ── steer-cleanup.ts ──────────────────────────────────────────────────
+//
+// Best-effort hygiene: when the chat process observes a run reach a terminal
+// status (completed/aborted), remove its stale pending approval marker(s),
+// guidance.jsonl, and paused.json, and clear RunState pending/paused fields.
+// NEVER throws — a cleanup failure must not break a chat turn.
+import { unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { deletePending, listPending } from "../state/approval-state.js";
+import { readRunState, writeRunState } from "../state/run-state.js";
+import { safeSegment } from "../state/guidance.js";
+/**
+ * Remove all disk + RunState steer artifacts for a run that has gone terminal.
+ * Best-effort: each step is individually guarded; the function never throws.
+ *
+ * Steps:
+ * 1. Delete pending approval marker(s) correlated to this runId (by runId field).
+ * 2. Unlink .bober/runs/<runId>/guidance.jsonl + paused.json (tolerate ENOENT).
+ * 3. Clear RunState pending/paused fields (pendingCheckpointId, pendingPrompt,
+ *    pendingSince, pausedAt) while leaving the terminal status (completed/aborted) as-is.
+ */
+export async function cleanupTerminalRun(projectRoot, runId) {
+    if (!safeSegment(runId))
+        return; // unsafe id → skip silently (mirrors pause.ts:79)
+    // 1. Delete pending markers correlated to this runId (checkpointId-keyed dir).
+    try {
+        const pending = await listPending(projectRoot);
+        for (const m of pending) {
+            if (m.runId === runId) {
+                await deletePending(projectRoot, m.checkpointId); // already best-effort (:138)
+            }
+        }
+    }
+    catch {
+        // never throw into a turn
+    }
+    // 2. Unlink guidance.jsonl + paused.json under .bober/runs/<runId>/ (tolerate ENOENT).
+    const runDir = join(projectRoot, ".bober", "runs", runId);
+    await unlink(join(runDir, "guidance.jsonl")).catch(() => { });
+    await unlink(join(runDir, "paused.json")).catch(() => { });
+    // 3. Clear RunState pending/paused fields (only if a state file exists).
+    //    Preserve the terminal status (completed/aborted) — do NOT force back to running.
+    try {
+        const state = await readRunState(projectRoot, runId);
+        if (state) {
+            // Destructure out optional fields — established idiom from chat-session.ts:441-447
+            const { pendingCheckpointId, pendingPrompt, pendingSince, pausedAt, ...rest } = state;
+            // Suppress unused-variable warnings in strict mode
+            void pendingCheckpointId;
+            void pendingPrompt;
+            void pendingSince;
+            void pausedAt;
+            await writeRunState(projectRoot, rest);
+        }
+    }
+    catch {
+        // never throw into a turn
+    }
+}
+//# sourceMappingURL=steer-cleanup.js.map

package/dist/chat/steer-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steer-cleanup.js","sourceRoot":"","sources":["../../src/chat/steer-cleanup.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,+DAA+D;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,KAAa;IAEb,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,kDAAkD;IAEnF,+EAA+E;IAC/E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBACtB,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,6BAA6B;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,uFAAuF;IACvF,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE1D,yEAAyE;IACzE,sFAAsF;IACtF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,mFAAmF;YACnF,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;YACtF,mDAAmD;YACnD,KAAK,mBAAmB,CAAC;YACzB,KAAK,aAAa,CAAC;YACnB,KAAK,YAAY,CAAC;YAClB,KAAK,QAAQ,CAAC;YACd,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;AACH,CAAC"}

package/dist/chat/turn-classifier.d.ts

@@ -0,0 +1,46 @@
+import type { LLMClient } from "../providers/types.js";
+export type ClassifierAction = {
+    action: "answer";
+} | {
+    action: "spawn";
+    task: string;
+} | {
+    action: "steer";
+    op: "inspect";
+} | {
+    action: "steer";
+    op: "stop";
+    runId: string;
+} | {
+    action: "approve";
+    checkpointId?: string;
+} | {
+    action: "reject";
+    checkpointId?: string;
+    feedback?: string;
+} | {
+    action: "tell";
+    runId: string;
+    text: string;
+} | {
+    action: "pause";
+    runId: string;
+} | {
+    action: "resume";
+    runId: string;
+} | {
+    action: "capture-task";
+    task: string;
+};
+export declare class TurnClassifier {
+    private readonly llm;
+    private readonly model;
+    constructor(llm: LLMClient, model: string);
+    /**
+     * Classify the user's input turn.
+     * Uses jsonObjectMode:true (loose JSON mode) for provider parity.
+     * Any failure in the LLM call or JSON parse returns { action: "answer" }.
+     */
+    classify(input: string): Promise<ClassifierAction>;
+}
+//# sourceMappingURL=turn-classifier.d.ts.map

package/dist/chat/turn-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-classifier.d.ts","sourceRoot":"","sources":["../../src/chat/turn-classifier.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA8G7C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;IAKzC;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAiCzD"}

package/dist/chat/turn-classifier.js

@@ -0,0 +1,157 @@
+// ── turn-classifier.ts ────────────────────────────────────────────────
+//
+// Classifies each user turn via a single jsonObjectMode LLMClient.chat call.
+// Any parse failure returns { action: "answer" } — never throws.
+import { z } from "zod";
+// ── Zod discriminated union ───────────────────────────────────────────
+const ClassifierActionSchema = z.discriminatedUnion("action", [
+    z.object({ action: z.literal("answer") }),
+    z.object({ action: z.literal("spawn"), task: z.string() }),
+    z.object({
+        action: z.literal("steer"),
+        op: z.union([
+            z.literal("inspect"),
+            z.object({ op: z.literal("stop"), runId: z.string() }).shape.op,
+        ]),
+        runId: z.string().optional(),
+    }),
+    z.object({ action: z.literal("approve"), checkpointId: z.string().optional() }),
+    z.object({
+        action: z.literal("reject"),
+        checkpointId: z.string().optional(),
+        feedback: z.string().optional(),
+    }),
+    z.object({ action: z.literal("tell"), runId: z.string(), text: z.string() }),
+    z.object({ action: z.literal("pause"), runId: z.string() }),
+    z.object({ action: z.literal("resume"), runId: z.string() }),
+    z.object({ action: z.literal("capture-task"), task: z.string() }),
+]);
+const FALLBACK = { action: "answer" };
+// ── Helpers ───────────────────────────────────────────────────────────
+/**
+ * Strip code fences (```json ... ``` or ``` ... ```) from a string.
+ */
+function stripCodeFences(text) {
+    return text.replace(/```(?:json)?\s*([\s\S]*?)```/g, "$1").trim();
+}
+/**
+ * Extract the first balanced {...} JSON object substring.
+ * Returns null if no balanced object found.
+ */
+function extractFirstObject(text) {
+    const start = text.indexOf("{");
+    if (start === -1)
+        return null;
+    let depth = 0;
+    for (let i = start; i < text.length; i++) {
+        if (text[i] === "{")
+            depth++;
+        else if (text[i] === "}") {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+/**
+ * Defensively parse text into a ClassifierAction.
+ * Returns FALLBACK on any error.
+ */
+function parseClassifierAction(text) {
+    try {
+        const stripped = stripCodeFences(text);
+        const extracted = extractFirstObject(stripped) ?? stripped;
+        const parsed = JSON.parse(extracted);
+        const result = ClassifierActionSchema.safeParse(parsed);
+        if (result.success) {
+            // Reconstruct steer with proper shape
+            const data = result.data;
+            if (data.action === "answer")
+                return { action: "answer" };
+            if (data.action === "spawn")
+                return { action: "spawn", task: data.task };
+            if (data.action === "capture-task") {
+                return { action: "capture-task", task: data.task };
+            }
+            if (data.action === "steer") {
+                const raw = parsed;
+                if (raw["op"] === "stop" && typeof raw["runId"] === "string") {
+                    return { action: "steer", op: "stop", runId: raw["runId"] };
+                }
+                return { action: "steer", op: "inspect" };
+            }
+            if (data.action === "approve") {
+                return { action: "approve", checkpointId: data.checkpointId };
+            }
+            if (data.action === "reject") {
+                return {
+                    action: "reject",
+                    checkpointId: data.checkpointId,
+                    feedback: data.feedback,
+                };
+            }
+            if (data.action === "tell") {
+                return { action: "tell", runId: data.runId, text: data.text };
+            }
+            if (data.action === "pause") {
+                return { action: "pause", runId: data.runId };
+            }
+            if (data.action === "resume") {
+                return { action: "resume", runId: data.runId };
+            }
+        }
+        return FALLBACK;
+    }
+    catch {
+        return FALLBACK;
+    }
+}
+// ── TurnClassifier ────────────────────────────────────────────────────
+export class TurnClassifier {
+    llm;
+    model;
+    constructor(llm, model) {
+        this.llm = llm;
+        this.model = model;
+    }
+    /**
+     * Classify the user's input turn.
+     * Uses jsonObjectMode:true (loose JSON mode) for provider parity.
+     * Any failure in the LLM call or JSON parse returns { action: "answer" }.
+     */
+    async classify(input) {
+        const system = [
+            "You are a routing classifier for a chat assistant.",
+            "Given the user message, decide what action to take.",
+            'Return ONLY a JSON object with an "action" field.',
+            'Options:',
+            '  {"action":"answer"}  — answer the question directly',
+            '  {"action":"spawn","task":"<task description>"}  — spawn a new agent run',
+            '  {"action":"steer","op":"inspect"}  — inspect running agents',
+            '  {"action":"steer","op":"stop","runId":"<id>"}  — stop a specific run',
+            '  {"action":"approve","checkpointId":"<id?>"}  — approve a pending checkpoint',
+            '  {"action":"reject","checkpointId":"<id?>","feedback":"<why?>"}  — reject a checkpoint',
+            '  {"action":"tell","runId":"<id>","text":"<instruction>"}  — queue free-text guidance for a run',
+            '  {"action":"pause","runId":"<id>"}  — soft-pause a run (process stays alive)',
+            '  {"action":"resume","runId":"<id>"}  — resume a soft-paused run',
+            '  {"action":"capture-task","task":"<task text>"}  — capture a NEW personal task/to-do the user states (an imperative like "renew passport", "book dentist", "call the bank")',
+            'A plain question (e.g. "what is X?", "how do I Y?") is {"action":"answer"} — NOT a task.',
+            'A decision/scope statement (e.g. "I\'m deciding between X and Y", "should I do A or B?") is NOT a new task — route it to {"action":"answer"}.',
+            "Return ONLY the JSON object, no other text.",
+        ].join("\n");
+        try {
+            const response = await this.llm.chat({
+                model: this.model,
+                system,
+                messages: [{ role: "user", content: input }],
+                jsonObjectMode: true,
+            });
+            return parseClassifierAction(response.text);
+        }
+        catch {
+            return FALLBACK;
+        }
+    }
+}
+//# sourceMappingURL=turn-classifier.js.map

package/dist/chat/turn-classifier.js.map

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