@xioflow/kernel 0.1.0

package/dist/driver/node-driver.js

@@ -0,0 +1,404 @@
+import { spawn, execFileSync } from 'node:child_process';
+export class NodePlatformDriver {
+    name = 'node-default';
+    capabilities = {
+        // Windows 无进程组语义：process.kill(-pid) 会失败并退化为只杀直接子进程，
+        // 所以必须如实声明不支持，让准入期拒绝 hard 请求而不是静默降级。
+        processGroupKill: process.platform !== 'win32',
+        accurateStartTime: true,
+        memoryHardLimit: false, // macOS/Node.js 默认不支持进程树 cgroup 内存硬限
+        pidsLimit: false,
+        cpuLimit: false,
+        // 后代枚举依赖 ps(1)：Windows 上无法枚举，不能谎报 full。
+        descendantEnumeration: process.platform === 'win32' ? 'none' : 'full',
+    };
+    // 内存中追踪当前驱动启动的所有活跃进程
+    activeHandles = new Map();
+    // 持续累积后代 PID 集合：leaderPid -> Set<descendantPid>
+    cumulativeDescendantsMap = new Map();
+    // 活跃进程树监控定时器：leaderPid -> Timeout
+    descendantPollers = new Map();
+    async spawn(command) {
+        return new Promise((resolve, reject) => {
+            let child;
+            try {
+                // envWhiteList 是精确语义：给了什么就是什么，不静默补 PATH。
+                const childEnv = command.envWhiteList
+                    ? { ...command.envWhiteList }
+                    : command.inheritEnv === false
+                        ? {}
+                        : process.env;
+                child = spawn(command.execPath, command.args, {
+                    cwd: command.cwd,
+                    env: childEnv,
+                    detached: true,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+            }
+            catch (err) {
+                return reject(err);
+            }
+            let hasSpawned = false;
+            child.on('error', (err) => {
+                if (!hasSpawned) {
+                    reject(err);
+                }
+            });
+            child.on('spawn', () => {
+                hasSpawned = true;
+                const pid = child.pid;
+                const startTimeMonotonic = Number(process.hrtime.bigint() / 1000n);
+                const identity = {
+                    pid,
+                    pgid: pid,
+                    startTimeMonotonic,
+                    spawnTime: new Date().toISOString(),
+                    commandFingerprint: `${command.execPath}:${command.args.join(' ')}`,
+                };
+                const cumSet = new Set();
+                this.cumulativeDescendantsMap.set(pid, cumSet);
+                const scanDescendants = () => {
+                    const currentCum = this.cumulativeDescendantsMap.get(pid);
+                    if (!currentCum)
+                        return;
+                    const tree = this.getProcessTree(pid);
+                    for (const d of tree.allDescendants) {
+                        currentCum.add(d);
+                    }
+                };
+                scanDescendants();
+                const poller = setInterval(scanDescendants, 30);
+                if (poller.unref)
+                    poller.unref();
+                this.descendantPollers.set(pid, poller);
+                const exitPromise = new Promise((exitResolve) => {
+                    const cleanup = () => {
+                        const p = this.descendantPollers.get(pid);
+                        if (p) {
+                            clearInterval(p);
+                            this.descendantPollers.delete(pid);
+                        }
+                        this.activeHandles.delete(pid);
+                    };
+                    child.on('close', (exitCode, signal) => {
+                        cleanup();
+                        exitResolve({ exitCode, signal });
+                    });
+                    child.on('error', () => {
+                        cleanup();
+                        exitResolve({ exitCode: 1, signal: null });
+                    });
+                });
+                const handle = {
+                    identity,
+                    stdout: child.stdout,
+                    stderr: child.stderr,
+                    onExit: exitPromise,
+                    rawProcess: child,
+                };
+                this.activeHandles.set(pid, { handle, child, startTime: startTimeMonotonic });
+                resolve(handle);
+            });
+        });
+    }
+    async verifyIdentity(identity) {
+        // 1. 检查操作系统中该 PID 是否存活
+        if (!this.isPidAlive(identity.pid)) {
+            return 'not_original_process';
+        }
+        // 2. 核对内存中本驱动登记的启动记录
+        const tracked = this.activeHandles.get(identity.pid);
+        if (tracked) {
+            if (identity.startTimeMonotonic &&
+                Math.abs(tracked.startTime - identity.startTimeMonotonic) < 10000 // 10ms 误差内
+            ) {
+                return 'is_original_process';
+            }
+            return 'cannot_determine';
+        }
+        // 3. 跨崩溃/重启进程恢复：查 OS 进程命令行指纹验证真实身份
+        if (identity.commandFingerprint) {
+            try {
+                const cmdLine = execFileSync('ps', ['-p', String(identity.pid), '-o', 'command='], {
+                    encoding: 'utf8',
+                    stdio: ['ignore', 'pipe', 'ignore'],
+                }).trim();
+                const baseExec = identity.commandFingerprint.split(':')[0];
+                if (cmdLine && cmdLine.includes(baseExec)) {
+                    return 'is_original_process';
+                }
+            }
+            catch {
+                return 'cannot_determine';
+            }
+        }
+        return 'cannot_determine';
+    }
+    async terminate(identity, graceMs = 2000) {
+        const pid = identity.pid;
+        const cumSet = this.cumulativeDescendantsMap.get(pid);
+        // 1. 终止前先枚举后代进程树，捕获所有组内进程与逃逸进程
+        const initialTree = this.getProcessTree(pid);
+        const allTrackedPids = new Set([pid, ...initialTree.allDescendants]);
+        if (cumSet) {
+            for (const cp of cumSet) {
+                allTrackedPids.add(cp);
+            }
+        }
+        // 若原主进程已死且无任何后代存活，直接收尾
+        const aliveBeforeSignals = Array.from(allTrackedPids).filter((p) => p !== pid && this.isPidAlive(p));
+        if (!this.isPidAlive(pid) && aliveBeforeSignals.length === 0) {
+            this.cumulativeDescendantsMap.delete(pid);
+            return { stopped: true, scope: 'direct_child' };
+        }
+        // 第一阶段：SIGINT 中断信号至整组
+        this.sendSignalToGroup(pid, 'SIGINT');
+        let exited = await this.waitForGroupAndPids(pid, initialTree.inGroupDescendants, graceMs);
+        if (!exited) {
+            // 第二阶段：SIGTERM 终止信号至整组
+            this.sendSignalToGroup(pid, 'SIGTERM');
+            exited = await this.waitForGroupAndPids(pid, initialTree.inGroupDescendants, 1000);
+        }
+        if (!exited) {
+            // 第三阶段：SIGKILL 强制终止至整组
+            this.sendSignalToGroup(pid, 'SIGKILL');
+            exited = await this.waitForGroupAndPids(pid, initialTree.inGroupDescendants, 1000);
+        }
+        // 组空后再次扫描后代，核查是否有任何残留进程或 setsid 逃逸孤儿
+        const postTree = this.getProcessTree(pid);
+        for (const p of postTree.allDescendants) {
+            allTrackedPids.add(p);
+        }
+        if (cumSet) {
+            for (const cp of cumSet) {
+                allTrackedPids.add(cp);
+            }
+        }
+        // 探活所有曾属于该进程树的后代
+        const aliveResiduals = Array.from(allTrackedPids).filter((p) => this.isPidAlive(p));
+        if (aliveResiduals.length > 0) {
+            // 存在逃逸或残留孤儿，如实标记 stopped: false 与 residualPids
+            return {
+                stopped: false,
+                scope: 'unknown',
+                residualPids: aliveResiduals,
+                errorDetails: `Residual or escaped processes still alive after termination: ${aliveResiduals.join(', ')}`,
+            };
+        }
+        this.cumulativeDescendantsMap.delete(pid);
+        return { stopped: true, scope: 'process_group' };
+    }
+    async sampleMetrics(identity) {
+        try {
+            const tree = this.getProcessTree(identity.pid);
+            const targetPids = [identity.pid, ...tree.allDescendants].filter((p) => this.isPidAlive(p));
+            if (targetPids.length === 0) {
+                return { rssBytes: 0, pidsCount: 0, cpuTimeMs: 0 };
+            }
+            const out = execFileSync('ps', ['-p', targetPids.join(','), '-o', 'pid=,rss=,time='], {
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            let totalRssKb = 0;
+            let totalCpuMs = 0;
+            let count = 0;
+            const lines = out.split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                const parts = trimmed.split(/\s+/);
+                if (parts.length >= 3) {
+                    const rssKb = parseInt(parts[1], 10) || 0;
+                    const timeStr = parts[2];
+                    totalRssKb += rssKb;
+                    totalCpuMs += this.parseCpuTimeToMs(timeStr);
+                    count++;
+                }
+            }
+            return {
+                rssBytes: totalRssKb * 1024,
+                pidsCount: count || targetPids.length,
+                cpuTimeMs: totalCpuMs,
+            };
+        }
+        catch {
+            return { rssBytes: 0, pidsCount: 0, cpuTimeMs: 0 };
+        }
+    }
+    getProcessTree(leaderPid) {
+        const allProcs = this.getAllProcesses();
+        const procsByPid = new Map();
+        const childrenMap = new Map();
+        for (const p of allProcs) {
+            procsByPid.set(p.pid, p);
+            const list = childrenMap.get(p.ppid);
+            if (list) {
+                list.push(p);
+            }
+            else {
+                childrenMap.set(p.ppid, [p]);
+            }
+        }
+        const allDescendants = [];
+        const inGroupDescendants = [];
+        const escapedDescendants = [];
+        const cumSet = this.cumulativeDescendantsMap.get(leaderPid);
+        const historicalDescendants = cumSet ? Array.from(cumSet) : [];
+        // 初始队列包括 leaderPid 以及所有已知历史后代（防止中间父进程提前退出导致孙进程 PPID 变为 1 发生断链漏报）
+        const queue = [leaderPid];
+        const visited = new Set([leaderPid]);
+        for (const hPid of historicalDescendants) {
+            if (!visited.has(hPid)) {
+                visited.add(hPid);
+                queue.push(hPid);
+                const pInfo = procsByPid.get(hPid);
+                if (pInfo) {
+                    allDescendants.push(hPid);
+                    if (pInfo.pgid === leaderPid) {
+                        inGroupDescendants.push(hPid);
+                    }
+                    else {
+                        escapedDescendants.push(hPid);
+                    }
+                }
+            }
+        }
+        while (queue.length > 0) {
+            const currentPid = queue.shift();
+            const children = childrenMap.get(currentPid) || [];
+            for (const child of children) {
+                if (!visited.has(child.pid)) {
+                    visited.add(child.pid);
+                    allDescendants.push(child.pid);
+                    if (child.pgid === leaderPid) {
+                        inGroupDescendants.push(child.pid);
+                    }
+                    else {
+                        escapedDescendants.push(child.pid);
+                    }
+                    queue.push(child.pid);
+                }
+            }
+        }
+        // 扫描可能已由于中间父进程退出导致 PPID 变为 1、但仍同属于 leader 进程组的残留进程
+        for (const p of allProcs) {
+            if (p.pgid === leaderPid && !visited.has(p.pid)) {
+                visited.add(p.pid);
+                allDescendants.push(p.pid);
+                inGroupDescendants.push(p.pid);
+            }
+        }
+        if (cumSet) {
+            for (const d of allDescendants) {
+                cumSet.add(d);
+            }
+        }
+        return { allDescendants, inGroupDescendants, escapedDescendants };
+    }
+    getAllProcesses() {
+        try {
+            const output = execFileSync('ps', ['-A', '-o', 'pid=,ppid=,pgid=,command='], {
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            const lines = output.split('\n');
+            const procs = [];
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                const match = trimmed.match(/^(\d+)\s+(\d+)\s+(\d+)\s+(.*)$/);
+                if (match) {
+                    procs.push({
+                        pid: parseInt(match[1], 10),
+                        ppid: parseInt(match[2], 10),
+                        pgid: parseInt(match[3], 10),
+                        command: match[4],
+                    });
+                }
+            }
+            return procs;
+        }
+        catch {
+            return [];
+        }
+    }
+    isPidAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (err) {
+            return err.code === 'EPERM';
+        }
+    }
+    isGroupAlive(pgid) {
+        try {
+            process.kill(-pgid, 0);
+            return true;
+        }
+        catch (err) {
+            return err.code === 'EPERM';
+        }
+    }
+    sendSignalToGroup(pid, signal) {
+        try {
+            process.kill(-pid, signal);
+        }
+        catch {
+            try {
+                process.kill(pid, signal);
+            }
+            catch { }
+        }
+    }
+    async waitForGroupAndPids(pid, inGroupPids, timeoutMs) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const grpAlive = this.isGroupAlive(pid);
+            const procAlive = this.isPidAlive(pid);
+            const inGrpAlive = inGroupPids.some((p) => this.isPidAlive(p));
+            if (!grpAlive && !procAlive && !inGrpAlive) {
+                return true;
+            }
+            await new Promise((r) => setTimeout(r, 50));
+        }
+        const stillGrp = this.isGroupAlive(pid);
+        const stillProc = this.isPidAlive(pid);
+        const stillInGrp = inGroupPids.some((p) => this.isPidAlive(p));
+        return !stillGrp && !stillProc && !stillInGrp;
+    }
+    parseCpuTimeToMs(timeStr) {
+        try {
+            let days = 0;
+            let rest = timeStr;
+            if (rest.includes('-')) {
+                const daySplit = rest.split('-');
+                days = parseInt(daySplit[0], 10) || 0;
+                rest = daySplit[1];
+            }
+            const parts = rest.split(':');
+            let hours = 0;
+            let minutes = 0;
+            let seconds = 0;
+            if (parts.length === 3) {
+                hours = parseInt(parts[0], 10) || 0;
+                minutes = parseInt(parts[1], 10) || 0;
+                seconds = parseFloat(parts[2]) || 0;
+            }
+            else if (parts.length === 2) {
+                minutes = parseInt(parts[0], 10) || 0;
+                seconds = parseFloat(parts[1]) || 0;
+            }
+            else if (parts.length === 1) {
+                seconds = parseFloat(parts[0]) || 0;
+            }
+            return Math.round(days * 86400000 + hours * 3600000 + minutes * 60000 + seconds * 1000);
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=node-driver.js.map

package/dist/driver/node-driver.js.map

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

package/dist/driver/types.d.ts

@@ -0,0 +1,60 @@
+import { IdentityVerificationResult } from '../types.js';
+export interface StructuredCommand {
+    execPath: string;
+    args: string[];
+    cwd: string;
+    /**
+     * 显式环境变量白名单：提供时按原样使用，绝不注入宿主 PATH。
+     * 需要 PATH 时请自行放入白名单（发行版通常有更严格的密钥剔除策略）。
+     */
+    envWhiteList?: Record<string, string>;
+    /**
+     * 未提供 envWhiteList 时是否继承宿主 process.env，默认 true。
+     * 设为 false 时子进程得到空环境（故障关闭，适合安全敏感调用方）。
+     */
+    inheritEnv?: boolean;
+}
+export interface ProcessIdentity {
+    pid: number;
+    pgid?: number;
+    startTimeMonotonic?: number;
+    spawnTime: string;
+    commandFingerprint?: string;
+}
+export interface StopProcessResult {
+    stopped: boolean;
+    scope: 'direct_child' | 'process_group' | 'containment_cgroup' | 'unknown';
+    residualPids?: number[];
+    errorDetails?: string;
+}
+export interface ManagedProcessHandle {
+    identity: ProcessIdentity;
+    stdout: NodeJS.ReadableStream;
+    stderr: NodeJS.ReadableStream;
+    onExit: Promise<{
+        exitCode: number | null;
+        signal: NodeJS.Signals | null;
+    }>;
+    rawProcess?: any;
+}
+export interface PlatformCapabilities {
+    processGroupKill: boolean;
+    accurateStartTime: boolean;
+    memoryHardLimit: boolean;
+    pidsLimit: boolean;
+    cpuLimit: boolean;
+    descendantEnumeration: 'full' | 'cgroup' | 'none';
+}
+export interface PlatformDriver {
+    name: string;
+    capabilities: PlatformCapabilities;
+    spawn(command: StructuredCommand): Promise<ManagedProcessHandle>;
+    verifyIdentity(identity: ProcessIdentity): Promise<IdentityVerificationResult>;
+    terminate(identity: ProcessIdentity, graceMs: number): Promise<StopProcessResult>;
+    sampleMetrics?(identity: ProcessIdentity): Promise<{
+        rssBytes: number;
+        pidsCount: number;
+        cpuTimeMs: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/driver/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/driver/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAkB,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,GAAG,eAAe,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC5E,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,oBAAoB,CAAC;IACnC,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjE,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC/E,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClF,aAAa,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChH"}

package/dist/driver/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/driver/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/driver/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './domain.js';
+export * from './store/schema.js';
+export * from './store/sqlite.js';
+export * from './driver/types.js';
+export * from './driver/node-driver.js';
+export * from './supervisor/supervisor.js';
+export * from './recovery/engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './domain.js';
+export * from './store/schema.js';
+export * from './store/sqlite.js';
+export * from './driver/types.js';
+export * from './driver/node-driver.js';
+export * from './supervisor/supervisor.js';
+export * from './recovery/engine.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/recovery/engine.d.ts

@@ -0,0 +1,19 @@
+import { ExecutionDomain } from '../domain.js';
+import { PlatformDriver } from '../driver/types.js';
+export interface RecoveryReport {
+    recoveredOperations: {
+        opId: string;
+        action: 'cleaned_unspawned' | 'stopped_alive_process' | 'marked_dead' | 'isolated_indeterminate';
+        resourcesReleased: boolean;
+    }[];
+}
+export declare class RecoveryEngine {
+    private readonly domain;
+    private readonly driver;
+    constructor(domain: ExecutionDomain, driver: PlatformDriver);
+    /**
+     * 恢复协议：对未终结操作现场核查并安全推进至终态或保留隔离
+     */
+    recover(): Promise<RecoveryReport>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/recovery/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/recovery/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,mBAAmB,GAAG,uBAAuB,GAAG,aAAa,GAAG,wBAAwB,CAAC;QACjG,iBAAiB,EAAE,OAAO,CAAC;KAC5B,EAAE,CAAC;CACL;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFzB,YACmB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,cAAc,EACrC;IAEJ;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAqH9C;CACF"}