driftdetect-mcp 0.4.0 → 0.4.3

package/dist/infrastructure/metrics.js.map

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

package/dist/infrastructure/rate-limiter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Rate Limiter
+ *
+ * Sliding window rate limiting to prevent abuse.
+ * Configurable per-tool and global limits.
+ */
+export interface RateLimitConfig {
+    globalMaxRequests: number;
+    globalWindowMs: number;
+    toolLimits?: Record<string, {
+        maxRequests: number;
+        windowMs: number;
+    }>;
+    expensiveTools?: string[];
+    expensiveMaxRequests?: number;
+    expensiveWindowMs?: number;
+}
+export declare class RateLimiter {
+    private windows;
+    private config;
+    constructor(config?: Partial<RateLimitConfig>);
+    /**
+     * Check if request is allowed
+     * @throws DriftError if rate limited
+     */
+    checkLimit(tool: string, identifier?: string): void;
+    /**
+     * Get remaining requests for a limit
+     */
+    getRemainingRequests(tool: string, identifier?: string): {
+        global: number;
+        tool?: number;
+        expensive?: number;
+    };
+    /**
+     * Record a request (call after successful processing)
+     */
+    recordRequest(tool: string, identifier?: string): void;
+    /**
+     * Clear all rate limit windows
+     */
+    clear(): void;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        activeWindows: number;
+        totalRequests: number;
+    };
+    private checkWindowLimit;
+    private getRemaining;
+    private addToWindow;
+    private getOrCreateWindow;
+}
+/**
+ * Singleton instance for convenience
+ */
+export declare const rateLimiter: RateLimiter;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/infrastructure/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,eAAe;IAE9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IAGvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IAGH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAmBD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAIjD;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAkB,GAAG,IAAI;IAiC9D;;OAEG;IACH,oBAAoB,CAClB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAkB,GAC7B;QACD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAsCD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAkB,GAAG,IAAI;IAcjE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB;IAcD,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,iBAAiB;CAQ1B;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/infrastructure/rate-limiter.js

@@ -0,0 +1,132 @@
+/**
+ * Rate Limiter
+ *
+ * Sliding window rate limiting to prevent abuse.
+ * Configurable per-tool and global limits.
+ */
+import { Errors } from './error-handler.js';
+const DEFAULT_CONFIG = {
+    globalMaxRequests: 100,
+    globalWindowMs: 60000, // 1 minute
+    expensiveTools: [
+        'drift_callgraph',
+        'drift_code_examples',
+        'drift_impact_analysis',
+        'drift_security_summary',
+    ],
+    expensiveMaxRequests: 10,
+    expensiveWindowMs: 60000,
+};
+export class RateLimiter {
+    windows = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Check if request is allowed
+     * @throws DriftError if rate limited
+     */
+    checkLimit(tool, identifier = 'default') {
+        const now = Date.now();
+        // Check global limit
+        this.checkWindowLimit(`global:${identifier}`, this.config.globalMaxRequests, this.config.globalWindowMs, now);
+        // Check tool-specific limit
+        const toolLimit = this.config.toolLimits?.[tool];
+        if (toolLimit) {
+            this.checkWindowLimit(`tool:${tool}:${identifier}`, toolLimit.maxRequests, toolLimit.windowMs, now);
+        }
+        // Check expensive tool limit
+        if (this.config.expensiveTools?.includes(tool)) {
+            this.checkWindowLimit(`expensive:${identifier}`, this.config.expensiveMaxRequests ?? 10, this.config.expensiveWindowMs ?? 60000, now);
+        }
+    }
+    /**
+     * Get remaining requests for a limit
+     */
+    getRemainingRequests(tool, identifier = 'default') {
+        const now = Date.now();
+        const result = {
+            global: this.getRemaining(`global:${identifier}`, this.config.globalMaxRequests, this.config.globalWindowMs, now),
+        };
+        const toolLimit = this.config.toolLimits?.[tool];
+        if (toolLimit) {
+            result.tool = this.getRemaining(`tool:${tool}:${identifier}`, toolLimit.maxRequests, toolLimit.windowMs, now);
+        }
+        if (this.config.expensiveTools?.includes(tool)) {
+            result.expensive = this.getRemaining(`expensive:${identifier}`, this.config.expensiveMaxRequests ?? 10, this.config.expensiveWindowMs ?? 60000, now);
+        }
+        return result;
+    }
+    /**
+     * Record a request (call after successful processing)
+     */
+    recordRequest(tool, identifier = 'default') {
+        const now = Date.now();
+        this.addToWindow(`global:${identifier}`, now);
+        if (this.config.toolLimits?.[tool]) {
+            this.addToWindow(`tool:${tool}:${identifier}`, now);
+        }
+        if (this.config.expensiveTools?.includes(tool)) {
+            this.addToWindow(`expensive:${identifier}`, now);
+        }
+    }
+    /**
+     * Clear all rate limit windows
+     */
+    clear() {
+        this.windows.clear();
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        let totalRequests = 0;
+        for (const window of this.windows.values()) {
+            totalRequests += window.requests.length;
+        }
+        return {
+            activeWindows: this.windows.size,
+            totalRequests,
+        };
+    }
+    // Private methods
+    checkWindowLimit(key, maxRequests, windowMs, now) {
+        const window = this.getOrCreateWindow(key);
+        const windowStart = now - windowMs;
+        // Clean old requests
+        window.requests = window.requests.filter(t => t > windowStart);
+        if (window.requests.length >= maxRequests) {
+            // Calculate retry after
+            const oldestRequest = window.requests[0];
+            const retryAfter = oldestRequest ? oldestRequest + windowMs - now : windowMs;
+            throw Errors.rateLimited(Math.max(0, retryAfter));
+        }
+    }
+    getRemaining(key, maxRequests, windowMs, now) {
+        const window = this.windows.get(key);
+        if (!window) {
+            return maxRequests;
+        }
+        const windowStart = now - windowMs;
+        const validRequests = window.requests.filter(t => t > windowStart);
+        return Math.max(0, maxRequests - validRequests.length);
+    }
+    addToWindow(key, timestamp) {
+        const window = this.getOrCreateWindow(key);
+        window.requests.push(timestamp);
+    }
+    getOrCreateWindow(key) {
+        let window = this.windows.get(key);
+        if (!window) {
+            window = { requests: [] };
+            this.windows.set(key, window);
+        }
+        return window;
+    }
+}
+/**
+ * Singleton instance for convenience
+ */
+export const rateLimiter = new RateLimiter();
+//# sourceMappingURL=rate-limiter.js.map

package/dist/infrastructure/rate-limiter.js.map

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

package/dist/infrastructure/response-builder.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Enterprise Response Builder
+ *
+ * Provides consistent response formatting with:
+ * - Summary-first responses
+ * - Token budget awareness
+ * - Pagination support
+ * - AI-friendly hints
+ */
+export interface MCPResponseMeta {
+    requestId: string;
+    durationMs: number;
+    cached: boolean;
+    tokenEstimate: number;
+}
+export interface PaginationInfo {
+    cursor?: string | undefined;
+    hasMore: boolean;
+    totalCount?: number | undefined;
+    pageSize: number;
+}
+export interface ResponseHints {
+    nextActions?: string[];
+    relatedTools?: string[];
+    warnings?: string[] | undefined;
+}
+export interface MCPResponse<T> {
+    summary: string;
+    data: T;
+    pagination?: PaginationInfo;
+    hints?: ResponseHints;
+    meta: MCPResponseMeta;
+}
+export interface ResponseBuilderConfig {
+    maxResponseTokens: number;
+    maxSectionTokens: number;
+    preferSummary: boolean;
+}
+export declare class ResponseBuilder<T> {
+    private readonly requestId;
+    private summary;
+    private data;
+    private pagination?;
+    private hints?;
+    private startTime;
+    private cached;
+    private readonly config;
+    private readonly tokenEstimator;
+    constructor(requestId: string, config?: Partial<ResponseBuilderConfig>);
+    /**
+     * Set the summary (1-2 sentences describing the response)
+     */
+    withSummary(summary: string): this;
+    /**
+     * Set the main data payload
+     */
+    withData(data: T): this;
+    /**
+     * Add pagination info
+     */
+    withPagination(info: PaginationInfo): this;
+    /**
+     * Create pagination from array results
+     */
+    withArrayPagination<Item>(items: Item[], totalCount: number, pageSize: number, createCursor: (lastItem: Item) => string): this;
+    /**
+     * Add hints for AI to understand next steps
+     */
+    withHints(hints: ResponseHints): this;
+    /**
+     * Add a single next action hint
+     */
+    addNextAction(action: string): this;
+    /**
+     * Add a warning hint
+     */
+    addWarning(warning: string): this;
+    /**
+     * Mark response as served from cache
+     */
+    markCached(): this;
+    /**
+     * Build the final response
+     */
+    build(): MCPResponse<T>;
+    /**
+     * Build and serialize to MCP content format
+     */
+    buildContent(): {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    /**
+     * Fit response to token budget
+     */
+    private fitToBudget;
+}
+/**
+ * Factory function for creating response builders
+ */
+export declare function createResponseBuilder<T>(requestId?: string, config?: Partial<ResponseBuilderConfig>): ResponseBuilder<T>;
+//# sourceMappingURL=response-builder.d.ts.map

package/dist/infrastructure/response-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../src/infrastructure/response-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;CACxB;AAQD,qBAAa,eAAe,CAAC,CAAC;IAY1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAX5B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAG7B,SAAS,EAAE,MAAM,EAClC,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAO7C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAKvB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAK1C;;OAEG;IACH,mBAAmB,CAAC,IAAI,EACtB,KAAK,EAAE,IAAI,EAAE,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,MAAM,GACvC,IAAI;IAeP;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKrC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWnC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWjC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;IAyCvB;;OAEG;IACH,YAAY,IAAI;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;IAUlE;;OAEG;IACH,OAAO,CAAC,WAAW;CA+CpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,eAAe,CAAC,CAAC,CAAC,CAGpB"}

package/dist/infrastructure/response-builder.js

@@ -0,0 +1,207 @@
+/**
+ * Enterprise Response Builder
+ *
+ * Provides consistent response formatting with:
+ * - Summary-first responses
+ * - Token budget awareness
+ * - Pagination support
+ * - AI-friendly hints
+ */
+import { TokenEstimator } from './token-estimator.js';
+const DEFAULT_CONFIG = {
+    maxResponseTokens: 4000,
+    maxSectionTokens: 1000,
+    preferSummary: true,
+};
+export class ResponseBuilder {
+    requestId;
+    summary = '';
+    data = null;
+    pagination;
+    hints;
+    startTime;
+    cached = false;
+    config;
+    tokenEstimator;
+    constructor(requestId, config = {}) {
+        this.requestId = requestId;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.tokenEstimator = new TokenEstimator();
+        this.startTime = Date.now();
+    }
+    /**
+     * Set the summary (1-2 sentences describing the response)
+     */
+    withSummary(summary) {
+        this.summary = summary;
+        return this;
+    }
+    /**
+     * Set the main data payload
+     */
+    withData(data) {
+        this.data = data;
+        return this;
+    }
+    /**
+     * Add pagination info
+     */
+    withPagination(info) {
+        this.pagination = info;
+        return this;
+    }
+    /**
+     * Create pagination from array results
+     */
+    withArrayPagination(items, totalCount, pageSize, createCursor) {
+        const hasMore = items.length === pageSize && items.length < totalCount;
+        this.pagination = {
+            hasMore,
+            totalCount,
+            pageSize,
+            cursor: hasMore && items.length > 0
+                ? createCursor(items[items.length - 1])
+                : undefined,
+        };
+        return this;
+    }
+    /**
+     * Add hints for AI to understand next steps
+     */
+    withHints(hints) {
+        this.hints = hints;
+        return this;
+    }
+    /**
+     * Add a single next action hint
+     */
+    addNextAction(action) {
+        if (!this.hints) {
+            this.hints = {};
+        }
+        if (!this.hints.nextActions) {
+            this.hints.nextActions = [];
+        }
+        this.hints.nextActions.push(action);
+        return this;
+    }
+    /**
+     * Add a warning hint
+     */
+    addWarning(warning) {
+        if (!this.hints) {
+            this.hints = {};
+        }
+        if (!this.hints.warnings) {
+            this.hints.warnings = [];
+        }
+        this.hints.warnings.push(warning);
+        return this;
+    }
+    /**
+     * Mark response as served from cache
+     */
+    markCached() {
+        this.cached = true;
+        return this;
+    }
+    /**
+     * Build the final response
+     */
+    build() {
+        if (this.data === null) {
+            throw new Error('Response data is required');
+        }
+        if (!this.summary) {
+            throw new Error('Response summary is required');
+        }
+        const response = {
+            summary: this.summary,
+            data: this.data,
+            meta: {
+                requestId: this.requestId,
+                durationMs: Date.now() - this.startTime,
+                cached: this.cached,
+                tokenEstimate: 0, // Will be calculated below
+            },
+        };
+        if (this.pagination) {
+            response.pagination = this.pagination;
+        }
+        if (this.hints && Object.keys(this.hints).length > 0) {
+            response.hints = this.hints;
+        }
+        // Calculate token estimate
+        response.meta.tokenEstimate = this.tokenEstimator.estimate(JSON.stringify(response));
+        // Check if we need to fit to budget
+        if (response.meta.tokenEstimate > this.config.maxResponseTokens) {
+            return this.fitToBudget(response);
+        }
+        return response;
+    }
+    /**
+     * Build and serialize to MCP content format
+     */
+    buildContent() {
+        const response = this.build();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(response, null, 2),
+                }],
+        };
+    }
+    /**
+     * Fit response to token budget
+     */
+    fitToBudget(response) {
+        // Strategy 1: If data is an array, reduce page size
+        if (Array.isArray(response.data) && response.pagination) {
+            const targetSize = Math.floor(response.data.length *
+                (this.config.maxResponseTokens / response.meta.tokenEstimate));
+            const reducedData = response.data.slice(0, Math.max(1, targetSize));
+            return {
+                ...response,
+                data: reducedData,
+                pagination: {
+                    ...response.pagination,
+                    hasMore: true,
+                    pageSize: targetSize,
+                },
+                hints: {
+                    ...response.hints,
+                    warnings: [
+                        ...(response.hints?.warnings || []),
+                        `Response truncated to fit token budget. Use pagination to see more.`,
+                    ],
+                },
+                meta: {
+                    ...response.meta,
+                    tokenEstimate: this.tokenEstimator.estimate(JSON.stringify({
+                        ...response,
+                        data: reducedData,
+                    })),
+                },
+            };
+        }
+        // Strategy 2: Add truncation warning
+        return {
+            ...response,
+            hints: {
+                ...response.hints,
+                warnings: [
+                    ...(response.hints?.warnings || []),
+                    `Response is large (${response.meta.tokenEstimate} tokens). Consider using more specific filters.`,
+                ],
+            },
+        };
+    }
+}
+/**
+ * Factory function for creating response builders
+ */
+export function createResponseBuilder(requestId, config) {
+    const id = requestId || `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+    return new ResponseBuilder(id, config);
+}
+//# sourceMappingURL=response-builder.js.map

package/dist/infrastructure/response-builder.js.map

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

package/dist/infrastructure/token-estimator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Token Estimator
+ *
+ * Estimates token count for responses to stay within context budgets.
+ * Uses heuristics based on typical tokenization patterns.
+ */
+export interface TokenEstimate {
+    tokens: number;
+    confidence: 'high' | 'medium' | 'low';
+    breakdown?: {
+        text: number;
+        structure: number;
+        whitespace: number;
+    };
+}
+export declare class TokenEstimator {
+    private static readonly CHARS_PER_TOKEN;
+    private static readonly JSON_OVERHEAD;
+    /**
+     * Estimate tokens for a string
+     */
+    estimate(text: string): number;
+    /**
+     * Estimate with detailed breakdown
+     */
+    estimateDetailed(text: string): TokenEstimate;
+    /**
+     * Estimate tokens for an object (will be JSON serialized)
+     */
+    estimateObject(obj: unknown): number;
+    /**
+     * Check if content fits within a token budget
+     */
+    fitsInBudget(text: string, budget: number): boolean;
+    /**
+     * Truncate text to fit within token budget
+     */
+    truncateToFit(text: string, budget: number, suffix?: string): string;
+    /**
+     * Detect content type for better estimation
+     */
+    private detectContentType;
+}
+/**
+ * Singleton instance for convenience
+ */
+export declare const tokenEstimator: TokenEstimator;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/infrastructure/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/infrastructure/token-estimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,qBAAa,cAAc;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;IAGF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAQ;IAE7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiB9B;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAmC7C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAIpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAyB,GAAG,MAAM;IAetF;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAqC1B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}