workerclaw 0.2.0

package/dist/agent/agent-engine.js

@@ -0,0 +1,380 @@
+/**
+ * Agent 引擎 (Phase 4 完整版)
+ *
+ * WorkerClaw 的核心执行引擎
+ * 集成人格系统、会话管理、上下文窗口、技能系统和工具调用循环
+ *
+ * 执行流程:
+ * 1. 构建系统提示（人格 + 技能提示 + 权限信息）
+ * 2. 获取/创建会话
+ * 3. 添加用户消息
+ * 4. 上下文窗口适配
+ * 5. 调用 LLM
+ * 6. 处理工具调用（循环直到完成）
+ * 7. 返回结果
+ */
+import { createLogger } from '../core/logger.js';
+import { WorkerClawEvent } from '../core/events.js';
+import { LLMClient } from './llm-client.js';
+import { Personality } from './personality.js';
+import { SessionManager } from './session-manager.js';
+import { ToolRegistry } from './tool-registry.js';
+import { ToolExecutor } from './tool-executor.js';
+import { SkillRunner } from '../skills/skill-runner.js';
+import { SkillRegistry } from '../skills/skill-registry.js';
+export class AgentEngine {
+    logger;
+    config;
+    eventBus;
+    llm;
+    personality;
+    sessionManager;
+    toolExecutor;
+    skillRunner;
+    skillRegistry;
+    constructor(config, eventBus) {
+        this.config = config;
+        this.eventBus = eventBus;
+        this.llm = new LLMClient(config.llm);
+        this.personality = new Personality(config.personality);
+        // 会话管理
+        this.sessionManager = new SessionManager({
+            maxActiveSessions: config.session?.maxActiveSessions || 50,
+            sessionTTL: config.session?.sessionTTL || 30 * 60 * 1000,
+            contextWindow: {
+                maxTokens: config.session?.maxTokens || 8000,
+            },
+        });
+        // 工具系统
+        const toolRegistry = new ToolRegistry();
+        this.toolExecutor = new ToolExecutor(toolRegistry, { security: config.security }, eventBus);
+        // 技能系统
+        this.skillRegistry = new SkillRegistry();
+        this.skillRunner = new SkillRunner(this.skillRegistry, config.skillRunner, eventBus);
+        this.logger = createLogger('AgentEngine');
+    }
+    /**
+     * 执行任务（Phase 4 完整版）
+     */
+    async executeTask(task, context) {
+        const startTime = Date.now();
+        this.logger.info(`开始执行任务 [${task.taskId}]`, {
+            type: task.taskType,
+            title: task.title,
+        });
+        this.eventBus.emit(WorkerClawEvent.TASK_STARTED, { taskId: task.taskId });
+        // 创建会话
+        const systemPrompt = this.buildSystemPrompt(task, context);
+        this.sessionManager.createSession(task.taskId, systemPrompt);
+        try {
+            // 添加用户消息
+            const userMessage = this.buildUserMessage(task);
+            this.sessionManager.addMessage(task.taskId, {
+                role: 'user',
+                content: userMessage,
+            });
+            // 报告进度
+            this.eventBus.emit(WorkerClawEvent.TASK_PROGRESS, {
+                taskId: task.taskId,
+                progress: 20,
+                message: '正在调用 LLM...',
+            });
+            // LLM 调用循环（支持工具调用）
+            const finalResponse = await this.llmLoop(task, context);
+            // 保存最终回复
+            this.sessionManager.addMessage(task.taskId, {
+                role: 'assistant',
+                content: finalResponse.content,
+            });
+            // 构建结果
+            const durationMs = Date.now() - startTime;
+            const result = {
+                taskId: task.taskId,
+                status: 'completed',
+                content: finalResponse.content,
+                outputs: this.buildOutputs(finalResponse.content),
+                tokensUsed: finalResponse.usage ? {
+                    prompt: finalResponse.usage.promptTokens,
+                    completion: finalResponse.usage.completionTokens,
+                } : undefined,
+                durationMs,
+            };
+            this.logger.info(`任务完成 [${task.taskId}]`, {
+                durationMs,
+                tokens: result.tokensUsed,
+                toolCallRounds: finalResponse.toolCallRounds || 0,
+                contentLength: finalResponse.content.length,
+            });
+            this.eventBus.emit(WorkerClawEvent.TASK_COMPLETED, { taskId: task.taskId, result });
+            return result;
+        }
+        catch (err) {
+            const durationMs = Date.now() - startTime;
+            const error = err;
+            this.logger.error(`任务执行失败 [${task.taskId}]`, { error: error.message, durationMs });
+            this.eventBus.emit(WorkerClawEvent.LLM_ERROR, { taskId: task.taskId, error });
+            this.eventBus.emit(WorkerClawEvent.TASK_FAILED, { taskId: task.taskId, error });
+            return {
+                taskId: task.taskId,
+                status: 'failed',
+                error: error.message,
+                durationMs,
+            };
+        }
+        finally {
+            // 标记会话完成
+            this.sessionManager.completeSession(task.taskId);
+        }
+    }
+    /**
+     * LLM 调用循环（支持工具调用）
+     */
+    async llmLoop(task, context, maxRounds = 10) {
+        let round = 0;
+        while (round < maxRounds) {
+            round++;
+            // 获取适配后的消息
+            const { messages, stats } = this.sessionManager.getFittedMessages(task.taskId);
+            if (stats.isTruncated) {
+                this.logger.debug('上下文窗口已裁剪', { stats });
+            }
+            // 获取工具
+            const tools = this.getToolsForTask(task, context.permissionLevel);
+            // 调用 LLM
+            this.eventBus.emit(WorkerClawEvent.LLM_REQUEST, {
+                taskId: task.taskId,
+                model: this.config.llm.model,
+            });
+            const response = await this.llm.chat({
+                messages,
+                tools: tools.length > 0 ? tools : undefined,
+                maxTokens: context.maxOutputTokens,
+            });
+            this.eventBus.emit(WorkerClawEvent.LLM_RESPONSE, {
+                taskId: task.taskId,
+                tokens: response.usage ? {
+                    prompt: response.usage.promptTokens,
+                    completion: response.usage.completionTokens,
+                } : undefined,
+            });
+            // 如果没有工具调用，直接返回
+            if (!response.hasToolCalls || !response.toolCalls || response.toolCalls.length === 0) {
+                return { ...response, toolCallRounds: round - 1 };
+            }
+            // 处理工具调用
+            this.eventBus.emit(WorkerClawEvent.TASK_PROGRESS, {
+                taskId: task.taskId,
+                progress: Math.min(20 + round * 10, 90),
+                message: `处理工具调用 (轮次 ${round})...`,
+            });
+            // 保存 assistant 消息（包含 tool_calls）
+            this.sessionManager.addMessage(task.taskId, {
+                role: 'assistant',
+                content: response.content || '',
+                tool_calls: response.toolCalls,
+            });
+            // 执行每个工具调用
+            for (const toolCall of response.toolCalls) {
+                const toolResult = await this.handleToolCall(toolCall, task, context);
+                // 保存工具结果
+                this.sessionManager.addMessage(task.taskId, {
+                    role: 'tool',
+                    content: typeof toolResult.content === 'string'
+                        ? toolResult.content
+                        : JSON.stringify(toolResult.content),
+                    tool_call_id: toolCall.id,
+                    name: toolCall.name,
+                });
+            }
+            // 更新进度
+            this.eventBus.emit(WorkerClawEvent.TASK_PROGRESS, {
+                taskId: task.taskId,
+                progress: Math.min(20 + round * 15, 90),
+                message: `已完成 ${response.toolCalls.length} 个工具调用`,
+            });
+        }
+        // 超过最大轮次
+        this.logger.warn(`LLM 循环超过最大轮次 [${task.taskId}]`, { maxRounds });
+        // 获取最终消息
+        const { messages } = this.sessionManager.getFittedMessages(task.taskId);
+        const lastAssistant = [...messages].reverse().find(m => m.role === 'assistant');
+        return {
+            content: lastAssistant?.content || '任务执行完成（达到最大工具调用轮次）',
+            hasToolCalls: false,
+            toolCalls: [],
+            usage: undefined,
+            model: this.config.llm.model,
+            finishReason: 'max_rounds',
+            allMessages: messages,
+            toolCallRounds: maxRounds,
+        };
+    }
+    /**
+     * 处理单个工具调用
+     */
+    async handleToolCall(toolCall, task, context) {
+        const { id, name, arguments: argsStr } = toolCall;
+        this.eventBus.emit(WorkerClawEvent.TOOL_CALLED, {
+            taskId: task.taskId,
+            toolName: name,
+            toolCallId: id,
+        });
+        try {
+            // 解析参数
+            const params = JSON.parse(argsStr || '{}');
+            // 执行工具
+            const toolCallObj = {
+                id,
+                name,
+                arguments: argsStr,
+            };
+            const result = await this.toolExecutor.execute(toolCallObj, {
+                taskId: task.taskId,
+                permissionLevel: context.permissionLevel,
+                workDir: this.config.security.sandbox.workDir,
+                remainingMs: context.timeoutMs - (Date.now() - context.receivedAt),
+                toolCallCount: 0,
+                maxToolCalls: 20,
+            });
+            this.eventBus.emit(WorkerClawEvent.TOOL_COMPLETED, {
+                taskId: task.taskId,
+                toolName: name,
+                toolCallId: id,
+                success: result.success,
+            });
+            return {
+                content: result.success ? result.content : `错误: ${result.error}`,
+                success: result.success,
+            };
+        }
+        catch (err) {
+            const error = err;
+            this.eventBus.emit(WorkerClawEvent.TOOL_BLOCKED, {
+                taskId: task.taskId,
+                toolName: name,
+                reason: error.message,
+            });
+            return {
+                content: `工具调用失败: ${error.message}`,
+                success: false,
+            };
+        }
+    }
+    /**
+     * 获取任务可用的工具
+     */
+    getToolsForTask(task, permLevel) {
+        // 合并内置工具和技能工具
+        const builtinTools = this.toolExecutor.getRegistry();
+        const builtinForLLM = builtinTools.getToolsForLLM(permLevel);
+        const skillTools = this.skillRegistry.getToolsFromAllSkills(permLevel);
+        const skillToolsForLLM = skillTools.map(st => ({
+            type: 'function',
+            function: {
+                name: st.tool.name,
+                description: st.tool.description,
+                parameters: st.tool.parameters,
+            },
+        }));
+        return [...builtinForLLM, ...skillToolsForLLM];
+    }
+    /**
+     * 构建系统提示（人格 + 技能 + 权限）
+     */
+    buildSystemPrompt(task, context) {
+        const availableTools = this.toolExecutor.getRegistry().getToolNames();
+        const skillAddons = this.skillRegistry.getSystemPromptAddons(context.permissionLevel);
+        const prompt = this.personality.buildSystemPrompt({
+            permissionLevel: context.permissionLevel,
+            maxOutputTokens: context.maxOutputTokens,
+            timeoutMs: context.timeoutMs,
+            availableTools,
+            currentDate: new Date().toISOString().slice(0, 10),
+        });
+        // 附加技能提示
+        if (skillAddons.length > 0) {
+            return prompt + '\n\n' + skillAddons.join('\n\n');
+        }
+        return prompt;
+    }
+    /**
+     * 构建用户消息
+     */
+    buildUserMessage(task) {
+        const lines = [
+            `## 任务信息`,
+            `- 任务ID: ${task.taskId}`,
+            `- 任务类型: ${task.taskType}`,
+            `- 标题: ${task.title}`,
+            ``,
+            `## 任务描述`,
+            task.description,
+        ];
+        if (task.attachments && task.attachments.length > 0) {
+            lines.push('', '## 附件');
+            for (const att of task.attachments) {
+                lines.push(`- [${att.type}] ${att.name || att.url}`);
+            }
+        }
+        if (task.posterName) {
+            lines.push('', `---`, `发单人: ${task.posterName}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 构建任务输出
+     */
+    buildOutputs(content) {
+        return [{ type: 'text', content }];
+    }
+    /**
+     * 获取人格实例
+     */
+    getPersonality() {
+        return this.personality;
+    }
+    /**
+     * 获取会话管理器
+     */
+    getSessionManager() {
+        return this.sessionManager;
+    }
+    /**
+     * 获取技能注册表
+     */
+    getSkillRegistry() {
+        return this.skillRegistry;
+    }
+    /**
+     * 注册技能
+     */
+    registerSkill(skill) {
+        this.skillRegistry.register(skill);
+    }
+    /**
+     * 初始化所有技能
+     */
+    async initializeSkills() {
+        return this.skillRegistry.initializeAll();
+    }
+    /**
+     * 获取会话统计
+     */
+    getSessionStats() {
+        return this.sessionManager.getStats();
+    }
+    /**
+     * 获取技能统计
+     */
+    getSkillStats() {
+        return this.skillRegistry.getStats();
+    }
+    /**
+     * 清理资源
+     */
+    dispose() {
+        this.sessionManager.dispose();
+        this.skillRegistry.disposeAll().catch(() => { });
+    }
+}
+//# sourceMappingURL=agent-engine.js.map

package/dist/agent/agent-engine.js.map

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

package/dist/agent/context-window.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 上下文窗口管理
+ *
+ * 管理对话历史，控制 token 数量
+ * 当超过窗口限制时自动截断旧消息
+ */
+import type { LLMMessage } from '../types/agent.js';
+export interface ContextWindowConfig {
+    /** 上下文窗口最大 token 数 */
+    maxTokens: number;
+    /** 保留的系统提示 token 数（始终保留系统消息） */
+    systemReserveTokens: number;
+    /** 保留最近 N 条消息（即使超出窗口） */
+    keepRecentMessages: number;
+    /** token 估算因子（中文约 1.5 token/字，英文约 0.75 token/词） */
+    tokenEstimateFactor: number;
+    /** 截断策略 */
+    truncationStrategy: 'oldest' | 'middle' | 'summarize';
+}
+export declare const DEFAULT_CONTEXT_WINDOW_CONFIG: ContextWindowConfig;
+export interface ContextWindowStats {
+    totalTokens: number;
+    systemTokens: number;
+    conversationTokens: number;
+    messageCount: number;
+    isTruncated: boolean;
+}
+export declare class ContextWindow {
+    private logger;
+    private config;
+    constructor(config?: Partial<ContextWindowConfig>);
+    /**
+     * 估算消息的 token 数
+     */
+    estimateTokens(message: LLMMessage): number;
+    /**
+     * 计算消息列表的总 token 数
+     */
+    estimateTotalTokens(messages: LLMMessage[]): number;
+    /**
+     * 裁剪消息列表以适应上下文窗口
+     * 始终保留系统消息和最近 N 条消息
+     */
+    fitToWindow(messages: LLMMessage[]): {
+        messages: LLMMessage[];
+        stats: ContextWindowStats;
+    };
+    /**
+     * 按策略截断消息列表
+     */
+    private truncateMessages;
+    /**
+     * 从最旧的消息开始删除
+     */
+    private truncateOldest;
+    /**
+     * 从中间删除，保留首尾
+     */
+    private truncateMiddle;
+    /**
+     * 保留首尾，中间替换为摘要占位
+     */
+    private truncateWithSummary;
+    /**
+     * 获取统计信息
+     */
+    getStats(messages: LLMMessage[]): ContextWindowStats;
+}
+//# sourceMappingURL=context-window.d.ts.map

package/dist/agent/context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.d.ts","sourceRoot":"","sources":["../../src/agent/context-window.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW;IACX,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;CACvD;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAIF,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKjD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IA6B3C;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM;IAInD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG;QACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,KAAK,EAAE,kBAAkB,CAAC;KAC3B;IAkED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,kBAAkB;CAYrD"}

package/dist/agent/context-window.js

@@ -0,0 +1,210 @@
+/**
+ * 上下文窗口管理
+ *
+ * 管理对话历史，控制 token 数量
+ * 当超过窗口限制时自动截断旧消息
+ */
+import { createLogger } from '../core/logger.js';
+export const DEFAULT_CONTEXT_WINDOW_CONFIG = {
+    maxTokens: 8000,
+    systemReserveTokens: 1000,
+    keepRecentMessages: 4,
+    tokenEstimateFactor: 1.5,
+    truncationStrategy: 'oldest',
+};
+export class ContextWindow {
+    logger;
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONTEXT_WINDOW_CONFIG, ...config };
+        this.logger = createLogger('ContextWindow');
+    }
+    /**
+     * 估算消息的 token 数
+     */
+    estimateTokens(message) {
+        let text = '';
+        if (typeof message.content === 'string') {
+            text = message.content;
+        }
+        else if (Array.isArray(message.content)) {
+            // 多模态内容
+            for (const part of message.content) {
+                if (typeof part === 'string') {
+                    text += part;
+                }
+                else if (part && typeof part === 'object' && 'text' in part) {
+                    text += part.text;
+                }
+                else if (part && typeof part === 'object' && 'image_url' in part) {
+                    // 图片按固定 token 数估算
+                    text += ' [IMAGE]';
+                }
+            }
+        }
+        // 添加角色和工具调用等结构开销
+        const overhead = message.tool_calls?.length
+            ? message.tool_calls.length * 50
+            : message.tool_call_id
+                ? 20
+                : 10;
+        return Math.ceil(text.length * this.config.tokenEstimateFactor) + overhead;
+    }
+    /**
+     * 计算消息列表的总 token 数
+     */
+    estimateTotalTokens(messages) {
+        return messages.reduce((sum, msg) => sum + this.estimateTokens(msg), 0);
+    }
+    /**
+     * 裁剪消息列表以适应上下文窗口
+     * 始终保留系统消息和最近 N 条消息
+     */
+    fitToWindow(messages) {
+        const systemMessages = messages.filter(m => m.role === 'system');
+        const conversationMessages = messages.filter(m => m.role !== 'system');
+        const systemTokens = this.estimateTotalTokens(systemMessages);
+        const availableTokens = this.config.maxTokens - this.config.systemReserveTokens;
+        // 如果系统提示本身就超出限制
+        if (systemTokens > this.config.systemReserveTokens) {
+            this.logger.warn('系统提示过长，可能影响上下文窗口', {
+                systemTokens,
+                reserveTokens: this.config.systemReserveTokens,
+            });
+        }
+        let resultMessages = conversationMessages;
+        let isTruncated = false;
+        // 计算最近 N 条必须保留的消息
+        const recentMessages = conversationMessages.slice(-this.config.keepRecentMessages);
+        const recentTokens = this.estimateTotalTokens(recentMessages);
+        // 可用于历史消息的 token 预算
+        const historyBudget = Math.max(0, availableTokens - recentTokens);
+        if (recentTokens > availableTokens) {
+            // 即使只保留最近消息也超出限制，只能截断最近消息
+            this.logger.warn('最近消息也超出窗口限制，进行截断');
+            resultMessages = this.truncateMessages(recentMessages, availableTokens);
+            isTruncated = true;
+        }
+        else {
+            // 检查总历史 token 数
+            const historyMessages = conversationMessages.slice(0, -this.config.keepRecentMessages);
+            const historyTokens = this.estimateTotalTokens(historyMessages);
+            if (historyTokens > historyBudget) {
+                // 需要裁剪历史消息
+                isTruncated = true;
+                const fitted = this.truncateMessages(historyMessages, historyBudget);
+                resultMessages = [...fitted, ...recentMessages];
+            }
+        }
+        const finalMessages = [...systemMessages, ...resultMessages];
+        const conversationTokens = this.estimateTotalTokens(resultMessages);
+        if (isTruncated) {
+            this.logger.debug('上下文窗口已裁剪', {
+                originalCount: conversationMessages.length,
+                fittedCount: resultMessages.length,
+                conversationTokens,
+            });
+        }
+        return {
+            messages: finalMessages,
+            stats: {
+                totalTokens: systemTokens + conversationTokens,
+                systemTokens,
+                conversationTokens,
+                messageCount: finalMessages.length,
+                isTruncated,
+            },
+        };
+    }
+    /**
+     * 按策略截断消息列表
+     */
+    truncateMessages(messages, budget) {
+        if (messages.length === 0)
+            return [];
+        switch (this.config.truncationStrategy) {
+            case 'oldest':
+                return this.truncateOldest(messages, budget);
+            case 'middle':
+                return this.truncateMiddle(messages, budget);
+            case 'summarize':
+                // 简化版 summarize: 保留首尾，中间放占位
+                return this.truncateWithSummary(messages, budget);
+            default:
+                return this.truncateOldest(messages, budget);
+        }
+    }
+    /**
+     * 从最旧的消息开始删除
+     */
+    truncateOldest(messages, budget) {
+        const result = [];
+        let usedTokens = 0;
+        // 从最新开始保留
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const tokens = this.estimateTokens(messages[i]);
+            if (usedTokens + tokens > budget)
+                break;
+            result.unshift(messages[i]);
+            usedTokens += tokens;
+        }
+        return result;
+    }
+    /**
+     * 从中间删除，保留首尾
+     */
+    truncateMiddle(messages, budget) {
+        if (messages.length <= 2) {
+            return this.truncateOldest(messages, budget);
+        }
+        const head = messages[0];
+        const tail = messages[messages.length - 1];
+        const headTokens = this.estimateTokens(head);
+        const tailTokens = this.estimateTokens(tail);
+        const middleBudget = budget - headTokens - tailTokens;
+        if (middleBudget <= 0) {
+            return this.truncateOldest(messages, budget);
+        }
+        const middle = messages.slice(1, -1);
+        const fittedMiddle = this.truncateOldest(middle, middleBudget);
+        return [head, ...fittedMiddle, tail];
+    }
+    /**
+     * 保留首尾，中间替换为摘要占位
+     */
+    truncateWithSummary(messages, budget) {
+        if (messages.length <= 2) {
+            return this.truncateOldest(messages, budget);
+        }
+        const head = messages.slice(0, 2);
+        const tail = messages.slice(-2);
+        const headTokens = this.estimateTotalTokens(head);
+        const tailTokens = this.estimateTotalTokens(tail);
+        const summaryTokenCost = 100; // 摘要占位 token 成本
+        const remainingBudget = budget - headTokens - tailTokens - summaryTokenCost;
+        if (remainingBudget < 0) {
+            return this.truncateOldest(messages, budget);
+        }
+        const omittedCount = messages.length - 4;
+        const summaryMessage = {
+            role: 'system',
+            content: `[已省略 ${omittedCount} 条历史消息以节省上下文空间]`,
+        };
+        return [...head, summaryMessage, ...tail];
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats(messages) {
+        const systemMessages = messages.filter(m => m.role === 'system');
+        const conversationMessages = messages.filter(m => m.role !== 'system');
+        return {
+            totalTokens: this.estimateTotalTokens(messages),
+            systemTokens: this.estimateTotalTokens(systemMessages),
+            conversationTokens: this.estimateTotalTokens(conversationMessages),
+            messageCount: messages.length,
+            isTruncated: false,
+        };
+    }
+}
+//# sourceMappingURL=context-window.js.map