@cicctencent/agent-core 0.1.18 → 0.1.20

package/dist/cjs/llm/types.d.ts

@@ -74,4 +74,143 @@ export interface LLMProvider {
     /** 测试连接是否正常 */
     ping(): Promise<boolean>;
 }
+/** 单条批处理请求（对应 JSONL 文件中的一行） */
+export interface BatchRequest {
+    /** 自定义 ID，用于关联结果 */
+    customId: string;
+    /** 请求方法，固定为 POST */
+    method: 'POST';
+    /** 请求路径，如 /v1/chat/completions */
+    url: string;
+    /** 请求体（ChatParams 去掉 abortSignal） */
+    body: {
+        model: string;
+        messages: Message[];
+        tools?: ToolDefinition[];
+        toolChoice?: 'auto' | 'none' | {
+            type: 'function';
+            function: {
+                name: string;
+            };
+        };
+        temperature?: number;
+        maxTokens?: number;
+    };
+}
+/** 批处理任务信息 */
+export interface BatchInfo {
+    id: string;
+    /** 任务状态 */
+    status: 'validating' | 'in_progress' | 'finalizing' | 'completed' | 'failed' | 'expired' | 'cancelling' | 'cancelled';
+    /** 输入文件 ID（JSONL） */
+    inputFileId: string;
+    /** 完成窗口 */
+    completionWindow: string;
+    /** 创建时间（Unix 时间戳，秒） */
+    createdAt: number;
+    /** 结束时间 */
+    expiresAt?: number;
+    /** 输出文件 ID（成功结果） */
+    outputFileId?: string;
+    /** 错误文件 ID（失败结果） */
+    errorFileId?: string;
+    /** 请求计数统计 */
+    requestCounts?: {
+        total: number;
+        completed: number;
+        failed: number;
+    };
+    /** 元数据 */
+    metadata?: Record<string, string>;
+}
+/** 单条批处理结果 */
+export interface BatchResult {
+    /** 对应 BatchRequest.customId */
+    id: string;
+    customId: string;
+    /** 响应（成功时） */
+    response?: {
+        status: number;
+        body: ChatResponse;
+    };
+    /** 错误（失败时） */
+    error?: {
+        message: string;
+        type?: string;
+        code?: string;
+    };
+}
+/**
+ * 批处理能力接口（可选实现）
+ *
+ * OpenAI Batch API 流程：
+ * 1. uploadFile() 上传 JSONL 格式的请求文件（purpose='batch'）
+ * 2. createBatch() 创建批处理任务，引用上传的文件
+ * 3. getBatch() 轮询任务状态
+ * 4. getBatchResults() 下载并解析结果
+ */
+export interface BatchProvider {
+    /** 创建批处理任务 */
+    createBatch(inputFileId: string, options?: {
+        completionWindow?: '24h';
+        endpoint?: '/v1/chat/completions';
+        metadata?: Record<string, string>;
+    }): Promise<BatchInfo>;
+    /** 查询批处理任务状态 */
+    getBatch(batchId: string): Promise<BatchInfo>;
+    /** 列出批处理任务 */
+    listBatches(limit?: number): Promise<BatchInfo[]>;
+    /** 取消批处理任务 */
+    cancelBatch(batchId: string): Promise<BatchInfo>;
+    /** 下载并解析批处理结果（自动下载 output + error 文件） */
+    getBatchResults(batchId: string): Promise<BatchResult[]>;
+}
+/** 已上传文件信息 */
+export interface UploadedFileInfo {
+    id: string;
+    filename: string;
+    bytes: number;
+    createdAt: number;
+    purpose: string;
+    status: string;
+    mimeType?: string;
+}
+/**
+ * 文件管理能力接口（可选实现）
+ *
+ * 用于上传文件到 LLM 供应商（如批处理 JSONL 文件、Fine-tune 数据、Assistants 附件等）。
+ */
+export interface FileProvider {
+    /** 上传文件 */
+    uploadFile(filename: string, content: Buffer | string, purpose: 'assistants' | 'batch' | 'fine-tune' | 'vision'): Promise<UploadedFileInfo>;
+    /** 获取文件信息 */
+    getFile(fileId: string): Promise<UploadedFileInfo>;
+    /** 列出文件 */
+    listFiles(limit?: number, purpose?: string): Promise<UploadedFileInfo[]>;
+    /** 删除文件 */
+    deleteFile(fileId: string): Promise<boolean>;
+    /** 下载文件内容（返回 Buffer） */
+    downloadFile(fileId: string): Promise<Buffer>;
+    /** 下载文件内容（返回文本字符串） */
+    getFileContent(fileId: string): Promise<string>;
+}
+/** 检测 Provider 是否支持批处理（Ollama 等不支持 Batch 的 Provider 会覆盖方法抛错，通过 provider 名称排除） */
+export declare function isBatchProvider(provider: LLMProvider): provider is LLMProvider & BatchProvider;
+/** 检测 Provider 是否支持文件管理 */
+export declare function isFileProvider(provider: LLMProvider): provider is LLMProvider & FileProvider;
+/**
+ * 将 BatchRequest[] 序列化为 JSONL 字符串（每行一个 JSON 对象）
+ *
+ * 格式遵循 OpenAI Batch API 规范：
+ * {"custom_id":"req-001","method":"POST","url":"/v1/chat/completions","body":{...}}
+ */
+export declare function serializeBatchRequests(requests: BatchRequest[]): string;
+/**
+ * 从 ChatParams 快速构建 BatchRequest
+ *
+ * @param customId 自定义 ID（用于关联结果）
+ * @param model 模型名称
+ * @param params ChatParams（去掉 abortSignal）
+ */
+export declare function createBatchRequest(customId: string, model: string, params: ChatParams): BatchRequest;
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/llm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAID,iBAAiB;AACjB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAChF,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,+DAA+D;QAC/D,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAID,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD,oCAAoC;IACpC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE1D,eAAe;IACf,QAAQ,IAAI,SAAS,CAAC;IAEtB,eAAe;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/llm/types.js

@@ -3,4 +3,78 @@
 // LLM Provider 类型定义
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBatchProvider = isBatchProvider;
+exports.isFileProvider = isFileProvider;
+exports.serializeBatchRequests = serializeBatchRequests;
+exports.createBatchRequest = createBatchRequest;
+// ============================================================
+// 类型守卫 — 运行时检测 Provider 是否支持 Batch/File
+// ============================================================
+/** 检测 Provider 是否支持批处理（Ollama 等不支持 Batch 的 Provider 会覆盖方法抛错，通过 provider 名称排除） */
+function isBatchProvider(provider) {
+    const p = provider;
+    if (typeof p.createBatch !== 'function')
+        return false;
+    // Ollama 等本地 Provider 覆盖了方法但实际不支持
+    const model = provider.getModel();
+    if (model.provider === 'ollama')
+        return false;
+    return true;
+}
+/** 检测 Provider 是否支持文件管理 */
+function isFileProvider(provider) {
+    const p = provider;
+    if (typeof p.uploadFile !== 'function')
+        return false;
+    const model = provider.getModel();
+    if (model.provider === 'ollama')
+        return false;
+    return true;
+}
+// ============================================================
+// 工具函数 — BatchRequest JSONL 序列化/反序列化
+// ============================================================
+/**
+ * 将 BatchRequest[] 序列化为 JSONL 字符串（每行一个 JSON 对象）
+ *
+ * 格式遵循 OpenAI Batch API 规范：
+ * {"custom_id":"req-001","method":"POST","url":"/v1/chat/completions","body":{...}}
+ */
+function serializeBatchRequests(requests) {
+    return requests.map(r => JSON.stringify({
+        custom_id: r.customId,
+        method: r.method,
+        url: r.url,
+        body: {
+            model: r.body.model,
+            messages: r.body.messages,
+            ...(r.body.tools?.length ? { tools: r.body.tools } : {}),
+            ...(r.body.toolChoice ? { tool_choice: r.body.toolChoice } : {}),
+            ...(r.body.temperature != null ? { temperature: r.body.temperature } : {}),
+            ...(r.body.maxTokens != null ? { max_tokens: r.body.maxTokens } : {}),
+        },
+    })).join('\n');
+}
+/**
+ * 从 ChatParams 快速构建 BatchRequest
+ *
+ * @param customId 自定义 ID（用于关联结果）
+ * @param model 模型名称
+ * @param params ChatParams（去掉 abortSignal）
+ */
+function createBatchRequest(customId, model, params) {
+    return {
+        customId,
+        method: 'POST',
+        url: '/v1/chat/completions',
+        body: {
+            model,
+            messages: params.messages,
+            tools: params.tools,
+            toolChoice: params.toolChoice,
+            temperature: params.temperature,
+            maxTokens: params.maxTokens,
+        },
+    };
+}
 //# sourceMappingURL=types.js.map

package/dist/cjs/llm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;;AAwO/D,0CAOC;AAGD,wCAMC;AAYD,wDAcC;AASD,gDAkBC;AA1ED,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D;AAE/D,iFAAiF;AACjF,SAAgB,eAAe,CAAC,QAAqB;IACnD,MAAM,CAAC,GAAG,QAAoC,CAAC;IAC/C,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACtD,kCAAkC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2BAA2B;AAC3B,SAAgB,cAAc,CAAC,QAAqB;IAClD,MAAM,CAAC,GAAG,QAAmC,CAAC;IAC9C,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,qCAAqC;AACrC,+DAA+D;AAE/D;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,QAAwB;IAC7D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;QACtC,SAAS,EAAE,CAAC,CAAC,QAAQ;QACrB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,IAAI,EAAE;YACJ,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;YACzB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE;KACF,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,QAAgB,EAChB,KAAa,EACb,MAAkB;IAElB,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,sBAAsB;QAC3B,IAAI,EAAE;YACJ,KAAK;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B;KACF,CAAC;AACJ,CAAC"}

package/dist/cjs/llm/usage-tracker.d.ts

@@ -0,0 +1,119 @@
+import type { TokenUsage } from '../types.js';
+/** 单条用量记录 */
+export interface UsageRecord {
+    /** 记录时间戳（毫秒） */
+    timestamp: number;
+    /** 会话 ID */
+    sessionId: string;
+    /** Agent Profile ID（可选） */
+    agentProfileId?: string;
+    /** LLM Provider 标识 */
+    provider: string;
+    /** 模型名称 */
+    model: string;
+    /** Token 用量 */
+    usage: TokenUsage;
+    /** 估算成本（美元） */
+    cost: number;
+    /** 迭代轮次 */
+    iterations?: number;
+}
+/** 用量统计查询过滤条件 */
+export interface UsageStatsFilter {
+    /** 起始时间（毫秒时间戳） */
+    startTime?: number;
+    /** 结束时间（毫秒时间戳） */
+    endTime?: number;
+    /** 按 Agent 过滤 */
+    agentProfileId?: string;
+    /** 按 Provider 过滤 */
+    provider?: string;
+    /** 按模型过滤 */
+    model?: string;
+}
+/** 用量统计结果 */
+export interface UsageStats {
+    /** 总 token 数 */
+    totalTokens: number;
+    /** 总输入 token 数 */
+    totalPromptTokens: number;
+    /** 总输出 token 数 */
+    totalCompletionTokens: number;
+    /** 总成本（美元） */
+    totalCost: number;
+    /** 记录数 */
+    recordCount: number;
+    /** 按 Provider 分组统计 */
+    byProvider: Record<string, {
+        tokens: number;
+        cost: number;
+        count: number;
+    }>;
+    /** 按模型分组统计 */
+    byModel: Record<string, {
+        tokens: number;
+        cost: number;
+        count: number;
+    }>;
+}
+/** Token 预算配置 */
+export interface TokenBudget {
+    /** 最大 token 数（undefined = 不限制） */
+    maxTokens?: number;
+    /** 超出预算时的行为 */
+    onExceed?: 'warn' | 'abort';
+}
+/** 预算检查结果 */
+export interface BudgetCheckResult {
+    /** 是否超出预算 */
+    exceeded: boolean;
+    /** 当前累计 token 数 */
+    currentTokens: number;
+    /** 预算上限 */
+    maxTokens?: number;
+    /** 超出比例（0-1） */
+    ratio: number;
+}
+/**
+ * UsageTracker — Token 用量追踪接口
+ *
+ * 使用方实现此接口即可将用量数据持久化到任意存储后端。
+ * Core 提供默认实现 `InMemoryUsageTracker`（内存存储，重启丢失）。
+ *
+ * @example
+ * const tracker = new InMemoryUsageTracker();
+ * const engine = new AgentEngine({ ..., usageTracker: tracker });
+ */
+export interface UsageTracker {
+    /** 记录一次 LLM 调用的用量 */
+    record(record: Omit<UsageRecord, 'cost' | 'timestamp'>): void;
+    /** 查询用量统计 */
+    stats(filter?: UsageStatsFilter): UsageStats;
+    /** 查询原始记录列表 */
+    list(filter?: UsageStatsFilter): UsageRecord[];
+    /** 检查会话是否超出 token 预算 */
+    checkBudget(sessionId: string, budget: TokenBudget): BudgetCheckResult;
+    /** 获取会话累计 token 数 */
+    getSessionUsage(sessionId: string): number;
+    /** 清空所有记录 */
+    clear(): void;
+}
+/**
+ * InMemoryUsageTracker — 内存版用量追踪器
+ *
+ * 开发/测试用，重启后数据丢失。
+ * 上层可替换为持久化实现（如 JsonUsageTracker）。
+ */
+export declare class InMemoryUsageTracker implements UsageTracker {
+    private records;
+    /** sessionId → 累计 token 数 */
+    private sessionUsageMap;
+    record(record: Omit<UsageRecord, 'cost' | 'timestamp'>): void;
+    stats(filter?: UsageStatsFilter): UsageStats;
+    list(filter?: UsageStatsFilter): UsageRecord[];
+    checkBudget(sessionId: string, budget: TokenBudget): BudgetCheckResult;
+    getSessionUsage(sessionId: string): number;
+    clear(): void;
+    private filterRecords;
+}
+//# sourceMappingURL=usage-tracker.d.ts.map

package/dist/cjs/llm/usage-tracker.d.ts.map

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

package/dist/cjs/llm/usage-tracker.js

@@ -0,0 +1,105 @@
+"use strict";
+// ============================================================
+// UsageTracker — Token 用量追踪与成本计算接口
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryUsageTracker = void 0;
+const pricing_ts_1 = require("../llm/pricing.js");
+/**
+ * InMemoryUsageTracker — 内存版用量追踪器
+ *
+ * 开发/测试用，重启后数据丢失。
+ * 上层可替换为持久化实现（如 JsonUsageTracker）。
+ */
+class InMemoryUsageTracker {
+    records = [];
+    /** sessionId → 累计 token 数 */
+    sessionUsageMap = new Map();
+    record(record) {
+        const cost = (0, pricing_ts_1.calculateCost)(record.provider, record.model, record.usage);
+        const fullRecord = {
+            ...record,
+            cost,
+            timestamp: Date.now(),
+        };
+        this.records.push(fullRecord);
+        // 更新会话累计
+        const current = this.sessionUsageMap.get(record.sessionId) || 0;
+        this.sessionUsageMap.set(record.sessionId, current + record.usage.totalTokens);
+    }
+    stats(filter) {
+        const filtered = this.filterRecords(filter);
+        const result = {
+            totalTokens: 0,
+            totalPromptTokens: 0,
+            totalCompletionTokens: 0,
+            totalCost: 0,
+            recordCount: filtered.length,
+            byProvider: {},
+            byModel: {},
+        };
+        for (const r of filtered) {
+            result.totalTokens += r.usage.totalTokens;
+            result.totalPromptTokens += r.usage.promptTokens;
+            result.totalCompletionTokens += r.usage.completionTokens;
+            result.totalCost += r.cost;
+            const provKey = r.provider;
+            if (!result.byProvider[provKey])
+                result.byProvider[provKey] = { tokens: 0, cost: 0, count: 0 };
+            result.byProvider[provKey].tokens += r.usage.totalTokens;
+            result.byProvider[provKey].cost += r.cost;
+            result.byProvider[provKey].count++;
+            const modelKey = r.model;
+            if (!result.byModel[modelKey])
+                result.byModel[modelKey] = { tokens: 0, cost: 0, count: 0 };
+            result.byModel[modelKey].tokens += r.usage.totalTokens;
+            result.byModel[modelKey].cost += r.cost;
+            result.byModel[modelKey].count++;
+        }
+        // 四舍五入成本到 6 位小数
+        result.totalCost = Math.round(result.totalCost * 1_000_000) / 1_000_000;
+        return result;
+    }
+    list(filter) {
+        return this.filterRecords(filter);
+    }
+    checkBudget(sessionId, budget) {
+        const current = this.getSessionUsage(sessionId);
+        const max = budget.maxTokens;
+        if (max == null) {
+            return { exceeded: false, currentTokens: current, maxTokens: undefined, ratio: 0 };
+        }
+        return {
+            exceeded: current >= max,
+            currentTokens: current,
+            maxTokens: max,
+            ratio: max > 0 ? current / max : 0,
+        };
+    }
+    getSessionUsage(sessionId) {
+        return this.sessionUsageMap.get(sessionId) || 0;
+    }
+    clear() {
+        this.records = [];
+        this.sessionUsageMap.clear();
+    }
+    filterRecords(filter) {
+        if (!filter)
+            return [...this.records];
+        return this.records.filter(r => {
+            if (filter.startTime != null && r.timestamp < filter.startTime)
+                return false;
+            if (filter.endTime != null && r.timestamp > filter.endTime)
+                return false;
+            if (filter.agentProfileId != null && r.agentProfileId !== filter.agentProfileId)
+                return false;
+            if (filter.provider != null && r.provider !== filter.provider)
+                return false;
+            if (filter.model != null && r.model !== filter.model)
+                return false;
+            return true;
+        });
+    }
+}
+exports.InMemoryUsageTracker = InMemoryUsageTracker;
+//# sourceMappingURL=usage-tracker.js.map

package/dist/cjs/llm/usage-tracker.js.map

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

package/dist/cjs/memory/extractor.js

@@ -54,7 +54,7 @@ class MemoryExtractor {
             abortSignal: AbortSignal.timeout(this.timeoutMs),
         });
         for await (const chunk of stream) {
-            if (chunk.delta.content) {
+            if (chunk.delta.content && typeof chunk.delta.content === 'string') {
                 chunks.push(chunk.delta.content);
             }
         }

package/dist/cjs/memory/extractor.js.map

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

package/dist/cjs/memory/persona.js

@@ -68,7 +68,7 @@ class PersonaGenerator {
             abortSignal: AbortSignal.timeout(this.timeoutMs),
         });
         for await (const chunk of stream) {
-            if (chunk.delta.content) {
+            if (chunk.delta.content && typeof chunk.delta.content === 'string') {
                 chunks.push(chunk.delta.content);
             }
         }

package/dist/cjs/memory/persona.js.map

@@ -1 +1 @@
-{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../../src/memory/persona.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAC/D,oCAAoC;AACpC,sCAAsC;;;AAItC,6CAAgE;AAkBhE;;;;;;;GAOG;AACH,MAAa,gBAAgB;IACnB,WAAW,CAAc;IACzB,SAAS,CAAS;IAE1B,YAAY,IAA6B;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,MAAoB,EACpB,kBAA0B,EAAE;QAE5B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAEvD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,yCAAyC,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YAC7E,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,MAAoB,EAAE,eAAuB;QACnE,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,MAAM;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;iBACxE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChB,MAAM,IAAI,yBAAyB,UAAU,MAAM,CAAC;QACtD,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,IAAI,+EAA+E,eAAe,MAAM,CAAC;YAC/G,MAAM,IAAI,wGAAwG,CAAC;QACrH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,sGAAsG,CAAC;QACnH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAc;YAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6CAAgC,EAAE;YAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;SACtC,CAAC;QAEF,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;YACzC,QAAQ;YACR,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SACjD,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACF;AAvED,4CAuEC"}
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../../src/memory/persona.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAC/D,oCAAoC;AACpC,sCAAsC;;;AAItC,6CAAgE;AAkBhE;;;;;;;GAOG;AACH,MAAa,gBAAgB;IACnB,WAAW,CAAc;IACzB,SAAS,CAAS;IAE1B,YAAY,IAA6B;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,MAAoB,EACpB,kBAA0B,EAAE;QAE5B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAEvD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,yCAAyC,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YAC7E,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,MAAoB,EAAE,eAAuB;QACnE,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,MAAM;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;iBACxE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChB,MAAM,IAAI,yBAAyB,UAAU,MAAM,CAAC;QACtD,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,IAAI,+EAA+E,eAAe,MAAM,CAAC;YAC/G,MAAM,IAAI,wGAAwG,CAAC;QACrH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,sGAAsG,CAAC;QACnH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAc;YAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6CAAgC,EAAE;YAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;SACtC,CAAC;QAEF,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;YACzC,QAAQ;YACR,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SACjD,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACnE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACF;AAvED,4CAuEC"}

package/dist/cjs/memory/scene.js

@@ -67,7 +67,7 @@ class SceneAggregator {
             abortSignal: AbortSignal.timeout(this.timeoutMs),
         });
         for await (const chunk of stream) {
-            if (chunk.delta.content) {
+            if (chunk.delta.content && typeof chunk.delta.content === 'string') {
                 chunks.push(chunk.delta.content);
             }
         }

package/dist/cjs/memory/scene.js.map

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

package/dist/cjs/middleware/types.d.ts

@@ -1,4 +1,5 @@
 import type { HookContext, HookResult } from '../hooks/types.js';
+import type { Message } from '../types.js';
 /**
  * 中间件 before/after 接收的上下文信息
  * 包含当前迭代的关键状态快照，中间件可读取但不应直接修改
@@ -9,10 +10,7 @@ export interface MiddlewareContext {
     /** 当前迭代轮次 */
     iteration: number;
     /** 当前消息列表（只读快照） */
-    messages: ReadonlyArray<{
-        role: string;
-        content: string | null;
-    }>;
+    messages: ReadonlyArray<Message>;
     /** 当前可用工具数量 */
     toolCount: number;
 }

package/dist/cjs/middleware/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/middleware/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIjE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAClE,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;OAGG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE5D;;;OAGG;IACH,WAAW,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/middleware/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;OAGG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE5D;;;OAGG;IACH,WAAW,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC5D"}

package/dist/cjs/middleware/workspace-notes.d.ts

@@ -0,0 +1,36 @@
+import type { Middleware, MiddlewareContext } from './types.js';
+/**
+ * 笔记存储接口 — Core 定义接口，App 提供持久化实现
+ */
+export interface NoteStore {
+    /** 读取笔记内容（返回空字符串表示无笔记） */
+    read(): Promise<string>;
+    /** 写入完整笔记内容 */
+    write(content: string): Promise<void>;
+    /** 追加内容到笔记末尾 */
+    append(section: string): Promise<void>;
+}
+/**
+ * 工作空间笔记中间件
+ *
+ * 在每轮迭代开始前读取工作空间笔记（如 agent.md），
+ * 将笔记内容注入到 system prompt 末尾，使 Agent 始终感知工作空间上下文。
+ *
+ * 笔记内容通过 `AgentConfig.basePrompt` 的动态拼接实现注入，
+ * 中间件本身不修改消息历史，仅在 before 阶段触发笔记读取。
+ */
+export declare class WorkspaceNotesMiddleware implements Middleware {
+    name: string;
+    private noteStore;
+    private basePrompt;
+    private logger;
+    /** 当前注入的笔记内容缓存 */
+    private cachedNote;
+    constructor(noteStore: NoteStore, basePrompt: string, logger?: (msg: string) => void);
+    before(ctx: MiddlewareContext): Promise<void>;
+    /** 获取当前笔记内容（供外部拼接 system prompt 使用） */
+    getNoteContent(): string;
+    /** 获取拼接了笔记的完整 system prompt */
+    getSystemPrompt(): string;
+}
+//# sourceMappingURL=workspace-notes.d.ts.map

package/dist/cjs/middleware/workspace-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-notes.d.ts","sourceRoot":"","sources":["../../../src/middleware/workspace-notes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,eAAe;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,gBAAgB;IAChB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,UAAU;IACzD,IAAI,SAAqB;IAEzB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAwB;IAEtC,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAAc;gBAEpB,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAM9E,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAanD,uCAAuC;IACvC,cAAc,IAAI,MAAM;IAIxB,+BAA+B;IAC/B,eAAe,IAAI,MAAM;CAI1B"}