@f2a/openclaw-f2a 0.3.3 → 0.3.5

package/dist/F2AComponentRegistry.d.ts

@@ -0,0 +1,195 @@
+/**
+ * F2A 组件注册器
+ *
+ * 负责管理所有 F2A 组件的懒加载和生命周期。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AComponentRegistry
+ */
+import type { ApiLogger, F2APluginConfig, F2ANodeConfig, OpenClawPluginApi, F2ANetworkClientLike, ReputationSystemLike, NodeManagerLike, TaskQueueLike, AnnouncementQueueLike, ReviewCommitteeLike, ContactManagerLike, HandshakeProtocolLike, F2APublicInterface } from './types.js';
+import { F2ANodeManager } from './node-manager.js';
+import { F2ANetworkClient } from './network-client.js';
+import { ReputationManager } from '@f2a/network';
+import { CapabilityDetector } from './capability-detector.js';
+import { TaskQueue } from './task-queue.js';
+import { AnnouncementQueue } from './announcement-queue.js';
+import { ReviewCommittee, F2A } from '@f2a/network';
+import { ContactManager } from './contact-manager.js';
+import { HandshakeProtocol } from './handshake-protocol.js';
+/**
+ * 组件注册器配置
+ */
+export interface ComponentRegistryConfig {
+    /** 插件配置 */
+    pluginConfig: F2APluginConfig;
+    /** 节点配置 */
+    nodeConfig: F2ANodeConfig;
+    /** OpenClaw API */
+    api?: OpenClawPluginApi;
+    /** Logger */
+    logger?: ApiLogger;
+}
+/**
+ * 初始化标志（防止重复初始化）
+ */
+export interface InitializingFlags {
+    nodeManager: boolean;
+    taskQueue: boolean;
+    contactManager: boolean;
+    handshakeProtocol: boolean;
+}
+/**
+ * F2A 组件注册器
+ *
+ * 管理所有组件的懒加载：
+ * - 核心组件：nodeManager, networkClient, taskQueue, announcementQueue
+ * - 信誉系统：reputationSystem, reviewCommittee
+ * - 能力检测：capabilityDetector
+ * - 通讯录：contactManager, handshakeProtocol
+ */
+export declare class F2AComponentRegistry {
+    private config;
+    private nodeConfig;
+    private api?;
+    private logger?;
+    private _nodeManager?;
+    private _networkClient?;
+    private _reputationSystem?;
+    private _capabilityDetector?;
+    private _taskQueue?;
+    private _announcementQueue?;
+    private _reviewCommittee?;
+    private _contactManager?;
+    private _handshakeProtocol?;
+    private initializingFlags;
+    /** F2A 实例（由外部设置，用于获取 peerId 等） */
+    private _f2a?;
+    constructor(config: ComponentRegistryConfig);
+    /**
+     * 获取插件配置
+     */
+    getConfig(): F2APluginConfig;
+    /**
+     * 获取 OpenClaw API
+     */
+    getApi(): OpenClawPluginApi | undefined;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<F2APluginConfig>): void;
+    /**
+     * 获取默认的 F2A 数据目录
+     *
+     * 优先级：
+     * 1. config.dataDir（用户显式配置）
+     * 2. workspace/.f2a（agent workspace 目录）
+     * 3. ~/.f2a（兼容旧版本）
+     */
+    getDefaultDataDir(): string;
+    /**
+     * 获取节点管理器（懒加载）
+     */
+    get nodeManager(): F2ANodeManager;
+    /**
+     * 获取网络客户端（懒加载）
+     */
+    get networkClient(): F2ANetworkClient;
+    /**
+     * 获取任务队列（懒加载）
+     */
+    get taskQueue(): TaskQueue;
+    /**
+     * 获取公告队列（懒加载）
+     */
+    get announcementQueue(): AnnouncementQueue;
+    /**
+     * 获取信誉系统（懒加载）
+     * 重构：改用 @f2a/network 的 ReputationManager
+     */
+    get reputationSystem(): ReputationManager;
+    /**
+     * 获取评审委员会（懒加载）
+     * 重构：直接使用 ReputationManager，不需要 Adapter
+     */
+    get reviewCommittee(): ReviewCommittee;
+    /**
+     * 获取能力检测器（懒加载）
+     */
+    get capabilityDetector(): CapabilityDetector;
+    /**
+     * 获取联系人管理器（延迟初始化）
+     */
+    get contactManager(): ContactManager;
+    /**
+     * 获取握手协议处理器（延迟初始化）
+     * 依赖 F2A 实例和 ContactManager
+     */
+    get handshakeProtocol(): HandshakeProtocol;
+    /**
+     * 设置 F2A 实例
+     */
+    setF2A(f2a: F2A | undefined): void;
+    /**
+     * 更新 Logger
+     */
+    updateLogger(logger: ApiLogger | undefined): void;
+    /**
+     * 获取网络客户端（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getNetworkClient(): F2ANetworkClientLike;
+    /**
+     * 获取信誉系统（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getReputationSystem(): ReputationSystemLike;
+    /**
+     * 获取节点管理器（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getNodeManager(): NodeManagerLike;
+    /**
+     * 获取任务队列（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getTaskQueue(): TaskQueueLike;
+    /**
+     * 获取公告队列（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getAnnouncementQueue(): AnnouncementQueueLike;
+    /**
+     * 获取评审委员会（公共接口）
+     * 触发懒加载
+     */
+    getReviewCommittee(): ReviewCommitteeLike | undefined;
+    /**
+     * 获取联系人管理器（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getContactManager(): ContactManagerLike;
+    /**
+     * 获取握手协议处理器（公共接口）
+     * @throws Error 如果 F2A 或 ContactManager 未就绪
+     */
+    getHandshakeProtocol(): HandshakeProtocolLike;
+    /**
+     * 获取 F2A 状态（公共接口）
+     */
+    getF2AStatus(): {
+        running: boolean;
+        peerId?: string;
+        uptime?: number;
+    };
+    /**
+     * 获取 F2A 实例（公共接口）
+     * 返回 F2A 公共接口供需要直接访问的场景使用。
+     * 注意：返回 undefined 表示 F2A 实例未初始化。
+     */
+    getF2A(): F2APublicInterface | undefined;
+    /**
+     * 清理所有组件（用于 shutdown）
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=F2AComponentRegistry.d.ts.map

package/dist/F2AComponentRegistry.d.ts.map

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

package/dist/F2AComponentRegistry.js

@@ -0,0 +1,385 @@
+"use strict";
+/**
+ * F2A 组件注册器
+ *
+ * 负责管理所有 F2A 组件的懒加载和生命周期。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AComponentRegistry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.F2AComponentRegistry = void 0;
+const path_1 = require("path");
+const os_1 = require("os");
+const types_js_1 = require("./types.js");
+const node_manager_js_1 = require("./node-manager.js");
+const network_client_js_1 = require("./network-client.js");
+const network_1 = require("@f2a/network");
+const capability_detector_js_1 = require("./capability-detector.js");
+const task_queue_js_1 = require("./task-queue.js");
+const announcement_queue_js_1 = require("./announcement-queue.js");
+const network_2 = require("@f2a/network");
+const contact_manager_js_1 = require("./contact-manager.js");
+const handshake_protocol_js_1 = require("./handshake-protocol.js");
+const connector_helpers_js_1 = require("./connector-helpers.js");
+/**
+ * F2A 组件注册器
+ *
+ * 管理所有组件的懒加载：
+ * - 核心组件：nodeManager, networkClient, taskQueue, announcementQueue
+ * - 信誉系统：reputationSystem, reviewCommittee
+ * - 能力检测：capabilityDetector
+ * - 通讯录：contactManager, handshakeProtocol
+ */
+class F2AComponentRegistry {
+    // ========== 配置和依赖 ==========
+    config;
+    nodeConfig;
+    api;
+    logger;
+    // ========== 组件实例（懒加载） ==========
+    _nodeManager;
+    _networkClient;
+    _reputationSystem;
+    _capabilityDetector;
+    _taskQueue;
+    _announcementQueue;
+    _reviewCommittee;
+    _contactManager;
+    _handshakeProtocol;
+    // ========== 初始化标志 ==========
+    initializingFlags = {
+        nodeManager: false,
+        taskQueue: false,
+        contactManager: false,
+        handshakeProtocol: false,
+    };
+    // ========== F2A 实例引用 ==========
+    /** F2A 实例（由外部设置，用于获取 peerId 等） */
+    _f2a;
+    constructor(config) {
+        this.config = config.pluginConfig;
+        this.nodeConfig = config.nodeConfig;
+        this.api = config.api;
+        this.logger = config.logger;
+    }
+    // ========== 配置访问 ==========
+    /**
+     * 获取插件配置
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * 获取 OpenClaw API
+     */
+    getApi() {
+        return this.api;
+    }
+    /**
+     * 更新配置
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    // ========== 数据目录 ==========
+    /**
+     * 获取默认的 F2A 数据目录
+     *
+     * 优先级：
+     * 1. config.dataDir（用户显式配置）
+     * 2. workspace/.f2a（agent workspace 目录）
+     * 3. ~/.f2a（兼容旧版本）
+     */
+    getDefaultDataDir() {
+        // 优先使用用户配置的 dataDir
+        if (this.config?.dataDir) {
+            return this.config.dataDir;
+        }
+        // 默认：使用 agent workspace 目录
+        const workspace = this.api?.config?.agents?.defaults?.workspace;
+        // 验证 workspace 路径安全性
+        if ((0, connector_helpers_js_1.isPathSafe)(workspace)) {
+            return (0, path_1.join)(workspace, '.f2a');
+        }
+        // 兼容旧版本
+        return (0, path_1.join)((0, os_1.homedir)(), '.f2a');
+    }
+    // ========== 核心组件 ==========
+    /**
+     * 获取节点管理器（懒加载）
+     */
+    get nodeManager() {
+        if (!this._nodeManager && !this.initializingFlags.nodeManager) {
+            this.initializingFlags.nodeManager = true;
+            try {
+                this._nodeManager = new node_manager_js_1.F2ANodeManager(this.nodeConfig, this.logger);
+            }
+            finally {
+                this.initializingFlags.nodeManager = false;
+            }
+        }
+        // P1-4 修复：添加 undefined 检查替代非空断言
+        if (!this._nodeManager) {
+            throw new Error('F2ANodeManager 初始化失败');
+        }
+        return this._nodeManager;
+    }
+    /**
+     * 获取网络客户端（懒加载）
+     */
+    get networkClient() {
+        if (!this._networkClient) {
+            this._networkClient = new network_client_js_1.F2ANetworkClient(this.nodeConfig, this.logger);
+        }
+        return this._networkClient;
+    }
+    /**
+     * 获取任务队列（懒加载）
+     */
+    get taskQueue() {
+        if (!this._taskQueue && !this.initializingFlags.taskQueue) {
+            this.initializingFlags.taskQueue = true;
+            try {
+                const dataDir = this.getDefaultDataDir();
+                this._taskQueue = new task_queue_js_1.TaskQueue({
+                    maxSize: this.config.maxQueuedTasks || 100,
+                    maxAgeMs: 24 * 60 * 60 * 1000, // 24小时
+                    persistDir: dataDir,
+                    persistEnabled: true,
+                    logger: this.logger
+                });
+                this.logger?.info('[F2A] TaskQueue 已初始化（懒加载）');
+            }
+            finally {
+                this.initializingFlags.taskQueue = false;
+            }
+        }
+        // P1-4 修复：添加 undefined 检查替代非空断言
+        if (!this._taskQueue) {
+            throw new Error('TaskQueue 初始化失败');
+        }
+        return this._taskQueue;
+    }
+    /**
+     * 获取公告队列（懒加载）
+     */
+    get announcementQueue() {
+        if (!this._announcementQueue) {
+            this._announcementQueue = new announcement_queue_js_1.AnnouncementQueue({
+                maxSize: 50,
+                maxAgeMs: 30 * 60 * 1000, // 30分钟
+                logger: this.logger
+            });
+        }
+        return this._announcementQueue;
+    }
+    // ========== 信誉系统 ==========
+    /**
+     * 获取信誉系统（懒加载）
+     * 重构：改用 @f2a/network 的 ReputationManager
+     */
+    get reputationSystem() {
+        if (!this._reputationSystem) {
+            this._reputationSystem = new network_1.ReputationManager({
+                initialScore: types_js_1.INTERNAL_REPUTATION_CONFIG.initialScore,
+                minScore: 0,
+                maxScore: 100,
+                decayRate: types_js_1.INTERNAL_REPUTATION_CONFIG.decayRate,
+            });
+        }
+        return this._reputationSystem;
+    }
+    /**
+     * 获取评审委员会（懒加载）
+     * 重构：直接使用 ReputationManager，不需要 Adapter
+     */
+    get reviewCommittee() {
+        if (!this._reviewCommittee) {
+            this._reviewCommittee = new network_2.ReviewCommittee(this.reputationSystem, {
+                minReviewers: 1,
+                maxReviewers: 5,
+                minReputation: types_js_1.INTERNAL_REPUTATION_CONFIG.minScoreForReview,
+                reviewTimeout: 5 * 60 * 1000 // 5 分钟
+            });
+        }
+        return this._reviewCommittee;
+    }
+    // ========== 能力检测 ==========
+    /**
+     * 获取能力检测器（懒加载）
+     */
+    get capabilityDetector() {
+        if (!this._capabilityDetector) {
+            this._capabilityDetector = new capability_detector_js_1.CapabilityDetector();
+        }
+        return this._capabilityDetector;
+    }
+    // ========== 通讯录和握手 ==========
+    /**
+     * 获取联系人管理器（延迟初始化）
+     */
+    get contactManager() {
+        if (!this._contactManager && !this.initializingFlags.contactManager) {
+            this.initializingFlags.contactManager = true;
+            try {
+                const dataDir = this.getDefaultDataDir();
+                this._contactManager = new contact_manager_js_1.ContactManager(dataDir, this.logger);
+                this.logger?.info('[F2A] ContactManager 已初始化');
+            }
+            finally {
+                this.initializingFlags.contactManager = false;
+            }
+        }
+        // P1-4 修复：添加 undefined 检查替代非空断言
+        if (!this._contactManager) {
+            throw new Error('ContactManager 初始化失败');
+        }
+        return this._contactManager;
+    }
+    /**
+     * 获取握手协议处理器（延迟初始化）
+     * 依赖 F2A 实例和 ContactManager
+     */
+    get handshakeProtocol() {
+        if (!this._handshakeProtocol && !this.initializingFlags.handshakeProtocol && this._f2a && this._contactManager) {
+            this.initializingFlags.handshakeProtocol = true;
+            try {
+                this._handshakeProtocol = new handshake_protocol_js_1.HandshakeProtocol(this._f2a, this._contactManager, this.logger, this.config.handshake // 传递配置
+                );
+                this.logger?.info('[F2A] HandshakeProtocol 已初始化');
+            }
+            finally {
+                this.initializingFlags.handshakeProtocol = false;
+            }
+        }
+        // P1-4 修复：添加 undefined 检查替代非空断言
+        if (!this._handshakeProtocol) {
+            throw new Error('HandshakeProtocol 初始化失败（可能 F2A 或 ContactManager 未就绪）');
+        }
+        return this._handshakeProtocol;
+    }
+    // ========== F2A 实例管理 ==========
+    /**
+     * 设置 F2A 实例
+     */
+    setF2A(f2a) {
+        this._f2a = f2a;
+    }
+    // ========== Logger 管理 ==========
+    /**
+     * 更新 Logger
+     */
+    updateLogger(logger) {
+        this.logger = logger;
+    }
+    // ========== 公共接口 getter（F2APluginPublicInterface 实现） ==========
+    // P2-1 修复：返回简化接口类型，使用类型断言避免严格的类型匹配问题
+    /**
+     * 获取网络客户端（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getNetworkClient() {
+        return this.networkClient;
+    }
+    /**
+     * 获取信誉系统（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getReputationSystem() {
+        return this.reputationSystem;
+    }
+    /**
+     * 获取节点管理器（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getNodeManager() {
+        return this.nodeManager;
+    }
+    /**
+     * 获取任务队列（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getTaskQueue() {
+        return this.taskQueue;
+    }
+    /**
+     * 获取公告队列（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getAnnouncementQueue() {
+        return this.announcementQueue;
+    }
+    /**
+     * 获取评审委员会（公共接口）
+     * 触发懒加载
+     */
+    getReviewCommittee() {
+        // 触发懒加载
+        return this.reviewCommittee;
+    }
+    /**
+     * 获取联系人管理器（公共接口）
+     * @throws Error 如果组件初始化失败
+     */
+    getContactManager() {
+        return this.contactManager;
+    }
+    /**
+     * 获取握手协议处理器（公共接口）
+     * @throws Error 如果 F2A 或 ContactManager 未就绪
+     */
+    getHandshakeProtocol() {
+        return this.handshakeProtocol;
+    }
+    /**
+     * 获取 F2A 状态（公共接口）
+     */
+    getF2AStatus() {
+        if (!this._f2a) {
+            return { running: false };
+        }
+        return {
+            running: true,
+            peerId: this._f2a.peerId,
+        };
+    }
+    /**
+     * 获取 F2A 实例（公共接口）
+     * 返回 F2A 公共接口供需要直接访问的场景使用。
+     * 注意：返回 undefined 表示 F2A 实例未初始化。
+     */
+    getF2A() {
+        return this._f2a;
+    }
+    // ========== 清理 ==========
+    /**
+     * 清理所有组件（用于 shutdown）
+     */
+    async cleanup() {
+        // TaskQueue 需要关闭持久化
+        if (this._taskQueue) {
+            this._taskQueue.close?.();
+            this._taskQueue = undefined;
+        }
+        // 清空其他组件引用
+        this._nodeManager = undefined;
+        this._networkClient = undefined;
+        this._reputationSystem = undefined;
+        this._capabilityDetector = undefined;
+        this._announcementQueue = undefined;
+        this._reviewCommittee = undefined;
+        this._contactManager = undefined;
+        this._handshakeProtocol = undefined;
+        this._f2a = undefined;
+        // 重置初始化标志
+        this.initializingFlags = {
+            nodeManager: false,
+            taskQueue: false,
+            contactManager: false,
+            handshakeProtocol: false,
+        };
+    }
+}
+exports.F2AComponentRegistry = F2AComponentRegistry;
+//# sourceMappingURL=F2AComponentRegistry.js.map

package/dist/F2AComponentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"F2AComponentRegistry.js","sourceRoot":"","sources":["../src/F2AComponentRegistry.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,+BAAwC;AACxC,2BAA6B;AAiB7B,yCAAwD;AACxD,uDAAmD;AACnD,2DAAuD;AACvD,0CAAiD;AACjD,qEAA8D;AAC9D,mDAA4C;AAC5C,mEAA4D;AAC5D,0CAAoD;AACpD,6DAAsD;AACtD,mEAA4D;AAC5D,iEAAoD;AA0BpD;;;;;;;;GAQG;AACH,MAAa,oBAAoB;IAC/B,8BAA8B;IAEtB,MAAM,CAAkB;IACxB,UAAU,CAAgB;IAC1B,GAAG,CAAqB;IACxB,MAAM,CAAa;IAE3B,kCAAkC;IAE1B,YAAY,CAAkB;IAC9B,cAAc,CAAoB;IAClC,iBAAiB,CAAqB;IACtC,mBAAmB,CAAsB;IACzC,UAAU,CAAa;IACvB,kBAAkB,CAAqB;IACvC,gBAAgB,CAAmB;IACnC,eAAe,CAAkB;IACjC,kBAAkB,CAAqB;IAE/C,8BAA8B;IAEtB,iBAAiB,GAAsB;QAC7C,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,KAAK;QACrB,iBAAiB,EAAE,KAAK;KACzB,CAAC;IAEF,iCAAiC;IAEjC,kCAAkC;IAC1B,IAAI,CAAO;IAEnB,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,6BAA6B;IAE7B;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAgC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,6BAA6B;IAE7B;;;;;;;OAOG;IACH,iBAAiB;QACf,oBAAoB;QACpB,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;QAED,2BAA2B;QAC3B,MAAM,SAAS,GAAI,IAAI,CAAC,GAAG,EAAE,MAAyB,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;QAEpF,qBAAqB;QACrB,IAAI,IAAA,iCAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAA,WAAI,EAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,QAAQ;QACR,OAAO,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,6BAA6B;IAE7B;;OAEG;IACH,IAAI,WAAW;QACb,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC;YAC9D,IAAI,CAAC,iBAAiB,CAAC,WAAW,GAAG,IAAI,CAAC;YAC1C,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACvE,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,iBAAiB,CAAC,WAAW,GAAG,KAAK,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,GAAG,IAAI,oCAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YAC1D,IAAI,CAAC,iBAAiB,CAAC,SAAS,GAAG,IAAI,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACzC,IAAI,CAAC,UAAU,GAAG,IAAI,yBAAS,CAAC;oBAC9B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,GAAG;oBAC1C,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO;oBACtC,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,IAAI;oBACpB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;gBACH,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACjD,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,iBAAiB,CAAC,SAAS,GAAG,KAAK,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,iBAAiB;QACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,yCAAiB,CAAC;gBAC9C,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO;gBACjC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,6BAA6B;IAE7B;;;OAGG;IACH,IAAI,gBAAgB;QAClB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,2BAAiB,CAAC;gBAC7C,YAAY,EAAE,qCAA0B,CAAC,YAAY;gBACrD,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,GAAG;gBACb,SAAS,EAAE,qCAA0B,CAAC,SAAS;aAChD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,IAAI,eAAe;QACjB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,IAAI,yBAAe,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBACjE,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,aAAa,EAAE,qCAA0B,CAAC,iBAAiB;gBAC3D,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO;aACrC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,6BAA6B;IAE7B;;OAEG;IACH,IAAI,kBAAkB;QACpB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,IAAI,CAAC,mBAAmB,GAAG,IAAI,2CAAkB,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,+BAA+B;IAE/B;;OAEG;IACH,IAAI,cAAc;QAChB,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,CAAC;YACpE,IAAI,CAAC,iBAAiB,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACzC,IAAI,CAAC,eAAe,GAAG,IAAI,mCAAc,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACjD,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,iBAAiB,CAAC,cAAc,GAAG,KAAK,CAAC;YAChD,CAAC;QACH,CAAC;QACD,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,iBAAiB;QACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC/G,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAChD,IAAI,CAAC;gBACH,IAAI,CAAC,kBAAkB,GAAG,IAAI,yCAAiB,CAC7C,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CAAC,SAAS,CAAE,OAAO;iBAC/B,CAAC;gBACF,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,8BAA8B,CAAC,CAAC;YACpD,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,KAAK,CAAC;YACnD,CAAC;QACH,CAAC;QACD,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,iCAAiC;IAEjC;;OAEG;IACH,MAAM,CAAC,GAAoB;QACzB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,kCAAkC;IAElC;;OAEG;IACH,YAAY,CAAC,MAA6B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,iEAAiE;IACjE,qCAAqC;IAErC;;;OAGG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAgD,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAmD,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAyC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAqC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,iBAAqD,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,QAAQ;QACR,OAAO,IAAI,CAAC,eAA6D,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAA+C,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,iBAAqD,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;SACzB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,IAAiD,CAAC;IAChE,CAAC;IAED,2BAA2B;IAE3B;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,oBAAoB;QACpB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,WAAW;QACX,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;QACrC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QAEtB,UAAU;QACV,IAAI,CAAC,iBAAiB,GAAG;YACvB,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,KAAK;YACrB,iBAAiB,EAAE,KAAK;SACzB,CAAC;IACJ,CAAC;CACF;AA9YD,oDA8YC"}