@truss-harness/tui 0.1.14 → 0.1.18

package/dist/components.d.ts

@@ -0,0 +1,44 @@
+import type { LocalModelEndpoint } from "@truss-harness/provider-openai-compatible";
+import type { AgentProfile, ToolCall } from "@truss-harness/runtime";
+import type { FileEntry } from "./file-browser.js";
+import type { TuiTheme, TuiThemeName } from "./theme.js";
+import type { Screen, SettingsField } from "./types.js";
+export declare function Panel({ title, active, theme, children, }: {
+    readonly title: string;
+    readonly active: boolean;
+    readonly theme: TuiTheme;
+    readonly children: React.ReactNode;
+}): React.ReactElement;
+interface McpToolView {
+    readonly name: string;
+    readonly readOnly: boolean;
+}
+interface McpServerView {
+    readonly name: string;
+    readonly state: string;
+    readonly error?: string;
+    readonly toolCount: number;
+    readonly tools?: readonly McpToolView[];
+}
+export interface TuiOverlaysProps {
+    readonly screen: Screen;
+    readonly theme: TuiTheme;
+    readonly overlayWidth: number;
+    readonly fileSearchInput: string;
+    readonly fileSearchResults: readonly FileEntry[];
+    readonly fileSearchIndex: number;
+    readonly settingsField: SettingsField;
+    readonly selectedEndpoint?: LocalModelEndpoint;
+    readonly endpointInput: string;
+    readonly modelInput: string;
+    readonly models: readonly string[];
+    readonly modelIndex: number;
+    readonly internetAccess: boolean;
+    readonly themeName: TuiThemeName;
+    readonly providerKind: string;
+    readonly pendingTool?: ToolCall;
+    readonly agentProfiles: readonly AgentProfile[];
+    readonly mcpStatuses: readonly McpServerView[];
+}
+export declare function TuiOverlays(props: TuiOverlaysProps): React.ReactElement;
+export {};

package/dist/components.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { workspaceCommandHelp } from "@truss-harness/runtime";
+import { Box, Text } from "ink";
+import { truncate } from "./display.js";
+export function Panel({ title, active, theme, children, }) {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: active ? theme.focus : theme.panel, paddingX: 1, width: "100%", height: "100%", overflow: "hidden", children: [_jsx(Text, { color: active ? theme.focus : theme.muted, bold: true, children: title }), children] }));
+}
+const tuiControlHelp = [
+    [
+        "NAVIGATION",
+        "Tab / Shift+Tab move focus; Ctrl+Left / Ctrl+Right move to an adjacent pane.",
+    ],
+    [
+        "FILES",
+        "/ opens fuzzy file search; Up/Down select; Left/Right collapse or expand; Enter opens.",
+    ],
+    [
+        "EDITOR",
+        "Up/Down scroll; d toggles Git diff; o opens the detected preview URL externally.",
+    ],
+    [
+        "AGENT",
+        "Enter sends; a opens saved multi-agent profiles; Up/Down scroll chat; n starts a new conversation outside the chat input.",
+    ],
+    [
+        "MCP",
+        "c opens credential-safe server and tool status; R tests configured servers.",
+    ],
+    [
+        "TERMINAL",
+        "Type directly and press Enter; Up/Down scroll output; slash commands run through Truss.",
+    ],
+    [
+        "SETTINGS",
+        "m opens settings outside chat; Tab changes fields; Theme previews forest, sage, and dusk.",
+    ],
+    ["APPROVALS", "Y or Enter allows; N or Escape denies."],
+    [
+        "CANCEL / EXIT",
+        "Escape cancels an active agent run. Ctrl+C stops a process or run, and exits while idle.",
+    ],
+];
+export function TuiOverlays(props) {
+    const { screen, theme, overlayWidth, fileSearchInput, fileSearchResults, fileSearchIndex, settingsField, selectedEndpoint, endpointInput, modelInput, models, modelIndex, internetAccess, themeName, providerKind, pendingTool, agentProfiles, mcpStatuses, } = props;
+    return (_jsxs(_Fragment, { children: [screen === "file-search" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 3, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "FIND FILE" }), _jsxs(Text, { color: theme.text, children: [_jsx(Text, { color: theme.focus, children: "> " }), fileSearchInput || (_jsx(Text, { color: theme.muted, children: "Type part of a file name or path" }))] }), _jsx(Text, { color: theme.muted, children: "Up/Down select Enter open Escape close" }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [fileSearchResults.map((entry, index) => {
+                                const selected = index ===
+                                    Math.min(fileSearchIndex, Math.max(0, fileSearchResults.length - 1));
+                                const fileName = entry.path.split("/").at(-1) ?? entry.path;
+                                return (_jsxs(Text, { color: selected ? theme.focus : theme.text, bold: selected, children: [selected ? "> " : "  ", fileName, _jsxs(Text, { color: theme.muted, children: [" ", truncate(entry.path, Math.max(12, overlayWidth - fileName.length - 10))] })] }, entry.path));
+                            }), !fileSearchResults.length && (_jsx(Text, { color: theme.warning, children: "No matching files." }))] })] })), screen === "settings" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 3, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "LOCAL MODEL CONFIGURATION" }), _jsx(Text, { color: theme.muted, children: "Tab changes fields. Enter selects an item or saves when endpoint and model are set." }), _jsxs(Text, { color: settingsField === "server" ? theme.focus : theme.text, children: ["SERVER: ", selectedEndpoint?.label ?? "Scanning local servers..."] }), _jsxs(Text, { color: settingsField === "endpoint" ? theme.focus : theme.text, children: ["ENDPOINT: ", endpointInput] }), _jsxs(Text, { color: settingsField === "model" ? theme.focus : theme.text, children: ["MODEL:", " ", modelInput || models[modelIndex] || "Choose or type a model"] }), _jsxs(Text, { color: settingsField === "internet" ? theme.focus : theme.text, children: ["INTERNET RESEARCH: ", internetAccess ? "enabled" : "disabled", " ", settingsField === "internet" ? "[Space toggles]" : ""] }), _jsxs(Text, { color: settingsField === "theme" ? theme.focus : theme.text, children: ["THEME: ", themeName, " ", settingsField === "theme" ? "[Left/Right changes]" : ""] }), _jsxs(Text, { color: theme.muted, children: ["Detected models:", " ", models.slice(0, 5).join(", ") || "none; type one manually"] }), _jsxs(Text, { color: theme.warning, children: ["Provider: ", providerKind, ". Local endpoints use the server selector. Configure cloud BYOK profiles with truss-cli setup, then relaunch the TUI."] })] })), screen === "approval" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.warning, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 8, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.warning, children: "TOOL APPROVAL REQUIRED" }), _jsxs(Text, { color: theme.text, children: [pendingTool?.name, " ", JSON.stringify(pendingTool?.input)] }), _jsx(Text, { color: theme.muted, children: "Press Y or Enter to allow. Press N or Escape to deny." })] })), screen === "agents" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 6, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "MULTI-AGENT PROFILES" }), _jsx(Text, { color: theme.muted, children: "Profiles are shared with truss-cli in .truss-harness/agents.json. Use `truss agents run <id> <task>` for independent concurrent runs." }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [agentProfiles.map((profile) => (_jsxs(Text, { color: theme.text, children: [_jsx(Text, { color: theme.focus, children: profile.displayName }), _jsxs(Text, { color: theme.muted, children: [" ", profile.id.slice(0, 8), " ", profile.provider.providerId, "/", profile.provider.modelId, " ", profile.mode, " ", profile.approvalPolicy] })] }, profile.id))), !agentProfiles.length && (_jsx(Text, { color: theme.warning, children: "No profiles yet. Add one with `truss agents add <name>`." }))] }), _jsx(Text, { color: theme.muted, children: "R refreshes. A or Escape closes." })] })), screen === "mcp" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 6, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "MCP CONNECTIONS" }), _jsx(Text, { color: theme.muted, children: "Status and discovered tools only. Commands, environment values, and credentials remain hidden." }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [mcpStatuses.map((server) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: server.state === "failed"
+                                            ? theme.error
+                                            : server.state === "connected"
+                                                ? theme.success
+                                                : theme.warning, children: [_jsx(Text, { bold: true, children: server.name }), " ", server.state, server.error
+                                                ? ` — ${server.error}`
+                                                : ` — ${server.toolCount} tool${server.toolCount === 1 ? "" : "s"}`] }), (server.tools ?? []).map((tool) => (_jsxs(Text, { color: theme.muted, children: ["  ", tool.name, " [", tool.readOnly ? "read-only" : "approval", "]"] }, `${server.name}:${tool.name}`)))] }, server.name))), !mcpStatuses.length && (_jsx(Text, { color: theme.warning, children: "No MCP servers configured." }))] }), _jsx(Text, { color: theme.muted, children: "R tests configured servers. C or Escape closes." })] })), screen === "help" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 7, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "TUI CONTROLS" }), tuiControlHelp.map(([label, detail]) => (_jsxs(Text, { color: theme.text, wrap: "wrap", children: [_jsxs(Text, { bold: true, color: theme.focus, children: [label, ":", " "] }), detail] }, label))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: theme.accent, children: "WORKSPACE COMMANDS" }) }), workspaceCommandHelp()
+                        .split("\n")
+                        .slice(1)
+                        .map((line) => (_jsx(Text, { color: theme.text, children: line }, line))), _jsx(Text, { color: theme.muted, children: "Press any key to close this reference." })] }))] }));
+}

package/dist/display.d.ts

@@ -0,0 +1,10 @@
+import type { ChatDisplayLine, ChatMessage } from "./types.js";
+export declare function truncate(value: string, length: number): string;
+export declare function clamp(value: number, minimum: number, maximum: number): number;
+export declare function visibleLines<T>(items: readonly T[], count: number, offset: number): readonly T[];
+export declare function estimateTokens(value: string): number;
+export declare function formatTokenCount(value: number): string;
+export declare function wrapText(value: string, width: number): string[];
+export declare function plainChatText(value: string): string;
+export declare function chatDisplayLines(messages: readonly ChatMessage[], busy: boolean, width: number): readonly ChatDisplayLine[];
+export declare function configuredContextWindow(value?: string | undefined): number;

package/dist/display.js

@@ -0,0 +1,88 @@
+export function truncate(value, length) {
+    return value.length <= length
+        ? value
+        : `${value.slice(0, Math.max(0, length - 3))}...`;
+}
+export function clamp(value, minimum, maximum) {
+    return Math.min(Math.max(value, minimum), Math.max(minimum, maximum));
+}
+export function visibleLines(items, count, offset) {
+    const end = Math.max(0, items.length - clamp(offset, 0, Math.max(0, items.length - count)));
+    return items.slice(Math.max(0, end - count), end);
+}
+export function estimateTokens(value) {
+    const trimmed = value.trim();
+    return trimmed ? Math.ceil(trimmed.length / 4) : 0;
+}
+export function formatTokenCount(value) {
+    if (value < 1_000)
+        return String(Math.round(value));
+    return `${(value / 1_000).toFixed(value >= 10_000 ? 0 : 1).replace(/\.0$/, "")}k`;
+}
+export function wrapText(value, width) {
+    const result = [];
+    for (const sourceLine of value.split(/\r?\n/)) {
+        let remaining = sourceLine || " ";
+        while (remaining.length > width) {
+            const breakAt = Math.max(1, remaining.lastIndexOf(" ", width));
+            result.push(remaining.slice(0, breakAt).trimEnd());
+            remaining = remaining.slice(breakAt).trimStart();
+        }
+        result.push(remaining);
+    }
+    return result;
+}
+export function plainChatText(value) {
+    let inCodeBlock = false;
+    return value
+        .split(/\r?\n/)
+        .flatMap((sourceLine) => {
+        if (/^\s*```/.test(sourceLine)) {
+            inCodeBlock = !inCodeBlock;
+            return [];
+        }
+        if (inCodeBlock)
+            return [`  ${sourceLine}`];
+        const line = sourceLine
+            .replace(/^\s{0,3}#{1,6}\s+/, "")
+            .replace(/^\s*>\s?/, "")
+            .replace(/^\s*[-*+]\s+/, "- ")
+            .replace(/^\s*\d+[.)]\s+/, "- ")
+            .replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1")
+            .replace(/`([^`]+)`/g, "$1")
+            .replace(/(\*\*|__|\*|_|~~)/g, "");
+        return /^\s*[-:|]+\s*$/.test(line) ? [] : [line];
+    })
+        .join("\n");
+}
+export function chatDisplayLines(messages, busy, width) {
+    return messages.flatMap((message, messageIndex) => {
+        const content = message.content
+            ? message.role === "assistant"
+                ? plainChatText(message.content)
+                : message.content
+            : busy && message.role === "assistant"
+                ? "Thinking..."
+                : "";
+        return [
+            {
+                key: `${messageIndex}:header`,
+                role: message.role,
+                text: message.role === "user" ? "YOU" : "AGENT",
+                header: true,
+            },
+            ...wrapText(content, width).map((text, lineIndex) => ({
+                key: `${messageIndex}:${lineIndex}`,
+                role: message.role,
+                text,
+                header: false,
+            })),
+        ];
+    });
+}
+export function configuredContextWindow(value = process.env.TRUSS_HARNESS_CONTEXT_WINDOW) {
+    const configured = Number.parseInt(value ?? "8192", 10);
+    return Number.isFinite(configured)
+        ? Math.max(512, Math.min(1_000_000, configured))
+        : 8_192;
+}

package/dist/input-controller.d.ts

@@ -0,0 +1,74 @@
+import type { LocalModelEndpoint, ModelProviderKind } from "@truss-harness/provider-openai-compatible";
+import type { Dispatch, SetStateAction } from "react";
+import type { FileEntry, FileTreeEntry } from "./file-browser.js";
+import { type TuiThemeName } from "./theme.js";
+import type { EditorDisplayRow, Focus, Screen, SettingsField } from "./types.js";
+type Setter<T> = Dispatch<SetStateAction<T>>;
+interface InputState {
+    readonly screen: Screen;
+    readonly focus: Focus;
+    readonly busy: boolean;
+    readonly fileSearchResults: readonly FileEntry[];
+    readonly fileSearchIndex: number;
+    readonly candidates: readonly LocalModelEndpoint[];
+    readonly selectedEndpoint?: LocalModelEndpoint;
+    readonly settingsField: SettingsField;
+    readonly endpointInput: string;
+    readonly modelInput: string;
+    readonly models: readonly string[];
+    readonly modelIndex: number;
+    readonly configurationAvailable: boolean;
+    readonly previewUrl?: string;
+    readonly terminalLineCount: number;
+    readonly terminalHeight: number;
+    readonly commandInput: string;
+    readonly fileTree: readonly FileTreeEntry[];
+    readonly selectedFileTreeEntry?: FileTreeEntry;
+    readonly editorRows: readonly EditorDisplayRow[];
+    readonly editorLineCount: number;
+    readonly chatTranscriptLength: number;
+    readonly chatLineCount: number;
+}
+interface InputSetters {
+    readonly setScreen: Setter<Screen>;
+    readonly setFileSearchInput: Setter<string>;
+    readonly setFileSearchIndex: Setter<number>;
+    readonly setSettingsField: Setter<SettingsField>;
+    readonly setServerIndex: Setter<number>;
+    readonly setProviderKind: Setter<ModelProviderKind>;
+    readonly setEndpointInput: Setter<string>;
+    readonly setModelIndex: Setter<number>;
+    readonly setModelInput: Setter<string>;
+    readonly setInternetAccess: Setter<boolean>;
+    readonly setThemeName: Setter<TuiThemeName>;
+    readonly setTerminalScroll: Setter<number>;
+    readonly setCommandInput: Setter<string>;
+    readonly setFileIndex: Setter<number>;
+    readonly setEditorScroll: Setter<number>;
+    readonly setChatScroll: Setter<number>;
+    readonly setChatInput: Setter<string>;
+}
+interface InputActions {
+    readonly interruptOrExit: () => void;
+    readonly cancelRun: () => void;
+    readonly resolveApproval: (approved: boolean) => void;
+    readonly openSearchResult: (entry: FileEntry) => void;
+    readonly refreshAgentProfiles: () => void;
+    readonly testMcpConnections: () => void;
+    readonly configureRuntime: () => void;
+    readonly moveFocus: (direction: 1 | -1) => void;
+    readonly openPreview: (url: string) => void;
+    readonly runTerminalInput: (input: string) => void;
+    readonly startNewConversation: () => void;
+    readonly toggleDirectory: (path: string, expand?: boolean) => void;
+    readonly loadFile: (entry: FileEntry) => void;
+    readonly toggleDiff: () => void;
+    readonly sendPrompt: () => void;
+}
+export interface TuiInputControllerOptions {
+    readonly state: InputState;
+    readonly setters: InputSetters;
+    readonly actions: InputActions;
+}
+export declare function useTuiInputController({ state, setters, actions, }: TuiInputControllerOptions): void;
+export {};

package/dist/input-controller.js

@@ -0,0 +1,251 @@
+import { useInput } from "ink";
+import { clamp } from "./display.js";
+import { tuiThemeNames } from "./theme.js";
+export function useTuiInputController({ state, setters, actions, }) {
+    useInput((input, key) => {
+        if (key.ctrl && input === "c") {
+            actions.interruptOrExit();
+            return;
+        }
+        if (state.screen === "approval") {
+            if (input.toLowerCase() === "y" || key.return)
+                actions.resolveApproval(true);
+            if (input.toLowerCase() === "n" || key.escape)
+                actions.resolveApproval(false);
+            return;
+        }
+        if (state.screen === "file-search") {
+            if (key.escape) {
+                setters.setFileSearchInput("");
+                setters.setFileSearchIndex(0);
+                setters.setScreen("workspace");
+                return;
+            }
+            if (key.upArrow) {
+                setters.setFileSearchIndex((current) => Math.max(0, current - 1));
+                return;
+            }
+            if (key.downArrow) {
+                setters.setFileSearchIndex((current) => Math.min(Math.max(0, state.fileSearchResults.length - 1), current + 1));
+                return;
+            }
+            if (key.return) {
+                const result = state.fileSearchResults[Math.min(state.fileSearchIndex, Math.max(0, state.fileSearchResults.length - 1))];
+                if (result)
+                    actions.openSearchResult(result);
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setters.setFileSearchInput((current) => current.slice(0, -1));
+                setters.setFileSearchIndex(0);
+            }
+            else if (input) {
+                setters.setFileSearchInput((current) => current + input);
+                setters.setFileSearchIndex(0);
+            }
+            return;
+        }
+        if (state.screen === "help") {
+            setters.setScreen("workspace");
+            return;
+        }
+        if (state.screen === "agents") {
+            if (key.escape || input.toLowerCase() === "a")
+                setters.setScreen("workspace");
+            if (input.toLowerCase() === "r")
+                actions.refreshAgentProfiles();
+            return;
+        }
+        if (state.screen === "mcp") {
+            if (key.escape || input.toLowerCase() === "c") {
+                setters.setScreen("workspace");
+                return;
+            }
+            if (input.toLowerCase() === "r" && state.configurationAvailable)
+                actions.testMcpConnections();
+            return;
+        }
+        if (state.screen === "settings") {
+            if (key.escape) {
+                setters.setScreen("workspace");
+                return;
+            }
+            if (key.tab) {
+                const fields = [
+                    "server",
+                    "endpoint",
+                    "model",
+                    "internet",
+                    "theme",
+                ];
+                setters.setSettingsField((current) => {
+                    const index = fields.indexOf(current);
+                    return fields[(index + (key.shift ? -1 : 1) + fields.length) % fields.length];
+                });
+                return;
+            }
+            if (state.settingsField === "server") {
+                if (key.upArrow)
+                    setters.setServerIndex((current) => Math.max(0, current - 1));
+                if (key.downArrow)
+                    setters.setServerIndex((current) => Math.min(state.candidates.length - 1, current + 1));
+                if (key.return && state.selectedEndpoint) {
+                    setters.setProviderKind(state.selectedEndpoint.kind);
+                    setters.setEndpointInput(state.selectedEndpoint.baseUrl);
+                    setters.setSettingsField("model");
+                }
+                return;
+            }
+            if (state.settingsField === "model") {
+                if (key.upArrow)
+                    setters.setModelIndex((current) => Math.max(0, current - 1));
+                if (key.downArrow)
+                    setters.setModelIndex((current) => Math.min(state.models.length - 1, current + 1));
+                if (state.models[state.modelIndex] && (key.return || key.rightArrow))
+                    setters.setModelInput(state.models[state.modelIndex]);
+            }
+            if (state.settingsField === "internet") {
+                if (input === " " || key.leftArrow || key.rightArrow)
+                    setters.setInternetAccess((current) => !current);
+                if (key.return && state.endpointInput && state.modelInput)
+                    actions.configureRuntime();
+                return;
+            }
+            if (state.settingsField === "theme") {
+                if (key.leftArrow || key.upArrow)
+                    setters.setThemeName((current) => tuiThemeNames[(tuiThemeNames.indexOf(current) - 1 + tuiThemeNames.length) %
+                        tuiThemeNames.length]);
+                if (key.rightArrow || key.downArrow || input === " ")
+                    setters.setThemeName((current) => tuiThemeNames[(tuiThemeNames.indexOf(current) + 1) % tuiThemeNames.length]);
+                if (key.return && state.endpointInput && state.modelInput)
+                    actions.configureRuntime();
+                return;
+            }
+            if (key.return && state.endpointInput && state.modelInput) {
+                actions.configureRuntime();
+                return;
+            }
+            const setter = state.settingsField === "endpoint"
+                ? setters.setEndpointInput
+                : setters.setModelInput;
+            if (key.backspace || key.delete)
+                setter((current) => current.slice(0, -1));
+            else if (!key.return && input)
+                setter((current) => current + input);
+            return;
+        }
+        if (key.ctrl && (key.leftArrow || key.rightArrow)) {
+            actions.moveFocus(key.leftArrow ? -1 : 1);
+            return;
+        }
+        if (input.toLowerCase() === "a" &&
+            state.focus !== "chat" &&
+            state.focus !== "terminal") {
+            setters.setScreen("agents");
+            return;
+        }
+        if (key.tab) {
+            actions.moveFocus(key.shift ? -1 : 1);
+            return;
+        }
+        if (key.escape && state.busy) {
+            actions.cancelRun();
+            return;
+        }
+        if (input === "o" &&
+            state.focus !== "chat" &&
+            state.focus !== "terminal" &&
+            state.previewUrl) {
+            actions.openPreview(state.previewUrl);
+            return;
+        }
+        if (state.focus === "terminal") {
+            if (key.upArrow) {
+                setters.setTerminalScroll((current) => clamp(current + 1, 0, Math.max(0, state.terminalLineCount - Math.max(1, state.terminalHeight - 4))));
+                return;
+            }
+            if (key.downArrow) {
+                setters.setTerminalScroll((current) => clamp(current - 1, 0, Math.max(0, state.terminalLineCount - Math.max(1, state.terminalHeight - 4))));
+                return;
+            }
+            if (key.return) {
+                const command = state.commandInput.trim();
+                setters.setCommandInput("");
+                if (command)
+                    actions.runTerminalInput(command);
+                return;
+            }
+            if (key.backspace || key.delete)
+                setters.setCommandInput((current) => current.slice(0, -1));
+            else if (input)
+                setters.setCommandInput((current) => current + input);
+            return;
+        }
+        if (input === "?" && state.focus !== "chat") {
+            setters.setScreen("help");
+            return;
+        }
+        if (input === "m" && state.focus !== "chat") {
+            setters.setScreen("settings");
+            return;
+        }
+        if (input.toLowerCase() === "c" && state.focus !== "chat") {
+            setters.setScreen("mcp");
+            return;
+        }
+        if (input === "n" && state.focus !== "chat") {
+            actions.startNewConversation();
+            return;
+        }
+        if (state.focus === "files") {
+            if (input === "/") {
+                setters.setFileSearchInput("");
+                setters.setFileSearchIndex(0);
+                setters.setScreen("file-search");
+                return;
+            }
+            if (key.upArrow)
+                setters.setFileIndex((current) => Math.max(0, current - 1));
+            if (key.downArrow)
+                setters.setFileIndex((current) => Math.min(Math.max(state.fileTree.length - 1, 0), current + 1));
+            if (key.leftArrow && state.selectedFileTreeEntry?.kind === "directory")
+                actions.toggleDirectory(state.selectedFileTreeEntry.path, false);
+            if (key.rightArrow && state.selectedFileTreeEntry?.kind === "directory")
+                actions.toggleDirectory(state.selectedFileTreeEntry.path, true);
+            if (key.return && state.selectedFileTreeEntry?.kind === "directory")
+                actions.toggleDirectory(state.selectedFileTreeEntry.path);
+            if (key.return && state.selectedFileTreeEntry?.kind === "file")
+                actions.loadFile(state.selectedFileTreeEntry);
+            return;
+        }
+        if (state.focus === "editor") {
+            if (key.upArrow) {
+                setters.setEditorScroll((current) => clamp(current - 1, 0, Math.max(0, state.editorRows.length - state.editorLineCount)));
+                return;
+            }
+            if (key.downArrow) {
+                setters.setEditorScroll((current) => clamp(current + 1, 0, Math.max(0, state.editorRows.length - state.editorLineCount)));
+                return;
+            }
+            if (input === "d")
+                actions.toggleDiff();
+            return;
+        }
+        if (key.upArrow) {
+            setters.setChatScroll((current) => clamp(current + 1, 0, Math.max(0, state.chatTranscriptLength - state.chatLineCount)));
+            return;
+        }
+        if (key.downArrow) {
+            setters.setChatScroll((current) => clamp(current - 1, 0, Math.max(0, state.chatTranscriptLength - state.chatLineCount)));
+            return;
+        }
+        if (key.return) {
+            actions.sendPrompt();
+            return;
+        }
+        if (key.backspace || key.delete)
+            setters.setChatInput((current) => current.slice(0, -1));
+        else if (input)
+            setters.setChatInput((current) => current + input);
+    });
+}

package/dist/layout.d.ts

@@ -0,0 +1,23 @@
+import { type Focus, type Viewport } from "./types.js";
+export interface TuiLayout {
+    readonly compact: boolean;
+    readonly terminalHeight: number;
+    readonly workspaceHeight: number;
+    readonly filesWidth: number;
+    readonly chatWidth: number;
+    readonly editorWidth: number;
+    readonly compactChatHeight: number;
+    readonly editorHeight: number;
+    readonly editorLineCount: number;
+    readonly overlayWidth: number;
+}
+export declare function calculateLayout(viewport: Viewport): TuiLayout;
+export type FocusAction = {
+    readonly type: "next";
+} | {
+    readonly type: "previous";
+} | {
+    readonly type: "select";
+    readonly focus: Focus;
+};
+export declare function focusReducer(current: Focus, action: FocusAction): Focus;

package/dist/layout.js

@@ -0,0 +1,39 @@
+import { clamp } from "./display.js";
+import { focusOrder } from "./types.js";
+export function calculateLayout(viewport) {
+    const compact = viewport.columns < 106;
+    const terminalHeight = clamp(Math.floor(viewport.rows * 0.24), 7, 11);
+    const workspaceHeight = Math.max(compact ? 14 : 9, viewport.rows - terminalHeight - 6);
+    const filesWidth = Math.max(20, Math.min(36, Math.floor(viewport.columns * 0.24)));
+    const chatWidth = compact
+        ? Math.max(40, viewport.columns - 4)
+        : Math.max(28, Math.min(48, Math.floor(viewport.columns * 0.31)));
+    const editorWidth = compact
+        ? Math.max(30, viewport.columns - filesWidth - 4)
+        : Math.max(30, viewport.columns - filesWidth - chatWidth - 4);
+    const compactChatHeight = compact
+        ? clamp(Math.floor(workspaceHeight * 0.4), 6, 10)
+        : workspaceHeight;
+    const editorHeight = compact
+        ? Math.max(6, workspaceHeight - compactChatHeight - 1)
+        : workspaceHeight;
+    return {
+        compact,
+        terminalHeight,
+        workspaceHeight,
+        filesWidth,
+        chatWidth,
+        editorWidth,
+        compactChatHeight,
+        editorHeight,
+        editorLineCount: Math.max(2, editorHeight - 3),
+        overlayWidth: clamp(viewport.columns - 4, 42, 90),
+    };
+}
+export function focusReducer(current, action) {
+    if (action.type === "select")
+        return action.focus;
+    const direction = action.type === "next" ? 1 : -1;
+    const index = focusOrder.indexOf(current);
+    return focusOrder[(index + direction + focusOrder.length) % focusOrder.length];
+}

package/dist/processes.d.ts

@@ -0,0 +1,7 @@
+import { type ChildProcess } from "node:child_process";
+export declare function runTrackedCommand(command: string, workspaceRoot: string, onOutput: (output: string) => void, onProcess?: (process: ChildProcess | undefined) => void): Promise<void>;
+export declare function detectedPreviewUrl(output: string): string | undefined;
+export declare function normalizedPreviewUrl(value: string): string;
+export declare function openExternalPreview(value: string): void;
+export declare function readWorkingTreeDiff(workspaceRoot: string, path: string): Promise<string>;
+export declare function stopProcessTree(child: ChildProcess): Promise<void>;