@xingular/harness 0.1.7 → 1.0.0

package/src/terminal/tui/application.ts

@@ -1,491 +0,0 @@
-import { execFile, spawn } from 'node:child_process'
-import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
-import { tmpdir } from 'node:os'
-import { join } from 'node:path'
-import { randomUUID } from 'node:crypto'
-import manifest from '../../../package.json'
-import { promisify } from 'node:util'
-import { CustomEditor, copyToClipboard, initTheme, type AgentSessionEvent, type ExtensionUIContext, type KeybindingsManager, type ReadonlyFooterDataProvider, type Theme } from '@earendil-works/pi-coding-agent'
-import { CombinedAutocompleteProvider, ProcessTerminal, TuiMainScreen, Text, matchesKey, setKeybindings, truncateToWidth, visibleWidth, wrapTextWithAnsi, type AutocompleteProvider, type Component, type EditorComponent, type TuiMouseEvent } from '@earendil-works/pi-tui'
-
-import { controlCall } from '../control'
-import { createTerminalCommands } from './commands'
-import { HarnessEditor } from './editor'
-import { HARNESS_KEYBINDINGS, terminalKeybindings } from './keybindings'
-import { loadPiAdapter, setPiTheme } from './piAdapter'
-import { createTerminalRuntime, type TerminalDecision, type TerminalRuntime } from './runtime'
-import { renderStatusBand, singleLine } from './status'
-import { createHarnessLightTheme, createHarnessTheme } from './theme'
-import { TerminalTranscript } from './transcript'
-import { createTerminalUi, type TerminalUi } from './ui'
-import { HarnessWelcome } from './welcome'
-import { answerTerminalQuestion } from './questions'
-import type { QuestionAnswer } from '../../sessions/registry'
-
-const exec = promisify(execFile)
-type Mounted = Component & { dispose?(): void }
-type EditorFactory = Parameters<ExtensionUIContext['setEditorComponent']>[0]
-type HeaderFactory = Parameters<ExtensionUIContext['setHeader']>[0]
-type FooterFactory = Parameters<ExtensionUIContext['setFooter']>[0]
-
-/** Sole owner of terminal lifecycle, layout, input dispatch, focus and screen transitions. */
-export class TerminalApplication implements Component {
-  readonly terminal = new ProcessTerminal()
-  readonly tui = new TuiMainScreen(this.terminal)
-  private runtime?: TerminalRuntime
-  private ui!: TerminalUi
-  private keybindings!: KeybindingsManager
-  private editor!: EditorComponent
-  private transcript!: TerminalTranscript
-  private commands!: ReturnType<typeof createTerminalCommands>
-  private header?: Mounted
-  private footer?: Mounted
-  private headerFactory?: HeaderFactory
-  private footerFactory?: FooterFactory
-  private editorFactory?: EditorFactory
-  private widgets = new Map<string, { component: Mounted; placement: string }>()
-  private statuses = new Map<string, string>()
-  private branch: string | null = null
-  private branchListeners = new Set<() => void>()
-  private baseAutocomplete?: AutocompleteProvider
-  private notices: { message: string; type: string }[] = []
-  private startedAt: number | null = null
-  private phase?: string
-  private scrollOffset = 0
-  private totalLines = 0
-  private toolsExpanded = false
-  private thinkingChanges = 0
-  private stopped = false
-  private initialized = false
-  private closing?: Promise<void>
-  private failure?: Error
-  private finish!: () => void
-  private done = new Promise<void>(resolve => { this.finish = resolve })
-  private cleanup: (() => void)[] = []
-  private finalCleanup: (() => void)[] = []
-  private draftSync = Promise.resolve()
-  private lastInput = ''
-  private commandBusy = false
-  private pendingPolling = false
-  private pendingBusy = false
-  private pendingAbort?: AbortController
-  private pendingId?: string
-  private dismissedDecisions = new Set<string>()
-  private mouseRegions: { component: Component; start: number; height: number }[] = []
-
-  constructor(private readonly args: string[]) {}
-  private get session() { if (!this.runtime) throw new Error('The terminal runtime is not ready.'); return this.runtime.session }
-  private get theme(): Theme { return this.ui.theme }
-  private change = (): void => { if (!this.stopped) this.tui.requestRender() }
-  private notify = (message: string, type = 'info'): void => {
-    if (message.startsWith('No models available.')) message = 'No model is configured. Use /accounts or /login to sign in.'
-    this.notices.push({ message, type })
-    this.notices = this.notices.slice(-8)
-    this.change()
-  }
-  private attempt = (action: () => Promise<unknown> | unknown): void => { void Promise.resolve().then(action).catch(error => this.notify(error instanceof Error ? error.message : String(error), 'error')).finally(this.change) }
-
-  async run(): Promise<number> {
-    if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error('The Harness frontend requires an interactive terminal.')
-    if (!process.env.PI_CODING_AGENT_DIR || !process.env.XINGULAR_HARNESS_SOCKET) throw new Error('Prepare a Harness terminal session before starting its frontend.')
-    const onSignal = () => { void this.shutdown() }
-    const onFatal = (error: unknown) => {
-      this.failure ??= error instanceof Error ? error : new Error(String(error))
-      void this.shutdown()
-    }
-    const onContinue = () => { if (!this.stopped) { this.tui.start(); this.change() } }
-    try {
-      const adapter = await loadPiAdapter()
-      initTheme('dark', false)
-      const theme = createHarnessTheme({ getColorMode: () => process.env.COLORTERM === 'truecolor' || process.env.COLORTERM === '24bit' ? 'truecolor' : '256color' } as Theme)
-      setPiTheme(theme)
-      this.keybindings = terminalKeybindings(process.env.PI_CODING_AGENT_DIR)
-      setKeybindings(this.keybindings)
-      this.transcript = new TerminalTranscript(this.tui, () => this.theme, adapter.withBuiltInRenderers)
-      this.ui = this.makeUi(theme)
-      this.mountEditor()
-      this.tui.addChild(this)
-      this.tui.setFocus(this.editor)
-      this.cleanup.push(this.tui.addInputListener(data => this.dispatchInput(data)))
-      for (const signal of ['SIGTERM', 'SIGINT', 'SIGHUP'] as const) { process.on(signal, onSignal); this.cleanup.push(() => { process.off(signal, onSignal) }) }
-      process.on('uncaughtException', onFatal)
-      process.on('unhandledRejection', onFatal)
-      this.finalCleanup.push(() => { process.off('uncaughtException', onFatal); process.off('unhandledRejection', onFatal) })
-      process.on('SIGCONT', onContinue)
-      this.cleanup.push(() => { process.off('SIGCONT', onContinue) })
-      this.tui.setShowHardwareCursor(true)
-      this.tui.setClearOnShrink(true)
-      this.tui.start()
-      this.phase = 'Starting session…'
-      this.runtime = await createTerminalRuntime(this.args, { ui: this.ui, shutdown: () => { void this.shutdown() }, notify: this.notify, changed: this.change, resources: services => {
-        this.ui.setThemes(services.resourceLoader.getThemes().themes)
-        const name = services.settingsManager.getTheme()
-        const selected = name ? this.ui.getTheme(name) : undefined
-        if (selected && this.ui.theme.name !== selected.name) this.ui.setTheme(selected)
-      } })
-      if (this.stopped) { await this.runtime.dispose(); if (this.failure) throw this.failure; return 0 }
-      this.commands = createTerminalCommands({
-        session: () => this.session, runtime: () => this.runtime!, ui: this.ui,
-        cwd: () => this.runtime!.cwd, sessionDirectory: () => this.runtime!.sessionDirectory,
-        refresh: () => this.refresh(), shutdown: () => { void this.shutdown() }, setEditorText: text => { this.editor.setText(text); this.syncDraft(text) },
-        copyText: copyToClipboard, openExternal: async url => {
-          const program = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'rundll32' : 'xdg-open'
-          await exec(program, process.platform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url])
-        },
-        suspend: () => this.suspend(), hotkeys: () => this.hotkeys(),
-        changelog: async () => {
-          for (const path of ['../CHANGELOG.md', '../../../CHANGELOG.md']) {
-            try { return `${manifest.name} v${manifest.version}\n\n${(await readFile(new URL(path, import.meta.url), 'utf8')).split('\n').slice(0, 24).join('\n')}` } catch { /* Bundled hosts may omit package documentation. */ }
-          }
-          return `${manifest.name} v${manifest.version}\nRelease notes were not bundled with this installation.`
-        },
-        secretInput: (title, placeholder, options) => this.ui.secretInput(title, placeholder, options)
-      })
-      this.cleanup.push(this.runtime.subscribe(event => this.accept(event)))
-      this.cleanup.push(this.runtime.onBeforeSessionChange(() => this.resetPresentation()))
-      this.cleanup.push(this.runtime.onSessionChange(() => { this.keybindings.reload(); this.startedAt = null; this.phase = undefined; this.scrollOffset = 0; this.thinkingChanges = 0; this.refresh(true) }))
-      this.initialized = true
-      this.phase = undefined
-      this.refresh(true)
-      const tick = setInterval(() => { if (this.startedAt !== null) this.change(); void this.decisions() }, 100)
-      const git = setInterval(() => { void this.refreshBranch() }, 3000)
-      this.cleanup.push(() => { clearInterval(tick); clearInterval(git) })
-      await this.refreshBranch()
-      await this.done
-      if (this.failure) throw this.failure
-      return 0
-    } catch (error) {
-      if (this.ui && !this.stopped) { this.notify(error instanceof Error ? error.message : String(error), 'error'); this.tui.renderNow(true) }
-      throw error
-    } finally { await this.shutdown() }
-  }
-
-  private makeUi(theme: Theme): TerminalUi {
-    return createTerminalUi({
-      tui: this.tui, theme, themes: [createHarnessLightTheme(theme)], keybindings: this.keybindings, changed: this.change, notify: this.notify,
-      setEditor: factory => this.mountEditor(factory), getEditor: () => this.editor,
-      getEditorText: () => this.editor?.getText() ?? '', setEditorText: value => { this.editor.setText(value); this.syncDraft(value) },
-      setStatus: (key, value) => { if (value === undefined) this.statuses.delete(key); else this.statuses.set(key, value) },
-      setWidget: (key, content, placement) => {
-        this.release(this.widgets.get(key)?.component)
-        if (!content) this.widgets.delete(key)
-        else this.widgets.set(key, { component: typeof content === 'function' ? content(this.tui, this.theme) : new Text(content.join('\n'), 0, 0), placement: placement ?? 'aboveEditor' })
-      },
-      setHeader: factory => { this.headerFactory = factory; this.release(this.header); this.header = factory?.(this.tui, this.theme) },
-      setFooter: factory => { this.footerFactory = factory; this.release(this.footer); this.footer = factory?.(this.tui, this.theme, this.footerData) },
-      getAutocompleteProvider: () => this.baseAutocomplete!,
-      setAutocompleteProvider: provider => this.editor.setAutocompleteProvider?.(provider),
-      themeChanged: next => { setPiTheme(next); this.remountPresentation() },
-      getToolsExpanded: () => this.toolsExpanded, setToolsExpanded: value => { this.toolsExpanded = value; this.transcript.setExpanded(value) }
-    })
-  }
-  private footerData: ReadonlyFooterDataProvider = {
-    getGitBranch: () => this.branch, getExtensionStatuses: () => this.statuses,
-    getAvailableProviderCount: () => new Set(this.runtime?.services.modelRuntime.getAvailableSnapshot().map(model => model.provider) ?? []).size,
-    onBranchChange: callback => { this.branchListeners.add(callback); return () => { this.branchListeners.delete(callback) } }
-  }
-  private async refreshBranch(): Promise<void> {
-    if (!this.runtime || this.stopped) return
-    let branch: string | null = null
-    try { branch = (await exec('git', ['symbolic-ref', '--quiet', '--short', 'HEAD'], { cwd: this.runtime.cwd, timeout: 2000 })).stdout.trim() || null }
-    catch { /* Non-repositories and detached HEAD have no branch segment. */ }
-    if (branch !== this.branch) { this.branch = branch; for (const listener of this.branchListeners) listener(); this.change() }
-  }
-  private release(component?: Mounted): void {
-    try { component?.dispose?.() }
-    catch (error) { this.notify(`Plugin cleanup failed: ${error instanceof Error ? error.message : String(error)}`, 'error') }
-  }
-  private mountEditor(factory?: EditorFactory): void {
-    const draft = this.editor?.getText() ?? ''
-    this.release(this.editor as Mounted | undefined)
-    this.editorFactory = factory
-    const editorTheme = { borderColor: (text: string) => this.theme.fg('border', text), selectList: {
-      selectedPrefix: (text: string) => this.theme.fg('accent', text), selectedText: (text: string) => this.theme.fg('accent', text), description: (text: string) => this.theme.fg('muted', text), scrollInfo: (text: string) => this.theme.fg('dim', text), noMatch: (text: string) => this.theme.fg('muted', text)
-    } }
-    this.editor = factory?.(this.tui, editorTheme, this.keybindings) ?? new HarnessEditor(this.tui, editorTheme, this.keybindings, {
-      band: (width, above, below) => this.band(width, above, below), theme: () => this.theme,
-      showHint: () => this.thinkingChanges < 3 && !this.runtime?.snapshot().hasUserMessages && this.startedAt === null,
-      thinkingKey: this.keybindings.getKeys('app.thinking.cycle').map(key => key === 'shift+tab' ? '⇧⇥' : key).join('/')
-    })
-    this.editor.setText(draft)
-    this.editor.onSubmit = text => this.submit(text)
-    const onChange = this.editor.onChange
-    this.editor.onChange = text => { onChange?.(text); this.syncDraft(text); this.scrollOffset = 0; this.change() }
-    if (factory && this.editor instanceof CustomEditor) {
-      // A trusted editor may consume keys in its own mode before delegating to CustomEditor.
-      // Wire host actions into that delegation instead of taking the keys away in a listener.
-      const editor = this.editor
-      for (const action of Object.keys(HARNESS_KEYBINDINGS).filter(name => name.startsWith('app.'))) {
-        const id = action as Parameters<CustomEditor['onAction']>[0]
-        if (!editor.actionHandlers.has(id)) editor.onAction(id, () => { this.dispatchInput(this.lastInput, true) })
-      }
-      editor.onEscape ??= () => { this.dispatchInput(this.lastInput, true) }
-      editor.onCtrlD ??= () => { void this.shutdown() }
-      editor.onPasteImage ??= () => this.attempt(() => this.pasteClipboard())
-      editor.onExtensionShortcut ??= data => this.extensionShortcut(data)
-    }
-    if (this.baseAutocomplete) this.editor.setAutocompleteProvider?.(this.ui.wrapAutocomplete(this.baseAutocomplete))
-    this.tui.setFocus(this.editor)
-  }
-  private syncDraft(text: string): void {
-    this.draftSync = this.draftSync.then(() => controlCall('terminal.draft', { dirty: text.length > 0 })).then(() => {}).catch(error => this.notify(String(error), 'error'))
-  }
-  private band(width: number, above = 0, below = 0): string {
-    const state = this.runtime?.snapshot()
-    return renderStatusBand({ cwd: state?.cwd ?? process.cwd(), model: state?.model,
-      thinkingLevel: state?.thinkingLevel ?? 'off', branch: this.branch, account: state?.account?.label ?? 'account unknown',
-      contextPercent: state?.context.percent ?? null, contextWindow: state?.context.window ?? 0,
-      costUsd: state?.costUsd ?? 0, subscription: state?.subscription ?? false,
-      running: this.startedAt !== null, elapsedMs: this.startedAt === null ? 0 : Date.now() - this.startedAt, hiddenAbove: above, hiddenBelow: below
-    }, width, this.theme)
-  }
-  private submit(text: string, followUp = false): void {
-    if (!text.trim() || !this.initialized) return
-    if (this.commandBusy) { this.notify('Finish or cancel the active command first.', 'error'); return }
-    const command = text.trimStart().startsWith('/')
-    if (command) this.commandBusy = true
-    this.editor.addToHistory?.(text)
-    this.editor.setText(''); this.syncDraft(''); this.notices = []; this.scrollOffset = 0
-    this.attempt(async () => {
-      try {
-        await this.draftSync
-        if (this.stopped) return
-        if (command && await this.commands.execute(text)) return
-        if (text.trimStart().startsWith('!')) throw new Error('Use the bash tool so this action can be checked.')
-        await this.runtime!.submit(text, followUp)
-      } finally { if (command) this.commandBusy = false }
-    })
-  }
-  private dispatchInput(data: string, delegated = false) {
-    this.lastInput = data
-    if (this.stopped) return { consume: true }
-    if (this.tui.hasOverlay()) return
-    if (!this.initialized) { if (matchesKey(data, 'ctrl+c') || matchesKey(data, 'ctrl+d')) void this.shutdown(); return { consume: true } }
-    if (this.editorFactory && !delegated) return
-    if (this.extensionShortcut(data)) return { consume: true }
-    const is = (action: Parameters<KeybindingsManager['matches']>[1]) => this.keybindings.matches(data, action)
-    if (is('app.interrupt')) {
-      if (this.editor instanceof HarnessEditor && this.editor.isShowingAutocomplete()) return
-      this.attempt(() => this.runtime!.interrupt())
-    } else if (is('app.clear')) {
-      if (this.session.isStreaming) this.attempt(() => this.runtime!.interrupt())
-      else if (this.editor.getText()) { this.editor.setText(''); this.syncDraft('') }
-      else void this.shutdown()
-    } else if (is('app.exit') && this.editor.getText() === '') void this.shutdown()
-    else if (is('app.thinking.cycle')) { this.session.cycleThinkingLevel(); this.thinkingChanges += 1 }
-    else if (is('app.thinking.save')) this.session.setThinkingLevel(this.session.thinkingLevel, { persist: true })
-    else if (is('app.model.cycleForward') || is('app.model.cycleBackward')) this.attempt(() => this.session.cycleModel(is('app.model.cycleBackward') ? 'backward' : 'forward'))
-    else if (is('app.model.select')) this.attempt(() => this.commands.execute('/model'))
-    else if (is('app.tools.expand')) this.ui.setToolsExpanded(!this.toolsExpanded)
-    else if (is('app.thinking.toggle')) { const hidden = !this.session.settingsManager.getHideThinkingBlock(); this.session.settingsManager.setHideThinkingBlock(hidden); this.transcript.setThinking(hidden) }
-    else if (is('app.message.followUp')) this.submit(this.editor.getExpandedText?.() ?? this.editor.getText(), true)
-    else if (is('app.message.dequeue')) { const pending = this.session.clearQueue(); this.editor.setText([...pending.steering, ...pending.followUp, this.editor.getText()].filter(Boolean).join('\n')); this.syncDraft(this.editor.getText()) }
-    else if (is('app.editor.external')) this.attempt(() => this.externalEditor())
-    else if (is('app.message.copy')) this.attempt(() => this.commands.execute('/copy'))
-    else if (is('app.clipboard.pasteImage')) this.attempt(() => this.pasteClipboard())
-    else if (is('app.suspend')) this.attempt(() => this.suspend())
-    else if (matchesKey(data, 'pageUp') || matchesKey(data, 'shift+pageUp')) this.scrollOffset = Math.min(Math.max(0, this.totalLines - 1), this.scrollOffset + Math.max(1, this.terminal.rows - 4))
-    else if (matchesKey(data, 'pageDown') || matchesKey(data, 'shift+pageDown')) this.scrollOffset = Math.max(0, this.scrollOffset - Math.max(1, this.terminal.rows - 4))
-    else if (matchesKey(data, 'ctrl+home')) this.scrollOffset = Math.max(0, this.totalLines - 1)
-    else if (matchesKey(data, 'ctrl+end')) this.scrollOffset = 0
-    else return
-    this.change(); return { consume: true }
-  }
-  private extensionShortcut(data: string): boolean {
-    const shortcut = [...this.session.extensionRunner.getShortcuts(this.keybindings.getResolvedBindings()).entries()].find(([key]) => matchesKey(data, key))
-    if (!shortcut) return false
-    this.attempt(() => shortcut[1].handler(this.session.extensionRunner.createContext()))
-    return true
-  }
-  private accept(event: AgentSessionEvent): void {
-    this.transcript.accept(event)
-    if (event.type === 'agent_start') { this.startedAt = Date.now(); this.phase = undefined; this.terminal.setProgress(this.session.settingsManager.getShowTerminalProgress()) }
-    if (event.type === 'agent_settled') { this.startedAt = null; this.phase = undefined; this.terminal.setProgress(false) }
-    if (event.type === 'compaction_start') this.phase = 'Compacting context…'
-    if (event.type === 'compaction_end') { this.phase = undefined; this.transcript.bind(this.session); if (event.errorMessage) this.notify(event.errorMessage, 'error') }
-    if (event.type === 'auto_retry_start') this.phase = `Retry ${event.attempt}/${event.maxAttempts} in ${(event.delayMs / 1000).toFixed(1)}s: ${event.errorMessage}`
-    if (event.type === 'auto_retry_end') this.phase = event.finalError
-    this.change()
-  }
-  private refresh(history = false): void {
-    if (!this.runtime) return
-    this.ui.setThemes(this.session.resourceLoader.getThemes().themes)
-    this.tui.setShowHardwareCursor(this.session.settingsManager.getShowHardwareCursor())
-    this.transcript.bind(this.session); this.transcript.setExpanded(this.toolsExpanded)
-    if (history) for (const message of this.session.state.messages) if (message.role === 'user') {
-      const text = typeof message.content === 'string' ? message.content : message.content.filter(part => part.type === 'text').map(part => part.text).join('\n')
-      if (text) this.editor.addToHistory?.(text)
-    }
-    this.baseAutocomplete = new CombinedAutocompleteProvider(this.commands.completions(), this.runtime.cwd)
-    this.editor.setAutocompleteProvider?.(this.ui.wrapAutocomplete(this.baseAutocomplete))
-    this.change()
-  }
-  private resetPresentation(): void {
-    this.pendingAbort?.abort(); this.dismissedDecisions.clear()
-    this.transcript.clearSession()
-    this.ui.reset()
-    this.release(this.header); this.release(this.footer)
-    this.header = this.footer = undefined; this.headerFactory = this.footerFactory = undefined
-    for (const widget of this.widgets.values()) this.release(widget.component)
-    this.widgets.clear(); this.statuses.clear(); this.branchListeners.clear()
-    this.mountEditor()
-    // The UI object bound to the runtime stays stable; reset its session-owned state separately.
-  }
-  private remountPresentation(): void {
-    this.release(this.header); this.release(this.footer)
-    this.header = this.headerFactory?.(this.tui, this.theme)
-    this.footer = this.footerFactory?.(this.tui, this.theme, this.footerData)
-    this.mountEditor(this.editorFactory)
-    if (this.runtime) this.refresh()
-  }
-
-  render(width: number): string[] {
-    if (width < 1 || !this.ui) return []
-    this.mouseRegions = []
-    const welcome = this.header ?? new HarnessWelcome(this.theme, process.env.XINGULAR_HARNESS_NAME)
-    const history = ['', ...welcome.render(width), '', '']
-    const state = this.runtime?.snapshot()
-    this.transcript.setThinking(state?.hideThinking ?? false, this.ui.state.hiddenThinkingLabel ?? 'Thinking…')
-    const transcriptRows = this.transcript.render(Math.max(3, width))
-    this.mouseRegions.push({ component: this.transcript, start: history.length, height: transcriptRows.length })
-    history.push(...transcriptRows); this.totalLines = history.length
-    const title = state?.name
-    const working = this.phase ?? (this.startedAt !== null && this.ui.state.workingVisible ? this.ui.state.workingMessage ?? 'Working…' : '')
-    const titleText = title ? this.theme.italic(this.theme.fg('dim', singleLine(title))) : ''
-    const indicator = this.ui.state.workingIndicator
-    const frames = indicator?.frames
-    const frame = this.startedAt !== null && frames?.length ? frames[Math.floor((Date.now() - this.startedAt) / Math.max(1, indicator?.intervalMs ?? 80)) % frames.length] : ''
-    const workText = working ? (frame ? frame + ' ' : '') + this.theme.fg('muted', singleLine(working)) : ''
-    const composer = titleText || workText ? [truncateToWidth(workText, width, '') + ' '.repeat(Math.max(0, width - visibleWidth(workText) - visibleWidth(titleText))) + titleText] : []
-    const append = (component: Component) => { const rows = component.render(width); this.mouseRegions.push({ component, start: history.length + composer.length, height: rows.length }); composer.push(...rows) }
-    for (const widget of this.widgets.values()) if (widget.placement !== 'belowEditor') append(widget.component)
-    if (state) for (const text of [...state.queue.steering.map(text => `Steering: ${text}`), ...state.queue.followUp.map(text => `Follow-up: ${text}`)]) composer.push(...wrapTextWithAnsi(this.theme.fg('muted', text), width))
-    for (const { message, type } of this.notices) composer.push(...wrapTextWithAnsi(this.theme.fg(type === 'error' ? 'error' : type === 'warning' ? 'warning' : 'muted', message), width))
-    append(this.editor)
-    for (const widget of this.widgets.values()) if (widget.placement === 'belowEditor') append(widget.component)
-    if (this.footer) append(this.footer)
-    else if (this.statuses.size) composer.push(...wrapTextWithAnsi([...this.statuses.values()].join('  '), width))
-    const available = Math.max(1, this.terminal.rows - composer.length - 1)
-    const end = Math.max(1, history.length - this.scrollOffset)
-    const start = this.scrollOffset ? Math.max(0, end - available) : 0
-    for (const region of this.mouseRegions) region.start -= region.component === this.transcript ? start : this.scrollOffset ? history.length - (end - start + 1) : 0
-    const content = this.scrollOffset ? [...history.slice(start, end), this.theme.fg('dim', `↑ Scrollback · ${this.scrollOffset} rows from latest · PgDn to return`)] : history
-    return [...content, ...composer].map(line => truncateToWidth(line, width, ''))
-  }
-  invalidate(): void { this.header?.invalidate(); this.footer?.invalidate(); this.transcript?.invalidate(); this.editor?.invalidate(); for (const widget of this.widgets.values()) widget.component.invalidate() }
-  handleMouse(event: TuiMouseEvent) {
-    if (event.type === 'wheel') { this.scrollOffset = Math.max(0, Math.min(this.totalLines - 1, this.scrollOffset - (event.wheelDelta ?? 0))); this.change(); return { handled: true } }
-    const region = this.mouseRegions.find(region => event.y >= region.start && event.y < region.start + region.height)
-    return region?.component.handleMouse?.({ ...event, y: event.y - region.start, height: region.height })
-  }
-
-  private async decisions(): Promise<void> {
-    if (this.pendingPolling || !this.runtime || this.stopped) return
-    this.pendingPolling = true
-    let requests: TerminalDecision[]
-    try {
-      requests = await this.runtime.pending()
-    } catch (error) {
-      if (!this.stopped) this.notify(error instanceof Error ? error.message : String(error), 'error')
-      return
-    } finally { this.pendingPolling = false }
-    if (this.pendingId && !requests.some(request => request.requestId === this.pendingId)) this.pendingAbort?.abort()
-    if (this.pendingBusy) return
-    this.pendingBusy = true
-    try {
-      const request = requests.find(request => !this.dismissedDecisions.has(request.requestId))
-      if (!request || this.tui.hasOverlay()) return
-      const abort = new AbortController(); this.pendingAbort = abort; this.pendingId = request.requestId
-      this.dismissedDecisions.add(request.requestId)
-      if (request.type === 'approval') {
-        const approved = await this.ui.confirm(`Allow ${request.target ?? 'action'}?`, request.action ?? '', { signal: abort.signal })
-        if (!abort.signal.aborted) await this.runtime.approve(request.requestId, approved ? 'approved' : 'denied')
-      } else {
-        const group = request.batchId
-          ? requests.filter(item => item.type === 'question' && item.batchId === request.batchId).sort((a, b) => (a.batchIndex ?? 0) - (b.batchIndex ?? 0))
-          : [request]
-        const answers: { questionId: string; answer: QuestionAnswer }[] = []
-        for (const question of group) {
-          const answer = await answerTerminalQuestion(this.ui, question, abort.signal)
-          if (abort.signal.aborted) return
-          if (!answer) { await this.runtime!.interrupt(); return }
-          answers.push({ questionId: question.requestId, answer })
-        }
-        if (!abort.signal.aborted) {
-          if (request.batchId) await this.runtime.answerBatch(request.batchId, answers)
-          else await this.runtime.answer(request.requestId, answers[0]!.answer)
-        }
-      }
-    } catch (error) {
-      if (this.pendingId) this.dismissedDecisions.delete(this.pendingId)
-      if (!this.stopped) this.notify(error instanceof Error ? error.message : String(error), 'error')
-    }
-    finally { this.pendingBusy = false; this.pendingId = undefined; this.pendingAbort = undefined }
-  }
-  private hotkeys(): string {
-    return Object.entries(this.keybindings.getResolvedBindings()).filter(([name, keys]) => name.startsWith('app.') && (!Array.isArray(keys) || keys.length)).map(([name, keys]) => `${Array.isArray(keys) ? keys.join(', ') : keys}: ${name.slice(4).replaceAll('.', ' ')}`).join('\n') + '\nPgUp/PgDn: scroll transcript\nCtrl+Home/End: oldest/latest transcript'
-  }
-  private async pasteClipboard(): Promise<void> {
-    const adapter = await loadPiAdapter()
-    const files = await adapter.readClipboardFilePaths()
-    if (files?.length) {
-      if (files.some(file => /[\x00-\x1f\x7f]/.test(file))) throw new Error('Clipboard file paths contain control characters.')
-      this.ui.pasteToEditor(files.join('\n'))
-      return
-    }
-    const image = await adapter.readClipboardImage()
-    if (image) {
-      const directory = await mkdtemp(join(tmpdir(), 'harness-clipboard-'))
-      const file = join(directory, `${randomUUID()}.${adapter.extensionForImageMimeType(image.mimeType) ?? 'png'}`)
-      await writeFile(file, image.bytes, { mode: 0o600 })
-      this.cleanup.push(() => { void rm(directory, { recursive: true, force: true }) })
-      this.ui.pasteToEditor(file)
-      return
-    }
-    const text = await adapter.readClipboardText()
-    if (text) this.ui.pasteToEditor(text)
-  }
-  private async externalEditor(): Promise<void> {
-    const editor = process.env.VISUAL || process.env.EDITOR
-    if (!editor) throw new Error('Set VISUAL or EDITOR to open an external editor.')
-    const directory = await mkdtemp(join(tmpdir(), 'harness-editor-')), file = join(directory, 'prompt.md')
-    try {
-      await writeFile(file, this.editor.getExpandedText?.() ?? this.editor.getText(), { mode: 0o600 })
-      this.tui.stop()
-      await new Promise<void>((resolve, reject) => {
-        const child = spawn(process.env.SHELL || '/bin/sh', ['-c', `${editor} "$1"`, 'harness-editor', file], { stdio: 'inherit' })
-        child.once('error', reject); child.once('exit', code => code === 0 ? resolve() : reject(new Error(`Editor exited with ${code}.`)))
-      })
-      this.editor.setText(await readFile(file, 'utf8')); this.syncDraft(this.editor.getText())
-    } finally { await rm(directory, { recursive: true, force: true }); if (!this.stopped) { this.tui.start(); this.change() } }
-  }
-  private async suspend(): Promise<void> {
-    if (process.platform === 'win32') throw new Error('Suspending is unavailable on Windows.')
-    this.tui.stop(); process.kill(process.pid, 'SIGTSTP')
-  }
-  shutdown(): Promise<void> {
-    return this.closing ??= (async () => {
-      const protect = (action: () => void) => {
-        try { action() } catch (error) { this.failure ??= error instanceof Error ? error : new Error(String(error)) }
-      }
-      this.stopped = true
-      protect(() => this.pendingAbort?.abort())
-      protect(() => this.ui?.dispose())
-      for (const cleanup of this.cleanup.splice(0)) protect(cleanup)
-      try { await this.runtime?.dispose() }
-      catch (error) { this.failure ??= error instanceof Error ? error : new Error(String(error)) }
-      finally {
-        protect(() => this.transcript?.clearSession())
-        protect(() => this.header?.dispose?.())
-        protect(() => this.footer?.dispose?.())
-        for (const widget of this.widgets.values()) protect(() => widget.component.dispose?.())
-        protect(() => (this.editor as Mounted | undefined)?.dispose?.())
-        await this.terminal.drainInput(200, 30).catch(() => {})
-        protect(() => this.tui.stop())
-        for (const cleanup of this.finalCleanup.splice(0)) protect(cleanup)
-        this.finish()
-      }
-    })()
-  }
-}
-export function runTerminalFrontend(args: string[]): Promise<number> { return new TerminalApplication(args).run() }