muonroi-cli 1.8.3 → 1.8.5

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 muonroi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 muonroi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,122 +1,133 @@
-<p align="center">
-  <h1 align="center">muonroi-cli</h1>
-  <p align="center">
-    <em>An AI coding agent where models argue with each other before answering.</em>
-  </p>
-  <p align="center">
-    <a href="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml"><img alt="CI" src="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml/badge.svg"></a>
-    <a href="https://www.npmjs.com/package/muonroi-cli"><img alt="npm" src="https://img.shields.io/npm/v/muonroi-cli.svg"></a>
-    <img alt="Providers" src="https://img.shields.io/badge/providers-7%20supported-blue">
-    <img alt="License" src="https://img.shields.io/badge/license-MIT-yellow">
-    <img alt="Runtime" src="https://img.shields.io/badge/runtime-Bun%201.3%2B-orange">
-  </p>
-</p>
-
----
-
-> Routes each task to the optimal model, runs adversarial multi-model debates for high-stakes decisions, and persists behavioral memory across sessions. Bring your own API keys. Total cost: ~$5/month.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/muonroi/muonroi-cli/master/docs/demo.gif" alt="Council debate — REST vs gRPC decision" width="840" />
-</p>
-
-## Quick Start
-
-### Install
-
-**Recommended — prebuilt standalone binary (zero runtime deps, no prereqs):**
-
-Linux / macOS:
-```bash
-curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash
-```
-
-Windows PowerShell:
-```powershell
-irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex
-```
-
-The installers download a `bun --compile` binary from GitHub Releases — single executable, all native deps bundled, no Node/Bun/build tools required.
-
-**Bun runtime (requires Bun ≥ 1.x):**
-```bash
-bun add -g muonroi-cli
-muonroi-cli
-```
-
-> **⚠ Why no `npm install -g`?** The TUI engine (`@opentui/core`) uses Bun-only `import ... with { type: "file" }` for Tree-sitter syntax highlight queries (`.scm` files). Node ESM cannot load these, so running under bare Node throws `ERR_UNKNOWN_FILE_EXTENSION`. Use the standalone installer (above) or `bun add -g`.
-
-### First run
-
-On first launch the CLI shows a wizard that:
-1. Lists supported providers (currently **DeepSeek** and **SiliconFlow**).
-2. Offers four ways to add credentials: paste an API key, import an encrypted bundle (`keys export`/`keys import`), sync from Bitwarden, or skip and add later via `/providers` inside the TUI.
-
-After setup, role routing auto-balances across enabled providers:
-
-```json
-// ~/.muonroi-cli/user-settings.json (generated by the wizard — edit if needed)
-{
-  "defaultProvider": "deepseek",
-  "providers": {
-    "deepseek":    { "enabled": true },
-    "siliconflow": { "enabled": true }
-  },
-  "roleModels": {
-    "leader":    "deepseek-v4-pro",
-    "implement": "deepseek-v4-flash",
-    "verify":    "deepseek-v4-pro",
-    "research":  "deepseek-v4-flash"
-  }
-}
-```
-
-### Moving keys between devices
-
-```bash
-# Source device — encrypts every stored key into one passphrase-protected file
-muonroi-cli keys export ~/muonroi-keys.json
-
-# Move the file via any channel (USB, Drive, AirDrop, email...)
-
-# Target device — same passphrase rehydrates the OS keychain
-muonroi-cli keys import ~/muonroi-keys.json
-```
-
-Inside the TUI press `/providers` then `B` to sync directly from a Bitwarden vault instead.
-
-### Updates
-
-The CLI checks npm once per day on startup and prompts when a newer version is available. Set `autoUpdate: true` in `user-settings.json` to skip the prompt and update silently. Manual: `muonroi-cli update`.
-
-## Documentation
-
-Full documentation at **[docs.muonroi.com/docs/cli](https://docs.muonroi.com/docs/cli/overview)**
-
-| Topic | Link |
-|---|---|
-| Overview & architecture | [CLI Overview](https://docs.muonroi.com/docs/cli/overview) |
-| Multi-Model Council | [Council Debate Guide](https://docs.muonroi.com/docs/cli/guides/council-debate) |
-| Prompt Intelligence Layer | [PIL Pipeline Guide](https://docs.muonroi.com/docs/cli/guides/pil-pipeline) |
-| Experience Engine | [Experience Engine Guide](https://docs.muonroi.com/docs/cli/guides/experience-engine) |
-| Agent Harness | [Agent Harness Guide](https://docs.muonroi.com/docs/cli/guides/agent-harness) |
-| Settings reference | [CLI Settings Reference](https://docs.muonroi.com/docs/cli/reference/cli-settings-reference) |
-| Commands reference | [Commands Reference](https://docs.muonroi.com/docs/cli/reference/commands-reference) |
-| Providers reference | [Providers Reference](https://docs.muonroi.com/docs/cli/reference/providers-reference) |
-
-## Development
-
-```bash
-git clone https://github.com/muonroi/muonroi-cli.git
-cd muonroi-cli && bun install
-
-bun run dev           # run from source
-bun run typecheck     # type check
-bun run test          # vitest
-bun run lint          # biome check
-bun run build:binary  # standalone binary
-```
-
-## License
-
-MIT
+<p align="center">
+  <h1 align="center">muonroi-cli</h1>
+  <p align="center">
+    <em>An AI coding agent where models argue with each other before answering.</em>
+  </p>
+  <p align="center">
+    <a href="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml"><img alt="CI" src="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml/badge.svg"></a>
+    <a href="https://www.npmjs.com/package/muonroi-cli"><img alt="npm" src="https://img.shields.io/npm/v/muonroi-cli.svg"></a>
+    <img alt="Providers" src="https://img.shields.io/badge/providers-7%20supported-blue">
+    <img alt="License" src="https://img.shields.io/badge/license-MIT-yellow">
+    <img alt="Runtime" src="https://img.shields.io/badge/runtime-Bun%201.3%2B-orange">
+  </p>
+</p>
+
+---
+
+> Routes each task to the optimal model, runs adversarial multi-model debates for high-stakes decisions, and persists behavioral memory across sessions. Bring your own API keys. Total cost: ~$5/month.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/muonroi/muonroi-cli/master/docs/demo.gif" alt="Council debate — REST vs gRPC decision" width="840" />
+</p>
+
+## Quick Start
+
+### Install
+
+**Recommended — install globally via NPM (requires Node.js ≥ 20) or Bun (requires Bun ≥ 1.x):**
+
+Using NPM:
+```bash
+npm install -g muonroi-cli
+```
+
+Using Bun:
+```bash
+bun add -g muonroi-cli
+```
+
+Once installed, run:
+```bash
+muonroi-cli
+```
+
+**Alternative — Prebuilt standalone binary (requires access to the GitHub repository):**
+
+Linux / macOS:
+```bash
+# Note: Requires github authorization if the repository is private
+curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash
+```
+
+Windows PowerShell:
+```powershell
+# Note: Requires github authorization if the repository is private
+irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex
+```
+
+The installers download a `bun --compile` binary from GitHub Releases — single executable, all native deps bundled, no Node/Bun/build tools required.
+
+### First run
+
+On first launch the CLI shows a wizard that:
+1. Lists supported providers (currently **DeepSeek** and **SiliconFlow**).
+2. Offers four ways to add credentials: paste an API key, import an encrypted bundle (`keys export`/`keys import`), sync from Bitwarden, or skip and add later via `/providers` inside the TUI.
+
+After setup, role routing auto-balances across enabled providers:
+
+```json
+// ~/.muonroi-cli/user-settings.json (generated by the wizard — edit if needed)
+{
+  "defaultProvider": "deepseek",
+  "providers": {
+    "deepseek":    { "enabled": true },
+    "siliconflow": { "enabled": true }
+  },
+  "roleModels": {
+    "leader":    "deepseek-v4-pro",
+    "implement": "deepseek-v4-flash",
+    "verify":    "deepseek-v4-pro",
+    "research":  "deepseek-v4-flash"
+  }
+}
+```
+
+### Moving keys between devices
+
+```bash
+# Source device — encrypts every stored key into one passphrase-protected file
+muonroi-cli keys export ~/muonroi-keys.json
+
+# Move the file via any channel (USB, Drive, AirDrop, email...)
+
+# Target device — same passphrase rehydrates the OS keychain
+muonroi-cli keys import ~/muonroi-keys.json
+```
+
+Inside the TUI press `/providers` then `B` to sync directly from a Bitwarden vault instead.
+
+### Updates
+
+The CLI checks npm once per day on startup and prompts when a newer version is available. Set `autoUpdate: true` in `user-settings.json` to skip the prompt and update silently. Manual: `muonroi-cli update`.
+
+## Documentation
+
+Full documentation at **[docs.muonroi.com/docs/cli](https://docs.muonroi.com/docs/cli/overview)**
+
+| Topic | Link |
+|---|---|
+| Overview & architecture | [CLI Overview](https://docs.muonroi.com/docs/cli/overview) |
+| Multi-Model Council | [Council Debate Guide](https://docs.muonroi.com/docs/cli/guides/council-debate) |
+| Prompt Intelligence Layer | [PIL Pipeline Guide](https://docs.muonroi.com/docs/cli/guides/pil-pipeline) |
+| Experience Engine | [Experience Engine Guide](https://docs.muonroi.com/docs/cli/guides/experience-engine) |
+| Agent Harness | [Agent Harness Guide](https://docs.muonroi.com/docs/cli/guides/agent-harness) |
+| Settings reference | [CLI Settings Reference](https://docs.muonroi.com/docs/cli/reference/cli-settings-reference) |
+| Commands reference | [Commands Reference](https://docs.muonroi.com/docs/cli/reference/commands-reference) |
+| Providers reference | [Providers Reference](https://docs.muonroi.com/docs/cli/reference/providers-reference) |
+
+## Development
+
+```bash
+git clone https://github.com/muonroi/muonroi-cli.git
+cd muonroi-cli && bun install
+
+bun run dev           # run from source
+bun run typecheck     # type check
+bun run test          # vitest
+bun run lint          # biome check
+bun run build:binary  # standalone binary
+```
+
+## License
+
+MIT

package/dist/packages/agent-harness-core/src/driver.d.ts

@@ -1,5 +1,13 @@
 import { type Predicate } from "./predicate.js";
-import type { LiveEvent, LiveFrame, UINode } from "./protocol.js";
+import type { LiveEvent, LiveFrame, UINode, VisualFrame } from "./protocol.js";
+import { type VisualQualityReport } from "./visual-quality.js";
+/** A single decoded cell from the rendered grid (returned by `visual_cell`). */
+export type VisualCell = {
+    char: string;
+    fg: string;
+    bg: string;
+    attrs: number;
+};
 type WaitConditionIdle = {
     idle: true;
 };
@@ -31,6 +39,9 @@ type DriverDeps = {
 type Ingested = {
     kind: "frame";
     frame: LiveFrame;
+} | {
+    kind: "visual";
+    frame: VisualFrame;
 } | {
     kind: "idle";
 } | {
@@ -69,6 +80,21 @@ export type Driver = {
      */
     events: (filter?: EventFilter) => AsyncIterable<LiveEvent>;
     render_text: () => string;
+    /** Latest VisualFrame — the ACTUAL rendered cell grid (colors + attributes),
+     *  or null if the TUI has not emitted one (renderer not attached). */
+    snapshot_visual: () => VisualFrame | null;
+    /** Render the visual grid as plain text (what a human reads on screen) —
+     *  faithful to the rendered characters, unlike render_text (semantic tree). */
+    render_visual: () => string;
+    /** Decode the cell at (row, col) — char + fg/bg hex + attribute bits — from
+     *  the latest VisualFrame, accounting for wide (2-col) glyphs. Null if out of
+     *  range or no visual frame yet. */
+    visual_cell: (row: number, col: number) => VisualCell | null;
+    /** Programmatic visual-quality heuristics over the latest VisualFrame:
+     *  near-empty-row ratio, blank-row runs, whitespace density, and mojibake —
+     *  the exact "messy render" signals the semantic tree is blind to. Null if no
+     *  visual frame yet. */
+    visual_quality: () => VisualQualityReport | null;
     _ingest: (m: Ingested) => void;
     /** Called when the TUI exits. Cleanly terminates all active `events()` iterables. */
     _closeAllSubscribers: () => void;

package/dist/packages/agent-harness-core/src/driver.js

@@ -1,5 +1,6 @@
 import { evaluatePredicate, predicateSchema } from "./predicate.js";
 import { matchSelector } from "./selector.js";
+import { computeVisualQuality } from "./visual-quality.js";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -12,6 +13,7 @@ const PER_SUBSCRIBER_QUEUE_CAP = 256;
 // ---------------------------------------------------------------------------
 export function createDriver(deps) {
     let latestFrame = null;
+    let latestVisualFrame = null;
     let lastIdleAt = -1;
     const eventBuffer = [];
     const waiters = new Set();
@@ -276,10 +278,54 @@ export function createDriver(deps) {
                 return "(no frame)";
             return latestFrame.nodes.map((n) => renderNode(n, 0)).join("\n");
         },
+        snapshot_visual() {
+            return latestVisualFrame;
+        },
+        render_visual() {
+            if (!latestVisualFrame)
+                return "(no visual frame)";
+            return latestVisualFrame.lines
+                .map((ln) => ln.spans
+                .map((s) => s.text)
+                .join("")
+                .replace(/\s+$/, ""))
+                .join("\n");
+        },
+        visual_cell(row, col) {
+            const frame = latestVisualFrame;
+            if (!frame)
+                return null;
+            const line = frame.lines[row];
+            if (!line)
+                return null;
+            // Walk spans accumulating display columns; a wide glyph spans 2 columns
+            // but its span.width already reflects that, so index within the run by
+            // string position while tracking the column cursor.
+            let colCursor = 0;
+            for (const span of line.spans) {
+                const chars = [...span.text];
+                for (const ch of chars) {
+                    // A char occupies span.width / chars.length columns on average; for
+                    // the common width===text-length case this is 1. Round to stay integral.
+                    const chCols = Math.max(1, Math.round(span.width / Math.max(1, chars.length)));
+                    if (col >= colCursor && col < colCursor + chCols) {
+                        return { char: ch, fg: span.fg, bg: span.bg, attrs: span.attrs };
+                    }
+                    colCursor += chCols;
+                }
+            }
+            return null;
+        },
+        visual_quality() {
+            return latestVisualFrame ? computeVisualQuality(latestVisualFrame) : null;
+        },
         _ingest(m) {
             if (m.kind === "frame") {
                 latestFrame = m.frame;
             }
+            else if (m.kind === "visual") {
+                latestVisualFrame = m.frame;
+            }
             else if (m.kind === "idle") {
                 lastIdleAt = Date.now();
             }

package/dist/packages/agent-harness-core/src/event-tee.d.ts

@@ -0,0 +1,48 @@
+/**
+ * event-tee.ts — optional JSONL sink for harness LiveEvents.
+ *
+ * Why: the MCP wake mechanism that re-invokes an external agent is a background
+ * task (e.g. a milestone watcher), which is a SEPARATE process from the MCP
+ * server. That watcher can only read files — it cannot reach the in-process
+ * driver that holds the real UI. So a generic, reusable milestone watcher needs
+ * the harness to persist events to a file it can tail.
+ *
+ * The DB only records debate-END rows (synthesis/debate_complete), so a
+ * DB-poll watcher is blind to mid-flight modal pauses (askcard-open) that never
+ * write a DB row. Teeing every LiveEvent to a JSONL file closes that gap for
+ * ANY event kind.
+ *
+ * Ephemeral events (toast, disconnect, retry, ee-*) flash and vanish before an
+ * agent can wake + render, so for those kinds — and ONLY those — we attach a
+ * plain-text visual snapshot captured at emit time, so the watcher's wake
+ * payload carries the exact frame. Persistent states (askcard, post-debate
+ * card) stay put, so the agent renders them fresh on demand; embedding a stale
+ * snapshot for those would be worse, not better.
+ *
+ * Gated entirely behind MUONROI_HARNESS_EVENT_LOG — unset means zero behavior
+ * change (clean checkouts are byte-identical to before this file existed).
+ */
+import type { LiveEvent } from "./protocol.js";
+/**
+ * Event kinds that flash and disappear before an agent can wake + render.
+ * Only these carry an at-emit visual snapshot in the teed line.
+ */
+export declare const EPHEMERAL_KINDS: ReadonlySet<string>;
+/** One teed JSONL record. */
+export interface TeedEventLine {
+    ts: number;
+    kind: string;
+    event: LiveEvent;
+    /** Present only for EPHEMERAL_KINDS — plain-text visual frame at emit time. */
+    visualText?: string;
+}
+/**
+ * Build an event-tee sink. Returns null when MUONROI_HARNESS_EVENT_LOG is unset
+ * or blank (no-op path — caller skips it entirely).
+ *
+ * @param getVisualText - lazily renders the current visual frame to plain text
+ *   (driver.render_visual). Called ONLY for ephemeral kinds, so persistent
+ *   events pay nothing.
+ * @param envValue - value of MUONROI_HARNESS_EVENT_LOG (injectable for tests).
+ */
+export declare function createEventTee(getVisualText: () => string | null, envValue?: string): ((event: LiveEvent) => void) | null;

package/dist/packages/agent-harness-core/src/event-tee.js

@@ -0,0 +1,77 @@
+/**
+ * event-tee.ts — optional JSONL sink for harness LiveEvents.
+ *
+ * Why: the MCP wake mechanism that re-invokes an external agent is a background
+ * task (e.g. a milestone watcher), which is a SEPARATE process from the MCP
+ * server. That watcher can only read files — it cannot reach the in-process
+ * driver that holds the real UI. So a generic, reusable milestone watcher needs
+ * the harness to persist events to a file it can tail.
+ *
+ * The DB only records debate-END rows (synthesis/debate_complete), so a
+ * DB-poll watcher is blind to mid-flight modal pauses (askcard-open) that never
+ * write a DB row. Teeing every LiveEvent to a JSONL file closes that gap for
+ * ANY event kind.
+ *
+ * Ephemeral events (toast, disconnect, retry, ee-*) flash and vanish before an
+ * agent can wake + render, so for those kinds — and ONLY those — we attach a
+ * plain-text visual snapshot captured at emit time, so the watcher's wake
+ * payload carries the exact frame. Persistent states (askcard, post-debate
+ * card) stay put, so the agent renders them fresh on demand; embedding a stale
+ * snapshot for those would be worse, not better.
+ *
+ * Gated entirely behind MUONROI_HARNESS_EVENT_LOG — unset means zero behavior
+ * change (clean checkouts are byte-identical to before this file existed).
+ */
+import { appendFileSync } from "node:fs";
+/**
+ * Event kinds that flash and disappear before an agent can wake + render.
+ * Only these carry an at-emit visual snapshot in the teed line.
+ */
+export const EPHEMERAL_KINDS = new Set([
+    "toast",
+    "disconnect",
+    "stream-retry",
+    "ee-timeout",
+    "ee-error",
+    "grounding-flag",
+]);
+/**
+ * Build an event-tee sink. Returns null when MUONROI_HARNESS_EVENT_LOG is unset
+ * or blank (no-op path — caller skips it entirely).
+ *
+ * @param getVisualText - lazily renders the current visual frame to plain text
+ *   (driver.render_visual). Called ONLY for ephemeral kinds, so persistent
+ *   events pay nothing.
+ * @param envValue - value of MUONROI_HARNESS_EVENT_LOG (injectable for tests).
+ */
+export function createEventTee(getVisualText, envValue) {
+    const path = (envValue ?? "").trim();
+    if (!path)
+        return null;
+    return (event) => {
+        // The idle sentinel arrives as { t: "idle" } — never here. Guard anyway so
+        // a malformed event can't crash the ingest loop.
+        const kind = event.kind;
+        if (typeof kind !== "string")
+            return;
+        const line = { ts: Date.now(), kind, event };
+        if (EPHEMERAL_KINDS.has(kind)) {
+            try {
+                const visual = getVisualText();
+                if (visual)
+                    line.visualText = visual;
+            }
+            catch (err) {
+                // A visual-render failure must not drop the event record itself.
+                console.error(`[event-tee] visual snapshot failed for kind=${kind}: ${err?.message}`);
+            }
+        }
+        try {
+            appendFileSync(path, `${JSON.stringify(line)}\n`);
+        }
+        catch (err) {
+            console.error(`[event-tee] append failed (path=${path}, kind=${kind}): ${err?.message}`);
+        }
+    };
+}
+//# sourceMappingURL=event-tee.js.map

package/dist/packages/agent-harness-core/src/mcp-server.d.ts

@@ -13,6 +13,7 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type Driver } from "./driver.js";
+import type { LiveEvent } from "./protocol.js";
 /**
  * The result returned by a HarnessSpawn implementation.
  * Both the POSIX fd-3/4 and Windows named-pipe transports satisfy this shape.
@@ -95,6 +96,16 @@ export declare function registerAsyncTools(server: McpServer, getDriver: () => D
 export declare function createMcpHarnessServer({ spawn }: {
     spawn: HarnessSpawn;
 }): McpServer;
+/**
+ * Build the onLine sidechannel handler: parse each JSON line, ingest frames /
+ * visuals / idle / events into the driver, and tee events to the optional JSONL
+ * sink. Extracted (and exported) so the frame/event/tee wiring is unit-testable
+ * without a live TUI or an MCP protocol handshake.
+ *
+ * @param driver   the driver to ingest into (only _ingest is used).
+ * @param eventTee optional sink from createEventTee (null → no tee).
+ */
+export declare function makeLineHandler(driver: Pick<Driver, "_ingest">, eventTee: ((event: LiveEvent) => void) | null): (line: string) => void;
 /**
  * Run the MCP harness driver over stdio with the OpenTUI spawn implementation
  * injected by the consumer.