js-agent-core 1.0.1

package/dist/core/logging/index.js

@@ -0,0 +1,33 @@
+export class LoggerFactory {
+    /**
+     * 根据当前运行环境创建默认的持久化日志记录器
+     */
+    static async createDefaultLogger() {
+        // 1. 探测 Node.js 环境
+        if (typeof process !== 'undefined' && process.versions?.node) {
+            try {
+                const { NodeFsLogger } = await import('./NodeFsLogger.js');
+                return new NodeFsLogger();
+            }
+            catch (e) {
+                console.warn('Failed to initialize NodeFsLogger, falling back to console:', e);
+            }
+        }
+        // 2. 探测浏览器环境 (支持 IndexedDB)
+        if (typeof window !== 'undefined' && typeof indexedDB !== 'undefined') {
+            try {
+                const { WebIndexedDbLogger } = await import('./WebIndexedDbLogger.js');
+                return new WebIndexedDbLogger();
+            }
+            catch (e) {
+                console.warn('Failed to initialize WebIndexedDbLogger, falling back to console:', e);
+            }
+        }
+        // 3. 回退逻辑：如果没有任何持久化环境（如某些极简 Sandbox），返回 null，BaseAgent 会默认使用 console
+        return null;
+    }
+}
+export * from './NodeFsLogger.js';
+export * from './WebIndexedDbLogger.js';
+export * from './CompositeLogger.js';
+//# sourceMappingURL=index.js.map

package/dist/core/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/logging/index.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,mBAAmB;QAC9B,mBAAmB;QACnB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7D,IAAI,CAAC;gBACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;gBAC3D,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,6DAA6D,EAAE,CAAC,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;YACtE,IAAI,CAAC;gBACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;gBACvE,OAAO,IAAI,kBAAkB,EAAE,CAAC;YAClC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,mEAAmE,EAAE,CAAC,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/core/persistence/NodeFsSkillStore.d.ts

@@ -0,0 +1,17 @@
+import { ISkillStore, SkillFile, SkillMetadata } from '../../interfaces/index.js';
+/**
+ * 后端实现：基于文件系统的目录隔离存储
+ */
+export declare class NodeFsSkillStore implements ISkillStore {
+    private baseDir;
+    constructor(baseDir?: string);
+    private initDefaultDir;
+    private ensureDir;
+    private getSkillDir;
+    saveSkill(metadata: SkillMetadata, files: SkillFile[]): Promise<void>;
+    getSkillFiles(skillName: string): Promise<SkillFile[]>;
+    getSkillMetadata(skillName: string): Promise<SkillMetadata | null>;
+    listSkills(): Promise<SkillMetadata[]>;
+    deleteSkill(skillName: string): Promise<void>;
+}
+//# sourceMappingURL=NodeFsSkillStore.d.ts.map

package/dist/core/persistence/NodeFsSkillStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeFsSkillStore.d.ts","sourceRoot":"","sources":["../../../src/core/persistence/NodeFsSkillStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAElF;;GAEG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IACtC,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,MAAW;YAO1B,cAAc;YAOd,SAAS;YAST,WAAW;IAKnB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BrE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAuCtD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAalE,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASpD"}

package/dist/core/persistence/NodeFsSkillStore.js

@@ -0,0 +1,124 @@
+/**
+ * 后端实现：基于文件系统的目录隔离存储
+ */
+export class NodeFsSkillStore {
+    baseDir;
+    constructor(baseDir = '') {
+        this.baseDir = baseDir;
+        if (!this.baseDir) {
+            // 延迟加载 path 以避免浏览器报错
+            this.initDefaultDir();
+        }
+    }
+    async initDefaultDir() {
+        if (typeof process !== 'undefined' && process.versions?.node) {
+            const path = await import('path');
+            this.baseDir = path.join(process.cwd(), 'storage', 'skills');
+        }
+    }
+    async ensureDir(dir) {
+        const fs = await import('fs/promises');
+        try {
+            await fs.access(dir);
+        }
+        catch {
+            await fs.mkdir(dir, { recursive: true });
+        }
+    }
+    async getSkillDir(skillName) {
+        const path = await import('path');
+        return path.join(this.baseDir, skillName);
+    }
+    async saveSkill(metadata, files) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const skillDir = await this.getSkillDir(metadata.name);
+        await this.ensureDir(skillDir);
+        // 1. 保存元数据
+        const metaPath = path.join(skillDir, 'metadata.json');
+        await fs.writeFile(metaPath, JSON.stringify(metadata, null, 2), 'utf-8');
+        // 2. 保存所有文件
+        for (const file of files) {
+            const filePath = path.join(skillDir, file.path);
+            const fileDir = path.dirname(filePath);
+            await this.ensureDir(fileDir);
+            if (typeof file.content === 'string') {
+                await fs.writeFile(filePath, file.content, 'utf-8');
+            }
+            else {
+                // Uint8Array is directly supported by fs.writeFile in Node.js
+                await fs.writeFile(filePath, file.content);
+            }
+        }
+    }
+    async getSkillFiles(skillName) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const skillDir = await this.getSkillDir(skillName);
+        const files = [];
+        const readDirRecursive = async (currentDir, relativePath = '') => {
+            const entries = await fs.readdir(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(currentDir, entry.name);
+                const relPath = path.join(relativePath, entry.name);
+                if (entry.name === 'metadata.json' && relativePath === '')
+                    continue; // 跳过元数据文件
+                if (entry.isDirectory()) {
+                    await readDirRecursive(fullPath, relPath);
+                }
+                else {
+                    const buffer = await fs.readFile(fullPath);
+                    // Convert Buffer to Uint8Array to satisfy the interface
+                    const content = new Uint8Array(buffer);
+                    files.push({
+                        path: relPath,
+                        content: content
+                    });
+                }
+            }
+        };
+        try {
+            await readDirRecursive(skillDir);
+        }
+        catch (e) {
+            console.error(`Failed to read files for skill ${skillName}:`, e);
+        }
+        return files;
+    }
+    async getSkillMetadata(skillName) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const metaPath = path.join(await this.getSkillDir(skillName), 'metadata.json');
+        try {
+            const content = await fs.readFile(metaPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async listSkills() {
+        const fs = await import('fs/promises');
+        await this.ensureDir(this.baseDir);
+        const skillNames = await fs.readdir(this.baseDir);
+        const results = [];
+        for (const name of skillNames) {
+            const meta = await this.getSkillMetadata(name);
+            if (meta) {
+                results.push(meta);
+            }
+        }
+        return results;
+    }
+    async deleteSkill(skillName) {
+        const fs = await import('fs/promises');
+        const skillDir = await this.getSkillDir(skillName);
+        try {
+            await fs.rm(skillDir, { recursive: true, force: true });
+        }
+        catch (e) {
+            console.error(`Failed to delete skill ${skillName}:`, e);
+        }
+    }
+}
+//# sourceMappingURL=NodeFsSkillStore.js.map

package/dist/core/persistence/NodeFsSkillStore.js.map

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

package/dist/core/persistence/NodeFsVectorStore.d.ts

@@ -0,0 +1,25 @@
+import { IVectorStore } from '../../interfaces/index.js';
+export interface NodeFsVectorStoreOptions {
+    storagePath?: string;
+}
+export declare class NodeFsVectorStore implements IVectorStore {
+    private items;
+    private storagePath;
+    constructor(options?: NodeFsVectorStoreOptions);
+    private ensureDirectory;
+    private load;
+    private save;
+    add(text: string, embedding: number[], metadata?: Record<string, any>): Promise<void>;
+    search(queryEmbedding: number[], topK?: number): Promise<Array<{
+        text: string;
+        score: number;
+        metadata?: Record<string, any>;
+    }>>;
+    searchByKeyword(keyword: string, topK?: number): Promise<Array<{
+        text: string;
+        score: number;
+        metadata?: Record<string, any>;
+    }>>;
+    private cosineSimilarity;
+}
+//# sourceMappingURL=NodeFsVectorStore.d.ts.map

package/dist/core/persistence/NodeFsVectorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeFsVectorStore.d.ts","sourceRoot":"","sources":["../../../src/core/persistence/NodeFsVectorStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,KAAK,CAAoF;IACjG,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,wBAA6B;YAIpC,eAAe;YASf,IAAI;YASJ,IAAI;IAKZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrF,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAanI,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAczI,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/core/persistence/NodeFsVectorStore.js

@@ -0,0 +1,74 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export class NodeFsVectorStore {
+    items = [];
+    storagePath;
+    constructor(options = {}) {
+        this.storagePath = options.storagePath || path.join(process.cwd(), '.agent_data', 'vector_store.json');
+    }
+    async ensureDirectory() {
+        const dir = path.dirname(this.storagePath);
+        try {
+            await fs.access(dir);
+        }
+        catch {
+            await fs.mkdir(dir, { recursive: true });
+        }
+    }
+    async load() {
+        try {
+            const data = await fs.readFile(this.storagePath, 'utf-8');
+            this.items = JSON.parse(data);
+        }
+        catch {
+            this.items = [];
+        }
+    }
+    async save() {
+        await this.ensureDirectory();
+        await fs.writeFile(this.storagePath, JSON.stringify(this.items, null, 2), 'utf-8');
+    }
+    async add(text, embedding, metadata) {
+        await this.load();
+        this.items.push({ text, embedding, metadata });
+        await this.save();
+    }
+    async search(queryEmbedding, topK = 3) {
+        await this.load();
+        const scoredItems = this.items.map(item => ({
+            ...item,
+            score: this.cosineSimilarity(queryEmbedding, item.embedding)
+        }));
+        return scoredItems
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK)
+            .map(({ text, score, metadata }) => ({ text, score, metadata }));
+    }
+    async searchByKeyword(keyword, topK = 3) {
+        await this.load();
+        const lowKeyword = keyword.toLowerCase();
+        return this.items
+            .filter(item => item.text.toLowerCase().includes(lowKeyword))
+            .map(item => ({
+            text: item.text,
+            score: 1.0,
+            metadata: item.metadata
+        }))
+            .slice(0, topK);
+    }
+    cosineSimilarity(vecA, vecB) {
+        if (vecA.length !== vecB.length)
+            return 0;
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < vecA.length; i++) {
+            dotProduct += vecA[i] * vecB[i];
+            normA += vecA[i] * vecA[i];
+            normB += vecB[i] * vecB[i];
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        return magnitude === 0 ? 0 : dotProduct / magnitude;
+    }
+}
+//# sourceMappingURL=NodeFsVectorStore.js.map

package/dist/core/persistence/NodeFsVectorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeFsVectorStore.js","sourceRoot":"","sources":["../../../src/core/persistence/NodeFsVectorStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAM7B,MAAM,OAAO,iBAAiB;IACpB,KAAK,GAAiF,EAAE,CAAC;IACzF,WAAW,CAAS;IAE5B,YAAY,UAAoC,EAAE;QAChD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;IACzG,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,SAAmB,EAAE,QAA8B;QACzE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,cAAwB,EAAE,OAAe,CAAC;QACrD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1C,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC;SAC7D,CAAC,CAAC,CAAC;QAEJ,OAAO,WAAW;aACf,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;aACd,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,OAAe,CAAC;QACrD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAEzC,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;aAC5D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;aACF,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpB,CAAC;IAEO,gBAAgB,CAAC,IAAc,EAAE,IAAc;QACrD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;IACtD,CAAC;CACF"}

package/dist/core/persistence/SkillLoader.d.ts

@@ -0,0 +1,26 @@
+import { ISkill, SkillFile, SkillMetadata } from '../../interfaces/index.js';
+/**
+ * 环境感知型技能加载器
+ */
+export declare class SkillLoader {
+    /**
+     * 将技能代码和元数据转化为可执行的 ISkill 或 ITool
+     * @param metadata 技能元数据
+     * @param files 技能文件列表
+     * @param baseDir 可选的基础目录 (用于 Node.js 子进程定位文件)
+     */
+    static load(metadata: SkillMetadata, files: SkillFile[], baseDir?: string): Promise<ISkill>;
+    /**
+     * 加载 JavaScript 技能
+     */
+    private static loadJavascript;
+    /**
+     * 加载脚本代理 (Python, Bash)
+     */
+    private static loadScriptProxy;
+    /**
+     * 加载 WebAssembly 技能 (示意实现)
+     */
+    private static loadWasm;
+}
+//# sourceMappingURL=SkillLoader.d.ts.map

package/dist/core/persistence/SkillLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillLoader.d.ts","sourceRoot":"","sources":["../../../src/core/persistence/SkillLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAS,SAAS,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGpF;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;OAKG;WACU,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBjG;;OAEG;mBACkB,cAAc;IAqCnC;;OAEG;mBACkB,eAAe;IA8CpC;;OAEG;mBACkB,QAAQ;CA4B9B"}

package/dist/core/persistence/SkillLoader.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+/**
+ * 环境感知型技能加载器
+ */
+export class SkillLoader {
+    /**
+     * 将技能代码和元数据转化为可执行的 ISkill 或 ITool
+     * @param metadata 技能元数据
+     * @param files 技能文件列表
+     * @param baseDir 可选的基础目录 (用于 Node.js 子进程定位文件)
+     */
+    static async load(metadata, files, baseDir) {
+        const isWeb = typeof window !== 'undefined';
+        switch (metadata.runtime) {
+            case 'javascript':
+                return await this.loadJavascript(metadata, files, baseDir);
+            case 'python':
+            case 'bash':
+                if (isWeb) {
+                    throw new Error(`Runtime ${metadata.runtime} is not supported in the browser.`);
+                }
+                return await this.loadScriptProxy(metadata, files, baseDir);
+            case 'wasm':
+                return await this.loadWasm(metadata, files);
+            default:
+                throw new Error(`Unsupported runtime: ${metadata.runtime}`);
+        }
+    }
+    /**
+     * 加载 JavaScript 技能
+     */
+    static async loadJavascript(metadata, files, baseDir) {
+        const entryFile = files.find(f => f.path === metadata.entry);
+        if (!entryFile)
+            throw new Error(`Entry file ${metadata.entry} not found.`);
+        if (typeof window !== 'undefined') {
+            // Web 环境: 使用 Blob URL
+            const code = typeof entryFile.content === 'string'
+                ? entryFile.content
+                : new TextDecoder().decode(entryFile.content);
+            const blob = new Blob([code], { type: 'text/javascript' });
+            const url = URL.createObjectURL(blob);
+            try {
+                const module = await import(url);
+                return module.default || module;
+            }
+            finally {
+                URL.revokeObjectURL(url);
+            }
+        }
+        else {
+            // Node.js 环境: 优先从磁盘路径加载 (支持断点调试和完整模块解析)
+            if (baseDir) {
+                const path = await import('path');
+                const fullPath = path.join(baseDir, metadata.name, metadata.entry);
+                const module = await import(`file://${fullPath}`);
+                return module.default || module;
+            }
+            // 如果没有 baseDir (如内存模式)，回退到 data URI
+            const code = typeof entryFile.content === 'string'
+                ? entryFile.content
+                : new TextDecoder().decode(entryFile.content);
+            const base64Code = Buffer.from(code).toString('base64');
+            const dataUri = `data:text/javascript;base64,${base64Code}`;
+            const module = await import(dataUri);
+            return module.default || module;
+        }
+    }
+    /**
+     * 加载脚本代理 (Python, Bash)
+     */
+    static async loadScriptProxy(metadata, files, baseDir) {
+        const { spawn } = await import('child_process');
+        const path = await import('path');
+        // 脚本代理 Skill
+        return {
+            name: metadata.name,
+            description: metadata.description,
+            tools: [{
+                    name: metadata.name,
+                    description: metadata.description,
+                    parameters: metadata.parameters || z.any(),
+                    execute: async (params) => {
+                        const scriptPath = path.join(baseDir, metadata.name, metadata.entry);
+                        return new Promise((resolve) => {
+                            const runtime = metadata.runtime === 'python' ? 'python3' : 'bash';
+                            const child = spawn(runtime, [scriptPath]);
+                            // 发送参数
+                            child.stdin.write(JSON.stringify(params));
+                            child.stdin.end();
+                            let stdout = '';
+                            let stderr = '';
+                            child.stdout.on('data', (data) => stdout += data);
+                            child.stderr.on('data', (data) => stderr += data);
+                            child.on('close', (code) => {
+                                if (code !== 0) {
+                                    resolve({ success: false, error: `Script exited with code ${code}: ${stderr}` });
+                                }
+                                else {
+                                    try {
+                                        const result = JSON.parse(stdout);
+                                        resolve({ success: true, data: result });
+                                    }
+                                    catch {
+                                        resolve({ success: true, data: stdout.trim() });
+                                    }
+                                }
+                            });
+                        });
+                    }
+                }]
+        };
+    }
+    /**
+     * 加载 WebAssembly 技能 (示意实现)
+     */
+    static async loadWasm(metadata, files) {
+        const entryFile = files.find(f => f.path === metadata.entry);
+        if (!entryFile)
+            throw new Error(`WASM entry ${metadata.entry} not found.`);
+        const buffer = typeof entryFile.content === 'string'
+            ? new TextEncoder().encode(entryFile.content)
+            : entryFile.content;
+        const wasmModule = await WebAssembly.instantiate(buffer);
+        const exports = wasmModule.instance?.exports || wasmModule.exports;
+        return {
+            name: metadata.name,
+            description: metadata.description,
+            tools: [{
+                    name: metadata.name,
+                    description: metadata.description,
+                    parameters: z.any(),
+                    execute: async (params) => {
+                        // 根据 WASM 导出函数执行逻辑
+                        if (exports.run) {
+                            return { success: true, data: exports.run(params) };
+                        }
+                        return { success: false, error: 'WASM module has no run() export' };
+                    }
+                }]
+        };
+    }
+}
+//# sourceMappingURL=SkillLoader.js.map

package/dist/core/persistence/SkillLoader.js.map

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

package/dist/core/persistence/WebIndexedDbSkillStore.d.ts

@@ -0,0 +1,21 @@
+import { ISkillStore, SkillFile, SkillMetadata } from '../../interfaces/index.js';
+/**
+ * 前端实现：基于 IndexedDB 的持久化存储
+ * 数据库名: JS_AGENT_DB
+ * Store 1: skill_metadata (Key: name)
+ * Store 2: skill_files (Key: [skillName, filePath])
+ */
+export declare class WebIndexedDbSkillStore implements ISkillStore {
+    private dbName;
+    private metaStore;
+    private fileStore;
+    private db;
+    constructor();
+    private getDB;
+    saveSkill(metadata: SkillMetadata, files: SkillFile[]): Promise<void>;
+    getSkillFiles(skillName: string): Promise<SkillFile[]>;
+    getSkillMetadata(skillName: string): Promise<SkillMetadata | null>;
+    listSkills(): Promise<SkillMetadata[]>;
+    deleteSkill(skillName: string): Promise<void>;
+}
+//# sourceMappingURL=WebIndexedDbSkillStore.d.ts.map

package/dist/core/persistence/WebIndexedDbSkillStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebIndexedDbSkillStore.d.ts","sourceRoot":"","sources":["../../../src/core/persistence/WebIndexedDbSkillStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,EAAE,CAA4B;;YAQxB,KAAK;IAyBb,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAwBtD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAWlE,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAWtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAwBpD"}

package/dist/core/persistence/WebIndexedDbSkillStore.js

@@ -0,0 +1,119 @@
+/**
+ * 前端实现：基于 IndexedDB 的持久化存储
+ * 数据库名: JS_AGENT_DB
+ * Store 1: skill_metadata (Key: name)
+ * Store 2: skill_files (Key: [skillName, filePath])
+ */
+export class WebIndexedDbSkillStore {
+    dbName = 'JS_AGENT_DB';
+    metaStore = 'skill_metadata';
+    fileStore = 'skill_files';
+    db = null;
+    constructor() {
+        if (typeof indexedDB === 'undefined') {
+            console.warn('IndexedDB is not supported in this environment.');
+        }
+    }
+    async getDB() {
+        if (this.db)
+            return this.db;
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(this.dbName, 1);
+            request.onupgradeneeded = (event) => {
+                const db = event.target.result;
+                if (!db.objectStoreNames.contains(this.metaStore)) {
+                    db.createObjectStore(this.metaStore, { keyPath: 'name' });
+                }
+                if (!db.objectStoreNames.contains(this.fileStore)) {
+                    db.createObjectStore(this.fileStore, { keyPath: ['skillName', 'path'] });
+                }
+            };
+            request.onsuccess = (event) => {
+                this.db = event.target.result;
+                resolve(this.db);
+            };
+            request.onerror = (event) => reject(event.target.error);
+        });
+    }
+    async saveSkill(metadata, files) {
+        const db = await this.getDB();
+        const tx = db.transaction([this.metaStore, this.fileStore], 'readwrite');
+        // 1. 保存元数据
+        tx.objectStore(this.metaStore).put(metadata);
+        // 2. 保存文件 (批量写入)
+        const fileStore = tx.objectStore(this.fileStore);
+        for (const file of files) {
+            fileStore.put({
+                skillName: metadata.name,
+                path: file.path,
+                content: file.content
+            });
+        }
+        return new Promise((resolve, reject) => {
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async getSkillFiles(skillName) {
+        const db = await this.getDB();
+        const tx = db.transaction(this.fileStore, 'readonly');
+        const store = tx.objectStore(this.fileStore);
+        const index = store.openCursor(IDBKeyRange.bound([skillName, ''], [skillName, '\uffff']));
+        const files = [];
+        return new Promise((resolve, reject) => {
+            index.onsuccess = (event) => {
+                const cursor = event.target.result;
+                if (cursor) {
+                    files.push({
+                        path: cursor.value.path,
+                        content: cursor.value.content
+                    });
+                    cursor.continue();
+                }
+                else {
+                    resolve(files);
+                }
+            };
+            index.onerror = () => reject(tx.error);
+        });
+    }
+    async getSkillMetadata(skillName) {
+        const db = await this.getDB();
+        const tx = db.transaction(this.metaStore, 'readonly');
+        const request = tx.objectStore(this.metaStore).get(skillName);
+        return new Promise((resolve, reject) => {
+            request.onsuccess = () => resolve(request.result || null);
+            request.onerror = () => reject(tx.error);
+        });
+    }
+    async listSkills() {
+        const db = await this.getDB();
+        const tx = db.transaction(this.metaStore, 'readonly');
+        const request = tx.objectStore(this.metaStore).getAll();
+        return new Promise((resolve, reject) => {
+            request.onsuccess = () => resolve(request.result || []);
+            request.onerror = () => reject(tx.error);
+        });
+    }
+    async deleteSkill(skillName) {
+        const db = await this.getDB();
+        const tx = db.transaction([this.metaStore, this.fileStore], 'readwrite');
+        // 1. 删除元数据
+        tx.objectStore(this.metaStore).delete(skillName);
+        // 2. 删除所有关联文件
+        const fileStore = tx.objectStore(this.fileStore);
+        const index = fileStore.openCursor(IDBKeyRange.bound([skillName, ''], [skillName, '\uffff']));
+        index.onsuccess = (event) => {
+            const cursor = event.target.result;
+            if (cursor) {
+                cursor.delete();
+                cursor.continue();
+            }
+        };
+        return new Promise((resolve, reject) => {
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+}
+//# sourceMappingURL=WebIndexedDbSkillStore.js.map

package/dist/core/persistence/WebIndexedDbSkillStore.js.map

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