@cesteral/tiktok-mcp 1.0.0

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

@@ -0,0 +1,193 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkUpdateEntitiesInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    advertiserId: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        entityId: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        data: Record<string, any>;
+    }, {
+        entityId: string;
+        data: Record<string, any>;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    advertiserId: string;
+    items: {
+        entityId: string;
+        data: Record<string, any>;
+    }[];
+}, {
+    entityType: string;
+    advertiserId: string;
+    items: {
+        entityId: string;
+        data: Record<string, any>;
+    }[];
+}>;
+export declare const BulkUpdateEntitiesOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<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, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}>;
+type BulkUpdateEntitiesInput = z.infer<typeof BulkUpdateEntitiesInputSchema>;
+type BulkUpdateEntitiesOutput = z.infer<typeof BulkUpdateEntitiesOutputSchema>;
+export declare function bulkUpdateEntitiesLogic(input: BulkUpdateEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkUpdateEntitiesOutput>;
+export declare function bulkUpdateEntitiesResponseFormatter(result: BulkUpdateEntitiesOutput): McpTextContent[];
+export declare const bulkUpdateEntitiesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        advertiserId: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            entityId: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            entityId: string;
+            data: Record<string, any>;
+        }, {
+            entityId: string;
+            data: Record<string, any>;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        advertiserId: string;
+        items: {
+            entityId: string;
+            data: Record<string, any>;
+        }[];
+    }, {
+        entityType: string;
+        advertiserId: string;
+        items: {
+            entityId: string;
+            data: Record<string, any>;
+        }[];
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<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, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            items: {
+                entityId: string;
+                data: {
+                    budget: number;
+                };
+            }[];
+        };
+    }[];
+    logic: typeof bulkUpdateEntitiesLogic;
+    responseFormatter: typeof bulkUpdateEntitiesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=bulk-update-entities.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-update-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAanD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBO,CAAC;AAElD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcV,CAAC;AAElC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAwCnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAyBlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BlC,CAAC"}

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

@@ -0,0 +1,130 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { BulkOperationResultSchema, elicitBulkMutationConfirmation, hasSensitiveBulkField, } from "@cesteral/shared";
+const TOOL_NAME = "tiktok_bulk_update_entities";
+const TOOL_TITLE = "TikTok Bulk Update Entities";
+const TOOL_DESCRIPTION = `Batch update multiple TikTok Ads entities of the same type.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Each item must include an \`entityId\` and a \`data\` object with fields to update.
+Updates are applied concurrently (max concurrency 5). advertiser_id is automatically injected.
+
+Max 50 items per call.`;
+export const BulkUpdateEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
+    advertiserId: z
+        .string()
+        .min(1)
+        .describe("TikTok Advertiser ID (informational — the session-bound advertiser from authentication is used for API calls)"),
+    items: z
+        .array(z.object({
+        entityId: z.string().min(1).describe("Entity ID to update"),
+        data: z.record(z.any()).describe("Fields to update"),
+    }))
+        .min(1)
+        .max(50)
+        .describe("Array of update operations (max 50)"),
+})
+    .describe("Parameters for bulk entity updates");
+export const BulkUpdateEntitiesOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    totalRequested: z.number(),
+    successCount: z.number(),
+    failureCount: z.number(),
+    results: z.array(BulkOperationResultSchema.extend({
+        entityId: z.string(),
+    })),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk update result");
+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 TikTok Ads entities.",
+        hasSensitiveFieldChange: hasSensitiveBulkField(payloads),
+        impactPreview: input.items.map((it) => it.entityId),
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            totalRequested: input.items.length,
+            successCount: 0,
+            failureCount: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    const bulkResult = await tiktokService.bulkUpdateEntities(input.entityType, input.items, context);
+    const totalSucceeded = bulkResult.results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        totalRequested: input.items.length,
+        successCount: totalSucceeded,
+        failureCount: input.items.length - totalSucceeded,
+        results: bulkResult.results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateEntitiesResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk update of ${result.totalRequested} entities cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const lines = [
+        `Bulk update: ${result.successCount}/${result.totalRequested} succeeded, ${result.failureCount} failed`,
+        "",
+    ];
+    for (const r of result.results) {
+        if (r.success) {
+            lines.push(`  ${r.entityId}: SUCCESS`);
+        }
+        else {
+            lines.push(`  ${r.entityId}: FAILED - ${r.error}`);
+        }
+    }
+    lines.push("", `Timestamp: ${result.timestamp}`);
+    return [{ type: "text", text: lines.join("\n") }];
+}
+export const bulkUpdateEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateEntitiesInputSchema,
+    outputSchema: BulkUpdateEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Bulk update campaign budgets",
+            input: {
+                entityType: "campaign",
+                advertiserId: "1234567890",
+                items: [
+                    { entityId: "1800111111111", data: { budget: 150 } },
+                    { entityId: "1800222222222", data: { budget: 250 } },
+                ],
+            },
+        },
+    ],
+    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,iBAAiB,EAAyB,MAAM,4BAA4B,CAAC;AACtF,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAChD,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;8BAEK,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;uBAKrC,CAAC;AAExB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC9E,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,+GAA+G,CAChH;IACH,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,kBAAkB,CAAC;KACrD,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC;KACD,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAElD,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,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,CACd,yBAAyB,CAAC,MAAM,CAAC;QAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC,CACH;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAKlC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAA8B,EAC9B,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,6DAA6D;QACtE,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,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,aAAa,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE7D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,kBAAkB,CACvD,KAAK,CAAC,UAA8B,EACpC,KAAK,CAAC,KAAK,EACX,OAAO,CACR,CAAC;IAEF,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAE1E,OAAO;QACL,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAClC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc;QACjD,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,MAAgC;IAEhC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,kBAAkB,MAAM,CAAC,cAAc,8CAA8C,MAAM,CAAC,SAAS,EAAE;aAC9G;SACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAa;QACtB,gBAAgB,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,cAAc,eAAe,MAAM,CAAC,YAAY,SAAS;QACvG,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAEjD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7D,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,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,8BAA8B;YACrC,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,YAAY,EAAE,YAAY;gBAC1B,KAAK,EAAE;oBACL,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;oBACpD,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;iBACrD;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,153 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkUpdateStatusInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    advertiserId: z.ZodString;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+    operationStatus: z.ZodEnum<["ENABLE", "DISABLE", "DELETE"]>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    operationStatus: "DELETE" | "ENABLE" | "DISABLE";
+    advertiserId: string;
+    entityIds: string[];
+}, {
+    entityType: string;
+    operationStatus: "DELETE" | "ENABLE" | "DISABLE";
+    advertiserId: string;
+    entityIds: string[];
+}>;
+export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    totalRequested: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        entityId: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }, {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}>;
+type BulkUpdateStatusInput = z.infer<typeof BulkUpdateStatusInputSchema>;
+type BulkUpdateStatusOutput = z.infer<typeof BulkUpdateStatusOutputSchema>;
+export declare function bulkUpdateStatusLogic(input: BulkUpdateStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkUpdateStatusOutput>;
+export declare function bulkUpdateStatusResponseFormatter(result: BulkUpdateStatusOutput): McpTextContent[];
+export declare const bulkUpdateStatusTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        advertiserId: z.ZodString;
+        entityIds: z.ZodArray<z.ZodString, "many">;
+        operationStatus: z.ZodEnum<["ENABLE", "DISABLE", "DELETE"]>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        operationStatus: "DELETE" | "ENABLE" | "DISABLE";
+        advertiserId: string;
+        entityIds: string[];
+    }, {
+        entityType: string;
+        operationStatus: "DELETE" | "ENABLE" | "DISABLE";
+        advertiserId: string;
+        entityIds: string[];
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        totalRequested: z.ZodNumber;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            entityId: z.ZodString;
+            success: z.ZodBoolean;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }, {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            entityIds: string[];
+            operationStatus: 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;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAenD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAgB+B,CAAC;AAExE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBD,CAAC;AAEzC,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACzE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAuCjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAyBlB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkChC,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 { elicitBulkStatusChangeConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "tiktok_bulk_update_status";
+const TOOL_TITLE = "TikTok Bulk Status Update";
+const TOOL_DESCRIPTION = `Batch update the status of TikTok Ads entities.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Operation status values:**
+- **ENABLE** — Activate entities
+- **DISABLE** — Pause entities
+- **DELETE** — Delete entities (irreversible)
+
+TikTok's status update API accepts an array of IDs in a single request.`;
+export const BulkUpdateStatusInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
+    advertiserId: z
+        .string()
+        .min(1)
+        .describe("TikTok Advertiser ID (informational — the session-bound advertiser from authentication is used for API calls)"),
+    entityIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(20)
+        .describe("Array of entity IDs to update (max 20)"),
+    operationStatus: z.enum(["ENABLE", "DISABLE", "DELETE"]).describe("Target status to apply"),
+})
+    .describe("Parameters for bulk status update of TikTok Ads entities");
+export const BulkUpdateStatusOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    totalRequested: z.number(),
+    successCount: z.number(),
+    failureCount: z.number(),
+    results: z.array(z.object({
+        entityId: z.string(),
+        success: z.boolean(),
+        error: z.string().optional(),
+    })),
+    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.operationStatus,
+        impactPreview: input.entityIds,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            totalRequested: input.entityIds.length,
+            successCount: 0,
+            failureCount: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    const result = await tiktokService.bulkUpdateStatus(input.entityType, input.entityIds, input.operationStatus, context);
+    const successCount = result.results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        totalRequested: input.entityIds.length,
+        successCount,
+        failureCount: input.entityIds.length - successCount,
+        results: result.results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateStatusResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk status update cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const lines = [
+        `Status updates: ${result.successCount}/${result.totalRequested} succeeded, ${result.failureCount} failed`,
+        "",
+    ];
+    for (const r of result.results) {
+        if (r.success) {
+            lines.push(`  ${r.entityId}: SUCCESS`);
+        }
+        else {
+            lines.push(`  ${r.entityId}: FAILED - ${r.error}`);
+        }
+    }
+    lines.push("", `Timestamp: ${result.timestamp}`);
+    return [{ type: "text", text: lines.join("\n") }];
+}
+export const bulkUpdateStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateStatusInputSchema,
+    outputSchema: BulkUpdateStatusOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Pause multiple campaigns",
+            input: {
+                entityType: "campaign",
+                advertiserId: "1234567890",
+                entityIds: ["1800111111111", "1800222222222"],
+                operationStatus: "DISABLE",
+            },
+        },
+        {
+            label: "Enable multiple ad groups",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "1234567890",
+                entityIds: ["1700111111111"],
+                operationStatus: "ENABLE",
+            },
+        },
+    ],
+    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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"}