@mobius-os/mobius 0.3.42 → 0.3.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobius-os/mobius",
-  "version": "0.3.42",
+  "version": "0.3.45",
   "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.29'
+/** 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')

package/src/api.ts

@@ -6,7 +6,9 @@
  * bearer token (header `Authorization: Bearer <jwt>`); there is no cookie auth.
  */
 import type {
+  AnyEntry,
   AuthConfig,
+  HistoryGroup,
   Issue,
   LoginResponse,
   Memory,
@@ -160,6 +162,17 @@ export class MobiusClient {
     return this.request<SessionRuntimeStatus>(`/api/sessions/${encodeURIComponent(sessionId)}/status`, { signal })
   }
 
+  // ── agent-history (协议 ①②: 组元数据 + 整组条目) ──────────────────────────
+  /** ① 全部组元数据, 一次给全. */
+  async listHistoryGroups(sessionId: string): Promise<{ session_version: number; groups: HistoryGroup[] }> {
+    return this.request(`/api/sessions/${encodeURIComponent(sessionId)}/groups`)
+  }
+
+  /** ② 某组全部条目 (全量, 无分页, 条目不可变). */
+  async listHistoryGroupEntries(sessionId: string, groupId: string): Promise<{ group_id: string; version: number; entries: AnyEntry[] }> {
+    return this.request(`/api/sessions/${encodeURIComponent(sessionId)}/groups/${encodeURIComponent(groupId)}/entries`)
+  }
+
   // ── preference lookups ────────────────────────────────────────────────────
   async modelOptions(): Promise<SessionModelOption[]> {
     const r = await this.request<any>('/api/sessions/model-options')

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
@@ -62,6 +63,7 @@ const SLASH_COMMANDS = [
   { cmd: '/config', desc: '重新选择项目、任务和模型' },
   { cmd: '/logout', desc: '断开当前连接并返回登录界面' },
   { cmd: '/help', desc: '显示帮助' },
+  { cmd: '/version', desc: '显示 TUI、AIMUX 和运行环境版本' },
   { cmd: '/quit', desc: '退出 TUI' },
 ]
 
@@ -77,6 +79,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
   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.
@@ -88,6 +91,9 @@ 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+/)
@@ -108,13 +114,27 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
       }
       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
     }
-  }, [chat, 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()
@@ -125,14 +145,14 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
       return
     }
     setShowHelp(false)
+    setVersionInfo(null)
     setRowAnchor(null)
     void chat.send(t)
   }, [chat, runSlash])
 
   // First query of a fresh session triggers the full backend bootstrap (lazy
   // session creation, worker spawn, context load) before any output streams.
-  // Label that phase "第一个问题，正在初始化+全平台同步中，请稍候" instead of "Working"
-  // so it reads as startup rather than a stuck agent. Once the first assistant
+  // Label that phase as startup rather than a stuck agent. Once the first assistant
   // output is observed (or the session is a resumed one with prior history),
   // the indicator falls back to the normal Working label for every turn.
   const firstQueryInFlight = !resumeSessionId && !chat.entries.some(isAssistantOutput)
@@ -177,7 +197,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) + (slashError ? 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)
@@ -384,6 +404,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
         {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}
@@ -576,6 +597,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

package/src/hooks/useChat.ts

@@ -4,11 +4,14 @@
  * Lifecycle (per the TUI spec):
  *   - lazily create a session (POST /api/issues/:issueId/sessions) on the first
  *     submitted message, using the saved preferences;
- *   - open the SSE stream (GET /api/sessions/:id/events?token=) and append
- *     `jsonl_entry` payloads to the transcript as they arrive;
+ *   - open the SSE stream (GET /api/sessions/:id/events?token=); on subscribe
+ *     bootstrap the transcript via ① groups + ② tail-group entries, then apply
+ *     live `entries` batches (watermark + uuid dedup) as they arrive;
+ *   - reconnects re-run the same ① negotiation (stateless reconciliation):
+ *     groups whose version changed are refetched whole, transcript rebuilt;
  *   - keep the agent's busy state synchronized with the runtime status API.
  * `/clear` remounts the hook (fresh session next time); `/resume` injects a
- * pre-existing sessionId so the stream replays its history.
+ * pre-existing sessionId.
  */
 import { useCallback, useEffect, useRef, useState } from 'react'
 import { MobiusClient, ApiError } from '../api.js'
@@ -42,7 +45,7 @@ function nextId(): number { ID += 1; return ID }
 /**
  * Does this entry represent the user's just-submitted message? Used to retire the
  * optimistic `pendingUser` placeholder once the real entry is observed — including
- * via a reconnect's history replay (the live `jsonl_entry` path already clears it).
+ * via a reconnect's history reconciliation (the live `entries` path already clears it).
  *
  * Mobius may prepend injected context (project/issue framing) to a user turn, so we
  * match the typed text as a suffix of the entry's normalized text rather than
@@ -66,6 +69,22 @@ function entryKey(entry: AnyEntry): string | null {
   return typeof entry?.uuid === 'string' ? entry.uuid : null
 }
 
+// 首次 bootstrap 拉取的末尾组数 (旧 SSE 尾部回放的等价物; 更早的组按需不拉,
+// TUI 是平铺字幕, 没有轮次展开概念, 末尾几组已覆盖活跃对话).
+const BOOTSTRAP_GROUP_COUNT = 3
+// A fresh session can spend several seconds creating the worker and loading
+// context before /status reports alive=true. Keep the first-turn indicator
+// visible during that bootstrap window instead of letting the short generic
+// hint expire and leaving the user with no feedback.
+const FIRST_TURN_BOOTSTRAP_GRACE_MS = 30_000
+
+/** Mini group store: 组序 + 水位线 (version) + 组内条目. */
+interface GroupSlot {
+  seq: number
+  version: number
+  entries: AnyEntry[]
+}
+
 // Retry transient gateway/transport errors so a brief 502/503/504 (a reverse-
 // proxy blip, a backend worker recycling after a deploy, a transient upstream
 // failure) doesn't immediately fail a message dispatch. 4xx errors are not
@@ -95,6 +114,8 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
   const [sending, setSending] = useState(false)
   const [error, setError] = useState<string | null>(null)
   const sseRef = useRef<SseConnection | null>(null)
+  // agent-history mini group store (协议 ①②③ 的 TUI 侧消费形态).
+  const groupSlotsRef = useRef<Map<string, GroupSlot>>(new Map())
   const pollNowRef = useRef<(() => void) | null>(null)
   const typingRef = useRef(false)
   const sendingRef = useRef(false)
@@ -103,7 +124,7 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
   // SSE auto-reconnect state. A reverse proxy's idle timeout (or a server
   // restart) drops the stream mid-session; without reconnect the TUI stops
   // receiving new jsonl entries even though the web client keeps updating.
-  // On reconnect the server replays jsonl_history, so no entries are lost.
+  // On reconnect the stateless ①② reconciliation refills any missed entries.
   const reconnectTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null)
   const reconnectAttemptRef = useRef(0)
   const aliveRef = useRef(true)
@@ -119,7 +140,7 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
   const appendEntries = useCallback((newOnes: AnyEntry[]) => {
     if (!newOnes.length) return
     setEntries(prev => {
-      // De-duplicate by uuid so a live jsonl_entry that also appears in a
+      // De-duplicate by uuid so a live `entries` batch that also appears in a
       // reconnect's history replay is never shown twice.
       const seen = new Set<string>()
       for (const e of prev) { const k = entryKey(e); if (k) seen.add(k) }
@@ -145,6 +166,63 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
     setEntries(out)
   }, [])
 
+  // ── agent-history (协议 ①②③): bootstrap / 重连对账 ──────────────────────
+
+  /** 按组序摊平重建 transcript (uuid 去重由 setHistory 兜底). */
+  const rebuildEntriesFromGroups = useCallback(() => {
+    const slots = [...groupSlotsRef.current.values()].sort((a, b) => a.seq - b.seq)
+    const flat: AnyEntry[] = []
+    for (const s of slots) flat.push(...s.entries)
+    setHistory(flat)
+  }, [setHistory])
+
+  /**
+   * Stateless 对账 (订阅时/重连时同一条路径):
+   *   ① 拿全部组元数据 → 本地没有的或 version 变了的组 ② 整组重拉 → 重建 transcript.
+   * 首次 (本地空) 只拉末尾 BOOTSTRAP_GROUP_COUNT 组; 之后每次只补差额, 常态零请求.
+   */
+  const reconcileHistory = useCallback(async (sid: string) => {
+    try {
+      const data = await client.listHistoryGroups(sid)
+      const groups: any[] = Array.isArray(data?.groups) ? data.groups : []
+      const local = groupSlotsRef.current
+      const targets = local.size === 0 ? groups.slice(-BOOTSTRAP_GROUP_COUNT) : groups
+      let changed = false
+      for (const g of targets) {
+        const gid = String(g?.id ?? '')
+        if (!gid) continue
+        const ver = Number(g?.version) || 0
+        const cur = local.get(gid)
+        if (cur && cur.version >= ver) continue
+        try {
+          const r = await client.listHistoryGroupEntries(sid, gid)
+          local.set(gid, {
+            seq: Number(g?.seq) || (local.size + 1),
+            version: Number(r?.version) || 0,
+            entries: Array.isArray(r?.entries) ? r.entries : [],
+          })
+          changed = true
+        } catch { /* 单组失败不阻塞其余组 */ }
+      }
+      // 服务端已不存在的组 → 丢弃 (会话被删/重建的防御).
+      const alive = new Set(groups.map((g: any) => String(g?.id ?? '')))
+      for (const gid of [...local.keys()]) {
+        if (!alive.has(gid)) { local.delete(gid); changed = true }
+      }
+      if (changed) rebuildEntriesFromGroups()
+      // 对账补齐后, 若乐观占位已被真实条目覆盖 → 退掉 (断线期间整轮完成的场景).
+      setPendingUser(prev => {
+        if (prev === null) return prev
+        const slots = [...local.values()].sort((a, b) => a.seq - b.seq)
+        const flat: AnyEntry[] = []
+        for (const s of slots) flat.push(...s.entries)
+        return flat.some(e => entryMatchesPendingUser(e, prev)) ? null : prev
+      })
+    } catch (e) {
+      if (process.env.MOBIUS_TUI_DEBUG) console.error('[history-reconcile]', (e as Error)?.message ?? e)
+    }
+  }, [client, rebuildEntriesFromGroups])
+
   // ── SSE connection ────────────────────────────────────────────────────────
   const connect = useCallback((sid: string) => {
     if (process.env.MOBIUS_TUI_DEBUG) console.error('[connect]', sid)
@@ -153,23 +231,49 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
     if (reconnectTimerRef.current) { clearTimeout(reconnectTimerRef.current); reconnectTimerRef.current = null }
     const url = `${client.server}/api/sessions/${encodeURIComponent(sid)}/events?token=${encodeURIComponent(client.token)}`
     const conn = new SseConnection(url, {
-      onHistoryEntries: (es, _done) => {
-        if (es.length) setHistory(es)
-        // A reconnect replays the session tail. If our optimistic placeholder is
-        // now backed by its real entry, retire it so the user's input isn't shown
-        // twice (once as the entry, once as the placeholder). The live jsonl_entry
-        // path already clears pendingUser, but a dropped SSE stream (reverse-proxy
-        // idle timeout) can deliver the message only via this history replay — and
-        // if the whole turn finished while disconnected, no live entry ever comes
-        // to clear it, leaving the duplication on screen until the next send.
-        setPendingUser(prev => (prev !== null && es.some(e => entryMatchesPendingUser(e, prev)) ? null : prev))
+      onGroupCreated: (group) => {
+        if (!group || typeof group !== 'object') return
+        const gid = String(group.id ?? '')
+        if (!gid || groupSlotsRef.current.has(gid)) return  // 元数据不可变, 已知即忽略
+        groupSlotsRef.current.set(gid, {
+          seq: Number(group.seq) || (groupSlotsRef.current.size + 1),
+          version: Number(group.version) || 1,
+          entries: [],
+        })
       },
-      onEntry: (entry) => {
-        if (process.env.MOBIUS_TUI_DEBUG) console.error('[onEntry]', entry?.type, (entry?.message?.content?.[0]?.text ?? '').slice(0, 40))
-        appendEntries([entry])
-        setPendingUser(null)
+      onEntries: ({ group_id, group_id_version, entries }) => {
+        if (process.env.MOBIUS_TUI_DEBUG) console.error('[onEntries]', group_id, group_id_version, entries.length)
+        const gid = String(group_id ?? '')
+        if (!gid) return
+        let slot = groupSlotsRef.current.get(gid)
+        if (!slot) {
+          // 事件早到且本地无该组 (错过 group_created): 建槽后按水位线对账.
+          slot = { seq: groupSlotsRef.current.size + 1, version: 0, entries: [] }
+          groupSlotsRef.current.set(gid, slot)
+        }
+        const version = Number(group_id_version) || 0
+        if (slot.entries.length > 0 && version <= slot.version) return  // 水位线: ≤ 本地即丢弃
+        // uuid 去重保险丝: 与整组重拉/对账重叠的条目只留一份.
+        const known = new Set<string>()
+        for (const e of slot.entries) { const k = entryKey(e); if (k) known.add(k) }
+        const fresh = entries.filter(e => {
+          const k = entryKey(e)
+          if (k && known.has(k)) return false
+          if (k) known.add(k)
+          return true
+        })
+        slot.entries = slot.entries.concat(fresh)
+        slot.version = Math.max(slot.version, version)
+        if (fresh.length > 0) {
+          appendEntries(fresh)
+          setPendingUser(null)
+        }
+      },
+      onSubscribed: () => {
+        reconnectAttemptRef.current = 0
+        // 订阅即对账 (首开 = bootstrap 拉末尾几组; 重连 = stateless 补差额).
+        void reconcileHistory(sid)
       },
-      onSubscribed: () => { reconnectAttemptRef.current = 0 },
       onTyping: (active) => {
         // SSE is a low-latency hint, not the source of truth. A `true` event
         // lights the indicator immediately; either edge requests a fresh
@@ -179,7 +283,11 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
           workingHintUntilRef.current = Date.now() + 1_500
           updateTyping(true)
         } else {
-          workingHintUntilRef.current = 0
+          // A fresh turn uses a longer bootstrap grace period.  Some agents
+          // emit an early typing=false edge before their worker is observable;
+          // do not let that transient edge erase the first-turn indicator.
+          const remaining = workingHintUntilRef.current - Date.now()
+          if (remaining < 5_000) workingHintUntilRef.current = 0
         }
         pollNowRef.current?.()
       },
@@ -204,7 +312,7 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
     })
     sseRef.current = conn
     conn.start()
-  }, [client.server, client.token, appendEntries, setHistory, updateTyping])
+  }, [client.server, client.token, appendEntries, setHistory, updateTyping, reconcileHistory])
   doConnectRef.current = connect
 
   const ensureSseForSend = useCallback((sid: string): boolean => {
@@ -374,7 +482,8 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
     setError(null)
     setPendingUser(body)
     statusEpochRef.current += 1
-    workingHintUntilRef.current = Date.now() + 2_000
+    const firstTurn = !sessionId && entries.length === 0
+    workingHintUntilRef.current = Date.now() + (firstTurn ? FIRST_TURN_BOOTSTRAP_GRACE_MS : 2_000)
     sendingRef.current = true
     updateTyping(true)
     setSending(true)
@@ -400,7 +509,7 @@ export function useChat({ client, ready, resumeSessionId }: ChatApi): ChatContro
       setSending(false)
       pollNowRef.current?.()
     }
-  }, [sending, ensureSession, ensureSseForSend, client, updateTyping])
+  }, [sending, sessionId, entries.length, ensureSession, ensureSseForSend, client, updateTyping])
 
   const stop = useCallback(async () => {
     if (!sessionId) return