@zhin.js/agent 1.1.23 → 1.1.26

package/lib/builtin/write-file-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"write-file-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAOnC,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,4GACuF;IAC3G,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,QAAQ,CAAC,IAAI,UAAU;;IAiBjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAyBrF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/lib/builtin/write-file-tool.js

@@ -1,55 +0,0 @@
-/**
- * write_file — 内置文件写入
- */
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { expandHome, nodeErrToFileMessage } from '../discovery/utils.js';
-import { BuiltinBaseTool } from './builtin-base-tool.js';
-export const WRITE_FILE_PARAMETERS = {
-    type: 'object',
-    properties: {
-        file_path: { type: 'string', description: 'File path to write' },
-        content: { type: 'string', description: 'Full file content to write' },
-    },
-    required: ['file_path', 'content'],
-};
-export class WriteFileBuiltinTool extends BuiltinBaseTool {
-    name = 'write_file';
-    description = 'Write content to a file path, creating or overwriting the file; creates parent directories if missing.';
-    parameters = WRITE_FILE_PARAMETERS;
-    kind = 'file';
-    constructor() {
-        super();
-        this.tags.push('file', 'write');
-        this.keywords.push('写文件', '写入文件', '创建文件', '保存文件', 'write file', 'write', '保存', '创建');
-    }
-    async run(args, commMessage) {
-        const filePathArg = args.file_path;
-        const contentArg = args.content;
-        if (typeof filePathArg !== 'string' || !filePathArg.trim()) {
-            return 'Error: file_path is required';
-        }
-        if (typeof contentArg !== 'string') {
-            return 'Error: content is required';
-        }
-        let fp;
-        try {
-            fp = expandHome(filePathArg);
-        }
-        catch (e) {
-            return nodeErrToFileMessage(e, String(filePathArg), 'write');
-        }
-        try {
-            await fs.mkdir(path.dirname(fp), { recursive: true });
-            await fs.writeFile(fp, contentArg, 'utf-8');
-            return `✅ Wrote ${Buffer.byteLength(contentArg)} bytes to ${fp}`;
-        }
-        catch (e) {
-            return nodeErrToFileMessage(e, String(filePathArg), 'write');
-        }
-    }
-}
-export function createWriteFileTool() {
-    return new WriteFileBuiltinTool().toTool();
-}
-//# sourceMappingURL=write-file-tool.js.map

package/lib/builtin/write-file-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"write-file-tool.js","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACzD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QAChE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;KACvE;IACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAC9C,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAClB,wGAAwG,CAAC;IAClG,UAAU,GAAG,qBAAqB,CAAC;IACnC,IAAI,GAAG,MAAM,CAAC;IAEvB;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAqB;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3D,OAAO,8BAA8B,CAAC;QACxC,CAAC;QACD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,4BAA4B,CAAC;QACtC,CAAC;QAED,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACH,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,WAAW,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC;QACnE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,EAAE,CAAC;AAC7C,CAAC"}

package/lib/builtin-tools.d.ts

@@ -1,25 +0,0 @@
-/**
- * AI 内置系统工具
- *
- * 文件工具:  read_file / write_file / edit_file / list_dir / glob / grep（builtin/* + BuiltinBaseTool）
- * Shell:     bash（builtin/bash-tool）
- * 网络:      web_search, web_fetch（builtin/web-*-tool）
- * 计划:      todo_read, todo_write（builtin/todo-*-tool）
- * 外部 MCP 工具由 generation MCPFeature 投影按 active binding 注入。
- * 技能:      load_skill, install_skill（builtin/load-skill-tool, install-skill-tool）
- * 交互工具由 Plugin Runtime 以 turn-scoped ToolFeature 发布。
- *
- * 发现逻辑已拆分到 discovery/skills.ts、agents.ts、tools.ts
- */
-import type { Plugin, ToolInput } from '@zhin.js/core';
-export interface BuiltinToolsOptions {
-    /** Classic Plugin authority still required by the legacy bash definition. */
-    plugin: Plugin;
-    /** 知识库目录（注册 knowledge_search 工具） */
-    knowledgeDir?: string;
-}
-/**
- * 创建所有内置系统工具
- */
-export declare function createBuiltinTools(options: BuiltinToolsOptions): ToolInput[];
-//# sourceMappingURL=builtin-tools.d.ts.map

package/lib/builtin-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAiBvD,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE,CA0B5E"}

package/lib/builtin-tools.js

@@ -1,54 +0,0 @@
-/**
- * AI 内置系统工具
- *
- * 文件工具:  read_file / write_file / edit_file / list_dir / glob / grep（builtin/* + BuiltinBaseTool）
- * Shell:     bash（builtin/bash-tool）
- * 网络:      web_search, web_fetch（builtin/web-*-tool）
- * 计划:      todo_read, todo_write（builtin/todo-*-tool）
- * 外部 MCP 工具由 generation MCPFeature 投影按 active binding 注入。
- * 技能:      load_skill, install_skill（builtin/load-skill-tool, install-skill-tool）
- * 交互工具由 Plugin Runtime 以 turn-scoped ToolFeature 发布。
- *
- * 发现逻辑已拆分到 discovery/skills.ts、agents.ts、tools.ts
- */
-import { getDataDir } from './discovery/utils.js';
-import { createReadFileTool } from './builtin/read-file-tool.js';
-import { createWriteFileTool } from './builtin/write-file-tool.js';
-import { createEditFileTool } from './builtin/edit-file-tool.js';
-import { createListDirTool } from './builtin/list-dir-tool.js';
-import { createGlobTool } from './builtin/glob-tool.js';
-import { createGrepTool } from './builtin/grep-tool.js';
-import { createBashTool } from './builtin/bash-tool.js';
-import { createWebSearchTool } from './builtin/web-search-tool.js';
-import { createWebFetchTool } from './builtin/web-fetch-tool.js';
-import { createTodoReadTool } from './builtin/todo-read-tool.js';
-import { createTodoWriteTool } from './builtin/todo-write-tool.js';
-import { createInstallSkillTool } from './builtin/install-skill-tool.js';
-import { createAnalyzeMediaTool } from './builtin/analyze-media-tool.js';
-import { createKnowledgeSearchTool } from './builtin/knowledge-search-tool.js';
-/**
- * 创建所有内置系统工具
- */
-export function createBuiltinTools(options) {
-    const DATA_DIR = getDataDir();
-    const pluginRef = options?.plugin;
-    const tools = [];
-    tools.push(createReadFileTool());
-    tools.push(createAnalyzeMediaTool());
-    tools.push(createWriteFileTool());
-    tools.push(createEditFileTool());
-    tools.push(createListDirTool());
-    tools.push(createGlobTool());
-    tools.push(createGrepTool());
-    tools.push(createBashTool(pluginRef.root ?? pluginRef));
-    tools.push(createWebSearchTool());
-    tools.push(createWebFetchTool());
-    tools.push(createTodoReadTool(DATA_DIR));
-    tools.push(createTodoWriteTool(DATA_DIR));
-    tools.push(createInstallSkillTool());
-    if (options?.knowledgeDir) {
-        tools.push(createKnowledgeSearchTool({ knowledgeDir: options.knowledgeDir }));
-    }
-    return tools;
-}
-//# sourceMappingURL=builtin-tools.js.map

package/lib/builtin-tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtin-tools.js","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAS/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC;IAElC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1C,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAErC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/defaults/hooks.d.ts

@@ -1,6 +0,0 @@
-/**
- * Default common hooks — baseline AI lifecycle hooks.
- */
-import type { AgentResourceHub } from '../resource-hub/index.js';
-export declare function registerDefaultHooks(_resourceHub: AgentResourceHub): void;
-//# sourceMappingURL=hooks.d.ts.map

package/lib/defaults/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/defaults/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAIzE"}

package/lib/defaults/hooks.js

@@ -1,9 +0,0 @@
-/**
- * Default common hooks — baseline AI lifecycle hooks.
- */
-export function registerDefaultHooks(_resourceHub) {
-    // Default hooks are intentionally minimal.
-    // The existing hooks.ts module-level API handles legacy hooks.
-    // Plugins/users register hooks via resourceHub.addHook().
-}
-//# sourceMappingURL=hooks.js.map

package/lib/defaults/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/defaults/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,oBAAoB,CAAC,YAA8B;IACjE,2CAA2C;IAC3C,+DAA+D;IAC/D,0DAA0D;AAC5D,CAAC"}

package/lib/defaults/subagents.d.ts

@@ -1,6 +0,0 @@
-/**
- * Default sub-agent templates — common presets available to all agents.
- */
-import type { AgentResourceHub } from '../resource-hub/index.js';
-export declare function registerDefaultSubAgents(resourceHub: AgentResourceHub): void;
-//# sourceMappingURL=subagents.d.ts.map

package/lib/defaults/subagents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../../src/defaults/subagents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAkBjE,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAI5E"}

package/lib/defaults/subagents.js

@@ -1,23 +0,0 @@
-/**
- * Default sub-agent templates — common presets available to all agents.
- */
-const DEFAULT_SUBAGENTS = [
-    {
-        name: 'summarizer',
-        description: '文本/对话摘要专家，擅长生成精练的中文摘要',
-        systemPrompt: '你是一个专业的摘要助手。请以简洁、准确的中文输出摘要，保留关键信息和重要决定。',
-        maxIterations: 3,
-    },
-    {
-        name: 'translator',
-        description: '多语言翻译助手，支持中英日韩等语言互译',
-        systemPrompt: '你是一个精确的翻译助手。请根据用户需求在不同语言间翻译，保持语义准确和地道表达。',
-        maxIterations: 3,
-    },
-];
-export function registerDefaultSubAgents(resourceHub) {
-    for (const def of DEFAULT_SUBAGENTS) {
-        resourceHub.addSubAgent(def, undefined, 'builtin');
-    }
-}
-//# sourceMappingURL=subagents.js.map

package/lib/defaults/subagents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"subagents.js","sourceRoot":"","sources":["../../src/defaults/subagents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,iBAAiB,GAAkB;IACvC;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,uBAAuB;QACpC,YAAY,EAAE,yCAAyC;QACvD,aAAa,EAAE,CAAC;KACjB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qBAAqB;QAClC,YAAY,EAAE,0CAA0C;QACxD,aAAa,EAAE,CAAC;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,WAA6B;IACpE,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/lib/defaults/tools.d.ts

@@ -1,5 +0,0 @@
-/**
- * Agent Resource Hub 默认工具注册位（保留入口；当前不注入任何占位 ZhinTool）。
- * 真实能力请通过插件、`createBuiltinTools`、MCP 等注册。
- */
-//# sourceMappingURL=tools.d.ts.map

package/lib/defaults/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/defaults/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/defaults/tools.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Agent Resource Hub 默认工具注册位（保留入口；当前不注入任何占位 ZhinTool）。
- * 真实能力请通过插件、`createBuiltinTools`、MCP 等注册。
- */
-//# sourceMappingURL=tools.js.map

package/lib/defaults/tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/defaults/tools.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/lib/discovery/index.d.ts

@@ -1,5 +0,0 @@
-export * from './utils.js';
-export * from './tools.js';
-export * from './skills.js';
-export * from './agents.js';
-//# sourceMappingURL=index.d.ts.map

package/lib/discovery/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/lib/discovery/index.js

@@ -1,5 +0,0 @@
-export * from './utils.js';
-export * from './tools.js';
-export * from './skills.js';
-export * from './agents.js';
-//# sourceMappingURL=index.js.map

package/lib/discovery/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/lib/discovery/skills.d.ts

@@ -1,53 +0,0 @@
-/**
- * 技能发现（SKILL.md 文件扫描与加载）
- *
- * 加载顺序：Workspace（cwd/skills）> Local（~/.zhin/skills）> .agents/skills（向上至 git root）> 已加载插件包 skills/
- * 同名先发现者优先，支持平台/依赖兼容性过滤
- */
-import { type Plugin } from '@zhin.js/core';
-export interface SkillMeta {
-    name: string;
-    description: string;
-    keywords?: string[];
-    tags?: string[];
-    /** SKILL.md frontmatter 中声明的关联工具名列表 */
-    toolNames?: string[];
-    /** 支持的平台列表（如 ['icqq', 'discord']），不填则为通用 Skill */
-    platforms?: string[];
-    filePath: string;
-    /** 是否常驻注入 system prompt（frontmatter always: true） */
-    always?: boolean;
-    /** 当前环境是否满足依赖（bins/env） */
-    available?: boolean;
-    /** 缺失的依赖描述（如 "CLI: ffmpeg", "ENV: API_KEY") */
-    requiresMissing?: string[];
-    /** 所属插件名（从 skills/ 目录归属推断） */
-    ownerPlugin?: string;
-}
-/**
- * 扫描技能目录，发现 SKILL.md 技能文件
- * @param root 根插件（可选）：用于追加插件包内 `skills/` 扫描，与 `activate_skill` 查找路径一致
- */
-export declare function discoverWorkspaceSkills(root?: Plugin | null): Promise<SkillMeta[]>;
-/**
- * 获取 frontmatter 中 always: true 的技能名列表（用于常驻注入 system prompt）
- */
-export declare function getAlwaysSkillNames(skills: SkillMeta[]): string[];
-/**
- * 加载 always 技能的正文内容并拼接为「Active Skills」段
- */
-export declare function loadAlwaysSkillsContent(skills: SkillMeta[]): Promise<string>;
-/**
- * 构建技能列表的 XML 摘要，供 model 区分可用/不可用及缺失依赖
- */
-export declare function buildSkillsSummaryXML(skills: SkillMeta[]): string;
-/**
- * 检查技能声明的依赖是否在环境中可用；若有缺失返回提示文案，否则返回空字符串
- */
-export declare function checkSkillDeps(content: string): Promise<string>;
-/**
- * 从 SKILL.md 全文中提取精简的执行指令
- * 只保留 frontmatter（工具列表）和执行规则，去掉示例、测试场景等冗余内容
- */
-export declare function extractSkillInstructions(name: string, content: string, maxBodyLen?: number): string;
-//# sourceMappingURL=skills.d.ts.map

package/lib/discovery/skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/discovery/skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,eAAe,CAAC;AAUvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAoHxF;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAEjE;AAQD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAclF;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAajE;AAMD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBrE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa,GAAG,MAAM,CAwEzG"}

package/lib/discovery/skills.js

@@ -1,306 +0,0 @@
-/**
- * 技能发现（SKILL.md 文件扫描与加载）
- *
- * 加载顺序：Workspace（cwd/skills）> Local（~/.zhin/skills）> .agents/skills（向上至 git root）> 已加载插件包 skills/
- * 同名先发现者优先，支持平台/依赖兼容性过滤
- */
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import { getLogger } from '@zhin.js/core';
-import { getSkillSearchDirectories } from './utils.js';
-const execAsync = promisify(exec);
-const logger = getLogger('builtin-tools');
-// ============================================================================
-// 发现
-// ============================================================================
-/**
- * 扫描技能目录，发现 SKILL.md 技能文件
- * @param root 根插件（可选）：用于追加插件包内 `skills/` 扫描，与 `activate_skill` 查找路径一致
- */
-export async function discoverWorkspaceSkills(root) {
-    const skills = [];
-    const seenNames = new Set();
-    const skillDirs = getSkillSearchDirectories(root ?? undefined);
-    // Build dir → pluginName mapping for attribution
-    const dirToPlugin = new Map();
-    if (root) {
-        const mapPlugin = (p) => {
-            if (!p?.filePath)
-                return;
-            const dir = path.dirname(p.filePath);
-            dirToPlugin.set(path.join(dir, 'skills'), p.name);
-            const dirName = path.basename(dir);
-            if (dirName === 'src' || dirName === 'lib') {
-                dirToPlugin.set(path.join(path.dirname(dir), 'skills'), p.name);
-            }
-        };
-        mapPlugin(root);
-        for (const child of (root.children || []))
-            mapPlugin(child);
-    }
-    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');
-                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;
-                    }
-                }
-                // 依赖检查
-                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 : [],
-                    platforms: Array.isArray(metadata.platforms) ? metadata.platforms : undefined,
-                    filePath: skillMdPath,
-                    always: Boolean(metadata.always),
-                    available,
-                    requiresMissing: requiresMissing.length > 0 ? requiresMissing : undefined,
-                    ownerPlugin: dirToPlugin.get(skillsDir),
-                });
-                logger.debug(`Skill发现成功: ${metadata.name}, tools: ${JSON.stringify(metadata.tools || [])}, platforms: ${JSON.stringify(metadata.platforms || '(all)')}`);
-            }
-            catch (e) {
-                logger.warn(`Failed to parse SKILL.md in ${skillMdPath}:`, e);
-            }
-        }
-    }
-    return skills;
-}
-// ============================================================================
-// 辅助函数
-// ============================================================================
-/**
- * 获取 frontmatter 中 always: true 的技能名列表（用于常驻注入 system prompt）
- */
-export function getAlwaysSkillNames(skills) {
-    return skills.filter(s => s.always && s.available).map(s => s.name);
-}
-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');
-}
-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 = ['<available_skills>'];
-    for (const s of skills) {
-        const available = s.available !== false;
-        const attrs = `available="${available}"`;
-        const requires = (!available && s.requiresMissing?.length)
-            ? ` requires="${escapeXml(s.requiresMissing.join(','))}"`
-            : '';
-        lines.push(`  <skill ${attrs}${requires}><name>${escapeXml(s.name)}</name><description>${escapeXml(s.description)}</description></skill>`);
-    }
-    lines.push('</available_skills>');
-    return lines.join('\n');
-}
-// ============================================================================
-// 技能内容解析（activate_skill 使用）
-// ============================================================================
-/**
- * 检查技能声明的依赖是否在环境中可用；若有缺失返回提示文案，否则返回空字符串
- */
-export 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（工具列表）和执行规则，去掉示例、测试场景等冗余内容
- */
-export 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');
-}
-//# sourceMappingURL=skills.js.map