@f2a/openclaw-f2a 0.3.3 → 0.3.5

package/dist/F2AMessageRouter.d.ts

@@ -0,0 +1,108 @@
+/**
+ * F2A 消息路由器
+ *
+ * 负责消息的去重、分发和路由。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AMessageRouter
+ */
+import type { ApiLogger, F2APublicInterface } from './types.js';
+/**
+ * 消息事件结构
+ */
+export interface F2AMessageEvent {
+    from: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    messageId: string;
+}
+/**
+ * 消息路由器配置
+ */
+export interface MessageRouterConfig {
+    /** 最大缓存大小 */
+    maxCacheSize: number;
+    /** 缓存 TTL（毫秒） */
+    cacheTtlMs: number;
+    /** 启用哈希去重的消息长度阈值 */
+    hashThreshold: number;
+}
+/** 默认配置 */
+export declare const DEFAULT_ROUTER_CONFIG: MessageRouterConfig;
+/**
+ * 消息路由器依赖
+ */
+export interface MessageRouterDeps {
+    /** F2A 实例（用于获取 peerId） */
+    f2a?: F2APublicInterface;
+    /** Logger */
+    logger?: ApiLogger;
+}
+/**
+ * F2A 消息路由器
+ *
+ * 功能：
+ * 1. 消息去重（基于 metadata 标记 + 内容哈希）
+ * 2. 回声消息检测（防止循环）
+ * 3. 消息哈希缓存管理
+ */
+export declare class F2AMessageRouter {
+    private deps;
+    private config;
+    /** 已处理消息哈希缓存 */
+    private processedHashes;
+    constructor(deps: MessageRouterDeps, config?: MessageRouterConfig);
+    /**
+     * 检测是否为回声消息（避免循环）
+     *
+     * 使用多层验证策略：
+     * 1. 检查 metadata 中的特定标记
+     * 2. 检查消息内容中的特殊标记
+     * 3. 检查消息来源是否为自己的 peerId
+     * 4. 基于消息内容哈希的去重机制
+     *
+     * @param msg - 接收到的消息
+     * @returns 是否为应该跳过的回声消息
+     */
+    isEchoMessage(msg: F2AMessageEvent): boolean;
+    /**
+     * 计算消息内容哈希
+     *
+     * 使用 SHA256 算法生成安全的哈希值。
+     *
+     * @param from - 发送者 peerId
+     * @param content - 消息内容
+     * @returns 哈希标识符
+     */
+    private computeHash;
+    /**
+     * 清理过期的消息哈希缓存
+     *
+     * @param now - 当前时间戳
+     */
+    private cleanupCache;
+    /**
+     * 更新 F2A 实例（运行时更新）
+     *
+     * @param f2a - 新的 F2A 实例
+     */
+    updateF2A(f2a: F2APublicInterface | undefined): void;
+    /**
+     * 更新 Logger（运行时更新）
+     *
+     * @param logger - 新的 Logger
+     */
+    updateLogger(logger: ApiLogger | undefined): void;
+    /**
+     * 清空缓存（用于测试或重置）
+     */
+    clearCache(): void;
+    /**
+     * 获取缓存统计信息
+     */
+    getCacheStats(): {
+        size: number;
+        maxAge: number;
+    };
+}
+//# sourceMappingURL=F2AMessageRouter.d.ts.map

package/dist/F2AMessageRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"F2AMessageRouter.d.ts","sourceRoot":"","sources":["../src/F2AMessageRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,WAAW;AACX,eAAO,MAAM,qBAAqB,EAAE,mBAInC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,aAAa;IACb,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAsB;IAEpC,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAkC;gBAE7C,IAAI,EAAE,iBAAiB,EAAE,MAAM,GAAE,mBAA2C;IAKxF;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO;IA2D5C;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI;IAIpD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IAIjD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAQlD"}

package/dist/F2AMessageRouter.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * F2A 消息路由器
+ *
+ * 负责消息的去重、分发和路由。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AMessageRouter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.F2AMessageRouter = exports.DEFAULT_ROUTER_CONFIG = void 0;
+const crypto_1 = require("crypto");
+/** 默认配置 */
+exports.DEFAULT_ROUTER_CONFIG = {
+    maxCacheSize: 10000,
+    cacheTtlMs: 5 * 60 * 1000, // 5 分钟
+    hashThreshold: 100,
+};
+/**
+ * F2A 消息路由器
+ *
+ * 功能：
+ * 1. 消息去重（基于 metadata 标记 + 内容哈希）
+ * 2. 回声消息检测（防止循环）
+ * 3. 消息哈希缓存管理
+ */
+class F2AMessageRouter {
+    deps;
+    config;
+    /** 已处理消息哈希缓存 */
+    processedHashes = new Map();
+    constructor(deps, config = exports.DEFAULT_ROUTER_CONFIG) {
+        this.deps = deps;
+        this.config = config;
+    }
+    /**
+     * 检测是否为回声消息（避免循环）
+     *
+     * 使用多层验证策略：
+     * 1. 检查 metadata 中的特定标记
+     * 2. 检查消息内容中的特殊标记
+     * 3. 检查消息来源是否为自己的 peerId
+     * 4. 基于消息内容哈希的去重机制
+     *
+     * @param msg - 接收到的消息
+     * @returns 是否为应该跳过的回声消息
+     */
+    isEchoMessage(msg) {
+        const { metadata, content, from } = msg;
+        // 层1: 检查 metadata 中的标记
+        if (metadata) {
+            // 检查是否是回复消息标记
+            if (metadata.type === 'reply' && metadata.replyTo) {
+                return true;
+            }
+            // 检查显式的跳过标记
+            if (metadata._f2a_skip_echo === true || metadata['x-openclaw-skip'] === true) {
+                return true;
+            }
+        }
+        // 层2: 检查消息内容中的特殊标记
+        if (content) {
+            if (content.includes('[[F2A:REPLY:') || content.includes('[[reply_to_current]]')) {
+                return true;
+            }
+            if (content.startsWith('NO_REPLY:') || content.startsWith('[NO_REPLY]')) {
+                return true;
+            }
+        }
+        // 层3: 检查消息来源是否是我们自己的 peerId（防止自循环）
+        if (this.deps.f2a && from === this.deps.f2a.peerId) {
+            return true;
+        }
+        // 层4: 基于消息内容哈希的去重机制（仅对长消息启用）
+        if (content && content.length > this.config.hashThreshold) {
+            const messageHash = this.computeHash(from, content);
+            const now = Date.now();
+            // 检查是否已处理过相同的消息内容
+            if (this.processedHashes.has(messageHash)) {
+                const processedTime = this.processedHashes.get(messageHash);
+                // 如果在 TTL 内，认为是重复消息
+                if (now - processedTime < this.config.cacheTtlMs) {
+                    this.deps.logger?.debug?.(`[F2A] 检测到重复消息（哈希去重）: ${messageHash.slice(0, 16)}...`);
+                    return true;
+                }
+            }
+            // 记录此消息哈希
+            this.processedHashes.set(messageHash, now);
+            // 清理过期的条目（防止内存泄漏）
+            if (this.processedHashes.size > this.config.maxCacheSize) {
+                this.cleanupCache(now);
+            }
+        }
+        return false;
+    }
+    /**
+     * 计算消息内容哈希
+     *
+     * 使用 SHA256 算法生成安全的哈希值。
+     *
+     * @param from - 发送者 peerId
+     * @param content - 消息内容
+     * @returns 哈希标识符
+     */
+    computeHash(from, content) {
+        const data = `${from}:${content}`;
+        const hash = (0, crypto_1.createHash)('sha256').update(data).digest('hex');
+        return `msg-${hash.slice(0, 32)}-${data.length}`;
+    }
+    /**
+     * 清理过期的消息哈希缓存
+     *
+     * @param now - 当前时间戳
+     */
+    cleanupCache(now) {
+        for (const [hash, timestamp] of this.processedHashes.entries()) {
+            if (now - timestamp > this.config.cacheTtlMs) {
+                this.processedHashes.delete(hash);
+            }
+        }
+    }
+    /**
+     * 更新 F2A 实例（运行时更新）
+     *
+     * @param f2a - 新的 F2A 实例
+     */
+    updateF2A(f2a) {
+        this.deps.f2a = f2a;
+    }
+    /**
+     * 更新 Logger（运行时更新）
+     *
+     * @param logger - 新的 Logger
+     */
+    updateLogger(logger) {
+        this.deps.logger = logger;
+    }
+    /**
+     * 清空缓存（用于测试或重置）
+     */
+    clearCache() {
+        this.processedHashes.clear();
+    }
+    /**
+     * 获取缓存统计信息
+     */
+    getCacheStats() {
+        let maxAge = 0;
+        const now = Date.now();
+        for (const timestamp of this.processedHashes.values()) {
+            maxAge = Math.max(maxAge, now - timestamp);
+        }
+        return { size: this.processedHashes.size, maxAge };
+    }
+}
+exports.F2AMessageRouter = F2AMessageRouter;
+//# sourceMappingURL=F2AMessageRouter.js.map

package/dist/F2AMessageRouter.js.map

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

package/dist/F2AToolRegistry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * F2A 工具注册器
+ *
+ * 负责 F2A 工具的注册和组装。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AToolRegistry
+ */
+import type { Tool } from './types.js';
+import type { ToolHandlers } from './tool-handlers.js';
+import type { ClaimHandlers } from './claim-handlers.js';
+import type { ContactToolHandlers } from './contact-tool-handlers.js';
+/**
+ * 工具注册器依赖
+ */
+export interface ToolRegistryDeps {
+    /** 工具处理器 */
+    toolHandlers: ToolHandlers;
+    /** 认领处理器 */
+    claimHandlers: ClaimHandlers;
+    /** 通讯录工具处理器 */
+    contactToolHandlers: ContactToolHandlers;
+}
+/**
+ * F2A 工具注册器
+ *
+ * 负责组装所有 F2A 工具（网络工具、任务工具、通讯录工具）。
+ */
+export declare class F2AToolRegistry {
+    private deps;
+    constructor(deps: ToolRegistryDeps);
+    /**
+     * 获取所有 F2A 工具
+     *
+     * @returns 工具列表
+     */
+    getTools(): Tool[];
+    /**
+     * 更新依赖（用于运行时更新处理器）
+     *
+     * @param deps - 新的依赖
+     */
+    updateDeps(deps: Partial<ToolRegistryDeps>): void;
+}
+//# sourceMappingURL=F2AToolRegistry.d.ts.map

package/dist/F2AToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"F2AToolRegistry.d.ts","sourceRoot":"","sources":["../src/F2AToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY;IACZ,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe;IACf,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAmB;gBAEnB,IAAI,EAAE,gBAAgB;IAIlC;;;;OAIG;IACH,QAAQ,IAAI,IAAI,EAAE;IAwClB;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAKlD"}

package/dist/F2AToolRegistry.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * F2A 工具注册器
+ *
+ * 负责 F2A 工具的注册和组装。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AToolRegistry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.F2AToolRegistry = void 0;
+const index_js_1 = require("./tools/index.js");
+/**
+ * F2A 工具注册器
+ *
+ * 负责组装所有 F2A 工具（网络工具、任务工具、通讯录工具）。
+ */
+class F2AToolRegistry {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * 获取所有 F2A 工具
+     *
+     * @returns 工具列表
+     */
+    getTools() {
+        // 网络、状态、信誉工具
+        const networkTools = (0, index_js_1.getNetworkTools)({
+            handleDiscover: this.deps.toolHandlers.handleDiscover.bind(this.deps.toolHandlers),
+            handleDelegate: this.deps.toolHandlers.handleDelegate.bind(this.deps.toolHandlers),
+            handleBroadcast: this.deps.toolHandlers.handleBroadcast.bind(this.deps.toolHandlers),
+            handleStatus: this.deps.toolHandlers.handleStatus.bind(this.deps.toolHandlers),
+            handleReputation: this.deps.toolHandlers.handleReputation.bind(this.deps.toolHandlers),
+        });
+        // 任务工具
+        const taskTools = (0, index_js_1.getTaskTools)({
+            handlePollTasks: this.deps.toolHandlers.handlePollTasks.bind(this.deps.toolHandlers),
+            handleSubmitResult: this.deps.toolHandlers.handleSubmitResult.bind(this.deps.toolHandlers),
+            handleTaskStats: this.deps.toolHandlers.handleTaskStats.bind(this.deps.toolHandlers),
+            handleAnnounce: this.deps.claimHandlers.handleAnnounce.bind(this.deps.claimHandlers),
+            handleListAnnouncements: this.deps.claimHandlers.handleListAnnouncements.bind(this.deps.claimHandlers),
+            handleClaim: this.deps.claimHandlers.handleClaim.bind(this.deps.claimHandlers),
+            handleManageClaims: this.deps.claimHandlers.handleManageClaims.bind(this.deps.claimHandlers),
+            handleMyClaims: this.deps.claimHandlers.handleMyClaims.bind(this.deps.claimHandlers),
+            handleAnnouncementStats: this.deps.claimHandlers.handleAnnouncementStats.bind(this.deps.claimHandlers),
+            handleEstimateTask: this.deps.toolHandlers.handleEstimateTask.bind(this.deps.toolHandlers),
+            handleReviewTask: this.deps.toolHandlers.handleReviewTask.bind(this.deps.toolHandlers),
+            handleGetReviews: this.deps.toolHandlers.handleGetReviews.bind(this.deps.toolHandlers),
+            handleGetCapabilities: this.deps.toolHandlers.handleGetCapabilities.bind(this.deps.toolHandlers),
+        });
+        // 通讯录工具
+        const contactTools = (0, index_js_1.getContactTools)({
+            handleContacts: this.deps.contactToolHandlers.handleContacts.bind(this.deps.contactToolHandlers),
+            handleContactGroups: this.deps.contactToolHandlers.handleContactGroups.bind(this.deps.contactToolHandlers),
+            handleFriendRequest: this.deps.contactToolHandlers.handleFriendRequest.bind(this.deps.contactToolHandlers),
+            handlePendingRequests: this.deps.contactToolHandlers.handlePendingRequests.bind(this.deps.contactToolHandlers),
+            handleContactsExport: this.deps.contactToolHandlers.handleContactsExport.bind(this.deps.contactToolHandlers),
+            handleContactsImport: this.deps.contactToolHandlers.handleContactsImport.bind(this.deps.contactToolHandlers),
+        });
+        return [...networkTools, ...taskTools, ...contactTools];
+    }
+    /**
+     * 更新依赖（用于运行时更新处理器）
+     *
+     * @param deps - 新的依赖
+     */
+    updateDeps(deps) {
+        if (deps.toolHandlers)
+            this.deps.toolHandlers = deps.toolHandlers;
+        if (deps.claimHandlers)
+            this.deps.claimHandlers = deps.claimHandlers;
+        if (deps.contactToolHandlers)
+            this.deps.contactToolHandlers = deps.contactToolHandlers;
+    }
+}
+exports.F2AToolRegistry = F2AToolRegistry;
+//# sourceMappingURL=F2AToolRegistry.js.map

package/dist/F2AToolRegistry.js.map

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

package/dist/F2AWebhookManager.d.ts

@@ -0,0 +1,79 @@
+/**
+ * F2A Webhook 管理器
+ *
+ * 负责管理 Webhook 处理器的创建和配置。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * @module F2AWebhookManager
+ */
+import type { AgentCapability, ApiLogger, F2APluginConfig, TaskQueueLike } from './types.js';
+import type { WebhookHandler } from './webhook-server.js';
+import type { WebhookPusher } from './webhook-pusher.js';
+import type { ReputationSystemLike } from './types.js';
+import type { OpenClawPluginApi } from './types.js';
+/**
+ * Webhook 管理器依赖
+ */
+export interface WebhookManagerDeps {
+    /** 插件配置 */
+    config: F2APluginConfig;
+    /** 能力列表 */
+    capabilities: AgentCapability[];
+    /** Logger */
+    logger?: ApiLogger;
+    /** 信誉系统 */
+    reputationSystem: ReputationSystemLike;
+    /** 任务队列 */
+    taskQueue: TaskQueueLike;
+    /** Webhook 推送器（可选） */
+    webhookPusher?: WebhookPusher;
+    /** OpenClaw API */
+    api?: OpenClawPluginApi;
+    /** 消息处理函数 */
+    invokeOpenClawAgent: (from: string, message: string) => Promise<string | undefined>;
+}
+/**
+ * F2A Webhook 管理器
+ *
+ * 功能：
+ * 1. 创建和配置 Webhook 处理器
+ * 2. 处理 discover、delegate、message、status 等 webhook 事件
+ */
+export declare class F2AWebhookManager {
+    private deps;
+    constructor(deps: WebhookManagerDeps);
+    /**
+     * 创建 Webhook 处理器
+     */
+    createHandler(): WebhookHandler;
+    /**
+     * 处理 discover webhook
+     */
+    private handleDiscover;
+    /**
+     * 处理 delegate webhook
+     */
+    private handleDelegate;
+    /**
+     * 处理 message webhook
+     */
+    private handleMessage;
+    /**
+     * 处理 status webhook
+     */
+    private handleStatus;
+    /**
+     * 更新依赖（用于运行时更新）
+     */
+    updateDeps(deps: Partial<WebhookManagerDeps>): void;
+    /**
+     * 更新能力列表
+     */
+    updateCapabilities(capabilities: AgentCapability[]): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: F2APluginConfig): void;
+}
+export default F2AWebhookManager;
+//# sourceMappingURL=F2AWebhookManager.d.ts.map

package/dist/F2AWebhookManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"F2AWebhookManager.d.ts","sourceRoot":"","sources":["../src/F2AWebhookManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAGV,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW;IACX,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,aAAa;IACb,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW;IACX,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,WAAW;IACX,SAAS,EAAE,aAAa,CAAC;IACzB,sBAAsB;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mBAAmB;IACnB,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,aAAa;IACb,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACrF;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAqB;gBAErB,IAAI,EAAE,kBAAkB;IAIpC;;OAEG;IACH,aAAa,IAAI,cAAc;IAoB/B;;OAEG;YACW,cAAc;IAwB5B;;OAEG;YACW,cAAc;IAuG5B;;OAEG;YACW,aAAa;IAuC3B;;OAEG;YACW,YAAY;IAe1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAWnD;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI;IAIzD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CAG5C;AAED,eAAe,iBAAiB,CAAC"}