@lingxiao-office/sdk 1.0.0

package/dist/core/RepairStrategyEngine.js

@@ -0,0 +1,268 @@
+/**
+ * RepairStrategyEngine — 修复策略引擎（轻量版）
+ *
+ * 替代已移除的 AdaptiveHarness，用更简单直接的方式处理任务失败修复。
+ *
+ * 核心理念：
+ * - 失败不是重试的理由——是分析的起点
+ * - 分类错误 → 选择策略 → 执行修复 → 记录模式
+ * - 避免对同一根因反复用同一策略
+ *
+ * 错误分类：
+ * - type_error: TypeScript 编译错误（类型不匹配/缺少属性/导入错误）
+ * - build_error: 构建失败（模块解析/配置错误）
+ * - runtime_error: 运行时崩溃（未处理异常/断言失败/测试失败）
+ * - logic_error: 逻辑错误（功能不正确但不崩溃，由验收发现）
+ * - timeout: 超时（worker 卡住或任务过大）
+ * - dependency_error: 依赖错误（包缺失/版本冲突）
+ *
+ * 策略：
+ * - retry_with_context: 附加错误上下文重试（类型错误、简单构建错误）
+ * - narrow_scope: 缩小范围重做（任务过大导致的超时/逻辑错误）
+ * - fix_dependencies: 先修依赖再重试（依赖错误）
+ * - different_approach: 换方向（同一策略已失败2次）
+ * - escalate_to_user: 上报用户（策略耗尽）
+ */
+/** 每种错误类型的默认策略优先级 */
+const STRATEGY_MAP = {
+    type_error: ['retry_with_context', 'different_approach', 'escalate_to_user'],
+    build_error: ['retry_with_context', 'fix_dependencies', 'different_approach', 'escalate_to_user'],
+    runtime_error: ['retry_with_context', 'narrow_scope', 'different_approach', 'escalate_to_user'],
+    logic_error: ['different_approach', 'narrow_scope', 'escalate_to_user'],
+    timeout: ['narrow_scope', 'different_approach', 'escalate_to_user'],
+    dependency_error: ['fix_dependencies', 'retry_with_context', 'escalate_to_user'],
+    unknown: ['retry_with_context', 'different_approach', 'escalate_to_user'],
+};
+/** 最大修复尝试次数 */
+const MAX_REPAIR_ATTEMPTS = 3;
+export class RepairStrategyEngine {
+    ledger;
+    failureHistory = new Map();
+    constructor(ledger) {
+        this.ledger = ledger;
+    }
+    /**
+     * 分类错误
+     */
+    classify(errorText) {
+        const lower = errorText.toLowerCase();
+        const signals = [];
+        let category = 'unknown';
+        let confidence = 0.5;
+        // Type errors
+        if (this.matchesTypeError(lower)) {
+            category = 'type_error';
+            confidence = 0.9;
+            signals.push('typescript_diagnostic');
+        }
+        // Build errors
+        else if (this.matchesBuildError(lower)) {
+            category = 'build_error';
+            confidence = 0.85;
+            signals.push('build_system');
+        }
+        // Dependency errors
+        else if (this.matchesDependencyError(lower)) {
+            category = 'dependency_error';
+            confidence = 0.9;
+            signals.push('package_resolution');
+        }
+        // Runtime errors
+        else if (this.matchesRuntimeError(lower)) {
+            category = 'runtime_error';
+            confidence = 0.8;
+            signals.push('runtime_exception');
+        }
+        // Timeout
+        else if (this.matchesTimeout(lower)) {
+            category = 'timeout';
+            confidence = 0.95;
+            signals.push('timeout_signal');
+        }
+        // Logic errors (验收失败但不崩溃)
+        else if (this.matchesLogicError(lower)) {
+            category = 'logic_error';
+            confidence = 0.7;
+            signals.push('acceptance_failure');
+        }
+        const keyError = this.extractKeyError(errorText);
+        const affectedFiles = this.extractFiles(errorText);
+        return { category, confidence, signals, keyError, affectedFiles };
+    }
+    /**
+     * 根据错误分类和历史，决定修复策略
+     */
+    decide(taskId, classification) {
+        const history = this.failureHistory.get(taskId) || [];
+        const priorAttempts = history.length;
+        // 超过最大修复次数 → 上报
+        if (priorAttempts >= MAX_REPAIR_ATTEMPTS) {
+            return {
+                strategy: 'escalate_to_user',
+                reason: `已尝试 ${priorAttempts} 次修复仍失败`,
+                instructions: this.buildEscalationInstructions(history),
+                isFinalAttempt: true,
+                priorAttempts,
+            };
+        }
+        // 检查是否对同一根因重复使用同一策略
+        const strategies = STRATEGY_MAP[classification.category];
+        const usedStrategies = new Set(history
+            .filter(r => this.isSameRootCause(r.keyError, classification.keyError))
+            .map(r => r.strategy));
+        // 选择第一个未用过的策略
+        const strategy = strategies.find(s => !usedStrategies.has(s)) || 'escalate_to_user';
+        // 记录本次决策
+        this.recordFailure(taskId, {
+            taskId,
+            category: classification.category,
+            strategy,
+            keyError: classification.keyError,
+            timestamp: Date.now(),
+        });
+        // 同步到 SharedLedger
+        if (this.ledger && priorAttempts === 0) {
+            this.ledger.append({
+                type: 'finding',
+                surface: `repair:${taskId}`,
+                author: 'repair-engine',
+                content: `Task ${taskId} failed: [${classification.category}] ${classification.keyError}`,
+                evidence: classification.affectedFiles,
+            });
+        }
+        return {
+            strategy,
+            reason: this.buildReason(classification, strategy, usedStrategies),
+            instructions: this.buildInstructions(strategy, classification),
+            isFinalAttempt: priorAttempts === MAX_REPAIR_ATTEMPTS - 1,
+            priorAttempts,
+        };
+    }
+    /**
+     * 获取任务的修复历史
+     */
+    getHistory(taskId) {
+        return this.failureHistory.get(taskId) || [];
+    }
+    /**
+     * 清除任务的修复历史（任务成功后调用）
+     */
+    clearHistory(taskId) {
+        this.failureHistory.delete(taskId);
+    }
+    // ─── 错误匹配器 ───
+    matchesTypeError(text) {
+        return /ts\(\d+\)|type.*is not assignable|property.*does not exist|cannot find name|has no exported member/i.test(text);
+    }
+    matchesBuildError(text) {
+        return /cannot find module|module not found|syntax error|unexpected token|failed to compile|build failed/i.test(text);
+    }
+    matchesDependencyError(text) {
+        return /enoent.*package\.json|peer dep|could not resolve|no matching version|npm err|yarn error/i.test(text);
+    }
+    matchesRuntimeError(text) {
+        return /uncaught|unhandled|typeerror:|referenceerror:|assertion.*failed|test.*fail|expect.*received/i.test(text);
+    }
+    matchesTimeout(text) {
+        return /timeout|timed out|exceeded.*time|took too long|max.*runtime/i.test(text);
+    }
+    matchesLogicError(text) {
+        return /not.*accepted|verification.*fail|does not meet|criteria.*not.*met|功能不完整|验收.*失败/i.test(text);
+    }
+    // ─── 辅助方法 ───
+    extractKeyError(text) {
+        // 取第一个有意义的错误行
+        const lines = text.split('\n').filter(l => l.trim().length > 10);
+        const errorLine = lines.find(l => /error|fail|cannot|not found|unexpected/i.test(l)) || lines[0] || text.slice(0, 200);
+        return errorLine.trim().slice(0, 200);
+    }
+    extractFiles(text) {
+        const files = new Set();
+        // 匹配常见文件路径格式
+        const matches = text.matchAll(/(?:^|\s)((?:src|lib|app|pages|components)\/[\w./\-]+\.(?:ts|tsx|js|jsx|vue|svelte))/gm);
+        for (const m of matches) {
+            files.add(m[1]);
+        }
+        return [...files].slice(0, 10);
+    }
+    isSameRootCause(a, b) {
+        // 简单相似度：共享 50%+ 的词
+        const wordsA = new Set(a.toLowerCase().split(/\s+/));
+        const wordsB = new Set(b.toLowerCase().split(/\s+/));
+        const intersection = [...wordsA].filter(w => wordsB.has(w)).length;
+        const union = new Set([...wordsA, ...wordsB]).size;
+        return union > 0 && intersection / union > 0.5;
+    }
+    recordFailure(taskId, record) {
+        const history = this.failureHistory.get(taskId) || [];
+        history.push(record);
+        this.failureHistory.set(taskId, history);
+    }
+    buildReason(classification, strategy, usedStrategies) {
+        const parts = [`error=${classification.category}`];
+        if (usedStrategies.size > 0) {
+            parts.push(`tried=[${[...usedStrategies].join(',')}]`);
+        }
+        parts.push(`next=${strategy}`);
+        return parts.join(', ');
+    }
+    buildInstructions(strategy, classification) {
+        switch (strategy) {
+            case 'retry_with_context':
+                return [
+                    '修复策略：带上下文重试',
+                    `错误类型: ${classification.category}`,
+                    `关键错误: ${classification.keyError}`,
+                    classification.affectedFiles.length > 0
+                        ? `涉及文件: ${classification.affectedFiles.join(', ')}`
+                        : '',
+                    '请先读取相关文件理解错误原因，再做针对性修复。',
+                ].filter(Boolean).join('\n');
+            case 'narrow_scope':
+                return [
+                    '修复策略：缩小范围',
+                    '原任务范围过大导致失败，请：',
+                    '1. 识别可独立完成的最小子集',
+                    '2. 先完成核心功能，跳过边缘情况',
+                    '3. 把剩余部分标记为 TODO 或后续任务',
+                ].join('\n');
+            case 'fix_dependencies':
+                return [
+                    '修复策略：先修依赖',
+                    `关键错误: ${classification.keyError}`,
+                    '请先确保所有依赖正确安装和配置：',
+                    '1. 检查 package.json / 配置文件',
+                    '2. 运行 npm install / 安装缺失依赖',
+                    '3. 确认版本兼容性',
+                    '4. 然后再继续原任务',
+                ].join('\n');
+            case 'different_approach':
+                return [
+                    '修复策略：换方向',
+                    '之前的方法已经失败多次，需要从根本上换一种实现方式：',
+                    `失败原因: ${classification.keyError}`,
+                    '请：',
+                    '1. 分析为什么之前的方法行不通',
+                    '2. 选择一种完全不同的技术路径',
+                    '3. 如果原需求不可行，说明原因并提出替代方案',
+                ].join('\n');
+            case 'escalate_to_user':
+                return '修复策略：上报用户。已多次尝试修复仍失败，请将问题详情报告给用户决策。';
+            default:
+                return '';
+        }
+    }
+    buildEscalationInstructions(history) {
+        const lines = [
+            '## 修复尝试已耗尽',
+            '',
+            `共尝试 ${history.length} 次修复：`,
+        ];
+        for (const [i, record] of history.entries()) {
+            lines.push(`${i + 1}. [${record.category}] ${record.strategy} — ${record.keyError.slice(0, 80)}`);
+        }
+        lines.push('', '请报告给用户，由用户决定下一步。');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=RepairStrategyEngine.js.map

package/dist/core/RepairStrategyEngine.js.map

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

package/dist/core/ResourceBudgetService.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 资源预算服务 — 24×7 模式磁盘/数据生命周期管理
+ *
+ * 定期扫描工作区下的各类产物目录。默认不删除会话产物和 Agent 日志，避免破坏
+ * Leader/Agent 原始历史与审计记录；仅对终端记录、scratchpad 等可再生临时数据执行预算清理。
+ */
+/** 预算类别标识 */
+export type BudgetCategory = 'session_artifacts' | 'agent_logs' | 'terminal_transcripts' | 'sqlite_wal' | 'scratchpad_files';
+/** 单类别磁盘用量报告 */
+export interface CategoryReport {
+    category: BudgetCategory;
+    currentBytes: number;
+    maxBytes: number;
+    fileCount: number;
+    overBudget: boolean;
+}
+/** 一次性清理报告 */
+export interface CleanupReport {
+    categories: CategoryReport[];
+    deletedCount: number;
+    freedBytes: number;
+    walCheckpointTriggered: boolean;
+}
+/** 服务依赖 — 便于测试时注入 mock */
+export interface ResourceBudgetDeps {
+    /** 返回活跃会话 ID 列表，这些会话的产物不会被清理 */
+    getActiveSessionIds?: () => string[];
+    /** 触发 WAL checkpoint；省略则跳过 */
+    walCheckpoint?: () => void;
+    /** 实际 SQLite DB 文件路径（用于 WAL 大小监控）。省略时 fallback 到 workspace/.lingxiao/lingxiao.db-wal（兼容旧行为）。 */
+    dbPath?: string;
+    /** 修剪高写入量 DB 审计/日志表的老记录(返回删除行数);省略则跳过。#2 */
+    pruneDatabaseRecords?: (maxAgeHours: number) => number;
+    /** 覆盖默认时钟 */
+    now?: () => number;
+}
+/** 递归计算目录/文件大小（字节） */
+export declare function dirSizeBytes(targetPath: string): number;
+export declare class ResourceBudgetService {
+    private readonly workspace;
+    private readonly deps;
+    private cleanupTimer;
+    constructor(workspace: string, deps?: ResourceBudgetDeps);
+    /** 计算实际 WAL 文件路径：优先从 deps.dbPath 推导，fallback 到旧的 workspace/.lingxiao/lingxiao.db-wal。 */
+    private getWalPath;
+    /** 启动后台清理循环 */
+    start(): void;
+    /** 停止后台清理循环 */
+    stop(): void;
+    /** 立即执行一轮清理 */
+    enforceNow(): CleanupReport;
+    /** 返回当前磁盘用量快照 */
+    getReport(): CategoryReport[];
+    private getCategoryReport;
+    /**
+     * 对单个目录执行预算强制：扫描 → 超限则从最旧文件开始删除。
+     * @param skipFilter 可选过滤器，返回 true 表示该条目应保留（不删除）
+     */
+    private enforceCategory;
+}
+//# sourceMappingURL=ResourceBudgetService.d.ts.map

package/dist/core/ResourceBudgetService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceBudgetService.d.ts","sourceRoot":"","sources":["../../src/core/ResourceBudgetService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,aAAa;AACb,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,YAAY,GACZ,sBAAsB,GACtB,YAAY,GACZ,kBAAkB,CAAC;AAEvB,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,mBAAmB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IACrC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,aAAa;IACb,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAMD,sBAAsB;AACtB,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAcvD;AA8BD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAA+C;gBAEvD,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;IAK5D,yFAAyF;IACzF,OAAO,CAAC,UAAU;IAOlB,eAAe;IACf,KAAK,IAAI,IAAI;IAab,eAAe;IACf,IAAI,IAAI,IAAI;IAOZ,eAAe;IACf,UAAU,IAAI,aAAa;IAyF3B,iBAAiB;IACjB,SAAS,IAAI,cAAc,EAAE;IAwB7B,OAAO,CAAC,iBAAiB;IAgBzB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAqCxB"}

package/dist/core/ResourceBudgetService.js

@@ -0,0 +1,257 @@
+/**
+ * 资源预算服务 — 24×7 模式磁盘/数据生命周期管理
+ *
+ * 定期扫描工作区下的各类产物目录。默认不删除会话产物和 Agent 日志，避免破坏
+ * Leader/Agent 原始历史与审计记录；仅对终端记录、scratchpad 等可再生临时数据执行预算清理。
+ */
+import { existsSync, readdirSync, statSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { coreLogger } from './Log.js';
+import { RESOURCE_BUDGET } from '../config/defaults.js';
+// ═══════════════════════════════════════════════════════════════
+// 工具函数
+// ═══════════════════════════════════════════════════════════════
+/** 递归计算目录/文件大小（字节） */
+export function dirSizeBytes(targetPath) {
+    if (!existsSync(targetPath))
+        return 0;
+    const st = statSync(targetPath);
+    if (st.isFile())
+        return st.size;
+    let total = 0;
+    for (const entry of readdirSync(targetPath, { withFileTypes: true })) {
+        const full = join(targetPath, entry.name);
+        if (entry.isDirectory()) {
+            total += dirSizeBytes(full);
+        }
+        else if (entry.isFile()) {
+            try {
+                total += statSync(full).size;
+            }
+            catch { /* 文件可能已删除 */ }
+        }
+    }
+    return total;
+}
+function listFilesSorted(targetPath) {
+    if (!existsSync(targetPath))
+        return [];
+    const results = [];
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            try {
+                const st = statSync(full);
+                results.push({ path: full, mtimeMs: st.mtimeMs, size: st.size });
+            }
+            catch { /* 忽略 */ }
+        }
+    };
+    walk(targetPath);
+    results.sort((a, b) => a.mtimeMs - b.mtimeMs); // 最旧在前
+    return results;
+}
+const MB = 1024 * 1024;
+// ═══════════════════════════════════════════════════════════════
+// 服务实现
+// ═══════════════════════════════════════════════════════════════
+export class ResourceBudgetService {
+    workspace;
+    deps;
+    cleanupTimer = null;
+    constructor(workspace, deps = {}) {
+        this.workspace = workspace;
+        this.deps = deps;
+    }
+    /** 计算实际 WAL 文件路径：优先从 deps.dbPath 推导，fallback 到旧的 workspace/.lingxiao/lingxiao.db-wal。 */
+    getWalPath() {
+        if (this.deps.dbPath) {
+            return this.deps.dbPath + '-wal';
+        }
+        return join(this.workspace, '.lingxiao', 'lingxiao.db-wal');
+    }
+    /** 启动后台清理循环 */
+    start() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            try {
+                this.enforceNow();
+            }
+            catch (err) {
+                coreLogger.error('[ResourceBudget] 清理循环异常：%s', String(err));
+            }
+        }, RESOURCE_BUDGET.CLEANUP_INTERVAL_MS);
+        // 不阻塞退出
+        if (this.cleanupTimer && typeof this.cleanupTimer.unref === 'function') {
+            this.cleanupTimer.unref();
+        }
+    }
+    /** 停止后台清理循环 */
+    stop() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /** 立即执行一轮清理 */
+    enforceNow() {
+        const categories = [];
+        let deletedCount = 0;
+        let freedBytes = 0;
+        let walCheckpointTriggered = false;
+        // ── 会话产物：只统计，不默认删除，保证原始会话/Agent 续跑材料可追溯 ──
+        const sessDir = join(this.workspace, '.lingxiao', 'sessions');
+        const sessReport = this.getCategoryReport(sessDir, 'session_artifacts', RESOURCE_BUDGET.SESSION_ARTIFACTS_MAX_MB * MB);
+        categories.push(sessReport);
+        // ── Agent 日志：只统计，不默认删除，保证运行审计记录完整 ──
+        const logDir = join(this.workspace, '.lingxiao', 'logs');
+        const logReport = this.getCategoryReport(logDir, 'agent_logs', RESOURCE_BUDGET.AGENT_LOGS_MAX_MB * MB);
+        categories.push(logReport);
+        // ── 终端记录 ──
+        const termDir = join(this.workspace, '.lingxiao', 'terminal');
+        const termReport = this.enforceCategory(termDir, 'terminal_transcripts', RESOURCE_BUDGET.TERMINAL_TRANSCRIPTS_MAX_MB * MB);
+        categories.push(termReport);
+        // ── 草稿文件 ──
+        const scratchDir = join(this.workspace, '.lingxiao', 'scratchpad');
+        const scratchReport = this.enforceCategory(scratchDir, 'scratchpad_files', RESOURCE_BUDGET.SCRATCHPAD_MAX_MB * MB);
+        categories.push(scratchReport);
+        // ── SQLite WAL ──
+        const walPath = this.getWalPath();
+        const walReport = {
+            category: 'sqlite_wal',
+            currentBytes: 0,
+            maxBytes: RESOURCE_BUDGET.SQLITE_WAL_CHECKPOINT_MB * MB,
+            fileCount: 0,
+            overBudget: false,
+        };
+        if (existsSync(walPath)) {
+            try {
+                const walSize = statSync(walPath).size;
+                walReport.currentBytes = walSize;
+                walReport.fileCount = 1;
+                if (walSize > walReport.maxBytes) {
+                    walReport.overBudget = true;
+                    try {
+                        this.deps.walCheckpoint?.();
+                        walCheckpointTriggered = true;
+                        coreLogger.info('[ResourceBudget] WAL checkpoint 触发（%.1f MB > %d MB）', walSize / MB, RESOURCE_BUDGET.SQLITE_WAL_CHECKPOINT_MB);
+                    }
+                    catch (err) {
+                        coreLogger.warn('[ResourceBudget] WAL checkpoint 失败：%s', String(err));
+                    }
+                }
+            }
+            catch { /* 文件可能已删除 */ }
+        }
+        categories.push(walReport);
+        // ── DB 高写入量审计/日志表老记录修剪(#2) ──
+        if (this.deps.pruneDatabaseRecords) {
+            try {
+                deletedCount += this.deps.pruneDatabaseRecords(RESOURCE_BUDGET.DB_PRUNE_MAX_AGE_HOURS);
+            }
+            catch (err) {
+                coreLogger.warn('[ResourceBudget] DB 修剪失败：%s', String(err));
+            }
+        }
+        // 汇总删除数
+        for (const r of categories) {
+            if (r.category === 'sqlite_wal')
+                continue;
+            // deletedCount/freedBytes 已在 enforceCategory 中累计
+        }
+        return { categories, deletedCount, freedBytes, walCheckpointTriggered };
+    }
+    /** 返回当前磁盘用量快照 */
+    getReport() {
+        const sessDir = join(this.workspace, '.lingxiao', 'sessions');
+        const logDir = join(this.workspace, '.lingxiao', 'logs');
+        const termDir = join(this.workspace, '.lingxiao', 'terminal');
+        const scratchDir = join(this.workspace, '.lingxiao', 'scratchpad');
+        const walPath = this.getWalPath();
+        const sessSize = dirSizeBytes(sessDir);
+        const logSize = dirSizeBytes(logDir);
+        const termSize = dirSizeBytes(termDir);
+        const scratchSize = dirSizeBytes(scratchDir);
+        const walSize = existsSync(walPath) ? statSync(walPath).size : 0;
+        return [
+            { category: 'session_artifacts', currentBytes: sessSize, maxBytes: RESOURCE_BUDGET.SESSION_ARTIFACTS_MAX_MB * MB, fileCount: countFiles(sessDir), overBudget: sessSize > RESOURCE_BUDGET.SESSION_ARTIFACTS_MAX_MB * MB },
+            { category: 'agent_logs', currentBytes: logSize, maxBytes: RESOURCE_BUDGET.AGENT_LOGS_MAX_MB * MB, fileCount: countFiles(logDir), overBudget: logSize > RESOURCE_BUDGET.AGENT_LOGS_MAX_MB * MB },
+            { category: 'terminal_transcripts', currentBytes: termSize, maxBytes: RESOURCE_BUDGET.TERMINAL_TRANSCRIPTS_MAX_MB * MB, fileCount: countFiles(termDir), overBudget: termSize > RESOURCE_BUDGET.TERMINAL_TRANSCRIPTS_MAX_MB * MB },
+            { category: 'scratchpad_files', currentBytes: scratchSize, maxBytes: RESOURCE_BUDGET.SCRATCHPAD_MAX_MB * MB, fileCount: countFiles(scratchDir), overBudget: scratchSize > RESOURCE_BUDGET.SCRATCHPAD_MAX_MB * MB },
+            { category: 'sqlite_wal', currentBytes: walSize, maxBytes: RESOURCE_BUDGET.SQLITE_WAL_CHECKPOINT_MB * MB, fileCount: existsSync(walPath) ? 1 : 0, overBudget: walSize > RESOURCE_BUDGET.SQLITE_WAL_CHECKPOINT_MB * MB },
+        ];
+    }
+    // ── 内部 ──
+    getCategoryReport(dir, category, maxBytes) {
+        const files = listFilesSorted(dir);
+        const currentBytes = files.reduce((sum, f) => sum + f.size, 0);
+        return {
+            category,
+            currentBytes,
+            maxBytes,
+            fileCount: files.length,
+            overBudget: currentBytes > maxBytes,
+        };
+    }
+    /**
+     * 对单个目录执行预算强制：扫描 → 超限则从最旧文件开始删除。
+     * @param skipFilter 可选过滤器，返回 true 表示该条目应保留（不删除）
+     */
+    enforceCategory(dir, category, maxBytes, skipFilter) {
+        const files = listFilesSorted(dir);
+        const currentBytes = files.reduce((sum, f) => sum + f.size, 0);
+        const report = {
+            category,
+            currentBytes,
+            maxBytes,
+            fileCount: files.length,
+            overBudget: currentBytes > maxBytes,
+        };
+        if (!report.overBudget)
+            return report;
+        let remaining = currentBytes;
+        for (const file of files) {
+            if (remaining <= maxBytes)
+                break;
+            if (skipFilter?.(file))
+                continue;
+            try {
+                unlinkSync(file.path);
+                remaining -= file.size;
+                coreLogger.info('[ResourceBudget] 清理 %s: %s（%.1f KB）', category, file.path, file.size / 1024);
+            }
+            catch (err) {
+                coreLogger.warn('[ResourceBudget] 删除失败 %s：%s', file.path, String(err));
+            }
+        }
+        // 更新报告
+        report.currentBytes = remaining;
+        report.fileCount = countFiles(dir);
+        report.overBudget = remaining > maxBytes;
+        return report;
+    }
+}
+/** 递归计算目录内文件数 */
+function countFiles(targetPath) {
+    if (!existsSync(targetPath))
+        return 0;
+    let count = 0;
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (entry.isFile())
+                count++;
+            else if (entry.isDirectory())
+                walk(join(dir, entry.name));
+        }
+    };
+    walk(targetPath);
+    return count;
+}
+//# sourceMappingURL=ResourceBudgetService.js.map

package/dist/core/ResourceBudgetService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceBudgetService.js","sourceRoot":"","sources":["../../src/core/ResourceBudgetService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA6CxD,kEAAkE;AAClE,OAAO;AACP,kEAAkE;AAElE,sBAAsB;AACtB,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC;gBAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAKD,SAAS,eAAe,CAAC,UAAkB;IACzC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC9B,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvB,kEAAkE;AAClE,OAAO;AACP,kEAAkE;AAElE,MAAM,OAAO,qBAAqB;IACf,SAAS,CAAS;IAClB,IAAI,CAAqB;IAClC,YAAY,GAA0C,IAAI,CAAC;IAEnE,YAAY,SAAiB,EAAE,OAA2B,EAAE;QAC1D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,yFAAyF;IACjF,UAAU;QAChB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;IAC9D,CAAC;IAED,eAAe;IACf,KAAK;QACH,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC;gBAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAAC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACtC,UAAU,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;QACxC,QAAQ;QACR,IAAI,IAAI,CAAC,YAAY,IAAI,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACvE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI;QACF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,eAAe;IACf,UAAU;QACR,MAAM,UAAU,GAAqB,EAAE,CAAC;QACxC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,sBAAsB,GAAG,KAAK,CAAC;QAEnC,4CAA4C;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CACvC,OAAO,EACP,mBAAmB,EACnB,eAAe,CAAC,wBAAwB,GAAG,EAAE,CAC9C,CAAC;QACF,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE5B,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CACtC,MAAM,EACN,YAAY,EACZ,eAAe,CAAC,iBAAiB,GAAG,EAAE,CACvC,CAAC;QACF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3B,aAAa;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,OAAO,EACP,sBAAsB,EACtB,eAAe,CAAC,2BAA2B,GAAG,EAAE,CACjD,CAAC;QACF,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE5B,aAAa;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CACxC,UAAU,EACV,kBAAkB,EAClB,eAAe,CAAC,iBAAiB,GAAG,EAAE,CACvC,CAAC;QACF,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE/B,mBAAmB;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,SAAS,GAAmB;YAChC,QAAQ,EAAE,YAAY;YACtB,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,eAAe,CAAC,wBAAwB,GAAG,EAAE;YACvD,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,KAAK;SAClB,CAAC;QACF,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;gBACvC,SAAS,CAAC,YAAY,GAAG,OAAO,CAAC;gBACjC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;gBACxB,IAAI,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;oBACjC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;oBAC5B,IAAI,CAAC;wBACH,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;wBAC5B,sBAAsB,GAAG,IAAI,CAAC;wBAC9B,UAAU,CAAC,IAAI,CAAC,qDAAqD,EACnE,OAAO,GAAG,EAAE,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;oBAC5D,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,UAAU,CAAC,IAAI,CAAC,uCAAuC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBACxE,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QAC3B,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3B,+BAA+B;QAC/B,IAAI,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC;YACzF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC,6BAA6B,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,QAAQ;QACR,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY;gBAAE,SAAS;YAC1C,iDAAiD;QACnD,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,CAAC;IAC1E,CAAC;IAED,iBAAiB;IACjB,SAAS;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAElC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjE,OAAO;YACL,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,wBAAwB,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,QAAQ,GAAG,eAAe,CAAC,wBAAwB,GAAG,EAAE,EAAE;YACxN,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,iBAAiB,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,eAAe,CAAC,iBAAiB,GAAG,EAAE,EAAE;YAChM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,2BAA2B,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,QAAQ,GAAG,eAAe,CAAC,2BAA2B,GAAG,EAAE,EAAE;YACjO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,CAAC,iBAAiB,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,WAAW,GAAG,eAAe,CAAC,iBAAiB,GAAG,EAAE,EAAE;YAClN,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,wBAAwB,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,eAAe,CAAC,wBAAwB,GAAG,EAAE,EAAE;SACxN,CAAC;IACJ,CAAC;IAED,WAAW;IAEH,iBAAiB,CACvB,GAAW,EACX,QAAwB,EACxB,QAAgB;QAEhB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/D,OAAO;YACL,QAAQ;YACR,YAAY;YACZ,QAAQ;YACR,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,UAAU,EAAE,YAAY,GAAG,QAAQ;SACpC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,eAAe,CACrB,GAAW,EACX,QAAwB,EACxB,QAAgB,EAChB,UAA0C;QAE1C,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAmB;YAC7B,QAAQ;YACR,YAAY;YACZ,QAAQ;YACR,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,UAAU,EAAE,YAAY,GAAG,QAAQ;SACpC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,MAAM,CAAC;QAEtC,IAAI,SAAS,GAAG,YAAY,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,SAAS,IAAI,QAAQ;gBAAE,MAAM;YACjC,IAAI,UAAU,EAAE,CAAC,IAAI,CAAC;gBAAE,SAAS;YACjC,IAAI,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC;gBACvB,UAAU,CAAC,IAAI,CAAC,qCAAqC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YAChG,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC,6BAA6B,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,OAAO;QACP,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,iBAAiB;AACjB,SAAS,UAAU,CAAC,UAAkB;IACpC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,KAAK,EAAE,CAAC;iBACvB,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/ResumeManager.d.ts

@@ -0,0 +1,18 @@
+import type { RecoveredTaskInfo } from '../contracts/types/Agent.js';
+import type { AgentState, DatabaseManager } from './Database.js';
+import type { TaskBoard } from './TaskBoard.js';
+export interface AgentResumeCheckpoint {
+    agentId: string;
+    agentName: string;
+    agentRole: string;
+    taskId: string;
+    iteration: number;
+    toolCallCount: number;
+    timestamp: number;
+}
+export declare function getAgentCheckpointKey(agentId: string): string;
+export declare function saveAgentResumeCheckpoint(db: Pick<DatabaseManager, 'setSessionState'>, sessionId: string, checkpoint: AgentResumeCheckpoint): void;
+export declare function clearAgentResumeCheckpoint(db: Pick<DatabaseManager, 'deleteSessionState'>, sessionId: string, agentId: string): void;
+export declare function loadAgentResumeCheckpoints(db: Pick<DatabaseManager, 'listSessionStateByPrefix'>, sessionId: string): Map<string, AgentResumeCheckpoint>;
+export declare function buildRecoveredTasks(board: TaskBoard, agentStates: AgentState[], checkpoints?: Map<string, AgentResumeCheckpoint>): RecoveredTaskInfo[];
+//# sourceMappingURL=ResumeManager.d.ts.map

package/dist/core/ResumeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResumeManager.d.ts","sourceRoot":"","sources":["../../src/core/ResumeManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,EAC5C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,oBAAoB,CAAC,EAC/C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,0BAA0B,CAAC,EACrD,SAAS,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CA2BpC;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,UAAU,EAAE,EACzB,WAAW,GAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAa,GAC1D,iBAAiB,EAAE,CA2GrB"}