@mobius-os/mobius 0.3.38 → 0.3.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobius-os/mobius",
-  "version": "0.3.38",
+  "version": "0.3.43",
   "type": "module",
   "description": "Mobius terminal client. Reuses Mobius frontend TypeScript types and jsonl entry shapes.",
   "bin": {
@@ -8,21 +8,13 @@
     "mobius-tui": "bin/mobius-tui.js"
   },
   "scripts": {
-    "dev": "tsx src/main.tsx",
-    "start": "tsx src/main.tsx",
-    "typecheck": "tsc --noEmit",
-    "test:integration": "tsx tests/integration.test.ts",
-    "test:ui": "tsx tests/ui.test.tsx",
-    "test:flow": "tsx tests/flow.test.tsx",
-    "test:resume": "tsx tests/resume.test.tsx",
-    "test:aimux": "tsx tests/aimux.test.tsx",
-    "test:reconnect": "tsx tests/reconnect.test.tsx",
-    "test:screen": "FORCE_COLOR=1 tsx tests/screen.test.tsx",
-    "test:scroll": "tsx tests/scroll.test.tsx",
-    "test:viewport": "tsx tests/viewport.test.ts",
-    "test:selection": "FORCE_COLOR=1 tsx tests/selection.test.tsx",
-    "test": "npm run typecheck && npm run test:ui && npm run test:integration"
+    "start": "tsx src/main.tsx"
   },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
   "dependencies": {
     "chalk": "^5.3.0",
     "cli-highlight": "2.1.11",
@@ -33,16 +25,7 @@
     "tsx": "4.19.2",
     "wrap-ansi": "^9.0.0"
   },
-  "devDependencies": {
-    "@types/node": "18.19.34",
-    "@types/react": "18.3.3",
-    "ink-testing-library": "4.0.0",
-    "typescript": "5.4.5"
-  },
   "engines": {
     "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

package/src/aimux.ts

@@ -20,6 +20,8 @@ export interface AimuxStatus {
   state: AimuxState
   phase?: AimuxPhase
   detail?: string
+  /** Runtime package version when known; falls back to the bundled version. */
+  version?: string
   identifier?: string
   attempt?: number
 }
@@ -90,7 +92,9 @@ async function pythonForAimux(onProgress?: (p: InstallProgress) => void): Promis
 // 系统 python（如被精简掉 ensurepip 的容器镜像）。aimux 全部依赖为纯 Python，
 // 故三平台可共用同一套打包产物，分别按 arch 发布到 CDN。
 const BUNDLE_VER = '3'
-const BUNDLE_AIMUX_VERSION = '0.1.23'
+const BUNDLE_AIMUX_VERSION = '0.1.28'
+/** Version expected from the installed or bundled AIMUX runtime. */
+export const AIMUX_VERSION = BUNDLE_AIMUX_VERSION
 const bundleDir = () => path.join(mobiusHome(), 'python-bundle')
 const bundlePython = () => WIN
   ? path.join(bundleDir(), 'python', 'python.exe')
@@ -313,28 +317,64 @@ export function tuiAimuxIdentifier(hostname = os.hostname(), cwd = process.cwd()
 }
 
 /**
- * Build the reverse-connect command in one place. The TUI can launch AIMUX
- * through either a venv executable or bundled Python; both paths must request
- * a fully headless Windows shell or every remote command flashes a console and
- * steals keyboard focus from the TUI. Keep the old --silent-shell path
- * available for older AIMUX bundles; current bundles use the no-console v2
- * implementation (the historical spelling --slient-v2 is intentional).
+ * Build the reverse-connect command in one place. On Windows the bridge shells
+ * must run headless or every remote command flashes a console and steals
+ * keyboard focus from the TUI — but *which* flag asks for that depends on the
+ * installed aimux: `--silent-shell` landed in 0.1.18, the no-console
+ * `--slient-v2`/`--silent-v2` only in 0.1.22+. PyPI and cached bundles in the
+ * wild are often older, and hard-coding any one spelling makes Click reject the
+ * whole command ("No such option: --slient-v2") and the supervisor crash-loop.
+ * So the caller probes `reverse connect --help` once (see probeReverseConnectHelp
+ * + pickSilentFlag) and passes the flag aimux actually advertises; when nothing
+ * is supported we send nothing rather than crash.
  */
 export function reverseConnectArgs(
   server: string,
   identifier: string,
   token: string,
   platform: NodeJS.Platform = process.platform,
+  silentFlag: string | null = null,
 ): string[] {
   return [
     'reverse', 'connect', `${server.replace(/\/$/, '')}/aimux_bridge`,
     '--identifier', identifier,
     '--token', token,
     '--replace',
-    ...(platform === 'win32' ? ['--slient-v2'] : []),
+    ...(platform === 'win32' && silentFlag ? [silentFlag] : []),
   ]
 }
 
+/**
+ * Capture `aimux reverse connect --help` so we can see which console-hiding
+ * flags this particular build advertises. Returns '' on any failure (the
+ * caller then sends no silent flag and stays alive instead of crash-looping).
+ */
+export async function probeReverseConnectHelp(launcher: AimuxLauncher): Promise<string> {
+  const base = launcher.kind === 'exe'
+    ? { cmd: launcher.path, args: ['reverse', 'connect', '--help'] }
+    : { cmd: launcher.python, args: ['-m', 'aimux', 'reverse', 'connect', '--help'] }
+  try {
+    const r = await run(base.cmd, base.args)
+    return `${r.stdout}\n${r.stderr}`
+  } catch {
+    return ''
+  }
+}
+
+/**
+ * Pick the strongest console-hiding flag aimux advertised for Windows. Prefers
+ * the correctly-spelled --silent-v2 (future-proof if the historical --slient-v2
+ * typo alias is ever dropped), then the --slient-v2 alias, then --silent-shell.
+ * Returns null off-Windows or when the installed aimux supports none.
+ */
+export function pickSilentFlag(helpText: string, platform: NodeJS.Platform = process.platform): string | null {
+  if (platform !== 'win32') return null
+  if (/--silent-v2\b/.test(helpText)) return '--silent-v2'
+  if (/--slient-v2\b/.test(helpText)) return '--slient-v2'
+  if (/--silent-shell\b/.test(helpText)) return '--silent-shell'
+  return null
+}
+
 export async function probeAimuxBridgeConnection(
   server: string,
   token: string,
@@ -513,6 +553,10 @@ export class AimuxSupervisor {
 
 let supervisor: AimuxSupervisor | null = null
 let installing: Promise<void> | null = null
+// Resolved Windows console-hiding flag for the installed aimux (undefined =
+// not probed yet this process). Cached so reconnects reuse it without re-running
+// `aimux reverse connect --help`. See reverseConnectArgs for why this is probed.
+let cachedSilentFlag: string | null | undefined = undefined
 
 export async function startAimuxConnection(opts: { server: string; token: string; onStatus?: (s: AimuxStatus) => void }): Promise<void> {
   const onStatus = opts.onStatus ?? (() => {})
@@ -534,9 +578,18 @@ export async function startAimuxConnection(opts: { server: string; token: string
     if (!ready.ok || !ready.launcher) { logInstall(`startAimuxConnection giving up: ${ready.error}\n`); onStatus({ state: 'failed', phase: 'idle', detail: `${ready.error} · 日志: ${aimuxLogPath()}` }); return }
     const identifier = tuiAimuxIdentifier()
     const launcher = ready.launcher
+    // Windows only: ask the installed aimux which console-hiding flag it accepts
+    // before spawning, so a version mismatch (older PyPI/bundle aimux without
+    // --slient-v2) can't crash-loop the supervisor with "No such option".
+    if (WIN && cachedSilentFlag === undefined) {
+      const help = await probeReverseConnectHelp(launcher)
+      cachedSilentFlag = pickSilentFlag(help)
+      logInstall(`reverse-connect silent flag probe → ${cachedSilentFlag ?? '(none supported; sending no flag)'}\n`)
+    }
+    const silentFlag = cachedSilentFlag
     supervisor = new AimuxSupervisor({
       server: opts.server, token: opts.token, identifier, onStatus,
-      spawnProcess: () => spawnLauncher(launcher, reverseConnectArgs(opts.server, identifier, opts.token)),
+      spawnProcess: () => spawnLauncher(launcher, reverseConnectArgs(opts.server, identifier, opts.token, process.platform, silentFlag)),
     })
     supervisor.start()
   })().finally(() => { installing = null })

package/src/components/Chat.tsx

@@ -24,11 +24,12 @@ import {
 import type { ReadyState } from './PrepScreen.js'
 import type { AnyEntry } from '../types.js'
 import { ConfigFlow, ReconfigFlow, type ConfigResult } from './ConfigFlow.js'
-import type { AimuxStatus } from '../aimux.js'
+import { AIMUX_VERSION, type AimuxStatus } from '../aimux.js'
 import { AimuxStatusLine, aimuxStatusText } from './AimuxStatus.js'
 import { isEscapeKeypress, isMouseInput, useMouseEvents, useStableInput } from './primitives.js'
 import { useDeleteKeyCapture, applyDeleteIntent, clampCursor, previousCursorBoundary, nextCursorBoundary, previousWordBoundary, nextWordBoundary } from '../lib/delete-keys.js'
 import { useCursorKeyCapture } from '../lib/cursor-keys.js'
+import { usePaintFlushOnInput } from '../lib/paint-flush.js'
 
 interface ChatProps {
   client: MobiusClient
@@ -56,11 +57,13 @@ const STATUS_ROWS = 3
 
 const SLASH_COMMANDS = [
   { cmd: '/clear', desc: '清空当前对话，开启新会话' },
+  { cmd: '/compact', desc: '压缩当前会话上下文' },
   { cmd: '/resume', desc: '恢复一个历史会话' },
   { cmd: '/model', desc: '更换模型并开启新会话（保留当前任务）' },
   { cmd: '/config', desc: '重新选择项目、任务和模型' },
   { cmd: '/logout', desc: '断开当前连接并返回登录界面' },
   { cmd: '/help', desc: '显示帮助' },
+  { cmd: '/version', desc: '显示 TUI、AIMUX 和运行环境版本' },
   { cmd: '/quit', desc: '退出 TUI' },
 ]
 
@@ -74,6 +77,9 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
   const [modelLabel, setModelLabel] = useState<string | null>(null)
   const [configOpen, setConfigOpen] = useState(false)
   const [reconfigOpen, setReconfigOpen] = useState(false)
+  // 本地命令错误 (如无会话时 /compact): 与 chat.error 分开, 下一次提交时清除。
+  const [slashError, setSlashError] = useState<string | null>(null)
+  const [versionInfo, setVersionInfo] = useState<string[] | null>(null)
   // Ink may deliver one final event to Composer while an async config picker is
   // replacing it. The shared ref lets that stale listener report "not handled"
   // so App can replay the key after the new Select mounts.
@@ -85,29 +91,61 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
   const handlerRef = useRef<{ configOpen: boolean; reconfigOpen: boolean; sessionId: string | null }>({ configOpen: false, reconfigOpen: false, sessionId: null })
   handlerRef.current = { configOpen, reconfigOpen, sessionId: chat.sessionId }
   const terminal = useTerminalSize()
+  // Paint each keystroke immediately instead of waiting out Ink's 32ms render
+  // throttle — that dead window was the typing lag users felt.
+  usePaintFlushOnInput()
 
   const runSlash = useCallback((raw: string) => {
     const [name] = raw.trim().split(/\s+/)
     switch (name) {
       case '/clear': onClear(); return true
+      case '/compact': {
+        // 对齐 web sendCompactCommand: 把字面 '/compact' 作为消息发给后端, 由
+        // agent (claude-code 原生 slash command / codex) 自行执行上下文压缩。
+        // 尚无会话时没有可压缩的上文, 提示而不是新建空会话去发。
+        if (!chat.sessionId) {
+          setSlashError('当前没有可发送指令的会话')
+          return true
+        }
+        setShowHelp(false)
+        setRowAnchor(null)
+        void chat.send('/compact')
+        return true
+      }
       case '/resume': onResume(); return true
       case '/help': setShowHelp(s => !s); return true
+      case '/version': {
+        const details = [
+          `TUI       v${TUI_VERSION}`,
+          `AIMUX     v${aimuxStatus?.version ?? AIMUX_VERSION}`,
+          `Node      ${process.version}`,
+          `平台      ${process.platform}/${process.arch}`,
+          `服务器    ${client.server}`,
+          `模型      ${modelLabel ?? ready.prefs.model ?? 'default'}`,
+          `AIMUX状态 ${aimuxStatus ? aimuxStatusText(aimuxStatus, true) : '未知'}`,
+        ]
+        setVersionInfo(details)
+        setShowHelp(false)
+        return true
+      }
       case '/model': setConfigOpen(true); return true
       case '/config': setReconfigOpen(true); return true
       case '/logout': onLogout(); return true
       case '/quit': case '/exit': onQuit(); return true
       default: return false
     }
-  }, [onClear, onResume, onQuit, onLogout])
+  }, [aimuxStatus, chat, client.server, modelLabel, ready.prefs.model, onClear, onResume, onQuit, onLogout])
 
   const onSubmit = useCallback((text: string) => {
     const t = text.trim()
     if (!t) return
+    setSlashError(null)
     if (t.startsWith('/')) {
       if (!runSlash(t)) setShowHelp(true)
       return
     }
     setShowHelp(false)
+    setVersionInfo(null)
     setRowAnchor(null)
     void chat.send(t)
   }, [chat, runSlash])
@@ -160,7 +198,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
     (entry) => rowsForEntry(entry),
   ), [transcriptEntries, rowsForEntry])
   const viewportRows = terminal.isTty ? Math.max(9, terminal.rows - 1) : terminal.rows
-  const activityRows = (chat.typing ? 2 : 0) + (chat.error ? 1 : 0)
+  const activityRows = (chat.typing ? 2 : 0) + (chat.error ? 1 : 0) + (slashError ? 1 : 0) + (versionInfo ? versionInfo.length + 2 : 0)
   const helpRows = showHelp ? SLASH_COMMANDS.length + 3 : 0
   // Conversation chrome is exactly two rows: compact header + navigation.
   const transcriptRows = Math.max(1, viewportRows - composerRows - STATUS_ROWS - activityRows - helpRows - 2)
@@ -214,9 +252,10 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
     else if (key.pageDown) scrollRows(pageRows)
   }, { interactive: false })
 
-  const navigationHint = viewport.hasOlder
-    ? `${viewport.hasNewer ? '↑ 较早内容 · ↓ 较新内容' : '↑ 还有较早内容'} · 滚轮 3 行 · PageUp/PageDown ${pageRows} 行 · 拖动选中文本`
-    : `${viewport.hasNewer ? '已到最早 · ↓ 还有较新内容' : '全部内容'} · 滚轮 3 行 · PageUp/PageDown ${pageRows} 行 · 拖动选中文本`
+  const navigationPosition = viewport.hasOlder
+    ? (viewport.hasNewer ? '↑ 较早内容 · ' : '↑ 还有较早内容')
+    : (viewport.hasNewer ? '已到最早 · ' : '全部内容')
+  const navigationDetail = ` · 滚轮 3 行 · PageUp/PageDown ${pageRows} 行 · 拖动选中文本`
 
   // Mouse: wheel pages through history in small fixed steps, and a left-button
   // drag selects transcript text (tmux-style: the app owns the mouse, draws its
@@ -335,7 +374,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
           : <CompactHeader ready={ready} sessionId={chat.sessionId} columns={terminal.columns} />}
 
         {!showWelcome
-          ? <Box width="100%" flexShrink={0}><Text dimColor wrap="truncate-end">  {navigationHint}</Text></Box>
+          ? <Box width="100%" flexShrink={0}><Text dimColor wrap="truncate-end">  {navigationPosition}{viewport.hasNewer ? <Text color="yellowBright">↓ 有新内容</Text> : null}{navigationDetail}</Text></Box>
           : null}
 
         <Box
@@ -365,6 +404,8 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
       <Box flexDirection="column" flexShrink={0}>
         {chat.typing ? <WorkingIndicator firstQuery={firstQueryInFlight} /> : null}
         {chat.error ? <Text color="red">⚠ {chat.error}</Text> : null}
+        {slashError ? <Text color="red">⚠ {slashError}</Text> : null}
+        {versionInfo ? <VersionBlock lines={versionInfo} /> : null}
 
         <Composer
           onSubmit={onSubmit}
@@ -557,6 +598,15 @@ function HelpBlock({ commands }: { commands: { cmd: string; desc: string }[] })
   )
 }
 
+function VersionBlock({ lines }: { lines: string[] }) {
+  return (
+    <Box flexDirection="column" borderStyle="round" borderColor="gray" borderDimColor paddingX={1} marginTop={1}>
+      <Text bold color="cyan">Mobius 版本信息</Text>
+      {lines.map(line => <Text key={line} dimColor>{line}</Text>)}
+    </Box>
+  )
+}
+
 interface ComposerProps {
   onSubmit: (text: string) => void
   onStop: () => void
@@ -574,6 +624,11 @@ export function Composer({ onSubmit, onStop, onQuit, typing, commands, onHeightC
   const [popupDismissed, setPopupDismissed] = useState(false)
   const historyRef = useRef<string[]>([])
   const [histIdx, setHistIdx] = useState<number | null>(null)
+  // Idle Ctrl+C quits, but a single accidental press must not kill the session:
+  // the first press arms a 2s confirmation window, the second press exits.
+  const [confirmQuit, setConfirmQuit] = useState(false)
+  const confirmQuitRef = useRef(false)
+  const confirmQuitTimer = useRef<ReturnType<typeof setTimeout> | null>(null)
   const valueRef = useRef(value)
   const cursorRef = useRef(cursor)
   const pasteRef = useRef<ComposerPasteState>({
@@ -587,6 +642,8 @@ export function Composer({ onSubmit, onStop, onQuit, typing, commands, onHeightC
   })
   const { stdout } = useStdout()
 
+  useEffect(() => () => { if (confirmQuitTimer.current) clearTimeout(confirmQuitTimer.current) }, [])
+
   // Physical Backspace/Delete keys are owned by useDeleteKeyCapture from the
   // raw stdin bytes — Ink reports the Backspace key (\x7f) and the Delete key
   // (ESC[3~) both as `key.delete`, so handling `key.delete` in useInput would
@@ -784,7 +841,19 @@ export function Composer({ onSubmit, onStop, onQuit, typing, commands, onHeightC
       }
       return
     }
-    if (key.ctrl && input === 'c') { typing ? void onStop() : onQuit(); return }
+    if (key.ctrl && input === 'c') {
+      if (typing) { void onStop(); return }
+      // Idle Ctrl+C exits, but guard against an accidental single press.
+      if (confirmQuitRef.current) { onQuit(); return }
+      confirmQuitRef.current = true
+      setConfirmQuit(true)
+      if (confirmQuitTimer.current) clearTimeout(confirmQuitTimer.current)
+      confirmQuitTimer.current = setTimeout(() => {
+        confirmQuitRef.current = false
+        setConfirmQuit(false)
+      }, 2000)
+      return
+    }
     // Physical Backspace/Delete keys are handled by useDeleteKeyCapture above
     // (raw stdin bytes distinguish them; Ink maps both to `key.delete`). Only
     // the unambiguous logical editing bindings stay here.
@@ -899,7 +968,9 @@ export function Composer({ onSubmit, onStop, onQuit, typing, commands, onHeightC
           })}
         </Box>
         <Box justifyContent="space-between">
-          <Text dimColor>{(stdout.columns ?? 80) >= 72 ? 'Enter 发送 · Shift+Enter / Alt+Enter / Ctrl+J 换行' : 'Enter 发送 · Alt+Enter / Ctrl+J 换行'}</Text>
+          {confirmQuit
+            ? <Text color="yellowBright" bold>请再次按下Ctrl+C退出</Text>
+            : <Text dimColor>{(stdout.columns ?? 80) >= 72 ? 'Enter 发送 · Shift+Enter / Alt+Enter / Ctrl+J 换行' : 'Enter 发送 · Alt+Enter / Ctrl+J 换行'}</Text>}
           <Text dimColor>{wrapped.length > maxRows ? `${visualCursor + 1}/${wrapped.length} 行` : `${wrapped.length} 行`}</Text>
         </Box>
       </Box>

package/src/lib/entry-view.ts

@@ -87,6 +87,31 @@ function entryUserText(entry: AnyEntry): string {
 
 const ENV_CONTEXT_RE = /<environment_context\b[^>]*>[\s\S]*?<\/environment_context>/gi
 
+// ── Claude Code 本地命令产物标签 (/compact 等) ─────────────────────────────
+// slash command 在 claude-code jsonl 里以 user 外壳 + 下列标签出现, 不是人类提问:
+//   <command-name>/compact</command-name> 等   命令回显 (噪声)
+//   <local-command-caveat>…</local-command-caveat>   "由本地命令产生" 提示 (噪声)
+//   <local-command-stdout>Compacted …</local-command-stdout>   命令输出 (压缩完成信号)
+// 对齐 web entry-extract.ts 的 extractLocalCommandParts (精简版), 渲染时不能把
+// 标签原文当用户消息显示.
+const LOCAL_COMMAND_TAG_PATTERN = /<(local-command-stdout|local-command-caveat|command-name|command-message|command-args)>\s*([\s\S]*?)<\/\1>/gi
+
+interface LocalCommandPart { tag: string; body: string }
+
+function extractLocalCommandParts(entry: AnyEntry): LocalCommandPart[] {
+  if (entry?.type !== 'user') return []
+  const text = entryUserText(entry)
+  if (!text || !text.includes('<')) return []
+  const parts: LocalCommandPart[] = []
+  LOCAL_COMMAND_TAG_PATTERN.lastIndex = 0
+  let m: RegExpExecArray | null
+  while ((m = LOCAL_COMMAND_TAG_PATTERN.exec(text))) {
+    const body = m[2].replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '').trim()
+    parts.push({ tag: m[1].toLowerCase(), body })
+  }
+  return parts
+}
+
 /**
  * 整卡隐藏的噪声: 对齐 web entry-classify.ts isHiddenJsonlNoiseEntry 的 7 类
  *   - token_count         : codex 每轮 token 用量统计 (event_msg)
@@ -558,6 +583,21 @@ export function viewsForBlock(block: Block): EntryView[] {
       }
       return out
     }
+    // Claude Code 本地命令产物 (/compact 等): 命令回显/caveat 标签是噪声 → 整条
+    // 隐藏; local-command-stdout 渲染成 system 行, "Compacted …" 对齐 codex 的
+    // context_compacted 事件显示 "◇ 上下文已压缩"。
+    const localParts = extractLocalCommandParts(entry)
+    if (localParts.length > 0) {
+      const out: EntryView[] = []
+      for (const part of localParts) {
+        if (part.tag !== 'local-command-stdout' || !part.body) continue
+        const text = /^compacted\b/i.test(part.body)
+          ? `◇ 上下文已压缩 · ${part.body}`
+          : part.body
+        out.push({ kind: 'system', text: truncate(text, 160) })
+      }
+      return out.length ? out : [{ kind: 'skip' }]
+    }
     const text = entryUserText(entry)
     return text ? [{ kind: 'user', text: stripUserFraming(text) }] : [{ kind: 'skip' }]
   }

package/src/lib/paint-flush.ts

@@ -0,0 +1,223 @@
+/**
+ * Typing-latency optimizations against Ink 5.2's fixed render pipeline.
+ *
+ * Profiling a keystroke loop (node --cpu-prof) showed ~40% of typing time
+ * inside Ink's per-paint `Output.get()`:
+ *   stringWidth 13.5% + styledCharsFromTokens 12.4% + Output.get 6.4%
+ *   + styledCharsToString 5.5% + diffAnsiCodes 3.4%
+ *
+ * Every paint rebuilds the whole frame: for each write-op line it applies
+ * style transformers, tokenizes the ANSI-styled text into styled chars and
+ * re-measures widths, then walks the full cell matrix back to a string.
+ * While typing, 19 of 22 line strings are byte-identical across paints (only
+ * the composer row changes), yet all are re-tokenized every time — that
+ * repetition is the lag users feel.
+ *
+ * Two runtime patches below. Both verify Ink internals first and silently
+ * no-op on mismatch (or when MOBIUS_TUI_DISABLE_PAINT_FLUSH=1):
+ *
+ * 1. usePaintFlushOnInput — Ink hardcodes `throttle(onRender, 32ms)`. React
+ *    commits a key in <1ms; the paint can then wait out the throttle window.
+ *    On each editing key we call the throttle's `flush()` right after the
+ *    commit lands, so the frame paints in the same event-loop turn.
+ *
+ * 2. installStyledLineCache — replaces `Output.prototype.get` with a faithful
+ *    reimplementation whose only difference is memoizing
+ *    `styledCharsFromTokens(tokenize(line))` by the post-transform line
+ *    string (the exact input tokenize receives, so cached results are
+ *    byte-identical). Unchanged lines skip the tokenize+measure hot path,
+ *    which is where the profiled ~40% lives.
+ */
+
+import { useEffect } from 'react'
+import { useStdin, useStdout } from 'ink'
+
+// ── 1. flush the render throttle right after each editing key ────────────────
+
+type Flushable = { flush?: () => void }
+
+/** Text-editing inputs that should paint immediately (typed text, Enter, backspace). */
+function isEditingInput(input: string): boolean {
+  if (!input) return false
+  if (input === '\r' || input === '\n') return true
+  if (input === '\x7f' || input === '\x08') return true
+  // Anything without an ESC lead is typed text (or a paste chunk). Sequences
+  // (arrows, mouse, bracketed paste) start with ESC and keep normal pacing.
+  return !input.startsWith('\x1b')
+}
+
+export function usePaintFlushOnInput(): void {
+  const { internal_eventEmitter } = useStdin()
+  const { stdout } = useStdout()
+
+  useEffect(() => {
+    if (process.env.MOBIUS_TUI_DISABLE_PAINT_FLUSH === '1') return
+    if (!internal_eventEmitter) return
+    installStyledLineCache()
+    const handler = (chunk: unknown) => {
+      if (!isEditingInput(String(chunk))) return
+      // React schedules the commit for this key on a setImmediate (scheduler's
+      // Immediate priority). Flushing on a microtask would paint the STALE
+      // frame before that commit lands. Schedule the flush for after the
+      // commit: another setImmediate queued from here runs after the one
+      // React already queued (FIFO within the same iteration).
+      setImmediate(() => {
+        try { getThrottledRender(stdout)?.flush?.() } catch { /* best-effort */ }
+      })
+    }
+    internal_eventEmitter.on('input', handler)
+    return () => { internal_eventEmitter.off('input', handler) }
+  }, [internal_eventEmitter, stdout])
+}
+
+// ── Ink internals access ─────────────────────────────────────────────────────
+// Ink's exports map blocks subpath imports ('ink/build/instances.js' →
+// ERR_PACKAGE_PATH_NOT_EXPORTED), but `import.meta.resolve('ink')` yields the
+// package entry file URL and the internal modules live next to it in the same
+// build directory. Resolving relative to the entry keeps this working in any
+// install layout (local node_modules, global npm prefix).
+
+function inkModuleUrl(name: string): string {
+  return new URL(name, new URL('.', (import.meta as any).resolve('ink') as string)).href
+}
+
+let cachedInstances: WeakMap<object, any> | null | undefined
+
+function getThrottledRender(stdout: object): Flushable | null {
+  if (cachedInstances === undefined) {
+    cachedInstances = null
+    void import(inkModuleUrl("instances.js"))
+      .then(mod => { cachedInstances = mod.default })
+      .catch(() => { /* keep null */ })
+  }
+  try {
+    return cachedInstances?.get(stdout)?.rootNode?.onRender ?? null
+  } catch {
+    return null
+  }
+}
+
+// ── 2. memoize styled-line tokenization across paints ────────────────────────
+
+let cacheInstalled = false
+
+export function installStyledLineCache(): void {
+  if (cacheInstalled || process.env.MOBIUS_TUI_DISABLE_PAINT_FLUSH === '1') return
+  cacheInstalled = true
+  void (async () => {
+    try {
+      const [outputMod, at, widestLineMod, stringWidthMod, sliceAnsiMod]: any[] = await Promise.all([
+        import(inkModuleUrl("output.js")),
+        import('@alcalzone/ansi-tokenize'),
+        import('widest-line'),
+        import('string-width'),
+        import('slice-ansi'),
+      ])
+      const OutputClass = outputMod.default
+      const proto = OutputClass?.prototype
+      if (!proto || typeof proto.get !== 'function' || typeof proto.write !== 'function') return
+      if (typeof at.styledCharsFromTokens !== 'function' || typeof at.tokenize !== 'function') return
+      const widestLine = widestLineMod.default
+      const stringWidth = stringWidthMod.default
+      const sliceAnsi = sliceAnsiMod.default
+
+      // Fragile-internals guard: confirm the op shape this Ink version writes.
+      const probe = new OutputClass({ width: 4, height: 2 })
+      probe.write(0, 0, 'ab', { transformers: [] })
+      const op = probe.operations?.[0]
+      if (!op || op.type !== 'write' || typeof op.text !== 'string' || !Array.isArray(op.transformers)) return
+
+      const cache = new Map<string, any[]>()
+      const styledCharsOf = (line: string): any[] => {
+        const hit = cache.get(line)
+        if (hit) return hit
+        const chars = at.styledCharsFromTokens(at.tokenize(line)) as any[]
+        if (cache.size >= 4096) cache.clear() // bound memory; rebuilt lazily
+        cache.set(line, chars)
+        return chars
+      }
+
+      const origGet = proto.get
+      proto.get = function (this: any) {
+        // Faithful reimplementation of Ink 5.2.0 Output.get with one change:
+        // the tokenize+styledCharsFromTokens result is memoized by the
+        // post-transform line string. Everything else mirrors upstream.
+        const output = []
+        for (let y = 0; y < this.height; y++) {
+          const row = []
+          for (let x = 0; x < this.width; x++) {
+            row.push({ type: 'char', value: ' ', fullWidth: false, styles: [] })
+          }
+          output.push(row)
+        }
+        const clips: any[] = []
+        for (const operation of this.operations) {
+          if (operation.type === 'clip') clips.push(operation.clip)
+          if (operation.type === 'unclip') clips.pop()
+          if (operation.type !== 'write') continue
+          const { text, transformers } = operation
+          let { x, y } = operation
+          let lines = text.split('\n')
+          const clip = clips.at(-1)
+          if (clip) {
+            const clipHorizontally = typeof clip?.x1 === 'number' && typeof clip?.x2 === 'number'
+            const clipVertically = typeof clip?.y1 === 'number' && typeof clip?.y2 === 'number'
+            if (clipHorizontally) {
+              const width = widestLine(text)
+              if (x + width < clip.x1 || x > clip.x2) continue
+            }
+            if (clipVertically) {
+              const height = lines.length
+              if (y + height < clip.y1 || y > clip.y2) continue
+            }
+            if (clipHorizontally) {
+              lines = lines.map((line: string) => {
+                const from = x < clip.x1 ? clip.x1 - x : 0
+                const width = stringWidth(line)
+                const to = x + width > clip.x2 ? clip.x2 - x : width
+                return sliceAnsi(line, from, to)
+              })
+              if (x < clip.x1) x = clip.x1
+            }
+            if (clipVertically) {
+              const from = y < clip.y1 ? clip.y1 - y : 0
+              const height = lines.length
+              const to = y + height > clip.y2 ? clip.y2 - y : height
+              lines = lines.slice(from, to)
+              if (y < clip.y1) y = clip.y1
+            }
+          }
+          let offsetY = 0
+          for (const [index, line0] of lines.entries()) {
+            const currentLine = output[y + offsetY]
+            if (!currentLine) continue
+            let line = line0
+            for (const transformer of transformers) line = transformer(line, index)
+            const characters = styledCharsOf(line)
+            let offsetX = x
+            for (const character of characters) {
+              currentLine[offsetX] = character
+              const isWideCharacter = character.fullWidth || character.value.length > 1
+              if (isWideCharacter) {
+                currentLine[offsetX + 1] = {
+                  type: 'char', value: '', fullWidth: false, styles: character.styles,
+                }
+              }
+              offsetX += isWideCharacter ? 2 : 1
+            }
+            offsetY++
+          }
+        }
+        const generatedOutput = output
+          .map(line => {
+            const lineWithoutEmptyItems = line.filter((item: unknown) => item !== undefined)
+            return at.styledCharsToString(lineWithoutEmptyItems).trimEnd()
+          })
+          .join('\n')
+        return { output: generatedOutput, height: output.length }
+      }
+      // Keep a handle for tests/debugging; origGet unused beyond the guard.
+      void origGet
+    } catch { /* keep stock behavior */ }
+  })()
+}