wotann 0.5.95 → 0.5.96

package/dist/index.js

@@ -224,7 +224,7 @@ program
     // `--no-fullscreen` or `WOTANN_FULLSCREEN=0`.
     .option("--fullscreen", "Use the alternate screen buffer (default: on)", true)
     .option("--no-fullscreen", "Render in main scrollback (legacy mode)")
-    .option("--renderer <renderer>", "TUI renderer: ink | opentui", "ink")
+    .option("--renderer <renderer>", "TUI renderer: ink (alt-screen) | inline (no-flicker main-buffer)", "ink")
     .action(async (options) => {
     if (options.workspace !== undefined) {
         try {
@@ -399,25 +399,15 @@ program
             "ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY etc. " +
             "in your environment. Continuing to TUI in static mode.\n");
     }
-    if (options.renderer === "opentui") {
-        if (!isInteractiveTTY) {
-            process.stderr.write("[wotann] --renderer opentui requires an interactive TTY.\n");
-            return;
-        }
-        const { mountOpenTuiChat } = await import("./ui/opentui-chat.js");
-        const handle = await mountOpenTuiChat({
-            version: VERSION,
-            providers: interactive.providers,
-            initialModel: interactive.initialModel,
-            initialProvider: interactive.initialProvider,
-            runtime: interactive.runtime,
-            fullscreen: options.fullscreen,
-        });
-        await handle.waitUntilExit;
-        return;
-    }
-    if (options.renderer !== undefined && options.renderer !== "ink") {
-        process.stderr.write("[wotann] Unknown renderer. Use --renderer ink or --renderer opentui.\n");
+    // The `opentui` renderer was retired (docs/phase-0-redesign/
+    // renderer-decision.md): @opentui loads its Zig core via bun:ffi, so
+    // it was dead-on-arrival under stock Node — it typechecked but threw
+    // on import for every user. The no-flicker win is delivered on Ink
+    // instead via `--renderer inline` (main-buffer + <Static>).
+    if (options.renderer !== undefined &&
+        options.renderer !== "ink" &&
+        options.renderer !== "inline") {
+        process.stderr.write("[wotann] Unknown renderer. Use --renderer ink (alt-screen) or --renderer inline (no-flicker main-buffer).\n");
         return;
     }
     // Pre-load the heavy UI modules BEFORE entering alt-buffer so the
@@ -426,13 +416,19 @@ program
     // AppV3 + Ink + react-reconciler hydrate, which is exactly the
     // "npx wotann hangs and shows a black screen" symptom users have
     // reported (2026-05-23 P0). Parallel imports cut the wait further.
-    const [{ AppV3 }, { mountInteractiveInk }, altBufferModule] = await Promise.all([
+    const [{ AppV3 }, { mountInteractiveInk }, altBufferModule, { isInlineRenderRequested }] = await Promise.all([
         import("./ui/components/v3/index.js"),
         import("./ui/mount-interactive-ink.js"),
         import("./ui/alt-buffer.js"),
+        import("./ui/inline-render.js"),
     ]);
     const { isAltBufferRequested, enterAltBuffer, exitAltBuffer } = altBufferModule;
-    const wantsAltBuffer = isAltBufferRequested(options.fullscreen !== false);
+    // Inline (main-buffer + <Static>) mode skips alt-buffer entry — the
+    // two are mutually exclusive (the alt buffer has no scrollback for
+    // <Static> to write committed history into). Opt in via
+    // `--renderer inline` OR WOTANN_TUI_INLINE=1; see src/ui/inline-render.ts.
+    const inlineMode = options.renderer === "inline" || isInlineRenderRequested();
+    const wantsAltBuffer = isAltBufferRequested(options.fullscreen !== false) && !inlineMode;
     // Mount the single V3 shell through the ONE guarded gate every
     // interactive Ink mount must use: viewport repair, raw-mode-
     // capable stdin resolution, refuse-cleanly-with-guidance.
@@ -455,6 +451,7 @@ program
             initialModel: interactive.initialModel,
             initialProvider: interactive.initialProvider,
             runtime: interactive.runtime,
+            inline: inlineMode,
         }), {
             onResolved: () => {
                 if (wantsAltBuffer)
@@ -1960,13 +1957,17 @@ program
     // (npx pitch-black fix 2026-05-23). Same fullscreen-mode hook as
     // `wotann start` — env var only here (no CLI flag on `wotann
     // resume`). Default ON; disable via `WOTANN_FULLSCREEN=0`.
-    const [{ AppV3 }, { mountInteractiveInk }, altBufferModule] = await Promise.all([
+    const [{ AppV3 }, { mountInteractiveInk }, altBufferModule, { isInlineRenderRequested }] = await Promise.all([
         import("./ui/components/v3/index.js"),
         import("./ui/mount-interactive-ink.js"),
         import("./ui/alt-buffer.js"),
+        import("./ui/inline-render.js"),
     ]);
     const { isAltBufferRequested, enterAltBuffer, exitAltBuffer } = altBufferModule;
-    const wantsAltBuffer = isAltBufferRequested(true);
+    // Inline main-buffer + <Static> rendering is mutually exclusive with
+    // the alt buffer (phased rollout behind WOTANN_TUI_INLINE=1).
+    const inlineMode = isInlineRenderRequested();
+    const wantsAltBuffer = isAltBufferRequested(true) && !inlineMode;
     // v0.5.89 hotfix: alt-buffer entry is now gated through `onResolved`
     // so a guard refusal never swallows the diagnostic. See start
     // command for the full discussion.
@@ -1979,6 +1980,7 @@ program
             initialProvider: session.provider,
             initialMessages: session.messages,
             runtime: interactive.runtime,
+            inline: inlineMode,
         }), {
             onResolved: () => {
                 if (wantsAltBuffer)

package/dist/ui/components/v3/AppV3.d.ts

@@ -50,6 +50,15 @@ export interface AppV3Props {
     readonly initialProvider?: ProviderName;
     readonly initialMessages?: readonly AgentMessage[];
     readonly runtime?: WotannRuntime;
+    /**
+     * AppV4 inline render mode — committed history renders in Ink `<Static>`
+     * (written once into the terminal's native scrollback) and only the
+     * in-flight turn repaints, eliminating streaming flicker. The mount path
+     * (src/index.ts) also skips the alt-screen buffer when this is set, since
+     * `<Static>` needs main-buffer scrollback. Phased rollout behind
+     * `WOTANN_TUI_INLINE=1`; defaults off.
+     */
+    readonly inline?: boolean;
     /**
      * Optional capability-profile override — primarily for tests so the
      * tier is deterministic without manipulating `process.env`. When
@@ -107,4 +116,4 @@ export interface AppV3Props {
  * renders without a missing-style crash.
  */
 export declare function toTranscriptMessages(messages: readonly AgentMessage[]): readonly TranscriptMessageV3[];
-export declare function AppV3({ version: _version, providers, initialModel, initialProvider, initialMessages, runtime, profileOverride, columnsOverride, rowsOverride, uiStatePathOverride, statuslineConfigPathOverride, layoutConfigPathOverride, snippetDbPathOverride, }: AppV3Props): React.ReactElement;
+export declare function AppV3({ version: _version, providers, initialModel, initialProvider, initialMessages, runtime, inline, profileOverride, columnsOverride, rowsOverride, uiStatePathOverride, statuslineConfigPathOverride, layoutConfigPathOverride, snippetDbPathOverride, }: AppV3Props): React.ReactElement;

package/dist/ui/components/v3/AppV3.js

@@ -224,7 +224,7 @@ function NoProviderHint() {
     const choices = useMemo(() => buildOnboardingAuthChoices().slice(0, 4), []);
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: tone.muted, children: "No provider configured \u2014 authenticate the standard way:" }), choices.map((c) => (_jsxs(Text, { color: tone.muted, children: ["  • ", c.label, ": ", c.hint] }, c.id)))] }));
 }
-function AppV3Inner({ providers, initialModel, initialProvider, messages, isStreaming, setIsStreaming, draftValue, setDraftValue, setMessages, profile, terminalCapabilities, runtime, escPrimed, quitConfirm, bannerVariant, setBannerVariant, slashRouter, slashContext, themeManager, tourResolved, setTourResolved, persistedOnboarded, sidePaneVisible, sidePaneSnapshotMessages, sidePaneLocalMessages, sidePaneStreaming, setSidePaneLocalMessages, setSidePaneStreaming, closeSidePane, toggleSidePane, statuslineSegments, sessionStartedAt, activeGoal, vimMode, petMode, statusBarPosition, }) {
+function AppV3Inner({ providers, initialModel, initialProvider, messages, isStreaming, setIsStreaming, draftValue, setDraftValue, setMessages, profile, terminalCapabilities, runtime, escPrimed, quitConfirm, bannerVariant, setBannerVariant, slashRouter, slashContext, themeManager, tourResolved, setTourResolved, persistedOnboarded, sidePaneVisible, sidePaneSnapshotMessages, sidePaneLocalMessages, sidePaneStreaming, setSidePaneLocalMessages, setSidePaneStreaming, closeSidePane, toggleSidePane, statuslineSegments, sessionStartedAt, activeGoal, vimMode, petMode, statusBarPosition, inline, staticEpoch, }) {
     const { tone } = useThemeTone();
     const overlay = useOverlayManager();
     const { columns, rows } = useTerminalWidth();
@@ -237,6 +237,11 @@ function AppV3Inner({ providers, initialModel, initialProvider, messages, isStre
     const maxTranscriptScrollOffset = Math.max(0, transcriptMessages.length - transcriptVisibleCount);
     const [transcriptScrollOffset, setTranscriptScrollOffset] = useState(0);
     const activeRunRef = useRef(null);
+    // AppV4 inline render — the committed-prefix length captured at turn
+    // start. While streaming, messages[0..streamBoundary) stay frozen in
+    // <Static> and only the in-flight turn (the suffix) repaints. See the
+    // `committedCount` derivation below.
+    const streamBoundaryRef = useRef(0);
     const sideActiveRunRef = useRef(null);
     // Hermes Gap 2 — interrupt-and-redirect: persistent channel for the
     // host composer's mid-stream redirects. Ctrl+R captures the current
@@ -247,6 +252,13 @@ function AppV3Inner({ providers, initialModel, initialProvider, messages, isStre
     const redirectChannelRef = useRef(new InMemoryRedirectChannel());
     const [sidePaneDraft, setSidePaneDraft] = useState("");
     const [nowMs, setNowMs] = useState(() => Date.now());
+    // AppV4 inline render boundary. Streaming → freeze the committed prefix
+    // at the turn-start length (only the in-flight turn repaints). Idle →
+    // everything is committed (→ <Static>). The min() guards against a stale
+    // boundary briefly exceeding the live length (e.g. right after /clear).
+    const committedCount = isStreaming
+        ? Math.min(streamBoundaryRef.current, transcriptMessages.length)
+        : transcriptMessages.length;
     useEffect(() => {
         setTranscriptScrollOffset(0);
     }, [messages.length]);
@@ -388,6 +400,12 @@ function AppV3Inner({ providers, initialModel, initialProvider, messages, isStre
         const turnContext = messages;
         const abortController = new AbortController();
         activeRunRef.current = abortController;
+        // Freeze the inline-render commit boundary at the pre-turn length so
+        // the prior history stays in <Static> and only this turn (user msg +
+        // streaming assistant + tool rows) repaints live. On finalize,
+        // isStreaming flips false and committedCount jumps to the full
+        // length, committing the whole turn to scrollback at once.
+        streamBoundaryRef.current = messages.length;
         setIsStreaming(true);
         setMessages((prev) => [...prev, userMessage]);
         void (async () => {
@@ -852,7 +870,7 @@ function AppV3Inner({ providers, initialModel, initialProvider, messages, isStre
     // "the UI isnt quite what I like… Minimal yet powerful. It's just a bit
     // too much." Provider status moved to the /providers slash command.
     const heavyChrome = process.env["WOTANN_TUI_HEAVY"] === "1";
-    const mainSurface = showSplash ? (_jsxs(Box, { flexDirection: "column", children: [heavyChrome ? (_jsxs(_Fragment, { children: [_jsx(GradientBanner, { profile: profile, state: bannerState, variant: bannerVariant }), _jsx(ModeCycle, { profile: profile, currentMode: currentMode })] })) : null, showTour ? (_jsx(Box, { marginTop: heavyChrome ? 1 : 0, children: _jsx(OnboardingTour, { profile: profile, authChoices: tourAuthChoices, themeChoices: tourThemeChoices, onComplete: finishTour, onDismiss: skipTour }) })) : (_jsxs(Box, { flexDirection: "column", marginTop: heavyChrome ? 1 : 0, marginBottom: 1, paddingLeft: 2, children: [!heavyChrome && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: tone.primary, bold: true, children: "WOTANN" }) })), _jsx(Text, { color: tone.muted, children: "Ready. Type to begin, / for commands, @ to reference files." }), providers.length === 0 ? (_jsx(Box, { marginTop: 1, children: _jsx(NoProviderHint, {}) })) : heavyChrome ? (_jsx(Box, { marginTop: 1, children: _jsx(ProviderStrip, { providers: providers, profile: profile }) })) : null] }))] })) : (_jsx(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: _jsx(Transcript, { messages: transcriptMessages, profile: profile, terminalCapabilities: terminalCapabilities, visibleCount: transcriptVisibleCount, scrollOffset: transcriptScrollOffset }) }));
+    const mainSurface = showSplash ? (_jsxs(Box, { flexDirection: "column", children: [heavyChrome ? (_jsxs(_Fragment, { children: [_jsx(GradientBanner, { profile: profile, state: bannerState, variant: bannerVariant }), _jsx(ModeCycle, { profile: profile, currentMode: currentMode })] })) : null, showTour ? (_jsx(Box, { marginTop: heavyChrome ? 1 : 0, children: _jsx(OnboardingTour, { profile: profile, authChoices: tourAuthChoices, themeChoices: tourThemeChoices, onComplete: finishTour, onDismiss: skipTour }) })) : (_jsxs(Box, { flexDirection: "column", marginTop: heavyChrome ? 1 : 0, marginBottom: 1, paddingLeft: 2, children: [!heavyChrome && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: tone.primary, bold: true, children: "WOTANN" }) })), _jsx(Text, { color: tone.muted, children: "Ready. Type to begin, / for commands, @ to reference files." }), providers.length === 0 ? (_jsx(Box, { marginTop: 1, children: _jsx(NoProviderHint, {}) })) : heavyChrome ? (_jsx(Box, { marginTop: 1, children: _jsx(ProviderStrip, { providers: providers, profile: profile }) })) : null] }))] })) : (_jsx(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: _jsx(Transcript, { messages: transcriptMessages, profile: profile, terminalCapabilities: terminalCapabilities, visibleCount: transcriptVisibleCount, scrollOffset: transcriptScrollOffset, inline: inline, committedCount: committedCount, staticEpoch: staticEpoch }) }));
     const statusBarRow = (_jsx(Box, { marginTop: statusBarPosition === "bottom" ? 1 : 0, marginBottom: statusBarPosition === "top" ? 1 : 0, children: _jsx(StatusBar, { model: initialModel, provider: initialProvider, mode: currentMode, usedTokens: usedTokens, maxTokens: maxTokens, costUsd: sessionCostUsd, reads: 0, edits: 0, bashCalls: 0, isStreaming: isStreaming, contextTrend: contextTrend, profile: profile }) }));
     return (_jsxs(Box, { flexDirection: "column", children: [statusBarPosition === "top" && statusBarRow, _jsxs(Box, { flexDirection: sidePaneVisible && columns >= 80 ? "row" : "column", gap: 1, children: [_jsx(Box, { flexDirection: "column", flexGrow: 1, flexShrink: 1, children: mainSurface }), _jsx(SidePane, { visible: sidePaneVisible, snapshotMessages: sidePaneSnapshotMessages, localMessages: sidePaneLocalMessages, profile: profile, onDismiss: closeSidePane, onPinToHost: () => promoteSidePaneToHost(), children: _jsx(PromptInput, { onSubmit: handleSidePaneSubmit, onChange: setSidePaneDraft, onAbort: handleSidePaneAbort, isStreaming: sidePaneStreaming, value: sidePaneDraft, vimMode: vimMode, placeholder: "Ask in this fork (/pin, /unfork, /clear)", mode: "side" }) })] }), showTypedSlashPanel && (_jsx(Box, { marginBottom: 0, children: _jsx(TypedSlashPanel, { draft: draftValue, commands: paletteCommands }) })), isStreaming && (_jsx(Box, { paddingX: 2, marginTop: 1, children: _jsx(RavensFlight, { active: isStreaming, tone: tone, label: "thinking", width: 16 }) })), !isStreaming && petMode === "raven" && (_jsx(Box, { paddingX: 2, marginTop: 1, children: _jsx(RavensFlight, { active: true, tone: tone, label: "companion", width: 16 }) })), _jsx(Box, { marginTop: 1, paddingX: 2, children: _jsxs(Box, { gap: 1, children: [_jsx(SigilStamp, { kind: sigilKind, tone: tone, nonce: sigilNonce }), _jsx(Statusline, { profile: profile, segments: statuslineSegments, model: initialModel, effort: currentMode, sandbox: runtime?.getPermissionMode?.() ?? "—", tokensUsed: usedTokens, tokensTotal: maxTokens, cost: sessionCostUsd, goal: activeGoal, uptimeMs: nowMs - sessionStartedAt })] }) }), _jsx(Composer, { profile: profile, children: _jsx(PromptInput, { onSubmit: handleSubmit, onChange: handleChange, onAbort: handleAbort, onPasteImageText: handlePasteImageText, imageAttachmentCount: pendingImages.length, disabled: sidePaneVisible, isStreaming: isStreaming, value: draftValue, vimMode: vimMode, placeholder: sidePaneVisible ? "Side fork owns input (/unfork to return)" : "Ask anything" }) }), _jsx(OverlayPaletteMount, { commands: paletteCommands, onSelect: (cmd) => {
                     // Dispatch through the router with the empty arg + the real
@@ -901,10 +919,15 @@ export function AppV3({
 // (the gradient banner replaced the version-tagged splash). Prefixed
 // with `_` so the noUnusedParameters check is satisfied while the
 // prop stays in the public interface.
-version: _version, providers, initialModel = "", initialProvider = "", initialMessages = [], runtime, profileOverride, columnsOverride, rowsOverride, uiStatePathOverride, statuslineConfigPathOverride, layoutConfigPathOverride, snippetDbPathOverride, }) {
+version: _version, providers, initialModel = "", initialProvider = "", initialMessages = [], runtime, inline = false, profileOverride, columnsOverride, rowsOverride, uiStatePathOverride, statuslineConfigPathOverride, layoutConfigPathOverride, snippetDbPathOverride, }) {
     const themeManager = useThemeManager(uiStatePathOverride);
     const [palette, setPalette] = useState(themeManager.getCurrent().colors);
     const [messages, setMessages] = useState([...initialMessages]);
+    // AppV4 inline render: bumping this remounts the <Static> committed-
+    // history region with a fresh append-index. Bumped by clearTranscript
+    // (/clear) — Static only appends, so without a remount it would silently
+    // drop every row added after a clear (its lastIndex stays stale).
+    const [staticEpoch, setStaticEpoch] = useState(0);
     const [isStreaming, setIsStreaming] = useState(false);
     const [draftValue, setDraftValue] = useState("");
     const [activeModel, setActiveModel] = useState(initialModel);
@@ -1021,7 +1044,13 @@ version: _version, providers, initialModel = "", initialProvider = "", initialMe
                 providerRef.current = next;
                 setActiveProvider(next);
             },
-            clearTranscript: () => setMessages([]),
+            clearTranscript: () => {
+                setMessages([]);
+                // Remount <Static> so the inline-render append-index resets; the
+                // already-emitted rows remain in native scrollback (Claude-Code
+                // semantics: /clear starts a fresh surface below).
+                setStaticEpoch((epoch) => epoch + 1);
+            },
             setVimMode: (enabled) => {
                 vimModeRef.current = enabled;
                 setVimMode(enabled);
@@ -1211,5 +1240,5 @@ version: _version, providers, initialModel = "", initialProvider = "", initialMe
         }, 2000);
         return () => clearTimeout(id);
     }, [escPrimed, quitConfirm]);
-    return (_jsx(ThemeProvider, { palette: palette ?? PALETTES.dark, children: _jsx(WidthAwareLayout, { overrideColumns: columnsOverride, overrideRows: rowsOverride, children: _jsx(OverlayManager, { closeOnEscape: false, children: _jsx(AppV3Inner, { providers: providers, initialModel: activeModel, initialProvider: activeProvider, messages: messages, isStreaming: isStreaming, setIsStreaming: setIsStreaming, draftValue: draftValue, setDraftValue: setDraftValue, setMessages: setMessages, profile: profile, terminalCapabilities: terminalCapabilities, runtime: runtime, escPrimed: escPrimed, quitConfirm: quitConfirm, bannerVariant: bannerVariant, setBannerVariant: setBannerVariant, slashRouter: slashRouter, slashContext: slashContextRef.current, themeManager: themeManager, tourResolved: tourResolved, setTourResolved: setTourResolved, persistedOnboarded: persistedOnboarded, sidePaneVisible: sidePaneVisible, sidePaneSnapshotMessages: sidePaneSnapshotMessages, sidePaneLocalMessages: sidePaneLocalMessages, sidePaneStreaming: sidePaneStreaming, setSidePaneLocalMessages: setSidePaneLocalMessages, setSidePaneStreaming: setSidePaneStreaming, closeSidePane: closeSidePane, toggleSidePane: toggleSidePane, statuslineSegments: statuslineSegments, sessionStartedAt: sessionStartedAtRef.current, activeGoal: activeGoal, vimMode: vimMode, petMode: petMode, statusBarPosition: statusBarPosition }) }) }) }));
+    return (_jsx(ThemeProvider, { palette: palette ?? PALETTES.dark, children: _jsx(WidthAwareLayout, { overrideColumns: columnsOverride, overrideRows: rowsOverride, children: _jsx(OverlayManager, { closeOnEscape: false, children: _jsx(AppV3Inner, { providers: providers, initialModel: activeModel, initialProvider: activeProvider, messages: messages, isStreaming: isStreaming, setIsStreaming: setIsStreaming, draftValue: draftValue, setDraftValue: setDraftValue, setMessages: setMessages, profile: profile, terminalCapabilities: terminalCapabilities, runtime: runtime, escPrimed: escPrimed, quitConfirm: quitConfirm, bannerVariant: bannerVariant, setBannerVariant: setBannerVariant, slashRouter: slashRouter, slashContext: slashContextRef.current, themeManager: themeManager, tourResolved: tourResolved, setTourResolved: setTourResolved, persistedOnboarded: persistedOnboarded, sidePaneVisible: sidePaneVisible, sidePaneSnapshotMessages: sidePaneSnapshotMessages, sidePaneLocalMessages: sidePaneLocalMessages, sidePaneStreaming: sidePaneStreaming, setSidePaneLocalMessages: setSidePaneLocalMessages, setSidePaneStreaming: setSidePaneStreaming, closeSidePane: closeSidePane, toggleSidePane: toggleSidePane, statuslineSegments: statuslineSegments, sessionStartedAt: sessionStartedAtRef.current, activeGoal: activeGoal, vimMode: vimMode, petMode: petMode, statusBarPosition: statusBarPosition, inline: inline, staticEpoch: staticEpoch }) }) }) }));
 }

package/dist/ui/components/v3/Transcript.d.ts

@@ -45,6 +45,26 @@ export interface TranscriptProps {
      */
     readonly scrollOffset?: number;
     readonly terminalCapabilities: TerminalCapabilities;
+    /**
+     * AppV4 inline mode: render committed history via Ink `<Static>`
+     * (write-once into native terminal scrollback) and only the in-flight
+     * turn live. Off (default) keeps the legacy windowed alt-buffer render.
+     */
+    readonly inline?: boolean;
+    /**
+     * Count of finalized (committed) messages. In inline mode,
+     * `messages[0..committedCount)` render in `<Static>` and
+     * `messages[committedCount..)` render live. Defaults to `messages.length`
+     * (everything committed — the idle state) when omitted.
+     */
+    readonly committedCount?: number;
+    /**
+     * Monotonic epoch that remounts the `<Static>` region. Bumped on
+     * `/clear` so Static's internal append-index resets to 0 — required
+     * because Static only ever appends and would otherwise silently drop
+     * every row added after a clear.
+     */
+    readonly staticEpoch?: number;
 }
 export interface TranscriptWindow {
     readonly messages: readonly TranscriptMessageV3[];
@@ -53,4 +73,4 @@ export interface TranscriptWindow {
     readonly scrollOffset: number;
 }
 export declare function selectTranscriptWindow(messages: readonly TranscriptMessageV3[], visibleCount: number | undefined, scrollOffset?: number): TranscriptWindow;
-export declare function Transcript({ messages, profile, visibleCount, scrollOffset, terminalCapabilities, }: TranscriptProps): React.ReactElement;
+export declare function Transcript({ messages, profile, visibleCount, scrollOffset, terminalCapabilities, inline, committedCount, staticEpoch, }: TranscriptProps): React.ReactElement;

package/dist/ui/components/v3/Transcript.js

@@ -1,36 +1,9 @@
-import { jsxs as _jsxs, jsx as _jsx } from "#wotann-jsx/jsx-runtime";
-import { Box, Text } from "ink";
-import { glyph } from "../../theme/tokens.js";
+import { jsx as _jsx, jsxs as _jsxs } from "#wotann-jsx/jsx-runtime";
+import { Box, Static, Text } from "ink";
 import { useThemeTone } from "../../theme/context.js";
 import { spacingForWidth } from "../../theme/tokens-v3.js";
 import { useTerminalWidth } from "./WidthAwareLayout.js";
-import { parseSlashResultMessage, SystemMessageCard } from "./SystemMessageCard.js";
-import { KittyGraphics } from "./KittyGraphics.js";
-// Minimal role markers — Claude Code / Codex parity. User gets a
-// single subtle ❯ (same glyph as the composer prompt); the assistant
-// is PURE content (no badge, no label, no gutter) — the biggest
-// declutter; system/tool get a dim · marker. No per-message gutter
-// bar, no Norse runes, nothing bold.
-const ROLE_STYLES_AB = {
-    user: { gutterTone: "primary", badge: glyph.prompt, label: "" },
-    assistant: { gutterTone: "muted", badge: "", label: "" },
-    system: { gutterTone: "warning", badge: "·", label: "system" },
-    tool: { gutterTone: "muted", badge: "·", label: "tool" },
-};
-const ROLE_STYLES_C = {
-    user: { gutterTone: "primary", badge: ">", label: "" },
-    assistant: { gutterTone: "muted", badge: "", label: "" },
-    system: { gutterTone: "warning", badge: "*", label: "system" },
-    tool: { gutterTone: "muted", badge: "*", label: "tool" },
-};
-function formatTime(timestamp) {
-    if (typeof timestamp !== "number" || !Number.isFinite(timestamp))
-        return null;
-    const d = new Date(timestamp);
-    const hh = String(d.getHours()).padStart(2, "0");
-    const mm = String(d.getMinutes()).padStart(2, "0");
-    return `${hh}:${mm}`;
-}
+import { TranscriptRow } from "./TranscriptRow.js";
 export function selectTranscriptWindow(messages, visibleCount, scrollOffset = 0) {
     const capacity = typeof visibleCount === "number" && Number.isFinite(visibleCount)
         ? Math.max(1, Math.floor(visibleCount))
@@ -54,36 +27,23 @@ export function selectTranscriptWindow(messages, visibleCount, scrollOffset = 0)
         scrollOffset: clampedOffset,
     };
 }
-export function Transcript({ messages, profile, visibleCount, scrollOffset = 0, terminalCapabilities, }) {
+export function Transcript({ messages, profile, visibleCount, scrollOffset = 0, terminalCapabilities, inline = false, committedCount, staticEpoch = 0, }) {
     const { tone } = useThemeTone();
     const { breakpoint } = useTerminalWidth();
     const spacing = spacingForWidth(breakpoint);
-    const styles = profile.tier === "C" ? ROLE_STYLES_C : ROLE_STYLES_AB;
+    // AppV4 inline render: committed history → Ink <Static> (written once
+    // into the terminal's native scrollback), and ONLY the in-flight turn
+    // repaints. This is the streaming-flicker fix. It requires the main
+    // buffer (the alt buffer has no scrollback); the mount path guarantees
+    // alt-buffer is skipped whenever inline is on. The windowed
+    // selectTranscriptWindow paging below is replaced by native scrollback.
+    if (inline) {
+        const boundary = Math.max(0, Math.min(committedCount ?? messages.length, messages.length));
+        const committed = messages.slice(0, boundary);
+        const live = messages.slice(boundary);
+        const pad = spacing.transcriptRowPaddingX;
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: committed, children: (msg) => (_jsx(Box, { paddingX: pad, children: _jsx(TranscriptRow, { msg: msg, profile: profile, terminalCapabilities: terminalCapabilities }) }, msg.id)) }, staticEpoch), live.length > 0 && (_jsx(Box, { flexDirection: "column", paddingX: pad, children: live.map((msg) => (_jsx(TranscriptRow, { msg: msg, profile: profile, terminalCapabilities: terminalCapabilities }, msg.id))) }))] }));
+    }
     const window = selectTranscriptWindow(messages, visibleCount, scrollOffset);
-    return (_jsxs(Box, { flexDirection: "column", paddingX: spacing.transcriptRowPaddingX, children: [window.hiddenBefore > 0 && _jsxs(Text, { color: tone.muted, children: ["\u2191 ", window.hiddenBefore, " earlier"] }), window.messages.map((msg) => {
-                // Route slash-command results to the richer SystemMessageCard so
-                // a `/model` dispatch reads as a harness response rather than a
-                // user message. The marker-based handshake keeps the Transcript
-                // schema unchanged — system messages without the marker fall
-                // through to the default render below.
-                if (msg.role === "system") {
-                    const payload = parseSlashResultMessage(msg.content);
-                    if (payload !== null) {
-                        return _jsx(SystemMessageCard, { payload: payload, profile: profile }, msg.id);
-                    }
-                }
-                const style = styles[msg.role];
-                const gutterColor = tone[style.gutterTone];
-                const timeString = formatTime(msg.timestamp);
-                const lines = msg.content.length === 0 ? [""] : msg.content.split("\n");
-                const attachments = msg.attachments ?? [];
-                const hasHeader = style.badge !== "" || style.label !== "" || timeString !== null;
-                return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [hasHeader && (_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Box, { gap: 1, children: [style.badge !== "" && _jsx(Text, { color: gutterColor, children: style.badge }), style.label !== "" && _jsx(Text, { color: gutterColor, children: style.label })] }), timeString !== null && _jsx(Text, { color: tone.muted, children: timeString })] })), lines.map((line, i) => (_jsx(Text, { color: tone.text, children: line.length === 0 ? " " : line }, `msg-${msg.id}-line-${i}`))), attachments.map((attachment, i) => {
-                            if (attachment.kind === "image" && attachment.dataUri !== undefined) {
-                                return (_jsx(KittyGraphics, { source: attachment.dataUri, capabilities: terminalCapabilities, rows: profile.tier === "C" ? 3 : 5, columns: profile.tier === "C" ? 28 : 40, caption: attachment.path }, `msg-${msg.id}-att-${i}`));
-                            }
-                            const label = attachment.kind === "image" ? "image" : "file";
-                            return (_jsxs(Text, { color: tone.muted, italic: true, children: ["[", label, ": ", attachment.path, "]"] }, `msg-${msg.id}-att-${i}`));
-                        })] }, msg.id));
-            }), window.hiddenAfter > 0 && _jsxs(Text, { color: tone.muted, children: ["\u2193 ", window.hiddenAfter, " newer"] })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: spacing.transcriptRowPaddingX, children: [window.hiddenBefore > 0 && _jsxs(Text, { color: tone.muted, children: ["\u2191 ", window.hiddenBefore, " earlier"] }), window.messages.map((msg) => (_jsx(TranscriptRow, { msg: msg, profile: profile, terminalCapabilities: terminalCapabilities }, msg.id))), window.hiddenAfter > 0 && _jsxs(Text, { color: tone.muted, children: ["\u2193 ", window.hiddenAfter, " newer"] })] }));
 }

package/dist/ui/components/v3/TranscriptRow.d.ts

@@ -0,0 +1,45 @@
+/**
+ * TranscriptRow — a single memoized conversation row.
+ *
+ * Extracted from `Transcript.tsx`'s inline row map so it can be rendered
+ * in BOTH places the AppV4 inline model needs it:
+ *   1. Committed history inside Ink `<Static>` (write-once → terminal
+ *      scrollback). Static never re-renders an emitted row, so the memo
+ *      is moot there — but identity-stable rows keep the contract clean.
+ *   2. The live in-flight turn (the streaming assistant row + its tool
+ *      rows). Here the memo earns its keep: while the assistant row's
+ *      content grows token-by-token, the sibling rows (the user prompt,
+ *      finished tool rows) MUST NOT re-render.
+ *
+ * Why a CUSTOM comparator (not the default shallow `React.memo`):
+ * `toTranscriptMessages` rebuilds a fresh object for every message on
+ * every render (`messages.map((m) => ({...}))`), so a by-reference memo
+ * would re-render every row on every streamed token — defeating the
+ * point. We compare the fields that actually drive the render. The
+ * `attachments` array survives a reference check because
+ * `toTranscriptMessages` threads the SAME array through (it never copies
+ * it), so an unchanged message keeps an identity-stable attachments ref.
+ *
+ * Rendering is byte-identical to the prior inline map (Phase 1 is a pure
+ * no-op refactor): the horizontal padding stays a concern of the
+ * container/Static call-site, never the row, so this component composes
+ * the same in either mounting context.
+ */
+import React from "react";
+import type { CapabilityProfile } from "../../capability-tier.js";
+import type { TerminalCapabilities } from "../../terminal-capabilities.js";
+import type { TranscriptMessageV3 } from "./Transcript.js";
+export interface TranscriptRowProps {
+    readonly msg: TranscriptMessageV3;
+    readonly profile: CapabilityProfile;
+    readonly terminalCapabilities: TerminalCapabilities;
+}
+declare function TranscriptRowImpl({ msg, profile, terminalCapabilities, }: TranscriptRowProps): React.ReactElement;
+/**
+ * Memo comparator — return TRUE to SKIP a re-render. Exported for direct
+ * unit testing (the streaming hot-path depends on this returning true for
+ * an unchanged sibling row while the assistant row streams).
+ */
+export declare function transcriptRowsEqual(prev: TranscriptRowProps, next: TranscriptRowProps): boolean;
+export declare const TranscriptRow: React.MemoExoticComponent<typeof TranscriptRowImpl>;
+export {};

package/dist/ui/components/v3/TranscriptRow.js

@@ -0,0 +1,102 @@
+import { jsx as _jsx, jsxs as _jsxs } from "#wotann-jsx/jsx-runtime";
+/**
+ * TranscriptRow — a single memoized conversation row.
+ *
+ * Extracted from `Transcript.tsx`'s inline row map so it can be rendered
+ * in BOTH places the AppV4 inline model needs it:
+ *   1. Committed history inside Ink `<Static>` (write-once → terminal
+ *      scrollback). Static never re-renders an emitted row, so the memo
+ *      is moot there — but identity-stable rows keep the contract clean.
+ *   2. The live in-flight turn (the streaming assistant row + its tool
+ *      rows). Here the memo earns its keep: while the assistant row's
+ *      content grows token-by-token, the sibling rows (the user prompt,
+ *      finished tool rows) MUST NOT re-render.
+ *
+ * Why a CUSTOM comparator (not the default shallow `React.memo`):
+ * `toTranscriptMessages` rebuilds a fresh object for every message on
+ * every render (`messages.map((m) => ({...}))`), so a by-reference memo
+ * would re-render every row on every streamed token — defeating the
+ * point. We compare the fields that actually drive the render. The
+ * `attachments` array survives a reference check because
+ * `toTranscriptMessages` threads the SAME array through (it never copies
+ * it), so an unchanged message keeps an identity-stable attachments ref.
+ *
+ * Rendering is byte-identical to the prior inline map (Phase 1 is a pure
+ * no-op refactor): the horizontal padding stays a concern of the
+ * container/Static call-site, never the row, so this component composes
+ * the same in either mounting context.
+ */
+import React from "react";
+import { Box, Text } from "ink";
+import { glyph } from "../../theme/tokens.js";
+import { useThemeTone } from "../../theme/context.js";
+import { parseSlashResultMessage, SystemMessageCard } from "./SystemMessageCard.js";
+import { KittyGraphics } from "./KittyGraphics.js";
+// Minimal role markers — Claude Code / Codex parity. User gets a
+// single subtle ❯ (same glyph as the composer prompt); the assistant
+// is PURE content (no badge, no label, no gutter) — the biggest
+// declutter; system/tool get a dim · marker. No per-message gutter
+// bar, no Norse runes, nothing bold.
+const ROLE_STYLES_AB = {
+    user: { gutterTone: "primary", badge: glyph.prompt, label: "" },
+    assistant: { gutterTone: "muted", badge: "", label: "" },
+    system: { gutterTone: "warning", badge: "·", label: "system" },
+    tool: { gutterTone: "muted", badge: "·", label: "tool" },
+};
+const ROLE_STYLES_C = {
+    user: { gutterTone: "primary", badge: ">", label: "" },
+    assistant: { gutterTone: "muted", badge: "", label: "" },
+    system: { gutterTone: "warning", badge: "*", label: "system" },
+    tool: { gutterTone: "muted", badge: "*", label: "tool" },
+};
+function formatTime(timestamp) {
+    if (typeof timestamp !== "number" || !Number.isFinite(timestamp))
+        return null;
+    const d = new Date(timestamp);
+    const hh = String(d.getHours()).padStart(2, "0");
+    const mm = String(d.getMinutes()).padStart(2, "0");
+    return `${hh}:${mm}`;
+}
+function TranscriptRowImpl({ msg, profile, terminalCapabilities, }) {
+    const { tone } = useThemeTone();
+    const styles = profile.tier === "C" ? ROLE_STYLES_C : ROLE_STYLES_AB;
+    // Route slash-command results to the richer SystemMessageCard so a
+    // `/model` dispatch reads as a harness response rather than a user
+    // message. The marker-based handshake keeps the Transcript schema
+    // unchanged — system messages without the marker fall through to the
+    // default render below.
+    if (msg.role === "system") {
+        const payload = parseSlashResultMessage(msg.content);
+        if (payload !== null) {
+            return _jsx(SystemMessageCard, { payload: payload, profile: profile });
+        }
+    }
+    const style = styles[msg.role];
+    const gutterColor = tone[style.gutterTone];
+    const timeString = formatTime(msg.timestamp);
+    const lines = msg.content.length === 0 ? [""] : msg.content.split("\n");
+    const attachments = msg.attachments ?? [];
+    const hasHeader = style.badge !== "" || style.label !== "" || timeString !== null;
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [hasHeader && (_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Box, { gap: 1, children: [style.badge !== "" && _jsx(Text, { color: gutterColor, children: style.badge }), style.label !== "" && _jsx(Text, { color: gutterColor, children: style.label })] }), timeString !== null && _jsx(Text, { color: tone.muted, children: timeString })] })), lines.map((line, i) => (_jsx(Text, { color: tone.text, children: line.length === 0 ? " " : line }, `msg-${msg.id}-line-${i}`))), attachments.map((attachment, i) => {
+                if (attachment.kind === "image" && attachment.dataUri !== undefined) {
+                    return (_jsx(KittyGraphics, { source: attachment.dataUri, capabilities: terminalCapabilities, rows: profile.tier === "C" ? 3 : 5, columns: profile.tier === "C" ? 28 : 40, caption: attachment.path }, `msg-${msg.id}-att-${i}`));
+                }
+                const label = attachment.kind === "image" ? "image" : "file";
+                return (_jsxs(Text, { color: tone.muted, italic: true, children: ["[", label, ": ", attachment.path, "]"] }, `msg-${msg.id}-att-${i}`));
+            })] }));
+}
+/**
+ * Memo comparator — return TRUE to SKIP a re-render. Exported for direct
+ * unit testing (the streaming hot-path depends on this returning true for
+ * an unchanged sibling row while the assistant row streams).
+ */
+export function transcriptRowsEqual(prev, next) {
+    return (prev.msg.id === next.msg.id &&
+        prev.msg.content === next.msg.content &&
+        prev.msg.role === next.msg.role &&
+        prev.msg.timestamp === next.msg.timestamp &&
+        prev.msg.attachments === next.msg.attachments &&
+        prev.profile === next.profile &&
+        prev.terminalCapabilities === next.terminalCapabilities);
+}
+export const TranscriptRow = React.memo(TranscriptRowImpl, transcriptRowsEqual);

package/dist/ui/inline-render.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Inline-render mode gate (AppV4 flicker fix, phased rollout).
+ *
+ * The complete streaming-flicker fix renders the chat surface INLINE in
+ * the terminal's MAIN buffer (committed history written once into native
+ * scrollback via Ink `<Static>`) instead of the alternate screen buffer.
+ * The alt buffer has no scrollback, so `<Static>` is incompatible with it
+ * (committed rows would scroll off irrecoverably) — see
+ * docs/phase-0-redesign/phase-1-inline-architecture.md §0.
+ *
+ * Why a flag (not default-on yet): the mount-path change can only be
+ * validated for "feel" + cross-terminal correctness (iTerm2 / Terminal.app
+ * / tmux) on a PHYSICAL terminal, which CI/headless harnesses cannot
+ * reproduce (this is the same fragility that drove the PR #35-#38
+ * raw-mode/mount hardening). So inline mode ships behind
+ * `WOTANN_TUI_INLINE=1` for opt-in verification; once confirmed on a real
+ * terminal it becomes the default for the chat surface.
+ *
+ * The objective gate (eraseLines-sequence drop ≥90% vs the alt-buffer
+ * baseline) is exercised by the PTY byte-trace test, which DOES run here.
+ */
+/**
+ * Whether this session should render the chat surface inline in the main
+ * buffer (Ink `<Static>` committed history) rather than in the alt-screen
+ * buffer. Reads `WOTANN_TUI_INLINE`; defaults OFF during the phased
+ * rollout. Pass an explicit env for tests.
+ */
+export declare function isInlineRenderRequested(env?: NodeJS.ProcessEnv): boolean;

package/dist/ui/inline-render.js

@@ -0,0 +1,35 @@
+/**
+ * Inline-render mode gate (AppV4 flicker fix, phased rollout).
+ *
+ * The complete streaming-flicker fix renders the chat surface INLINE in
+ * the terminal's MAIN buffer (committed history written once into native
+ * scrollback via Ink `<Static>`) instead of the alternate screen buffer.
+ * The alt buffer has no scrollback, so `<Static>` is incompatible with it
+ * (committed rows would scroll off irrecoverably) — see
+ * docs/phase-0-redesign/phase-1-inline-architecture.md §0.
+ *
+ * Why a flag (not default-on yet): the mount-path change can only be
+ * validated for "feel" + cross-terminal correctness (iTerm2 / Terminal.app
+ * / tmux) on a PHYSICAL terminal, which CI/headless harnesses cannot
+ * reproduce (this is the same fragility that drove the PR #35-#38
+ * raw-mode/mount hardening). So inline mode ships behind
+ * `WOTANN_TUI_INLINE=1` for opt-in verification; once confirmed on a real
+ * terminal it becomes the default for the chat surface.
+ *
+ * The objective gate (eraseLines-sequence drop ≥90% vs the alt-buffer
+ * baseline) is exercised by the PTY byte-trace test, which DOES run here.
+ */
+/** Truthy values that opt a session into inline main-buffer rendering. */
+const TRUTHY = new Set(["1", "true", "yes", "on"]);
+/**
+ * Whether this session should render the chat surface inline in the main
+ * buffer (Ink `<Static>` committed history) rather than in the alt-screen
+ * buffer. Reads `WOTANN_TUI_INLINE`; defaults OFF during the phased
+ * rollout. Pass an explicit env for tests.
+ */
+export function isInlineRenderRequested(env = process.env) {
+    const value = env["WOTANN_TUI_INLINE"];
+    if (value === undefined)
+        return false;
+    return TRUTHY.has(value.trim().toLowerCase());
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wotann",
-  "version": "0.5.95",
+  "version": "0.5.96",
   "description": "WOTANN — The All-Father of AI Agent Harnesses",
   "type": "module",
   "main": "dist/index.js",

package/dist/ui/opentui-chat.d.ts

@@ -1,19 +0,0 @@
-import { type CliRenderer } from "@opentui/core";
-import { type Root } from "@opentui/react";
-import type { ProviderName, ProviderStatus } from "../core/types.js";
-import type { WotannRuntime } from "../core/runtime.js";
-export interface OpenTuiChatOptions {
-    readonly version: string;
-    readonly providers: readonly ProviderStatus[];
-    readonly initialProvider?: ProviderName;
-    readonly initialModel?: string;
-    readonly runtime: WotannRuntime;
-    readonly fullscreen?: boolean;
-}
-export interface OpenTuiChatHandle {
-    readonly renderer: CliRenderer;
-    readonly root: Root;
-    readonly waitUntilExit: Promise<void>;
-    stop(): Promise<void>;
-}
-export declare function mountOpenTuiChat(options: OpenTuiChatOptions): Promise<OpenTuiChatHandle>;

package/dist/ui/opentui-chat.js

@@ -1,285 +0,0 @@
-import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { createCliRenderer } from "@opentui/core";
-import { createRoot, useKeyboard } from "@opentui/react";
-import { runAgent } from "../core/runtime-agent-loop.js";
-import { buildAgentToolContext } from "../core/agent-tool-context.js";
-import { AGENT_TOOL_DEFINITIONS, executeAgentTool } from "../tools/agent-tools.js";
-export async function mountOpenTuiChat(options) {
-    const screenMode = options.fullscreen === false ? "main-screen" : "alternate-screen";
-    const renderer = await createCliRenderer({
-        screenMode,
-        exitOnCtrlC: false,
-        useMouse: true,
-        enableMouseMovement: true,
-        targetFps: 30,
-        maxFps: 60,
-        clearOnShutdown: options.fullscreen !== false,
-        useKittyKeyboard: {
-            disambiguate: true,
-            alternateKeys: true,
-            events: false,
-            allKeysAsEscapes: false,
-            reportText: true,
-        },
-    });
-    const root = createRoot(renderer);
-    let done = false;
-    let resolveExit;
-    const waitUntilExit = new Promise((resolve) => {
-        resolveExit = resolve;
-    });
-    const stop = async () => {
-        if (done)
-            return;
-        done = true;
-        root.unmount();
-        renderer.destroy();
-        resolveExit?.();
-    };
-    root.render(React.createElement(OpenTuiChatApp, { ...options, onExit: () => void stop() }));
-    return { renderer, root, waitUntilExit, stop };
-}
-function OpenTuiChatApp(props) {
-    const providerSummary = useMemo(() => summarizeProviders(props.providers), [props.providers]);
-    const [draft, setDraft] = useState("");
-    const [isStreaming, setIsStreaming] = useState(false);
-    const [messages, setMessages] = useState(() => [
-        {
-            id: "system-welcome",
-            role: "system",
-            content: `WOTANN ${props.version} native OpenTUI renderer ready. ` +
-                "Type a prompt, /help, /clear, or /quit.",
-        },
-    ]);
-    const messagesRef = useRef(messages);
-    const queueRef = useRef([]);
-    const abortRef = useRef(null);
-    const submitPromptRef = useRef(async () => { });
-    useEffect(() => {
-        messagesRef.current = messages;
-    }, [messages]);
-    const appendMessage = useCallback((message) => {
-        setMessages((prev) => [...prev, message]);
-    }, []);
-    const appendAssistantDelta = useCallback((id, content, model, provider) => {
-        setMessages((prev) => {
-            const existing = prev.find((message) => message.id === id);
-            if (!existing) {
-                return [...prev, { id, role: "assistant", content, model, provider }];
-            }
-            return prev.map((message) => message.id === id
-                ? {
-                    ...message,
-                    content: `${message.content}${content}`,
-                    ...(model ? { model } : {}),
-                    ...(provider ? { provider } : {}),
-                }
-                : message);
-        });
-    }, []);
-    const runQueued = useCallback(() => {
-        const [next, ...rest] = queueRef.current;
-        queueRef.current = rest;
-        if (next) {
-            void submitPromptRef.current(next);
-        }
-    }, []);
-    const submitPrompt = useCallback(async (rawPrompt) => {
-        const prompt = rawPrompt.trim();
-        if (!prompt)
-            return;
-        if (prompt === "/quit" || prompt === "/exit") {
-            props.onExit();
-            return;
-        }
-        if (prompt === "/clear") {
-            setMessages([]);
-            return;
-        }
-        if (prompt === "/help") {
-            appendMessage({
-                id: `system-${Date.now()}`,
-                role: "system",
-                content: "Commands: /help, /clear, /quit. Enter submits. Esc aborts an active turn. " +
-                    "OpenTUI provides native scroll, mouse, keyboard, and alternate-screen rendering.",
-            });
-            return;
-        }
-        if (isStreaming) {
-            queueRef.current = [...queueRef.current, prompt];
-            appendMessage({
-                id: `queued-${Date.now()}`,
-                role: "system",
-                content: `Queued next turn: ${prompt}`,
-            });
-            return;
-        }
-        const userMessage = {
-            id: `user-${Date.now()}`,
-            role: "user",
-            content: prompt,
-        };
-        const turnContext = messagesRef.current;
-        const abortController = new AbortController();
-        abortRef.current = abortController;
-        setIsStreaming(true);
-        appendMessage(userMessage);
-        const assistantId = `assistant-${Date.now()}`;
-        let failed = false;
-        try {
-            for await (const event of runAgent({
-                prompt,
-                context: turnContext,
-                model: props.initialModel || undefined,
-                provider: props.initialProvider || undefined,
-                tools: AGENT_TOOL_DEFINITIONS,
-                signal: abortController.signal,
-                query: (queryOptions) => props.runtime.query(queryOptions),
-                executeTool: (name, input) => executeAgentTool(name, input, buildAgentToolContext(props.runtime, {
-                    workingDir: props.runtime.getWorkingDir(),
-                    permissionMode: props.runtime.getPermissionMode(),
-                })),
-            })) {
-                if (abortController.signal.aborted)
-                    break;
-                if ("kind" in event) {
-                    if (event.kind === "tool_result") {
-                        appendMessage({
-                            id: `tool-${Date.now()}`,
-                            role: "tool",
-                            toolName: event.toolName,
-                            toolCallId: event.toolCallId,
-                            content: `${event.toolName}: ${previewToolResult(event.result)}`,
-                        });
-                    }
-                    continue;
-                }
-                if (event.type === "text" && event.content.length > 0) {
-                    appendAssistantDelta(assistantId, event.content, event.model, event.provider);
-                }
-                else if (event.type === "error") {
-                    failed = true;
-                    appendMessage({
-                        id: `error-${Date.now()}`,
-                        role: "system",
-                        content: `Runtime error: ${event.content || "query failed"}`,
-                    });
-                }
-            }
-        }
-        catch (err) {
-            failed = true;
-            appendMessage({
-                id: `error-${Date.now()}`,
-                role: "system",
-                content: `Runtime error: ${err instanceof Error ? err.message : String(err)}`,
-            });
-        }
-        finally {
-            abortRef.current = null;
-            setIsStreaming(false);
-            if (!failed && abortController.signal.aborted) {
-                appendMessage({
-                    id: `abort-${Date.now()}`,
-                    role: "system",
-                    content: "Turn aborted.",
-                });
-            }
-            runQueued();
-        }
-    }, [
-        appendAssistantDelta,
-        appendMessage,
-        isStreaming,
-        props,
-        runQueued,
-    ]);
-    useEffect(() => {
-        submitPromptRef.current = submitPrompt;
-    }, [submitPrompt]);
-    useKeyboard((key) => {
-        if (key.name === "escape" && abortRef.current) {
-            abortRef.current.abort();
-            return;
-        }
-        if ((key.name === "c" && key.ctrl) || key.name === "q") {
-            props.onExit();
-        }
-    });
-    const transcript = messages.map(formatMessage).join("\n\n");
-    const status = isStreaming
-        ? "streaming - Esc aborts"
-        : queueRef.current.length > 0
-            ? `${queueRef.current.length} queued`
-            : "ready";
-    return React.createElement("box", {
-        id: "wotann-opentui-root",
-        flexDirection: "column",
-        width: "100%",
-        height: "100%",
-        padding: 1,
-        backgroundColor: "#05070d",
-        gap: 1,
-    }, React.createElement("box", {
-        id: "wotann-opentui-header",
-        border: true,
-        borderColor: "#6ee7f9",
-        paddingX: 1,
-        height: 5,
-        flexDirection: "column",
-    }, React.createElement("text", {
-        content: `WOTANN ${props.version}  |  OpenTUI native renderer  |  ${status}`,
-        fg: "#67e8f9",
-    }), React.createElement("text", {
-        content: providerSummary,
-        fg: "#a7f3d0",
-    })), React.createElement("scrollbox", {
-        id: "wotann-opentui-transcript",
-        flexGrow: 1,
-        border: true,
-        borderColor: "#334155",
-        paddingX: 1,
-        scrollY: true,
-        stickyScroll: true,
-        stickyStart: "bottom",
-    }, React.createElement("text", {
-        content: transcript || "No messages yet.",
-        fg: "#e5e7eb",
-    })), React.createElement("box", {
-        id: "wotann-opentui-composer",
-        border: true,
-        borderColor: isStreaming ? "#f59e0b" : "#22c55e",
-        paddingX: 1,
-        height: 4,
-    }, React.createElement("input", {
-        id: "wotann-opentui-input",
-        value: draft,
-        placeholder: isStreaming ? "Streaming... type to queue next prompt" : "Ask WOTANN...",
-        focused: true,
-        onInput: setDraft,
-        onChange: setDraft,
-        onSubmit: (value) => {
-            setDraft("");
-            void submitPrompt(value);
-        },
-    })));
-}
-function summarizeProviders(providers) {
-    const available = providers.filter((provider) => provider.available);
-    if (available.length === 0) {
-        return "No provider configured. Run wotann init or set a provider API key.";
-    }
-    return `Providers: ${available.map((provider) => provider.label || provider.provider).join(", ")}`;
-}
-function formatMessage(message) {
-    const label = message.role === "assistant" && message.provider
-        ? `assistant:${message.provider}${message.model ? `/${message.model}` : ""}`
-        : message.toolName
-            ? `tool:${message.toolName}`
-            : message.role;
-    return `${label}> ${message.content}`;
-}
-function previewToolResult(result) {
-    const oneLine = result.replace(/\s+/g, " ").trim();
-    return oneLine.length > 240 ? `${oneLine.slice(0, 237)}...` : oneLine;
-}