sub-agents-mcp 0.1.2

package/dist/execution/McpRequestTimeout.js.map

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

package/dist/execution/PromptController.d.ts

@@ -0,0 +1,92 @@
+import type { ExecutionParams } from '../types/ExecutionParams';
+/**
+ * Configuration options for recursion prevention warnings.
+ * Allows customization of warning messages and formatting.
+ */
+export interface RecursionWarningConfig {
+    /**
+     * The warning message template to add to prompts.
+     * Should contain clear instructions to prevent recursion.
+     */
+    warningTemplate: string;
+    /**
+     * Whether to format the warning with visual separators.
+     * Defaults to true for better readability.
+     */
+    useFormatting: boolean;
+}
+/**
+ * Default configuration for recursion prevention warnings.
+ * Uses clear English instructions to prevent sub-agents-mcp MCP tool usage.
+ */
+export declare const DEFAULT_RECURSION_WARNING_CONFIG: RecursionWarningConfig;
+/**
+ * Controller class for enhancing prompts with recursion prevention instructions.
+ * Implements the security strategy defined in ADR-0001 for preventing infinite loops
+ * in agent-to-agent communication through prompt control.
+ */
+export declare class PromptController {
+    private readonly config;
+    /**
+     * Creates a new PromptController instance.
+     *
+     * @param config - Optional configuration for recursion warning behavior
+     */
+    constructor(config?: RecursionWarningConfig);
+    /**
+     * Adds recursion prevention warning to a prompt string.
+     *
+     * This method implements the prompt control strategy defined in ADR-0001
+     * to prevent infinite loops in agent-to-agent communication. It preserves
+     * the original prompt content while adding clear security instructions
+     * that explicitly prohibit the use of sub-agents-mcp MCP tools.
+     *
+     * @param originalPrompt - The original user prompt to enhance
+     * @returns Enhanced prompt with recursion prevention instructions appended
+     * @throws {Error} When originalPrompt is empty or contains only whitespace
+     *
+     * @example
+     * ```typescript
+     * const controller = new PromptController()
+     * const enhanced = controller.addRecursionWarning("Help me debug this code")
+     * console.log(enhanced)
+     * // Output: "Help me debug this code\n============...===========\nIMPORTANT RECURSION PREVENTION INSTRUCTIONS:\n- Do NOT use sub-agents-mcp MCP tools..."
+     * ```
+     */
+    addRecursionWarning(originalPrompt: string): string;
+    /**
+     * Formats the warning message according to the current configuration.
+     *
+     * @private
+     * @returns Formatted warning message with or without visual separators
+     */
+    private formatWarningMessage;
+    /**
+     * Enhances ExecutionParams by adding recursion prevention to the prompt field.
+     *
+     * This method is the primary interface for integrating prompt enhancement
+     * into the agent execution pipeline. It creates a new ExecutionParams object
+     * with an enhanced prompt while preserving all other execution parameters.
+     * The enhanced prompt includes ADR-0001 compliant security instructions.
+     *
+     * @param params - Original execution parameters to enhance
+     * @returns New ExecutionParams object with enhanced prompt field
+     * @throws {Error} When params is invalid or prompt enhancement fails
+     *
+     * @example
+     * ```typescript
+     * const controller = new PromptController()
+     * const original = {
+     *   agent: "code-helper",
+     *   prompt: "Fix this bug",
+     *   cwd: "/project",
+     *   extra_args: ["--verbose"]
+     * }
+     * const enhanced = controller.enhanceExecutionParams(original)
+     * console.log(enhanced.prompt) // Original prompt + recursion prevention
+     * console.log(enhanced.agent)  // "code-helper" (unchanged)
+     * ```
+     */
+    enhanceExecutionParams(params: ExecutionParams): ExecutionParams;
+}
+//# sourceMappingURL=PromptController.d.ts.map

package/dist/execution/PromptController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptController.d.ts","sourceRoot":"","sources":["../../src/execution/PromptController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAA;IAEvB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,sBAS9C,CAAA;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C;;;;OAIG;gBACS,MAAM,GAAE,sBAAyD;IAI7E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAiBnD;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe;CA6BjE"}

package/dist/execution/PromptController.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptController = exports.DEFAULT_RECURSION_WARNING_CONFIG = void 0;
+/**
+ * Default configuration for recursion prevention warnings.
+ * Uses clear English instructions to prevent sub-agents-mcp MCP tool usage.
+ */
+exports.DEFAULT_RECURSION_WARNING_CONFIG = {
+    warningTemplate: `
+IMPORTANT RECURSION PREVENTION INSTRUCTIONS:
+- Do NOT use sub-agents-mcp MCP tools in your response
+- Complete this task within the current agent context only
+- Do not attempt to call other agents or sub-agents
+- Focus on direct implementation and solution delivery
+`,
+    useFormatting: true,
+};
+/**
+ * Controller class for enhancing prompts with recursion prevention instructions.
+ * Implements the security strategy defined in ADR-0001 for preventing infinite loops
+ * in agent-to-agent communication through prompt control.
+ */
+class PromptController {
+    /**
+     * Creates a new PromptController instance.
+     *
+     * @param config - Optional configuration for recursion warning behavior
+     */
+    constructor(config = exports.DEFAULT_RECURSION_WARNING_CONFIG) {
+        this.config = config;
+    }
+    /**
+     * Adds recursion prevention warning to a prompt string.
+     *
+     * This method implements the prompt control strategy defined in ADR-0001
+     * to prevent infinite loops in agent-to-agent communication. It preserves
+     * the original prompt content while adding clear security instructions
+     * that explicitly prohibit the use of sub-agents-mcp MCP tools.
+     *
+     * @param originalPrompt - The original user prompt to enhance
+     * @returns Enhanced prompt with recursion prevention instructions appended
+     * @throws {Error} When originalPrompt is empty or contains only whitespace
+     *
+     * @example
+     * ```typescript
+     * const controller = new PromptController()
+     * const enhanced = controller.addRecursionWarning("Help me debug this code")
+     * console.log(enhanced)
+     * // Output: "Help me debug this code\n============...===========\nIMPORTANT RECURSION PREVENTION INSTRUCTIONS:\n- Do NOT use sub-agents-mcp MCP tools..."
+     * ```
+     */
+    addRecursionWarning(originalPrompt) {
+        // Input validation: ensure prompt is not empty or whitespace-only
+        if (typeof originalPrompt !== 'string') {
+            throw new Error('Original prompt must be a string');
+        }
+        if (originalPrompt.trim().length === 0) {
+            throw new Error('Original prompt cannot be empty');
+        }
+        // Format warning based on configuration
+        const warning = this.formatWarningMessage();
+        // Concatenate original prompt with warning
+        return `${originalPrompt}${warning}`;
+    }
+    /**
+     * Formats the warning message according to the current configuration.
+     *
+     * @private
+     * @returns Formatted warning message with or without visual separators
+     */
+    formatWarningMessage() {
+        if (this.config.useFormatting) {
+            const separator = '='.repeat(60);
+            return `\n${separator}\n${this.config.warningTemplate}\n${separator}\n`;
+        }
+        return this.config.warningTemplate;
+    }
+    /**
+     * Enhances ExecutionParams by adding recursion prevention to the prompt field.
+     *
+     * This method is the primary interface for integrating prompt enhancement
+     * into the agent execution pipeline. It creates a new ExecutionParams object
+     * with an enhanced prompt while preserving all other execution parameters.
+     * The enhanced prompt includes ADR-0001 compliant security instructions.
+     *
+     * @param params - Original execution parameters to enhance
+     * @returns New ExecutionParams object with enhanced prompt field
+     * @throws {Error} When params is invalid or prompt enhancement fails
+     *
+     * @example
+     * ```typescript
+     * const controller = new PromptController()
+     * const original = {
+     *   agent: "code-helper",
+     *   prompt: "Fix this bug",
+     *   cwd: "/project",
+     *   extra_args: ["--verbose"]
+     * }
+     * const enhanced = controller.enhanceExecutionParams(original)
+     * console.log(enhanced.prompt) // Original prompt + recursion prevention
+     * console.log(enhanced.agent)  // "code-helper" (unchanged)
+     * ```
+     */
+    enhanceExecutionParams(params) {
+        // Input validation: ensure params is valid ExecutionParams object
+        if (!params || typeof params !== 'object') {
+            throw new Error('ExecutionParams must be a valid object');
+        }
+        if (!params.agent || typeof params.agent !== 'string') {
+            throw new Error('ExecutionParams must have a valid agent field');
+        }
+        if (!params.prompt || typeof params.prompt !== 'string') {
+            throw new Error('ExecutionParams must have a valid prompt field');
+        }
+        try {
+            // Enhance the prompt with recursion prevention instructions
+            const enhancedPrompt = this.addRecursionWarning(params.prompt);
+            // Return new object with enhanced prompt, preserving all other fields
+            return {
+                ...params,
+                prompt: enhancedPrompt,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to enhance execution parameters: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+exports.PromptController = PromptController;
+//# sourceMappingURL=PromptController.js.map

package/dist/execution/PromptController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptController.js","sourceRoot":"","sources":["../../src/execution/PromptController.ts"],"names":[],"mappings":";;;AAoBA;;;GAGG;AACU,QAAA,gCAAgC,GAA2B;IACtE,eAAe,EAAE;;;;;;CAMlB;IACC,aAAa,EAAE,IAAI;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAa,gBAAgB;IAG3B;;;;OAIG;IACH,YAAY,SAAiC,wCAAgC;QAC3E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,CAAC,cAAsB;QACxC,kEAAkE;QAClE,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACpD,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAE3C,2CAA2C;QAC3C,OAAO,GAAG,cAAc,GAAG,OAAO,EAAE,CAAA;IACtC,CAAC;IAED;;;;;OAKG;IACK,oBAAoB;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAChC,OAAO,KAAK,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,CAAA;QACzE,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAA;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,MAAuB;QAC5C,kEAAkE;QAClE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QACnE,CAAC;QAED,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAE9D,sEAAsE;YACtE,OAAO;gBACL,GAAG,MAAM;gBACT,MAAM,EAAE,cAAc;aACvB,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,2CAA2C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACtG,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAvHD,4CAuHC"}

package/dist/execution/StreamProcessor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * StreamProcessor - Simplified stream processing for agent output
+ *
+ * Handles both cursor and claude output in JSON format.
+ * Both agents now use --output-format json and return a single JSON response.
+ */
+export declare class StreamProcessor {
+    private resultJson;
+    /**
+     * Process a single line from the agent output stream.
+     * Returns true when a valid JSON is detected, false otherwise.
+     *
+     * @param line - Raw line from stdout
+     * @returns true if processing is complete, false to continue
+     */
+    processLine(line: string): boolean;
+    /**
+     * Get the final result JSON.
+     * @returns The stored result JSON or null if not yet available
+     */
+    getResult(): unknown;
+}
+//# sourceMappingURL=StreamProcessor.d.ts.map

package/dist/execution/StreamProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamProcessor.d.ts","sourceRoot":"","sources":["../../src/execution/StreamProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAgB;IAElC;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAwBlC;;;OAGG;IACH,SAAS,IAAI,OAAO;CAGrB"}

package/dist/execution/StreamProcessor.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamProcessor = void 0;
+/**
+ * StreamProcessor - Simplified stream processing for agent output
+ *
+ * Handles both cursor and claude output in JSON format.
+ * Both agents now use --output-format json and return a single JSON response.
+ */
+class StreamProcessor {
+    constructor() {
+        this.resultJson = null;
+    }
+    /**
+     * Process a single line from the agent output stream.
+     * Returns true when a valid JSON is detected, false otherwise.
+     *
+     * @param line - Raw line from stdout
+     * @returns true if processing is complete, false to continue
+     */
+    processLine(line) {
+        const trimmedLine = line.trim();
+        // Empty lines are ignored
+        if (!trimmedLine) {
+            return false;
+        }
+        // Try to parse as JSON
+        try {
+            const json = JSON.parse(trimmedLine);
+            // Store the first valid JSON response
+            if (!this.resultJson) {
+                this.resultJson = json;
+                return true; // Processing complete
+            }
+            return false; // Ignore subsequent JSONs
+        }
+        catch {
+            // Not valid JSON, ignore
+            return false;
+        }
+    }
+    /**
+     * Get the final result JSON.
+     * @returns The stored result JSON or null if not yet available
+     */
+    getResult() {
+        return this.resultJson;
+    }
+}
+exports.StreamProcessor = StreamProcessor;
+//# sourceMappingURL=StreamProcessor.js.map

package/dist/execution/StreamProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamProcessor.js","sourceRoot":"","sources":["../../src/execution/StreamProcessor.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,eAAe;IAA5B;QACU,eAAU,GAAY,IAAI,CAAA;IAwCpC,CAAC;IAtCC;;;;;;OAMG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAE/B,0BAA0B;QAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;YAEpC,sCAAsC;YACtC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;gBACtB,OAAO,IAAI,CAAA,CAAC,sBAAsB;YACpC,CAAC;YACD,OAAO,KAAK,CAAA,CAAC,0BAA0B;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;YACzB,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;CACF;AAzCD,0CAyCC"}

package/dist/execution/TimeoutManager.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Timeout management for agent execution with configurable limits and cleanup.
+ *
+ * Provides timeout enforcement with warning mechanisms, graceful cleanup,
+ * and integration with agent execution processes.
+ */
+/**
+ * Configuration interface for timeout management.
+ */
+export interface TimeoutConfig {
+    /** Default timeout in milliseconds (default: 30000) */
+    defaultTimeoutMs: number;
+    /** Warning threshold as percentage of timeout (default: 0.8 for 80%) */
+    warningThresholdPercent: number;
+    /** Enable timeout warnings (default: true) */
+    enableWarnings: boolean;
+    /** Grace period for cleanup in milliseconds (default: 5000) */
+    cleanupGracePeriodMs: number;
+}
+/**
+ * Timeout execution context for tracking active operations.
+ */
+export interface TimeoutContext {
+    /** Unique identifier for the operation */
+    operationId: string;
+    /** Start time of the operation */
+    startTime: Date;
+    /** Timeout duration in milliseconds */
+    timeoutMs: number;
+    /** Warning callback function */
+    onWarning?: (remainingMs: number) => void;
+    /** Cleanup callback function */
+    onCleanup?: () => Promise<void>;
+}
+/**
+ * Default timeout configuration.
+ */
+export declare const DEFAULT_TIMEOUT_CONFIG: TimeoutConfig;
+/**
+ * Timeout manager for execution time monitoring and enforcement.
+ *
+ * Manages timeout enforcement with configurable limits, warning mechanisms,
+ * and graceful cleanup for agent execution processes.
+ */
+export declare class TimeoutManager {
+    private readonly config;
+    private readonly activeTimeouts;
+    /**
+     * Creates a new TimeoutManager instance.
+     *
+     * @param config - Timeout configuration (uses defaults if not provided)
+     */
+    constructor(config?: Partial<TimeoutConfig>);
+    /**
+     * Starts timeout monitoring for an operation.
+     *
+     * @param context - Timeout context for the operation
+     * @returns Operation ID for tracking
+     * @throws {Error} If operation ID is already being tracked
+     */
+    startTimeout(context: TimeoutContext): string;
+    /**
+     * Clears timeout monitoring for an operation.
+     *
+     * @param operationId - Operation ID to clear
+     * @returns True if timeout was cleared, false if not found
+     */
+    clearTimeout(operationId: string): boolean;
+    /**
+     * Gets the remaining time for an operation.
+     *
+     * @param operationId - Operation ID to check
+     * @returns Remaining time in milliseconds, or null if not found
+     */
+    getRemainingTime(operationId: string): number | null;
+    /**
+     * Gets the elapsed time for an operation.
+     *
+     * @param operationId - Operation ID to check
+     * @returns Elapsed time in milliseconds, or null if not found
+     */
+    getElapsedTime(operationId: string): number | null;
+    /**
+     * Checks if an operation is currently being tracked.
+     *
+     * @param operationId - Operation ID to check
+     * @returns True if operation is being tracked
+     */
+    isActive(operationId: string): boolean;
+    /**
+     * Gets all active operation IDs.
+     *
+     * @returns Array of active operation IDs
+     */
+    getActiveOperations(): string[];
+    /**
+     * Creates a timeout context with default values.
+     *
+     * @param operationId - Unique operation identifier
+     * @param timeoutMs - Timeout duration (uses default if not provided)
+     * @param options - Additional context options
+     * @returns Timeout context
+     */
+    createContext(operationId: string, timeoutMs?: number, options?: {
+        onWarning?: (remainingMs: number) => void;
+        onCleanup?: () => Promise<void>;
+    }): TimeoutContext;
+    /**
+     * Gets the current configuration.
+     *
+     * @returns Timeout configuration
+     */
+    getConfig(): TimeoutConfig;
+    /**
+     * Clears all active timeouts.
+     *
+     * @returns Number of timeouts cleared
+     */
+    clearAllTimeouts(): number;
+    /**
+     * Gets timeout statistics for monitoring and optimization.
+     *
+     * @returns Timeout statistics
+     */
+    getTimeoutStats(): {
+        activeOperations: number;
+        totalOperationsStarted: number;
+        averageCompletionTime: number;
+        timeoutRate: number;
+    };
+    /**
+     * Suggests optimal timeout based on historical data.
+     *
+     * @param operationType - Type of operation for historical analysis (reserved for future use)
+     * @returns Suggested timeout in milliseconds
+     */
+    suggestOptimalTimeout(operationType?: string): number;
+    /**
+     * Updates timeout statistics.
+     *
+     * @param operationId - Operation that completed/timed out
+     * @param completed - Whether operation completed successfully
+     * @private
+     */
+    private updateStats;
+    /**
+     * Handles timeout event with cleanup and error throwing.
+     *
+     * @param context - Timeout context
+     * @private
+     */
+    private handleTimeout;
+    /**
+     * Statistics tracking for timeout optimization.
+     * @private
+     */
+    private stats;
+}
+//# sourceMappingURL=TimeoutManager.d.ts.map

package/dist/execution/TimeoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutManager.d.ts","sourceRoot":"","sources":["../../src/execution/TimeoutManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAA;IAExB,wEAAwE;IACxE,uBAAuB,EAAE,MAAM,CAAA;IAE/B,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAA;IAEvB,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IAEnB,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAA;IAEf,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IAEjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IAEzC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAA;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAOlB;IAEb;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAI/C;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IA8B7C;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAkB1C;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAWpD;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASlD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAItC;;;;OAIG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;;;;OAOG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;QACzC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAC3B,GACL,cAAc;IAkBjB;;;;OAIG;IACH,SAAS,IAAI,aAAa;IAI1B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAQ1B;;;;OAIG;IACH,eAAe,IAAI;QACjB,gBAAgB,EAAE,MAAM,CAAA;QACxB,sBAAsB,EAAE,MAAM,CAAA;QAC9B,qBAAqB,EAAE,MAAM,CAAA;QAC7B,WAAW,EAAE,MAAM,CAAA;KACpB;IAaD;;;;;OAKG;IACH,qBAAqB,CAAC,aAAa,SAAY,GAAG,MAAM;IAmBxD;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAenB;;;;;OAKG;YACW,aAAa;IA0C3B;;;OAGG;IACH,OAAO,CAAC,KAAK,CAKZ;CACF"}