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

package/dist/scope/Scope.d.ts

@@ -0,0 +1,111 @@
+import type { Tool } from "@ai-zen/agents-core";
+import type { AppConfig, AgentDefinition, ToolEnv } from "../types/index.js";
+import type { ScopePlugin } from "./ScopePlugin.js";
+/**
+ * 能力过滤系统的公共类型。
+ * FilterOutput 由 filter() 产出，由 instantiate() 消费。
+ */
+export interface FilterOutput {
+    tools: string[];
+    subagents: string[];
+    skills: string[];
+    mcps: string[];
+}
+/**
+ * 排除项黑名单（优先级高于 permissions）。
+ * 与 permissions 四维对称，用于安全预过滤。
+ */
+export interface ExcludeOptions {
+    tools?: string[];
+    skills?: string[];
+    mcps?: string[];
+    subagents?: string[];
+}
+/** filter / buildTools 的过滤选项 */
+export interface FilterOptions {
+    /** 排除项黑名单（优先级高于 permissions） */
+    exclude?: ExcludeOptions;
+}
+/**
+ * Scope — 全局上下文 + 能力装配编排容器（v1）。
+ *
+ * Scope 是 SDK 的唯一入口对象，持有：
+ *   - 应用配置（端点、模型等）
+ *   - 当前工作目录 cwd（相对路径解析基准，ToolEnv.cwd 的来源）
+ *   - Agent 定义目录 agentsDir（createAgent 用）
+ *   - 一组 ScopePlugin（能力插件）
+ *
+ * 装配方式（插件必须显式注入，Scope 不装任何默认插件）：
+ * ```ts
+ * const scope = new Scope({ config, cwd, agentsDir })
+ *   .use(...allInOne({ skillsPaths, toolsPaths, subAgentsPaths, mcpPaths }));
+ * await scope.init();
+ * ```
+ *
+ * 设计原则：
+ *   - Scope 只做编排：三阶段管线骨架（发现 → 过滤 → 实例化）+ 生命周期
+ *   - 能力来源（内置/用户工具、Skill、MCP、SubAgent）全部疏散到 ScopePlugin，各自自持
+ *   - Scope 实例一旦创建，config/cwd/agentsDir/env 不变；refresh() 只让插件重新发现
+ */
+export declare class Scope {
+    /** 应用配置（端点、模型等） */
+    readonly config: AppConfig;
+    /** 当前工作目录 — 相对路径解析基准，也是 ToolEnv.cwd 的来源 */
+    readonly cwd: string;
+    /** 工具环境 — 插件实例化内置工具时注入 */
+    readonly env: ToolEnv;
+    /** Agent 定义目录（createAgent 用） */
+    readonly agentsDir: string;
+    /** 已注册的插件 */
+    private _plugins;
+    /** 是否已 init（init 之后禁止再 use） */
+    private _initialized;
+    constructor(options: {
+        config: AppConfig;
+        agentsDir: string;
+        cwd?: string;
+    });
+    /** 已注册插件（只读视图） */
+    get plugins(): readonly ScopePlugin[];
+    /**
+     * 注册能力插件（链式，可变参数）。
+     *
+     * 支持两种用法：
+     *   scope.use(plugin)
+     *   scope.use(...allInOne({ ... }))   // 展开批量注册
+     *
+     * 必须在 init() 之前调用；init() 之后再 use() 会抛错。
+     */
+    use(...plugins: ScopePlugin[]): this;
+    /** 按 id 查找插件（供外部代码/其它插件查询插件状态） */
+    getPluginById<T extends ScopePlugin>(id: string): T | undefined;
+    /**
+     * 初始化：执行首次全局能力发现（遍历插件 discover()），随后锁定插件注册。
+     */
+    init(): Promise<void>;
+    /**
+     * 重新执行全局发现（遍历插件 discover()）。
+     */
+    refresh(options?: {
+        silent?: boolean;
+    }): Promise<void>;
+    /**
+     * 释放：逆序调用各插件 dispose()（如 MCP 断开所有连接）。与 init() 对称。
+     */
+    dispose(): Promise<void>;
+    /**
+     * 按权限过滤候选集，返回过滤后的名称列表。
+     * 汇总各插件 candidates() → 应用 exclude 安全预过滤 → 四维权限过滤。
+     * 纯名称操作，不涉及 Tool 实例化。
+     */
+    filter(definition: AgentDefinition, options?: FilterOptions): FilterOutput;
+    /**
+     * 快捷方法：filter + instantiate 一步完成。
+     */
+    buildTools(definition: AgentDefinition, options?: FilterOptions): Tool[];
+    /**
+     * 将过滤后的名称列表实例化为 Tool 数组。
+     * 遍历各插件 instantiate()，收集后去重（后注册覆盖先注册）。
+     */
+    instantiate(filtered: FilterOutput): Tool[];
+}

package/dist/scope/Scope.js

@@ -0,0 +1,165 @@
+import { PermissionEvaluator } from "./PermissionEvaluator.js";
+/**
+ * Scope — 全局上下文 + 能力装配编排容器（v1）。
+ *
+ * Scope 是 SDK 的唯一入口对象，持有：
+ *   - 应用配置（端点、模型等）
+ *   - 当前工作目录 cwd（相对路径解析基准，ToolEnv.cwd 的来源）
+ *   - Agent 定义目录 agentsDir（createAgent 用）
+ *   - 一组 ScopePlugin（能力插件）
+ *
+ * 装配方式（插件必须显式注入，Scope 不装任何默认插件）：
+ * ```ts
+ * const scope = new Scope({ config, cwd, agentsDir })
+ *   .use(...allInOne({ skillsPaths, toolsPaths, subAgentsPaths, mcpPaths }));
+ * await scope.init();
+ * ```
+ *
+ * 设计原则：
+ *   - Scope 只做编排：三阶段管线骨架（发现 → 过滤 → 实例化）+ 生命周期
+ *   - 能力来源（内置/用户工具、Skill、MCP、SubAgent）全部疏散到 ScopePlugin，各自自持
+ *   - Scope 实例一旦创建，config/cwd/agentsDir/env 不变；refresh() 只让插件重新发现
+ */
+export class Scope {
+    /** 应用配置（端点、模型等） */
+    config;
+    /** 当前工作目录 — 相对路径解析基准，也是 ToolEnv.cwd 的来源 */
+    cwd;
+    /** 工具环境 — 插件实例化内置工具时注入 */
+    env;
+    /** Agent 定义目录（createAgent 用） */
+    agentsDir;
+    /** 已注册的插件 */
+    _plugins = [];
+    /** 是否已 init（init 之后禁止再 use） */
+    _initialized = false;
+    constructor(options) {
+        this.config = options.config;
+        this.cwd = options.cwd ?? process.cwd();
+        this.env = { cwd: this.cwd, config: this.config };
+        this.agentsDir = options.agentsDir;
+    }
+    // ==================================================================
+    // 插件注册与生命周期
+    // ==================================================================
+    /** 已注册插件（只读视图） */
+    get plugins() {
+        return this._plugins;
+    }
+    /**
+     * 注册能力插件（链式，可变参数）。
+     *
+     * 支持两种用法：
+     *   scope.use(plugin)
+     *   scope.use(...allInOne({ ... }))   // 展开批量注册
+     *
+     * 必须在 init() 之前调用；init() 之后再 use() 会抛错。
+     */
+    use(...plugins) {
+        if (this._initialized) {
+            throw new Error("Scope.use() 必须在 init() 之前调用");
+        }
+        for (const plugin of plugins) {
+            this._plugins.push(plugin);
+        }
+        return this;
+    }
+    /** 按 id 查找插件（供外部代码/其它插件查询插件状态） */
+    getPluginById(id) {
+        return this._plugins.find((p) => p.id === id);
+    }
+    /**
+     * 初始化：执行首次全局能力发现（遍历插件 discover()），随后锁定插件注册。
+     */
+    async init() {
+        await this.refresh();
+        this._initialized = true;
+    }
+    /**
+     * 重新执行全局发现（遍历插件 discover()）。
+     */
+    async refresh(options) {
+        const opts = { silent: options?.silent ?? false };
+        for (const plugin of this._plugins) {
+            await plugin.discover?.(this, opts);
+        }
+    }
+    /**
+     * 释放：逆序调用各插件 dispose()（如 MCP 断开所有连接）。与 init() 对称。
+     */
+    async dispose() {
+        for (let i = this._plugins.length - 1; i >= 0; i--) {
+            await this._plugins[i].dispose?.();
+        }
+    }
+    // ==================================================================
+    // 能力过滤与实例化
+    // ==================================================================
+    /**
+     * 按权限过滤候选集，返回过滤后的名称列表。
+     * 汇总各插件 candidates() → 应用 exclude 安全预过滤 → 四维权限过滤。
+     * 纯名称操作，不涉及 Tool 实例化。
+     */
+    filter(definition, options) {
+        const exclude = options?.exclude ?? {};
+        const excludeTools = new Set(exclude.tools ?? []);
+        const excludeSkills = new Set(exclude.skills ?? []);
+        const excludeMcps = new Set(exclude.mcps ?? []);
+        const excludeSubAgents = new Set(exclude.subagents ?? []);
+        // 1. 汇总各插件候选（插件已在 candidates 内完成自身可用性判断）
+        const tools = new Set();
+        const skills = new Set();
+        const mcps = new Set();
+        const subagents = new Set();
+        for (const plugin of this._plugins) {
+            const c = plugin.candidates(this, definition);
+            c.tools?.forEach((n) => tools.add(n));
+            c.skills?.forEach((n) => skills.add(n));
+            c.mcps?.forEach((n) => mcps.add(n));
+            c.subagents?.forEach((n) => subagents.add(n));
+        }
+        // 2 + 3. exclude 预过滤 + 四维权限过滤
+        const evaluator = new PermissionEvaluator(definition.permissions);
+        const filtered = evaluator.filter({
+            tools: [...tools].filter((n) => !excludeTools.has(n)),
+            skills: [...skills].filter((n) => !excludeSkills.has(n)),
+            mcps: [...mcps].filter((n) => !excludeMcps.has(n)),
+            subagents: [...subagents].filter((n) => !excludeSubAgents.has(n)),
+        });
+        return {
+            tools: filtered.tools,
+            subagents: filtered.subagents,
+            skills: filtered.skills,
+            mcps: filtered.mcps,
+        };
+    }
+    /**
+     * 快捷方法：filter + instantiate 一步完成。
+     */
+    buildTools(definition, options) {
+        return this.instantiate(this.filter(definition, options));
+    }
+    /**
+     * 将过滤后的名称列表实例化为 Tool 数组。
+     * 遍历各插件 instantiate()，收集后去重（后注册覆盖先注册）。
+     */
+    instantiate(filtered) {
+        const result = [];
+        for (const plugin of this._plugins) {
+            result.push(...plugin.instantiate(this, filtered));
+        }
+        return dedupTools(result);
+    }
+}
+function dedupTools(tools) {
+    const seen = new Set();
+    const result = [];
+    for (let i = tools.length - 1; i >= 0; i--) {
+        const name = tools[i].function.name;
+        if (!seen.has(name)) {
+            seen.add(name);
+            result.unshift(tools[i]);
+        }
+    }
+    return result;
+}

package/dist/scope/ScopePlugin.d.ts

@@ -0,0 +1,51 @@
+import type { Tool } from "@ai-zen/agents-core";
+import type { AgentDefinition } from "../types/index.js";
+import type { Scope, FilterOutput } from "./Scope.js";
+/**
+ * 插件向四维权限体系贡献的候选名称（任意子集）。
+ */
+export interface ScopeCandidates {
+    tools?: string[];
+    skills?: string[];
+    mcps?: string[];
+    subagents?: string[];
+}
+/**
+ * ScopePlugin — 能力插件契约（v1 核心扩展点）。
+ *
+ * 一个插件**自持一类能力**的完整生命周期：自己发现、自己持有发现结果、
+ * 自己声明候选名、自己按过滤结果实例化工具、自己负责释放。
+ * `Scope` 只做编排，不感知任何具体能力的发现状态。
+ *
+ * 与 `AgentPlugin`（core，挂在 Agent 运行时 send/loop/toolcall）不同，
+ * `ScopePlugin` 挂在**能力装配管线**（discover/filter/instantiate）。二者互不相关。
+ *
+ * 生命周期与三阶段管线的对应：
+ *   discover     —— 阶段 1 · 发现
+ *   candidates   —— 阶段 2 · 候选（供权限过滤）
+ *   instantiate  —— 阶段 3 · 实例化
+ *   dispose      —— 释放
+ */
+export interface ScopePlugin {
+    /** 唯一标识，如 "builtin" / "user-tools" / "skills" / "mcp" / "subagents" */
+    readonly id: string;
+    /**
+     * 阶段 1 · 发现：扫描来源、刷新自身状态（每次内部重新扫描，不跨 refresh 累积）。
+     * 相对路径应在此基于 `scope.cwd` 解析。
+     */
+    discover?(scope: Scope, options: {
+        silent?: boolean;
+    }): Promise<void> | void;
+    /**
+     * 阶段 2 · 候选：返回本插件向四维贡献的候选名。
+     * 可结合 `definition` 做可用性判断（如内置工具的 isAvailable）。同步返回。
+     */
+    candidates(scope: Scope, definition: AgentDefinition): ScopeCandidates;
+    /**
+     * 阶段 3 · 实例化：按过滤后的允许名产出 Tool 实例。
+     * `filtered` 为 `Scope.filter()` 的产物（四维允许名）。
+     */
+    instantiate(scope: Scope, filtered: FilterOutput): Tool[];
+    /** 可选 · 释放：逆序于注册顺序调用。如 MCP 断开所有连接。 */
+    dispose?(): Promise<void> | void;
+}

package/dist/scope/ScopePlugin.js

@@ -0,0 +1 @@
+export {};

package/dist/scope/plugins/allInOne.d.ts

@@ -0,0 +1,18 @@
+import type { ScopePlugin } from "../ScopePlugin.js";
+/** allInOne 的装配选项：各类能力来源的路径（绝对或相对 scope.cwd） */
+export interface AllInOneOptions {
+    skillsPaths?: string[];
+    toolsPaths?: string[];
+    subAgentsPaths?: string[];
+    mcpPaths?: string[];
+}
+/**
+ * 标准能力插件工厂 —— 恒返回 5 个标准插件（"全家桶"）。
+ *
+ * 顺序即优先级（去重时后注册覆盖先注册）：
+ *   builtin → user-tools → skills → mcp → subagents
+ * 因此用户工具可覆盖同名内置工具（与 v0 一致）。
+ *
+ * 想裁剪/替换某一类，改用手工逐个 `new XxxScopePlugin(...)` 后 `.use()`。
+ */
+export declare function allInOne(options?: AllInOneOptions): ScopePlugin[];

package/dist/scope/plugins/allInOne.js

@@ -0,0 +1,23 @@
+import { BuiltinToolsScopePlugin } from "./builtin/BuiltinToolsScopePlugin.js";
+import { UserToolsScopePlugin } from "./usertools/UserToolsScopePlugin.js";
+import { SkillsScopePlugin } from "./skills/SkillsScopePlugin.js";
+import { McpScopePlugin } from "./mcp/McpScopePlugin.js";
+import { SubAgentsScopePlugin } from "./subagents/SubAgentsScopePlugin.js";
+/**
+ * 标准能力插件工厂 —— 恒返回 5 个标准插件（"全家桶"）。
+ *
+ * 顺序即优先级（去重时后注册覆盖先注册）：
+ *   builtin → user-tools → skills → mcp → subagents
+ * 因此用户工具可覆盖同名内置工具（与 v0 一致）。
+ *
+ * 想裁剪/替换某一类，改用手工逐个 `new XxxScopePlugin(...)` 后 `.use()`。
+ */
+export function allInOne(options) {
+    return [
+        new BuiltinToolsScopePlugin(),
+        new UserToolsScopePlugin({ paths: options?.toolsPaths }),
+        new SkillsScopePlugin({ paths: options?.skillsPaths }),
+        new McpScopePlugin({ paths: options?.mcpPaths }),
+        new SubAgentsScopePlugin({ paths: options?.subAgentsPaths }),
+    ];
+}

package/dist/{capabilities/implements → scope/plugins}/builtin/BatchEditTool.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";
 interface Replacement {

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

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

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",