workerclaw 0.2.0

package/dist/skills/pack-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-loader.d.ts","sourceRoot":"","sources":["../../src/skills/pack-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAGhE,qBAAa,eAAe;IAC1B;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAU9C;;OAEG;YACW,WAAW;IAoBzB;;OAEG;YACW,YAAY;IAwD1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAyB3D"}

package/dist/skills/pack-loader.js

@@ -0,0 +1,167 @@
+/**
+ * WorkerClaw 技能包加载器
+ *
+ * 从 npm 包或本地路径动态加载技能包
+ */
+import { resolve, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+export class SkillPackLoader {
+    /**
+     * 从 npm 包或本地路径加载技能包
+     *
+     * @param source - npm 包名 (如 @glin_1/workerclaw-skill-image) 或本地路径 (如 ./my-skills)
+     */
+    async load(source) {
+        // 判断是本地路径还是 npm 包
+        if (source.startsWith('./') || source.startsWith('../') || source.startsWith('/') || source.startsWith('~')) {
+            return this.loadFromPath(resolve(source));
+        }
+        // npm 包 - 尝试动态 import
+        return this.loadFromNpm(source);
+    }
+    /**
+     * 从 npm 包加载
+     */
+    async loadFromNpm(packageName) {
+        try {
+            const mod = await import(packageName);
+            // 尝试获取默认导出或直接导出
+            const pack = mod.default || mod;
+            return this.validateAndNormalize(pack, packageName);
+        }
+        catch (err) {
+            // 如果直接 import 失败，尝试 resolve 路径后 import
+            try {
+                const mod = await import(`${packageName}/dist/index.js`);
+                const pack = mod.default || mod;
+                return this.validateAndNormalize(pack, packageName);
+            }
+            catch {
+                throw new Error(`无法加载技能包 "${packageName}": ${err.message}`);
+            }
+        }
+    }
+    /**
+     * 从本地路径加载
+     */
+    async loadFromPath(dirPath) {
+        // 读取 skill.json 或 package.json
+        let meta = null;
+        const skillJsonPath = join(dirPath, 'skill.json');
+        const packageJsonPath = join(dirPath, 'package.json');
+        if (existsSync(skillJsonPath)) {
+            try {
+                meta = JSON.parse(readFileSync(skillJsonPath, 'utf-8'));
+            }
+            catch {
+                throw new Error(`skill.json 解析失败: ${skillJsonPath}`);
+            }
+        }
+        else if (existsSync(packageJsonPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                meta = {
+                    name: pkg.name,
+                    version: pkg.version || '0.0.0',
+                    description: pkg.description,
+                    main: pkg.main || 'index.js',
+                    skills: pkg.skills,
+                };
+            }
+            catch {
+                throw new Error(`package.json 解析失败: ${packageJsonPath}`);
+            }
+        }
+        if (!meta) {
+            throw new Error(`未找到 skill.json 或 package.json: ${dirPath}`);
+        }
+        // 确定入口文件
+        const mainFile = meta.main
+            ? resolve(dirPath, meta.main)
+            : resolve(dirPath, 'dist/index.js');
+        if (!existsSync(mainFile)) {
+            // 尝试直接 import 目录
+            try {
+                const mod = await import(dirPath);
+                const pack = mod.default || mod;
+                return this.validateAndNormalize(pack, meta.name);
+            }
+            catch {
+                throw new Error(`入口文件不存在: ${mainFile}`);
+            }
+        }
+        try {
+            const mod = await import(mainFile);
+            const pack = mod.default || mod;
+            return this.validateAndNormalize(pack, meta.name);
+        }
+        catch (err) {
+            throw new Error(`无法加载入口文件 ${mainFile}: ${err.message}`);
+        }
+    }
+    /**
+     * 验证并标准化技能包
+     */
+    validateAndNormalize(raw, sourceName) {
+        // 基本验证
+        if (!raw || typeof raw !== 'object') {
+            throw new Error(`技能包格式无效: ${sourceName}`);
+        }
+        const name = raw.name || sourceName;
+        const version = raw.version || '0.0.0';
+        const description = raw.description || '';
+        // 验证 skills
+        let skills = [];
+        if (Array.isArray(raw.skills)) {
+            skills = raw.skills;
+        }
+        else if (raw.skills && typeof raw.skills === 'object') {
+            // 可能是 { name: Skill } 格式
+            skills = Object.values(raw.skills);
+        }
+        if (skills.length === 0) {
+            throw new Error(`技能包 "${name}" 没有提供任何技能`);
+        }
+        // 验证每个技能有 metadata
+        for (const skill of skills) {
+            if (!skill.metadata?.name) {
+                throw new Error(`技能包 "${name}" 中的技能缺少 metadata.name`);
+            }
+        }
+        return {
+            name,
+            version,
+            description,
+            skills,
+            init: typeof raw.init === 'function' ? raw.init : undefined,
+            dispose: typeof raw.dispose === 'function' ? raw.dispose : undefined,
+        };
+    }
+    /**
+     * 从指定目录扫描所有 skill.json
+     */
+    async loadFromDirectory(dir) {
+        const { readdirSync } = await import('node:fs');
+        const packs = [];
+        if (!existsSync(dir))
+            return packs;
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const subDir = join(dir, entry.name);
+            const skillJsonPath = join(subDir, 'skill.json');
+            if (existsSync(skillJsonPath)) {
+                try {
+                    const pack = await this.loadFromPath(subDir);
+                    packs.push(pack);
+                }
+                catch (err) {
+                    console.warn(`跳过加载 ${entry.name}: ${err.message}`);
+                }
+            }
+        }
+        return packs;
+    }
+}
+//# sourceMappingURL=pack-loader.js.map

package/dist/skills/pack-loader.js.map

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

package/dist/skills/pack-registry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * WorkerClaw 技能包注册表
+ *
+ * 管理已安装的外部技能包清单
+ */
+import type { InstalledSkillPack } from './pack-types.js';
+export declare class SkillPackRegistry {
+    private filePath;
+    private manifest;
+    constructor(filePath: string);
+    /**
+     * 加载清单文件
+     */
+    private load;
+    /**
+     * 保存清单文件
+     */
+    private save;
+    /**
+     * 添加已安装的技能包
+     */
+    add(pack: InstalledSkillPack): void;
+    /**
+     * 移除技能包
+     */
+    remove(source: string): boolean;
+    /**
+     * 列出所有已安装的技能包
+     */
+    list(): InstalledSkillPack[];
+    /**
+     * 查找技能包
+     */
+    find(source: string): InstalledSkillPack | undefined;
+    /**
+     * 检查是否已安装
+     */
+    has(source: string): boolean;
+}
+//# sourceMappingURL=pack-registry.d.ts.map

package/dist/skills/pack-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-registry.d.ts","sourceRoot":"","sources":["../../src/skills/pack-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAE1E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACH,OAAO,CAAC,IAAI;IAYZ;;OAEG;IACH,OAAO,CAAC,IAAI;IAQZ;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IASnC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAY/B;;OAEG;IACH,IAAI,IAAI,kBAAkB,EAAE;IAI5B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIpD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAG7B"}

package/dist/skills/pack-registry.js

@@ -0,0 +1,80 @@
+/**
+ * WorkerClaw 技能包注册表
+ *
+ * 管理已安装的外部技能包清单
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+export class SkillPackRegistry {
+    filePath;
+    manifest;
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.manifest = this.load();
+    }
+    /**
+     * 加载清单文件
+     */
+    load() {
+        try {
+            if (existsSync(this.filePath)) {
+                const content = readFileSync(this.filePath, 'utf-8');
+                return JSON.parse(content);
+            }
+        }
+        catch {
+            // 清单文件损坏，重建
+        }
+        return { installed: [] };
+    }
+    /**
+     * 保存清单文件
+     */
+    save() {
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.filePath, JSON.stringify(this.manifest, null, 2), 'utf-8');
+    }
+    /**
+     * 添加已安装的技能包
+     */
+    add(pack) {
+        // 移除已有的同名包
+        this.manifest.installed = this.manifest.installed.filter(item => item.source !== pack.source);
+        this.manifest.installed.push(pack);
+        this.save();
+    }
+    /**
+     * 移除技能包
+     */
+    remove(source) {
+        const before = this.manifest.installed.length;
+        this.manifest.installed = this.manifest.installed.filter(item => item.source !== source);
+        if (this.manifest.installed.length < before) {
+            this.save();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 列出所有已安装的技能包
+     */
+    list() {
+        return [...this.manifest.installed];
+    }
+    /**
+     * 查找技能包
+     */
+    find(source) {
+        return this.manifest.installed.find(item => item.source === source);
+    }
+    /**
+     * 检查是否已安装
+     */
+    has(source) {
+        return this.manifest.installed.some(item => item.source === source);
+    }
+}
+//# sourceMappingURL=pack-registry.js.map

package/dist/skills/pack-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-registry.js","sourceRoot":"","sources":["../../src/skills/pack-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAS;IACjB,QAAQ,CAAiB;IAEjC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,IAAI;QACV,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,IAAI;QACV,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAwB;QAC1B,WAAW;QACX,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CACtD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CACpC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CACtD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAC/B,CAAC;QACF,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/skills/pack-types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * WorkerClaw 技能包类型定义
+ *
+ * 定义外部技能包的接口规范
+ */
+import type { Skill } from './types.js';
+import type { Logger } from '../core/logger.js';
+/** 技能包元数据 */
+export interface SkillPackMeta {
+    /** 技能包名称 */
+    name: string;
+    /** 技能包版本 */
+    version: string;
+    /** 技能包描述 */
+    description?: string;
+    /** 入口文件 */
+    main?: string;
+    /** 包含的技能清单 */
+    skills?: Array<{
+        name: string;
+        displayName?: string;
+        requiredLevel?: string;
+        applicableTaskTypes?: string[];
+        requiredTools?: string[];
+    }>;
+}
+/** 技能包实例 */
+export interface SkillPack {
+    /** 技能包元数据 */
+    name: string;
+    /** 版本 */
+    version: string;
+    /** 描述 */
+    description: string;
+    /** 提供的技能列表 */
+    skills: Skill[];
+    /** 初始化 */
+    init?(context: SkillPackContext): Promise<void>;
+    /** 清理 */
+    dispose?(): Promise<void>;
+}
+/** 技能包上下文（init 时传入） */
+export interface SkillPackContext {
+    config: any;
+    logger: Logger;
+}
+/** 已安装技能包记录 */
+export interface InstalledSkillPack {
+    /** 来源（npm 包名或本地路径） */
+    source: string;
+    /** 名称 */
+    name?: string;
+    /** 描述 */
+    description?: string;
+    /** 版本 */
+    version: string;
+    /** 安装时间 */
+    installedAt: string;
+}
+/** skills.json 结构 */
+export interface SkillsManifest {
+    installed: InstalledSkillPack[];
+}
+//# sourceMappingURL=pack-types.d.ts.map

package/dist/skills/pack-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-types.d.ts","sourceRoot":"","sources":["../../src/skills/pack-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,YAAY;AACZ,MAAM,WAAW,SAAS;IACxB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS;IACT,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAe;AACf,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAqB;AACrB,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC"}

package/dist/skills/pack-types.js

@@ -0,0 +1,7 @@
+/**
+ * WorkerClaw 技能包类型定义
+ *
+ * 定义外部技能包的接口规范
+ */
+export {};
+//# sourceMappingURL=pack-types.js.map

package/dist/skills/pack-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-types.js","sourceRoot":"","sources":["../../src/skills/pack-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/skills/skill-registry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 技能注册表
+ *
+ * 管理所有已注册的技能
+ * 按任务类型和权限级别匹配技能
+ */
+import type { PermissionLevel } from '../types/agent.js';
+import type { Task } from '../types/task.js';
+import type { Skill, SkillMetadata, SkillState } from './types.js';
+export declare class SkillRegistry {
+    private logger;
+    private skills;
+    /**
+     * 注册技能
+     */
+    register(skill: Skill): void;
+    /**
+     * 注销技能
+     */
+    unregister(name: string): boolean;
+    /**
+     * 初始化所有技能
+     */
+    initializeAll(): Promise<{
+        success: number;
+        failed: number;
+    }>;
+    /**
+     * 获取技能
+     */
+    getSkill(name: string): Skill | undefined;
+    /**
+     * 获取适用于指定任务和权限级别的技能列表
+     */
+    getApplicableSkills(task: Task, permissionLevel: PermissionLevel): Skill[];
+    /**
+     * 获取技能的元数据列表
+     */
+    getAllMetadata(): SkillMetadata[];
+    /**
+     * 获取技能名称列表
+     */
+    getSkillNames(): string[];
+    /**
+     * 获取技能状态
+     */
+    getSkillState(name: string): SkillState | undefined;
+    /**
+     * 检查技能是否存在
+     */
+    hasSkill(name: string): boolean;
+    /**
+     * 获取所有技能提供的工具（合并到工具注册表）
+     */
+    getToolsFromAllSkills(permissionLevel: PermissionLevel): Array<{
+        tool: import('../types/agent.js').ToolDefinition;
+        skillName: string;
+    }>;
+    /**
+     * 获取技能提供的工具执行器
+     */
+    getToolExecutor(toolName: string): {
+        executor: import('../types/agent.js').ToolExecutorFn;
+        skillName: string;
+    } | undefined;
+    /**
+     * 获取技能系统提示附加内容
+     */
+    getSystemPromptAddons(permissionLevel: PermissionLevel): string[];
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        total: number;
+        byState: Record<SkillState, number>;
+        byLevel: Record<PermissionLevel, number>;
+    };
+    /**
+     * 清理所有技能
+     */
+    disposeAll(): Promise<void>;
+}
+//# sourceMappingURL=skill-registry.d.ts.map

package/dist/skills/skill-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/skills/skill-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EACV,KAAK,EAAqB,aAAa,EAAE,UAAU,EACpD,MAAM,YAAY,CAAC;AAQpB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAwC;IAEtD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAe5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWjC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBnE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,GAAG,KAAK,EAAE;IAsB1E;;OAEG;IACH,cAAc,IAAI,aAAa,EAAE;IAIjC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAInD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,qBAAqB,CAAC,eAAe,EAAE,eAAe,GAAG,KAAK,CAAC;QAC7D,IAAI,EAAE,OAAO,mBAAmB,EAAE,cAAc,CAAC;QACjD,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAmBF;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,mBAAmB,EAAE,cAAc,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAW1H;;OAEG;IACH,qBAAqB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,EAAE;IAgBjE;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;KAC1C;IAgBD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAYlC"}

package/dist/skills/skill-registry.js

@@ -0,0 +1,206 @@
+/**
+ * 技能注册表
+ *
+ * 管理所有已注册的技能
+ * 按任务类型和权限级别匹配技能
+ */
+import { createLogger } from '../core/logger.js';
+const LEVEL_ORDER = ['read_only', 'limited', 'standard', 'elevated'];
+function levelIndex(level) {
+    return LEVEL_ORDER.indexOf(level);
+}
+export class SkillRegistry {
+    logger = createLogger('SkillRegistry');
+    skills = new Map();
+    /**
+     * 注册技能
+     */
+    register(skill) {
+        const name = skill.metadata.name;
+        if (this.skills.has(name)) {
+            this.logger.warn(`技能 "${name}" 已存在，将被覆盖`);
+        }
+        this.skills.set(name, {
+            skill,
+            registeredAt: Date.now(),
+            state: 'loaded',
+        });
+        this.logger.debug(`注册技能: ${name} (权限: ${skill.metadata.requiredLevel})`);
+    }
+    /**
+     * 注销技能
+     */
+    unregister(name) {
+        const reg = this.skills.get(name);
+        if (reg) {
+            // 调用清理
+            reg.skill.dispose?.().catch(err => {
+                this.logger.warn(`清理技能 "${name}" 失败`, err.message);
+            });
+        }
+        return this.skills.delete(name);
+    }
+    /**
+     * 初始化所有技能
+     */
+    async initializeAll() {
+        let success = 0;
+        let failed = 0;
+        for (const [name, reg] of this.skills) {
+            try {
+                if (reg.skill.init) {
+                    await reg.skill.init();
+                    reg.state = 'initialized';
+                }
+                reg.state = 'ready';
+                success++;
+            }
+            catch (err) {
+                reg.state = 'error';
+                reg.error = err.message;
+                failed++;
+                this.logger.error(`技能 "${name}" 初始化失败`, err.message);
+            }
+        }
+        this.logger.info(`技能初始化完成: ${success} 成功, ${failed} 失败`);
+        return { success, failed };
+    }
+    /**
+     * 获取技能
+     */
+    getSkill(name) {
+        return this.skills.get(name)?.skill;
+    }
+    /**
+     * 获取适用于指定任务和权限级别的技能列表
+     */
+    getApplicableSkills(task, permissionLevel) {
+        const threshold = levelIndex(permissionLevel);
+        return [...this.skills.values()]
+            .filter(reg => {
+            if (reg.state !== 'ready')
+                return false;
+            const meta = reg.skill.metadata;
+            // 权限检查
+            if (levelIndex(meta.requiredLevel) > threshold)
+                return false;
+            // 任务类型检查（空数组表示适用所有类型）
+            if (meta.applicableTaskTypes.length > 0 &&
+                !meta.applicableTaskTypes.includes(task.taskType)) {
+                return false;
+            }
+            return true;
+        })
+            .map(reg => reg.skill);
+    }
+    /**
+     * 获取技能的元数据列表
+     */
+    getAllMetadata() {
+        return [...this.skills.values()].map(reg => reg.skill.metadata);
+    }
+    /**
+     * 获取技能名称列表
+     */
+    getSkillNames() {
+        return [...this.skills.keys()];
+    }
+    /**
+     * 获取技能状态
+     */
+    getSkillState(name) {
+        return this.skills.get(name)?.state;
+    }
+    /**
+     * 检查技能是否存在
+     */
+    hasSkill(name) {
+        return this.skills.has(name);
+    }
+    /**
+     * 获取所有技能提供的工具（合并到工具注册表）
+     */
+    getToolsFromAllSkills(permissionLevel) {
+        const threshold = levelIndex(permissionLevel);
+        const result = [];
+        for (const [name, reg] of this.skills) {
+            if (reg.state !== 'ready')
+                continue;
+            if (levelIndex(reg.skill.metadata.requiredLevel) > threshold)
+                continue;
+            const tools = reg.skill.tools || [];
+            for (const tool of tools) {
+                if (levelIndex(tool.requiredLevel) <= threshold) {
+                    result.push({ tool, skillName: name });
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 获取技能提供的工具执行器
+     */
+    getToolExecutor(toolName) {
+        for (const [name, reg] of this.skills) {
+            if (reg.state !== 'ready')
+                continue;
+            const executors = reg.skill.toolExecutors || {};
+            if (toolName in executors) {
+                return { executor: executors[toolName], skillName: name };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * 获取技能系统提示附加内容
+     */
+    getSystemPromptAddons(permissionLevel) {
+        const threshold = levelIndex(permissionLevel);
+        const addons = [];
+        for (const reg of this.skills.values()) {
+            if (reg.state !== 'ready')
+                continue;
+            if (levelIndex(reg.skill.metadata.requiredLevel) > threshold)
+                continue;
+            if (reg.skill.getSystemPromptAddon) {
+                const addon = reg.skill.getSystemPromptAddon();
+                if (addon)
+                    addons.push(addon);
+            }
+        }
+        return addons;
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        const byState = {
+            loaded: 0, initialized: 0, ready: 0, error: 0,
+        };
+        const byLevel = {
+            read_only: 0, limited: 0, standard: 0, elevated: 0,
+        };
+        for (const reg of this.skills.values()) {
+            byState[reg.state]++;
+            byLevel[reg.skill.metadata.requiredLevel]++;
+        }
+        return { total: this.skills.size, byState, byLevel };
+    }
+    /**
+     * 清理所有技能
+     */
+    async disposeAll() {
+        for (const [name, reg] of this.skills) {
+            try {
+                if (reg.skill.dispose) {
+                    await reg.skill.dispose();
+                }
+            }
+            catch (err) {
+                this.logger.warn(`清理技能 "${name}" 失败`, err.message);
+            }
+        }
+        this.skills.clear();
+    }
+}
+//# sourceMappingURL=skill-registry.js.map