@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,187 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getBulkEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue, mergeParentIdsIntoData } from "../utils/parent-id-validation.js";
+import { BulkOperationResultSchema, elicitBulkMutationConfirmation, hasSensitiveBulkField, } from "@cesteral/shared";
+const TOOL_NAME = "ttd_bulk_update_entities";
+const TOOL_TITLE = "Bulk Update TTD Entities";
+const TOOL_DESCRIPTION = `Update multiple The Trade Desk entities of the same type in a single batch operation.
+
+**Supported entity types for bulk update:** ${getBulkEntityTypeEnum().join(", ")}
+
+Provide an array of update items, each with an entityId and data payload. Uses TTD PUT semantics (full entity replacement). Partial failures are reported per-item.
+
+**Important:** TTD uses PUT for updates — include ALL fields you want to keep, not just changed ones. Consider GETting each entity first to merge changes.`;
+export const BulkUpdateEntitiesInputSchema = z
+    .object({
+    entityType: z
+        .enum(getBulkEntityTypeEnum())
+        .describe("Type of entities to update (campaign or adGroup)"),
+    advertiserId: z
+        .string()
+        .optional()
+        .describe("Advertiser ID for all items (required for campaign/adGroup)"),
+    campaignId: z.string().optional().describe("Campaign ID for all items (required for adGroup)"),
+    items: z
+        .array(z.object({
+        entityId: z.string().min(1).describe("Entity ID to update"),
+        data: z.record(z.any()).describe("Entity data fields to update"),
+    }))
+        .min(1)
+        .max(50)
+        .describe("Array of update items (max 50)"),
+})
+    .superRefine((input, ctx) => {
+    input.items.forEach((item, index) => {
+        addParentValidationIssue(ctx, input.entityType, input, item.data, ["items", index]);
+    });
+})
+    .describe("Parameters for bulk updating TTD entities");
+export const BulkUpdateEntitiesOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    entityType: z.string(),
+    totalRequested: z.number(),
+    successCount: z.number(),
+    failureCount: z.number(),
+    results: z.array(BulkOperationResultSchema),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk entity update results");
+export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
+    const payloads = input.items.map((it) => it.data ?? {});
+    const confirmed = await elicitBulkMutationConfirmation({
+        count: input.items.length,
+        entityLabel: input.entityType,
+        summary: "Applying field updates across multiple entities (TTD uses PUT semantics).",
+        hasSensitiveFieldChange: hasSensitiveBulkField(payloads),
+        impactPreview: input.items.map((it) => it.entityId),
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            entityType: input.entityType,
+            totalRequested: input.items.length,
+            successCount: 0,
+            failureCount: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const items = input.items.map((item) => ({
+        ...item,
+        data: mergeParentIdsIntoData(item.data, input),
+    }));
+    const { results } = await ttdService.bulkUpdateEntities(input.entityType, items, context);
+    const succeeded = results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        entityType: input.entityType,
+        totalRequested: items.length,
+        successCount: succeeded,
+        failureCount: items.length - succeeded,
+        results: results.map((r) => ({
+            success: r.success,
+            entity: r.entity,
+            error: r.error,
+        })),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateEntitiesResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk update of ${result.totalRequested} ${result.entityType}(s) cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk update ${result.entityType}: ${result.successCount}/${result.totalRequested} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkUpdateEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateEntitiesInputSchema,
+    outputSchema: BulkUpdateEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Update 2 ad groups with new bid CPMs",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "adv123abc",
+                campaignId: "camp456def",
+                items: [
+                    {
+                        entityId: "adg111aaa",
+                        data: {
+                            AdGroupName: "Prospecting - Display",
+                            RTBAttributes: {
+                                BudgetSettings: { DailyBudget: { Amount: 600, CurrencyCode: "USD" } },
+                                BaseBidCPM: { Amount: 4.0, CurrencyCode: "USD" },
+                            },
+                        },
+                    },
+                    {
+                        entityId: "adg222bbb",
+                        data: {
+                            AdGroupName: "Prospecting - Video",
+                            RTBAttributes: {
+                                BudgetSettings: { DailyBudget: { Amount: 1200, CurrencyCode: "USD" } },
+                                BaseBidCPM: { Amount: 9.5, CurrencyCode: "USD" },
+                            },
+                        },
+                    },
+                ],
+            },
+        },
+        {
+            label: "Update 2 campaigns with new budgets",
+            input: {
+                entityType: "campaign",
+                advertiserId: "adv123abc",
+                items: [
+                    {
+                        entityId: "camp456def",
+                        data: {
+                            CampaignName: "Q1 Brand Awareness",
+                            Budget: { Amount: 75000, CurrencyCode: "USD" },
+                            StartDate: "2025-01-01T00:00:00Z",
+                            EndDate: "2025-03-31T23:59:59Z",
+                            PacingMode: "PaceAhead",
+                        },
+                    },
+                    {
+                        entityId: "camp789ghi",
+                        data: {
+                            CampaignName: "Q1 Retargeting",
+                            Budget: { Amount: 30000, CurrencyCode: "USD" },
+                            StartDate: "2025-01-01T00:00:00Z",
+                            EndDate: "2025-03-31T23:59:59Z",
+                            PacingMode: "PaceAhead",
+                        },
+                    },
+                ],
+            },
+        },
+    ],
+    logic: bulkUpdateEntitiesLogic,
+    responseFormatter: bulkUpdateEntitiesResponseFormatter,
+};
+//# sourceMappingURL=bulk-update-entities.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-update-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAsB,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AACpG,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAC7C,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,gBAAgB,GAAG;;8CAEqB,qBAAqB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;;;2JAI2E,CAAC;AAE5J,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,qBAAqB,EAAE,CAAC;SAC7B,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC9F,KAAK,EAAE,CAAC;SACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAC3D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KACjE,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,gCAAgC,CAAC;CAC9C,CAAC;KACD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAClC,wBAAwB,CACtB,GAAG,EACH,KAAK,CAAC,UAA2B,EACjC,KAAgC,EAChC,IAAI,CAAC,IAAI,EACT,CAAC,OAAO,EAAE,KAAK,CAAC,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;KACD,QAAQ,CAAC,2CAA2C,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,4BAA4B,CAAC,CAAC;AAK1C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAsB,EACtB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,MAAM,8BAA8B,CAAC;QACrD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QACzB,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,OAAO,EAAE,2EAA2E;QACpF,uBAAuB,EAAE,qBAAqB,CAAC,QAAQ,CAAC;QACxD,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACnD,UAAU;KACX,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,eAAe;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAClC,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,GAAG,IAAI;QACP,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAgC,CAAC;KAC1E,CAAC,CAAC,CAAC;IAEJ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC,kBAAkB,CACrD,KAAK,CAAC,UAA2B,EACjC,KAAK,EACL,OAAO,CACR,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAE1D,OAAO;QACL,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS;QACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,CAAC,CAAC,MAAyC;YACnD,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC;QACH,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,MAAwB;IAC1E,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,kBAAkB,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,UAAU,wCAAwC,MAAM,CAAC,SAAS,EAAE;aAC7H;SACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,eAAe,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,cAAc,eAAe,MAAM,CAAC,YAAY,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACnN;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,6BAA6B;IAC1C,YAAY,EAAE,8BAA8B;IAC5C,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,sCAAsC;YAC7C,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;gBACrB,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,YAAY;gBACxB,KAAK,EAAE;oBACL;wBACE,QAAQ,EAAE,WAAW;wBACrB,IAAI,EAAE;4BACJ,WAAW,EAAE,uBAAuB;4BACpC,aAAa,EAAE;gCACb,cAAc,EAAE,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE;gCACrE,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE;6BACjD;yBACF;qBACF;oBACD;wBACE,QAAQ,EAAE,WAAW;wBACrB,IAAI,EAAE;4BACJ,WAAW,EAAE,qBAAqB;4BAClC,aAAa,EAAE;gCACb,cAAc,EAAE,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE;gCACtE,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE;6BACjD;yBACF;qBACF;iBACF;aACF;SACF;QACD;YACE,KAAK,EAAE,qCAAqC;YAC5C,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,YAAY,EAAE,WAAW;gBACzB,KAAK,EAAE;oBACL;wBACE,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE;4BACJ,YAAY,EAAE,oBAAoB;4BAClC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE;4BAC9C,SAAS,EAAE,sBAAsB;4BACjC,OAAO,EAAE,sBAAsB;4BAC/B,UAAU,EAAE,WAAW;yBACxB;qBACF;oBACD;wBACE,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE;4BACJ,YAAY,EAAE,gBAAgB;4BAC9B,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE;4BAC9C,SAAS,EAAE,sBAAsB;4BACjC,OAAO,EAAE,sBAAsB;4BAC/B,UAAU,EAAE,WAAW;yBACxB;qBACF;iBACF;aACF;SACF;KACF;IACD,KAAK,EAAE,uBAAuB;IAC9B,iBAAiB,EAAE,mCAAmC;CACvD,CAAC"}

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

@@ -0,0 +1,170 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkUpdateStatusInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+    status: z.ZodEnum<["Available", "Paused", "Archived"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "Archived" | "Available" | "Paused";
+    entityType: string;
+    entityIds: string[];
+}, {
+    status: "Archived" | "Available" | "Paused";
+    entityType: string;
+    entityIds: string[];
+}>;
+export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodString;
+    targetStatus: z.ZodString;
+    totalRequested: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        success: z.ZodBoolean;
+        entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        error: z.ZodOptional<z.ZodString>;
+    } & {
+        entityId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }, {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    successCount: number;
+    failureCount: number;
+    targetStatus: string;
+    declineReason?: string | undefined;
+}, {
+    entityType: string;
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    successCount: number;
+    failureCount: number;
+    targetStatus: string;
+    declineReason?: string | undefined;
+}>;
+type BulkStatusInput = z.infer<typeof BulkUpdateStatusInputSchema>;
+type BulkStatusOutput = z.infer<typeof BulkUpdateStatusOutputSchema>;
+export declare function bulkUpdateStatusLogic(input: BulkStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkStatusOutput>;
+export declare function bulkUpdateStatusResponseFormatter(result: BulkStatusOutput): McpTextContent[];
+export declare const bulkUpdateStatusTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        entityIds: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["Available", "Paused", "Archived"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "Archived" | "Available" | "Paused";
+        entityType: string;
+        entityIds: string[];
+    }, {
+        status: "Archived" | "Available" | "Paused";
+        entityType: string;
+        entityIds: string[];
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        entityType: z.ZodString;
+        targetStatus: z.ZodString;
+        totalRequested: z.ZodNumber;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            success: z.ZodBoolean;
+            entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            error: z.ZodOptional<z.ZodString>;
+        } & {
+            entityId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }, {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        successCount: number;
+        failureCount: number;
+        targetStatus: string;
+        declineReason?: string | undefined;
+    }, {
+        entityType: string;
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        successCount: number;
+        failureCount: number;
+        targetStatus: string;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            entityIds: string[];
+            status: string;
+        };
+    }[];
+    logic: typeof bulkUpdateStatusLogic;
+    responseFormatter: typeof bulkUpdateStatusResponseFormatter;
+};
+export {};
+//# sourceMappingURL=bulk-update-status.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-update-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.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;AAiBnD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAUQ,CAAC;AAEjD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBD,CAAC;AAEzC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACnE,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErE,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA2C3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAe5F;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwChC,CAAC"}

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

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { BulkOperationResultSchema, elicitBulkStatusChangeConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "ttd_bulk_update_status";
+const TOOL_TITLE = "Bulk Update TTD Entity Status";
+const TOOL_DESCRIPTION = `Batch update the availability status for multiple The Trade Desk entities of the same type.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Available statuses:**
+- \`Available\` — active and eligible for delivery
+- \`Paused\` — temporarily stopped (can be resumed)
+- \`Archived\` — permanently deactivated (cannot be un-archived)
+
+Use this tool for batch pause/resume operations across campaigns or ad groups.
+
+**Note:** This uses a read-modify-write pattern (GET → PUT). Concurrent modifications to the same entity may cause one update to overwrite the other. Avoid running multiple status updates for the same entity in parallel.`;
+export const BulkUpdateStatusInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
+    entityIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(100)
+        .describe("Array of entity IDs to update (max 100)"),
+    status: z.enum(["Available", "Paused", "Archived"]).describe("New availability status"),
+})
+    .describe("Parameters for bulk status update");
+export const BulkUpdateStatusOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    entityType: z.string(),
+    targetStatus: z.string(),
+    totalRequested: z.number(),
+    successCount: z.number(),
+    failureCount: z.number(),
+    results: z.array(BulkOperationResultSchema.extend({
+        entityId: z.string(),
+    })),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk status update result");
+export async function bulkUpdateStatusLogic(input, context, sdkContext) {
+    const confirmed = await elicitBulkStatusChangeConfirmation({
+        count: input.entityIds.length,
+        entityLabel: input.entityType,
+        targetStatus: input.status,
+        impactPreview: input.entityIds,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            entityType: input.entityType,
+            targetStatus: input.status,
+            totalRequested: input.entityIds.length,
+            successCount: 0,
+            failureCount: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const { results } = await ttdService.bulkUpdateStatus(input.entityType, input.entityIds, input.status, context);
+    const succeeded = results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        entityType: input.entityType,
+        targetStatus: input.status,
+        totalRequested: input.entityIds.length,
+        successCount: succeeded,
+        failureCount: input.entityIds.length - succeeded,
+        results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateStatusResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk status update of ${result.totalRequested} ${result.entityType}(s) cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk status update → ${result.targetStatus} for ${result.entityType}: ${result.successCount}/${result.totalRequested} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkUpdateStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateStatusInputSchema,
+    outputSchema: BulkUpdateStatusOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Pause multiple ad groups",
+            input: {
+                entityType: "adGroup",
+                entityIds: ["adg111aaa", "adg222bbb", "adg333ccc"],
+                status: "Paused",
+            },
+        },
+        {
+            label: "Resume (activate) multiple campaigns",
+            input: {
+                entityType: "campaign",
+                entityIds: ["camp456def", "camp789ghi"],
+                status: "Available",
+            },
+        },
+        {
+            label: "Archive a set of creatives",
+            input: {
+                entityType: "creative",
+                entityIds: ["cre001xyz", "cre002xyz"],
+                status: "Archived",
+            },
+        },
+    ],
+    logic: bulkUpdateStatusLogic,
+    responseFormatter: bulkUpdateStatusResponseFormatter,
+};
+//# sourceMappingURL=bulk-update-status.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.d.ts

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const CancelReportExecutionInputSchema: z.ZodObject<{
+    executionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    executionId: string;
+}, {
+    executionId: string;
+}>;
+export declare const CancelReportExecutionOutputSchema: z.ZodObject<{
+    executionId: z.ZodString;
+    isCancelled: z.ZodOptional<z.ZodBoolean>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        field?: string | undefined;
+    }, {
+        message: string;
+        field?: string | undefined;
+    }>, "many">>;
+    rawResponse: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    executionId: string;
+    errors?: {
+        message: string;
+        field?: string | undefined;
+    }[] | undefined;
+    rawResponse?: Record<string, unknown> | undefined;
+    isCancelled?: boolean | undefined;
+}, {
+    timestamp: string;
+    executionId: string;
+    errors?: {
+        message: string;
+        field?: string | undefined;
+    }[] | undefined;
+    rawResponse?: Record<string, unknown> | undefined;
+    isCancelled?: boolean | undefined;
+}>;
+type CancelReportExecutionInput = z.infer<typeof CancelReportExecutionInputSchema>;
+type CancelReportExecutionOutput = z.infer<typeof CancelReportExecutionOutputSchema>;
+export declare function cancelReportExecutionLogic(input: CancelReportExecutionInput, context: RequestContext, sdkContext?: SdkContext): Promise<CancelReportExecutionOutput>;
+export declare function cancelReportExecutionResponseFormatter(result: CancelReportExecutionOutput): McpTextContent[];
+export declare const cancelReportExecutionTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        executionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        executionId: string;
+    }, {
+        executionId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        executionId: z.ZodString;
+        isCancelled: z.ZodOptional<z.ZodBoolean>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            field?: string | undefined;
+        }, {
+            message: string;
+            field?: string | undefined;
+        }>, "many">>;
+        rawResponse: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        executionId: string;
+        errors?: {
+            message: string;
+            field?: string | undefined;
+        }[] | undefined;
+        rawResponse?: Record<string, unknown> | undefined;
+        isCancelled?: boolean | undefined;
+    }, {
+        timestamp: string;
+        executionId: string;
+        errors?: {
+            message: string;
+            field?: string | undefined;
+        }[] | undefined;
+        rawResponse?: Record<string, unknown> | undefined;
+        isCancelled?: boolean | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            executionId: string;
+        };
+    }[];
+    logic: typeof cancelReportExecutionLogic;
+    responseFormatter: typeof cancelReportExecutionResponseFormatter;
+};
+export {};
+//# sourceMappingURL=cancel-report-execution.tool.d.ts.map

package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-report-execution.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/cancel-report-execution.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoBnF,eAAO,MAAM,gCAAgC;;;;;;EAIkB,CAAC;AAEhE,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcQ,CAAC;AAEvD,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AACnF,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAiBrF,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,2BAA2B,CAAC,CA8BtC;AAED,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,2BAA2B,GAClC,cAAc,EAAE,CAyClB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBrC,CAAC"}