opencode-bridge 2.9.0-beta

package/dist/reliability/process-guard.js

@@ -0,0 +1,344 @@
+import fs from 'node:fs/promises';
+import net from 'node:net';
+import os from 'node:os';
+import process from 'node:process';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export async function checkOpenCodeSingleInstance(options) {
+    const timeoutMs = options.timeoutMs ?? 1200;
+    const processKeywords = options.processKeywords ?? ['opencode'];
+    const processAliveChecker = options.processAliveChecker ?? isProcessAlive;
+    const portProbe = options.portProbe ?? probeTcpPort;
+    const pidFromFile = await readPidFile(options.pidFilePath);
+    const pidAlive = pidFromFile !== null ? await processAliveChecker(pidFromFile) : false;
+    const probeResult = await portProbe(options.host, options.port, timeoutMs);
+    const processList = options.processListProvider
+        ? await options.processListProvider()
+        : await listOpenCodeProcesses(processKeywords);
+    const keywordMatched = processList.filter(item => matchesProcessKeywords(item, processKeywords));
+    const runningPidSet = new Set(keywordMatched.map(item => item.pid));
+    if (pidFromFile !== null && pidAlive) {
+        runningPidSet.add(pidFromFile);
+    }
+    const runningPids = Array.from(runningPidSet).sort((left, right) => left - right);
+    const conflictPids = runningPids.filter(pid => pidFromFile === null || pid !== pidFromFile);
+    if (runningPids.length > 1) {
+        return {
+            status: 'single-instance-violation',
+            pidFromFile,
+            pidAlive,
+            portOpen: probeResult.isOpen,
+            probeReason: probeResult.reason,
+            runningPids,
+            conflictPids,
+        };
+    }
+    if (!pidAlive && !probeResult.isOpen && runningPids.length === 0) {
+        return {
+            status: 'not-running',
+            pidFromFile,
+            pidAlive,
+            portOpen: probeResult.isOpen,
+            probeReason: probeResult.reason,
+            runningPids,
+            conflictPids,
+        };
+    }
+    return {
+        status: 'ok',
+        pidFromFile,
+        pidAlive,
+        portOpen: probeResult.isOpen,
+        probeReason: probeResult.reason,
+        runningPids,
+        conflictPids,
+    };
+}
+export async function acquireRescueLock(options) {
+    const staleMs = options.staleMs ?? 30_000;
+    const updateMs = options.updateMs ?? Math.max(1_000, Math.floor(staleMs / 2));
+    const getNow = options.now ?? Date.now;
+    const lockPath = `${options.lockTargetPath}.lock`;
+    const ownerFilePath = `${lockPath}/owner.json`;
+    const acquired = await tryAcquireLockPath(lockPath, staleMs, getNow);
+    if (!acquired) {
+        return {
+            ok: false,
+            code: 'lock-busy',
+            lockPath,
+        };
+    }
+    const ownerInfo = {
+        pid: process.pid,
+        hostname: os.hostname(),
+        acquiredAt: getNow(),
+    };
+    await fs.writeFile(ownerFilePath, JSON.stringify(ownerInfo), 'utf-8');
+    const heartbeatTimer = setInterval(async () => {
+        try {
+            const now = new Date(getNow());
+            await fs.utimes(lockPath, now, now);
+        }
+        catch (error) {
+            console.error('[process-guard] lock heartbeat update failed:', error instanceof Error ? error.message : String(error));
+            // 锁被外部清理时，心跳更新可安全忽略。
+        }
+    }, updateMs);
+    heartbeatTimer.unref();
+    let released = false;
+    const release = async () => {
+        if (released) {
+            return;
+        }
+        released = true;
+        clearInterval(heartbeatTimer);
+        await fs.rm(lockPath, { recursive: true, force: true });
+    };
+    return {
+        ok: true,
+        lockPath,
+        release,
+    };
+}
+async function tryAcquireLockPath(lockPath, staleMs, now) {
+    try {
+        await fs.mkdir(lockPath);
+        return true;
+    }
+    catch (error) {
+        if (!isAlreadyExistsError(error)) {
+            throw error;
+        }
+    }
+    if (!(await isLockStale(lockPath, staleMs, now))) {
+        return false;
+    }
+    await fs.rm(lockPath, { recursive: true, force: true });
+    try {
+        await fs.mkdir(lockPath);
+        return true;
+    }
+    catch (error) {
+        if (isAlreadyExistsError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+function isAlreadyExistsError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    if (!('code' in error)) {
+        return false;
+    }
+    return String(error.code) === 'EEXIST';
+}
+async function isLockStale(lockPath, staleMs, now) {
+    try {
+        const stat = await fs.stat(lockPath);
+        const ageMs = now() - stat.mtimeMs;
+        return ageMs > staleMs;
+    }
+    catch {
+        return false;
+    }
+}
+async function readPidFile(pidFilePath) {
+    try {
+        const raw = (await fs.readFile(pidFilePath, 'utf-8')).trim();
+        const pid = Number.parseInt(raw, 10);
+        return Number.isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+async function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function probeTcpPort(host, port, timeoutMs = 1200) {
+    return new Promise(resolve => {
+        const socket = new net.Socket();
+        let settled = false;
+        const finish = (isOpen, reason) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            socket.destroy();
+            resolve({ isOpen, reason });
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once('connect', () => finish(true, 'connected'));
+        socket.once('timeout', () => finish(false, 'timeout'));
+        socket.once('error', error => {
+            const reason = error && typeof error === 'object' && 'code' in error
+                ? String(error.code)
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            finish(false, reason);
+        });
+        socket.connect(port, host);
+    });
+}
+async function listOpenCodeProcesses(processKeywords) {
+    const snapshot = await listAllProcesses();
+    return snapshot.filter(item => matchesProcessKeywords(item, processKeywords));
+}
+function matchesProcessKeywords(item, processKeywords) {
+    const command = item.command.toLowerCase();
+    return processKeywords.some(keyword => command.includes(keyword.toLowerCase()));
+}
+async function listAllProcesses() {
+    if (process.platform === 'win32') {
+        const fromPowerShell = await listProcessesByPowerShell();
+        if (fromPowerShell.length > 0) {
+            return fromPowerShell;
+        }
+        return listProcessesByTaskList();
+    }
+    return listProcessesByPs();
+}
+async function listProcessesByPowerShell() {
+    try {
+        const command = 'Get-CimInstance Win32_Process | Select-Object ProcessId,Name,CommandLine | ConvertTo-Json -Compress';
+        const { stdout } = await execFileAsync('powershell', ['-NoProfile', '-Command', command], {
+            windowsHide: true,
+            maxBuffer: 1024 * 1024 * 8,
+        });
+        const content = stdout.trim();
+        if (!content) {
+            return [];
+        }
+        const parsed = JSON.parse(content);
+        const records = Array.isArray(parsed) ? parsed : [parsed];
+        const processList = [];
+        for (const record of records) {
+            if (!record || typeof record !== 'object') {
+                continue;
+            }
+            const pidValue = 'ProcessId' in record ? record.ProcessId : undefined;
+            const nameValue = 'Name' in record ? record.Name : '';
+            const commandValue = 'CommandLine' in record ? record.CommandLine : '';
+            const pid = Number.parseInt(String(pidValue), 10);
+            if (Number.isNaN(pid)) {
+                continue;
+            }
+            const command = String(commandValue || nameValue || '').trim();
+            if (!command) {
+                continue;
+            }
+            processList.push({ pid, command });
+        }
+        return processList;
+    }
+    catch (error) {
+        console.error('[process-guard] PowerShell scan failed:', error instanceof Error ? error.message : String(error));
+        return [];
+    }
+}
+async function listProcessesByTaskList() {
+    try {
+        const { stdout } = await execFileAsync('tasklist', ['/FO', 'CSV', '/NH'], {
+            windowsHide: true,
+            maxBuffer: 1024 * 1024 * 8,
+        });
+        const lines = stdout
+            .split(/\r?\n/u)
+            .map(line => line.trim())
+            .filter(Boolean);
+        const processList = [];
+        for (const line of lines) {
+            const columns = parseWindowsCsvLine(line);
+            if (columns.length < 2) {
+                continue;
+            }
+            const imageName = columns[0] ?? '';
+            const pid = Number.parseInt((columns[1] ?? '').replace(/,/gu, ''), 10);
+            if (Number.isNaN(pid) || !imageName) {
+                continue;
+            }
+            processList.push({ pid, command: imageName });
+        }
+        return processList;
+    }
+    catch {
+        return [];
+    }
+}
+function parseWindowsCsvLine(line) {
+    const values = [];
+    let cursor = 0;
+    while (cursor < line.length) {
+        if (line[cursor] === '"') {
+            cursor += 1;
+            let field = '';
+            while (cursor < line.length) {
+                if (line[cursor] === '"') {
+                    if (line[cursor + 1] === '"') {
+                        field += '"';
+                        cursor += 2;
+                        continue;
+                    }
+                    cursor += 1;
+                    break;
+                }
+                field += line[cursor] ?? '';
+                cursor += 1;
+            }
+            values.push(field);
+            if (line[cursor] === ',') {
+                cursor += 1;
+            }
+            continue;
+        }
+        let field = '';
+        while (cursor < line.length && line[cursor] !== ',') {
+            field += line[cursor] ?? '';
+            cursor += 1;
+        }
+        values.push(field.trim());
+        if (line[cursor] === ',') {
+            cursor += 1;
+        }
+    }
+    return values;
+}
+async function listProcessesByPs() {
+    try {
+        const { stdout } = await execFileAsync('ps', ['-ax', '-o', 'pid=,command='], {
+            maxBuffer: 1024 * 1024 * 8,
+        });
+        const lines = stdout
+            .split(/\r?\n/u)
+            .map(line => line.trim())
+            .filter(Boolean);
+        const processList = [];
+        for (const line of lines) {
+            const matched = line.match(/^(\d+)\s+(.+)$/u);
+            if (!matched) {
+                continue;
+            }
+            const pid = Number.parseInt(matched[1], 10);
+            const command = matched[2]?.trim() ?? '';
+            if (Number.isNaN(pid) || !command) {
+                continue;
+            }
+            processList.push({ pid, command });
+        }
+        return processList;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=process-guard.js.map

package/dist/reliability/process-guard.js.map

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

package/dist/reliability/recovery-reporter.d.ts

@@ -0,0 +1,37 @@
+import { type AuditLogger } from './audit-log.js';
+import { FailureType } from './types.js';
+export interface RecoveryReporterClient {
+    sendMessageAsync(sessionId: string, text: string, options?: {
+        providerId?: string;
+        modelId?: string;
+        agent?: string;
+        variant?: string;
+        directory?: string;
+    }): Promise<void>;
+    createSession(title?: string, directory?: string): Promise<{
+        id: string;
+    }>;
+}
+export interface ReportRecoveryContextInput {
+    failureType: FailureType;
+    failureReason: string;
+    backupPath: string;
+    nextActions: string[];
+    selfCheckCommands: string[];
+    sessionId?: string;
+    directory?: string;
+    context?: Record<string, unknown>;
+}
+export interface ReportRecoveryContextResult {
+    sent: boolean;
+    sessionId: string;
+    message: string;
+    error?: string;
+}
+interface ReportRecoveryContextOptions {
+    client?: RecoveryReporterClient;
+    audit?: AuditLogger;
+}
+export declare function reportRecoveryContext(input: ReportRecoveryContextInput, options?: ReportRecoveryContextOptions): Promise<ReportRecoveryContextResult>;
+export {};
+//# sourceMappingURL=recovery-reporter.d.ts.map

package/dist/reliability/recovery-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-reporter.d.ts","sourceRoot":"","sources":["../../src/reliability/recovery-reporter.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,4BAA4B;IACpC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAiBD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,EACjC,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,2BAA2B,CAAC,CAyFtC"}

package/dist/reliability/recovery-reporter.js

@@ -0,0 +1,161 @@
+import { opencodeClient } from '../opencode/client.js';
+import { generateIncidentId, redactSensitiveFields } from './audit-log.js';
+const noOpAuditLogger = {
+    async log() {
+        return;
+    },
+};
+const REDACTION_PATTERNS = [
+    /(password\s*[:=]\s*)([^\s,;]+)/giu,
+    /(passwd\s*[:=]\s*)([^\s,;]+)/giu,
+    /(token\s*[:=]\s*)([^\s,;]+)/giu,
+    /(secret\s*[:=]\s*)([^\s,;]+)/giu,
+    /(api[_-]?key\s*[:=]\s*)([^\s,;]+)/giu,
+    /(opencode_server_password\s*[:=]\s*)([^\s,;]+)/giu,
+];
+export async function reportRecoveryContext(input, options) {
+    const client = options?.client ?? opencodeClient;
+    const audit = options?.audit ?? noOpAuditLogger;
+    const failureReason = redactText(input.failureReason);
+    const backupPath = redactText(input.backupPath);
+    const nextActions = sanitizeList(input.nextActions);
+    const selfCheckCommands = sanitizeList(input.selfCheckCommands);
+    const context = input.context ? redactSensitiveFields(input.context) : undefined;
+    const message = buildRecoveryMessage({
+        failureType: input.failureType,
+        failureReason,
+        backupPath,
+        nextActions,
+        selfCheckCommands,
+        context,
+    });
+    let sessionId = (input.sessionId || '').trim();
+    await logAuditSafe(audit, {
+        action: 'recovery.report.attempt',
+        result: 'success',
+        metadata: {
+            sessionId: sessionId || null,
+            failureType: input.failureType,
+            backupPath,
+            hasContext: Boolean(context),
+        },
+    });
+    if (!sessionId) {
+        try {
+            const session = await client.createSession(`Recovery ${input.failureType}`, input.directory);
+            sessionId = session.id;
+        }
+        catch (error) {
+            const errorMessage = normalizeErrorMessage(error);
+            await logAuditSafe(audit, {
+                action: 'recovery.report.failed',
+                result: 'failed',
+                metadata: {
+                    stage: 'create_session',
+                    failureType: input.failureType,
+                    error: errorMessage,
+                },
+            });
+            return {
+                sent: false,
+                sessionId: '',
+                message,
+                error: errorMessage,
+            };
+        }
+    }
+    try {
+        await client.sendMessageAsync(sessionId, message, input.directory ? { directory: input.directory } : undefined);
+        await logAuditSafe(audit, {
+            action: 'recovery.report.sent',
+            result: 'success',
+            metadata: {
+                sessionId,
+                failureType: input.failureType,
+                backupPath,
+            },
+        });
+        return {
+            sent: true,
+            sessionId,
+            message,
+        };
+    }
+    catch (error) {
+        const errorMessage = normalizeErrorMessage(error);
+        await logAuditSafe(audit, {
+            action: 'recovery.report.failed',
+            result: 'failed',
+            metadata: {
+                stage: 'send_message',
+                sessionId,
+                failureType: input.failureType,
+                error: errorMessage,
+            },
+        });
+        return {
+            sent: false,
+            sessionId,
+            message,
+            error: errorMessage,
+        };
+    }
+}
+function buildRecoveryMessage(input) {
+    const nextActionText = input.nextActions.length > 0
+        ? input.nextActions.map((item, index) => `${index + 1}. ${item}`).join('\n')
+        : '1. 使用备份配置恢复并重启服务';
+    const selfCheckText = input.selfCheckCommands.length > 0
+        ? input.selfCheckCommands.map(command => `- ${command}`).join('\n')
+        : '- npm run build\n- npm test';
+    const contextText = input.context
+        ? `\n\n附加上下文（已脱敏）：\n${JSON.stringify(input.context, null, 2)}`
+        : '';
+    return [
+        '恢复后修复上下文（自动下发）',
+        '',
+        `- failureType: ${input.failureType}`,
+        `- 故障原因(failureReason): ${input.failureReason}`,
+        `- 备份配置路径(backupPath): ${input.backupPath}`,
+        '- nextAction（建议还原动作）:',
+        nextActionText,
+        '- 自检指令:',
+        selfCheckText,
+    ].join('\n') + contextText;
+}
+function sanitizeList(items) {
+    return items
+        .map(item => redactText(item).trim())
+        .filter(item => item.length > 0);
+}
+function redactText(input) {
+    let result = input;
+    for (const pattern of REDACTION_PATTERNS) {
+        result = result.replace(pattern, '$1***');
+    }
+    return result;
+}
+function normalizeErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+async function logAuditSafe(audit, input) {
+    try {
+        await audit.log({
+            incidentId: generateIncidentId(),
+            classification: 'system',
+            decision: 'create',
+            action: input.action,
+            result: input.result,
+            timestamp: new Date().toISOString(),
+            metadata: input.metadata,
+        });
+    }
+    catch (error) {
+        console.error('[recovery-reporter] audit write failed:', error instanceof Error ? error.message : String(error));
+        // 审计日志失败不应影响主流程。
+    }
+}
+//# sourceMappingURL=recovery-reporter.js.map

package/dist/reliability/recovery-reporter.js.map

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

package/dist/reliability/rescue-executor.d.ts

@@ -0,0 +1,52 @@
+import { type AuditLogger } from './audit-log.js';
+import { applyConfigGuardWithFallback, type ApplyConfigGuardResult, type ConfigGuardServerFields } from './config-guard.js';
+import { diagnoseEnvironment, type EnvironmentDoctorReport } from './environment-doctor.js';
+import { probeOpenCodeHealth, type OpenCodeProbeResult } from './opencode-probe.js';
+import { acquireRescueLock, checkOpenCodeSingleInstance, type ProcessGuardResult } from './process-guard.js';
+export type RescueStep = 'lock' | 'doctor' | 'config' | 'start' | 'verify' | 'release';
+export type RescueStepResult = 'success' | 'failed';
+export interface RescueStepTrace {
+    step: RescueStep;
+    result: RescueStepResult;
+    durationMs: number;
+    reason?: string;
+}
+export interface RescueExecutorOptions {
+    lockTargetPath: string;
+    pidFilePath: string;
+    host: string;
+    port: number;
+    configPath: string;
+    serverFields: ConfigGuardServerFields;
+    healthPath?: string;
+    startOpenCode?: () => Promise<void>;
+    audit?: AuditLogger;
+    deps?: Partial<RescueExecutorDependencies>;
+}
+export interface RescueExecutionSuccess {
+    ok: true;
+    trace: RescueStepTrace[];
+    lockPath: string;
+    singleInstance: ProcessGuardResult;
+    doctor: EnvironmentDoctorReport;
+    config: ApplyConfigGuardResult;
+    health: OpenCodeProbeResult;
+}
+export interface RescueExecutionFailure {
+    ok: false;
+    failedStep: RescueStep;
+    reason: string;
+    trace: RescueStepTrace[];
+}
+export type RescueExecutionResult = RescueExecutionSuccess | RescueExecutionFailure;
+export interface RescueExecutorDependencies {
+    acquireRescueLock: typeof acquireRescueLock;
+    checkOpenCodeSingleInstance: typeof checkOpenCodeSingleInstance;
+    diagnoseEnvironment: typeof diagnoseEnvironment;
+    applyConfigGuardWithFallback: typeof applyConfigGuardWithFallback;
+    probeOpenCodeHealth: typeof probeOpenCodeHealth;
+    startOpenCode: () => Promise<void>;
+    now: () => number;
+}
+export declare function executeRescuePipeline(options: RescueExecutorOptions): Promise<RescueExecutionResult>;
+//# sourceMappingURL=rescue-executor.d.ts.map

package/dist/reliability/rescue-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rescue-executor.d.ts","sourceRoot":"","sources":["../../src/reliability/rescue-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AACvF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,uBAAuB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,kBAAkB,CAAC;IACnC,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEpF,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,4BAA4B,EAAE,OAAO,4BAA4B,CAAC;IAClE,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAQD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqM1G"}