@cicctencent/agent-core 0.1.6 → 0.1.7

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.6",
+  "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",