agent-nuvira 3.5.1 → 3.5.2

package/dist/cli/ui/markdown.js

@@ -0,0 +1,292 @@
+/**
+ * Markdown → shared AST parser.
+ *
+ * ONE PARSE, TWO RENDERERS. The CLI needs to show a model's markdown reply both
+ * live (Ink) and as a final frame / non-TTY fallback (a plain ANSI string).
+ * Parsing twice would guarantee drift, so the parse lives here and each renderer
+ * is a pure consumer of {@link Block}[]:
+ *
+ *   markdown.ts  →  Block[]  →  render.ts      (ANSI string)
+ *                            →  answer-view.tsx (Ink elements)
+ *
+ * A single AST also makes the behaviour testable without a terminal: assertions
+ * are made against the parsed structure, not against bytes of coloured output.
+ *
+ * SCOPE. This is a deliberately small subset — headings, paragraphs, fenced
+ * code, ordered/unordered (nested) lists, pipe tables, block quotes and rules,
+ * with inline strong/em/code/link. That is what coding-agent answers actually
+ * use; anything else degrades to a paragraph. It is not a CommonMark engine.
+ */
+import { highlightCode } from './highlight.js';
+const FENCE_RE = /^\s*(`{3,}|~{3,})\s*([\w+#.-]*)\s*$/;
+const HEADING_RE = /^(#{1,6})\s+(.*?)\s*#*\s*$/;
+const HR_RE = /^\s*(?:-{3,}|\*{3,}|_{3,})\s*$/;
+const BULLET_RE = /^(\s*)([-*+])\s+(.*)$/;
+const ORDERED_RE = /^(\s*)(\d{1,9})[.)]\s+(.*)$/;
+const QUOTE_RE = /^\s*>\s?(.*)$/;
+const TABLE_SEP_RE = /^\s*\|?\s*:?-{1,}:?\s*(\|\s*:?-{1,}:?\s*)*\|?\s*$/;
+/** Parse a markdown string into blocks. */
+export function parseMarkdown(md) {
+    const lines = (md ?? '').replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    return parseBlocks(lines);
+}
+function parseBlocks(lines) {
+    const blocks = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Blank
+        if (line.trim() === '') {
+            i++;
+            continue;
+        }
+        // Fenced code
+        const fence = FENCE_RE.exec(line);
+        if (fence) {
+            const marker = fence[1][0];
+            const lang = fence[2] || '';
+            const body = [];
+            i++;
+            while (i < lines.length) {
+                const closing = new RegExp(`^\\s*${marker === '`' ? '`' : '~'}{3,}\\s*$`);
+                if (closing.test(lines[i])) {
+                    i++;
+                    break;
+                }
+                body.push(lines[i]);
+                i++;
+            }
+            const code = body.join('\n');
+            blocks.push({ type: 'code', lang, code, tokens: highlightCode(code, lang) });
+            continue;
+        }
+        // Heading
+        const heading = HEADING_RE.exec(line);
+        if (heading && !line.trimStart().startsWith('>')) {
+            blocks.push({ type: 'heading', level: heading[1].length, inlines: parseInline(heading[2]) });
+            i++;
+            continue;
+        }
+        // Horizontal rule
+        if (HR_RE.test(line)) {
+            blocks.push({ type: 'hr' });
+            i++;
+            continue;
+        }
+        // Block quote
+        if (QUOTE_RE.test(line)) {
+            const inner = [];
+            while (i < lines.length && (QUOTE_RE.test(lines[i]) || lines[i].trim() === '')) {
+                if (lines[i].trim() === '') {
+                    // A blank line ends the quote unless another '>' follows.
+                    if (!QUOTE_RE.test(lines[i + 1] ?? ''))
+                        break;
+                    inner.push('');
+                }
+                else {
+                    inner.push(QUOTE_RE.exec(lines[i])[1]);
+                }
+                i++;
+            }
+            blocks.push({ type: 'quote', blocks: parseBlocks(inner) });
+            continue;
+        }
+        // List (unordered or ordered)
+        if (BULLET_RE.test(line) || ORDERED_RE.test(line)) {
+            const ordered = ORDERED_RE.test(line) && !BULLET_RE.test(line);
+            const start = ordered ? Number(ORDERED_RE.exec(line)[2]) : 1;
+            const items = [];
+            while (i < lines.length) {
+                const bullet = BULLET_RE.exec(lines[i]);
+                const num = ORDERED_RE.exec(lines[i]);
+                if (!bullet && !num)
+                    break;
+                const m = bullet ?? num;
+                const indent = m[1].length;
+                const isOrdered = !bullet;
+                items.push({
+                    inlines: parseInline(m[3]),
+                    depth: Math.min(4, Math.floor(indent / 2)),
+                    ordered: isOrdered,
+                    index: isOrdered ? Number(num[2]) : 0,
+                });
+                i++;
+                // Skip blank separator lines between items.
+                if (lines[i]?.trim() === '' && (BULLET_RE.test(lines[i + 1] ?? '') || ORDERED_RE.test(lines[i + 1] ?? ''))) {
+                    i++;
+                }
+            }
+            blocks.push({ type: 'list', ordered, start, items });
+            continue;
+        }
+        // Table (a header row followed by a separator row)
+        if (line.includes('|') && TABLE_SEP_RE.test(lines[i + 1] ?? '')) {
+            const header = splitRow(line);
+            const align = parseAlign(lines[i + 1]);
+            const rows = [];
+            i += 2;
+            while (i < lines.length && lines[i].includes('|') && lines[i].trim() !== '') {
+                rows.push(splitRow(lines[i]));
+                i++;
+            }
+            blocks.push({ type: 'table', header, rows, align });
+            continue;
+        }
+        // Paragraph — consecutive non-blank, non-structural lines.
+        const para = [];
+        while (i < lines.length && lines[i].trim() !== '' && !isBlockStart(lines[i], lines[i + 1])) {
+            para.push(lines[i].trim());
+            i++;
+        }
+        if (para.length) {
+            blocks.push({ type: 'paragraph', inlines: parseInline(para.join(' ')) });
+        }
+        else {
+            // Defensive: never loop forever on an unexpected line.
+            i++;
+        }
+    }
+    return blocks;
+}
+function isBlockStart(line, next) {
+    return (FENCE_RE.test(line) ||
+        HEADING_RE.test(line) ||
+        HR_RE.test(line) ||
+        QUOTE_RE.test(line) ||
+        BULLET_RE.test(line) ||
+        ORDERED_RE.test(line) ||
+        (line.includes('|') && TABLE_SEP_RE.test(next ?? '')));
+}
+function splitRow(line) {
+    const trimmed = line.trim().replace(/^\|/, '').replace(/\|$/, '');
+    return trimmed.split('|').map((cell) => parseInline(cell.trim()));
+}
+function parseAlign(sep) {
+    const cells = sep.trim().replace(/^\|/, '').replace(/\|$/, '').split('|');
+    return cells.map((c) => {
+        const t = c.trim();
+        const left = t.startsWith(':');
+        const right = t.endsWith(':');
+        if (left && right)
+            return 'center';
+        if (right)
+            return 'right';
+        if (left)
+            return 'left';
+        return null;
+    });
+}
+/**
+ * Parse inline markdown into styled runs.
+ *
+ * Deliberately non-greedy and pragmatic: an unmatched marker such as a lone `*`
+ * or a `[` without `](…)` is emitted as literal text, never swallowed, so
+ * ordinary prose containing asterisks and brackets survives intact.
+ */
+export function parseInline(text) {
+    const out = [];
+    let buf = '';
+    const flush = () => {
+        if (buf) {
+            out.push({ kind: 'text', text: buf });
+            buf = '';
+        }
+    };
+    let i = 0;
+    while (i < text.length) {
+        const rest = text.slice(i);
+        // Inline code — highest precedence, spans markers as literals.
+        if (text[i] === '`') {
+            const end = text.indexOf('`', i + 1);
+            if (end !== -1) {
+                flush();
+                out.push({ kind: 'code', text: text.slice(i + 1, end) });
+                i = end + 1;
+                continue;
+            }
+        }
+        // Strong: ** or __
+        const strong = /^(\*\*|__)([\s\S]+?)\1/.exec(rest);
+        if (strong) {
+            flush();
+            out.push({ kind: 'strong', children: parseInline(strong[2]) });
+            i += strong[0].length;
+            continue;
+        }
+        // Emphasis: * or _
+        const em = /^(\*|_)([^\s*_][\s\S]*?)\1/.exec(rest);
+        if (em) {
+            flush();
+            out.push({ kind: 'em', children: parseInline(em[2]) });
+            i += em[0].length;
+            continue;
+        }
+        // Link: [text](href)
+        const link = /^\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/.exec(rest);
+        if (link) {
+            flush();
+            out.push({ kind: 'link', text: link[1], href: link[2] });
+            i += link[0].length;
+            continue;
+        }
+        buf += text[i];
+        i++;
+    }
+    flush();
+    return out.length ? out : [{ kind: 'text', text }];
+}
+/** Plain text of an inline run — used for measuring and for non-colour output. */
+export function inlineText(inlines) {
+    return inlines
+        .map((inl) => {
+        switch (inl.kind) {
+            case 'text':
+            case 'code':
+                return inl.text;
+            case 'link':
+                return inl.text;
+            case 'strong':
+            case 'em':
+                return inlineText(inl.children);
+        }
+    })
+        .join('');
+}
+/** Plain text of a block tree — a markdown-aware fallback when colour is off. */
+export function blocksToPlainText(blocks) {
+    const lines = [];
+    for (const b of blocks) {
+        switch (b.type) {
+            case 'heading':
+                lines.push(inlineText(b.inlines), '');
+                break;
+            case 'paragraph':
+                lines.push(inlineText(b.inlines), '');
+                break;
+            case 'code':
+                lines.push(...b.code.split('\n'), '');
+                break;
+            case 'hr':
+                lines.push('', '');
+                break;
+            case 'quote':
+                lines.push(blocksToPlainText(b.blocks).trimEnd(), '');
+                break;
+            case 'list':
+                b.items.forEach((it, idx) => {
+                    const bullet = it.ordered ? `${it.index || b.start + idx}. ` : '- ';
+                    lines.push('  '.repeat(it.depth) + bullet + inlineText(it.inlines));
+                });
+                lines.push('');
+                break;
+            case 'table':
+                lines.push(b.header.map(inlineText).join(' | '));
+                for (const row of b.rows)
+                    lines.push(row.map(inlineText).join(' | '));
+                lines.push('');
+                break;
+        }
+    }
+    return lines.join('\n').replace(/\n{3,}/g, '\n\n').replace(/\n+$/, '\n');
+}
+//# sourceMappingURL=markdown.js.map

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

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

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

@@ -0,0 +1,147 @@
+/**
+ * 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 { type CardOptions } from './render.js';
+import { type ToolCallCardInfo } from './cards.js';
+import { type Theme, type ThemeRole } from './theme.js';
+import type { GitDiffPayload } from '../../tools/git-tool.js';
+export interface PresenterOptions {
+    stream?: NodeJS.WriteStream;
+    /** Force rich/plain instead of probing the stream. */
+    tty?: boolean;
+    theme?: Theme;
+    width?: number;
+    color?: boolean;
+    env?: NodeJS.ProcessEnv;
+}
+/** True when the rich presentation layer may be used for this stream. */
+export declare function shouldUseRichUi(opts?: PresenterOptions): boolean;
+/**
+ * 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 declare function renderAnswer(markdown: string, opts?: PresenterOptions): string;
+/**
+ * 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 declare function presentAnswer(markdown: string, opts?: PresenterOptions): string;
+/** Print a structured card (tool call, shell, diff, plan). */
+export declare function presentCard(card: CardOptions, opts?: PresenterOptions): string;
+/** The turn options a card sink supplies (shape-compatible with the chat and
+ *  loop-executor `onToolCall` / `onGitDiff` seams). */
+export interface CardSinkOverrides {
+    onToolCall?: (phase: 'started' | 'called', info: ToolCallCardInfo) => void;
+    onGitDiff?: (payload: GitDiffPayload) => void;
+}
+/**
+ * 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 declare function createCardSink(opts?: PresenterOptions): {
+    overrides: CardSinkOverrides;
+    stop: () => void;
+};
+export interface StreamMeta {
+    header?: string;
+    headerColor?: ThemeRole;
+    note?: string;
+}
+/**
+ * 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 declare class AnswerStream {
+    private readonly r;
+    private text;
+    private meta;
+    private ink;
+    private flushTimer;
+    private pending;
+    private closed;
+    constructor(meta?: StreamMeta, opts?: PresenterOptions);
+    /** Begin the live view (mounts Ink on a TTY; a no-op otherwise). */
+    begin(meta?: StreamMeta): this;
+    /** Append streamed text. Safe to call with empty/undefined deltas. */
+    append(delta: string | undefined): this;
+    /** Replace the inline note (e.g. "thinking…" → "writing…"). */
+    setNote(note: string | undefined): 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;
+    /** The text accumulated so far. */
+    get current(): string;
+    /**
+     * 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(): this;
+    /** Remount the live view after {@link pause} (no-op when nothing was mounted). */
+    resume(): 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: CardOptions): void;
+    private mount;
+    private element;
+    /** Coalesce high-frequency token updates into ~20fps repaints. */
+    private scheduleFlush;
+    private repaint;
+    /**
+     * 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?: {
+        archive?: boolean;
+    }): string;
+}
+//# sourceMappingURL=presenter.d.ts.map

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

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