@cicctencent/agent-core 0.1.5 → 0.1.7

package/dist/esm/store/json-store.js

@@ -0,0 +1,236 @@
+// ============================================================
+// JsonStore — 通用 JSON 文件存储引擎
+// 原子写入、读缓存、自动创建目录
+// ============================================================
+import * as fs from 'fs';
+import * as fsp from 'fs/promises';
+import * as path from 'path';
+import { getDataPath, getProjectDataPath, ensureDataDir, ensureProjectDataDir } from "../utils/data-dir.js";
+/**
+ * 通用 JSON 文件存储
+ *
+ * - read(): 读取整个 JSON 文件（带缓存）
+ * - write(): 原子写入（先写 .tmp 再 rename）
+ * - 自动创建父目录
+ */
+export class JsonStore {
+    filePath;
+    cache = null;
+    cacheTime = 0;
+    /** 缓存有效期（毫秒），0 = 永久 */
+    ttl;
+    useProjectDir;
+    constructor(relativePath, ttl = 0, options) {
+        this.useProjectDir = options?.projectLocal ?? false;
+        this.ttl = ttl;
+        if (options?.absolutePath) {
+            this.filePath = options.absolutePath;
+        }
+        else {
+            const basePath = this.useProjectDir
+                ? getProjectDataPath(relativePath)
+                : getDataPath(relativePath);
+            this.filePath = basePath;
+        }
+    }
+    /** 读取 JSON 数据 */
+    read(defaultValue) {
+        if (this.cache !== null && (this.ttl === 0 || Date.now() - this.cacheTime < this.ttl)) {
+            return this.cache;
+        }
+        if (!fs.existsSync(this.filePath)) {
+            this.cache = defaultValue;
+            return defaultValue;
+        }
+        try {
+            const raw = fs.readFileSync(this.filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            this.cache = data;
+            this.cacheTime = Date.now();
+            return data;
+        }
+        catch (e) {
+            console.error(`[JsonStore] read error: ${this.filePath}`, e);
+            return defaultValue;
+        }
+    }
+    /** 原子写入 JSON 数据 */
+    write(data) {
+        this.useProjectDir ? ensureProjectDataDir() : ensureDataDir();
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const tmpPath = this.filePath + '.tmp';
+        const content = JSON.stringify(data, null, 2);
+        try {
+            fs.writeFileSync(tmpPath, content, 'utf-8');
+            try {
+                fs.renameSync(tmpPath, this.filePath);
+            }
+            catch (renameErr) {
+                if (renameErr?.code === 'ENOENT' || renameErr?.code === 'EPERM' || renameErr?.code === 'EBUSY') {
+                    fs.writeFileSync(tmpPath, content, 'utf-8');
+                    try {
+                        fs.renameSync(tmpPath, this.filePath);
+                    }
+                    catch {
+                        fs.writeFileSync(this.filePath, content, 'utf-8');
+                    }
+                }
+                else {
+                    throw renameErr;
+                }
+            }
+        }
+        catch (e) {
+            try {
+                fs.writeFileSync(this.filePath, content, 'utf-8');
+            }
+            catch (directErr) {
+                console.error(`[JsonStore] write failed: ${this.filePath}`, directErr);
+                throw directErr;
+            }
+        }
+        finally {
+            try {
+                if (fs.existsSync(tmpPath))
+                    fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+        }
+        this.cache = data;
+        this.cacheTime = Date.now();
+    }
+    /** 异步读取 JSON 数据 */
+    async readAsync(defaultValue) {
+        if (this.cache !== null && (this.ttl === 0 || Date.now() - this.cacheTime < this.ttl)) {
+            return this.cache;
+        }
+        try {
+            await fsp.access(this.filePath);
+        }
+        catch {
+            this.cache = defaultValue;
+            return defaultValue;
+        }
+        try {
+            const raw = await fsp.readFile(this.filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            this.cache = data;
+            this.cacheTime = Date.now();
+            return data;
+        }
+        catch (e) {
+            console.error(`[JsonStore] readAsync error: ${this.filePath}`, e);
+            return defaultValue;
+        }
+    }
+    /** 异步原子写入 JSON 数据 */
+    async writeAsync(data) {
+        this.useProjectDir ? ensureProjectDataDir() : ensureDataDir();
+        const dir = path.dirname(this.filePath);
+        await fsp.mkdir(dir, { recursive: true });
+        const tmpPath = this.filePath + '.tmp';
+        const content = JSON.stringify(data, null, 2);
+        try {
+            await fsp.writeFile(tmpPath, content, 'utf-8');
+            try {
+                await fsp.rename(tmpPath, this.filePath);
+            }
+            catch (renameErr) {
+                if (renameErr?.code === 'ENOENT' || renameErr?.code === 'EPERM' || renameErr?.code === 'EBUSY') {
+                    await fsp.writeFile(tmpPath, content, 'utf-8');
+                    try {
+                        await fsp.rename(tmpPath, this.filePath);
+                    }
+                    catch {
+                        await fsp.writeFile(this.filePath, content, 'utf-8');
+                    }
+                }
+                else {
+                    throw renameErr;
+                }
+            }
+        }
+        catch (e) {
+            try {
+                await fsp.writeFile(this.filePath, content, 'utf-8');
+            }
+            catch (directErr) {
+                console.error(`[JsonStore] writeAsync failed: ${this.filePath}`, directErr);
+                throw directErr;
+            }
+        }
+        finally {
+            try {
+                await fsp.unlink(tmpPath);
+            }
+            catch { /* ignore */ }
+        }
+        this.cache = data;
+        this.cacheTime = Date.now();
+    }
+    /** 清除缓存，强制下次从文件读取 */
+    invalidate() {
+        this.cache = null;
+        this.cacheTime = 0;
+    }
+    /** 获取文件路径（调试用） */
+    getPath() {
+        return this.filePath;
+    }
+}
+/**
+ * 列表型 JSON 存储（数组）
+ * 提供便捷的 CRUD 方法，内部使用 JsonStore<T[]>
+ */
+export class JsonListStore {
+    store;
+    constructor(relativePath, options) {
+        this.store = new JsonStore(relativePath, 0, options);
+    }
+    list() {
+        return this.store.read([]);
+    }
+    findById(id) {
+        return this.list().find((item) => item.id === id);
+    }
+    add(item) {
+        const list = this.list();
+        list.push(item);
+        this.store.write(list);
+        return item;
+    }
+    update(id, updates) {
+        const list = this.list();
+        const idx = list.findIndex((item) => item.id === id);
+        if (idx === -1)
+            return undefined;
+        list[idx] = { ...list[idx], ...updates };
+        this.store.write(list);
+        return list[idx];
+    }
+    remove(id) {
+        const list = this.list();
+        const filtered = list.filter((item) => item.id !== id);
+        if (filtered.length === list.length)
+            return false;
+        this.store.write(filtered);
+        return true;
+    }
+    filter(predicate) {
+        return this.list().filter(predicate);
+    }
+    maxId() {
+        const list = this.list();
+        return list.reduce((max, item) => Math.max(max, item.id), 0);
+    }
+    getPath() {
+        return this.store.getPath();
+    }
+    replaceAll(data) {
+        this.store.write(data);
+    }
+}
+//# sourceMappingURL=json-store.js.map

package/dist/esm/store/json-store.js.map

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

package/dist/esm/utils/data-dir.d.ts

@@ -0,0 +1,27 @@
+/** 配置应用名（影响全局数据目录路径 ~/{appName}） */
+export declare function setAppName(name: string): void;
+/** 获取当前应用名 */
+export declare function getAppName(): string;
+/**
+ * 获取全局数据目录路径（~/{appName}）
+ * @param subPath 可选的子路径
+ */
+export declare function getDataPath(subPath?: string): string;
+/**
+ * 获取项目级数据目录路径
+ * - 若设置了 WORKAI_WORKSPACE 环境变量，返回工作空间数据目录
+ * - 否则返回 {cwd}/data
+ * 用于日志、消息历史等跟随项目的数据
+ * @param subPath 可选的子路径
+ */
+export declare function getProjectDataPath(subPath?: string): string;
+/** 确保全局数据目录存在 */
+export declare function ensureDataDir(): string;
+/** 确保项目级数据目录存在 */
+export declare function ensureProjectDataDir(): string;
+/**
+ * 解析配置对象中的 ${env.XXX} 占位符，替换为对应的环境变量值。
+ * 例如：{ dbPassword: '${env.DB_PASSWORD}' } → { dbPassword: '实际密码' }
+ */
+export declare function expandEnvVars(obj: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=data-dir.d.ts.map

package/dist/esm/utils/data-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-dir.d.ts","sourceRoot":"","sources":["../../../src/utils/data-dir.ts"],"names":[],"mappings":"AAaA,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,cAAc;AACd,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED,iBAAiB;AACjB,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED,kBAAkB;AAClB,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYnF"}

package/dist/esm/utils/data-dir.js

@@ -0,0 +1,80 @@
+// ============================================================
+// DataDir — 统一数据目录管理（全局 + 项目级）
+// ============================================================
+import * as path from 'path';
+import * as fs from 'fs';
+import * as os from 'os';
+/** 默认全局目录名 */
+const DEFAULT_APP_NAME = '.agent';
+let _appName = DEFAULT_APP_NAME;
+/** 配置应用名（影响全局数据目录路径 ~/{appName}） */
+export function setAppName(name) {
+    _appName = name;
+}
+/** 获取当前应用名 */
+export function getAppName() {
+    return _appName;
+}
+/**
+ * 获取全局数据目录路径（~/{appName}）
+ * @param subPath 可选的子路径
+ */
+export function getDataPath(subPath) {
+    const dataDir = path.join(os.homedir(), _appName);
+    if (subPath) {
+        return path.join(dataDir, subPath);
+    }
+    return dataDir;
+}
+/**
+ * 获取项目级数据目录路径
+ * - 若设置了 WORKAI_WORKSPACE 环境变量，返回工作空间数据目录
+ * - 否则返回 {cwd}/data
+ * 用于日志、消息历史等跟随项目的数据
+ * @param subPath 可选的子路径
+ */
+export function getProjectDataPath(subPath) {
+    // 工作空间模式：数据目录指向工作空间专属目录
+    const wsDir = process.env.WORKAI_WORKSPACE;
+    const dataDir = wsDir ? path.join(wsDir, 'data') : path.join(process.cwd(), 'data');
+    if (subPath) {
+        return path.join(dataDir, subPath);
+    }
+    return dataDir;
+}
+/** 确保全局数据目录存在 */
+export function ensureDataDir() {
+    const dataDir = getDataPath();
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    return dataDir;
+}
+/** 确保项目级数据目录存在 */
+export function ensureProjectDataDir() {
+    const dataDir = getProjectDataPath();
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    return dataDir;
+}
+/**
+ * 解析配置对象中的 ${env.XXX} 占位符，替换为对应的环境变量值。
+ * 例如：{ dbPassword: '${env.DB_PASSWORD}' } → { dbPassword: '实际密码' }
+ */
+export function expandEnvVars(obj) {
+    const result = {};
+    for (const [key, val] of Object.entries(obj)) {
+        if (typeof val === 'string' && val.includes('${env.')) {
+            result[key] = val.replace(/\$\{env\.([^}]+)\}/g, (_m, name) => process.env[name] || '');
+        }
+        else if (val && typeof val === 'object' && !Array.isArray(val)) {
+            result[key] = expandEnvVars(val);
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=data-dir.js.map

package/dist/esm/utils/data-dir.js.map

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

package/dist/esm/utils/event-collector.d.ts

@@ -0,0 +1,13 @@
+import type { AgentEvent } from '../types.ts';
+/** Engine 事件流消费结果 */
+export interface EngineRunResult {
+    finalContent: string;
+    errors: string[];
+    iterations: number;
+    toolSummary: string[];
+}
+/**
+ * 消费 AgentEngine 的事件流，收集最终内容、错误、迭代次数和工具调用摘要
+ */
+export declare function collectEngineOutput(engineRunIterator: AsyncIterable<AgentEvent>): Promise<EngineRunResult>;
+//# sourceMappingURL=event-collector.d.ts.map

package/dist/esm/utils/event-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-collector.d.ts","sourceRoot":"","sources":["../../../src/utils/event-collector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,iBAAiB,EAAE,aAAa,CAAC,UAAU,CAAC,GAC3C,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/esm/utils/event-collector.js

@@ -0,0 +1,30 @@
+// ============================================================
+// EventCollector — 消费 AgentEngine 事件流收集结果
+// ============================================================
+/**
+ * 消费 AgentEngine 的事件流，收集最终内容、错误、迭代次数和工具调用摘要
+ */
+export async function collectEngineOutput(engineRunIterator) {
+    let finalContent = '';
+    const errors = [];
+    const toolSummary = [];
+    let iterations = 0;
+    for await (const event of engineRunIterator) {
+        if (event.type === 'message') {
+            finalContent += event.content;
+        }
+        else if (event.type === 'done') {
+            finalContent = event.content || finalContent;
+            iterations = event.iterations;
+        }
+        else if (event.type === 'error') {
+            errors.push(event.error);
+        }
+        if (event.type === 'tool_result') {
+            const status = event.isError ? 'error' : 'ok';
+            toolSummary.push(`${event.tool}(${status}, ${event.duration}ms)`);
+        }
+    }
+    return { finalContent, errors, iterations, toolSummary };
+}
+//# sourceMappingURL=event-collector.js.map

package/dist/esm/utils/event-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-collector.js","sourceRoot":"","sources":["../../../src/utils/event-collector.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,0CAA0C;AAC1C,+DAA+D;AAY/D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,iBAA4C;IAE5C,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC;QAChC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACjC,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC;YAC7C,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAChC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9C,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cicctencent/agent-core",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Core engine for AI agent — LLM orchestration, tool execution, MCP, skill routing, security, and memory pipeline.",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -27,16 +27,14 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "js-tiktoken": "^1.0.21",
-    "socks-proxy-agent": "^10.1.0",
-    "undici": "^8.5.0"
+    "js-tiktoken": "^1.0.21"
   },
   "devDependencies": {
     "@types/node": "^22.19.21",
     "typescript": "~5.8.3"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22.17.0"
   },
   "files": [
     "dist/**/*",