@allbluecn/web-app 0.23.3 → 0.23.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/web-app",
-  "version": "0.23.3",
+  "version": "0.23.5",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "files": [
@@ -60,9 +60,9 @@
   "dependencies": {
     "@ag-ui/core": "1.0.0",
     "@allbluecn/collab-core": "0.2.0",
-    "@allbluecn/database": "0.12.2",
+    "@allbluecn/database": "0.12.3",
     "@allbluecn/kernel": "0.12.0",
-    "@allbluecn/sync-core": "0.6.0",
+    "@allbluecn/sync-core": "0.7.0",
     "@ariakit/react": "^0.4.28",
     "@auth/core": "^0.41.2",
     "@auth/prisma-adapter": "^2.11.2",

package/src/components/ai/global-harness-sidebar/__tests__/global-ai-prompts.test.ts

@@ -92,6 +92,8 @@ function coveredByBoardRule(rel: string): boolean {
  * 新增业务页面时二者必居其一：在此登记，或在 BOARD_RULES 增加板块规则。
  */
 const PAGES_WITHOUT_BOARDS = [
+  // 本地文件助手（桌面本地优先 P3-B5）：页面自带对话区，非业务板块，无全局 AI 板块上下文
+  "agent",
   "bugs",
   "chat",
   "changelog",

package/src/components/desktop/__tests__/cloud-login-rollback.test.tsx

@@ -0,0 +1,161 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 桌面云端登录的回滚路径（C2 / 裁定 R4）：
+// ① 非空账号 → logoutRemoteFn + clearCloudSession 被调、不进入 bind（transferOwnershipFn
+//    未调、bindBegin 未调）、不 reload（query 缓存清空留在 guest 视图）；
+// ② 探测不可达（与 ① 同路，提示文案分路）；
+// ③ 旧壳无 bind 三 IPC（不探测）→ 同 ① 回滚；
+// ④ 空账号 → 正常 bind 流程（不回滚、不 logout）。
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import type { ReactNode } from 'react'
+
+const H = vi.hoisted(() => ({
+  exchangeRemoteTokenFn: vi.fn(),
+  logoutRemoteFn: vi.fn(),
+  probeCloudAccountStatusFn: vi.fn(),
+  transferOwnershipFn: vi.fn(),
+  toast: { info: vi.fn(), error: vi.fn(), success: vi.fn() },
+  bridge: null as unknown,
+  reload: vi.fn(),
+}))
+
+vi.mock('@/lib/desktop-bridge-types', () => ({ getDesktopBridge: () => H.bridge }))
+vi.mock('@/server/serverFns/auth/session', () => ({
+  exchangeRemoteTokenFn: H.exchangeRemoteTokenFn,
+  logoutRemoteFn: H.logoutRemoteFn,
+}))
+vi.mock('@/server/serverFns/sync/transfer', () => ({
+  probeCloudAccountStatusFn: H.probeCloudAccountStatusFn,
+  transferOwnershipFn: H.transferOwnershipFn,
+}))
+vi.mock('@/components/ui/toast', () => ({ toast: H.toast }))
+
+import { DesktopCloudLogin } from '../cloud-login'
+
+type BridgeOverrides = Partial<{
+  bindBegin: (() => Promise<{ ok: boolean }>) | undefined
+  bindDone: (() => Promise<{ ok: boolean }>) | undefined
+  bindFail: (() => Promise<{ ok: boolean }>) | undefined
+  clearCloudSession: (() => Promise<{ ok: boolean }>) | undefined
+}>
+
+function makeBridge(overrides: BridgeOverrides = {}) {
+  return {
+    cloudLogin: vi.fn(async () => ({ ok: true, userId: 'cloud-1' })),
+    exchangeCloudSession: vi.fn(async () => ({ ok: true, token: 'tok-1' })),
+    bindBegin: vi.fn(async () => ({ ok: true })),
+    bindDone: vi.fn(async () => ({ ok: true })),
+    bindFail: vi.fn(async () => ({ ok: true })),
+    clearCloudSession: vi.fn(async () => ({ ok: true })),
+    ...overrides,
+  }
+}
+
+function wrapper({ children }: { children: ReactNode }) {
+  const client = new QueryClient({ defaultOptions: { queries: { retry: false } } })
+  return <QueryClientProvider client={client}>{children}</QueryClientProvider>
+}
+
+/** 走完「输入 → 提交」并等激活链路结束 */
+async function submitLogin() {
+  render(<DesktopCloudLogin />, { wrapper })
+  fireEvent.change(screen.getByLabelText('邮箱'), { target: { value: 'me@example.com' } })
+  // 密码框无 accessible label 关联（htmlFor 指向 desktop-cloud-password，Label 有）
+  fireEvent.change(screen.getByLabelText('密码'), { target: { value: 'secret' } })
+  fireEvent.click(screen.getByRole('button', { name: '登录云端' }))
+  await waitFor(() => {
+    expect(H.exchangeRemoteTokenFn).toHaveBeenCalled()
+  })
+  // 让后续 await 链（probe → 回滚 / bind）跑完
+  await waitFor(() => {
+    expect(
+      H.logoutRemoteFn.mock.calls.length + H.probeCloudAccountStatusFn.mock.calls.length,
+    ).toBeGreaterThan(0)
+  })
+}
+
+beforeEach(() => {
+  vi.clearAllMocks()
+  H.exchangeRemoteTokenFn.mockResolvedValue({ success: true, userId: 'cloud-1', planName: 'free' })
+  H.logoutRemoteFn.mockResolvedValue({ success: true })
+  H.transferOwnershipFn.mockResolvedValue({ tables: 1, rows: 1 })
+  H.bridge = makeBridge()
+  // jsdom 不支持导航：替换 location.reload 为可断言 spy（不可配置时静默跳过）
+  try {
+    Object.defineProperty(window, 'location', {
+      configurable: true,
+      value: { ...window.location, reload: H.reload },
+    })
+  } catch {
+    /* jsdom 限制：断言改为「未进入成功分支」 */
+  }
+})
+
+afterEach(() => {
+  cleanup()
+})
+
+describe('DesktopCloudLogin 不可转移路径回滚（C2 / 裁定 R4）', () => {
+  it('①非空账号：回滚云身份（logoutRemoteFn + clearCloudSession），不进入 bind', async () => {
+    H.probeCloudAccountStatusFn.mockResolvedValue({ empty: false })
+    const bridge = H.bridge as ReturnType<typeof makeBridge>
+
+    await submitLogin()
+
+    await waitFor(() => {
+      expect(H.logoutRemoteFn).toHaveBeenCalledWith({ data: {} })
+      expect(bridge.clearCloudSession).toHaveBeenCalled()
+    })
+    expect(H.transferOwnershipFn).not.toHaveBeenCalled()
+    expect(bridge.bindBegin).not.toHaveBeenCalled()
+    // 提示：非空账号 + 回滚说明；不清缓存即不会回到云态
+    expect(H.toast.info).toHaveBeenCalledTimes(2)
+  })
+
+  it('②探测不可达：同样回滚（宁可不转不可错转）', async () => {
+    H.probeCloudAccountStatusFn.mockResolvedValue({ empty: false, unreachable: true })
+    const bridge = H.bridge as ReturnType<typeof makeBridge>
+
+    await submitLogin()
+
+    await waitFor(() => {
+      expect(H.logoutRemoteFn).toHaveBeenCalledTimes(1)
+      expect(bridge.clearCloudSession).toHaveBeenCalledTimes(1)
+    })
+    expect(bridge.bindBegin).not.toHaveBeenCalled()
+    expect(H.transferOwnershipFn).not.toHaveBeenCalled()
+  })
+
+  it('③旧壳无 bind 三 IPC：不探测、直接回滚', async () => {
+    const bridge = makeBridge({ bindBegin: undefined, bindDone: undefined, bindFail: undefined })
+    H.bridge = bridge
+
+    await submitLogin()
+
+    await waitFor(() => {
+      expect(H.logoutRemoteFn).toHaveBeenCalledTimes(1)
+      expect(bridge.clearCloudSession).toHaveBeenCalledTimes(1)
+    })
+    expect(H.probeCloudAccountStatusFn).not.toHaveBeenCalled()
+    expect(H.transferOwnershipFn).not.toHaveBeenCalled()
+  })
+
+  it('④空账号：进入 bind 流程，不回滚', async () => {
+    H.probeCloudAccountStatusFn.mockResolvedValue({ empty: true })
+    const bridge = H.bridge as ReturnType<typeof makeBridge>
+
+    await submitLogin()
+
+    await waitFor(() => {
+      expect(bridge.bindBegin).toHaveBeenCalledTimes(1)
+      expect(H.transferOwnershipFn).toHaveBeenCalledWith({ data: { cloudUserId: 'cloud-1' } })
+      expect(bridge.bindDone).toHaveBeenCalledTimes(1)
+    })
+    expect(H.logoutRemoteFn).not.toHaveBeenCalled()
+    expect(bridge.clearCloudSession).not.toHaveBeenCalled()
+  })
+})

package/src/components/desktop/cloud-login.tsx

@@ -13,9 +13,12 @@
 // P2 A8b 归属转移串联：exchange 成功后 claim 探测（probeCloudAccountStatusFn
 // 代持云会话 token 问 SaaS 账号是否空账号）——空账号进入 bind 流程（bindBegin
 // 停写快照 → transferOwnershipFn 单事务翻转 guest→cloud（身份字段省略，server
-// 侧自取 SaaS profile）→ bindDone 清快照触发 push → reload）；非空账号一期不
-// 支持转移（提示后仍 reload，云身份生效、本地数据保留 guest 属主）；转移失败
-// bindFail 恢复快照回 guest 态（toast 提示，不 reload）。
+// 侧自取 SaaS profile）→ bindDone 清快照触发 push → reload）。
+// P3 收尾 C2（裁定 R4）：非空账号 / 探测不可达 / 旧壳无 bind 三 IPC 一律**回滚
+// 云身份**（logoutRemoteFn 清 remote-auth + clearCloudSession 清 cloud-session
+// + 清 query 缓存），留在 guest 会话并提示「一期仅支持空账号」——不再像旧版
+// 那样激活云身份后 reload（那会留下「云态零数据 + 写入 P2003」的坏态）。
+// 转移失败 bindFail 恢复快照回 guest 态（toast 提示，不 reload）。
 // 独立于 web 登录页——web 表单走本地 serverFn authjs，二者不混用。
 import { useEffect, useState } from "react"
 import { useQueryClient } from "@tanstack/react-query"
@@ -75,11 +78,14 @@ export function DesktopCloudLogin() {
         return
       }
 
-      // claim 探测（A8b）：探测异常按非空处理（宁可不转不可错转）。旧壳无
-      // bind 三方法时同样只激活云身份不转移（优雅降级，A10 行为）。
+      // 不可转移判定（C2 / 裁定 R4）：非空账号 / 探测不可达 / 旧壳不支持一期
+      // 均**不得**把用户带进「云身份已激活但本地数据仍属 guest」的坏态——
+      // 回滚云身份（清 remote-auth + cloud-session）留在 guest 会话，提示后
+      // 不 reload（query 缓存清空即回到 guest 数据视图）。
       const { bindBegin, bindDone, bindFail } = bridge
+      const shellSupported = Boolean(bindBegin && bindDone && bindFail)
       let probe: { empty: boolean; unreachable?: boolean } = { empty: false, unreachable: true }
-      if (bindBegin && bindDone && bindFail) {
+      if (shellSupported) {
         try {
           probe = await probeCloudAccountStatusFn()
         } catch {
@@ -87,30 +93,27 @@ export function DesktopCloudLogin() {
         }
       }
 
-      if (!(bindBegin && bindDone && bindFail)) {
-        // 旧壳降级（无 bind 三 IPC）：只激活云身份不转移（A10 行为），提示后
-        // 仍 reload 生效（本地数据保留 guest 属主）。与探测不可达分路如实提示。
-        toast.info(m.sync_bind_shell_unsupported())
-        setOk(true)
-        queryClient.clear()
-        window.location.reload()
-        return
-      }
-      if (!probe.empty) {
-        // 非空账号：一期不支持转移——云身份已激活，仍 reload 生效（本地数据
-        // 保留 guest 属主，二期做云端 bootstrap 下载）。探测不可达与「确认
-        // 非空」分路提示（不可达 ≠ 账号有数据，勿误导）。
-        toast.info(probe.unreachable ? m.sync_bind_probe_unreachable() : m.sync_bind_nonempty())
-        setOk(true)
+      if (!shellSupported || !probe.empty) {
+        await logoutRemoteFn({ data: {} }).catch(() => null)
+        await bridge.clearCloudSession?.().catch(() => null)
         queryClient.clear()
-        window.location.reload()
+        toast.info(
+          !shellSupported
+            ? m.sync_bind_shell_unsupported()
+            : probe.unreachable
+              ? m.sync_bind_probe_unreachable()
+              : m.sync_bind_nonempty(),
+        )
+        toast.info(m.sync_bind_rolled_back())
         return
       }
 
-      // 空账号 → 归属转移 bind 流程：main 侧停写快照（bindBegin）→ renderer 调
-      // 转移 serverFn（localhost cookie 过鉴权；身份字段省略，server 自取
-      // profile）→ 成功 bindDone（清快照 + 触发 push）；失败 bindFail（停
-      // backend 还原快照重启，回 guest 态）。
+      // 归属转移 bind 流程：main 侧停写快照（bindBegin）→ renderer 调转移
+      // serverFn（localhost cookie 过鉴权；身份字段省略，server 自取 profile）
+      // → 成功 bindDone（清快照 + 触发 push）；失败 bindFail（停 backend 还原
+      // 快照重启，回 guest 态）。此处 shellSupported 必为 true（false 已在上方
+      // 回滚分支返回）——守卫只为收窄可选方法类型。
+      if (!bindBegin || !bindDone || !bindFail) return
       setBinding(true)
       const begin = await bindBegin()
       if (!begin.ok) {

package/src/components/desktop-agent/__tests__/agent-chat.test.tsx

@@ -0,0 +1,194 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 对话区（桌面本地优先 P3-B5）：useChat 接线（懒取端点的 connection
+// 包装 + 稳定 threadId + forwardedProps.cwd）、消息渲染（空 assistant 消息跳过、
+// 工具调用折叠卡按 toolCallId 关联结果）、输入（Enter 发送 / Shift+Enter /
+// 输入法组合）、中止（按钮 + agent-abort 热键仅运行中生效）、错误文案映射。
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { HotkeysProvider } from '@tanstack/react-hotkeys'
+import type { UIMessage } from '@tanstack/ai-client'
+import { TooltipProvider } from '@/components/ui/tooltip'
+import { appHotkeys } from '@/lib/hotkeys/registry'
+import { m } from '@/paraglide/messages.js'
+
+const chat = vi.hoisted(() => ({
+  messages: [] as unknown[],
+  isLoading: false,
+  error: undefined as Error | undefined,
+  sendMessage: vi.fn(async (_text: string) => {}),
+  stop: vi.fn(),
+  options: [] as Array<Record<string, unknown>>,
+}))
+
+vi.mock('@tanstack/ai-react', () => ({
+  useChat: (options: Record<string, unknown>) => {
+    chat.options.push(options)
+    return {
+      messages: chat.messages,
+      isLoading: chat.isLoading,
+      error: chat.error,
+      sendMessage: chat.sendMessage,
+      stop: chat.stop,
+    }
+  },
+}))
+// markdown 渲染器替身（react-markdown/shiki 与本组件行为无关，保测试轻量）
+vi.mock('@/components/harness/ai-message/components/markdown-content', () => ({
+  MarkdownContent: ({ content }: { content: string }) => <div data-testid="markdown">{content}</div>,
+}))
+
+import { AgentChat } from '../agent-chat'
+
+const piResult = (text: string) => ({ content: [{ type: 'text', text }], details: undefined })
+
+function renderChat(props: { cwd?: string | null; onRunningChange?: (running: boolean) => void } = {}) {
+  const ui = (cwd: string | null) => (
+    <HotkeysProvider appHotkeys={appHotkeys}>
+      <TooltipProvider>
+        <AgentChat cwd={cwd} onRunningChange={props.onRunningChange} />
+      </TooltipProvider>
+    </HotkeysProvider>
+  )
+  const cwd = props.cwd === undefined ? '/Users/x/proj' : props.cwd
+  const utils = render(ui(cwd))
+  return { ...utils, rerenderWith: (next: string | null) => utils.rerender(ui(next)) }
+}
+
+beforeEach(() => {
+  chat.messages = []
+  chat.isLoading = false
+  chat.error = undefined
+  chat.options = []
+  chat.sendMessage.mockClear()
+  chat.stop.mockClear()
+})
+
+afterEach(() => cleanup())
+
+describe('AgentChat · useChat 接线', () => {
+  it('connection 为懒取端点的包装（含 connect）、threadId 跨渲染稳定、forwardedProps 携带 cwd', () => {
+    const { rerenderWith } = renderChat({ cwd: '/Users/x/proj' })
+    const first = chat.options[0]!
+    expect(typeof (first.connection as { connect?: unknown }).connect).toBe('function')
+    expect(typeof first.threadId).toBe('string')
+    expect(first.forwardedProps).toEqual({ cwd: '/Users/x/proj' })
+    rerenderWith('/Users/x/proj')
+    const last = chat.options.at(-1)!
+    expect(last.threadId).toBe(first.threadId)
+    expect(last.connection).toBe(first.connection)
+  })
+})
+
+describe('AgentChat · 消息渲染', () => {
+  it('user 气泡 + assistant 正文；pi 回显产生的空 assistant 消息被跳过', () => {
+    chat.messages = [
+      { id: 'u1', role: 'user', parts: [{ type: 'text', content: '列出目录' }] },
+      { id: 'msg-1', role: 'assistant', parts: [] },
+      { id: 'msg-2', role: 'assistant', parts: [{ type: 'text', content: '   ' }] },
+      { id: 'msg-3', role: 'assistant', parts: [{ type: 'text', content: '目录里有 a.txt' }] },
+    ] satisfies UIMessage[]
+    renderChat()
+    expect(screen.getByText('列出目录')).toBeInTheDocument()
+    expect(screen.getByText('目录里有 a.txt')).toBeInTheDocument()
+    const rendered = screen.getAllByTestId('agent-message').map((el) => el.getAttribute('data-role'))
+    expect(rendered).toEqual(['user', 'assistant'])
+  })
+
+  it('工具调用：tool-call 渲染折叠卡，同 toolCallId 的 tool-result 不单独渲染', () => {
+    chat.messages = [
+      { id: 'u1', role: 'user', parts: [{ type: 'text', content: '总结项目' }] },
+      {
+        id: 'msg-2',
+        role: 'assistant',
+        parts: [
+          { type: 'tool-call', id: 'call_ls_1', name: 'ls', arguments: '{"path":"."}', state: 'complete', output: piResult('README.md\nsrc/') },
+          { type: 'tool-result', toolCallId: 'call_ls_1', content: JSON.stringify(piResult('README.md\nsrc/')), state: 'complete' },
+        ],
+      },
+    ] satisfies UIMessage[]
+    renderChat()
+    expect(screen.getAllByTestId('agent-tool-card-trigger')).toHaveLength(1)
+    expect(screen.getByText(m.agent_desktop_toolLs({ target: '.' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountFiles({ count: 2 }))).toBeInTheDocument()
+  })
+
+  it('空对话：引导空态', () => {
+    renderChat()
+    expect(screen.getByText(m.agent_desktop_chatEmptyTitle())).toBeInTheDocument()
+  })
+})
+
+describe('AgentChat · 输入与发送', () => {
+  it('Enter 发送（trim）并清空输入；Shift+Enter 与输入法组合中的 Enter 不发送', () => {
+    renderChat()
+    const textarea = screen.getByRole('textbox')
+    fireEvent.change(textarea, { target: { value: '  总结这个项目  ' } })
+    fireEvent.keyDown(textarea, { key: 'Enter', shiftKey: true })
+    fireEvent.keyDown(textarea, { key: 'Enter', isComposing: true })
+    expect(chat.sendMessage).not.toHaveBeenCalled()
+    fireEvent.keyDown(textarea, { key: 'Enter' })
+    expect(chat.sendMessage).toHaveBeenCalledWith('总结这个项目')
+    expect(textarea).toHaveValue('')
+  })
+
+  it('发送按钮：空输入禁用，有内容可点', () => {
+    renderChat()
+    const send = screen.getByRole('button', { name: m.agent_desktop_chatSend() })
+    expect(send).toBeDisabled()
+    fireEvent.change(screen.getByRole('textbox'), { target: { value: '找出所有 TODO' } })
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_chatSend() }))
+    expect(chat.sendMessage).toHaveBeenCalledWith('找出所有 TODO')
+  })
+
+  it('无授权目录（cwd=null）：输入禁用 + 引导先选目录', () => {
+    renderChat({ cwd: null })
+    expect(screen.getByRole('textbox')).toBeDisabled()
+    expect(screen.getByTestId('agent-chat-cwd')).toHaveTextContent(m.agent_desktop_chatNoWorkspace())
+  })
+})
+
+describe('AgentChat · 中止（按钮 + agent-abort 热键）', () => {
+  it('运行中：显示中止按钮（替代发送）并调用 stop；思考指示可见', () => {
+    chat.isLoading = true
+    renderChat()
+    expect(screen.queryByRole('button', { name: m.agent_desktop_chatSend() })).toBeNull()
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_chatStop() }))
+    expect(chat.stop).toHaveBeenCalledTimes(1)
+    expect(screen.getByTestId('agent-chat-thinking')).toBeInTheDocument()
+  })
+
+  it('运行中按 Mod+. → stop（声明即绑定：appHotkeys["agent-abort"]）', () => {
+    chat.isLoading = true
+    renderChat()
+    act(() => {
+      fireEvent.keyDown(document.body, { key: '.', code: 'Period', ctrlKey: true })
+    })
+    expect(chat.stop).toHaveBeenCalledTimes(1)
+  })
+
+  it('未运行时 Mod+. 不触发 stop（enabled 门控）', () => {
+    renderChat()
+    act(() => {
+      fireEvent.keyDown(document.body, { key: '.', code: 'Period', ctrlKey: true })
+    })
+    expect(chat.stop).not.toHaveBeenCalled()
+  })
+
+  it('运行态变化通知父级（锁定目录切换用）', () => {
+    const onRunningChange = vi.fn()
+    chat.isLoading = true
+    renderChat({ onRunningChange })
+    expect(onRunningChange).toHaveBeenLastCalledWith(true)
+  })
+})
+
+describe('AgentChat · 错误文案', () => {
+  it('401 令牌失效 → 可读提示（role=alert）', () => {
+    chat.error = Object.assign(new Error('HTTP error! status: 401'), { name: 'StreamHttpError', status: 401 })
+    renderChat()
+    expect(screen.getByRole('alert')).toHaveTextContent(m.agent_desktop_errorUnauthorized())
+  })
+})

package/src/components/desktop-agent/__tests__/agent-tool-card.test.tsx

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 工具调用折叠卡（桌面本地优先 P3-B5）：默认折叠，头部展示
+// 「工具 + 目标 + 计数」；展开渲染文件名（ls/find）、命中行（grep）、文件内容
+// （read）；运行中 / 错误 / 空结果 / 截断各态。part 形态取自 TanStack processor
+// 处理 B3 mapper 事件后的真实结果（tool-call part.output = pi AgentToolResult）。
+import { afterEach, describe, expect, it } from 'vitest'
+import type { ComponentProps } from 'react'
+import { cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { m } from '@/paraglide/messages.js'
+import { AgentToolCard } from '../agent-tool-card'
+
+type Part = ComponentProps<typeof AgentToolCard>['part']
+type Result = NonNullable<ComponentProps<typeof AgentToolCard>['result']>
+
+const piResult = (text: string) => ({ content: [{ type: 'text', text }], details: undefined })
+
+function toolCall(name: string, args: Record<string, unknown>, extra: Partial<Part> = {}): Part {
+  return {
+    type: 'tool-call',
+    id: `call-${name}`,
+    name,
+    arguments: JSON.stringify(args),
+    state: 'input-streaming',
+    ...extra,
+  } as Part
+}
+
+const trigger = () => screen.getByTestId('agent-tool-card-trigger')
+
+afterEach(() => cleanup())
+
+describe('AgentToolCard', () => {
+  it('grep 默认折叠：头部「搜索 模式」+ 命中计数，命中行不渲染', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('grep', { pattern: 'TODO' }, {
+          state: 'complete',
+          output: piResult('src/a.ts:12: const TODO = 1\ndocs/b.md:3: TODO: write docs'),
+        })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolGrep({ target: 'TODO' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountHits({ count: 2 }))).toBeInTheDocument()
+    expect(trigger()).toHaveAttribute('aria-expanded', 'false')
+    expect(screen.queryByText('const TODO = 1')).toBeNull()
+  })
+
+  it('grep 展开：命中行渲染「文件:行号」+ 行内容', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('grep', { pattern: 'TODO' }, {
+          state: 'complete',
+          output: piResult('src/a.ts:12: const TODO = 1\ndocs/b.md:3: TODO: write docs'),
+        })}
+      />,
+    )
+    fireEvent.click(trigger())
+    expect(trigger()).toHaveAttribute('aria-expanded', 'true')
+    expect(screen.getByText('src/a.ts:12')).toBeInTheDocument()
+    expect(screen.getByText('const TODO = 1')).toBeInTheDocument()
+    expect(screen.getByText('docs/b.md:3')).toBeInTheDocument()
+  })
+
+  it('ls 展开：文件名列表（目录保留 / 后缀），target 缺省为 .', () => {
+    render(<AgentToolCard part={toolCall('ls', {}, { state: 'complete', output: piResult('README.md\nsrc/') })} />)
+    expect(screen.getByText(m.agent_desktop_toolLs({ target: '.' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountFiles({ count: 2 }))).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText('README.md')).toBeInTheDocument()
+    expect(screen.getByText('src/')).toBeInTheDocument()
+  })
+
+  it('read：tool-call part 无 output 时回落 tool-result part 内容（JSON 串）', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('read', { path: 'notes.md' }, { state: 'input-complete' })}
+        result={{
+          type: 'tool-result',
+          toolCallId: 'call-read',
+          content: JSON.stringify(piResult('# Notes\nhello')),
+          state: 'complete',
+        } as Result}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolRead({ target: 'notes.md' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountLines({ count: 2 }))).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText(/# Notes/)).toBeInTheDocument()
+  })
+
+  it('运行中（尚无结果）：执行中指示，不可展开', () => {
+    render(<AgentToolCard part={toolCall('find', { pattern: '**/*.ts' })} />)
+    expect(screen.getByText(m.agent_desktop_toolFind({ target: '**/*.ts' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolRunning())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(trigger()).toHaveAttribute('aria-expanded', 'false')
+  })
+
+  it('错误态（output-error）：失败徽标，展开显示错误原文', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('read', { path: 'secret.txt' }, { state: 'error', output: piResult('ENOENT: no such file') })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolError())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText('ENOENT: no such file')).toBeInTheDocument()
+  })
+
+  it('空结果哨兵：grep 无匹配 → 「无匹配结果」，不可展开', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('grep', { pattern: 'zzz' }, { state: 'complete', output: piResult('No matches found') })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolNoMatches())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(trigger()).toHaveAttribute('aria-expanded', 'false')
+  })
+
+  it('pi 截断提示 → 「已截断」徽标；超过展示上限 → 「还有 N 项未显示」', () => {
+    const many = Array.from({ length: 53 }, (_, i) => `f${i}.txt`).join('\n')
+    render(
+      <AgentToolCard
+        part={toolCall('find', { pattern: '*.txt' }, {
+          state: 'complete',
+          output: piResult(`${many}\n\n[1000 results limit reached]`),
+        })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolTruncated())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText(m.agent_desktop_toolMore({ count: 3 }))).toBeInTheDocument()
+  })
+})