@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,156 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { MYREPORTS_TEMPLATE_ACCESS_ERROR, throwIfGraphqlErrors } from "../utils/graphql-errors.js";
+const TOOL_NAME = "ttd_update_report_template";
+const TOOL_TITLE = "Update TTD Report Template (GraphQL)";
+const TOOL_DESCRIPTION = `Update an existing report template via TTD GraphQL (\`myReportsTemplateUpdate\`).
+
+**IMPORTANT:** The updated structure **completely replaces** the existing template. You must re-include all fields and metrics you want to keep — any omitted columns will be removed.
+
+Use \`ttd_get_report_template\` first to retrieve the current template structure before updating.
+Use \`ttd_list_report_templates\` to find the template ID.
+Use \`ttd_list_report_types\` and \`ttd_get_report_type_schema\` to discover available fields and metrics.`;
+const ReportTemplateColumnSchema = z.object({
+    columnId: z.string().describe("Column or metric ID"),
+    columnOrder: z.number().int().min(1).describe("Display order of this column in the report"),
+    includedInPivot: z.boolean().describe("Whether to include this column in the Excel pivot table"),
+});
+const ReportTemplateResultSetSchema = z.object({
+    name: z.string().describe("Tab name in the report"),
+    reportTypeId: z.string().describe("Report type ID"),
+    fields: z.array(ReportTemplateColumnSchema).describe("Dimension fields to include"),
+    metrics: z.array(ReportTemplateColumnSchema).describe("Metric columns to include"),
+    conversionMetrics: z
+        .array(ReportTemplateColumnSchema)
+        .optional()
+        .describe("Conversion metric columns to include (optional)"),
+});
+export const UpdateReportTemplateInputSchema = z
+    .object({
+    id: z.string().min(1).describe("ID of the report template to update"),
+    name: z.string().min(1).describe("New name for the report template"),
+    resultSets: z
+        .array(ReportTemplateResultSetSchema)
+        .min(1)
+        .max(29)
+        .describe("Complete new tab structure (up to 29 tabs). Replaces the existing structure entirely — re-include all columns you want to keep."),
+})
+    .describe("Parameters for updating a TTD report template");
+export const UpdateReportTemplateOutputSchema = z
+    .object({
+    templateData: z.unknown().optional().describe("Raw data scalar returned by TTD"),
+    errors: z
+        .array(z.object({ field: z.string().optional(), message: z.string() }))
+        .optional()
+        .describe("Mutation errors from TTD"),
+    rawResponse: z.record(z.unknown()).optional(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Result of report template update");
+const UPDATE_REPORT_TEMPLATE_MUTATION = `mutation UpdateReportTemplate($input: MyReportsTemplateUpdateInput!) {
+  myReportsTemplateUpdate(input: $input) {
+    data
+    errors {
+      __typename
+      ... on MutationError {
+        field
+        message
+      }
+    }
+  }
+}`;
+export async function updateReportTemplateLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const variables = {
+        input: {
+            id: input.id,
+            name: input.name,
+            resultSets: input.resultSets,
+        },
+    };
+    const raw = (await ttdService.graphqlQuery(UPDATE_REPORT_TEMPLATE_MUTATION, variables, context));
+    throwIfGraphqlErrors(raw, "GraphQL error updating report template", {
+        unauthorizedMessage: MYREPORTS_TEMPLATE_ACCESS_ERROR,
+    });
+    const gqlData = raw.data ?? {};
+    const mutationResult = gqlData.myReportsTemplateUpdate ?? {};
+    const errors = mutationResult.errors;
+    return {
+        templateData: mutationResult.data,
+        errors: errors?.length ? errors : undefined,
+        rawResponse: raw,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function updateReportTemplateResponseFormatter(result) {
+    if (result.errors?.length) {
+        return [
+            {
+                type: "text",
+                text: `Report template update failed:\n\n` +
+                    result.errors.map((e) => `- ${e.field ? `${e.field}: ` : ""}${e.message}`).join("\n") +
+                    `\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (!result.templateData) {
+        return [
+            {
+                type: "text",
+                text: `Report template update returned no template data. The mutation may not have executed.\n\n` +
+                    `This usually means the API token lacks MyReports write access. ` +
+                    `Check the raw response for details:\n\n` +
+                    `${JSON.stringify(result.rawResponse, null, 2)}\n\n` +
+                    `Timestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Report template updated successfully.\n\n` +
+                `Template data: ${JSON.stringify(result.templateData, null, 2)}\n\n` +
+                `Timestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const updateReportTemplateTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UpdateReportTemplateInputSchema,
+    outputSchema: UpdateReportTemplateOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Update a report template with new columns",
+            input: {
+                id: "template-id-placeholder",
+                name: "Updated Weekly Report",
+                resultSets: [
+                    {
+                        name: "Tab 1",
+                        reportTypeId: "60",
+                        fields: [
+                            { columnId: "10", columnOrder: 1, includedInPivot: true },
+                            { columnId: "1", columnOrder: 2, includedInPivot: false },
+                        ],
+                        metrics: [
+                            { columnId: "7", columnOrder: 3, includedInPivot: true },
+                            { columnId: "25", columnOrder: 4, includedInPivot: true },
+                            { columnId: "58", columnOrder: 5, includedInPivot: true },
+                        ],
+                    },
+                ],
+            },
+        },
+    ],
+    logic: updateReportTemplateLogic,
+    responseFormatter: updateReportTemplateResponseFormatter,
+};
+//# sourceMappingURL=update-report-template.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-report-template.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-report-template.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEnG,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAC/C,MAAM,UAAU,GAAG,sCAAsC,CAAC;AAC1D,MAAM,gBAAgB,GAAG;;;;;;2GAMkF,CAAC;AAE5G,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC3F,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CACjG,CAAC,CAAC;AAEH,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACnD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACnD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACnF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAClF,iBAAiB,EAAE,CAAC;SACjB,KAAK,CAAC,0BAA0B,CAAC;SACjC,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACpE,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,6BAA6B,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,iIAAiI,CAClI;CACJ,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAChF,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SACtE,QAAQ,EAAE;SACV,QAAQ,CAAC,0BAA0B,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,kCAAkC,CAAC,CAAC;AAKhD,MAAM,+BAA+B,GAAG;;;;;;;;;;;EAWtC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAgC,EAChC,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE1D,MAAM,SAAS,GAAG;QAChB,KAAK,EAAE;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B;KACF,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,MAAM,UAAU,CAAC,YAAY,CACxC,+BAA+B,EAC/B,SAAS,EACT,OAAO,CACR,CAA4B,CAAC;IAE9B,oBAAoB,CAAC,GAAG,EAAE,wCAAwC,EAAE;QAClE,mBAAmB,EAAE,+BAA+B;KACrD,CAAC,CAAC;IAEH,MAAM,OAAO,GAAI,GAAG,CAAC,IAA4C,IAAI,EAAE,CAAC;IACxE,MAAM,cAAc,GACjB,OAAO,CAAC,uBAA+D,IAAI,EAAE,CAAC;IACjF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAgE,CAAC;IAE/F,OAAO;QACL,YAAY,EAAE,cAAc,CAAC,IAAI;QACjC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAC3C,WAAW,EAAE,GAA8B;QAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,MAAkC;IAElC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,oCAAoC;oBACpC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrF,kBAAkB,MAAM,CAAC,SAAS,EAAE;aACvC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,2FAA2F;oBAC3F,iEAAiE;oBACjE,yCAAyC;oBACzC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM;oBACpD,cAAc,MAAM,CAAC,SAAS,EAAE;aACnC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EACF,2CAA2C;gBAC3C,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM;gBACpE,cAAc,MAAM,CAAC,SAAS,EAAE;SACnC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,+BAA+B;IAC5C,YAAY,EAAE,gCAAgC;IAC9C,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,2CAA2C;YAClD,KAAK,EAAE;gBACL,EAAE,EAAE,yBAAyB;gBAC7B,IAAI,EAAE,uBAAuB;gBAC7B,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,OAAO;wBACb,YAAY,EAAE,IAAI;wBAClB,MAAM,EAAE;4BACN,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;4BACzD,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE;yBAC1D;wBACD,OAAO,EAAE;4BACP,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;4BACxD,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;4BACzD,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;yBAC1D;qBACF;iBACF;aACF;SACF;KACF;IACD,KAAK,EAAE,yBAAyB;IAChC,iBAAiB,EAAE,qCAAqC;CACzD,CAAC"}

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

@@ -0,0 +1,226 @@
+import { z } from "zod";
+import type { RequestContext } from "@cesteral/shared";
+import { validateEntityResponseFormatter } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ValidateEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    mode: z.ZodEnum<["create", "update"]>;
+    entityId: z.ZodOptional<z.ZodString>;
+    partnerId: z.ZodOptional<z.ZodString>;
+    advertiserId: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    adGroupId: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    data: Record<string, any>;
+    mode: "create" | "update";
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    entityId?: string | undefined;
+}, {
+    entityType: string;
+    data: Record<string, any>;
+    mode: "create" | "update";
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    entityId?: 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;
+    timestamp: string;
+    mode: 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;
+    timestamp: string;
+    mode: 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.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        mode: z.ZodEnum<["create", "update"]>;
+        entityId: z.ZodOptional<z.ZodString>;
+        partnerId: z.ZodOptional<z.ZodString>;
+        advertiserId: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodString>;
+        adGroupId: z.ZodOptional<z.ZodString>;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        data: Record<string, any>;
+        mode: "create" | "update";
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        entityId?: string | undefined;
+    }, {
+        entityType: string;
+        data: Record<string, any>;
+        mode: "create" | "update";
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        entityId?: 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;
+        timestamp: string;
+        mode: 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;
+        timestamp: string;
+        mode: string;
+        nextAction?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            mode: string;
+            data: {
+                AdvertiserId: string;
+                CampaignName: string;
+                Budget: {
+                    Amount: number;
+                    CurrencyCode: string;
+                };
+                StartDate: string;
+                EndDate: string;
+                PacingMode: string;
+                AdGroupName?: undefined;
+            };
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            mode: string;
+            data: {
+                AdGroupName: string;
+                AdvertiserId?: undefined;
+                CampaignName?: undefined;
+                Budget?: undefined;
+                StartDate?: undefined;
+                EndDate?: undefined;
+                PacingMode?: undefined;
+            };
+        };
+    })[];
+    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":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAKL,+BAA+B,EAEhC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA6BnD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBuB,CAAC;AAW9D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASP,CAAC;AAMjC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAMvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAuI/B;AAMD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC9B,CAAC"}

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

@@ -0,0 +1,205 @@
+import { z } from "zod";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { validateRequiredFieldsStructured, validateEnumFieldsStructured, checkReadOnlyFieldsStructured, validateEntityResponseFormatter, buildNextAction, } from "@cesteral/shared";
+import { mergeParentIdsIntoData } from "../utils/parent-id-validation.js";
+import { REQUIRED_FIELDS_CREATE, OPTIONAL_ENUM_FIELDS, READ_ONLY_FIELDS, POSITIVE_NUMBER_FIELDS, } from "../../resources/utils/field-rules.js";
+const TOOL_NAME = "ttd_validate_entity";
+const TOOL_TITLE = "TTD Entity Validation (Client-Side)";
+const TOOL_DESCRIPTION = `Validate an entity payload against known TTD requirements without calling the API. Checks required fields, data types, and common configuration mistakes.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+This is a pure client-side check — it catches missing required fields and
+obvious type errors. The TTD API may still reject payloads for business-rule
+reasons (e.g., invalid pacing mode / budget combinations).
+
+Required-field tables, enum suggestions, and read-only field lists per entity type are also exposed as MCP resources. Valid values: see resource \`ttd-field-rules://{entityType}\`.`;
+export const ValidateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to validate"),
+    mode: z.enum(["create", "update"]).describe("Whether validating for creation or update"),
+    entityId: z.string().optional().describe("Entity ID (recommended for update mode)"),
+    partnerId: z
+        .string()
+        .optional()
+        .describe("Partner ID (merged into data as PartnerId before validation, mirrors create tool)"),
+    advertiserId: z
+        .string()
+        .optional()
+        .describe("Advertiser ID (merged into data before validation, mirrors create/update tools)"),
+    campaignId: z.string().optional().describe("Campaign ID (merged into data before validation)"),
+    adGroupId: z.string().optional().describe("Ad group ID (merged into data before validation)"),
+    data: z.record(z.any()).describe("Entity payload to validate"),
+})
+    .describe("Parameters for validating a TTD entity payload");
+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().describe("Entity type that was validated"),
+    mode: z.string().describe("Validation mode (create or update)"),
+    issues: z.array(ValidationIssueSchema),
+    nextAction: z.string().optional(),
+    timestamp: z.string().datetime().describe("ISO-8601 timestamp of validation"),
+})
+    .describe("Validation result");
+export async function validateEntityLogic(input, _context, _sdkContext) {
+    const { entityType, mode } = input;
+    const data = mergeParentIdsIntoData(input.data, input);
+    const issues = [];
+    const rules = REQUIRED_FIELDS_CREATE[entityType] ?? [];
+    const optionalRules = OPTIONAL_ENUM_FIELDS[entityType] ?? [];
+    issues.push(...validateEnumFieldsStructured(data, [...rules, ...optionalRules]));
+    if (mode === "create") {
+        issues.push(...validateRequiredFieldsStructured(data, rules));
+        if (entityType === "campaign" && data.Budget && typeof data.Budget === "object") {
+            const budget = data.Budget;
+            if (budget.Amount === undefined) {
+                issues.push({
+                    field: "Budget.Amount",
+                    code: "missing",
+                    message: 'Field "Budget.Amount" is required',
+                    severity: "error",
+                });
+            }
+            if (!budget.CurrencyCode) {
+                issues.push({
+                    field: "Budget.CurrencyCode",
+                    code: "missing",
+                    message: 'Field "Budget.CurrencyCode" is required',
+                    severity: "error",
+                });
+            }
+        }
+        if (entityType === "adGroup" && data.RTBAttributes && typeof data.RTBAttributes === "object") {
+            const rtb = data.RTBAttributes;
+            if (!rtb.BudgetSettings) {
+                issues.push({
+                    field: "RTBAttributes.BudgetSettings",
+                    code: "missing",
+                    message: 'Field "RTBAttributes.BudgetSettings" is recommended for ad group creation',
+                    severity: "warning",
+                });
+            }
+            if (!rtb.BaseBidCPM) {
+                issues.push({
+                    field: "RTBAttributes.BaseBidCPM",
+                    code: "missing",
+                    message: 'Field "RTBAttributes.BaseBidCPM" is recommended for ad group creation',
+                    severity: "warning",
+                });
+            }
+        }
+    }
+    if (mode === "update") {
+        if (Object.keys(data).length === 0) {
+            issues.push({
+                field: "data",
+                code: "custom",
+                message: "Update payload must contain at least one field to update",
+                severity: "error",
+            });
+        }
+        issues.push(...checkReadOnlyFieldsStructured(data, READ_ONLY_FIELDS, (field) => `Field "${field}" is a system field and may be ignored by the API on update`));
+    }
+    const budgetObj = data.Budget;
+    if (budgetObj && typeof budgetObj === "object") {
+        const amount = budgetObj.Amount;
+        if (amount !== undefined && typeof amount === "number" && amount <= 0) {
+            issues.push({
+                field: "Budget.Amount",
+                code: "invalidValue",
+                message: 'Field "Budget.Amount" must be a positive number',
+                severity: "error",
+            });
+        }
+    }
+    for (const field of POSITIVE_NUMBER_FIELDS) {
+        const value = data[field];
+        if (value !== undefined && typeof value === "number" && value <= 0) {
+            issues.push({
+                field,
+                code: "invalidValue",
+                message: `Field "${field}" must be a positive number`,
+                severity: "error",
+            });
+        }
+    }
+    const errorIssues = issues.filter((i) => i.severity !== "warning");
+    let nextAction;
+    if (errorIssues.length > 0) {
+        const parentMissing = errorIssues.find((i) => ["AdvertiserId", "CampaignId", "AdGroupId", "PartnerId"].includes(i.field));
+        if (parentMissing) {
+            nextAction = buildNextAction({
+                kind: "list-entity",
+                tool: "ttd_list_entities",
+                field: parentMissing.field,
+            });
+        }
+        else {
+            nextAction = buildNextAction({
+                kind: "read-resource",
+                uri: `ttd-field-rules://${entityType}`,
+                purpose: `the ${entityType} required-field reference`,
+            });
+        }
+    }
+    return {
+        valid: errorIssues.length === 0,
+        entityType,
+        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: "Valid campaign create",
+            input: {
+                entityType: "campaign",
+                mode: "create",
+                data: {
+                    AdvertiserId: "adv123abc",
+                    CampaignName: "Q1 2025 Brand Awareness",
+                    Budget: { Amount: 50000, CurrencyCode: "USD" },
+                    StartDate: "2025-01-01T00:00:00Z",
+                    EndDate: "2025-03-31T23:59:59Z",
+                    PacingMode: "PaceAhead",
+                },
+            },
+        },
+        {
+            label: "Missing required fields (ad group)",
+            input: {
+                entityType: "adGroup",
+                mode: "create",
+                data: {
+                    AdGroupName: "Prospecting - Display",
+                },
+            },
+        },
+    ],
+    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/entity-mapping.d.ts

@@ -0,0 +1,18 @@
+export type TtdEntityType = "advertiser" | "campaign" | "adGroup" | "creative" | "conversionTracker";
+export type BulkSupportedEntityType = "campaign" | "adGroup";
+export interface TtdEntityConfig {
+    apiPath: string;
+    queryPath: string;
+    parentIds: ParentIdKey[];
+    idField: string;
+    supportsBulk?: boolean;
+    supportsArchive?: boolean;
+}
+export type ParentIdKey = "advertiserId" | "campaignId" | "adGroupId" | "partnerId";
+export declare function getEntityConfig(entityType: TtdEntityType): TtdEntityConfig;
+export declare function getSupportedEntityTypes(): TtdEntityType[];
+export declare function getEntityTypeEnum(): [string, ...string[]];
+export declare function getBulkSupportedEntityTypes(): BulkSupportedEntityType[];
+export declare function getBulkEntityTypeEnum(): [string, ...string[]];
+export declare function getArchiveSupportedEntityTypes(): TtdEntityType[];
+//# 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,aAAa,GACrB,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,GACV,mBAAmB,CAAC;AAGxB,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAuCpF,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,GAAG,eAAe,CAM1E;AAED,wBAAgB,uBAAuB,IAAI,aAAa,EAAE,CAEzD;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGzD;AAED,wBAAgB,2BAA2B,IAAI,uBAAuB,EAAE,CAIvE;AAED,wBAAgB,qBAAqB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAG7D;AAED,wBAAgB,8BAA8B,IAAI,aAAa,EAAE,CAIhE"}