agentic-qe 1.8.3 → 1.9.0

package/dist/telemetry/instrumentation/task.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Task Instrumentation - OpenTelemetry spans for task lifecycle
+ *
+ * Provides comprehensive tracing for task orchestration, distribution,
+ * and execution across the agent fleet. Supports parent-child task
+ * relationships and distributed tracing.
+ *
+ * @module telemetry/instrumentation/task
+ */
+import { Span, Context } from '@opentelemetry/api';
+import { QEAttributes } from '../types';
+import { QETask } from '../../types';
+/**
+ * Task span configuration
+ */
+export interface TaskSpanConfig {
+    /** Task to trace */
+    task: QETask;
+    /** Parent span context */
+    parentContext?: Context;
+    /** Additional QE-specific attributes */
+    qeAttributes?: Partial<QEAttributes>;
+}
+/**
+ * Task result metadata
+ */
+export interface TaskResult {
+    /** Execution time in milliseconds */
+    executionTime?: number;
+    /** Tokens used by LLM */
+    tokensUsed?: number;
+    /** Cost in USD */
+    cost?: number;
+    /** Test framework used */
+    framework?: string;
+    /** Coverage percentage */
+    coverage?: number;
+    /** Quality score */
+    qualityScore?: number;
+    /** Additional metrics */
+    metrics?: Record<string, number>;
+}
+/**
+ * Task lifecycle span manager
+ *
+ * Manages OpenTelemetry spans for task orchestration and execution
+ * with support for hierarchical task relationships and distributed tracing.
+ */
+export declare class TaskSpanManager {
+    private readonly tracer;
+    private activeSpans;
+    /**
+     * Start task orchestration span
+     *
+     * Records task distribution and coordination across the fleet.
+     *
+     * @param task - Task being orchestrated
+     * @param fleetId - Fleet identifier
+     * @param agentCount - Number of agents involved
+     * @returns Active span with context
+     */
+    startOrchestrationSpan(task: QETask, fleetId?: string, agentCount?: number): {
+        span: Span;
+        context: Context;
+    };
+    /**
+     * Complete task orchestration span
+     *
+     * @param taskId - Task identifier
+     * @param success - Whether orchestration was successful
+     * @param agentsAssigned - Number of agents assigned
+     * @param error - Error if orchestration failed
+     */
+    completeOrchestrationSpan(taskId: string, success: boolean, agentsAssigned?: number, error?: Error): void;
+    /**
+     * Start task execution span
+     *
+     * Records task execution with semantic attributes for task type,
+     * priority, and QE-specific metadata.
+     *
+     * @param config - Task span configuration
+     * @returns Active span with context
+     */
+    startExecutionSpan(config: TaskSpanConfig): {
+        span: Span;
+        context: Context;
+    };
+    /**
+     * Complete task execution span
+     *
+     * @param taskId - Task identifier
+     * @param success - Whether execution was successful
+     * @param result - Task execution result
+     * @param error - Error if execution failed
+     */
+    completeExecutionSpan(taskId: string, success: boolean, result?: TaskResult, error?: Error): void;
+    /**
+     * Record task status change
+     *
+     * @param taskId - Task identifier
+     * @param oldStatus - Previous status
+     * @param newStatus - New status
+     */
+    recordStatusChange(taskId: string, oldStatus: string, newStatus: string): void;
+    /**
+     * Record task retry
+     *
+     * @param taskId - Task identifier
+     * @param attempt - Retry attempt number
+     * @param reason - Reason for retry
+     */
+    recordRetry(taskId: string, attempt: number, reason?: string): void;
+    /**
+     * Record task cancellation
+     *
+     * @param taskId - Task identifier
+     * @param reason - Cancellation reason
+     */
+    recordCancellation(taskId: string, reason?: string): void;
+    /**
+     * Cleanup all active spans
+     */
+    cleanup(): void;
+    /**
+     * Build task semantic attributes
+     */
+    private buildTaskAttributes;
+    /**
+     * Get appropriate span name for task type
+     */
+    private getSpanNameForTaskType;
+}
+/**
+ * Global task span manager instance
+ */
+export declare const taskSpanManager: TaskSpanManager;
+/**
+ * Execute function within task span context
+ *
+ * @param task - Task being executed
+ * @param fn - Function to execute
+ * @param qeAttributes - QE-specific attributes
+ * @returns Function result
+ */
+export declare function withTaskSpan<T>(task: QETask, fn: (context: Context) => Promise<T>, qeAttributes?: Partial<QEAttributes>): Promise<T>;
+//# sourceMappingURL=task.d.ts.map

package/dist/telemetry/instrumentation/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/telemetry/instrumentation/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAkC,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAA8B,YAAY,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,WAAW,CAA2B;IAE9C;;;;;;;;;OASG;IACH,sBAAsB,CACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAoBnC;;;;;;;OAOG;IACH,yBAAyB,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,KAAK,CAAC,EAAE,KAAK,GACZ,IAAI;IA8BP;;;;;;;;OAQG;IACH,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IA0B5E;;;;;;;OAOG;IACH,qBAAqB,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,UAAU,EACnB,KAAK,CAAC,EAAE,KAAK,GACZ,IAAI;IAyDP;;;;;;OAMG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI;IAWP;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAWnE;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBzD;;OAEG;IACH,OAAO,IAAI,IAAI;IAYf;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAW/B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/telemetry/instrumentation/task.js

@@ -0,0 +1,305 @@
+"use strict";
+/**
+ * Task Instrumentation - OpenTelemetry spans for task lifecycle
+ *
+ * Provides comprehensive tracing for task orchestration, distribution,
+ * and execution across the agent fleet. Supports parent-child task
+ * relationships and distributed tracing.
+ *
+ * @module telemetry/instrumentation/task
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskSpanManager = exports.TaskSpanManager = void 0;
+exports.withTaskSpan = withTaskSpan;
+const api_1 = require("@opentelemetry/api");
+const bootstrap_1 = require("../bootstrap");
+const types_1 = require("../types");
+/**
+ * Task lifecycle span manager
+ *
+ * Manages OpenTelemetry spans for task orchestration and execution
+ * with support for hierarchical task relationships and distributed tracing.
+ */
+class TaskSpanManager {
+    constructor() {
+        this.tracer = (0, bootstrap_1.getTracer)();
+        this.activeSpans = new Map();
+    }
+    /**
+     * Start task orchestration span
+     *
+     * Records task distribution and coordination across the fleet.
+     *
+     * @param task - Task being orchestrated
+     * @param fleetId - Fleet identifier
+     * @param agentCount - Number of agents involved
+     * @returns Active span with context
+     */
+    startOrchestrationSpan(task, fleetId, agentCount) {
+        const span = this.tracer.startSpan(types_1.SPAN_NAMES.FLEET_DISTRIBUTE_TASK, {
+            attributes: {
+                ...this.buildTaskAttributes(task),
+                ...(fleetId && { 'fleet.id': fleetId }),
+                ...(agentCount && { 'fleet.agent_count': agentCount }),
+            },
+        });
+        this.activeSpans.set(`orchestrate:${task.id}`, span);
+        span.addEvent('task.orchestration.started', {
+            'task.id': task.id,
+            'task.type': task.type,
+        });
+        const spanContext = api_1.trace.setSpan(api_1.context.active(), span);
+        return { span, context: spanContext };
+    }
+    /**
+     * Complete task orchestration span
+     *
+     * @param taskId - Task identifier
+     * @param success - Whether orchestration was successful
+     * @param agentsAssigned - Number of agents assigned
+     * @param error - Error if orchestration failed
+     */
+    completeOrchestrationSpan(taskId, success, agentsAssigned, error) {
+        const span = this.activeSpans.get(`orchestrate:${taskId}`);
+        if (!span) {
+            console.warn(`[TaskSpanManager] No orchestration span found for task ${taskId}`);
+            return;
+        }
+        if (agentsAssigned !== undefined) {
+            span.setAttribute('task.agents_assigned', agentsAssigned);
+        }
+        if (success) {
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            span.addEvent('task.orchestration.completed', {
+                'task.id': taskId,
+            });
+        }
+        else {
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error?.message || 'Task orchestration failed',
+            });
+            if (error) {
+                span.recordException(error);
+            }
+        }
+        span.end();
+        this.activeSpans.delete(`orchestrate:${taskId}`);
+    }
+    /**
+     * Start task execution span
+     *
+     * Records task execution with semantic attributes for task type,
+     * priority, and QE-specific metadata.
+     *
+     * @param config - Task span configuration
+     * @returns Active span with context
+     */
+    startExecutionSpan(config) {
+        const { task, parentContext, qeAttributes } = config;
+        const spanContext = parentContext || api_1.context.active();
+        const span = this.tracer.startSpan(this.getSpanNameForTaskType(task.type), {
+            attributes: {
+                ...this.buildTaskAttributes(task),
+                ...qeAttributes,
+            },
+        }, spanContext);
+        this.activeSpans.set(`execute:${task.id}`, span);
+        span.addEvent('task.execution.started', {
+            'task.id': task.id,
+            'task.type': task.type,
+        });
+        const execContext = api_1.trace.setSpan(api_1.context.active(), span);
+        return { span, context: execContext };
+    }
+    /**
+     * Complete task execution span
+     *
+     * @param taskId - Task identifier
+     * @param success - Whether execution was successful
+     * @param result - Task execution result
+     * @param error - Error if execution failed
+     */
+    completeExecutionSpan(taskId, success, result, error) {
+        const span = this.activeSpans.get(`execute:${taskId}`);
+        if (!span) {
+            console.warn(`[TaskSpanManager] No execution span found for task ${taskId}`);
+            return;
+        }
+        // Add result metrics
+        if (result) {
+            if (result.executionTime !== undefined) {
+                span.setAttribute('task.execution_time_ms', result.executionTime);
+            }
+            if (result.tokensUsed !== undefined) {
+                span.setAttribute('task.tokens_used', result.tokensUsed);
+            }
+            if (result.cost !== undefined) {
+                span.setAttribute('task.cost_usd', result.cost);
+            }
+            if (result.framework) {
+                span.setAttribute('qe.test_framework', result.framework);
+            }
+            if (result.coverage !== undefined) {
+                span.setAttribute('qe.coverage_percent', result.coverage);
+            }
+            if (result.qualityScore !== undefined) {
+                span.setAttribute('qe.quality_score', result.qualityScore);
+            }
+            if (result.metrics) {
+                for (const [key, value] of Object.entries(result.metrics)) {
+                    span.setAttribute(`task.metric.${key}`, value);
+                }
+            }
+        }
+        if (success) {
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            span.addEvent('task.execution.completed', {
+                'task.id': taskId,
+            });
+        }
+        else {
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error?.message || 'Task execution failed',
+            });
+            if (error) {
+                span.recordException(error);
+            }
+            span.addEvent('task.execution.failed', {
+                'task.id': taskId,
+                'error.message': error?.message || 'Unknown error',
+            });
+        }
+        span.end();
+        this.activeSpans.delete(`execute:${taskId}`);
+    }
+    /**
+     * Record task status change
+     *
+     * @param taskId - Task identifier
+     * @param oldStatus - Previous status
+     * @param newStatus - New status
+     */
+    recordStatusChange(taskId, oldStatus, newStatus) {
+        const span = api_1.trace.getActiveSpan();
+        if (span) {
+            span.addEvent('task.status.changed', {
+                'task.id': taskId,
+                'task.status.old': oldStatus,
+                'task.status.new': newStatus,
+            });
+        }
+    }
+    /**
+     * Record task retry
+     *
+     * @param taskId - Task identifier
+     * @param attempt - Retry attempt number
+     * @param reason - Reason for retry
+     */
+    recordRetry(taskId, attempt, reason) {
+        const span = api_1.trace.getActiveSpan();
+        if (span) {
+            span.addEvent('task.retry', {
+                'task.id': taskId,
+                'task.retry.attempt': attempt,
+                ...(reason && { 'task.retry.reason': reason }),
+            });
+        }
+    }
+    /**
+     * Record task cancellation
+     *
+     * @param taskId - Task identifier
+     * @param reason - Cancellation reason
+     */
+    recordCancellation(taskId, reason) {
+        const span = this.activeSpans.get(`execute:${taskId}`);
+        if (span) {
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: reason || 'Task cancelled',
+            });
+            span.addEvent('task.cancelled', {
+                'task.id': taskId,
+                ...(reason && { 'task.cancellation.reason': reason }),
+            });
+            span.end();
+            this.activeSpans.delete(`execute:${taskId}`);
+        }
+    }
+    /**
+     * Cleanup all active spans
+     */
+    cleanup() {
+        for (const [key, span] of this.activeSpans.entries()) {
+            console.warn(`[TaskSpanManager] Force-ending orphaned span: ${key}`);
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: 'Span ended during cleanup',
+            });
+            span.end();
+        }
+        this.activeSpans.clear();
+    }
+    /**
+     * Build task semantic attributes
+     */
+    buildTaskAttributes(task) {
+        return {
+            'task.id': task.id,
+            'task.type': task.type,
+            'task.status': task.status,
+            'task.priority': task.priority,
+            'task.parent_id': task.parentId || '',
+        };
+    }
+    /**
+     * Get appropriate span name for task type
+     */
+    getSpanNameForTaskType(taskType) {
+        const spanMap = {
+            'unit-test': types_1.SPAN_NAMES.AGENT_GENERATE_TESTS,
+            'integration-test': types_1.SPAN_NAMES.AGENT_GENERATE_TESTS,
+            'coverage-analysis': types_1.SPAN_NAMES.AGENT_ANALYZE_COVERAGE,
+            'quality-gate': types_1.SPAN_NAMES.AGENT_VALIDATE_QUALITY,
+            'security-scan': types_1.SPAN_NAMES.AGENT_SCAN_SECURITY,
+        };
+        return spanMap[taskType] || types_1.SPAN_NAMES.AGENT_EXECUTE_TASK;
+    }
+}
+exports.TaskSpanManager = TaskSpanManager;
+/**
+ * Global task span manager instance
+ */
+exports.taskSpanManager = new TaskSpanManager();
+/**
+ * Execute function within task span context
+ *
+ * @param task - Task being executed
+ * @param fn - Function to execute
+ * @param qeAttributes - QE-specific attributes
+ * @returns Function result
+ */
+async function withTaskSpan(task, fn, qeAttributes) {
+    const { span, context: spanContext } = exports.taskSpanManager.startExecutionSpan({
+        task,
+        qeAttributes,
+    });
+    const startTime = Date.now();
+    try {
+        const result = await fn(spanContext);
+        const executionTime = Date.now() - startTime;
+        exports.taskSpanManager.completeExecutionSpan(task.id, true, {
+            executionTime,
+        });
+        return result;
+    }
+    catch (error) {
+        const executionTime = Date.now() - startTime;
+        exports.taskSpanManager.completeExecutionSpan(task.id, false, { executionTime }, error);
+        throw error;
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/telemetry/instrumentation/task.js.map

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

package/dist/telemetry/metrics/agent-metrics.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Agent Performance Metrics for Agentic QE Fleet
+ *
+ * Metrics for tracking agent task execution, performance, and resource usage.
+ */
+import { Meter, Counter, Histogram, UpDownCounter, Attributes } from '@opentelemetry/api';
+import { MetricRecordOptions } from '../types';
+/**
+ * Agent metrics registry
+ */
+export interface AgentMetrics {
+    /** Total number of tasks executed by agents */
+    taskCount: Counter;
+    /** Distribution of task durations in milliseconds */
+    taskDuration: Histogram;
+    /** Number of successful tasks */
+    successCount: Counter;
+    /** Number of failed tasks */
+    errorCount: Counter;
+    /** Total tokens consumed by agents */
+    tokenUsage: Counter;
+    /** Total cost incurred by agents */
+    costTotal: Counter;
+    /** Number of currently active agents */
+    activeAgents: UpDownCounter;
+}
+/**
+ * Initialize agent metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns Agent metrics registry
+ */
+export declare function createAgentMetrics(meter?: Meter): AgentMetrics;
+/**
+ * Get initialized agent metrics
+ *
+ * @returns Agent metrics registry
+ */
+export declare function getAgentMetrics(): AgentMetrics;
+/**
+ * Record a completed agent task
+ *
+ * @param agentType - Type of agent (e.g., test-generator, coverage-analyzer)
+ * @param taskType - Type of task executed
+ * @param durationMs - Task duration in milliseconds
+ * @param success - Whether the task succeeded
+ * @param options - Additional recording options
+ */
+export declare function recordAgentTask(agentType: string, taskType: string, durationMs: number, success: boolean, options?: {
+    agentId?: string;
+    taskId?: string;
+    priority?: string;
+    tokensUsed?: number;
+    cost?: number;
+}): void;
+/**
+ * Record agent spawn/despawn
+ *
+ * @param agentType - Type of agent
+ * @param delta - Change in agent count (+1 for spawn, -1 for despawn)
+ * @param attributes - Additional attributes
+ */
+export declare function recordAgentCount(agentType: string, delta: number, attributes?: Attributes): void;
+/**
+ * Record model routing decision
+ */
+export interface ModelRoutingRecord {
+    /** Model provider (anthropic, openai, etc.) */
+    provider: string;
+    /** Model name/ID */
+    model: string;
+    /** Model tier (fast, balanced, quality) */
+    tier: string;
+    /** Task complexity score */
+    complexity: number;
+    /** Routing latency in ms */
+    routingLatencyMs: number;
+    /** Tokens used for routing */
+    tokensUsed?: number;
+    /** Cost of the routed call */
+    cost?: number;
+}
+/**
+ * Create model routing metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns Model routing metrics
+ */
+export declare function createModelRoutingMetrics(meter?: Meter): {
+    routingCount: Counter<Attributes>;
+    routingLatency: Histogram<Attributes>;
+    modelInvocationCount: Counter<Attributes>;
+    modelTokensInput: Counter<Attributes>;
+    modelTokensOutput: Counter<Attributes>;
+    modelCost: Counter<Attributes>;
+    modelLatency: Histogram<Attributes>;
+};
+/**
+ * Learning and pattern metrics for agents
+ */
+export declare function createLearningMetrics(meter?: Meter): {
+    patternMatchCount: Counter<Attributes>;
+    patternMatchScore: Histogram<Attributes>;
+    learningEpisodeCount: Counter<Attributes>;
+    rewardScore: Histogram<Attributes>;
+    experienceBufferSize: UpDownCounter<Attributes>;
+};
+export type { MetricRecordOptions };
+//# sourceMappingURL=agent-metrics.d.ts.map

package/dist/telemetry/metrics/agent-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-metrics.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics/agent-metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1F,OAAO,EAAsC,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,YAAY,EAAE,SAAS,CAAC;IACxB,iCAAiC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,6BAA6B;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,YAAY,EAAE,aAAa,CAAC;CAC7B;AAKD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,YAAY,CAgD9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,IAAI,CAyCN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,UAAU,GACtB,IAAI,CAON;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,KAAK;;;;;;;;EA6CtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,KAAK;;;;;;EAmClD;AAGD,YAAY,EAAE,mBAAmB,EAAE,CAAC"}