crewly 1.4.2 → 1.4.4

package/dist/backend/backend/src/services/telegram/telegram-initializer.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Telegram Initializer
+ *
+ * Handles automatic Telegram connection on application startup.
+ * Checks for environment variables or saved credentials and initializes
+ * the TelegramService + bridge if configured.
+ *
+ * @module services/telegram/telegram-initializer
+ */
+import { TelegramConfig } from './telegram-credentials.service.js';
+import type { MessageQueueService } from '../messaging/message-queue.service.js';
+/**
+ * Result of initialization attempt.
+ */
+export interface TelegramInitResult {
+    /** Whether initialization was attempted */
+    attempted: boolean;
+    /** Whether initialization succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Check if Telegram is configured via environment variables.
+ *
+ * @returns True if TELEGRAM_BOT_TOKEN is set
+ */
+export declare function isTelegramConfigured(): boolean;
+/**
+ * Get Telegram configuration from environment variables.
+ *
+ * @returns TelegramConfig object or null if not configured
+ */
+export declare function getTelegramConfigFromEnv(): TelegramConfig | null;
+/**
+ * Get Telegram configuration from environment variables or saved credentials.
+ * Environment variables take priority over saved credentials.
+ *
+ * @returns TelegramConfig object or null if not configured
+ */
+export declare function getTelegramConfig(): Promise<TelegramConfig | null>;
+/**
+ * Options for Telegram initialization.
+ */
+export interface TelegramInitOptions {
+    /** Optional MessageQueueService for enqueuing messages to orchestrator */
+    messageQueueService?: MessageQueueService;
+}
+/**
+ * Initialize Telegram integration if configured via environment variables
+ * or saved credentials.
+ *
+ * This function is designed to be called during application startup.
+ * It safely handles cases where Telegram is not configured.
+ *
+ * @param options - Optional initialization options
+ * @returns Result object indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = await initializeTelegramIfConfigured({
+ *   messageQueueService: myQueueService,
+ * });
+ * if (result.success) {
+ *   console.log('Telegram connected!');
+ * }
+ * ```
+ */
+export declare function initializeTelegramIfConfigured(options?: TelegramInitOptions): Promise<TelegramInitResult>;
+/**
+ * Gracefully shutdown Telegram integration.
+ *
+ * Call this during application shutdown to disconnect cleanly.
+ */
+export declare function shutdownTelegram(): Promise<void>;
+//# sourceMappingURL=telegram-initializer.d.ts.map

package/dist/backend/backend/src/services/telegram/telegram-initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-initializer.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/telegram/telegram-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAA2B,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,GAAG,IAAI,CAYhE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAqBxE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,8BAA8B,CACnD,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAYtD"}

package/dist/backend/backend/src/services/telegram/telegram-initializer.js

@@ -0,0 +1,131 @@
+/**
+ * Telegram Initializer
+ *
+ * Handles automatic Telegram connection on application startup.
+ * Checks for environment variables or saved credentials and initializes
+ * the TelegramService + bridge if configured.
+ *
+ * @module services/telegram/telegram-initializer
+ */
+import { getTelegramService } from './telegram.service.js';
+import { getTelegramOrchestratorBridge } from './telegram-orchestrator-bridge.js';
+import { loadTelegramCredentials } from './telegram-credentials.service.js';
+import { LoggerService } from '../core/logger.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('TelegramInitializer');
+/**
+ * Check if Telegram is configured via environment variables.
+ *
+ * @returns True if TELEGRAM_BOT_TOKEN is set
+ */
+export function isTelegramConfigured() {
+    return !!process.env.TELEGRAM_BOT_TOKEN;
+}
+/**
+ * Get Telegram configuration from environment variables.
+ *
+ * @returns TelegramConfig object or null if not configured
+ */
+export function getTelegramConfigFromEnv() {
+    const botToken = process.env.TELEGRAM_BOT_TOKEN;
+    if (!botToken) {
+        return null;
+    }
+    return {
+        botToken,
+        defaultChatId: process.env.TELEGRAM_DEFAULT_CHAT_ID,
+        allowedUserIds: process.env.TELEGRAM_ALLOWED_USERS?.split(',').filter(Boolean),
+    };
+}
+/**
+ * Get Telegram configuration from environment variables or saved credentials.
+ * Environment variables take priority over saved credentials.
+ *
+ * @returns TelegramConfig object or null if not configured
+ */
+export async function getTelegramConfig() {
+    // Env vars take priority
+    const envConfig = getTelegramConfigFromEnv();
+    if (envConfig) {
+        return envConfig;
+    }
+    // Fall back to saved credentials
+    try {
+        const savedConfig = await loadTelegramCredentials();
+        if (savedConfig) {
+            logger.info('Loaded Telegram credentials from saved config');
+            return savedConfig;
+        }
+    }
+    catch (error) {
+        logger.warn('Failed to load saved Telegram credentials', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    return null;
+}
+/**
+ * Initialize Telegram integration if configured via environment variables
+ * or saved credentials.
+ *
+ * This function is designed to be called during application startup.
+ * It safely handles cases where Telegram is not configured.
+ *
+ * @param options - Optional initialization options
+ * @returns Result object indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = await initializeTelegramIfConfigured({
+ *   messageQueueService: myQueueService,
+ * });
+ * if (result.success) {
+ *   console.log('Telegram connected!');
+ * }
+ * ```
+ */
+export async function initializeTelegramIfConfigured(options) {
+    const config = await getTelegramConfig();
+    if (!config) {
+        logger.info('Not configured — skipping initialization');
+        return { attempted: false, success: false };
+    }
+    try {
+        const telegramService = getTelegramService();
+        await telegramService.initialize(config);
+        const bridge = getTelegramOrchestratorBridge();
+        // Set the message queue service if provided
+        if (options?.messageQueueService) {
+            bridge.setMessageQueueService(options.messageQueueService);
+        }
+        await bridge.initialize();
+        // Start polling for incoming messages
+        telegramService.startPolling();
+        logger.info('Successfully connected and polling started');
+        return { attempted: true, success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to initialize', { error: errorMessage });
+        return { attempted: true, success: false, error: errorMessage };
+    }
+}
+/**
+ * Gracefully shutdown Telegram integration.
+ *
+ * Call this during application shutdown to disconnect cleanly.
+ */
+export async function shutdownTelegram() {
+    try {
+        const telegramService = getTelegramService();
+        if (telegramService.isConnected()) {
+            await telegramService.disconnect();
+            logger.info('Disconnected');
+        }
+    }
+    catch (error) {
+        logger.error('Error during shutdown', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=telegram-initializer.js.map

package/dist/backend/backend/src/services/telegram/telegram-initializer.js.map

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

package/dist/backend/backend/src/services/telegram/telegram-orchestrator-bridge.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Telegram-Orchestrator Bridge
+ *
+ * Routes messages between Telegram and the Crewly orchestrator,
+ * enabling mobile control of AI teams via Telegram bot.
+ *
+ * Flow:
+ * 1. TelegramService emits 'message' event for each incoming text
+ * 2. This bridge enqueues the message to MessageQueueService
+ * 3. QueueProcessor delivers it to the orchestrator
+ * 4. ResponseRouter calls the telegramResolve callback
+ * 5. Bridge sends the response back to the Telegram chat
+ *
+ * @module services/telegram/telegram-orchestrator-bridge
+ */
+import type { MessageQueueService } from '../messaging/message-queue.service.js';
+/**
+ * TelegramOrchestratorBridge routes incoming Telegram messages to the
+ * orchestrator via the message queue, and sends responses back.
+ *
+ * @example
+ * ```typescript
+ * const bridge = getTelegramOrchestratorBridge();
+ * bridge.setMessageQueueService(queueService);
+ * await bridge.initialize();
+ * ```
+ */
+export declare class TelegramOrchestratorBridge {
+    private logger;
+    private telegramService;
+    private messageQueueService;
+    private threadStore;
+    private initialized;
+    constructor();
+    /**
+     * Set the MessageQueueService for enqueuing incoming messages.
+     *
+     * @param service - The MessageQueueService instance
+     */
+    setMessageQueueService(service: MessageQueueService): void;
+    /**
+     * Initialize the bridge by subscribing to TelegramService events.
+     * Must be called after TelegramService.initialize() and startPolling().
+     */
+    initialize(): Promise<void>;
+    /**
+     * Handle an incoming Telegram message by enqueuing it for the orchestrator.
+     *
+     * @param msg - The incoming Telegram message
+     */
+    private handleIncomingMessage;
+    /**
+     * Enqueue a Telegram message into the message queue with a resolve callback.
+     *
+     * @param msg - The incoming message to enqueue
+     */
+    private enqueueMessage;
+    /**
+     * Clean up the bridge by removing event listeners.
+     */
+    destroy(): void;
+}
+/**
+ * Get the TelegramOrchestratorBridge singleton.
+ *
+ * @returns The bridge instance
+ */
+export declare function getTelegramOrchestratorBridge(): TelegramOrchestratorBridge;
+/**
+ * Reset the TelegramOrchestratorBridge singleton (for testing).
+ */
+export declare function resetTelegramOrchestratorBridge(): void;
+//# sourceMappingURL=telegram-orchestrator-bridge.d.ts.map

package/dist/backend/backend/src/services/telegram/telegram-orchestrator-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-orchestrator-bridge.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/telegram/telegram-orchestrator-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF;;;;;;;;;;GAUG;AACH,qBAAa,0BAA0B;IACtC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAAS;;IAS5B;;;;OAIG;IACH,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC;;;;OAIG;YACW,qBAAqB;IA4BnC;;;;OAIG;YACW,cAAc;IAsD5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAKf;AAKD;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,0BAA0B,CAK1E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}

package/dist/backend/backend/src/services/telegram/telegram-orchestrator-bridge.js

@@ -0,0 +1,172 @@
+/**
+ * Telegram-Orchestrator Bridge
+ *
+ * Routes messages between Telegram and the Crewly orchestrator,
+ * enabling mobile control of AI teams via Telegram bot.
+ *
+ * Flow:
+ * 1. TelegramService emits 'message' event for each incoming text
+ * 2. This bridge enqueues the message to MessageQueueService
+ * 3. QueueProcessor delivers it to the orchestrator
+ * 4. ResponseRouter calls the telegramResolve callback
+ * 5. Bridge sends the response back to the Telegram chat
+ *
+ * @module services/telegram/telegram-orchestrator-bridge
+ */
+import { getTelegramService } from './telegram.service.js';
+import { setTelegramThreadStore, TelegramThreadStoreService, } from './telegram-thread-store.service.js';
+import { isOrchestratorActive, getOrchestratorOfflineMessage } from '../orchestrator/index.js';
+import { TELEGRAM_CONSTANTS, MESSAGE_QUEUE_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { formatError } from '../../utils/format-error.js';
+/**
+ * TelegramOrchestratorBridge routes incoming Telegram messages to the
+ * orchestrator via the message queue, and sends responses back.
+ *
+ * @example
+ * ```typescript
+ * const bridge = getTelegramOrchestratorBridge();
+ * bridge.setMessageQueueService(queueService);
+ * await bridge.initialize();
+ * ```
+ */
+export class TelegramOrchestratorBridge {
+    logger;
+    telegramService;
+    messageQueueService = null;
+    threadStore;
+    initialized = false;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('TelegramBridge');
+        this.telegramService = getTelegramService();
+        this.threadStore = new TelegramThreadStoreService();
+        setTelegramThreadStore(this.threadStore);
+    }
+    /**
+     * Set the MessageQueueService for enqueuing incoming messages.
+     *
+     * @param service - The MessageQueueService instance
+     */
+    setMessageQueueService(service) {
+        this.messageQueueService = service;
+    }
+    /**
+     * Initialize the bridge by subscribing to TelegramService events.
+     * Must be called after TelegramService.initialize() and startPolling().
+     */
+    async initialize() {
+        if (this.initialized) {
+            this.logger.warn('Bridge already initialized');
+            return;
+        }
+        this.telegramService.on('message', (msg) => {
+            this.handleIncomingMessage(msg).catch((error) => {
+                this.logger.error('Failed to handle incoming message', {
+                    error: formatError(error),
+                    chatId: msg.chatId,
+                });
+            });
+        });
+        this.initialized = true;
+        this.logger.info('Bridge initialized');
+    }
+    /**
+     * Handle an incoming Telegram message by enqueuing it for the orchestrator.
+     *
+     * @param msg - The incoming Telegram message
+     */
+    async handleIncomingMessage(msg) {
+        // Store the message in the thread file
+        await this.threadStore.appendUserMessage(msg.chatId, msg.userName, msg.text);
+        // Check if orchestrator is active
+        if (!(await isOrchestratorActive())) {
+            const offlineMsg = getOrchestratorOfflineMessage();
+            await this.telegramService.sendMessage(msg.chatId, offlineMsg, msg.messageId);
+            return;
+        }
+        // Enqueue via MessageQueueService if available
+        if (this.messageQueueService) {
+            await this.enqueueMessage(msg);
+        }
+        else {
+            this.logger.warn('No MessageQueueService — cannot deliver message to orchestrator');
+            await this.telegramService.sendMessage(msg.chatId, 'Message queue is not available. Please try again later.', msg.messageId);
+        }
+    }
+    /**
+     * Enqueue a Telegram message into the message queue with a resolve callback.
+     *
+     * @param msg - The incoming message to enqueue
+     */
+    async enqueueMessage(msg) {
+        if (!this.messageQueueService)
+            return;
+        // Create a promise that will be resolved by the ResponseRouter
+        const responsePromise = new Promise((resolve) => {
+            const conversationId = `${TELEGRAM_CONSTANTS.CHAT_PREFIX}-${msg.chatId}`;
+            this.messageQueueService.enqueue({
+                content: msg.text,
+                conversationId,
+                source: 'telegram',
+                sourceMetadata: {
+                    chatId: msg.chatId,
+                    messageId: msg.messageId,
+                    userId: msg.userId,
+                    userName: msg.userName,
+                    telegramResolve: resolve,
+                },
+            });
+        });
+        // Wait for response and send it back to Telegram
+        try {
+            const response = await Promise.race([
+                responsePromise,
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Response timeout')), MESSAGE_QUEUE_CONSTANTS.DEFAULT_MESSAGE_TIMEOUT)),
+            ]);
+            // Store the bot reply
+            await this.threadStore.appendBotReply(msg.chatId, response);
+            // Send reply back to Telegram
+            await this.telegramService.sendMessage(msg.chatId, response, msg.messageId);
+        }
+        catch (error) {
+            this.logger.error('Failed to deliver response to Telegram', {
+                error: formatError(error),
+                chatId: msg.chatId,
+            });
+            await this.telegramService.sendMessage(msg.chatId, 'Sorry, something went wrong processing your message. Please try again.', msg.messageId).catch(() => {
+                // Swallow send failure for error message
+            });
+        }
+    }
+    /**
+     * Clean up the bridge by removing event listeners.
+     */
+    destroy() {
+        this.telegramService.removeAllListeners('message');
+        this.initialized = false;
+        this.logger.info('Bridge destroyed');
+    }
+}
+/** Singleton instance */
+let instance = null;
+/**
+ * Get the TelegramOrchestratorBridge singleton.
+ *
+ * @returns The bridge instance
+ */
+export function getTelegramOrchestratorBridge() {
+    if (!instance) {
+        instance = new TelegramOrchestratorBridge();
+    }
+    return instance;
+}
+/**
+ * Reset the TelegramOrchestratorBridge singleton (for testing).
+ */
+export function resetTelegramOrchestratorBridge() {
+    if (instance) {
+        instance.destroy();
+    }
+    instance = null;
+}
+//# sourceMappingURL=telegram-orchestrator-bridge.js.map

package/dist/backend/backend/src/services/telegram/telegram-orchestrator-bridge.js.map

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

package/dist/backend/backend/src/services/telegram/telegram-thread-store.service.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Telegram Thread Store Service
+ *
+ * Persists Telegram chat conversations as markdown files so the
+ * orchestrator can read conversation history after restart.
+ *
+ * Storage layout:
+ *   ~/.crewly/telegram-threads/
+ *     {chatId}.md          — Chat conversation file
+ *
+ * @module services/telegram/telegram-thread-store
+ */
+/**
+ * TelegramThreadStoreService manages persistent storage of Telegram
+ * chat conversations as markdown files.
+ *
+ * @example
+ * ```typescript
+ * const store = new TelegramThreadStoreService();
+ * await store.appendUserMessage('12345', 'Alice', 'Hello bot!');
+ * await store.appendBotReply('12345', 'Hello Alice!');
+ * ```
+ */
+export declare class TelegramThreadStoreService {
+    private baseDir;
+    /**
+     * Create a new TelegramThreadStoreService.
+     *
+     * @param crewlyHome - Base crewly home directory (defaults to ~/.crewly)
+     */
+    constructor(crewlyHome?: string);
+    /**
+     * Compute the file path for a chat conversation file.
+     *
+     * @param chatId - Telegram chat ID
+     * @returns Absolute path to the chat markdown file
+     */
+    getChatFilePath(chatId: string): string;
+    /**
+     * Ensure the chat file exists, creating it with frontmatter if needed.
+     *
+     * @param chatId - Telegram chat ID
+     * @param userName - Name of the user who started the conversation
+     * @returns Absolute path to the chat file
+     */
+    ensureChatFile(chatId: string, userName: string): Promise<string>;
+    /**
+     * Append a user message to the chat conversation file.
+     *
+     * @param chatId - Telegram chat ID
+     * @param userName - Display name of the sender
+     * @param message - Message content
+     */
+    appendUserMessage(chatId: string, userName: string, message: string): Promise<void>;
+    /**
+     * Append a bot reply to the chat conversation file.
+     *
+     * @param chatId - Telegram chat ID
+     * @param message - Bot response content
+     */
+    appendBotReply(chatId: string, message: string): Promise<void>;
+    /**
+     * Read the latest conversation thread file path for a given chat.
+     *
+     * @param chatId - Telegram chat ID
+     * @returns Path to the thread file, or null if not found
+     */
+    getLatestThreadPath(chatId: string): Promise<string | null>;
+}
+/**
+ * Get the TelegramThreadStoreService singleton.
+ *
+ * @returns The service instance or null if not initialized
+ */
+export declare function getTelegramThreadStore(): TelegramThreadStoreService | null;
+/**
+ * Set the TelegramThreadStoreService singleton.
+ *
+ * @param store - The service instance to set
+ */
+export declare function setTelegramThreadStore(store: TelegramThreadStoreService): void;
+/**
+ * Reset the TelegramThreadStoreService singleton (for testing).
+ */
+export declare function resetTelegramThreadStore(): void;
+//# sourceMappingURL=telegram-thread-store.service.d.ts.map

package/dist/backend/backend/src/services/telegram/telegram-thread-store.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-thread-store.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/telegram/telegram-thread-store.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH;;;;;;;;;;GAUG;AACH,qBAAa,0BAA0B;IACtC,OAAO,CAAC,OAAO,CAAS;IAExB;;;;OAIG;gBACS,UAAU,CAAC,EAAE,MAAM;IAK/B;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMvC;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BvE;;;;;;OAMG;IACG,iBAAiB,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepE;;;;;OAKG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CASjE;AAKD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,0BAA0B,GAAG,IAAI,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAE9E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}