dsh-plugin-core 0.31.0 → 0.33.0

package/dist/adv/session/mirror/GenericCommandCard.js

@@ -0,0 +1,948 @@
+// 官方对照：packages/client/ui-tool/src/client/tool/（0.1.7-rc.2 lib/client.js）。
+// 官方会话里的工具卡 = ui-tool 的 GenericToolCard → ToolRow（chat 包同名文件只是 command 节点兜底，
+// 本文件名沿用历史，实际镜像 GenericToolCard + ToolRow 一套）。
+// 展开体分发链照官方 ToolRow（lib/client.js:1598-1688）：
+//   TerminalBlock（bash/pwsh/terminal_send，maxLines:∞）→ DiffBlock（write/edit，maxLines:9）
+//   → ReadBlock（read，maxLines:8 = 头 4 + 尾 4，中间「… 其余 N 行」）
+//   → SearchBlock（grep/glob，maxLines:8 + 截断 recovery 正文）→ WebBlock（web_search/web_fetch）
+//   → ToolDetails（goal/schedule 两族）→ 兜底 ioCard 灰框（输入/分隔/输出）。
+//   ask_user_question 走 AskQuestionCard，插在整条链之前。
+// 数据模型照官方 models/*（行号为 lib/client.js）：toolRowModel 273、diffCardModel 534、
+//   readCardModel 421、terminalCardModel 929、parseExitStatus 903、hasSpillNotice 692；
+// 摘要与五态同构：state = preparing|running|ok|error|stopped（成功结算但退出码非 0 ⇒ error，1767）；
+//   summary = [generic? 工具名, deriveSummary]，终端卡优先 description；error 态摘要 = 输出首行。
+import { Fragment, createElement as h, useMemo, useState } from 'react';
+import { DiffBlock, DisclosureRow, IconApiOutlineRegular, IconBrowseOutlineRegular, IconCodeOutlineRegular, IconEditOutlineRegular, IconSearchOutlineRegular, IconSparkleRegular, ReadBlock, SearchBlock, TerminalBlock, TextShimmer, WebBlock, diffTotals, } from '../../../ui/official.js';
+import { officialClass } from '../official-classes.js';
+import { CodeViewer } from '../../../ui/display/CodeViewer.js';
+import { markdownLabels } from '../../explorer/preview/md-labels.js';
+import { AskQuestionCardView, askCardModel } from './AskCard.js';
+import { ToolDetailsView, detailsCardModel, detailsSummary } from './ToolDetails.js';
+/** 官方 TOOL_VARIANTS（tool client.js:83-100，cordis_* 一并保留）。 */
+const TOOL_VARIANTS = {
+    bash: 'bash',
+    pwsh: 'bash',
+    read: 'read',
+    read_image: 'read',
+    web_fetch: 'read',
+    web_search: 'search',
+    grep: 'search',
+    glob: 'search',
+    write: 'write',
+    edit: 'edit',
+    run_code: 'code',
+    cordis_package_inspect: 'read',
+    cordis_runtime_inspect: 'read',
+    cordis_run: 'others',
+    cordis_stop: 'others',
+    cordis_undefine: 'others',
+};
+export const classifyTool = (name) => TOOL_VARIANTS[name] ?? 'others';
+/** 官方 VARIANT_TITLE_KEYS + TOOL_TITLE_KEYS（tool client.js:65-149；本仓库键名前缀 toolTitle）。 */
+const VARIANT_TITLE_KEYS = {
+    search: 'toolTitleSearch',
+    read: 'toolTitleRead',
+    bash: 'toolTitleBash',
+    write: 'toolTitleWrite',
+    edit: 'toolTitleEdit',
+    code: 'toolTitleCode',
+    others: 'toolTitleGeneric',
+};
+const TOOL_TITLE_KEYS = {
+    pwsh: 'toolTitlePwsh',
+    read_image: 'toolTitleReadImage',
+    grep: 'toolTitleGrep',
+    glob: 'toolTitleGlob',
+    web_search: 'toolTitleWebSearch',
+    web_fetch: 'toolTitleWebFetch',
+    todo_write: 'toolTitleTodo',
+    ask_user_question: 'toolTitleAsk',
+    cordis_package_inspect: 'toolTitleInspect',
+    cordis_runtime_inspect: 'toolTitleInspect',
+    cordis_run: 'toolTitleRunCordis',
+    cordis_stop: 'toolTitleStopCordis',
+    cordis_undefine: 'toolTitleRemoveCordis',
+    cordis_inspect_list: 'toolTitleInspectProviders',
+    cordis_inspect_query: 'toolTitleQueryRuntime',
+    cordis_inspect_self: 'toolTitleInspectPlugins',
+    create_goal: 'toolTitleCreateGoal',
+    get_goal: 'toolTitleGetGoal',
+    update_goal: 'toolTitleUpdateGoal',
+    schedule_create: 'toolTitleCreateSchedule',
+    schedule_list: 'toolTitleListSchedules',
+    schedule_delete: 'toolTitleDeleteSchedule',
+    schedule_update: 'toolTitleUpdateSchedule',
+    workflow: 'toolTitleWorkflow',
+    ralph: 'toolTitleRalph',
+    session_event_read: 'toolTitleReadEvent',
+    session_event_search: 'toolTitleSearchEvents',
+    session_event_trace: 'toolTitleTraceEvent',
+    session_search: 'toolTitleSearchSessions',
+    session_trace: 'toolTitleTraceSession',
+    list_subagent_models: 'toolTitleListModels',
+    subagent: 'toolTitleSubagent',
+    list_agents: 'toolTitleListAgents',
+    send_message: 'toolTitleSendMessage',
+    interrupt_agent: 'toolTitleInterruptAgent',
+    job_list: 'toolTitleListJobs',
+    job_output: 'toolTitleReadJob',
+    job_kill: 'toolTitleKillJob',
+    terminal_open: 'toolTitleOpenTerminal',
+    terminal_read: 'toolTitleReadTerminal',
+    terminal_list: 'toolTitleListTerminals',
+    terminal_signal: 'toolTitleSignalTerminal',
+    terminal_close: 'toolTitleCloseTerminal',
+    lsp: 'toolTitleLsp',
+    spawn_teammate: 'toolTitleSpawnTeammate',
+    team_task_create: 'toolTitleCreateTeamTask',
+    team_task_get: 'toolTitleGetTeamTask',
+    team_task_update: 'toolTitleUpdateTeamTask',
+    team_task_list: 'toolTitleListTeamTasks',
+    wait_agent: 'toolTitleWaitAgent',
+};
+export const toolTitleKey = (name) => TOOL_TITLE_KEYS[name] ?? VARIANT_TITLE_KEYS[classifyTool(name)];
+/** 官方 VARIANT_ICONS（tool client.js:1749-1757，size 14）。 */
+const VARIANT_ICONS = {
+    search: h(IconSearchOutlineRegular, { size: 14 }),
+    read: h(IconBrowseOutlineRegular, { size: 14 }),
+    bash: h(IconApiOutlineRegular, { size: 14 }),
+    write: h(IconEditOutlineRegular, { size: 14 }),
+    edit: h(IconEditOutlineRegular, { size: 14 }),
+    code: h(IconCodeOutlineRegular, { size: 14 }),
+    others: h(IconSparkleRegular, { size: 14 }),
+};
+/** 官方 SUMMARY_KEYS（tool client.js:204-220）：摘要取参键偏好。 */
+const SUMMARY_KEYS = {
+    bash: ['description', 'command'],
+    read: ['path', 'file_path', 'url'],
+    search: ['query', 'pattern', 'url'],
+    write: ['path', 'file_path'],
+    edit: ['path', 'file_path'],
+    code: ['description'],
+    others: [],
+};
+/** 官方 FILE_PATH_VARIANTS（tool client.js:237-241）：摘要可开预览的文件型变体。 */
+const FILE_PATH_VARIANTS = new Set(['read', 'write', 'edit']);
+const firstLine = (text) => {
+    const nl = text.indexOf('\n');
+    return nl === -1 ? text : text.slice(0, nl);
+};
+/** 官方 parseArgs（tool client.js:186-192）。 */
+const parseArgs = (raw) => {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+};
+const pickString = (args, keys) => {
+    for (const key of keys) {
+        const value = args[key];
+        if (typeof value === 'string' && value !== '')
+            return value;
+    }
+    return undefined;
+};
+/** 官方 deriveSummary（tool client.js:221-233）。 */
+export function deriveSummary(variant, argsRaw) {
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return firstLine(argsRaw);
+    const args = parsed;
+    if (variant === 'search' && Array.isArray(args.queries)) {
+        const queries = args.queries.filter((query) => typeof query === 'string' && query !== '');
+        if (queries.length > 0)
+            return queries.map(firstLine).join(', ');
+    }
+    const picked = pickString(args, SUMMARY_KEYS[variant]);
+    if (picked !== undefined)
+        return firstLine(picked);
+    for (const value of Object.values(args))
+        if (typeof value === 'string' && value !== '')
+            return firstLine(value);
+    return firstLine(argsRaw);
+}
+/** 官方 deriveFilePath（tool client.js:242-248）：read/write/edit 的路径取参。 */
+function deriveFilePath(variant, argsRaw) {
+    if (!FILE_PATH_VARIANTS.has(variant))
+        return undefined;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return undefined;
+    const picked = pickString(parsed, ['path', 'file_path']);
+    return picked === undefined ? undefined : firstLine(picked);
+}
+/** 官方 readCallLine（tool client.js:432-436）：read 的 offset（1 起）就是落点行，参数非法则无行。 */
+export function readCallLine(name, argsRaw) {
+    if (name !== 'read')
+        return undefined;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return undefined;
+    const { file_path, offset, limit } = parsed;
+    if (typeof file_path !== 'string' || file_path.trim() === '')
+        return undefined;
+    if (offset !== undefined && !positiveInteger(offset))
+        return undefined;
+    if (limit !== undefined && !positiveInteger(limit))
+        return undefined;
+    return positiveInteger(offset) ? offset : undefined;
+}
+/** 官方 formatToolBody（tool client.js:255-264）：通用展开体的输入正文。 */
+export function formatToolBody(variant, argsRaw) {
+    if (argsRaw === '')
+        return null;
+    const parsed = parseArgs(argsRaw);
+    if (parsed === undefined)
+        return argsRaw;
+    if (variant === 'code' && typeof parsed === 'object' && parsed !== null) {
+        const code = parsed.code;
+        if (typeof code === 'string' && code !== '')
+            return code;
+    }
+    return JSON.stringify(parsed, null, 2);
+}
+/** 官方 validEscalationFields（tool client.js:347-353）。 */
+function validEscalationFields(args) {
+    const permission = args.sandbox_permissions;
+    const justification = args.justification;
+    if (permission === undefined && justification === undefined)
+        return true;
+    if (permission !== 'workspace-write' && permission !== 'danger-full-access')
+        return false;
+    return typeof justification === 'string' && justification.trim() !== '';
+}
+/** 官方 intendedDiff（tool client.js:460-517）：write/edit/str_replace_editor 的参数侧意图 diff。 */
+function intendedDiff(name, argsRaw) {
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const args = parsed;
+    if (name === 'str_replace_editor') {
+        const { command, path, file_text: fileText, old_str: oldText, new_str: newText } = args;
+        if (typeof path !== 'string' || path.trim() === '')
+            return null;
+        if (command === 'create') {
+            if (fileText !== undefined && typeof fileText !== 'string')
+                return null;
+            return { tool: name, diff: { path, oldText: null, newText: typeof fileText === 'string' ? fileText : '' } };
+        }
+        if (command === 'str_replace') {
+            if (oldText !== undefined && typeof oldText !== 'string')
+                return null;
+            if (newText !== undefined && typeof newText !== 'string')
+                return null;
+            return { tool: name, diff: { path, oldText: typeof oldText === 'string' ? oldText : null, newText: typeof newText === 'string' ? newText : '' } };
+        }
+        return null;
+    }
+    const { file_path: path } = args;
+    if (typeof path !== 'string' || path.trim() === '')
+        return null;
+    if (!validEscalationFields(args))
+        return null;
+    if (name === 'write') {
+        const { content } = args;
+        return typeof content === 'string' ? { tool: name, diff: { path, oldText: null, newText: content } } : null;
+    }
+    if (name !== 'edit')
+        return null;
+    const { old_string: oldText, new_string: newText, replace_all: replaceAll } = args;
+    if (typeof oldText !== 'string' || typeof newText !== 'string')
+        return null;
+    if (replaceAll !== undefined && typeof replaceAll !== 'boolean')
+        return null;
+    return { tool: name, diff: { path, oldText: oldText || null, newText } };
+}
+/** 官方 narrowDiffs（tool client.js:443-459）。 */
+function narrowDiffs(diffs) {
+    if (!Array.isArray(diffs) || diffs.length === 0)
+        return null;
+    const out = [];
+    for (const hunk of diffs) {
+        if (typeof hunk !== 'object' || hunk === null || Array.isArray(hunk))
+            return null;
+        const { path, oldText, newText } = hunk;
+        if (typeof path !== 'string')
+            return null;
+        if (oldText !== null && typeof oldText !== 'string')
+            return null;
+        if (typeof newText !== 'string')
+            return null;
+        out.push({ path, oldText, newText });
+    }
+    return out;
+}
+/** 官方 appliedDiffs（tool client.js:518-524）。 */
+function appliedDiffs(meta) {
+    if (typeof meta !== 'object' || meta === null || Array.isArray(meta))
+        return null;
+    const diffs = meta.diffs;
+    if (!Array.isArray(diffs))
+        return null;
+    if (diffs.length === 0)
+        return 'empty';
+    return narrowDiffs(diffs);
+}
+/** 官方 diffCardModel（tool client.js:534-544；keyed 流里只有根调用，parentCallId 分支略）。 */
+function diffCardModel(name, argsRaw, meta, isError, settled) {
+    const intended = intendedDiff(name, argsRaw);
+    if (intended === null)
+        return null;
+    if (!settled)
+        return [intended.diff];
+    if (name === 'str_replace_editor')
+        return null;
+    if (isError)
+        return null;
+    const applied = appliedDiffs(meta);
+    if (applied === null || applied === 'empty')
+        return name === 'write' ? [intended.diff] : null;
+    return applied;
+}
+const positiveInteger = (value) => typeof value === 'number' && Number.isInteger(value) && value >= 1;
+/** 官方 readMeta（tool client.js:369-395）：宿主写入的读取窗口 meta 收窄。 */
+function readMeta(meta) {
+    if (typeof meta !== 'object' || meta === null || Array.isArray(meta))
+        return null;
+    const { path, offset, lines, totalLines, lang } = meta;
+    if (typeof path !== 'string' || typeof offset !== 'number' || !Number.isInteger(offset) || offset < 1)
+        return null;
+    if (typeof totalLines !== 'number' || !Number.isInteger(totalLines) || totalLines < 0 || !Array.isArray(lines))
+        return null;
+    if (lang !== undefined && typeof lang !== 'string')
+        return null;
+    const narrowed = [];
+    let previous = offset - 1;
+    for (const line of lines) {
+        if (typeof line !== 'object' || line === null || Array.isArray(line))
+            return null;
+        const { number, text } = line;
+        if (typeof number !== 'number' || !Number.isInteger(number) || number < 1 || number <= previous)
+            return null;
+        if (number > totalLines || typeof text !== 'string')
+            return null;
+        previous = number;
+        narrowed.push({ number, text });
+    }
+    return { label: path, lines: narrowed, totalLines: totalLines, ...(lang === undefined ? {} : { lang }) };
+}
+/** 官方 readCardModel（tool client.js:421-435）：read + 合法参数 + meta + 结果 envelope。 */
+function readCardModel(name, argsRaw, output, meta, isError, settled) {
+    if (!settled || isError || name !== 'read')
+        return null;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const { file_path: path, offset, limit } = parsed;
+    if (typeof path !== 'string' || path.trim() === '')
+        return null;
+    if (offset !== undefined && !positiveInteger(offset))
+        return null;
+    if (limit !== undefined && !positiveInteger(limit))
+        return null;
+    const face = readMeta(meta);
+    if (face === null)
+        return null;
+    // 官方结果 envelope（read 工具输出格式）不匹配 ⇒ 走 generic。
+    if (/^<path>[^\n]*<\/path>\n<type>file<\/type>\n<content>\n([\s\S]*)\n<\/content>$/u.exec(output)?.[1] === undefined)
+        return null;
+    return face;
+}
+/** 官方 validInclude（tool client.js:590-597）：逗号分隔的多 pattern include 不收。 */
+function validInclude(include) {
+    if (include.trim() === '' || include.startsWith('!'))
+        return false;
+    let braceDepth = 0;
+    for (const character of include) {
+        if (character === '{')
+            braceDepth += 1;
+        else if (character === '}')
+            braceDepth = Math.max(0, braceDepth - 1);
+        else if (character === ',' && braceDepth === 0)
+            return false;
+    }
+    return true;
+}
+/** 官方 validSearchCall（tool client.js:575-589）。 */
+function validSearchCall(name, argsRaw) {
+    if (name !== 'grep' && name !== 'glob')
+        return null;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const { pattern, path, include } = parsed;
+    if (typeof pattern !== 'string')
+        return null;
+    if (name === 'grep' && pattern === '')
+        return null;
+    if (name === 'glob' && pattern.trim() === '')
+        return null;
+    if (path !== undefined && (typeof path !== 'string' || path.trim() === ''))
+        return null;
+    if (name === 'grep' && include !== undefined && (typeof include !== 'string' || !validInclude(include)))
+        return null;
+    return name;
+}
+/** 官方 searchFiles（tool client.js:598-622）：meta.files 收窄。 */
+function searchFiles(value) {
+    if (!Array.isArray(value))
+        return null;
+    const files = [];
+    for (const file of value) {
+        if (typeof file !== 'object' || file === null || Array.isArray(file))
+            return null;
+        const { path, matches } = file;
+        if (typeof path !== 'string' || !Array.isArray(matches))
+            return null;
+        const narrowed = [];
+        for (const match of matches) {
+            if (typeof match !== 'object' || match === null || Array.isArray(match))
+                return null;
+            const { lineNumber, line } = match;
+            if (typeof lineNumber !== 'number' || !Number.isInteger(lineNumber) || lineNumber < 1)
+                return null;
+            if (typeof line !== 'string')
+                return null;
+            narrowed.push({ lineNumber, line });
+        }
+        files.push({ path, matches: narrowed });
+    }
+    return files;
+}
+/**
+ * 官方 searchCardModel（tool client.js:632-667）：结算成功 + meta.{truncated,total} 齐全才出卡，
+ * 否则落回 ioCard 兜底（与官方 generic 路径一致）。
+ */
+export function searchCardModel(name, argsRaw, output, meta, isError, settled) {
+    if (!settled || isError)
+        return null;
+    const tool = validSearchCall(name, argsRaw);
+    if (tool === null)
+        return null;
+    if (typeof meta !== 'object' || meta === null || Array.isArray(meta))
+        return null;
+    const m = meta;
+    if (typeof m.truncated !== 'boolean')
+        return null;
+    if (typeof m.total !== 'number' || !Number.isInteger(m.total) || m.total < 0)
+        return null;
+    const common = { total: m.total, truncated: m.truncated };
+    // 官方 recovery = flattenContent(block.content)：截断时把完整正文摊在卡下方。
+    const recovery = m.truncated && output !== '' ? output : undefined;
+    if (tool === 'grep') {
+        if (m.shape !== 'matches')
+            return null;
+        const files = searchFiles(m.files);
+        return files === null ? null : { card: { kind: 'matches', files, ...common }, ...(recovery === undefined ? {} : { recovery }) };
+    }
+    if (m.shape !== 'paths' || !Array.isArray(m.paths))
+        return null;
+    if (!m.paths.every(path => typeof path === 'string'))
+        return null;
+    return { card: { kind: 'paths', paths: [...m.paths], ...common }, ...(recovery === undefined ? {} : { recovery }) };
+}
+/** 官方 validWebCall（tool client.js:1024-1045）。 */
+function validWebCall(name, argsRaw) {
+    if (name !== 'web_search' && name !== 'web_fetch')
+        return null;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const args = parsed;
+    if (name === 'web_search') {
+        const { queries } = args;
+        if (!Array.isArray(queries) || queries.length === 0)
+            return null;
+        return queries.every(query => typeof query === 'string' && query.trim() !== '') ? name : null;
+    }
+    const { url } = args;
+    return typeof url === 'string' && url.trim() !== '' ? name : null;
+}
+/** 官方 webSources（tool client.js:1046-1064）：meta.sources 收窄（可选字段缺省即不带）。 */
+function webSources(value) {
+    if (!Array.isArray(value))
+        return null;
+    const sources = [];
+    for (const source of value) {
+        if (typeof source !== 'object' || source === null || Array.isArray(source))
+            return null;
+        const { url, title, snippet, publishedAt } = source;
+        if (typeof url !== 'string')
+            return null;
+        if (title !== undefined && typeof title !== 'string')
+            return null;
+        if (snippet !== undefined && typeof snippet !== 'string')
+            return null;
+        if (publishedAt !== undefined && typeof publishedAt !== 'string')
+            return null;
+        sources.push({
+            url,
+            ...(title === undefined ? {} : { title }),
+            ...(snippet === undefined ? {} : { snippet }),
+            ...(publishedAt === undefined ? {} : { publishedAt }),
+        });
+    }
+    return sources;
+}
+/** 官方 webCardModel（tool client.js:1070-1094）。 */
+export function webCardModel(name, argsRaw, meta, isError, settled) {
+    if (!settled || isError)
+        return null;
+    const tool = validWebCall(name, argsRaw);
+    if (tool === null || typeof meta !== 'object' || meta === null || Array.isArray(meta))
+        return null;
+    const m = meta;
+    if (typeof m.truncated !== 'boolean')
+        return null;
+    if (tool === 'web_search') {
+        const sources = webSources(m.sources);
+        if (sources === null || (m.answer !== undefined && typeof m.answer !== 'string'))
+            return null;
+        return { kind: 'search', ...(typeof m.answer === 'string' ? { answer: m.answer } : {}), sources, truncated: m.truncated };
+    }
+    if (typeof m.url !== 'string')
+        return null;
+    if (typeof m.statusCode !== 'number' || !Number.isInteger(m.statusCode))
+        return null;
+    return { kind: 'fetch', url: m.url, statusCode: m.statusCode, truncated: m.truncated };
+}
+/** 官方 shellCall（tool client.js:831-855）：无 description = persistent（结算走 generic）。 */
+export function shellCall(name, args) {
+    if (name !== 'bash' && name !== 'pwsh')
+        return null;
+    const { command, description, timeoutMs, workdir, run_in_background: background } = args;
+    if (typeof command !== 'string' || command.trim() === '')
+        return null;
+    if (timeoutMs !== undefined && (typeof timeoutMs !== 'number' || !Number.isFinite(timeoutMs) || timeoutMs <= 0))
+        return null;
+    if (workdir !== undefined && typeof workdir !== 'string')
+        return null;
+    if (background !== undefined && typeof background !== 'boolean')
+        return null;
+    if (!validEscalationFields(args))
+        return null;
+    if (description === undefined)
+        return { command, description: '', workdir: undefined, persistent: true, background: false };
+    if (typeof description !== 'string' || description.trim() === '')
+        return null;
+    return { command, description, workdir, persistent: false, background: background === true };
+}
+/** 官方 terminalSendCall（tool client.js:884-896）。 */
+function terminalSendCall(name, args) {
+    if (name !== 'terminal_send')
+        return null;
+    const { sessionId, text, run_in_background: background } = args;
+    if (typeof sessionId !== 'string' || sessionId === '' || typeof text !== 'string')
+        return null;
+    if (background !== undefined && typeof background !== 'boolean')
+        return null;
+    return { text, sessionId, background: background === true };
+}
+/** 官方 parseExitStatus（tool client.js:903-918）：结果尾部退出码 / 信号标记剥离。 */
+function parseExitStatus(text) {
+    const signal = /\n\[killed by signal: ([^\]\n]+)\]$/.exec(text);
+    if (signal?.[1] !== undefined)
+        return { output: text.slice(0, signal.index), signal: signal[1] };
+    const exit = /\n\[exit code: (\d+)\]$/.exec(text);
+    if (exit?.[1] !== undefined)
+        return { output: text.slice(0, exit.index), exitCode: Number(exit[1]) };
+    return { output: text, exitCode: 0 };
+}
+/**
+ * 官方 spill notice 识别（spill-policy notice.ts，tool client.js:660-703）：
+ * 结尾 `)` + 「\n\n( Full formatted result stored at: 」段。超长输出被 spill 化的
+ * bash 结果走 generic（官方 isSpilledShellCall 同向；此处放宽为字面匹配，宁滥勿漏）。
+ */
+export function hasSpillNotice(text) {
+    if (!text.endsWith(')'))
+        return false;
+    return text.includes('\n\n( Full formatted result stored at: ');
+}
+/** 官方 resolveTerminalCwd + normalizeSegments（tool client.js:776-798）的显示用简化版：
+ *  弹窗侧拿不到会话 cwd ⇒ 绝对路径原样、相对路径弹出 `.`/`..` 段。 */
+function normalizeSegments(path) {
+    if (!/(?:^|[/\\])\.\.?(?:[/\\]|$)/.test(path))
+        return path;
+    const out = [];
+    for (const segment of path.split(/[/\\]+/)) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            out.pop();
+            continue;
+        }
+        out.push(segment);
+    }
+    return out.join('/');
+}
+/** 官方 terminalCardModel（tool client.js:929-968）：running 半截返回 running 卡。 */
+export function terminalCardModel(name, argsRaw, output, isError, settled) {
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const args = parsed;
+    const shell = shellCall(name, args);
+    const send = shell === null ? terminalSendCall(name, args) : null;
+    if (shell === null && send === null)
+        return null;
+    if (shell?.background || send?.background)
+        return null;
+    if (!settled) {
+        return shell !== null
+            ? { command: shell.command, cwd: shell.workdir === undefined ? undefined : normalizeSegments(shell.workdir), running: true }
+            : { command: send.text, running: true, sessionId: send.sessionId };
+    }
+    if (isError || shell?.persistent || hasSpillNotice(output))
+        return null;
+    if (send !== null)
+        return { command: send.text, running: false, sessionId: send.sessionId };
+    const shellCmd = shell;
+    const status = parseExitStatus(output);
+    return {
+        command: shellCmd.command,
+        cwd: shellCmd.workdir === undefined ? undefined : normalizeSegments(shellCmd.workdir),
+        output: status.output,
+        exitCode: status.exitCode,
+        signal: status.signal,
+        running: false,
+    };
+}
+/** 官方 contentKilobytes（tool client.js:2632-2645）静态参数版：content/old_string/new_string 字符数 / 1024。
+ *  shortcut: 官方按流式 stringLength 增量算，弹窗只有 argsRaw 全量串 ⇒ 按已到字段总长估算。 */
+function contentKilobytes(argsRaw) {
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const args = parsed;
+    let chars = 0;
+    let any = false;
+    for (const key of ['content', 'old_string', 'new_string']) {
+        const value = args[key];
+        if (typeof value === 'string') {
+            any = true;
+            chars += value.length;
+        }
+    }
+    return any ? Math.ceil(chars / 1024) : null;
+}
+/** 官方 todo 行摘要（tool client.js:4480-4503）：done/total + 首个 in_progress 内容，
+ *  多条并行 in_progress ⇒ 额外条数走 summarySuffix「+N」。 */
+function todoSummary(argsRaw, t) {
+    if (argsRaw === '')
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(argsRaw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const todos = parsed.todos;
+    if (!Array.isArray(todos) || !todos.every(item => typeof item === 'object' && item !== null))
+        return null;
+    const list = todos;
+    const done = list.filter(item => item.status === 'completed').length;
+    const active = list.filter(item => item.status === 'in_progress');
+    const first = active[0]?.content;
+    const named = typeof first === 'string' && first.trim() !== '';
+    const head = t('todoCompleted', { done, total: list.length });
+    return { text: named ? `${head} · ${first}` : head, extra: named ? active.length - 1 : 0 };
+}
+/** 词典：代码工具栏（官方 codeToolbarLabels，tool client.js:1098-1104）。 */
+const codeToolbarLabels = (t) => ({
+    codeLabel: t('codeBlockLabel'),
+    wrapLabel: t('diffWrapLabel'),
+    unwrapLabel: t('diffUnwrapLabel'),
+});
+/** 官方 diffBlockLabels（tool client.js:1125-1135）。 */
+const diffLabels = (t) => ({
+    ...codeToolbarLabels(t),
+    copy: t('copyLabel'),
+    copied: t('copiedLabel'),
+    collapseAria: t('diffCollapseAria'),
+    expandAria: (count) => t('diffExpandAria', { count }),
+    collapse: t('collapseLabel'),
+    expand: (count) => t('diffExpandRest', { count }),
+});
+/** 官方 readBlockLabels（tool client.js:1141-1155）。 */
+const readLabels = (t) => ({
+    ...codeToolbarLabels(t),
+    window: (shown, total) => t('readWindow', { shown, total }),
+    copy: t('copyLabel'),
+    copied: t('copiedLabel'),
+    collapseAria: t('readCollapseAria'),
+    expandAria: (count) => t('readExpandAria', { count }),
+    collapse: t('collapseLabel'),
+    expand: (count) => t('readExpandRest', { count }),
+});
+/** 官方 searchBlockLabels（tool client.js:1222-1240）。 */
+const searchLabels = (t) => ({
+    pathsSummary: (shown, total, truncated) => truncated
+        ? t('searchPathsTruncated', { shown, total })
+        : t('searchPaths', { shown }),
+    matchesSummary: (shown, total, files, truncated) => truncated
+        ? t('searchMatchesTruncated', { shown, total, files })
+        : t('searchMatches', { shown, files }),
+    copy: t('copyLabel'),
+    copied: t('copiedLabel'),
+    noResults: t('searchNoResults'),
+    collapseAria: t('searchCollapseAria'),
+    expandAria: (count) => t('searchExpandAria', { count }),
+    collapse: t('collapseLabel'),
+    expand: (count) => t('searchExpandRest', { count }),
+});
+/** 官方 webBlockLabels（tool client.js:1247-1255）；markdown 复用 core 的 MarkdownText 文案。 */
+const webLabels = (t) => ({
+    noResults: t('webNoResults'),
+    sourcesTruncated: t('webSourcesTruncated'),
+    http: t('webHttp'),
+    contentTruncated: t('webContentTruncated'),
+    markdown: markdownLabels(),
+});
+/** 官方 terminalBlockLabels（tool client.js:708-737 的键面）。 */
+export const terminalLabels = (t) => ({
+    // 官方 terminalBlockLabels（ui-tool terminal-card-model.ts）：commandLine 是**函数**，
+    // TerminalBlock 会调它给输出行编号。缺它就抛 `w.commandLine is not a function`（真机 2026-10-23 崩溃）。
+    commandLine: (line) => t('terminalCommandLine', { n: line }),
+    signal: (signal) => t('terminalSignal', { signal }),
+    exitCode: (code) => t('terminalExitCode', { code }),
+    noExitCode: t('terminalNoExitCode'),
+    running: t('terminalRunning'),
+    failed: t('terminalFailed'),
+    done: t('terminalDone'),
+    copy: t('copyLabel'),
+    copied: t('copiedLabel'),
+    noOutput: t('terminalNoOutput'),
+    collapseAria: t('terminalCollapseAria'),
+    collapse: t('collapseLabel'),
+    expandAria: (hidden) => t('terminalExpandAria', { n: hidden }),
+    expand: (hidden) => t('terminalExpandRest', { n: hidden }),
+});
+/** 摘要链接（官方 fileLink）：点击只跟随、不折叠行。 */
+const stopLinkClick = (event) => { event.stopPropagation(); };
+/** 官方 summaryLinkKeyDown：Enter/空格不触发行折叠（链接自身仍可达）。 */
+const summaryLinkKeyDown = (event) => {
+    if (event.key === 'Enter' || event.key === ' ')
+        event.stopPropagation();
+};
+/** 官方 ExitCodeBadge（tool client.js:1517-1522）：中性胶囊 + 失败点 + 本地化退出状态。 */
+export function ExitCodeBadge({ label }) {
+    return h('span', { className: officialClass('ExitCodeBadge', 'badge') ?? '' }, h('span', { className: officialClass('ExitCodeBadge', 'dot') ?? '', 'aria-hidden': true }), label);
+}
+/**
+ * 工具调用 / 命令卡（官方 GenericToolCard + ToolRow 镜像）。
+ * 折叠行 = 图标 + 标题 [+ 分隔点 + 摘要（文件路径链接化）+ 后缀]；展开体按官方分发链。
+ */
+export function GenericCommandCard(props) {
+    const { name, argsRaw, output, isError, meta, settled = true, phase, interrupted, errorCode, onOpenFile, t } = props;
+    const [expanded, setExpanded] = useState(false);
+    const variant = classifyTool(name);
+    const titleKey = toolTitleKey(name);
+    const state = !settled
+        ? (phase === 'preparing' ? 'preparing' : 'running')
+        : interrupted ? 'stopped' : isError ? 'error' : 'ok';
+    const terminalFace = useMemo(() => terminalCardModel(name, argsRaw, output, isError, settled), [name, argsRaw, output, isError, settled]);
+    const read = useMemo(() => readCardModel(name, argsRaw, output, meta, isError, settled), [name, argsRaw, output, meta, isError, settled]);
+    const diffs = useMemo(() => diffCardModel(name, argsRaw, meta, isError, settled), [name, argsRaw, meta, isError, settled]);
+    const search = useMemo(() => searchCardModel(name, argsRaw, output, meta, isError, settled), [name, argsRaw, output, meta, isError, settled]);
+    const web = useMemo(() => webCardModel(name, argsRaw, meta, isError, settled), [name, argsRaw, meta, isError, settled]);
+    const ask = useMemo(() => askCardModel(name, argsRaw, output, errorCode, settled, t), [name, argsRaw, output, errorCode, settled, t]);
+    const details = useMemo(() => detailsCardModel(name, argsRaw, output, settled, isError, t), [name, argsRaw, output, settled, isError, t]);
+    // 终端卡展开体（官方 localizeTerminalCardModel：send 命令空 = （发送输入），描述 = 终端 {sessionId}）。
+    const terminal = useMemo(() => {
+        if (terminalFace === null)
+            return null;
+        return terminalFace.sessionId !== undefined
+            ? { ...terminalFace, command: terminalFace.command === '' ? t('terminalSendInput') : terminalFace.command, description: t('terminalSession', { sessionId: terminalFace.sessionId }) }
+            : terminalFace;
+    }, [terminalFace, t]);
+    // 官方 terminalFailed（tool client.js:763-766）：成功结算但退出码非 0 / 有信号 ⇒ 整行 error。
+    const failedTerminal = terminal !== null && terminal.running !== true
+        && ((terminal.exitCode !== undefined && terminal.exitCode !== 0) || terminal.signal !== undefined);
+    // 官方 AskQuestionRow 强制态（2298-2316）：取消 ⇒ ok、中断 ⇒ stopped，优先于 error。
+    const rowState = ask?.state ?? (state === 'ok' && failedTerminal ? 'error' : state);
+    const running = rowState === 'running' || rowState === 'preparing';
+    // 摘要（官方 toolRowModel 273-295 + ToolRow 1527-1528）：generic 标题补工具名；
+    // 终端卡优先 description；error 态摘要 = 输出首行。
+    const generic = titleKey === 'toolTitleGeneric';
+    const base = argsRaw === '' ? '' : deriveSummary(variant, argsRaw);
+    const plainSummary = [generic ? name : '', base].filter(Boolean).join(' · ');
+    const todoInfo = name === 'todo_write' ? todoSummary(argsRaw, t) : null;
+    const detailsText = details === null ? undefined : detailsSummary(details);
+    const normalSummary = ask !== null ? ask.summary : detailsText ?? (todoInfo !== null ? todoInfo.text : terminal?.description ?? plainSummary);
+    const errorSummary = rowState === 'error' && output !== '' ? firstLine(output) : null;
+    // 官方 terminalExitLabel（tool client.js:801-809）：已失败前台命令才出退出码徽章。
+    const exitLabel = failedTerminal
+        ? terminal?.signal !== undefined
+            ? t('terminalSignal', { signal: terminal.signal })
+            : terminal?.exitCode === undefined || terminal.exitCode === null
+                ? t('terminalNoExitCode')
+                : t('terminalExitCode', { code: terminal.exitCode })
+        : null;
+    const summaryText = (rowState === 'error' && exitLabel === null ? errorSummary ?? normalSummary : null) ?? normalSummary;
+    // 官方 ToolRow 两个独立后缀槽（1600-1602）：summarySuffix（edit/write 内容 KB）与 diffStat（+N -M）。
+    const totals = diffs === null ? null : diffTotals(diffs);
+    const settledWithCue = rowState === 'error' || rowState === 'stopped';
+    const kilobytes = variant === 'edit' || variant === 'write' ? contentKilobytes(argsRaw) : null;
+    const summarySuffix = settledWithCue
+        ? null
+        : todoInfo !== null
+            ? (todoInfo.extra > 0 ? `+${todoInfo.extra}` : null)
+            : (kilobytes === null || summaryText === '' ? null : t('toolPreparingContent', { kilobytes }));
+    const diffStatTotals = settledWithCue ? null : totals;
+    // 官方 fileLink（1536-1545）：read/write/edit 摘要路径 + onOpenFile + 非 error/stopped ⇒ 链接钮。
+    const filePath = argsRaw === '' ? undefined : deriveFilePath(variant, argsRaw);
+    // 官方 readCallLine（tool client.js:432-436）：read 的 offset 就是落点行，链接可带过去。
+    const filePathLine = filePath === undefined ? undefined : readCallLine(name, argsRaw);
+    const openFile = filePath !== undefined && onOpenFile !== undefined && !settledWithCue
+        ? () => {
+            if (filePathLine === undefined)
+                onOpenFile(filePath);
+            else
+                onOpenFile(filePath, { line: filePathLine });
+        }
+        : undefined;
+    // 官方 linkHref（tool client.js:1100-1110）：web_fetch 且 args.url 为 http(s) ⇒ 摘要外链。
+    const linkHref = (() => {
+        if (name !== 'web_fetch' || settledWithCue)
+            return undefined;
+        const parsed = parseArgs(argsRaw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return undefined;
+        const url = parsed.url;
+        if (typeof url !== 'string')
+            return undefined;
+        try {
+            const { protocol } = new URL(url);
+            return protocol === 'http:' || protocol === 'https:' ? url : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    // 展开体（官方 1514-1550）：input/output/card 三源；bodyText 仅展开且无专属卡时格式化。
+    // 官方 singleFile（1876/1885）：摘要已是文件路径链接的工具（read）不再摊原始输入 JSON。
+    const inputRaw = argsRaw === '' || filePath !== undefined ? null : argsRaw;
+    const outputText = output === '' ? null : output;
+    const card = terminal !== null ? 'terminal' : diffs !== null ? 'diff' : read !== null ? 'read' : search !== null ? 'search' : web !== null ? 'web' : details !== null ? 'details' : null;
+    const bodyText = expanded && card === null && inputRaw !== null ? formatToolBody(variant, inputRaw) : null;
+    const cardBody = variant === 'code' ? null : bodyText;
+    const expandable = rowState !== 'preparing' && (inputRaw !== null || outputText !== null || card !== null);
+    const open = expanded && expandable;
+    const blockLabels = useMemo(() => ({
+        diff: diffLabels(t),
+        read: readLabels(t),
+        search: searchLabels(t),
+        web: webLabels(t),
+        terminal: terminalLabels(t),
+    }), [t]);
+    const statusText = rowState === 'preparing' ? t('rowPreparing')
+        : rowState === 'running' ? t('rowRunning')
+            : rowState === 'error' ? t('rowFailed')
+                : rowState === 'stopped' ? t('rowStopped')
+                    : null;
+    const summaryClassName = `${officialClass('ToolRow', 'summary') ?? ''}${rowState === 'error' ? ` ${officialClass('ToolRow', 'errorSummary') ?? ''}` : ''}${rowState === 'stopped' ? ` ${officialClass('ToolRow', 'stoppedSummary') ?? ''}` : ''}`;
+    const collapsedContent = summaryText === '' ? undefined : h(Fragment, null, h('span', { className: officialClass('ToolRow', 'sep') ?? '', 'aria-hidden': true }), openFile !== undefined
+        ? h('button', {
+            type: 'button',
+            className: officialClass('ToolRow', 'fileLink') ?? '',
+            onClick: (event) => { stopLinkClick(event); openFile(); },
+        }, h(TextShimmer, { active: running }, summaryText))
+        : linkHref !== undefined
+            ? h('a', {
+                className: officialClass('ToolRow', 'fileLink') ?? '',
+                href: linkHref,
+                target: '_blank',
+                rel: 'noopener noreferrer',
+                onClick: (event) => { event.stopPropagation(); },
+                onKeyDown: summaryLinkKeyDown,
+            }, h(TextShimmer, { active: running }, summaryText))
+            : h('span', { className: summaryClassName }, h(TextShimmer, { active: running }, summaryText)), exitLabel !== null ? h(ExitCodeBadge, { label: exitLabel }) : null, summarySuffix !== null
+        ? h(TextShimmer, {
+            className: officialClass('ToolRow', 'summarySuffix') ?? '',
+            active: running,
+        }, summarySuffix)
+        : null, diffStatTotals !== null
+        ? h(TextShimmer, {
+            className: `${officialClass('ToolRow', 'summarySuffix') ?? ''} ${officialClass('ToolRow', 'diffStat') ?? ''}`,
+            active: running,
+        }, h('span', { className: officialClass('ToolRow', 'diffAdded') ?? '' }, `+${diffStatTotals.added}`), ' ', h('span', { className: officialClass('ToolRow', 'diffRemoved') ?? '' }, `-${diffStatTotals.removed}`))
+        : null);
+    const expandedContent = open ? h('div', { className: officialClass('ToolRow', 'bodyWrap') ?? '' }, ask?.card !== undefined
+        ? h(AskQuestionCardView, { card: ask.card })
+        : terminal !== null
+            ? h(TerminalBlock, {
+                command: terminal.command,
+                cwd: terminal.cwd,
+                output: terminal.output,
+                exitCode: terminal.exitCode,
+                signal: terminal.signal,
+                running: terminal.running,
+                maxLines: Infinity,
+                labels: blockLabels.terminal,
+                className: officialClass('ToolRow', 'terminalBody') ?? '',
+            })
+            : diffs !== null
+                ? h(DiffBlock, { diffs, labels: blockLabels.diff, maxLines: 9, className: officialClass('ToolRow', 'diffBody') ?? '' })
+                : read !== null
+                    ? h(ReadBlock, {
+                        label: read.label,
+                        lines: read.lines,
+                        totalLines: read.totalLines,
+                        lang: read.lang,
+                        labels: blockLabels.read,
+                        maxLines: 8,
+                        className: officialClass('ToolRow', 'readBody') ?? '',
+                    })
+                    : search !== null
+                        ? h(Fragment, null, h(SearchBlock, {
+                            ...search.card,
+                            labels: blockLabels.search,
+                            maxLines: 8,
+                            className: officialClass('ToolRow', 'searchBody') ?? '',
+                        }), search.recovery !== undefined
+                            ? h('div', { className: officialClass('ToolRow', 'searchRecovery') ?? '' }, search.recovery)
+                            : null)
+                        : web !== null
+                            ? h(WebBlock, { ...web, labels: blockLabels.web, className: officialClass('ToolRow', 'webBody') ?? '' })
+                            : details !== null
+                                ? h(ToolDetailsView, { model: details, t, onOpenFile })
+                                : h(Fragment, null, variant === 'code' && bodyText !== null
+                                    ? h('div', { className: officialClass('ToolRow', 'bodyScroll') ?? '' }, h(CodeViewer, {
+                                        text: bodyText,
+                                        path: 'tool-code.ts',
+                                        t,
+                                        className: officialClass('ToolRow', 'codeBody') ?? '',
+                                        height: 'auto',
+                                        style: { height: 'auto' },
+                                    }))
+                                    : null, (cardBody !== null || outputText !== null) && h('div', { className: officialClass('ToolRow', 'ioCard') ?? '' }, cardBody !== null && h('div', { className: officialClass('ToolRow', 'ioSection') ?? '' }, h('span', { className: officialClass('ToolRow', 'ioLabel') ?? '' }, t('toolInputLabel')), h('span', { className: officialClass('ToolRow', 'ioText') ?? '' }, cardBody)), cardBody !== null && outputText !== null
+                                    && h('span', { className: officialClass('ToolRow', 'ioDivider') ?? '', 'aria-hidden': true }), outputText !== null && h('div', { className: officialClass('ToolRow', 'ioSection') ?? '' }, h('span', { className: officialClass('ToolRow', 'ioLabel') ?? '' }, t('toolOutputLabel')), h('span', { className: officialClass('ToolRow', 'ioText') ?? '', 'data-error': rowState === 'error' || undefined }, outputText))))) : undefined;
+    return h('div', {
+        className: officialClass('ToolRow', 'root') ?? '',
+        'data-variant': variant,
+        'data-tool': name,
+        'data-state': rowState,
+    }, statusText !== null
+        ? h('span', { className: officialClass('ToolRow', 'visuallyHidden') ?? '' }, statusText)
+        : null, h(DisclosureRow, {
+        rowClassName: officialClass('ToolRow', 'row') ?? '',
+        leadingClassName: officialClass('ToolRow', 'leading') ?? '',
+        titleClassName: officialClass('ToolRow', 'title') ?? '',
+        icon: VARIANT_ICONS[variant],
+        title: t(titleKey),
+        running,
+        open,
+        expandable,
+        expandOnRowClick: true,
+        keepContentWhenOpen: true,
+        onToggle: () => { setExpanded(value => !value); },
+        collapsedContent,
+        children: expandedContent,
+    }));
+}
+//# sourceMappingURL=GenericCommandCard.js.map