js-agent-core 1.0.1

package/dist/core/AutoVectorStore.js

@@ -0,0 +1,55 @@
+import { MemoryVectorStore } from './MemoryVectorStore.js';
+/**
+ * A proxy that dynamically loads the appropriate VectorStore implementation
+ * based on the runtime environment (Node.js vs Browser).
+ */
+export class AutoVectorStore {
+    instance = null;
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async getInstance() {
+        if (this.instance)
+            return this.instance;
+        const isNode = typeof process !== 'undefined' && process.versions?.node;
+        const isBrowser = typeof window !== 'undefined' && typeof indexedDB !== 'undefined';
+        try {
+            if (isNode) {
+                // Node.js: Dynamic import NodeFsVectorStore
+                const { NodeFsVectorStore } = await import('./persistence/NodeFsVectorStore.js');
+                this.instance = new NodeFsVectorStore(this.options);
+            }
+            else if (isBrowser) {
+                // Browser: Use WebIndexedDbVectorStore (already exported from persistence/index.js)
+                const { WebIndexedDbVectorStore } = await import('./persistence/WebIndexedDbVectorStore.js');
+                this.instance = new WebIndexedDbVectorStore(this.options);
+            }
+            else {
+                // Fallback: In-memory store
+                this.instance = new MemoryVectorStore();
+            }
+        }
+        catch (error) {
+            console.warn('Failed to load environment-specific VectorStore, falling back to MemoryVectorStore', error);
+            this.instance = new MemoryVectorStore();
+        }
+        return this.instance;
+    }
+    async add(text, embedding, metadata) {
+        const instance = await this.getInstance();
+        return instance.add(text, embedding, metadata);
+    }
+    async search(queryEmbedding, topK) {
+        const instance = await this.getInstance();
+        return instance.search(queryEmbedding, topK);
+    }
+    async searchByKeyword(keyword, topK) {
+        const instance = await this.getInstance();
+        if (instance.searchByKeyword) {
+            return instance.searchByKeyword(keyword, topK);
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=AutoVectorStore.js.map

package/dist/core/AutoVectorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoVectorStore.js","sourceRoot":"","sources":["../../src/core/AutoVectorStore.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAwB,IAAI,CAAC;IACrC,OAAO,CAAM;IAErB,YAAY,UAAe,EAAE;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QAExC,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;QACxE,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,SAAS,KAAK,WAAW,CAAC;QAEpF,IAAI,CAAC;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,4CAA4C;gBAC5C,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;gBACjF,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACrB,oFAAoF;gBACpF,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,0CAA0C,CAAC,CAAC;gBAC7F,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,4BAA4B;gBAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,oFAAoF,EAAE,KAAK,CAAC,CAAC;YAC1G,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC1C,CAAC;QAED,OAAO,IAAI,CAAC,QAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,SAAmB,EAAE,QAA8B;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,cAAwB,EAAE,IAAa;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,IAAa;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/core/BaseAgent.d.ts

@@ -0,0 +1,70 @@
+import { IAgentEvent, ISkill, ITool, ILLMProvider, LLMMessage, IMemory, IPlanner, IAgentState, ISkillStore, SkillFile, SkillMetadata, ILogger } from '../interfaces/index.js';
+export interface AgentOptions {
+    provider: ILLMProvider;
+    model: string;
+    systemPrompt?: string;
+    memory?: IMemory;
+    planner?: IPlanner;
+    maxIterations?: number;
+    enableDynamicSkills?: boolean;
+    routerModel?: string;
+    skillStore?: ISkillStore;
+    stream?: boolean;
+    logger?: ILogger;
+    agentId?: string;
+}
+export declare class BaseAgent {
+    private eventEmitter;
+    private toolRegistry;
+    private provider;
+    private memory;
+    private planner;
+    private model;
+    private routerModel?;
+    private maxIterations;
+    private enableDynamicSkills;
+    private skillStore?;
+    private stream;
+    private logger?;
+    private agentId;
+    private currentTraceId?;
+    private skills;
+    private registeredSkills;
+    private activeSkills;
+    private currentTaskList?;
+    constructor(options: AgentOptions);
+    private initDefaultLogger;
+    registerSkill(skill: ISkill): void;
+    /**
+     * 持久化保存一个新技能并自动注册
+     */
+    saveSkill(metadata: SkillMetadata, files: SkillFile[]): Promise<void>;
+    /**
+     * 从存储中加载所有已保存的技能
+     */
+    loadStoredSkills(): Promise<void>;
+    use(skill: ISkill): Promise<void>;
+    registerTool(tool: ITool): void;
+    on<T = any>(event: IAgentEvent['type'], listener: (payload: T) => void): void;
+    getHistory(): Promise<LLMMessage[]>;
+    getMemoryUsage(): Promise<{
+        used: number;
+        total: number;
+    }>;
+    exportState(): Promise<IAgentState>;
+    /**
+     * 恢复 Agent 状态 (从快照中恢复)
+     * @param state 导出的状态快照
+     * @param availableSkills 可用的技能定义列表 (因为函数逻辑无法序列化，需手动提供)
+     * @param availableTools 可用的工具定义列表 (可选)
+     */
+    restoreState(state: IAgentState, availableSkills?: ISkill[], availableTools?: ITool[]): Promise<void>;
+    run(input: string, options?: {
+        traceId?: string;
+    }): Promise<string>;
+    private emit;
+    private log;
+    private addToMemory;
+    private selectAndActivateSkills;
+}
+//# sourceMappingURL=BaseAgent.d.ts.map

package/dist/core/BaseAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAgent.d.ts","sourceRoot":"","sources":["../../src/core/BaseAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAe,QAAQ,EAAY,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAwB,MAAM,wBAAwB,CAAC;AAa1O,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAC,CAAU;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,eAAe,CAAC,CAAW;gBAEvB,OAAO,EAAE,YAAY;YA+BnB,iBAAiB;IAM/B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3E;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvC,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAI/B,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAIvE,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAInC,cAAc,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO1D,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAsBzC;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,eAAe,GAAE,MAAM,EAAO,EAAE,cAAc,GAAE,KAAK,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C7G,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgXzE,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,GAAG;YAUG,WAAW;YAgBX,uBAAuB;CAgCtC"}