praxis-agent 0.43.0 → 0.43.1

package/dist/cli/tui/ansi-surface.d.ts

@@ -1,26 +1,10 @@
 import { type AnsiFrame } from './ansi-frame-renderer.js';
-import type { TuiScreenModel } from './tui-screen-model.js';
-export interface TuiAnsiSurfaceProps {
-    screen: TuiScreenModel;
-    width: number;
-    rows: number | undefined;
-    input: string;
-    busy: boolean;
-    status: string;
-    screenReader?: boolean;
-    display?: {
-        cwd: string;
-        model?: string;
-        effort?: string;
-        permissionMode?: string;
-        version?: string;
-    };
-    sessionLabel?: string;
-    cursor?: number;
-    onError: (error: unknown) => void;
+import type { QuietFrame } from './quiet-frame.js';
+export interface TuiAnsiSurfaceFrameProps {
+    readonly frame: QuietFrame;
+    readonly onError: (error: unknown) => void;
 }
-/** ANSI mode is intentionally limited to the plain conversation surface. */
-export declare function supportsAnsiSurface(screen: TuiScreenModel): boolean;
-export declare function projectAnsiSurfaceFrame(props: TuiAnsiSurfaceProps): AnsiFrame;
+export type TuiAnsiSurfaceProps = TuiAnsiSurfaceFrameProps;
+export declare function projectAnsiQuietFrame(frame: QuietFrame): AnsiFrame;
 export declare function TuiAnsiSurface(props: TuiAnsiSurfaceProps): null;
 //# sourceMappingURL=ansi-surface.d.ts.map

package/dist/cli/tui/ansi-surface.js

@@ -3,132 +3,12 @@ import { useStdout } from 'ink';
 import { AnsiFullscreenRenderer, } from './ansi-frame-renderer.js';
 import { resolveAnsiTextStyles } from './ansi-theme.js';
 import { useTuiTheme } from './theme.js';
-// Keep line breaks long enough for active stream projection to split them;
-// every emitted row is still guaranteed to contain no line breaks.
-function isUnsafeControl(character) {
-    const codePoint = character.codePointAt(0) ?? 0;
-    return ((codePoint >= 0 && codePoint <= 9) ||
-        codePoint === 11 ||
-        codePoint === 12 ||
-        (codePoint >= 14 && codePoint <= 31) ||
-        codePoint === 127);
-}
-function safeText(value) {
-    return typeof value === 'string'
-        ? Array.from(value)
-            .filter((character) => !isUnsafeControl(character))
-            .join('')
-        : '';
-}
-function row(key, text, role = 'body') {
-    return {
-        key,
-        segments: [{ text: safeText(text) || ' ', role }],
-        height: 1,
-        source: key,
-    };
-}
-function activeRows(key, text, role = 'body') {
-    return safeText(text)
-        .replace(/\r\n?/gu, '\n')
-        .split('\n')
-        .map((line, index) => row(`${key}:${index}`, line, role));
-}
-function headerRows(props) {
-    const display = props.display;
-    const identity = `Praxis${display?.version ? ` ${safeText(display.version)}` : ''}${props.sessionLabel ? ` · session ${safeText(props.sessionLabel)}` : ''}`;
-    const metadata = [
-        display?.cwd ? `cwd ${safeText(display.cwd).slice(0, 80)}` : '',
-        display?.model ? `model ${safeText(display.model).slice(0, 40)}` : '',
-        display?.effort ? `effort ${safeText(display.effort).slice(0, 20)}` : '',
-        display?.permissionMode
-            ? `permissions ${safeText(display.permissionMode).slice(0, 30)}`
-            : '',
-    ]
-        .filter(Boolean)
-        .join(' · ');
-    return [
-        row('ansi:header:identity', identity, 'heading'),
-        row('ansi:header:context', metadata || 'Ready', 'muted'),
-    ];
-}
-function summarize(value, depth = 0) {
-    if (depth > 1 || value === null || typeof value !== 'object')
-        return [];
-    const result = [];
-    for (const [key, item] of Object.entries(value)) {
-        if (typeof item === 'string' && item.length > 0) {
-            result.push(`${key}: ${safeText(item).slice(0, 120)}`);
-        }
-        else if (Array.isArray(item)) {
-            const strings = item.filter((entry) => typeof entry === 'string');
-            if (strings.length > 0)
-                result.push(`${key}: ${strings.slice(0, 4).map(safeText).join(', ')}`);
-        }
-        else if (typeof item === 'object' && item !== null) {
-            result.push(...summarize(item, depth + 1).slice(0, 4));
-        }
-        if (result.length >= 8)
-            break;
-    }
-    return result.slice(0, 8);
-}
-function surfaceRows(screen) {
-    const body = screen.body;
-    if (body.kind === 'session-picker') {
-        return [
-            row('ansi:session-picker', 'Sessions', 'heading'),
-            ...summarize(body.surface).map((text, index) => row(`ansi:session:${index}`, text, 'muted')),
-        ];
-    }
-    if (body.foreground.kind !== 'compose') {
-        const surface = body.foreground.surface;
-        return [
-            row(`ansi:foreground:${body.foreground.kind}`, body.foreground.kind, 'heading'),
-            ...summarize(surface).map((text, index) => row(`ansi:foreground:${index}`, text, 'muted')),
-        ];
-    }
-    return [];
-}
-/** ANSI mode is intentionally limited to the plain conversation surface. */
-export function supportsAnsiSurface(screen) {
-    if (screen.body.kind !== 'conversation')
-        return false;
-    return (screen.body.intro === 'none' &&
-        screen.body.foreground.kind === 'compose' &&
-        screen.body.foreground.overlays.length === 0);
-}
-export function projectAnsiSurfaceFrame(props) {
-    const body = props.screen.body;
-    const lines = [...surfaceRows(props.screen)];
-    const headers = body.kind === 'conversation' ? headerRows(props) : [];
-    if (body.kind === 'conversation') {
-        lines.push(...body.transcript.rows);
-        if (body.transcript.active.visible) {
-            if (safeText(body.transcript.active.text))
-                lines.push(...activeRows('ansi:active:text', body.transcript.active.text));
-            if (safeText(body.transcript.active.thinking))
-                lines.push(...activeRows('ansi:active:thinking', body.transcript.active.thinking, 'muted'));
-        }
-    }
-    const cursor = Math.min(Math.max(0, props.cursor ?? props.input.length), props.input.length);
-    lines.push(row('composer', `❯ ${props.input.slice(0, cursor)}▌${props.input.slice(cursor)}`, 'input'));
-    lines.push(row('status', `● ${props.status}${props.busy ? ' · busy' : ''}`, 'muted'));
-    const limit = props.rows === undefined ? lines.length : Math.max(2, props.rows);
-    const chrome = lines.slice(-2);
-    const content = [...headers, ...lines.slice(0, -2)];
-    const headerCount = Math.min(headers.length, Math.max(0, limit - 2));
-    const visibleHeaders = headers.slice(0, headerCount);
-    const bodyRows = content.slice(headers.length);
-    const contentBudget = Math.max(0, limit - headerCount - 2);
+export function projectAnsiQuietFrame(frame) {
     return {
-        columns: Math.max(1, Math.floor(props.width)),
-        rows: limit,
-        lines: [
-            ...visibleHeaders,
-            ...bodyRows.slice(-contentBudget),
-            ...chrome,
-        ].slice(-limit),
+        columns: frame.columns,
+        rows: frame.rows,
+        lines: frame.lines,
+        ...(frame.cursor === undefined ? {} : { cursor: frame.cursor }),
     };
 }
 export function TuiAnsiSurface(props) {
@@ -175,7 +55,7 @@ export function TuiAnsiSurface(props) {
         if (renderer === null)
             return;
         try {
-            renderer.draw(projectAnsiSurfaceFrame(props));
+            renderer.draw(projectAnsiQuietFrame(props.frame));
         }
         catch (error) {
             failedRef.current = true;

package/dist/cli/tui/ansi-theme.d.ts

@@ -1,3 +1,4 @@
-import type { TuiSemanticTheme, TuiTextRole } from './theme.js';
-export declare function resolveAnsiTextStyles(theme: Pick<TuiSemanticTheme, 'text' | 'noColor' | 'screenReader'>): Partial<Record<TuiTextRole, string>>;
+import type { TuiSemanticTheme } from './theme.js';
+import type { TuiTextRole as RowIrTextRole } from './tui-row-ir.js';
+export declare function resolveAnsiTextStyles(theme: Pick<TuiSemanticTheme, 'text' | 'noColor' | 'screenReader'>): Partial<Record<RowIrTextRole | 'link', string>>;
 //# sourceMappingURL=ansi-theme.d.ts.map

package/dist/cli/tui/ansi-theme.js

@@ -73,11 +73,32 @@ export function resolveAnsiTextStyles(theme) {
     if (theme.noColor || theme.screenReader)
         return {};
     const styles = {};
-    for (const [role, style] of Object.entries(theme.text)) {
+    const roleMap = {
+        body: 'body',
+        heading: 'heading',
+        muted: 'muted',
+        accent: 'focusMarker',
+        success: 'success',
+        warning: 'warning',
+        error: 'error',
+        tool: 'info',
+        selection: 'focusMarker',
+        input: 'inputMarker',
+        diffAdded: 'diffAdded',
+        diffRemoved: 'diffRemoved',
+    };
+    for (const [role, semanticRole] of Object.entries(roleMap)) {
+        const style = theme.text[semanticRole] ??
+            theme.text[role];
+        if (style === undefined)
+            continue;
         const sequence = styleSequence(style);
         if (sequence !== undefined)
             styles[role] = sequence;
     }
+    const link = theme.text.link === undefined ? undefined : styleSequence(theme.text.link);
+    if (link !== undefined)
+        styles.link = link;
     return styles;
 }
 //# sourceMappingURL=ansi-theme.js.map

package/dist/cli/tui/quiet-choice-rows.d.ts

@@ -0,0 +1,26 @@
+import { type QuietFrameDensity, type QuietFrameRow } from './quiet-frame.js';
+import type { TuiCommandPaletteModel } from './command-palette-model.js';
+import type { TuiDecisionSurfaceModel } from './decision-surface-model.js';
+import type { TuiElicitationSurfaceModel } from './mcp-elicitation-surface-model.js';
+import type { TuiMentionPickerModel } from './mention-picker-model.js';
+import type { TuiPermissionSurfaceModel } from './permission-surface-model.js';
+import type { TuiSessionPickerModel } from './session-picker-model.js';
+export type QuietPrioritySurface = {
+    readonly kind: 'editor-wait';
+} | {
+    readonly kind: 'permission';
+    readonly surface: TuiPermissionSurfaceModel;
+} | TuiDecisionSurfaceModel | {
+    readonly kind: 'elicitation';
+    readonly surface: TuiElicitationSurfaceModel;
+};
+export type QuietOverlaySurface = TuiCommandPaletteModel | TuiMentionPickerModel | {
+    readonly kind: 'exit-confirmation';
+};
+export type QuietChoiceSurface = QuietPrioritySurface | QuietOverlaySurface | TuiSessionPickerModel | TuiPermissionSurfaceModel;
+export interface QuietChoiceProjectionOptions {
+    readonly density: QuietFrameDensity;
+    readonly screenReader?: boolean;
+}
+export declare function projectQuietChoiceRows(surface: QuietChoiceSurface, options: QuietChoiceProjectionOptions): readonly QuietFrameRow[];
+//# sourceMappingURL=quiet-choice-rows.d.ts.map

package/dist/cli/tui/quiet-choice-rows.js

@@ -0,0 +1,302 @@
+import { createQuietFrameRow, } from './quiet-frame.js';
+const excerpt = (value, max = 160) => typeof value === 'string'
+    ? value.replace(/\s+/gu, ' ').trim().slice(0, max)
+    : '';
+const detailAllowed = (density) => density === 'full' || density === 'standard';
+const row = (key, text, role = 'body', sr) => createQuietFrameRow(key, text, 'focus', role, sr);
+const footer = (screenReader, text = '↑/↓ select  Enter confirm  Esc cancel') => row('quiet:choice:footer', text, 'muted', screenReader
+    ? 'Use up and down arrows to select. Press Enter to confirm. Press Escape to cancel.'
+    : undefined);
+const explicitFooter = (key, visual, accessible) => row(key, visual, 'muted', accessible);
+const marker = (selected, label, screenReader) => screenReader
+    ? selected
+        ? `Selected: ${label}`
+        : `Option: ${label}`
+    : `${selected ? '❯ ' : '  '}${label}`;
+const excerptOption = (label, description, density) => detailAllowed(density) && description
+    ? `${label} — ${excerpt(description)}`
+    : label;
+const unsupported = (value) => {
+    throw new Error(`Unsupported quiet choice surface: ${String(value)}`);
+};
+function optionsRows(options, prefix, density, sr) {
+    return options.map((item, index) => row(`${prefix}:${item.id ?? item.index ?? index}`, marker(item.selected, excerptOption(item.label, item.description, density), sr), item.selected ? 'selection' : 'body', sr
+        ? item.selected
+            ? `Selected: ${item.label}`
+            : `Option: ${item.label}`
+        : undefined));
+}
+function permission(surface, density, sr) {
+    const out = [];
+    switch (surface.kind) {
+        case 'tool-request': {
+            out.push(row('quiet:permission:heading', excerpt(surface.tool.question || surface.heading), 'heading'));
+            if (detailAllowed(density)) {
+                for (const [key, value] of [
+                    ['subtitle', surface.tool.subtitle],
+                    ['explanation', surface.tool.explanation],
+                ])
+                    if (value)
+                        out.push(row(`quiet:permission:${key}`, excerpt(value), 'muted'));
+                surface.tool.detail
+                    .slice(0, 20)
+                    .forEach((item, i) => out.push(row(`quiet:permission:detail:${i}`, `${item.prefix ?? ' '} ${excerpt(item.text)}`, item.prefix === '-'
+                    ? 'diffRemoved'
+                    : item.prefix === '+'
+                        ? 'diffAdded'
+                        : 'body')));
+            }
+            out.push(...optionsRows(surface.options.map((item, index) => ({
+                ...item,
+                label: permissionLabel({
+                    ...item,
+                    index: index + 1,
+                    selected: index === surface.selectedIndex,
+                }),
+                selected: index === surface.selectedIndex,
+            })), 'quiet:permission:option', density, sr));
+            if (surface.feedbackMode)
+                out.push(row('quiet:permission:feedback', `> ${excerpt(surface.feedback) || 'Enter feedback…'}`, 'input'));
+            return [...out, footer(sr)];
+        }
+        case 'recovery-request':
+            out.push(row('quiet:recovery:heading', surface.heading, 'heading'), row('quiet:recovery:question', surface.question), row('quiet:recovery:display', excerpt(surface.display), 'muted'));
+            if (surface.feedbackMode)
+                out.push(row('quiet:recovery:feedback', `> ${excerpt(surface.feedback) || surface.feedbackPlaceholder}`, 'input'));
+            return [
+                ...out,
+                ...optionsRows(surface.options, 'quiet:recovery:option', density, sr),
+                footer(sr),
+            ];
+        case 'permission-dashboard':
+            out.push(row('quiet:dashboard:heading', surface.heading, 'heading'), row('quiet:dashboard:tab', `Tab: ${surface.tabs.find((x) => x.current)?.label ?? 'Permissions'}`));
+            if (detailAllowed(density))
+                out.push(row('quiet:dashboard:description', excerpt(surface.description)));
+            if (surface.query)
+                out.push(row('quiet:dashboard:search', `Search: ${excerpt(surface.query)}`, 'input'));
+            if (surface.originalWorkspace)
+                out.push(row('quiet:dashboard:workspace:original', `Original workspace: ${surface.originalWorkspace.label}`, 'muted'));
+            out.push(...surface.rows
+                .slice(0, 20)
+                .map((item, i) => row(`quiet:dashboard:${item.id ?? item.index ?? i}`, marker(item.selected, `${item.label}${item.status === 'retrying' ? ' (retrying)' : item.status === 'denied' ? ' (denied)' : ''}`, sr), item.selected
+                ? 'selection'
+                : item.status === 'denied'
+                    ? 'error'
+                    : item.status === 'retrying'
+                        ? 'warning'
+                        : 'body')));
+            if (surface.rows.length === 0 && surface.emptyState)
+                out.push(row('quiet:dashboard:empty', surface.emptyState, 'muted'));
+            return [
+                ...out,
+                explicitFooter('quiet:dashboard:footer', surface.rows.length > 0
+                    ? '↑/↓ select  Enter open  Esc close'
+                    : 'Esc close', surface.rows.length > 0
+                    ? 'Use left and right arrows to switch tabs. Use up and down arrows to select. Press Enter to open. Press Escape to close.'
+                    : 'Use left and right arrows to switch tabs. Press Escape to close.'),
+            ];
+        case 'permission-rule-input':
+        case 'workspace-directory-input':
+            out.push(row(`quiet:${surface.kind}:heading`, surface.heading, 'heading'), row(`quiet:${surface.kind}:description`, excerpt(surface.description)), row(`quiet:${surface.kind}:value`, `> ${excerpt(surface.value) || surface.placeholder}`, 'input'));
+            return [
+                ...out,
+                explicitFooter(`quiet:${surface.kind}:footer`, 'Enter confirm  Esc cancel', 'Press Enter to confirm. Press Escape to cancel.'),
+            ];
+        case 'permission-scope':
+            out.push(row('quiet:scope:heading', surface.heading, 'heading'), row('quiet:scope:description', excerpt(surface.description)));
+            return [
+                ...out,
+                ...optionsRows(surface.options, 'quiet:scope:option', density, sr),
+                footer(sr),
+            ];
+        case 'permission-delete':
+            out.push(row('quiet:delete:heading', surface.heading, 'heading'), row('quiet:delete:rule', `${surface.rule} · ${surface.scope}`), row('quiet:delete:question', surface.question, 'warning'));
+            if (surface.description)
+                out.push(row('quiet:delete:description', excerpt(surface.description), 'warning'));
+            return [
+                ...out,
+                ...optionsRows(surface.options, 'quiet:delete:option', density, sr).map((x, i) => i === 0
+                    ? {
+                        ...x,
+                        segments: x.segments.map((s) => ({
+                            ...s,
+                            role: 'error',
+                        })),
+                    }
+                    : x),
+                footer(sr),
+            ];
+        case 'workspace-directory-delete':
+            out.push(row('quiet:workspace-delete:heading', surface.heading, 'heading'), row('quiet:workspace-delete:path', surface.path), row('quiet:workspace-delete:description', excerpt(surface.description), 'warning'));
+            return [
+                ...out,
+                ...optionsRows(surface.options, 'quiet:workspace-delete:option', density, sr),
+                footer(sr),
+            ];
+        default:
+            return unsupported(surface);
+    }
+}
+function permissionLabel(item) {
+    if (item.action === 'allow-once')
+        return 'Allow once';
+    if (item.action === 'deny')
+        return 'Deny';
+    const label = item.label.trim();
+    if (/^yes,\s*/iu.test(label)) {
+        const consequence = label.replace(/^yes,\s*/iu, '');
+        return /^allow\b/iu.test(consequence)
+            ? `Allow${consequence.slice('allow'.length)}`
+            : `Allow ${consequence}`;
+    }
+    if (/^no,\s*/iu.test(label))
+        return `Deny ${label.replace(/^no,\s*/iu, '')}`;
+    if (/^yes$/iu.test(label))
+        return 'Allow for this session';
+    if (/^no$/iu.test(label))
+        return 'Deny';
+    return label;
+}
+function decision(surface, density, sr) {
+    const out = [
+        row(`quiet:decision:${surface.kind}:heading`, surface.heading, 'heading'),
+    ];
+    if (surface.kind === 'plan-approval') {
+        if (detailAllowed(density)) {
+            out.push(row('quiet:plan:explanation', surface.explanation));
+            if (surface.plan)
+                out.push(row('quiet:plan:content', excerpt(surface.plan, 160), 'muted'));
+            out.push(row('quiet:plan:path', `Plan: ${excerpt(surface.planPath)}`, 'muted'));
+        }
+        out.push(...optionsRows(surface.options, 'quiet:plan:option', density, sr));
+        if (surface.feedbackMode)
+            out.push(row('quiet:plan:feedback', `> ${excerpt(surface.feedback) || surface.feedbackPlaceholder}`, 'input'));
+        return [
+            ...out,
+            explicitFooter('quiet:plan:footer', '↑/↓ select  Enter confirm  Esc cancel', 'Use up and down arrows to select. Press Enter to confirm. Press Escape to cancel.'),
+        ];
+    }
+    if (surface.progress)
+        out.push(row('quiet:question:progress', surface.progress, 'muted'));
+    if (surface.question)
+        out.push(row('quiet:question:text', surface.question));
+    out.push(...optionsRows(surface.options, 'quiet:question:option', density, sr));
+    out.push(row('quiet:question:answer', `Current answer: ${excerpt(surface.answer) || '(empty)'}`, 'input'));
+    if (surface.guidance)
+        out.push(row('quiet:question:guidance', surface.guidance, 'muted'));
+    if (surface.emptyState)
+        out.push(row('quiet:question:empty', surface.emptyState, 'muted'));
+    out.push(explicitFooter('quiet:question:footer', 'Enter answer  Esc cancel', 'Press Enter to submit the answer. Press Escape to cancel.'));
+    return out;
+}
+function picker(surface, density, sr) {
+    const name = surface.kind === 'session-picker'
+        ? 'Sessions'
+        : surface.kind === 'command-palette'
+            ? 'Commands'
+            : 'Mentions';
+    const out = [
+        row(`quiet:${surface.kind}:heading`, `${name}${surface.query ? ` · ${excerpt(surface.query)}` : ''}`, 'heading'),
+    ];
+    const { start, end } = surface.visibleRange;
+    surface.rows.slice(start, end).forEach((item) => {
+        const label = 'path' in item
+            ? item.path
+            : 'invocation' in item
+                ? detailAllowed(density)
+                    ? `${item.invocation} — ${item.description}`
+                    : item.invocation
+                : 'name' in item
+                    ? detailAllowed(density)
+                        ? `${item.name} — ${item.description}`
+                        : item.name
+                    : detailAllowed(density) && item.detail
+                        ? `${item.label} — ${item.detail}`
+                        : item.label;
+        out.push(row(`quiet:${surface.kind}:${item.id}`, marker(item.selected, excerptOption(label, undefined, density), sr), item.selected ? 'selection' : 'body'));
+    });
+    if (surface.rows.length === 0)
+        out.push(row(`quiet:${surface.kind}:empty`, 'No matching choices.', 'muted'));
+    return [
+        ...out,
+        explicitFooter(`quiet:${surface.kind}:footer`, '↑/↓ select  Enter confirm  Esc cancel', 'Use up and down arrows to select. Press Enter to confirm. Press Escape to cancel.'),
+    ];
+}
+function elicitation(surface, density, sr) {
+    const out = [
+        row(`quiet:elicitation:${surface.kind}:server`, `Server: ${excerpt(surface.serverName)}`, 'heading'),
+        row(`quiet:elicitation:${surface.kind}:message`, excerpt(surface.message)),
+    ];
+    if (surface.kind === 'elicitation-url') {
+        out.push(row('quiet:elicitation:url', `URL: ${excerpt(surface.url)}`), row('quiet:elicitation:waiting', surface.waiting
+            ? 'Waiting for confirmation…'
+            : marker(surface.selection === 0, surface.actionLabel, sr), surface.waiting
+            ? 'warning'
+            : surface.selection === 0
+                ? 'selection'
+                : 'body'), row('quiet:elicitation:cancel', marker(surface.selection === 1, 'Cancel', sr), surface.selection === 1 ? 'selection' : 'body'));
+        return [...out, footer(sr)];
+    }
+    const start = Math.max(0, Math.min(surface.state.focusIndex - 2, surface.state.fields.length - Math.max(1, surface.maxVisibleFields)));
+    surface.state.fields
+        .slice(start, start + Math.max(1, surface.maxVisibleFields))
+        .forEach((field) => {
+        const stored = surface.state.values[field.name];
+        const value = surface.state.fields.indexOf(field) === surface.state.focusIndex &&
+            ['text', 'number', 'integer'].includes(field.kind) &&
+            surface.state.expandedField !== field.name
+            ? surface.input
+            : stored;
+        const text = `${field.title}${field.required ? ' (required)' : ''}: ${value === undefined || value === '' ? '(empty)' : String(value)}${detailAllowed(density) && field.description ? ` — ${excerpt(field.description)}` : ''}${surface.state.errors[field.name] ? ` — ${excerpt(surface.state.errors[field.name])}` : ''}`;
+        out.push(row(`quiet:elicitation:field:${field.name}`, marker(surface.state.fields.indexOf(field) === surface.state.focusIndex, text, sr), surface.state.fields.indexOf(field) === surface.state.focusIndex
+            ? 'selection'
+            : surface.state.errors[field.name]
+                ? 'error'
+                : 'body'));
+        if (surface.state.expandedField === field.name) {
+            const optionStart = Math.max(0, Math.min(surface.state.optionIndex - 10, field.options.length - 20));
+            field.options
+                .slice(optionStart, optionStart + 20)
+                .forEach((option, offset) => {
+                const optionIndex = optionStart + offset;
+                const focused = surface.state.optionIndex === optionIndex;
+                const checked = field.kind === 'multi-enum' &&
+                    Array.isArray(stored) &&
+                    stored.includes(option.value);
+                const label = field.kind === 'multi-enum'
+                    ? `${checked ? '[x]' : '[ ]'} ${option.label}`
+                    : option.label;
+                out.push(row(`quiet:elicitation:field:${field.name}:option:${option.value}`, marker(focused, label, sr), focused ? 'selection' : checked ? 'success' : 'body'));
+            });
+        }
+    });
+    return [
+        ...out,
+        explicitFooter('quiet:elicitation:footer', '↑/↓ field  Enter edit/select  Esc cancel', 'Use up and down arrows to change fields. Press Enter to edit or select. Press Escape to cancel.'),
+    ];
+}
+export function projectQuietChoiceRows(surface, options) {
+    const sr = options.screenReader === true;
+    if (surface.kind === 'permission')
+        return permission(surface.surface, options.density, sr);
+    if (surface.kind === 'elicitation')
+        return elicitation(surface.surface, options.density, sr);
+    if (surface.kind === 'editor-wait')
+        return [
+            row('quiet:editor-wait', 'Editor is open. Waiting for changes…', 'warning'),
+            explicitFooter('quiet:editor-wait:footer', 'Esc cancel', 'Press Escape to cancel.'),
+        ];
+    if (surface.kind === 'exit-confirmation')
+        return [
+            row('quiet:exit:heading', 'Exit Praxis?', 'heading'),
+            explicitFooter('quiet:exit:footer', 'Enter confirm  Esc cancel', 'Press Enter to confirm. Press Escape to cancel.'),
+        ];
+    if (surface.kind === 'plan-approval' || surface.kind === 'question')
+        return decision(surface, options.density, sr);
+    if (surface.kind === 'session-picker' ||
+        surface.kind === 'command-palette' ||
+        surface.kind === 'mention-picker')
+        return picker(surface, options.density, sr);
+    return permission(surface, options.density, sr);
+}
+//# sourceMappingURL=quiet-choice-rows.js.map

package/dist/cli/tui/quiet-frame-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { QuietFrame } from './quiet-frame.js';
+import { type TuiTextRole } from './theme.js';
+export interface QuietInkLineSegment {
+    readonly text: string;
+    readonly role: TuiTextRole;
+    readonly cursor?: boolean;
+}
+export interface QuietInkFrameLine {
+    readonly key: string;
+    readonly segments: readonly QuietInkLineSegment[];
+}
+export declare function projectQuietInkFrameLines(frame: QuietFrame, screenReader?: boolean): readonly QuietInkFrameLine[];
+export interface QuietInkFrameProps {
+    readonly frame: QuietFrame;
+    readonly screenReader?: boolean;
+}
+export declare function QuietInkFrame({ frame, screenReader, }: QuietInkFrameProps): import("react").JSX.Element;
+//# sourceMappingURL=quiet-frame-adapter.d.ts.map

package/dist/cli/tui/quiet-frame-adapter.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Text } from 'ink';
+import { useTuiTheme } from './theme.js';
+import { terminalGraphemeWidth, terminalGraphemes, terminalTextWidth, } from './transcript-viewport.js';
+const ROLE_MAP = {
+    body: 'body',
+    heading: 'heading',
+    muted: 'muted',
+    accent: 'focusMarker',
+    success: 'success',
+    warning: 'warning',
+    error: 'error',
+    tool: 'info',
+    selection: 'focusMarker',
+    input: 'inputMarker',
+    diffAdded: 'diffAdded',
+    diffRemoved: 'diffRemoved',
+};
+function plainText(row) {
+    return row.segments.map((segment) => segment.text).join('') || ' ';
+}
+export function projectQuietInkFrameLines(frame, screenReader = false) {
+    return frame.lines.map((row) => {
+        if (screenReader)
+            return {
+                key: row.key,
+                segments: [
+                    {
+                        text: row.accessibleText ?? plainText(row),
+                        role: 'body',
+                    },
+                ],
+            };
+        const cursor = frame.cursor?.rowKey === row.key ? frame.cursor.column : undefined;
+        if (cursor === undefined)
+            return {
+                key: row.key,
+                segments: row.segments.map((segment) => ({
+                    ...segment,
+                    role: ROLE_MAP[segment.role],
+                })),
+            };
+        const output = [];
+        let position = 0;
+        let inserted = false;
+        for (const segment of row.segments) {
+            const chars = terminalGraphemes(segment.text);
+            const mappedRole = ROLE_MAP[segment.role];
+            const segmentWidth = terminalTextWidth(segment.text);
+            if (!inserted && cursor >= position && cursor < position + segmentWidth) {
+                let offset = 0;
+                let cell = position;
+                for (const [index, grapheme] of chars.entries()) {
+                    const width = terminalGraphemeWidth(grapheme);
+                    if (cursor < cell + width) {
+                        offset = index;
+                        break;
+                    }
+                    cell += width;
+                }
+                const before = chars.slice(0, offset).join('');
+                const at = chars[offset] ?? ' ';
+                const after = chars
+                    .slice(offset + (offset < chars.length ? 1 : 0))
+                    .join('');
+                if (before)
+                    output.push({ text: before, role: mappedRole });
+                output.push({ text: at, role: mappedRole, cursor: true });
+                if (after)
+                    output.push({ text: after, role: mappedRole });
+                inserted = true;
+            }
+            else
+                output.push({ text: segment.text, role: mappedRole });
+            position += segmentWidth;
+        }
+        if (!inserted)
+            output.push({ text: ' ', role: 'body', cursor: true });
+        return { key: row.key, segments: output };
+    });
+}
+export function QuietInkFrame({ frame, screenReader = false, }) {
+    const theme = useTuiTheme();
+    const lines = projectQuietInkFrameLines(frame, screenReader);
+    return (_jsx(_Fragment, { children: lines.map((line) => (_jsx(Text, { children: line.segments.map((segment, index) => {
+                const style = theme.text[segment.role];
+                return (_jsx(Text, { ...style, ...(segment.cursor || style.inverse ? { inverse: true } : {}), children: segment.text }, `${line.key}:${index}`));
+            }) }, line.key))) }));
+}
+//# sourceMappingURL=quiet-frame-adapter.js.map