@robinmordasiewicz/f5xc-api-mcp 3.0.0

package/dist/tools/discovery/execute.js

@@ -0,0 +1,251 @@
+/**
+ * Tool Execution Dispatcher
+ *
+ * Routes tool execution requests to the appropriate handler.
+ * This provides a unified interface for executing any discovered tool.
+ */
+import { getToolByName } from "../registry.js";
+import { toolExists } from "./index-loader.js";
+import { CredentialManager, AuthMode } from "../../auth/credential-manager.js";
+import { createHttpClient } from "../../auth/http-client.js";
+import { logger } from "../../utils/logging.js";
+/**
+ * Build path with parameters substituted
+ */
+function buildPath(pathTemplate, pathParams) {
+    let path = pathTemplate;
+    for (const [key, value] of Object.entries(pathParams)) {
+        // Handle both {param} and {metadata.param} style placeholders
+        path = path.replace(`{${key}}`, encodeURIComponent(value));
+    }
+    // Check for any remaining unsubstituted parameters
+    const remaining = path.match(/\{[^}]+\}/g);
+    if (remaining) {
+        throw new Error(`Missing path parameters: ${remaining.join(", ")}`);
+    }
+    return path;
+}
+/**
+ * Build query string from parameters
+ */
+function buildQueryString(queryParams) {
+    const parts = [];
+    for (const [key, value] of Object.entries(queryParams)) {
+        if (Array.isArray(value)) {
+            for (const v of value) {
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);
+            }
+        }
+        else {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join("&")}` : "";
+}
+/**
+ * Generate f5xcctl equivalent command
+ */
+function generateF5xcctlCommand(tool, params) {
+    const { operation, resource } = tool;
+    const pathParams = params.pathParams ?? {};
+    // Build resource identifier
+    const namespace = pathParams.namespace ?? pathParams["metadata.namespace"] ?? "{namespace}";
+    const name = pathParams.name ?? pathParams["metadata.name"] ?? "{name}";
+    // Map operation to f5xcctl verb
+    const verbMap = {
+        create: "create",
+        get: "get",
+        list: "list",
+        update: "replace",
+        delete: "delete",
+    };
+    const verb = verbMap[operation] ?? operation;
+    // Build command
+    const resourceType = resource.replace(/-/g, "_");
+    if (operation === "list") {
+        return `f5xcctl ${verb} ${resourceType} --namespace ${namespace}`;
+    }
+    else if (operation === "create") {
+        return `f5xcctl ${verb} ${resourceType} --namespace ${namespace} -f config.yaml`;
+    }
+    else {
+        return `f5xcctl ${verb} ${resourceType} ${name} --namespace ${namespace}`;
+    }
+}
+/**
+ * Generate curl command example
+ */
+function generateCurlCommand(tool, params, apiUrl) {
+    const path = buildPath(tool.path, params.pathParams ?? {});
+    const queryString = buildQueryString(params.queryParams ?? {});
+    const fullUrl = `${apiUrl}${path}${queryString}`;
+    let cmd = `curl -X ${tool.method} "${fullUrl}"`;
+    cmd += ' \\\n  -H "Authorization: APIToken $F5XC_API_TOKEN"';
+    cmd += ' \\\n  -H "Content-Type: application/json"';
+    if (params.body && ["POST", "PUT", "PATCH"].includes(tool.method)) {
+        cmd += ` \\\n  -d '${JSON.stringify(params.body, null, 2)}'`;
+    }
+    return cmd;
+}
+/**
+ * Generate documentation response for unauthenticated mode
+ */
+function generateDocumentationResponse(tool, params) {
+    const apiUrl = "https://{tenant}.console.ves.volterra.io/api";
+    return {
+        tool: {
+            name: tool.toolName,
+            summary: tool.summary,
+            method: tool.method,
+            path: tool.path,
+            domain: tool.domain,
+            resource: tool.resource,
+            operation: tool.operation,
+        },
+        f5xcctlCommand: generateF5xcctlCommand(tool, params),
+        curlExample: generateCurlCommand(tool, params, apiUrl),
+        authMessage: "API execution disabled. Set F5XC_API_URL and F5XC_API_TOKEN to enable execution.",
+    };
+}
+/**
+ * Execute a tool by name with the given parameters
+ *
+ * In authenticated mode: Makes the actual API call
+ * In documentation mode: Returns CLI equivalents and examples
+ *
+ * @param params - Execution parameters
+ * @param credentialManager - Optional credential manager for auth
+ * @returns Execution result or documentation
+ *
+ * @example
+ * ```typescript
+ * // Execute in authenticated mode
+ * const result = await executeTool({
+ *   toolName: "f5xc-api-waap-http-loadbalancer-list",
+ *   pathParams: { namespace: "default" }
+ * }, credentialManager);
+ *
+ * // Execute in documentation mode (no credentials)
+ * const docs = await executeTool({
+ *   toolName: "f5xc-api-waap-http-loadbalancer-create",
+ *   pathParams: { "metadata.namespace": "default" },
+ *   body: { metadata: { name: "example-lb" }, spec: { ... } }
+ * });
+ * ```
+ */
+export async function executeTool(params, credentialManager) {
+    const { toolName, pathParams = {}, queryParams = {}, body } = params;
+    // Validate tool exists
+    if (!toolExists(toolName)) {
+        return {
+            success: false,
+            error: `Tool "${toolName}" not found. Use search_tools to find available tools.`,
+            toolInfo: {
+                name: toolName,
+                method: "UNKNOWN",
+                path: "UNKNOWN",
+                operation: "UNKNOWN",
+            },
+        };
+    }
+    // Get full tool definition
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return {
+            success: false,
+            error: `Failed to load tool "${toolName}".`,
+            toolInfo: {
+                name: toolName,
+                method: "UNKNOWN",
+                path: "UNKNOWN",
+                operation: "UNKNOWN",
+            },
+        };
+    }
+    const toolInfo = {
+        name: tool.toolName,
+        method: tool.method,
+        path: tool.path,
+        operation: tool.operation,
+    };
+    // Check authentication
+    const creds = credentialManager ?? new CredentialManager();
+    const authMode = creds.getAuthMode();
+    if (authMode === AuthMode.NONE) {
+        // Return documentation response
+        return generateDocumentationResponse(tool, params);
+    }
+    // Authenticated mode - execute API call
+    try {
+        const httpClient = createHttpClient(creds);
+        const path = buildPath(tool.path, pathParams);
+        const queryString = buildQueryString(queryParams);
+        const fullPath = `${path}${queryString}`;
+        logger.debug(`Executing tool: ${toolName}`, { method: tool.method, path: fullPath });
+        let response;
+        switch (tool.method.toUpperCase()) {
+            case "GET":
+                response = await httpClient.get(fullPath);
+                break;
+            case "POST":
+                response = await httpClient.post(fullPath, body);
+                break;
+            case "PUT":
+                response = await httpClient.put(fullPath, body);
+                break;
+            case "DELETE":
+                response = await httpClient.delete(fullPath);
+                break;
+            default:
+                return {
+                    success: false,
+                    error: `Unsupported HTTP method: ${tool.method}`,
+                    toolInfo,
+                };
+        }
+        return {
+            success: true,
+            data: response.data,
+            statusCode: response.status,
+            toolInfo,
+        };
+    }
+    catch (error) {
+        logger.error(`Tool execution failed: ${toolName}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error occurred",
+            toolInfo,
+        };
+    }
+}
+/**
+ * Validate execution parameters before running
+ */
+export function validateExecuteParams(toolName, params) {
+    const errors = [];
+    // Check tool exists
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return { valid: false, errors: [`Tool "${toolName}" not found`] };
+    }
+    // Check required path parameters
+    for (const param of tool.pathParameters) {
+        if (param.required) {
+            const value = params.pathParams?.[param.name] ?? params.pathParams?.[param.name.replace("metadata.", "")];
+            if (!value) {
+                errors.push(`Missing required path parameter: ${param.name}`);
+            }
+        }
+    }
+    // Check if body is required
+    if (tool.requestBodySchema && !params.body) {
+        if (["POST", "PUT", "PATCH"].includes(tool.method)) {
+            errors.push("Request body is required for this operation");
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/discovery/execute.js.map

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

package/dist/tools/discovery/index-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool Index Loader
+ *
+ * Loads and caches the lightweight tool index for discovery.
+ * Generates the index from existing tool registry on first load.
+ */
+import type { ToolIndex, ToolIndexEntry, ToolIndexMetadata } from "./types.js";
+/**
+ * Get the tool index (generates on first call, cached thereafter)
+ */
+export declare function getToolIndex(): ToolIndex;
+/**
+ * Clear the cached index (useful for testing or refresh)
+ */
+export declare function clearIndexCache(): void;
+/**
+ * Get index metadata without loading full index
+ */
+export declare function getIndexMetadata(): ToolIndexMetadata;
+/**
+ * Check if a tool exists by name
+ */
+export declare function toolExists(toolName: string): boolean;
+/**
+ * Get a single tool entry by name
+ */
+export declare function getToolEntry(toolName: string): ToolIndexEntry | undefined;
+//# sourceMappingURL=index-loader.d.ts.map

package/dist/tools/discovery/index-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-loader.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/index-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAkC/E;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGzE"}

package/dist/tools/discovery/index-loader.js

@@ -0,0 +1,69 @@
+/**
+ * Tool Index Loader
+ *
+ * Loads and caches the lightweight tool index for discovery.
+ * Generates the index from existing tool registry on first load.
+ */
+import { allTools } from "../registry.js";
+// Cached index for performance
+let cachedIndex = null;
+/**
+ * Generate tool index from the existing tool registry
+ */
+function generateIndex() {
+    const tools = allTools.map((tool) => ({
+        name: tool.toolName,
+        domain: tool.domain,
+        resource: tool.resource,
+        operation: tool.operation,
+        summary: tool.summary,
+    }));
+    // Calculate domain counts
+    const domains = {};
+    for (const tool of tools) {
+        domains[tool.domain] = (domains[tool.domain] ?? 0) + 1;
+    }
+    const metadata = {
+        totalTools: tools.length,
+        domains,
+        generatedAt: new Date().toISOString(),
+        version: "1.0.0",
+    };
+    return { metadata, tools };
+}
+/**
+ * Get the tool index (generates on first call, cached thereafter)
+ */
+export function getToolIndex() {
+    if (!cachedIndex) {
+        cachedIndex = generateIndex();
+    }
+    return cachedIndex;
+}
+/**
+ * Clear the cached index (useful for testing or refresh)
+ */
+export function clearIndexCache() {
+    cachedIndex = null;
+}
+/**
+ * Get index metadata without loading full index
+ */
+export function getIndexMetadata() {
+    return getToolIndex().metadata;
+}
+/**
+ * Check if a tool exists by name
+ */
+export function toolExists(toolName) {
+    const index = getToolIndex();
+    return index.tools.some((t) => t.name === toolName);
+}
+/**
+ * Get a single tool entry by name
+ */
+export function getToolEntry(toolName) {
+    const index = getToolIndex();
+    return index.tools.find((t) => t.name === toolName);
+}
+//# sourceMappingURL=index-loader.js.map

package/dist/tools/discovery/index-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-loader.js","sourceRoot":"","sources":["../../../src/tools/discovery/index-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,+BAA+B;AAC/B,IAAI,WAAW,GAAqB,IAAI,CAAC;AAEzC;;GAEG;AACH,SAAS,aAAa;IACpB,MAAM,KAAK,GAAqB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC,CAAC;IAEJ,0BAA0B;IAC1B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAsB;QAClC,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,OAAO;QACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,OAAO,EAAE,OAAO;KACjB,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,aAAa,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,EAAE,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/dist/tools/discovery/index.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Discovery Module - Dynamic Tool Discovery for Token Efficiency
+ *
+ * This module implements the Speakeasy-style dynamic toolset pattern
+ * that reduces token consumption by 95%+ through lazy loading.
+ *
+ * Instead of loading all 1,400+ tools upfront (~535K tokens), this module
+ * exposes three meta-tools that load tool schemas on-demand:
+ *
+ * 1. search_tools - Find tools matching a natural language query
+ * 2. describe_tool - Get full schema for a specific tool
+ * 3. execute_tool - Execute a discovered tool
+ *
+ * Token Impact:
+ * - Before: 535,000 tokens loaded at server start
+ * - After: ~500 tokens (meta-tools) + ~375 tokens per tool used
+ */
+export type { ToolIndexEntry, SearchResult, SearchOptions, ToolIndex, ToolIndexMetadata, } from "./types.js";
+export type { ToolDescription, ParameterDescription, CompactToolDescription } from "./describe.js";
+export type { ExecuteToolParams, ExecuteToolResult, DocumentationResponse } from "./execute.js";
+export { getToolIndex, clearIndexCache, getIndexMetadata, toolExists, getToolEntry, } from "./index-loader.js";
+export { searchTools, getToolsByDomain, getToolsByResource, getAvailableDomains, getToolCountByDomain, } from "./search.js";
+export { describeTool, describeTools, describeToolSafe, describeToolCompact, getFullToolSchema, getOptimizationStats, } from "./describe.js";
+export { executeTool, validateExecuteParams } from "./execute.js";
+export type { CrudOperation, ConsolidatedResource, ConsolidatedIndex } from "./consolidate.js";
+export { getConsolidatedIndex, clearConsolidatedCache, getConsolidatedResource, getConsolidatedByDomain, searchConsolidatedResources, resolveConsolidatedTool, getConsolidationStats, } from "./consolidate.js";
+/**
+ * MCP Tool Definitions for the discovery meta-tools
+ *
+ * These are the three tools that get registered with the MCP server
+ * instead of the 1,400+ individual API tools.
+ */
+export declare const DISCOVERY_TOOLS: {
+    readonly search: {
+        readonly name: "f5xc-api-search-tools";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly query: {
+                    readonly type: "string";
+                    readonly description: "Natural language search query (e.g., 'http load balancer', 'create origin pool', 'delete dns zone')";
+                };
+                readonly limit: {
+                    readonly type: "number";
+                    readonly description: "Maximum number of results to return (default: 10, max: 50)";
+                    readonly default: 10;
+                };
+                readonly domains: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Filter by domain(s): waap, dns, core, network, site, security, appstack";
+                };
+                readonly operations: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Filter by operation type(s): create, get, list, update, delete";
+                };
+            };
+            readonly required: readonly ["query"];
+        };
+    };
+    readonly describe: {
+        readonly name: "f5xc-api-describe-tool";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly toolName: {
+                    readonly type: "string";
+                    readonly description: "The exact tool name (e.g., 'f5xc-api-waap-http-loadbalancer-create')";
+                };
+            };
+            readonly required: readonly ["toolName"];
+        };
+    };
+    readonly execute: {
+        readonly name: "f5xc-api-execute-tool";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly toolName: {
+                    readonly type: "string";
+                    readonly description: "The exact tool name to execute";
+                };
+                readonly pathParams: {
+                    readonly type: "object";
+                    readonly description: "Path parameters (e.g., { namespace: 'default', name: 'example-resource' })";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly queryParams: {
+                    readonly type: "object";
+                    readonly description: "Query parameters for the request";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly body: {
+                    readonly type: "object";
+                    readonly description: "Request body for POST/PUT/PATCH operations";
+                };
+            };
+            readonly required: readonly ["toolName"];
+        };
+    };
+    readonly serverInfo: {
+        readonly name: "f5xc-api-server-info";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {};
+        };
+    };
+    readonly searchResources: {
+        readonly name: "f5xc-api-search-resources";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly query: {
+                    readonly type: "string";
+                    readonly description: "Natural language search query (e.g., 'http load balancer', 'origin pool', 'dns zone')";
+                };
+                readonly limit: {
+                    readonly type: "number";
+                    readonly description: "Maximum number of results to return (default: 10)";
+                    readonly default: 10;
+                };
+                readonly domains: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Filter by domain(s): waap, dns, core, network, site, security, appstack";
+                };
+            };
+            readonly required: readonly ["query"];
+        };
+    };
+    readonly executeResource: {
+        readonly name: "f5xc-api-execute-resource";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly resourceName: {
+                    readonly type: "string";
+                    readonly description: "The consolidated resource name (e.g., 'f5xc-api-waap-http-loadbalancer')";
+                };
+                readonly operation: {
+                    readonly type: "string";
+                    readonly enum: readonly ["create", "get", "list", "update", "delete"];
+                    readonly description: "The CRUD operation to perform";
+                };
+                readonly pathParams: {
+                    readonly type: "object";
+                    readonly description: "Path parameters (e.g., { namespace: 'default', name: 'example-resource' })";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly queryParams: {
+                    readonly type: "object";
+                    readonly description: "Query parameters for the request";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly body: {
+                    readonly type: "object";
+                    readonly description: "Request body for create/update operations";
+                };
+            };
+            readonly required: readonly ["resourceName", "operation"];
+        };
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEnG,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGlE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4JlB,CAAC"}