@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/agent/tools/apis/api-validation-orchestrator.js

@@ -0,0 +1,562 @@
+import { resolve } from "node:path";
+import yaml from "yaml";
+import { safeJsonStringify } from "../../../../util/log-sanitizer.js";
+import { getPrefixedLogger } from "../../../../util/logger.js";
+import { Paths } from "../../../const.js";
+import { AGENT_NEEDS_USER_INPUT, ClarkStateNames, } from "../../../state-machine/clark-fsm.js";
+import { sendInteractiveMessageChannel } from "../../../state-machine/helpers/peer.js";
+import { renderPath } from "../../../transform/shared.js";
+import { ApiExecutor } from "./api-executor.js";
+var ApiValidationStage;
+(function (ApiValidationStage) {
+    ApiValidationStage["REGISTRATION"] = "registration";
+    ApiValidationStage["EXECUTE"] = "execute";
+    ApiValidationStage["AUTH"] = "auth";
+    ApiValidationStage["RESULTS"] = "results";
+    ApiValidationStage["METADATA"] = "metadata";
+})(ApiValidationStage || (ApiValidationStage = {}));
+class ApiValidationEscalatedError extends Error {
+    issues;
+    summary;
+    constructor(summary, issues) {
+        super(`${summary}\n\nAutomation has requested user input via the UI prompt. Wait for the user's response before proceeding.`);
+        this.name = "ApiValidationEscalatedError";
+        this.issues = issues;
+        this.summary = summary;
+    }
+}
+const DEFAULT_OPTIONS = {
+    maxRegistrationAttempts: 5,
+    maxExecutionAttempts: 3,
+    validateMetadata: false,
+};
+const initAttempts = () => ({
+    [ApiValidationStage.REGISTRATION]: 0,
+    [ApiValidationStage.EXECUTE]: 0,
+    [ApiValidationStage.AUTH]: 0,
+    [ApiValidationStage.RESULTS]: 0,
+    [ApiValidationStage.METADATA]: 0,
+});
+/**
+ * Execute the automated API validation pipeline, progressing through execution,
+ * authentication, parameter, metadata, and result validation stages.
+ */
+export const runApiValidationPipeline = async (params) => {
+    const { clark, services, identifier } = params;
+    const logger = params.logger ?? getPrefixedLogger(`[validateApi-${identifier}]`);
+    logger.info("Starting API validation pipeline", identifier);
+    const validationKey = makeValidationKey(identifier);
+    activeValidations.add(validationKey);
+    try {
+        return await (async () => {
+            const options = {
+                ...DEFAULT_OPTIONS,
+                ...params.options,
+            };
+            const attempts = initAttempts();
+            const issues = [];
+            if (options.validateMetadata) {
+                let apiDefinition;
+                try {
+                    apiDefinition = await loadApiDefinition(identifier, services, params.sourcePath);
+                    logger.info("Loaded API definition for validation", safeJsonStringify({ hasDefinition: apiDefinition !== undefined }, 2));
+                }
+                catch (error) {
+                    logger.error(`Failed to load API definition: ${error instanceof Error ? error.message : String(error)}`);
+                    issues.push({
+                        stage: ApiValidationStage.EXECUTE,
+                        reason: "Unable to load API definition",
+                        recoverable: false,
+                        attempt: attempts[ApiValidationStage.EXECUTE],
+                        error: error instanceof Error ? error.message : safeJsonStringify(error),
+                    });
+                    return await escalateToUser({
+                        clark,
+                        services,
+                        identifier,
+                        issues,
+                        attempts,
+                        logger,
+                    });
+                }
+                try {
+                    await ensureIntegrationMetadataReady({
+                        api: apiDefinition,
+                        clark,
+                        services,
+                        attempts,
+                        logger,
+                        issues,
+                    });
+                }
+                catch (_error) {
+                    return await escalateToUser({
+                        clark,
+                        services,
+                        identifier,
+                        issues,
+                        attempts,
+                        logger,
+                    });
+                }
+            }
+            const editorClient = clark.context.peer;
+            if (!editorClient) {
+                throw new Error("No editor client available to execute APIs");
+            }
+            const executor = new ApiExecutor(editorClient, services.integrationStore);
+            let lastExecution;
+            const inputs = params.inputs ?? {};
+            while (attempts[ApiValidationStage.EXECUTE] < options.maxExecutionAttempts) {
+                attempts[ApiValidationStage.EXECUTE] += 1;
+                logger.info("Executing API validation attempt", safeJsonStringify({ attempt: attempts[ApiValidationStage.EXECUTE] }, 2));
+                const execution = await executor.execute({ type: "fetch", apiName: identifier }, inputs, {
+                    includeStepOutputs: !options.omitStepOutputs,
+                    timeout: options.timeout,
+                });
+                if (execution.success) {
+                    const hasUsefulResult = hasMeaningfulResult(execution);
+                    if (!hasUsefulResult) {
+                        attempts[ApiValidationStage.RESULTS] += 1;
+                        issues.push({
+                            stage: ApiValidationStage.RESULTS,
+                            reason: "API executed but returned no usable data",
+                            recoverable: false,
+                            attempt: attempts[ApiValidationStage.RESULTS],
+                            error: "Execution outputs were empty or undefined.",
+                        });
+                        return {
+                            success: false,
+                            summary: `Validation failed after ${attempts[ApiValidationStage.EXECUTE]} execution attempt(s).`,
+                            issues,
+                            attempts,
+                            executionResult: execution,
+                            escalated: false,
+                        };
+                    }
+                    logger.info("API validation succeeded", safeJsonStringify({ attempts: attempts[ApiValidationStage.EXECUTE] }, 2));
+                    return {
+                        success: true,
+                        summary: `Validation succeeded after ${attempts[ApiValidationStage.EXECUTE]} execution attempt(s).`,
+                        issues,
+                        attempts,
+                        executionResult: execution,
+                        escalated: false,
+                    };
+                }
+                lastExecution = execution;
+                const errors = execution.errors ?? [];
+                const unhandledErrors = errors.filter((error) => !error.handled);
+                const primaryError = selectPrimaryError(unhandledErrors);
+                const additionalErrors = primaryError
+                    ? unhandledErrors.filter((error) => error !== primaryError)
+                    : [];
+                if (primaryError) {
+                    switch (primaryError.type) {
+                        case "auth":
+                            issues.push({
+                                stage: ApiValidationStage.AUTH,
+                                reason: "Access error",
+                                recoverable: false,
+                                attempt: attempts[ApiValidationStage.AUTH],
+                                error: primaryError.message,
+                                suggestion: primaryError.suggestion,
+                            });
+                            addAdditionalIssues({
+                                errors: additionalErrors,
+                                issues,
+                                attempts,
+                            });
+                            return await escalateToUser({
+                                clark,
+                                services,
+                                identifier,
+                                issues,
+                                attempts,
+                                logger,
+                            });
+                        case "rate_limit": {
+                            attempts[ApiValidationStage.EXECUTE] += 1;
+                            issues.push({
+                                stage: primaryError.type,
+                                reason: primaryError.displayMessage ||
+                                    primaryError.message ||
+                                    "Rate limit encountered",
+                                recoverable: attempts[ApiValidationStage.EXECUTE] <
+                                    options.maxExecutionAttempts,
+                                attempt: attempts[ApiValidationStage.EXECUTE],
+                                error: primaryError.bodyDetails || primaryError.message,
+                                suggestion: primaryError.suggestion,
+                            });
+                            addAdditionalIssues({
+                                errors: additionalErrors,
+                                issues,
+                                attempts,
+                            });
+                            if (attempts[ApiValidationStage.EXECUTE] >=
+                                options.maxExecutionAttempts) {
+                                return await escalateToUser({
+                                    clark,
+                                    services,
+                                    identifier,
+                                    issues,
+                                    attempts,
+                                    logger,
+                                });
+                            }
+                            await delay(500 * attempts[ApiValidationStage.EXECUTE]);
+                            continue;
+                        }
+                        case "validation":
+                        case "binding":
+                        case "execution": {
+                            const registrationFailure = /API ['"][^'"]+['"] not found/i.test(primaryError.message ?? "");
+                            if (registrationFailure) {
+                                attempts[ApiValidationStage.REGISTRATION] += 1;
+                                logger.warn("API not yet registered in editor; retrying", safeJsonStringify({
+                                    registrationAttempt: attempts[ApiValidationStage.REGISTRATION],
+                                    executionAttempt: attempts[ApiValidationStage.EXECUTE],
+                                    message: primaryError.message,
+                                }, 2));
+                                if (attempts[ApiValidationStage.REGISTRATION] >=
+                                    options.maxRegistrationAttempts) {
+                                    // Registration failures are not user-actionable, they indicate a system timing issue
+                                    // Log the issue but don't escalate - throw an error for the LLM to see
+                                    const detail = primaryError.bodyDetails ??
+                                        primaryError.message ??
+                                        undefined;
+                                    const alreadyLogged = hasIssueWithDetail(issues, ApiValidationStage.REGISTRATION, detail);
+                                    issues.push({
+                                        stage: ApiValidationStage.REGISTRATION,
+                                        reason: "API failed to register in the editor after multiple attempts",
+                                        recoverable: false,
+                                        attempt: attempts[ApiValidationStage.REGISTRATION],
+                                        error: alreadyLogged ? undefined : detail,
+                                        suggestion: "This indicates a race condition or system issue. The API was built successfully but did not become available for execution.",
+                                    });
+                                    addAdditionalIssues({
+                                        errors: additionalErrors,
+                                        issues,
+                                        attempts,
+                                    });
+                                    throw new Error(`API registration timeout: ${identifier} failed to register after ${attempts[ApiValidationStage.REGISTRATION]} attempts. ` +
+                                        `This typically indicates a race condition or system issue, not a user error.`);
+                                }
+                                // Use exponential backoff for registration retries: 200ms, 400ms, 800ms, 1600ms, 3200ms
+                                await delay(200 *
+                                    Math.pow(2, attempts[ApiValidationStage.REGISTRATION] - 1));
+                                continue;
+                            }
+                            return {
+                                success: false,
+                                summary: `Validation failed with a ${primaryError.type} error`,
+                                issues,
+                                attempts,
+                                executionResult: execution,
+                                escalated: false,
+                            };
+                        }
+                        default:
+                            break;
+                    }
+                }
+            }
+            return {
+                success: false,
+                summary: "Exceeded maximum execution retries",
+                issues,
+                attempts,
+                executionResult: lastExecution,
+                escalated: false,
+            };
+        })();
+    }
+    finally {
+        activeValidations.delete(validationKey);
+        await flushPendingEscalations({
+            clark,
+            services,
+            logger,
+        });
+    }
+};
+const LOAD_FAILURE_MESSAGE = "Unable to parse the generated API YAML.";
+const escalateToUser = async (params) => {
+    const { identifier, issues, attempts, logger } = params;
+    logger.warn("Escalating API validation failure to the user", safeJsonStringify({ issues }, 2));
+    const key = makeValidationKey(identifier);
+    pendingEscalations.set(key, {
+        identifier,
+        issues: issues.map((issue) => ({ ...issue })),
+    });
+    logger.info("Queued API validation escalation for aggregated handling", safeJsonStringify({
+        apiName: identifier,
+        pendingEscalations: pendingEscalations.size,
+    }));
+    const summary = `Validation failed after ${attempts[ApiValidationStage.EXECUTE]} execution attempt(s). User input required.`;
+    logger.info("Validation escalation recorded", safeJsonStringify({ summary, issueCount: issues.length }, 2));
+    throw new ApiValidationEscalatedError(summary, issues);
+};
+const getErrorMessageFromStage = (identifier, stage) => {
+    switch (stage) {
+        case ApiValidationStage.AUTH:
+            return `I can't successfully test ${identifier} due to authentication errors. How would you like to proceed?`;
+        case ApiValidationStage.EXECUTE:
+        case ApiValidationStage.REGISTRATION:
+            return `I can't successfully test ${identifier} due to connection errors. How would you like to proceed?`;
+        case ApiValidationStage.METADATA:
+            return `I can't successfully test ${identifier} due to metadata errors. How would you like to proceed?`;
+        case ApiValidationStage.RESULTS:
+            return `I can't successfully test ${identifier} due to invalid response errors. How would you like to proceed?`;
+        default:
+            return `I can't successfully test ${identifier} due to an unknown error. How would you like to proceed?`;
+    }
+};
+const _guessBetterParams = (message, currentInputs) => {
+    const guess = { ...currentInputs };
+    let mutated = false;
+    const requiredParamMatch = message.match(/"([^"]+)" is required/);
+    const paramName = requiredParamMatch?.[1];
+    if (typeof paramName === "string") {
+        if (guess[paramName] === undefined) {
+            guess[paramName] = "sample";
+            mutated = true;
+        }
+    }
+    const missingBindingMatch = message.match(/ReferenceError: (\w+) is not defined/);
+    const variableName = missingBindingMatch?.[1];
+    if (typeof variableName === "string") {
+        guess[variableName] = "sample";
+        mutated = true;
+    }
+    return mutated ? guess : undefined;
+};
+const hasMeaningfulResult = (result) => {
+    if (!result.outputs) {
+        return false;
+    }
+    return Object.values(result.outputs).some((value) => {
+        if (value === null || value === undefined) {
+            return false;
+        }
+        if (Array.isArray(value)) {
+            return value.length > 0;
+        }
+        if (typeof value === "object") {
+            return Object.keys(value).length > 0;
+        }
+        return true;
+    });
+};
+const loadApiDefinition = async (identifier, services, sourcePath) => {
+    const filePath = sourcePath ??
+        renderPath(Paths.ApiYamls, {
+            apiName: identifier,
+        });
+    // Guard against path traversal: a caller-supplied sourcePath must resolve
+    // within the application root directory.
+    if (sourcePath !== undefined) {
+        const appRoot = resolve(services.appRootDirPath);
+        const resolved = resolve(sourcePath);
+        if (!resolved.startsWith(appRoot + "/") && resolved !== appRoot) {
+            throw new Error(`sourcePath "${sourcePath}" resolves outside the application root`);
+        }
+    }
+    const files = await services.appShell.readFiles([filePath]);
+    if (!files?.[0]) {
+        throw new Error(LOAD_FAILURE_MESSAGE);
+    }
+    try {
+        const parsed = yaml.parse(files[0].content);
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : LOAD_FAILURE_MESSAGE);
+    }
+};
+const delay = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+const ensureIntegrationMetadataReady = async ({ api, clark, services, attempts, logger, issues, }) => {
+    const editorClient = clark.context.peer;
+    if (!editorClient) {
+        logger.warn("Skipping metadata fetch because no editor client is available");
+        return;
+    }
+    const integrationIds = extractIntegrationIds(api);
+    if (integrationIds.length === 0) {
+        return;
+    }
+    logger.info("Ensuring integration metadata is available", safeJsonStringify({ integrationIds }, 2));
+    const metadataResults = await Promise.all(integrationIds.map(async (integrationId) => {
+        try {
+            const metadata = await services.integrationStore.getMetadata(integrationId, editorClient);
+            logger.info("Fetched integration metadata", safeJsonStringify({
+                integrationId,
+                gronPath: metadata?._gronPath,
+            }, 2));
+            return { integrationId, metadata };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`Failed to fetch integration metadata for ${integrationId}: ${message}`);
+            return { integrationId, error: message };
+        }
+    }));
+    const failures = metadataResults.filter((result) => result.error !== undefined);
+    if (failures.length === 0) {
+        return;
+    }
+    attempts[ApiValidationStage.METADATA] += 1;
+    failures.forEach(({ integrationId, error }) => {
+        issues.push({
+            stage: ApiValidationStage.METADATA,
+            reason: `Failed to load metadata for integration ${integrationId}`,
+            recoverable: false,
+            attempt: attempts[ApiValidationStage.METADATA],
+            error: error,
+            suggestion: "Confirm the integration is accessible and the credentials are valid. Try reloading metadata manually from the integrations panel.",
+        });
+    });
+    throw new ApiValidationEscalatedError("Integration metadata is required to validate the API.", issues);
+};
+const extractIntegrationIds = (api) => {
+    const ids = new Set();
+    for (const block of api.blocks || []) {
+        const integration = block?.step?.integration;
+        if (integration &&
+            integration !== "javascript" &&
+            integration !== "python") {
+            ids.add(integration);
+        }
+    }
+    return Array.from(ids);
+};
+const ERROR_PRIORITY = [
+    "auth",
+    "rate_limit",
+    "validation",
+    "binding",
+    "execution",
+    "proto",
+    "unknown",
+];
+const selectPrimaryError = (errors) => {
+    for (const type of ERROR_PRIORITY) {
+        const match = errors.find((error) => error.type === type);
+        if (match) {
+            return match;
+        }
+    }
+    return undefined;
+};
+const addAdditionalIssues = ({ errors, issues, attempts, }) => {
+    for (const error of errors) {
+        const stage = mapErrorTypeToStage(error.type);
+        if (hasIssueWithDetail(issues, stage, error.message)) {
+            continue;
+        }
+        issues.push({
+            stage,
+            reason: error.displayMessage ||
+                error.message ||
+                `Additional ${error.type.replace("_", " ")} error encountered`,
+            recoverable: false,
+            attempt: attempts[stage],
+            error: error.bodyDetails || error.message,
+            suggestion: error.suggestion,
+        });
+    }
+};
+const mapErrorTypeToStage = (type) => {
+    switch (type) {
+        case "auth":
+            return ApiValidationStage.AUTH;
+        default:
+            return ApiValidationStage.EXECUTE;
+    }
+};
+const hasIssueWithDetail = (issues, stage, detail) => {
+    if (!detail) {
+        return false;
+    }
+    return issues.some((issue) => issue.stage === stage && issue.error === detail);
+};
+const activeValidations = new Set();
+const pendingEscalations = new Map();
+const makeValidationKey = (identifier) => identifier;
+/**
+ * Checks if there are any pending escalations.
+ */
+export const hasPendingEscalations = () => {
+    return pendingEscalations.size > 0;
+};
+/**
+ * Flushes pending escalations by sending a multi_choice message to the user.
+ * Returns true if an escalation was sent, false otherwise.
+ */
+export const flushPendingEscalations = async ({ clark, services, logger, force = false, skipStateTransition = false, }) => {
+    if (activeValidations.size > 0) {
+        return false;
+    }
+    if (pendingEscalations.size === 0) {
+        return false;
+    }
+    if (!force && clark.state === ClarkStateNames.AwaitingUser) {
+        logger.info("Clark already awaiting user input; deferring aggregated escalation", safeJsonStringify({ pendingEscalations: pendingEscalations.size }, 2));
+        return false;
+    }
+    const entries = Array.from(pendingEscalations.values());
+    const identifier = entries[0]?.identifier;
+    const primaryIssue = entries[0]?.issues[0];
+    if (!primaryIssue || !identifier) {
+        return false;
+    }
+    const question = getErrorMessageFromStage(identifier, primaryIssue.stage);
+    const description = `${primaryIssue.reason}. ${primaryIssue.suggestion}`;
+    const error = primaryIssue.error;
+    const choices = [
+        {
+            text: "Ignore and continue",
+            subText: "Will result in runtime errors when running the API",
+        },
+        {
+            text: "Use mock data",
+            subText: "Allows you to test the UI but will require an API update later to connect to real data",
+        },
+        {
+            text: "Try again",
+            subText: "Try the API validation again to see if the issue persists",
+        },
+    ];
+    try {
+        const sendInteractiveMessage = sendInteractiveMessageChannel(clark, services.chatSessionStore);
+        const result = await sendInteractiveMessage({
+            role: "assistant",
+            type: "multi_choice",
+            content: question,
+            choices,
+            selectionType: "single",
+            questionType: "api_integration_error",
+            details: error,
+            subtitle: description,
+        });
+        if (!result.success) {
+            logger.warn(`Aggregated escalation prompt was not delivered: ${result.message}`);
+            return false;
+        }
+    }
+    catch (error) {
+        logger.error(`Aggregated escalation prompt threw an error: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+    pendingEscalations.clear();
+    if (!skipStateTransition) {
+        void clark.send({
+            type: AGENT_NEEDS_USER_INPUT,
+            countsAsPromptSuccess: true,
+        });
+    }
+    return true;
+};
+//# sourceMappingURL=api-validation-orchestrator.js.map

package/dist/ai-service/agent/tools/apis/api-validation-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-validation-orchestrator.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/api-validation-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tools/apis/build-api-artifact.d.ts

@@ -0,0 +1,51 @@
+import type { Api } from "@superblocksteam/library-shared/types";
+import { getPrefixedLogger } from "../../../../util/logger.js";
+import type { OperationQueue } from "../../../../util/operation-queue.js";
+import type { IntegrationStore } from "../../../integrations/store.js";
+import type { ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
+import type { FileArtifact } from "../../../types.js";
+import type { ApiIdentifier } from "../../subagents/apis/types.js";
+/**
+ * Integration output type definitions.
+ * Source of truth for what each integration returns.
+ */
+export declare const INTEGRATION_OUTPUT_TYPES: Record<string, string>;
+/**
+ * Get the output type for a specific block.
+ * Control flow blocks return their last child's output.
+ * @internal Exported for testing only
+ */
+export declare function getBlockOutputType(block: any): string;
+/**
+ * Determine the output type of an API based on its last block.
+ * The API response is always the output of the last block executed.
+ * @internal Exported for testing only
+ */
+export declare function determineApiOutputType(apiJson: any): string;
+interface BuildApiArtifactParams {
+    apiName: ApiIdentifier;
+    services: ClarkStateHandlerParams;
+    scopeUpdateQueue: OperationQueue;
+    logger?: ReturnType<typeof getPrefixedLogger>;
+}
+interface BuildApiArtifactResult {
+    apiYaml: FileArtifact;
+    isNewApi: boolean;
+    contentChanged: boolean;
+    inputInterface: string;
+    responseType: string;
+}
+/**
+ * Compile an API source file, validate it, and persist the generated YAML artifact.
+ *
+ * @param params - Build parameters including identifiers and shared services.
+ * @returns The generated API YAML artifact and whether the API is newly created.
+ * @throws Error when the API source is missing, compilation fails, or persistence is not possible.
+ */
+export declare const buildApiArtifact: (params: BuildApiArtifactParams) => Promise<BuildApiArtifactResult>;
+/**
+ * Validate that blocks use the correct plugin field name matching the integration's plugin.id.
+ */
+export declare function validateBlockFieldNames(api: Api, integrationStore: IntegrationStore): void;
+export {};
+//# sourceMappingURL=build-api-artifact.d.ts.map

package/dist/ai-service/agent/tools/apis/build-api-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-api-artifact.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/build-api-artifact.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAMjE,OAAO,EAGL,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAOnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+C3D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CA4GrD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAQ3D;AAkDD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,gBAAgB,EAAE,cAAc,CAAC;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;CAC/C;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,sBAAsB,KAC7B,OAAO,CAAC,sBAAsB,CAqLhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,GAAG,EACR,gBAAgB,EAAE,gBAAgB,GACjC,IAAI,CAqDN"}