@cesteral/gads-mcp 1.0.0

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

@@ -0,0 +1,151 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { validateEntityResponseFormatter, buildNextAction, } from "@cesteral/shared";
+const TOOL_NAME = "gads_validate_entity";
+const TOOL_TITLE = "Google Ads Entity Validation (Dry Run)";
+const TOOL_DESCRIPTION = `Validate an entity payload without creating or modifying it. Uses Google Ads \`validateOnly\` mode for true server-side validation.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Sends the payload to the Google Ads :mutate endpoint with \`validateOnly: true\`, which performs full server-side validation without any side effects.
+
+**Modes:**
+- **create**: Validates a create operation payload
+- **update**: Validates an update operation payload (requires \`entityId\` and \`updateMask\`)
+
+**Composite entityId required for:** \`ad\` -> use \`{adGroupId}~{adId}\`, \`keyword\` -> use \`{adGroupId}~{criterionId}\`. Other entity types use simple IDs.`;
+export const ValidateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to validate"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    mode: z
+        .enum(["create", "update"])
+        .describe("Validation mode: 'create' for new entity, 'update' for existing"),
+    data: z
+        .record(z.any())
+        .describe("Entity data payload to validate (fields vary by entity type — see entity-schema resources)"),
+    entityId: z.string().optional().describe("Entity ID (required for update mode)"),
+    updateMask: z
+        .string()
+        .optional()
+        .describe("Comma-separated list of fields to update (required for update mode, e.g., 'name,status')"),
+})
+    .superRefine((input, ctx) => {
+    if (input.mode === "update") {
+        if (!input.entityId) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "entityId is required when mode is 'update'",
+                path: ["entityId"],
+            });
+        }
+        if (!input.updateMask) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "updateMask is required when mode is 'update'",
+                path: ["updateMask"],
+            });
+        }
+    }
+})
+    .describe("Parameters for validating a Google Ads entity payload (dry run)");
+const ValidationIssueSchema = z.object({
+    field: z.string(),
+    code: z.enum(["missing", "wrongType", "invalidValue", "readOnly", "custom"]),
+    message: z.string(),
+    hint: z.string().optional(),
+    suggestedValues: z.array(z.string()).optional(),
+    severity: z.enum(["error", "warning"]).optional(),
+});
+export const ValidateEntityOutputSchema = z
+    .object({
+    valid: z.boolean().describe("Whether the payload passed validation"),
+    entityType: z.string(),
+    mode: z.string(),
+    issues: z.array(ValidationIssueSchema).describe("Structured per-field issues"),
+    nextAction: z
+        .string()
+        .optional()
+        .describe("One-line guidance for resolving validation failures."),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity validation result");
+export async function validateEntityLogic(input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const result = await gadsService.validateEntity(input.entityType, input.customerId, input.data, input.mode, input.entityId, input.updateMask, context);
+    const issues = (result.errors ?? []).map((message) => ({
+        field: "",
+        code: "custom",
+        message,
+        severity: "error",
+    }));
+    let nextAction;
+    if (!result.valid) {
+        nextAction =
+            input.mode === "create" && !input.customerId
+                ? buildNextAction({
+                    kind: "discover-account",
+                    tool: "gads_list_accounts",
+                    field: "customerId",
+                })
+                : buildNextAction({
+                    kind: "list-entity",
+                    tool: "gads_list_entities",
+                    entityType: input.entityType,
+                });
+    }
+    return {
+        valid: result.valid,
+        entityType: input.entityType,
+        mode: input.mode,
+        issues,
+        ...(nextAction ? { nextAction } : {}),
+        timestamp: new Date().toISOString(),
+    };
+}
+export const validateEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ValidateEntityInputSchema,
+    outputSchema: ValidateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Validate a new campaign (create mode)",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                mode: "create",
+                data: {
+                    name: "Test Campaign",
+                    advertisingChannelType: "SEARCH",
+                    status: "PAUSED",
+                    campaignBudget: "customers/1234567890/campaignBudgets/5678",
+                },
+            },
+        },
+        {
+            label: "Validate a campaign update",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                mode: "update",
+                entityId: "123456",
+                data: {
+                    name: "Updated Campaign",
+                },
+                updateMask: "name",
+            },
+        },
+    ],
+    logic: validateEntityLogic,
+    responseFormatter: validateEntityResponseFormatter,
+};
+//# sourceMappingURL=validate-entity.tool.js.map

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

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

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

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

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

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

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

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

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

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

package/dist/mcp-server/tools/utils/computed-metrics.d.ts

@@ -0,0 +1,8 @@
+export interface ComputedMetrics {
+    cpa: number | null;
+    roas: number | null;
+    cpm: number | null;
+}
+export declare function computeMetrics(metrics: Record<string, unknown>): ComputedMetrics;
+export declare function addComputedMetrics(row: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=computed-metrics.d.ts.map

package/dist/mcp-server/tools/utils/computed-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-metrics.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/computed-metrics.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAWhF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAMhF"}

package/dist/mcp-server/tools/utils/computed-metrics.js

@@ -0,0 +1,19 @@
+export function computeMetrics(metrics) {
+    const cost = Number(metrics.cost_micros || 0) / 1_000_000;
+    const conversions = Number(metrics.conversions || 0);
+    const conversionsValue = Number(metrics.conversions_value || 0);
+    const impressions = Number(metrics.impressions || 0);
+    return {
+        cpa: conversions > 0 ? cost / conversions : null,
+        roas: cost > 0 ? conversionsValue / cost : null,
+        cpm: impressions > 0 ? (cost / impressions) * 1000 : null,
+    };
+}
+export function addComputedMetrics(row) {
+    const metrics = row.metrics || {};
+    return {
+        ...row,
+        computedMetrics: computeMetrics(metrics),
+    };
+}
+//# sourceMappingURL=computed-metrics.js.map

package/dist/mcp-server/tools/utils/computed-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-metrics.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/computed-metrics.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,cAAc,CAAC,OAAgC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IAErD,OAAO;QACL,GAAG,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI;QAChD,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI;QAC/C,GAAG,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAwB;IACzD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,OAAO;QACL,GAAG,GAAG;QACN,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/mcp-server/tools/utils/entity-mapping.d.ts

@@ -0,0 +1,22 @@
+export type GAdsEntityType = "campaign" | "adGroup" | "ad" | "keyword" | "campaignBudget" | "asset";
+export type ParentIdKey = "customerId" | "campaignId" | "adGroupId";
+export type MutateOp = "create" | "update" | "remove";
+export interface GAdsEntityConfig {
+    gaqlResource: string;
+    mutateEndpoint: string;
+    resourceNamePattern: string;
+    parentIds: ParentIdKey[];
+    idField: string;
+    statusField?: string;
+    nameField?: string;
+    supportedMutateOps: readonly MutateOp[];
+}
+export declare function assertMutateOpSupported(entityType: GAdsEntityType, op: MutateOp): void;
+export declare function getEntityConfig(entityType: GAdsEntityType): GAdsEntityConfig;
+export declare function getSupportedEntityTypes(): GAdsEntityType[];
+export declare function getEntityTypeEnum(): [string, ...string[]];
+export declare function getStatusCapableEntityTypes(): GAdsEntityType[];
+export declare function getStatusCapableEntityTypeEnum(): [string, ...string[]];
+export declare function buildResourceName(entityType: GAdsEntityType, customerId: string, entityId: string): string;
+export declare function buildMutateUrl(entityType: GAdsEntityType, customerId: string): string;
+//# sourceMappingURL=entity-mapping.d.ts.map

package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAEpG,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;AAEpE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAE/B,YAAY,EAAE,MAAM,CAAC;IAErB,cAAc,EAAE,MAAM,CAAC;IAEvB,mBAAmB,EAAE,MAAM,CAAC;IAE5B,SAAS,EAAE,WAAW,EAAE,CAAC;IAEzB,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kBAAkB,EAAE,SAAS,QAAQ,EAAE,CAAC;CACzC;AAmED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAQtF;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,gBAAgB,CAS5E;AAED,wBAAgB,uBAAuB,IAAI,cAAc,EAAE,CAE1D;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGzD;AAMD,wBAAgB,2BAA2B,IAAI,cAAc,EAAE,CAI9D;AAED,wBAAgB,8BAA8B,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGtE;AAMD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAMD,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGrF"}

package/dist/mcp-server/tools/utils/entity-mapping.js

@@ -0,0 +1,99 @@
+import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
+const ALL_MUTATE_OPS = ["create", "update", "remove"];
+const ENTITY_CONFIGS = {
+    campaign: {
+        gaqlResource: "campaign",
+        mutateEndpoint: "campaigns",
+        resourceNamePattern: "customers/{customerId}/campaigns/{campaignId}",
+        parentIds: ["customerId"],
+        idField: "campaign.id",
+        statusField: "campaign.status",
+        nameField: "campaign.name",
+        supportedMutateOps: ALL_MUTATE_OPS,
+    },
+    adGroup: {
+        gaqlResource: "ad_group",
+        mutateEndpoint: "adGroups",
+        resourceNamePattern: "customers/{customerId}/adGroups/{adGroupId}",
+        parentIds: ["customerId"],
+        idField: "ad_group.id",
+        statusField: "ad_group.status",
+        nameField: "ad_group.name",
+        supportedMutateOps: ALL_MUTATE_OPS,
+    },
+    ad: {
+        gaqlResource: "ad_group_ad",
+        mutateEndpoint: "adGroupAds",
+        resourceNamePattern: "customers/{customerId}/adGroupAds/{adGroupId}~{adId}",
+        parentIds: ["customerId"],
+        idField: "ad_group_ad.ad.id",
+        statusField: "ad_group_ad.status",
+        nameField: "ad_group_ad.ad.name",
+        supportedMutateOps: ALL_MUTATE_OPS,
+    },
+    keyword: {
+        gaqlResource: "ad_group_criterion",
+        mutateEndpoint: "adGroupCriteria",
+        resourceNamePattern: "customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}",
+        parentIds: ["customerId"],
+        idField: "ad_group_criterion.criterion_id",
+        statusField: "ad_group_criterion.status",
+        supportedMutateOps: ALL_MUTATE_OPS,
+    },
+    campaignBudget: {
+        gaqlResource: "campaign_budget",
+        mutateEndpoint: "campaignBudgets",
+        resourceNamePattern: "customers/{customerId}/campaignBudgets/{budgetId}",
+        parentIds: ["customerId"],
+        idField: "campaign_budget.id",
+        nameField: "campaign_budget.name",
+        supportedMutateOps: ALL_MUTATE_OPS,
+    },
+    asset: {
+        gaqlResource: "asset",
+        mutateEndpoint: "assets",
+        resourceNamePattern: "customers/{customerId}/assets/{assetId}",
+        parentIds: ["customerId"],
+        idField: "asset.id",
+        nameField: "asset.name",
+        supportedMutateOps: ["create"],
+    },
+};
+export function assertMutateOpSupported(entityType, op) {
+    const config = ENTITY_CONFIGS[entityType];
+    if (!config.supportedMutateOps.includes(op)) {
+        throw new McpError(JsonRpcErrorCode.InvalidParams, `Google Ads API does not support ${op} on ${entityType} entities (supported: ${config.supportedMutateOps.join(", ")})`);
+    }
+}
+export function getEntityConfig(entityType) {
+    const config = ENTITY_CONFIGS[entityType];
+    if (!config) {
+        throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown Google Ads entity type: ${entityType}`);
+    }
+    return config;
+}
+export function getSupportedEntityTypes() {
+    return Object.keys(ENTITY_CONFIGS);
+}
+export function getEntityTypeEnum() {
+    const types = getSupportedEntityTypes();
+    return types;
+}
+export function getStatusCapableEntityTypes() {
+    return Object.entries(ENTITY_CONFIGS)
+        .filter(([, config]) => !!config.statusField)
+        .map(([type]) => type);
+}
+export function getStatusCapableEntityTypeEnum() {
+    const types = getStatusCapableEntityTypes();
+    return types;
+}
+export function buildResourceName(entityType, customerId, entityId) {
+    const config = getEntityConfig(entityType);
+    return `customers/${customerId}/${config.mutateEndpoint}/${entityId}`;
+}
+export function buildMutateUrl(entityType, customerId) {
+    const config = getEntityConfig(entityType);
+    return `/customers/${customerId}/${config.mutateEndpoint}:mutate`;
+}
+//# sourceMappingURL=entity-mapping.js.map

package/dist/mcp-server/tools/utils/entity-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAyC9D,MAAM,cAAc,GAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAE3E,MAAM,cAAc,GAA6C;IAC/D,QAAQ,EAAE;QACR,YAAY,EAAE,UAAU;QACxB,cAAc,EAAE,WAAW;QAC3B,mBAAmB,EAAE,+CAA+C;QACpE,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,iBAAiB;QAC9B,SAAS,EAAE,eAAe;QAC1B,kBAAkB,EAAE,cAAc;KACnC;IACD,OAAO,EAAE;QACP,YAAY,EAAE,UAAU;QACxB,cAAc,EAAE,UAAU;QAC1B,mBAAmB,EAAE,6CAA6C;QAClE,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,iBAAiB;QAC9B,SAAS,EAAE,eAAe;QAC1B,kBAAkB,EAAE,cAAc;KACnC;IACD,EAAE,EAAE;QACF,YAAY,EAAE,aAAa;QAC3B,cAAc,EAAE,YAAY;QAC5B,mBAAmB,EAAE,sDAAsD;QAC3E,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,qBAAqB;QAChC,kBAAkB,EAAE,cAAc;KACnC;IACD,OAAO,EAAE;QACP,YAAY,EAAE,oBAAoB;QAClC,cAAc,EAAE,iBAAiB;QACjC,mBAAmB,EAAE,kEAAkE;QACvF,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EAAE,2BAA2B;QACxC,kBAAkB,EAAE,cAAc;KACnC;IACD,cAAc,EAAE;QACd,YAAY,EAAE,iBAAiB;QAC/B,cAAc,EAAE,iBAAiB;QACjC,mBAAmB,EAAE,mDAAmD;QACxE,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;QACjC,kBAAkB,EAAE,cAAc;KACnC;IACD,KAAK,EAAE;QAIL,YAAY,EAAE,OAAO;QACrB,cAAc,EAAE,QAAQ;QACxB,mBAAmB,EAAE,yCAAyC;QAC9D,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,YAAY;QACvB,kBAAkB,EAAE,CAAC,QAAQ,CAAC;KAC/B;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,UAA0B,EAAE,EAAY;IAC9E,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,mCAAmC,EAAE,OAAO,UAAU,yBAAyB,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA0B;IACxD,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,mCAAmC,UAAU,EAAE,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAqB,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;IACxC,OAAO,KAA8B,CAAC;AACxC,CAAC;AAMD,MAAM,UAAU,2BAA2B;IACzC,OAAQ,MAAM,CAAC,OAAO,CAAC,cAAc,CAA0C;SAC5E,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;SAC5C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,MAAM,KAAK,GAAG,2BAA2B,EAAE,CAAC;IAC5C,OAAO,KAA8B,CAAC;AACxC,CAAC;AAMD,MAAM,UAAU,iBAAiB,CAC/B,UAA0B,EAC1B,UAAkB,EAClB,QAAgB;IAEhB,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,aAAa,UAAU,IAAI,MAAM,CAAC,cAAc,IAAI,QAAQ,EAAE,CAAC;AACxE,CAAC;AAMD,MAAM,UAAU,cAAc,CAAC,UAA0B,EAAE,UAAkB;IAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,cAAc,UAAU,IAAI,MAAM,CAAC,cAAc,SAAS,CAAC;AACpE,CAAC"}

package/dist/mcp-server/tools/utils/gaql-helpers.d.ts

@@ -0,0 +1,4 @@
+import { type GAdsEntityType } from "./entity-mapping.js";
+export declare function buildListQuery(entityType: GAdsEntityType, filters?: Record<string, string>, orderBy?: string): string;
+export declare function buildGetByIdQuery(entityType: GAdsEntityType, entityId: string): string;
+//# sourceMappingURL=gaql-helpers.d.ts.map

package/dist/mcp-server/tools/utils/gaql-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaql-helpers.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/gaql-helpers.ts"],"names":[],"mappings":"AAUA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA0D3E,wBAAgB,cAAc,CAC5B,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAoCR;AAKD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAStF"}

package/dist/mcp-server/tools/utils/gaql-helpers.js

@@ -0,0 +1,82 @@
+import { getEntityConfig } from "./entity-mapping.js";
+const DEFAULT_SELECT_FIELDS = {
+    campaign: [
+        "campaign.id",
+        "campaign.name",
+        "campaign.status",
+        "campaign.advertising_channel_type",
+        "campaign.start_date",
+        "campaign.end_date",
+        "campaign.campaign_budget",
+        "campaign.resource_name",
+    ],
+    adGroup: [
+        "ad_group.id",
+        "ad_group.name",
+        "ad_group.status",
+        "ad_group.type",
+        "ad_group.campaign",
+        "ad_group.cpc_bid_micros",
+        "ad_group.cpm_bid_micros",
+        "ad_group.resource_name",
+    ],
+    ad: [
+        "ad_group_ad.ad.id",
+        "ad_group_ad.ad.name",
+        "ad_group_ad.ad.type",
+        "ad_group_ad.status",
+        "ad_group_ad.ad_group",
+        "ad_group_ad.ad.final_urls",
+        "ad_group_ad.resource_name",
+    ],
+    keyword: [
+        "ad_group_criterion.criterion_id",
+        "ad_group_criterion.keyword.text",
+        "ad_group_criterion.keyword.match_type",
+        "ad_group_criterion.status",
+        "ad_group_criterion.ad_group",
+        "ad_group_criterion.resource_name",
+    ],
+    campaignBudget: [
+        "campaign_budget.id",
+        "campaign_budget.name",
+        "campaign_budget.amount_micros",
+        "campaign_budget.delivery_method",
+        "campaign_budget.status",
+        "campaign_budget.resource_name",
+    ],
+    asset: ["asset.id", "asset.name", "asset.type", "asset.resource_name"],
+};
+export function buildListQuery(entityType, filters, orderBy) {
+    const config = getEntityConfig(entityType);
+    const fields = DEFAULT_SELECT_FIELDS[entityType] || [config.idField];
+    let query = `SELECT ${fields.join(", ")} FROM ${config.gaqlResource}`;
+    const conditions = [];
+    if (filters) {
+        for (const [field, value] of Object.entries(filters)) {
+            if (value.match(/^(=|!=|>=|<=|>|<|(?:IN|LIKE|CONTAINS|NOT|BETWEEN|DURING|IS)\b)\s/)) {
+                conditions.push(`${field} ${value}`);
+            }
+            else {
+                conditions.push(`${field} = '${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`);
+            }
+        }
+    }
+    if (conditions.length > 0) {
+        query += ` WHERE ${conditions.join(" AND ")}`;
+    }
+    if (orderBy) {
+        query += ` ORDER BY ${orderBy}`;
+    }
+    query += " PARAMETERS omit_unselected_resource_names=true";
+    return query;
+}
+export function buildGetByIdQuery(entityType, entityId) {
+    if (!/^\d+$/.test(entityId)) {
+        throw new Error(`Invalid entity ID: "${entityId}". Entity IDs must be numeric.`);
+    }
+    const config = getEntityConfig(entityType);
+    const fields = DEFAULT_SELECT_FIELDS[entityType] || [config.idField];
+    return `SELECT ${fields.join(", ")} FROM ${config.gaqlResource} WHERE ${config.idField} = ${entityId} LIMIT 1 PARAMETERS omit_unselected_resource_names=true`;
+}
+//# sourceMappingURL=gaql-helpers.js.map

package/dist/mcp-server/tools/utils/gaql-helpers.js.map

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

package/dist/mcp-server/tools/utils/parent-id-validation.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import { type ParentIdKey, type GAdsEntityType } from "./entity-mapping.js";
+export declare function getRequiredParentIds(entityType: GAdsEntityType): ParentIdKey[];
+export declare function getMissingParentIds(entityType: GAdsEntityType, input: Record<string, unknown>): ParentIdKey[];
+export declare function buildMissingParentIdsMessage(entityType: GAdsEntityType, missing: ParentIdKey[]): string;
+export interface ParentValidationOptions {
+    validateCompositeIds?: boolean;
+}
+export declare function addParentValidationIssue(ctx: z.RefinementCtx, entityType: GAdsEntityType, input: Record<string, unknown>, path?: Array<string | number>, options?: ParentValidationOptions): void;
+//# sourceMappingURL=parent-id-validation.d.ts.map

package/dist/mcp-server/tools/utils/parent-id-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-id-validation.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/parent-id-validation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsB7F,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,GAAG,WAAW,EAAE,CAE9E;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,WAAW,EAAE,CAMf;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,WAAW,EAAE,GACrB,MAAM,CAKR;AAED,MAAM,WAAW,uBAAuB;IAEtC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,CAAC,CAAC,aAAa,EACpB,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAM,EACjC,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAuCN"}

package/dist/mcp-server/tools/utils/parent-id-validation.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { getEntityConfig } from "./entity-mapping.js";
+const COMPOSITE_ID_ENTITIES = {
+    ad: "{adGroupId}~{adId}",
+    keyword: "{adGroupId}~{criterionId}",
+};
+const COMPOSITE_ID_PATTERN = /^\d+~\d+$/;
+export function getRequiredParentIds(entityType) {
+    return [...getEntityConfig(entityType).parentIds];
+}
+export function getMissingParentIds(entityType, input) {
+    const required = getRequiredParentIds(entityType);
+    return required.filter((parentId) => {
+        const value = input[parentId];
+        return !value || (typeof value === "string" && value.trim().length === 0);
+    });
+}
+export function buildMissingParentIdsMessage(entityType, missing) {
+    const requiredFields = getRequiredParentIds(entityType).map((key) => `\`${key}\``);
+    const missingFields = missing.map((key) => `\`${key}\``);
+    return `Missing required parent identifier(s) for entity type "${entityType}": ${missingFields.join(", ")}. Required parent identifiers: ${requiredFields.join(", ")}.`;
+}
+export function addParentValidationIssue(ctx, entityType, input, path = [], options) {
+    const missing = getMissingParentIds(entityType, input);
+    if (missing.length > 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path,
+            message: buildMissingParentIdsMessage(entityType, missing),
+        });
+    }
+    if (options?.validateCompositeIds) {
+        const compositeFormat = COMPOSITE_ID_ENTITIES[entityType];
+        if (compositeFormat) {
+            const entityId = input.entityId;
+            if (entityId && !COMPOSITE_ID_PATTERN.test(entityId)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: [...path, "entityId"],
+                    message: `Entity type "${entityType}" requires a composite entityId in the format ${compositeFormat} (two numeric IDs separated by ~), but got "${entityId}".`,
+                });
+            }
+            const entityIds = input.entityIds;
+            if (Array.isArray(entityIds)) {
+                for (let i = 0; i < entityIds.length; i++) {
+                    if (!COMPOSITE_ID_PATTERN.test(entityIds[i])) {
+                        ctx.addIssue({
+                            code: z.ZodIssueCode.custom,
+                            path: [...path, "entityIds", i],
+                            message: `Entity type "${entityType}" requires composite IDs in the format ${compositeFormat} (two numeric IDs separated by ~), but entityIds[${i}] = "${entityIds[i]}".`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=parent-id-validation.js.map

package/dist/mcp-server/tools/utils/parent-id-validation.js.map

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

package/dist/mcp-server/tools/utils/resolve-session.d.ts

@@ -0,0 +1,4 @@
+import { type SessionServices } from "../../../services/session-services.js";
+import type { SdkContext } from "@cesteral/shared";
+export declare function resolveSessionServices(sdkContext?: SdkContext): SessionServices;
+//# sourceMappingURL=resolve-session.d.ts.map

package/dist/mcp-server/tools/utils/resolve-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,eAAe,CAE/E"}

package/dist/mcp-server/tools/utils/resolve-session.js

@@ -0,0 +1,6 @@
+import { resolveSessionServicesFromStore } from "@cesteral/shared";
+import { sessionServiceStore } from "../../../services/session-services.js";
+export function resolveSessionServices(sdkContext) {
+    return resolveSessionServicesFromStore(sessionServiceStore, sdkContext);
+}
+//# sourceMappingURL=resolve-session.js.map

package/dist/mcp-server/tools/utils/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAOlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from "pino";
+export declare const createMcpHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "gads-headers" | "jwt" | "none";
+    gadsApiBaseUrl: string;
+    gadsRateLimitPerMinute: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    gadsDeveloperToken?: string | undefined;
+    gadsClientId?: string | undefined;
+    gadsClientSecret?: string | undefined;
+    gadsRefreshToken?: string | undefined;
+    gadsLoginCustomerId?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "gads-headers" | "jwt" | "none";
+    gadsApiBaseUrl: string;
+    gadsRateLimitPerMinute: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    gadsDeveloperToken?: string | undefined;
+    gadsClientId?: string | undefined;
+    gadsClientSecret?: string | undefined;
+    gadsRefreshToken?: string | undefined;
+    gadsLoginCustomerId?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
+//# sourceMappingURL=streamable-http-transport.d.ts.map

package/dist/mcp-server/transports/streamable-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkHnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}