agent-nuvira 3.5.1 → 3.5.2

package/dist/cli/ui/presenter.js

@@ -0,0 +1,313 @@
+/**
+ * Presenter — decides HOW a model answer reaches the terminal, and owns the
+ * streaming lifecycle.
+ *
+ * THE ONE RULE: rich rendering is a TTY-only affordance. Pipes, CI, `--json-events`
+ * and `NUVIRA_UI=plain` all keep the historical plain-text behaviour, so a
+ * script consuming stdout is never handed escape codes or reflowed borders.
+ * That mirrors the fallback `PipelineBoard` already implements for its board.
+ *
+ * STREAMING. `AnswerStream` mounts Ink while tokens arrive. Ink's frame is
+ * transient, so `finish()` UNMOUNTS Ink and writes the final frame with the ANSI
+ * renderer — the same "unmount then write the final frame" step the board uses.
+ * The answer therefore survives in the transcript instead of being erased.
+ */
+import { createElement } from 'react';
+import { render } from 'ink';
+import { renderMarkdown, renderCard } from './render.js';
+import { attachShellCards, gitDiffCard, toolCallCard } from './cards.js';
+import { resolveTheme } from './theme.js';
+import { LiveAnswer } from './answer-view.js';
+import { isJsonLogMode } from '../../enterprise/log.js';
+/** True when the rich presentation layer may be used for this stream. */
+export function shouldUseRichUi(opts = {}) {
+    const env = opts.env ?? process.env;
+    if (isJsonLogMode())
+        return false;
+    const mode = (env.NUVIRA_UI || '').trim().toLowerCase();
+    if (mode === 'plain' || mode === 'text' || mode === 'off')
+        return false;
+    if (opts.tty !== undefined)
+        return opts.tty;
+    const stream = opts.stream ?? process.stdout;
+    return stream.isTTY === true;
+}
+function resolve(opts) {
+    const env = opts.env ?? process.env;
+    const stream = opts.stream ?? process.stdout;
+    const { name, theme } = resolveTheme(env);
+    const width = opts.width ?? stream.columns ?? 80;
+    const rich = shouldUseRichUi(opts);
+    const color = opts.color ?? (name !== 'none' && !('NO_COLOR' in env));
+    return { rich, theme: opts.theme ?? theme, themeName: name, width, color, stream };
+}
+/**
+ * Render a complete markdown answer to the string that would be printed.
+ *
+ * The non-rich path is a BYTE-IDENTICAL passthrough: a piped or CI consumer
+ * must receive exactly what it received before this layer existed, so the
+ * markdown is never rewritten on the way out.
+ */
+export function renderAnswer(markdown, opts = {}) {
+    if (!markdown)
+        return '';
+    const r = resolve(opts);
+    if (!r.rich)
+        return markdown;
+    return renderMarkdown(markdown, { theme: r.theme, width: r.width, color: r.color });
+}
+/**
+ * Print a complete answer. Returns the written string so callers (and tests)
+ * can assert on exactly what a surface produced.
+ *
+ * The non-rich path deliberately goes through `console.log` when no stream was
+ * injected: that is the channel this CLI has always used for answers, and both
+ * the test suite and any log-capturing wrapper depend on it. Rich output is
+ * written straight to the stream because it is a composed frame, not a line.
+ */
+export function presentAnswer(markdown, opts = {}) {
+    if (!markdown)
+        return '';
+    const r = resolve(opts);
+    if (!r.rich) {
+        if (opts.stream)
+            r.stream.write(markdown + (markdown.endsWith('\n') ? '' : '\n'));
+        else
+            console.log(markdown);
+        return markdown;
+    }
+    const out = renderMarkdown(markdown, { theme: r.theme, width: r.width, color: r.color });
+    r.stream.write(out + (out.endsWith('\n') ? '' : '\n'));
+    return out;
+}
+/** Print a structured card (tool call, shell, diff, plan). */
+export function presentCard(card, opts = {}) {
+    const r = resolve(opts);
+    const out = renderCard(card, { theme: r.theme, width: r.width, color: r.color });
+    r.stream.write(out + '\n');
+    return out;
+}
+/**
+ * A card sink for a surface with NO live Ink frame (the `execute` loop arm).
+ *
+ * Cards are written straight to the transcript as they arrive — no pause/resume
+ * is needed because nothing else owns the terminal. The finished tool call is
+ * the one that gets a card; `started` is ignored because the outcome is what a
+ * reader needs and a card that is replaced a moment later is noise.
+ *
+ * Off a real terminal this is INERT (no overrides, nothing written), so a piped
+ * or CI `execute` keeps the exact bytes it produced before cards existed.
+ */
+export function createCardSink(opts = {}) {
+    if (!shouldUseRichUi(opts))
+        return { overrides: {}, stop: () => { } };
+    const write = (card) => {
+        presentCard(card, opts);
+    };
+    return {
+        overrides: {
+            onToolCall: (phase, info) => {
+                if (phase === 'called')
+                    write(toolCallCard(info));
+            },
+            onGitDiff: (payload) => write(gitDiffCard(payload)),
+        },
+        stop: attachShellCards(write),
+    };
+}
+/**
+ * Live-streaming answer view.
+ *
+ * Usage:
+ *   const stream = new AnswerStream({ header: 'nuvira · groq/llama-3.3-70b' });
+ *   stream.begin();
+ *   // ... onToken: (t) => stream.append(t) ...
+ *   const final = stream.finish();
+ */
+export class AnswerStream {
+    r;
+    text = '';
+    meta;
+    ink = null;
+    flushTimer = null;
+    pending = false;
+    closed = false;
+    constructor(meta = {}, opts = {}) {
+        this.r = resolve(opts);
+        this.meta = meta;
+    }
+    /** Begin the live view (mounts Ink on a TTY; a no-op otherwise). */
+    begin(meta = {}) {
+        this.meta = { ...this.meta, ...meta };
+        if (this.r.rich)
+            this.mount();
+        return this;
+    }
+    /** Append streamed text. Safe to call with empty/undefined deltas. */
+    append(delta) {
+        if (delta)
+            this.text += delta;
+        this.scheduleFlush();
+        return this;
+    }
+    /** Replace the inline note (e.g. "thinking…" → "writing…"). */
+    setNote(note) {
+        this.meta = { ...this.meta, note };
+        this.scheduleFlush();
+        return this;
+    }
+    /**
+     * Discard the text accumulated so far.
+     *
+     * Needed because `onToken` fires for EVERY model call in the tool loop, not
+     * only the final answer: without this, the next step's answer would be
+     * appended onto the previous step's preamble.
+     */
+    reset() {
+        this.text = '';
+        this.scheduleFlush();
+        return this;
+    }
+    /** The text accumulated so far. */
+    get current() {
+        return this.text;
+    }
+    /**
+     * Suspend the live view so static output can be written below it.
+     *
+     * Ink owns the frame, so anything printed while it is mounted collides with
+     * the next repaint. Cards are archived output (they must survive), so the
+     * frame is unmounted, the card written, then the frame remounted — the same
+     * stop/start discipline `PipelineBoard` uses around interactive prompts.
+     */
+    pause() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+            this.pending = false;
+        }
+        if (this.ink) {
+            try {
+                this.ink.unmount();
+            }
+            catch {
+                /* best-effort */
+            }
+            this.ink = null;
+        }
+        return this;
+    }
+    /** Remount the live view after {@link pause} (no-op when nothing was mounted). */
+    resume() {
+        if (!this.r.rich || this.closed)
+            return this;
+        this.mount();
+        this.repaint();
+        return this;
+    }
+    /**
+     * Print a card into the transcript, above the live view.
+     *
+     * Rich terminals only: a piped or CI stream keeps the exact bytes it produced
+     * before cards existed, which is also why the card is not attempted at all
+     * when rich output is unavailable.
+     */
+    card(card) {
+        if (!this.r.rich)
+            return;
+        const wasMounted = this.ink !== null;
+        if (wasMounted)
+            this.pause();
+        const out = renderCard(card, { theme: this.r.theme, width: this.r.width, color: this.r.color });
+        this.r.stream.write(out + '\n');
+        if (wasMounted)
+            this.resume();
+    }
+    mount() {
+        try {
+            this.ink = render(this.element(), {
+                stdout: this.r.stream,
+                patchConsole: false,
+                // The CLI owns SIGINT (the REPL installs its own handler); letting Ink
+                // also grab Ctrl+C would race that handler and can exit the process.
+                exitOnCtrlC: false,
+            });
+        }
+        catch {
+            // Rendering must never break a turn — fall back to no live view.
+            this.ink = null;
+        }
+    }
+    element(note) {
+        return createElement(LiveAnswer, {
+            text: this.text,
+            theme: this.r.theme,
+            header: this.meta.header,
+            headerColor: this.meta.headerColor,
+            note: note ?? this.meta.note,
+        });
+    }
+    /** Coalesce high-frequency token updates into ~20fps repaints. */
+    scheduleFlush() {
+        if (!this.ink || this.closed)
+            return;
+        if (this.pending)
+            return;
+        this.pending = true;
+        this.flushTimer = setTimeout(() => {
+            this.pending = false;
+            this.flushTimer = null;
+            this.repaint();
+        }, 50);
+        this.flushTimer.unref?.();
+    }
+    repaint() {
+        if (!this.ink)
+            return;
+        try {
+            this.ink.rerender(this.element());
+        }
+        catch {
+            /* a repaint failure must not break the stream */
+        }
+    }
+    /**
+     * Finish the stream: unmount the transient Ink frame, then write the final
+     * archival frame. Returns the final rendered string.
+     *
+     * `archive: false` unmounts WITHOUT printing a frame. A caller that will
+     * print the authoritative answer itself (the REPL, which renders the final
+     * `answer.content` rather than the raw token stream) must use it, or the
+     * answer would be printed twice.
+     */
+    finish(opts = {}) {
+        const archive = opts.archive ?? true;
+        if (this.closed)
+            return '';
+        this.closed = true;
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.ink) {
+            try {
+                this.ink.unmount();
+            }
+            catch {
+                /* best-effort */
+            }
+            this.ink = null;
+        }
+        if (!archive)
+            return '';
+        // The final frame is the archival output and is always printed. Non-rich
+        // streams get the raw markdown, byte-identical to the pre-layer behaviour.
+        const out = this.r.rich
+            ? renderMarkdown(this.text, { theme: this.r.theme, width: this.r.width, color: this.r.color })
+            : this.text;
+        if (out)
+            this.r.stream.write(out + (out.endsWith('\n') ? '' : '\n'));
+        return out;
+    }
+}
+//# sourceMappingURL=presenter.js.map

package/dist/cli/ui/presenter.js.map

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

package/dist/cli/ui/render.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ANSI renderer — turns the shared markdown AST into a styled terminal string.
+ *
+ * This is the workhorse for two paths:
+ *   - the FINAL frame of a streamed answer (the presenter unmounts Ink, then
+ *     writes this string, exactly as `PipelineBoard.finish()` writes its final
+ *     frame — so the answer is not erased by Ink's unmount)
+ *   - NON-TTY output (pipes, CI, `--json-events`), where Ink must not mount
+ *
+ * It is intentionally a PURE function of (blocks, options): no globals, no
+ * terminal probing. Width and colour are passed in, so tests assert on plain
+ * strings with `color: false`.
+ */
+import { type Block } from './markdown.js';
+import { type Theme, type ThemeRole } from './theme.js';
+export interface RenderOptions {
+    theme?: Theme;
+    /** Terminal width (columns). Defaults to 80. */
+    width?: number;
+    /** Emit ANSI colour. Defaults to true (chalk still honours its own level). */
+    color?: boolean;
+}
+/** Visible width of a string: ANSI stripped, wide glyphs counted as two. */
+export declare function visibleWidth(s: string): number;
+/** Render the block AST to a string. */
+export declare function renderBlocks(blocks: readonly Block[], opts?: RenderOptions): string;
+/**
+ * A card body line. A bare string is rendered muted; the object form lets a
+ * caller colour one line — which is what makes a git diff readable (added /
+ * removed / hunk lines each take their own role).
+ */
+export interface CardLine {
+    text: string;
+    role?: ThemeRole;
+}
+export interface CardOptions {
+    icon?: string;
+    title: string;
+    lines?: Array<string | CardLine>;
+    /** Accent role for the title. */
+    role?: ThemeRole;
+}
+/**
+ * A bordered card for structured events (tool call, shell, diff, plan).
+ *
+ * Kept separate from block rendering because a card is a single visual unit
+ * whose height is computable before it is placed in a live view.
+ */
+export declare function renderCard(card: CardOptions, opts?: RenderOptions): string;
+/** Render a markdown string to an ANSI string. */
+export declare function renderMarkdown(md: string, opts?: RenderOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/cli/ui/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAiB,KAAK,KAAK,EAA8B,MAAM,eAAe,CAAC;AACtF,OAAO,EAAc,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAqB9C;AA0QD,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAkDvF;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IACjC,iCAAiC;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAwB9E;AAeD,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAE3E"}