@dommaker/harness 0.8.3 → 0.9.0

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":"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"}

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"}

package/dist/context/tool-output-budget.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * 工具输出预算
+ *
+ * 控制工具输出对上下文的占用
+ * 策略：full / preview / overflow / dedup
+ */
+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.ToolOutputBudget = void 0;
+const crypto = __importStar(require("crypto"));
+const token_budget_1 = require("./token-budget");
+const types_1 = require("./types");
+class ToolOutputBudget {
+    config;
+    seenHashes = new Map();
+    constructor(config) {
+        this.config = { ...types_1.DEFAULT_TOOL_OUTPUT_BUDGET, ...config };
+    }
+    /**
+     * 检查工具输出应该使用什么策略
+     */
+    checkOutput(output, totalBudget) {
+        const charCount = output.length;
+        const tokens = token_budget_1.TokenEstimator.estimateText(output);
+        // 去重检查
+        if (this.config.dedup) {
+            const hash = this.computeHash(output);
+            if (this.seenHashes.has(hash)) {
+                return { allowed: true, strategy: 'dedup', reason: '重复内容，将被去重' };
+            }
+            // 记录 hash（无论最终策略是什么）
+            this.seenHashes.set(hash, true);
+        }
+        // 硬上限检查
+        if (charCount > this.config.maxChars) {
+            return {
+                allowed: true,
+                strategy: this.config.overflowToDisk ? 'overflow' : 'preview',
+                reason: `输出 ${charCount} 字符超过限制 ${this.config.maxChars}`,
+            };
+        }
+        // Token 比例检查
+        if (totalBudget) {
+            const maxTokens = totalBudget * this.config.maxTokenRatio;
+            if (tokens > maxTokens) {
+                return {
+                    allowed: true,
+                    strategy: 'preview',
+                    reason: `输出 ${tokens} tokens 超过预算比例 ${(this.config.maxTokenRatio * 100).toFixed(0)}% (${Math.floor(maxTokens)} tokens)`,
+                };
+            }
+        }
+        return { allowed: true, strategy: 'full' };
+    }
+    /**
+     * 应用预算策略
+     */
+    applyBudget(output, strategy, totalBudget) {
+        const originalTokens = token_budget_1.TokenEstimator.estimateText(output);
+        switch (strategy) {
+            case 'full': {
+                if (this.config.dedup) {
+                    this.recordHash(output);
+                }
+                return { content: output, originalTokens, keptTokens: originalTokens };
+            }
+            case 'preview': {
+                const preview = this.generatePreview(output);
+                const keptTokens = token_budget_1.TokenEstimator.estimateText(preview);
+                return { content: preview, originalTokens, keptTokens };
+            }
+            case 'overflow': {
+                const path = this.writeToOverflow(output);
+                const summary = `[输出已写入磁盘: ${path}]\n前 ${this.config.previewLines} 行预览:\n${output.split('\n').slice(0, this.config.previewLines).join('\n')}`;
+                const keptTokens = token_budget_1.TokenEstimator.estimateText(summary);
+                return { content: summary, offloaded: { path }, originalTokens, keptTokens };
+            }
+            case 'dedup': {
+                const dedupContent = `[重复内容，已省略。原始大小: ${output.length} 字符]`;
+                return { content: dedupContent, originalTokens, keptTokens: token_budget_1.TokenEstimator.estimateText(dedupContent) };
+            }
+            default:
+                return { content: output, originalTokens, keptTokens: originalTokens };
+        }
+    }
+    /**
+     * 生成预览内容
+     */
+    generatePreview(output) {
+        const lines = output.split('\n');
+        const previewLines = this.config.previewLines;
+        if (lines.length <= previewLines) {
+            return output;
+        }
+        const head = lines.slice(0, previewLines).join('\n');
+        const omitted = lines.length - previewLines;
+        return `${head}\n\n... [省略 ${omitted} 行] ...\n\n${lines.slice(-3).join('\n')}`;
+    }
+    /**
+     * 写入溢出文件
+     */
+    writeToOverflow(output) {
+        const hash = this.computeHash(output).slice(0, 8);
+        const path = `.harness/overflow/tool-output-${hash}.txt`;
+        try {
+            const fs = require('fs');
+            const dir = require('path').dirname(path);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(path, output, 'utf-8');
+        }
+        catch {
+            // 写入失败时回退到 preview
+            return '';
+        }
+        return path;
+    }
+    /**
+     * 计算内容 hash
+     */
+    computeHash(content) {
+        return crypto.createHash('md5').update(content).digest('hex');
+    }
+    /**
+     * 记录已见 hash
+     */
+    recordHash(content) {
+        const hash = this.computeHash(content);
+        this.seenHashes.set(hash, true);
+    }
+    /**
+     * 清除去重缓存
+     */
+    clearDedupCache() {
+        this.seenHashes.clear();
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.ToolOutputBudget = ToolOutputBudget;
+//# sourceMappingURL=tool-output-budget.js.map

package/dist/context/tool-output-budget.js.map

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

package/dist/context/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 上下文管理类型定义
+ *
+ * Phase 2: Token 流水线 + 预算 + 压缩
+ */
+import type { QueryResult } from '../knowledge/types';
+export interface FileBudgetConfig {
+    maxLines: number;
+    maxBytes: number;
+    maxTokenEstimate: number;
+    continuationHint: boolean;
+}
+export declare const DEFAULT_FILE_BUDGET: FileBudgetConfig;
+export interface ToolOutputBudgetConfig {
+    maxChars: number;
+    maxTokenRatio: number;
+    previewLines: number;
+    overflowToDisk: boolean;
+    dedup: boolean;
+}
+export declare const DEFAULT_TOOL_OUTPUT_BUDGET: ToolOutputBudgetConfig;
+export type CompactionLevel = 'eviction' | 'summary' | 'checkpoint';
+export interface CompactionConfig {
+    triggerRatio: number;
+    level: CompactionLevel;
+    preserveToolCallPairs: boolean;
+    structuredSummary: boolean;
+    maxSummaryTokens: number;
+    fallbackStrategy: 'truncate-middle' | 'head-drop' | 'retry-with-clamp';
+}
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfig;
+export interface SessionMessage {
+    role: 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCallId?: string;
+    timestamp: string;
+}
+export type ContextSourceType = 'session_event' | 'tool_output' | 'knowledge' | 'user_message' | 'system_prompt' | 'tool_definition';
+export interface ContextSource {
+    type: ContextSourceType;
+    id: string;
+    content: string;
+    priority: number;
+    metadata?: Record<string, any>;
+}
+export interface TokenBudgetAllocation {
+    total: number;
+    systemPrompt: number;
+    toolDefinitions: number;
+    knowledge: number;
+    notes: number;
+    history: number;
+}
+export interface PipelineInput {
+    sources: ContextSource[];
+    budget: TokenBudgetAllocation;
+    knowledge?: QueryResult;
+}
+export interface PipelineOutput {
+    prompt: string;
+    snapshot: ContextUsageSnapshot;
+    dropped: Array<{
+        type: string;
+        id: string;
+        reason: string;
+    }>;
+}
+export interface ContextUsageSnapshot {
+    timestamp: string;
+    totalTokens: number;
+    breakdown: {
+        systemPrompt: number;
+        messages: number;
+        toolOutputs: number;
+        knowledge: number;
+        other: number;
+    };
+    truncatedItems: Array<{
+        type: string;
+        id: string;
+        originalTokens: number;
+        keptTokens: number;
+    }>;
+    offloadedItems: Array<{
+        type: string;
+        id: string;
+        target: 'disk' | 'summary' | 'dropped';
+    }>;
+    compactionTriggered: boolean;
+    compactionLevel?: CompactionLevel;
+}
+export type SessionEventType = 'user_message' | 'assistant_message' | 'tool_call' | 'tool_result' | 'checkpoint' | 'system';
+export interface SessionEvent {
+    type: SessionEventType;
+    id: string;
+    content: string;
+    timestamp: string;
+    metadata?: Record<string, any>;
+}
+export interface SessionHandle {
+    id: string;
+    events: SessionEvent[];
+    createdAt: string;
+    lastActiveAt: string;
+}
+export interface SessionCheckpoint {
+    id: string;
+    sessionId: string;
+    timestamp: string;
+    eventCount: number;
+    summary: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/types.d.ts.map

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