@cesteral/gads-mcp 1.0.0

package/dist/mcp-server/tools/definitions/get-insights.tool.js

@@ -0,0 +1,246 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { addComputedMetrics } from "../utils/computed-metrics.js";
+import { createReportView, formatReportViewResponse, getReportViewFetchLimit, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+const TOOL_NAME = "gads_get_insights";
+const TOOL_TITLE = "Google Ads Performance Insights";
+const TOOL_DESCRIPTION = `Get performance insights for Google Ads entities using preset parameters.
+
+Convenience wrapper around GAQL that constructs queries from simple inputs. For ad-hoc queries, use \`gads_gaql_search\` directly.
+
+**Supported entity types:** campaign, adGroup, ad, keyword
+
+**Default metrics:** impressions, clicks, cost_micros, conversions, ctr, average_cpc
+
+**Date ranges:** Preset (TODAY, YESTERDAY, LAST_7_DAYS, etc.) OR custom (startDate + endDate)
+
+**Computed metrics:** Set includeComputedMetrics=true for derived CPA, ROAS, CPM`;
+const ENTITY_TYPE_ENUM = ["campaign", "adGroup", "ad", "keyword"];
+const METRIC_NAME_PATTERN = /^(metrics\.)?[a-z_][a-z0-9_]*$/;
+const DATE_RANGE_ENUM = [
+    "TODAY",
+    "YESTERDAY",
+    "LAST_7_DAYS",
+    "LAST_30_DAYS",
+    "THIS_MONTH",
+    "LAST_MONTH",
+    "LAST_90_DAYS",
+];
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const DEFAULT_METRICS = [
+    "metrics.impressions",
+    "metrics.clicks",
+    "metrics.cost_micros",
+    "metrics.conversions",
+    "metrics.ctr",
+    "metrics.average_cpc",
+];
+const GAQL_RESOURCE_MAP = {
+    campaign: "campaign",
+    adGroup: "ad_group",
+    ad: "ad_group_ad",
+    keyword: "keyword_view",
+};
+const ENTITY_ID_FIELD_MAP = {
+    campaign: "campaign.id",
+    adGroup: "ad_group.id",
+    ad: "ad_group_ad.ad.id",
+    keyword: "ad_group_criterion.criterion_id",
+};
+const ENTITY_NAME_FIELD_MAP = {
+    campaign: "campaign.name",
+    adGroup: "ad_group.name",
+    ad: "ad_group_ad.ad.name",
+    keyword: "ad_group_criterion.keyword.text",
+};
+export const GetInsightsInputSchema = z
+    .object({
+    customerId: z
+        .string()
+        .regex(/^\d+$/, "customerId must be numeric")
+        .describe("Google Ads customer ID (no dashes)"),
+    entityType: z.enum(ENTITY_TYPE_ENUM).describe("Type of entity to get insights for"),
+    entityId: z
+        .string()
+        .regex(/^\d+$/, "entityId must be numeric")
+        .optional()
+        .describe("Filter to a specific entity ID"),
+    dateRange: z
+        .enum(DATE_RANGE_ENUM)
+        .optional()
+        .describe("Preset date range for metrics (use this OR startDate+endDate)"),
+    startDate: z
+        .string()
+        .regex(DATE_PATTERN, "startDate must be YYYY-MM-DD")
+        .optional()
+        .describe("Custom start date (YYYY-MM-DD) — requires endDate"),
+    endDate: z
+        .string()
+        .regex(DATE_PATTERN, "endDate must be YYYY-MM-DD")
+        .optional()
+        .describe("Custom end date (YYYY-MM-DD) — requires startDate"),
+    metrics: z
+        .array(z
+        .string()
+        .regex(METRIC_NAME_PATTERN, "metrics must be metric names like 'clicks' or 'metrics.clicks'"))
+        .optional()
+        .describe("Metrics to include (defaults to impressions, clicks, cost_micros, conversions, ctr, average_cpc)"),
+    includeComputedMetrics: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Include computed CPA, ROAS, CPM derived from raw metrics"),
+    limit: z
+        .number()
+        .min(1)
+        .max(10000)
+        .optional()
+        .describe("Deprecated. Use maxRows for the returned row count."),
+})
+    .merge(ReportViewInputSchema)
+    .refine((data) => {
+    const hasPreset = !!data.dateRange;
+    const hasCustomStart = !!data.startDate;
+    const hasCustomEnd = !!data.endDate;
+    if (hasPreset && (hasCustomStart || hasCustomEnd))
+        return false;
+    if (!hasPreset && !hasCustomStart && !hasCustomEnd)
+        return false;
+    if (hasCustomStart !== hasCustomEnd)
+        return false;
+    return true;
+}, {
+    message: "Provide either dateRange OR both startDate and endDate (not both, not neither)",
+})
+    .refine((data) => {
+    if (data.startDate && data.endDate) {
+        return data.startDate <= data.endDate;
+    }
+    return true;
+}, {
+    message: "startDate must be on or before endDate",
+})
+    .describe("Parameters for getting Google Ads performance insights");
+export const GetInsightsOutputSchema = z
+    .object({
+    ...ReportViewOutputSchema.shape,
+    totalResults: z.number().describe("Number of results returned"),
+    dateRange: z.string().describe("Date range used"),
+    startDate: z.string().optional().describe("Custom start date (when used)"),
+    endDate: z.string().optional().describe("Custom end date (when used)"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Google Ads performance insights");
+function buildGaqlQuery(input) {
+    const resource = GAQL_RESOURCE_MAP[input.entityType];
+    const idField = ENTITY_ID_FIELD_MAP[input.entityType];
+    const nameField = ENTITY_NAME_FIELD_MAP[input.entityType];
+    const metricFields = input.metrics && input.metrics.length > 0
+        ? input.metrics.map((m) => {
+            if (!METRIC_NAME_PATTERN.test(m)) {
+                throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid metric name: ${m}`);
+            }
+            return m.startsWith("metrics.") ? m : `metrics.${m}`;
+        })
+        : DEFAULT_METRICS;
+    const selectFields = [idField, nameField, ...metricFields].join(", ");
+    const whereClauses = [];
+    if (input.dateRange) {
+        whereClauses.push(`segments.date DURING ${input.dateRange}`);
+    }
+    else if (input.startDate && input.endDate) {
+        whereClauses.push(`segments.date BETWEEN '${input.startDate}' AND '${input.endDate}'`);
+    }
+    if (input.entityId) {
+        if (!/^\d+$/.test(input.entityId)) {
+            throw new McpError(JsonRpcErrorCode.InvalidParams, "entityId must be numeric");
+        }
+        whereClauses.push(`${idField} = ${input.entityId}`);
+    }
+    const whereClause = whereClauses.join(" AND ");
+    return `SELECT ${selectFields} FROM ${resource} WHERE ${whereClause} ORDER BY metrics.impressions DESC LIMIT ${input.limit} PARAMETERS omit_unselected_resource_names=true`;
+}
+export async function getInsightsLogic(input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const viewInput = input.maxRows === undefined && input.limit !== undefined
+        ? { ...input, maxRows: input.limit }
+        : input;
+    const query = buildGaqlQuery({ ...input, limit: getReportViewFetchLimit(viewInput) });
+    const result = await gadsService.gaqlSearch(input.customerId, query, getReportViewFetchLimit(viewInput), undefined, context);
+    let results = result.results;
+    if (input.includeComputedMetrics) {
+        results = results.map(addComputedMetrics);
+    }
+    const dateRangeLabel = input.dateRange || `${input.startDate} to ${input.endDate}`;
+    return {
+        ...createReportView({
+            rows: results,
+            totalRows: results.length + (result.nextPageToken ? 1 : 0),
+            input: viewInput,
+            warnings: result.nextPageToken
+                ? [
+                    "More rows are available. Use gads_gaql_search with the returned page token to continue.",
+                ]
+                : [],
+        }),
+        totalResults: results.length,
+        dateRange: dateRangeLabel,
+        ...(input.startDate && { startDate: input.startDate }),
+        ...(input.endDate && { endDate: input.endDate }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getInsightsResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Insights (${result.dateRange}): ${result.returnedRows} result(s)\n\n${formatReportViewResponse(result, "Insight data")}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getInsightsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetInsightsInputSchema,
+    outputSchema: GetInsightsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Campaign performance last 30 days",
+            input: {
+                customerId: "1234567890",
+                entityType: "campaign",
+                dateRange: "LAST_30_DAYS",
+            },
+        },
+        {
+            label: "Ad group metrics for specific campaign",
+            input: {
+                customerId: "1234567890",
+                entityType: "adGroup",
+                dateRange: "LAST_7_DAYS",
+                limit: 100,
+            },
+        },
+        {
+            label: "Custom date range with computed metrics",
+            input: {
+                customerId: "1234567890",
+                entityType: "campaign",
+                startDate: "2026-01-01",
+                endDate: "2026-01-31",
+                includeComputedMetrics: true,
+            },
+        },
+    ],
+    logic: getInsightsLogic,
+    responseFormatter: getInsightsResponseFormatter,
+};
+//# sourceMappingURL=get-insights.tool.js.map

package/dist/mcp-server/tools/definitions/get-insights.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-insights.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-insights.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAI9D,MAAM,SAAS,GAAG,mBAAmB,CAAC;AACtC,MAAM,UAAU,GAAG,iCAAiC,CAAC;AACrD,MAAM,gBAAgB,GAAG;;;;;;;;;;iFAUwD,CAAC;AAElF,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAU,CAAC;AAC3E,MAAM,mBAAmB,GAAG,gCAAgC,CAAC;AAE7D,MAAM,eAAe,GAAG;IACtB,OAAO;IACP,WAAW;IACX,aAAa;IACb,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,cAAc;CACN,CAAC;AAEX,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAE3C,MAAM,eAAe,GAAG;IACtB,qBAAqB;IACrB,gBAAgB;IAChB,qBAAqB;IACrB,qBAAqB;IACrB,aAAa;IACb,qBAAqB;CACtB,CAAC;AAEF,MAAM,iBAAiB,GAA2B;IAChD,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,UAAU;IACnB,EAAE,EAAE,aAAa;IACjB,OAAO,EAAE,cAAc;CACxB,CAAC;AAEF,MAAM,mBAAmB,GAA2B;IAClD,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,aAAa;IACtB,EAAE,EAAE,mBAAmB;IACvB,OAAO,EAAE,iCAAiC;CAC3C,CAAC;AAEF,MAAM,qBAAqB,GAA2B;IACpD,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE,eAAe;IACxB,EAAE,EAAE,qBAAqB;IACzB,OAAO,EAAE,iCAAiC;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,4BAA4B,CAAC;SAC5C,QAAQ,CAAC,oCAAoC,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACnF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC;SAC1C,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,eAAe,CAAC;SACrB,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,KAAK,CAAC,YAAY,EAAE,8BAA8B,CAAC;SACnD,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,YAAY,EAAE,4BAA4B,CAAC;SACjD,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC;SACE,MAAM,EAAE;SACR,KAAK,CACJ,mBAAmB,EACnB,gEAAgE,CACjE,CACJ;SACA,QAAQ,EAAE;SACV,QAAQ,CACP,kGAAkG,CACnG;IACH,sBAAsB,EAAE,CAAC;SACtB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,0DAA0D,CAAC;IACvE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC;KACD,KAAK,CAAC,qBAAqB,CAAC;KAC5B,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACxC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IAEpC,IAAI,SAAS,IAAI,CAAC,cAAc,IAAI,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,cAAc,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC,EACD;IACE,OAAO,EAAE,gFAAgF;CAC1F,CACF;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,EACD;IACE,OAAO,EAAE,wCAAwC;CAClD,CACF;KACA,QAAQ,CAAC,wDAAwD,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,GAAG,sBAAsB,CAAC,KAAK;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,iCAAiC,CAAC,CAAC;AAK/C,SAAS,cAAc,CAAC,KAAuB;IAC7C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAE1D,MAAM,YAAY,GAChB,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,wBAAwB,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,CAAC,CAAC;QACJ,CAAC,CAAC,eAAe,CAAC;IAEtB,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtE,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,YAAY,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5C,YAAY,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,SAAS,UAAU,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;QACjF,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE/C,OAAO,UAAU,YAAY,SAAS,QAAQ,UAAU,WAAW,4CAA4C,KAAK,CAAC,KAAK,iDAAiD,CAAC;AAC9K,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAuB,EACvB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC3D,MAAM,SAAS,GACb,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QACtD,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE;QACpC,CAAC,CAAC,KAAK,CAAC;IAEZ,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CACzC,KAAK,CAAC,UAAU,EAChB,KAAK,EACL,uBAAuB,CAAC,SAAS,CAAC,EAClC,SAAS,EACT,OAAO,CACR,CAAC;IAEF,IAAI,OAAO,GAAG,MAAM,CAAC,OAA2C,CAAC;IAEjE,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,IAAI,GAAG,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;IAEnF,OAAO;QACL,GAAG,gBAAgB,CAAC;YAClB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM,CAAC,aAAa;gBAC5B,CAAC,CAAC;oBACE,yFAAyF;iBAC1F;gBACH,CAAC,CAAC,EAAE;SACP,CAAC;QACF,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,SAAS,EAAE,cAAc;QACzB,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAChD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAyB;IACpE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,aAAa,MAAM,CAAC,SAAS,MAAM,MAAM,CAAC,YAAY,iBAAiB,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAClK;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,sBAAsB;IACnC,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,mCAAmC;YAC1C,KAAK,EAAE;gBACL,UAAU,EAAE,YAAY;gBACxB,UAAU,EAAE,UAAU;gBACtB,SAAS,EAAE,cAAc;aAC1B;SACF;QACD;YACE,KAAK,EAAE,wCAAwC;YAC/C,KAAK,EAAE;gBACL,UAAU,EAAE,YAAY;gBACxB,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,aAAa;gBACxB,KAAK,EAAE,GAAG;aACX;SACF;QACD;YACE,KAAK,EAAE,yCAAyC;YAChD,KAAK,EAAE;gBACL,UAAU,EAAE,YAAY;gBACxB,UAAU,EAAE,UAAU;gBACtB,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,YAAY;gBACrB,sBAAsB,EAAE,IAAI;aAC7B;SACF;KACF;IACD,KAAK,EAAE,gBAAgB;IACvB,iBAAiB,EAAE,4BAA4B;CAChD,CAAC"}

package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext, ToolDefinition } from "@cesteral/shared";
+export declare const GetPacingStatusInputSchema: z.ZodObject<{
+    customerId: z.ZodString;
+    campaignId: z.ZodString;
+    spendToDate: z.ZodNumber;
+    budgetTotal: z.ZodNumber;
+    flightStartDate: z.ZodString;
+    flightEndDate: z.ZodString;
+    currency: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    campaignId: string;
+    spendToDate: number;
+    budgetTotal: number;
+    flightStartDate: string;
+    flightEndDate: string;
+    currency: string;
+}, {
+    customerId: string;
+    campaignId: string;
+    spendToDate: number;
+    budgetTotal: number;
+    flightStartDate: string;
+    flightEndDate: string;
+    currency?: string | undefined;
+}>;
+export declare const GetPacingStatusOutputSchema: z.ZodObject<{
+    customerId: z.ZodString;
+    campaignId: z.ZodString;
+    budget: z.ZodObject<{
+        total: z.ZodNumber;
+        spent: z.ZodNumber;
+        remaining: z.ZodNumber;
+        currency: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    }, {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    }>;
+    flight: z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        daysElapsed: z.ZodNumber;
+        daysRemaining: z.ZodNumber;
+        totalDays: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    }, {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    }>;
+    pacing: z.ZodObject<{
+        expectedSpendPercent: z.ZodNumber;
+        actualSpendPercent: z.ZodNumber;
+        pacingRatio: z.ZodNumber;
+        status: z.ZodEnum<["ON_PACE", "AHEAD", "BEHIND", "SEVERELY_BEHIND"]>;
+        projectedEndSpend: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    }, {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    campaignId: string;
+    timestamp: string;
+    budget: {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    };
+    flight: {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    };
+    pacing: {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    };
+}, {
+    customerId: string;
+    campaignId: string;
+    timestamp: string;
+    budget: {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    };
+    flight: {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    };
+    pacing: {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    };
+}>;
+export type GetPacingStatusInput = z.infer<typeof GetPacingStatusInputSchema>;
+export type GetPacingStatusOutput = z.infer<typeof GetPacingStatusOutputSchema>;
+export declare function getPacingStatusLogic(input: GetPacingStatusInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<GetPacingStatusOutput>;
+export declare function getPacingStatusResponseFormatter(result: GetPacingStatusOutput, _input: GetPacingStatusInput): McpTextContent[];
+export declare const getPacingStatusTool: ToolDefinition<typeof GetPacingStatusInputSchema, typeof GetPacingStatusOutputSchema>;
+//# sourceMappingURL=get-pacing-status.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pacing-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-pacing-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAUnE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;EAsBsB,CAAC;AAK9D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BI,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAKhF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,qBAAqB,CAAC,CAiChC;AAKD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,oBAAoB,GAC3B,cAAc,EAAE,CAkClB;AAKD,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAC9C,OAAO,0BAA0B,EACjC,OAAO,2BAA2B,CAyCnC,CAAC"}

package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js

@@ -0,0 +1,163 @@
+import { z } from "zod";
+import { calculatePacingStatus } from "@cesteral/shared";
+const TOOL_NAME = "gads_get_pacing_status";
+const TOOL_TITLE = "Get Pacing Status";
+const TOOL_DESCRIPTION = "Calculate real-time pacing status for a Google Ads campaign (actual vs expected delivery). Requires budget, spend to date, and flight dates as inputs. Note: spendToDate should be in actual currency units (not micros).";
+export const GetPacingStatusInputSchema = z
+    .object({
+    customerId: z
+        .string()
+        .regex(/^\d+$/, "Customer ID must contain only digits (no dashes)")
+        .describe("Google Ads customer ID (no dashes)"),
+    campaignId: z.string().describe("Google Ads Campaign ID"),
+    spendToDate: z
+        .number()
+        .min(0)
+        .describe("Total spend to date in account currency (not micros — actual currency units)"),
+    budgetTotal: z.number().min(0).describe("Total campaign budget in account currency"),
+    flightStartDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("Flight start date (YYYY-MM-DD)"),
+    flightEndDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("Flight end date (YYYY-MM-DD)"),
+    currency: z.string().default("USD").describe("Currency code (default: USD)"),
+})
+    .describe("Parameters for checking campaign pacing status");
+export const GetPacingStatusOutputSchema = z
+    .object({
+    customerId: z.string(),
+    campaignId: z.string(),
+    budget: z.object({
+        total: z.number(),
+        spent: z.number(),
+        remaining: z.number(),
+        currency: z.string(),
+    }),
+    flight: z.object({
+        startDate: z.string(),
+        endDate: z.string(),
+        daysElapsed: z.number(),
+        daysRemaining: z.number(),
+        totalDays: z.number(),
+    }),
+    pacing: z.object({
+        expectedSpendPercent: z.number(),
+        actualSpendPercent: z.number(),
+        pacingRatio: z.number().describe("actual / expected (1.0 = on pace)"),
+        status: z.enum(["ON_PACE", "AHEAD", "BEHIND", "SEVERELY_BEHIND"]),
+        projectedEndSpend: z.number(),
+    }),
+    timestamp: z.string().datetime(),
+})
+    .describe("Campaign pacing status result");
+export async function getPacingStatusLogic(input, _context, _sdkContext) {
+    const pacingStatus = calculatePacingStatus({
+        spendToDate: input.spendToDate,
+        budgetTotal: input.budgetTotal,
+        flightStartDate: input.flightStartDate,
+        flightEndDate: input.flightEndDate,
+    });
+    return {
+        customerId: input.customerId,
+        campaignId: input.campaignId,
+        budget: {
+            total: input.budgetTotal,
+            spent: input.spendToDate,
+            remaining: Math.max(0, input.budgetTotal - input.spendToDate),
+            currency: input.currency,
+        },
+        flight: {
+            startDate: input.flightStartDate,
+            endDate: input.flightEndDate,
+            daysElapsed: pacingStatus.daysElapsed,
+            daysRemaining: pacingStatus.daysRemaining,
+            totalDays: pacingStatus.totalDays,
+        },
+        pacing: {
+            expectedSpendPercent: pacingStatus.expectedSpendPercent,
+            actualSpendPercent: pacingStatus.actualSpendPercent,
+            pacingRatio: pacingStatus.pacingRatio,
+            status: pacingStatus.status,
+            projectedEndSpend: pacingStatus.projectedEndSpend,
+        },
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getPacingStatusResponseFormatter(result, _input) {
+    const statusEmoji = result.pacing.status === "ON_PACE"
+        ? "[OK]"
+        : result.pacing.status === "AHEAD"
+            ? "[AHEAD]"
+            : result.pacing.status === "BEHIND"
+                ? "[BEHIND]"
+                : "[CRITICAL]";
+    return [
+        {
+            type: "text",
+            text: `Campaign "${result.campaignId}" Pacing Status:
+
+${statusEmoji} Status: ${result.pacing.status}
+
+Budget:
+• Total: $${result.budget.total.toLocaleString()}
+• Spent: $${result.budget.spent.toLocaleString()} (${result.pacing.actualSpendPercent.toFixed(1)}%)
+• Remaining: $${result.budget.remaining.toLocaleString()}
+
+Flight:
+• ${result.flight.startDate} to ${result.flight.endDate}
+• Days: ${result.flight.daysElapsed} elapsed / ${result.flight.totalDays} total
+• Days Remaining: ${result.flight.daysRemaining}
+
+Pacing Analysis:
+• Expected Spend: ${result.pacing.expectedSpendPercent.toFixed(1)}%
+• Actual Spend: ${result.pacing.actualSpendPercent.toFixed(1)}%
+• Pacing Ratio: ${result.pacing.pacingRatio.toFixed(2)}x
+• Projected End Spend: $${result.pacing.projectedEndSpend.toFixed(2)}`,
+        },
+    ];
+}
+export const getPacingStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetPacingStatusInputSchema,
+    outputSchema: GetPacingStatusOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Check pacing for a standard monthly campaign",
+            input: {
+                customerId: "1234567890",
+                campaignId: "9876543",
+                spendToDate: 18000,
+                budgetTotal: 50000,
+                flightStartDate: "2026-03-01",
+                flightEndDate: "2026-03-31",
+                currency: "USD",
+            },
+        },
+        {
+            label: "Check pacing for a short-burst campaign in GBP",
+            input: {
+                customerId: "9876543210",
+                campaignId: "1122334",
+                spendToDate: 4200,
+                budgetTotal: 10000,
+                flightStartDate: "2026-03-15",
+                flightEndDate: "2026-03-21",
+                currency: "GBP",
+            },
+        },
+    ],
+    logic: getPacingStatusLogic,
+    responseFormatter: getPacingStatusResponseFormatter,
+};
+//# sourceMappingURL=get-pacing-status.tool.js.map

package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map

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

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,18 @@
+export { gaqlSearchTool } from "./gaql-search.tool.js";
+export { listAccountsTool } from "./list-accounts.tool.js";
+export { getEntityTool } from "./get-entity.tool.js";
+export { listEntitiesTool } from "./list-entities.tool.js";
+export { getInsightsTool } from "./get-insights.tool.js";
+export { createEntityTool } from "./create-entity.tool.js";
+export { updateEntityTool } from "./update-entity.tool.js";
+export { removeEntityTool } from "./remove-entity.tool.js";
+export { bulkMutateTool } from "./bulk-mutate.tool.js";
+export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+export { validateEntityTool } from "./validate-entity.tool.js";
+export { adjustBidsTool } from "./adjust-bids.tool.js";
+export { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { getPacingStatusTool } from "./get-pacing-status.tool.js";
+import { type ToolDefinitionForFactory } from "@cesteral/shared";
+export declare const allTools: ToolDefinitionForFactory[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAiBlE,OAAO,EAAoB,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AA6BnF,eAAO,MAAM,QAAQ,EAAE,wBAAwB,EAG9C,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,53 @@
+export { gaqlSearchTool } from "./gaql-search.tool.js";
+export { listAccountsTool } from "./list-accounts.tool.js";
+export { getEntityTool } from "./get-entity.tool.js";
+export { listEntitiesTool } from "./list-entities.tool.js";
+export { getInsightsTool } from "./get-insights.tool.js";
+export { createEntityTool } from "./create-entity.tool.js";
+export { updateEntityTool } from "./update-entity.tool.js";
+export { removeEntityTool } from "./remove-entity.tool.js";
+export { bulkMutateTool } from "./bulk-mutate.tool.js";
+export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+export { validateEntityTool } from "./validate-entity.tool.js";
+export { adjustBidsTool } from "./adjust-bids.tool.js";
+export { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { getPacingStatusTool } from "./get-pacing-status.tool.js";
+import { gaqlSearchTool } from "./gaql-search.tool.js";
+import { listAccountsTool } from "./list-accounts.tool.js";
+import { getEntityTool } from "./get-entity.tool.js";
+import { listEntitiesTool } from "./list-entities.tool.js";
+import { getInsightsTool } from "./get-insights.tool.js";
+import { createEntityTool } from "./create-entity.tool.js";
+import { updateEntityTool } from "./update-entity.tool.js";
+import { removeEntityTool } from "./remove-entity.tool.js";
+import { bulkMutateTool } from "./bulk-mutate.tool.js";
+import { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+import { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+import { validateEntityTool } from "./validate-entity.tool.js";
+import { adjustBidsTool } from "./adjust-bids.tool.js";
+import { getAdPreviewTool } from "./get-ad-preview.tool.js";
+import { getPacingStatusTool } from "./get-pacing-status.tool.js";
+import { conformanceTools } from "@cesteral/shared";
+const productionTools = [
+    gaqlSearchTool,
+    listAccountsTool,
+    getEntityTool,
+    listEntitiesTool,
+    getInsightsTool,
+    createEntityTool,
+    updateEntityTool,
+    removeEntityTool,
+    bulkMutateTool,
+    bulkCreateEntitiesTool,
+    bulkUpdateStatusTool,
+    adjustBidsTool,
+    validateEntityTool,
+    getAdPreviewTool,
+    getPacingStatusTool,
+];
+export const allTools = [
+    ...productionTools,
+    ...(process.env.MCP_INCLUDE_CONFORMANCE_TOOLS === "true" ? conformanceTools : []),
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAiC,MAAM,kBAAkB,CAAC;AAEnF,MAAM,eAAe,GAA+B;IAElD,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,eAAe;IAEf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,sBAAsB;IACtB,oBAAoB;IACpB,cAAc;IAEd,kBAAkB;IAElB,gBAAgB;IAEhB,mBAAmB;CACpB,CAAC;AAMF,MAAM,CAAC,MAAM,QAAQ,GAA+B;IAClD,GAAG,eAAe;IAClB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;CAClF,CAAC"}