@specforge/mcp 2.6.0 → 3.0.0

package/dist/ai-provider/logger.d.ts

@@ -0,0 +1,69 @@
+/**
+ * AI Provider Logger
+ *
+ * Structured JSON logging with request ID support.
+ */
+import type { LogLevel } from './types.js';
+export declare class Logger {
+    private component;
+    private static globalRequestId?;
+    private static logLevel;
+    constructor(component: string);
+    /**
+     * Set global request ID for correlation
+     */
+    static setRequestId(requestId: string): void;
+    /**
+     * Clear global request ID
+     */
+    static clearRequestId(): void;
+    /**
+     * Get current request ID
+     */
+    static getRequestId(): string | undefined;
+    /**
+     * Set minimum log level
+     */
+    static setLogLevel(level: LogLevel): void;
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Log debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error message
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error with Error object
+     */
+    errorWithException(message: string, error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with additional context
+     */
+    child(subComponent: string): Logger;
+    /**
+     * Core logging method
+     */
+    private log;
+    /**
+     * Sanitize context to prevent PII logging
+     */
+    private sanitizeContext;
+}
+/**
+ * Create a logger for a specific component
+ */
+export declare function createLogger(component: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/ai-provider/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/ai-provider/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AAMrD,qBAAa,MAAM;IAIL,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAS;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;gBAEvB,SAAS,EAAE,MAAM;IAErC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;IAI7B;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIzC;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW1F;;OAEG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,OAAO,CAAC,GAAG;IAiCX;;OAEG;IACH,OAAO,CAAC,eAAe;CAyBxB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/ai-provider/logger.js

@@ -0,0 +1,161 @@
+/**
+ * AI Provider Logger
+ *
+ * Structured JSON logging with request ID support.
+ */
+// ============================================================================
+// Logger Class
+// ============================================================================
+export class Logger {
+    component;
+    static globalRequestId;
+    static logLevel = 'info';
+    constructor(component) {
+        this.component = component;
+    }
+    /**
+     * Set global request ID for correlation
+     */
+    static setRequestId(requestId) {
+        Logger.globalRequestId = requestId;
+    }
+    /**
+     * Clear global request ID
+     */
+    static clearRequestId() {
+        Logger.globalRequestId = undefined;
+    }
+    /**
+     * Get current request ID
+     */
+    static getRequestId() {
+        return Logger.globalRequestId;
+    }
+    /**
+     * Set minimum log level
+     */
+    static setLogLevel(level) {
+        Logger.logLevel = level;
+    }
+    /**
+     * Check if a log level should be output
+     */
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        const currentIndex = levels.indexOf(Logger.logLevel);
+        const messageIndex = levels.indexOf(level);
+        return messageIndex >= currentIndex;
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    /**
+     * Log error message
+     */
+    error(message, context) {
+        this.log('error', message, context);
+    }
+    /**
+     * Log error with Error object
+     */
+    errorWithException(message, error, context) {
+        this.log('error', message, {
+            ...context,
+            error: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            },
+        });
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(subComponent) {
+        return new Logger(`${this.component}:${subComponent}`);
+    }
+    /**
+     * Core logging method
+     */
+    log(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            component: this.component,
+            message,
+            context: this.sanitizeContext(context),
+            requestId: Logger.globalRequestId,
+        };
+        // Structured JSON logging
+        const output = JSON.stringify(entry);
+        switch (level) {
+            case 'debug':
+                console.debug(output);
+                break;
+            case 'info':
+                console.info(output);
+                break;
+            case 'warn':
+                console.warn(output);
+                break;
+            case 'error':
+                console.error(output);
+                break;
+        }
+    }
+    /**
+     * Sanitize context to prevent PII logging
+     */
+    sanitizeContext(context) {
+        if (!context) {
+            return undefined;
+        }
+        const sanitized = {};
+        const sensitiveKeys = ['password', 'token', 'apiKey', 'secret', 'credential', 'auth'];
+        for (const [key, value] of Object.entries(context)) {
+            const lowerKey = key.toLowerCase();
+            const isSensitive = sensitiveKeys.some(sk => lowerKey.includes(sk));
+            if (isSensitive) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (typeof value === 'string' && value.length > 1000) {
+                sanitized[key] = value.substring(0, 1000) + '...[TRUNCATED]';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitized[key] = this.sanitizeContext(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a logger for a specific component
+ */
+export function createLogger(component) {
+    return new Logger(component);
+}
+//# sourceMappingURL=logger.js.map

package/dist/ai-provider/logger.js.map

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

package/dist/ai-provider/metrics.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Metrics Collection
+ *
+ * Counters and histograms for observability.
+ */
+import type { MetricStats } from './types.js';
+export declare class Metrics {
+    private counters;
+    private histograms;
+    private gauges;
+    /**
+     * Increment a counter.
+     */
+    increment(name: string, value?: number): void;
+    /**
+     * Decrement a counter.
+     */
+    decrement(name: string, value?: number): void;
+    /**
+     * Record a value in a histogram.
+     */
+    histogram(name: string, value: number): void;
+    /**
+     * Set a gauge value.
+     */
+    gauge(name: string, value: number): void;
+    /**
+     * Get a counter value.
+     */
+    getCounter(name: string): number;
+    /**
+     * Get a gauge value.
+     */
+    getGauge(name: string): number;
+    /**
+     * Get histogram statistics.
+     */
+    getHistogramStats(name: string): MetricStats | null;
+    /**
+     * Get all metrics.
+     */
+    getAll(): {
+        counters: Record<string, number>;
+        gauges: Record<string, number>;
+        histograms: Record<string, MetricStats | null>;
+    };
+    /**
+     * Reset all metrics.
+     */
+    reset(): void;
+    /**
+     * Reset a specific metric.
+     */
+    resetMetric(name: string): void;
+    /**
+     * Export metrics as Prometheus-style text.
+     */
+    toPrometheus(): string;
+    /**
+     * Calculate percentile from sorted array.
+     */
+    private percentile;
+}
+/**
+ * Get or create global metrics instance.
+ */
+export declare function getMetrics(): Metrics;
+/**
+ * Create a new metrics instance.
+ */
+export declare function createMetrics(): Metrics;
+export declare const METRIC_NAMES: {
+    readonly REQUESTS_STARTED: "requests.started";
+    readonly REQUESTS_SUCCESS: "requests.success";
+    readonly REQUESTS_FAILURE: "requests.failure";
+    readonly REQUESTS_TIMEOUT: "requests.timeout";
+    readonly REQUESTS_CIRCUIT_BLOCKED: "requests.circuit_breaker_blocked";
+    readonly REQUEST_DURATION_MS: "requests.duration_ms";
+    readonly SPAWN_DURATION_MS: "spawn.duration_ms";
+    readonly PROCESSES_ACTIVE: "processes.active";
+    readonly PROCESSES_SPAWNED: "processes.spawned";
+    readonly PROCESSES_KILLED: "processes.killed";
+    readonly ERRORS_AUTH: "errors.auth";
+    readonly ERRORS_RATE_LIMIT: "errors.rate_limit";
+    readonly ERRORS_TIMEOUT: "errors.timeout";
+    readonly ERRORS_NETWORK: "errors.network";
+    readonly ERRORS_UNKNOWN: "errors.unknown";
+    readonly RETRIES_ATTEMPTED: "retries.attempted";
+    readonly RETRIES_SUCCESS: "retries.success";
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/ai-provider/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/ai-provider/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAkC;IAEhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAKhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAKhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAkBnD;;OAEG;IACH,MAAM,IAAI;QACR,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC;KAChD;IAaD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,YAAY,IAAI,MAAM;IAsCtB;;OAEG;IACH,OAAO,CAAC,UAAU;CAInB;AAOD;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAGD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CA2Bf,CAAC"}

package/dist/ai-provider/metrics.js

@@ -0,0 +1,187 @@
+/**
+ * Metrics Collection
+ *
+ * Counters and histograms for observability.
+ */
+export class Metrics {
+    counters = new Map();
+    histograms = new Map();
+    gauges = new Map();
+    /**
+     * Increment a counter.
+     */
+    increment(name, value = 1) {
+        const current = this.counters.get(name) || 0;
+        this.counters.set(name, current + value);
+    }
+    /**
+     * Decrement a counter.
+     */
+    decrement(name, value = 1) {
+        const current = this.counters.get(name) || 0;
+        this.counters.set(name, Math.max(0, current - value));
+    }
+    /**
+     * Record a value in a histogram.
+     */
+    histogram(name, value) {
+        const values = this.histograms.get(name) || [];
+        values.push(value);
+        this.histograms.set(name, values);
+    }
+    /**
+     * Set a gauge value.
+     */
+    gauge(name, value) {
+        this.gauges.set(name, value);
+    }
+    /**
+     * Get a counter value.
+     */
+    getCounter(name) {
+        return this.counters.get(name) || 0;
+    }
+    /**
+     * Get a gauge value.
+     */
+    getGauge(name) {
+        return this.gauges.get(name) || 0;
+    }
+    /**
+     * Get histogram statistics.
+     */
+    getHistogramStats(name) {
+        const values = this.histograms.get(name);
+        if (!values || values.length === 0)
+            return null;
+        const sorted = [...values].sort((a, b) => a - b);
+        const count = sorted.length;
+        return {
+            count,
+            min: sorted[0],
+            max: sorted[count - 1],
+            avg: sorted.reduce((a, b) => a + b, 0) / count,
+            p50: this.percentile(sorted, 0.5),
+            p95: this.percentile(sorted, 0.95),
+            p99: this.percentile(sorted, 0.99),
+        };
+    }
+    /**
+     * Get all metrics.
+     */
+    getAll() {
+        const histograms = {};
+        for (const name of this.histograms.keys()) {
+            histograms[name] = this.getHistogramStats(name);
+        }
+        return {
+            counters: Object.fromEntries(this.counters),
+            gauges: Object.fromEntries(this.gauges),
+            histograms,
+        };
+    }
+    /**
+     * Reset all metrics.
+     */
+    reset() {
+        this.counters.clear();
+        this.histograms.clear();
+        this.gauges.clear();
+    }
+    /**
+     * Reset a specific metric.
+     */
+    resetMetric(name) {
+        this.counters.delete(name);
+        this.histograms.delete(name);
+        this.gauges.delete(name);
+    }
+    /**
+     * Export metrics as Prometheus-style text.
+     */
+    toPrometheus() {
+        const lines = [];
+        // Counters
+        for (const [name, value] of this.counters) {
+            const safeName = name.replace(/\./g, '_');
+            lines.push(`# TYPE ${safeName} counter`);
+            lines.push(`${safeName} ${value}`);
+        }
+        // Gauges
+        for (const [name, value] of this.gauges) {
+            const safeName = name.replace(/\./g, '_');
+            lines.push(`# TYPE ${safeName} gauge`);
+            lines.push(`${safeName} ${value}`);
+        }
+        // Histograms
+        for (const [name, values] of this.histograms) {
+            if (values.length === 0)
+                continue;
+            const safeName = name.replace(/\./g, '_');
+            const stats = this.getHistogramStats(name);
+            if (!stats)
+                continue;
+            lines.push(`# TYPE ${safeName} histogram`);
+            lines.push(`${safeName}_count ${stats.count}`);
+            lines.push(`${safeName}_sum ${values.reduce((a, b) => a + b, 0)}`);
+            lines.push(`${safeName}_min ${stats.min}`);
+            lines.push(`${safeName}_max ${stats.max}`);
+            lines.push(`${safeName}{quantile="0.5"} ${stats.p50}`);
+            lines.push(`${safeName}{quantile="0.95"} ${stats.p95}`);
+            lines.push(`${safeName}{quantile="0.99"} ${stats.p99}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Calculate percentile from sorted array.
+     */
+    percentile(sorted, p) {
+        const index = Math.ceil(sorted.length * p) - 1;
+        return sorted[Math.max(0, Math.min(index, sorted.length - 1))];
+    }
+}
+/**
+ * Global metrics instance.
+ */
+let globalMetrics = null;
+/**
+ * Get or create global metrics instance.
+ */
+export function getMetrics() {
+    if (!globalMetrics) {
+        globalMetrics = new Metrics();
+    }
+    return globalMetrics;
+}
+/**
+ * Create a new metrics instance.
+ */
+export function createMetrics() {
+    return new Metrics();
+}
+// Metric name constants for consistency
+export const METRIC_NAMES = {
+    // Request metrics
+    REQUESTS_STARTED: 'requests.started',
+    REQUESTS_SUCCESS: 'requests.success',
+    REQUESTS_FAILURE: 'requests.failure',
+    REQUESTS_TIMEOUT: 'requests.timeout',
+    REQUESTS_CIRCUIT_BLOCKED: 'requests.circuit_breaker_blocked',
+    // Duration metrics
+    REQUEST_DURATION_MS: 'requests.duration_ms',
+    SPAWN_DURATION_MS: 'spawn.duration_ms',
+    // Process metrics
+    PROCESSES_ACTIVE: 'processes.active',
+    PROCESSES_SPAWNED: 'processes.spawned',
+    PROCESSES_KILLED: 'processes.killed',
+    // Error metrics
+    ERRORS_AUTH: 'errors.auth',
+    ERRORS_RATE_LIMIT: 'errors.rate_limit',
+    ERRORS_TIMEOUT: 'errors.timeout',
+    ERRORS_NETWORK: 'errors.network',
+    ERRORS_UNKNOWN: 'errors.unknown',
+    // Retry metrics
+    RETRIES_ATTEMPTED: 'retries.attempted',
+    RETRIES_SUCCESS: 'retries.success',
+};
+//# sourceMappingURL=metrics.js.map

package/dist/ai-provider/metrics.js.map

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

package/dist/ai-provider/process-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Claude Code Process Manager
+ *
+ * Core module for spawning and managing Claude CLI processes.
+ */
+import type { ProcessManagerConfig, ProcessResult, ProcessStatus } from './types.js';
+/**
+ * Claude CLI Process Manager.
+ */
+export declare class ClaudeCodeProcessManager {
+    private config;
+    private semaphore;
+    private circuitBreaker;
+    private retryExecutor;
+    private activeProcesses;
+    private isRateLimited;
+    private rateLimitMessage?;
+    private metrics;
+    private tracer;
+    private isShuttingDown;
+    constructor(config: ProcessManagerConfig);
+    /**
+     * Check if user is authenticated with Claude Code.
+     */
+    checkAuth(): Promise<{
+        authenticated: boolean;
+        error?: string;
+        cliVersion?: string;
+    }>;
+    /**
+     * Run a prompt using Claude Code CLI.
+     */
+    run(prompt: string, options?: {
+        workingDirectory?: string;
+        timeout?: number;
+        model?: 'sonnet' | 'opus';
+        sessionId?: string;
+    }): Promise<ProcessResult>;
+    /**
+     * Execute prompt with CLI.
+     */
+    private executePrompt;
+    /**
+     * Spawn a Claude CLI process.
+     */
+    private spawn;
+    /**
+     * Detect rate limit errors from CLI output.
+     */
+    private isRateLimitError;
+    /**
+     * Detect auth errors from CLI output.
+     */
+    private isAuthError;
+    /**
+     * Check if error is retryable.
+     */
+    private isRetryable;
+    /**
+     * Categorize error type.
+     */
+    private categorizeError;
+    /**
+     * Get current status.
+     */
+    getStatus(): ProcessStatus;
+    /**
+     * Reset rate limit flag (after user switches accounts).
+     */
+    resetRateLimitFlag(): void;
+    /**
+     * Get metrics.
+     */
+    getMetrics(): {
+        counters: Record<string, number>;
+        gauges: Record<string, number>;
+        histograms: Record<string, import("./types.js").MetricStats | null>;
+    };
+    /**
+     * Graceful shutdown.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Health check.
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        details: Record<string, unknown>;
+    }>;
+}
+/**
+ * Create a process manager with configuration.
+ */
+export declare function createProcessManager(config: Partial<ProcessManagerConfig> & {
+    workingDirectory: string;
+}): ClaudeCodeProcessManager;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/ai-provider/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/ai-provider/process-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,aAAa,EAEd,MAAM,YAAY,CAAC;AAoCpB;;GAEG;AACH,qBAAa,wBAAwB;IAWvB,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAkB;gBAEpB,MAAM,EAAE,oBAAoB;IAchD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IA0CF;;OAEG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACvG,OAAO,CAAC,aAAa,CAAC;IAgFzB;;OAEG;YACW,aAAa;IAyE3B;;OAEG;YACW,KAAK;IA2HnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,SAAS,IAAI,aAAa;IAS1B;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;OAEG;IACH,UAAU;;;;;IAIV;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CAkBH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACnE,wBAAwB,CAS1B"}