@cesteral/snapchat-mcp 1.0.0

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

@@ -0,0 +1,82 @@
+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<{
+    mediaId: z.ZodString;
+    mediaStatus: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mediaId: string;
+    uploadedAt: string;
+    mediaStatus?: string | undefined;
+}, {
+    mediaId: string;
+    uploadedAt: string;
+    mediaStatus?: 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<{
+        mediaId: z.ZodString;
+        mediaStatus: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mediaId: string;
+        uploadedAt: string;
+        mediaStatus?: string | undefined;
+    }, {
+        mediaId: string;
+        uploadedAt: string;
+        mediaStatus?: 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;AAUxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqBnD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMyB,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAMO,CAAC;AAE5C,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEjE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAoF5B;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,111 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { downloadFileToBuffer, McpError, JsonRpcErrorCode, pollUntilComplete, ReportTimeoutError, ReportFailedError, } from "@cesteral/shared";
+import { mcpConfig } from "../../../config/index.js";
+const TOOL_NAME = "snapchat_upload_image";
+const TOOL_TITLE = "Upload Image to Snapchat Ads";
+const TOOL_DESCRIPTION = `Upload an image to Snapchat Ads Library from a URL.
+
+The server downloads the image and uploads it to Snapchat's media library.
+Returns the mediaId for use in creative payloads.
+
+**Image requirements:**
+- Formats: JPEG, PNG
+- Max file size: 5MB
+- Recommended dimensions: 1080x1920px (9:16 vertical), 1080x1080px (1:1)
+
+**Usage:** The returned mediaId is used in creative payloads.`;
+export const UploadImageInputSchema = z
+    .object({
+    adAccountId: z.string().describe("Snapchat Ad Account ID"),
+    mediaUrl: z.string().url().describe("Publicly accessible URL of the image to upload"),
+    name: z.string().optional().describe("Name for the media in the library"),
+})
+    .describe("Parameters for uploading an image to Snapchat");
+export const UploadImageOutputSchema = z
+    .object({
+    mediaId: z.string().describe("Media ID for use in creative payloads"),
+    mediaStatus: z.string().optional().describe("Media processing status"),
+    uploadedAt: z.string().datetime(),
+})
+    .describe("Uploaded Snapchat image info");
+export async function uploadImageLogic(input, context, sdkContext) {
+    const { snapchatService } = resolveSessionServices(sdkContext);
+    const { buffer, contentType, filename } = await downloadFileToBuffer(input.mediaUrl, 120_000, context);
+    const createResult = (await snapchatService.client.post(`/v1/adaccounts/${input.adAccountId}/media`, {
+        media: [
+            {
+                name: input.name ?? filename,
+                type: "IMAGE",
+                ad_account_id: input.adAccountId,
+            },
+        ],
+    }, context));
+    const createdItem = createResult.media?.[0]?.media;
+    const mediaId = createdItem?.id;
+    if (!mediaId) {
+        throw new McpError(JsonRpcErrorCode.InternalError, "Snapchat image upload failed: no media id returned from create step");
+    }
+    await snapchatService.client.postMultipart(`/v1/media/${mediaId}/upload`, {}, "file", buffer, filename, contentType, context);
+    try {
+        const finalStatus = await pollUntilComplete({
+            fetchStatus: async () => {
+                const statusResult = (await snapchatService.client.get(`/v1/media/${mediaId}`, undefined, context));
+                return statusResult.media?.[0]?.media?.media_status ?? "PENDING";
+            },
+            isComplete: (s) => s === "READY",
+            isFailed: (s) => s === "FAILED",
+            initialDelayMs: mcpConfig.snapchatVideoUploadPollIntervalMs,
+            maxDelayMs: mcpConfig.snapchatVideoUploadPollIntervalMs,
+            maxAttempts: mcpConfig.snapchatVideoUploadMaxPollAttempts,
+            backoffFactor: 1,
+        });
+        return { mediaId, mediaStatus: finalStatus, uploadedAt: new Date().toISOString() };
+    }
+    catch (error) {
+        if (error instanceof ReportFailedError) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat image processing failed: status=${String(error.status)}`);
+        }
+        if (error instanceof ReportTimeoutError) {
+            throw new McpError(JsonRpcErrorCode.Timeout, `Snapchat image processing timed out before media reached READY status: mediaId=${mediaId}`, {
+                mediaId,
+                nextAction: "Retry later by checking the Snapchat media status, then use the mediaId only after status is READY.",
+            }, { cause: error });
+        }
+        throw error;
+    }
+}
+export function uploadImageResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Image uploaded to Snapchat!\n\nMedia ID: ${result.mediaId}${result.mediaStatus ? `\nStatus: ${result.mediaStatus}` : ""}\n\nUse mediaId in your creative payload`,
+        },
+    ];
+}
+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 Snapchat ad image",
+            input: {
+                adAccountId: "1234567890",
+                mediaUrl: "https://example.com/banner.jpg",
+                name: "Summer 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,82 @@
+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;
+    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 UploadVideoOutputSchema: z.ZodObject<{
+    mediaId: z.ZodString;
+    mediaStatus: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mediaId: string;
+    uploadedAt: string;
+    mediaStatus?: string | undefined;
+}, {
+    mediaId: string;
+    uploadedAt: string;
+    mediaStatus?: 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;
+        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<{
+        mediaId: z.ZodString;
+        mediaStatus: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mediaId: string;
+        uploadedAt: string;
+        mediaStatus?: string | undefined;
+    }, {
+        mediaId: string;
+        uploadedAt: string;
+        mediaStatus?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            adAccountId: string;
+            mediaUrl: string;
+            name: 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;AAUxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAsBnD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMwB,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAMO,CAAC;AAE5C,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEjE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA4E5B;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,109 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { downloadFileToBuffer, McpError, JsonRpcErrorCode, pollUntilComplete, ReportTimeoutError, ReportFailedError, } from "@cesteral/shared";
+import { mcpConfig } from "../../../config/index.js";
+const TOOL_NAME = "snapchat_upload_video";
+const TOOL_TITLE = "Upload Video to Snapchat Ads";
+const TOOL_DESCRIPTION = `Upload a video to Snapchat Ads Library from a URL.
+
+The server downloads the video and uploads it to Snapchat's media library.
+Polls until processing is complete (up to 10 minutes).
+
+**Video requirements:**
+- Formats: MP4, MOV (H.264 codec recommended)
+- Max file size: 1GB
+- Min resolution: 540x960px (9:16), 640x640px (1:1)
+- Duration: 3 to 180 seconds
+
+**Usage:** The returned mediaId is used in creative payloads.`;
+export const UploadVideoInputSchema = z
+    .object({
+    adAccountId: z.string().describe("Snapchat Ad Account ID"),
+    mediaUrl: z.string().url().describe("Publicly accessible URL of the video to upload"),
+    name: z.string().optional().describe("Optional name for the video in the library"),
+})
+    .describe("Parameters for uploading a video to Snapchat");
+export const UploadVideoOutputSchema = z
+    .object({
+    mediaId: z.string().describe("Media ID for use in creative payloads"),
+    mediaStatus: z.string().optional().describe("Final media processing status"),
+    uploadedAt: z.string().datetime(),
+})
+    .describe("Uploaded Snapchat video info");
+export async function uploadVideoLogic(input, context, sdkContext) {
+    const { snapchatService } = resolveSessionServices(sdkContext);
+    const { buffer, contentType, filename } = await downloadFileToBuffer(input.mediaUrl, 600_000, context);
+    const createResult = (await snapchatService.client.post(`/v1/adaccounts/${input.adAccountId}/media`, {
+        media: [
+            {
+                name: input.name ?? filename,
+                type: "VIDEO",
+                ad_account_id: input.adAccountId,
+            },
+        ],
+    }, context));
+    const mediaItem = createResult.media?.[0]?.media;
+    const mediaId = mediaItem?.id;
+    if (!mediaId) {
+        throw new McpError(JsonRpcErrorCode.InternalError, "Snapchat video upload failed: no media id returned from create step");
+    }
+    await snapchatService.client.postMultipart(`/v1/media/${mediaId}/upload`, {}, "file", buffer, filename, contentType, context);
+    try {
+        const finalStatus = await pollUntilComplete({
+            fetchStatus: async () => {
+                const statusResult = (await snapchatService.client.get(`/v1/media/${mediaId}`, undefined, context));
+                return statusResult.media?.[0]?.media?.media_status ?? "PENDING";
+            },
+            isComplete: (s) => s === "READY",
+            isFailed: (s) => s === "FAILED",
+            initialDelayMs: mcpConfig.snapchatVideoUploadPollIntervalMs,
+            maxDelayMs: mcpConfig.snapchatVideoUploadPollIntervalMs,
+            maxAttempts: mcpConfig.snapchatVideoUploadMaxPollAttempts,
+            backoffFactor: 1,
+        });
+        return { mediaId, mediaStatus: finalStatus, uploadedAt: new Date().toISOString() };
+    }
+    catch (error) {
+        if (error instanceof ReportFailedError) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat video processing failed: status=${String(error.status)}`);
+        }
+        if (error instanceof ReportTimeoutError) {
+            return { mediaId, uploadedAt: new Date().toISOString() };
+        }
+        throw error;
+    }
+}
+export function uploadVideoResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Video uploaded to Snapchat!\n\nMedia ID: ${result.mediaId}${result.mediaStatus ? `\nStatus: ${result.mediaStatus}` : ""}\n\nUse mediaId in your creative payload`,
+        },
+    ];
+}
+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 Snapchat campaign video",
+            input: {
+                adAccountId: "1234567890",
+                mediaUrl: "https://example.com/video.mp4",
+                name: "Summer Campaign 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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"}

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

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { type SnapchatEntityType } from "../utils/entity-mapping.js";
+export declare const validateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[SnapchatEntityType, ...SnapchatEntityType[]]>;
+        mode: z.ZodEnum<["create", "update"]>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: SnapchatEntityType;
+        data: Record<string, unknown>;
+        mode: "create" | "update";
+    }, {
+        entityType: SnapchatEntityType;
+        data: Record<string, unknown>;
+        mode: "create" | "update";
+    }>;
+    outputSchema: z.ZodObject<{
+        valid: z.ZodBoolean;
+        entityType: z.ZodString;
+        mode: z.ZodString;
+        issues: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            code: z.ZodEnum<["missing", "wrongType", "invalidValue", "readOnly", "custom"]>;
+            message: z.ZodString;
+            hint: z.ZodOptional<z.ZodString>;
+            suggestedValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+        }, "strip", z.ZodTypeAny, {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "error" | "warning" | undefined;
+        }, {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "error" | "warning" | undefined;
+        }>, "many">;
+        nextAction: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        issues: {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "error" | "warning" | undefined;
+        }[];
+        valid: boolean;
+        entityType: string;
+        mode: string;
+        timestamp: string;
+        nextAction?: string | undefined;
+    }, {
+        issues: {
+            code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+            message: string;
+            field: string;
+            hint?: string | undefined;
+            suggestedValues?: string[] | undefined;
+            severity?: "error" | "warning" | undefined;
+        }[];
+        valid: boolean;
+        entityType: string;
+        mode: string;
+        timestamp: string;
+        nextAction?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: Record<string, unknown>;
+    }[];
+    logic: (input: {
+        entityType: SnapchatEntityType;
+        data: Record<string, unknown>;
+        mode: "create" | "update";
+    }, _context: import("@cesteral/shared").RequestContext, _sdkContext?: import("@cesteral/shared").SdkContext) => Promise<import("@cesteral/shared").ValidateEntityOutput>;
+    responseFormatter: typeof import("@cesteral/shared").validateEntityResponseFormatter;
+};
+export declare const ValidateEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[SnapchatEntityType, ...SnapchatEntityType[]]>;
+    mode: z.ZodEnum<["create", "update"]>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    entityType: SnapchatEntityType;
+    data: Record<string, unknown>;
+    mode: "create" | "update";
+}, {
+    entityType: SnapchatEntityType;
+    data: Record<string, unknown>;
+    mode: "create" | "update";
+}>;
+export declare const ValidateEntityOutputSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    entityType: z.ZodString;
+    mode: z.ZodString;
+    issues: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        code: z.ZodEnum<["missing", "wrongType", "invalidValue", "readOnly", "custom"]>;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        suggestedValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "error" | "warning" | undefined;
+    }, {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "error" | "warning" | undefined;
+    }>, "many">;
+    nextAction: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    issues: {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "error" | "warning" | undefined;
+    }[];
+    valid: boolean;
+    entityType: string;
+    mode: string;
+    timestamp: string;
+    nextAction?: string | undefined;
+}, {
+    issues: {
+        code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
+        message: string;
+        field: string;
+        hint?: string | undefined;
+        suggestedValues?: string[] | undefined;
+        severity?: "error" | "warning" | undefined;
+    }[];
+    valid: boolean;
+    entityType: string;
+    mode: string;
+    timestamp: string;
+    nextAction?: string | undefined;
+}>;
+export declare const validateEntityLogic: (input: {
+    entityType: SnapchatEntityType;
+    data: Record<string, unknown>;
+    mode: "create" | "update";
+}, _context: import("@cesteral/shared").RequestContext, _sdkContext?: import("@cesteral/shared").SdkContext) => Promise<import("@cesteral/shared").ValidateEntityOutput>;
+//# sourceMappingURL=validate-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/validate-entity.tool.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AA0ExF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAuDR,CAAC;2BAEF,CAAC;oBAA4C,CAAC;;;;;gBAQ1D,CAAJ;2BAAiD,CAAC;oBAEhD,CAAN;;;;;;;;;gBAawB,CAAA;2BACI,CAAC;oBACrB,CAAC;;;;;;kBAIY,CAAC;;;;;;gBAQkC,CAAC;2BAEnD,CAAJ;oBACwB,CAAC;;;;;;kBAGsC,CAAA;;;;;;;;;;;;;;;;;;CAwCjE,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAAiC,CAAC;AACxE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;YAxFhB,CAAC;uBAEF,CAAC;gBAA4C,CAAC;;;;;YAQ1D,CAAJ;uBAAiD,CAAC;gBAEhD,CAAN;;;;;;;;;YAawB,CAAA;uBACI,CAAC;gBACrB,CAAC;;;;;;;;;;;;YAY+C,CAAC;uBAEnD,CAAJ;gBACwB,CAAC;;;;;;;EA8C4C,CAAC;AAC1E,eAAO,MAAM,mBAAmB;;;;wKAA2B,CAAC"}