@cesteral/pinterest-mcp 1.0.0

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

@@ -0,0 +1,81 @@
+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;
+    filename: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adAccountId: string;
+    mediaUrl: string;
+    filename?: string | undefined;
+}, {
+    adAccountId: string;
+    mediaUrl: string;
+    filename?: string | undefined;
+}>;
+export declare const UploadImageOutputSchema: z.ZodObject<{
+    mediaId: z.ZodString;
+    mediaType: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mediaId: string;
+    uploadedAt: string;
+    mediaType?: string | undefined;
+}, {
+    mediaId: string;
+    uploadedAt: string;
+    mediaType?: 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;
+        filename: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountId: string;
+        mediaUrl: string;
+        filename?: string | undefined;
+    }, {
+        adAccountId: string;
+        mediaUrl: string;
+        filename?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        mediaId: z.ZodString;
+        mediaType: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mediaId: string;
+        uploadedAt: string;
+        mediaType?: string | undefined;
+    }, {
+        mediaId: string;
+        uploadedAt: string;
+        mediaType?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            adAccountId: string;
+            mediaUrl: 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;;;;;;;;;;;;EAI0B,CAAC;AAE9D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIQ,CAAC;AAE7C,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,CAsC5B;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAKxF;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB3B,CAAC"}

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

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { downloadFileToBuffer } from "@cesteral/shared";
+const TOOL_NAME = "pinterest_upload_image";
+const TOOL_TITLE = "Upload Image to Pinterest Ads";
+const TOOL_DESCRIPTION = `Upload an image to Pinterest Ads Library from a URL.
+
+The server downloads the image and uploads it to Pinterest's ad media library.
+Returns the mediaId for use in ad creatives.
+
+**Image requirements:**
+- Formats: JPEG, PNG
+- Max file size: 100KB (for feed ads), 500KB (for other placements)
+- Recommended dimensions: 1200x628px, 1080x1080px, 720x1280px
+
+**Usage:** The returned mediaId is used in ad creative payloads.`;
+export const UploadImageInputSchema = z.object({
+    adAccountId: z.string().describe("Pinterest Ad Account ID"),
+    mediaUrl: z.string().url().describe("Publicly accessible URL of the image to upload"),
+    filename: z.string().optional().describe("Override filename (otherwise derived from URL)"),
+}).describe("Parameters for uploading an image to Pinterest");
+export const UploadImageOutputSchema = z.object({
+    mediaId: z.string().describe("Media ID for use in ad creative payloads"),
+    mediaType: z.string().optional().describe("Media type"),
+    uploadedAt: z.string().datetime(),
+}).describe("Uploaded Pinterest image info");
+export async function uploadImageLogic(input, context, sdkContext) {
+    const { pinterestService } = resolveSessionServices(sdkContext);
+    const { buffer, contentType, filename } = await downloadFileToBuffer(input.mediaUrl, 120_000, context);
+    const effectiveFilename = input.filename ?? filename;
+    const registration = await pinterestService.client.post("/v5/media", { media_type: "image" }, context);
+    const mediaId = registration.media_id;
+    if (!mediaId || !registration.upload_url) {
+        throw new Error("Pinterest image upload registration failed: missing media_id or upload_url");
+    }
+    await pinterestService.client.uploadToS3(registration.upload_url, registration.upload_parameters ?? {}, buffer, effectiveFilename, contentType, context);
+    return {
+        mediaId,
+        mediaType: registration.media_type,
+        uploadedAt: new Date().toISOString(),
+    };
+}
+export function uploadImageResponseFormatter(result) {
+    return [{
+            type: "text",
+            text: `Image uploaded to Pinterest!\n\nMedia ID: ${result.mediaId}${result.mediaType ? `\nMedia Type: ${result.mediaType}` : ""}\n\nUse mediaId in your ad 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 Pinterest ad image",
+            input: {
+                adAccountId: "1234567890",
+                mediaUrl: "https://example.com/banner.jpg",
+            },
+        },
+    ],
+    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;
+    videoName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adAccountId: string;
+    mediaUrl: string;
+    videoName?: string | undefined;
+}, {
+    adAccountId: string;
+    mediaUrl: string;
+    videoName?: 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;
+        videoName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountId: string;
+        mediaUrl: string;
+        videoName?: string | undefined;
+    }, {
+        adAccountId: string;
+        mediaUrl: string;
+        videoName?: 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;
+            videoName: 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;;;;;;;;;;;;EAMyB,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAMQ,CAAC;AAE7C,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,CAkE5B;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,100 @@
+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 = "pinterest_upload_video";
+const TOOL_TITLE = "Upload Video to Pinterest Ads";
+const TOOL_DESCRIPTION = `Upload a video to Pinterest Ads Library from a URL.
+
+The server downloads the video and uploads it to Pinterest's ad media library.
+Polls until processing is complete (up to 10 minutes).
+
+**Video requirements:**
+- Formats: MP4, MOV (H.264 codec recommended)
+- Max file size: 500MB
+- Min resolution: 240px on shortest side
+- Duration: 2 to 60 seconds for standard ads
+
+**Usage:** The returned mediaId is used in ad creative payloads.`;
+export const UploadVideoInputSchema = z
+    .object({
+    adAccountId: z.string().describe("Pinterest Ad Account ID"),
+    mediaUrl: z.string().url().describe("Publicly accessible URL of the video to upload"),
+    videoName: z.string().optional().describe("Optional name for the video in the library"),
+})
+    .describe("Parameters for uploading a video to Pinterest");
+export const UploadVideoOutputSchema = z
+    .object({
+    mediaId: z.string().describe("Media ID for use in ad creative payloads"),
+    mediaStatus: z.string().optional().describe("Final media processing status"),
+    uploadedAt: z.string().datetime(),
+})
+    .describe("Uploaded Pinterest video info");
+export async function uploadVideoLogic(input, context, sdkContext) {
+    const { pinterestService } = resolveSessionServices(sdkContext);
+    const { buffer, contentType, filename } = await downloadFileToBuffer(input.mediaUrl, 600_000, context);
+    const registration = (await pinterestService.client.post("/v5/media", { media_type: "video" }, context));
+    const mediaId = registration.media_id;
+    if (!mediaId || !registration.upload_url) {
+        throw new McpError(JsonRpcErrorCode.InternalError, "Pinterest video upload registration failed: missing media_id or upload_url");
+    }
+    await pinterestService.client.uploadToS3(registration.upload_url, registration.upload_parameters ?? {}, buffer, input.videoName ?? filename, contentType, context);
+    try {
+        const finalStatus = await pollUntilComplete({
+            fetchStatus: async () => {
+                const statusResult = (await pinterestService.client.get(`/v5/media/${mediaId}`, undefined, context));
+                return statusResult.media_processing_record?.status ?? "processing";
+            },
+            isComplete: (s) => s === "succeeded" || s === "SUCCEEDED",
+            isFailed: (s) => s === "failed" || s === "FAILED",
+            initialDelayMs: mcpConfig.pinterestVideoUploadPollIntervalMs,
+            maxDelayMs: mcpConfig.pinterestVideoUploadPollIntervalMs,
+            maxAttempts: mcpConfig.pinterestVideoUploadMaxPollAttempts,
+            backoffFactor: 1,
+        });
+        return { mediaId, mediaStatus: finalStatus, uploadedAt: new Date().toISOString() };
+    }
+    catch (error) {
+        if (error instanceof ReportFailedError) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Pinterest 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 Pinterest!\n\nMedia ID: ${result.mediaId}${result.mediaStatus ? `\nStatus: ${result.mediaStatus}` : ""}\n\nUse mediaId in your ad 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 Pinterest campaign video",
+            input: {
+                adAccountId: "1234567890",
+                mediaUrl: "https://example.com/video.mp4",
+                videoName: "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 PinterestEntityType } from "../utils/entity-mapping.js";
+export declare const validateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[PinterestEntityType, ...PinterestEntityType[]]>;
+        mode: z.ZodEnum<["create", "update"]>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: PinterestEntityType;
+        data: Record<string, unknown>;
+        mode: "create" | "update";
+    }, {
+        entityType: PinterestEntityType;
+        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: PinterestEntityType;
+        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<[PinterestEntityType, ...PinterestEntityType[]]>;
+    mode: z.ZodEnum<["create", "update"]>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    entityType: PinterestEntityType;
+    data: Record<string, unknown>;
+    mode: "create" | "update";
+}, {
+    entityType: PinterestEntityType;
+    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: PinterestEntityType;
+    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,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAoDzF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAuET,CAAC;2BACgB,CAAC;oBAGpC,CAAF;;;;;gBAUQ,CAAA;2BACI,CAAC;oBACQ,CAAA;;;;;;;;;gBAiBa,CAAC;2BACxB,CAAC;oBAA4C,CAAC;;;;;;kBAE+B,CAAC;;;;;;gBAA6M,CAAC;2BAAiD,CAAC;oBAA4C,CAAC;;;;;;kBAAuK,CAAC;;;;;;;;;;;;;;;;;;CAL9iB,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAAiC,CAAC;AACxE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;YAlCjB,CAAC;uBACgB,CAAC;gBAGpC,CAAF;;;;;YAUQ,CAAA;uBACI,CAAC;gBACQ,CAAA;;;;;;;;;YAiBa,CAAC;uBACxB,CAAC;gBAA4C,CAAC;;;;;;;;;;;;YAE6O,CAAC;uBAAiD,CAAC;gBAA4C,CAAC;;;;;;;EAF/T,CAAC;AAC1E,eAAO,MAAM,mBAAmB;;;;wKAA2B,CAAC"}