@provos/ironcurtain 0.10.0 → 0.12.0

package/dist/mux/session-scanner.js

@@ -8,8 +8,7 @@
 import { readdirSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
-import { getSessionsDir, getSessionSandboxDir } from '../config/paths.js';
-import { SESSION_STATE_FILENAME } from '../docker/pty-types.js';
+import { getSessionsDir, getSessionSandboxDir, SESSION_STATE_FILENAME } from '../config/paths.js';
 /**
  * Scans the sessions directory for resumable sessions.
  * Returns snapshots sorted by lastActivity descending (most recent first).

package/dist/mux/session-scanner.js.map

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

package/dist/{pipeline → observability}/llm-logger.d.ts

@@ -1,10 +1,15 @@
 /**
- * LLM Interaction Logger -- AI SDK middleware that captures all LLM
- * prompts and responses during the policy compilation pipeline.
+ * LLM Interaction Logger -- AI SDK middleware that captures LLM
+ * prompts and responses to a JSONL file.
+ *
+ * Used by any AI SDK call site that wants to record LLM interactions:
+ * the offline policy compilation pipeline (per-phase, full-prompt logging)
+ * as well as runtime call sites such as the sandbox and the agent session
+ * (long-running conversations, delta logging).
  *
  * Uses `wrapLanguageModel()` with a custom middleware that intercepts
  * every `doGenerate` call. The caller sets `context.stepName` before
- * each pipeline phase so logs are labeled without changing module APIs.
+ * each phase so logs are labeled without changing module APIs.
  *
  * Writes a single JSONL file with one entry per LLM call.
  */

package/dist/{pipeline → observability}/llm-logger.js

@@ -1,10 +1,15 @@
 /**
- * LLM Interaction Logger -- AI SDK middleware that captures all LLM
- * prompts and responses during the policy compilation pipeline.
+ * LLM Interaction Logger -- AI SDK middleware that captures LLM
+ * prompts and responses to a JSONL file.
+ *
+ * Used by any AI SDK call site that wants to record LLM interactions:
+ * the offline policy compilation pipeline (per-phase, full-prompt logging)
+ * as well as runtime call sites such as the sandbox and the agent session
+ * (long-running conversations, delta logging).
  *
  * Uses `wrapLanguageModel()` with a custom middleware that intercepts
  * every `doGenerate` call. The caller sets `context.stepName` before
- * each pipeline phase so logs are labeled without changing module APIs.
+ * each phase so logs are labeled without changing module APIs.
  *
  * Writes a single JSONL file with one entry per LLM call.
  */

package/dist/observability/llm-logger.js.map

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

package/dist/observe/observe-command.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI entry point for `ironcurtain observe`.
+ *
+ * Connects to the daemon's WebSocket server, subscribes to token
+ * stream events, and renders LLM output to stdout in real time.
+ *
+ * When stdout is a TTY (and --json is not set), the command uses a
+ * full-screen TUI with a Matrix rain panel and formatted text panel.
+ * Otherwise (pipe, --json, --no-tui), it falls back to the plain
+ * line-oriented renderer.
+ */
+export declare function runObserveCommand(argv: string[]): Promise<void>;

package/dist/observe/observe-command.js

@@ -0,0 +1,285 @@
+/**
+ * CLI entry point for `ironcurtain observe`.
+ *
+ * Connects to the daemon's WebSocket server, subscribes to token
+ * stream events, and renders LLM output to stdout in real time.
+ *
+ * When stdout is a TTY (and --json is not set), the command uses a
+ * full-screen TUI with a Matrix rain panel and formatted text panel.
+ * Otherwise (pipe, --json, --no-tui), it falls back to the plain
+ * line-oriented renderer.
+ */
+import chalk from 'chalk';
+import { checkHelp, parseArgsStrict } from '../cli-help.js';
+import { createDaemonClient, discoverDaemon, } from '../daemon-client/daemon-client.js';
+import { renderEventBatch, renderConnected, renderSessionEnded } from './observe-renderer.js';
+import { createObserveTui } from './observe-tui.js';
+// ---------------------------------------------------------------------------
+// Command spec (for --help)
+// ---------------------------------------------------------------------------
+const observeSpec = {
+    name: 'ironcurtain observe',
+    description: 'Watch live LLM token output for running sessions',
+    usage: [
+        'ironcurtain observe <label>             Watch a single session by label',
+        'ironcurtain observe --all               Watch all active sessions',
+    ],
+    options: [
+        { flag: 'all', description: 'Observe all active sessions' },
+        { flag: 'raw', description: 'Show all event types, not just text' },
+        { flag: 'debug', description: 'Show all events including protocol noise (implies --raw)' },
+        { flag: 'json', description: 'Output events as newline-delimited JSON' },
+        { flag: 'no-tui', description: 'Disable TUI mode (plain text output)' },
+    ],
+    examples: [
+        'ironcurtain observe 3                 # Watch session #3 (TUI mode)',
+        'ironcurtain observe --all             # Watch all sessions',
+        'ironcurtain observe 3 --no-tui        # Plain text output',
+        'ironcurtain observe 3 --raw           # Show tool use + message markers in TUI',
+        'ironcurtain observe 3 --debug         # Show everything including protocol noise',
+        'ironcurtain observe --all --json      # NDJSON output for piping',
+    ],
+};
+// ---------------------------------------------------------------------------
+// Plain renderer adapter
+// ---------------------------------------------------------------------------
+/**
+ * Wraps the existing plain-text renderer functions into the
+ * ObserveEventSink interface so observe-command can use either
+ * the TUI or the plain renderer interchangeably.
+ */
+function createPlainSink(renderOptions) {
+    return {
+        pushEvents(label, events) {
+            const output = renderEventBatch(label, events, renderOptions);
+            if (output)
+                process.stdout.write(output);
+        },
+        sessionEnded(label, reason) {
+            process.stderr.write(renderSessionEnded(label, reason));
+        },
+        connectionLost(reason) {
+            process.stderr.write(`\nConnection lost: ${reason}\n`);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Push event handler
+// ---------------------------------------------------------------------------
+/**
+ * Routes a single WebSocket push event to the event sink.
+ */
+function handlePushEvent(event, payload, sink, targetLabel, cleanup) {
+    if (event === 'session.token_stream') {
+        const label = payload.label;
+        const events = payload.events;
+        sink.pushEvents(label, events);
+        return;
+    }
+    if (event === 'session.ended') {
+        const endedLabel = payload.label;
+        const reason = payload.reason ?? 'unknown';
+        // For single-session mode, exit when the watched session ends
+        if (targetLabel !== undefined && endedLabel === targetLabel) {
+            sink.sessionEnded(endedLabel, reason);
+            cleanup();
+            return;
+        }
+        // For multi-session mode (--all), just show a notification
+        if (targetLabel === undefined) {
+            sink.sessionEnded(endedLabel, reason);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+export async function runObserveCommand(argv) {
+    const { values, positionals } = parseArgsStrict({
+        args: argv,
+        options: {
+            all: { type: 'boolean' },
+            raw: { type: 'boolean' },
+            debug: { type: 'boolean' },
+            json: { type: 'boolean' },
+            'no-tui': { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' },
+        },
+        allowPositionals: true,
+    }, observeSpec.name);
+    if (checkHelp(values, observeSpec))
+        return;
+    const allMode = values.all;
+    const labelArg = positionals[0];
+    const noTui = values['no-tui'];
+    // Validate argument combinations
+    if (!allMode && !labelArg) {
+        process.stderr.write(chalk.red('Error: provide a session label or --all\n'));
+        process.exit(1);
+    }
+    if (labelArg && allMode) {
+        process.stderr.write(chalk.red('Error: cannot combine a session label with --all\n'));
+        process.exit(1);
+    }
+    const label = labelArg ? parseInt(labelArg, 10) : undefined;
+    if (labelArg && (label === undefined || !Number.isFinite(label) || label < 1)) {
+        process.stderr.write(chalk.red(`Error: invalid session label "${labelArg}" (must be a positive integer)\n`));
+        process.exit(1);
+    }
+    const showLabel = !!allMode;
+    const debugMode = !!values.debug;
+    const renderOptions = {
+        raw: !!values.raw || debugMode,
+        json: !!values.json,
+        showLabel,
+    };
+    // Mode selection: TUI when stdout is a TTY and not in JSON or --no-tui mode
+    const isTty = process.stdout.isTTY;
+    const useTui = isTty && !renderOptions.json && !noTui;
+    // Create the event sink
+    let sink;
+    let tui = null;
+    if (useTui) {
+        tui = createObserveTui({ raw: !!values.raw || debugMode, showLabel, debug: debugMode });
+        tui.start();
+        sink = tui;
+    }
+    else {
+        sink = createPlainSink(renderOptions);
+    }
+    // Discover daemon connection info; "no daemon" surfaces identically to before.
+    const endpoint = discoverDaemon();
+    if (!endpoint) {
+        tui?.destroy();
+        printConnectionError();
+        process.exit(1);
+    }
+    const client = createDaemonClient({ endpoint });
+    try {
+        await client.connect();
+    }
+    catch {
+        // A connect failure is presentationally identical to "no daemon".
+        tui?.destroy();
+        printConnectionError();
+        process.exit(1);
+    }
+    await runObserveSession(client, { label, useTui, tui, sink });
+}
+/**
+ * Drives a connected {@link DaemonClient}: subscribes to the token stream,
+ * routes push events to the sink, and tears down on session end, involuntary
+ * disconnect, or Ctrl+C. Resolves exactly once.
+ */
+async function runObserveSession(client, ctx) {
+    const { label, useTui, tui, sink } = ctx;
+    await new Promise((resolve) => {
+        let closing = false;
+        let unsubscribeEvents = null;
+        let unsubscribeClose = null;
+        let sigHandler = null;
+        const removeSignalHandlers = () => {
+            if (sigHandler) {
+                process.off('SIGINT', sigHandler);
+                process.off('SIGTERM', sigHandler);
+                sigHandler = null;
+            }
+        };
+        // Deliberate teardown: destroy TUI, unsubscribe, then close the client.
+        // `client.close()` is what suppresses any onClose for this self-initiated
+        // disconnect, so connectionLost never fires for our own cleanup.
+        const cleanup = () => {
+            if (closing)
+                return;
+            closing = true;
+            // Destroy TUI before unsubscribing (restores terminal state).
+            tui?.destroy();
+            unsubscribeEvents?.();
+            unsubscribeClose?.();
+            removeSignalHandlers();
+            const unsubscribe = label !== undefined
+                ? client.call('sessions.unsubscribeTokenStream', { label })
+                : client.call('sessions.unsubscribeAllTokenStreams');
+            void unsubscribe
+                .catch(() => {
+                /* best-effort: we are tearing down regardless */
+            })
+                .then(() => client.close())
+                .catch(() => {
+                /* close() is idempotent and never throws meaningfully here */
+            })
+                .finally(resolve);
+        };
+        // Handle Ctrl+C -- only register for plain mode; TUI handles its own signals.
+        if (!useTui) {
+            sigHandler = () => {
+                process.stderr.write(chalk.dim('\n'));
+                cleanup();
+            };
+            process.on('SIGINT', sigHandler);
+            process.on('SIGTERM', sigHandler);
+        }
+        unsubscribeEvents = client.onEvent((e) => {
+            handlePushEvent(e.event, e.payload, sink, label, cleanup);
+        });
+        unsubscribeClose = client.onClose((info) => {
+            // An *involuntary* disconnect (our own cleanup uses client.close(), which
+            // never fires onClose). Mirror the old ws 'error'/'close' behavior.
+            if (closing)
+                return;
+            closing = true;
+            removeSignalHandlers();
+            sink.connectionLost(info.reason);
+            // In TUI mode the TUI's own 3-second exit timer manages shutdown; the
+            // promise resolves so runObserveCommand returns, but the TUI's frame loop
+            // and stdin keep the event loop alive until its destroy() fires.
+            resolve();
+        });
+        void subscribe(client, label, useTui)
+            .then((ok) => {
+            if (closing)
+                return;
+            if (ok) {
+                // In TUI mode the text panel shows state; in plain mode write to stderr.
+                if (!useTui)
+                    process.stderr.write(renderConnected(label));
+            }
+            else {
+                cleanup();
+            }
+        })
+            .catch(() => {
+            // `subscribe()` awaits `client.call()`, which REJECTS on a transport
+            // failure (e.g. the socket drops in the subscribe window). Without this
+            // handler that becomes an unhandled rejection. The onClose path already
+            // tears down on involuntary disconnect, so here we only need to clean up
+            // if we are not already closing (mirrors awaitDecisionPoint's guard).
+            if (closing)
+                return;
+            cleanup();
+        });
+    });
+}
+/**
+ * Subscribes to the token stream for `label` (or all sessions). Returns true on
+ * success; on an RPC error, writes the plain-mode error and returns false.
+ */
+async function subscribe(client, label, useTui) {
+    const result = label !== undefined
+        ? await client.call('sessions.subscribeTokenStream', { label })
+        : await client.call('sessions.subscribeAllTokenStreams');
+    if (result.ok)
+        return true;
+    // Match the old plain-mode behavior: TUI mode swallows the message (the panel
+    // surfaces state); plain mode prints it. Cleanup is the caller's job.
+    if (!useTui) {
+        process.stderr.write(chalk.red(`Error: ${result.message || 'subscription failed'}\n`));
+    }
+    return false;
+}
+/** Prints the shared "cannot connect to daemon" guidance to stderr. */
+function printConnectionError() {
+    process.stderr.write(chalk.red('Error: cannot connect to daemon. Is the daemon running with --web-ui?\n') +
+        chalk.dim('Start with: ironcurtain daemon --web-ui\n'));
+}
+//# sourceMappingURL=observe-command.js.map

package/dist/observe/observe-command.js.map

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

package/dist/observe/observe-renderer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Output formatting for `ironcurtain observe`.
+ *
+ * Pure functions that transform TokenStreamEvent batches into
+ * terminal-friendly text. No I/O or side effects -- all output
+ * is returned as strings.
+ */
+import type { TokenStreamEvent } from '../docker/token-stream-types.js';
+export interface RenderOptions {
+    /** Show all event kinds, not just text. */
+    readonly raw: boolean;
+    /** Output events as newline-delimited JSON. */
+    readonly json: boolean;
+    /** When set, prefix output lines with a session label. */
+    readonly showLabel: boolean;
+}
+/** Render a batch of events for a single session label. */
+export declare function renderEventBatch(label: number, events: readonly TokenStreamEvent[], options: RenderOptions): string;
+/** Render a single event. Returns null if the event should be suppressed. */
+export declare function renderEvent(label: number, event: TokenStreamEvent, options: RenderOptions): string | null;
+/** Render a connection header message. */
+export declare function renderConnected(label?: number): string;
+/** Render a session-ended notification. */
+export declare function renderSessionEnded(label: number, reason: string): string;

package/dist/observe/observe-renderer.js

@@ -0,0 +1,87 @@
+/**
+ * Output formatting for `ironcurtain observe`.
+ *
+ * Pure functions that transform TokenStreamEvent batches into
+ * terminal-friendly text. No I/O or side effects -- all output
+ * is returned as strings.
+ */
+import chalk from 'chalk';
+import { truncate } from '../mux/mux-renderer.js';
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+/** Render a batch of events for a single session label. */
+export function renderEventBatch(label, events, options) {
+    const parts = [];
+    for (const event of events) {
+        const rendered = renderEvent(label, event, options);
+        if (rendered !== null) {
+            parts.push(rendered);
+        }
+    }
+    return parts.join('');
+}
+/** Render a single event. Returns null if the event should be suppressed. */
+export function renderEvent(label, event, options) {
+    if (options.json) {
+        return renderJson(label, event);
+    }
+    return renderText(label, event, options);
+}
+// ---------------------------------------------------------------------------
+// JSON mode
+// ---------------------------------------------------------------------------
+function renderJson(label, event) {
+    return JSON.stringify({ label, ...event }) + '\n';
+}
+// ---------------------------------------------------------------------------
+// Text mode
+// ---------------------------------------------------------------------------
+function renderText(label, event, options) {
+    const prefix = options.showLabel ? chalk.dim(`[${label}] `) : '';
+    switch (event.kind) {
+        case 'text_delta':
+            return `${prefix}${event.text}`;
+        case 'tool_use':
+            if (!options.raw)
+                return null;
+            // Mid-stream input_json_delta fragments arrive with an empty toolName;
+            // skip them in plain mode so we do not emit noisy "[tool: ]" lines.
+            if (event.toolName === '')
+                return null;
+            return `${prefix}${chalk.cyan(`[tool: ${event.toolName}]`)} ${chalk.dim(truncate(event.inputDelta, 120))}\n`;
+        case 'message_start':
+            if (!options.raw)
+                return null;
+            return `${prefix}${chalk.green(`--- message start (${event.model}) ---`)}\n`;
+        case 'message_end':
+            if (!options.raw)
+                return null;
+            return `${prefix}${chalk.green(`--- message end (${event.stopReason}, ${event.inputTokens}+${event.outputTokens} tokens) ---`)}\n`;
+        case 'error':
+            return `${prefix}${chalk.red(`[error] ${event.message}`)}\n`;
+        case 'tool_result':
+            if (!options.raw)
+                return null;
+            return `${prefix}${chalk.dim(`[tool_result] ${truncate(event.content, 120)}`)}\n`;
+        case 'raw':
+            if (!options.raw)
+                return null;
+            return `${prefix}${chalk.dim(`[${event.eventType}] ${truncate(event.data, 120)}`)}\n`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Render a connection header message. */
+export function renderConnected(label) {
+    if (label !== undefined) {
+        return chalk.dim(`Observing session ${label}. Press Ctrl+C to stop.\n`);
+    }
+    return chalk.dim('Observing all sessions. Press Ctrl+C to stop.\n');
+}
+/** Render a session-ended notification. */
+export function renderSessionEnded(label, reason) {
+    return chalk.dim(`\nSession ${label} ended: ${reason}\n`);
+}
+//# sourceMappingURL=observe-renderer.js.map

package/dist/observe/observe-renderer.js.map

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

package/dist/observe/observe-tui-rain.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Rain engine for the observe TUI.
+ *
+ * Manages a pool of falling "drops" fed by a bounded token queue.
+ * Each drop carries characters from LLM token events (text, tool, error)
+ * or random katakana when idle, rendered with per-kind color gradients.
+ *
+ * Supports word drops (words that materialize horizontally, hold, then
+ * dissolve back into falling rain) and phase-driven ambient color
+ * transitions that shift the visual atmosphere based on agent state.
+ *
+ * Adapted from mux-splash.ts drop mechanics but uses continuous
+ * free-falling drops instead of target-locking drops.
+ */
+import { type AgentPhase, type RainToken, type TuiLayout, type WordDropSource } from './observe-tui-types.js';
+/** Public interface for the rain engine. */
+export interface RainEngine {
+    /** Push characters from token stream events into the rain queue. */
+    enqueueTokens(tokens: readonly RainToken[]): void;
+    /** Advance one frame: move drops, despawn dead ones, spawn new ones. */
+    tick(): void;
+    /** Produce ANSI string for the entire rain panel for this frame. */
+    render(): string;
+    /** Update dimensions after terminal resize; kill out-of-bounds drops. */
+    resize(layout: TuiLayout): void;
+    /** Current queue depth (for status bar display). */
+    readonly queueDepth: number;
+    /** Queue a word for materialization in the rain panel. */
+    enqueueWord(word: string, source: WordDropSource): void;
+    /** Set the current agent phase for ambient color selection. */
+    setPhase(phase: AgentPhase): void;
+}
+/** Random number generation functions, injectable for deterministic tests. */
+export interface RainRng {
+    /** Return a random float in [0, 1). */
+    random(): number;
+}
+export interface CreateRainEngineOptions {
+    layout: TuiLayout;
+    rng?: RainRng;
+}
+export declare function createRainEngine(options: CreateRainEngineOptions): RainEngine;