@ai-zen/agents-sdk 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.2.5] - 2026-07-20
+
+### 🔧 修复
+
+- **`DEFAULT_SUBAGENT_DEFINITION` 缺少 `permissions` 配置** — 默认 SubAgent `general-assistant` 未配置权限，导致所有维度等同于 `deny: ['*']`，完全无法使用任何工具/skill/MCP/SubAgent。现已按设计规范补全，仅 `subagents` 维度设为 `deny: ['*']` 防止递归调用
+
+## [0.2.4] - 2026-07-20
+
+### 🔧 修复
+
+- **`load_skill` 不再注入 System 消息** — 改为在工具返回值中直接返回完整 SKILL.md 内容和 Skill 目录路径、文件列表，LLM 完全透明可见
+- **`SkillInfo` 新增 `dirPath` 字段** — 记录 SKILL.md 所在目录的绝对路径
+- **`McpConnectionManager.doConnect` 按 Server capabilities 按需调用** — 仅对声明了的能力调用对应方法，避免未声明时返回 Method not found
+- **`McpConnectionManager.doConnect` 各 list 调用加 try/catch 保护** — 单个能力获取失败不影响其他能力
+
+## [0.2.3] - 2026-07-20
+
+### 🔧 修复
+
+- **`AgentRepository` — 使用 `EntityRepository` 替代直接文件操作** — 采用基础仓储统一逻辑
+
 ## [0.2.2] - 2026-07-20
 
 ### 🔧 修复

package/dist/capabilities/discovery/skills.d.ts

@@ -20,6 +20,8 @@ export interface SkillInfo {
     description: string;
     subAgent: boolean;
     content: string;
+    /** SKILL.md 所在目录的绝对路径 */
+    dirPath: string;
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;

package/dist/capabilities/discovery/skills.js

@@ -75,6 +75,7 @@ function readSkillFromPath(skillId, skillMdPath, silent) {
             description: fm.description ?? "",
             subAgent: fm.subAgent ?? false,
             content,
+            dirPath: skillMdPath.replace(/\/SKILL\.md$/, ""),
             license: fm.license,
             compatibility: fm.compatibility,
             metadata: fm.metadata,

package/dist/capabilities/implements/skillTools.js

@@ -3,6 +3,7 @@ import { SdkAgent } from "../../runtime/SdkAgent.js";
 import { createDisclosureParam } from "../disclosure.js";
 import { readSkill } from "../discovery/skills.js";
 import { createLogger } from "../../shared/logger.js";
+import { readdirSync } from "node:fs";
 const log = createLogger();
 const EMPTY_HINT = "（当前没有可用的 Skill，请联系用户添加）";
 /**
@@ -40,14 +41,28 @@ export function createLoadSkillTool(skillDirs, filteredSkills) {
             if (!skill) {
                 return `❌ Skill "${skillId}" 不存在，请确认名称是否正确`;
             }
-            const alreadyLoaded = this.agent?.messages?.some((m) => String(m.content ?? "").includes(`Skill "${skillId}" 已加载`));
-            if (alreadyLoaded) {
-                return `Skill "${skillId}" 已加载`;
+            // 扫描 skill 目录下的文件列表
+            let fileList = "";
+            try {
+                const entries = readdirSync(skill.dirPath, { withFileTypes: true });
+                const files = entries.map((e) => {
+                    const suffix = e.isDirectory() ? "/" : "";
+                    return `  - ${e.name}${suffix}`;
+                });
+                fileList = `\n\nSkill 目录文件列表：\n${files.join("\n")}`;
             }
-            if (this.agent) {
-                this.agent.messages.push(Message.System(`以下是 Skill "${skillId}" 的内容，请按照其中的指导完成任务：\n\n${skill.content}`));
+            catch {
+                fileList = "";
             }
-            return `✅ Skill "${skillId}" 已加载，内容已附加到当前对话中`;
+            return [
+                `Skill "${skillId}" 已加载：`,
+                ``,
+                `Skill 目录路径: ${skill.dirPath}`,
+                fileList,
+                ``,
+                `--- Skill 内容开始 ---`,
+                skill.content,
+            ].join("\n");
         },
     });
 }

package/dist/config/constants.js

@@ -39,6 +39,12 @@ export const DEFAULT_SUBAGENT_DEFINITION = {
         },
         { role: AgentNS.Role.User, content: "{{query}}" },
     ],
+    permissions: {
+        tools: { allow: ["*"] },
+        skills: { allow: ["*"] },
+        mcps: { allow: ["*"] },
+        subagents: { deny: ["*"] },
+    },
     function: {
         name: "general_assistant",
         description: "通用助手，可独立完成各类任务",

package/dist/runtime/McpConnectionManager.js

@@ -122,26 +122,52 @@ export class McpConnectionManager {
             ? this._clientFactory()
             : new Client({ name: "ai-zen-agents", version: "0.1.0" }, { capabilities: {} });
         await client.connect(transport);
-        const toolsResult = await client.listTools();
-        const resourcesResult = await client.listResources();
-        const promptsResult = await client.listPrompts();
+        // 根据 Server 声明的 capabilities 按需调用，避免调用未声明的方法
+        const serverCaps = client.getServerCapabilities();
         const manifest = {
-            tools: (toolsResult.tools ?? []).map((t) => ({
-                name: t.name,
-                description: t.description ?? "",
-                inputSchema: t.inputSchema,
-            })),
-            resources: (resourcesResult.resources ?? []).map((r) => ({
-                uri: r.uri,
-                name: r.name,
-                description: r.description,
-                mimeType: r.mimeType,
-            })),
-            prompts: (promptsResult.prompts ?? []).map((p) => ({
-                name: p.name,
-                description: p.description,
-            })),
+            tools: [],
+            resources: [],
+            prompts: [],
         };
+        if (serverCaps?.tools) {
+            try {
+                const toolsResult = await client.listTools();
+                manifest.tools = (toolsResult.tools ?? []).map((t) => ({
+                    name: t.name,
+                    description: t.description ?? "",
+                    inputSchema: t.inputSchema,
+                }));
+            }
+            catch (err) {
+                console.error(`[McpConnectionManager] 获取 "${name}" 工具列表失败:`, err);
+            }
+        }
+        if (serverCaps?.resources) {
+            try {
+                const resourcesResult = await client.listResources();
+                manifest.resources = (resourcesResult.resources ?? []).map((r) => ({
+                    uri: r.uri,
+                    name: r.name,
+                    description: r.description,
+                    mimeType: r.mimeType,
+                }));
+            }
+            catch (err) {
+                console.error(`[McpConnectionManager] 获取 "${name}" 资源列表失败:`, err);
+            }
+        }
+        if (serverCaps?.prompts) {
+            try {
+                const promptsResult = await client.listPrompts();
+                manifest.prompts = (promptsResult.prompts ?? []).map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                }));
+            }
+            catch (err) {
+                console.error(`[McpConnectionManager] 获取 "${name}" 提示列表失败:`, err);
+            }
+        }
         const entry = this.servers.get(name) ?? { state: "connecting" };
         this.servers.set(name, {
             ...entry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-zen/agents-sdk",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "AI-Zen Agents SDK — shared business logic for CLI and Desktop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",