@cesteral/meta-mcp 1.0.0

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":"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"}

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

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { runMetaUpdateDryRun } from "../utils/dry-run.js";
+import { captureMetaSnapshot } from "../utils/capture-snapshot.js";
+import { DryRunResultSchema, NormalizedEntitySnapshotSchema } from "@cesteral/shared";
+const TOOL_NAME = "meta_update_entity";
+const TOOL_TITLE = "Update Meta Ads Entity";
+const TOOL_DESCRIPTION = `Update an existing Meta Ads entity.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Uses POST /{entityId} with PATCH semantics — only provided fields are updated.
+
+**Gotchas:**
+- Returns \`{ success: true }\` on success, NOT the full entity. Use meta_get_entity to fetch updated state.
+- \`targeting\` replaces entirely (no merge with existing targeting).
+- Budget values are in cents (1000 = $10 USD).
+- Budget changes limited to ~4/hour per ad set.
+- Writes are rate-limited at 3x read cost.`;
+export const UpdateEntityInputSchema = z
+    .object({
+    entityType: z
+        .enum(getEntityTypeEnum())
+        .optional()
+        .describe("Type of entity to update (optional — for informational purposes only, not used in API call)"),
+    entityId: z.string().min(1).describe("The entity ID to update"),
+    data: z.record(z.any()).describe("Fields to update as key-value pairs"),
+    dry_run: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("When true, validates the proposed mutation and returns a DryRunResult under `dryRun` without invoking the Meta Graph API. The underlying entity is never mutated."),
+})
+    .describe("Parameters for updating a Meta Ads entity");
+export const UpdateEntityOutputSchema = z
+    .object({
+    success: z.boolean(),
+    entityId: z.string(),
+    entityType: z.string().optional(),
+    timestamp: z.string().datetime(),
+    dryRun: DryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. The mutation was NOT applied."),
+    before: NormalizedEntitySnapshotSchema.optional().describe("Pre-write canonical snapshot of the entity, captured at the start of the handler. Populated when the entity type is in canonical scope (campaign, ad_set, ad) and the read partner returns the entity. Undefined for out-of-scope types or when the pre-read fails."),
+    after: NormalizedEntitySnapshotSchema.optional().describe("Post-write canonical snapshot of the entity. Captured by re-reading after the write because Meta's update endpoint returns only `{ success: true }`. Undefined when the post-read fails or the entity type is out of canonical scope."),
+})
+    .describe("Entity update result");
+export async function updateEntityLogic(input, context, sdkContext) {
+    const { metaService } = resolveSessionServices(sdkContext);
+    if (input.dry_run === true) {
+        const dryRun = await runMetaUpdateDryRun({ entityType: input.entityType, entityId: input.entityId, data: input.data }, metaService, context);
+        return {
+            success: dryRun.wouldSucceed,
+            entityId: input.entityId,
+            entityType: input.entityType,
+            timestamp: new Date().toISOString(),
+            dryRun,
+        };
+    }
+    const before = await captureMetaSnapshot(metaService, input.entityType, input.entityId, context);
+    const result = await metaService.updateEntity(input.entityId, input.data, context);
+    const success = result?.success === true;
+    const after = success
+        ? await captureMetaSnapshot(metaService, input.entityType, input.entityId, context)
+        : undefined;
+    return {
+        success,
+        entityId: input.entityId,
+        entityType: input.entityType,
+        timestamp: new Date().toISOString(),
+        ...(before ? { before } : {}),
+        ...(after ? { after } : {}),
+    };
+}
+export function updateEntityResponseFormatter(result) {
+    const status = result.success ? "updated successfully" : "update returned unexpected response";
+    const entityLabel = result.entityType ?? "Entity";
+    return [
+        {
+            type: "text",
+            text: `${entityLabel} ${result.entityId} ${status}\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,
+        idempotentHint: true,
+        destructiveHint: true,
+        cesteral: {
+            kind: "write",
+            platform: "meta_ads",
+            operation: ["update_budget", "pause", "resume", "update_status", "update"],
+            entityKinds: ["campaign", "ad_set", "ad"],
+            entityIdArgs: ["entityId"],
+            readPartner: {
+                toolName: "meta_get_entity",
+                argMap: { entityId: "entityId" },
+            },
+            schemaVersion: 1,
+            contractId: "meta.update_entity.v1",
+            supportsDryRun: true,
+            supportsBeforeAfterSnapshot: true,
+        },
+    },
+    inputExamples: [
+        {
+            label: "Pause a campaign",
+            input: {
+                entityType: "campaign",
+                entityId: "23456789012345",
+                data: { status: "PAUSED" },
+            },
+        },
+        {
+            label: "Update ad set budget",
+            input: {
+                entityType: "adSet",
+                entityId: "23456789012345",
+                data: { daily_budget: 10000 },
+            },
+        },
+        {
+            label: "Update ad set targeting",
+            input: {
+                entityType: "adSet",
+                entityId: "23456789012345",
+                data: {
+                    targeting: {
+                        age_min: 25,
+                        age_max: 55,
+                        geo_locations: { countries: ["US", "CA"] },
+                    },
+                },
+            },
+        },
+    ],
+    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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"}

package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const UploadImageInputSchema: z.ZodObject<{
+    adAccountId: z.ZodString;
+    mediaUrl: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adAccountId: string;
+    mediaUrl: string;
+    name?: string | undefined;
+}, {
+    adAccountId: string;
+    mediaUrl: string;
+    name?: string | undefined;
+}>;
+export declare const UploadImageOutputSchema: z.ZodObject<{
+    imageHash: z.ZodString;
+    name: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    imageHash: string;
+    uploadedAt: string;
+    url?: string | undefined;
+}, {
+    name: string;
+    imageHash: string;
+    uploadedAt: string;
+    url?: string | undefined;
+}>;
+type UploadImageInput = z.infer<typeof UploadImageInputSchema>;
+type UploadImageOutput = z.infer<typeof UploadImageOutputSchema>;
+export declare function uploadImageLogic(input: UploadImageInput, context: RequestContext, sdkContext?: SdkContext): Promise<UploadImageOutput>;
+export declare function uploadImageResponseFormatter(result: UploadImageOutput): McpTextContent[];
+export declare const uploadImageTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        adAccountId: z.ZodString;
+        mediaUrl: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountId: string;
+        mediaUrl: string;
+        name?: string | undefined;
+    }, {
+        adAccountId: string;
+        mediaUrl: string;
+        name?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        imageHash: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        imageHash: string;
+        uploadedAt: string;
+        url?: string | undefined;
+    }, {
+        name: string;
+        imageHash: string;
+        uploadedAt: string;
+        url?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            adAccountId: string;
+            mediaUrl: string;
+            name: string;
+        };
+    }[];
+    logic: typeof uploadImageLogic;
+    responseFormatter: typeof uploadImageResponseFormatter;
+};
+export {};
+//# sourceMappingURL=upload-image.tool.d.ts.map

package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-image.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/upload-image.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMqB,CAAC;AAEzD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAOF,CAAC;AAEnC,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAYjE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAyC5B;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAOxF;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAC"}

package/dist/mcp-server/tools/definitions/upload-image.tool.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { downloadFileToBuffer, McpError, JsonRpcErrorCode } from "@cesteral/shared";
+const TOOL_NAME = "meta_upload_image";
+const TOOL_TITLE = "Upload Image to Meta Ads";
+const TOOL_DESCRIPTION = `Upload an image to Meta Ads Library from a URL.
+
+The server downloads the image and uploads it to Meta's ad image library.
+Returns the image hash which can be used in ad creative payloads.
+
+**Image requirements:**
+- Formats: JPEG, PNG, GIF
+- Max file size: 30MB
+- Recommended: 1200x628px (1.91:1 ratio) for link ads
+- Square 1080x1080px for Stories/Reels
+
+**Usage:** The returned imageHash is used in adCreative → object_story_spec → link_data → image_hash`;
+export const UploadImageInputSchema = z
+    .object({
+    adAccountId: z.string().describe("Meta Ad Account ID (e.g., act_1234567890)"),
+    mediaUrl: z.string().url().describe("Publicly accessible URL of the image to upload"),
+    name: z.string().optional().describe("Optional name for the image in Media Library"),
+})
+    .describe("Parameters for uploading an image to Meta");
+export const UploadImageOutputSchema = z
+    .object({
+    imageHash: z.string().describe("Image hash used in ad creative payloads"),
+    name: z.string().describe("Image name in Media Library"),
+    url: z.string().optional().describe("Preview URL of the uploaded image"),
+    uploadedAt: z.string().datetime(),
+})
+    .describe("Uploaded image info");
+export async function uploadImageLogic(input, context, sdkContext) {
+    const { metaService } = resolveSessionServices(sdkContext);
+    const { buffer, contentType, filename } = await downloadFileToBuffer(input.mediaUrl, 120_000, context);
+    const actId = input.adAccountId.startsWith("act_")
+        ? input.adAccountId
+        : `act_${input.adAccountId}`;
+    const effectiveName = input.name ?? filename;
+    const fields = {};
+    if (input.name)
+        fields.name = input.name;
+    const result = (await metaService.graphApiClient.postMultipart(`/${actId}/adimages`, fields, "bytes", buffer, effectiveName, contentType, context));
+    const images = result.images ?? {};
+    const imageEntry = Object.values(images)[0];
+    if (!imageEntry) {
+        throw new McpError(JsonRpcErrorCode.InternalError, "Meta image upload failed: no image data returned");
+    }
+    return {
+        imageHash: imageEntry.hash,
+        name: imageEntry.name ?? effectiveName,
+        url: imageEntry.url,
+        uploadedAt: new Date().toISOString(),
+    };
+}
+export function uploadImageResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Image uploaded to Meta!\n\nImage Hash: ${result.imageHash}\nName: ${result.name}${result.url ? `\nPreview URL: ${result.url}` : ""}\n\nUse imageHash in adCreative.object_story_spec.link_data.image_hash`,
+        },
+    ];
+}
+export const uploadImageTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UploadImageInputSchema,
+    outputSchema: UploadImageOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        idempotentHint: false,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Upload a banner image",
+            input: {
+                adAccountId: "act_1234567890",
+                mediaUrl: "https://example.com/banner-1200x628.jpg",
+                name: "Summer Sale Banner",
+            },
+        },
+    ],
+    logic: uploadImageLogic,
+    responseFormatter: uploadImageResponseFormatter,
+};
+//# sourceMappingURL=upload-image.tool.js.map

package/dist/mcp-server/tools/definitions/upload-image.tool.js.map

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

package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const UploadVideoInputSchema: z.ZodObject<{
+    adAccountId: z.ZodString;
+    mediaUrl: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adAccountId: string;
+    mediaUrl: string;
+    title?: string | undefined;
+    description?: string | undefined;
+}, {
+    adAccountId: string;
+    mediaUrl: string;
+    title?: string | undefined;
+    description?: string | undefined;
+}>;
+export declare const UploadVideoOutputSchema: z.ZodObject<{
+    videoId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    uploadedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    uploadedAt: string;
+    videoId: string;
+    title?: string | undefined;
+}, {
+    status: string;
+    uploadedAt: string;
+    videoId: string;
+    title?: string | undefined;
+}>;
+type UploadVideoInput = z.infer<typeof UploadVideoInputSchema>;
+type UploadVideoOutput = z.infer<typeof UploadVideoOutputSchema>;
+export declare function uploadVideoLogic(input: UploadVideoInput, context: RequestContext, sdkContext?: SdkContext): Promise<UploadVideoOutput>;
+export declare function uploadVideoResponseFormatter(result: UploadVideoOutput): McpTextContent[];
+export declare const uploadVideoTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        adAccountId: z.ZodString;
+        mediaUrl: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountId: string;
+        mediaUrl: string;
+        title?: string | undefined;
+        description?: string | undefined;
+    }, {
+        adAccountId: string;
+        mediaUrl: string;
+        title?: string | undefined;
+        description?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        videoId: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        uploadedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        uploadedAt: string;
+        videoId: string;
+        title?: string | undefined;
+    }, {
+        status: string;
+        uploadedAt: string;
+        videoId: string;
+        title?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            adAccountId: string;
+            mediaUrl: string;
+            title: string;
+        };
+    }[];
+    logic: typeof uploadVideoLogic;
+    responseFormatter: typeof uploadVideoResponseFormatter;
+};
+export {};
+//# sourceMappingURL=upload-video.tool.d.ts.map

package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-video.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/upload-video.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAsBnD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAOoB,CAAC;AAExD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAOF,CAAC;AAEnC,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAkCjE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAgG5B;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAOxF;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAC"}

package/dist/mcp-server/tools/definitions/upload-video.tool.js

@@ -0,0 +1,151 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { downloadFileToBuffer, createLogger, fetchWithTimeout, McpError, JsonRpcErrorCode, pollUntilComplete, ReportTimeoutError, ReportFailedError, } from "@cesteral/shared";
+import { mcpConfig } from "../../../config/index.js";
+const logger = createLogger("meta-upload-video");
+const TOOL_NAME = "meta_upload_video";
+const TOOL_TITLE = "Upload Video to Meta Ads";
+const TOOL_DESCRIPTION = `Upload a video to Meta Ads Library from a URL.
+
+The server downloads the video and uploads it to Meta's ad video library.
+This tool uses a buffered proxy upload path, so it is intended for moderate-size assets rather than Meta's largest supported uploads.
+Polls until processing is complete (up to 5 minutes).
+
+**Video requirements:**
+- Formats: MP4, MOV (H.264 codec recommended)
+- Server safety limit: ${Math.round(mcpConfig.metaVideoUploadMaxBufferedBytes / (1024 * 1024))}MB buffered upload size
+- Min resolution: 120x120px
+- Recommended: 1080x1080px (square) or 1920x1080px (landscape)
+- Duration: 1 second to 240 minutes
+
+**Usage:** The returned videoId is used in adCreative → video_data → video_id`;
+export const UploadVideoInputSchema = z
+    .object({
+    adAccountId: z.string().describe("Meta Ad Account ID (e.g., act_1234567890)"),
+    mediaUrl: z.string().url().describe("Publicly accessible URL of the video to upload"),
+    title: z.string().optional().describe("Optional video title"),
+    description: z.string().optional().describe("Optional video description"),
+})
+    .describe("Parameters for uploading a video to Meta");
+export const UploadVideoOutputSchema = z
+    .object({
+    videoId: z.string().describe("Video ID used in ad creative payloads"),
+    title: z.string().optional(),
+    status: z.string().describe("Processing status"),
+    uploadedAt: z.string().datetime(),
+})
+    .describe("Uploaded video info");
+async function getRemoteContentLength(url, context) {
+    try {
+        const response = await fetchWithTimeout(url, 30_000, context, { method: "HEAD" });
+        if (!response.ok) {
+            return undefined;
+        }
+        const contentLength = response.headers.get("content-length");
+        if (!contentLength) {
+            return undefined;
+        }
+        const parsedLength = Number(contentLength);
+        return Number.isFinite(parsedLength) && parsedLength >= 0 ? parsedLength : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function uploadVideoLogic(input, context, sdkContext) {
+    const { metaService } = resolveSessionServices(sdkContext);
+    const maxBufferedBytes = mcpConfig.metaVideoUploadMaxBufferedBytes;
+    const remoteContentLength = await getRemoteContentLength(input.mediaUrl, context);
+    if (remoteContentLength !== undefined && remoteContentLength > maxBufferedBytes) {
+        throw new McpError(JsonRpcErrorCode.InternalError, `Meta video upload aborted before download: remote file is ${remoteContentLength} bytes, exceeding the server's buffered upload limit of ${maxBufferedBytes} bytes. Use a smaller asset or a chunked upload workflow.`);
+    }
+    const { buffer, contentType, filename } = await downloadFileToBuffer(input.mediaUrl, 300_000, context);
+    if (buffer.length > maxBufferedBytes) {
+        throw new McpError(JsonRpcErrorCode.InternalError, `Meta video upload aborted after download: buffered file is ${buffer.length} bytes, exceeding the server's buffered upload limit of ${maxBufferedBytes} bytes. Use a smaller asset or a chunked upload workflow.`);
+    }
+    const actId = input.adAccountId.startsWith("act_")
+        ? input.adAccountId
+        : `act_${input.adAccountId}`;
+    const fields = {};
+    if (input.title)
+        fields.title = input.title;
+    if (input.description)
+        fields.description = input.description;
+    const uploadResult = (await metaService.graphApiClient.postMultipart(`/${actId}/advideos`, fields, "source", buffer, filename, contentType, context));
+    const videoId = uploadResult.id;
+    if (!videoId) {
+        throw new McpError(JsonRpcErrorCode.InternalError, "Meta video upload failed: no video ID returned");
+    }
+    try {
+        await pollUntilComplete({
+            fetchStatus: async () => {
+                const statusResult = (await metaService.graphApiClient.get(`/${videoId}`, { fields: "status" }, context));
+                return {
+                    progress: statusResult.status?.processing_progress ?? 0,
+                    videoStatus: statusResult.status?.video_status ?? "processing",
+                };
+            },
+            isComplete: ({ progress, videoStatus }) => progress >= 100 || videoStatus === "ready",
+            isFailed: ({ videoStatus }) => videoStatus === "error",
+            initialDelayMs: mcpConfig.metaVideoUploadPollIntervalMs,
+            maxDelayMs: mcpConfig.metaVideoUploadPollIntervalMs,
+            maxAttempts: mcpConfig.metaVideoUploadMaxPollAttempts,
+            backoffFactor: 1,
+        });
+        return {
+            videoId,
+            title: input.title ?? uploadResult.title,
+            status: "ready",
+            uploadedAt: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        if (error instanceof ReportFailedError) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Meta video processing failed: status=error`);
+        }
+        if (error instanceof ReportTimeoutError) {
+            logger.warn({ videoId }, "Meta video upload polling timed out — returning processing status");
+            return {
+                videoId,
+                title: input.title ?? uploadResult.title,
+                status: "processing",
+                uploadedAt: new Date().toISOString(),
+            };
+        }
+        throw error;
+    }
+}
+export function uploadVideoResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Video uploaded to Meta!\n\nVideo ID: ${result.videoId}\nStatus: ${result.status}${result.title ? `\nTitle: ${result.title}` : ""}\n\nUse videoId in adCreative.video_data.video_id`,
+        },
+    ];
+}
+export const uploadVideoTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UploadVideoInputSchema,
+    outputSchema: UploadVideoOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        idempotentHint: false,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Upload a campaign video",
+            input: {
+                adAccountId: "act_1234567890",
+                mediaUrl: "https://example.com/summer-sale.mp4",
+                title: "Summer Sale 2025",
+            },
+        },
+    ],
+    logic: uploadVideoLogic,
+    responseFormatter: uploadVideoResponseFormatter,
+};
+//# sourceMappingURL=upload-video.tool.js.map

package/dist/mcp-server/tools/definitions/upload-video.tool.js.map

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