@lingxiao-office/sdk 1.0.0

package/dist/core/ProcessIdleGuard.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ProcessIdleGuard — 进程级 Idle 自动退出守卫
+ *
+ * 解决问题：凌霄交互模式在终端断开/TUI 退出后进程永生，累积僵尸实例导致 CPU 和 swap 爆炸。
+ *
+ * 设计：
+ * 1. 跟踪"最后有意义活动"时间戳
+ * 2. 所有 session idle + 无 running agent + 无 active connection 超过阈值 → gracefulShutdown
+ * 3. 终端断开（SIGHUP/SIGTERM）后进入"有限存活"模式（短 TTL），给 Web UI 重连留窗口
+ * 4. 可通过配置/环境变量覆盖阈值或禁用
+ *
+ * 资源降级：idle 时自动拉长 HealthMonitor / cleanup loop 周期，降低空转 CPU。
+ */
+export interface ProcessIdleGuardConfig {
+    /** 全 idle 自动退出阈值 (ms)。默认 10 分钟。设为 0 或 Infinity 禁用。 */
+    idleExitMs: number;
+    /** 终端断开后有限存活时间 (ms)。默认 5 分钟。 */
+    detachedTtlMs: number;
+    /** 检查间隔 (ms)。默认 30 秒。 */
+    checkIntervalMs: number;
+    /** 是否禁用自动退出（daemon 模式不退出） */
+    disabled: boolean;
+}
+export type ActivityProbe = () => boolean;
+export declare class ProcessIdleGuard {
+    private config;
+    private lastActivityMs;
+    private detachedAtMs;
+    private timer;
+    private probes;
+    private idleCallbacks;
+    private started;
+    private lastProbeErrorLogMs;
+    constructor(config?: Partial<ProcessIdleGuardConfig>);
+    /**
+     * 注册活跃探针 — 返回 true 表示当前有活跃工作，刷新 idle 计时器
+     */
+    registerProbe(probe: ActivityProbe): void;
+    /**
+     * 注册 idle 回调 — 进入 idle 状态时调用（用于降级资源消耗）
+     */
+    onIdle(callback: (idleMs: number) => void): void;
+    /**
+     * 外部手动刷新活跃时间（用户操作、消息收发等）
+     */
+    touch(): void;
+    /**
+     * 标记终端已断开 — 进入有限存活模式
+     */
+    markDetached(reason?: string): void;
+    /**
+     * 启动 idle 检查循环
+     */
+    start(): void;
+    /**
+     * 停止 idle guard（进程正在 graceful shutdown 时自动调用）
+     */
+    stop(): void;
+    /**
+     * 获取当前 idle 时长 (ms)
+     */
+    getIdleMs(): number;
+    /**
+     * 获取诊断信息
+     */
+    getDiagnostics(): {
+        idleMs: number;
+        detachedAtMs: number | null;
+        config: ProcessIdleGuardConfig;
+        willExitIn: number | null;
+    };
+    private check;
+}
+export declare function getProcessIdleGuard(): ProcessIdleGuard;
+export declare function createProcessIdleGuard(config?: Partial<ProcessIdleGuardConfig>): ProcessIdleGuard;
+//# sourceMappingURL=ProcessIdleGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessIdleGuard.d.ts","sourceRoot":"","sources":["../../src/core/ProcessIdleGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAC;CACnB;AASD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC;AAE1C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAyBpD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIzC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,YAAY,CAAC,MAAM,SAAW,GAAG,IAAI;IASrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,cAAc,IAAI;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,EAAE,sBAAsB,CAAC;QAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B;IAeD,OAAO,CAAC,KAAK;CAyDd;AAKD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,gBAAgB,CAGjG"}

package/dist/core/ProcessIdleGuard.js

@@ -0,0 +1,201 @@
+/**
+ * ProcessIdleGuard — 进程级 Idle 自动退出守卫
+ *
+ * 解决问题：凌霄交互模式在终端断开/TUI 退出后进程永生，累积僵尸实例导致 CPU 和 swap 爆炸。
+ *
+ * 设计：
+ * 1. 跟踪"最后有意义活动"时间戳
+ * 2. 所有 session idle + 无 running agent + 无 active connection 超过阈值 → gracefulShutdown
+ * 3. 终端断开（SIGHUP/SIGTERM）后进入"有限存活"模式（短 TTL），给 Web UI 重连留窗口
+ * 4. 可通过配置/环境变量覆盖阈值或禁用
+ *
+ * 资源降级：idle 时自动拉长 HealthMonitor / cleanup loop 周期，降低空转 CPU。
+ */
+import { gracefulShutdown, isGracefulShuttingDown } from './RuntimeGuards.js';
+import { coreLogger } from './Log.js';
+const DEFAULT_CONFIG = {
+    idleExitMs: 10 * 60 * 1000, // 10 分钟
+    detachedTtlMs: 5 * 60 * 1000, // 5 分钟
+    checkIntervalMs: 30 * 1000, // 30 秒
+    disabled: false,
+};
+export class ProcessIdleGuard {
+    config;
+    lastActivityMs = Date.now();
+    detachedAtMs = null;
+    timer = null;
+    probes = [];
+    idleCallbacks = [];
+    started = false;
+    lastProbeErrorLogMs = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // 环境变量覆盖
+        const envIdleMs = process.env.LINGXIAO_IDLE_EXIT_MS;
+        if (envIdleMs) {
+            const parsed = parseInt(envIdleMs, 10);
+            if (!isNaN(parsed) && parsed >= 0)
+                this.config.idleExitMs = parsed;
+        }
+        const envDetachedTtlMs = process.env.LINGXIAO_DETACHED_TTL_MS;
+        if (envDetachedTtlMs) {
+            const parsed = parseInt(envDetachedTtlMs, 10);
+            if (!isNaN(parsed) && parsed >= 0)
+                this.config.detachedTtlMs = parsed;
+        }
+        const envCheckIntervalMs = process.env.LINGXIAO_IDLE_CHECK_INTERVAL_MS;
+        if (envCheckIntervalMs) {
+            const parsed = parseInt(envCheckIntervalMs, 10);
+            if (!isNaN(parsed) && parsed > 0)
+                this.config.checkIntervalMs = parsed;
+        }
+        const envDisabled = process.env.LINGXIAO_IDLE_EXIT_DISABLED;
+        if (envDisabled === '1' || envDisabled === 'true') {
+            this.config.disabled = true;
+        }
+    }
+    /**
+     * 注册活跃探针 — 返回 true 表示当前有活跃工作，刷新 idle 计时器
+     */
+    registerProbe(probe) {
+        this.probes.push(probe);
+    }
+    /**
+     * 注册 idle 回调 — 进入 idle 状态时调用（用于降级资源消耗）
+     */
+    onIdle(callback) {
+        this.idleCallbacks.push(callback);
+    }
+    /**
+     * 外部手动刷新活跃时间（用户操作、消息收发等）
+     */
+    touch() {
+        this.lastActivityMs = Date.now();
+        // 如果从 detached 模式恢复了连接
+        if (this.detachedAtMs !== null) {
+            this.detachedAtMs = null;
+        }
+    }
+    /**
+     * 标记终端已断开 — 进入有限存活模式
+     */
+    markDetached(reason = 'signal') {
+        if (this.detachedAtMs === null) {
+            this.detachedAtMs = Date.now();
+            coreLogger.warn(`[ProcessIdleGuard] Terminal detached (${reason}); will auto-exit in ${Math.round(this.config.detachedTtlMs / 1000)}s unless activity resumes`);
+        }
+    }
+    /**
+     * 启动 idle 检查循环
+     */
+    start() {
+        if (this.started || this.config.disabled)
+            return;
+        this.started = true;
+        this.lastActivityMs = Date.now();
+        this.timer = setInterval(() => {
+            this.check();
+        }, this.config.checkIntervalMs);
+        // 不阻止进程自然退出
+        this.timer.unref();
+    }
+    /**
+     * 停止 idle guard（进程正在 graceful shutdown 时自动调用）
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.started = false;
+    }
+    /**
+     * 获取当前 idle 时长 (ms)
+     */
+    getIdleMs() {
+        return Date.now() - this.lastActivityMs;
+    }
+    /**
+     * 获取诊断信息
+     */
+    getDiagnostics() {
+        const idleMs = this.getIdleMs();
+        let willExitIn = null;
+        if (!this.config.disabled && this.config.idleExitMs > 0 && this.config.idleExitMs < Infinity) {
+            if (this.detachedAtMs !== null) {
+                willExitIn = Math.max(0, this.config.detachedTtlMs - (Date.now() - this.detachedAtMs));
+            }
+            else {
+                willExitIn = Math.max(0, this.config.idleExitMs - idleMs);
+            }
+        }
+        return { idleMs, detachedAtMs: this.detachedAtMs, config: this.config, willExitIn };
+    }
+    check() {
+        if (this.config.disabled || isGracefulShuttingDown())
+            return;
+        const now = Date.now();
+        // 探针检查：任何探针返回 true → 刷新活跃
+        for (const probe of this.probes) {
+            try {
+                if (probe()) {
+                    this.lastActivityMs = now;
+                    return; // 有活跃工作，不需要继续检查
+                }
+            }
+            catch (error) {
+                // 探针异常不能让 idle guard 自身成为 uncaughtException 源；限频记录，方便排查误判 idle。
+                if (now - this.lastProbeErrorLogMs >= 60_000) {
+                    this.lastProbeErrorLogMs = now;
+                    coreLogger.warn(`[ProcessIdleGuard] Activity probe failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+        const idleMs = now - this.lastActivityMs;
+        // 通知 idle 回调（用于资源降级）
+        if (idleMs > this.config.checkIntervalMs) {
+            for (const cb of this.idleCallbacks) {
+                try {
+                    cb(idleMs);
+                }
+                catch { /* ignore */ }
+            }
+        }
+        // 检查是否该退出
+        let shouldExit = false;
+        let reason = '';
+        if (this.detachedAtMs !== null) {
+            // 终端已断开 — 使用短 TTL
+            const detachedMs = now - this.detachedAtMs;
+            if (detachedMs >= this.config.detachedTtlMs) {
+                shouldExit = true;
+                reason = `terminal detached ${Math.round(detachedMs / 1000)}s ago (TTL=${Math.round(this.config.detachedTtlMs / 1000)}s)`;
+            }
+        }
+        else {
+            // 正常 idle 超时
+            if (this.config.idleExitMs > 0 && this.config.idleExitMs < Infinity && idleMs >= this.config.idleExitMs) {
+                shouldExit = true;
+                reason = `all sessions idle for ${Math.round(idleMs / 1000)}s (threshold=${Math.round(this.config.idleExitMs / 1000)}s)`;
+            }
+        }
+        if (shouldExit) {
+            coreLogger.info(`[ProcessIdleGuard] Auto-exit: ${reason}; idleMs=${idleMs}; detachedAtMs=${this.detachedAtMs ?? 'null'}; probes=${this.probes.length}`);
+            this.stop();
+            void gracefulShutdown(0, 10_000);
+        }
+    }
+}
+/** 进程级单例 */
+let _instance = null;
+export function getProcessIdleGuard() {
+    if (!_instance) {
+        _instance = new ProcessIdleGuard();
+    }
+    return _instance;
+}
+export function createProcessIdleGuard(config) {
+    _instance = new ProcessIdleGuard(config);
+    return _instance;
+}
+//# sourceMappingURL=ProcessIdleGuard.js.map

package/dist/core/ProcessIdleGuard.js.map

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

package/dist/core/ProcessOrphanCleaner.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ProcessOrphanCleaner — 启动时清理同源僵尸凌霄实例
+ *
+ * 解决问题：用户反复启动 lingxiao 但旧实例不退出，导致 N 个进程累积。
+ *
+ * 策略：
+ * 1. 读取 PidRegistry，找到同 workspace 的其他 interactive 实例
+ * 2. 对其发 SIGTERM，给 5s 优雅退出
+ * 3. 超时未退的发 SIGKILL
+ * 4. 清理 PidRegistry 残留
+ *
+ * 安全性：
+ * - 只清理 kind=interactive 且同 workspace 的实例（不碰 daemon、worker、external-agent）
+ * - 通过 PidRegistry 的 isSamePidEntry 校验防止 PID 重用误杀
+ * - 不清理刚启动 <5s 的进程（避免并发启动竞态）
+ */
+export interface OrphanCleanResult {
+    /** 清理的 PID 列表 */
+    cleaned: number[];
+    /** 跳过的（仍活跃或正在使用） */
+    skipped: number[];
+    /** 清理失败的 */
+    failed: number[];
+}
+/**
+ * 清理同 workspace 的僵尸交互实例
+ *
+ * @param currentPid 当前进程 PID（不杀自己）
+ * @param workspace 当前工作目录
+ * @param gracePeriodMs SIGTERM 后等待时间，默认 3s
+ */
+export declare function cleanOrphanInstances(currentPid: number, workspace: string, gracePeriodMs?: number): Promise<OrphanCleanResult>;
+/**
+ * 轻量检查：返回同 workspace 的其他存活实例数（不执行清理）
+ */
+export declare function countOrphanInstances(currentPid: number, workspace: string): number;
+//# sourceMappingURL=ProcessOrphanCleaner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessOrphanCleaner.d.ts","sourceRoot":"","sources":["../../src/core/ProcessOrphanCleaner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAa,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA+D5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQlF"}

package/dist/core/ProcessOrphanCleaner.js

@@ -0,0 +1,106 @@
+/**
+ * ProcessOrphanCleaner — 启动时清理同源僵尸凌霄实例
+ *
+ * 解决问题：用户反复启动 lingxiao 但旧实例不退出，导致 N 个进程累积。
+ *
+ * 策略：
+ * 1. 读取 PidRegistry，找到同 workspace 的其他 interactive 实例
+ * 2. 对其发 SIGTERM，给 5s 优雅退出
+ * 3. 超时未退的发 SIGKILL
+ * 4. 清理 PidRegistry 残留
+ *
+ * 安全性：
+ * - 只清理 kind=interactive 且同 workspace 的实例（不碰 daemon、worker、external-agent）
+ * - 通过 PidRegistry 的 isSamePidEntry 校验防止 PID 重用误杀
+ * - 不清理刚启动 <5s 的进程（避免并发启动竞态）
+ */
+import { PidRegistry } from './PidRegistry.js';
+import { killProcess, processExists } from '../utils/platform.js';
+import { coreLogger } from './Log.js';
+/**
+ * 清理同 workspace 的僵尸交互实例
+ *
+ * @param currentPid 当前进程 PID（不杀自己）
+ * @param workspace 当前工作目录
+ * @param gracePeriodMs SIGTERM 后等待时间，默认 3s
+ */
+export async function cleanOrphanInstances(currentPid, workspace, gracePeriodMs = 3000) {
+    const result = { cleaned: [], skipped: [], failed: [] };
+    const allEntries = PidRegistry.listAll();
+    const candidates = allEntries.filter((entry) => {
+        // 只处理交互/bg 实例
+        if (entry.kind !== 'interactive' && entry.kind !== 'bg')
+            return false;
+        // 不杀自己
+        if (entry.pid === currentPid)
+            return false;
+        // 同 workspace
+        if (entry.cwd !== workspace)
+            return false;
+        // 跳过刚启动 <10s 的（避免竞态）
+        if (Date.now() - entry.startedAt < 10_000)
+            return false;
+        return true;
+    });
+    if (candidates.length === 0)
+        return result;
+    coreLogger.info(`[OrphanCleaner] 发现 ${candidates.length} 个同目录旧实例，尝试清理...`);
+    // Phase 1: SIGTERM
+    const termTargets = [];
+    for (const entry of candidates) {
+        if (!processExists(entry.pid)) {
+            // 已经不存在了，清理注册表
+            PidRegistry.unregister(entry.pid);
+            result.cleaned.push(entry.pid);
+            continue;
+        }
+        try {
+            await killProcess(entry.pid, 'SIGTERM');
+            termTargets.push(entry.pid);
+        }
+        catch {
+            result.failed.push(entry.pid);
+        }
+    }
+    if (termTargets.length === 0)
+        return result;
+    // Phase 2: 等待 gracePeriod 后检查
+    await new Promise(resolve => setTimeout(resolve, gracePeriodMs));
+    for (const pid of termTargets) {
+        if (!processExists(pid)) {
+            PidRegistry.unregister(pid);
+            result.cleaned.push(pid);
+        }
+        else {
+            // 还活着 → SIGKILL
+            try {
+                await killProcess(pid, 'SIGKILL');
+                PidRegistry.unregister(pid);
+                result.cleaned.push(pid);
+            }
+            catch {
+                result.failed.push(pid);
+            }
+        }
+    }
+    if (result.cleaned.length > 0) {
+        coreLogger.info(`[OrphanCleaner] 已清理 ${result.cleaned.length} 个僵尸实例: PIDs=${result.cleaned.join(',')}`);
+    }
+    return result;
+}
+/**
+ * 轻量检查：返回同 workspace 的其他存活实例数（不执行清理）
+ */
+export function countOrphanInstances(currentPid, workspace) {
+    const allEntries = PidRegistry.listAll();
+    return allEntries.filter(entry => {
+        if (entry.kind !== 'interactive' && entry.kind !== 'bg')
+            return false;
+        if (entry.pid === currentPid)
+            return false;
+        if (entry.cwd !== workspace)
+            return false;
+        return true;
+    }).length;
+}
+//# sourceMappingURL=ProcessOrphanCleaner.js.map

package/dist/core/ProcessOrphanCleaner.js.map

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

package/dist/core/ProcessSelfProtection.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ProcessSelfProtection — 进程信号安全防护
+ *
+ * 始终启用的底线守卫，不依赖 hardened mode 配置。
+ *
+ * 设计原则（确定性，非关键词黑名单）：
+ *   信号类命令（kill / pkill / killall）必须以**字面数字 PID** 枚举目标。
+ *   任何在运行时解析目标、按模式匹配、或针对进程组的，一律拦截——
+ *   因为这类命令无法静态证明只杀目标，可能误杀全系统进程（"杀光所有"）。
+ *
+ * 这条单一谓词结构性覆盖所有绕过路径，不枚举任何进程发现工具名：
+ *   - pkill / killall（模式匹配选择器，非字面 PID）
+ *   - kill $(...) / 反引号 / $变量 / ${...}（运行时解析）
+ *   - ... | xargs kill / xargs kill ...（从 stdin 运行时喂 PID）
+ *   - find ... -exec kill ... {}（{} 占位符运行时替换）
+ *   - kill -1 / kill -- -PGID / kill -<负数>（进程组 / 杀全部）
+ *   - kill $PPID / kill $$ / /proc/.../ppid（自杀/杀父）
+ *
+ * 放行：
+ *   - kill <字面正数 PID>（agent 可管理任意明确进程，含重启外部 dev server）
+ *   - kill -0（仅探活，无副作用）
+ *   - kill -l（列信号名）/ kill 无目标（无害）
+ *   - 纯只读探查：ps / lsof / pgrep（非信号命令，快速路径放行）
+ *
+ * 例外：protectedPids（主进程 + worker 子进程）即便以字面 PID 命中也拦截——
+ * 这些核心进程有专用停止机制（stop_agent / graceful shutdown）。
+ */
+/** 启动时注册主进程 */
+export declare function registerMainProcess(): void;
+/** Worker 子进程启动时注册 */
+export declare function registerProtectedPid(pid: number): void;
+/** Worker 退出时注销 */
+export declare function unregisterProtectedPid(pid: number): void;
+/** 获取当前受保护 PID 集合（测试用） */
+export declare function getProtectedPids(): ReadonlySet<number>;
+/** 重置（仅测试用） */
+export declare function _resetForTest(): void;
+/**
+ * 检测命令是否试图以不安全方式发送进程信号。
+ * 返回 null 表示安全，返回错误描述字符串表示拦截。
+ *
+ * 此函数始终启用，不受 hardened mode 开关控制。
+ */
+export declare function validateCommandForProcessKill(command: string): string | null;
+//# sourceMappingURL=ProcessSelfProtection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessSelfProtection.d.ts","sourceRoot":"","sources":["../../src/core/ProcessSelfProtection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,eAAe;AACf,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,sBAAsB;AACtB,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAItD;AAED,mBAAmB;AACnB,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,IAAI,WAAW,CAAC,MAAM,CAAC,CAEtD;AAED,eAAe;AACf,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAsBD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB5E"}