/** * Interactive mode for the coding agent. * Handles TUI rendering and user interaction, delegating business logic to AgentSession. */ import * as fs from "node:fs"; import * as os from "node:os"; import * as path from "node:path"; import type { AgentMessage } from "@mariozechner/pi-agent-core"; import type { AssistantMessage, Message, OAuthProvider } from "@mariozechner/pi-ai"; import type { SlashCommand } from "@mariozechner/pi-tui"; import { CombinedAutocompleteProvider, type Component, Container, Input, Loader, Markdown, ProcessTerminal, Spacer, Text, TruncatedText, TUI, visibleWidth, } from "@mariozechner/pi-tui"; import { exec, spawn, spawnSync } from "child_process"; import { APP_NAME, getAuthPath, getDebugLogPath } from "../../config.js"; import type { AgentSession, AgentSessionEvent } from "../../core/agent-session.js"; import type { CustomToolSessionEvent, LoadedCustomTool } from "../../core/custom-tools/index.js"; import type { HookUIContext } from "../../core/hooks/index.js"; import { createCompactionSummaryMessage } from "../../core/messages.js"; import { type SessionContext, SessionManager } from "../../core/session-manager.js"; import { loadSkills } from "../../core/skills.js"; import { loadProjectContextFiles } from "../../core/system-prompt.js"; import type { TruncationResult } from "../../core/tools/truncate.js"; import { getChangelogPath, parseChangelog } from "../../utils/changelog.js"; import { copyToClipboard } from "../../utils/clipboard.js"; import { ArminComponent } from "./components/armin.js"; import { AssistantMessageComponent } from "./components/assistant-message.js"; import { BashExecutionComponent } from "./components/bash-execution.js"; import { BorderedLoader } from "./components/bordered-loader.js"; import { BranchSummaryMessageComponent } from "./components/branch-summary-message.js"; import { CompactionSummaryMessageComponent } from "./components/compaction-summary-message.js"; import { CustomEditor } from "./components/custom-editor.js"; import { DynamicBorder } from "./components/dynamic-border.js"; import { FooterComponent } from "./components/footer.js"; import { HookEditorComponent } from "./components/hook-editor.js"; import { HookInputComponent } from "./components/hook-input.js"; import { HookMessageComponent } from "./components/hook-message.js"; import { HookSelectorComponent } from "./components/hook-selector.js"; import { ModelSelectorComponent } from "./components/model-selector.js"; import { OAuthSelectorComponent } from "./components/oauth-selector.js"; import { SessionSelectorComponent } from "./components/session-selector.js"; import { SettingsSelectorComponent } from "./components/settings-selector.js"; import { ToolExecutionComponent } from "./components/tool-execution.js"; import { TreeSelectorComponent } from "./components/tree-selector.js"; import { UserMessageComponent } from "./components/user-message.js"; import { UserMessageSelectorComponent } from "./components/user-message-selector.js"; import { getAvailableThemes, getEditorTheme, getMarkdownTheme, onThemeChange, setTheme, type Theme, theme, } from "./theme/theme.js"; /** Interface for components that can be expanded/collapsed */ interface Expandable { setExpanded(expanded: boolean): void; } function isExpandable(obj: unknown): obj is Expandable { return typeof obj === "object" && obj !== null && "setExpanded" in obj && typeof obj.setExpanded === "function"; } export class InteractiveMode { private session: AgentSession; private ui: TUI; private chatContainer: Container; private pendingMessagesContainer: Container; private statusContainer: Container; private editor: CustomEditor; private editorContainer: Container; private footer: FooterComponent; private version: string; private isInitialized = false; private onInputCallback?: (text: string) => void; private loadingAnimation: Loader | undefined = undefined; private lastSigintTime = 0; private lastEscapeTime = 0; private changelogMarkdown: string | undefined = undefined; // Status line tracking (for mutating immediately-sequential status updates) private lastStatusSpacer: Spacer | undefined = undefined; private lastStatusText: Text | undefined = undefined; // Streaming message tracking private streamingComponent: AssistantMessageComponent | undefined = undefined; private streamingMessage: AssistantMessage | undefined = undefined; // Tool execution tracking: toolCallId -> component private pendingTools = new Map(); // Tool output expansion state private toolOutputExpanded = false; // Thinking block visibility state private hideThinkingBlock = false; // Agent subscription unsubscribe function private unsubscribe?: () => void; // Track if editor is in bash mode (text starts with !) private isBashMode = false; // Track current bash execution component private bashComponent: BashExecutionComponent | undefined = undefined; // Track pending bash components (shown in pending area, moved to chat on submit) private pendingBashComponents: BashExecutionComponent[] = []; // Auto-compaction state private autoCompactionLoader: Loader | undefined = undefined; private autoCompactionEscapeHandler?: () => void; // Auto-retry state private retryLoader: Loader | undefined = undefined; private retryEscapeHandler?: () => void; // Hook UI state private hookSelector: HookSelectorComponent | undefined = undefined; private hookInput: HookInputComponent | undefined = undefined; private hookEditor: HookEditorComponent | undefined = undefined; // Custom tools for custom rendering private customTools: Map; // Convenience accessors private get agent() { return this.session.agent; } private get sessionManager() { return this.session.sessionManager; } private get settingsManager() { return this.session.settingsManager; } constructor( session: AgentSession, version: string, changelogMarkdown: string | undefined = undefined, customTools: LoadedCustomTool[] = [], private setToolUIContext: (uiContext: HookUIContext, hasUI: boolean) => void = () => {}, fdPath: string | undefined = undefined, ) { this.session = session; this.version = version; this.changelogMarkdown = changelogMarkdown; this.customTools = new Map(customTools.map((ct) => [ct.tool.name, ct])); this.ui = new TUI(new ProcessTerminal()); this.chatContainer = new Container(); this.pendingMessagesContainer = new Container(); this.statusContainer = new Container(); this.editor = new CustomEditor(getEditorTheme()); this.editorContainer = new Container(); this.editorContainer.addChild(this.editor); this.footer = new FooterComponent(session); this.footer.setAutoCompactEnabled(session.autoCompactionEnabled); // Define slash commands for autocomplete const slashCommands: SlashCommand[] = [ { name: "settings", description: "Open settings menu" }, { name: "model", description: "Select model (opens selector UI)" }, { name: "export", description: "Export session to HTML file" }, { name: "share", description: "Share session as a secret GitHub gist" }, { name: "copy", description: "Copy last agent message to clipboard" }, { name: "session", description: "Show session info and stats" }, { name: "changelog", description: "Show changelog entries" }, { name: "hotkeys", description: "Show all keyboard shortcuts" }, { name: "branch", description: "Create a new branch from a previous message" }, { name: "tree", description: "Navigate session tree (switch branches)" }, { name: "login", description: "Login with OAuth provider" }, { name: "logout", description: "Logout from OAuth provider" }, { name: "new", description: "Start a new session" }, { name: "compact", description: "Manually compact the session context" }, { name: "resume", description: "Resume a different session" }, ]; // Load hide thinking block setting this.hideThinkingBlock = this.settingsManager.getHideThinkingBlock(); // Convert file commands to SlashCommand format const fileSlashCommands: SlashCommand[] = this.session.fileCommands.map((cmd) => ({ name: cmd.name, description: cmd.description, })); // Convert hook commands to SlashCommand format const hookCommands: SlashCommand[] = (this.session.hookRunner?.getRegisteredCommands() ?? []).map((cmd) => ({ name: cmd.name, description: cmd.description ?? "(hook command)", })); // Setup autocomplete const autocompleteProvider = new CombinedAutocompleteProvider( [...slashCommands, ...fileSlashCommands, ...hookCommands], process.cwd(), fdPath, ); this.editor.setAutocompleteProvider(autocompleteProvider); } async init(): Promise { if (this.isInitialized) return; // Add header const logo = theme.bold(theme.fg("accent", APP_NAME)) + theme.fg("dim", ` v${this.version}`); const instructions = theme.fg("dim", "esc") + theme.fg("muted", " to interrupt") + "\n" + theme.fg("dim", "ctrl+c") + theme.fg("muted", " to clear") + "\n" + theme.fg("dim", "ctrl+c twice") + theme.fg("muted", " to exit") + "\n" + theme.fg("dim", "ctrl+d") + theme.fg("muted", " to exit (empty)") + "\n" + theme.fg("dim", "ctrl+z") + theme.fg("muted", " to suspend") + "\n" + theme.fg("dim", "ctrl+k") + theme.fg("muted", " to delete line") + "\n" + theme.fg("dim", "shift+tab") + theme.fg("muted", " to cycle thinking") + "\n" + theme.fg("dim", "ctrl+p/shift+ctrl+p") + theme.fg("muted", " to cycle models") + "\n" + theme.fg("dim", "ctrl+l") + theme.fg("muted", " to select model") + "\n" + theme.fg("dim", "ctrl+o") + theme.fg("muted", " to expand tools") + "\n" + theme.fg("dim", "ctrl+t") + theme.fg("muted", " to toggle thinking") + "\n" + theme.fg("dim", "ctrl+g") + theme.fg("muted", " for external editor") + "\n" + theme.fg("dim", "/") + theme.fg("muted", " for commands") + "\n" + theme.fg("dim", "!") + theme.fg("muted", " to run bash") + "\n" + theme.fg("dim", "alt+enter") + theme.fg("muted", " to queue follow-up") + "\n" + theme.fg("dim", "drop files") + theme.fg("muted", " to attach"); const header = new Text(`${logo}\n${instructions}`, 1, 0); // Setup UI layout this.ui.addChild(new Spacer(1)); this.ui.addChild(header); this.ui.addChild(new Spacer(1)); // Add changelog if provided if (this.changelogMarkdown) { this.ui.addChild(new DynamicBorder()); if (this.settingsManager.getCollapseChangelog()) { const versionMatch = this.changelogMarkdown.match(/##\s+\[?(\d+\.\d+\.\d+)\]?/); const latestVersion = versionMatch ? versionMatch[1] : this.version; const condensedText = `Updated to v${latestVersion}. Use ${theme.bold("/changelog")} to view full changelog.`; this.ui.addChild(new Text(condensedText, 1, 0)); } else { this.ui.addChild(new Text(theme.bold(theme.fg("accent", "What's New")), 1, 0)); this.ui.addChild(new Spacer(1)); this.ui.addChild(new Markdown(this.changelogMarkdown.trim(), 1, 0, getMarkdownTheme())); this.ui.addChild(new Spacer(1)); } this.ui.addChild(new DynamicBorder()); } this.ui.addChild(this.chatContainer); this.ui.addChild(this.pendingMessagesContainer); this.ui.addChild(this.statusContainer); this.ui.addChild(new Spacer(1)); this.ui.addChild(this.editorContainer); this.ui.addChild(this.footer); this.ui.setFocus(this.editor); this.setupKeyHandlers(); this.setupEditorSubmitHandler(); // Start the UI this.ui.start(); this.isInitialized = true; // Set terminal title const cwdBasename = path.basename(process.cwd()); this.ui.terminal.setTitle(`pi - ${cwdBasename}`); // Initialize hooks with TUI-based UI context await this.initHooksAndCustomTools(); // Subscribe to agent events this.subscribeToAgent(); // Set up theme file watcher onThemeChange(() => { this.ui.invalidate(); this.updateEditorBorderColor(); this.ui.requestRender(); }); // Set up git branch watcher this.footer.watchBranch(() => { this.ui.requestRender(); }); } // ========================================================================= // Hook System // ========================================================================= /** * Initialize the hook system with TUI-based UI context. */ private async initHooksAndCustomTools(): Promise { // Show loaded project context files const contextFiles = loadProjectContextFiles(); if (contextFiles.length > 0) { const contextList = contextFiles.map((f) => theme.fg("dim", ` ${f.path}`)).join("\n"); this.chatContainer.addChild(new Text(theme.fg("muted", "Loaded context:\n") + contextList, 0, 0)); this.chatContainer.addChild(new Spacer(1)); } // Show loaded skills const skillsSettings = this.session.skillsSettings; if (skillsSettings?.enabled !== false) { const { skills, warnings: skillWarnings } = loadSkills(skillsSettings ?? {}); if (skills.length > 0) { const skillList = skills.map((s) => theme.fg("dim", ` ${s.filePath}`)).join("\n"); this.chatContainer.addChild(new Text(theme.fg("muted", "Loaded skills:\n") + skillList, 0, 0)); this.chatContainer.addChild(new Spacer(1)); } // Show skill warnings if any if (skillWarnings.length > 0) { const warningList = skillWarnings .map((w) => theme.fg("warning", ` ${w.skillPath}: ${w.message}`)) .join("\n"); this.chatContainer.addChild(new Text(theme.fg("warning", "Skill warnings:\n") + warningList, 0, 0)); this.chatContainer.addChild(new Spacer(1)); } } // Show loaded custom tools if (this.customTools.size > 0) { const toolList = Array.from(this.customTools.values()) .map((ct) => theme.fg("dim", ` ${ct.tool.name} (${ct.path})`)) .join("\n"); this.chatContainer.addChild(new Text(theme.fg("muted", "Loaded custom tools:\n") + toolList, 0, 0)); this.chatContainer.addChild(new Spacer(1)); } // Create and set hook & tool UI context const uiContext: HookUIContext = { select: (title, options) => this.showHookSelector(title, options), confirm: (title, message) => this.showHookConfirm(title, message), input: (title, placeholder) => this.showHookInput(title, placeholder), notify: (message, type) => this.showHookNotify(message, type), setStatus: (key, text) => this.setHookStatus(key, text), custom: (factory) => this.showHookCustom(factory), setEditorText: (text) => this.editor.setText(text), getEditorText: () => this.editor.getText(), editor: (title, prefill) => this.showHookEditor(title, prefill), get theme() { return theme; }, }; this.setToolUIContext(uiContext, true); // Notify custom tools of session start await this.emitCustomToolSessionEvent({ reason: "start", previousSessionFile: undefined, }); const hookRunner = this.session.hookRunner; if (!hookRunner) { return; // No hooks loaded } hookRunner.initialize({ getModel: () => this.session.model, sendMessageHandler: (message, options) => { const wasStreaming = this.session.isStreaming; this.session .sendHookMessage(message, options) .then(() => { // For non-streaming cases with display=true, update UI // (streaming cases update via message_end event) if (!wasStreaming && message.display) { this.rebuildChatFromMessages(); } }) .catch((err) => { this.showError(`Hook sendMessage failed: ${err instanceof Error ? err.message : String(err)}`); }); }, appendEntryHandler: (customType, data) => { this.sessionManager.appendCustomEntry(customType, data); }, newSessionHandler: async (options) => { // Stop any loading animation if (this.loadingAnimation) { this.loadingAnimation.stop(); this.loadingAnimation = undefined; } this.statusContainer.clear(); // Create new session const success = await this.session.newSession({ parentSession: options?.parentSession }); if (!success) { return { cancelled: true }; } // Call setup callback if provided if (options?.setup) { await options.setup(this.sessionManager); } // Clear UI state this.chatContainer.clear(); this.pendingMessagesContainer.clear(); this.streamingComponent = undefined; this.streamingMessage = undefined; this.pendingTools.clear(); this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(`${theme.fg("accent", "✓ New session started")}`, 1, 1)); this.ui.requestRender(); return { cancelled: false }; }, branchHandler: async (entryId) => { const result = await this.session.branch(entryId); if (result.cancelled) { return { cancelled: true }; } // Update UI this.chatContainer.clear(); this.renderInitialMessages(); this.editor.setText(result.selectedText); this.showStatus("Branched to new session"); return { cancelled: false }; }, navigateTreeHandler: async (targetId, options) => { const result = await this.session.navigateTree(targetId, { summarize: options?.summarize }); if (result.cancelled) { return { cancelled: true }; } // Update UI this.chatContainer.clear(); this.renderInitialMessages(); if (result.editorText) { this.editor.setText(result.editorText); } this.showStatus("Navigated to selected point"); return { cancelled: false }; }, isIdle: () => !this.session.isStreaming, waitForIdle: () => this.session.agent.waitForIdle(), abort: () => { this.session.abort(); }, hasPendingMessages: () => this.session.pendingMessageCount > 0, uiContext, hasUI: true, }); // Subscribe to hook errors hookRunner.onError((error) => { this.showHookError(error.hookPath, error.error); }); // Show loaded hooks const hookPaths = hookRunner.getHookPaths(); if (hookPaths.length > 0) { const hookList = hookPaths.map((p) => theme.fg("dim", ` ${p}`)).join("\n"); this.chatContainer.addChild(new Text(theme.fg("muted", "Loaded hooks:\n") + hookList, 0, 0)); this.chatContainer.addChild(new Spacer(1)); } // Emit session_start event await hookRunner.emit({ type: "session_start", }); } /** * Emit session event to all custom tools. */ private async emitCustomToolSessionEvent(event: CustomToolSessionEvent): Promise { for (const { tool } of this.customTools.values()) { if (tool.onSession) { try { await tool.onSession(event, { sessionManager: this.session.sessionManager, modelRegistry: this.session.modelRegistry, model: this.session.model, isIdle: () => !this.session.isStreaming, hasPendingMessages: () => this.session.pendingMessageCount > 0, abort: () => { this.session.abort(); }, }); } catch (err) { this.showToolError(tool.name, err instanceof Error ? err.message : String(err)); } } } } /** * Show a tool error in the chat. */ private showToolError(toolName: string, error: string): void { const errorText = new Text(theme.fg("error", `Tool "${toolName}" error: ${error}`), 1, 0); this.chatContainer.addChild(errorText); this.ui.requestRender(); } /** * Set hook status text in the footer. */ private setHookStatus(key: string, text: string | undefined): void { this.footer.setHookStatus(key, text); this.ui.requestRender(); } /** * Show a selector for hooks. */ private showHookSelector(title: string, options: string[]): Promise { return new Promise((resolve) => { this.hookSelector = new HookSelectorComponent( title, options, (option) => { this.hideHookSelector(); resolve(option); }, () => { this.hideHookSelector(); resolve(undefined); }, ); this.editorContainer.clear(); this.editorContainer.addChild(this.hookSelector); this.ui.setFocus(this.hookSelector); this.ui.requestRender(); }); } /** * Hide the hook selector. */ private hideHookSelector(): void { this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.hookSelector = undefined; this.ui.setFocus(this.editor); this.ui.requestRender(); } /** * Show a confirmation dialog for hooks. */ private async showHookConfirm(title: string, message: string): Promise { const result = await this.showHookSelector(`${title}\n${message}`, ["Yes", "No"]); return result === "Yes"; } /** * Show a text input for hooks. */ private showHookInput(title: string, placeholder?: string): Promise { return new Promise((resolve) => { this.hookInput = new HookInputComponent( title, placeholder, (value) => { this.hideHookInput(); resolve(value); }, () => { this.hideHookInput(); resolve(undefined); }, ); this.editorContainer.clear(); this.editorContainer.addChild(this.hookInput); this.ui.setFocus(this.hookInput); this.ui.requestRender(); }); } /** * Hide the hook input. */ private hideHookInput(): void { this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.hookInput = undefined; this.ui.setFocus(this.editor); this.ui.requestRender(); } /** * Show a multi-line editor for hooks (with Ctrl+G support). */ private showHookEditor(title: string, prefill?: string): Promise { return new Promise((resolve) => { this.hookEditor = new HookEditorComponent( this.ui, title, prefill, (value) => { this.hideHookEditor(); resolve(value); }, () => { this.hideHookEditor(); resolve(undefined); }, ); this.editorContainer.clear(); this.editorContainer.addChild(this.hookEditor); this.ui.setFocus(this.hookEditor); this.ui.requestRender(); }); } /** * Hide the hook editor. */ private hideHookEditor(): void { this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.hookEditor = undefined; this.ui.setFocus(this.editor); this.ui.requestRender(); } /** * Show a notification for hooks. */ private showHookNotify(message: string, type?: "info" | "warning" | "error"): void { if (type === "error") { this.showError(message); } else if (type === "warning") { this.showWarning(message); } else { this.showStatus(message); } } /** * Show a custom component with keyboard focus. */ private async showHookCustom( factory: ( tui: TUI, theme: Theme, done: (result: T) => void, ) => (Component & { dispose?(): void }) | Promise, ): Promise { const savedText = this.editor.getText(); return new Promise((resolve) => { let component: Component & { dispose?(): void }; const close = (result: T) => { component.dispose?.(); this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.editor.setText(savedText); this.ui.setFocus(this.editor); this.ui.requestRender(); resolve(result); }; Promise.resolve(factory(this.ui, theme, close)).then((c) => { component = c; this.editorContainer.clear(); this.editorContainer.addChild(component); this.ui.setFocus(component); this.ui.requestRender(); }); }); } /** * Show a hook error in the UI. */ private showHookError(hookPath: string, error: string): void { const errorText = new Text(theme.fg("error", `Hook "${hookPath}" error: ${error}`), 1, 0); this.chatContainer.addChild(errorText); this.ui.requestRender(); } /** * Handle pi.send() from hooks. * If streaming, queue the message. Otherwise, start a new agent loop. */ // ========================================================================= // Key Handlers // ========================================================================= private setupKeyHandlers(): void { this.editor.onEscape = () => { if (this.loadingAnimation) { // Abort and restore queued messages to editor const { steering, followUp } = this.session.clearQueue(); const allQueued = [...steering, ...followUp]; const queuedText = allQueued.join("\n\n"); const currentText = this.editor.getText(); const combinedText = [queuedText, currentText].filter((t) => t.trim()).join("\n\n"); this.editor.setText(combinedText); this.updatePendingMessagesDisplay(); this.agent.abort(); } else if (this.session.isBashRunning) { this.session.abortBash(); } else if (this.isBashMode) { this.editor.setText(""); this.isBashMode = false; this.updateEditorBorderColor(); } else if (!this.editor.getText().trim()) { // Double-escape with empty editor triggers /tree or /branch based on setting const now = Date.now(); if (now - this.lastEscapeTime < 500) { if (this.settingsManager.getDoubleEscapeAction() === "tree") { this.showTreeSelector(); } else { this.showUserMessageSelector(); } this.lastEscapeTime = 0; } else { this.lastEscapeTime = now; } } }; this.editor.onCtrlC = () => this.handleCtrlC(); this.editor.onCtrlD = () => this.handleCtrlD(); this.editor.onCtrlZ = () => this.handleCtrlZ(); this.editor.onShiftTab = () => this.cycleThinkingLevel(); this.editor.onCtrlP = () => this.cycleModel("forward"); this.editor.onShiftCtrlP = () => this.cycleModel("backward"); // Global debug handler on TUI (works regardless of focus) this.ui.onDebug = () => this.handleDebugCommand(); this.editor.onCtrlL = () => this.showModelSelector(); this.editor.onCtrlO = () => this.toggleToolOutputExpansion(); this.editor.onCtrlT = () => this.toggleThinkingBlockVisibility(); this.editor.onCtrlG = () => this.openExternalEditor(); this.editor.onAltEnter = () => this.handleAltEnter(); this.editor.onChange = (text: string) => { const wasBashMode = this.isBashMode; this.isBashMode = text.trimStart().startsWith("!"); if (wasBashMode !== this.isBashMode) { this.updateEditorBorderColor(); } }; } private setupEditorSubmitHandler(): void { this.editor.onSubmit = async (text: string) => { text = text.trim(); if (!text) return; // Handle slash commands if (text === "/settings") { this.showSettingsSelector(); this.editor.setText(""); return; } if (text === "/model") { this.showModelSelector(); this.editor.setText(""); return; } if (text.startsWith("/export")) { this.handleExportCommand(text); this.editor.setText(""); return; } if (text === "/share") { await this.handleShareCommand(); this.editor.setText(""); return; } if (text === "/copy") { this.handleCopyCommand(); this.editor.setText(""); return; } if (text === "/session") { this.handleSessionCommand(); this.editor.setText(""); return; } if (text === "/changelog") { this.handleChangelogCommand(); this.editor.setText(""); return; } if (text === "/hotkeys") { this.handleHotkeysCommand(); this.editor.setText(""); return; } if (text === "/branch") { this.showUserMessageSelector(); this.editor.setText(""); return; } if (text === "/tree") { this.showTreeSelector(); this.editor.setText(""); return; } if (text === "/login") { this.showOAuthSelector("login"); this.editor.setText(""); return; } if (text === "/logout") { this.showOAuthSelector("logout"); this.editor.setText(""); return; } if (text === "/new") { this.editor.setText(""); await this.handleClearCommand(); return; } if (text === "/compact" || text.startsWith("/compact ")) { const customInstructions = text.startsWith("/compact ") ? text.slice(9).trim() : undefined; this.editor.setText(""); this.editor.disableSubmit = true; try { await this.handleCompactCommand(customInstructions); } finally { this.editor.disableSubmit = false; } return; } if (text === "/debug") { this.handleDebugCommand(); this.editor.setText(""); return; } if (text === "/arminsayshi") { this.handleArminSaysHi(); this.editor.setText(""); return; } if (text === "/resume") { this.showSessionSelector(); this.editor.setText(""); return; } // Handle bash command if (text.startsWith("!")) { const command = text.slice(1).trim(); if (command) { if (this.session.isBashRunning) { this.showWarning("A bash command is already running. Press Esc to cancel it first."); this.editor.setText(text); return; } this.editor.addToHistory(text); await this.handleBashCommand(command); this.isBashMode = false; this.updateEditorBorderColor(); return; } } // Block input during compaction if (this.session.isCompacting) { return; } // Hook commands always run immediately, even during streaming // (if they need to interact with LLM, they use pi.sendMessage which handles queueing) if (text.startsWith("/") && this.session.hookRunner) { const spaceIndex = text.indexOf(" "); const commandName = spaceIndex === -1 ? text.slice(1) : text.slice(1, spaceIndex); const command = this.session.hookRunner.getCommand(commandName); if (command) { this.editor.addToHistory(text); this.editor.setText(""); await this.session.prompt(text); return; } } // Queue steering message if agent is streaming (interrupts current work) if (this.session.isStreaming) { await this.session.steer(text); this.updatePendingMessagesDisplay(); this.editor.addToHistory(text); this.editor.setText(""); this.ui.requestRender(); return; } // Normal message submission // First, move any pending bash components to chat this.flushPendingBashComponents(); if (this.onInputCallback) { this.onInputCallback(text); } this.editor.addToHistory(text); }; } private subscribeToAgent(): void { this.unsubscribe = this.session.subscribe(async (event) => { await this.handleEvent(event); }); } private async handleEvent(event: AgentSessionEvent): Promise { if (!this.isInitialized) { await this.init(); } this.footer.invalidate(); switch (event.type) { case "agent_start": if (this.loadingAnimation) { this.loadingAnimation.stop(); } this.statusContainer.clear(); this.loadingAnimation = new Loader( this.ui, (spinner) => theme.fg("accent", spinner), (text) => theme.fg("muted", text), "Working... (esc to interrupt)", ); this.statusContainer.addChild(this.loadingAnimation); this.ui.requestRender(); break; case "message_start": if (event.message.role === "hookMessage") { this.addMessageToChat(event.message); this.ui.requestRender(); } else if (event.message.role === "user") { this.addMessageToChat(event.message); this.editor.setText(""); this.updatePendingMessagesDisplay(); this.ui.requestRender(); } else if (event.message.role === "assistant") { this.streamingComponent = new AssistantMessageComponent(undefined, this.hideThinkingBlock); this.streamingMessage = event.message; this.chatContainer.addChild(this.streamingComponent); this.streamingComponent.updateContent(this.streamingMessage); this.ui.requestRender(); } break; case "message_update": if (this.streamingComponent && event.message.role === "assistant") { this.streamingMessage = event.message; this.streamingComponent.updateContent(this.streamingMessage); for (const content of this.streamingMessage.content) { if (content.type === "toolCall") { if (!this.pendingTools.has(content.id)) { this.chatContainer.addChild(new Text("", 0, 0)); const component = new ToolExecutionComponent( content.name, content.arguments, { showImages: this.settingsManager.getShowImages(), }, this.customTools.get(content.name)?.tool, this.ui, ); component.setExpanded(this.toolOutputExpanded); this.chatContainer.addChild(component); this.pendingTools.set(content.id, component); } else { const component = this.pendingTools.get(content.id); if (component) { component.updateArgs(content.arguments); } } } } this.ui.requestRender(); } break; case "message_end": if (event.message.role === "user") break; if (this.streamingComponent && event.message.role === "assistant") { this.streamingMessage = event.message; this.streamingComponent.updateContent(this.streamingMessage); if (this.streamingMessage.stopReason === "aborted" || this.streamingMessage.stopReason === "error") { const errorMessage = this.streamingMessage.stopReason === "aborted" ? "Operation aborted" : this.streamingMessage.errorMessage || "Error"; for (const [, component] of this.pendingTools.entries()) { component.updateResult({ content: [{ type: "text", text: errorMessage }], isError: true, }); } this.pendingTools.clear(); } else { // Args are now complete - trigger diff computation for edit tools for (const [, component] of this.pendingTools.entries()) { component.setArgsComplete(); } } this.streamingComponent = undefined; this.streamingMessage = undefined; this.footer.invalidate(); } this.ui.requestRender(); break; case "tool_execution_start": { if (!this.pendingTools.has(event.toolCallId)) { const component = new ToolExecutionComponent( event.toolName, event.args, { showImages: this.settingsManager.getShowImages(), }, this.customTools.get(event.toolName)?.tool, this.ui, ); component.setExpanded(this.toolOutputExpanded); this.chatContainer.addChild(component); this.pendingTools.set(event.toolCallId, component); this.ui.requestRender(); } break; } case "tool_execution_update": { const component = this.pendingTools.get(event.toolCallId); if (component) { component.updateResult({ ...event.partialResult, isError: false }, true); this.ui.requestRender(); } break; } case "tool_execution_end": { const component = this.pendingTools.get(event.toolCallId); if (component) { component.updateResult({ ...event.result, isError: event.isError }); this.pendingTools.delete(event.toolCallId); this.ui.requestRender(); } break; } case "agent_end": if (this.loadingAnimation) { this.loadingAnimation.stop(); this.loadingAnimation = undefined; this.statusContainer.clear(); } if (this.streamingComponent) { this.chatContainer.removeChild(this.streamingComponent); this.streamingComponent = undefined; this.streamingMessage = undefined; } this.pendingTools.clear(); this.ui.requestRender(); break; case "auto_compaction_start": { // Disable submit to preserve editor text during compaction this.editor.disableSubmit = true; // Set up escape to abort auto-compaction this.autoCompactionEscapeHandler = this.editor.onEscape; this.editor.onEscape = () => { this.session.abortCompaction(); }; // Show compacting indicator with reason this.statusContainer.clear(); const reasonText = event.reason === "overflow" ? "Context overflow detected, " : ""; this.autoCompactionLoader = new Loader( this.ui, (spinner) => theme.fg("accent", spinner), (text) => theme.fg("muted", text), `${reasonText}Auto-compacting... (esc to cancel)`, ); this.statusContainer.addChild(this.autoCompactionLoader); this.ui.requestRender(); break; } case "auto_compaction_end": { // Re-enable submit this.editor.disableSubmit = false; // Restore escape handler if (this.autoCompactionEscapeHandler) { this.editor.onEscape = this.autoCompactionEscapeHandler; this.autoCompactionEscapeHandler = undefined; } // Stop loader if (this.autoCompactionLoader) { this.autoCompactionLoader.stop(); this.autoCompactionLoader = undefined; this.statusContainer.clear(); } // Handle result if (event.aborted) { this.showStatus("Auto-compaction cancelled"); } else if (event.result) { // Rebuild chat to show compacted state this.chatContainer.clear(); this.rebuildChatFromMessages(); // Add compaction component at bottom so user sees it without scrolling this.addMessageToChat({ role: "compactionSummary", tokensBefore: event.result.tokensBefore, summary: event.result.summary, timestamp: Date.now(), }); this.footer.invalidate(); } this.ui.requestRender(); break; } case "auto_retry_start": { // Set up escape to abort retry this.retryEscapeHandler = this.editor.onEscape; this.editor.onEscape = () => { this.session.abortRetry(); }; // Show retry indicator this.statusContainer.clear(); const delaySeconds = Math.round(event.delayMs / 1000); this.retryLoader = new Loader( this.ui, (spinner) => theme.fg("warning", spinner), (text) => theme.fg("muted", text), `Retrying (${event.attempt}/${event.maxAttempts}) in ${delaySeconds}s... (esc to cancel)`, ); this.statusContainer.addChild(this.retryLoader); this.ui.requestRender(); break; } case "auto_retry_end": { // Restore escape handler if (this.retryEscapeHandler) { this.editor.onEscape = this.retryEscapeHandler; this.retryEscapeHandler = undefined; } // Stop loader if (this.retryLoader) { this.retryLoader.stop(); this.retryLoader = undefined; this.statusContainer.clear(); } // Show error only on final failure (success shows normal response) if (!event.success) { this.showError(`Retry failed after ${event.attempt} attempts: ${event.finalError || "Unknown error"}`); } this.ui.requestRender(); break; } } } /** Extract text content from a user message */ private getUserMessageText(message: Message): string { if (message.role !== "user") return ""; const textBlocks = typeof message.content === "string" ? [{ type: "text", text: message.content }] : message.content.filter((c: { type: string }) => c.type === "text"); return textBlocks.map((c) => (c as { text: string }).text).join(""); } /** * Show a status message in the chat. * * If multiple status messages are emitted back-to-back (without anything else being added to the chat), * we update the previous status line instead of appending new ones to avoid log spam. */ private showStatus(message: string): void { const children = this.chatContainer.children; const last = children.length > 0 ? children[children.length - 1] : undefined; const secondLast = children.length > 1 ? children[children.length - 2] : undefined; if (last && secondLast && last === this.lastStatusText && secondLast === this.lastStatusSpacer) { this.lastStatusText.setText(theme.fg("dim", message)); this.ui.requestRender(); return; } const spacer = new Spacer(1); const text = new Text(theme.fg("dim", message), 1, 0); this.chatContainer.addChild(spacer); this.chatContainer.addChild(text); this.lastStatusSpacer = spacer; this.lastStatusText = text; this.ui.requestRender(); } private addMessageToChat(message: AgentMessage, options?: { populateHistory?: boolean }): void { switch (message.role) { case "bashExecution": { const component = new BashExecutionComponent(message.command, this.ui); if (message.output) { component.appendOutput(message.output); } component.setComplete( message.exitCode, message.cancelled, message.truncated ? ({ truncated: true } as TruncationResult) : undefined, message.fullOutputPath, ); this.chatContainer.addChild(component); break; } case "hookMessage": { if (message.display) { const renderer = this.session.hookRunner?.getMessageRenderer(message.customType); this.chatContainer.addChild(new HookMessageComponent(message, renderer)); } break; } case "compactionSummary": { this.chatContainer.addChild(new Spacer(1)); const component = new CompactionSummaryMessageComponent(message); component.setExpanded(this.toolOutputExpanded); this.chatContainer.addChild(component); break; } case "branchSummary": { this.chatContainer.addChild(new Spacer(1)); const component = new BranchSummaryMessageComponent(message); component.setExpanded(this.toolOutputExpanded); this.chatContainer.addChild(component); break; } case "user": { const textContent = this.getUserMessageText(message); if (textContent) { const userComponent = new UserMessageComponent(textContent); this.chatContainer.addChild(userComponent); if (options?.populateHistory) { this.editor.addToHistory(textContent); } } break; } case "assistant": { const assistantComponent = new AssistantMessageComponent(message, this.hideThinkingBlock); this.chatContainer.addChild(assistantComponent); break; } case "toolResult": { // Tool results are rendered inline with tool calls, handled separately break; } default: { const _exhaustive: never = message; } } } /** * Render session context to chat. Used for initial load and rebuild after compaction. * @param sessionContext Session context to render * @param options.updateFooter Update footer state * @param options.populateHistory Add user messages to editor history */ private renderSessionContext( sessionContext: SessionContext, options: { updateFooter?: boolean; populateHistory?: boolean } = {}, ): void { this.pendingTools.clear(); if (options.updateFooter) { this.footer.invalidate(); this.updateEditorBorderColor(); } for (const message of sessionContext.messages) { // Assistant messages need special handling for tool calls if (message.role === "assistant") { this.addMessageToChat(message); // Render tool call components for (const content of message.content) { if (content.type === "toolCall") { const component = new ToolExecutionComponent( content.name, content.arguments, { showImages: this.settingsManager.getShowImages() }, this.customTools.get(content.name)?.tool, this.ui, ); component.setExpanded(this.toolOutputExpanded); this.chatContainer.addChild(component); if (message.stopReason === "aborted" || message.stopReason === "error") { const errorMessage = message.stopReason === "aborted" ? "Operation aborted" : message.errorMessage || "Error"; component.updateResult({ content: [{ type: "text", text: errorMessage }], isError: true }); } else { this.pendingTools.set(content.id, component); } } } } else if (message.role === "toolResult") { // Match tool results to pending tool components const component = this.pendingTools.get(message.toolCallId); if (component) { component.updateResult(message); this.pendingTools.delete(message.toolCallId); } } else { // All other messages use standard rendering this.addMessageToChat(message, options); } } this.pendingTools.clear(); this.ui.requestRender(); } renderInitialMessages(): void { // Get aligned messages and entries from session context const context = this.sessionManager.buildSessionContext(); this.renderSessionContext(context, { updateFooter: true, populateHistory: true, }); // Show compaction info if session was compacted const allEntries = this.sessionManager.getEntries(); const compactionCount = allEntries.filter((e) => e.type === "compaction").length; if (compactionCount > 0) { const times = compactionCount === 1 ? "1 time" : `${compactionCount} times`; this.showStatus(`Session compacted ${times}`); } } async getUserInput(): Promise { return new Promise((resolve) => { this.onInputCallback = (text: string) => { this.onInputCallback = undefined; resolve(text); }; }); } private rebuildChatFromMessages(): void { this.chatContainer.clear(); const context = this.sessionManager.buildSessionContext(); this.renderSessionContext(context); } // ========================================================================= // Key handlers // ========================================================================= private handleCtrlC(): void { const now = Date.now(); if (now - this.lastSigintTime < 500) { void this.shutdown(); } else { this.clearEditor(); this.lastSigintTime = now; } } private handleCtrlD(): void { // Only called when editor is empty (enforced by CustomEditor) void this.shutdown(); } /** * Gracefully shutdown the agent. * Emits shutdown event to hooks and tools, then exits. */ private async shutdown(): Promise { // Emit shutdown event to hooks const hookRunner = this.session.hookRunner; if (hookRunner?.hasHandlers("session_shutdown")) { await hookRunner.emit({ type: "session_shutdown", }); } // Emit shutdown event to custom tools await this.session.emitCustomToolSessionEvent("shutdown"); this.stop(); process.exit(0); } private handleCtrlZ(): void { // Set up handler to restore TUI when resumed process.once("SIGCONT", () => { this.ui.start(); this.ui.requestRender(true); }); // Stop the TUI (restore terminal to normal mode) this.ui.stop(); // Send SIGTSTP to process group (pid=0 means all processes in group) process.kill(0, "SIGTSTP"); } private async handleAltEnter(): Promise { const text = this.editor.getText().trim(); if (!text) return; // Alt+Enter queues a follow-up message (waits until agent finishes) if (this.session.isStreaming) { await this.session.followUp(text); this.updatePendingMessagesDisplay(); this.editor.addToHistory(text); this.editor.setText(""); this.ui.requestRender(); } // If not streaming, Alt+Enter acts like regular Enter (trigger onSubmit) else if (this.editor.onSubmit) { this.editor.onSubmit(text); } } private updateEditorBorderColor(): void { if (this.isBashMode) { this.editor.borderColor = theme.getBashModeBorderColor(); } else { const level = this.session.thinkingLevel || "off"; this.editor.borderColor = theme.getThinkingBorderColor(level); } this.ui.requestRender(); } private cycleThinkingLevel(): void { const newLevel = this.session.cycleThinkingLevel(); if (newLevel === undefined) { this.showStatus("Current model does not support thinking"); } else { this.footer.invalidate(); this.updateEditorBorderColor(); this.showStatus(`Thinking level: ${newLevel}`); } } private async cycleModel(direction: "forward" | "backward"): Promise { try { const result = await this.session.cycleModel(direction); if (result === undefined) { const msg = this.session.scopedModels.length > 0 ? "Only one model in scope" : "Only one model available"; this.showStatus(msg); } else { this.footer.invalidate(); this.updateEditorBorderColor(); const thinkingStr = result.model.reasoning && result.thinkingLevel !== "off" ? ` (thinking: ${result.thinkingLevel})` : ""; this.showStatus(`Switched to ${result.model.name || result.model.id}${thinkingStr}`); } } catch (error) { this.showError(error instanceof Error ? error.message : String(error)); } } private toggleToolOutputExpansion(): void { this.toolOutputExpanded = !this.toolOutputExpanded; for (const child of this.chatContainer.children) { if (isExpandable(child)) { child.setExpanded(this.toolOutputExpanded); } } this.ui.requestRender(); } private toggleThinkingBlockVisibility(): void { this.hideThinkingBlock = !this.hideThinkingBlock; this.settingsManager.setHideThinkingBlock(this.hideThinkingBlock); // Rebuild chat from session messages this.chatContainer.clear(); this.rebuildChatFromMessages(); // If streaming, re-add the streaming component with updated visibility and re-render if (this.streamingComponent && this.streamingMessage) { this.streamingComponent.setHideThinkingBlock(this.hideThinkingBlock); this.streamingComponent.updateContent(this.streamingMessage); this.chatContainer.addChild(this.streamingComponent); } this.showStatus(`Thinking blocks: ${this.hideThinkingBlock ? "hidden" : "visible"}`); } private openExternalEditor(): void { // Determine editor (respect $VISUAL, then $EDITOR) const editorCmd = process.env.VISUAL || process.env.EDITOR; if (!editorCmd) { this.showWarning("No editor configured. Set $VISUAL or $EDITOR environment variable."); return; } const currentText = this.editor.getText(); const tmpFile = path.join(os.tmpdir(), `pi-editor-${Date.now()}.pi.md`); try { // Write current content to temp file fs.writeFileSync(tmpFile, currentText, "utf-8"); // Stop TUI to release terminal this.ui.stop(); // Split by space to support editor arguments (e.g., "code --wait") const [editor, ...editorArgs] = editorCmd.split(" "); // Spawn editor synchronously with inherited stdio for interactive editing const result = spawnSync(editor, [...editorArgs, tmpFile], { stdio: "inherit", }); // On successful exit (status 0), replace editor content if (result.status === 0) { const newContent = fs.readFileSync(tmpFile, "utf-8").replace(/\n$/, ""); this.editor.setText(newContent); } // On non-zero exit, keep original text (no action needed) } finally { // Clean up temp file try { fs.unlinkSync(tmpFile); } catch { // Ignore cleanup errors } // Restart TUI this.ui.start(); this.ui.requestRender(); } } // ========================================================================= // UI helpers // ========================================================================= clearEditor(): void { this.editor.setText(""); this.ui.requestRender(); } showError(errorMessage: string): void { this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(theme.fg("error", `Error: ${errorMessage}`), 1, 0)); this.ui.requestRender(); } showWarning(warningMessage: string): void { this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(theme.fg("warning", `Warning: ${warningMessage}`), 1, 0)); this.ui.requestRender(); } showNewVersionNotification(newVersion: string): void { this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new DynamicBorder((text) => theme.fg("warning", text))); this.chatContainer.addChild( new Text( theme.bold(theme.fg("warning", "Update Available")) + "\n" + theme.fg("muted", `New version ${newVersion} is available. Run: `) + theme.fg("accent", "npm install -g @mariozechner/pi-coding-agent"), 1, 0, ), ); this.chatContainer.addChild(new DynamicBorder((text) => theme.fg("warning", text))); this.ui.requestRender(); } private updatePendingMessagesDisplay(): void { this.pendingMessagesContainer.clear(); const steeringMessages = this.session.getSteeringMessages(); const followUpMessages = this.session.getFollowUpMessages(); if (steeringMessages.length > 0 || followUpMessages.length > 0) { this.pendingMessagesContainer.addChild(new Spacer(1)); for (const message of steeringMessages) { const text = theme.fg("dim", `Steering: ${message}`); this.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0)); } for (const message of followUpMessages) { const text = theme.fg("dim", `Follow-up: ${message}`); this.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0)); } } } /** Move pending bash components from pending area to chat */ private flushPendingBashComponents(): void { for (const component of this.pendingBashComponents) { this.pendingMessagesContainer.removeChild(component); this.chatContainer.addChild(component); } this.pendingBashComponents = []; } // ========================================================================= // Selectors // ========================================================================= /** * Shows a selector component in place of the editor. * @param create Factory that receives a `done` callback and returns the component and focus target */ private showSelector(create: (done: () => void) => { component: Component; focus: Component }): void { const done = () => { this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.ui.setFocus(this.editor); }; const { component, focus } = create(done); this.editorContainer.clear(); this.editorContainer.addChild(component); this.ui.setFocus(focus); this.ui.requestRender(); } private showSettingsSelector(): void { this.showSelector((done) => { const selector = new SettingsSelectorComponent( { autoCompact: this.session.autoCompactionEnabled, showImages: this.settingsManager.getShowImages(), autoResizeImages: this.settingsManager.getImageAutoResize(), steeringMode: this.session.steeringMode, followUpMode: this.session.followUpMode, thinkingLevel: this.session.thinkingLevel, availableThinkingLevels: this.session.getAvailableThinkingLevels(), currentTheme: this.settingsManager.getTheme() || "dark", availableThemes: getAvailableThemes(), hideThinkingBlock: this.hideThinkingBlock, collapseChangelog: this.settingsManager.getCollapseChangelog(), doubleEscapeAction: this.settingsManager.getDoubleEscapeAction(), }, { onAutoCompactChange: (enabled) => { this.session.setAutoCompactionEnabled(enabled); this.footer.setAutoCompactEnabled(enabled); }, onShowImagesChange: (enabled) => { this.settingsManager.setShowImages(enabled); for (const child of this.chatContainer.children) { if (child instanceof ToolExecutionComponent) { child.setShowImages(enabled); } } }, onAutoResizeImagesChange: (enabled) => { this.settingsManager.setImageAutoResize(enabled); }, onSteeringModeChange: (mode) => { this.session.setSteeringMode(mode); }, onFollowUpModeChange: (mode) => { this.session.setFollowUpMode(mode); }, onThinkingLevelChange: (level) => { this.session.setThinkingLevel(level); this.footer.invalidate(); this.updateEditorBorderColor(); }, onThemeChange: (themeName) => { const result = setTheme(themeName, true); this.settingsManager.setTheme(themeName); this.ui.invalidate(); if (!result.success) { this.showError(`Failed to load theme "${themeName}": ${result.error}\nFell back to dark theme.`); } }, onThemePreview: (themeName) => { const result = setTheme(themeName, true); if (result.success) { this.ui.invalidate(); this.ui.requestRender(); } }, onHideThinkingBlockChange: (hidden) => { this.hideThinkingBlock = hidden; this.settingsManager.setHideThinkingBlock(hidden); for (const child of this.chatContainer.children) { if (child instanceof AssistantMessageComponent) { child.setHideThinkingBlock(hidden); } } this.chatContainer.clear(); this.rebuildChatFromMessages(); }, onCollapseChangelogChange: (collapsed) => { this.settingsManager.setCollapseChangelog(collapsed); }, onDoubleEscapeActionChange: (action) => { this.settingsManager.setDoubleEscapeAction(action); }, onCancel: () => { done(); this.ui.requestRender(); }, }, ); return { component: selector, focus: selector.getSettingsList() }; }); } private showModelSelector(): void { this.showSelector((done) => { const selector = new ModelSelectorComponent( this.ui, this.session.model, this.settingsManager, this.session.modelRegistry, this.session.scopedModels, async (model) => { try { await this.session.setModel(model); this.footer.invalidate(); this.updateEditorBorderColor(); done(); this.showStatus(`Model: ${model.id}`); } catch (error) { done(); this.showError(error instanceof Error ? error.message : String(error)); } }, () => { done(); this.ui.requestRender(); }, ); return { component: selector, focus: selector }; }); } private showUserMessageSelector(): void { const userMessages = this.session.getUserMessagesForBranching(); if (userMessages.length === 0) { this.showStatus("No messages to branch from"); return; } this.showSelector((done) => { const selector = new UserMessageSelectorComponent( userMessages.map((m) => ({ id: m.entryId, text: m.text })), async (entryId) => { const result = await this.session.branch(entryId); if (result.cancelled) { // Hook cancelled the branch done(); this.ui.requestRender(); return; } this.chatContainer.clear(); this.renderInitialMessages(); this.editor.setText(result.selectedText); done(); this.showStatus("Branched to new session"); }, () => { done(); this.ui.requestRender(); }, ); return { component: selector, focus: selector.getMessageList() }; }); } private showTreeSelector(): void { const tree = this.sessionManager.getTree(); const realLeafId = this.sessionManager.getLeafId(); // Find the visible leaf for display (skip metadata entries like labels) let visibleLeafId = realLeafId; while (visibleLeafId) { const entry = this.sessionManager.getEntry(visibleLeafId); if (!entry) break; if (entry.type !== "label" && entry.type !== "custom") break; visibleLeafId = entry.parentId ?? null; } if (tree.length === 0) { this.showStatus("No entries in session"); return; } this.showSelector((done) => { const selector = new TreeSelectorComponent( tree, visibleLeafId, this.ui.terminal.rows, async (entryId) => { // Selecting the visible leaf is a no-op (already there) if (entryId === visibleLeafId) { done(); this.showStatus("Already at this point"); return; } // Ask about summarization done(); // Close selector first const wantsSummary = await this.showHookConfirm( "Summarize branch?", "Create a summary of the branch you're leaving?", ); // Set up escape handler and loader if summarizing let summaryLoader: Loader | undefined; const originalOnEscape = this.editor.onEscape; if (wantsSummary) { this.editor.onEscape = () => { this.session.abortBranchSummary(); }; this.chatContainer.addChild(new Spacer(1)); summaryLoader = new Loader( this.ui, (spinner) => theme.fg("accent", spinner), (text) => theme.fg("muted", text), "Summarizing branch... (esc to cancel)", ); this.statusContainer.addChild(summaryLoader); this.ui.requestRender(); } try { const result = await this.session.navigateTree(entryId, { summarize: wantsSummary }); if (result.aborted) { // Summarization aborted - re-show tree selector this.showStatus("Branch summarization cancelled"); this.showTreeSelector(); return; } if (result.cancelled) { this.showStatus("Navigation cancelled"); return; } // Update UI this.chatContainer.clear(); this.renderInitialMessages(); if (result.editorText) { this.editor.setText(result.editorText); } this.showStatus("Navigated to selected point"); } catch (error) { this.showError(error instanceof Error ? error.message : String(error)); } finally { if (summaryLoader) { summaryLoader.stop(); this.statusContainer.clear(); } this.editor.onEscape = originalOnEscape; } }, () => { done(); this.ui.requestRender(); }, (entryId, label) => { this.sessionManager.appendLabelChange(entryId, label); this.ui.requestRender(); }, ); return { component: selector, focus: selector }; }); } private showSessionSelector(): void { this.showSelector((done) => { const sessions = SessionManager.list(this.sessionManager.getCwd(), this.sessionManager.getSessionDir()); const selector = new SessionSelectorComponent( sessions, async (sessionPath) => { done(); await this.handleResumeSession(sessionPath); }, () => { done(); this.ui.requestRender(); }, () => { void this.shutdown(); }, ); return { component: selector, focus: selector.getSessionList() }; }); } private async handleResumeSession(sessionPath: string): Promise { // Stop loading animation if (this.loadingAnimation) { this.loadingAnimation.stop(); this.loadingAnimation = undefined; } this.statusContainer.clear(); // Clear UI state this.pendingMessagesContainer.clear(); this.streamingComponent = undefined; this.streamingMessage = undefined; this.pendingTools.clear(); // Switch session via AgentSession (emits hook and tool session events) await this.session.switchSession(sessionPath); // Clear and re-render the chat this.chatContainer.clear(); this.renderInitialMessages(); this.showStatus("Resumed session"); } private async showOAuthSelector(mode: "login" | "logout"): Promise { if (mode === "logout") { const providers = this.session.modelRegistry.authStorage.list(); const loggedInProviders = providers.filter( (p) => this.session.modelRegistry.authStorage.get(p)?.type === "oauth", ); if (loggedInProviders.length === 0) { this.showStatus("No OAuth providers logged in. Use /login first."); return; } } this.showSelector((done) => { const selector = new OAuthSelectorComponent( mode, this.session.modelRegistry.authStorage, async (providerId: string) => { done(); if (mode === "login") { this.showStatus(`Logging in to ${providerId}...`); try { await this.session.modelRegistry.authStorage.login(providerId as OAuthProvider, { onAuth: (info: { url: string; instructions?: string }) => { this.chatContainer.addChild(new Spacer(1)); // Use OSC 8 hyperlink escape sequence for clickable link const hyperlink = `\x1b]8;;${info.url}\x07Click here to login\x1b]8;;\x07`; this.chatContainer.addChild(new Text(theme.fg("accent", hyperlink), 1, 0)); if (info.instructions) { this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(theme.fg("warning", info.instructions), 1, 0)); } this.ui.requestRender(); const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"; exec(`${openCmd} "${info.url}"`); }, onPrompt: async (prompt: { message: string; placeholder?: string }) => { this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(theme.fg("warning", prompt.message), 1, 0)); if (prompt.placeholder) { this.chatContainer.addChild(new Text(theme.fg("dim", prompt.placeholder), 1, 0)); } this.ui.requestRender(); return new Promise((resolve) => { const codeInput = new Input(); codeInput.onSubmit = () => { const code = codeInput.getValue(); this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.ui.setFocus(this.editor); resolve(code); }; this.editorContainer.clear(); this.editorContainer.addChild(codeInput); this.ui.setFocus(codeInput); this.ui.requestRender(); }); }, onProgress: (message: string) => { this.chatContainer.addChild(new Text(theme.fg("dim", message), 1, 0)); this.ui.requestRender(); }, }); // Refresh models to pick up new baseUrl (e.g., github-copilot) this.session.modelRegistry.refresh(); this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild( new Text(theme.fg("success", `✓ Successfully logged in to ${providerId}`), 1, 0), ); this.chatContainer.addChild( new Text(theme.fg("dim", `Credentials saved to ${getAuthPath()}`), 1, 0), ); this.ui.requestRender(); } catch (error: unknown) { this.showError(`Login failed: ${error instanceof Error ? error.message : String(error)}`); } } else { try { this.session.modelRegistry.authStorage.logout(providerId); // Refresh models to reset baseUrl this.session.modelRegistry.refresh(); this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild( new Text(theme.fg("success", `✓ Successfully logged out of ${providerId}`), 1, 0), ); this.chatContainer.addChild( new Text(theme.fg("dim", `Credentials removed from ${getAuthPath()}`), 1, 0), ); this.ui.requestRender(); } catch (error: unknown) { this.showError(`Logout failed: ${error instanceof Error ? error.message : String(error)}`); } } }, () => { done(); this.ui.requestRender(); }, ); return { component: selector, focus: selector }; }); } // ========================================================================= // Command handlers // ========================================================================= private handleExportCommand(text: string): void { const parts = text.split(/\s+/); const outputPath = parts.length > 1 ? parts[1] : undefined; try { const filePath = this.session.exportToHtml(outputPath); this.showStatus(`Session exported to: ${filePath}`); } catch (error: unknown) { this.showError(`Failed to export session: ${error instanceof Error ? error.message : "Unknown error"}`); } } private async handleShareCommand(): Promise { // Check if gh is available and logged in try { const authResult = spawnSync("gh", ["auth", "status"], { encoding: "utf-8" }); if (authResult.status !== 0) { this.showError("GitHub CLI is not logged in. Run 'gh auth login' first."); return; } } catch { this.showError("GitHub CLI (gh) is not installed. Install it from https://cli.github.com/"); return; } // Export to a temp file const tmpFile = path.join(os.tmpdir(), "session.html"); try { this.session.exportToHtml(tmpFile); } catch (error: unknown) { this.showError(`Failed to export session: ${error instanceof Error ? error.message : "Unknown error"}`); return; } // Show cancellable loader, replacing the editor const loader = new BorderedLoader(this.ui, theme, "Creating gist..."); this.editorContainer.clear(); this.editorContainer.addChild(loader); this.ui.setFocus(loader); this.ui.requestRender(); const restoreEditor = () => { loader.dispose(); this.editorContainer.clear(); this.editorContainer.addChild(this.editor); this.ui.setFocus(this.editor); try { fs.unlinkSync(tmpFile); } catch { // Ignore cleanup errors } }; // Create a secret gist asynchronously let proc: ReturnType | null = null; loader.onAbort = () => { proc?.kill(); restoreEditor(); this.showStatus("Share cancelled"); }; try { const result = await new Promise<{ stdout: string; stderr: string; code: number | null }>((resolve) => { proc = spawn("gh", ["gist", "create", "--public=false", tmpFile]); let stdout = ""; let stderr = ""; proc.stdout?.on("data", (data) => { stdout += data.toString(); }); proc.stderr?.on("data", (data) => { stderr += data.toString(); }); proc.on("close", (code) => resolve({ stdout, stderr, code })); }); if (loader.signal.aborted) return; restoreEditor(); if (result.code !== 0) { const errorMsg = result.stderr?.trim() || "Unknown error"; this.showError(`Failed to create gist: ${errorMsg}`); return; } // Extract gist ID from the URL returned by gh // gh returns something like: https://gist.github.com/username/GIST_ID const gistUrl = result.stdout?.trim(); const gistId = gistUrl?.split("/").pop(); if (!gistId) { this.showError("Failed to parse gist ID from gh output"); return; } // Create the preview URL const previewUrl = `https://shittycodingagent.ai/session?${gistId}`; this.showStatus(`Share URL: ${previewUrl}\nGist: ${gistUrl}`); } catch (error: unknown) { if (!loader.signal.aborted) { restoreEditor(); this.showError(`Failed to create gist: ${error instanceof Error ? error.message : "Unknown error"}`); } } } private handleCopyCommand(): void { const text = this.session.getLastAssistantText(); if (!text) { this.showError("No agent messages to copy yet."); return; } try { copyToClipboard(text); this.showStatus("Copied last agent message to clipboard"); } catch (error) { this.showError(error instanceof Error ? error.message : String(error)); } } private handleSessionCommand(): void { const stats = this.session.getSessionStats(); let info = `${theme.bold("Session Info")}\n\n`; info += `${theme.fg("dim", "File:")} ${stats.sessionFile ?? "In-memory"}\n`; info += `${theme.fg("dim", "ID:")} ${stats.sessionId}\n\n`; info += `${theme.bold("Messages")}\n`; info += `${theme.fg("dim", "User:")} ${stats.userMessages}\n`; info += `${theme.fg("dim", "Assistant:")} ${stats.assistantMessages}\n`; info += `${theme.fg("dim", "Tool Calls:")} ${stats.toolCalls}\n`; info += `${theme.fg("dim", "Tool Results:")} ${stats.toolResults}\n`; info += `${theme.fg("dim", "Total:")} ${stats.totalMessages}\n\n`; info += `${theme.bold("Tokens")}\n`; info += `${theme.fg("dim", "Input:")} ${stats.tokens.input.toLocaleString()}\n`; info += `${theme.fg("dim", "Output:")} ${stats.tokens.output.toLocaleString()}\n`; if (stats.tokens.cacheRead > 0) { info += `${theme.fg("dim", "Cache Read:")} ${stats.tokens.cacheRead.toLocaleString()}\n`; } if (stats.tokens.cacheWrite > 0) { info += `${theme.fg("dim", "Cache Write:")} ${stats.tokens.cacheWrite.toLocaleString()}\n`; } info += `${theme.fg("dim", "Total:")} ${stats.tokens.total.toLocaleString()}\n`; if (stats.cost > 0) { info += `\n${theme.bold("Cost")}\n`; info += `${theme.fg("dim", "Total:")} ${stats.cost.toFixed(4)}`; } this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(info, 1, 0)); this.ui.requestRender(); } private handleChangelogCommand(): void { const changelogPath = getChangelogPath(); const allEntries = parseChangelog(changelogPath); const changelogMarkdown = allEntries.length > 0 ? allEntries .reverse() .map((e) => e.content) .join("\n\n") : "No changelog entries found."; this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new DynamicBorder()); this.ui.addChild(new Text(theme.bold(theme.fg("accent", "What's New")), 1, 0)); this.ui.addChild(new Spacer(1)); this.chatContainer.addChild(new Markdown(changelogMarkdown, 1, 1, getMarkdownTheme())); this.chatContainer.addChild(new DynamicBorder()); this.ui.requestRender(); } private handleHotkeysCommand(): void { const hotkeys = ` **Navigation** | Key | Action | |-----|--------| | \`Arrow keys\` | Move cursor / browse history (Up when empty) | | \`Option+Left/Right\` | Move by word | | \`Ctrl+A\` / \`Home\` / \`Cmd+Left\` | Start of line | | \`Ctrl+E\` / \`End\` / \`Cmd+Right\` | End of line | **Editing** | Key | Action | |-----|--------| | \`Enter\` | Send message | | \`Shift+Enter\` / \`Alt+Enter\` | New line | | \`Ctrl+W\` / \`Option+Backspace\` | Delete word backwards | | \`Ctrl+U\` | Delete to start of line | | \`Ctrl+K\` | Delete to end of line | **Other** | Key | Action | |-----|--------| | \`Tab\` | Path completion / accept autocomplete | | \`Escape\` | Cancel autocomplete / abort streaming | | \`Ctrl+C\` | Clear editor (first) / exit (second) | | \`Ctrl+D\` | Exit (when editor is empty) | | \`Ctrl+Z\` | Suspend to background | | \`Shift+Tab\` | Cycle thinking level | | \`Ctrl+P\` | Cycle models | | \`Ctrl+O\` | Toggle tool output expansion | | \`Ctrl+T\` | Toggle thinking block visibility | | \`Ctrl+G\` | Edit message in external editor | | \`/\` | Slash commands | | \`!\` | Run bash command | `; this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new DynamicBorder()); this.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", "Keyboard Shortcuts")), 1, 0)); this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Markdown(hotkeys.trim(), 1, 1, getMarkdownTheme())); this.chatContainer.addChild(new DynamicBorder()); this.ui.requestRender(); } private async handleClearCommand(): Promise { // Stop loading animation if (this.loadingAnimation) { this.loadingAnimation.stop(); this.loadingAnimation = undefined; } this.statusContainer.clear(); // New session via session (emits hook and tool session events) await this.session.newSession(); // Clear UI state this.chatContainer.clear(); this.pendingMessagesContainer.clear(); this.streamingComponent = undefined; this.streamingMessage = undefined; this.pendingTools.clear(); this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new Text(`${theme.fg("accent", "✓ New session started")}`, 1, 1)); this.ui.requestRender(); } private handleDebugCommand(): void { const width = this.ui.terminal.columns; const allLines = this.ui.render(width); const debugLogPath = getDebugLogPath(); const debugData = [ `Debug output at ${new Date().toISOString()}`, `Terminal width: ${width}`, `Total lines: ${allLines.length}`, "", "=== All rendered lines with visible widths ===", ...allLines.map((line, idx) => { const vw = visibleWidth(line); const escaped = JSON.stringify(line); return `[${idx}] (w=${vw}) ${escaped}`; }), "", "=== Agent messages (JSONL) ===", ...this.session.messages.map((msg) => JSON.stringify(msg)), "", ].join("\n"); fs.mkdirSync(path.dirname(debugLogPath), { recursive: true }); fs.writeFileSync(debugLogPath, debugData); this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild( new Text(`${theme.fg("accent", "✓ Debug log written")}\n${theme.fg("muted", debugLogPath)}`, 1, 1), ); this.ui.requestRender(); } private handleArminSaysHi(): void { this.chatContainer.addChild(new Spacer(1)); this.chatContainer.addChild(new ArminComponent(this.ui)); this.ui.requestRender(); } private async handleBashCommand(command: string): Promise { const isDeferred = this.session.isStreaming; this.bashComponent = new BashExecutionComponent(command, this.ui); if (isDeferred) { // Show in pending area when agent is streaming this.pendingMessagesContainer.addChild(this.bashComponent); this.pendingBashComponents.push(this.bashComponent); } else { // Show in chat immediately when agent is idle this.chatContainer.addChild(this.bashComponent); } this.ui.requestRender(); try { const result = await this.session.executeBash(command, (chunk) => { if (this.bashComponent) { this.bashComponent.appendOutput(chunk); this.ui.requestRender(); } }); if (this.bashComponent) { this.bashComponent.setComplete( result.exitCode, result.cancelled, result.truncated ? ({ truncated: true, content: result.output } as TruncationResult) : undefined, result.fullOutputPath, ); } } catch (error) { if (this.bashComponent) { this.bashComponent.setComplete(undefined, false); } this.showError(`Bash command failed: ${error instanceof Error ? error.message : "Unknown error"}`); } this.bashComponent = undefined; this.ui.requestRender(); } private async handleCompactCommand(customInstructions?: string): Promise { const entries = this.sessionManager.getEntries(); const messageCount = entries.filter((e) => e.type === "message").length; if (messageCount < 2) { this.showWarning("Nothing to compact (no messages yet)"); return; } await this.executeCompaction(customInstructions, false); } private async executeCompaction(customInstructions?: string, isAuto = false): Promise { // Stop loading animation if (this.loadingAnimation) { this.loadingAnimation.stop(); this.loadingAnimation = undefined; } this.statusContainer.clear(); // Set up escape handler during compaction const originalOnEscape = this.editor.onEscape; this.editor.onEscape = () => { this.session.abortCompaction(); }; // Show compacting status this.chatContainer.addChild(new Spacer(1)); const label = isAuto ? "Auto-compacting context... (esc to cancel)" : "Compacting context... (esc to cancel)"; const compactingLoader = new Loader( this.ui, (spinner) => theme.fg("accent", spinner), (text) => theme.fg("muted", text), label, ); this.statusContainer.addChild(compactingLoader); this.ui.requestRender(); try { const result = await this.session.compact(customInstructions); // Rebuild UI this.rebuildChatFromMessages(); // Add compaction component at bottom so user sees it without scrolling const msg = createCompactionSummaryMessage(result.summary, result.tokensBefore, new Date().toISOString()); this.addMessageToChat(msg); this.footer.invalidate(); } catch (error) { const message = error instanceof Error ? error.message : String(error); if (message === "Compaction cancelled" || (error instanceof Error && error.name === "AbortError")) { this.showError("Compaction cancelled"); } else { this.showError(`Compaction failed: ${message}`); } } finally { compactingLoader.stop(); this.statusContainer.clear(); this.editor.onEscape = originalOnEscape; } } stop(): void { if (this.loadingAnimation) { this.loadingAnimation.stop(); this.loadingAnimation = undefined; } this.footer.dispose(); if (this.unsubscribe) { this.unsubscribe(); } if (this.isInitialized) { this.ui.stop(); this.isInitialized = false; } } }