@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,241 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const UpdateCampaignsToolInputSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+    primaryInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    advancedInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+} & {
+    mode: z.ZodLiteral<"single">;
+}, "strip", z.ZodTypeAny, {
+    id: string | null;
+    mode: "single";
+    primaryInput?: Record<string, any> | undefined;
+    advancedInput?: Record<string, any> | undefined;
+    validateInputOnly?: boolean | null | undefined;
+}, {
+    id: string | null;
+    mode: "single";
+    primaryInput?: Record<string, any> | undefined;
+    advancedInput?: Record<string, any> | undefined;
+    validateInputOnly?: boolean | null | undefined;
+}>, z.ZodObject<{
+    input: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodNullable<z.ZodString>;
+        primaryInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        advancedInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string | null;
+        primaryInput?: Record<string, any> | undefined;
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }, {
+        id: string | null;
+        primaryInput?: Record<string, any> | undefined;
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }>, "many">>;
+    validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    callbackInput: z.ZodOptional<z.ZodObject<{
+        callbackUrl: z.ZodString;
+        callbackHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, "strip", z.ZodTypeAny, {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    }, {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    }>>;
+} & {
+    mode: z.ZodLiteral<"batch">;
+}, "strip", z.ZodTypeAny, {
+    input: {
+        id: string | null;
+        primaryInput?: Record<string, any> | undefined;
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }[] | null;
+    mode: "batch";
+    callbackInput?: {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    } | undefined;
+    validateInputOnly?: boolean | null | undefined;
+}, {
+    input: {
+        id: string | null;
+        primaryInput?: Record<string, any> | undefined;
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }[] | null;
+    mode: "batch";
+    callbackInput?: {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    } | undefined;
+    validateInputOnly?: boolean | null | undefined;
+}>]>;
+export declare const UpdateCampaignsToolOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    mode: z.ZodEnum<["single", "batch"]>;
+    campaign: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    job: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    confirmed: boolean;
+    mode: "single" | "batch";
+    campaign?: Record<string, unknown> | undefined;
+    job?: Record<string, unknown> | undefined;
+    declineReason?: string | undefined;
+}, {
+    timestamp: string;
+    confirmed: boolean;
+    mode: "single" | "batch";
+    campaign?: Record<string, unknown> | undefined;
+    job?: Record<string, unknown> | undefined;
+    declineReason?: string | undefined;
+}>;
+type UpdateCampaignsToolInput = z.infer<typeof UpdateCampaignsToolInputSchema>;
+type UpdateCampaignsToolOutput = z.infer<typeof UpdateCampaignsToolOutputSchema>;
+export declare function updateCampaignsLogic(input: UpdateCampaignsToolInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateCampaignsToolOutput>;
+export declare function updateCampaignsResponseFormatter(result: UpdateCampaignsToolOutput): McpTextContent[];
+export declare const updateCampaignsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        id: z.ZodNullable<z.ZodString>;
+        primaryInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        advancedInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    } & {
+        mode: z.ZodLiteral<"single">;
+    }, "strip", z.ZodTypeAny, {
+        id: string | null;
+        mode: "single";
+        primaryInput?: Record<string, any> | undefined;
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }, {
+        id: string | null;
+        mode: "single";
+        primaryInput?: Record<string, any> | undefined;
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }>, z.ZodObject<{
+        input: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            id: z.ZodNullable<z.ZodString>;
+            primaryInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            advancedInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string | null;
+            primaryInput?: Record<string, any> | undefined;
+            advancedInput?: Record<string, any> | undefined;
+            validateInputOnly?: boolean | null | undefined;
+        }, {
+            id: string | null;
+            primaryInput?: Record<string, any> | undefined;
+            advancedInput?: Record<string, any> | undefined;
+            validateInputOnly?: boolean | null | undefined;
+        }>, "many">>;
+        validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        callbackInput: z.ZodOptional<z.ZodObject<{
+            callbackUrl: z.ZodString;
+            callbackHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, "strip", z.ZodTypeAny, {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        }, {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        }>>;
+    } & {
+        mode: z.ZodLiteral<"batch">;
+    }, "strip", z.ZodTypeAny, {
+        input: {
+            id: string | null;
+            primaryInput?: Record<string, any> | undefined;
+            advancedInput?: Record<string, any> | undefined;
+            validateInputOnly?: boolean | null | undefined;
+        }[] | null;
+        mode: "batch";
+        callbackInput?: {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        } | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }, {
+        input: {
+            id: string | null;
+            primaryInput?: Record<string, any> | undefined;
+            advancedInput?: Record<string, any> | undefined;
+            validateInputOnly?: boolean | null | undefined;
+        }[] | null;
+        mode: "batch";
+        callbackInput?: {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        } | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }>]>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        mode: z.ZodEnum<["single", "batch"]>;
+        campaign: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        job: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        confirmed: boolean;
+        mode: "single" | "batch";
+        campaign?: Record<string, unknown> | undefined;
+        job?: Record<string, unknown> | undefined;
+        declineReason?: string | undefined;
+    }, {
+        timestamp: string;
+        confirmed: boolean;
+        mode: "single" | "batch";
+        campaign?: Record<string, unknown> | undefined;
+        job?: Record<string, unknown> | undefined;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            mode: string;
+            id: string;
+            primaryInput: {
+                name: string;
+            };
+            input?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            mode: string;
+            input: {
+                id: string;
+                primaryInput: {
+                    name: string;
+                };
+            }[];
+            id?: undefined;
+            primaryInput?: undefined;
+        };
+    })[];
+    logic: typeof updateCampaignsLogic;
+    responseFormatter: typeof updateCampaignsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=update-campaigns.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-campaigns.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-campaigns.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAS+B,CAAC;AAE3E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;EAO1C,CAAC;AAEH,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CA6CpC;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAclB;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/B,CAAC"}

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

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { CampaignUpdateWorkflowInputSchema, CampaignsUpdateJobInputSchema, toWorkflowCallbackInput, } from "../utils/workflow-schemas.js";
+import { elicitBulkMutationConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "ttd_update_campaigns";
+const TOOL_TITLE = "TTD Update Campaigns";
+const TOOL_DESCRIPTION = `Update one or more campaigns through the TTD Workflows API (PATCH semantics).
+
+- \`mode: "single"\` — synchronous PATCH of a single campaign by id.
+- \`mode: "batch"\` — submit an async Workflows job that updates multiple campaigns. Returns a JobId; poll status with \`ttd_get_job_status\`.`;
+export const UpdateCampaignsToolInputSchema = z
+    .discriminatedUnion("mode", [
+    CampaignUpdateWorkflowInputSchema.extend({
+        mode: z.literal("single").describe("Synchronous single-campaign PATCH via Workflows API"),
+    }),
+    CampaignsUpdateJobInputSchema.extend({
+        mode: z.literal("batch").describe("Async bulk-update job via Workflows API"),
+    }),
+])
+    .describe("Parameters for updating campaigns via the TTD Workflows API");
+export const UpdateCampaignsToolOutputSchema = z.object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    mode: z.enum(["single", "batch"]),
+    campaign: z.record(z.unknown()).optional().describe("Campaign workflow response (mode=single)"),
+    job: z.record(z.unknown()).optional().describe("Job submission response (mode=batch)"),
+    timestamp: z.string().datetime(),
+});
+export async function updateCampaignsLogic(input, context, sdkContext) {
+    const timestamp = new Date().toISOString();
+    if (input.mode === "batch" && !input.validateInputOnly) {
+        const confirmed = await elicitBulkMutationConfirmation({
+            count: input.input?.length ?? 0,
+            entityLabel: "campaign",
+            summary: "Submitting an async Workflows job to PATCH multiple campaigns.",
+            hasSensitiveFieldChange: true,
+            sdkContext,
+        });
+        if (!confirmed) {
+            return {
+                confirmed: false,
+                declineReason: "user_declined",
+                mode: "batch",
+                timestamp,
+            };
+        }
+    }
+    const { ttdService } = resolveSessionServices(sdkContext);
+    if (input.mode === "single") {
+        const { mode: _mode, ...payload } = input;
+        const campaign = (await ttdService.updateCampaignWorkflow(payload, context));
+        return { confirmed: true, mode: "single", campaign, timestamp };
+    }
+    const job = (await ttdService.updateCampaignsJob({
+        input: input.input,
+        ...(input.validateInputOnly !== undefined
+            ? { validateInputOnly: input.validateInputOnly }
+            : {}),
+        ...(input.callbackInput
+            ? { callbackInput: toWorkflowCallbackInput(input.callbackInput) }
+            : {}),
+    }, context));
+    return { confirmed: true, mode: "batch", job, timestamp };
+}
+export function updateCampaignsResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Batch campaign update cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const body = result.mode === "single"
+        ? `Campaign workflow update response:\n\n${JSON.stringify(result.campaign, null, 2)}`
+        : `Campaigns update job submitted:\n\n${JSON.stringify(result.job, null, 2)}`;
+    return [{ type: "text", text: `${body}\n\nTimestamp: ${result.timestamp}` }];
+}
+export const updateCampaignsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UpdateCampaignsToolInputSchema,
+    outputSchema: UpdateCampaignsToolOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Update a single campaign (workflow)",
+            input: {
+                mode: "single",
+                id: "camp123",
+                primaryInput: {
+                    name: "Updated Workflow Campaign",
+                },
+            },
+        },
+        {
+            label: "Submit batch campaign-update job",
+            input: {
+                mode: "batch",
+                input: [
+                    {
+                        id: "camp123",
+                        primaryInput: {
+                            name: "Updated Campaign One",
+                        },
+                    },
+                ],
+            },
+        },
+    ],
+    logic: updateCampaignsLogic,
+    responseFormatter: updateCampaignsResponseFormatter,
+};
+//# sourceMappingURL=update-campaigns.tool.js.map

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

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

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

@@ -0,0 +1,164 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const UpdateEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityId: 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>;
+    strictMode: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    data: Record<string, any>;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}, {
+    entityType: string;
+    data: Record<string, any>;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}>, {
+    entityType: string;
+    data: Record<string, any>;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}, {
+    entityType: string;
+    data: Record<string, any>;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}>;
+export declare const UpdateEntityOutputSchema: z.ZodObject<{
+    entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    entity: Record<string, any>;
+}, {
+    timestamp: string;
+    entity: Record<string, any>;
+}>;
+type UpdateEntityInput = z.infer<typeof UpdateEntityInputSchema>;
+type UpdateEntityOutput = z.infer<typeof UpdateEntityOutputSchema>;
+export declare function updateEntityLogic(input: UpdateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateEntityOutput>;
+export declare function updateEntityResponseFormatter(result: UpdateEntityOutput): McpTextContent[];
+export declare const updateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        entityId: 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>;
+        strictMode: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        data: Record<string, any>;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }, {
+        entityType: string;
+        data: Record<string, any>;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }>, {
+        entityType: string;
+        data: Record<string, any>;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }, {
+        entityType: string;
+        data: Record<string, any>;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            entityId: string;
+            advertiserId: string;
+            data: {
+                CampaignName: string;
+                RTBAttributes?: undefined;
+            };
+            campaignId?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            entityId: string;
+            advertiserId: string;
+            campaignId: string;
+            data: {
+                RTBAttributes: {
+                    BaseBidCPM: {
+                        Amount: number;
+                        CurrencyCode: string;
+                    };
+                };
+                CampaignName?: undefined;
+            };
+        };
+    })[];
+    logic: typeof updateEntityLogic;
+    responseFormatter: typeof updateEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=update-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCe,CAAC;AAEpD,eAAO,MAAM,wBAAwB;;;;;;;;;EAKF,CAAC;AAEpC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC5B,CAAC"}

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

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue, mergeParentIdsIntoData } from "../utils/parent-id-validation.js";
+const TOOL_NAME = "ttd_update_entity";
+const TOOL_TITLE = "Update TTD Entity";
+const TOOL_DESCRIPTION = `Update an existing The Trade Desk entity.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Uses TTD API v3 PUT endpoint. Provide the entity ID and a data object with the fields to update.`;
+export const UpdateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to update"),
+    entityId: z.string().min(1).describe("The entity ID to update"),
+    partnerId: z
+        .string()
+        .optional()
+        .describe("Partner ID (optional for advertiser updates; injected as PartnerId in the request body)"),
+    advertiserId: z
+        .string()
+        .optional()
+        .describe("Advertiser ID (required for most non-advertiser entities)"),
+    campaignId: z.string().optional().describe("Campaign ID (required for adGroup)"),
+    adGroupId: z.string().optional().describe("Ad Group ID (required for ad)"),
+    data: z.record(z.any()).describe("Entity data fields to update"),
+    strictMode: z
+        .boolean()
+        .optional()
+        .describe("Set TTD-Strict-Mode header — TTD returns 400 on unrecognized properties or read-only field assignments. Recommended for development/CI; avoid in production (per TTD Foundations §10)."),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input, input.data);
+})
+    .describe("Parameters for updating a TTD entity");
+export const UpdateEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Updated entity data"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity update result");
+export async function updateEntityLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const data = mergeParentIdsIntoData(input.data, input);
+    const entity = await ttdService.updateEntity(input.entityType, input.entityId, data, context, { strictMode: input.strictMode });
+    return {
+        entity: entity,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function updateEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Entity updated successfully\n${JSON.stringify(result.entity, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const updateEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UpdateEntityInputSchema,
+    outputSchema: UpdateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Update campaign name",
+            input: {
+                entityType: "campaign",
+                entityId: "camp456def",
+                advertiserId: "adv123abc",
+                data: {
+                    CampaignName: "Q1 2025 Brand Awareness - Updated",
+                },
+            },
+        },
+        {
+            label: "Update ad group bid",
+            input: {
+                entityType: "adGroup",
+                entityId: "ag789ghi",
+                advertiserId: "adv123abc",
+                campaignId: "camp456def",
+                data: {
+                    RTBAttributes: {
+                        BaseBidCPM: { Amount: 4.25, CurrencyCode: "USD" },
+                    },
+                },
+            },
+        },
+    ],
+    logic: updateEntityLogic,
+    responseFormatter: updateEntityResponseFormatter,
+};
+//# sourceMappingURL=update-entity.tool.js.map

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

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