@ai-zen/agents-sdk 0.12.0 → 1.0.0-alpha.0

package/dist/scope/plugins/builtin/BuiltinToolsScopePlugin.d.ts

@@ -0,0 +1,20 @@
+import type { Tool } from "@ai-zen/agents-core";
+import type { AgentDefinition } from "../../../types/index.js";
+import type { Scope, FilterOutput } from "../../Scope.js";
+import type { ScopeCandidates, ScopePlugin } from "../../ScopePlugin.js";
+/**
+ * 内置工具插件 —— 20 个内置工具类（BUILTIN_TOOL_CLASSES）。
+ *
+ * 发现层零过滤；可用性由各工具 `isAvailable(config, definition)` 自陈，
+ * 在本插件 `candidates()` 阶段按声明剔除（如 GenerateImageTool 依赖 defaultImageModel、
+ * ViewImageTool 仅视觉模型可用）。
+ */
+export declare class BuiltinToolsScopePlugin implements ScopePlugin {
+    static readonly ID = "builtin";
+    readonly id = "builtin";
+    /** 发现结果自持（每次 discover 重新实例化） */
+    private tools;
+    discover(scope: Scope): void;
+    candidates(scope: Scope, definition: AgentDefinition): ScopeCandidates;
+    instantiate(_scope: Scope, filtered: FilterOutput): Tool[];
+}

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

@@ -0,0 +1,30 @@
+import { discoverBuiltinTools } from "./discover.js";
+/**
+ * 内置工具插件 —— 20 个内置工具类（BUILTIN_TOOL_CLASSES）。
+ *
+ * 发现层零过滤；可用性由各工具 `isAvailable(config, definition)` 自陈，
+ * 在本插件 `candidates()` 阶段按声明剔除（如 GenerateImageTool 依赖 defaultImageModel、
+ * ViewImageTool 仅视觉模型可用）。
+ */
+export class BuiltinToolsScopePlugin {
+    static ID = "builtin";
+    id = BuiltinToolsScopePlugin.ID;
+    /** 发现结果自持（每次 discover 重新实例化） */
+    tools = [];
+    discover(scope) {
+        this.tools = discoverBuiltinTools(scope.env);
+    }
+    candidates(scope, definition) {
+        const tools = this.tools
+            .filter((t) => {
+            const isAvailable = t?.isAvailable;
+            return isAvailable ? isAvailable(scope.config, definition) : true;
+        })
+            .map((t) => t.function.name);
+        return { tools };
+    }
+    instantiate(_scope, filtered) {
+        const allow = new Set(filtered.tools);
+        return this.tools.filter((t) => allow.has(t.function.name));
+    }
+}

package/dist/{capabilities/implements → scope/plugins}/builtin/CopyTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class CopyTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/CopyTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class CopyTool extends SdkCallbackTool {
     function = {
         name: "copy",

package/dist/{capabilities/implements → scope/plugins}/builtin/CwdTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class CwdTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/CwdTool.js

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class CwdTool extends SdkCallbackTool {
     function = {
         name: "cwd",

package/dist/{capabilities/implements → scope/plugins}/builtin/DownloadFileTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
 export declare class DownloadFileTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/DownloadFileTool.js

@@ -1,6 +1,6 @@
 import * as fsp from "fs/promises";
 import * as path from "path";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class DownloadFileTool extends SdkCallbackTool {
     function = {
         name: "downloadFile",

package/dist/{capabilities/implements → scope/plugins}/builtin/EditTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class EditTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/EditTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 function countOccurrences(content, text) {
     let count = 0;
     let pos = 0;

package/dist/{capabilities/implements → scope/plugins}/builtin/ExecAsyncTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class ExecAsyncTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/ExecAsyncTool.js

@@ -1,5 +1,5 @@
 import { spawn } from "child_process";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class ExecAsyncTool extends SdkCallbackTool {
     function = {
         name: "exec_async",

package/dist/{capabilities/implements → scope/plugins}/builtin/ExecTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
 export declare class ExecTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/ExecTool.js

@@ -1,5 +1,5 @@
 import { exec } from "child_process";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headTailPreview } from "./outputGuard.js";
 export class ExecTool extends SdkCallbackTool {
     function = {

package/dist/{capabilities/implements → scope/plugins}/builtin/ExistTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class ExistTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/ExistTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class ExistTool extends SdkCallbackTool {
     function = {
         name: "exist",

package/dist/{capabilities/implements → scope/plugins}/builtin/FindTextTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
 export declare class FindTextTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/FindTextTool.js

@@ -1,6 +1,6 @@
 import * as fsp from "fs/promises";
 import * as path from "path";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard.js";
 /** 默认总匹配数上限 */
 const DEFAULT_MAX_MATCHES = 200;

package/dist/{capabilities/implements → scope/plugins}/builtin/GenerateImageTool.d.ts

@@ -1,5 +1,5 @@
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { AgentDefinition, AppConfig, ToolEnv } from "../../../types/index.js";
 /**
  * 根据文字描述生成图片。**统一返回字符串**（JSON，含图片 URL 列表）：

package/dist/{capabilities/implements → scope/plugins}/builtin/GenerateImageTool.js

@@ -1,5 +1,5 @@
 import OpenAI from "openai";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 /**
  * 根据文字描述生成图片。**统一返回字符串**（JSON，含图片 URL 列表）：
  * 生成结果如何处理（查看/下载/转发）由模型与上层自由决定——

package/dist/{capabilities/implements → scope/plugins}/builtin/GlobTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
 export declare class GlobTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/GlobTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard.js";
 export class GlobTool extends SdkCallbackTool {
     function = {

package/dist/{capabilities/implements → scope/plugins}/builtin/InspectFileTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 /**

package/dist/{capabilities/implements → scope/plugins}/builtin/InspectFileTool.js

@@ -1,7 +1,7 @@
 import * as fsp from "fs/promises";
 import { createReadStream } from "fs";
 import { StringDecoder } from "string_decoder";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import { DEFAULT_MAX_TOOL_OUTPUT } from "./outputGuard.js";
 /**
  * 勘察文件结构概况（行数、每行列数等），不做内容读取。

package/dist/{capabilities/implements → scope/plugins}/builtin/LsTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class LsTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/LsTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard.js";
 export class LsTool extends SdkCallbackTool {
     function = {

package/dist/{capabilities/implements → scope/plugins}/builtin/MkdirTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class MkdirTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/MkdirTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class MkdirTool extends SdkCallbackTool {
     function = {
         name: "mkdir",

package/dist/{capabilities/implements → scope/plugins}/builtin/ReadFileTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class ReadFileTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/ReadFileTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput } from "./outputGuard.js";
 export class ReadFileTool extends SdkCallbackTool {
     function = {

package/dist/{capabilities/implements → scope/plugins}/builtin/RenameTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class RenameTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/RenameTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class RenameTool extends SdkCallbackTool {
     function = {
         name: "rename",

package/dist/{capabilities/implements → scope/plugins}/builtin/RmTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class RmTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/RmTool.js

@@ -1,5 +1,5 @@
 import * as fsp from "fs/promises";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class RmTool extends SdkCallbackTool {
     function = {
         name: "rm",

package/dist/{runtime → scope/plugins/builtin}/SdkCallbackTool.d.ts

@@ -1,6 +1,6 @@
 import { Tool, ToolCallContext } from "@ai-zen/agents-core";
 import type { AgentNS } from "@ai-zen/agents-core";
-import type { AgentDefinition, AppConfig, ToolEnv } from "../types/index.js";
+import type { AgentDefinition, AppConfig, ToolEnv } from "../../../types/index.js";
 /** SdkCallbackTool 构造选项。env 为核心字段，未来可在此扩展可选项。 */
 export interface SdkCallbackToolOptions {
     /** 注入的工具环境 */

package/dist/{capabilities/implements → scope/plugins}/builtin/SleepTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
 export declare class SleepTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/SleepTool.js

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class SleepTool extends SdkCallbackTool {
     function = {
         name: "sleep",

package/dist/{capabilities/implements → scope/plugins}/builtin/ViewImageTool.d.ts

@@ -1,5 +1,5 @@
 import type { AgentNS, ToolCallContext } from "@ai-zen/agents-core";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { AgentDefinition, AppConfig, ToolEnv } from "../../../types/index.js";
 /**
  * 查看图片工具 — 让 Agent 主动查看/分析一张图片。**仅对视觉模型可用**：

package/dist/{capabilities/implements → scope/plugins}/builtin/ViewImageTool.js

@@ -1,7 +1,7 @@
 import OpenAI, { toFile } from "openai";
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 const SUPPORTED_EXT = [".jpg", ".jpeg", ".png", ".gif", ".webp"];
 /**
  * 是否为"本地 URL"——指向本地/回环地址，API 服务商无法下载访问。

package/dist/{capabilities/implements → scope/plugins}/builtin/WriteFileTool.d.ts

@@ -1,4 +1,4 @@
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import type { AgentNS } from "@ai-zen/agents-core";
 export declare class WriteFileTool extends SdkCallbackTool {

package/dist/{capabilities/implements → scope/plugins}/builtin/WriteFileTool.js

@@ -1,6 +1,6 @@
 import * as fsp from "fs/promises";
 import * as path from "path";
-import { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class WriteFileTool extends SdkCallbackTool {
     function = {
         name: "writeFile",

package/dist/{capabilities/discovery/builtin.d.ts → scope/plugins/builtin/discover.d.ts}

@@ -1,5 +1,5 @@
 import type { Tool } from "@ai-zen/agents-core";
-import type { ToolEnv } from "../../types/index.js";
+import type { ToolEnv } from "../../../types/index.js";
 /**
  * 发现内置工具：按静态注册表实例化全部内置工具（无任何过滤）。
  *

package/dist/{capabilities/discovery/builtin.js → scope/plugins/builtin/discover.js}

@@ -1,4 +1,4 @@
-import { BUILTIN_TOOL_CLASSES } from "../implements/builtin/index.js";
+import { BUILTIN_TOOL_CLASSES } from "./index.js";
 /**
  * 发现内置工具：按静态注册表实例化全部内置工具（无任何过滤）。
  *

package/dist/{capabilities/implements → scope/plugins}/builtin/index.d.ts

@@ -1,4 +1,4 @@
-import type { SdkCallbackTool } from "../../../runtime/SdkCallbackTool.js";
+import type { SdkCallbackTool } from "./SdkCallbackTool.js";
 import type { ToolEnv } from "../../../types/index.js";
 import { CwdTool } from "./CwdTool.js";
 import { ReadFileTool } from "./ReadFileTool.js";
@@ -22,7 +22,7 @@ import { ViewImageTool } from "./ViewImageTool.js";
 import { GenerateImageTool } from "./GenerateImageTool.js";
 /**
  * 全部内置工具类（20 个）。
- * 工具类由 Provider 用 ToolEnv 实例化（每个 Provider 一套实例，注入其 cwd）。
+ * 工具类由 Scope 的内置工具插件（BuiltinToolsScopePlugin）用 ToolEnv 实例化（每个 Scope 一套实例，注入其 cwd）。
  *
  * 发现层不做任何过滤——工具的可用性由各工具自行声明（SdkCallbackTool.isAvailable，
  * 入参含完整 config + 模型信息），在 buildTools/filter 阶段按声明过滤。

package/dist/{capabilities/implements → scope/plugins}/builtin/index.js

@@ -20,7 +20,7 @@ import { ViewImageTool } from "./ViewImageTool.js";
 import { GenerateImageTool } from "./GenerateImageTool.js";
 /**
  * 全部内置工具类（20 个）。
- * 工具类由 Provider 用 ToolEnv 实例化（每个 Provider 一套实例，注入其 cwd）。
+ * 工具类由 Scope 的内置工具插件（BuiltinToolsScopePlugin）用 ToolEnv 实例化（每个 Scope 一套实例，注入其 cwd）。
  *
  * 发现层不做任何过滤——工具的可用性由各工具自行声明（SdkCallbackTool.isAvailable，
  * 入参含完整 config + 模型信息），在 buildTools/filter 阶段按声明过滤。

package/dist/{runtime → scope/plugins/mcp}/McpConnectionManager.d.ts

@@ -1,6 +1,6 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
-import type { McpServerConfig, McpServerManifest, McpConnectionState } from "../types/index.js";
+import type { McpServerConfig, McpServerManifest, McpConnectionState } from "../../../types/index.js";
 export interface McpConnectOptions {
     /** 空闲超时（毫秒），默认 stdio: 30min, http: 5min */
     idleTimeoutMs?: number;

package/dist/{runtime → scope/plugins/mcp}/McpConnectionManager.js

@@ -2,7 +2,7 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { getLogger } from "../shared/logger.js";
+import { getLogger } from "../../../shared/logger.js";
 const DEFAULT_IDLE_TIMEOUT = {
     stdio: 30 * 60 * 1000,
     http: 5 * 60 * 1000,

package/dist/scope/plugins/mcp/McpScopePlugin.d.ts

@@ -0,0 +1,29 @@
+import type { Tool } from "@ai-zen/agents-core";
+import type { Scope, FilterOutput } from "../../Scope.js";
+import type { ScopeCandidates, ScopePlugin } from "../../ScopePlugin.js";
+/**
+ * MCP 插件 —— 发现 mcp.json + 自持连接管理器 + 装配渐进式披露元工具。
+ *
+ * 渐进式披露设计原样保留：
+ *   - `load_mcp`            枚举所有允许的 server（含 include_manifest 开关）
+ *   - `call_mcp_tool`       调用已连接 server 的工具
+ *   - `read_mcp_resource`   读取已连接 server 的资源
+ * 三个元工具名恒上报 `tools` 维度；`mcpManager` 由本插件私有持有，
+ * 有配置路径时在构造时创建，`dispose()` 时统一断开。
+ */
+export declare class McpScopePlugin implements ScopePlugin {
+    static readonly ID = "mcp";
+    readonly id = "mcp";
+    private readonly paths;
+    private readonly mcpManager;
+    private servers;
+    constructor(options?: {
+        paths?: string[];
+    });
+    discover(scope: Scope): Promise<void>;
+    /** 是否配置了 MCP（供外部代码判定，如 UnknownToolHintPlugin） */
+    hasConfig(): boolean;
+    candidates(): ScopeCandidates;
+    instantiate(_scope: Scope, filtered: FilterOutput): Tool[];
+    dispose(): Promise<void>;
+}

package/dist/scope/plugins/mcp/McpScopePlugin.js

@@ -0,0 +1,60 @@
+import { isAbsolute, join } from "node:path";
+import { discoverMcpServers } from "./discover.js";
+import { createCallMcpTool, createLoadMcpTool, createReadMcpResourceTool, } from "./mcpTools.js";
+import { McpConnectionManager } from "./McpConnectionManager.js";
+/**
+ * MCP 插件 —— 发现 mcp.json + 自持连接管理器 + 装配渐进式披露元工具。
+ *
+ * 渐进式披露设计原样保留：
+ *   - `load_mcp`            枚举所有允许的 server（含 include_manifest 开关）
+ *   - `call_mcp_tool`       调用已连接 server 的工具
+ *   - `read_mcp_resource`   读取已连接 server 的资源
+ * 三个元工具名恒上报 `tools` 维度；`mcpManager` 由本插件私有持有，
+ * 有配置路径时在构造时创建，`dispose()` 时统一断开。
+ */
+export class McpScopePlugin {
+    static ID = "mcp";
+    id = McpScopePlugin.ID;
+    paths;
+    mcpManager;
+    servers = [];
+    constructor(options) {
+        this.paths = options?.paths ?? [];
+        this.mcpManager =
+            this.paths.length > 0 ? new McpConnectionManager() : undefined;
+    }
+    async discover(scope) {
+        const files = this.paths.map((p) => (isAbsolute(p) ? p : join(scope.cwd, p)));
+        this.servers = await discoverMcpServers(files);
+    }
+    /** 是否配置了 MCP（供外部代码判定，如 UnknownToolHintPlugin） */
+    hasConfig() {
+        return this.paths.length > 0;
+    }
+    candidates() {
+        return {
+            mcps: this.servers.map((s) => s.id),
+            tools: ["load_mcp", "call_mcp_tool", "read_mcp_resource"],
+        };
+    }
+    instantiate(_scope, filtered) {
+        const allow = new Set(filtered.tools);
+        const allowedMcps = new Set(filtered.mcps);
+        const filteredMcps = this.servers.filter((s) => allowedMcps.has(s.id));
+        const m = this.mcpManager;
+        const result = [];
+        if (allow.has("load_mcp") && m && filteredMcps.length > 0) {
+            result.push(createLoadMcpTool(m, filteredMcps));
+        }
+        if (allow.has("call_mcp_tool") && m) {
+            result.push(createCallMcpTool(m));
+        }
+        if (allow.has("read_mcp_resource") && m) {
+            result.push(createReadMcpResourceTool(m));
+        }
+        return result;
+    }
+    async dispose() {
+        await this.mcpManager?.disconnectAll();
+    }
+}

package/dist/{capabilities/discovery/mcp.d.ts → scope/plugins/mcp/discover.d.ts}

@@ -1,4 +1,4 @@
-import type { McpServerConfig } from "../../types/index.js";
+import type { McpServerConfig } from "../../../types/index.js";
 /**
  * 从 mcp.json 文件列表中发现所有 MCP server 配置。
  *

package/dist/{capabilities/discovery/mcp.js → scope/plugins/mcp/discover.js}

@@ -1,5 +1,5 @@
 import { promises as fs } from "node:fs";
-import { getLogger } from "../../shared/logger.js";
+import { getLogger } from "../../../shared/logger.js";
 /**
  * 归一化原始 MCP server 配置为内部 McpServerConfig。
  * 处理业界标准中的字段别名差异。

package/dist/{capabilities/implements → scope/plugins/mcp}/mcpTools.d.ts

@@ -1,6 +1,6 @@
 import { CallbackTool } from "@ai-zen/agents-core";
-import type { McpConnectionManager } from "../../runtime/McpConnectionManager.js";
-import type { McpServerConfig } from "../../types/index.js";
+import type { McpConnectionManager } from "./McpConnectionManager.js";
+import type { McpServerConfig } from "../../../types/index.js";
 /**
  * 创建 load_mcp 工具。
  * server 枚举由 filteredMcps （完整 McpServerConfig[]）自动推导，

package/dist/{capabilities/implements → scope/plugins/mcp}/mcpTools.js

@@ -1,6 +1,6 @@
 import { CallbackTool } from "@ai-zen/agents-core";
-import { createDisclosureParam } from "../disclosure.js";
-import { getLogger } from "../../shared/logger.js";
+import { createDisclosureParam } from "../../disclosure.js";
+import { getLogger } from "../../../shared/logger.js";
 const EMPTY_HINT = "（当前没有可用的 MCP 服务器，请联系用户添加）";
 const log = getLogger();
 /**

package/dist/scope/plugins/skills/SkillsScopePlugin.d.ts

@@ -0,0 +1,28 @@
+import type { Tool } from "@ai-zen/agents-core";
+import type { Scope, FilterOutput } from "../../Scope.js";
+import type { ScopeCandidates, ScopePlugin } from "../../ScopePlugin.js";
+/**
+ * Skill 插件 —— 发现 SKILL.md + 装配渐进式披露元工具。
+ *
+ * 渐进式披露设计原样保留：
+ *   - `load_skill`            枚举所有允许的 skill
+ *   - `call_skill_sub_agent`  枚举 subAgent: true 的 skill（AgentToolLazy）
+ * 两个元工具名恒上报 `tools` 维度（供权限允许/拒绝 → 拒绝即切断披露通道）；
+ * 是否真正注册由 `instantiate()` 按允许名 + 候选条件决定。
+ */
+export declare class SkillsScopePlugin implements ScopePlugin {
+    static readonly ID = "skills";
+    readonly id = "skills";
+    private readonly paths;
+    private skills;
+    /** 解析后的 skill 目录（供 instantiate 时传给工具读取正文） */
+    private dirs;
+    constructor(options?: {
+        paths?: string[];
+    });
+    discover(scope: Scope, options?: {
+        silent?: boolean;
+    }): Promise<void>;
+    candidates(): ScopeCandidates;
+    instantiate(_scope: Scope, filtered: FilterOutput): Tool[];
+}