@ai-zen/agents-sdk 1.0.0-alpha.22 → 1.0.0-alpha.23

package/dist/scope/plugins/builtin/BatchEditTool.js

@@ -4,33 +4,33 @@ export class BatchEditTool extends SdkCallbackTool {
     function = {
         name: "batch_edit",
         description: [
-            "批量编辑文件文本，可以优先使用这个工具对文件进行编辑。",
-            "对同一个文件的多处修改应在一次调用中全部提交（replacements 数组），而不是并行多次调用 edit——并行编辑同一文件会互相覆盖。",
+            "Edit text in a file in batches. Prefer this tool when making edits to a file.",
+            "Submit all changes to the same file in a single call (the replacements array) instead of calling edit in parallel multiple times — parallel edits to the same file overwrite each other.",
         ].join("\n"),
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 replacements: {
                     type: "array",
-                    description: "要替换的文本数组",
+                    description: "Array of replacements",
                     items: {
                         type: "object",
                         properties: {
                             oldText: {
                                 type: "string",
-                                description: "要替换的文本",
+                                description: "Text to replace",
                             },
                             newText: {
                                 type: "string",
-                                description: "替换后的文本",
+                                description: "Replacement text",
                             },
                             isReplaceAll: {
                                 type: "boolean",
-                                description: "是否替换所有匹配的文本（默认仅替换首次匹配）。使用此功能前应确保你提供的 oldText 足够精确，避免误替换",
+                                description: "Whether to replace all matches (by default only the first match is replaced). Make sure the oldText you provide is precise enough to avoid unintended replacements",
                                 default: false,
                             },
                         },
@@ -60,7 +60,7 @@ export class BatchEditTool extends SdkCallbackTool {
                     failed.push({
                         oldText: replacement.oldText,
                         newText: replacement.newText,
-                        reason: "文件中未精确匹配到要替换的文本",
+                        reason: "No exact match found for the text to replace",
                     });
                     continue;
                 }

package/dist/scope/plugins/builtin/CopyTool.js

@@ -3,21 +3,21 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class CopyTool extends SdkCallbackTool {
     function = {
         name: "copy",
-        description: "复制文件或目录（相当于 cp 命令）",
+        description: "Copy a file or directory (equivalent to the cp command)",
         parameters: {
             type: "object",
             properties: {
                 src: {
                     type: "string",
-                    description: "源路径",
+                    description: "Source path",
                 },
                 dest: {
                     type: "string",
-                    description: "目标路径",
+                    description: "Destination path",
                 },
                 recursive: {
                     type: "boolean",
-                    description: "是否递归复制目录，复制目录时需设为 true",
+                    description: "Whether to copy directories recursively; must be true when copying a directory",
                 },
             },
             required: ["src", "dest"],

package/dist/scope/plugins/builtin/CwdTool.js

@@ -2,7 +2,7 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class CwdTool extends SdkCallbackTool {
     function = {
         name: "cwd",
-        description: "获取当前工作目录 cwd",
+        description: "Get the current working directory (cwd)",
         parameters: {
             type: "object",
             properties: {},

package/dist/scope/plugins/builtin/DownloadFileTool.js

@@ -4,17 +4,17 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class DownloadFileTool extends SdkCallbackTool {
     function = {
         name: "download_file",
-        description: "从 URL 下载文件（图片、PDF 等二进制文件）并保存到本地磁盘。自动从 URL 推断文件名，也可指定保存路径。",
+        description: "Download a file from a URL (images, PDFs and other binary files) and save it to the local disk. The file name is inferred from the URL, or you can specify the save path.",
         parameters: {
             type: "object",
             properties: {
                 url: {
                     type: "string",
-                    description: "文件下载链接",
+                    description: "URL to download the file from",
                 },
                 outputPath: {
                     type: "string",
-                    description: "保存路径（可选）。可以是目录或完整文件路径。不指定则下载到当前工作目录，自动从 URL 推断文件名。",
+                    description: "Save path (optional). May be a directory or a full file path. If omitted, the file is saved to the current working directory with the file name inferred from the URL.",
                 },
             },
             required: ["url"],
@@ -30,7 +30,7 @@ export class DownloadFileTool extends SdkCallbackTool {
         try {
             const url = input.url;
             if (!url)
-                throw new Error("url 不能为空");
+                throw new Error("url must not be empty");
             if (input.outputPath) {
                 savePath = this.resolve(input.outputPath);
                 const stat = await fsp.stat(savePath).catch(() => null);
@@ -48,7 +48,7 @@ export class DownloadFileTool extends SdkCallbackTool {
             await fsp.mkdir(path.dirname(savePath), { recursive: true });
             const response = await fetch(url, { signal });
             if (!response.ok) {
-                throw new Error(`下载失败: HTTP ${response.status} ${response.statusText}`);
+                throw new Error(`Download failed: HTTP ${response.status} ${response.statusText}`);
             }
             const contentType = response.headers.get("content-type") || "";
             const arrayBuffer = await response.arrayBuffer();
@@ -61,7 +61,7 @@ export class DownloadFileTool extends SdkCallbackTool {
                 filePath: path.resolve(savePath),
                 fileSize: `${fileSizeKB} KB`,
                 contentType,
-                note: "文件已保存到本地",
+                note: "File saved to local disk",
             });
         }
         catch (error) {
@@ -71,12 +71,12 @@ export class DownloadFileTool extends SdkCallbackTool {
                 return JSON.stringify({
                     success: false,
                     aborted: true,
-                    error: "下载被中断（aborted）",
+                    error: "Download aborted",
                 });
             }
             return JSON.stringify({
                 success: false,
-                error: error?.message || "下载失败",
+                error: error?.message || "Download failed",
             });
         }
     }

package/dist/scope/plugins/builtin/EditTool.js

@@ -16,29 +16,29 @@ export class EditTool extends SdkCallbackTool {
     function = {
         name: "edit",
         description: [
-            "编辑文件中的文本，支持精确替换或替换所有匹配项。",
+            "Edit text in a file, supporting exact replacement or replacing all matches.",
             "",
-            "并发限制（重要）：同一个文件禁止并行编辑。不要在同一轮回复中对同一路径发起多个 edit 调用——这些调用会各自读取旧内容再写回，后写者覆盖先写者，导致修改丢失或文件被写坏。",
-            "如需对同一个文件施加多处修改，请改用 batch_edit，在一次调用里提交全部替换。只有编辑不同文件时才可以并行调用 edit。",
+            "Concurrency limit (important): never edit the same file in parallel. Do not issue multiple edit calls for the same path within one reply — each call reads the old content and writes it back, so the later write overwrites the earlier one, losing changes or corrupting the file.",
+            "To apply multiple changes to one file, use batch_edit instead and submit all replacements in a single call. Only edit different files in parallel.",
         ].join("\n"),
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 oldText: {
                     type: "string",
-                    description: "要替换的文本",
+                    description: "Text to replace",
                 },
                 newText: {
                     type: "string",
-                    description: "替换后的文本",
+                    description: "Replacement text",
                 },
                 isReplaceAll: {
                     type: "boolean",
-                    description: "是否替换所有匹配的文本（默认 false，仅替换首次匹配）。使用此功能前应确保你提供的 oldText 足够精确，避免误替换",
+                    description: "Whether to replace all matches (default false, only the first match is replaced). Make sure the oldText you provide is precise enough to avoid unintended replacements",
                     default: false,
                 },
             },
@@ -59,7 +59,7 @@ export class EditTool extends SdkCallbackTool {
             const count = countOccurrences(content, oldText);
             if (count === 0) {
                 return JSON.stringify({
-                    result: "文件中未精确匹配到要替换的文本",
+                    result: "No exact match found for the text to replace",
                     matchCount: 0,
                 });
             }
@@ -69,7 +69,7 @@ export class EditTool extends SdkCallbackTool {
             await fsp.writeFile(filePath, newContent);
             if (!isReplaceAll && count > 1) {
                 return JSON.stringify({
-                    result: `警告：未开启替换所有（isReplaceAll=false），但文本 "${oldText}" 在文件中出现了 ${count} 次，仅替换了首次匹配。如果希望替换所有匹配，请将 isReplaceAll 设为 true`,
+                    result: `Warning: replace-all is off (isReplaceAll=false), but the text "${oldText}" occurs ${count} times in the file; only the first match was replaced. Set isReplaceAll to true to replace all matches`,
                     matchCount: count,
                     replacedCount: 1,
                 });

package/dist/scope/plugins/builtin/ExecTool.js

@@ -4,17 +4,17 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headTailPreview } from "./outputG
 export class ExecTool extends SdkCallbackTool {
     function = {
         name: "exec",
-        description: "执行命令",
+        description: "Execute a shell command",
         parameters: {
             type: "object",
             properties: {
                 command: {
                     type: "string",
-                    description: "要执行的命令",
+                    description: "Command to execute",
                 },
                 timeout: {
                     type: "number",
-                    description: "超时时间（毫秒），必填。超时后会终止进程；超过该时长仍未完成即视为超时并终止。建议长时间运行的命令使用 spawn 异步执行。",
+                    description: "Timeout in milliseconds (required). The process is killed on timeout. For long-running commands, prefer spawn to run them asynchronously.",
                 },
             },
             required: ["command", "timeout"],
@@ -29,7 +29,7 @@ export class ExecTool extends SdkCallbackTool {
         const { timeout } = input;
         // 运行时双校验：timeout 必填且必须为正数
         if (typeof timeout !== "number" || !Number.isFinite(timeout) || timeout <= 0) {
-            throw new Error(`exec: 参数 timeout 为必填项，且必须是正数（毫秒），当前值: ${JSON.stringify(timeout)}`);
+            throw new Error(`exec: timeout is required and must be a positive number (milliseconds), got: ${JSON.stringify(timeout)}`);
         }
         const signal = ctx?.signal;
         const result = await new Promise((resolve) => {
@@ -37,7 +37,7 @@ export class ExecTool extends SdkCallbackTool {
             if (signal?.aborted) {
                 resolve({
                     stdout: "",
-                    stderr: "进程已中断（aborted）",
+                    stderr: "Process aborted",
                     exitCode: null,
                     killed: true,
                     terminated: "aborted",
@@ -72,7 +72,7 @@ export class ExecTool extends SdkCallbackTool {
                 // 即便 exec 回调因信号处理而未能及时触发，也立即返回中断结果，避免挂起
                 settle({
                     stdout: "",
-                    stderr: "进程已中断（aborted）",
+                    stderr: "Process aborted",
                     exitCode: null,
                     killed: true,
                     terminated: "aborted",
@@ -97,8 +97,8 @@ export class ExecTool extends SdkCallbackTool {
                 const stderr = headTailPreview(result.stderr);
                 return JSON.stringify({
                     outputTooLarge: true,
-                    warning: `输出过大：stdout + stderr 合计 ${result.stdout.length + result.stderr.length} 字符，` +
-                        `超过上限 ${limit} 字符。完整内容已分文件落盘（stdout.log / stderr.log），可用 read 分批读取。`,
+                    warning: `Output too large: stdout + stderr total ${result.stdout.length + result.stderr.length} characters, ` +
+                        `exceeds the limit of ${limit} characters. Full content was written to separate files (stdout.log / stderr.log); use read to fetch it in chunks`,
                     files: ctx.files,
                     stdout: { chars: result.stdout.length, lines: countLines(result.stdout), ...stdout },
                     stderr: { chars: result.stderr.length, lines: countLines(result.stderr), ...stderr },

package/dist/scope/plugins/builtin/ExistTool.js

@@ -3,13 +3,13 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class ExistTool extends SdkCallbackTool {
     function = {
         name: "exist",
-        description: "检查文件或目录是否存在",
+        description: "Check whether a file or directory exists",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件或目录路径",
+                    description: "File or directory path",
                 },
             },
             required: ["path"],

package/dist/scope/plugins/builtin/FindTextTool.js

@@ -11,7 +11,7 @@ const DEFAULT_MAX_LINE_LENGTH = 200;
 export class FindTextTool extends SdkCallbackTool {
     function = {
         name: "find_text",
-        description: "查找文本出现的位置，支持普通文本或正则匹配，返回文件名及具体行号、行内容。为避免结果撑爆上下文，默认限制总匹配数、单文件大小与行内容长度，超限会截断并标记 truncated。",
+        description: "Find where text occurs, supporting plain text or regex matching; returns file names with line numbers and line content. To avoid blowing up the context, the total match count, per-file size and line content length are limited by default, and results beyond the limits are truncated and marked truncated.",
         parameters: {
             type: "object",
             properties: {
@@ -25,30 +25,30 @@ export class FindTextTool extends SdkCallbackTool {
                 },
                 text: {
                     type: "string",
-                    description: "要查找的文本（与 regex 二选一）",
+                    description: "Text to search for (mutually exclusive with regex)",
                 },
                 regex: {
                     type: "string",
-                    description: "正则表达式（与 text 二选一，例如 \\bconst\\s+\\w+）",
+                    description: "Regular expression (mutually exclusive with text, e.g. \\bconst\\s+\\w+)",
                 },
                 exclude: {
                     type: "array",
-                    description: "要排除的 glob 模式数组",
+                    description: "Array of glob patterns to exclude",
                     items: {
                         type: "string",
                     },
                 },
                 maxMatches: {
                     type: "number",
-                    description: "总匹配数上限，默认 200",
+                    description: "Maximum total matches (default 200)",
                 },
                 maxFileSize: {
                     type: "number",
-                    description: "单文件大小上限（字节），超过则跳过该文件，默认 307200（300KB）",
+                    description: "Maximum file size in bytes; larger files are skipped (default 307200, i.e. 300KB)",
                 },
                 maxLineLength: {
                     type: "number",
-                    description: "行内容与匹配子串的截断长度，默认 200",
+                    description: "Truncation length for line content and matched substrings (default 200)",
                 },
             },
             required: ["path", "pattern"],
@@ -65,7 +65,7 @@ export class FindTextTool extends SdkCallbackTool {
             const text = input.text;
             const regexStr = input.regex;
             if (!text && !regexStr) {
-                return "请提供 text 或 regex 参数";
+                return "Provide either the text or the regex parameter";
             }
             const regex = regexStr ? new RegExp(regexStr) : null;
             const maxMatches = input.maxMatches ?? DEFAULT_MAX_MATCHES;
@@ -153,8 +153,8 @@ export class FindTextTool extends SdkCallbackTool {
                 const preview = headPreview(json);
                 return JSON.stringify({
                     outputTooLarge: true,
-                    warning: `输出过大：结果共 ${json.length} 字符，超过上限 ${limit} 字符。` +
-                        `完整结果已落盘（result.json），可用 read 分批读取。`,
+                    warning: `Output too large: the results total ${json.length} characters, exceeding the limit of ${limit} characters. ` +
+                        `The full result has been written to disk (result.json) and can be read in chunks with read.`,
                     files: ctx.files,
                     chars: json.length,
                     ...preview,

package/dist/scope/plugins/builtin/GenerateImageTool.js

@@ -15,25 +15,25 @@ export class GenerateImageTool extends SdkCallbackTool {
     }
     function = {
         name: "generate_image",
-        description: "根据文字描述生成图片，返回图片 URL 列表（JSON）。如需查看图片内容，请用 view_image 工具（传入图片 URL）；如需保存到本地，用 download_file 下载。",
+        description: "Generate an image from a text description and return a list of image URLs (JSON). To inspect the image content, use the view_image tool (pass the image URL); to save it locally, use download_file.",
         parameters: {
             type: "object",
             properties: {
                 prompt: {
                     type: "string",
-                    description: "所需图像的文本描述，应详细描述画面内容、风格、构图等",
+                    description: "Text description of the desired image; describe the subject, style, composition and other details",
                 },
                 model: {
                     type: "string",
-                    description: "图片模型 ID，不指定则使用配置中的默认图片模型；若指定的模型不存在，本工具会返回当前可用的模型列表。",
+                    description: "Image model ID. Defaults to the configured default image model; if the given model does not exist, this tool returns the list of currently available models.",
                 },
                 size: {
                     type: "string",
-                    description: '图片尺寸。不指定则使用模型的默认尺寸。cogview系列: 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440。glm-image: 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728。',
+                    description: 'Image size. Defaults to the model default size. cogview series: 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440. glm-image: 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728.',
                 },
                 quality: {
                     type: "string",
-                    description: "图像质量。hd: 精细(约20秒), standard: 快速(约5-10秒)",
+                    description: "Image quality. hd: fine (about 20 seconds), standard: fast (about 5-10 seconds)",
                     enum: ["hd", "standard"],
                 },
             },
@@ -49,7 +49,7 @@ export class GenerateImageTool extends SdkCallbackTool {
         try {
             const prompt = input.prompt;
             if (!prompt || !prompt.trim()) {
-                return JSON.stringify({ success: false, error: "prompt 不能为空" });
+                return JSON.stringify({ success: false, error: "prompt must not be empty" });
             }
             const config = this.env.config;
             const imageModels = config.imageModels;
@@ -57,7 +57,7 @@ export class GenerateImageTool extends SdkCallbackTool {
             if (!imageModels || imageModels.length === 0) {
                 return JSON.stringify({
                     success: false,
-                    error: "未配置图片生成模型。请在配置中添加 imageModels。",
+                    error: "No image generation model configured. Add imageModels to the configuration.",
                 });
             }
             const modelId = input.model || defaultImageModel;
@@ -67,20 +67,20 @@ export class GenerateImageTool extends SdkCallbackTool {
             if (!imageModel) {
                 return JSON.stringify({
                     success: false,
-                    error: `图片模型 "${modelId}" 不存在。可用的图片模型: ${imageModels.map((m) => m.id).join(", ")}`,
+                    error: `Image model "${modelId}" does not exist. Available image models: ${imageModels.map((m) => m.id).join(", ")}`,
                 });
             }
             const endpoint = config.endpoints.find((e) => e.id === imageModel.endpointId);
             if (!endpoint) {
                 return JSON.stringify({
                     success: false,
-                    error: `图片模型 "${imageModel.name}" 对应的端点 "${imageModel.endpointId}" 未配置`,
+                    error: `Endpoint "${imageModel.endpointId}" for image model "${imageModel.name}" is not configured`,
                 });
             }
             if (!endpoint.apiKey) {
                 return JSON.stringify({
                     success: false,
-                    error: `端点 "${endpoint.name}" 的 API Key 未设置`,
+                    error: `API Key for endpoint "${endpoint.name}" is not set`,
                 });
             }
             const client = new OpenAI({
@@ -107,7 +107,7 @@ export class GenerateImageTool extends SdkCallbackTool {
                 modelId: imageModel.id,
                 created: result.created,
                 images: urls.map((url, i) => ({ index: i, url })),
-                note: "图片临时链接有效期为30天。如需查看图片内容，可用 view_image 工具（传入图片 URL）；如需保存，可用 download_file 下载。",
+                note: "Image links are temporary and expire after 30 days. To inspect the image content, use the view_image tool (pass the image URL); to save it, use download_file.",
             }, null, 2);
         }
         catch (error) {
@@ -116,12 +116,12 @@ export class GenerateImageTool extends SdkCallbackTool {
                 return JSON.stringify({
                     success: false,
                     aborted: true,
-                    error: "图片生成被中断（aborted）",
+                    error: "Image generation aborted",
                 });
             }
             return JSON.stringify({
                 success: false,
-                error: error instanceof Error ? error.message : "图片生成失败",
+                error: error instanceof Error ? error.message : "Image generation failed",
             });
         }
     }

package/dist/scope/plugins/builtin/GlobTool.js

@@ -4,7 +4,7 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard
 export class GlobTool extends SdkCallbackTool {
     function = {
         name: "glob",
-        description: "使用 glob 模式递归扫描和查找文件。这是进行文件系统搜索的首选工具，功能远优于简单的 'ls' 列表命令。当你需要查找特定类型的文件、遍历目录树或需要排除特定文件时，请优先使用此函数。",
+        description: "Recursively scan for and find files using a glob pattern. This is the preferred tool for file system searches, far better than a plain 'ls' listing. Prefer this tool when you need to find files of a specific type, walk a directory tree, or exclude specific files.",
         parameters: {
             type: "object",
             properties: {
@@ -68,9 +68,9 @@ export class GlobTool extends SdkCallbackTool {
                 const preview = headPreview(json);
                 return JSON.stringify({
                     outputTooLarge: true,
-                    warning: `输出过大：匹配结果共 ${json.length} 字符，超过上限 ${limit} 字符。` +
-                        `完整结果已落盘（result.json），可用 read 分批读取；` +
-                        `也可用更精确的 pattern 或 exclude 缩小范围后重新查找。`,
+                    warning: `Output too large: the matches total ${json.length} characters, exceeding the limit of ${limit} characters. ` +
+                        `The full result has been written to disk (result.json) and can be read in chunks with read; ` +
+                        `alternatively, narrow the scope with a more precise pattern or exclude and search again.`,
                     files: ctx.files,
                     chars: json.length,
                     ...preview,

package/dist/scope/plugins/builtin/InspectFileTool.js

@@ -12,17 +12,17 @@ import { DEFAULT_MAX_TOOL_OUTPUT } from "./outputGuard.js";
 export class InspectFileTool extends SdkCallbackTool {
     function = {
         name: "inspect_file",
-        description: "勘察文件的结构概况：总行数、总字符数、最长行的列数及其行索引、平均列数、行尾类型（LF/CRLF）。可选返回每行的列数映射。适用于在 read 之前先了解文件规模，再决定用 range 读取哪一段。仅做流式扫描，不受 read 的 300KB 读取阈值限制。",
+        description: "Inspect a file's structural overview: total lines, total characters, the longest line's column count and its line index, average column count, and line ending type (LF/CRLF). Optionally returns a per-line column count map. Useful for sizing up a file before reading it, so you can decide which range to read. Streaming scan only, not subject to the 300KB read threshold of read.",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 withColCountMap: {
                     type: "boolean",
-                    description: "是否返回每行列数映射（对象：行索引 → 列数，行索引从 0 开始）。默认 false。行数很多时该映射可能过大，此时将只返回概况字段。",
+                    description: "Whether to return a per-line column count map (object: line index → column count, line index is 0-based). Default false. When there are many lines the map may be too large; in that case only the overview fields are returned.",
                     default: false,
                 },
             },
@@ -38,7 +38,7 @@ export class InspectFileTool extends SdkCallbackTool {
             const filePath = this.resolve(input.path);
             const stats = await fsp.stat(filePath);
             if (!stats.isFile()) {
-                return `"${filePath}" 不是文件`;
+                return `"${filePath}" is not a file`;
             }
             const withColCountMap = input.withColCountMap ?? false;
             const result = await scan(filePath, withColCountMap);
@@ -61,9 +61,9 @@ export class InspectFileTool extends SdkCallbackTool {
                 return JSON.stringify({
                     ...summary,
                     colCountMapOmitted: true,
-                    warning: `行长度明细过大：概况与 colCountMap 合计 ${payload.length} 字符，` +
-                        `超过上限 ${limit} 字符，未落盘返回。文件规模超出可处理范围，` +
-                        `建议改用 find_text 定位后再按 range 分段读取。`,
+                    warning: `Line length details too large: overview plus colCountMap total ${payload.length} characters, ` +
+                        `exceeding the limit of ${limit} characters; not written to disk. The file is beyond the supported size, ` +
+                        `so use find_text to locate the target and then read it in chunks by range.`,
                 });
             }
             return payload;

package/dist/scope/plugins/builtin/LsTool.js

@@ -4,13 +4,13 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard
 export class LsTool extends SdkCallbackTool {
     function = {
         name: "ls",
-        description: "列出目录",
+        description: "List a directory",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "目录路径",
+                    description: "Directory path",
                 },
             },
             required: ["path"],
@@ -35,9 +35,9 @@ export class LsTool extends SdkCallbackTool {
                     const preview = headPreview(json);
                     return JSON.stringify({
                         outputTooLarge: true,
-                        warning: `输出过大：目录条目共 ${entries.length} 项、${json.length} 字符，超过上限 ${limit} 字符。` +
-                            `完整列表已落盘（result.json），可用 read 分批读取；` +
-                            `也可改用 glob 按模式筛选。`,
+                        warning: `Output too large: ${entries.length} directory entries, ${json.length} characters in total, exceeding the limit of ${limit} characters. ` +
+                            `The full list has been written to disk (result.json) and can be read in chunks with read; ` +
+                            `alternatively, use glob to filter by pattern.`,
                         files: ctx.files,
                         chars: json.length,
                         ...preview,

package/dist/scope/plugins/builtin/MkdirTool.js

@@ -3,17 +3,17 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class MkdirTool extends SdkCallbackTool {
     function = {
         name: "mkdir",
-        description: "创建目录",
+        description: "Create a directory",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "目录路径",
+                    description: "Directory path",
                 },
                 recursive: {
                     type: "boolean",
-                    description: "是否递归创建子目录",
+                    description: "Whether to create parent directories recursively",
                 },
             },
             required: ["path"],

package/dist/scope/plugins/builtin/ReadTool.js

@@ -4,18 +4,18 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput } from "./outputGuard.js";
 export class ReadTool extends SdkCallbackTool {
     function = {
         name: "read",
-        description: "读取文件",
+        description: "Read a file",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 range: {
                     type: "array",
-                    description: "读取范围 [起始行, 起始列, 结束行, 结束列]，行列均从 0 开始，-1 表示末位；" +
-                        "例如 [0, 0, 100, -1] 表示从第 0 行第 0 列读到第 100 行最后一列。省略则读取整个文件。",
+                    description: "Read range [startLine, startCol, endLine, endCol]; rows and columns are 0-based, -1 means the last position. " +
+                        "For example, [0, 0, 100, -1] reads from line 0, column 0 through the last column of line 100; omit it to read the whole file.",
                     items: {
                         type: "number",
                     },
@@ -34,7 +34,7 @@ export class ReadTool extends SdkCallbackTool {
             const stats = await fsp.stat(filePath);
             // 读取阈值：文件过大时拒绝读取（与输出阈值 maxToolOutput 无关）
             if (stats.size > 300 * 1024) {
-                throw new Error(`文件过大，无法读取，当前文件大小 ${stats.size} 字节`);
+                throw new Error(`File too large to read: ${stats.size} bytes`);
             }
             const content = await fsp.readFile(filePath, "utf-8");
             const output = input.range ? sliceByRange(content, input.range) : content;
@@ -44,9 +44,9 @@ export class ReadTool extends SdkCallbackTool {
                 tool: "read",
                 content: output,
                 isOverLimit: (text) => text.length > limit,
-                buildWarning: () => `读取内容过大：本次输出 ${output.length} 字符，超过上限 ${limit} 字符，未落盘。` +
-                    `文件共 ${countLines(content)} 行、${content.length} 字符，` +
-                    `请用 range 参数分范围读取（形如 [起始行, 起始列, 结束行, 结束列]，行列从 0 开始，-1 表示末位）。`,
+                buildWarning: () => `Output too large: this read returned ${output.length} characters, exceeding the limit of ${limit} characters; not written to disk. ` +
+                    `The file has ${countLines(content)} lines and ${content.length} characters. ` +
+                    `Use the range parameter to read it in chunks (format [startLine, startCol, endLine, endCol], 0-based, -1 means the last position).`,
             });
         }
         catch (error) {