regen-koi-mcp 1.0.6 → 1.2.0

package/dist/resilience.js

@@ -0,0 +1,317 @@
+/**
+ * Resilience Module - Retry Logic, Circuit Breaker, Timeouts
+ *
+ * Provides utilities for making the MCP server fault-tolerant:
+ * - Exponential backoff retry for transient failures
+ * - Circuit breaker to prevent cascading failures
+ * - Timeout wrapper for long-running operations
+ */
+import { logger, logCircuitBreaker } from './logger.js';
+import { recordCircuitBreak } from './metrics.js';
+/**
+ * Check if an error is retriable (transient failure)
+ */
+export function isRetriableError(error) {
+    // Network errors
+    if (error.code === 'ECONNREFUSED')
+        return true;
+    if (error.code === 'ECONNRESET')
+        return true;
+    if (error.code === 'ETIMEDOUT')
+        return true;
+    if (error.code === 'ENOTFOUND')
+        return true;
+    // HTTP status codes that are retriable
+    if (error.response?.status) {
+        const status = error.response.status;
+        // 5xx server errors (except 501 Not Implemented)
+        if (status >= 500 && status !== 501)
+            return true;
+        // 429 Too Many Requests (rate limited)
+        if (status === 429)
+            return true;
+        // 408 Request Timeout
+        if (status === 408)
+            return true;
+    }
+    // Axios network errors
+    if (error.code === 'ERR_NETWORK')
+        return true;
+    // PostgreSQL connection errors
+    if (error.code === '57P01')
+        return true; // admin_shutdown
+    if (error.code === '57P02')
+        return true; // crash_shutdown
+    if (error.code === '57P03')
+        return true; // cannot_connect_now
+    return false;
+}
+/**
+ * Sleep helper
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    shouldRetry: isRetriableError,
+    onRetry: () => { }
+};
+/**
+ * Execute a function with exponential backoff retry
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError;
+    let delay = opts.initialDelayMs;
+    for (let attempt = 1; attempt <= opts.maxRetries + 1; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if we should retry
+            if (attempt > opts.maxRetries || !opts.shouldRetry(error)) {
+                throw error;
+            }
+            // Log retry attempt
+            logger.warn({
+                action: 'retry',
+                attempt,
+                max_retries: opts.maxRetries,
+                delay_ms: delay,
+                error: error instanceof Error ? error.message : String(error)
+            }, `Retrying after error (attempt ${attempt}/${opts.maxRetries})`);
+            // Call onRetry callback
+            opts.onRetry(error, attempt, delay);
+            // Wait before retrying
+            await sleep(delay);
+            // Calculate next delay with exponential backoff
+            delay = Math.min(delay * opts.backoffMultiplier, opts.maxDelayMs);
+        }
+    }
+    throw lastError;
+}
+const DEFAULT_CIRCUIT_OPTIONS = {
+    failureThreshold: 5,
+    resetTimeoutMs: 60000,
+    halfOpenMaxCalls: 3,
+    onStateChange: () => { }
+};
+/**
+ * Circuit Breaker class for preventing cascading failures
+ */
+export class CircuitBreaker {
+    state = 'closed';
+    failureCount = 0;
+    successCount = 0;
+    lastFailureTime;
+    halfOpenCalls = 0;
+    options;
+    serviceName;
+    constructor(serviceName, options = {}) {
+        this.serviceName = serviceName;
+        this.options = { ...DEFAULT_CIRCUIT_OPTIONS, ...options };
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        // Check if we should transition from open to half-open
+        if (this.state === 'open' && this.lastFailureTime) {
+            const elapsed = Date.now() - this.lastFailureTime.getTime();
+            if (elapsed >= this.options.resetTimeoutMs) {
+                this.transitionTo('half-open');
+            }
+        }
+        return this.state;
+    }
+    /**
+     * Transition to a new state
+     */
+    transitionTo(newState) {
+        if (this.state !== newState) {
+            const oldState = this.state;
+            this.state = newState;
+            // Reset counters on state change
+            if (newState === 'half-open') {
+                this.halfOpenCalls = 0;
+            }
+            else if (newState === 'closed') {
+                this.failureCount = 0;
+                this.successCount = 0;
+            }
+            // Log state change
+            logCircuitBreaker({
+                state: newState,
+                service: this.serviceName,
+                failure_count: this.failureCount,
+                reset_at: newState === 'open'
+                    ? new Date(Date.now() + this.options.resetTimeoutMs)
+                    : undefined
+            });
+            // Callback
+            this.options.onStateChange(oldState, newState);
+        }
+    }
+    /**
+     * Execute a function through the circuit breaker
+     */
+    async execute(fn) {
+        const state = this.getState();
+        // If circuit is open, fail fast
+        if (state === 'open') {
+            throw new CircuitBreakerError(`Circuit breaker is open for ${this.serviceName}. Try again later.`, this.serviceName, this.lastFailureTime
+                ? new Date(this.lastFailureTime.getTime() + this.options.resetTimeoutMs)
+                : new Date(Date.now() + this.options.resetTimeoutMs));
+        }
+        // If half-open, limit concurrent calls
+        if (state === 'half-open') {
+            if (this.halfOpenCalls >= this.options.halfOpenMaxCalls) {
+                throw new CircuitBreakerError(`Circuit breaker is half-open for ${this.serviceName}. Waiting for test calls to complete.`, this.serviceName);
+            }
+            this.halfOpenCalls++;
+        }
+        try {
+            const result = await fn();
+            this.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            this.recordFailure();
+            throw error;
+        }
+    }
+    /**
+     * Record a successful call
+     */
+    recordSuccess() {
+        this.successCount++;
+        if (this.state === 'half-open') {
+            // In half-open, successes move us back to closed
+            this.transitionTo('closed');
+        }
+        else if (this.state === 'closed') {
+            // In closed, successes reduce failure count
+            if (this.failureCount > 0) {
+                this.failureCount--;
+            }
+        }
+    }
+    /**
+     * Record a failed call
+     */
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureTime = new Date();
+        if (this.state === 'half-open') {
+            // In half-open, any failure reopens the circuit
+            this.transitionTo('open');
+            recordCircuitBreak();
+        }
+        else if (this.state === 'closed') {
+            // In closed, check if we've hit the threshold
+            if (this.failureCount >= this.options.failureThreshold) {
+                this.transitionTo('open');
+                recordCircuitBreak();
+            }
+        }
+    }
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset() {
+        this.transitionTo('closed');
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = undefined;
+        this.halfOpenCalls = 0;
+    }
+    /**
+     * Get circuit breaker stats
+     */
+    getStats() {
+        return {
+            state: this.getState(),
+            failureCount: this.failureCount,
+            successCount: this.successCount,
+            lastFailure: this.lastFailureTime?.toISOString()
+        };
+    }
+}
+/**
+ * Custom error for circuit breaker open state
+ */
+export class CircuitBreakerError extends Error {
+    serviceName;
+    retryAfter;
+    constructor(message, serviceName, retryAfter) {
+        super(message);
+        this.serviceName = serviceName;
+        this.retryAfter = retryAfter;
+        this.name = 'CircuitBreakerError';
+    }
+}
+/**
+ * Custom error for timeouts
+ */
+export class TimeoutError extends Error {
+    timeoutMs;
+    constructor(message, timeoutMs) {
+        super(message);
+        this.timeoutMs = timeoutMs;
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Execute a function with a timeout
+ */
+export async function withTimeout(fn, timeoutMs, operationName = 'operation') {
+    return new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            reject(new TimeoutError(`${operationName} timed out after ${timeoutMs}ms`, timeoutMs));
+        }, timeoutMs);
+        fn()
+            .then(result => {
+            clearTimeout(timeoutId);
+            resolve(result);
+        })
+            .catch(error => {
+            clearTimeout(timeoutId);
+            reject(error);
+        });
+    });
+}
+/**
+ * Combine retry and timeout
+ */
+export async function withRetryAndTimeout(fn, timeoutMs, retryOptions = {}, operationName = 'operation') {
+    return withRetry(() => withTimeout(fn, timeoutMs, operationName), retryOptions);
+}
+// Create circuit breakers for different services
+export const circuitBreakers = {
+    graphApi: new CircuitBreaker('graph-api', {
+        failureThreshold: 5,
+        resetTimeoutMs: 60000
+    }),
+    koiApi: new CircuitBreaker('koi-api', {
+        failureThreshold: 5,
+        resetTimeoutMs: 60000
+    }),
+    database: new CircuitBreaker('database', {
+        failureThreshold: 3,
+        resetTimeoutMs: 30000
+    })
+};
+export default {
+    withRetry,
+    withTimeout,
+    withRetryAndTimeout,
+    CircuitBreaker,
+    circuitBreakers,
+    isRetriableError
+};
+//# sourceMappingURL=resilience.js.map

package/dist/resilience.js.map

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

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,eAAO,MAAM,KAAK,EAAE,IAAI,EAkKvB,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,eAAO,MAAM,KAAK,EAAE,IAAI,EA+LvB,CAAC"}

package/dist/tools.js

@@ -77,7 +77,7 @@ export const TOOLS = [
     },
     {
         name: 'generate_weekly_digest',
-        description: 'Generate a weekly digest of Regen Network activity and discussions. Returns markdown content suitable for NotebookLM or sharing. Optionally saves to a file.',
+        description: 'Generate a weekly digest SUMMARY of Regen Network activity. Returns a curated markdown brief with executive summary, governance analysis, community discussions, and on-chain metrics. This is a condensed overview - use get_notebooklm_export for full content with complete forum posts and Notion pages.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -109,6 +109,19 @@ export const TOOLS = [
             }
         }
     },
+    {
+        name: 'get_notebooklm_export',
+        description: 'Get the full NotebookLM export with COMPLETE content including: full forum thread posts, complete Notion page content (all chunks), enriched URLs, and detailed source material. Automatically saves to a local file to avoid bloating LLM context. Returns the file path and summary stats.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                output_path: {
+                    type: 'string',
+                    description: 'Custom file path for saving. Defaults to notebooklm_export_YYYY-MM-DD.md in the current directory.'
+                }
+            }
+        }
+    },
     {
         name: 'search_github_docs',
         description: 'Search Regen Network GitHub repositories for documentation, README files, configuration files, and technical content. Searches regen-ledger (blockchain), regen-web (frontend), regen-data-standards (schemas), and regenie-corpus (docs). Note: Currently searches documentation and config files, not source code.',
@@ -163,6 +176,22 @@ export const TOOLS = [
                 }
             }
         }
+    },
+    {
+        name: 'get_mcp_metrics',
+        description: 'Get MCP server performance metrics, cache statistics, and health status. Useful for monitoring and debugging. Returns uptime, tool latencies, cache hit rates, error counts, and circuit breaker status.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    },
+    {
+        name: 'regen_koi_authenticate',
+        description: 'Authenticate with your @regen.network email to access internal Regen Network documentation in addition to public sources. Opens a browser window for secure OAuth login. Authentication token is saved on the server and persists across sessions. Only needs to be done once.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
     }
 ];
 //# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Validation Module - Input Validation with Zod Schemas
+ *
+ * Provides input validation for all MCP tool parameters to prevent
+ * injection attacks and ensure data integrity.
+ */
+import { z } from 'zod';
+/**
+ * Schema for query_code_graph tool
+ */
+export declare const QueryCodeGraphSchema: z.ZodObject<{
+    query_type: z.ZodEnum<{
+        list_repos: "list_repos";
+        list_entity_types: "list_entity_types";
+        get_entity_stats: "get_entity_stats";
+        list_modules: "list_modules";
+        find_by_type: "find_by_type";
+        get_module: "get_module";
+        search_modules: "search_modules";
+        module_entities: "module_entities";
+        module_for_entity: "module_for_entity";
+        search_entities: "search_entities";
+        keeper_for_msg: "keeper_for_msg";
+        msgs_for_keeper: "msgs_for_keeper";
+        docs_mentioning: "docs_mentioning";
+        entities_in_doc: "entities_in_doc";
+        related_entities: "related_entities";
+    }>;
+    entity_name: z.ZodOptional<z.ZodString>;
+    entity_type: z.ZodOptional<z.ZodString>;
+    doc_path: z.ZodOptional<z.ZodString>;
+    repo_name: z.ZodOptional<z.ZodString>;
+    module_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for search_knowledge tool
+ */
+export declare const SearchKnowledgeSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    published_from: z.ZodOptional<z.ZodString>;
+    published_to: z.ZodOptional<z.ZodString>;
+    include_undated: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * Schema for hybrid_search tool
+ */
+export declare const HybridSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Schema for search_github_docs tool
+ */
+export declare const SearchGithubDocsSchema: z.ZodObject<{
+    query: z.ZodString;
+    repository: z.ZodOptional<z.ZodEnum<{
+        "regen-ledger": "regen-ledger";
+        "regen-web": "regen-web";
+        "regen-data-standards": "regen-data-standards";
+        "regenie-corpus": "regenie-corpus";
+        "koi-sensors": "koi-sensors";
+    }>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Schema for get_repo_overview tool
+ */
+export declare const GetRepoOverviewSchema: z.ZodObject<{
+    repository: z.ZodEnum<{
+        "regen-ledger": "regen-ledger";
+        "regen-web": "regen-web";
+        "regen-data-standards": "regen-data-standards";
+        "regenie-corpus": "regenie-corpus";
+        "koi-sensors": "koi-sensors";
+    }>;
+}, z.core.$strip>;
+/**
+ * Schema for get_tech_stack tool
+ */
+export declare const GetTechStackSchema: z.ZodObject<{
+    repository: z.ZodOptional<z.ZodEnum<{
+        "regen-ledger": "regen-ledger";
+        "regen-web": "regen-web";
+        "regen-data-standards": "regen-data-standards";
+        "regenie-corpus": "regenie-corpus";
+        "koi-sensors": "koi-sensors";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for get_stats tool
+ */
+export declare const GetStatsSchema: z.ZodObject<{
+    detailed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * Schema for generate_weekly_digest tool
+ */
+export declare const GenerateWeeklyDigestSchema: z.ZodObject<{
+    start_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    save_to_file: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    output_path: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        markdown: "markdown";
+        json: "json";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * Validation result type
+ */
+export interface ValidationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    details?: z.ZodIssue[];
+}
+/**
+ * Validate input against a schema
+ */
+export declare function validateInput<T>(schema: z.ZodSchema<T>, input: unknown, toolName: string): ValidationResult<T>;
+/**
+ * Map of tool names to their schemas
+ */
+export declare const ToolSchemas: Record<string, z.ZodSchema<any>>;
+/**
+ * Validate tool input by tool name
+ */
+export declare function validateToolInput(toolName: string, input: unknown): ValidationResult<any>;
+/**
+ * Sanitize a string for safe use in queries
+ * Removes potentially dangerous characters
+ */
+export declare function sanitizeString(input: string): string;
+/**
+ * Check if a string looks like an injection attempt
+ */
+export declare function detectInjection(input: string): boolean;
+declare const _default: {
+    validateInput: typeof validateInput;
+    validateToolInput: typeof validateToolInput;
+    sanitizeString: typeof sanitizeString;
+    detectInjection: typeof detectInjection;
+    QueryCodeGraphSchema: z.ZodObject<{
+        query_type: z.ZodEnum<{
+            list_repos: "list_repos";
+            list_entity_types: "list_entity_types";
+            get_entity_stats: "get_entity_stats";
+            list_modules: "list_modules";
+            find_by_type: "find_by_type";
+            get_module: "get_module";
+            search_modules: "search_modules";
+            module_entities: "module_entities";
+            module_for_entity: "module_for_entity";
+            search_entities: "search_entities";
+            keeper_for_msg: "keeper_for_msg";
+            msgs_for_keeper: "msgs_for_keeper";
+            docs_mentioning: "docs_mentioning";
+            entities_in_doc: "entities_in_doc";
+            related_entities: "related_entities";
+        }>;
+        entity_name: z.ZodOptional<z.ZodString>;
+        entity_type: z.ZodOptional<z.ZodString>;
+        doc_path: z.ZodOptional<z.ZodString>;
+        repo_name: z.ZodOptional<z.ZodString>;
+        module_name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    SearchKnowledgeSchema: z.ZodObject<{
+        query: z.ZodString;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        published_from: z.ZodOptional<z.ZodString>;
+        published_to: z.ZodOptional<z.ZodString>;
+        include_undated: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    HybridSearchSchema: z.ZodObject<{
+        query: z.ZodString;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>;
+    SearchGithubDocsSchema: z.ZodObject<{
+        query: z.ZodString;
+        repository: z.ZodOptional<z.ZodEnum<{
+            "regen-ledger": "regen-ledger";
+            "regen-web": "regen-web";
+            "regen-data-standards": "regen-data-standards";
+            "regenie-corpus": "regenie-corpus";
+            "koi-sensors": "koi-sensors";
+        }>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>;
+    GetRepoOverviewSchema: z.ZodObject<{
+        repository: z.ZodEnum<{
+            "regen-ledger": "regen-ledger";
+            "regen-web": "regen-web";
+            "regen-data-standards": "regen-data-standards";
+            "regenie-corpus": "regenie-corpus";
+            "koi-sensors": "koi-sensors";
+        }>;
+    }, z.core.$strip>;
+    GetTechStackSchema: z.ZodObject<{
+        repository: z.ZodOptional<z.ZodEnum<{
+            "regen-ledger": "regen-ledger";
+            "regen-web": "regen-web";
+            "regen-data-standards": "regen-data-standards";
+            "regenie-corpus": "regenie-corpus";
+            "koi-sensors": "koi-sensors";
+        }>>;
+    }, z.core.$strip>;
+    GetStatsSchema: z.ZodObject<{
+        detailed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    GenerateWeeklyDigestSchema: z.ZodObject<{
+        start_date: z.ZodOptional<z.ZodString>;
+        end_date: z.ZodOptional<z.ZodString>;
+        save_to_file: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        output_path: z.ZodOptional<z.ZodString>;
+        format: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            markdown: "markdown";
+            json: "json";
+        }>>>;
+    }, z.core.$strip>;
+};
+export default _default;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;iBAyChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAiBhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAU7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAWjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;iBAEhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;iBAE7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;iBAUrC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,CAAC,CAAC,CAmCrB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CASxD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,GAAG,CAAC,CAYvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,wBAaE"}