@cesteral/meta-mcp 1.0.0

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

@@ -0,0 +1,180 @@
+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.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    items: z.ZodArray<z.ZodObject<{
+        entityId: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        data: Record<string, any>;
+        entityId: string;
+    }, {
+        data: Record<string, any>;
+        entityId: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        data: Record<string, any>;
+        entityId: string;
+    }[];
+    entityType?: string | undefined;
+}, {
+    items: {
+        data: Record<string, any>;
+        entityId: string;
+    }[];
+    entityType?: string | undefined;
+}>;
+export declare const BulkUpdateEntitiesOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    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">;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    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.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+        items: z.ZodArray<z.ZodObject<{
+            entityId: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            data: Record<string, any>;
+            entityId: string;
+        }, {
+            data: Record<string, any>;
+            entityId: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        items: {
+            data: Record<string, any>;
+            entityId: string;
+        }[];
+        entityType?: string | undefined;
+    }, {
+        items: {
+            data: Record<string, any>;
+            entityId: string;
+        }[];
+        entityType?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        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">;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            items: {
+                entityId: string;
+                data: {
+                    daily_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;AAenD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;EAiBO,CAAC;AAElD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaV,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,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAkCnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAelB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgClC,CAAC"}

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

@@ -0,0 +1,125 @@
+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 = "meta_bulk_update_entities";
+const TOOL_TITLE = "Bulk Update Meta Ads Entities";
+const TOOL_DESCRIPTION = `Batch update multiple entities with individual data payloads.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Gotchas:**
+- Max 50 items per call.
+- Each update consumes 3x rate limit tokens.
+- Per-item failure reporting (partial success possible).
+- Items are executed with concurrency limit of 5.
+- entityType is informational only (not used in API call).`;
+export const BulkUpdateEntitiesInputSchema = z
+    .object({
+    entityType: z
+        .enum(getEntityTypeEnum())
+        .optional()
+        .describe("Type of entities being updated (informational only)"),
+    items: z
+        .array(z.object({
+        entityId: z.string().describe("Entity ID to update"),
+        data: z.record(z.any()).describe("Fields to update"),
+    }))
+        .min(1)
+        .max(50)
+        .describe("Array of update items, each with entityId and data (max 50)"),
+})
+    .describe("Parameters for bulk entity updates");
+export const BulkUpdateEntitiesOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    results: z.array(BulkOperationResultSchema.extend({
+        entityId: z.string(),
+    })),
+    successCount: z.number(),
+    failureCount: z.number(),
+    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 ?? "entity",
+        summary: "Applying field updates across multiple Meta Ads entities.",
+        hasSensitiveFieldChange: hasSensitiveBulkField(payloads),
+        impactPreview: input.items.map((it) => it.entityId),
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            results: [],
+            successCount: 0,
+            failureCount: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { metaService } = resolveSessionServices(sdkContext);
+    const result = await metaService.bulkUpdateEntities(input.items, _context);
+    const successCount = result.results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        results: result.results,
+        successCount,
+        failureCount: result.results.length - successCount,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateEntitiesResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk update cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk update: ${result.successCount} 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,
+        idempotentHint: false,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Update budgets for multiple ad sets",
+            input: {
+                entityType: "adSet",
+                items: [
+                    {
+                        entityId: "23456789012345",
+                        data: { daily_budget: 7500 },
+                    },
+                    {
+                        entityId: "23456789012346",
+                        data: { daily_budget: 5000 },
+                    },
+                ],
+            },
+        },
+    ],
+    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":"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"}

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

@@ -0,0 +1,140 @@
+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.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+    status: z.ZodEnum<["ACTIVE", "PAUSED", "ARCHIVED"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "ACTIVE" | "PAUSED" | "ARCHIVED";
+    entityIds: string[];
+    entityType?: string | undefined;
+}, {
+    status: "ACTIVE" | "PAUSED" | "ARCHIVED";
+    entityIds: string[];
+    entityType?: string | undefined;
+}>;
+export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    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">;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        entityId: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    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.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+        entityIds: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["ACTIVE", "PAUSED", "ARCHIVED"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "ACTIVE" | "PAUSED" | "ARCHIVED";
+        entityIds: string[];
+        entityType?: string | undefined;
+    }, {
+        status: "ACTIVE" | "PAUSED" | "ARCHIVED";
+        entityIds: string[];
+        entityType?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        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">;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            entityId: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: 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;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgBnD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAWQ,CAAC;AAEjD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeD,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,CAgCjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAelB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC"}

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

@@ -0,0 +1,112 @@
+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 = "meta_bulk_update_status";
+const TOOL_TITLE = "Bulk Update Meta Ads Entity Status";
+const TOOL_DESCRIPTION = `Batch update status for multiple Meta Ads entities.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Valid statuses:** ACTIVE, PAUSED, ARCHIVED
+
+**Gotchas:**
+- Can't ARCHIVE entities with active children.
+- ARCHIVED is permanent and cannot be reversed.
+- Max 50 entities per call.
+- Each update consumes 3x rate limit tokens (write operation).`;
+export const BulkUpdateStatusInputSchema = z
+    .object({
+    entityType: z
+        .enum(getEntityTypeEnum())
+        .optional()
+        .describe("Type of entities to update (optional — for informational purposes only, not used in API call)"),
+    entityIds: z.array(z.string()).min(1).max(50).describe("Entity IDs to update (max 50)"),
+    status: z.enum(["ACTIVE", "PAUSED", "ARCHIVED"]).describe("Target status"),
+})
+    .describe("Parameters for bulk status update");
+export const BulkUpdateStatusOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    results: z.array(z.object({
+        entityId: z.string(),
+        success: z.boolean(),
+        error: z.string().optional(),
+    })),
+    successCount: z.number(),
+    failureCount: z.number(),
+    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 ?? "entity",
+        targetStatus: input.status,
+        impactPreview: input.entityIds,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            results: [],
+            successCount: 0,
+            failureCount: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { metaService } = resolveSessionServices(sdkContext);
+    const result = await metaService.bulkUpdateStatus(input.entityIds, input.status, context);
+    const successCount = result.results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        results: result.results,
+        successCount,
+        failureCount: result.results.length - successCount,
+        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}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk status update: ${result.successCount} 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,
+        idempotentHint: true,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Pause multiple campaigns",
+            input: {
+                entityType: "campaign",
+                entityIds: ["23456789012345", "23456789012346"],
+                status: "PAUSED",
+            },
+        },
+    ],
+    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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"}