@ai-zen/agents-sdk 0.3.4 → 0.5.0

package/dist/capabilities/implements/builtin/ReadFileTool.js

@@ -0,0 +1,37 @@
+import * as fsp from "fs/promises";
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+export class ReadFileTool extends SdkCallbackTool {
+    constructor(env) {
+        super({
+            function: {
+                name: "readFile",
+                description: "读取文件",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "文件路径",
+                        },
+                    },
+                    required: ["path"],
+                    additionalProperties: false,
+                },
+            },
+            env,
+        });
+    }
+    async call(input) {
+        try {
+            const filePath = this.resolve(input.path);
+            const stats = await fsp.stat(filePath);
+            if (stats.size > 300 * 1024) {
+                throw new Error(`文件过大，无法读取，当前文件大小 ${stats.size} 字节`);
+            }
+            return await fsp.readFile(filePath, "utf-8");
+        }
+        catch (error) {
+            return error?.message;
+        }
+    }
+}

package/dist/capabilities/implements/builtin/RenameTool.d.ts

@@ -0,0 +1,9 @@
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import type { ToolEnv } from "../../../types/index.js";
+export declare class RenameTool extends SdkCallbackTool {
+    constructor(env: ToolEnv);
+    call(input: {
+        oldPath: string;
+        newPath: string;
+    }): Promise<string>;
+}

package/dist/capabilities/implements/builtin/RenameTool.js

@@ -0,0 +1,37 @@
+import * as fsp from "fs/promises";
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+export class RenameTool extends SdkCallbackTool {
+    constructor(env) {
+        super({
+            function: {
+                name: "rename",
+                description: "重命名或移动文件/目录（相当于 mv 命令）",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        oldPath: {
+                            type: "string",
+                            description: "原路径",
+                        },
+                        newPath: {
+                            type: "string",
+                            description: "新路径",
+                        },
+                    },
+                    required: ["oldPath", "newPath"],
+                    additionalProperties: false,
+                },
+            },
+            env,
+        });
+    }
+    async call(input) {
+        try {
+            await fsp.rename(this.resolve(input.oldPath), this.resolve(input.newPath));
+            return "success";
+        }
+        catch (error) {
+            return error?.message;
+        }
+    }
+}

package/dist/capabilities/implements/builtin/RmTool.d.ts

@@ -0,0 +1,9 @@
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import type { ToolEnv } from "../../../types/index.js";
+export declare class RmTool extends SdkCallbackTool {
+    constructor(env: ToolEnv);
+    call(input: {
+        path: string;
+        recursive?: boolean;
+    }): Promise<string>;
+}

package/dist/capabilities/implements/builtin/RmTool.js

@@ -0,0 +1,39 @@
+import * as fsp from "fs/promises";
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+export class RmTool extends SdkCallbackTool {
+    constructor(env) {
+        super({
+            function: {
+                name: "rm",
+                description: "删除文件或目录",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "文件或目录路径",
+                        },
+                        recursive: {
+                            type: "boolean",
+                            description: "是否递归删除子目录",
+                        },
+                    },
+                    required: ["path"],
+                    additionalProperties: false,
+                },
+            },
+            env,
+        });
+    }
+    async call(input) {
+        try {
+            await fsp.rm(this.resolve(input.path), {
+                recursive: input.recursive ?? false,
+            });
+            return "success";
+        }
+        catch (error) {
+            return error?.message;
+        }
+    }
+}

package/dist/capabilities/implements/builtin/SleepTool.d.ts

@@ -0,0 +1,8 @@
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import type { ToolEnv } from "../../../types/index.js";
+export declare class SleepTool extends SdkCallbackTool {
+    constructor(env: ToolEnv);
+    call(input: {
+        ms: number;
+    }): Promise<string>;
+}

package/dist/capabilities/implements/builtin/SleepTool.js

@@ -0,0 +1,46 @@
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+export class SleepTool extends SdkCallbackTool {
+    constructor(env) {
+        super({
+            function: {
+                name: "sleep",
+                description: "等待指定的时间（毫秒）。用于需要延迟执行的场景，例如等待其他操作完成、操作间隔控制等。注意：过长的等待时间会影响响应速度，建议不超过 30000 毫秒（30 秒）。",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        ms: {
+                            type: "number",
+                            description: "等待的毫秒数（1 秒 = 1000 毫秒）。建议不超过 30000（30 秒）。",
+                        },
+                    },
+                    required: ["ms"],
+                    additionalProperties: false,
+                },
+            },
+            env,
+        });
+    }
+    async call(input) {
+        const ms = input.ms;
+        if (typeof ms !== "number" || !Number.isFinite(ms) || ms < 0) {
+            return JSON.stringify({
+                success: false,
+                error: "ms 必须是正整数",
+            });
+        }
+        if (ms > 300_000) {
+            // 超过 5 分钟给出警告
+            return JSON.stringify({
+                success: false,
+                error: `等待时间 ${ms}ms 过长，建议不超过 300000ms（5 分钟）。如需长时间等待请分段执行。`,
+            });
+        }
+        await new Promise((resolve) => setTimeout(resolve, ms));
+        return JSON.stringify({
+            success: true,
+            waitedMs: ms,
+            waitedSeconds: (ms / 1000).toFixed(1),
+            message: `已等待 ${ms}ms（${(ms / 1000).toFixed(1)} 秒）`,
+        });
+    }
+}

package/dist/capabilities/implements/builtin/WriteFileTool.d.ts

@@ -0,0 +1,9 @@
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import type { ToolEnv } from "../../../types/index.js";
+export declare class WriteFileTool extends SdkCallbackTool {
+    constructor(env: ToolEnv);
+    call(input: {
+        path: string;
+        content: string;
+    }): Promise<string>;
+}

package/dist/capabilities/implements/builtin/WriteFileTool.js

@@ -0,0 +1,40 @@
+import * as fsp from "fs/promises";
+import * as path from "path";
+import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+export class WriteFileTool extends SdkCallbackTool {
+    constructor(env) {
+        super({
+            function: {
+                name: "writeFile",
+                description: "写入文件",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "文件路径",
+                        },
+                        content: {
+                            type: "string",
+                            description: "文件内容",
+                        },
+                    },
+                    required: ["path", "content"],
+                    additionalProperties: false,
+                },
+            },
+            env,
+        });
+    }
+    async call(input) {
+        try {
+            const filePath = this.resolve(input.path);
+            await fsp.mkdir(path.dirname(filePath), { recursive: true });
+            await fsp.writeFile(filePath, input.content);
+            return "success";
+        }
+        catch (error) {
+            return error?.message;
+        }
+    }
+}

package/dist/capabilities/implements/builtin/index.d.ts

@@ -1,21 +1,29 @@
-import type { Tool } from "@ai-zen/agents-core";
-import { cwdTool } from "./cwd.js";
-import { readFileTool } from "./readFile.js";
-import { writeFileTool } from "./writeFile.js";
-import { execTool } from "./exec.js";
-import { mkdirTool } from "./mkdir.js";
-import { rmTool } from "./rm.js";
-import { globTool } from "./glob.js";
-import { lsTool } from "./ls.js";
-import { existTool } from "./exist.js";
-import { findTextTool } from "./findText.js";
-import { downloadFileTool } from "./downloadFile.js";
-import { renameTool } from "./rename.js";
-import { copyTool } from "./copy.js";
-import { batchEditTool } from "./batchEdit.js";
-import { editTool } from "./edit.js";
-import { execAsyncTool } from "./execAsync.js";
-import { sleepTool } from "./sleep.js";
-/** 17 个内置工具实例，注册与实现一体。 */
-export declare const BUILTIN_TOOLS: Tool[];
-export { cwdTool, readFileTool, writeFileTool, execTool, mkdirTool, rmTool, globTool, lsTool, existTool, findTextTool, downloadFileTool, renameTool, copyTool, batchEditTool, editTool, execAsyncTool, sleepTool };
+import type { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import type { ToolEnv } from "../../../types/index.js";
+import { CwdTool } from "./CwdTool.js";
+import { ReadFileTool } from "./ReadFileTool.js";
+import { WriteFileTool } from "./WriteFileTool.js";
+import { ExecTool } from "./ExecTool.js";
+import { MkdirTool } from "./MkdirTool.js";
+import { RmTool } from "./RmTool.js";
+import { GlobTool } from "./GlobTool.js";
+import { LsTool } from "./LsTool.js";
+import { ExistTool } from "./ExistTool.js";
+import { FindTextTool } from "./FindTextTool.js";
+import { DownloadFileTool } from "./DownloadFileTool.js";
+import { RenameTool } from "./RenameTool.js";
+import { CopyTool } from "./CopyTool.js";
+import { BatchEditTool } from "./BatchEditTool.js";
+import { EditTool } from "./EditTool.js";
+import { ExecAsyncTool } from "./ExecAsyncTool.js";
+import { SleepTool } from "./SleepTool.js";
+import { GenerateImageTool } from "./GenerateImageTool.js";
+/**
+ * 17 个无条件注册的内置工具类。
+ * 工具类由 Provider 用 ToolEnv 实例化（每个 Provider 一套实例，注入其 cwd）。
+ *
+ * 注意：GenerateImageTool 依赖图片模型配置（defaultImageModel），
+ * 由 discoverBuiltinTools 按条件实例化，不在此静态注册表中。
+ */
+export declare const BUILTIN_TOOL_CLASSES: Array<new (env: ToolEnv) => SdkCallbackTool>;
+export { CwdTool, ReadFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, GenerateImageTool, };

package/dist/capabilities/implements/builtin/index.js

@@ -1,38 +1,45 @@
-import { cwdTool } from "./cwd.js";
-import { readFileTool } from "./readFile.js";
-import { writeFileTool } from "./writeFile.js";
-import { execTool } from "./exec.js";
-import { mkdirTool } from "./mkdir.js";
-import { rmTool } from "./rm.js";
-import { globTool } from "./glob.js";
-import { lsTool } from "./ls.js";
-import { existTool } from "./exist.js";
-import { findTextTool } from "./findText.js";
-import { downloadFileTool } from "./downloadFile.js";
-import { renameTool } from "./rename.js";
-import { copyTool } from "./copy.js";
-import { batchEditTool } from "./batchEdit.js";
-import { editTool } from "./edit.js";
-import { execAsyncTool } from "./execAsync.js";
-import { sleepTool } from "./sleep.js";
-/** 17 个内置工具实例，注册与实现一体。 */
-export const BUILTIN_TOOLS = [
-    cwdTool,
-    readFileTool,
-    writeFileTool,
-    execTool,
-    mkdirTool,
-    rmTool,
-    globTool,
-    lsTool,
-    existTool,
-    findTextTool,
-    downloadFileTool,
-    renameTool,
-    copyTool,
-    batchEditTool,
-    editTool,
-    execAsyncTool,
-    sleepTool,
+import { CwdTool } from "./CwdTool.js";
+import { ReadFileTool } from "./ReadFileTool.js";
+import { WriteFileTool } from "./WriteFileTool.js";
+import { ExecTool } from "./ExecTool.js";
+import { MkdirTool } from "./MkdirTool.js";
+import { RmTool } from "./RmTool.js";
+import { GlobTool } from "./GlobTool.js";
+import { LsTool } from "./LsTool.js";
+import { ExistTool } from "./ExistTool.js";
+import { FindTextTool } from "./FindTextTool.js";
+import { DownloadFileTool } from "./DownloadFileTool.js";
+import { RenameTool } from "./RenameTool.js";
+import { CopyTool } from "./CopyTool.js";
+import { BatchEditTool } from "./BatchEditTool.js";
+import { EditTool } from "./EditTool.js";
+import { ExecAsyncTool } from "./ExecAsyncTool.js";
+import { SleepTool } from "./SleepTool.js";
+import { GenerateImageTool } from "./GenerateImageTool.js";
+/**
+ * 17 个无条件注册的内置工具类。
+ * 工具类由 Provider 用 ToolEnv 实例化（每个 Provider 一套实例，注入其 cwd）。
+ *
+ * 注意：GenerateImageTool 依赖图片模型配置（defaultImageModel），
+ * 由 discoverBuiltinTools 按条件实例化，不在此静态注册表中。
+ */
+export const BUILTIN_TOOL_CLASSES = [
+    CwdTool,
+    ReadFileTool,
+    WriteFileTool,
+    ExecTool,
+    MkdirTool,
+    RmTool,
+    GlobTool,
+    LsTool,
+    ExistTool,
+    FindTextTool,
+    DownloadFileTool,
+    RenameTool,
+    CopyTool,
+    BatchEditTool,
+    EditTool,
+    ExecAsyncTool,
+    SleepTool,
 ];
-export { cwdTool, readFileTool, writeFileTool, execTool, mkdirTool, rmTool, globTool, lsTool, existTool, findTextTool, downloadFileTool, renameTool, copyTool, batchEditTool, editTool, execAsyncTool, sleepTool };
+export { CwdTool, ReadFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, GenerateImageTool, };

package/dist/capabilities/implements/builtin/test-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { AppConfig, ToolEnv } from "../../../types/index.js";
+/** 构造测试用 ToolEnv */
+export declare function makeEnv(cwd?: string, config?: AppConfig): ToolEnv;

package/dist/capabilities/implements/builtin/test-helpers.js

@@ -0,0 +1,4 @@
+/** 构造测试用 ToolEnv */
+export function makeEnv(cwd = process.cwd(), config = {}) {
+    return { cwd, config };
+}

package/dist/capabilities/implements/mcpTools.js

@@ -1,6 +1,8 @@
 import { CallbackTool } from "@ai-zen/agents-core";
 import { createDisclosureParam } from "../disclosure.js";
+import { getLogger } from "../../shared/logger.js";
 const EMPTY_HINT = "（当前没有可用的 MCP 服务器，请联系用户添加）";
+const log = getLogger();
 /**
  * 创建 load_mcp 工具。
  * server 枚举由 filteredMcps （完整 McpServerConfig[]）自动推导，
@@ -40,13 +42,13 @@ export function createLoadMcpTool(mcpManager, filteredMcps) {
             const existingManifest = mcpManager.getManifest(serverName);
             if (existingManifest && mcpManager.getState(serverName) === "connected") {
                 mcpManager.touch(serverName);
-                const toolList = existingManifest.tools.map((t) => `- ${t.name}: ${t.description}`).join("\n");
-                return `✅ MCP 服务器 "${serverName}" 已连接 (${existingManifest.tools.length} 个工具):\n${toolList}`;
+                log.info(`[load_mcp] ${serverName}:\n${JSON.stringify(existingManifest, null, 2)}`);
+                return JSON.stringify({ tools: existingManifest.tools, resources: existingManifest.resources });
             }
             try {
                 const manifest = await mcpManager.connect(serverName, config);
-                const toolList = manifest.tools.map((t) => `- ${t.name}: ${t.description}`).join("\n");
-                return `✅ MCP 服务器 "${serverName}" 已连接 (${manifest.tools.length} 个工具):\n${toolList}`;
+                log.info(`[load_mcp] ${serverName}:\n${JSON.stringify(manifest, null, 2)}`);
+                return JSON.stringify({ tools: manifest.tools, resources: manifest.resources });
             }
             catch (error) {
                 return `无法连接到 "${serverName}": ${error?.message ?? error}`;

package/dist/capabilities/implements/skillTools.js

@@ -2,9 +2,9 @@ import { CallbackTool, Agent, Message } from "@ai-zen/agents-core";
 import { SdkAgent } from "../../runtime/SdkAgent.js";
 import { createDisclosureParam } from "../disclosure.js";
 import { readSkill } from "../discovery/skills.js";
-import { createLogger } from "../../shared/logger.js";
+import { getLogger } from "../../shared/logger.js";
 import { promises as fs } from "node:fs";
-const log = createLogger();
+const log = getLogger();
 const EMPTY_HINT = "（当前没有可用的 Skill，请联系用户添加）";
 /**
  * 创建 load_skill 工具。

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { PermissionPolicy, AgentPermissions, Endpoint, Model, ImageModel, AgentDefinition, Conversation, Draft, AppConfig, McpIcon, McpAnnotations, McpToolDef, McpResourceDef, McpPromptDef, McpServerManifest, McpServerConfig, McpConnectionState, } from "./types/index.js";
+export type { PermissionPolicy, AgentPermissions, Endpoint, Model, ImageModel, AgentDefinition, AppConfig, ToolEnv, McpIcon, McpAnnotations, McpToolDef, McpResourceDef, McpPromptDef, McpServerManifest, McpServerConfig, McpConnectionState, } from "./types/index.js";
 export { PermissionEvaluator } from "./capabilities/PermissionEvaluator.js";
 export type { CandidateSets } from "./capabilities/PermissionEvaluator.js";
 export { createDisclosureParam } from "./capabilities/disclosure.js";
@@ -12,8 +12,6 @@ export { discoverUserTools } from "./capabilities/discovery/usertools.js";
 export { ConfigManager, DEFAULT_AGENT_ID, DEFAULT_AGENT_DEFINITION, DEFAULT_SUBAGENT_ID, DEFAULT_SUBAGENT_DEFINITION, DEFAULT_APP_CONFIG, CONFIG_SUB_DIRS, } from "./config/ConfigManager.js";
 export { EntityRepository } from "./shared/EntityRepository.js";
 export { AgentRepository } from "./crud/AgentRepository.js";
-export { ConversationRepository } from "./crud/ConversationRepository.js";
-export { DraftRepository } from "./crud/DraftRepository.js";
 export { Provider } from "./runtime/Provider.js";
 export type { FilterOutput, ExcludeOptions } from "./runtime/Provider.js";
 export { createModel } from "./runtime/createModel.js";
@@ -22,20 +20,18 @@ export type { AgentPlugin, SendContext } from "./runtime/SdkAgent.js";
 export { createAgent } from "./runtime/createAgent.js";
 export { McpConnectionManager } from "./runtime/McpConnectionManager.js";
 export type { McpConnectOptions } from "./runtime/McpConnectionManager.js";
+export { SdkCallbackTool } from "./runtime/SdkCallbackTool.js";
 export { TaskMigrationService } from "./runtime/TaskMigrationService.js";
 export type { BuildMigrationAgentOptions } from "./runtime/TaskMigrationService.js";
 export { AutoMigratePlugin } from "./plugin/AutoMigratePlugin.js";
 export type { AutoMigrateOptions } from "./plugin/AutoMigratePlugin.js";
-export { AutoDraftPlugin } from "./plugin/AutoDraftPlugin.js";
-export type { AutoDraftOptions } from "./plugin/AutoDraftPlugin.js";
 export { AutoRefreshToolsPlugin } from "./plugin/AutoRefreshToolsPlugin.js";
-export { BUILTIN_TOOLS } from "./capabilities/implements/builtin/index.js";
-export { createGenerateImageTool } from "./capabilities/implements/builtin/generateImage.js";
-export { execAsyncTool } from "./capabilities/implements/builtin/execAsync.js";
-export { sleepTool } from "./capabilities/implements/builtin/sleep.js";
+export { BUILTIN_TOOL_CLASSES } from "./capabilities/implements/builtin/index.js";
+export { CwdTool, ReadFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, } from "./capabilities/implements/builtin/index.js";
+export { GenerateImageTool } from "./capabilities/implements/builtin/GenerateImageTool.js";
 export { createLoadSkillTool, createCallSkillSubAgentTool } from "./capabilities/implements/skillTools.js";
 export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./capabilities/implements/mcpTools.js";
 export { createSubAgentTool } from "./capabilities/implements/subAgentTools.js";
-export { createLogger } from "./shared/logger.js";
+export { getLogger, setLogger } from "./shared/logger.js";
 export type { Logger, LogFunctions } from "./shared/logger.js";
 export { SdkError } from "./shared/errors.js";

package/dist/index.js

@@ -9,30 +9,27 @@ export { discoverMcpServers } from "./capabilities/discovery/mcp.js";
 export { discoverUserTools } from "./capabilities/discovery/usertools.js";
 // 配置 — ConfigManager
 export { ConfigManager, DEFAULT_AGENT_ID, DEFAULT_AGENT_DEFINITION, DEFAULT_SUBAGENT_ID, DEFAULT_SUBAGENT_DEFINITION, DEFAULT_APP_CONFIG, CONFIG_SUB_DIRS, } from "./config/ConfigManager.js";
-// CRUD — EntityRepository + 实体仓储
+// CRUD — 实体仓储（仅 Agent 定义等能力实体）
 export { EntityRepository } from "./shared/EntityRepository.js";
 export { AgentRepository } from "./crud/AgentRepository.js";
-export { ConversationRepository } from "./crud/ConversationRepository.js";
-export { DraftRepository } from "./crud/DraftRepository.js";
 // 运行时
 export { Provider } from "./runtime/Provider.js";
 export { createModel } from "./runtime/createModel.js";
 export { SdkAgent } from "./runtime/SdkAgent.js";
 export { createAgent } from "./runtime/createAgent.js";
 export { McpConnectionManager } from "./runtime/McpConnectionManager.js";
+export { SdkCallbackTool } from "./runtime/SdkCallbackTool.js";
 export { TaskMigrationService } from "./runtime/TaskMigrationService.js";
 // 插件
 export { AutoMigratePlugin } from "./plugin/AutoMigratePlugin.js";
-export { AutoDraftPlugin } from "./plugin/AutoDraftPlugin.js";
 export { AutoRefreshToolsPlugin } from "./plugin/AutoRefreshToolsPlugin.js";
-// 工具
-export { BUILTIN_TOOLS } from "./capabilities/implements/builtin/index.js";
-export { createGenerateImageTool } from "./capabilities/implements/builtin/generateImage.js";
-export { execAsyncTool } from "./capabilities/implements/builtin/execAsync.js";
-export { sleepTool } from "./capabilities/implements/builtin/sleep.js";
+// 工具 — 内置工具类 + 动态工具工厂
+export { BUILTIN_TOOL_CLASSES } from "./capabilities/implements/builtin/index.js";
+export { CwdTool, ReadFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, } from "./capabilities/implements/builtin/index.js";
+export { GenerateImageTool } from "./capabilities/implements/builtin/GenerateImageTool.js";
 export { createLoadSkillTool, createCallSkillSubAgentTool } from "./capabilities/implements/skillTools.js";
 export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./capabilities/implements/mcpTools.js";
 export { createSubAgentTool } from "./capabilities/implements/subAgentTools.js";
 // 共享
-export { createLogger } from "./shared/logger.js";
+export { getLogger, setLogger } from "./shared/logger.js";
 export { SdkError } from "./shared/errors.js";

package/dist/plugin/AutoMigratePlugin.js

@@ -1,7 +1,7 @@
 import { AgentNS } from "@ai-zen/agents-core";
 import { TaskMigrationService } from "../runtime/TaskMigrationService.js";
-import { createLogger } from "../shared/logger.js";
-const log = createLogger();
+import { getLogger } from "../shared/logger.js";
+const log = getLogger();
 /**
  * 自动迁移插件。
  *

package/dist/runtime/McpConnectionManager.js

@@ -1,6 +1,7 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { getLogger } from "../shared/logger.js";
 const DEFAULT_IDLE_TIMEOUT = {
     stdio: 30 * 60 * 1000,
     http: 5 * 60 * 1000,
@@ -139,7 +140,7 @@ export class McpConnectionManager {
                 }));
             }
             catch (err) {
-                console.error(`[McpConnectionManager] 获取 "${name}" 工具列表失败:`, err);
+                getLogger().error(`[McpConnectionManager] 获取 "${name}" 工具列表失败: ${err?.message ?? err}`);
             }
         }
         if (serverCaps?.resources) {
@@ -153,7 +154,7 @@ export class McpConnectionManager {
                 }));
             }
             catch (err) {
-                console.error(`[McpConnectionManager] 获取 "${name}" 资源列表失败:`, err);
+                getLogger().error(`[McpConnectionManager] 获取 "${name}" 资源列表失败: ${err?.message ?? err}`);
             }
         }
         if (serverCaps?.prompts) {
@@ -165,7 +166,7 @@ export class McpConnectionManager {
                 }));
             }
             catch (err) {
-                console.error(`[McpConnectionManager] 获取 "${name}" 提示列表失败:`, err);
+                getLogger().error(`[McpConnectionManager] 获取 "${name}" 提示列表失败: ${err?.message ?? err}`);
             }
         }
         const entry = this.servers.get(name) ?? { state: "connecting" };

package/dist/runtime/Provider.d.ts

@@ -1,5 +1,5 @@
 import type { Tool } from "@ai-zen/agents-core";
-import type { AppConfig, AgentDefinition, AgentPermissions, McpServerConfig } from "../types/index.js";
+import type { AppConfig, AgentDefinition, AgentPermissions, McpServerConfig, ToolEnv } from "../types/index.js";
 import type { SkillInfo } from "../capabilities/discovery/skills.js";
 import { McpConnectionManager } from "./McpConnectionManager.js";
 /**
@@ -48,6 +48,10 @@ export interface ExcludeOptions {
 export declare class Provider {
     /** 应用配置（端点、模型等） */
     readonly config: AppConfig;
+    /** 当前工作目录 — 相对路径解析基准，也是 ToolEnv.cwd 的来源 */
+    readonly cwd: string;
+    /** 工具环境 — 实例化内置工具时注入 */
+    readonly env: ToolEnv;
     readonly agentsDir: string;
     readonly subAgentsPaths: string[];
     readonly skillsPaths: string[];
@@ -68,6 +72,8 @@ export declare class Provider {
         skillsPaths?: string[];
         toolsPaths?: string[];
         mcpPaths?: string[];
+        /** 当前工作目录，默认 process.cwd() */
+        cwd?: string;
     });
     /**
      * 异步创建 Provider，一步完成构造 + 全局能力发现。
@@ -79,6 +85,8 @@ export declare class Provider {
         skillsPaths?: string[];
         toolsPaths?: string[];
         mcpPaths?: string[];
+        /** 当前工作目录，默认 process.cwd() */
+        cwd?: string;
     }): Promise<Provider>;
     /**
      * 初始化：执行全局能力发现。

package/dist/runtime/Provider.js

@@ -34,6 +34,10 @@ import { discoverUserTools } from "../capabilities/discovery/usertools.js";
 export class Provider {
     /** 应用配置（端点、模型等） */
     config;
+    /** 当前工作目录 — 相对路径解析基准，也是 ToolEnv.cwd 的来源 */
+    cwd;
+    /** 工具环境 — 实例化内置工具时注入 */
+    env;
     // ---- 路径 ----
     agentsDir;
     subAgentsPaths;
@@ -52,6 +56,8 @@ export class Provider {
     mcpManager;
     constructor(options) {
         this.config = options.config;
+        this.cwd = options.cwd ?? process.cwd();
+        this.env = { cwd: this.cwd, config: this.config };
         this.agentsDir = options.agentsDir;
         this.subAgentsPaths = options.subAgentsPaths ?? [];
         this.skillsPaths = options.skillsPaths ?? [];
@@ -181,7 +187,7 @@ export class Provider {
      */
     async refresh(options) {
         const silent = options?.silent ?? false;
-        this.builtinTools = discoverBuiltinTools(this.config);
+        this.builtinTools = discoverBuiltinTools(this.env);
         this.userTools = await discoverUserTools(this.toolsPaths, { silent });
         this.subagents = await discoverSubAgents(this.subAgentsPaths);
         this.skills = await discoverSkills(this.skillsPaths, { silent });