@kidsinai/kids-client 0.0.20 → 0.0.22

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@kidsinai/kids-client",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "type": "module",
   "description": "Own-client TUI for Kids OpenCode — talks to local `opencode serve` via @opencode-ai/sdk v2 with kid-warm rendering, mission progress, permission dialog, and stderr-tail audit pipeline.",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "react": "^18.3.1",
-    "@kidsinai/kids-opencode-plugin": "^0.0.20"
+    "@kidsinai/kids-opencode-plugin": "^0.0.22"
   },
   "devDependencies": {
     "@opencode-ai/sdk": "^1.14.51",

package/src/core/commands.ts

@@ -45,6 +45,9 @@ export const COMMANDS: KidCommand[] = [
   { id: "clear", slash: "/clear",
     label: { en: "Clear screen", zh: "清屏" },
     hint: { en: "Clear the chat (your files stay)", zh: "清空聊天记录（文件不动）" } },
+  { id: "compact", slash: "/compact",
+    label: { en: "Shrink this chat", zh: "压缩对话" },
+    hint: { en: "Summarise a long chat to save space", zh: "把很长的对话压缩一下,省空间" } },
   { id: "menu", slash: "/menu", aliases: ["/home"],
     label: { en: "Main menu", zh: "主菜单" },
     hint: { en: "Back to the start screen", zh: "回到开始界面" } },

package/src/core/files.ts

@@ -0,0 +1,41 @@
+/**
+ * Thin wrapper over the server's `find.files` for the `@file` mention
+ * autocomplete. Duck-typed + defensive (like models.ts): a missing endpoint or
+ * an error degrades to an empty list rather than crashing the input.
+ *
+ * Kid-safe: this only *lists* project file paths so the kid can name one. The
+ * AI reads it through the existing `read` tool (already on the kid whitelist) —
+ * we add no new capability here.
+ */
+
+import type { OpencodeClient } from "./connection.ts"
+
+const MAX_FILES = 8
+
+export async function findFiles(client: OpencodeClient, query: string, limit = MAX_FILES): Promise<string[]> {
+  const api = client as unknown as { find?: { files?: (params: unknown, options?: unknown) => Promise<unknown> } }
+  if (typeof api.find?.files !== "function") return []
+  try {
+    const raw = await api.find.files({ query: query || "", type: "file", limit })
+    return extractPaths(raw).slice(0, limit)
+  } catch {
+    return []
+  }
+}
+
+export function extractPaths(raw: unknown): string[] {
+  const arr = Array.isArray(raw)
+    ? raw
+    : raw && typeof raw === "object" && Array.isArray((raw as { data?: unknown }).data)
+      ? ((raw as { data: unknown[] }).data)
+      : []
+  const out: string[] = []
+  for (const item of arr) {
+    if (typeof item === "string") out.push(item)
+    else if (item && typeof item === "object") {
+      const p = (item as { path?: string; absolute?: string }).path ?? (item as { absolute?: string }).absolute
+      if (typeof p === "string") out.push(p)
+    }
+  }
+  return out
+}

package/src/core/session.ts

@@ -10,7 +10,7 @@
  */
 
 import type { OpencodeClient } from "./connection.ts"
-import type { SessionSummary } from "./store.ts"
+import type { SessionSummary, ChatMessage } from "./store.ts"
 import { debug } from "./debug.ts"
 
 /**
@@ -59,6 +59,33 @@ export class SessionManager {
     this.currentSessionId = sessionID
   }
 
+  /**
+   * Load a past session's transcript as ChatMessages (for `/sessions`
+   * rehydration) AND make it current. user → kid, assistant → agent (text parts
+   * joined); tool/reasoning/control messages are skipped. Defensive: an
+   * unavailable endpoint just yields an empty transcript.
+   */
+  async loadMessages(sessionID: string): Promise<ChatMessage[]> {
+    this.currentSessionId = sessionID
+    const api = (this.client as unknown as { session?: { messages?: (p: unknown) => Promise<unknown> } }).session
+    if (typeof api?.messages !== "function") return []
+    let raw: unknown
+    try {
+      raw = await api.messages({ sessionID, order: "asc", limit: 200 })
+    } catch {
+      return []
+    }
+    return unwrapItems(raw).map(mapServerMessage).filter((m): m is ChatMessage => m !== null)
+  }
+
+  /** Compress a long session server-side (the `/compact` command). */
+  async compact(): Promise<void> {
+    if (!this.currentSessionId) return
+    const api = (this.client as unknown as { session?: { compact?: (p: unknown, o?: unknown) => Promise<unknown> } }).session
+    if (typeof api?.compact !== "function") throw new Error("SDK: session.compact unavailable")
+    await api.compact({ sessionID: this.currentSessionId }, SDK_THROW)
+  }
+
   async create(): Promise<string> {
     const api = (this.client as unknown as { session?: { create: (input?: unknown, options?: unknown) => Promise<{ data?: { id?: string } } | { id?: string } | string> } }).session
     if (!api?.create) throw new Error("SDK v2: client.session.create unavailable")
@@ -134,6 +161,43 @@ function splitModelId(id: string | undefined): { providerID: string; modelID: st
   return { providerID: id.slice(0, slash), modelID: id.slice(slash + 1) }
 }
 
+/** session.messages returns `{ items }` or `{ data: { items } }`. */
+function unwrapItems(result: unknown): unknown[] {
+  if (result && typeof result === "object") {
+    const r = result as { items?: unknown; data?: { items?: unknown } }
+    if (Array.isArray(r.items)) return r.items
+    if (Array.isArray(r.data?.items)) return r.data!.items as unknown[]
+  }
+  return []
+}
+
+/** Map a server SessionMessage to our ChatMessage; null = skip (tool/control). */
+export function mapServerMessage(m: unknown): ChatMessage | null {
+  if (!m || typeof m !== "object") return null
+  const o = m as {
+    id?: string
+    type?: string
+    text?: string
+    content?: Array<{ type?: string; text?: string }>
+    time?: { created?: number }
+  }
+  const id = o.id ?? `srv-${o.time?.created ?? 0}`
+  const ts = typeof o.time?.created === "number" ? o.time.created : 0
+  if (o.type === "user" && typeof o.text === "string") {
+    return { id, actor: "kid", text: o.text, streaming: false, ts }
+  }
+  if (o.type === "assistant" && Array.isArray(o.content)) {
+    const text = o.content
+      .filter((p) => p?.type === "text" && typeof p.text === "string")
+      .map((p) => p.text)
+      .join("")
+      .trim()
+    if (!text) return null
+    return { id, actor: "agent", text, streaming: false, ts }
+  }
+  return null
+}
+
 /** SDK list responses come back as `T[]` or `{ data: T[] }` across versions. */
 function unwrapArray(result: unknown): unknown[] {
   if (Array.isArray(result)) return result

package/src/core/store.ts

@@ -159,6 +159,12 @@ export class Store {
     this.notify()
   }
 
+  /** Replace the whole transcript at once (used when rehydrating a past session). */
+  setMessages(messages: ChatMessage[]): void {
+    this.state = { ...this.state, messages }
+    this.notify()
+  }
+
   appendDelta(messageId: string, delta: string): void {
     const messages = this.state.messages.map((m) =>
       m.id === messageId ? { ...m, text: m.text + delta } : m,

package/src/index.tsx

@@ -32,6 +32,7 @@ import { readLastSession, writeLastSession } from "./core/last-session.ts"
 import { isCompletionTrigger, runCheck } from "./core/check-runner.ts"
 import { parseSlash, matchCommand } from "./core/commands.ts"
 import { listModels } from "./core/models.ts"
+import { findFiles } from "./core/files.ts"
 import { App } from "./render/ink/App.tsx"
 import { FREE_PLAY_PACK_ID } from "./render/ink/screens/CoursePackPicker.tsx"
 import { detectDangerousTopicEn, detectDangerousTopicZh } from "./dangerous-topic-bridge.ts"
@@ -61,6 +62,7 @@ interface FullHandlers {
   onPickPack: (packId: string) => void
   onMissionNext: () => void
   onSessionPick: (sessionId: string) => void
+  onFindFiles: (query: string) => Promise<string[]>
 }
 
 interface AppHandlers {
@@ -81,6 +83,7 @@ interface AppHandlers {
   onModelPick: (modelId: string) => void
   onSessionPick: (sessionId: string) => void
   onPickerClose: () => void
+  onFindFiles: (query: string) => Promise<string[]>
   onSetupSave: (provider: ProviderId, apiKey: string) => Promise<{ ok: true } | { ok: false; reason: string }>
   onSetupContinue: () => Promise<void>
   onSetupSkip: () => void
@@ -251,6 +254,10 @@ function makeHandlers(
       })
     },
     onSessionPick: ifBooted((s, id: string) => s.handlers.onSessionPick(id)),
+    onFindFiles: async (query: string) => {
+      const s = servicesHolder.current
+      return s ? s.handlers.onFindFiles(query) : []
+    },
     onPickerClose: () => {
       const sc = store.getSnapshot().screen
       if (sc.kind === "model_picker" || sc.kind === "session_list") {
@@ -522,6 +529,18 @@ function makeFullHandlers(
       case "clear":
         store.update({ messages: [] })
         return
+      case "compact":
+        if (!session.getId()) {
+          sysMessage(zh ? "还没有对话可以压缩。" : "No chat to shrink yet.")
+          return
+        }
+        try {
+          await session.compact()
+          flashToast(store, { kind: "success", text: zh ? "对话已压缩 ✓" : "Chat shrunk ✓" })
+        } catch {
+          flashToast(store, { kind: "warn", text: zh ? "压缩没成功,稍后再试" : "Couldn't shrink — try again later" })
+        }
+        return
       case "new":
         session.reset()
         store.update({ messages: [] })
@@ -726,18 +745,24 @@ function makeFullHandlers(
         text: env.locale === "zh-Hans" ? `开始：${next.title}` : `Starting: ${next.title}`,
       })
     },
-    onSessionPick: (sessionId) => {
-      session.switchTo(sessionId)
+    onSessionPick: async (sessionId) => {
       const sc = store.getSnapshot().screen
       const back = sc.kind === "session_list" ? sc.returnTo : { kind: "mission" as const }
-      // We continue the session server-side; the local transcript starts clean
-      // (full rehydration of past messages is a later enhancement).
+      // Show the chat immediately (loading), then rehydrate the transcript from
+      // the server so the kid sees what was said before.
       store.update({ messages: [], screen: back })
+      try {
+        const past = await session.loadMessages(sessionId)
+        store.setMessages(past)
+      } catch {
+        session.switchTo(sessionId) // at least continue it even if rehydrate failed
+      }
       flashToast(store, {
         kind: "info",
-        text: env.locale === "zh-Hans" ? "已切到这段对话，继续聊吧" : "Switched to that chat — keep going",
+        text: env.locale === "zh-Hans" ? "打开了这段对话" : "Opened that chat",
       })
     },
+    onFindFiles: (query) => findFiles(client, query),
   }
 }
 

package/src/render/ink/App.tsx

@@ -67,6 +67,8 @@ export interface AppDeps {
   onSessionPick: (sessionId: string) => void
   /** Cancel a model/session picker and go back to where it was opened from. */
   onPickerClose: () => void
+  /** Autocomplete project files for an `@mention`. */
+  onFindFiles: (query: string) => Promise<string[]>
   onSetupSave: (provider: ProviderId, apiKey: string) => Promise<{ ok: true } | { ok: false; reason: string }>
   onSetupContinue: () => Promise<void>
   onSetupSkip: () => void
@@ -137,7 +139,7 @@ function renderScreen(state: ReturnType<Store["getSnapshot"]>, deps: AppDeps): R
     case "startup":
       return <StartupScreen locale={deps.locale} coursePack={state.coursePack} toast={state.toast} onStart={deps.onStart} onOpenWallet={deps.onOpenWallet} onQuit={deps.onQuit} />
     case "mission":
-      return <MissionScreen state={state} locale={deps.locale} onPrompt={deps.onPrompt} onAbort={deps.onAbort} onExit={deps.onMissionExit} />
+      return <MissionScreen state={state} locale={deps.locale} onPrompt={deps.onPrompt} onAbort={deps.onAbort} onExit={deps.onMissionExit} onFindFiles={deps.onFindFiles} />
     case "help":
       return <HelpScreen locale={deps.locale} onBack={deps.onHelpBack} />
     case "course_picker":

package/src/render/ink/components/ChatStream.tsx

@@ -1,14 +1,22 @@
 import React from "react"
 import { Box, Static, Text } from "ink"
 import { getTheme } from "../theme.ts"
+import { MessageBody } from "./MessageBody.tsx"
 import type { ChatMessage } from "../../../core/store.ts"
 
 interface ChatStreamProps {
   messages: ChatMessage[]
 }
 
-export function ChatStream({ messages }: ChatStreamProps): React.ReactElement {
+/** Agent text gets markdown/code rendering; kid + system stay plain. */
+function MessageText({ m }: { m: ChatMessage }): React.ReactElement {
   const theme = getTheme()
+  const color = colorFor(m.actor, theme)
+  if (m.actor === "agent") return <MessageBody text={m.text || " "} color={color} />
+  return <Text color={color}>{m.text || " "}</Text>
+}
+
+export function ChatStream({ messages }: ChatStreamProps): React.ReactElement {
   if (messages.length === 0) return <Box />
   // Settled messages go into <Static> so Ink doesn't re-render the entire
   // history every delta. The active streaming message (if any) renders
@@ -22,7 +30,7 @@ export function ChatStream({ messages }: ChatStreamProps): React.ReactElement {
           <Box key={m.id} flexDirection="row" marginBottom={1}>
             <ActorBadge actor={m.actor} />
             <Box flexDirection="column" flexGrow={1}>
-              <Text color={colorFor(m.actor, theme)}>{m.text || " "}</Text>
+              <MessageText m={m} />
             </Box>
           </Box>
         )}
@@ -31,7 +39,7 @@ export function ChatStream({ messages }: ChatStreamProps): React.ReactElement {
         <Box flexDirection="row" marginBottom={1}>
           <ActorBadge actor={active.actor} />
           <Box flexDirection="column" flexGrow={1}>
-            <Text color={colorFor(active.actor, theme)}>{active.text || " "}</Text>
+            <MessageText m={active} />
           </Box>
         </Box>
       )}

package/src/render/ink/components/FileSuggestions.tsx

@@ -0,0 +1,37 @@
+/**
+ * Inline `@file` suggestions, shown above the input when the kid's current
+ * token starts with "@". Like CommandSuggestions, it's non-interactive: the kid
+ * keeps typing the path and presses Enter. The matches are fetched by
+ * MissionScreen (it owns the client) and passed in.
+ */
+
+import React from "react"
+import { Box, Text } from "ink"
+import { getTheme } from "../theme.ts"
+import type { Locale } from "../../../core/commands.ts"
+
+export function FileSuggestions({ matches, locale }: { matches: string[]; locale: Locale }): React.ReactElement {
+  const theme = getTheme()
+  if (matches.length === 0) {
+    return (
+      <Box marginBottom={1}>
+        <Text color={theme.fgDim}>
+          {locale === "zh-Hans" ? "没找到这个文件 — 继续打它的名字" : "No file yet — keep typing its name"}
+        </Text>
+      </Box>
+    )
+  }
+  return (
+    <Box marginBottom={1} flexDirection="column">
+      {matches.map((path) => (
+        <Box key={path}>
+          <Text color={theme.accent}>@</Text>
+          <Text color={theme.fg}>{path}</Text>
+        </Box>
+      ))}
+      <Text color={theme.fgDim}>
+        {locale === "zh-Hans" ? "打上文件名,AI 就能读它" : "Name a file and the AI can read it"}
+      </Text>
+    </Box>
+  )
+}

package/src/render/ink/components/MessageBody.tsx

@@ -0,0 +1,99 @@
+/**
+ * Lightweight markdown-ish renderer for the AI's chat messages — no heavy dep.
+ * Handles the things a kid actually sees from a coding mentor:
+ *   - fenced ```code``` blocks (incl. an unterminated one while streaming)
+ *   - headings (#, ##), bullet lists (-, *), and inline **bold** / `code`
+ * Everything else renders as plain wrapped text. Kid/system messages stay plain
+ * (they don't author markdown); only agent text is enriched.
+ */
+
+import React from "react"
+import { Box, Text } from "ink"
+import { getTheme } from "../theme.ts"
+
+type Theme = ReturnType<typeof getTheme>
+
+export interface Block {
+  type: "code" | "text"
+  /** code language label (may be ""); unused for text blocks. */
+  lang?: string
+  content: string
+}
+
+/** Split message text into fenced-code vs prose blocks. */
+export function splitBlocks(text: string): Block[] {
+  const lines = text.split("\n")
+  const blocks: Block[] = []
+  let mode: "text" | "code" = "text"
+  let buf: string[] = []
+  let lang = ""
+  const flush = (type: "code" | "text"): void => {
+    if (buf.length === 0 && type === "text") return
+    blocks.push({ type, lang: type === "code" ? lang : undefined, content: buf.join("\n") })
+    buf = []
+  }
+  for (const line of lines) {
+    const fence = line.match(/^```(\w*)\s*$/)
+    if (fence) {
+      if (mode === "text") { flush("text"); mode = "code"; lang = fence[1] ?? "" }
+      else { flush("code"); mode = "text"; lang = "" }
+      continue
+    }
+    buf.push(line)
+  }
+  // Unterminated fence while streaming → keep what we have as a code block.
+  flush(mode)
+  return blocks
+}
+
+/** Parse inline **bold** and `code` into Ink <Text> spans. */
+export function renderInline(line: string, theme: Theme, keyPrefix: string): React.ReactNode[] {
+  const out: React.ReactNode[] = []
+  const re = /(\*\*([^*]+)\*\*|`([^`]+)`)/g
+  let last = 0
+  let m: RegExpExecArray | null
+  let i = 0
+  while ((m = re.exec(line)) !== null) {
+    if (m.index > last) out.push(<Text key={`${keyPrefix}-t${i}`}>{line.slice(last, m.index)}</Text>)
+    if (m[2] !== undefined) out.push(<Text key={`${keyPrefix}-b${i}`} bold>{m[2]}</Text>)
+    else if (m[3] !== undefined) out.push(<Text key={`${keyPrefix}-c${i}`} color={theme.accent}>{m[3]}</Text>)
+    last = m.index + m[0].length
+    i++
+  }
+  if (last < line.length) out.push(<Text key={`${keyPrefix}-t${i}`}>{line.slice(last)}</Text>)
+  if (out.length === 0) out.push(<Text key={`${keyPrefix}-empty`}> </Text>)
+  return out
+}
+
+export function MessageBody({ text, color }: { text: string; color: string }): React.ReactElement {
+  const theme = getTheme()
+  const blocks = splitBlocks(text)
+  return (
+    <Box flexDirection="column">
+      {blocks.map((b, bi) => {
+        if (b.type === "code") {
+          return (
+            <Box key={`code-${bi}`} flexDirection="column" borderStyle="round" borderColor={theme.fgDim} paddingX={1}>
+              {b.lang ? <Text color={theme.fgDim} dimColor>{b.lang}</Text> : null}
+              {(b.content || " ").split("\n").map((l, li) => (
+                <Text key={li} color={theme.success}>{l || " "}</Text>
+              ))}
+            </Box>
+          )
+        }
+        return (
+          <Box key={`text-${bi}`} flexDirection="column">
+            {b.content.split("\n").map((line, li) => {
+              const key = `${bi}-${li}`
+              const heading = line.match(/^(#{1,3})\s+(.*)$/)
+              if (heading) return <Text key={key} color={theme.accent} bold>{heading[2]}</Text>
+              const bullet = line.match(/^\s*[-*]\s+(.*)$/)
+              if (bullet) return <Text key={key} color={color}>{"• "}{renderInline(bullet[1] ?? "", theme, key)}</Text>
+              return <Text key={key} color={color}>{renderInline(line, theme, key)}</Text>
+            })}
+          </Box>
+        )
+      })}
+    </Box>
+  )
+}

package/src/render/ink/screens/MissionScreen.tsx

@@ -9,7 +9,7 @@
  * client.session.abort()).
  */
 
-import React, { useState } from "react"
+import React, { useState, useEffect } from "react"
 import { Box, Text, useInput } from "ink"
 import { Header } from "../components/Header.tsx"
 import { ChatStream } from "../components/ChatStream.tsx"
@@ -17,10 +17,15 @@ import { Input } from "../components/Input.tsx"
 import { Thinking } from "../components/Thinking.tsx"
 import { Toast } from "../components/Toast.tsx"
 import { CommandSuggestions } from "../components/CommandSuggestions.tsx"
+import { FileSuggestions } from "../components/FileSuggestions.tsx"
 import { getTheme } from "../theme.ts"
 import { useVoiceInput } from "../useVoiceInput.ts"
 import type { KidsClientState } from "../../../core/store.ts"
 
+// Module-level so the kid's prompt history survives MissionScreen remounts
+// (e.g. after opening a picker and coming back) within one process.
+const promptHistory: string[] = []
+
 interface MissionScreenProps {
   state: KidsClientState
   locale: "zh-Hans" | "en"
@@ -28,13 +33,33 @@ interface MissionScreenProps {
   onAbort: () => void
   /** Leave the mission and return to the startup menu. */
   onExit: () => void
+  /** Autocomplete project files for an `@mention`. Optional (demo/tests omit). */
+  onFindFiles?: (query: string) => Promise<string[]>
 }
 
-export function MissionScreen({ state, locale, onPrompt, onAbort, onExit }: MissionScreenProps): React.ReactElement {
+export function MissionScreen({ state, locale, onPrompt, onAbort, onExit, onFindFiles }: MissionScreenProps): React.ReactElement {
   const theme = getTheme()
   const [draft, setDraft] = useState("")
+  // -1 = not browsing history; otherwise an index into promptHistory.
+  const [historyIdx, setHistoryIdx] = useState(-1)
+  const [fileMatches, setFileMatches] = useState<string[]>([])
   const placeholder = locale === "zh-Hans" ? "想做什么？告诉我吧（中文/英文都行）" : "What would you like to make? (English or Chinese)"
 
+  // `@file` autocomplete: when the current (last) token starts with "@", fetch
+  // matching project files. Plain display — the kid finishes the name and the
+  // AI reads it via the `read` tool.
+  const lastToken = draft.split(/\s/).pop() ?? ""
+  const atQuery = !draft.trim().startsWith("/") && lastToken.startsWith("@") ? lastToken.slice(1) : null
+  useEffect(() => {
+    if (atQuery === null || !onFindFiles) {
+      setFileMatches([])
+      return
+    }
+    let cancelled = false
+    onFindFiles(atQuery).then((m) => { if (!cancelled) setFileMatches(m) }).catch(() => {})
+    return () => { cancelled = true }
+  }, [atQuery, onFindFiles])
+
   const voice = useVoiceInput(onPrompt)
   const voiceBusy = voice.voiceState !== "idle"
   // Spacebar talks ONLY when the kid isn't mid-typing — a non-empty draft means
@@ -60,8 +85,19 @@ export function MissionScreen({ state, locale, onPrompt, onAbort, onExit }: Miss
       onExit()
     } else if (key.escape) {
       if (state.thinking) onAbort()
-      else if (draft.length > 0) setDraft("")
+      else if (draft.length > 0) { setDraft(""); setHistoryIdx(-1) }
       else onExit()
+    } else if (key.upArrow && (draft.length === 0 || historyIdx >= 0)) {
+      // ↑ recalls earlier prompts. Works from an empty box, or keeps walking
+      // back once we're already browsing history.
+      if (promptHistory.length === 0) return
+      const next = historyIdx < 0 ? promptHistory.length - 1 : Math.max(0, historyIdx - 1)
+      setHistoryIdx(next)
+      setDraft(promptHistory[next] ?? "")
+    } else if (key.downArrow && historyIdx >= 0) {
+      const next = historyIdx + 1
+      if (next >= promptHistory.length) { setHistoryIdx(-1); setDraft("") }
+      else { setHistoryIdx(next); setDraft(promptHistory[next] ?? "") }
     } else if (input === " " && canTalk) {
       setDraft("")
       voice.startListening()
@@ -69,8 +105,8 @@ export function MissionScreen({ state, locale, onPrompt, onAbort, onExit }: Miss
   })
 
   const hint = locale === "zh-Hans"
-    ? "提示：打 / 看命令 · 按「空格」说话 · 「我做完了」验收 · 按 ← 返回菜单 · AI 说话时 Esc 打断"
-    : "Tip: type / for commands · Space to talk · 'I'm done' to validate · ← to go back · Esc interrupts the AI"
+    ? "提示：打 / 看命令 · @ 选文件 · ↑ 上一句 · 「空格」说话 · 「我做完了」验收 · ← 返回 · Esc 打断"
+    : "Tip: / commands · @ files · ↑ last prompt · Space to talk · 'I'm done' to validate · ← back · Esc interrupts"
 
   return (
     <Box flexDirection="column" flexGrow={1}>
@@ -95,16 +131,23 @@ export function MissionScreen({ state, locale, onPrompt, onAbort, onExit }: Miss
           <CommandSuggestions query={draft} locale={locale} />
         </Box>
       )}
+      {!voiceBusy && atQuery !== null && (
+        <Box marginTop={1}>
+          <FileSuggestions matches={fileMatches} locale={locale} />
+        </Box>
+      )}
       <Box marginTop={1}>
         {voiceBusy ? (
           <VoiceBar voiceState={voice.voiceState} meter={voice.meter} mode={voice.mode} locale={locale} theme={theme} />
         ) : (
           <Input
             value={draft}
-            onChange={setDraft}
+            onChange={(v) => { setDraft(v); setHistoryIdx(-1) }}
             onSubmit={(v) => {
               const text = v.trim()
               if (!text) return
+              if (promptHistory[promptHistory.length - 1] !== text) promptHistory.push(text)
+              setHistoryIdx(-1)
               setDraft("")
               onPrompt(text)
             }}