@cesteral/gads-mcp 1.0.0

package/dist/mcp-server/tools/definitions/bulk-mutate.tool.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue } from "../utils/parent-id-validation.js";
+const TOOL_NAME = "gads_bulk_mutate";
+const TOOL_TITLE = "Bulk Mutate Google Ads Entities";
+const TOOL_DESCRIPTION = `Execute multiple create/update/remove operations in a single API call.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+All operations must target the same entity type and customer. By default, all operations
+succeed or all fail atomically. Set \`partialFailure: true\` to allow partial success.
+
+Each operation object must contain exactly one of:
+- \`{ create: { ...fields } }\` — create a new entity
+- \`{ update: { ...fields, resourceName: "customers/{id}/{type}/{entityId}" }, updateMask: "field1,field2" }\` — update
+- \`{ remove: "customers/{id}/{type}/{entityId}" }\` — remove
+
+Maximum: thousands of operations per call (subject to Google Ads API limits).
+
+**Composite resource names required for:** \`ad\` → use \`customers/{id}/adGroupAds/{adGroupId}~{adId}\`, \`keyword\` → use \`customers/{id}/adGroupCriteria/{adGroupId}~{criterionId}\`.`;
+export const BulkMutateInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to mutate"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    operations: z
+        .array(z.record(z.any()))
+        .min(1)
+        .max(5000)
+        .describe("Array of mutate operation objects (create/update/remove)"),
+    partialFailure: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Allow partial success (default: false = atomic)"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input);
+})
+    .describe("Parameters for bulk mutate operations");
+export const BulkMutateOutputSchema = z
+    .object({
+    mutateResult: z.record(z.any()).describe("Full mutate response"),
+    operationCount: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk mutate result");
+export async function bulkMutateLogic(input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const result = await gadsService.bulkMutate(input.entityType, input.customerId, input.operations, input.partialFailure, context);
+    return {
+        mutateResult: result,
+        operationCount: input.operations.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkMutateResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Bulk mutate completed: ${result.operationCount} operations\n${JSON.stringify(result.mutateResult, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkMutateTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkMutateInputSchema,
+    outputSchema: BulkMutateOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Batch create ad groups",
+            input: {
+                entityType: "adGroup",
+                customerId: "1234567890",
+                operations: [
+                    {
+                        create: {
+                            name: "Brand Terms",
+                            campaign: "customers/1234567890/campaigns/123456",
+                            type: "SEARCH_STANDARD",
+                            status: "PAUSED",
+                            cpcBidMicros: "1500000",
+                        },
+                    },
+                    {
+                        create: {
+                            name: "Generic Terms",
+                            campaign: "customers/1234567890/campaigns/123456",
+                            type: "SEARCH_STANDARD",
+                            status: "PAUSED",
+                            cpcBidMicros: "2000000",
+                        },
+                    },
+                ],
+            },
+        },
+        {
+            label: "Mixed operations with partial failure",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                operations: [
+                    {
+                        update: {
+                            resourceName: "customers/1234567890/campaigns/111",
+                            name: "Updated Campaign Name",
+                        },
+                        updateMask: "name",
+                    },
+                    { remove: "customers/1234567890/campaigns/222" },
+                ],
+                partialFailure: true,
+            },
+        },
+    ],
+    logic: bulkMutateLogic,
+    responseFormatter: bulkMutateResponseFormatter,
+};
+//# sourceMappingURL=bulk-mutate.tool.js.map

package/dist/mcp-server/tools/definitions/bulk-mutate.tool.js.map

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

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts

@@ -0,0 +1,185 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkUpdateStatusInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+    status: z.ZodEnum<["ENABLED", "PAUSED", "REMOVED"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "ENABLED" | "PAUSED" | "REMOVED";
+    customerId: string;
+    entityType: string;
+    entityIds: string[];
+}, {
+    status: "ENABLED" | "PAUSED" | "REMOVED";
+    customerId: string;
+    entityType: string;
+    entityIds: string[];
+}>, {
+    status: "ENABLED" | "PAUSED" | "REMOVED";
+    customerId: string;
+    entityType: string;
+    entityIds: string[];
+}, {
+    status: "ENABLED" | "PAUSED" | "REMOVED";
+    customerId: string;
+    entityType: string;
+    entityIds: string[];
+}>;
+export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodString;
+    targetStatus: z.ZodString;
+    totalRequested: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        entityId: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }, {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    entityType: string;
+    timestamp: string;
+    confirmed: boolean;
+    successCount: number;
+    failureCount: number;
+    targetStatus: string;
+    totalRequested: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    entityType: string;
+    timestamp: string;
+    confirmed: boolean;
+    successCount: number;
+    failureCount: number;
+    targetStatus: string;
+    totalRequested: number;
+    declineReason?: string | undefined;
+}>;
+type BulkStatusInput = z.infer<typeof BulkUpdateStatusInputSchema>;
+type BulkStatusOutput = z.infer<typeof BulkUpdateStatusOutputSchema>;
+export declare function bulkUpdateStatusLogic(input: BulkStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkStatusOutput>;
+export declare function bulkUpdateStatusResponseFormatter(result: BulkStatusOutput): McpTextContent[];
+export declare const bulkUpdateStatusTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        entityIds: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["ENABLED", "PAUSED", "REMOVED"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "ENABLED" | "PAUSED" | "REMOVED";
+        customerId: string;
+        entityType: string;
+        entityIds: string[];
+    }, {
+        status: "ENABLED" | "PAUSED" | "REMOVED";
+        customerId: string;
+        entityType: string;
+        entityIds: string[];
+    }>, {
+        status: "ENABLED" | "PAUSED" | "REMOVED";
+        customerId: string;
+        entityType: string;
+        entityIds: string[];
+    }, {
+        status: "ENABLED" | "PAUSED" | "REMOVED";
+        customerId: string;
+        entityType: string;
+        entityIds: string[];
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        entityType: z.ZodString;
+        targetStatus: z.ZodString;
+        totalRequested: z.ZodNumber;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            entityId: z.ZodString;
+            success: z.ZodBoolean;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }, {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        entityType: string;
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        targetStatus: string;
+        totalRequested: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        entityType: string;
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        targetStatus: string;
+        totalRequested: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            entityIds: string[];
+            status: string;
+        };
+    }[];
+    logic: typeof bulkUpdateStatusLogic;
+    responseFormatter: typeof bulkUpdateStatusResponseFormatter;
+};
+export {};
+//# sourceMappingURL=bulk-update-status.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-update-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;EAsBQ,CAAC;AAEjD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBD,CAAC;AAEzC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACnE,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErE,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAe5F;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ChC,CAAC"}

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getStatusCapableEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue } from "../utils/parent-id-validation.js";
+import { elicitBulkStatusChangeConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "gads_bulk_update_status";
+const TOOL_TITLE = "Bulk Update Google Ads Entity Status";
+const TOOL_DESCRIPTION = `Batch update the status for multiple Google Ads entities of the same type.
+
+**Supported entity types:** ${getStatusCapableEntityTypeEnum().join(", ")}
+
+**Available statuses:**
+- \`ENABLED\` — active and eligible for delivery
+- \`PAUSED\` — temporarily stopped (can be re-enabled)
+- \`REMOVED\` — permanently removed (cannot be un-removed)
+
+Use this tool for batch pause/resume operations across campaigns, ad groups, or ads.
+
+**Composite entityId required for:** \`ad\` → use \`{adGroupId}~{adId}\`, \`keyword\` → use \`{adGroupId}~{criterionId}\`. Other entity types use simple IDs.`;
+export const BulkUpdateStatusInputSchema = z
+    .object({
+    entityType: z
+        .enum(getStatusCapableEntityTypeEnum())
+        .describe("Type of entities to update (only types with a status field)"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    entityIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(100)
+        .describe("Array of entity IDs to update (max 100)"),
+    status: z.enum(["ENABLED", "PAUSED", "REMOVED"]).describe("New entity status"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input, [], { validateCompositeIds: true });
+})
+    .describe("Parameters for bulk status update");
+export const BulkUpdateStatusOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    entityType: z.string(),
+    targetStatus: z.string(),
+    totalRequested: z.number(),
+    successCount: z.number(),
+    failureCount: z.number(),
+    results: z.array(z.object({
+        entityId: z.string(),
+        success: z.boolean(),
+        error: z.string().optional(),
+    })),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk status update result");
+export async function bulkUpdateStatusLogic(input, context, sdkContext) {
+    const confirmed = await elicitBulkStatusChangeConfirmation({
+        count: input.entityIds.length,
+        entityLabel: input.entityType,
+        targetStatus: input.status,
+        impactPreview: input.entityIds,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            entityType: input.entityType,
+            targetStatus: input.status,
+            totalRequested: input.entityIds.length,
+            successCount: 0,
+            failureCount: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const { results } = await gadsService.bulkUpdateStatus(input.entityType, input.customerId, input.entityIds, input.status, context);
+    const succeeded = results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        entityType: input.entityType,
+        targetStatus: input.status,
+        totalRequested: input.entityIds.length,
+        successCount: succeeded,
+        failureCount: input.entityIds.length - succeeded,
+        results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateStatusResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk status update of ${result.totalRequested} ${result.entityType}(s) cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk status update → ${result.targetStatus} for ${result.entityType}: ${result.successCount}/${result.totalRequested} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkUpdateStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateStatusInputSchema,
+    outputSchema: BulkUpdateStatusOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Pause a single campaign",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                entityIds: ["9876543210"],
+                status: "PAUSED",
+            },
+        },
+        {
+            label: "Pause multiple ad groups",
+            input: {
+                entityType: "adGroup",
+                customerId: "1234567890",
+                entityIds: ["1111111111", "2222222222", "3333333333"],
+                status: "PAUSED",
+            },
+        },
+        {
+            label: "Re-enable paused ads",
+            input: {
+                entityType: "ad",
+                customerId: "1234567890",
+                entityIds: ["5555555555~7777777777", "5555555555~8888888888"],
+                status: "ENABLED",
+            },
+        },
+    ],
+    logic: bulkUpdateStatusLogic,
+    responseFormatter: bulkUpdateStatusResponseFormatter,
+};
+//# sourceMappingURL=bulk-update-status.tool.js.map

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map

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

package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const CreateEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    entityType: string;
+    data: Record<string, any>;
+}, {
+    customerId: string;
+    entityType: string;
+    data: Record<string, any>;
+}>, {
+    customerId: string;
+    entityType: string;
+    data: Record<string, any>;
+}, {
+    customerId: string;
+    entityType: string;
+    data: Record<string, any>;
+}>;
+export declare const CreateEntityOutputSchema: z.ZodObject<{
+    mutateResult: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    mutateResult: Record<string, any>;
+}, {
+    timestamp: string;
+    mutateResult: Record<string, any>;
+}>;
+type CreateEntityInput = z.infer<typeof CreateEntityInputSchema>;
+type CreateEntityOutput = z.infer<typeof CreateEntityOutputSchema>;
+export declare function createEntityLogic(input: CreateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateEntityOutput>;
+export declare function createEntityResponseFormatter(result: CreateEntityOutput): McpTextContent[];
+export declare const createEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        entityType: string;
+        data: Record<string, any>;
+    }, {
+        customerId: string;
+        entityType: string;
+        data: Record<string, any>;
+    }>, {
+        customerId: string;
+        entityType: string;
+        data: Record<string, any>;
+    }, {
+        customerId: string;
+        entityType: string;
+        data: Record<string, any>;
+    }>;
+    outputSchema: z.ZodObject<{
+        mutateResult: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        mutateResult: Record<string, any>;
+    }, {
+        timestamp: string;
+        mutateResult: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            data: {
+                name: string;
+                amountMicros: string;
+                deliveryMethod: string;
+                advertisingChannelType?: undefined;
+                status?: undefined;
+                campaignBudget?: undefined;
+                startDate?: undefined;
+                endDate?: undefined;
+                networkSettings?: undefined;
+            };
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            data: {
+                name: string;
+                advertisingChannelType: string;
+                status: string;
+                campaignBudget: string;
+                startDate: string;
+                endDate: string;
+                networkSettings: {
+                    targetGoogleSearch: boolean;
+                    targetSearchNetwork: boolean;
+                    targetContentNetwork: boolean;
+                };
+                amountMicros?: undefined;
+                deliveryMethod?: undefined;
+            };
+        };
+    })[];
+    logic: typeof createEntityLogic;
+    responseFormatter: typeof createEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=create-entity.tool.d.ts.map

package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAanD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;EAesB,CAAC;AAE3D,eAAO,MAAM,wBAAwB;;;;;;;;;EAKA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD5B,CAAC"}