crewly 1.2.1 → 1.2.4

package/dist/backend/backend/src/services/cloud/cloud-task-processor.service.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Cloud Task Processor Service
+ *
+ * Polls the cloud task queue and processes tasks using the Anthropic API.
+ * Handles text, image_analysis, and document task types.
+ *
+ * MVP implementation: direct Anthropic Messages API calls.
+ * Future: pluggable runtime backends (OpenHands, Gemini, etc.).
+ *
+ * @module services/cloud/cloud-task-processor.service
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { type CloudTask } from '../../controllers/cloud/tasks/cloud-task.types.js';
+/** Task processor configuration. */
+export declare const TASK_PROCESSOR_CONSTANTS: {
+    /** Polling interval in ms (5 seconds) */
+    readonly POLL_INTERVAL_MS: 5000;
+    /** Maximum concurrent task processing (MVP: sequential) */
+    readonly MAX_CONCURRENT: 1;
+    /** Anthropic model for task processing */
+    readonly DEFAULT_MODEL: "claude-sonnet-4-5-20250929";
+    /** Maximum tokens in AI response */
+    readonly MAX_TOKENS: 4096;
+    /** Task processing timeout in ms (5 minutes) */
+    readonly PROCESSING_TIMEOUT_MS: 300000;
+    /** Supported image MIME types for base64 encoding */
+    readonly IMAGE_MEDIA_TYPES: readonly ["image/png", "image/jpeg", "image/gif", "image/webp"];
+};
+/** Anthropic API media type union. */
+type AnthropicMediaType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+/**
+ * Processes cloud tasks by polling the queue and invoking the Anthropic API.
+ *
+ * Singleton — access via `CloudTaskProcessorService.getInstance()`.
+ */
+export declare class CloudTaskProcessorService {
+    private static instance;
+    private readonly logger;
+    private pollTimer;
+    private processing;
+    private running;
+    private constructor();
+    /** Get singleton instance. */
+    static getInstance(): CloudTaskProcessorService;
+    /** Reset singleton (for testing). */
+    static resetInstance(): void;
+    /** Whether the processor is currently running. */
+    isRunning(): boolean;
+    /** Whether a task is currently being processed. */
+    isProcessing(): boolean;
+    /**
+     * Start the task processor polling loop.
+     * Idempotent — safe to call multiple times.
+     */
+    start(): void;
+    /**
+     * Stop the task processor.
+     * Waits for current processing to finish before returning.
+     */
+    stop(): void;
+    /**
+     * Poll for the next pending task and process it.
+     * Skips if already processing a task (sequential MVP).
+     */
+    pollAndProcess(): Promise<void>;
+    /**
+     * Process a single cloud task by type.
+     *
+     * @param task - The dequeued task to process
+     */
+    processTask(task: CloudTask): Promise<void>;
+    /**
+     * Process a text-only task using the Anthropic Messages API.
+     *
+     * @param task - Text task with prompt
+     * @returns AI-generated response text
+     */
+    processTextTask(task: CloudTask): Promise<string>;
+    /**
+     * Process an image analysis task.
+     * Loads attached image files and sends them with the prompt to the AI.
+     *
+     * @param task - Image analysis task with file attachments
+     * @returns AI-generated analysis result
+     */
+    processImageTask(task: CloudTask): Promise<string>;
+    /**
+     * Process a document task.
+     * Reads document files and sends their content with the prompt.
+     *
+     * @param task - Document task with file attachments
+     * @returns AI-generated response
+     */
+    processDocumentTask(task: CloudTask): Promise<string>;
+    /**
+     * Create an Anthropic API client.
+     *
+     * @returns Configured Anthropic client
+     * @throws Error if ANTHROPIC_API_KEY is not set
+     */
+    createClient(): Anthropic;
+    /**
+     * Extract text content from an Anthropic message response.
+     *
+     * @param message - Anthropic API message response
+     * @returns Concatenated text from all text content blocks
+     */
+    extractTextFromResponse(message: Anthropic.Message): string;
+    /**
+     * Map a file extension to an Anthropic-compatible media type.
+     *
+     * @param ext - File extension (without dot)
+     * @returns Media type string or null if unsupported
+     */
+    extensionToMediaType(ext: string): AnthropicMediaType | null;
+}
+export {};
+//# sourceMappingURL=cloud-task-processor.service.d.ts.map

package/dist/backend/backend/src/services/cloud/cloud-task-processor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-task-processor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-task-processor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAM1C,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,mDAAmD,CAAC;AAMrG,oCAAoC;AACpC,eAAO,MAAM,wBAAwB;IACpC,yCAAyC;;IAEzC,2DAA2D;;IAE3D,0CAA0C;;IAE1C,oCAAoC;;IAEpC,gDAAgD;;IAEhD,qDAAqD;;CAE5C,CAAC;AAEX,sCAAsC;AACtC,KAAK,kBAAkB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAMlF;;;;GAIG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IAEjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAIP,8BAA8B;IAC9B,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C,qCAAqC;IACrC,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,kDAAkD;IAClD,SAAS,IAAI,OAAO;IAIpB,mDAAmD;IACnD,YAAY,IAAI,OAAO;IAQvB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgBb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAeZ;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrC;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCjD;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBvD;;;;;;OAMG;IACG,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAoDxD;;;;;;OAMG;IACG,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAqC3D;;;;;OAKG;IACH,YAAY,IAAI,SAAS;IAQzB;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM;IAO3D;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;CAU5D"}

package/dist/backend/backend/src/services/cloud/cloud-task-processor.service.js

@@ -0,0 +1,322 @@
+/**
+ * Cloud Task Processor Service
+ *
+ * Polls the cloud task queue and processes tasks using the Anthropic API.
+ * Handles text, image_analysis, and document task types.
+ *
+ * MVP implementation: direct Anthropic Messages API calls.
+ * Future: pluggable runtime backends (OpenHands, Gemini, etc.).
+ *
+ * @module services/cloud/cloud-task-processor.service
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { LoggerService } from '../core/logger.service.js';
+import { CloudTaskService } from './cloud-task.service.js';
+import { CloudFileService } from './cloud-file.service.js';
+import { CloudImageAnalysisService } from './cloud-image-analysis.service.js';
+import { CLOUD_TASK_TYPES } from '../../controllers/cloud/tasks/cloud-task.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Task processor configuration. */
+export const TASK_PROCESSOR_CONSTANTS = {
+    /** Polling interval in ms (5 seconds) */
+    POLL_INTERVAL_MS: 5_000,
+    /** Maximum concurrent task processing (MVP: sequential) */
+    MAX_CONCURRENT: 1,
+    /** Anthropic model for task processing */
+    DEFAULT_MODEL: 'claude-sonnet-4-5-20250929',
+    /** Maximum tokens in AI response */
+    MAX_TOKENS: 4096,
+    /** Task processing timeout in ms (5 minutes) */
+    PROCESSING_TIMEOUT_MS: 300_000,
+    /** Supported image MIME types for base64 encoding */
+    IMAGE_MEDIA_TYPES: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
+};
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Processes cloud tasks by polling the queue and invoking the Anthropic API.
+ *
+ * Singleton — access via `CloudTaskProcessorService.getInstance()`.
+ */
+export class CloudTaskProcessorService {
+    static instance = null;
+    logger;
+    pollTimer = null;
+    processing = false;
+    running = false;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('CloudTaskProcessor');
+    }
+    /** Get singleton instance. */
+    static getInstance() {
+        if (!CloudTaskProcessorService.instance) {
+            CloudTaskProcessorService.instance = new CloudTaskProcessorService();
+        }
+        return CloudTaskProcessorService.instance;
+    }
+    /** Reset singleton (for testing). */
+    static resetInstance() {
+        CloudTaskProcessorService.instance = null;
+    }
+    /** Whether the processor is currently running. */
+    isRunning() {
+        return this.running;
+    }
+    /** Whether a task is currently being processed. */
+    isProcessing() {
+        return this.processing;
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    /**
+     * Start the task processor polling loop.
+     * Idempotent — safe to call multiple times.
+     */
+    start() {
+        if (this.running)
+            return;
+        if (!process.env.ANTHROPIC_API_KEY) {
+            this.logger.warn('ANTHROPIC_API_KEY not set — task processor disabled');
+            return;
+        }
+        this.running = true;
+        this.pollTimer = setInterval(() => this.pollAndProcess(), TASK_PROCESSOR_CONSTANTS.POLL_INTERVAL_MS);
+        this.logger.info('Task processor started', {
+            pollIntervalMs: TASK_PROCESSOR_CONSTANTS.POLL_INTERVAL_MS,
+            model: TASK_PROCESSOR_CONSTANTS.DEFAULT_MODEL,
+        });
+    }
+    /**
+     * Stop the task processor.
+     * Waits for current processing to finish before returning.
+     */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.logger.info('Task processor stopped');
+    }
+    // -----------------------------------------------------------------------
+    // Core Processing Loop
+    // -----------------------------------------------------------------------
+    /**
+     * Poll for the next pending task and process it.
+     * Skips if already processing a task (sequential MVP).
+     */
+    async pollAndProcess() {
+        if (this.processing || !this.running)
+            return;
+        try {
+            const taskService = CloudTaskService.getInstance();
+            const task = await taskService.dequeueNext();
+            if (!task)
+                return;
+            this.processing = true;
+            this.logger.info('Processing task', { taskId: task.id, type: task.type });
+            await this.processTask(task);
+        }
+        catch (err) {
+            this.logger.error('Poll cycle error', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /**
+     * Process a single cloud task by type.
+     *
+     * @param task - The dequeued task to process
+     */
+    async processTask(task) {
+        const taskService = CloudTaskService.getInstance();
+        const startTime = Date.now();
+        try {
+            let result;
+            switch (task.type) {
+                case CLOUD_TASK_TYPES.TEXT:
+                    result = await this.processTextTask(task);
+                    break;
+                case CLOUD_TASK_TYPES.IMAGE_ANALYSIS:
+                    result = await this.processImageTask(task);
+                    break;
+                case CLOUD_TASK_TYPES.DOCUMENT:
+                    result = await this.processDocumentTask(task);
+                    break;
+                default:
+                    throw new Error(`Unknown task type: ${task.type}`);
+            }
+            await taskService.completeTask(task.id, result);
+            const durationMs = Date.now() - startTime;
+            this.logger.info('Task completed', { taskId: task.id, type: task.type, durationMs });
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            await taskService.failTask(task.id, errorMsg);
+            this.logger.error('Task processing failed', { taskId: task.id, error: errorMsg });
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Task Type Handlers
+    // -----------------------------------------------------------------------
+    /**
+     * Process a text-only task using the Anthropic Messages API.
+     *
+     * @param task - Text task with prompt
+     * @returns AI-generated response text
+     */
+    async processTextTask(task) {
+        const client = this.createClient();
+        const message = await client.messages.create({
+            model: TASK_PROCESSOR_CONSTANTS.DEFAULT_MODEL,
+            max_tokens: TASK_PROCESSOR_CONSTANTS.MAX_TOKENS,
+            messages: [
+                {
+                    role: 'user',
+                    content: task.prompt,
+                },
+            ],
+        });
+        return this.extractTextFromResponse(message);
+    }
+    /**
+     * Process an image analysis task.
+     * Loads attached image files and sends them with the prompt to the AI.
+     *
+     * @param task - Image analysis task with file attachments
+     * @returns AI-generated analysis result
+     */
+    async processImageTask(task) {
+        const client = this.createClient();
+        const fileService = CloudFileService.getInstance();
+        const imageAnalysisService = CloudImageAnalysisService.getInstance();
+        const contentBlocks = [];
+        // Load and attach image files
+        for (const fileKey of task.files) {
+            const buffer = await fileService.readFile(fileKey);
+            if (!buffer) {
+                this.logger.warn('Image file not found, skipping', { fileKey, taskId: task.id });
+                continue;
+            }
+            const ext = fileKey.split('.').pop()?.toLowerCase() ?? '';
+            const mediaType = this.extensionToMediaType(ext);
+            if (!mediaType) {
+                this.logger.warn('Unsupported image extension, skipping', { ext, fileKey });
+                continue;
+            }
+            const imageBlock = {
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    media_type: mediaType,
+                    data: buffer.toString('base64'),
+                },
+            };
+            contentBlocks.push(imageBlock);
+        }
+        // Build analysis prompt (WeChat-aware)
+        const isWeChat = imageAnalysisService.isLikelyWeChatScreenshot(task.prompt);
+        const analysisPrompt = imageAnalysisService.buildAnalysisPrompt(task.prompt, isWeChat);
+        contentBlocks.push({ type: 'text', text: analysisPrompt });
+        const message = await client.messages.create({
+            model: TASK_PROCESSOR_CONSTANTS.DEFAULT_MODEL,
+            max_tokens: TASK_PROCESSOR_CONSTANTS.MAX_TOKENS,
+            messages: [
+                {
+                    role: 'user',
+                    content: contentBlocks,
+                },
+            ],
+        });
+        return this.extractTextFromResponse(message);
+    }
+    /**
+     * Process a document task.
+     * Reads document files and sends their content with the prompt.
+     *
+     * @param task - Document task with file attachments
+     * @returns AI-generated response
+     */
+    async processDocumentTask(task) {
+        const client = this.createClient();
+        const fileService = CloudFileService.getInstance();
+        // Read document files and include their content
+        const documentContents = [];
+        for (const fileKey of task.files) {
+            const buffer = await fileService.readFile(fileKey);
+            if (!buffer) {
+                this.logger.warn('Document file not found, skipping', { fileKey, taskId: task.id });
+                continue;
+            }
+            documentContents.push(`--- File: ${fileKey} ---\n${buffer.toString('utf-8')}`);
+        }
+        const fullPrompt = documentContents.length > 0
+            ? `${task.prompt}\n\n${documentContents.join('\n\n')}`
+            : task.prompt;
+        const message = await client.messages.create({
+            model: TASK_PROCESSOR_CONSTANTS.DEFAULT_MODEL,
+            max_tokens: TASK_PROCESSOR_CONSTANTS.MAX_TOKENS,
+            messages: [
+                {
+                    role: 'user',
+                    content: fullPrompt,
+                },
+            ],
+        });
+        return this.extractTextFromResponse(message);
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Create an Anthropic API client.
+     *
+     * @returns Configured Anthropic client
+     * @throws Error if ANTHROPIC_API_KEY is not set
+     */
+    createClient() {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            throw new Error('ANTHROPIC_API_KEY environment variable is required');
+        }
+        return new Anthropic({ apiKey });
+    }
+    /**
+     * Extract text content from an Anthropic message response.
+     *
+     * @param message - Anthropic API message response
+     * @returns Concatenated text from all text content blocks
+     */
+    extractTextFromResponse(message) {
+        return message.content
+            .filter((block) => block.type === 'text')
+            .map((block) => block.text)
+            .join('\n');
+    }
+    /**
+     * Map a file extension to an Anthropic-compatible media type.
+     *
+     * @param ext - File extension (without dot)
+     * @returns Media type string or null if unsupported
+     */
+    extensionToMediaType(ext) {
+        const mapping = {
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            gif: 'image/gif',
+            webp: 'image/webp',
+        };
+        return mapping[ext] ?? null;
+    }
+}
+//# sourceMappingURL=cloud-task-processor.service.js.map

package/dist/backend/backend/src/services/cloud/cloud-task-processor.service.js.map

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

package/dist/backend/backend/src/services/cloud/cloud-task.service.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Cloud Task Service
+ *
+ * Manages the lifecycle of cloud tasks submitted by customers:
+ * creation, queuing, processing via AI runtime, and result storage.
+ *
+ * MVP implementation uses an in-memory queue with file-based persistence.
+ * Future: migrate to Redis/BullMQ for production scale.
+ *
+ * @module services/cloud/cloud-task.service
+ */
+import { type CloudTask, type CloudTaskStatus, type CloudTaskType } from '../../controllers/cloud/tasks/cloud-task.types.js';
+/** Cloud task service configuration. */
+export declare const CLOUD_TASK_CONSTANTS: {
+    /** Storage directory under ~/.crewly/ */
+    readonly STORAGE_DIR: "cloud/tasks";
+    /** Task data file */
+    readonly TASKS_FILE: "tasks.json";
+    /** Maximum tasks returned per list query */
+    readonly DEFAULT_PAGE_SIZE: 20;
+    /** Maximum allowed page size */
+    readonly MAX_PAGE_SIZE: 100;
+    /** Maximum pending tasks per user (cost control) */
+    readonly MAX_PENDING_PER_USER: 50;
+    /** Task processing timeout (ms) — 5 minutes */
+    readonly PROCESSING_TIMEOUT_MS: 300000;
+};
+/**
+ * Manages cloud task CRUD, queuing, and processing.
+ *
+ * Singleton — access via `CloudTaskService.getInstance()`.
+ */
+export declare class CloudTaskService {
+    private static instance;
+    private readonly logger;
+    private readonly storageDir;
+    private readonly tasksFilePath;
+    private tasks;
+    private initialized;
+    private constructor();
+    /** Get singleton instance. */
+    static getInstance(): CloudTaskService;
+    /** Reset singleton (for testing). */
+    static resetInstance(): void;
+    /**
+     * Initialize the service — load persisted tasks from disk.
+     * Idempotent: safe to call multiple times.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create a new cloud task.
+     *
+     * @param userId - Authenticated user ID
+     * @param type - Task type (text, image_analysis, document)
+     * @param prompt - User instruction / prompt
+     * @param files - Attached file keys (DO Spaces object keys)
+     * @returns The created task
+     * @throws Error if user exceeds pending task limit
+     */
+    createTask(userId: string, type: CloudTaskType, prompt: string, files?: string[]): Promise<CloudTask>;
+    /**
+     * Get a single task by ID, scoped to the requesting user.
+     *
+     * @param taskId - Task UUID
+     * @param userId - Authenticated user ID (ownership check)
+     * @returns The task or null if not found / not owned
+     */
+    getTask(taskId: string, userId: string): Promise<CloudTask | null>;
+    /**
+     * List tasks for a user, with optional status filter and pagination.
+     *
+     * @param userId - Authenticated user ID
+     * @param options - Filter and pagination options
+     * @returns Paginated task list with total count
+     */
+    listTasks(userId: string, options?: {
+        status?: CloudTaskStatus;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        tasks: CloudTask[];
+        total: number;
+    }>;
+    /**
+     * Dequeue the next pending task for processing.
+     *
+     * @returns The oldest pending task, or null if queue is empty
+     */
+    dequeueNext(): Promise<CloudTask | null>;
+    /**
+     * Mark a task as completed with a result.
+     *
+     * @param taskId - Task UUID
+     * @param result - AI-generated result content
+     */
+    completeTask(taskId: string, result: string): Promise<void>;
+    /**
+     * Mark a task as failed with an error message.
+     *
+     * @param taskId - Task UUID
+     * @param error - Error description
+     */
+    failTask(taskId: string, error: string): Promise<void>;
+    /**
+     * Get queue statistics.
+     *
+     * @returns Counts by status
+     */
+    getQueueStats(): Promise<Record<CloudTaskStatus, number>>;
+    /** Count pending tasks for a specific user. */
+    private countUserPendingTasks;
+    /** Persist tasks to disk. */
+    private persist;
+}
+//# sourceMappingURL=cloud-task.service.d.ts.map

package/dist/backend/backend/src/services/cloud/cloud-task.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-task.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-task.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAGN,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,mDAAmD,CAAC;AAM3D,wCAAwC;AACxC,eAAO,MAAM,oBAAoB;IAChC,yCAAyC;;IAEzC,qBAAqB;;IAErB,4CAA4C;;IAE5C,gCAAgC;;IAEhC,oDAAoD;;IAEpD,+CAA+C;;CAEtC,CAAC;AAMX;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAMP,8BAA8B;IAC9B,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,qCAAqC;IACrC,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;;;;;;;;OASG;IACG,UAAU,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAM,EAAO,GAClB,OAAO,CAAC,SAAS,CAAC;IAiCrB;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAOxE;;;;;;OAMG;IACG,SAAS,CACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GACzE,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BjD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAkB9C;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjE;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAqB/D,+CAA+C;IAC/C,OAAO,CAAC,qBAAqB;IAU7B,6BAA6B;YACf,OAAO;CAQrB"}