@cesteral/gads-mcp 1.0.0

package/dist/mcp-server/resources/definitions/insights-reference.resource.js

@@ -0,0 +1,78 @@
+export const insightsReferenceResource = {
+    uri: "insights-reference://gads",
+    name: "Google Ads Insights Reference",
+    description: "Available metrics, entity types, computed metrics, and date range options for gads_get_insights",
+    mimeType: "text/markdown",
+    getContent: () => `# Google Ads Insights Reference
+
+## Available Metrics
+
+Standard metrics that can be used with \`gads_get_insights\`:
+
+| Metric | Description |
+|--------|-------------|
+| metrics.impressions | Number of ad impressions |
+| metrics.clicks | Number of clicks |
+| metrics.cost_micros | Cost in micros (divide by 1,000,000 for currency units) |
+| metrics.conversions | Number of conversions |
+| metrics.conversions_value | Total conversion value |
+| metrics.ctr | Click-through rate (clicks / impressions) |
+| metrics.average_cpc | Average cost per click |
+| metrics.average_cpm | Average cost per thousand impressions |
+| metrics.interactions | Number of interactions |
+| metrics.interaction_rate | Interaction rate |
+| metrics.all_conversions | All conversions (including cross-device) |
+| metrics.all_conversions_value | All conversions value |
+| metrics.search_impression_share | Search impression share |
+| metrics.search_rank_lost_impression_share | Impression share lost to ad rank |
+| metrics.quality_score | Keyword quality score (keywords only) |
+
+## Supported Entity Types
+
+| Entity Type | GAQL Resource | ID Field | Name Field |
+|-------------|--------------|----------|------------|
+| campaign | campaign | campaign.id | campaign.name |
+| adGroup | ad_group | ad_group.id | ad_group.name |
+| ad | ad_group_ad | ad_group_ad.ad.id | ad_group_ad.ad.name |
+| keyword | keyword_view | ad_group_criterion.criterion_id | ad_group_criterion.keyword.text |
+
+## Computed Metrics
+
+When \`includeComputedMetrics: true\`, these derived metrics are added to each result row:
+
+| Metric | Formula | Null When |
+|--------|---------|-----------|
+| cpa | cost / conversions | conversions = 0 |
+| roas | conversions_value / cost | cost = 0 |
+| cpm | (cost / impressions) × 1000 | impressions = 0 |
+
+Where \`cost = cost_micros / 1,000,000\`.
+
+## Date Range Options
+
+### Preset Ranges
+- \`TODAY\` — Current day
+- \`YESTERDAY\` — Previous day
+- \`LAST_7_DAYS\` — Past 7 days
+- \`LAST_30_DAYS\` — Past 30 days
+- \`THIS_MONTH\` — Current month to date
+- \`LAST_MONTH\` — Previous calendar month
+- \`LAST_90_DAYS\` — Past 90 days
+
+### Custom Ranges
+Provide \`startDate\` and \`endDate\` in YYYY-MM-DD format instead of \`dateRange\`.
+
+Example: \`startDate: "2026-01-01", endDate: "2026-03-31"\`
+
+## Default Metrics
+
+impressions, clicks, cost_micros, conversions, ctr, average_cpc
+
+## Notes
+
+- For ad-hoc queries with custom field selection, use \`gads_gaql_search\` directly
+- cost_micros is in micros — divide by 1,000,000 for the actual currency value
+- keyword quality_score is only available for keyword entity type
+`,
+};
+//# sourceMappingURL=insights-reference.resource.js.map

package/dist/mcp-server/resources/definitions/insights-reference.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/insights-reference.resource.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,yBAAyB,GAAa;IACjD,GAAG,EAAE,2BAA2B;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,iGAAiG;IACnG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEnB;CACA,CAAC"}

package/dist/mcp-server/resources/index.d.ts

@@ -0,0 +1,3 @@
+export type { Resource } from "./types.js";
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/index.js

@@ -0,0 +1,2 @@
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/types.d.ts

@@ -0,0 +1,8 @@
+export interface Resource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    getContent: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp-server/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,QAAQ;IAEvB,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B"}

package/dist/mcp-server/resources/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp-server/resources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":""}

package/dist/mcp-server/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "pino";
+export declare function createMcpServer(logger: Logger, sessionId?: string, gcsBucket?: string): Promise<McpServer>;
+export declare function runStdioServer(server: McpServer, logger: Logger): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA6BnC,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,CAwHpB;AAKD,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF"}

package/dist/mcp-server/server.js

@@ -0,0 +1,124 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { allTools } from "./tools/index.js";
+import { allResources } from "./resources/index.js";
+import { promptRegistry } from "./prompts/index.js";
+import { createOperationContext } from "@cesteral/shared";
+import { sessionServiceStore } from "../services/session-services.js";
+import { extractZodShape, registerToolsFromDefinitions, registerPromptsFromDefinitions, registerStaticResourcesFromDefinitions, InteractionLogger, isConformanceFixturesEnabled, } from "@cesteral/shared";
+import packageJson from "../../package.json" with { type: "json" };
+const GADS_PACKAGE_NAME = "gads-mcp";
+const GADS_PLATFORM = "gads";
+const gadsWorkflowIdByToolName = {
+    gads_gaql_search: "mcp.execute.gads_entity_read",
+    gads_list_accounts: "mcp.execute.gads_entity_read",
+    gads_get_entity: "mcp.execute.gads_entity_read",
+    gads_list_entities: "mcp.execute.gads_entity_read",
+    gads_get_insights: "mcp.execute.gads_entity_read",
+    gads_validate_entity: "mcp.execute.gads_entity_read",
+    gads_create_entity: "mcp.execute.gads_entity_management",
+    gads_update_entity: "mcp.execute.gads_entity_management",
+    gads_remove_entity: "mcp.execute.gads_entity_management",
+    gads_adjust_bids: "mcp.execute.gads_entity_management",
+    gads_bulk_mutate: "mcp.execute.gads_bulk_operations",
+    gads_bulk_create_entities: "mcp.execute.gads_bulk_operations",
+    gads_bulk_update_status: "mcp.execute.gads_bulk_operations",
+    gads_get_ad_preview: "mcp.execute.gads_entity_read",
+};
+export async function createMcpServer(logger, sessionId, gcsBucket) {
+    const server = new McpServer({
+        name: "gads-mcp",
+        version: packageJson.version,
+        description: "Google Ads campaign management and reporting via Google Ads REST API v23. " +
+            "Supports GAQL queries, account listing, and full CRUD for 6 entity types " +
+            "(campaign, adGroup, ad, keyword, campaignBudget, asset) with bulk operations.",
+    }, {
+        capabilities: {
+            logging: {},
+        },
+        instructions: "Google Ads campaign management and reporting server. Supports GAQL queries and full CRUD for 6 entity types via Google Ads REST API v23. " +
+            "Use gads_list_accounts to discover accounts, gads_gaql_search for flexible queries. " +
+            "See MCP Resources for GAQL syntax reference and entity schema details.",
+    });
+    const interactionLogger = new InteractionLogger({
+        serverName: GADS_PACKAGE_NAME,
+        logger,
+        gcsBucket,
+    });
+    registerToolsFromDefinitions({
+        server,
+        tools: allTools,
+        logger,
+        sessionId,
+        transformSchema: (schema) => extractZodShape(schema),
+        createRequestContext: (params) => createOperationContext({
+            operation: params.operation,
+            additionalContext: params.additionalContext,
+        }),
+        defaultTextFormat: "compact",
+        packageName: GADS_PACKAGE_NAME,
+        platform: GADS_PLATFORM,
+        workflowIdByToolName: gadsWorkflowIdByToolName,
+        interactionLogger,
+        authContextResolver: sessionId
+            ? () => sessionServiceStore.getAuthContext(sessionId)
+            : undefined,
+    });
+    registerStaticResourcesFromDefinitions({
+        server,
+        resources: allResources,
+        logger,
+    });
+    if (isConformanceFixturesEnabled()) {
+        const { conformanceResources, conformanceResourceTemplate, conformancePrompts } = await import("@cesteral/shared");
+        const { ResourceTemplate: McpResourceTemplate } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+        registerStaticResourcesFromDefinitions({
+            server,
+            resources: conformanceResources,
+            logger,
+        });
+        const template = new McpResourceTemplate(conformanceResourceTemplate.uriTemplate, {
+            list: undefined,
+        });
+        server.registerResource("conformance_template", template, {
+            description: conformanceResourceTemplate.description,
+            mimeType: conformanceResourceTemplate.mimeType,
+        }, async (uri, variables) => {
+            const id = variables.id || "unknown";
+            const content = conformanceResourceTemplate.getContent(id);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: conformanceResourceTemplate.mimeType,
+                        text: content,
+                    },
+                ],
+            };
+        });
+        registerPromptsFromDefinitions({
+            server: server,
+            prompts: conformancePrompts,
+            logger,
+        });
+    }
+    const allPrompts = Array.from(promptRegistry.values()).map((def) => ({
+        name: def.prompt.name,
+        description: def.prompt.description ?? "",
+        arguments: def.prompt.arguments,
+        generateMessage: def.generateMessage,
+    }));
+    registerPromptsFromDefinitions({
+        server: server,
+        prompts: allPrompts,
+        logger,
+    });
+    return server;
+}
+export async function runStdioServer(server, logger) {
+    logger.info("Starting MCP server with stdio transport");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("MCP server connected via stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp-server/server.js.map

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

package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts

@@ -0,0 +1,270 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const AdjustBidsInputSchema: z.ZodObject<{
+    customerId: z.ZodString;
+    adjustments: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        adGroupId: z.ZodString;
+        cpcBidMicros: z.ZodOptional<z.ZodString>;
+        cpmBidMicros: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adGroupId: string;
+        cpcBidMicros?: string | undefined;
+        cpmBidMicros?: string | undefined;
+    }, {
+        adGroupId: string;
+        cpcBidMicros?: string | undefined;
+        cpmBidMicros?: string | undefined;
+    }>, {
+        adGroupId: string;
+        cpcBidMicros?: string | undefined;
+        cpmBidMicros?: string | undefined;
+    }, {
+        adGroupId: string;
+        cpcBidMicros?: string | undefined;
+        cpmBidMicros?: string | undefined;
+    }>, "many">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    adjustments: {
+        adGroupId: string;
+        cpcBidMicros?: string | undefined;
+        cpmBidMicros?: string | undefined;
+    }[];
+    reason?: string | undefined;
+}, {
+    customerId: string;
+    adjustments: {
+        adGroupId: string;
+        cpcBidMicros?: string | undefined;
+        cpmBidMicros?: string | undefined;
+    }[];
+    reason?: string | undefined;
+}>;
+export declare const AdjustBidsOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    totalRequested: z.ZodNumber;
+    totalSucceeded: z.ZodNumber;
+    totalFailed: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        adGroupId: z.ZodString;
+        adGroupName: z.ZodOptional<z.ZodString>;
+        success: z.ZodBoolean;
+        previousCpcBidMicros: z.ZodOptional<z.ZodString>;
+        previousCpmBidMicros: z.ZodOptional<z.ZodString>;
+        newCpcBidMicros: z.ZodOptional<z.ZodString>;
+        newCpmBidMicros: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adGroupId: string;
+        success: boolean;
+        error?: string | undefined;
+        adGroupName?: string | undefined;
+        previousCpcBidMicros?: string | undefined;
+        previousCpmBidMicros?: string | undefined;
+        newCpcBidMicros?: string | undefined;
+        newCpmBidMicros?: string | undefined;
+    }, {
+        adGroupId: string;
+        success: boolean;
+        error?: string | undefined;
+        adGroupName?: string | undefined;
+        previousCpcBidMicros?: string | undefined;
+        previousCpmBidMicros?: string | undefined;
+        newCpcBidMicros?: string | undefined;
+        newCpmBidMicros?: string | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        adGroupId: string;
+        success: boolean;
+        error?: string | undefined;
+        adGroupName?: string | undefined;
+        previousCpcBidMicros?: string | undefined;
+        previousCpmBidMicros?: string | undefined;
+        newCpcBidMicros?: string | undefined;
+        newCpmBidMicros?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        adGroupId: string;
+        success: boolean;
+        error?: string | undefined;
+        adGroupName?: string | undefined;
+        previousCpcBidMicros?: string | undefined;
+        previousCpmBidMicros?: string | undefined;
+        newCpcBidMicros?: string | undefined;
+        newCpmBidMicros?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    declineReason?: string | undefined;
+}>;
+type AdjustBidsInput = z.infer<typeof AdjustBidsInputSchema>;
+type AdjustBidsOutput = z.infer<typeof AdjustBidsOutputSchema>;
+export declare function adjustBidsLogic(input: AdjustBidsInput, context: RequestContext, sdkContext?: SdkContext): Promise<AdjustBidsOutput>;
+export declare function adjustBidsResponseFormatter(result: AdjustBidsOutput): McpTextContent[];
+export declare const adjustBidsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        customerId: z.ZodString;
+        adjustments: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            adGroupId: z.ZodString;
+            cpcBidMicros: z.ZodOptional<z.ZodString>;
+            cpmBidMicros: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            adGroupId: string;
+            cpcBidMicros?: string | undefined;
+            cpmBidMicros?: string | undefined;
+        }, {
+            adGroupId: string;
+            cpcBidMicros?: string | undefined;
+            cpmBidMicros?: string | undefined;
+        }>, {
+            adGroupId: string;
+            cpcBidMicros?: string | undefined;
+            cpmBidMicros?: string | undefined;
+        }, {
+            adGroupId: string;
+            cpcBidMicros?: string | undefined;
+            cpmBidMicros?: string | undefined;
+        }>, "many">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        adjustments: {
+            adGroupId: string;
+            cpcBidMicros?: string | undefined;
+            cpmBidMicros?: string | undefined;
+        }[];
+        reason?: string | undefined;
+    }, {
+        customerId: string;
+        adjustments: {
+            adGroupId: string;
+            cpcBidMicros?: string | undefined;
+            cpmBidMicros?: string | undefined;
+        }[];
+        reason?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        totalRequested: z.ZodNumber;
+        totalSucceeded: z.ZodNumber;
+        totalFailed: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            adGroupId: z.ZodString;
+            adGroupName: z.ZodOptional<z.ZodString>;
+            success: z.ZodBoolean;
+            previousCpcBidMicros: z.ZodOptional<z.ZodString>;
+            previousCpmBidMicros: z.ZodOptional<z.ZodString>;
+            newCpcBidMicros: z.ZodOptional<z.ZodString>;
+            newCpmBidMicros: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            adGroupId: string;
+            success: boolean;
+            error?: string | undefined;
+            adGroupName?: string | undefined;
+            previousCpcBidMicros?: string | undefined;
+            previousCpmBidMicros?: string | undefined;
+            newCpcBidMicros?: string | undefined;
+            newCpmBidMicros?: string | undefined;
+        }, {
+            adGroupId: string;
+            success: boolean;
+            error?: string | undefined;
+            adGroupName?: string | undefined;
+            previousCpcBidMicros?: string | undefined;
+            previousCpmBidMicros?: string | undefined;
+            newCpcBidMicros?: string | undefined;
+            newCpmBidMicros?: string | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            adGroupId: string;
+            success: boolean;
+            error?: string | undefined;
+            adGroupName?: string | undefined;
+            previousCpcBidMicros?: string | undefined;
+            previousCpmBidMicros?: string | undefined;
+            newCpcBidMicros?: string | undefined;
+            newCpmBidMicros?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        totalSucceeded: number;
+        totalFailed: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            adGroupId: string;
+            success: boolean;
+            error?: string | undefined;
+            adGroupName?: string | undefined;
+            previousCpcBidMicros?: string | undefined;
+            previousCpmBidMicros?: string | undefined;
+            newCpcBidMicros?: string | undefined;
+            newCpmBidMicros?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        totalSucceeded: number;
+        totalFailed: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            customerId: string;
+            adjustments: {
+                adGroupId: string;
+                cpcBidMicros: string;
+            }[];
+            reason?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            customerId: string;
+            adjustments: ({
+                adGroupId: string;
+                cpcBidMicros: string;
+                cpmBidMicros?: undefined;
+            } | {
+                adGroupId: string;
+                cpmBidMicros: string;
+                cpcBidMicros?: undefined;
+            })[];
+            reason: string;
+        };
+    })[];
+    logic: typeof adjustBidsLogic;
+    responseFormatter: typeof adjustBidsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=adjust-bids.tool.d.ts.map

package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-bids.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqBnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkC2B,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBE,CAAC;AAEtC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA2C3B;AASD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAuCtF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC"}