@zhin.js/agent 0.0.17 → 0.0.18

package/lib/builtin-tools.js

@@ -1,117 +1,26 @@
 /**
  * AI 内置系统工具
  *
- * 借鉴 OpenClaw/MicroClaw 的实用工具设计，为 ZhinAgent 提供：
- *
  * 文件工具:  read_file, write_file, edit_file, list_dir, glob, grep
  * Shell:     bash
  * 网络:      web_search, web_fetch
  * 计划:      todo_read, todo_write
  * 记忆:      read_memory, write_memory (AGENTS.md)
  * 技能:      activate_skill, install_skill
- * 会话:      session_status, compact_session
- * 技能发现:  工作区 skills/ 目录自动扫描
- * 引导文件:  SOUL.md, TOOLS.md, AGENTS.md 自动加载
+ *
+ * 发现逻辑已拆分到 discover-skills.ts / discover-agents.ts / discover-tools.ts
  */
 import * as fs from 'fs';
-import * as os from 'os';
 import * as path from 'path';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 import { Logger } from '@zhin.js/core';
 import { ZhinTool } from '@zhin.js/core';
 import { assertFileAccess, checkBashCommandSafety, shellEscape } from './file-policy.js';
-// 从新模块中 re-export 向后兼容的函数
-export { loadSoulPersona, loadToolsGuide, loadAgentsMemory } from './bootstrap.js';
+import { errMsg, expandHome, getDataDir, mergeSkillDirsWithResolver, nodeErrToFileMessage, } from './discovery-utils.js';
+import { checkSkillDeps, extractSkillInstructions } from './discover-skills.js';
 const execAsync = promisify(exec);
 const logger = new Logger(null, 'builtin-tools');
-function errMsg(e) {
-    return e instanceof Error ? e.message : String(e);
-}
-/**
- * 获取数据目录路径
- */
-function getDataDir() {
-    const dir = path.join(process.cwd(), 'data');
-    fs.mkdirSync(dir, { recursive: true });
-    return dir;
-}
-/** Workspace / ~/.zhin / data 下 skills 根目录（与 activate_skill 扫描顺序一致的前缀） */
-function buildStandardSkillDirs() {
-    return [
-        path.join(process.cwd(), 'skills'),
-        path.join(os.homedir(), '.zhin', 'skills'),
-        path.join(getDataDir(), 'skills'),
-    ];
-}
-/**
- * 从根插件树收集：根插件与**直接子插件**包目录下的 `skills/`（其下为 `<name>/SKILL.md`）
- */
-export function collectPluginSkillSearchRoots(root) {
-    if (!root)
-        return [];
-    const dirs = [];
-    const push = (d) => {
-        if (d && !dirs.includes(d))
-            dirs.push(d);
-    };
-    const fromPlugin = (p) => {
-        if (!p?.filePath)
-            return;
-        const dir = path.dirname(p.filePath);
-        push(path.join(dir, 'skills'));
-        // Also check package root when filePath is under src/ or lib/
-        const dirName = path.basename(dir);
-        if (dirName === 'src' || dirName === 'lib') {
-            push(path.join(path.dirname(dir), 'skills'));
-        }
-    };
-    fromPlugin(root);
-    for (const child of root.children || []) {
-        fromPlugin(child);
-    }
-    return dirs;
-}
-/**
- * 技能发现与 activate_skill 查找共用：标准目录 + 已加载插件包 skills/
- */
-export function getSkillSearchDirectories(root) {
-    const list = [...buildStandardSkillDirs()];
-    for (const d of collectPluginSkillSearchRoots(root ?? undefined)) {
-        if (!list.includes(d))
-            list.push(d);
-    }
-    return list;
-}
-function mergeSkillDirsWithResolver(resolver) {
-    const list = [...buildStandardSkillDirs()];
-    for (const d of resolver?.() ?? []) {
-        if (d && !list.includes(d))
-            list.push(d);
-    }
-    return list;
-}
-/** 展开路径中的 ~ 为实际 home 目录 */
-function expandHome(p) {
-    if (p === '~')
-        return os.homedir();
-    if (p.startsWith('~/') || p.startsWith('~\\'))
-        return path.join(os.homedir(), p.slice(2));
-    return p;
-}
-/** 将 Node 文件错误转为 miniclawd 风格的结构化短句，便于模型区分并重试 */
-function nodeErrToFileMessage(err, filePath, kind) {
-    const e = err;
-    if (e?.code === 'ENOENT') {
-        if (kind === 'list')
-            return `Error: Directory not found: ${filePath}`;
-        return `Error: File not found: ${filePath}`;
-    }
-    if (e?.code === 'EACCES')
-        return `Error: Permission denied: ${filePath}`;
-    const action = kind === 'read' ? 'reading file' : kind === 'write' ? 'writing file' : kind === 'edit' ? 'editing file' : 'listing directory';
-    return `Error ${action}: ${e?.message ?? String(err)}`;
-}
 /**
  * 创建所有内置系统工具
  */
@@ -502,7 +411,6 @@ export function createBuiltinTools(options) {
                 const instructions = extractSkillInstructions(args.name, fullContent, skillMaxChars);
                 return depWarning ? `${depWarning}\n\n${instructions}` : instructions;
             }
-            // 回退到目录扫描（与 discoverWorkspaceSkills 顺序一致）
             for (const dir of skillDirList()) {
                 const skillPath = path.join(dir, args.name, 'SKILL.md');
                 if (fs.existsSync(skillPath)) {
@@ -563,631 +471,4 @@ export function createBuiltinTools(options) {
     }));
     return tools;
 }
-/**
- * 检查技能声明的依赖是否在环境中可用；若有缺失返回提示文案，否则返回空字符串
- */
-async function checkSkillDeps(content) {
-    const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
-    if (!fmMatch)
-        return '';
-    let jsYaml;
-    try {
-        jsYaml = await import('js-yaml');
-        if (jsYaml.default)
-            jsYaml = jsYaml.default;
-    }
-    catch {
-        return '';
-    }
-    const metadata = jsYaml.load(fmMatch[1]);
-    if (!metadata)
-        return '';
-    const compat = metadata.compatibility || {};
-    const deps = compat.deps || metadata.deps;
-    if (!deps || !Array.isArray(deps))
-        return '';
-    const missing = [];
-    for (const dep of deps) {
-        try {
-            await execAsync(`which ${dep} 2>/dev/null`);
-        }
-        catch {
-            missing.push(dep);
-        }
-    }
-    if (missing.length === 0)
-        return '';
-    return `⚠️ 当前环境缺少以下依赖，请先安装后再使用本技能：${missing.join(', ')}`;
-}
-/**
- * 从 SKILL.md 全文中提取精简的执行指令
- * 只保留 frontmatter（工具列表）和执行规则，去掉示例、测试场景等冗余内容
- * 这样可以大幅减少 token 占用，让小模型能有足够空间继续调用工具
- */
-function extractSkillInstructions(name, content, maxBodyLen = 4000) {
-    const lines = [];
-    lines.push(`Skill '${name}' activated. 请立即根据以下指导执行工具调用：`);
-    lines.push('');
-    const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
-    if (fmMatch) {
-        const fmContent = fmMatch[1];
-        const toolsMatch = fmContent.match(/tools:\s*\n((?:\s+-\s+.+\n?)+)/);
-        if (toolsMatch) {
-            lines.push('## 可用工具');
-            lines.push(toolsMatch[0].trim());
-            lines.push('');
-        }
-    }
-    const bodyAfterFm = fmMatch && fmMatch.index !== undefined
-        ? content.slice(fmMatch.index + fmMatch[0].length).replace(/^\s+/, '')
-        : content;
-    // Priority: "## 快速操作" / "## Quick Actions" summary for small models
-    const quickActionsMatch = bodyAfterFm.match(/## (?:快速操作|Quick\s*Actions)[\s\S]*?(?=\n## [^\s]|$)/i);
-    if (quickActionsMatch && maxBodyLen <= 2000) {
-        lines.push(quickActionsMatch[0].trim());
-        lines.push('');
-        lines.push('## 立即行动');
-        lines.push('根据上面的指导，立即调用工具完成用户请求。禁止重复调用 activate_skill，禁止用文本描述代替实际工具调用。');
-        return lines.join('\n');
-    }
-    const rulesMatch = content.match(/## 执行规则[\s\S]*?(?=\n## [^\s]|$)/);
-    const workflowMatch = content.match(/## (?:Workflow|Instructions|使用说明)[\s\S]*?(?=\n## [^\s]|$)/);
-    if (rulesMatch) {
-        lines.push(rulesMatch[0].trim());
-        lines.push('');
-    }
-    else if (workflowMatch) {
-        lines.push(workflowMatch[0].trim());
-        lines.push('');
-    }
-    else if (bodyAfterFm.trim()) {
-        const firstH2 = bodyAfterFm.match(/\n## [^\s]/);
-        const intro = firstH2 ? bodyAfterFm.slice(0, firstH2.index).trim() : bodyAfterFm.trim();
-        const quickStartMatch = bodyAfterFm.match(/## (?:快速开始|Quick\s*Start|Getting\s*Started)[\s\S]*?(?=\n## [^\s]|$)/i);
-        const authMatch = bodyAfterFm.match(/## (?:认证|Authentication|Auth)[\s\S]*?(?=\n## [^\s]|$)/i);
-        if (quickStartMatch || (intro.length < 200 && bodyAfterFm.length > intro.length)) {
-            lines.push('## 指导');
-            lines.push(intro);
-            lines.push('');
-            const extra = [];
-            if (quickStartMatch)
-                extra.push(quickStartMatch[0].trim());
-            if (authMatch)
-                extra.push(authMatch[0].trim());
-            if (extra.length > 0) {
-                const joined = extra.join('\n\n');
-                lines.push(joined.length > maxBodyLen ? joined.slice(0, maxBodyLen) + '\n...(truncated)' : joined);
-            }
-            else {
-                const rest = bodyAfterFm.slice(intro.length).trim();
-                lines.push(rest.length > maxBodyLen ? rest.slice(0, maxBodyLen) + '\n...(truncated)' : rest);
-            }
-            lines.push('');
-        }
-        else if (intro) {
-            lines.push('## 指导');
-            lines.push(intro);
-            lines.push('');
-        }
-    }
-    lines.push('## 立即行动');
-    lines.push('根据上面的指导，立即调用工具完成用户请求。禁止重复调用 activate_skill，禁止用文本描述代替实际工具调用。');
-    return lines.join('\n');
-}
-/**
- * 扫描技能目录，发现 SKILL.md 技能文件
- * 加载顺序：Workspace（cwd/skills）> Local（~/.zhin/skills）> data/skills > 已加载插件包 skills/，同名先发现者优先
- * 支持平台/依赖兼容性过滤。内置技能由 create-zhin 在创建项目时写入 skills/summarize 等。
- *
- * @param root 根插件（可选）：用于追加插件包内 `skills/` 扫描，与 `activate_skill` 查找路径一致
- */
-export async function discoverWorkspaceSkills(root) {
-    const skills = [];
-    const seenNames = new Set();
-    const dataDir = getDataDir();
-    const skillDirs = getSkillSearchDirectories(root ?? undefined);
-    // 确保 data/skills 目录存在
-    const defaultSkillDir = path.join(dataDir, 'skills');
-    if (!fs.existsSync(defaultSkillDir)) {
-        fs.mkdirSync(defaultSkillDir, { recursive: true });
-        logger.debug(`Created skill directory: ${defaultSkillDir}`);
-    }
-    for (const skillsDir of skillDirs) {
-        if (!fs.existsSync(skillsDir))
-            continue;
-        let entries;
-        try {
-            entries = await fs.promises.readdir(skillsDir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            const skillMdPath = path.join(skillsDir, entry.name, 'SKILL.md');
-            if (!fs.existsSync(skillMdPath))
-                continue;
-            try {
-                const content = await fs.promises.readFile(skillMdPath, 'utf-8');
-                // 改进的 frontmatter 正则：支持多种换行符、可选的尾部空白
-                const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/);
-                if (!match) {
-                    logger.debug(`Skill文件 ${skillMdPath} 没有有效的frontmatter格式`);
-                    continue;
-                }
-                let jsYaml;
-                try {
-                    jsYaml = await import('js-yaml');
-                    if (jsYaml.default)
-                        jsYaml = jsYaml.default;
-                }
-                catch (e) {
-                    logger.warn(`Unable to import js-yaml module: ${e}`);
-                    continue;
-                }
-                const metadata = jsYaml.load(match[1]);
-                if (!metadata || !metadata.name || !metadata.description) {
-                    logger.debug(`Skill文件 ${skillMdPath} 缺少必需的 name/description 字段`);
-                    continue;
-                }
-                // 平台兼容检查
-                const compat = metadata.compatibility || {};
-                if (compat.os && Array.isArray(compat.os)) {
-                    const currentOs = process.platform === 'darwin' ? 'darwin' : process.platform === 'win32' ? 'windows' : 'linux';
-                    if (!compat.os.includes(currentOs)) {
-                        logger.debug(`Skipping skill '${metadata.name}' (unsupported OS)`);
-                        continue;
-                    }
-                }
-                // 依赖检查：支持 metadata.requires.bins / requires.env 或 compat.deps / metadata.deps
-                const requiresBins = metadata.requires?.bins || compat.deps || metadata.deps || [];
-                const requiresEnv = metadata.requires?.env || [];
-                const binsToCheck = Array.isArray(requiresBins) ? requiresBins : [];
-                const envToCheck = Array.isArray(requiresEnv) ? requiresEnv : [];
-                const requiresMissing = [];
-                for (const bin of binsToCheck) {
-                    try {
-                        await execAsync(`which ${bin} 2>/dev/null`);
-                    }
-                    catch {
-                        requiresMissing.push(`CLI: ${bin}`);
-                    }
-                }
-                for (const envKey of envToCheck) {
-                    if (!process.env[envKey]) {
-                        requiresMissing.push(`ENV: ${envKey}`);
-                    }
-                }
-                const available = requiresMissing.length === 0;
-                if (seenNames.has(metadata.name)) {
-                    logger.debug(`Skill '${metadata.name}' 已由先序目录加载，跳过: ${skillMdPath}`);
-                    continue;
-                }
-                seenNames.add(metadata.name);
-                skills.push({
-                    name: metadata.name,
-                    description: metadata.description,
-                    keywords: metadata.keywords || [],
-                    tags: [...(metadata.tags || []), 'workspace-skill'],
-                    toolNames: Array.isArray(metadata.tools) ? metadata.tools : [],
-                    filePath: skillMdPath,
-                    always: Boolean(metadata.always),
-                    available,
-                    requiresMissing: requiresMissing.length > 0 ? requiresMissing : undefined,
-                });
-                logger.debug(`Skill发现成功: ${metadata.name}, tools: ${JSON.stringify(metadata.tools || [])}`);
-            }
-            catch (e) {
-                logger.warn(`Failed to parse SKILL.md in ${skillMdPath}:`, e);
-            }
-        }
-    }
-    if (skills.length > 0) {
-        logger.info(`发现 ${skills.length} 个工作区技能: ${skills.map(s => `${s.name}(tools:${(s.toolNames || []).join(',')})`).join(', ')}`);
-    }
-    return skills;
-}
-/**
- * 获取 frontmatter 中 always: true 的技能名列表（用于常驻注入 system prompt）
- */
-export function getAlwaysSkillNames(skills) {
-    return skills.filter(s => s.always && s.available).map(s => s.name);
-}
-/**
- * 去除 frontmatter，返回正文
- */
-function stripFrontmatter(content) {
-    const match = content.match(/^---\s*\n[\s\S]*?\n---\s*(?:\n|$)/);
-    if (match) {
-        return content.slice(match[0].length).trim();
-    }
-    return content.trim();
-}
-/**
- * 加载 always 技能的正文内容并拼接为「Active Skills」段
- */
-export async function loadAlwaysSkillsContent(skills) {
-    const always = skills.filter(s => s.always && s.available);
-    if (always.length === 0)
-        return '';
-    const parts = [];
-    for (const s of always) {
-        try {
-            const content = await fs.promises.readFile(s.filePath, 'utf-8');
-            const body = stripFrontmatter(content);
-            parts.push(`### Skill: ${s.name}\n\n${body}`);
-        }
-        catch (e) {
-            logger.warn(`Failed to load always skill ${s.name}: ${e.message}`);
-        }
-    }
-    return parts.join('\n\n---\n\n');
-}
-/** 转义 XML 特殊字符 */
-function escapeXml(s) {
-    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
-}
-/**
- * 构建技能列表的 XML 摘要，供 model 区分可用/不可用及缺失依赖
- */
-export function buildSkillsSummaryXML(skills) {
-    if (skills.length === 0)
-        return '';
-    const lines = ['<skills>'];
-    for (const s of skills) {
-        const available = s.available !== false;
-        lines.push(`  <skill available="${available}">`);
-        lines.push(`    <name>${escapeXml(s.name)}</name>`);
-        lines.push(`    <description>${escapeXml(s.description)}</description>`);
-        lines.push(`    <location>${escapeXml(s.filePath)}</location>`);
-        if (!available && s.requiresMissing && s.requiresMissing.length > 0) {
-            lines.push(`    <requires>${escapeXml(s.requiresMissing.join(', '))}</requires>`);
-        }
-        lines.push('  </skill>');
-    }
-    lines.push('</skills>');
-    return lines.join('\n');
-}
-/**
- * 扫描 agents/ 目录，发现 *.agent.md 文件
- * 加载顺序与 skills 一致：Workspace > ~/.zhin > data > 插件包
- * 同名先发现者优先
- */
-export async function discoverWorkspaceAgents(root) {
-    const agents = [];
-    const seenNames = new Set();
-    // 构建扫描目录：标准目录的 agents/ + 插件包的 agents/
-    const agentDirs = [
-        path.join(process.cwd(), 'agents'),
-        path.join(os.homedir(), '.zhin', 'agents'),
-        path.join(getDataDir(), 'agents'),
-    ];
-    if (root) {
-        const addPluginDir = (p) => {
-            if (!p?.filePath)
-                return;
-            const dir = path.dirname(p.filePath);
-            const d = path.join(dir, 'agents');
-            if (!agentDirs.includes(d))
-                agentDirs.push(d);
-            // Also check package root when filePath is under src/ or lib/
-            const dirName = path.basename(dir);
-            if (dirName === 'src' || dirName === 'lib') {
-                const d2 = path.join(path.dirname(dir), 'agents');
-                if (!agentDirs.includes(d2))
-                    agentDirs.push(d2);
-            }
-        };
-        addPluginDir(root);
-        for (const child of root.children || []) {
-            addPluginDir(child);
-        }
-    }
-    for (const agentsDir of agentDirs) {
-        if (!fs.existsSync(agentsDir))
-            continue;
-        let entries;
-        try {
-            entries = await fs.promises.readdir(agentsDir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            // 支持两种结构：
-            // 1. agents/<name>.agent.md（扁平文件）
-            // 2. agents/<name>/<name>.agent.md（目录结构）
-            let agentMdPath;
-            if (entry.isFile() && entry.name.endsWith('.agent.md')) {
-                agentMdPath = path.join(agentsDir, entry.name);
-            }
-            else if (entry.isDirectory()) {
-                const nested = path.join(agentsDir, entry.name, `${entry.name}.agent.md`);
-                if (fs.existsSync(nested)) {
-                    agentMdPath = nested;
-                }
-            }
-            if (!agentMdPath)
-                continue;
-            try {
-                const content = await fs.promises.readFile(agentMdPath, 'utf-8');
-                const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/);
-                if (!match) {
-                    logger.debug(`Agent文件 ${agentMdPath} 没有有效的frontmatter格式`);
-                    continue;
-                }
-                let jsYaml;
-                try {
-                    jsYaml = await import('js-yaml');
-                    if (jsYaml.default)
-                        jsYaml = jsYaml.default;
-                }
-                catch (e) {
-                    logger.warn(`Unable to import js-yaml module: ${e}`);
-                    continue;
-                }
-                const metadata = jsYaml.load(match[1]);
-                if (!metadata || !metadata.name || !metadata.description) {
-                    logger.debug(`Agent文件 ${agentMdPath} 缺少必需的 name/description 字段`);
-                    continue;
-                }
-                if (seenNames.has(metadata.name)) {
-                    logger.debug(`Agent '${metadata.name}' 已由先序目录加载，跳过: ${agentMdPath}`);
-                    continue;
-                }
-                seenNames.add(metadata.name);
-                agents.push({
-                    name: metadata.name,
-                    description: metadata.description,
-                    keywords: metadata.keywords || [],
-                    tags: metadata.tags || [],
-                    toolNames: Array.isArray(metadata.tools) ? metadata.tools : [],
-                    filePath: agentMdPath,
-                    model: metadata.model,
-                    provider: metadata.provider,
-                    maxIterations: typeof metadata.maxIterations === 'number' ? metadata.maxIterations : undefined,
-                });
-                logger.debug(`Agent发现成功: ${metadata.name}`);
-            }
-            catch (e) {
-                logger.warn(`Failed to parse agent.md in ${agentMdPath}:`, e);
-            }
-        }
-    }
-    if (agents.length > 0) {
-        logger.info(`发现 ${agents.length} 个工作区 Agent 预设: ${agents.map(a => a.name).join(', ')}`);
-    }
-    return agents;
-}
-/**
- * 从根插件树收集：根插件与直接子插件包目录下的 `tools/`
- */
-export function collectPluginToolSearchRoots(root) {
-    if (!root)
-        return [];
-    const dirs = [];
-    const push = (d) => {
-        if (d && !dirs.includes(d))
-            dirs.push(d);
-    };
-    const fromPlugin = (p) => {
-        if (!p?.filePath)
-            return;
-        const dir = path.dirname(p.filePath);
-        push(path.join(dir, 'tools'));
-        // Also check package root when filePath is under src/ or lib/
-        const dirName = path.basename(dir);
-        if (dirName === 'src' || dirName === 'lib') {
-            push(path.join(path.dirname(dir), 'tools'));
-        }
-    };
-    fromPlugin(root);
-    for (const child of root.children || []) {
-        fromPlugin(child);
-    }
-    return dirs;
-}
-/**
- * 获取所有 tool 搜索目录（标准目录 + 插件包 tools/）
- */
-export function getToolSearchDirectories(root) {
-    const list = [
-        path.join(process.cwd(), 'tools'),
-        path.join(os.homedir(), '.zhin', 'tools'),
-        path.join(getDataDir(), 'tools'),
-    ];
-    for (const d of collectPluginToolSearchRoots(root ?? undefined)) {
-        if (!list.includes(d))
-            list.push(d);
-    }
-    return list;
-}
-/**
- * 将简写参数定义转换为 ToolParametersSchema
- */
-function shorthandToSchema(params) {
-    const properties = {};
-    const required = [];
-    for (const [key, param] of Object.entries(params)) {
-        properties[key] = {
-            type: param.type || 'string',
-            description: param.description || key,
-        };
-        if (param.enum)
-            properties[key].enum = param.enum;
-        if (param.default !== undefined)
-            properties[key].default = param.default;
-        if (param.required)
-            required.push(key);
-    }
-    return { type: 'object', properties, required: required.length > 0 ? required : undefined };
-}
-/**
- * 加载 handler 文件（动态 import）
- * @returns execute 函数, 或 undefined（加载失败）
- */
-async function loadToolHandler(handlerPath, toolMdPath) {
-    const resolved = path.resolve(path.dirname(toolMdPath), handlerPath);
-    if (!fs.existsSync(resolved)) {
-        logger.warn(`Tool handler 文件不存在: ${resolved}`);
-        return undefined;
-    }
-    try {
-        const fileUrl = `file://${resolved}?t=${Date.now()}`;
-        const mod = await import(fileUrl);
-        const fn = mod.default || mod;
-        if (typeof fn !== 'function') {
-            logger.warn(`Tool handler 未导出函数: ${resolved}`);
-            return undefined;
-        }
-        return fn;
-    }
-    catch (e) {
-        logger.warn(`Tool handler 加载失败 (${resolved}): ${errMsg(e)}`);
-        return undefined;
-    }
-}
-/**
- * 从 body 构建 prompt 模板执行函数
- */
-function buildTemplateExecute(body) {
-    return (args) => body.replace(/\{\{(\w+)\}\}/g, (_, k) => {
-        const val = args[k];
-        return val !== undefined && val !== null ? String(val) : '';
-    });
-}
-/**
- * 扫描 tools/ 目录，发现 *.tool.md 文件
- * 加载顺序与 skills/agents 一致：Workspace > ~/.zhin > data > 插件包
- * 同名先发现者优先
- */
-export async function discoverWorkspaceTools(root) {
-    const tools = [];
-    const seenNames = new Set();
-    const toolDirs = getToolSearchDirectories(root);
-    for (const toolsDir of toolDirs) {
-        if (!fs.existsSync(toolsDir))
-            continue;
-        let entries;
-        try {
-            entries = await fs.promises.readdir(toolsDir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            // 支持两种结构：
-            // 1. tools/<name>.tool.md（扁平文件）
-            // 2. tools/<name>/<name>.tool.md（目录结构，允许放 handler.ts）
-            let toolMdPath;
-            if (entry.isFile() && entry.name.endsWith('.tool.md')) {
-                toolMdPath = path.join(toolsDir, entry.name);
-            }
-            else if (entry.isDirectory()) {
-                const nested = path.join(toolsDir, entry.name, `${entry.name}.tool.md`);
-                if (fs.existsSync(nested)) {
-                    toolMdPath = nested;
-                }
-            }
-            if (!toolMdPath)
-                continue;
-            try {
-                const content = await fs.promises.readFile(toolMdPath, 'utf-8');
-                const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/);
-                if (!match) {
-                    logger.debug(`Tool文件 ${toolMdPath} 没有有效的frontmatter格式`);
-                    continue;
-                }
-                let jsYaml;
-                try {
-                    jsYaml = await import('js-yaml');
-                    if (jsYaml.default)
-                        jsYaml = jsYaml.default;
-                }
-                catch (e) {
-                    logger.warn(`Unable to import js-yaml module: ${e}`);
-                    continue;
-                }
-                const metadata = jsYaml.load(match[1]);
-                if (!metadata || !metadata.name || !metadata.description) {
-                    logger.debug(`Tool文件 ${toolMdPath} 缺少必需的 name/description 字段`);
-                    continue;
-                }
-                if (seenNames.has(metadata.name)) {
-                    logger.debug(`Tool '${metadata.name}' 已由先序目录加载，跳过: ${toolMdPath}`);
-                    continue;
-                }
-                seenNames.add(metadata.name);
-                // 提取 body（frontmatter 之后的内容）
-                const body = content.replace(/^---\s*\n[\s\S]*?\n---\s*(?:\n|$)/, '').trim();
-                tools.push({
-                    name: metadata.name,
-                    description: metadata.description,
-                    parameters: metadata.parameters || undefined,
-                    command: metadata.command || undefined,
-                    platforms: metadata.platforms,
-                    scopes: metadata.scopes,
-                    permissionLevel: metadata.permissionLevel,
-                    tags: metadata.tags || [],
-                    keywords: metadata.keywords || [],
-                    kind: metadata.kind,
-                    hidden: metadata.hidden,
-                    handler: metadata.handler,
-                    filePath: toolMdPath,
-                    templateBody: !metadata.handler && body ? body : undefined,
-                });
-                logger.debug(`Tool发现成功: ${metadata.name}`);
-            }
-            catch (e) {
-                logger.warn(`Failed to parse tool.md in ${toolMdPath}:`, e);
-            }
-        }
-    }
-    if (tools.length > 0) {
-        logger.info(`发现 ${tools.length} 个工作区 Tool: ${tools.map(t => t.name).join(', ')}`);
-    }
-    return tools;
-}
-/**
- * 将 ToolMeta 转换为 Tool 对象（包含 execute 函数）
- */
-export async function buildToolFromMeta(meta) {
-    // 构建 execute 函数
-    let execute;
-    if (meta.handler) {
-        execute = await loadToolHandler(meta.handler, meta.filePath);
-        if (!execute)
-            return null;
-    }
-    else if (meta.templateBody) {
-        execute = buildTemplateExecute(meta.templateBody);
-    }
-    else {
-        logger.warn(`Tool '${meta.name}' 既没有 handler 也没有模板 body，跳过`);
-        return null;
-    }
-    // 构建参数 schema
-    const parameters = meta.parameters
-        ? shorthandToSchema(meta.parameters)
-        : { type: 'object', properties: {} };
-    return {
-        name: meta.name,
-        description: meta.description,
-        parameters,
-        execute,
-        tags: meta.tags,
-        keywords: meta.keywords,
-        platforms: meta.platforms,
-        scopes: meta.scopes,
-        permissionLevel: meta.permissionLevel,
-        hidden: meta.hidden,
-        kind: meta.kind,
-        command: meta.command ? {
-            pattern: meta.command.pattern,
-            alias: meta.command.alias,
-            examples: meta.command.examples,
-        } : undefined,
-    };
-}
 //# sourceMappingURL=builtin-tools.js.map