@lingxiao-office/sdk 1.0.0

package/dist/core/ProxyConfig.d.ts

@@ -0,0 +1,26 @@
+export type ProxyScope = 'llm' | 'tools';
+export interface RuntimeProxyConfig {
+    protocol?: 'http' | 'socks5';
+    host?: string;
+    port?: number;
+    username?: string;
+    password?: string;
+    no_proxy?: string;
+    url?: string;
+    llm_enabled?: boolean;
+    tools_enabled?: boolean;
+}
+export declare function getConfiguredProxyUrl(scope: ProxyScope): string | null;
+export declare function isConfiguredProxyEnabled(scope: ProxyScope): boolean;
+export declare function getConfiguredNoProxy(): string;
+export declare function buildToolProxyEnv(): NodeJS.ProcessEnv;
+export declare function withToolProxyEnv<T extends NodeJS.ProcessEnv | Record<string, string | undefined>>(env: T): T;
+export declare function getScopedProxyFetch(scope: ProxyScope): typeof fetch | undefined;
+export declare function resolveToolBrowserProxy(): {
+    server: string;
+    username?: string;
+    password?: string;
+    bypass?: string;
+} | undefined;
+export declare function __resetProxyFetchCacheForTest(): void;
+//# sourceMappingURL=ProxyConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyConfig.d.ts","sourceRoot":"","sources":["../../src/core/ProxyConfig.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAgCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAkBtE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEnE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,UAAU,CAkBrD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAI5G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,KAAK,GAAG,SAAS,CAmB/E;AAED,wBAAgB,uBAAuB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAe/H;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAMpD"}

package/dist/core/ProxyConfig.js

@@ -0,0 +1,121 @@
+import fetchWithAgent from 'node-fetch';
+import { ProxyAgent } from 'proxy-agent';
+import { config } from '../config.js';
+const scopedFetchCache = {};
+function getRuntimeProxyConfig() {
+    return (config.network?.proxy || {});
+}
+function isScopeEnabled(cfg, scope) {
+    return scope === 'llm' ? cfg.llm_enabled === true : cfg.tools_enabled === true;
+}
+function buildUrlFromParts(cfg) {
+    const host = String(cfg.host || '').trim();
+    const port = Number(cfg.port || 0);
+    if (!host || !Number.isFinite(port) || port <= 0)
+        return null;
+    const protocol = cfg.protocol === 'socks5' ? 'socks5' : 'http';
+    const url = new URL(`${protocol}://${host}:${port}`);
+    const username = String(cfg.username || '').trim();
+    const password = String(cfg.password || '');
+    if (username)
+        url.username = username;
+    if (password)
+        url.password = password;
+    return url.toString();
+}
+export function getConfiguredProxyUrl(scope) {
+    const cfg = getRuntimeProxyConfig();
+    if (!isScopeEnabled(cfg, scope))
+        return null;
+    const explicitUrl = String(cfg.url || '').trim();
+    const rawUrl = explicitUrl || buildUrlFromParts(cfg);
+    if (!rawUrl)
+        return null;
+    try {
+        const parsed = new URL(rawUrl);
+        const protocol = parsed.protocol.replace(':', '').toLowerCase();
+        if (!['http', 'https', 'socks', 'socks4', 'socks4a', 'socks5', 'socks5h'].includes(protocol)) {
+            return null;
+        }
+        return parsed.toString();
+    }
+    catch { /* expected: operation may fail gracefully */
+        return null;
+    }
+}
+export function isConfiguredProxyEnabled(scope) {
+    return getConfiguredProxyUrl(scope) !== null;
+}
+export function getConfiguredNoProxy() {
+    return String(getRuntimeProxyConfig().no_proxy || '').trim();
+}
+export function buildToolProxyEnv() {
+    const proxyUrl = getConfiguredProxyUrl('tools');
+    if (!proxyUrl)
+        return {};
+    const noProxy = getConfiguredNoProxy();
+    const env = {
+        HTTP_PROXY: proxyUrl,
+        http_proxy: proxyUrl,
+        HTTPS_PROXY: proxyUrl,
+        https_proxy: proxyUrl,
+        ALL_PROXY: proxyUrl,
+        all_proxy: proxyUrl,
+    };
+    if (noProxy) {
+        env.NO_PROXY = noProxy;
+        env.no_proxy = noProxy;
+    }
+    return env;
+}
+export function withToolProxyEnv(env) {
+    const proxyEnv = buildToolProxyEnv();
+    if (Object.keys(proxyEnv).length === 0)
+        return env;
+    return { ...env, ...proxyEnv };
+}
+export function getScopedProxyFetch(scope) {
+    const proxyUrl = getConfiguredProxyUrl(scope);
+    if (!proxyUrl)
+        return undefined;
+    const cached = scopedFetchCache[scope];
+    if (cached?.proxyUrl === proxyUrl)
+        return cached.fetch;
+    const agent = new ProxyAgent({
+        getProxyForUrl: () => proxyUrl,
+    });
+    const scopedFetch = ((input, init) => {
+        return fetchWithAgent(input, {
+            ...init,
+            agent,
+        });
+    });
+    scopedFetchCache[scope] = { proxyUrl, fetch: scopedFetch, agent };
+    return scopedFetch;
+}
+export function resolveToolBrowserProxy() {
+    const proxyUrl = getConfiguredProxyUrl('tools');
+    if (!proxyUrl)
+        return undefined;
+    try {
+        const parsed = new URL(proxyUrl);
+        const proxy = {
+            server: `${parsed.protocol}//${parsed.host}`,
+            username: parsed.username ? decodeURIComponent(parsed.username) : undefined,
+            password: parsed.password ? decodeURIComponent(parsed.password) : undefined,
+            bypass: getConfiguredNoProxy() || undefined,
+        };
+        return proxy;
+    }
+    catch { /* expected: resource not available */
+        return undefined;
+    }
+}
+export function __resetProxyFetchCacheForTest() {
+    for (const entry of Object.values(scopedFetchCache)) {
+        entry?.agent.destroy();
+    }
+    delete scopedFetchCache.llm;
+    delete scopedFetchCache.tools;
+}
+//# sourceMappingURL=ProxyConfig.js.map

package/dist/core/ProxyConfig.js.map

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

package/dist/core/RecoveryRecords.d.ts

@@ -0,0 +1,29 @@
+import type { DatabaseManager } from './Database.js';
+export type RecoveryFaultClass = 'worker_heartbeat_timeout' | 'worker_max_runtime' | 'worker_crashed' | 'worker_exit' | 'worker_protocol' | 'worker_runtime' | 'worker_stopped' | 'worker_health_runaway' | 'worker_startup' | 'external_agent_timeout' | 'external_agent_crashed' | 'external_agent_protocol' | 'external_agent_auth' | 'external_agent_config';
+export interface RuntimeRecoveryRecord {
+    sessionId: string;
+    taskId: string;
+    agentId: string;
+    agentName: string;
+    roleType?: string;
+    category: 'internal_recoverable' | 'external_retryable' | 'external_blocking';
+    faultClass: RecoveryFaultClass;
+    status: 'recovering' | 'blocked' | 'resolved';
+    reason: string;
+    recoveryAction: 'leader_takeover' | 'worker_restart' | 'worker_redispatch' | 'waiting_external';
+    attempt: number;
+    lineId: string;
+    lastActivityAt?: number;
+    timestamp: number;
+}
+export declare function recoveryRecordKey(taskId: string): string;
+export declare function saveRecoveryRecord(db: DatabaseManager, record: RuntimeRecoveryRecord): void;
+export declare function getRecoveryRecord(db: Pick<DatabaseManager, 'getSessionState'>, sessionId: string, taskId: string): RuntimeRecoveryRecord | null;
+export declare function clearRecoveryRecord(db: DatabaseManager, sessionId: string, taskId: string): void;
+export declare function listRecoveryRecords(db: Pick<DatabaseManager, 'listSessionStateByPrefix'>, sessionId: string): RuntimeRecoveryRecord[];
+/**
+ * 清理已解决且超过 maxAgeMs 的恢复记录，防止 DB 无限增长。
+ * 返回清理的记录数。
+ */
+export declare function gcRecoveryRecords(db: DatabaseManager, sessionId: string, maxAgeMs?: number): number;
+//# sourceMappingURL=RecoveryRecords.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryRecords.d.ts","sourceRoot":"","sources":["../../src/core/RecoveryRecords.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAC1B,0BAA0B,GAC1B,oBAAoB,GACpB,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,uBAAuB,GACvB,gBAAgB,GAChB,wBAAwB,GACxB,wBAAwB,GACxB,yBAAyB,GACzB,qBAAqB,GACrB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,sBAAsB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;IAC9E,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IAChG,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmFD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAE3F;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,EAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,qBAAqB,GAAG,IAAI,CAI9B;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEhG;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,0BAA0B,CAAC,EACrD,SAAS,EAAE,MAAM,GAChB,qBAAqB,EAAE,CAIzB;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAA4B,GACrC,MAAM,CAWR"}

package/dist/core/RecoveryRecords.js

@@ -0,0 +1,122 @@
+const RECOVERY_PREFIX = 'runtime_recovery:';
+const RECOVERY_FAULT_CLASSES = new Set([
+    'worker_heartbeat_timeout',
+    'worker_max_runtime',
+    'worker_crashed',
+    'worker_exit',
+    'worker_protocol',
+    'worker_runtime',
+    'worker_stopped',
+    'worker_health_runaway',
+    'worker_startup',
+    'external_agent_timeout',
+    'external_agent_crashed',
+    'external_agent_protocol',
+    'external_agent_auth',
+    'external_agent_config',
+]);
+const RECOVERY_CATEGORIES = new Set([
+    'internal_recoverable',
+    'external_retryable',
+    'external_blocking',
+]);
+const RECOVERY_STATUSES = new Set([
+    'recovering',
+    'blocked',
+    'resolved',
+]);
+const RECOVERY_ACTIONS = new Set([
+    'leader_takeover',
+    'worker_restart',
+    'worker_redispatch',
+    'waiting_external',
+]);
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requireString(row, field) {
+    const value = row[field];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`Recovery record missing canonical field ${String(field)}`);
+    }
+    return value;
+}
+function requireNumber(row, field) {
+    const value = row[field];
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`Recovery record missing canonical field ${String(field)}`);
+    }
+    return value;
+}
+function parseRecoveryRecord(value) {
+    if (!isRecord(value)) {
+        throw new Error('Recovery record must be a canonical object');
+    }
+    const record = {
+        sessionId: requireString(value, 'sessionId'),
+        taskId: requireString(value, 'taskId'),
+        agentId: requireString(value, 'agentId'),
+        agentName: requireString(value, 'agentName'),
+        category: requireString(value, 'category'),
+        faultClass: requireString(value, 'faultClass'),
+        status: requireString(value, 'status'),
+        reason: requireString(value, 'reason'),
+        recoveryAction: requireString(value, 'recoveryAction'),
+        attempt: requireNumber(value, 'attempt'),
+        lineId: requireString(value, 'lineId'),
+        timestamp: requireNumber(value, 'timestamp'),
+    };
+    if (value.roleType !== undefined)
+        record.roleType = requireString(value, 'roleType');
+    if (value.lastActivityAt !== undefined)
+        record.lastActivityAt = requireNumber(value, 'lastActivityAt');
+    if (!RECOVERY_CATEGORIES.has(record.category))
+        throw new Error(`Recovery record has invalid category: ${record.category}`);
+    if (!RECOVERY_FAULT_CLASSES.has(record.faultClass))
+        throw new Error(`Recovery record has invalid faultClass: ${record.faultClass}`);
+    if (!RECOVERY_STATUSES.has(record.status))
+        throw new Error(`Recovery record has invalid status: ${record.status}`);
+    if (!RECOVERY_ACTIONS.has(record.recoveryAction))
+        throw new Error(`Recovery record has invalid recoveryAction: ${record.recoveryAction}`);
+    return record;
+}
+export function recoveryRecordKey(taskId) {
+    return `${RECOVERY_PREFIX}${taskId}`;
+}
+export function saveRecoveryRecord(db, record) {
+    db.setSessionState(record.sessionId, recoveryRecordKey(record.taskId), record);
+}
+export function getRecoveryRecord(db, sessionId, taskId) {
+    const value = db.getSessionState(sessionId, recoveryRecordKey(taskId));
+    if (value === null || value === undefined)
+        return null;
+    return parseRecoveryRecord(value);
+}
+export function clearRecoveryRecord(db, sessionId, taskId) {
+    db.deleteSessionState(sessionId, recoveryRecordKey(taskId));
+}
+export function listRecoveryRecords(db, sessionId) {
+    return db.listSessionStateByPrefix(sessionId, RECOVERY_PREFIX)
+        .map((entry) => parseRecoveryRecord(entry.value))
+        .sort((a, b) => (b.timestamp || 0) - (a.timestamp || 0));
+}
+function recoveryTimestampMs(timestamp) {
+    return timestamp < 10_000_000_000 ? timestamp * 1000 : timestamp;
+}
+/**
+ * 清理已解决且超过 maxAgeMs 的恢复记录，防止 DB 无限增长。
+ * 返回清理的记录数。
+ */
+export function gcRecoveryRecords(db, sessionId, maxAgeMs = 24 * 60 * 60 * 1000) {
+    const records = listRecoveryRecords(db, sessionId);
+    const now = Date.now();
+    let cleaned = 0;
+    for (const record of records) {
+        if (record.status === 'resolved' && now - recoveryTimestampMs(record.timestamp) > maxAgeMs) {
+            clearRecoveryRecord(db, sessionId, record.taskId);
+            cleaned++;
+        }
+    }
+    return cleaned;
+}
+//# sourceMappingURL=RecoveryRecords.js.map

package/dist/core/RecoveryRecords.js.map

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

package/dist/core/RepairStrategyEngine.d.ts

@@ -0,0 +1,94 @@
+/**
+ * RepairStrategyEngine — 修复策略引擎（轻量版）
+ *
+ * 替代已移除的 AdaptiveHarness，用更简单直接的方式处理任务失败修复。
+ *
+ * 核心理念：
+ * - 失败不是重试的理由——是分析的起点
+ * - 分类错误 → 选择策略 → 执行修复 → 记录模式
+ * - 避免对同一根因反复用同一策略
+ *
+ * 错误分类：
+ * - type_error: TypeScript 编译错误（类型不匹配/缺少属性/导入错误）
+ * - build_error: 构建失败（模块解析/配置错误）
+ * - runtime_error: 运行时崩溃（未处理异常/断言失败/测试失败）
+ * - logic_error: 逻辑错误（功能不正确但不崩溃，由验收发现）
+ * - timeout: 超时（worker 卡住或任务过大）
+ * - dependency_error: 依赖错误（包缺失/版本冲突）
+ *
+ * 策略：
+ * - retry_with_context: 附加错误上下文重试（类型错误、简单构建错误）
+ * - narrow_scope: 缩小范围重做（任务过大导致的超时/逻辑错误）
+ * - fix_dependencies: 先修依赖再重试（依赖错误）
+ * - different_approach: 换方向（同一策略已失败2次）
+ * - escalate_to_user: 上报用户（策略耗尽）
+ */
+import type { SharedLedger } from './SharedLedger.js';
+export type ErrorCategory = 'type_error' | 'build_error' | 'runtime_error' | 'logic_error' | 'timeout' | 'dependency_error' | 'unknown';
+export type RepairStrategy = 'retry_with_context' | 'narrow_scope' | 'fix_dependencies' | 'different_approach' | 'escalate_to_user';
+export interface ErrorClassification {
+    /** 错误分类 */
+    category: ErrorCategory;
+    /** 置信度 (0-1) */
+    confidence: number;
+    /** 分类依据 */
+    signals: string[];
+    /** 提取的关键错误信息 */
+    keyError: string;
+    /** 涉及的文件（如果能提取） */
+    affectedFiles: string[];
+}
+export interface RepairDecision {
+    /** 选择的策略 */
+    strategy: RepairStrategy;
+    /** 决策原因 */
+    reason: string;
+    /** 给 repair worker 的额外指令 */
+    instructions: string;
+    /** 是否是最终尝试 */
+    isFinalAttempt: boolean;
+    /** 历史失败次数 */
+    priorAttempts: number;
+}
+export interface FailureRecord {
+    taskId: string;
+    category: ErrorCategory;
+    strategy: RepairStrategy;
+    keyError: string;
+    timestamp: number;
+}
+export declare class RepairStrategyEngine {
+    private readonly ledger?;
+    private failureHistory;
+    constructor(ledger?: SharedLedger | undefined);
+    /**
+     * 分类错误
+     */
+    classify(errorText: string): ErrorClassification;
+    /**
+     * 根据错误分类和历史，决定修复策略
+     */
+    decide(taskId: string, classification: ErrorClassification): RepairDecision;
+    /**
+     * 获取任务的修复历史
+     */
+    getHistory(taskId: string): FailureRecord[];
+    /**
+     * 清除任务的修复历史（任务成功后调用）
+     */
+    clearHistory(taskId: string): void;
+    private matchesTypeError;
+    private matchesBuildError;
+    private matchesDependencyError;
+    private matchesRuntimeError;
+    private matchesTimeout;
+    private matchesLogicError;
+    private extractKeyError;
+    private extractFiles;
+    private isSameRootCause;
+    private recordFailure;
+    private buildReason;
+    private buildInstructions;
+    private buildEscalationInstructions;
+}
+//# sourceMappingURL=RepairStrategyEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RepairStrategyEngine.d.ts","sourceRoot":"","sources":["../../src/core/RepairStrategyEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,aAAa,GACb,eAAe,GACf,aAAa,GACb,SAAS,GACT,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY;IACZ,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAFpC,OAAO,CAAC,cAAc,CAAsC;gBAE/B,MAAM,CAAC,EAAE,YAAY,YAAA;IAElD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAiDhD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,GAAG,cAAc;IAuD3E;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;IAI3C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,iBAAiB;IAoDzB,OAAO,CAAC,2BAA2B;CAYpC"}