@dommaker/harness 0.8.3 → 0.9.0

package/dist/context/knowledge-injector.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * 知识注入器
+ *
+ * 将知识条目转换为 ContextSource，注入到 TokenPipeline 的 P3 位置
+ * 支持按阶段预算、类型过滤、去重
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeInjector = void 0;
+const token_budget_1 = require("./token-budget");
+class KnowledgeInjector {
+    query;
+    constructor(query) {
+        this.query = query;
+    }
+    /**
+     * 注入知识到上下文
+     */
+    inject(config) {
+        const { budget, focusTypes, phase, exclude = [], injectSummaryForExcluded = true, } = config;
+        // 查询知识
+        const queryResult = this.query.query({
+            phase: phase || 'default',
+            maxTokens: budget,
+            maxEntries: 20,
+            focusTypes: focusTypes || [],
+        });
+        const sources = [];
+        let tokensUsed = 0;
+        let entriesIncluded = 0;
+        let entriesExcluded = 0;
+        let entriesSummarized = 0;
+        const excludeSet = new Set(exclude);
+        for (const entry of queryResult.entries) {
+            if (excludeSet.has(entry.id)) {
+                entriesExcluded++;
+                // 注入摘要版本
+                if (injectSummaryForExcluded) {
+                    const summary = this.formatEntrySummary(entry);
+                    const summaryTokens = token_budget_1.TokenEstimator.estimateText(summary);
+                    if (tokensUsed + summaryTokens <= budget) {
+                        sources.push({
+                            type: 'knowledge',
+                            id: `knowledge-summary-${entry.id}`,
+                            content: summary,
+                            priority: 3,
+                            metadata: { entryId: entry.id, isSummary: true },
+                        });
+                        tokensUsed += summaryTokens;
+                        entriesSummarized++;
+                    }
+                }
+                continue;
+            }
+            // 注入完整版本
+            const formatted = this.formatEntry(entry);
+            const entryTokens = token_budget_1.TokenEstimator.estimateText(formatted);
+            if (tokensUsed + entryTokens <= budget) {
+                sources.push({
+                    type: 'knowledge',
+                    id: `knowledge-${entry.id}`,
+                    content: formatted,
+                    priority: 3,
+                    metadata: { entryId: entry.id, maturity: entry.maturity },
+                });
+                tokensUsed += entryTokens;
+                entriesIncluded++;
+            }
+            else {
+                // 预算不足，尝试注入摘要
+                const summary = this.formatEntrySummary(entry);
+                const summaryTokens = token_budget_1.TokenEstimator.estimateText(summary);
+                if (tokensUsed + summaryTokens <= budget) {
+                    sources.push({
+                        type: 'knowledge',
+                        id: `knowledge-summary-${entry.id}`,
+                        content: summary,
+                        priority: 3,
+                        metadata: { entryId: entry.id, isSummary: true },
+                    });
+                    tokensUsed += summaryTokens;
+                    entriesSummarized++;
+                }
+            }
+        }
+        return {
+            sources,
+            tokensUsed,
+            entriesIncluded,
+            entriesExcluded,
+            entriesSummarized,
+        };
+    }
+    /**
+     * 将知识条目格式化为上下文内容
+     */
+    formatEntry(entry) {
+        const parts = [];
+        parts.push(`## [${entry.type.toUpperCase()}] ${entry.title}`);
+        parts.push(`ID: ${entry.id} | 成熟度: ${entry.maturity} | 层级: ${entry.layer}`);
+        if (entry.tags.length > 0) {
+            parts.push(`标签: ${entry.tags.join(', ')}`);
+        }
+        parts.push('');
+        parts.push(entry.content);
+        return parts.join('\n');
+    }
+    /**
+     * 将知识条目格式化为摘要（一行）
+     */
+    formatEntrySummary(entry) {
+        return `[${entry.id}] ${entry.title} (${entry.maturity}) — ${entry.content.slice(0, 100)}${entry.content.length > 100 ? '...' : ''}`;
+    }
+    /**
+     * 获取查询引擎
+     */
+    getQuery() {
+        return this.query;
+    }
+}
+exports.KnowledgeInjector = KnowledgeInjector;
+//# sourceMappingURL=knowledge-injector.js.map

package/dist/context/knowledge-injector.js.map

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

package/dist/context/progressive-loader.d.ts

@@ -104,7 +104,6 @@ export declare class ProgressiveLoader {
      */
     processBatch<T, R>(items: T[], processor: (item: T) => Promise<R>, concurrency?: number): Promise<R[]>;
     private processChunk;
-    private sleep;
 }
 export declare const progressiveLoader: ProgressiveLoader;
 //# sourceMappingURL=progressive-loader.d.ts.map

package/dist/context/progressive-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progressive-loader.d.ts","sourceRoot":"","sources":["../../src/context/progressive-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,2BAA2B;IAC3B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,aAAa;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,aAAa;IACb,gBAAgB,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,WAAW;IACX,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,CAAC,EAClB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC;IAgChB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAkDzB;;;;OAIG;IACI,YAAY,CAAC,CAAC,EACnB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,GAChB,aAAa,CAAC,CAAC,EAAE,CAAC;IAkBrB;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,CAAC,EACrB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC;YAwBD,YAAY;IAiB1B,OAAO,CAAC,KAAK;CAGd;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}
+{"version":3,"file":"progressive-loader.d.ts","sourceRoot":"","sources":["../../src/context/progressive-loader.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,2BAA2B;IAC3B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,aAAa;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,aAAa;IACb,gBAAgB,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,WAAW;IACX,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,CAAC,EAClB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC;IAgChB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAkDzB;;;;OAIG;IACI,YAAY,CAAC,CAAC,EACnB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,GAChB,aAAa,CAAC,CAAC,EAAE,CAAC;IAkBrB;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,CAAC,EACrB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC;YAmBD,YAAY;CAiB3B;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/context/progressive-loader.js

@@ -1,18 +1,7 @@
 "use strict";
-/**
- * @spec HZ-002
- * @implements HZ-002-C1
- * @acceptance AC-001-1, AC-001-4
- *
- * Progressive Content Loader
- *
- * 通用内容分片加载能力
- * - 支持大数据集分片加载
- * - 支持 Token 预算管理
- * - 零业务逻辑，可被任意系统使用
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.progressiveLoader = exports.ProgressiveLoader = void 0;
+const exec_1 = require("../utils/exec");
 /**
  * 渐进式内容加载器
  *
@@ -41,7 +30,7 @@ class ProgressiveLoader {
      * ```
      */
     async loadInChunks(items, options) {
-        const { chunkSize, onChunk, onProgress, parallel = false, delay = 0 } = options;
+        const { chunkSize, onChunk, onProgress, parallel = false, delay: throttleDelay = 0 } = options;
         const total = items.length;
         const chunks = [];
         // 分片
@@ -52,8 +41,8 @@ class ProgressiveLoader {
         if (parallel) {
             // 并行加载
             await Promise.all(chunks.map(async (chunk, index) => {
-                if (delay > 0) {
-                    await this.sleep(delay * index);
+                if (throttleDelay > 0) {
+                    await (0, exec_1.delay)(throttleDelay * index);
                 }
                 await this.processChunk(chunk, index, onChunk, onProgress, total);
             }));
@@ -61,8 +50,8 @@ class ProgressiveLoader {
         else {
             // 串行加载
             for (let i = 0; i < chunks.length; i++) {
-                if (delay > 0 && i > 0) {
-                    await this.sleep(delay);
+                if (throttleDelay > 0 && i > 0) {
+                    await (0, exec_1.delay)(throttleDelay);
                 }
                 await this.processChunk(chunks[i], i, onChunk, onProgress, total);
             }
@@ -149,19 +138,16 @@ class ProgressiveLoader {
      * 批量处理（带并发控制）
      */
     async processBatch(items, processor, concurrency = 5) {
-        const results = [];
-        const executing = [];
-        for (const item of items) {
-            const promise = processor(item).then(result => {
-                results.push(result);
-            });
-            executing.push(promise);
-            if (executing.length >= concurrency) {
-                await Promise.race(executing);
-                executing.splice(executing.findIndex(p => p === promise), 1);
+        const results = new Array(items.length);
+        let nextIndex = 0;
+        const worker = async () => {
+            while (nextIndex < items.length) {
+                const index = nextIndex++;
+                results[index] = await processor(items[index]);
             }
-        }
-        await Promise.all(executing);
+        };
+        const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+        await Promise.all(workers);
         return results;
     }
     async processChunk(chunk, index, onChunk, onProgress, total) {
@@ -173,9 +159,6 @@ class ProgressiveLoader {
             onProgress(loaded, total);
         }
     }
-    sleep(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
 }
 exports.ProgressiveLoader = ProgressiveLoader;
 // 默认实例

package/dist/context/progressive-loader.js.map

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

package/dist/context/session-manager.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Session Manager
+ *
+ * 解耦 Session（持久事件日志）/ Harness（窗口视图）/ Sandbox（执行环境）
+ * Session 事件存储：.harness/sessions/{id}/events.jsonl
+ * Checkpoint 存储：.harness/sessions/{id}/checkpoints/
+ */
+import { ContextTracker } from '../monitoring/context-tracker';
+import type { SessionEvent, SessionHandle, SessionCheckpoint, TokenBudgetAllocation, PipelineOutput } from './types';
+export declare class SessionManager {
+    private basePath;
+    private sessions;
+    private pipeline;
+    private tracker;
+    constructor(basePath?: string);
+    /**
+     * 创建会话
+     */
+    createSession(id: string): SessionHandle;
+    /**
+     * 追加事件到会话
+     */
+    appendToSession(id: string, event: SessionEvent): void;
+    /**
+     * 获取当前轮窗口视图
+     *
+     * 将 session 事件转换为 ContextSource，通过 TokenPipeline 生成 prompt
+     */
+    getWindowView(id: string, budget: TokenBudgetAllocation): PipelineOutput;
+    /**
+     * 生成 checkpoint
+     */
+    checkpointSession(id: string): SessionCheckpoint;
+    /**
+     * 从 checkpoint 恢复会话
+     */
+    restoreSession(checkpointId: string): SessionHandle;
+    /**
+     * 获取会话信息
+     */
+    getSession(id: string): SessionHandle | undefined;
+    /**
+     * 获取 tracker
+     */
+    getTracker(): ContextTracker;
+    /**
+     * 将事件转换为 ContextSource
+     */
+    private eventsToSources;
+    /**
+     * 生成 checkpoint 摘要
+     */
+    private generateCheckpointSummary;
+    /**
+     * 持久化事件到 JSONL
+     */
+    private appendEvent;
+    /**
+     * 保存 checkpoint
+     */
+    private saveCheckpoint;
+    /**
+     * 获取会话目录
+     */
+    private getSessionDir;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/context/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/context/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EAEf,MAAM,SAAS,CAAC;AAEjB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,QAAQ,CAAC,EAAE,MAAM;IAM7B;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAqBxC;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAatD;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,cAAc;IAkBxE;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB;IAoBhD;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa;IA+CnD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD;;OAEG;IACH,UAAU,IAAI,cAAc;IAI5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA0CvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAgBjC;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAGtB"}

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