claude-chrome-parallel 2.2.2 → 3.0.0

package/dist/orchestration/workflow-engine.js

@@ -0,0 +1,326 @@
+"use strict";
+/**
+ * Workflow Engine - Executes parallel browser workflows
+ * Manages worker lifecycle and result aggregation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowEngine = void 0;
+exports.getWorkflowEngine = getWorkflowEngine;
+const session_manager_1 = require("../session-manager");
+const state_manager_1 = require("./state-manager");
+class WorkflowEngine {
+    sessionManager = (0, session_manager_1.getSessionManager)();
+    stateManager = (0, state_manager_1.getOrchestrationStateManager)();
+    /**
+     * Initialize a new workflow
+     * Creates workers, tabs, and scratchpads
+     */
+    async initWorkflow(sessionId, workflow) {
+        const orchestrationId = `orch-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const workers = [];
+        // Create workers and tabs for each step
+        for (const step of workflow.steps) {
+            // Create isolated worker
+            const worker = await this.sessionManager.createWorker(sessionId, {
+                id: step.workerId,
+                name: step.workerName,
+            });
+            // Create tab in worker context
+            const { targetId } = await this.sessionManager.createTarget(sessionId, step.url, worker.id);
+            workers.push({
+                workerId: worker.id,
+                workerName: step.workerName,
+                tabId: targetId,
+                task: step.task,
+            });
+        }
+        // Initialize orchestration state
+        await this.stateManager.initOrchestration(orchestrationId, workflow.name, workers);
+        console.error(`[WorkflowEngine] Initialized workflow ${orchestrationId} with ${workers.length} workers`);
+        return {
+            orchestrationId,
+            workers: workers.map(w => ({
+                workerId: w.workerId,
+                workerName: w.workerName,
+                tabId: w.tabId,
+            })),
+        };
+    }
+    /**
+     * Update worker progress
+     */
+    async updateWorkerProgress(workerName, update) {
+        if (update.status || update.iteration !== undefined || update.extractedData !== undefined) {
+            await this.stateManager.updateWorkerState(workerName, {
+                status: update.status,
+                iteration: update.iteration,
+                extractedData: update.extractedData,
+            });
+        }
+        if (update.action && update.result) {
+            await this.stateManager.addProgressEntry(workerName, update.action, update.result, update.error);
+        }
+    }
+    /**
+     * Mark worker as complete
+     * Note: This method prevents double-counting by checking the previous worker status
+     */
+    async completeWorker(workerName, status, resultSummary, extractedData) {
+        await this.stateManager.updateWorkerState(workerName, {
+            status,
+            extractedData,
+        });
+        // Update orchestration state
+        const orch = await this.stateManager.readOrchestrationState();
+        if (orch) {
+            const workerIdx = orch.workers.findIndex(w => w.workerName === workerName);
+            if (workerIdx !== -1) {
+                const previousStatus = orch.workers[workerIdx].status;
+                const wasAlreadyCompleted = previousStatus === 'SUCCESS' || previousStatus === 'PARTIAL' || previousStatus === 'FAIL';
+                orch.workers[workerIdx].status = status;
+                orch.workers[workerIdx].resultSummary = resultSummary;
+                // Only update counters if the worker wasn't already in a completed state
+                // This prevents double-counting when completeWorker is called multiple times
+                if (!wasAlreadyCompleted) {
+                    if (status === 'SUCCESS' || status === 'PARTIAL') {
+                        orch.completedWorkers++;
+                    }
+                    if (status === 'FAIL') {
+                        orch.failedWorkers++;
+                    }
+                }
+                else {
+                    // If status changed from one completed state to another, adjust counters
+                    const wasCompleted = previousStatus === 'SUCCESS' || previousStatus === 'PARTIAL';
+                    const wasFailed = previousStatus === 'FAIL';
+                    const isNowCompleted = status === 'SUCCESS' || status === 'PARTIAL';
+                    const isNowFailed = status === 'FAIL';
+                    if (wasCompleted && isNowFailed) {
+                        orch.completedWorkers--;
+                        orch.failedWorkers++;
+                    }
+                    else if (wasFailed && isNowCompleted) {
+                        orch.failedWorkers--;
+                        orch.completedWorkers++;
+                    }
+                    // If both were completed or both were failed, no change needed
+                }
+                // Check if all workers are done
+                const allDone = orch.workers.every(w => w.status === 'SUCCESS' || w.status === 'PARTIAL' || w.status === 'FAIL');
+                if (allDone) {
+                    if (orch.failedWorkers === orch.workers.length) {
+                        orch.status = 'FAILED';
+                    }
+                    else if (orch.failedWorkers > 0) {
+                        orch.status = 'PARTIAL';
+                    }
+                    else {
+                        orch.status = 'COMPLETED';
+                    }
+                }
+                else {
+                    orch.status = 'RUNNING';
+                }
+                await this.stateManager.writeOrchestrationState(orch);
+            }
+        }
+    }
+    /**
+     * Get current orchestration status
+     */
+    async getOrchestrationStatus() {
+        return this.stateManager.readOrchestrationState();
+    }
+    /**
+     * Get all worker states
+     */
+    async getAllWorkerStates() {
+        return this.stateManager.getAllWorkerStates();
+    }
+    /**
+     * Get worker state by name
+     */
+    async getWorkerState(workerName) {
+        return this.stateManager.readWorkerState(workerName);
+    }
+    /**
+     * Collect final results from all workers
+     */
+    async collectResults() {
+        const orch = await this.stateManager.readOrchestrationState();
+        if (!orch)
+            return null;
+        const workerResults = [];
+        const workerStates = await this.stateManager.getAllWorkerStates();
+        for (const state of workerStates) {
+            workerResults.push({
+                workerId: state.workerId,
+                workerName: state.workerName,
+                tabId: state.tabId,
+                status: state.status === 'SUCCESS' ? 'SUCCESS'
+                    : state.status === 'PARTIAL' ? 'PARTIAL'
+                        : 'FAIL',
+                resultSummary: `${state.status}: ${state.iteration} iterations`,
+                dataExtracted: state.extractedData,
+                iterations: state.iteration,
+                errors: state.errors,
+            });
+        }
+        const completedCount = workerResults.filter(r => r.status === 'SUCCESS' || r.status === 'PARTIAL').length;
+        const failedCount = workerResults.filter(r => r.status === 'FAIL').length;
+        const duration = Date.now() - orch.createdAt;
+        return {
+            orchestrationId: orch.orchestrationId,
+            status: orch.status === 'COMPLETED' ? 'COMPLETED'
+                : orch.status === 'PARTIAL' ? 'PARTIAL'
+                    : 'FAILED',
+            workerResults,
+            completedCount,
+            failedCount,
+            duration,
+        };
+    }
+    /**
+     * Cleanup workflow resources
+     */
+    async cleanupWorkflow(sessionId) {
+        // Get all workers from orchestration state
+        const orch = await this.stateManager.readOrchestrationState();
+        if (!orch)
+            return;
+        // Delete workers (which closes tabs and contexts)
+        for (const worker of orch.workers) {
+            try {
+                await this.sessionManager.deleteWorker(sessionId, worker.workerId);
+            }
+            catch {
+                // Worker might already be deleted
+            }
+        }
+        // Cleanup state files
+        await this.stateManager.cleanup();
+        console.error(`[WorkflowEngine] Cleaned up workflow resources`);
+    }
+    /**
+     * Generate worker agent prompt for Background Task
+     */
+    generateWorkerPrompt(workerId, workerName, tabId, task, successCriteria) {
+        return `## Chrome-Sisyphus Worker Agent
+
+You are an autonomous browser automation worker. Execute your assigned task completely before returning.
+
+### Configuration
+- Worker ID: ${workerId}
+- Worker Name: ${workerName}
+- Tab ID: ${tabId}
+- Scratchpad: .agent/chrome-sisyphus/worker-${workerName}.md
+
+### Your Task
+${task}
+
+### Success Criteria
+${successCriteria}
+
+---
+
+## CRITICAL RULES
+
+1. **ALWAYS include tabId="${tabId}" in EVERY MCP tool call**
+2. **Update scratchpad after EVERY action using Write tool**
+3. **Maximum 5 iterations**
+4. **Return compressed result only - NO screenshots or full DOM**
+
+---
+
+## Available MCP Tools
+
+### Navigation
+mcp__chrome-parallel__navigate
+- url: string (required)
+- tabId: "${tabId}" (required)
+
+### Interaction
+mcp__chrome-parallel__computer
+- action: "left_click" | "type" | "screenshot" | "scroll" | "key"
+- tabId: "${tabId}" (required)
+- coordinate: [x, y] (for clicks)
+- text: string (for typing)
+
+### Page Reading
+mcp__chrome-parallel__read_page
+- tabId: "${tabId}" (required)
+- filter: "interactive" | "all"
+
+### Element Finding
+mcp__chrome-parallel__find
+- query: string (natural language)
+- tabId: "${tabId}" (required)
+
+### Form Input
+mcp__chrome-parallel__form_input
+- ref: string (element reference from find/read_page)
+- value: string | boolean | number
+- tabId: "${tabId}" (required)
+
+### JavaScript Execution
+mcp__chrome-parallel__javascript_tool
+- action: "javascript_exec"
+- text: string (JS code)
+- tabId: "${tabId}" (required)
+
+---
+
+## Execution Algorithm (Ralph Loop)
+
+for iteration in 1..5:
+    1. Assess current state (read page or check scratchpad)
+    2. Decide next action
+    3. Execute MCP tool with tabId="${tabId}"
+    4. Update scratchpad with Write tool
+    5. Check if success criteria met -> if yes, return SUCCESS
+
+---
+
+## Final Output Format
+
+When done, your LAST message MUST contain:
+
+---RESULT---
+{
+  "status": "SUCCESS" | "PARTIAL" | "FAIL",
+  "workerName": "${workerName}",
+  "resultSummary": "Brief summary (max 100 chars)",
+  "dataExtracted": {
+    // Your extracted data here
+  },
+  "scratchpadPath": ".agent/chrome-sisyphus/worker-${workerName}.md",
+  "iterations": 3,
+  "errors": [],
+  "EXIT_SIGNAL": true
+}
+---END---
+
+---
+
+## Error Handling
+
+| Error | Strategy |
+|-------|----------|
+| Element not found | Try find with different query |
+| Page timeout | Refresh and retry |
+| Captcha | Report FAIL |
+| Network error | Wait 2s, retry |
+
+Now begin your task. Navigate to the target site and complete the assigned work.`;
+    }
+}
+exports.WorkflowEngine = WorkflowEngine;
+// Singleton instance
+let workflowEngineInstance = null;
+function getWorkflowEngine() {
+    if (!workflowEngineInstance) {
+        workflowEngineInstance = new WorkflowEngine();
+    }
+    return workflowEngineInstance;
+}
+//# sourceMappingURL=workflow-engine.js.map

package/dist/orchestration/workflow-engine.js.map

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

package/dist/session-manager.d.ts

@@ -1,8 +1,9 @@
 /**
  * Session Manager - Manages lifecycle of parallel Claude Code sessions
+ * Supports multiple Workers within a single session for parallel browser operations
  */
 import { Page } from 'puppeteer-core';
-import { Session, SessionInfo, SessionCreateOptions, SessionEvent } from './types/session';
+import { Session, SessionInfo, SessionCreateOptions, SessionEvent, Worker, WorkerInfo, WorkerCreateOptions } from './types/session';
 import { CDPClient } from './cdp/client';
 import { PoolStats } from './cdp/connection-pool';
 export interface SessionManagerConfig {
@@ -14,12 +15,15 @@ export interface SessionManagerConfig {
     autoCleanup?: boolean;
     /** Maximum number of sessions (default: 100) */
     maxSessions?: number;
-    /** Use connection pool for page management (default: true) */
+    /** Maximum workers per session (default: 20) */
+    maxWorkersPerSession?: number;
+    /** Use connection pool for page management (default: false for worker isolation) */
     useConnectionPool?: boolean;
 }
 export interface SessionManagerStats {
     activeSessions: number;
     totalTargets: number;
+    totalWorkers: number;
     totalSessionsCreated: number;
     totalSessionsCleaned: number;
     uptime: number;
@@ -29,7 +33,7 @@ export interface SessionManagerStats {
 }
 export declare class SessionManager {
     private sessions;
-    private targetToSession;
+    private targetToWorker;
     private cdpClient;
     private connectionPool;
     private queueManager;
@@ -66,7 +70,7 @@ export declare class SessionManager {
      */
     ensureConnected(): Promise<void>;
     /**
-     * Create a new session
+     * Create a new session with a default worker
      */
     createSession(options?: SessionCreateOptions): Promise<Session>;
     /**
@@ -82,7 +86,7 @@ export declare class SessionManager {
      */
     touchSession(sessionId: string): void;
     /**
-     * Delete a session and clean up resources
+     * Delete a session and clean up all workers
      */
     deleteSession(sessionId: string): Promise<void>;
     /**
@@ -94,36 +98,80 @@ export declare class SessionManager {
      */
     cleanupAllSessions(): Promise<number>;
     /**
-     * Create a new page/target for a session
+     * Create a new worker within a session
+     * Each worker has its own isolated browser context (cookies, localStorage, etc.)
      */
-    createTarget(sessionId: string, url?: string): Promise<{
+    createWorker(sessionId: string, options?: WorkerCreateOptions): Promise<Worker>;
+    /**
+     * Get a worker by ID
+     */
+    getWorker(sessionId: string, workerId: string): Worker | undefined;
+    /**
+     * Get or create a worker
+     */
+    getOrCreateWorker(sessionId: string, workerId?: string): Promise<Worker>;
+    /**
+     * List all workers in a session
+     */
+    getWorkers(sessionId: string): WorkerInfo[];
+    /**
+     * Delete a worker and its resources
+     */
+    deleteWorker(sessionId: string, workerId: string): Promise<void>;
+    /**
+     * Internal worker deletion (also used for cleanup)
+     */
+    private deleteWorkerInternal;
+    /**
+     * Create a new page/target for a worker
+     * @param sessionId Session ID
+     * @param url Optional URL to navigate to
+     * @param workerId Optional worker ID (uses default worker if not specified)
+     */
+    createTarget(sessionId: string, url?: string, workerId?: string): Promise<{
         targetId: string;
         page: Page;
+        workerId: string;
     }>;
+    /**
+     * Check if a target is still valid (page not closed)
+     */
+    isTargetValid(targetId: string): Promise<boolean>;
     /**
      * Get page for a target
+     * @param sessionId Session ID
+     * @param targetId Target/Tab ID
+     * @param workerId Optional worker ID for validation
      */
-    getPage(sessionId: string, targetId: string): Promise<Page | null>;
+    getPage(sessionId: string, targetId: string, workerId?: string): Promise<Page | null>;
     /**
-     * Get all pages for a session
+     * Get all pages for a worker
      */
-    getSessionPages(sessionId: string): Promise<Page[]>;
+    getWorkerPages(sessionId: string, workerId: string): Promise<Page[]>;
     /**
-     * Get target IDs for a session
+     * Get target IDs for a session (all workers)
      */
     getSessionTargetIds(sessionId: string): string[];
     /**
-     * Validate target ownership
+     * Get target IDs for a specific worker
+     */
+    getWorkerTargetIds(sessionId: string, workerId: string): string[];
+    /**
+     * Validate target ownership (legacy method, checks session only)
      */
     validateTargetOwnership(sessionId: string, targetId: string): boolean;
+    /**
+     * Get the worker ID that owns a target
+     */
+    getTargetWorkerId(targetId: string): string | undefined;
     /**
      * Execute a CDP command through the session's queue
      */
     executeCDP<T = unknown>(sessionId: string, targetId: string, method: string, params?: Record<string, unknown>): Promise<T>;
     /**
-     * Remove a target from a session
+     * Handle target closed event
      */
-    removeTarget(sessionId: string, targetId: string): Promise<void>;
+    onTargetClosed(targetId: string): void;
     /**
      * Get session info (for serialization)
      */
@@ -132,10 +180,6 @@ export declare class SessionManager {
      * Get all session infos
      */
     getAllSessionInfos(): SessionInfo[];
-    /**
-     * Handle target closed event
-     */
-    onTargetClosed(targetId: string): void;
     /**
      * Add event listener
      */

package/dist/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAA0B,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACpI,OAAO,EAAE,SAAS,EAAgB,MAAM,cAAc,CAAC;AACvD,OAAO,EAA2C,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAS3F,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAWD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,cAAc,CAAmE;IACzF,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,cAAc,CAAyC;IAG/D,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,eAAe,CAAuB;gBAElC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAmBhE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,eAAe,IAAI,IAAI;IAOvB;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IA+B/B;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAI3C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAYzD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtC;;OAEG;IACG,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDzE;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7D;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOrC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrD;;OAEG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAelE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAc3C;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CzF;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMlE;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc9E;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAkB3C;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtE;;OAEG;YACW,oBAAoB;IAgClC;;;;;OAKG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA0B9D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvD;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAoB3F;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAe1E;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAYhD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAMjE;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKrE;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvD;;OAEG;IACG,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAgBb;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwBtC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IA6B1D;;OAEG;IACH,kBAAkB,IAAI,WAAW,EAAE;IAanC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI/D;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAOlE;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,YAAY,IAAI,SAAS;CAG1B;AAKD,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}