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

package/dist/scope/plugins/skills/skillTools.js

@@ -2,23 +2,23 @@ import { CallbackTool, Agent, AgentToolLazy, Message } from "@ai-zen/agents-core
 import { createDisclosureParam } from "../../disclosure.js";
 import { readSkill } from "./discover.js";
 import { promises as fs } from "node:fs";
-const EMPTY_HINT = "（当前没有可用的 Skill，请联系用户添加）";
+const EMPTY_HINT = "(No Skills are currently available, please ask the user to add one)";
 /**
  * 创建 load_skill 工具。
  * 枚举所有允许的 skill（不限是否支持子 Agent），由 filteredSkills 提供完整信息。
  */
 export function createLoadSkillTool(skillDirs, filteredSkills) {
     const ids = filteredSkills.map((s) => s.id);
-    const param = createDisclosureParam(ids, "选择一个 Skill", EMPTY_HINT);
+    const param = createDisclosureParam(ids, "Select a Skill", EMPTY_HINT);
     // 拼接各 skill 的描述供 LLM 参考
     const skillDescriptions = filteredSkills
-        .map((s) => `  - ${s.id}: ${s.description || "无描述"}`)
+        .map((s) => `  - ${s.id}: ${s.description || "No description"}`)
         .join("\n");
-    const skillIdDescription = `${param.description}\n\n各 Skill 说明：\n${skillDescriptions || "  无可用 Skill"}`;
+    const skillIdDescription = `${param.description}\n\nSkill descriptions:\n${skillDescriptions || "  No Skills available"}`;
     return new CallbackTool({
         function: {
             name: "load_skill",
-            description: "加载指定 Skill 的完整指导文档。Skill 是预制的专业指导，加载后展开到上下文中。",
+            description: "Load the full guidance document of a Skill. A Skill is pre-authored expert guidance that is expanded into the context once loaded.",
             parameters: {
                 type: "object",
                 properties: {
@@ -36,7 +36,7 @@ export function createLoadSkillTool(skillDirs, filteredSkills) {
             const skillId = input.skill_id;
             const skill = await readSkill(skillDirs, skillId);
             if (!skill) {
-                return `❌ Skill "${skillId}" 不存在，请确认名称是否正确`;
+                return `❌ Skill "${skillId}" not found, please verify the name`;
             }
             // 扫描 skill 目录下的文件列表
             let fileList = "";
@@ -46,18 +46,18 @@ export function createLoadSkillTool(skillDirs, filteredSkills) {
                     const suffix = e.isDirectory() ? "/" : "";
                     return `  - ${e.name}${suffix}`;
                 });
-                fileList = `\n\nSkill 目录文件列表：\n${files.join("\n")}`;
+                fileList = `\n\nSkill directory files:\n${files.join("\n")}`;
             }
             catch {
                 fileList = "";
             }
             return [
-                `Skill "${skillId}" 已加载：`,
+                `Skill "${skillId}" loaded:`,
                 ``,
-                `Skill 目录路径: ${skill.dirPath}`,
+                `Skill directory path: ${skill.dirPath}`,
                 fileList,
                 ``,
-                `--- Skill 内容开始 ---`,
+                `--- Skill content starts ---`,
                 skill.content,
             ].join("\n");
         },
@@ -76,16 +76,16 @@ export function createCallSkillSubAgentTool(skillDirs, filteredSkills) {
     // 只保留支持子 Agent 模式的 skill
     const subAgentSkills = filteredSkills.filter((s) => s.subAgent);
     const ids = subAgentSkills.map((s) => s.id);
-    const param = createDisclosureParam(ids, "选择一个 Skill（支持子 Agent）", EMPTY_HINT);
+    const param = createDisclosureParam(ids, "Select a Skill that supports SubAgent mode", EMPTY_HINT);
     // 拼接各 skill 的描述供 LLM 参考
     const skillDescriptions = subAgentSkills
-        .map((s) => `  - ${s.id}: ${s.description || "无描述"}`)
+        .map((s) => `  - ${s.id}: ${s.description || "No description"}`)
         .join("\n");
-    const skillIdDescription = `${param.description}\n\n各 Skill 说明：\n${skillDescriptions || "  无可用 Skill"}`;
+    const skillIdDescription = `${param.description}\n\nSkill descriptions:\n${skillDescriptions || "  No Skills available"}`;
     return new AgentToolLazy({
         function: {
             name: "call_skill_sub_agent",
-            description: "将任务委派给指定的 Skill 子 Agent，由其独立完成并返回结果。",
+            description: "Delegate a task to the specified Skill SubAgent, which completes it independently and returns the result.",
             parameters: {
                 type: "object",
                 properties: {
@@ -96,7 +96,7 @@ export function createCallSkillSubAgentTool(skillDirs, filteredSkills) {
                     },
                     task: {
                         type: "string",
-                        description: "要委派给子 Agent 完成的任务描述",
+                        description: "Task description to delegate to the SubAgent",
                     },
                 },
                 required: ["skill_id", "task"],
@@ -110,10 +110,10 @@ export function createCallSkillSubAgentTool(skillDirs, filteredSkills) {
             const task = parsedArgs.task;
             const skill = await readSkill(skillDirs, skillId);
             if (!skill) {
-                throw new Error(`❌ Skill "${skillId}" 不存在，请确认名称是否正确`);
+                throw new Error(`❌ Skill "${skillId}" not found, please verify the name`);
             }
             if (!skill.subAgent) {
-                throw new Error(`Skill "${skillId}" 不支持子 Agent 模式，请使用 load_skill 加载指导后自行处理`);
+                throw new Error(`Skill "${skillId}" does not support SubAgent mode, use load_skill to load its guidance and handle the task yourself`);
             }
             // 沿用父 Agent 的工具能力（不做权限过滤），剔除自身以防自递归
             const parentAgent = ctx.agent;

package/dist/scope/plugins/subagents/subAgentTools.js

@@ -8,7 +8,7 @@ import { createModel } from "../../../runtime/createModel.js";
  */
 export function createSubAgentTool(def, scope) {
     if (!def.function) {
-        throw new Error(`Agent "${def.id}" 没有 function 字段，不能作为 SubAgent 工具`);
+        throw new Error(`Agent "${def.id}" has no function field, so it cannot be used as a SubAgent tool`);
     }
     const selfName = def.function.name;
     const lazy = new AgentToolLazy({
@@ -33,7 +33,7 @@ export function createSubAgentTool(def, scope) {
             else {
                 const parent = ctx.agent;
                 if (!parent) {
-                    throw new Error(`SubAgent "${selfName}" 未指定 modelId，且父 Agent 没有可复用的模型`);
+                    throw new Error(`SubAgent "${selfName}" does not specify a modelId, and the parent Agent has no reusable model`);
                 }
                 client = parent.client;
                 model = parent.model;

package/dist/scope/plugins/usertools/discover.js

@@ -74,7 +74,7 @@ async function loadToolFile(filepath, silent) {
     }
     catch (err) {
         if (!silent) {
-            getLogger().error(`[usertools] 加载工具文件失败: ${filepath} — ${err?.message ?? err}`);
+            getLogger().error(`[usertools] Failed to load tool file: ${filepath} — ${err?.message ?? err}`);
         }
         return null;
     }
@@ -110,7 +110,7 @@ function normalizeToolExport(exported, filepath, silent) {
         });
     }
     if (!silent) {
-        getLogger().error(`[usertools] 无法识别的工具格式: ${filepath}`);
+        getLogger().error(`[usertools] Unrecognized tool format: ${filepath}`);
     }
     return null;
 }

package/dist/shared/content-blocks.js

@@ -139,7 +139,7 @@ export async function fileToContentSection(input) {
     // ---- 1. 网络 URL：直接引用，不经上传/内联 ----
     if ("url" in source) {
         if (!isRemoteUrl(source.url)) {
-            throw new Error(`不支持本地 URL（${source.url}）：API 服务商无法访问。本地文件请传文件路径，而不是本地链接。`);
+            throw new Error(`Unsupported local URL (${source.url}): the API provider cannot access it. For local files pass a file path, not a local link`);
         }
         return {
             section: { type: "image_url", image_url: { url: source.url } },
@@ -160,10 +160,10 @@ export async function fileToContentSection(input) {
         absPath = path.isAbsolute(source.path) ? source.path : path.resolve(source.path);
         const st = await fs.stat(absPath);
         if (!st.isFile())
-            throw new Error(`"${absPath}" 不是文件。`);
+            throw new Error(`"${absPath}" is not a file`);
         const inferred = mimeOf(absPath);
         if (!inferred) {
-            throw new Error(`不支持的文件类型："${absPath}"（已知类型：${Object.keys(MIME_BY_EXT).join(" ")}）`);
+            throw new Error(`Unsupported file type: "${absPath}" (known types: ${Object.keys(MIME_BY_EXT).join(" ")})`);
         }
         mime = inferred;
         stat = { mtimeMs: st.mtimeMs, size: st.size };
@@ -198,10 +198,10 @@ export async function fileToContentSection(input) {
     if (isImage && model && model.vision !== true) {
         const label = absPath ?? filename;
         return {
-            section: textSection(`[图片] ${label}（当前模型不支持图片输入，如需查看请改用视觉模型）`),
+            section: textSection(`[Image] ${label} (the current model does not support image input; use a vision-capable model to view it)`),
             transport: "text",
             bytes: byteLength,
-            warning: "当前模型不支持图片输入，已退化为文本提示",
+            warning: "The current model does not support image input; degraded to a text hint",
         };
     }
     // ---- 4. 端点支持 Files API：上传（带缓存），失败降级内联 ----
@@ -231,14 +231,14 @@ export async function fileToContentSection(input) {
         catch (error) {
             if (signal?.aborted)
                 throw error;
-            warning = `上传 Files API 失败，已改为 base64 内联：${error?.message ?? error}`;
+            warning = `Files API upload failed, falling back to base64 inline: ${error?.message ?? error}`;
         }
     }
     // ---- 5. 内联（base64 data URL）----
     if (byteLength > maxInline) {
-        throw new Error(`文件体积 ${(byteLength / 1024 / 1024).toFixed(1)} MiB 超过内联上限 ` +
-            `${(maxInline / 1024 / 1024).toFixed(1)} MiB，且端点未声明 Files API 能力` +
-            `（capabilities.filesApi），无法发送。`);
+        throw new Error(`File size ${(byteLength / 1024 / 1024).toFixed(1)} MiB exceeds the inline limit of ` +
+            `${(maxInline / 1024 / 1024).toFixed(1)} MiB and the endpoint does not declare the Files API capability ` +
+            `(capabilities.filesApi), so it cannot be sent`);
     }
     // base64 来源直接透传，不重新编码（保证字节级一致，也省一次编解码）
     const dataUrl = toDataUrl(base64 ?? Buffer.from(ensureBytes()).toString("base64"), mime);

package/dist/shared/errors.js

@@ -24,9 +24,9 @@ export class ContextOverflowError extends Error {
     /** 被越过的强行阻断阈值（`tokenThresholds.guard`，绝对值） */
     guardTokens;
     constructor(promptTokens, guardTokens) {
-        super(`🛑 上下文严重超限：已用 ${promptTokens} token，超过阻断阈值 ${guardTokens}。` +
-            `当前对话可能因读入超大文件而失控，已中断，请检查并重新开始。` +
-            `（如确需更长上下文，请调高 config.json 中该模型的 tokenThresholds.guard。）`);
+        super(`🛑 Context critically over the limit: ${promptTokens} tokens used, above the blocking threshold of ${guardTokens}.` +
+            ` The conversation may have run away after reading an oversized file, so it has been interrupted — please inspect and start over.` +
+            ` (If you really need a longer context, raise tokenThresholds.guard for this model in config.json.)`);
         this.name = "ContextOverflowError";
         this.promptTokens = promptTokens;
         this.guardTokens = guardTokens;

package/package.json

@@ -1,10 +1,19 @@
 {
   "name": "@ai-zen/agents-sdk",
-  "version": "1.0.0-alpha.22",
+  "version": "1.0.0-alpha.23",
   "description": "AI-Zen Agents SDK — shared business logic for CLI and Desktop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ai-zen/agents.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/ai-zen/agents/tree/main/packages/sdk#readme",
+  "bugs": {
+    "url": "https://github.com/ai-zen/agents/issues"
+  },
   "keywords": [
     "ai",
     "agent",