@lingxiao-office/sdk 1.0.0

package/dist/core/EternalRuntimeProjection.d.ts

@@ -0,0 +1,39 @@
+export type EternalRuntimeProjectionStatus = 'disabled' | 'paused' | 'ready' | 'waiting' | 'patrolling' | 'silenced' | 'budget_exhausted' | 'circuit_open';
+export type EternalRuntimeProjectionTone = 'active' | 'ok' | 'warn' | 'danger' | 'neutral';
+export interface EternalRuntimeProjectionSnapshot {
+    enabled: boolean;
+    status: EternalRuntimeProjectionStatus;
+    goal?: {
+        description: string;
+        paused: boolean;
+        createdAt: number;
+        updatedAt: number;
+    } | null;
+    currentPatrolIntervalMs: number;
+    consecutiveIdlePatrols: number;
+    lastPatrolAtMs: number;
+    nextPatrolDueAtMs: number;
+    currentWindowTokens: number;
+    tokenBudgetPerHour: number;
+    windowStartMs: number;
+    consecutiveApiFailures: number;
+    circuitOpenUntilMs: number;
+    totalPatrols: number;
+    silenceLockEngaged: boolean;
+    lastPatrolOutcome: 'productive' | 'idle' | 'never';
+    workerCompletionCount: number;
+    patrolInFlight: boolean;
+    lastFingerprintKnown: boolean;
+}
+export interface EternalRuntimeProjection {
+    tone: EternalRuntimeProjectionTone;
+    statusLabel: string;
+    compactDetailLabel: string | null;
+    detailLabel: string | null;
+    title: string;
+    spinning: boolean;
+}
+export declare function formatEternalRuntimeStatus(status: EternalRuntimeProjectionStatus): string;
+export declare function formatEternalRuntimeDuration(ms: number): string;
+export declare function buildEternalRuntimeProjection(snapshot: EternalRuntimeProjectionSnapshot | null | undefined, now?: number): EternalRuntimeProjection | null;
+//# sourceMappingURL=EternalRuntimeProjection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EternalRuntimeProjection.d.ts","sourceRoot":"","sources":["../../src/core/EternalRuntimeProjection.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,8BAA8B,GACtC,UAAU,GACV,QAAQ,GACR,OAAO,GACP,SAAS,GACT,YAAY,GACZ,UAAU,GACV,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3F,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,8BAA8B,CAAC;IACvC,IAAI,CAAC,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;IACnD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,4BAA4B,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CAKzF;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAS/D;AAmFD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,EAC7D,GAAG,SAAa,GACf,wBAAwB,GAAG,IAAI,CAYjC"}

package/dist/core/EternalRuntimeProjection.js

@@ -0,0 +1,114 @@
+export function formatEternalRuntimeStatus(status) {
+    if (status === 'paused')
+        return 'paused';
+    if (status === 'budget_exhausted')
+        return 'budget';
+    if (status === 'circuit_open')
+        return 'circuit';
+    return status.replace(/_/g, ' ');
+}
+export function formatEternalRuntimeDuration(ms) {
+    if (!Number.isFinite(ms) || ms <= 0)
+        return 'now';
+    const seconds = Math.ceil(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.ceil(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return rest > 0 ? `${hours}h${rest}m` : `${hours}h`;
+}
+function toneForStatus(status) {
+    if (status === 'patrolling')
+        return 'active';
+    if (status === 'ready')
+        return 'ok';
+    if (status === 'paused')
+        return 'warn';
+    if (status === 'waiting')
+        return 'neutral';
+    if (status === 'silenced')
+        return 'warn';
+    if (status === 'budget_exhausted' || status === 'circuit_open')
+        return 'danger';
+    return 'neutral';
+}
+function detailForSnapshot(snapshot, now) {
+    if (snapshot.status === 'patrolling') {
+        const value = snapshot.patrolInFlight ? 'in flight' : null;
+        return { compactDetailLabel: value, detailLabel: value };
+    }
+    if (snapshot.status === 'paused') {
+        return { compactDetailLabel: 'goal paused', detailLabel: 'goal paused' };
+    }
+    if (snapshot.status === 'waiting' && snapshot.nextPatrolDueAtMs > 0) {
+        const value = `next ${formatEternalRuntimeDuration(snapshot.nextPatrolDueAtMs - now)}`;
+        return { compactDetailLabel: value, detailLabel: value };
+    }
+    if (snapshot.status === 'ready') {
+        return { compactDetailLabel: 'due now', detailLabel: 'due now' };
+    }
+    if (snapshot.status === 'silenced') {
+        const value = snapshot.silenceLockEngaged ? 'lock' : null;
+        return { compactDetailLabel: value, detailLabel: value };
+    }
+    if (snapshot.status === 'budget_exhausted') {
+        const compact = snapshot.tokenBudgetPerHour > 0
+            ? `${snapshot.currentWindowTokens}/${snapshot.tokenBudgetPerHour}`
+            : 'budget';
+        return {
+            compactDetailLabel: compact,
+            detailLabel: compact === 'budget' ? compact : `budget ${compact}`,
+        };
+    }
+    if (snapshot.status === 'circuit_open') {
+        const retry = snapshot.circuitOpenUntilMs > 0
+            ? `retry ${formatEternalRuntimeDuration(snapshot.circuitOpenUntilMs - now)}`
+            : null;
+        const failures = snapshot.consecutiveApiFailures > 0
+            ? `fail ${snapshot.consecutiveApiFailures}`
+            : null;
+        const detail = [retry, failures].filter(Boolean).join(' ') || null;
+        return {
+            compactDetailLabel: retry,
+            detailLabel: detail,
+        };
+    }
+    return { compactDetailLabel: null, detailLabel: null };
+}
+function titleForSnapshot(snapshot, statusLabel, detailLabel) {
+    const parts = [
+        `Eternal ${statusLabel}`,
+        detailLabel,
+        `patrols ${snapshot.totalPatrols}`,
+        `idle ${snapshot.consecutiveIdlePatrols}`,
+        `outcome ${snapshot.lastPatrolOutcome}`,
+        snapshot.tokenBudgetPerHour > 0
+            ? `tokens ${snapshot.currentWindowTokens}/${snapshot.tokenBudgetPerHour}`
+            : null,
+        snapshot.consecutiveApiFailures > 0
+            ? `api failures ${snapshot.consecutiveApiFailures}`
+            : null,
+        snapshot.goal?.description
+            ? `goal ${snapshot.goal.description.slice(0, 80)}`
+            : null,
+    ].filter(Boolean);
+    return parts.join(' | ');
+}
+export function buildEternalRuntimeProjection(snapshot, now = Date.now()) {
+    if (!snapshot?.enabled)
+        return null;
+    const statusLabel = formatEternalRuntimeStatus(snapshot.status);
+    const detail = detailForSnapshot(snapshot, now);
+    return {
+        tone: toneForStatus(snapshot.status),
+        statusLabel,
+        compactDetailLabel: detail.compactDetailLabel,
+        detailLabel: detail.detailLabel,
+        title: titleForSnapshot(snapshot, statusLabel, detail.detailLabel),
+        spinning: snapshot.status === 'patrolling' && snapshot.patrolInFlight,
+    };
+}
+//# sourceMappingURL=EternalRuntimeProjection.js.map

package/dist/core/EternalRuntimeProjection.js.map

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

package/dist/core/EternalRuntimeTelemetry.d.ts

@@ -0,0 +1,63 @@
+export interface EternalRuntimeMetrics {
+    projectId: string;
+    projectCreated: number;
+    projectPaused: number;
+    projectResumed: number;
+    projectBlocked: number;
+    projectCompleted: number;
+    repairCount: number;
+    resetCount: number;
+    replanCount: number;
+    schedulerSwitchCount: number;
+    staleResultRejected: number;
+    blockedDurationMs: number;
+    updatedAt: number;
+}
+export interface EternalAuditEntry {
+    id: string;
+    at: number;
+    kind: string;
+    summary: string;
+    details?: Record<string, unknown>;
+}
+export interface EternalTrendSample {
+    at: number;
+    repairCount: number;
+    resetCount: number;
+    blockedDurationMs: number;
+    staleResultRejected: number;
+    schedulerSwitchCount: number;
+}
+export interface EternalTrendSummary {
+    samples: number;
+    latest?: EternalTrendSample;
+    deltas: {
+        repairs: number;
+        resets: number;
+        blockedDurationMs: number;
+        staleRejected: number;
+        schedulerSwitches: number;
+    };
+}
+export declare class EternalRuntimeTelemetry {
+    private projectsRoot;
+    constructor(workspaceRoot: string);
+    private metricsPath;
+    private auditPath;
+    private trendsPath;
+    loadMetrics(projectId: string): EternalRuntimeMetrics;
+    saveMetrics(metrics: EternalRuntimeMetrics): EternalRuntimeMetrics;
+    increment(projectId: string, patch: Partial<Record<keyof EternalRuntimeMetrics, number>>): EternalRuntimeMetrics;
+    loadAudit(projectId: string): EternalAuditEntry[];
+    recordAudit(projectId: string, entry: Omit<EternalAuditEntry, 'id' | 'at'> & Partial<Pick<EternalAuditEntry, 'id' | 'at'>>): EternalAuditEntry[];
+    loadTrends(projectId: string): EternalTrendSample[];
+    recordTrendSample(projectId: string, at?: number): EternalTrendSample[];
+    summarizeTrends(projectId: string): EternalTrendSummary;
+    applyRetention(projectId: string): {
+        state: string;
+        compactedAuditEntries: number;
+        compactedTrendSamples: number;
+    };
+}
+export default EternalRuntimeTelemetry;
+//# sourceMappingURL=EternalRuntimeTelemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EternalRuntimeTelemetry.d.ts","sourceRoot":"","sources":["../../src/core/EternalRuntimeTelemetry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAoBD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,YAAY,CAAS;gBAEjB,aAAa,EAAE,MAAM;IAIjC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIlB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB;IAQrD,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB;IAQlE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,qBAAqB,EAAE,MAAM,CAAC,CAAC,GAAG,qBAAqB;IAYhH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQjD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,iBAAiB,EAAE;IAgBhJ,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAQnD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAE,MAAmB,GAAG,kBAAkB,EAAE;IAkBnF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAiBvD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,qBAAqB,EAAE,MAAM,CAAC;QAC9B,qBAAqB,EAAE,MAAM,CAAC;KAC/B;CA6BF;AAED,eAAe,uBAAuB,CAAC"}

package/dist/core/EternalRuntimeTelemetry.js

@@ -0,0 +1,153 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { ProjectRetentionPolicy } from './ProjectRetentionPolicy.js';
+function createEmptyMetrics(projectId) {
+    return {
+        projectId,
+        projectCreated: 0,
+        projectPaused: 0,
+        projectResumed: 0,
+        projectBlocked: 0,
+        projectCompleted: 0,
+        repairCount: 0,
+        resetCount: 0,
+        replanCount: 0,
+        schedulerSwitchCount: 0,
+        staleResultRejected: 0,
+        blockedDurationMs: 0,
+        updatedAt: Date.now(),
+    };
+}
+export class EternalRuntimeTelemetry {
+    projectsRoot;
+    constructor(workspaceRoot) {
+        this.projectsRoot = join(workspaceRoot, '.lingxiao', 'projects');
+    }
+    metricsPath(projectId) {
+        return join(this.projectsRoot, projectId, 'metrics.json');
+    }
+    auditPath(projectId) {
+        return join(this.projectsRoot, projectId, 'audit.json');
+    }
+    trendsPath(projectId) {
+        return join(this.projectsRoot, projectId, 'trends.json');
+    }
+    loadMetrics(projectId) {
+        const path = this.metricsPath(projectId);
+        if (!existsSync(path)) {
+            return createEmptyMetrics(projectId);
+        }
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    saveMetrics(metrics) {
+        const path = this.metricsPath(metrics.projectId);
+        mkdirSync(dirname(path), { recursive: true });
+        metrics.updatedAt = Date.now();
+        writeFileSync(path, JSON.stringify(metrics, null, 2) + '\n', 'utf-8');
+        return metrics;
+    }
+    increment(projectId, patch) {
+        const current = this.loadMetrics(projectId);
+        for (const [key, value] of Object.entries(patch)) {
+            if (key === 'projectId' || key === 'updatedAt')
+                continue;
+            const typedKey = key;
+            if (typeof value === 'number' && typeof current[typedKey] === 'number') {
+                current[typedKey] = (current[typedKey] + value);
+            }
+        }
+        return this.saveMetrics(current);
+    }
+    loadAudit(projectId) {
+        const path = this.auditPath(projectId);
+        if (!existsSync(path)) {
+            return [];
+        }
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    recordAudit(projectId, entry) {
+        const path = this.auditPath(projectId);
+        mkdirSync(dirname(path), { recursive: true });
+        const existing = this.loadAudit(projectId);
+        const next = {
+            id: entry.id || `${projectId}-${Date.now()}-${existing.length + 1}`,
+            at: entry.at || Date.now(),
+            kind: entry.kind,
+            summary: entry.summary,
+            details: entry.details,
+        };
+        const updated = [...existing, next].slice(-200);
+        writeFileSync(path, JSON.stringify(updated, null, 2) + '\n', 'utf-8');
+        return updated;
+    }
+    loadTrends(projectId) {
+        const path = this.trendsPath(projectId);
+        if (!existsSync(path)) {
+            return [];
+        }
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    recordTrendSample(projectId, at = Date.now()) {
+        const path = this.trendsPath(projectId);
+        mkdirSync(dirname(path), { recursive: true });
+        const metrics = this.loadMetrics(projectId);
+        const samples = this.loadTrends(projectId);
+        const next = {
+            at,
+            repairCount: metrics.repairCount,
+            resetCount: metrics.resetCount,
+            blockedDurationMs: metrics.blockedDurationMs,
+            staleResultRejected: metrics.staleResultRejected,
+            schedulerSwitchCount: metrics.schedulerSwitchCount,
+        };
+        const updated = [...samples, next].slice(-500);
+        writeFileSync(path, JSON.stringify(updated, null, 2) + '\n', 'utf-8');
+        return updated;
+    }
+    summarizeTrends(projectId) {
+        const samples = this.loadTrends(projectId);
+        const first = samples[0];
+        const latest = samples.at(-1);
+        return {
+            samples: samples.length,
+            latest,
+            deltas: {
+                repairs: latest && first ? latest.repairCount - first.repairCount : 0,
+                resets: latest && first ? latest.resetCount - first.resetCount : 0,
+                blockedDurationMs: latest && first ? latest.blockedDurationMs - first.blockedDurationMs : 0,
+                staleRejected: latest && first ? latest.staleResultRejected - first.staleResultRejected : 0,
+                schedulerSwitches: latest && first ? latest.schedulerSwitchCount - first.schedulerSwitchCount : 0,
+            },
+        };
+    }
+    applyRetention(projectId) {
+        const policy = new ProjectRetentionPolicy();
+        const audit = this.loadAudit(projectId);
+        const trends = this.loadTrends(projectId);
+        const decision = policy.evaluate({
+            archivedAt: Date.now(),
+            transferCount: 0,
+            auditCount: audit.length,
+            trendSamples: trends.length,
+        });
+        let compactedAuditEntries = audit.length;
+        let compactedTrendSamples = trends.length;
+        if (decision.shouldCompactAudit) {
+            const compactedAudit = audit.slice(-50);
+            writeFileSync(this.auditPath(projectId), JSON.stringify(compactedAudit, null, 2) + '\n', 'utf-8');
+            compactedAuditEntries = compactedAudit.length;
+        }
+        if (decision.shouldCompactTransfers) {
+            const compactedTrends = trends.slice(-100);
+            writeFileSync(this.trendsPath(projectId), JSON.stringify(compactedTrends, null, 2) + '\n', 'utf-8');
+            compactedTrendSamples = compactedTrends.length;
+        }
+        return {
+            state: decision.state,
+            compactedAuditEntries,
+            compactedTrendSamples,
+        };
+    }
+}
+export default EternalRuntimeTelemetry;
+//# sourceMappingURL=EternalRuntimeTelemetry.js.map

package/dist/core/EternalRuntimeTelemetry.js.map

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

package/dist/core/EternalSupervisor.d.ts

@@ -0,0 +1,108 @@
+/**
+ * EternalSupervisor — 进程级健康守护
+ *
+ * 多层健康检查：
+ *   Layer 1: platform-aware PID probe — 进程存活
+ *   Layer 2: watchdog 文件新鲜度 — ~/.lingxiao/watchdog.json (< 30s)
+ *   Layer 3: HTTP /health — 服务可达
+ *
+ * 重启策略：
+ *   - 指数退避：1m → 2m → 4m → 8m → 15m (cap)
+ *   - 连续健康 >5min 后重置重启计数器
+ *   - 达到 maxRestarts 后放弃
+ */
+import { type CoreSupervisorStatus } from './StateSemantics.js';
+export interface SupervisorConfig {
+    /** Daemon 健康检查 URL */
+    healthUrl: string;
+    /** 期望的 daemon PID */
+    pid: number;
+    /** 启动 daemon 的回调 (返回新 PID 和 URL) */
+    onRestart: () => Promise<{
+        pid: number;
+        healthUrl: string;
+    }>;
+    /** 放弃前的最大重启次数 (默认 5) */
+    maxRestarts?: number;
+    /** 重启间隔基数 ms (默认 60_000) */
+    baseRestartDelayMs?: number;
+    /** 最大重启间隔 ms (默认 900_000 = 15分钟) */
+    maxRestartDelayMs?: number;
+    /** 健康检查间隔 ms (默认 15_000) */
+    healthCheckIntervalMs?: number;
+    /** 健康检查超时 ms (默认 5_000) */
+    healthCheckTimeoutMs?: number;
+    /** Watchdog 文件路径 (默认 ~/.lingxiao/watchdog.json) */
+    watchdogFile?: string;
+    /** Watchdog 文件最大允许年龄 ms (默认 30_000) */
+    watchdogMaxAgeMs?: number;
+    /** 连续健康多久后重置重启计数器 ms (默认 300_000 = 5min) */
+    healthyResetMs?: number;
+    /**
+     * 软健康（watchdog/HTTP）连续失败多少次才判定不健康并重启（默认 3）。
+     * 防止单次瞬时事件循环阻塞（如重 LLM 流式 / 大文件 IO 卡住一拍心跳）被误判成宕机，
+     * 进而 stopDaemon → SIGTERM 把正在干活的 daemon（连同 worker agent）整窝杀掉。
+     * 注意：Layer 1 进程真死不受此约束，立即重启。
+     */
+    unhealthyThreshold?: number;
+    /** 放弃回调 */
+    onGiveUp?: (reason: string) => void;
+    /** 告警回调 (non-blocking) */
+    onAlert?: (alert: SupervisorAlert) => void;
+}
+export interface SupervisorAlert {
+    type: 'restart' | 'restart_failed' | 'give_up' | 'health_degraded';
+    message: string;
+    attempt?: number;
+    maxRestarts?: number;
+    timestamp: number;
+}
+export interface SupervisorState {
+    status: CoreSupervisorStatus;
+    restartCount: number;
+    lastHealthCheckAt: number;
+    lastHealthyAt: number;
+    currentPid: number;
+    currentHealthUrl: string;
+    /** 连续软健康失败次数（watchdog/HTTP）；达到 unhealthyThreshold 才触发重启 */
+    consecutiveSoftFailures: number;
+}
+export declare class EternalSupervisor {
+    private config;
+    private state;
+    private timer;
+    private stopping;
+    /**
+     * In-flight 重启 Promise（P0 #4 单飞锁）。
+     *
+     * setInterval 每 healthCheckIntervalMs(15s) 触发 healthCheck()，而一次 attemptRestart
+     * 内部 `await sleep(60s/2min/4min/...)` 会让出事件循环，导致同一时间窗内 healthCheck
+     * 反复进入 attemptRestart：每次 restartCount++，几个 tick 后 maxRestarts(5) 被耗尽，
+     * 触发 give_up，daemon 永远不再被拉起。
+     *
+     * 这里把 attemptRestart 串行化：第二次进入直接 await 上次 promise，等其完成。
+     */
+    private restartInFlight;
+    constructor(config: SupervisorConfig);
+    /** 启动守护循环。永不 resolve（除非停止）。 */
+    start(): void;
+    /** 优雅停止 */
+    stop(): void;
+    getState(): Readonly<SupervisorState>;
+    private healthCheck;
+    /**
+     * 软健康检查：Layer 2 watchdog 新鲜度 + Layer 3 HTTP /health。
+     * 不含 Layer 1（进程存活），那是硬失败、由 healthCheck 单独优先处理。
+     */
+    private isSoftHealthy;
+    private isWatchdogFresh;
+    private isProcessAlive;
+    private attemptRestart;
+    private _attemptRestartImpl;
+    private emitAlert;
+}
+/**
+ * Write watchdog heartbeat file. Call this from the daemon process every 10s.
+ */
+export declare function writeWatchdog(filePath?: string): void;
+//# sourceMappingURL=EternalSupervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EternalSupervisor.d.ts","sourceRoot":"","sources":["../../src/core/EternalSupervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,EAAE,MAAM,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW;IACX,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,iBAAiB,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAGZ;IACF,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAS;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe,CAA8B;gBAEzC,MAAM,EAAE,gBAAgB;IAwBpC,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAeb,WAAW;IACX,IAAI,IAAI,IAAI;IASZ,QAAQ,IAAI,QAAQ,CAAC,eAAe,CAAC;YAMvB,WAAW;IA8DzB;;;OAGG;YACW,aAAa;IA0B3B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;YAIR,cAAc;YAed,mBAAmB;IA4CjC,OAAO,CAAC,SAAS;CASlB;AACD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAOrD"}