@bluefly/openstandardagents 0.4.3 → 0.4.4

package/dist/messenger/Handler/AgentBatchHandler.js

@@ -0,0 +1,207 @@
+/**
+ * Message handler for batch agent execution
+ *
+ * This handler processes AgentBatchMessage messages and executes
+ * multiple OSSA agents either in parallel or sequentially.
+ *
+ * @package @bluefly/openstandardagents
+ * @since 0.5.0
+ */
+export class AgentBatchHandler {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Handle batch execution message
+     */
+    async handle(message) {
+        const startTime = new Date().toISOString();
+        const agentIds = message.getAgentIds();
+        const context = message.getContext();
+        this.deps.logger.info('Starting batch agent execution', {
+            agentCount: agentIds.length,
+            mode: message.getOptions().mode,
+            userId: context.userId,
+            sessionId: context.sessionId,
+        });
+        try {
+            let results;
+            if (message.isParallel()) {
+                results = await this.executeParallel(message);
+            }
+            else {
+                results = await this.executeSequential(message);
+            }
+            const endTime = new Date().toISOString();
+            const duration = new Date(endTime).getTime() - new Date(startTime).getTime();
+            // Count successes and failures
+            const successCount = Object.values(results).filter((r) => r.success).length;
+            const failureCount = agentIds.length - successCount;
+            const batchResult = {
+                success: failureCount === 0,
+                results,
+                metadata: {
+                    totalAgents: agentIds.length,
+                    successCount,
+                    failureCount,
+                    startTime,
+                    endTime,
+                    duration,
+                },
+            };
+            // Store batch result
+            const batchId = context.requestId ?? `batch-${Date.now()}`;
+            await this.deps.resultStorage.store(batchId, batchResult);
+            // Dispatch completion event
+            await this.deps.eventDispatcher.dispatch('agent.batch.complete', {
+                batchResult,
+                context,
+            });
+            // Send callback if specified
+            const callbackUrl = message.getCallbackUrl();
+            if (callbackUrl && this.deps.callbackHandler) {
+                await this.deps.callbackHandler.notify(callbackUrl, batchResult);
+            }
+            this.deps.logger.info('Batch execution completed', {
+                totalAgents: agentIds.length,
+                successCount,
+                failureCount,
+                duration,
+            });
+            // Throw if any failures and stopOnError is true
+            if (failureCount > 0 && message.shouldStopOnError()) {
+                throw new Error(`Batch execution failed: ${failureCount} agent(s) failed`);
+            }
+        }
+        catch (error) {
+            this.deps.logger.error('Batch execution failed', error, {
+                agentCount: agentIds.length,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Execute agents in parallel
+     */
+    async executeParallel(message) {
+        const agentIds = message.getAgentIds();
+        const maxParallel = message.getOptions().maxParallel ?? agentIds.length;
+        this.deps.logger.debug('Executing agents in parallel', {
+            total: agentIds.length,
+            maxParallel,
+        });
+        const results = {};
+        // Execute in chunks
+        for (let i = 0; i < agentIds.length; i += maxParallel) {
+            const chunk = agentIds.slice(i, i + maxParallel);
+            const chunkPromises = chunk.map((agentId) => this.executeSingleAgent(agentId, message.getInputForAgent(agentId)));
+            const chunkResults = await Promise.allSettled(chunkPromises);
+            chunk.forEach((agentId, index) => {
+                const result = chunkResults[index];
+                if (result.status === 'fulfilled') {
+                    results[agentId] = result.value;
+                }
+                else {
+                    results[agentId] = {
+                        success: false,
+                        error: {
+                            message: result.reason?.message ?? 'Unknown error',
+                            code: 'EXECUTION_FAILED',
+                        },
+                        metadata: {
+                            agentId,
+                            startTime: new Date().toISOString(),
+                            endTime: new Date().toISOString(),
+                            duration: 0,
+                        },
+                    };
+                }
+            });
+        }
+        return results;
+    }
+    /**
+     * Execute agents sequentially
+     */
+    async executeSequential(message) {
+        const agentIds = message.getAgentIds();
+        const results = {};
+        this.deps.logger.debug('Executing agents sequentially', {
+            total: agentIds.length,
+        });
+        for (const agentId of agentIds) {
+            try {
+                const result = await this.executeSingleAgent(agentId, message.getInputForAgent(agentId));
+                results[agentId] = result;
+                // Stop on error if requested
+                if (!result.success && message.shouldStopOnError()) {
+                    this.deps.logger.info('Stopping batch execution due to error', { agentId });
+                    break;
+                }
+            }
+            catch (error) {
+                results[agentId] = {
+                    success: false,
+                    error: {
+                        message: error instanceof Error ? error.message : String(error),
+                        code: 'EXECUTION_FAILED',
+                    },
+                    metadata: {
+                        agentId,
+                        startTime: new Date().toISOString(),
+                        endTime: new Date().toISOString(),
+                        duration: 0,
+                    },
+                };
+                // Stop on error if requested
+                if (message.shouldStopOnError()) {
+                    this.deps.logger.info('Stopping batch execution due to error', { agentId });
+                    break;
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute a single agent
+     */
+    async executeSingleAgent(agentId, input) {
+        const startTime = new Date().toISOString();
+        try {
+            const agent = await this.deps.agentRuntime.loadAgent(agentId);
+            const output = await this.deps.agentRuntime.executeAgent(agent, input);
+            const endTime = new Date().toISOString();
+            const duration = new Date(endTime).getTime() - new Date(startTime).getTime();
+            return {
+                success: true,
+                output,
+                metadata: {
+                    agentId,
+                    startTime,
+                    endTime,
+                    duration,
+                },
+            };
+        }
+        catch (error) {
+            const endTime = new Date().toISOString();
+            const duration = new Date(endTime).getTime() - new Date(startTime).getTime();
+            return {
+                success: false,
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                    code: 'EXECUTION_FAILED',
+                    stack: error instanceof Error ? error.stack : undefined,
+                },
+                metadata: {
+                    agentId,
+                    startTime,
+                    endTime,
+                    duration,
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=AgentBatchHandler.js.map

package/dist/messenger/Handler/AgentBatchHandler.js.map

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

package/dist/messenger/Handler/AgentExecutionHandler.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Message handler for agent execution
+ *
+ * This handler processes AgentExecutionMessage messages and executes
+ * OSSA agents asynchronously. It integrates with the agent runtime,
+ * handles errors, stores results, and triggers events.
+ *
+ * @package @bluefly/openstandardagents
+ * @since 0.5.0
+ */
+import type { AgentExecutionMessage } from '../Message/AgentExecutionMessage.js';
+import type { OssaAgent } from '../../types/index.js';
+export interface AgentExecutionResult {
+    success: boolean;
+    output?: unknown;
+    error?: {
+        message: string;
+        code: string;
+        stack?: string;
+    };
+    metadata: {
+        agentId: string;
+        startTime: string;
+        endTime: string;
+        duration: number;
+        tokenUsage?: {
+            input: number;
+            output: number;
+            total: number;
+        };
+    };
+}
+export interface AgentExecutionHandlerDependencies {
+    /**
+     * Agent runtime for executing OSSA agents
+     */
+    agentRuntime: {
+        loadAgent(agentId: string): Promise<OssaAgent>;
+        executeAgent(agent: OssaAgent, input: Record<string, unknown>): Promise<unknown>;
+    };
+    /**
+     * Result storage for persisting execution results
+     */
+    resultStorage: {
+        store(messageId: string, result: AgentExecutionResult): Promise<void>;
+    };
+    /**
+     * Event dispatcher for triggering events
+     */
+    eventDispatcher: {
+        dispatch(eventName: string, data: unknown): Promise<void>;
+    };
+    /**
+     * Logger for execution tracking
+     */
+    logger: {
+        info(message: string, context?: Record<string, unknown>): void;
+        error(message: string, error?: Error, context?: Record<string, unknown>): void;
+        debug(message: string, context?: Record<string, unknown>): void;
+    };
+    /**
+     * Optional callback handler for async notifications
+     */
+    callbackHandler?: {
+        notify(url: string, result: AgentExecutionResult): Promise<void>;
+    };
+}
+export declare class AgentExecutionHandler {
+    private readonly deps;
+    constructor(deps: AgentExecutionHandlerDependencies);
+    /**
+     * Handle agent execution message
+     */
+    handle(message: AgentExecutionMessage): Promise<void>;
+}
+//# sourceMappingURL=AgentExecutionHandler.d.ts.map

package/dist/messenger/Handler/AgentExecutionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentExecutionHandler.d.ts","sourceRoot":"","sources":["../../../src/messenger/Handler/AgentExecutionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE;YACX,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,YAAY,EAAE;QACZ,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAClF,CAAC;IAEF;;OAEG;IACH,aAAa,EAAE;QACb,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACvE,CAAC;IAEF;;OAEG;IACH,eAAe,EAAE;QACf,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3D,CAAC;IAEF;;OAEG;IACH,MAAM,EAAE;QACN,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC/E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KACjE,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE;QAChB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClE,CAAC;CACH;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,iCAAiC;IAEpE;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2HnE"}

package/dist/messenger/Handler/AgentExecutionHandler.js

@@ -0,0 +1,131 @@
+/**
+ * Message handler for agent execution
+ *
+ * This handler processes AgentExecutionMessage messages and executes
+ * OSSA agents asynchronously. It integrates with the agent runtime,
+ * handles errors, stores results, and triggers events.
+ *
+ * @package @bluefly/openstandardagents
+ * @since 0.5.0
+ */
+export class AgentExecutionHandler {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Handle agent execution message
+     */
+    async handle(message) {
+        const startTime = new Date().toISOString();
+        const agentId = message.getAgentId();
+        const input = message.getInput();
+        const context = message.getContext();
+        this.deps.logger.info('Starting agent execution', {
+            agentId,
+            userId: context.userId,
+            sessionId: context.sessionId,
+            requestId: context.requestId,
+        });
+        try {
+            // Load agent manifest
+            const agent = await this.deps.agentRuntime.loadAgent(agentId);
+            this.deps.logger.debug('Agent loaded successfully', {
+                agentId,
+                agentName: agent.metadata?.name,
+            });
+            // Execute agent
+            const output = await this.deps.agentRuntime.executeAgent(agent, input);
+            const endTime = new Date().toISOString();
+            const duration = new Date(endTime).getTime() - new Date(startTime).getTime();
+            // Build success result
+            const result = {
+                success: true,
+                output,
+                metadata: {
+                    agentId,
+                    startTime,
+                    endTime,
+                    duration,
+                },
+            };
+            // Store result
+            await this.deps.resultStorage.store(context.requestId ?? agentId, result);
+            // Dispatch success event
+            await this.deps.eventDispatcher.dispatch('agent.execution.success', {
+                agentId,
+                result,
+                context,
+            });
+            // Send callback if specified
+            const callbackUrl = message.getCallbackUrl();
+            if (callbackUrl && this.deps.callbackHandler) {
+                await this.deps.callbackHandler.notify(callbackUrl, result);
+            }
+            this.deps.logger.info('Agent execution completed successfully', {
+                agentId,
+                duration,
+                hasOutput: !!output,
+            });
+        }
+        catch (error) {
+            const endTime = new Date().toISOString();
+            const duration = new Date(endTime).getTime() - new Date(startTime).getTime();
+            const errorResult = {
+                success: false,
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                    code: 'EXECUTION_FAILED',
+                    stack: error instanceof Error ? error.stack : undefined,
+                },
+                metadata: {
+                    agentId,
+                    startTime,
+                    endTime,
+                    duration,
+                },
+            };
+            // Store error result
+            try {
+                await this.deps.resultStorage.store(context.requestId ?? agentId, errorResult);
+            }
+            catch (storageError) {
+                this.deps.logger.error('Failed to store error result', storageError, {
+                    agentId,
+                });
+            }
+            // Dispatch failure event
+            try {
+                await this.deps.eventDispatcher.dispatch('agent.execution.failure', {
+                    agentId,
+                    error: errorResult.error,
+                    context,
+                });
+            }
+            catch (eventError) {
+                this.deps.logger.error('Failed to dispatch failure event', eventError, {
+                    agentId,
+                });
+            }
+            // Send callback with error if specified
+            const callbackUrl = message.getCallbackUrl();
+            if (callbackUrl && this.deps.callbackHandler) {
+                try {
+                    await this.deps.callbackHandler.notify(callbackUrl || '', errorResult);
+                }
+                catch (callbackError) {
+                    this.deps.logger.error('Failed to send error callback', callbackError, {
+                        agentId,
+                    });
+                }
+            }
+            this.deps.logger.error('Agent execution failed', error, {
+                agentId,
+                duration,
+            });
+            // Re-throw to mark message as failed (will trigger retry)
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=AgentExecutionHandler.js.map

package/dist/messenger/Handler/AgentExecutionHandler.js.map

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

package/dist/messenger/Handler/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Messenger handlers
+ *
+ * @package @bluefly/openstandardagents
+ * @since 0.5.0
+ */
+export { AgentExecutionHandler, type AgentExecutionHandlerDependencies, type AgentExecutionResult, } from './AgentExecutionHandler.js';
+export { AgentBatchHandler, type AgentBatchHandlerDependencies, type BatchExecutionResult, } from './AgentBatchHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/messenger/Handler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/messenger/Handler/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,iCAAiC,EACtC,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC"}

package/dist/messenger/Handler/index.js

@@ -0,0 +1,9 @@
+/**
+ * Messenger handlers
+ *
+ * @package @bluefly/openstandardagents
+ * @since 0.5.0
+ */
+export { AgentExecutionHandler, } from './AgentExecutionHandler.js';
+export { AgentBatchHandler, } from './AgentBatchHandler.js';
+//# sourceMappingURL=index.js.map

package/dist/messenger/Handler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/messenger/Handler/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC"}

package/dist/messenger/Message/AgentBatchMessage.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Message for batch agent execution
+ *
+ * This message is dispatched to execute multiple agents in parallel or sequence.
+ * It supports batch processing with optional ordering and dependency management.
+ *
+ * @package @bluefly/openstandardagents
+ * @since 0.5.0
+ */
+export interface AgentBatchMessageData {
+    /**
+     * List of agent IDs to execute
+     */
+    agentIds: string[];
+    /**
+     * Input data for each agent (indexed by agent ID)
+     * If not specified, same input will be used for all agents
+     */
+    inputs: Record<string, Record<string, unknown>>;
+    /**
+     * Batch execution options
+     */
+    options: {
+        /**
+         * Execution mode: parallel or sequential
+         */
+        mode: 'parallel' | 'sequential';
+        /**
+         * Maximum parallel executions (for parallel mode)
+         */
+        maxParallel?: number;
+        /**
+         * Stop on first error
+         */
+        stopOnError?: boolean;
+        /**
+         * Aggregate results
+         */
+        aggregateResults?: boolean;
+        /**
+         * Timeout for entire batch in milliseconds
+         */
+        batchTimeout?: number;
+    };
+    /**
+     * Shared context for all agents
+     */
+    context: {
+        userId?: string;
+        sessionId?: string;
+        requestId?: string;
+        metadata?: Record<string, unknown>;
+    };
+    /**
+     * Optional callback URL for batch completion
+     */
+    callbackUrl?: string;
+    /**
+     * Timestamp when message was created
+     */
+    timestamp: string;
+}
+export declare class AgentBatchMessage {
+    private readonly agentIds;
+    private readonly inputs;
+    private readonly options;
+    private readonly context;
+    private readonly callbackUrl?;
+    constructor(agentIds: string[], inputs: Record<string, Record<string, unknown>>, options?: AgentBatchMessageData['options'], context?: AgentBatchMessageData['context'], callbackUrl?: string | undefined);
+    /**
+     * Get the agent IDs
+     */
+    getAgentIds(): string[];
+    /**
+     * Get inputs for a specific agent
+     */
+    getInputForAgent(agentId: string): Record<string, unknown>;
+    /**
+     * Get all inputs
+     */
+    getInputs(): Record<string, Record<string, unknown>>;
+    /**
+     * Get batch options
+     */
+    getOptions(): AgentBatchMessageData['options'];
+    /**
+     * Get execution context
+     */
+    getContext(): AgentBatchMessageData['context'];
+    /**
+     * Get callback URL
+     */
+    getCallbackUrl(): string | undefined;
+    /**
+     * Check if execution should be parallel
+     */
+    isParallel(): boolean;
+    /**
+     * Check if execution should stop on error
+     */
+    shouldStopOnError(): boolean;
+    /**
+     * Get number of agents in batch
+     */
+    getCount(): number;
+    /**
+     * Serialize to JSON
+     */
+    toJSON(): AgentBatchMessageData;
+    /**
+     * Deserialize from JSON
+     */
+    static fromJSON(data: AgentBatchMessageData): AgentBatchMessage;
+}
+//# sourceMappingURL=AgentBatchMessage.d.ts.map

package/dist/messenger/Message/AgentBatchMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentBatchMessage.d.ts","sourceRoot":"","sources":["../../../src/messenger/Message/AgentBatchMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEhD;;OAEG;IACH,OAAO,EAAE;QACP;;WAEG;QACH,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;QAEhC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB;;WAEG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAE3B;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAJZ,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAwB,EAChE,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,EAC9C,WAAW,CAAC,EAAE,MAAM,YAAA;IAOvC;;OAEG;IACI,WAAW,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjE;;OAEG;IACI,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI3D;;OAEG;IACI,UAAU,IAAI,qBAAqB,CAAC,SAAS,CAAC;IAIrD;;OAEG;IACI,UAAU,IAAI,qBAAqB,CAAC,SAAS,CAAC;IAIrD;;OAEG;IACI,cAAc,IAAI,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACI,UAAU,IAAI,OAAO;IAI5B;;OAEG;IACI,iBAAiB,IAAI,OAAO;IAInC;;OAEG;IACI,QAAQ,IAAI,MAAM;IAIzB;;OAEG;IACI,MAAM,IAAI,qBAAqB;IAWtC;;OAEG;WACW,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB;CASvE"}