@zhin.js/agent 1.1.23 → 1.1.27

package/lib/discovery/tools.js

@@ -1,305 +0,0 @@
-/**
- * 文件化 Tool 发现（*.tool.md 文件扫描与构建）
- *
- * 加载顺序与 skills/agents 一致：Workspace > ~/.zhin > data > 插件包
- * 同名先发现者优先
- */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { spawn } from 'node:child_process';
-import { getLogger } from '@zhin.js/core';
-import { getDataDir } from './utils.js';
-const VALID_TOOL_SCOPES = ['private', 'group', 'channel'];
-const VALID_SENDER_ROLES = ['user', 'trusted', 'master'];
-function parseScopes(raw) {
-    if (!raw || raw.length === 0)
-        return undefined;
-    const filtered = raw.filter((s) => VALID_TOOL_SCOPES.includes(s));
-    return filtered.length > 0 ? filtered : undefined;
-}
-function parsePermit(raw) {
-    const items = raw == null ? [] : Array.isArray(raw) ? raw : [raw];
-    const permits = items.map((v) => String(v).trim()).filter(Boolean);
-    return permits.length > 0 ? permits : undefined;
-}
-/** 兼容旧 requiredAnyRole frontmatter，转为 role(...) permit */
-function parsePermissionsFromMetadata(metadata) {
-    const direct = parsePermit(metadata.permit);
-    if (direct?.length)
-        return direct;
-    const items = metadata.requiredAnyRole == null
-        ? []
-        : Array.isArray(metadata.requiredAnyRole)
-            ? metadata.requiredAnyRole
-            : [metadata.requiredAnyRole];
-    const roles = items.filter((r) => VALID_SENDER_ROLES.includes(r));
-    if (roles.length === 0)
-        return undefined;
-    return roles.map((r) => `role(${r})`);
-}
-const logger = getLogger('builtin-tools');
-// ============================================================================
-// 目录收集
-// ============================================================================
-/**
- * 从根插件树收集：根插件与直接子插件包目录下的 `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'));
-        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;
-}
-// ============================================================================
-// 发现
-// ============================================================================
-/**
- * 扫描 tools/ 目录，发现 *.tool.md 文件
- */
-export async function discoverWorkspaceTools(root) {
-    const tools = [];
-    const seenNames = new Set();
-    const toolDirs = getToolSearchDirectories(root);
-    // 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, 'tools'), p.name);
-            const dirName = path.basename(dir);
-            if (dirName === 'src' || dirName === 'lib') {
-                dirToPlugin.set(path.join(path.dirname(dir), 'tools'), p.name);
-            }
-        };
-        mapPlugin(root);
-        for (const child of (root.children || []))
-            mapPlugin(child);
-    }
-    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) {
-            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);
-                const body = content.replace(/^---\s*\n[\s\S]*?\n---\s*(?:\n|$)/, '').trim();
-                tools.push({
-                    name: metadata.name,
-                    description: metadata.description,
-                    parameters: metadata.parameters || undefined,
-                    platforms: metadata.platforms,
-                    scopes: metadata.scopes,
-                    permit: parsePermissionsFromMetadata(metadata),
-                    tags: metadata.tags || [],
-                    keywords: metadata.keywords || [],
-                    kind: metadata.kind,
-                    hidden: metadata.hidden,
-                    preExecutable: metadata.preExecutable,
-                    handler: metadata.handler,
-                    filePath: toolMdPath,
-                    templateBody: !metadata.handler && body ? body : undefined,
-                    ownerPlugin: dirToPlugin.get(toolsDir),
-                });
-                logger.debug(`Tool发现成功: ${metadata.name}`);
-            }
-            catch (e) {
-                logger.warn(`Failed to parse tool.md in ${toolMdPath}:`, e);
-            }
-        }
-    }
-    return tools;
-}
-// ============================================================================
-// 构建
-// ============================================================================
-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 };
-}
-async function loadToolHandler(handlerPath, toolMdPath) {
-    const resolved = path.resolve(path.dirname(toolMdPath), handlerPath);
-    if (!fs.existsSync(resolved)) {
-        logger.warn(`Tool handler 文件不存在: ${resolved}`);
-        return undefined;
-    }
-    const ext = path.extname(resolved).toLowerCase();
-    // Python script handler: spawn subprocess, pass args via JSON stdin, return stdout
-    if (ext === '.py') {
-        return async (args) => {
-            const input = JSON.stringify(args);
-            const pythonBin = process.env.PYTHON_BIN || 'python3';
-            try {
-                const result = await new Promise((resolve, reject) => {
-                    const child = spawn(pythonBin, [resolved], {
-                        stdio: ['pipe', 'pipe', 'pipe'],
-                        timeout: 30_000,
-                    });
-                    let stdout = '';
-                    let stderr = '';
-                    child.stdout.on('data', (d) => { stdout += d.toString(); });
-                    child.stderr.on('data', (d) => { stderr += d.toString(); });
-                    child.on('close', (code) => {
-                        if (stderr)
-                            logger.debug(`[Python handler] ${resolved} stderr: ${stderr.trim()}`);
-                        if (code !== 0)
-                            reject(new Error(`Python exited with code ${code}: ${stderr.trim()}`));
-                        else
-                            resolve(stdout.trim());
-                    });
-                    child.on('error', reject);
-                    child.stdin.write(input);
-                    child.stdin.end();
-                });
-                return result;
-            }
-            catch (e) {
-                return `Error running Python handler: ${e instanceof Error ? e.message : String(e)}`;
-            }
-        };
-    }
-    // JS/TS handler: ESM import
-    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 has no exported function: ${resolved}`);
-            return undefined;
-        }
-        return fn;
-    }
-    catch (e) {
-        logger.warn(`Failed to load tool handler ${resolved}: ${e instanceof Error ? e.message : String(e)}`);
-        return undefined;
-    }
-}
-function buildTemplateExecute(body) {
-    return (args) => body.replace(/\{\{(\w+)\}\}/g, (_, k) => {
-        const val = args[k];
-        return val !== undefined && val !== null ? String(val) : '';
-    });
-}
-/**
- * 将 ToolMeta 转换为 Tool 对象（包含 execute 函数）
- */
-export async function buildToolFromMeta(meta) {
-    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;
-    }
-    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: parseScopes(meta.scopes),
-        permissions: meta.permit,
-        hidden: meta.hidden,
-        preExecutable: meta.preExecutable,
-        kind: meta.kind,
-    };
-}
-//# sourceMappingURL=tools.js.map

package/lib/discovery/tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/discovery/tools.ts"],"names":[],"mappings":"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"}

package/lib/features/agent-feature.d.ts

@@ -1,23 +0,0 @@
-/**
- * AgentFeature — 专长 / 子代理预设（装配面；ADR 0042）
- *
- * 不等同于配置 `agents[].match` 主绑定；主路径选用由 Agent Binding 决定。
- * Core `AgentPresetFeature` 仍保留；本 Feature 为 agent 包权威装配面。
- */
-import { Feature, type FeatureJSON } from '@zhin.js/kernel';
-import type { AgentPreset } from '../resource-hub/types.js';
-export declare class AgentFeature extends Feature<AgentPreset> {
-    readonly name: "agentFeature";
-    readonly icon = "Bot";
-    readonly desc = "Agent \u4E13\u957F\u9884\u8BBE";
-    readonly byName: Map<string, AgentPreset>;
-    /** Bumped when presets change — Capability Ingress cache invalidation. */
-    epoch: number;
-    add(preset: AgentPreset, pluginName: string): () => void;
-    remove(preset: AgentPreset, pluginName?: string): boolean;
-    get(name: string): AgentPreset | undefined;
-    getAll(): AgentPreset[];
-    dispose(): void;
-    toJSON(pluginName?: string): FeatureJSON;
-}
-//# sourceMappingURL=agent-feature.d.ts.map

package/lib/features/agent-feature.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-feature.d.ts","sourceRoot":"","sources":["../../src/features/agent-feature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,YAAa,SAAQ,OAAO,CAAC,WAAW,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IACxC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,IAAI,oCAAgB;IAE7B,QAAQ,CAAC,MAAM,2BAAkC;IACjD,0EAA0E;IAC1E,KAAK,SAAK;IAEV,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAMxD,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAMzD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,MAAM,IAAI,WAAW,EAAE;IAIvB,OAAO,IAAI,IAAI;IAKf,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;CAezC"}

package/lib/features/agent-feature.js

@@ -1,51 +0,0 @@
-/**
- * AgentFeature — 专长 / 子代理预设（装配面；ADR 0042）
- *
- * 不等同于配置 `agents[].match` 主绑定；主路径选用由 Agent Binding 决定。
- * Core `AgentPresetFeature` 仍保留；本 Feature 为 agent 包权威装配面。
- */
-import { Feature } from '@zhin.js/kernel';
-export class AgentFeature extends Feature {
-    name = 'agentFeature';
-    icon = 'Bot';
-    desc = 'Agent 专长预设';
-    byName = new Map();
-    /** Bumped when presets change — Capability Ingress cache invalidation. */
-    epoch = 0;
-    add(preset, pluginName) {
-        this.byName.set(preset.name, preset);
-        this.epoch++;
-        return super.add(preset, pluginName);
-    }
-    remove(preset, pluginName) {
-        this.byName.delete(preset.name);
-        this.epoch++;
-        return super.remove(preset, pluginName);
-    }
-    get(name) {
-        return this.byName.get(name);
-    }
-    getAll() {
-        return [...this.items];
-    }
-    dispose() {
-        this.byName.clear();
-        this.epoch++;
-    }
-    toJSON(pluginName) {
-        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
-        return {
-            name: this.name,
-            icon: this.icon,
-            desc: this.desc,
-            count: list.length,
-            items: list.map((p) => ({
-                name: p.name,
-                desc: p.description,
-                model: p.model,
-                pluginName: p.pluginName,
-            })),
-        };
-    }
-}
-//# sourceMappingURL=agent-feature.js.map

package/lib/features/agent-feature.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-feature.js","sourceRoot":"","sources":["../../src/features/agent-feature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,iBAAiB,CAAC;AAG5D,MAAM,OAAO,YAAa,SAAQ,OAAoB;IAC3C,IAAI,GAAG,cAAuB,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC;IACb,IAAI,GAAG,YAAY,CAAC;IAEpB,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,0EAA0E;IAC1E,KAAK,GAAG,CAAC,CAAC;IAEV,GAAG,CAAC,MAAmB,EAAE,UAAkB;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,MAAmB,EAAE,UAAmB;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,MAAM,CAAC,UAAmB;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,WAAW;gBACnB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF"}

package/lib/features/index.d.ts

@@ -1,3 +0,0 @@
-export { AgentFeature } from './agent-feature.js';
-export { MCPFeature, type McpFeatureEntry } from './mcp-feature.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/features/index.js

@@ -1,3 +0,0 @@
-export { AgentFeature } from './agent-feature.js';
-export { MCPFeature } from './mcp-feature.js';
-//# sourceMappingURL=index.js.map

package/lib/features/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC"}

package/lib/features/mcp-feature.d.ts

@@ -1,25 +0,0 @@
-/**
- * MCPFeature — MCP server 声明（装配面；ADR 0042）
- *
- * 仅存连接声明，不含已连接后的工具列表。
- */
-import { Feature, type FeatureJSON } from '@zhin.js/kernel';
-import type { McpServerEntry } from '../resource-hub/types.js';
-export interface McpFeatureEntry extends McpServerEntry {
-    /** 来源插件或 config */
-    pluginName?: string;
-}
-export declare class MCPFeature extends Feature<McpFeatureEntry> {
-    readonly name: "mcpFeature";
-    readonly icon = "Plug";
-    readonly desc = "MCP \u670D\u52A1\u58F0\u660E";
-    readonly byName: Map<string, McpFeatureEntry>;
-    epoch: number;
-    add(entry: McpFeatureEntry, pluginName: string): () => void;
-    remove(entry: McpFeatureEntry, pluginName?: string): boolean;
-    get(name: string): McpFeatureEntry | undefined;
-    getAll(): McpFeatureEntry[];
-    dispose(): void;
-    toJSON(pluginName?: string): FeatureJSON;
-}
-//# sourceMappingURL=mcp-feature.d.ts.map

package/lib/features/mcp-feature.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-feature.d.ts","sourceRoot":"","sources":["../../src/features/mcp-feature.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAW,SAAQ,OAAO,CAAC,eAAe,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,IAAI,kCAAc;IAE3B,QAAQ,CAAC,MAAM,+BAAsC;IACrD,KAAK,SAAK;IAEV,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAU3D,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAM5D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C,MAAM,IAAI,eAAe,EAAE;IAI3B,OAAO,IAAI,IAAI;IAKf,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;CAczC"}

package/lib/features/mcp-feature.js

@@ -1,52 +0,0 @@
-/**
- * MCPFeature — MCP server 声明（装配面；ADR 0042）
- *
- * 仅存连接声明，不含已连接后的工具列表。
- */
-import { Feature } from '@zhin.js/kernel';
-export class MCPFeature extends Feature {
-    name = 'mcpFeature';
-    icon = 'Plug';
-    desc = 'MCP 服务声明';
-    byName = new Map();
-    epoch = 0;
-    add(entry, pluginName) {
-        const withPlugin = {
-            ...entry,
-            pluginName: entry.pluginName ?? pluginName,
-        };
-        this.byName.set(withPlugin.name, withPlugin);
-        this.epoch++;
-        return super.add(withPlugin, pluginName);
-    }
-    remove(entry, pluginName) {
-        this.byName.delete(entry.name);
-        this.epoch++;
-        return super.remove(entry, pluginName);
-    }
-    get(name) {
-        return this.byName.get(name);
-    }
-    getAll() {
-        return [...this.items];
-    }
-    dispose() {
-        this.byName.clear();
-        this.epoch++;
-    }
-    toJSON(pluginName) {
-        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
-        return {
-            name: this.name,
-            icon: this.icon,
-            desc: this.desc,
-            count: list.length,
-            items: list.map((e) => ({
-                name: e.name,
-                desc: e.transport,
-                pluginName: e.pluginName,
-            })),
-        };
-    }
-}
-//# sourceMappingURL=mcp-feature.js.map

package/lib/features/mcp-feature.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-feature.js","sourceRoot":"","sources":["../../src/features/mcp-feature.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,iBAAiB,CAAC;AAQ5D,MAAM,OAAO,UAAW,SAAQ,OAAwB;IAC7C,IAAI,GAAG,YAAqB,CAAC;IAC7B,IAAI,GAAG,MAAM,CAAC;IACd,IAAI,GAAG,UAAU,CAAC;IAElB,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IACrD,KAAK,GAAG,CAAC,CAAC;IAEV,GAAG,CAAC,KAAsB,EAAE,UAAkB;QAC5C,MAAM,UAAU,GAAoB;YAClC,GAAG,KAAK;YACR,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,UAAU;SAC3C,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,KAAsB,EAAE,UAAmB;QAChD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,MAAM,CAAC,UAAmB;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,SAAS;gBACjB,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF"}

package/lib/hooks.d.ts

@@ -1,144 +0,0 @@
-/**
- * AI Hooks — AI 生命周期事件钩子系统
- *
- * 借鉴 OpenClaw 的 Hooks 设计，提供可扩展的事件驱动钩子：
- *
- *   - message:received   — 收到消息时触发
- *   - message:sent       — 发送消息时触发
- *   - session:compact    — 会话压缩时触发
- *   - session:new        — 新建会话时触发
- *   - agent:bootstrap    — Agent 初始化时触发
- *   - agent:tool-call    — 工具调用时触发
- *
- * 钩子按注册顺序执行，错误不会中断其他钩子。
- */
-import { runModuleAIHookHandlers } from './ai-hook-handlers.js';
-/** 事件类型 */
-export type AIHookEventType = 'message' | 'session' | 'agent' | 'tool';
-/** Hook 事件基础接口 */
-export interface AIHookEvent {
-    /** 事件类型 */
-    type: AIHookEventType;
-    /** 具体动作 */
-    action: string;
-    /** 会话标识 */
-    sessionId?: string;
-    /** 附加上下文 */
-    context: Record<string, unknown>;
-    /** 事件时间戳 */
-    timestamp: Date;
-    /** 钩子可以推送消息到这个数组 */
-    messages: string[];
-}
-/** 消息接收事件 */
-export interface MessageReceivedEvent extends AIHookEvent {
-    type: 'message';
-    action: 'received';
-    context: {
-        from: string;
-        content: string;
-        platform: string;
-        channelId?: string;
-        messageId?: string;
-    };
-}
-/** 消息发送事件 */
-export interface MessageSentEvent extends AIHookEvent {
-    type: 'message';
-    action: 'sent';
-    context: {
-        to: string;
-        content: string;
-        success: boolean;
-        error?: string;
-        platform: string;
-    };
-}
-/** 会话压缩事件 */
-export interface SessionCompactEvent extends AIHookEvent {
-    type: 'session';
-    action: 'compact';
-    context: {
-        compactedCount: number;
-        savedTokens: number;
-        summary: string;
-    };
-}
-/** 会话新建事件 */
-export interface SessionNewEvent extends AIHookEvent {
-    type: 'session';
-    action: 'new';
-    context: {
-        previousSessionId?: string;
-    };
-}
-/** Agent 初始化事件 */
-export interface AgentBootstrapEvent extends AIHookEvent {
-    type: 'agent';
-    action: 'bootstrap';
-    context: {
-        workspaceDir: string;
-        toolCount: number;
-        skillCount: number;
-        bootstrapFiles: string[];
-    };
-}
-/** 工具调用事件 */
-export interface ToolCallEvent extends AIHookEvent {
-    type: 'tool';
-    action: 'call';
-    context: {
-        toolName: string;
-        args: Record<string, unknown>;
-        result?: string;
-        durationMs?: number;
-        success: boolean;
-        error?: string;
-    };
-}
-/** Hook 处理函数 */
-export type AIHookHandler = (event: AIHookEvent) => Promise<void> | void;
-/**
- * 注册 Hook 处理函数
- *
- * @param eventKey - 事件类型（如 'message'）或具体动作（如 'message:received'）
- * @param handler - 处理函数
- *
- * @example
- * ```ts
- * // 监听所有消息事件
- * registerAIHook('message', async (event) => {
- *   console.log('消息事件:', event.action);
- * });
- *
- * // 只监听消息接收
- * registerAIHook('message:received', async (event) => {
- *   console.log('收到消息:', event.context.content);
- * });
- * ```
- */
-export declare function registerAIHook(eventKey: string, handler: AIHookHandler): () => void;
-/**
- * 注销 Hook 处理函数
- */
-export declare function unregisterAIHook(eventKey: string, handler: AIHookHandler): void;
-/**
- * 清除所有 Hook（测试用）
- */
-export declare function clearAIHooks(): void;
-/**
- * 获取已注册的事件 key 列表（调试用）
- */
-export declare function getRegisteredAIHookKeys(): string[];
-/**
- * 触发 Hook 事件
- *
- * 扇出到 Runtime bus + `registerAIHook` handlers +（若有）host Plugin。
- */
-export declare function triggerAIHook(event: AIHookEvent): Promise<void>;
-export { runModuleAIHookHandlers };
-/**
- * 创建 Hook 事件（辅助函数）
- */
-export declare function createAIHookEvent(type: AIHookEventType, action: string, sessionId?: string, context?: Record<string, unknown>): AIHookEvent;
-//# sourceMappingURL=hooks.d.ts.map

package/lib/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}