@lingxiao-office/sdk 1.0.0

package/dist/core/Diagnostics.js

@@ -0,0 +1,308 @@
+/**
+ * Diagnostics Bundle Builder
+ *
+ * 聚合运行时诊断信息，生成可直接贴到 GitHub issue 的 markdown，
+ * 并可选打包为 zip 写到 ~/.lingxiao/logs/diagnostics-<时间戳>.zip。
+ *
+ * 聚合内容：
+ * - 环境信息：版本 / 平台 / 架构 / Node 版本
+ * - lingxiao.log 尾部（最近 ~500 行或 200KB）
+ * - 最新 crash 报告（若有）
+ * - agent_logs 摘要（从 SQLite 只读查询最近若干条；不可访问则跳过并注明）
+ * - 内存最近日志（环形缓冲）
+ *
+ * 脱敏：复用 CrashReporter 的 redactSensitive / redactSensitiveString。
+ * best-effort：所有外部 IO 单独 try-catch，单点失败不影响整体产出。
+ */
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
+import { open } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { DatabaseSync } from 'node:sqlite';
+import { getLogDir, getMainLogFilePath, getRecentLogEntries, } from './Log.js';
+import { listCrashReports, redactSensitive, redactSensitiveString } from './CrashReporter.js';
+import { VERSION } from '../version.js';
+// ─── Constants ───
+const DEFAULT_LOG_TAIL_BYTES = 200 * 1024; // 200KB
+const DEFAULT_LOG_TAIL_LINES = 500;
+const DEFAULT_AGENT_LOG_LIMIT = 50;
+const DEFAULT_RECENT_LOG_LIMIT = 200;
+// ─── Path helpers ───
+function getDefaultDbPath() {
+    return join(homedir(), '.lingxiao', 'data.db');
+}
+// ─── Section builders (each best-effort) ───
+function buildEnvSection(sessionId) {
+    const lines = [];
+    lines.push('## 环境信息');
+    lines.push('');
+    lines.push('| 项 | 值 |');
+    lines.push('| --- | --- |');
+    lines.push(`| 版本 | ${VERSION} |`);
+    lines.push(`| 平台 | ${process.platform} |`);
+    lines.push(`| 架构 | ${process.arch} |`);
+    lines.push(`| Node 版本 | ${process.version} |`);
+    lines.push(`| 生成时间 | ${new Date().toISOString()} |`);
+    if (sessionId)
+        lines.push(`| Session | ${sessionId} |`);
+    lines.push('');
+    return lines.join('\n');
+}
+function buildCrashSection() {
+    try {
+        const reports = listCrashReports();
+        if (reports.length === 0) {
+            return { markdown: '## 错误摘要\n\n_无 crash 报告。_\n' };
+        }
+        const latest = reports[0];
+        const lines = [];
+        lines.push('## 错误摘要');
+        lines.push('');
+        lines.push(`最新崩溃报告：\`${latest.path}\`（共 ${reports.length} 个）`);
+        lines.push('');
+        try {
+            const raw = readFileSync(latest.path, 'utf-8');
+            // 文件内容写入时已脱敏，这里再做一次字符串级兜底
+            const safe = redactSensitiveString(raw);
+            const parsed = JSON.parse(safe);
+            lines.push('```json');
+            lines.push(JSON.stringify({
+                ts: parsed.ts,
+                source: parsed.source,
+                error: {
+                    name: parsed.error?.name,
+                    message: parsed.error?.message,
+                    stack: parsed.error?.stack,
+                },
+            }, null, 2));
+            lines.push('```');
+        }
+        catch {
+            lines.push('_无法解析最新 crash 报告内容。_');
+        }
+        lines.push('');
+        return { markdown: lines.join('\n'), latestCrashPath: latest.path };
+    }
+    catch {
+        return { markdown: '## 错误摘要\n\n_读取 crash 报告失败。_\n' };
+    }
+}
+/**
+ * 读取文件末尾最多 maxBytes 字节，再按行截取最后 maxLines 行。
+ * best-effort，失败返回空字符串。
+ */
+async function readFileTail(filePath, maxBytes, maxLines) {
+    let handle;
+    try {
+        if (!existsSync(filePath))
+            return '';
+        const st = statSync(filePath);
+        if (!st.isFile() || st.size === 0)
+            return '';
+        const start = Math.max(0, st.size - maxBytes);
+        const length = st.size - start;
+        handle = await open(filePath, 'r');
+        const buf = Buffer.alloc(length);
+        await handle.read(buf, 0, length, start);
+        let text = buf.toString('utf-8');
+        // 若从中间截断，丢弃第一段不完整行
+        if (start > 0) {
+            const nl = text.indexOf('\n');
+            if (nl >= 0)
+                text = text.slice(nl + 1);
+        }
+        const allLines = text.split('\n');
+        const tail = allLines.slice(Math.max(0, allLines.length - maxLines));
+        return tail.join('\n');
+    }
+    catch {
+        return '';
+    }
+    finally {
+        if (handle) {
+            try {
+                await handle.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+async function buildLogTailSection(opts) {
+    const lines = ['## 最近日志（lingxiao.log 尾部）', ''];
+    const logPath = getMainLogFilePath();
+    const tail = await readFileTail(logPath, opts.logTailBytes, opts.logTailLines);
+    if (!tail.trim()) {
+        lines.push('_无主日志或日志为空。_');
+        lines.push('');
+        return lines.join('\n');
+    }
+    const safe = redactSensitiveString(tail);
+    lines.push('```');
+    lines.push(safe);
+    lines.push('```');
+    lines.push('');
+    return lines.join('\n');
+}
+function buildAgentLogSection(dbPath, sessionId, limit) {
+    const lines = ['## Agent 日志摘要', ''];
+    if (!existsSync(dbPath)) {
+        lines.push('_未找到会话数据库，已跳过 agent_logs 摘要。_');
+        lines.push('');
+        return lines.join('\n');
+    }
+    let db;
+    try {
+        db = new DatabaseSync(dbPath, { readOnly: true });
+        let rows;
+        const cols = 'session_id, agent_id, agent_name, agent_role, task_id, event_type, action, timestamp';
+        if (sessionId) {
+            const stmt = db.prepare(`SELECT ${cols} FROM agent_logs WHERE session_id = ? ORDER BY timestamp DESC LIMIT ?`);
+            rows = stmt.all(sessionId, limit);
+        }
+        else {
+            const stmt = db.prepare(`SELECT ${cols} FROM agent_logs ORDER BY timestamp DESC LIMIT ?`);
+            rows = stmt.all(limit);
+        }
+        if (rows.length === 0) {
+            lines.push('_agent_logs 表无匹配记录。_');
+            lines.push('');
+            return lines.join('\n');
+        }
+        lines.push(`最近 ${rows.length} 条（倒序）：`);
+        lines.push('');
+        lines.push('| 时间 | agent | role | task | event | action |');
+        lines.push('| --- | --- | --- | --- | --- | --- |');
+        for (const r of rows) {
+            const ts = typeof r.timestamp === 'number' ? new Date(r.timestamp).toISOString() : '-';
+            lines.push(`| ${ts} | ${r.agent_name ?? r.agent_id ?? '-'} | ${r.agent_role ?? '-'} | ${r.task_id ?? '-'} | ${r.event_type ?? '-'} | ${r.action ?? '-'} |`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    catch (err) {
+        lines.push(`_读取 agent_logs 失败，已跳过：${err instanceof Error ? err.message : String(err)}_`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    finally {
+        if (db) {
+            try {
+                db.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+function buildRecentMemorySection(limit) {
+    const lines = ['## 内存最近日志（环形缓冲）', ''];
+    let entries = [];
+    try {
+        entries = getRecentLogEntries(limit);
+    }
+    catch {
+        entries = [];
+    }
+    if (entries.length === 0) {
+        lines.push('_内存缓冲无记录。_');
+        lines.push('');
+        return { markdown: lines.join('\n'), entries };
+    }
+    const safe = redactSensitive(entries);
+    lines.push('```json');
+    lines.push(JSON.stringify(safe, null, 2));
+    lines.push('```');
+    lines.push('');
+    return { markdown: lines.join('\n'), entries: safe };
+}
+function buildRepro() {
+    return [
+        '## 复现说明',
+        '',
+        '<!-- 请补充以下信息 -->',
+        '- 期望行为：',
+        '- 实际行为：',
+        '- 复现步骤：',
+        '  1. ',
+        '  2. ',
+        '  3. ',
+        '',
+    ].join('\n');
+}
+// ─── Public API ───
+/**
+ * 构建诊断包。聚合环境 / 错误 / 日志信息为 markdown，
+ * 并将 markdown 文件写到 ~/.lingxiao/logs/diagnostics-<时间戳>.md。
+ * opts.zip 为 true 时尝试额外打包 zip（用 jszip）；打包失败则仅保留 markdown 文件并在结果中注明。
+ *
+ * best-effort：各 section 独立 try-catch，单点失败不影响整体产出。
+ */
+export async function buildDiagnosticsBundle(opts = {}) {
+    const logTailBytes = opts.logTailBytes ?? DEFAULT_LOG_TAIL_BYTES;
+    const logTailLines = opts.logTailLines ?? DEFAULT_LOG_TAIL_LINES;
+    const agentLogLimit = opts.agentLogLimit ?? DEFAULT_AGENT_LOG_LIMIT;
+    const recentLogLimit = opts.recentLogLimit ?? DEFAULT_RECENT_LOG_LIMIT;
+    const dbPath = opts.dbPath ?? getDefaultDbPath();
+    const envMd = buildEnvSection(opts.sessionId);
+    const crash = buildCrashSection();
+    const logTailMd = await buildLogTailSection({ logTailBytes, logTailLines });
+    const agentMd = buildAgentLogSection(dbPath, opts.sessionId, agentLogLimit);
+    const recent = buildRecentMemorySection(recentLogLimit);
+    const notes = [];
+    const markdown = [
+        `# 凌霄诊断报告`,
+        '',
+        envMd,
+        crash.markdown,
+        logTailMd,
+        agentMd,
+        recent.markdown,
+        buildRepro(),
+    ].join('\n');
+    const files = [];
+    let bundlePath;
+    // 写 markdown 文件
+    const logDir = getLogDir();
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const mdPath = join(logDir, `diagnostics-${stamp}.md`);
+    try {
+        if (!existsSync(logDir))
+            mkdirSync(logDir, { recursive: true });
+        writeFileSync(mdPath, markdown, 'utf-8');
+        files.push(mdPath);
+    }
+    catch {
+        // markdown 落盘失败不影响返回 markdown 字符串
+    }
+    if (opts.zip) {
+        try {
+            const { default: JSZip } = await import('jszip');
+            const zip = new JSZip();
+            zip.file('diagnostics.md', markdown);
+            // 附带最新 crash 报告原文（已脱敏写盘）
+            if (crash.latestCrashPath && existsSync(crash.latestCrashPath)) {
+                try {
+                    const raw = readFileSync(crash.latestCrashPath, 'utf-8');
+                    zip.file('crash.json', redactSensitiveString(raw));
+                }
+                catch {
+                    // 跳过 crash 附件
+                }
+            }
+            const buf = await zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' });
+            const zipPath = join(logDir, `diagnostics-${stamp}.zip`);
+            writeFileSync(zipPath, buf);
+            files.push(zipPath);
+            bundlePath = zipPath;
+        }
+        catch (err) {
+            notes.push(`> 注意：zip 打包失败，仅产出 markdown 文件。原因：${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const finalMarkdown = notes.length > 0 ? `${markdown}\n\n${notes.join('\n')}\n` : markdown;
+    return { markdown: finalMarkdown, files, bundlePath };
+}
+//# sourceMappingURL=Diagnostics.js.map

package/dist/core/Diagnostics.js.map

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

package/dist/core/EternalGoal.d.ts

@@ -0,0 +1,15 @@
+export interface EternalGoal {
+    description: string;
+    paused: boolean;
+    createdAt: number;
+    updatedAt: number;
+    deletedAt?: number;
+}
+export interface EternalGoalReader {
+    getSessionState(sessionId: string, key: string): unknown | null;
+}
+export declare function normalizeEternalGoal(raw: unknown): EternalGoal | null;
+export declare function readPersistedEternalGoal(db: EternalGoalReader, sessionId: string): EternalGoal | null;
+export declare function createEternalGoal(description: string, previous?: EternalGoal | null, now?: number): EternalGoal;
+export declare function setEternalGoalPaused(goal: EternalGoal, paused: boolean, now?: number): EternalGoal;
+//# sourceMappingURL=EternalGoal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EternalGoal.d.ts","sourceRoot":"","sources":["../../src/core/EternalGoal.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACjE;AAeD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA6BrE;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAEpB;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,WAAW,GAAG,IAAW,EACnC,GAAG,SAAa,GACf,WAAW,CAOb;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,OAAO,EACf,GAAG,SAAa,GACf,WAAW,CAMb"}

package/dist/core/EternalGoal.js

@@ -0,0 +1,67 @@
+import { SESSION_KEYS } from './SessionStateKeys.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readTimestamp(value, fallback) {
+    if (typeof value === 'number' && Number.isFinite(value) && value > 0)
+        return value;
+    if (typeof value === 'string' && value.trim()) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed) && parsed > 0)
+            return parsed;
+    }
+    return fallback;
+}
+export function normalizeEternalGoal(raw) {
+    if (typeof raw === 'string') {
+        const trimmed = raw.trim();
+        if (!trimmed)
+            return null;
+        try {
+            return normalizeEternalGoal(JSON.parse(trimmed));
+        }
+        catch { /* swallowed: unhandled error */
+            const now = Date.now();
+            return {
+                description: trimmed,
+                paused: false,
+                createdAt: now,
+                updatedAt: now,
+            };
+        }
+    }
+    if (!isRecord(raw))
+        return null;
+    if (raw.deletedAt != null)
+        return null;
+    const description = typeof raw.description === 'string' ? raw.description.trim() : '';
+    if (!description)
+        return null;
+    const updatedAt = readTimestamp(raw.updatedAt, Date.now());
+    const createdAt = readTimestamp(raw.createdAt, updatedAt);
+    return {
+        description,
+        paused: raw.paused === true,
+        createdAt,
+        updatedAt,
+    };
+}
+export function readPersistedEternalGoal(db, sessionId) {
+    return normalizeEternalGoal(db.getSessionState(sessionId, SESSION_KEYS.ETERNAL_GOAL));
+}
+export function createEternalGoal(description, previous = null, now = Date.now()) {
+    return {
+        description: description.trim(),
+        paused: false,
+        createdAt: previous?.createdAt ?? now,
+        updatedAt: now,
+    };
+}
+export function setEternalGoalPaused(goal, paused, now = Date.now()) {
+    return {
+        ...goal,
+        paused,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=EternalGoal.js.map

package/dist/core/EternalGoal.js.map

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

package/dist/core/EternalLoop.d.ts

@@ -0,0 +1,206 @@
+/**
+ * EternalLoop — 统一自治控制回路
+ *
+ * 替代 LeaderProgressInvariant 的碎片化巡逻逻辑（停滞检测 / watchdog / patrol），
+ * 并提供无硬上限的持续自治能力 + 成本护栏。
+ *
+ * 架构位置：
+ *   嵌入 LeaderAgent 主循环，替换原有的 invariant.checkProgressStagnation()
+ *   和 invariant.maybeEternalIdlePatrol() 调用点。
+ *
+ * 回路：
+ *   IDLE → (interval) → CHECK → [has work?] → SKIP
+ *                              → [idle?] → PATROL → THINK → WAIT → IDLE
+ *
+ * 护栏：
+ *   - Token 预算 (per-hour cap): 超出后暂停 patrol，等待下个窗口
+ *   - 指数退避 patrol 间隔: 30s → 1m → 2m → 4m → 8m → 16m (no hard cap)
+ *   - 最大连续无工具调用 patrol 数: 30 (超限后以 maxInterval 持续，不放弃)
+ *   - Circuit breaker: API 连续失败 N 次后暂停 patrol，等待手动干预或指数退避恢复
+ */
+import type { DatabaseManager } from './Database.js';
+import type { EventEmitter } from './EventEmitter.js';
+import type { TaskBoard } from './TaskBoard.js';
+import { type AlertManager } from './AlertManager.js';
+import type { EternalGoal } from './EternalGoal.js';
+import { type EternalPatrolJudgeInput, type EternalPatrolVerdict } from '../contracts/adapters/EternalPatrolPolicy.js';
+import type { ContentGenerator } from '../llm/ContentGenerator.js';
+import type { EternalTokenSnapshot } from '../types/canonical.js';
+export interface EternalLoopConfig {
+    /** Patrol 基础间隔 ms (默认 30s) */
+    basePatrolIntervalMs?: number;
+    /** 最大 patrol 间隔 ms (默认 960s = 16min, 指数退避上限) */
+    maxPatrolIntervalMs?: number;
+    /** 每小时的 token 预算 (0 = unlimited) */
+    tokenBudgetPerHour?: number;
+    /** API 失败 circuit breaker 阈值 (默认 8) */
+    circuitBreakerThreshold?: number;
+    /** Circuit breaker 基础退避时间 ms (默认 60s) */
+    circuitBreakerBaseBackoffMs?: number;
+    /** Circuit breaker 最大退避时间 ms (默认 1800s = 30min) */
+    circuitBreakerMaxBackoffMs?: number;
+    /** 允许在 worker 运行时并行调度新任务 (默认 true) */
+    parallelDispatch?: boolean;
+}
+export type TokenUsage = EternalTokenSnapshot;
+export interface EternalLoopState {
+    /** 当前 patrol 间隔 (会随 idle 退避增长) */
+    currentPatrolIntervalMs: number;
+    /** 连续无工具调用的 patrol 次数 */
+    consecutiveIdlePatrols: number;
+    /** 上次 patrol 时间 */
+    lastPatrolAtMs: number;
+    /** 当前小时窗口内的 token 消耗 */
+    currentWindowTokens: number;
+    /** 当前窗口开始时间 */
+    windowStartMs: number;
+    /** 连续 API 失败计数 */
+    consecutiveApiFailures: number;
+    /** Circuit breaker 打开时间 (0 表示关闭) */
+    circuitOpenUntilMs: number;
+    /** 本次运行中的总 patrol 数 */
+    totalPatrols: number;
+    /** 上次记录的项目指纹（task/blackboard/scratchpad/conversation/worker complete count） */
+    lastFingerprint: string | null;
+    /** 静默锁：true 表示同 fingerprint 不再调 LLM judge / patrol */
+    silenceLockEngaged: boolean;
+    /** 上一次 patrol 的产出 */
+    lastPatrolOutcome: 'productive' | 'idle' | 'never';
+    /** worker:complete / worker:failed 累计计数（参与 fingerprint） */
+    workerCompletionCount: number;
+    /** 当前是否正在执行 patrol LLM 轮次。只做运行时观测，不持久化。 */
+    patrolInFlight: boolean;
+}
+export interface EternalPatrolCandidate {
+    id: string;
+    title: string;
+    score: number;
+    type: string;
+    reason: string;
+}
+export type EternalRuntimeStatus = 'disabled' | 'paused' | 'ready' | 'waiting' | 'patrolling' | 'silenced' | 'budget_exhausted' | 'circuit_open';
+export interface EternalRuntimeSnapshot {
+    enabled: boolean;
+    status: EternalRuntimeStatus;
+    goal: EternalGoal | null;
+    currentPatrolIntervalMs: number;
+    consecutiveIdlePatrols: number;
+    lastPatrolAtMs: number;
+    nextPatrolDueAtMs: number;
+    currentWindowTokens: number;
+    tokenBudgetPerHour: number;
+    windowStartMs: number;
+    consecutiveApiFailures: number;
+    circuitOpenUntilMs: number;
+    totalPatrols: number;
+    silenceLockEngaged: boolean;
+    lastPatrolOutcome: EternalLoopState['lastPatrolOutcome'];
+    workerCompletionCount: number;
+    patrolInFlight: boolean;
+    lastFingerprintKnown: boolean;
+}
+export interface EternalLoopDeps {
+    sessionId: string;
+    db: DatabaseManager;
+    emitter: EventEmitter;
+    board: TaskBoard;
+    alertManager?: AlertManager;
+    isEternalMode: () => boolean;
+    isFinished: () => boolean;
+    isWaitingForUser: () => boolean;
+    isPendingReview: () => boolean;
+    hasRunningAgents: () => boolean;
+    getRunningAgentCount: () => number;
+    getMaxConcurrent: () => number;
+    getConversationLength: () => number;
+    getEternalGoal?: () => EternalGoal | null;
+    recordTokenUsage: (usage: TokenUsage) => void;
+    executeEternalPatrol: (patrolNumber: number, totalPatrols: number, candidates?: EternalPatrolCandidate[]) => Promise<boolean>;
+    dispatchReadyTasks: () => Promise<number>;
+    getReadyTaskCount?: () => number;
+    /** 拉取黑板节点/边计数；返回 null 表示黑板未就绪。 */
+    getBlackboardCounts?: () => {
+        nodes: number;
+        edges: number;
+    } | null;
+    /** 拉取最新 scratchpad review digest；用于 fingerprint。 */
+    getScratchpadDigest?: () => string | null;
+    /** 拉取最近 conversation digest；提供给 judge。 */
+    getRecentConversationDigest?: () => string;
+    /** 取活跃任务总数等 stats。getStats 已在 board 上，但这层封装方便测试时注入。 */
+    getOpenWorkPresent?: () => boolean;
+    /** Judge LLM client（默认走 Leader-NextSpeaker 同款 ContentGenerator） */
+    getJudgeLlm?: () => ContentGenerator | null;
+    /** Judge 模型名 */
+    getJudgeModel?: () => string | null;
+    /** 自定义 judge 函数（测试/agents 注入用，默认 → runtime deterministic fallback） */
+    judgeFn?: (input: EternalPatrolJudgeInput) => Promise<EternalPatrolVerdict>;
+    /** judge 决定 yield_user 时调用，把 leader 切回等待状态 */
+    yieldToUser?: (reason: string) => Promise<void>;
+}
+export declare function createInitialEternalRuntimeSnapshot(enabled?: boolean, config?: EternalLoopConfig, now?: number, goal?: EternalGoal | null): EternalRuntimeSnapshot;
+export declare class EternalLoop {
+    readonly state: EternalLoopState;
+    private config;
+    private deps;
+    private alertMgr;
+    constructor(config: EternalLoopConfig, deps: EternalLoopDeps);
+    toRuntimeSnapshot(enabled?: boolean, now?: number): EternalRuntimeSnapshot;
+    /** 主循环入口。每轮 LeaderAgent 主循环调用一次。返回 true 表示本循环执行了 patrol。 */
+    tick(): Promise<boolean>;
+    /** 记录 token 使用 (每次 LLM 调用后调用) */
+    recordTokens(usage: TokenUsage): void;
+    /** 记录 API 成功/失败 */
+    recordApiResult(success: boolean): void;
+    /** 从 DB 恢复 patrol 状态 */
+    hydrate(): Promise<void>;
+    /** 持久化 patrol 状态 */
+    persist(): Promise<void>;
+    private runPatrol;
+    private runPatrolWithinTrace;
+    private onPatrolProductive;
+    private onPatrolIdle;
+    private rollTokenWindow;
+    private isOverTokenBudget;
+    private isCircuitOpen;
+    /**
+     * 计算当前项目指纹。包含：
+     * - task stats（dispatchable/running/terminal/completed/failed）
+     * - blackboard 节点/边计数
+     * - scratchpad digest
+     * - conversation 长度
+     * - worker complete 计数（外部 emitter 喂进来）
+     * - Eternal 目标模式
+     *
+     * 任何一项变化都会让 fingerprint 改变，从而解锁 silence。
+     */
+    computeFingerprint(): string;
+    /**
+     * 把 fingerprint 解析成"什么变了"，喂给 LLM judge。简单 diff——
+     * 没必要做最优 LCS，看得懂就行。
+     */
+    private describeFingerprintDiff;
+    private hasOpenWorkFromBoard;
+    private buildStructuredCandidates;
+    /**
+     * silence 期间也要推进 idle 退避计数，避免 interval 卡在低位反复 tick。
+     * 不增 totalPatrols，不进 alert 阈值。
+     */
+    private advanceSilentIdle;
+    /**
+     * 外部状态变化主动唤醒 silence lock。
+     * LeaderProgressInvariant 会在 task:completed / agent:completed / worker:complete /
+     * blackboard:delta / team:message_sent / 用户消息 进来时调用。
+     */
+    invalidateSilenceLock(reason?: string): void;
+    /**
+     * 切到 manual 模式时调用：彻底重置 silence/idle/streak 状态，让下次切回 eternal
+     * 从基础间隔重新出发，不携带旧 backoff / outcome 包袱。
+     * 不动 token 窗口与 circuit breaker（这两类与 eternal 无关）。
+     */
+    resetForControlModeSwitch(): void;
+    /** 由 LeaderProgressInvariant 在收到 worker:complete / worker:failed 时调用 */
+    noteWorkerCompletion(): void;
+    private persistSoon;
+}
+//# sourceMappingURL=EternalLoop.d.ts.map

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

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