@dommaker/harness 0.8.3 → 0.10.0

package/dist/context/session-manager.js

@@ -0,0 +1,275 @@
+"use strict";
+/**
+ * Session Manager
+ *
+ * 解耦 Session（持久事件日志）/ Harness（窗口视图）/ Sandbox（执行环境）
+ * Session 事件存储：.harness/sessions/{id}/events.jsonl
+ * Checkpoint 存储：.harness/sessions/{id}/checkpoints/
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const token_pipeline_1 = require("./token-pipeline");
+const context_tracker_1 = require("../monitoring/context-tracker");
+class SessionManager {
+    basePath;
+    sessions = new Map();
+    pipeline;
+    tracker;
+    constructor(basePath) {
+        this.basePath = basePath || process.cwd();
+        this.pipeline = new token_pipeline_1.TokenPipeline();
+        this.tracker = new context_tracker_1.ContextTracker(this.basePath);
+    }
+    /**
+     * 创建会话
+     */
+    createSession(id) {
+        const handle = {
+            id,
+            events: [],
+            createdAt: new Date().toISOString(),
+            lastActiveAt: new Date().toISOString(),
+        };
+        this.sessions.set(id, handle);
+        // 创建会话目录
+        const sessionDir = this.getSessionDir(id);
+        try {
+            fs.mkdirSync(sessionDir, { recursive: true });
+        }
+        catch {
+            // 目录创建失败，静默处理
+        }
+        return handle;
+    }
+    /**
+     * 追加事件到会话
+     */
+    appendToSession(id, event) {
+        const handle = this.sessions.get(id);
+        if (!handle) {
+            throw new Error(`会话 ${id} 不存在`);
+        }
+        handle.events.push(event);
+        handle.lastActiveAt = new Date().toISOString();
+        // 持久化到 JSONL
+        this.appendEvent(id, event);
+    }
+    /**
+     * 获取当前轮窗口视图
+     *
+     * 将 session 事件转换为 ContextSource，通过 TokenPipeline 生成 prompt
+     */
+    getWindowView(id, budget) {
+        const handle = this.sessions.get(id);
+        if (!handle) {
+            throw new Error(`会话 ${id} 不存在`);
+        }
+        // 将事件转换为 ContextSource
+        const sources = this.eventsToSources(handle.events);
+        // 通过 pipeline 生成窗口视图
+        const output = this.pipeline.run({ sources, budget });
+        // 记录快照
+        this.tracker.record(output.snapshot);
+        return output;
+    }
+    /**
+     * 生成 checkpoint
+     */
+    checkpointSession(id) {
+        const handle = this.sessions.get(id);
+        if (!handle) {
+            throw new Error(`会话 ${id} 不存在`);
+        }
+        const checkpoint = {
+            id: `cp-${Date.now()}`,
+            sessionId: id,
+            timestamp: new Date().toISOString(),
+            eventCount: handle.events.length,
+            summary: this.generateCheckpointSummary(handle.events),
+        };
+        // 持久化 checkpoint
+        this.saveCheckpoint(id, checkpoint);
+        return checkpoint;
+    }
+    /**
+     * 从 checkpoint 恢复会话
+     */
+    restoreSession(checkpointId) {
+        // 搜索所有会话的 checkpoints
+        const sessionsDir = path.join(this.basePath, '.harness', 'sessions');
+        try {
+            const sessionIds = fs.readdirSync(sessionsDir);
+            for (const sessionId of sessionIds) {
+                const checkpointPath = path.join(sessionsDir, sessionId, 'checkpoints', `${checkpointId}.json`);
+                if (fs.existsSync(checkpointPath)) {
+                    const checkpointData = JSON.parse(fs.readFileSync(checkpointPath, 'utf-8'));
+                    // 恢复会话
+                    const handle = this.createSession(sessionId);
+                    // 从 events.jsonl 恢复事件
+                    const eventsPath = path.join(sessionsDir, sessionId, 'events.jsonl');
+                    if (fs.existsSync(eventsPath)) {
+                        const content = fs.readFileSync(eventsPath, 'utf-8');
+                        const lines = content.trim().split('\n').filter(Boolean);
+                        // 只恢复 checkpoint 之前的事件
+                        const events = lines
+                            .slice(0, checkpointData.eventCount)
+                            .map(line => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((e) => e !== null);
+                        handle.events = events;
+                    }
+                    return handle;
+                }
+            }
+        }
+        catch {
+            // 恢复失败
+        }
+        throw new Error(`Checkpoint ${checkpointId} 不存在`);
+    }
+    /**
+     * 获取会话信息
+     */
+    getSession(id) {
+        return this.sessions.get(id);
+    }
+    /**
+     * 获取 tracker
+     */
+    getTracker() {
+        return this.tracker;
+    }
+    /**
+     * 将事件转换为 ContextSource
+     */
+    eventsToSources(events) {
+        return events.map(event => {
+            let priority;
+            let type;
+            switch (event.type) {
+                case 'system':
+                    priority = 1;
+                    type = 'system_prompt';
+                    break;
+                case 'user_message':
+                    priority = 6;
+                    type = 'user_message';
+                    break;
+                case 'assistant_message':
+                    priority = 5;
+                    type = 'session_event';
+                    break;
+                case 'tool_call':
+                case 'tool_result':
+                    priority = 5;
+                    type = 'tool_output';
+                    break;
+                case 'checkpoint':
+                    priority = 4;
+                    type = 'session_event';
+                    break;
+                default:
+                    priority = 5;
+                    type = 'session_event';
+            }
+            return {
+                type,
+                id: event.id,
+                content: event.content,
+                priority,
+                metadata: event.metadata,
+            };
+        });
+    }
+    /**
+     * 生成 checkpoint 摘要
+     */
+    generateCheckpointSummary(events) {
+        const userMessages = events.filter(e => e.type === 'user_message');
+        const toolCalls = events.filter(e => e.type === 'tool_call');
+        const parts = [];
+        parts.push(`事件总数: ${events.length}`);
+        parts.push(`用户消息: ${userMessages.length}`);
+        parts.push(`工具调用: ${toolCalls.length}`);
+        if (userMessages.length > 0) {
+            parts.push(`最近目标: ${userMessages[userMessages.length - 1].content.slice(0, 200)}`);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * 持久化事件到 JSONL
+     */
+    appendEvent(sessionId, event) {
+        try {
+            const eventsPath = path.join(this.getSessionDir(sessionId), 'events.jsonl');
+            const line = JSON.stringify(event) + '\n';
+            fs.appendFileSync(eventsPath, line, 'utf-8');
+        }
+        catch {
+            // 持久化失败，静默处理
+        }
+    }
+    /**
+     * 保存 checkpoint
+     */
+    saveCheckpoint(sessionId, checkpoint) {
+        try {
+            const checkpointDir = path.join(this.getSessionDir(sessionId), 'checkpoints');
+            fs.mkdirSync(checkpointDir, { recursive: true });
+            const checkpointPath = path.join(checkpointDir, `${checkpoint.id}.json`);
+            fs.writeFileSync(checkpointPath, JSON.stringify(checkpoint, null, 2), 'utf-8');
+        }
+        catch {
+            // 保存失败，静默处理
+        }
+    }
+    /**
+     * 获取会话目录
+     */
+    getSessionDir(sessionId) {
+        return path.join(this.basePath, '.harness', 'sessions', sessionId);
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session-manager.js.map

package/dist/context/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/context/session-manager.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,qDAAiD;AACjD,mEAA+D;AAU/D,MAAa,cAAc;IACjB,QAAQ,CAAS;IACjB,QAAQ,GAA+B,IAAI,GAAG,EAAE,CAAC;IACjD,QAAQ,CAAgB;IACxB,OAAO,CAAiB;IAEhC,YAAY,QAAiB;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,8BAAa,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,EAAU;QACtB,MAAM,MAAM,GAAkB;YAC5B,EAAE;YACF,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAE9B,SAAS;QACT,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,EAAU,EAAE,KAAmB;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE/C,aAAa;QACb,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,EAAU,EAAE,MAA6B;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,uBAAuB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEpD,qBAAqB;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEtD,OAAO;QACP,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,EAAU;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,UAAU,GAAsB;YACpC,EAAE,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE;YACtB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;YAChC,OAAO,EAAE,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,MAAM,CAAC;SACvD,CAAC;QAEF,iBAAiB;QACjB,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAEpC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,YAAoB;QACjC,sBAAsB;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAE/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,YAAY,OAAO,CAAC,CAAC;gBAEhG,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;oBAClC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAsB,CAAC;oBAEjG,OAAO;oBACP,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;oBAE7C,sBAAsB;oBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;oBACrE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC9B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;wBACrD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;wBAEzD,uBAAuB;wBACvB,MAAM,MAAM,GAAG,KAAK;6BACjB,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC;6BACnC,GAAG,CAAC,IAAI,CAAC,EAAE;4BACV,IAAI,CAAC;gCACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;4BAC1C,CAAC;4BAAC,MAAM,CAAC;gCACP,OAAO,IAAI,CAAC;4BACd,CAAC;wBACH,CAAC,CAAC;6BACD,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;wBAEhD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;oBACzB,CAAC;oBAED,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,cAAc,YAAY,MAAM,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAsB;QAC5C,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACxB,IAAI,QAAgB,CAAC;YACrB,IAAI,IAA2B,CAAC;YAEhC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,QAAQ;oBACX,QAAQ,GAAG,CAAC,CAAC;oBACb,IAAI,GAAG,eAAe,CAAC;oBACvB,MAAM;gBACR,KAAK,cAAc;oBACjB,QAAQ,GAAG,CAAC,CAAC;oBACb,IAAI,GAAG,cAAc,CAAC;oBACtB,MAAM;gBACR,KAAK,mBAAmB;oBACtB,QAAQ,GAAG,CAAC,CAAC;oBACb,IAAI,GAAG,eAAe,CAAC;oBACvB,MAAM;gBACR,KAAK,WAAW,CAAC;gBACjB,KAAK,aAAa;oBAChB,QAAQ,GAAG,CAAC,CAAC;oBACb,IAAI,GAAG,aAAa,CAAC;oBACrB,MAAM;gBACR,KAAK,YAAY;oBACf,QAAQ,GAAG,CAAC,CAAC;oBACb,IAAI,GAAG,eAAe,CAAC;oBACvB,MAAM;gBACR;oBACE,QAAQ,GAAG,CAAC,CAAC;oBACb,IAAI,GAAG,eAAe,CAAC;YAC3B,CAAC;YAED,OAAO;gBACL,IAAI;gBACJ,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ;gBACR,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,MAAsB;QACtD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAExC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,SAAiB,EAAE,KAAmB;QACxD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;YAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAC1C,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,SAAiB,EAAE,UAA6B;QACrE,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;YAC9E,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEjD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;YACzE,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACrE,CAAC;CACF;AApQD,wCAoQC"}

package/dist/context/token-pipeline.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Token 流水线
+ *
+ * 五步：收集 → 排序 → 压缩 → 预算 → 组装
+ * 每次 LLM 调用前运行
+ */
+import type { ContextSource, TokenBudgetAllocation, PipelineInput, PipelineOutput } from './types';
+interface CollectedGroup {
+    priority: number;
+    sources: ContextSource[];
+}
+export declare class TokenPipeline {
+    /**
+     * 完整流水线：收集 → 排序 → 压缩 → 预算 → 组装
+     */
+    run(input: PipelineInput): PipelineOutput;
+    /**
+     * Step 1: 收集 — 从 sources 按 priority 分组
+     */
+    collect(sources: ContextSource[]): CollectedGroup[];
+    /**
+     * Step 2: 排序 — 按 P1→P6，组内保持原序
+     */
+    sort(groups: CollectedGroup[]): ContextSource[];
+    /**
+     * Step 3: 压缩 — 对 P3-P5 应用 token 预算裁剪
+     *
+     * P1（系统提示词）和 P6（用户消息）不压缩
+     * P2（工具定义）按需懒加载，这里不处理
+     */
+    compress(sorted: ContextSource[], budget: TokenBudgetAllocation): {
+        compressed: ContextSource[];
+        dropped: Array<{
+            type: string;
+            id: string;
+            reason: string;
+        }>;
+    };
+    /**
+     * Step 4: 预算 — 按 TokenBudgetAllocation 分配各段
+     */
+    applyBudget(compressed: ContextSource[], budget: TokenBudgetAllocation): ContextSource[];
+    /**
+     * Step 5: 组装 — 拼装最终 prompt
+     *
+     * P1 开头 + P6 结尾，中间 P2-P5
+     */
+    assemble(budgeted: ContextSource[]): string;
+    /**
+     * 构建上下文使用快照
+     */
+    private buildSnapshot;
+}
+export {};
+//# sourceMappingURL=token-pipeline.d.ts.map

package/dist/context/token-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-pipeline.d.ts","sourceRoot":"","sources":["../../src/context/token-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,cAAc,EAEf,MAAM,SAAS,CAAC;AAEjB,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,qBAAa,aAAa;IACxB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc;IAwBzC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE;IAcnD;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE;IAU/C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,qBAAqB,GAAG;QAChE,UAAU,EAAE,aAAa,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9D;IAkED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,qBAAqB,GAAG,aAAa,EAAE;IAqBxF;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM;IAgC3C;;OAEG;IACH,OAAO,CAAC,aAAa;CA8CtB"}

package/dist/context/token-pipeline.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Token 流水线
+ *
+ * 五步：收集 → 排序 → 压缩 → 预算 → 组装
+ * 每次 LLM 调用前运行
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenPipeline = void 0;
+const token_budget_1 = require("./token-budget");
+class TokenPipeline {
+    /**
+     * 完整流水线：收集 → 排序 → 压缩 → 预算 → 组装
+     */
+    run(input) {
+        const { sources, budget } = input;
+        // Step 1: 收集 — 按 priority 分组
+        const collected = this.collect(sources);
+        // Step 2: 排序 — 按 P1→P6 排序
+        const sorted = this.sort(collected);
+        // Step 3: 压缩 — 对 P3-P5 应用预算裁剪
+        const { compressed, dropped } = this.compress(sorted, budget);
+        // Step 4: 预算 — 按分配裁剪
+        const budgeted = this.applyBudget(compressed, budget);
+        // Step 5: 组装 — 拼装最终 prompt
+        const prompt = this.assemble(budgeted);
+        // 生成快照
+        const snapshot = this.buildSnapshot(budgeted, dropped);
+        return { prompt, snapshot, dropped };
+    }
+    /**
+     * Step 1: 收集 — 从 sources 按 priority 分组
+     */
+    collect(sources) {
+        const groups = new Map();
+        for (const source of sources) {
+            const existing = groups.get(source.priority) || [];
+            existing.push(source);
+            groups.set(source.priority, existing);
+        }
+        return Array.from(groups.entries())
+            .map(([priority, sources]) => ({ priority, sources }))
+            .sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Step 2: 排序 — 按 P1→P6，组内保持原序
+     */
+    sort(groups) {
+        const sorted = [];
+        for (const group of groups) {
+            sorted.push(...group.sources);
+        }
+        return sorted;
+    }
+    /**
+     * Step 3: 压缩 — 对 P3-P5 应用 token 预算裁剪
+     *
+     * P1（系统提示词）和 P6（用户消息）不压缩
+     * P2（工具定义）按需懒加载，这里不处理
+     */
+    compress(sorted, budget) {
+        const compressed = [];
+        const dropped = [];
+        // 各段预算
+        const budgetMap = {
+            1: budget.systemPrompt,
+            2: budget.toolDefinitions,
+            3: budget.knowledge,
+            4: budget.notes,
+            5: budget.history,
+            6: Infinity, // 用户消息不限
+        };
+        // 按优先级分组处理
+        const byPriority = new Map();
+        for (const item of sorted) {
+            const existing = byPriority.get(item.priority) || [];
+            existing.push(item);
+            byPriority.set(item.priority, existing);
+        }
+        for (const [priority, items] of byPriority) {
+            const sectionBudget = budgetMap[priority] || budget.history;
+            if (priority === 1 || priority === 6) {
+                // P1/P6 不压缩
+                compressed.push(...items);
+                continue;
+            }
+            // 按 token 预算裁剪
+            let usedTokens = 0;
+            for (const item of items) {
+                const tokens = token_budget_1.TokenEstimator.estimateText(item.content);
+                if (usedTokens + tokens <= sectionBudget) {
+                    compressed.push(item);
+                    usedTokens += tokens;
+                }
+                else {
+                    // 尝试截断
+                    const remaining = sectionBudget - usedTokens;
+                    if (remaining > 50) {
+                        const ratio = remaining / tokens;
+                        const truncatedContent = item.content.slice(0, Math.floor(item.content.length * ratio));
+                        compressed.push({ ...item, content: truncatedContent });
+                        dropped.push({
+                            type: item.type,
+                            id: item.id,
+                            reason: `截断: ${tokens} → ${Math.floor(tokens * ratio)} tokens`,
+                        });
+                    }
+                    else {
+                        dropped.push({
+                            type: item.type,
+                            id: item.id,
+                            reason: `超出预算: 需要 ${tokens} tokens，剩余 ${remaining}`,
+                        });
+                    }
+                    usedTokens += tokens; // 仍然计入已用
+                }
+            }
+        }
+        return { compressed, dropped };
+    }
+    /**
+     * Step 4: 预算 — 按 TokenBudgetAllocation 分配各段
+     */
+    applyBudget(compressed, budget) {
+        const tokenBudget = new token_budget_1.TokenBudget(budget.total);
+        const result = [];
+        for (const item of compressed) {
+            const tokens = token_budget_1.TokenEstimator.estimateText(item.content);
+            if (tokenBudget.canAfford(tokens)) {
+                tokenBudget.consume(tokens);
+                result.push(item);
+            }
+            else if (item.priority === 1 || item.priority === 6) {
+                // P1/P6 强制保留
+                tokenBudget.forceConsume(tokens);
+                result.push(item);
+            }
+            // 其他优先级的超预算项被丢弃
+        }
+        return result;
+    }
+    /**
+     * Step 5: 组装 — 拼装最终 prompt
+     *
+     * P1 开头 + P6 结尾，中间 P2-P5
+     */
+    assemble(budgeted) {
+        const sections = {
+            1: [], 2: [], 3: [], 4: [], 5: [], 6: [],
+        };
+        for (const item of budgeted) {
+            sections[item.priority] = sections[item.priority] || [];
+            sections[item.priority].push(item.content);
+        }
+        const parts = [];
+        // P1: 系统提示词（开头）
+        if (sections[1].length > 0) {
+            parts.push(sections[1].join('\n'));
+        }
+        // P2-P5: 中间部分
+        for (const priority of [2, 3, 4, 5]) {
+            if (sections[priority].length > 0) {
+                parts.push(sections[priority].join('\n'));
+            }
+        }
+        // P6: 用户消息（结尾）
+        if (sections[6].length > 0) {
+            parts.push(sections[6].join('\n'));
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * 构建上下文使用快照
+     */
+    buildSnapshot(budgeted, dropped) {
+        const breakdown = {
+            systemPrompt: 0,
+            messages: 0,
+            toolOutputs: 0,
+            knowledge: 0,
+            other: 0,
+        };
+        for (const item of budgeted) {
+            const tokens = token_budget_1.TokenEstimator.estimateText(item.content);
+            switch (item.type) {
+                case 'system_prompt':
+                    breakdown.systemPrompt += tokens;
+                    break;
+                case 'user_message':
+                case 'session_event':
+                    breakdown.messages += tokens;
+                    break;
+                case 'tool_output':
+                case 'tool_definition':
+                    breakdown.toolOutputs += tokens;
+                    break;
+                case 'knowledge':
+                    breakdown.knowledge += tokens;
+                    break;
+                default:
+                    breakdown.other += tokens;
+            }
+        }
+        return {
+            timestamp: new Date().toISOString(),
+            totalTokens: breakdown.systemPrompt + breakdown.messages + breakdown.toolOutputs + breakdown.knowledge + breakdown.other,
+            breakdown,
+            truncatedItems: dropped.filter(d => d.reason.startsWith('截断')).map(d => ({
+                type: d.type,
+                id: d.id,
+                originalTokens: 0,
+                keptTokens: 0,
+            })),
+            offloadedItems: [],
+            compactionTriggered: false,
+        };
+    }
+}
+exports.TokenPipeline = TokenPipeline;
+//# sourceMappingURL=token-pipeline.js.map

package/dist/context/token-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-pipeline.js","sourceRoot":"","sources":["../../src/context/token-pipeline.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAA6D;AAc7D,MAAa,aAAa;IACxB;;OAEG;IACH,GAAG,CAAC,KAAoB;QACtB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QAElC,6BAA6B;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,0BAA0B;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEpC,8BAA8B;QAC9B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE9D,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEtD,2BAA2B;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEvC,OAAO;QACP,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEvD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAwB;QAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;QAElD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;aACrD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAwB;QAC3B,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAuB,EAAE,MAA6B;QAI7D,MAAM,UAAU,GAAoB,EAAE,CAAC;QACvC,MAAM,OAAO,GAAwD,EAAE,CAAC;QAExE,OAAO;QACP,MAAM,SAAS,GAA2B;YACxC,CAAC,EAAE,MAAM,CAAC,YAAY;YACtB,CAAC,EAAE,MAAM,CAAC,eAAe;YACzB,CAAC,EAAE,MAAM,CAAC,SAAS;YACnB,CAAC,EAAE,MAAM,CAAC,KAAK;YACf,CAAC,EAAE,MAAM,CAAC,OAAO;YACjB,CAAC,EAAE,QAAQ,EAAE,SAAS;SACvB,CAAC;QAEF,WAAW;QACX,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;YAE5D,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACrC,YAAY;gBACZ,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBAC1B,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,6BAAc,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAEzD,IAAI,UAAU,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;oBACzC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACtB,UAAU,IAAI,MAAM,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,OAAO;oBACP,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;oBAC7C,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;wBACnB,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;wBACjC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;wBACxF,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;wBACxD,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,MAAM,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS;yBAC/D,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,MAAM,EAAE,YAAY,MAAM,cAAc,SAAS,EAAE;yBACpD,CAAC,CAAC;oBACL,CAAC;oBACD,UAAU,IAAI,MAAM,CAAC,CAAC,SAAS;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAA2B,EAAE,MAA6B;QACpE,MAAM,WAAW,GAAG,IAAI,0BAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,6BAAc,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEzD,IAAI,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACtD,aAAa;gBACb,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;YACD,gBAAgB;QAClB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAAyB;QAChC,MAAM,QAAQ,GAA6B;YACzC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;SACzC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,gBAAgB;QAChB,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,cAAc;QACd,KAAK,MAAM,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAyB,EAAE,OAA4D;QAC3G,MAAM,SAAS,GAAG;YAChB,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,KAAK,EAAE,CAAC;SACT,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,6BAAc,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEzD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,KAAK,eAAe;oBAClB,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC;oBACjC,MAAM;gBACR,KAAK,cAAc,CAAC;gBACpB,KAAK,eAAe;oBAClB,SAAS,CAAC,QAAQ,IAAI,MAAM,CAAC;oBAC7B,MAAM;gBACR,KAAK,aAAa,CAAC;gBACnB,KAAK,iBAAiB;oBACpB,SAAS,CAAC,WAAW,IAAI,MAAM,CAAC;oBAChC,MAAM;gBACR,KAAK,WAAW;oBACd,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC;oBAC9B,MAAM;gBACR;oBACE,SAAS,CAAC,KAAK,IAAI,MAAM,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,KAAK;YACxH,SAAS;YACT,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvE,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,cAAc,EAAE,CAAC;gBACjB,UAAU,EAAE,CAAC;aACd,CAAC,CAAC;YACH,cAAc,EAAE,EAAE;YAClB,mBAAmB,EAAE,KAAK;SAC3B,CAAC;IACJ,CAAC;CACF;AAnPD,sCAmPC"}

package/dist/context/tool-output-budget.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 工具输出预算
+ *
+ * 控制工具输出对上下文的占用
+ * 策略：full / preview / overflow / dedup
+ */
+import type { ToolOutputBudgetConfig } from './types';
+export type OutputStrategy = 'full' | 'preview' | 'overflow' | 'dedup';
+export interface OutputCheckResult {
+    allowed: boolean;
+    strategy: OutputStrategy;
+    reason?: string;
+}
+export interface OutputApplyResult {
+    content: string;
+    offloaded?: {
+        path: string;
+    };
+    originalTokens: number;
+    keptTokens: number;
+}
+export declare class ToolOutputBudget {
+    private config;
+    private seenHashes;
+    constructor(config?: Partial<ToolOutputBudgetConfig>);
+    /**
+     * 检查工具输出应该使用什么策略
+     */
+    checkOutput(output: string, totalBudget?: number): OutputCheckResult;
+    /**
+     * 应用预算策略
+     */
+    applyBudget(output: string, strategy: OutputStrategy, totalBudget?: number): OutputApplyResult;
+    /**
+     * 生成预览内容
+     */
+    private generatePreview;
+    /**
+     * 写入溢出文件
+     */
+    private writeToOverflow;
+    /**
+     * 计算内容 hash
+     */
+    private computeHash;
+    /**
+     * 记录已见 hash
+     */
+    private recordHash;
+    /**
+     * 清除去重缓存
+     */
+    clearDedupCache(): void;
+    /**
+     * 获取配置
+     */
+    getConfig(): ToolOutputBudgetConfig;
+}
+//# sourceMappingURL=tool-output-budget.d.ts.map

package/dist/context/tool-output-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-budget.d.ts","sourceRoot":"","sources":["../../src/context/tool-output-budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAmC;gBAEzC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAIpD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAsCpE;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAkC9F;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,SAAS,IAAI,sBAAsB;CAGpC"}