@cesteral/linkedin-mcp 1.0.0

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

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const DeleteEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityUrn: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    entityUrn: string;
+}, {
+    entityType: string;
+    entityUrn: string;
+}>;
+export declare const DeleteEntityOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    success: z.ZodBoolean;
+    entityUrn: z.ZodString;
+    entityType: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    entityUrn: string;
+    success: boolean;
+    confirmed: boolean;
+    declineReason?: string | undefined;
+}, {
+    entityType: string;
+    timestamp: string;
+    entityUrn: string;
+    success: boolean;
+    confirmed: boolean;
+    declineReason?: string | undefined;
+}>;
+type DeleteEntityInput = z.infer<typeof DeleteEntityInputSchema>;
+type DeleteEntityOutput = z.infer<typeof DeleteEntityOutputSchema>;
+export declare function deleteEntityLogic(input: DeleteEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<DeleteEntityOutput>;
+export declare function deleteEntityResponseFormatter(result: DeleteEntityOutput): McpTextContent[];
+export declare const deleteEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        entityUrn: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        entityUrn: string;
+    }, {
+        entityType: string;
+        entityUrn: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        success: z.ZodBoolean;
+        entityUrn: z.ZodString;
+        entityType: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        entityUrn: string;
+        success: boolean;
+        confirmed: boolean;
+        declineReason?: string | undefined;
+    }, {
+        entityType: string;
+        timestamp: string;
+        entityUrn: string;
+        success: boolean;
+        confirmed: boolean;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            entityUrn: string;
+        };
+    }[];
+    logic: typeof deleteEntityLogic;
+    responseFormatter: typeof deleteEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=delete-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAanD,eAAO,MAAM,uBAAuB;;;;;;;;;EAQwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EASA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAgC7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAe1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB5B,CAAC"}

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

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { elicitDeleteConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_delete_entity";
+const TOOL_TITLE = "Delete LinkedIn Ads Entity";
+const TOOL_DESCRIPTION = `Delete a LinkedIn Ads entity by URN.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Gotchas:**
+- Active campaigns/campaign groups must be paused before deletion.
+- Deletion is permanent and cannot be undone.
+- Creative deletion will unlink it from any campaigns.`;
+export const DeleteEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to delete"),
+    entityUrn: z
+        .string()
+        .min(1)
+        .describe("The entity URN to delete (e.g., urn:li:sponsoredCampaign:123)"),
+})
+    .describe("Parameters for deleting a LinkedIn Ads entity");
+export const DeleteEntityOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    success: z.boolean(),
+    entityUrn: z.string(),
+    entityType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity deletion result");
+export async function deleteEntityLogic(input, context, sdkContext) {
+    const confirmed = await elicitDeleteConfirmation({
+        entityLabel: input.entityType,
+        entityId: input.entityUrn,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            success: false,
+            entityUrn: input.entityUrn,
+            entityType: input.entityType,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    await linkedInService.deleteEntity(input.entityType, input.entityUrn, context);
+    return {
+        confirmed: true,
+        success: true,
+        entityUrn: input.entityUrn,
+        entityType: input.entityType,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function deleteEntityResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Deletion of ${result.entityType} ${result.entityUrn} cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} ${result.entityUrn} deleted successfully\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const deleteEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: DeleteEntityInputSchema,
+    outputSchema: DeleteEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Delete a campaign",
+            input: {
+                entityType: "campaign",
+                entityUrn: "urn:li:sponsoredCampaign:123456789",
+            },
+        },
+    ],
+    logic: deleteEntityLogic,
+    responseFormatter: deleteEntityResponseFormatter,
+};
+//# sourceMappingURL=delete-entity.tool.js.map

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

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

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

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const DuplicateEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityUrn: z.ZodString;
+    newName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    entityUrn: string;
+    newName?: string | undefined;
+}, {
+    entityType: string;
+    entityUrn: string;
+    newName?: string | undefined;
+}>;
+export declare const DuplicateEntityOutputSchema: z.ZodObject<{
+    sourceUrn: z.ZodString;
+    newEntity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    entityType: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    sourceUrn: string;
+    newEntity: Record<string, any>;
+}, {
+    entityType: string;
+    timestamp: string;
+    sourceUrn: string;
+    newEntity: Record<string, any>;
+}>;
+type DuplicateEntityInput = z.infer<typeof DuplicateEntityInputSchema>;
+type DuplicateEntityOutput = z.infer<typeof DuplicateEntityOutputSchema>;
+export declare function duplicateEntityLogic(input: DuplicateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<DuplicateEntityOutput>;
+export declare function duplicateEntityResponseFormatter(result: DuplicateEntityOutput): McpTextContent[];
+export declare const duplicateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        entityUrn: z.ZodString;
+        newName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        entityUrn: string;
+        newName?: string | undefined;
+    }, {
+        entityType: string;
+        entityUrn: string;
+        newName?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        sourceUrn: z.ZodString;
+        newEntity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        entityType: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        sourceUrn: string;
+        newEntity: Record<string, any>;
+    }, {
+        entityType: string;
+        timestamp: string;
+        sourceUrn: string;
+        newEntity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            entityUrn: string;
+            newName?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            entityUrn: string;
+            newName: string;
+        };
+    })[];
+    logic: typeof duplicateEntityLogic;
+    responseFormatter: typeof duplicateEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=duplicate-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/duplicate-entity.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;AAoBnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EASwB,CAAC;AAEhE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAOP,CAAC;AAElC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAOhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/B,CAAC"}

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "linkedin_duplicate_entity";
+const TOOL_TITLE = "Duplicate LinkedIn Ads Entity";
+const TOOL_DESCRIPTION = `Copy a LinkedIn Ads entity by reading it and creating a new entity with the same settings.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+LinkedIn does not have a native copy API endpoint, so this tool:
+1. Reads the source entity
+2. Strips read-only fields (id, changeAuditStamps, etc.)
+3. Sets name to "Copy of {name}" (or custom name if provided)
+4. Sets status to DRAFT
+5. Creates the new entity
+
+**Gotchas:**
+- The new entity will be in DRAFT status regardless of source status.
+- Some entity-specific fields may need manual adjustment after duplication.
+- Campaign URNs in references (e.g., creative.campaign) are preserved from source.`;
+export const DuplicateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to duplicate"),
+    entityUrn: z.string().min(1).describe("The source entity URN to copy"),
+    newName: z
+        .string()
+        .optional()
+        .describe("Name for the new entity (defaults to 'Copy of {original name}')"),
+})
+    .describe("Parameters for duplicating a LinkedIn Ads entity");
+export const DuplicateEntityOutputSchema = z
+    .object({
+    sourceUrn: z.string(),
+    newEntity: z.record(z.any()).describe("The newly created entity"),
+    entityType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Duplication result");
+export async function duplicateEntityLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const newEntity = await linkedInService.duplicateEntity(input.entityType, input.entityUrn, { newName: input.newName }, context);
+    return {
+        sourceUrn: input.entityUrn,
+        newEntity: newEntity,
+        entityType: input.entityType,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function duplicateEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} duplicated from ${result.sourceUrn}\n\nNew entity:\n${JSON.stringify(result.newEntity, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const duplicateEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: DuplicateEntityInputSchema,
+    outputSchema: DuplicateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Duplicate a campaign with default name",
+            input: {
+                entityType: "campaign",
+                entityUrn: "urn:li:sponsoredCampaign:123456789",
+            },
+        },
+        {
+            label: "Duplicate a campaign group with custom name",
+            input: {
+                entityType: "campaignGroup",
+                entityUrn: "urn:li:sponsoredCampaignGroup:987654321",
+                newName: "Q2 2026 Brand Awareness (Copy)",
+            },
+        },
+    ],
+    logic: duplicateEntityLogic,
+    responseFormatter: duplicateEntityResponseFormatter,
+};
+//# sourceMappingURL=duplicate-entity.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetAdPreviewInputSchema: z.ZodObject<{
+    creativeUrn: z.ZodString;
+    adFormat: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    creativeUrn: string;
+    adFormat?: string | undefined;
+}, {
+    creativeUrn: string;
+    adFormat?: string | undefined;
+}>;
+export declare const GetAdPreviewOutputSchema: z.ZodObject<{
+    preview: z.ZodRecord<z.ZodString, z.ZodAny>;
+    creativeUrn: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    creativeUrn: string;
+    preview: Record<string, any>;
+}, {
+    timestamp: string;
+    creativeUrn: string;
+    preview: Record<string, any>;
+}>;
+type GetAdPreviewInput = z.infer<typeof GetAdPreviewInputSchema>;
+type GetAdPreviewOutput = z.infer<typeof GetAdPreviewOutputSchema>;
+export declare function getAdPreviewLogic(input: GetAdPreviewInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdPreviewOutput>;
+export declare function getAdPreviewResponseFormatter(result: GetAdPreviewOutput): McpTextContent[];
+export declare const getAdPreviewTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        creativeUrn: z.ZodString;
+        adFormat: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        creativeUrn: string;
+        adFormat?: string | undefined;
+    }, {
+        creativeUrn: string;
+        adFormat?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        preview: z.ZodRecord<z.ZodString, z.ZodAny>;
+        creativeUrn: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        creativeUrn: string;
+        preview: Record<string, any>;
+    }, {
+        timestamp: string;
+        creativeUrn: string;
+        preview: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            creativeUrn: string;
+            adFormat: string;
+        };
+    }[];
+    logic: typeof getAdPreviewLogic;
+    responseFormatter: typeof getAdPreviewResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-ad-preview.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ad-preview.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWnD,eAAO,MAAM,uBAAuB;;;;;;;;;EAQuB,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAML,CAAC;AAEjC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAU7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB5B,CAAC"}

package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "linkedin_get_ad_preview";
+const TOOL_TITLE = "Get LinkedIn Ads Ad Preview";
+const TOOL_DESCRIPTION = `Get a preview of a LinkedIn Ads creative.
+
+Returns preview rendering data for a creative URN.
+
+**adFormat values:** SINGLE_IMAGE_AD, VIDEO_AD, CAROUSEL_AD, TEXT_AD,
+SPOTLIGHT_AD, FOLLOWER_AD, MESSAGE_AD, CONVERSATION_AD`;
+export const GetAdPreviewInputSchema = z
+    .object({
+    creativeUrn: z
+        .string()
+        .min(1)
+        .describe("The creative URN to preview (e.g., urn:li:sponsoredCreative:123)"),
+    adFormat: z.string().optional().describe("Ad format for the preview (e.g., SINGLE_IMAGE_AD)"),
+})
+    .describe("Parameters for getting a LinkedIn ad preview");
+export const GetAdPreviewOutputSchema = z
+    .object({
+    preview: z.record(z.any()).describe("Preview data from LinkedIn API"),
+    creativeUrn: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Ad preview result");
+export async function getAdPreviewLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const preview = await linkedInService.getAdPreviews(input.creativeUrn, input.adFormat, context);
+    return {
+        preview: preview,
+        creativeUrn: input.creativeUrn,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getAdPreviewResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Ad preview for ${result.creativeUrn}\n\n${JSON.stringify(result.preview, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getAdPreviewTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetAdPreviewInputSchema,
+    outputSchema: GetAdPreviewOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get preview for a creative",
+            input: {
+                creativeUrn: "urn:li:sponsoredCreative:123456789",
+                adFormat: "SINGLE_IMAGE_AD",
+            },
+        },
+    ],
+    logic: getAdPreviewLogic,
+    responseFormatter: getAdPreviewResponseFormatter,
+};
+//# sourceMappingURL=get-ad-preview.tool.js.map

package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ad-preview.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;;;;uDAK8B,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAC9F,CAAC;KACD,QAAQ,CAAC,8CAA8C,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACrE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAKjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,eAAe,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEhG,OAAO;QACL,OAAO,EAAE,OAAkC;QAC3C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,kBAAkB,MAAM,CAAC,WAAW,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAC7H;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,4BAA4B;YACnC,KAAK,EAAE;gBACL,WAAW,EAAE,oCAAoC;gBACjD,QAAQ,EAAE,iBAAiB;aAC5B;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}

package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import type { RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "../../../types-global/mcp.js";
+export declare const GetAdPreviewsInputSchema: z.ZodObject<{
+    creativeUrn: z.ZodString;
+    adFormat: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    creativeUrn: string;
+    adFormat?: string | undefined;
+}, {
+    creativeUrn: string;
+    adFormat?: string | undefined;
+}>;
+export declare const GetAdPreviewsOutputSchema: z.ZodObject<{
+    preview: z.ZodRecord<z.ZodString, z.ZodAny>;
+    creativeUrn: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    creativeUrn: string;
+    preview: Record<string, any>;
+}, {
+    timestamp: string;
+    creativeUrn: string;
+    preview: Record<string, any>;
+}>;
+type GetAdPreviewsInput = z.infer<typeof GetAdPreviewsInputSchema>;
+type GetAdPreviewsOutput = z.infer<typeof GetAdPreviewsOutputSchema>;
+export declare function getAdPreviewsLogic(input: GetAdPreviewsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdPreviewsOutput>;
+export declare function getAdPreviewsResponseFormatter(result: GetAdPreviewsOutput): unknown[];
+export declare const getAdPreviewsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        creativeUrn: z.ZodString;
+        adFormat: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        creativeUrn: string;
+        adFormat?: string | undefined;
+    }, {
+        creativeUrn: string;
+        adFormat?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        preview: z.ZodRecord<z.ZodString, z.ZodAny>;
+        creativeUrn: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        creativeUrn: string;
+        preview: Record<string, any>;
+    }, {
+        timestamp: string;
+        creativeUrn: string;
+        preview: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            creativeUrn: string;
+            adFormat: string;
+        };
+    }[];
+    logic: typeof getAdPreviewsLogic;
+    responseFormatter: typeof getAdPreviewsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-ad-previews.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ad-previews.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-previews.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAW/D,eAAO,MAAM,wBAAwB;;;;;;;;;EAWsB,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAMN,CAAC;AAEjC,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AACnE,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErE,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAc9B;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,EAAE,CAOrF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB7B,CAAC"}