@cesteral/gads-mcp 1.0.0

package/dist/mcp-server/tools/definitions/remove-entity.tool.js

@@ -0,0 +1,120 @@
+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";
+import { elicitDeleteConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "gads_remove_entity";
+const TOOL_TITLE = "Remove Google Ads Entity";
+const TOOL_DESCRIPTION = `Remove a Google Ads entity using the :mutate API.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Warning**: This is a destructive operation. For campaigns and ad groups, consider using \`gads_bulk_update_status\` with status \`PAUSED\` instead of removing.
+
+Note: In Google Ads, "remove" sets the entity status to REMOVED. The entity data is retained but the entity becomes inactive and cannot be re-enabled.
+
+**Composite entityId required for:** \`ad\` → use \`{adGroupId}~{adId}\`, \`keyword\` → use \`{adGroupId}~{criterionId}\`. Other entity types use simple IDs.`;
+export const RemoveEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to remove"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    entityId: z.string().min(1).describe("The entity ID to remove"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input, [], { validateCompositeIds: true });
+})
+    .describe("Parameters for removing a Google Ads entity");
+export const RemoveEntityOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    mutateResult: z.record(z.any()).describe("Mutate operation result"),
+    entityType: z.string(),
+    entityId: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity removal result");
+export async function removeEntityLogic(input, context, sdkContext) {
+    const confirmed = await elicitDeleteConfirmation({
+        entityLabel: input.entityType,
+        entityId: input.entityId,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            mutateResult: {},
+            entityType: input.entityType,
+            entityId: input.entityId,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const result = await gadsService.removeEntity(input.entityType, input.customerId, input.entityId, context);
+    return {
+        confirmed: true,
+        mutateResult: result,
+        entityType: input.entityType,
+        entityId: input.entityId,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function removeEntityResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Removal of ${result.entityType} ${result.entityId} cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Entity removed: ${result.entityType} ${result.entityId}\n${JSON.stringify(result.mutateResult, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const removeEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: RemoveEntityInputSchema,
+    outputSchema: RemoveEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Remove a keyword",
+            input: {
+                entityType: "keyword",
+                customerId: "1234567890",
+                entityId: "5555555555~6666666666",
+            },
+        },
+        {
+            label: "Remove an ad",
+            input: {
+                entityType: "ad",
+                customerId: "1234567890",
+                entityId: "7777777777~8888888888",
+            },
+        },
+        {
+            label: "Remove a campaign budget",
+            input: {
+                entityType: "campaignBudget",
+                customerId: "1234567890",
+                entityId: "9999999999",
+            },
+        },
+    ],
+    logic: removeEntityLogic,
+    responseFormatter: removeEntityResponseFormatter,
+};
+//# sourceMappingURL=remove-entity.tool.js.map

package/dist/mcp-server/tools/definitions/remove-entity.tool.js.map

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

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

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const UpdateEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    entityId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    updateMask: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+    updateMask: string;
+    data: Record<string, any>;
+}, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+    updateMask: string;
+    data: Record<string, any>;
+}>, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+    updateMask: string;
+    data: Record<string, any>;
+}, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+    updateMask: string;
+    data: Record<string, any>;
+}>;
+export declare const UpdateEntityOutputSchema: 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 UpdateEntityInput = z.infer<typeof UpdateEntityInputSchema>;
+type UpdateEntityOutput = z.infer<typeof UpdateEntityOutputSchema>;
+export declare function updateEntityLogic(input: UpdateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateEntityOutput>;
+export declare function updateEntityResponseFormatter(result: UpdateEntityOutput): McpTextContent[];
+export declare const updateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        entityId: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+        updateMask: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+        updateMask: string;
+        data: Record<string, any>;
+    }, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+        updateMask: string;
+        data: Record<string, any>;
+    }>, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+        updateMask: string;
+        data: Record<string, any>;
+    }, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+        updateMask: 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;
+            entityId: string;
+            data: {
+                name: string;
+                status?: undefined;
+            };
+            updateMask: string;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            entityId: string;
+            data: {
+                status: string;
+                name?: undefined;
+            };
+            updateMask: string;
+        };
+    })[];
+    logic: typeof updateEntityLogic;
+    responseFormatter: typeof updateEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=update-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-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;AAenD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBsB,CAAC;AAE3D,eAAO,MAAM,wBAAwB;;;;;;;;;EAKF,CAAC;AAEpC,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,CAgB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC5B,CAAC"}

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

@@ -0,0 +1,91 @@
+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_update_entity";
+const TOOL_TITLE = "Update Google Ads Entity";
+const TOOL_DESCRIPTION = `Update an existing Google Ads entity using the :mutate API with updateMask discipline.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**updateMask is required** — specify which fields to update as a comma-separated string.
+Only fields listed in updateMask will be modified. This prevents accidental overwrites.
+
+Example updateMask: "name,status" or "campaignBudget,startDate"
+
+**Composite entityId required for:** \`ad\` → use \`{adGroupId}~{adId}\`, \`keyword\` → use \`{adGroupId}~{criterionId}\`. Other entity types use simple IDs.`;
+export const UpdateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to update"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    entityId: z.string().min(1).describe("The entity ID to update"),
+    data: z.record(z.any()).describe("Entity data fields to update"),
+    updateMask: z
+        .string()
+        .min(1)
+        .describe("Comma-separated list of fields to update (e.g., 'name,status')"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input, [], { validateCompositeIds: true });
+})
+    .describe("Parameters for updating a Google Ads entity");
+export const UpdateEntityOutputSchema = z
+    .object({
+    mutateResult: z.record(z.any()).describe("Mutate operation result"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity update result");
+export async function updateEntityLogic(input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const result = await gadsService.updateEntity(input.entityType, input.customerId, input.entityId, input.data, input.updateMask, context);
+    return {
+        mutateResult: result,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function updateEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Entity updated successfully\n${JSON.stringify(result.mutateResult, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const updateEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UpdateEntityInputSchema,
+    outputSchema: UpdateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Update campaign name",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                entityId: "123456",
+                data: { name: "Updated Campaign Name" },
+                updateMask: "name",
+            },
+        },
+        {
+            label: "Pause an ad group",
+            input: {
+                entityType: "adGroup",
+                customerId: "1234567890",
+                entityId: "789012",
+                data: { status: "PAUSED" },
+                updateMask: "status",
+            },
+        },
+    ],
+    logic: updateEntityLogic,
+    responseFormatter: updateEntityResponseFormatter,
+};
+//# sourceMappingURL=update-entity.tool.js.map

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

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

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

@@ -0,0 +1,239 @@
+import { z } from "zod";
+import type { RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+import { validateEntityResponseFormatter } from "@cesteral/shared";
+export declare const ValidateEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    mode: z.ZodEnum<["create", "update"]>;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    entityId: z.ZodOptional<z.ZodString>;
+    updateMask: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    entityType: string;
+    mode: "create" | "update";
+    data: Record<string, any>;
+    entityId?: string | undefined;
+    updateMask?: string | undefined;
+}, {
+    customerId: string;
+    entityType: string;
+    mode: "create" | "update";
+    data: Record<string, any>;
+    entityId?: string | undefined;
+    updateMask?: string | undefined;
+}>, {
+    customerId: string;
+    entityType: string;
+    mode: "create" | "update";
+    data: Record<string, any>;
+    entityId?: string | undefined;
+    updateMask?: string | undefined;
+}, {
+    customerId: string;
+    entityType: string;
+    mode: "create" | "update";
+    data: Record<string, any>;
+    entityId?: string | undefined;
+    updateMask?: string | undefined;
+}>;
+export declare const ValidateEntityOutputSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    entityType: z.ZodString;
+    mode: z.ZodString;
+    issues: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        code: z.ZodEnum<["missing", "wrongType", "invalidValue", "readOnly", "custom"]>;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        suggestedValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "warning" | "error" | undefined;
+    }, {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "warning" | "error" | undefined;
+    }>, "many">;
+    nextAction: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    issues: {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "warning" | "error" | undefined;
+    }[];
+    valid: boolean;
+    entityType: string;
+    mode: string;
+    timestamp: string;
+    nextAction?: string | undefined;
+}, {
+    issues: {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "warning" | "error" | undefined;
+    }[];
+    valid: boolean;
+    entityType: string;
+    mode: string;
+    timestamp: string;
+    nextAction?: string | undefined;
+}>;
+type ValidateEntityInput = z.infer<typeof ValidateEntityInputSchema>;
+type ValidateEntityOutput = z.infer<typeof ValidateEntityOutputSchema>;
+export declare function validateEntityLogic(input: ValidateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<ValidateEntityOutput>;
+export declare const validateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        mode: z.ZodEnum<["create", "update"]>;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+        entityId: z.ZodOptional<z.ZodString>;
+        updateMask: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        entityType: string;
+        mode: "create" | "update";
+        data: Record<string, any>;
+        entityId?: string | undefined;
+        updateMask?: string | undefined;
+    }, {
+        customerId: string;
+        entityType: string;
+        mode: "create" | "update";
+        data: Record<string, any>;
+        entityId?: string | undefined;
+        updateMask?: string | undefined;
+    }>, {
+        customerId: string;
+        entityType: string;
+        mode: "create" | "update";
+        data: Record<string, any>;
+        entityId?: string | undefined;
+        updateMask?: string | undefined;
+    }, {
+        customerId: string;
+        entityType: string;
+        mode: "create" | "update";
+        data: Record<string, any>;
+        entityId?: string | undefined;
+        updateMask?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        valid: z.ZodBoolean;
+        entityType: z.ZodString;
+        mode: z.ZodString;
+        issues: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            code: z.ZodEnum<["missing", "wrongType", "invalidValue", "readOnly", "custom"]>;
+            message: z.ZodString;
+            hint: z.ZodOptional<z.ZodString>;
+            suggestedValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+        }, "strip", z.ZodTypeAny, {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "warning" | "error" | undefined;
+        }, {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "warning" | "error" | undefined;
+        }>, "many">;
+        nextAction: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        issues: {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "warning" | "error" | undefined;
+        }[];
+        valid: boolean;
+        entityType: string;
+        mode: string;
+        timestamp: string;
+        nextAction?: string | undefined;
+    }, {
+        issues: {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "warning" | "error" | undefined;
+        }[];
+        valid: boolean;
+        entityType: string;
+        mode: string;
+        timestamp: string;
+        nextAction?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            mode: string;
+            data: {
+                name: string;
+                advertisingChannelType: string;
+                status: string;
+                campaignBudget: string;
+            };
+            entityId?: undefined;
+            updateMask?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            mode: string;
+            entityId: string;
+            data: {
+                name: string;
+                advertisingChannelType?: undefined;
+                status?: undefined;
+                campaignBudget?: undefined;
+            };
+            updateMask: string;
+        };
+    })[];
+    logic: typeof validateEntityLogic;
+    responseFormatter: typeof validateEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=validate-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/validate-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,+BAA+B,EAGhC,MAAM,kBAAkB,CAAC;AAgB1B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCwC,CAAC;AAW/E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYA,CAAC;AAExC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC,CA4C/B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C9B,CAAC"}