@teneo-protocol/sdk 1.0.0

package/dist/managers/message-router.d.ts

@@ -0,0 +1,112 @@
+/**
+ * MessageRouter - Manages message sending and routing
+ * Handles user messages, direct commands, and message-response patterns
+ */
+import { EventEmitter } from "eventemitter3";
+import { WebSocketClient } from "../core/websocket-client";
+import { WebhookHandler } from "../handlers/webhook-handler";
+import { ResponseFormatter, FormattedResponse } from "../formatters/response-formatter";
+import { Logger, ResponseFormat } from "../types";
+import { SDKEvents } from "../types/events";
+export interface SendMessageOptions {
+    room: string;
+    from?: string;
+    waitForResponse?: boolean;
+    timeout?: number;
+    format?: ResponseFormat | "raw" | "humanized";
+}
+export interface AgentCommand {
+    agent: string;
+    command: string;
+    room: string;
+}
+export declare class MessageRouter extends EventEmitter<SDKEvents> {
+    private readonly wsClient;
+    private readonly webhookHandler;
+    private readonly responseFormatter;
+    private readonly logger;
+    private readonly messageTimeout;
+    private readonly responseFormat;
+    constructor(wsClient: WebSocketClient, webhookHandler: WebhookHandler, responseFormatter: ResponseFormatter, logger: Logger, config: {
+        messageTimeout?: number;
+        responseFormat?: ResponseFormat;
+    });
+    /**
+     * Sends a message to agents via the coordinator.
+     * The coordinator intelligently selects the most appropriate agent.
+     * Supports optional response waiting with configurable timeout and format.
+     *
+     * @param content - The message content to send
+     * @param options - Configuration for message sending
+     * @param options.room - Room to send to (required)
+     * @param options.from - Sender address (defaults to authenticated wallet)
+     * @param options.waitForResponse - Whether to wait for response (default: false)
+     * @param options.timeout - Response timeout in ms (default: 60000)
+     * @param options.format - Response format: 'raw', 'humanized', or 'both'
+     * @returns Promise resolving to FormattedResponse if waiting, void otherwise
+     * @throws {SDKError} If not connected
+     * @throws {ValidationError} If content is empty, room not specified, or options invalid
+     * @throws {TimeoutError} If waitForResponse and timeout exceeded
+     *
+     * @example
+     * ```typescript
+     * // Fire and forget
+     * await messageRouter.sendMessage('What is the weather?', { room: 'general' });
+     *
+     * // Wait for response
+     * const response = await messageRouter.sendMessage('Calculate 2+2', {
+     *   room: 'general',
+     *   waitForResponse: true,
+     *   timeout: 30000
+     * });
+     * console.log(response.humanized);
+     * ```
+     */
+    sendMessage(content: string, options: SendMessageOptions): Promise<FormattedResponse | void>;
+    /**
+     * Sends a direct command to a specific agent, bypassing the coordinator.
+     * Formats command as "@agentName command" internally.
+     *
+     * @param command - The direct agent command configuration
+     * @param command.agent - Agent ID or name to send command to
+     * @param command.command - Command text to send
+     * @param command.room - Room to send in (required)
+     * @returns Promise that resolves when command is sent
+     * @throws {SDKError} If not connected
+     * @throws {ValidationError} If agent/command empty or room not specified
+     *
+     * @example
+     * ```typescript
+     * await messageRouter.sendDirectCommand({
+     *   agent: 'weather-agent',
+     *   command: 'Get forecast for Tokyo',
+     *   room: 'general'
+     * });
+     * ```
+     */
+    sendDirectCommand(command: AgentCommand): Promise<FormattedResponse | void>;
+    /**
+     * Send message and wait for agent response
+     * Uses event-waiter utility for clean Promise-based waiting with automatic cleanup
+     */
+    private sendMessageAndWaitForResponse;
+    /**
+     * Set up event forwarding from WebSocket client
+     */
+    private setupEventForwarding;
+    /**
+     * Destroys the message router and cleans up resources.
+     * Removes all event listeners and marks the router as destroyed.
+     * After destruction, the router cannot be reused.
+     *
+     * Note: Any pending waitForEvent calls will automatically timeout and clean up.
+     *
+     * @example
+     * ```typescript
+     * messageRouter.destroy();
+     * console.log('Message router destroyed');
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=message-router.d.ts.map

package/dist/managers/message-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.d.ts","sourceRoot":"","sources":["../../src/managers/message-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACxF,OAAO,EAGL,MAAM,EACN,cAAc,EAEf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAA4C,MAAM,iBAAiB,CAAC;AAUtF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,GAAG,KAAK,GAAG,WAAW,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAc,SAAQ,YAAY,CAAC,SAAS,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAG9C,QAAQ,EAAE,eAAe,EACzB,cAAc,EAAE,cAAc,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;QACN,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC;IAaH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACU,WAAW,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAiCpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAmCxF;;;OAGG;YACW,6BAA6B;IA8C3C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkF5B;;;;;;;;;;;;OAYG;IACI,OAAO,IAAI,IAAI;CAOvB"}

package/dist/managers/message-router.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * MessageRouter - Manages message sending and routing
+ * Handles user messages, direct commands, and message-response patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageRouter = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const uuid_1 = require("uuid");
+const types_1 = require("../types");
+const events_1 = require("../types/events");
+const error_codes_1 = require("../types/error-codes");
+const constants_1 = require("../constants");
+const validation_1 = require("../types/validation");
+const event_waiter_1 = require("../utils/event-waiter");
+class MessageRouter extends eventemitter3_1.EventEmitter {
+    constructor(wsClient, webhookHandler, responseFormatter, logger, config) {
+        super();
+        this.wsClient = wsClient;
+        this.webhookHandler = webhookHandler;
+        this.responseFormatter = responseFormatter;
+        this.logger = logger;
+        this.messageTimeout = config.messageTimeout ?? constants_1.TIMEOUTS.DEFAULT_MESSAGE_TIMEOUT;
+        this.responseFormat = config.responseFormat ?? "humanized";
+        this.setupEventForwarding();
+    }
+    /**
+     * Sends a message to agents via the coordinator.
+     * The coordinator intelligently selects the most appropriate agent.
+     * Supports optional response waiting with configurable timeout and format.
+     *
+     * @param content - The message content to send
+     * @param options - Configuration for message sending
+     * @param options.room - Room to send to (required)
+     * @param options.from - Sender address (defaults to authenticated wallet)
+     * @param options.waitForResponse - Whether to wait for response (default: false)
+     * @param options.timeout - Response timeout in ms (default: 60000)
+     * @param options.format - Response format: 'raw', 'humanized', or 'both'
+     * @returns Promise resolving to FormattedResponse if waiting, void otherwise
+     * @throws {SDKError} If not connected
+     * @throws {ValidationError} If content is empty, room not specified, or options invalid
+     * @throws {TimeoutError} If waitForResponse and timeout exceeded
+     *
+     * @example
+     * ```typescript
+     * // Fire and forget
+     * await messageRouter.sendMessage('What is the weather?', { room: 'general' });
+     *
+     * // Wait for response
+     * const response = await messageRouter.sendMessage('Calculate 2+2', {
+     *   room: 'general',
+     *   waitForResponse: true,
+     *   timeout: 30000
+     * });
+     * console.log(response.humanized);
+     * ```
+     */
+    async sendMessage(content, options) {
+        if (!this.wsClient.isConnected) {
+            throw new events_1.SDKError("Not connected to Teneo network", error_codes_1.ErrorCode.NOT_CONNECTED);
+        }
+        // Validate content
+        const validatedContent = validation_1.MessageContentSchema.parse(content);
+        const room = options.room;
+        if (!room) {
+            throw new events_1.ValidationError("Room parameter is required");
+        }
+        // Use custom 'from' address if provided, otherwise use wallet address from auth state
+        const authState = this.wsClient.getAuthState();
+        const fromAddress = options.from ?? authState.walletAddress;
+        const message = (0, types_1.createUserMessage)(validatedContent, room, fromAddress);
+        this.logger.debug("MessageRouter: Sending message", {
+            content: validatedContent,
+            room,
+            from: fromAddress
+        });
+        if (options.waitForResponse) {
+            return await this.sendMessageAndWaitForResponse(message, options);
+        }
+        else {
+            await this.wsClient.sendMessage(message);
+            await this.webhookHandler.sendMessageWebhook(message);
+        }
+    }
+    /**
+     * Sends a direct command to a specific agent, bypassing the coordinator.
+     * Formats command as "@agentName command" internally.
+     *
+     * @param command - The direct agent command configuration
+     * @param command.agent - Agent ID or name to send command to
+     * @param command.command - Command text to send
+     * @param command.room - Room to send in (required)
+     * @returns Promise that resolves when command is sent
+     * @throws {SDKError} If not connected
+     * @throws {ValidationError} If agent/command empty or room not specified
+     *
+     * @example
+     * ```typescript
+     * await messageRouter.sendDirectCommand({
+     *   agent: 'weather-agent',
+     *   command: 'Get forecast for Tokyo',
+     *   room: 'general'
+     * });
+     * ```
+     */
+    async sendDirectCommand(command) {
+        if (!this.wsClient.isConnected) {
+            throw new events_1.SDKError("Not connected to Teneo network", error_codes_1.ErrorCode.NOT_CONNECTED);
+        }
+        // Validate command
+        const validatedAgent = validation_1.AgentIdSchema.parse(command.agent);
+        const validatedCommand = validation_1.AgentCommandContentSchema.parse(command.command);
+        const room = command.room;
+        if (!room) {
+            throw new events_1.ValidationError("Room parameter is required");
+        }
+        // Get wallet address from auth state
+        const authState = this.wsClient.getAuthState();
+        const walletAddress = authState.walletAddress;
+        // Format as direct command
+        const content = `@${validatedAgent} ${validatedCommand}`;
+        const message = (0, types_1.createUserMessage)(content, room, walletAddress);
+        this.logger.debug("MessageRouter: Sending direct command", {
+            agent: validatedAgent,
+            command: validatedCommand,
+            room,
+            from: walletAddress
+        });
+        await this.wsClient.sendMessage(message);
+        await this.webhookHandler.sendMessageWebhook(message);
+    }
+    /**
+     * Send message and wait for agent response
+     * Uses event-waiter utility for clean Promise-based waiting with automatic cleanup
+     */
+    async sendMessageAndWaitForResponse(message, options) {
+        // Generate unique request ID for correlation
+        const requestId = (0, uuid_1.v4)();
+        const timeout = options.timeout ?? this.messageTimeout;
+        const format = options.format ?? this.responseFormat;
+        // Add client_request_id to message data for server-side correlation
+        const messageWithId = {
+            ...message,
+            data: {
+                ...(message.data || {}),
+                client_request_id: requestId
+            }
+        };
+        this.logger.debug("Sending message with request tracking", { requestId });
+        // Send message first (fail fast if send fails)
+        await this.wsClient.sendMessage(messageWithId);
+        // Wait for agent response with automatic timeout and cleanup
+        // The filter ensures we only match responses for THIS specific request
+        const response = await (0, event_waiter_1.waitForEvent)(this.wsClient, "agent:response", {
+            timeout,
+            filter: (r) => {
+                // Try to match by client_request_id if server echoes it back
+                const responseRequestId = r.raw?.data && "client_request_id" in r.raw.data
+                    ? r.raw.data.client_request_id
+                    : undefined;
+                return responseRequestId === requestId;
+            },
+            timeoutMessage: `Message timeout - no response received after ${timeout}ms (requestId: ${requestId})`
+        });
+        // Format response according to requested format
+        if (format === "raw" && response.raw) {
+            return response.raw;
+        }
+        return response;
+    }
+    /**
+     * Set up event forwarding from WebSocket client
+     */
+    setupEventForwarding() {
+        // Forward message events
+        this.wsClient.on("message:sent", (message) => {
+            this.emit("message:sent", message);
+            // Fire and forget - don't block event emission
+            this.webhookHandler.sendMessageWebhook(message).catch((error) => {
+                this.logger.error("Failed to send webhook for message:sent", error);
+            });
+        });
+        this.wsClient.on("message:received", (message) => {
+            this.emit("message:received", message);
+            // Send webhook for received messages (fire-and-forget)
+            if (message.type !== "ping" && message.type !== "pong") {
+                this.webhookHandler.sendMessageWebhook(message).catch((error) => {
+                    this.logger.error("Failed to send webhook for message:received", error);
+                });
+            }
+        });
+        this.wsClient.on("message:error", (error, message) => this.emit("message:error", error, message));
+        // Forward agent events
+        this.wsClient.on("agent:selected", (data) => {
+            this.emit("agent:selected", data);
+            // Fire and forget - don't block event emission
+            this.webhookHandler
+                .sendWebhook("agent_selected", data, {
+                agentId: data.agentId
+            })
+                .catch((error) => {
+                this.logger.error("Failed to send webhook for agent:selected", error);
+            });
+        });
+        this.wsClient.on("agent:response", (response) => {
+            // Format response only if raw message is available
+            let enhancedResponse = response;
+            if (response.raw) {
+                try {
+                    const formatted = this.responseFormatter.formatTaskResponse(response.raw);
+                    enhancedResponse = {
+                        ...response,
+                        ...formatted
+                    };
+                }
+                catch (error) {
+                    this.logger.debug("Could not format response, using original", {
+                        error
+                    });
+                }
+            }
+            // Emit event (waitForEvent listeners will receive this)
+            this.emit("agent:response", enhancedResponse);
+            // Fire and forget - don't block event emission
+            this.webhookHandler
+                .sendWebhook("task_response", enhancedResponse, {
+                agentId: response.agentId,
+                taskId: response.taskId
+            })
+                .catch((error) => {
+                this.logger.error("Failed to send webhook for agent:response", error);
+            });
+        });
+        // Forward coordinator events
+        this.wsClient.on("coordinator:processing", (request) => this.emit("coordinator:processing", request));
+        this.wsClient.on("coordinator:selected", (agentId, reasoning) => this.emit("coordinator:selected", agentId, reasoning));
+        this.wsClient.on("coordinator:error", (error) => this.emit("coordinator:error", error));
+    }
+    /**
+     * Destroys the message router and cleans up resources.
+     * Removes all event listeners and marks the router as destroyed.
+     * After destruction, the router cannot be reused.
+     *
+     * Note: Any pending waitForEvent calls will automatically timeout and clean up.
+     *
+     * @example
+     * ```typescript
+     * messageRouter.destroy();
+     * console.log('Message router destroyed');
+     * ```
+     */
+    destroy() {
+        this.logger.info("MessageRouter: Destroying");
+        // Remove all event listeners
+        // Any pending waitForEvent calls will automatically timeout and clean up
+        this.removeAllListeners();
+    }
+}
+exports.MessageRouter = MessageRouter;
+//# sourceMappingURL=message-router.js.map

package/dist/managers/message-router.js.map

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

package/dist/managers/room-manager.d.ts

@@ -0,0 +1,165 @@
+/**
+ * RoomManager - Manages room state and operations
+ * Handles joining, leaving, and tracking rooms
+ */
+import { EventEmitter } from "eventemitter3";
+import { WebSocketClient } from "../core/websocket-client";
+import { Room, Logger, RoomInfo } from "../types";
+import { SDKEvents } from "../types/events";
+export declare class RoomManager extends EventEmitter<SDKEvents> {
+    private readonly wsClient;
+    private readonly logger;
+    private readonly rooms;
+    private readonly subscribedRooms;
+    constructor(wsClient: WebSocketClient, logger: Logger);
+    /**
+     * Subscribes to a public room in the Teneo network.
+     * Validates room ID and sends subscribe message to the server.
+     * The actual subscription state is updated when the server confirms via room:subscribed event.
+     *
+     * @param roomId - The ID of the room to subscribe to
+     * @returns Promise that resolves when subscribed
+     * @throws {SDKError} If not connected to the network
+     * @throws {ValidationError} If roomId is empty or invalid
+     *
+     * @example
+     * ```typescript
+     * await roomManager.subscribeToRoom('general');
+     * console.log('Subscription request sent to general room');
+     * ```
+     */
+    subscribeToRoom(roomId: string): Promise<void>;
+    /**
+     * Unsubscribes from a room in the Teneo network.
+     * Validates room ID and sends unsubscribe message to the server.
+     * The actual subscription state is updated when the server confirms via room:unsubscribed event.
+     *
+     * @param roomId - The ID of the room to unsubscribe from
+     * @returns Promise that resolves when unsubscribed
+     * @throws {SDKError} If not connected to the network
+     * @throws {ValidationError} If roomId is empty or invalid
+     *
+     * @example
+     * ```typescript
+     * await roomManager.unsubscribeFromRoom('general');
+     * console.log('Unsubscription request sent for general room');
+     * ```
+     */
+    unsubscribeFromRoom(roomId: string): Promise<void>;
+    /**
+     * Updates the subscription state from server response.
+     * This is the authoritative source of which rooms you're subscribed to.
+     * Called internally when receiving subscribe/unsubscribe responses.
+     *
+     * @internal
+     * @param subscriptions - Array of room IDs from server response
+     *
+     * @example
+     * ```typescript
+     * // Internal SDK usage
+     * roomManager.updateSubscriptions(['general', 'support', 'trading']);
+     * ```
+     */
+    updateSubscriptions(subscriptions: string[]): void;
+    /**
+     * Gets all rooms currently subscribed to.
+     * Returns array of room IDs that you're actively listening to.
+     *
+     * @returns Array of subscribed room IDs
+     *
+     * @example
+     * ```typescript
+     * const rooms = roomManager.getSubscribedRooms();
+     * console.log(`Subscribed to ${rooms.length} rooms:`, rooms);
+     * ```
+     */
+    getSubscribedRooms(): string[];
+    /**
+     * Gets a list of all available rooms.
+     * Returns rooms the user has access to based on authentication.
+     * Returns a read-only array with defensive copies to prevent external modification.
+     *
+     * @returns Read-only array of room copies
+     *
+     * @example
+     * ```typescript
+     * const rooms = roomManager.getRooms();
+     * rooms.forEach(room => console.log(`${room.id}: ${room.name}`));
+     * ```
+     */
+    getRooms(): ReadonlyArray<Readonly<Room>>;
+    /**
+     * Gets a specific room by its ID.
+     * Returns a defensive copy to prevent external modification of room state.
+     * Returns undefined if room doesn't exist or user doesn't have access.
+     *
+     * @param roomId - The ID of the room to retrieve
+     * @returns Copy of the room object if found, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * const room = roomManager.getRoom('general');
+     * if (room) {
+     *   console.log(`Room: ${room.name}`);
+     *   console.log(`Members: ${room.members?.length ?? 0}`);
+     * }
+     * ```
+     */
+    getRoom(roomId: string): Readonly<Room> | undefined;
+    /**
+     * Fetches the list of rooms from the server.
+     * Sends list_rooms message and waits for response from server.
+     * Returns array of rooms the user owns or has access to.
+     *
+     * @returns Promise that resolves to array of room information
+     * @throws {SDKError} If not connected to the network
+     *
+     * @example
+     * ```typescript
+     * const rooms = await roomManager.listRooms();
+     * rooms.forEach(room => {
+     *   console.log(`${room.name} (${room.is_public ? 'public' : 'private'})`);
+     *   console.log(`Owner: ${room.is_owner}`);
+     * });
+     * ```
+     */
+    listRooms(): Promise<RoomInfo[]>;
+    /**
+     * Updates the room list from authentication state.
+     * Called internally after successful authentication to populate accessible rooms.
+     *
+     * @internal This method is for internal SDK use
+     * @param rooms - Array of rooms to update in the manager
+     *
+     * @example
+     * ```typescript
+     * // Internal SDK usage after auth
+     * roomManager.updateRoomsFromAuth(authState.roomObjects);
+     * ```
+     */
+    updateRoomsFromAuth(rooms: Room[]): void;
+    /**
+     * Clears all rooms from the manager.
+     * Clears subscription state.
+     *
+     * @example
+     * ```typescript
+     * roomManager.clear();
+     * console.log('All rooms cleared');
+     * ```
+     */
+    clear(): void;
+    /**
+     * Destroys the room manager and cleans up resources.
+     * Clears all rooms and removes all event listeners.
+     * After destruction, the manager cannot be reused.
+     *
+     * @example
+     * ```typescript
+     * roomManager.destroy();
+     * console.log('Room manager destroyed');
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=room-manager.d.ts.map

package/dist/managers/room-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-manager.d.ts","sourceRoot":"","sources":["../../src/managers/room-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAuD,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACvG,OAAO,EAAE,SAAS,EAAY,MAAM,iBAAiB,CAAC;AAItD,qBAAa,WAAY,SAAQ,YAAY,CAAC,SAAS,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;gBAEzC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;IAMrD;;;;;;;;;;;;;;;OAeG;IACU,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D;;;;;;;;;;;;;;;OAeG;IACU,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/D;;;;;;;;;;;;;OAaG;IACI,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;IASzD;;;;;;;;;;;OAWG;IACI,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;;;;;;;;;;;OAYG;IACI,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAIhD;;;;;;;;;;;;;;;;OAgBG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS;IAK1D;;;;;;;;;;;;;;;;OAgBG;IACU,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgB7C;;;;;;;;;;;;OAYG;IACI,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAQ/C;;;;;;;;;OASG;IACI,KAAK,IAAI,IAAI;IAKpB;;;;;;;;;;OAUG;IACI,OAAO,IAAI,IAAI;CAKvB"}