@yeaft/webchat-agent 0.1.1016 → 0.1.1018

package/yeaft/tools/grep.js

@@ -142,7 +142,8 @@ async function nodeGrep(pattern, searchPath, options) {
 
 export default defineTool({
   name: 'Grep',
-  description: `Search file contents for a regex pattern.
+  description: {
+    en: `Search file contents for a regex pattern.
 
 Uses ripgrep (rg) when available for fast searching, with a Node.js fallback.
 
@@ -156,53 +157,101 @@ Guidelines:
 - Use glob or type filters to narrow the search
 - Skips binary files and common large directories (node_modules, .git)
 - Results are limited to 500 matches by default`,
+    zh: `用正则表达式搜索文件内容。
+
+优先使用 ripgrep (rg) 快速搜索，回退到 Node.js 实现。
+
+输出模式：
+- "content" — 显示匹配行，含文件路径和行号
+- "files_with_matches" — 仅显示匹配的文件路径（默认）
+- "count" — 显示每个文件的匹配数量
+
+使用指南：
+- 使用正则语法（特殊字符需转义：\\.、\\{ 等）
+- 用 glob 或 type 过滤缩小搜索范围
+- 跳过二进制文件和常见大目录（node_modules、.git）
+- 默认结果限制 500 条`
+  },
   parameters: {
     type: 'object',
     properties: {
       pattern: {
         type: 'string',
-        description: 'Regex pattern to search for',
+        description: {
+          en: 'Regex pattern to search for',
+          zh: '要搜索的正则表达式模式',
+        },
       },
       path: {
         type: 'string',
-        description: 'File or directory to search (default: cwd)',
+        description: {
+          en: 'File or directory to search (default: cwd)',
+          zh: '要搜索的文件或目录（默认当前工作目录）',
+        },
       },
       output_mode: {
         type: 'string',
         enum: ['content', 'files_with_matches', 'count'],
-        description: 'Output format (default: "files_with_matches")',
+        description: {
+          en: 'Output format (default: "files_with_matches")',
+          zh: '输出格式（默认 "files_with_matches"）',
+        },
       },
       glob: {
         type: 'string',
-        description: 'Glob filter for file names (e.g. "*.js", "*.{ts,tsx}")',
+        description: {
+          en: 'Glob filter for file names (e.g. "*.js", "*.{ts,tsx}")',
+          zh: '文件名 glob 过滤（如 "*.js"、"*.{ts,tsx}"）',
+        },
       },
       type: {
         type: 'string',
-        description: 'File type filter (e.g. "js", "py", "rust")',
+        description: {
+          en: 'File type filter (e.g. "js", "py", "rust")',
+          zh: '文件类型过滤（如 "js"、"py"、"rust"）',
+        },
       },
       case_insensitive: {
         type: 'boolean',
-        description: 'Case-insensitive search (default: false)',
+        description: {
+          en: 'Case-insensitive search (default: false)',
+          zh: '不区分大小写搜索（默认 false）',
+        },
       },
       context: {
         type: 'number',
-        description: 'Lines of context around matches (for "content" mode)',
+        description: {
+          en: 'Lines of context around matches (for "content" mode)',
+          zh: '匹配行周围的上下文行数（用于 "content" 模式）',
+        },
       },
       before: {
         type: 'number',
-        description: 'Lines before each match',
+        description: {
+          en: 'Lines before each match',
+          zh: '每个匹配之前显示的行数',
+        },
       },
       after: {
         type: 'number',
-        description: 'Lines after each match',
+        description: {
+          en: 'Lines after each match',
+          zh: '每个匹配之后显示的行数',
+        },
       },
       multiline: {
         type: 'boolean',
-        description: 'Enable multiline matching',
+        description: {
+          en: 'Enable multiline matching',
+          zh: '启用多行匹配',
+        },
       },
       head_limit: {
         type: 'number',
-        description: 'Limit output to first N results (default: 250)',
+        description: {
+          en: 'Limit output to first N results (default: 250)',
+          zh: '限制输出前 N 条结果（默认 250）',
+        },
       },
     },
     required: ['pattern'],

package/yeaft/tools/history-search.js

@@ -10,22 +10,35 @@ import { searchMessages } from '../conversation/search.js';
 
 export default defineTool({
   name: 'HistorySearch',
-  description: `Search through past conversation history.
+  description: {
+    en: `Search through past conversation history.
 
 Searches for keywords in previously persisted conversation messages.
 Useful for finding previous discussions, decisions, or code snippets.
 
 Results are returned newest-first with message role and content.`,
+    zh: `搜索历史对话记录。
+
+在已持久化的对话消息中按关键词搜索。用于查找之前的讨论、决策或代码片段。
+
+结果按最新优先返回，包含消息角色和内容。`
+  },
   parameters: {
     type: 'object',
     properties: {
       keyword: {
         type: 'string',
-        description: 'Search keyword (case-insensitive)',
+        description: {
+          en: 'Search keyword (case-insensitive)',
+          zh: '搜索关键词（不区分大小写）',
+        },
       },
       limit: {
         type: 'number',
-        description: 'Maximum number of results (default: 20)',
+        description: {
+          en: 'Maximum number of results (default: 20)',
+          zh: '最多返回结果数（默认 20）',
+        },
       },
     },
     required: ['keyword'],

package/yeaft/tools/image-generation.js

@@ -8,7 +8,8 @@ import { defineTool } from './types.js';
 
 export default defineTool({
   name: 'ImageGeneration',
-  description: `Generate an image from a text description.
+  description: {
+    en: `Generate an image from a text description.
 
 Uses a configured image generation API to create images.
 Requires an image generation API endpoint in config.
@@ -17,21 +18,39 @@ Guidelines:
 - Provide detailed, specific descriptions for best results
 - Specify style, composition, and mood
 - Images are saved to the working directory`,
+    zh: `根据文字描述生成图片。
+
+使用配置的图片生成 API 创建图片。需要配置中设置图片生成 API 端点。
+
+使用指南：
+- 提供详细具体的描述以获得最佳效果
+- 指定风格、构图和氛围
+- 图片保存到工作目录`
+  },
   parameters: {
     type: 'object',
     properties: {
       prompt: {
         type: 'string',
-        description: 'Text description of the image to generate',
+        description: {
+          en: 'Text description of the image to generate',
+          zh: '要生成图像的文本描述',
+        },
       },
       output_path: {
         type: 'string',
-        description: 'File path to save the generated image',
+        description: {
+          en: 'File path to save the generated image',
+          zh: '保存生成图像的文件路径',
+        },
       },
       size: {
         type: 'string',
         enum: ['256x256', '512x512', '1024x1024'],
-        description: 'Image size (default: "1024x1024")',
+        description: {
+          en: 'Image size (default: "1024x1024")',
+          zh: '图像大小（默认 "1024x1024"）',
+        },
       },
     },
     required: ['prompt'],

package/yeaft/tools/js-repl.js

@@ -53,7 +53,8 @@ function getContext() {
 
 export const jsRepl = defineTool({
   name: 'JsRepl',
-  description: `Evaluate JavaScript code in a persistent REPL environment.
+  description: {
+    en: `Evaluate JavaScript code in a persistent REPL environment.
 
 The REPL context persists across calls — variables and functions
 defined in one call are available in subsequent calls.
@@ -66,16 +67,34 @@ Guidelines:
 - console.log output is captured and returned
 - Returns the last expression's value plus any console output
 - No filesystem or network access from within the REPL`,
+    zh: `在持久 REPL 环境中执行 JavaScript 代码。
+
+REPL 上下文在多次调用间保持——一次调用中定义的变量和函数可在后续调用中使用。
+
+使用指南：
+- 用于计算、数据转换和快速实验
+- 状态在调用间保留
+- 传入 reset: true 可在执行前清除所有状态（干净环境）。此模式下 code 可选——只传 reset 即可清除
+- console.log 输出被捕获并返回
+- 返回最后一个表达式的值及所有 console 输出
+- REPL 内不能访问文件系统或网络`
+  },
   parameters: {
     type: 'object',
     properties: {
       code: {
         type: 'string',
-        description: 'JavaScript code to evaluate. Optional when reset=true and you only want to clear state.',
+        description: {
+          en: 'JavaScript code to evaluate. Optional when reset=true and you only want to clear state.',
+          zh: '要执行的 JavaScript 代码。当 reset=true 且只想清空状态时可省略。',
+        },
       },
       reset: {
         type: 'boolean',
-        description: 'When true, reset the REPL context BEFORE evaluating `code`. If `code` is omitted, just resets.',
+        description: {
+          en: 'When true, reset the REPL context BEFORE evaluating `code`. If `code` is omitted, just resets.',
+          zh: '为 true 时，在求值前先重置 REPL 上下文。若省略 code，则仅重置。',
+        },
       },
     },
   },
@@ -136,7 +155,10 @@ function warnJsReplResetDeprecated() {
 
 export const jsReplReset = defineTool({
   name: 'JsReplReset',
-  description: 'DEPRECATED — use JsRepl with `reset: true` instead. Resets the persistent REPL context. Removal target: v0.2.0.',
+  description: {
+    en: 'DEPRECATED — use JsRepl with `reset: true` instead. Resets the persistent REPL context. Removal target: v0.2.0.',
+    zh: '已废弃——请改用带有 `reset: true` 参数的 JsRepl。它会清空持久 REPL 上下文。计划在 v0.2.0 移除。',
+  },
   parameters: { type: 'object', properties: {} },
   isConcurrencySafe: () => false,
   isReadOnly: () => false,

package/yeaft/tools/list-agents.js

@@ -16,7 +16,8 @@ import { diagnoseAgentLiveness } from '../sub-agent/liveness.js';
 
 export default defineTool({
   name: 'ListAgents',
-  description: `List all sub-agents and their current status.
+  description: {
+    en: `List all sub-agents and their current status.
 
 Returns id, name, status, mission/task summary, durable outputFile path,
 liveness counters (toolUseCount, tokenCount, msSinceLastEvent, recentTools),
@@ -26,16 +27,31 @@ this as the primary non-blocking monitor for async sub-agent work, and Read
 
 By default only non-closed agents are returned. Pass include_closed=true
 to also list closed/failed/abandoned/completed agents.`,
+    zh: `列出所有子 Agent 及其当前状态。
+
+返回每个 Agent 的 id、name、status、mission/task 摘要、持久化 outputFile 路径、
+liveness 计数器（toolUseCount、tokenCount、msSinceLastEvent、recentTools）、
+stale/stalled 诊断、result 尾部和消息数量。将此作为异步子 Agent 工作的主要非阻塞监控工具；
+如需查看某个 Agent 的完整时间线，可 Read 其 outputFile。
+
+默认只返回未关闭的 Agent。传 include_closed=true 可同时列出 closed/failed/abandoned/completed 的 Agent。`
+  },
   parameters: {
     type: 'object',
     properties: {
       include_closed: {
         type: 'boolean',
-        description: 'Include closed/failed/abandoned/completed agents in the list (default: false)',
+        description: {
+          en: 'Include closed/failed/abandoned/completed agents in the list (default: false)',
+          zh: '在列表中包含已关闭/失败/放弃/完成的 Agent（默认 false）',
+        },
       },
       include_terminal: {
         type: 'boolean',
-        description: 'Alias for include_closed — include all terminal-status agents in the list',
+        description: {
+          en: 'Alias for include_closed — include all terminal-status agents in the list',
+          zh: 'include_closed 的别名 — 列出所有已终止状态的 Agent',
+        },
       },
     },
   },

package/yeaft/tools/list-dir.js

@@ -17,23 +17,36 @@ const SKIP_DIRS = new Set([
 
 export default defineTool({
   name: 'ListDir',
-  description: `List the contents of a directory.
+  description: {
+    en: `List the contents of a directory.
 
 Shows files and subdirectories with their types and sizes.
 Directories are listed first, then files, both sorted alphabetically.
 Common large directories (node_modules, .git) are skipped.
 
 This is better than using Bash with 'ls' because it provides structured output.`,
+    zh: `列出目录内容。
+
+显示文件和子目录，含类型和大小。目录优先列出，文件次之，均按字母排序。常见大目录（node_modules、.git）被跳过。
+
+比用 Bash 执行 ls 更好，因为它提供结构化输出。`
+  },
   parameters: {
     type: 'object',
     properties: {
       path: {
         type: 'string',
-        description: 'Directory path to list (default: cwd)',
+        description: {
+          en: 'Directory path to list (default: cwd)',
+          zh: '要列出的目录路径（默认当前工作目录）',
+        },
       },
       show_hidden: {
         type: 'boolean',
-        description: 'Include hidden files (starting with dot, default: true)',
+        description: {
+          en: 'Include hidden files (starting with dot, default: true)',
+          zh: '是否包含隐藏文件（以点开头的文件，默认 true）',
+        },
       },
     },
   },

package/yeaft/tools/mcp-tools.js

@@ -135,7 +135,8 @@ export function buildMcpFlattenedTools(mcpManager) {
 
 export const mcpListTools = defineTool({
   name: 'mcp_list_tools',
-  description: `List all tools available from connected MCP (Model Context Protocol) servers.
+  description: {
+    en: `List all tools available from connected MCP (Model Context Protocol) servers.
 
 Usage guidelines:
 - Use to discover what MCP tools are available in the current session
@@ -143,12 +144,24 @@ Usage guidelines:
 - Each tool is prefixed with the server name (e.g. "github__list_prs", "slack__send_message")
 - Use this before mcp_call_tool to understand available capabilities
 - MCP servers are configured by the user — if none are connected, returns an empty list`,
+    zh: `列出已连接 MCP（Model Context Protocol）服务器提供的所有工具。
+
+使用指南：
+- 用于发现当前会话中可用的 MCP 工具
+- 返回所有已连接 MCP 服务器的工具名称、描述和参数 schema
+- 每个工具名称都带服务器名前缀（例如 "github__list_prs"、"slack__send_message"）
+- 调用 mcp_call_tool 前先用此工具确认可用能力和参数
+- MCP 服务器由用户配置；如果当前没有连接服务器，将返回空列表`,
+  },
   parameters: {
     type: 'object',
     properties: {
       server: {
         type: 'string',
-        description: 'Filter tools from a specific MCP server (optional)',
+        description: {
+          en: 'Filter tools from a specific MCP server (optional)',
+          zh: '按特定 MCP 服务器过滤工具（可选）',
+        },
       },
     },
   },
@@ -181,7 +194,8 @@ Usage guidelines:
 
 export const mcpCallTool = defineTool({
   name: 'mcp_call_tool',
-  description: `Call a tool on a connected MCP (Model Context Protocol) server.
+  description: {
+    en: `Call a tool on a connected MCP (Model Context Protocol) server.
 
 Usage guidelines:
 - Use after discovering tools via mcp_list_tools
@@ -190,20 +204,39 @@ Usage guidelines:
 - The tool executes on the MCP server and returns the result
 - Timeouts depend on the MCP server — use timeout_ms if the operation is slow
 - Errors from the MCP server are returned as structured error objects`,
+    zh: `调用已连接 MCP（Model Context Protocol）服务器上的某个工具。
+
+使用指南：
+- 先通过 mcp_list_tools 发现工具，再调用此工具
+- 提供包含服务器名前缀的完整工具名（例如 "github__create_issue"）
+- arguments 必须严格匹配该 MCP 工具的参数 schema
+- 工具会在 MCP 服务器侧执行，并返回执行结果
+- 超时时间取决于 MCP 服务器；慢操作可显式传入 timeout_ms
+- MCP 服务器返回的错误会以结构化错误对象返回`,
+  },
   parameters: {
     type: 'object',
     properties: {
       tool_name: {
         type: 'string',
-        description: 'Full tool name including server prefix (e.g. "github__list_prs")',
+        description: {
+          en: 'Full tool name including server prefix (e.g. "github__list_prs")',
+          zh: '完整工具名称，包括服务器前缀（如 "github__list_prs"）',
+        },
       },
       arguments: {
         type: 'object',
-        description: 'Arguments to pass to the MCP tool (must match its schema)',
+        description: {
+          en: 'Arguments to pass to the MCP tool (must match its schema)',
+          zh: '传递给 MCP 工具的参数（必须匹配其 schema）',
+        },
       },
       timeout_ms: {
         type: 'number',
-        description: 'Timeout in milliseconds (default: 30000)',
+        description: {
+          en: 'Timeout in milliseconds (default: 30000)',
+          zh: '超时时间，单位毫秒（默认 30000）',
+        },
       },
     },
     required: ['tool_name'],

package/yeaft/tools/notebook-edit.js

@@ -11,7 +11,8 @@ import { resolve } from 'path';
 
 export default defineTool({
   name: 'NotebookEdit',
-  description: `Edit a Jupyter notebook (.ipynb file) cell.
+  description: {
+    en: `Edit a Jupyter notebook (.ipynb file) cell.
 
 Actions:
 - "replace" — replace the source of a cell at the given index
@@ -20,30 +21,55 @@ Actions:
 - "read" — read the notebook content (all cells)
 
 Cell types: "code" or "markdown"`,
+    zh: `编辑 Jupyter notebook（.ipynb 文件）单元格。
+
+操作：
+- "replace" — 替换指定索引处单元格的源码
+- "insert" — 在指定索引后插入新单元格
+- "delete" — 删除指定索引处的单元格
+- "read" — 读取 notebook 内容（全部单元格）
+
+单元格类型："code" 或 "markdown"`
+  },
   parameters: {
     type: 'object',
     properties: {
       notebook_path: {
         type: 'string',
-        description: 'Path to the .ipynb file',
+        description: {
+          en: 'Path to the .ipynb file',
+          zh: '.ipynb 文件的路径',
+        },
       },
       action: {
         type: 'string',
         enum: ['replace', 'insert', 'delete', 'read'],
-        description: 'Operation to perform (default: "replace")',
+        description: {
+          en: 'Operation to perform (default: "replace")',
+          zh: '要执行的操作（默认 "replace"）',
+        },
       },
       cell_index: {
         type: 'number',
-        description: 'Cell index (0-based)',
+        description: {
+          en: 'Cell index (0-based)',
+          zh: '单元格索引（从 0 开始）',
+        },
       },
       cell_type: {
         type: 'string',
         enum: ['code', 'markdown'],
-        description: 'Cell type for insert/replace',
+        description: {
+          en: 'Cell type for insert/replace',
+          zh: '插入/替换的单元格类型',
+        },
       },
       source: {
         type: 'string',
-        description: 'New cell source content',
+        description: {
+          en: 'New cell source content',
+          zh: '新单元格的源码内容',
+        },
       },
     },
     required: ['notebook_path'],

package/yeaft/tools/registry.js

@@ -10,7 +10,6 @@
  */
 
 import { formatSize } from '../archive/tool-results.js';
-import { getBuiltinToolLocalization } from './localized-descriptions.js';
 
 /**
  * Collaboration tools are mutually exclusive per Yeaft group shape:
@@ -52,47 +51,36 @@ function normalizeLanguage(language) {
   return String(language || '').toLowerCase().startsWith('zh') ? 'zh' : 'en';
 }
 
+function isLocalizedTextObject(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
+  return ['en', 'zh', 'zh-CN', 'en-US', 'default'].some(key => typeof value[key] === 'string' || typeof value[key] === 'function');
+}
+
 function localizeVisibleText(value, language, toolName) {
   const lang = normalizeLanguage(language);
   if (typeof value === 'function') return localizeVisibleText(value(lang), lang, toolName);
-  if (value && typeof value === 'object') {
+  if (isLocalizedTextObject(value)) {
     const picked = value[lang] || value[lang === 'zh' ? 'zh-CN' : 'en-US'] || value.en || value.default;
     if (typeof picked === 'string') return picked;
+    if (typeof picked === 'function') return localizeVisibleText(picked(lang), lang, toolName);
   }
-  const text = typeof value === 'string' ? value : String(value || '');
-  if (lang !== 'zh') return text;
-  if (!text.trim()) return text;
-  return [
-    `工具说明：${toolName || '该工具'}。请严格按照 schema 调用；工具名、参数名、JSON key 和枚举值保持英文，不要翻译。`,
-    `原始协议说明（英文，供精确调用参考）：${text}`,
-  ].join('\n');
+  // Legacy single-string descriptions are already authored text. Return them
+  // unchanged; do not synthesize zh-prefixed wrappers around English strings.
+  return typeof value === 'string' ? value : String(value || '');
 }
 
 /**
- * Walk a JSON Schema `parameters` object and localize the human-readable
- * `description` strings to the requested language. All other schema bits
+ * Walk a JSON Schema `parameters` object and localize human-readable
+ * `description` values to the requested language. All other schema bits
  * (`type`, `enum`, `required`, `items`, nested `properties`, etc.) are
  * preserved by value.
  *
  * Critical correctness rule: a JSON Schema can have a *property named*
  * `description` whose value is itself a sub-schema (e.g.
- * `properties: { description: { type: 'string', description: 'Detailed...' }}`).
+ * `properties: { description: { type: 'string', description: { en, zh } }}`).
  * In that case the OUTER `description` key holds the sub-schema and must
- * be recursed into; only the INNER `description: 'Detailed...'` value
- * (which is a string) should be localized.
- *
- * Previous bug: this walker localized ANY value under a `description`
- * key, including sub-schema objects. `localizeVisibleText` then ran
- * `String(value)` on the object, producing the literal string
- * `'[object Object]'`. GPT-5's strict schema validator rejected the
- * resulting `{ description: '[object Object]' }` with
- * `"'[object Object]' is not of type 'object', 'boolean'"`. This made
- * FeatureCreate (and any tool whose schema contains a property named
- * `description`) unusable in zh locale on strict providers.
- *
- * The fix: only treat a `description` value as localizable text when it
- * is actually a string. Object/array values under a `description` key
- * are sub-schemas and must be recursed into normally.
+ * be recursed into; only the INNER bilingual `description` value should
+ * be localized.
  */
 function cloneSchema(value) {
   if (!value || typeof value !== 'object') return value;
@@ -126,11 +114,11 @@ function applyParameterOverrides(parameters, overrides) {
 
 function localizeParameters(parameters, language, toolName, parameterOverrides = null) {
   const lang = normalizeLanguage(language);
-  if (lang !== 'zh' || !parameters || typeof parameters !== 'object') return parameters;
+  if (!parameters || typeof parameters !== 'object') return parameters;
   if (Array.isArray(parameters)) return parameters.map(v => localizeParameters(v, lang, toolName));
   const out = {};
   for (const [key, value] of Object.entries(parameters)) {
-    if (key === 'description' && typeof value === 'string') {
+    if (key === 'description' && (typeof value === 'string' || typeof value === 'function' || isLocalizedTextObject(value))) {
       out[key] = localizeVisibleText(value, lang, toolName);
     } else if (value && typeof value === 'object') {
       out[key] = localizeParameters(value, lang, toolName, null);
@@ -374,11 +362,10 @@ export class ToolRegistry {
     return this.getAllTools()
       .filter(t => !isToolHiddenByCollabPolicy(t.name, collabToolPolicy))
       .map(t => {
-        const localized = getBuiltinToolLocalization(t.name, lang);
         return {
           name: t.name,
-          description: localized?.description || localizeVisibleText(t.description, lang, t.name),
-          parameters: localizeParameters(t.parameters, lang, t.name, localized?.parameters),
+          description: localizeVisibleText(t.description, lang, t.name),
+          parameters: localizeParameters(t.parameters, lang, t.name),
         };
       });
   }