agent-nuvira 3.5.1 → 3.5.2

package/dist/cli/ui/cards.js

@@ -0,0 +1,141 @@
+/**
+ * Card builders — one pure function per event family.
+ *
+ * Cards are how a turn SHOWS what it did instead of only saying it: a tool call,
+ * a shell command and a git diff each become a bordered block the user can read
+ * at a glance. Keeping the mapping pure (event → `CardOptions`) means the card
+ * content is unit-testable without a terminal, and both surfaces — chat and
+ * execute — render the SAME card for the same event, so they cannot drift.
+ *
+ * These functions only shape data; the rendering (borders, colour, width) lives
+ * in `render.ts` / `answer-view.tsx`.
+ */
+import { EventNames, getEventBus } from '../../observability/event-bus.js';
+/** How many arguments to preview on a tool card before summarising the rest. */
+const MAX_ARG_PREVIEWS = 3;
+/** Bounds so a huge diff or argument list cannot flood the transcript. */
+const MAX_DIFF_FILES = 4;
+const MAX_DIFF_LINES_PER_FILE = 12;
+const MAX_DETAIL_CHARS = 72;
+/** Compact duration: `840ms`, `3.2s`, `1m 04s`. */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return '?';
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const s = ms / 1000;
+    if (s < 60)
+        return `${s.toFixed(1)}s`;
+    const m = Math.floor(s / 60);
+    const rest = Math.round(s - m * 60);
+    return `${m}m ${String(rest).padStart(2, '0')}s`;
+}
+/** One-line, bounded preview of a value — never the whole multi-line blob. */
+function clip(text, max = MAX_DETAIL_CHARS) {
+    const first = text.replace(/\s+/g, ' ').trim();
+    return first.length > max ? first.slice(0, max - 1) + '…' : first;
+}
+function previewArgs(args) {
+    if (!args)
+        return [];
+    const entries = Object.entries(args).filter(([, v]) => v !== undefined && v !== null);
+    return entries.slice(0, MAX_ARG_PREVIEWS).map(([k, v]) => ({
+        text: `${k}: ${clip(typeof v === 'string' ? v : JSON.stringify(v))}`,
+        role: 'muted',
+    }));
+}
+/**
+ * A tool call. Rendered on COMPLETION (the `called` phase), because only then is
+ * the outcome known — a card that says "running" and is immediately replaced by
+ * an outcome is noise in a transcript.
+ */
+export function toolCallCard(info) {
+    const ok = info.ok !== false;
+    const lines = [...previewArgs(info.args)];
+    const detail = info.error || info.result;
+    if (detail)
+        lines.push({ text: clip(detail), role: ok ? 'muted' : 'error' });
+    const ms = typeof info.durationMs === 'number' ? ` · ${formatDuration(info.durationMs)}` : '';
+    return {
+        icon: ok ? '🔧' : '⛔',
+        title: `tool · ${info.tool}${ms}`,
+        role: ok ? 'info' : 'error',
+        lines,
+    };
+}
+/** A finished shell command, with the failure reason when there is one. */
+export function shellCard(payload) {
+    const ok = payload.success ?? payload.exitCode === 0;
+    const lines = [{ text: `$ ${clip(payload.command, 100)}`, role: 'muted' }];
+    if (!ok) {
+        const why = (payload.stderr || payload.stdout || '').trim();
+        if (why)
+            lines.push({ text: clip(why), role: 'error' });
+        else if (payload.timedOut)
+            lines.push({ text: 'timed out', role: 'error' });
+        else if (payload.aborted)
+            lines.push({ text: 'aborted', role: 'error' });
+    }
+    const bits = [`exit ${payload.exitCode ?? (ok ? 0 : '?')}`];
+    if (typeof payload.durationMs === 'number')
+        bits.push(formatDuration(payload.durationMs));
+    return {
+        icon: ok ? '💻' : '💥',
+        title: `shell · ${bits.join(' · ')}`,
+        role: ok ? 'info' : 'error',
+        lines,
+    };
+}
+/** Colour role for one line of a unified diff. */
+export function diffLineRole(line) {
+    if (line.startsWith('@@'))
+        return 'diffHunk';
+    if (line.startsWith('+++') || line.startsWith('---'))
+        return 'muted';
+    if (line.startsWith('+'))
+        return 'diffAdd';
+    if (line.startsWith('-'))
+        return 'diffDel';
+    return 'muted';
+}
+/** A `git diff`, one block per changed file, lines coloured by kind. */
+export function gitDiffCard(payload) {
+    const lines = [];
+    for (const file of payload.files.slice(0, MAX_DIFF_FILES)) {
+        lines.push({ text: file.path, role: 'accent' });
+        const body = file.body.split('\n');
+        for (const l of body.slice(0, MAX_DIFF_LINES_PER_FILE)) {
+            lines.push({ text: `  ${l}`, role: diffLineRole(l) });
+        }
+        if (body.length > MAX_DIFF_LINES_PER_FILE) {
+            lines.push({ text: `  … ${body.length - MAX_DIFF_LINES_PER_FILE} more line(s)`, role: 'faint' });
+        }
+    }
+    const more = payload.files.length > MAX_DIFF_FILES ? ` (+${payload.files.length - MAX_DIFF_FILES} more file(s))` : '';
+    return { icon: '📝', title: `git diff · ${payload.summary}${more}`, role: 'accent', lines };
+}
+/**
+ * Subscribe to shell completion events for the duration of one turn.
+ *
+ * Shell is the one event family driven by the GLOBAL bus rather than a turn
+ * callback: `runShell` emits it from deep inside `utils/shell.ts`, which no
+ * surface owns. Returns the unsubscribe function the caller must invoke (the
+ * turn's `stop()` does).
+ */
+export function attachShellCards(onCard, bus) {
+    try {
+        const source = bus ?? getEventBus();
+        return source.on(EventNames.EXEC_SHELL_END, (record) => {
+            try {
+                onCard(shellCard(record.data));
+            }
+            catch {
+                // A card must never break the turn.
+            }
+        });
+    }
+    catch {
+        return () => { };
+    }
+}
+//# sourceMappingURL=cards.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Syntax highlighting — a small, dependency-free, line-based tokenizer.
+ *
+ * WHY NOT A LIBRARY. The codebase deliberately keeps a small runtime dependency
+ * footprint, and the CLI only needs to colour the ~10 languages that appear in
+ * model answers (ts/js, json, shell, python, go, rust, sql, yaml, css). A full
+ * TextMate/Shiki grammar is orders of magnitude heavier than that job. This
+ * tokenizer is heuristic by design: it never needs to be *correct*, only to make
+ * code readable, and every rule is a pure function with a unit test.
+ *
+ * The output is a per-line, per-token structure of `{ text, kind }`. Both the
+ * ANSI renderer and the Ink view map `kind` through the shared theme, so code
+ * colouring is identical on both surfaces.
+ */
+export type TokenKind = 'plain' | 'keyword' | 'boolean' | 'string' | 'number' | 'comment' | 'func' | 'type' | 'punct' | 'operator';
+export interface Token {
+    text: string;
+    kind: TokenKind;
+}
+/** Per-line token stream. */
+export type TokenizedCode = Token[][];
+/** Map many aliases to the canonical language key used by {@link highlightCode}. */
+export declare function normalizeLang(raw: string): string;
+/**
+ * Highlight a code block into per-line tokens.
+ *
+ * Block comments (`/​* ... *​/`) and backtick template literals are tracked across
+ * lines through {@link LineState}, so a multi-line comment is coloured as a
+ * comment on every line rather than only the first.
+ */
+export declare function highlightCode(code: string, lang: string): TokenizedCode;
+//# sourceMappingURL=highlight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/highlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,6BAA6B;AAC7B,MAAM,MAAM,aAAa,GAAG,KAAK,EAAE,EAAE,CAAC;AA+CtC,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcjD;AAwBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUvE"}

package/dist/cli/ui/highlight.js

@@ -0,0 +1,261 @@
+/**
+ * Syntax highlighting — a small, dependency-free, line-based tokenizer.
+ *
+ * WHY NOT A LIBRARY. The codebase deliberately keeps a small runtime dependency
+ * footprint, and the CLI only needs to colour the ~10 languages that appear in
+ * model answers (ts/js, json, shell, python, go, rust, sql, yaml, css). A full
+ * TextMate/Shiki grammar is orders of magnitude heavier than that job. This
+ * tokenizer is heuristic by design: it never needs to be *correct*, only to make
+ * code readable, and every rule is a pure function with a unit test.
+ *
+ * The output is a per-line, per-token structure of `{ text, kind }`. Both the
+ * ANSI renderer and the Ink view map `kind` through the shared theme, so code
+ * colouring is identical on both surfaces.
+ */
+const KEYWORDS = {
+    js: [
+        'as', 'async', 'await', 'break', 'case', 'catch', 'class', 'const', 'continue', 'default',
+        'delete', 'do', 'else', 'enum', 'export', 'extends', 'finally', 'for', 'from', 'function',
+        'get', 'if', 'implements', 'import', 'in', 'instanceof', 'interface', 'let', 'new', 'of',
+        'package', 'private', 'protected', 'public', 'readonly', 'return', 'set', 'static', 'super',
+        'switch', 'this', 'throw', 'try', 'typeof', 'var', 'void', 'while', 'with', 'yield',
+        'type', 'namespace', 'declare', 'abstract', 'satisfies', 'keyof', 'infer',
+    ],
+    python: [
+        'and', 'as', 'assert', 'async', 'await', 'break', 'class', 'continue', 'def', 'del', 'elif',
+        'else', 'except', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda',
+        'nonlocal', 'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield',
+    ],
+    shell: [
+        'case', 'do', 'done', 'elif', 'else', 'esac', 'fi', 'for', 'function', 'if', 'in', 'select',
+        'then', 'until', 'while', 'export', 'local', 'return', 'source', 'echo',
+    ],
+    go: [
+        'break', 'case', 'chan', 'const', 'continue', 'default', 'defer', 'else', 'fallthrough',
+        'for', 'func', 'go', 'goto', 'if', 'import', 'interface', 'map', 'package', 'range',
+        'return', 'select', 'struct', 'switch', 'type', 'var',
+    ],
+    rust: [
+        'as', 'async', 'await', 'break', 'const', 'continue', 'crate', 'dyn', 'else', 'enum', 'extern',
+        'false', 'fn', 'for', 'if', 'impl', 'in', 'let', 'loop', 'match', 'mod', 'move', 'mut', 'pub',
+        'ref', 'return', 'self', 'Self', 'static', 'struct', 'super', 'trait', 'true', 'type',
+        'unsafe', 'use', 'where', 'while',
+    ],
+    sql: [
+        'select', 'from', 'where', 'insert', 'into', 'values', 'update', 'set', 'delete', 'create',
+        'table', 'alter', 'drop', 'join', 'inner', 'left', 'right', 'outer', 'on', 'group', 'by',
+        'order', 'having', 'limit', 'offset', 'as', 'and', 'or', 'not', 'null', 'distinct', 'union',
+        'primary', 'key', 'foreign', 'references', 'index',
+    ],
+    css: ['important', 'media', 'keyframes', 'supports', 'import', 'from', 'to', 'and', 'not'],
+};
+const LITERALS = new Set([
+    'true', 'false', 'null', 'undefined', 'nil', 'None', 'True', 'False', 'NULL', 'NaN', 'Infinity',
+]);
+const HASH_COMMENT_LANGS = new Set(['python', 'shell', 'yaml', 'ruby', 'toml', 'make']);
+const DASH_COMMENT_LANGS = new Set(['sql']);
+/** Map many aliases to the canonical language key used by {@link highlightCode}. */
+export function normalizeLang(raw) {
+    const l = (raw || '').trim().toLowerCase();
+    if (!l)
+        return 'plain';
+    if (['ts', 'tsx', 'typescript', 'mts', 'cts'].includes(l))
+        return 'js';
+    if (['js', 'jsx', 'javascript', 'mjs', 'cjs', 'node'].includes(l))
+        return 'js';
+    if (['py', 'python3'].includes(l))
+        return 'python';
+    if (['sh', 'bash', 'zsh', 'shell', 'console', 'shellsession'].includes(l))
+        return 'shell';
+    if (['json', 'jsonc'].includes(l))
+        return 'json';
+    if (['golang'].includes(l))
+        return 'go';
+    if (['rs'].includes(l))
+        return 'rust';
+    if (['yml'].includes(l))
+        return 'yaml';
+    if (['postgres', 'postgresql', 'mysql', 'sqlite'].includes(l))
+        return 'sql';
+    if (KEYWORDS[l])
+        return l;
+    return 'plain';
+}
+function isIdentStart(ch) {
+    return /[A-Za-z_$]/.test(ch);
+}
+function isIdentPart(ch) {
+    return /[A-Za-z0-9_$]/.test(ch);
+}
+function isDigit(ch) {
+    return ch >= '0' && ch <= '9';
+}
+/** Is this language one where `/` starts a regex rather than division? */
+function slashStartsComment(lang) {
+    return !DASH_COMMENT_LANGS.has(lang) && lang !== 'python' && lang !== 'shell';
+}
+/**
+ * Highlight a code block into per-line tokens.
+ *
+ * Block comments (`/​* ... *​/`) and backtick template literals are tracked across
+ * lines through {@link LineState}, so a multi-line comment is coloured as a
+ * comment on every line rather than only the first.
+ */
+export function highlightCode(code, lang) {
+    const language = normalizeLang(lang);
+    const keywords = new Set(KEYWORDS[language] ?? []);
+    const hashComment = HASH_COMMENT_LANGS.has(language);
+    const dashComment = DASH_COMMENT_LANGS.has(language);
+    const supportsSlash = slashStartsComment(language);
+    const lines = code.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    const state = { blockComment: false, template: false };
+    return lines.map((line) => tokenizeLine(line, { language, keywords, hashComment, dashComment, supportsSlash, state }));
+}
+function tokenizeLine(line, ctx) {
+    const out = [];
+    let i = 0;
+    const push = (text, kind) => {
+        if (!text)
+            return;
+        const last = out[out.length - 1];
+        if (last && last.kind === kind)
+            last.text += text;
+        else
+            out.push({ text, kind });
+    };
+    // Continue a block comment / template string from the previous line.
+    if (ctx.state.blockComment) {
+        const end = line.indexOf('*/');
+        if (end === -1) {
+            push(line, 'comment');
+            return out;
+        }
+        push(line.slice(0, end + 2), 'comment');
+        ctx.state.blockComment = false;
+        i = end + 2;
+    }
+    if (ctx.state.template) {
+        const end = findUnescaped(line, i, '`');
+        if (end === -1) {
+            push(line.slice(i), 'string');
+            return out;
+        }
+        push(line.slice(i, end + 1), 'string');
+        ctx.state.template = false;
+        i = end + 1;
+    }
+    const n = line.length;
+    while (i < n) {
+        const ch = line[i];
+        const rest = line.slice(i);
+        // ── Comments ──────────────────────────────────────────────────────
+        if (ctx.supportsSlash && rest.startsWith('//')) {
+            push(line.slice(i), 'comment');
+            break;
+        }
+        if (ctx.supportsSlash && rest.startsWith('/*')) {
+            const end = line.indexOf('*/', i + 2);
+            if (end === -1) {
+                push(line.slice(i), 'comment');
+                ctx.state.blockComment = true;
+                break;
+            }
+            push(line.slice(i, end + 2), 'comment');
+            i = end + 2;
+            continue;
+        }
+        if (ctx.hashComment && ch === '#') {
+            push(line.slice(i), 'comment');
+            break;
+        }
+        if (ctx.dashComment && rest.startsWith('--')) {
+            push(line.slice(i), 'comment');
+            break;
+        }
+        // ── Strings ───────────────────────────────────────────────────────
+        if (ch === '"' || ch === "'") {
+            const end = findUnescaped(line, i + 1, ch);
+            if (end === -1) {
+                push(line.slice(i), 'string');
+                break;
+            }
+            push(line.slice(i, end + 1), 'string');
+            i = end + 1;
+            continue;
+        }
+        if (ch === '`' && ctx.language === 'js') {
+            const end = findUnescaped(line, i + 1, '`');
+            if (end === -1) {
+                push(line.slice(i), 'string');
+                ctx.state.template = true;
+                break;
+            }
+            push(line.slice(i, end + 1), 'string');
+            i = end + 1;
+            continue;
+        }
+        // ── Numbers ───────────────────────────────────────────────────────
+        if (isDigit(ch) || (ch === '.' && isDigit(line[i + 1] ?? ''))) {
+            let j = i;
+            while (j < n && /[0-9a-fA-FxXoObB._]/.test(line[j]))
+                j++;
+            push(line.slice(i, j), 'number');
+            i = j;
+            continue;
+        }
+        // ── Identifiers ───────────────────────────────────────────────────
+        if (isIdentStart(ch)) {
+            let j = i;
+            while (j < n && isIdentPart(line[j]))
+                j++;
+            const word = line.slice(i, j);
+            let kind = 'plain';
+            if (LITERALS.has(word))
+                kind = 'boolean';
+            else if (ctx.keywords.has(word))
+                kind = 'keyword';
+            else if (word === word.toUpperCase() && word.length > 1 && /^[A-Z0-9_]+$/.test(word))
+                kind = 'type';
+            else if (line[j] === '(')
+                kind = 'func';
+            else if (/^[A-Z]/.test(word))
+                kind = 'type';
+            push(word, kind);
+            i = j;
+            continue;
+        }
+        // ── Punctuation / operators ───────────────────────────────────────
+        if ('(){}[];,.:'.includes(ch)) {
+            push(ch, 'punct');
+            i++;
+            continue;
+        }
+        if ('+-*/%=<>!&|^~?'.includes(ch)) {
+            push(ch, 'operator');
+            i++;
+            continue;
+        }
+        push(ch, 'plain');
+        i++;
+    }
+    return out;
+}
+/** Index of the next unescaped `quote` at or after `from`, or -1. */
+function findUnescaped(line, from, quote) {
+    let escaped = false;
+    for (let k = from; k < line.length; k++) {
+        const c = line[k];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (c === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (c === quote)
+            return k;
+    }
+    return -1;
+}
+//# sourceMappingURL=highlight.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * CLI presentation layer — markdown, syntax highlighting, cards and streaming.
+ *
+ * Consumers import from here, never from the individual modules, so the internal
+ * split (parser → renderers → presenter) can change without touching call sites.
+ */
+export { DARK_THEME, LIGHT_THEME, resolveTheme } from './theme.js';
+export type { Theme, ThemeRole, ThemeName } from './theme.js';
+export { highlightCode, normalizeLang } from './highlight.js';
+export type { Token, TokenKind, TokenizedCode } from './highlight.js';
+export { parseMarkdown, parseInline, inlineText, blocksToPlainText } from './markdown.js';
+export type { Block, Inline, Align, ListItem } from './markdown.js';
+export { renderMarkdown, renderBlocks, renderCard, visibleWidth } from './render.js';
+export type { RenderOptions, CardOptions, CardLine } from './render.js';
+export { attachShellCards, diffLineRole, formatDuration, gitDiffCard, shellCard, toolCallCard, } from './cards.js';
+export type { ShellEndPayload, ToolCallCardInfo } from './cards.js';
+export { LiveAnswer } from './answer-view.js';
+export type { LiveAnswerProps } from './answer-view.js';
+export { AnswerStream, createCardSink, presentAnswer, presentCard, renderAnswer, shouldUseRichUi, } from './presenter.js';
+export type { CardSinkOverrides, PresenterOptions, StreamMeta } from './presenter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1F,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrF,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli/ui/index.js

@@ -0,0 +1,14 @@
+/**
+ * CLI presentation layer — markdown, syntax highlighting, cards and streaming.
+ *
+ * Consumers import from here, never from the individual modules, so the internal
+ * split (parser → renderers → presenter) can change without touching call sites.
+ */
+export { DARK_THEME, LIGHT_THEME, resolveTheme } from './theme.js';
+export { highlightCode, normalizeLang } from './highlight.js';
+export { parseMarkdown, parseInline, inlineText, blocksToPlainText } from './markdown.js';
+export { renderMarkdown, renderBlocks, renderCard, visibleWidth } from './render.js';
+export { attachShellCards, diffLineRole, formatDuration, gitDiffCard, shellCard, toolCallCard, } from './cards.js';
+export { LiveAnswer } from './answer-view.js';
+export { AnswerStream, createCardSink, presentAnswer, presentCard, renderAnswer, shouldUseRichUi, } from './presenter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG1F,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * 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 { type TokenizedCode } from './highlight.js';
+export type Inline = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'code';
+    text: string;
+} | {
+    kind: 'strong';
+    children: Inline[];
+} | {
+    kind: 'em';
+    children: Inline[];
+} | {
+    kind: 'link';
+    text: string;
+    href: string;
+};
+export type Align = 'left' | 'center' | 'right' | null;
+export interface ListItem {
+    inlines: Inline[];
+    /** Nesting depth (0 = top level), derived from leading indentation. */
+    depth: number;
+    /** Whether THIS item used an ordered marker (`1.`). */
+    ordered: boolean;
+    /** The item's own number when ordered (0 for a bullet). */
+    index: number;
+}
+export type Block = {
+    type: 'heading';
+    level: number;
+    inlines: Inline[];
+} | {
+    type: 'paragraph';
+    inlines: Inline[];
+} | {
+    type: 'code';
+    lang: string;
+    code: string;
+    tokens: TokenizedCode;
+} | {
+    type: 'list';
+    ordered: boolean;
+    start: number;
+    items: ListItem[];
+} | {
+    type: 'table';
+    header: Inline[][];
+    rows: Inline[][][];
+    align: Align[];
+} | {
+    type: 'quote';
+    blocks: Block[];
+} | {
+    type: 'hr';
+};
+/** Parse a markdown string into blocks. */
+export declare function parseMarkdown(md: string): Block[];
+/**
+ * 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 declare function parseInline(text: string): Inline[];
+/** Plain text of an inline run — used for measuring and for non-colour output. */
+export declare function inlineText(inlines: readonly Inline[]): string;
+/** Plain text of a block tree — a markdown-aware fallback when colour is off. */
+export declare function blocksToPlainText(blocks: readonly Block[]): string;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAUnB,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,EAAE,CAGjD;AA6JD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA2DlD;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAe7D;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAkClE"}