retestkit 1.4.1

package/dist/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { createServer as createHttpServer } from "node:http";
+import { loadConfig } from "./config.js";
+import { createLogger } from "./logger.js";
+import { createServer } from "./server.js";
+import { createTransport } from "./transports/index.js";
+async function main() {
+    // Load and validate configuration
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (error) {
+        console.error("Configuration error:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+    const logger = createLogger(config.logLevel);
+    logger.info("Starting server", { transport: config.transport });
+    // Create MCP server with all components
+    const { server, cleanup } = createServer(config, logger);
+    // Create transport based on configuration
+    const transportResult = createTransport(config, logger);
+    // Set up graceful shutdown
+    const shutdown = async (signal) => {
+        logger.info("Received shutdown signal", { signal });
+        try {
+            await cleanup();
+            await server.close();
+            logger.info("Server closed gracefully");
+            process.exit(0);
+        }
+        catch (error) {
+            logger.error("Error during shutdown", {
+                error: error instanceof Error ? error.message : "Unknown error",
+            });
+            process.exit(1);
+        }
+    };
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    // Connect based on transport type
+    if (transportResult.type === "stdio") {
+        await server.connect(transportResult.transport);
+        logger.info("Server connected via stdio");
+    }
+    else {
+        // HTTP transport requires an HTTP server
+        const httpServer = createHttpServer(async (req, res) => {
+            // Handle MCP requests
+            if (req.method === "POST") {
+                await transportResult.transport.handleRequest(req, res);
+            }
+            else if (req.method === "GET") {
+                // Health check endpoint
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ status: "ok" }));
+            }
+            else {
+                res.writeHead(405);
+                res.end();
+            }
+        });
+        await server.connect(transportResult.transport);
+        httpServer.listen(transportResult.port, () => {
+            logger.info("Server listening", {
+                transport: "http",
+                port: transportResult.port,
+            });
+        });
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from "../logger.js";
+import { type ClientCapabilities } from "../types/capabilities.js";
+export declare const REQUIRED_PROTOCOL_VERSION = "2025-06-18";
+export interface InitializeResult {
+    protocolVersion: string;
+    capabilities: {
+        sampling?: Record<string, unknown>;
+        elicitation?: Record<string, unknown>;
+        logging?: Record<string, unknown>;
+        resources?: {
+            listChanged?: boolean;
+            subscribe?: boolean;
+        };
+    };
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+export declare function parseClientCapabilities(initResult: InitializeResult, logger: Logger): ClientCapabilities;
+export declare function getServerCapabilities(): {
+    tools: {};
+    resources: {
+        listChanged: boolean;
+        subscribe: boolean;
+    };
+    prompts: {};
+    logging: {};
+};
+export declare function checkCapability(caps: ClientCapabilities, capability: keyof Omit<ClientCapabilities, "protocolVersion">): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,SAAS,CAAC,EAAE;YACV,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,SAAS,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC;KACH,CAAC;IACF,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,MAAM,GACb,kBAAkB,CAqDpB;AAED,wBAAgB,qBAAqB;;;;;;;;EAUpC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GAC5D,OAAO,CAET"}

package/dist/lifecycle/index.js

@@ -0,0 +1,61 @@
+import { DEFAULT_CAPABILITIES, } from "../types/capabilities.js";
+export const REQUIRED_PROTOCOL_VERSION = "2025-06-18";
+export function parseClientCapabilities(initResult, logger) {
+    const caps = initResult.capabilities || {};
+    const protocolVersion = initResult.protocolVersion || "unknown";
+    const clientCaps = {
+        ...DEFAULT_CAPABILITIES,
+        protocolVersion,
+        sampling: !!caps.sampling,
+        logging: !!caps.logging,
+        resourcesListChanged: !!caps.resources?.listChanged,
+        resourcesSubscribe: !!caps.resources?.subscribe,
+        // Elicitation requires protocol version 2025-06-18+
+        elicitation: !!caps.elicitation && protocolVersion >= REQUIRED_PROTOCOL_VERSION,
+        // Progress is typically available if sampling is available
+        progress: !!caps.sampling,
+    };
+    // Log capability detection
+    logger.info("Client capabilities detected", {
+        protocolVersion,
+        sampling: clientCaps.sampling,
+        elicitation: clientCaps.elicitation,
+        logging: clientCaps.logging,
+        resourcesListChanged: clientCaps.resourcesListChanged,
+        resourcesSubscribe: clientCaps.resourcesSubscribe,
+    });
+    // Warn about degraded mode
+    if (protocolVersion < REQUIRED_PROTOCOL_VERSION) {
+        logger.warn("Running in degraded mode due to older protocol version", {
+            clientVersion: protocolVersion,
+            requiredVersion: REQUIRED_PROTOCOL_VERSION,
+            disabledFeatures: ["elicitation"],
+        });
+    }
+    if (!clientCaps.sampling) {
+        logger.warn("Sampling not available - AI-powered features will use fallback mode", {
+            fallbackBehavior: "manual prompts via resources",
+        });
+    }
+    if (!clientCaps.elicitation) {
+        logger.info("Elicitation not available - user decisions via tool output", {
+            fallbackBehavior: "questions in tool response",
+        });
+    }
+    return clientCaps;
+}
+export function getServerCapabilities() {
+    return {
+        tools: {},
+        resources: {
+            listChanged: true,
+            subscribe: true,
+        },
+        prompts: {},
+        logging: {},
+    };
+}
+export function checkCapability(caps, capability) {
+    return caps[capability];
+}
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAmBtD,MAAM,UAAU,uBAAuB,CACrC,UAA4B,EAC5B,MAAc;IAEd,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC;IAC3C,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,IAAI,SAAS,CAAC;IAEhE,MAAM,UAAU,GAAuB;QACrC,GAAG,oBAAoB;QACvB,eAAe;QACf,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;QACzB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;QACvB,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW;QACnD,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS;QAC/C,oDAAoD;QACpD,WAAW,EACT,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,eAAe,IAAI,yBAAyB;QACpE,2DAA2D;QAC3D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;KAC1B,CAAC;IAEF,2BAA2B;IAC3B,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;QAC1C,eAAe;QACf,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,oBAAoB,EAAE,UAAU,CAAC,oBAAoB;QACrD,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;KAClD,CAAC,CAAC;IAEH,2BAA2B;IAC3B,IAAI,eAAe,GAAG,yBAAyB,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,wDAAwD,EAAE;YACpE,aAAa,EAAE,eAAe;YAC9B,eAAe,EAAE,yBAAyB;YAC1C,gBAAgB,EAAE,CAAC,aAAa,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,qEAAqE,EACrE;YACE,gBAAgB,EAAE,8BAA8B;SACjD,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,4DAA4D,EAAE;YACxE,gBAAgB,EAAE,4BAA4B;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,KAAK,EAAE,EAAE;QACT,SAAS,EAAE;YACT,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;SAChB;QACD,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAwB,EACxB,UAA6D;IAE7D,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;AAC1B,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,21 @@
+import type { LogLevel } from "./schemas/config.js";
+export interface CorrelationIds {
+    analysisId?: string;
+    crawlId?: string;
+    featureSlug?: string;
+    testRunId?: string;
+    iteration?: number;
+    requestId?: string;
+}
+export interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    withCorrelation(ids: CorrelationIds): Logger;
+    setMcpNotifier(notifier: McpLogNotifier | null): void;
+    setLevel(level: LogLevel): void;
+}
+export type McpLogNotifier = (level: string, data: unknown, logger: string) => Promise<void>;
+export declare function createLogger(level: LogLevel): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAqHpD,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7F,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CA0FpD"}

package/dist/logger.js

@@ -0,0 +1,182 @@
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const MCP_LOG_LEVELS = {
+    debug: "debug",
+    info: "info",
+    warn: "warning",
+    error: "error",
+};
+const REDACT_KEYS = [
+    "password",
+    "token",
+    "secret",
+    "apikey",
+    "authorization",
+    "api_key",
+    "access_token",
+    "refresh_token",
+    "cookie",
+    "session",
+    "credential",
+];
+const SENSITIVE_URL_PARAMS = [
+    "password",
+    "token",
+    "secret",
+    "key",
+    "auth",
+    "session",
+    "code",
+    "state",
+];
+const MAX_HTML_LOG_LENGTH = 500;
+function shouldRedact(key) {
+    const lowerKey = key.toLowerCase();
+    return REDACT_KEYS.some((redactKey) => lowerKey.includes(redactKey));
+}
+function redactUrlParams(url) {
+    try {
+        const parsed = new URL(url);
+        for (const param of SENSITIVE_URL_PARAMS) {
+            if (parsed.searchParams.has(param)) {
+                parsed.searchParams.set(param, "[REDACTED]");
+            }
+            // Also check for similar params
+            for (const key of parsed.searchParams.keys()) {
+                if (key.toLowerCase().includes(param)) {
+                    parsed.searchParams.set(key, "[REDACTED]");
+                }
+            }
+        }
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
+function truncateHtml(content) {
+    if (content.length <= MAX_HTML_LOG_LENGTH) {
+        return content;
+    }
+    return content.slice(0, MAX_HTML_LOG_LENGTH) + "... [truncated]";
+}
+function redactValue(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (typeof obj === "string") {
+        // Check if it looks like a URL
+        if (obj.startsWith("http://") || obj.startsWith("https://")) {
+            return redactUrlParams(obj);
+        }
+        // Check if it looks like HTML
+        if (obj.includes("<html") || obj.includes("<body") || obj.includes("<div")) {
+            return truncateHtml(obj);
+        }
+        return obj;
+    }
+    if (typeof obj !== "object") {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(redactValue);
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (shouldRedact(key)) {
+            result[key] = "[REDACTED]";
+        }
+        else if (key === "url" && typeof value === "string") {
+            result[key] = redactUrlParams(value);
+        }
+        else if (key === "html" || key === "content" || key === "dom") {
+            result[key] = typeof value === "string" ? truncateHtml(value) : redactValue(value);
+        }
+        else if (typeof value === "object" && value !== null) {
+            result[key] = redactValue(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+export function createLogger(level) {
+    let minLevel = LOG_LEVELS[level];
+    let mcpNotifier = null;
+    let correlationIds = {};
+    function log(logLevel, message, data) {
+        if (LOG_LEVELS[logLevel] < minLevel) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: logLevel,
+            message,
+        };
+        // Add correlation IDs if present
+        if (Object.keys(correlationIds).length > 0) {
+            entry.correlation = correlationIds;
+        }
+        if (data) {
+            entry.data = redactValue(data);
+        }
+        // Write to stderr to avoid interfering with MCP stdio transport
+        process.stderr.write(JSON.stringify(entry) + "\n");
+        // Also emit MCP logging notification if available
+        if (mcpNotifier) {
+            const mcpLevel = MCP_LOG_LEVELS[logLevel];
+            mcpNotifier(mcpLevel, entry, "testing-mcp").catch(() => {
+                // Silently ignore notification failures
+            });
+        }
+    }
+    const logger = {
+        debug: (message, data) => log("debug", message, data),
+        info: (message, data) => log("info", message, data),
+        warn: (message, data) => log("warn", message, data),
+        error: (message, data) => log("error", message, data),
+        withCorrelation(ids) {
+            const childLogger = createLogger((Object.entries(LOG_LEVELS).find(([_, v]) => v === minLevel)?.[0] ||
+                "info"));
+            childLogger.setMcpNotifier(mcpNotifier);
+            // Merge correlation IDs
+            const mergedIds = { ...correlationIds, ...ids };
+            // Set up the child logger's correlation
+            return {
+                ...childLogger,
+                debug: (message, data) => {
+                    correlationIds = mergedIds;
+                    log("debug", message, data);
+                },
+                info: (message, data) => {
+                    correlationIds = mergedIds;
+                    log("info", message, data);
+                },
+                warn: (message, data) => {
+                    correlationIds = mergedIds;
+                    log("warn", message, data);
+                },
+                error: (message, data) => {
+                    correlationIds = mergedIds;
+                    log("error", message, data);
+                },
+                withCorrelation: childLogger.withCorrelation,
+                setMcpNotifier: childLogger.setMcpNotifier,
+                setLevel: childLogger.setLevel,
+            };
+        },
+        setMcpNotifier(notifier) {
+            mcpNotifier = notifier;
+        },
+        setLevel(newLevel) {
+            minLevel = LOG_LEVELS[newLevel];
+        },
+    };
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/playwright-client/index.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from "../logger.js";
+import type { Config } from "../schemas/config.js";
+import { type PlaywrightToolMapping, type PlaywrightToolCallResult, type PlaywrightSnapshot, type PlaywrightScreenshot } from "./types.js";
+export type { PlaywrightToolMapping, PlaywrightSnapshot, PlaywrightScreenshot };
+export interface TypeOptions {
+    submit?: boolean;
+    slowly?: boolean;
+}
+export interface PlaywrightClient {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getToolMapping(): PlaywrightToolMapping | null;
+    callTool(canonicalName: keyof PlaywrightToolMapping, args: Record<string, unknown>): Promise<PlaywrightToolCallResult>;
+    snapshot(): Promise<PlaywrightSnapshot>;
+    screenshot(): Promise<PlaywrightScreenshot>;
+    navigate(url: string): Promise<void>;
+    click(element: string, ref: string): Promise<void>;
+    type(element: string, ref: string, text: string, options?: TypeOptions): Promise<void>;
+    fill(element: string, ref: string, value: string): Promise<void>;
+    hover(element: string, ref: string): Promise<void>;
+    select(element: string, ref: string, values: string[]): Promise<void>;
+    evaluate(fn: string, element?: string, ref?: string): Promise<unknown>;
+    press(key: string): Promise<void>;
+    scroll(x: number, y: number): Promise<void>;
+    wait(ms: number): Promise<void>;
+}
+export declare function createPlaywrightClient(config: Config, logger: Logger): PlaywrightClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/playwright-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright-client/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAI1B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,cAAc,IAAI,qBAAqB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CACN,aAAa,EAAE,MAAM,qBAAqB,EAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,gBAAgB,CAuVlB"}