@cesteral/amazon-dsp-mcp 1.0.0

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

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "amazon_dsp_duplicate_entity";
+const TOOL_TITLE = "Duplicate AmazonDsp Ads Entity";
+const TOOL_DESCRIPTION = `Duplicate a AmazonDsp Ads entity (copy it).
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Creates a copy of the entity. The copy is created in DISABLED status by default.
+Use the returned entity ID to make modifications before enabling.`;
+export const DuplicateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to duplicate"),
+    profileId: z.string().min(1).describe("AmazonDsp Advertiser ID"),
+    entityId: z.string().min(1).describe("ID of the entity to duplicate"),
+    options: z
+        .record(z.any())
+        .optional()
+        .describe("Optional copy options (e.g., new name, target campaign ID)"),
+})
+    .describe("Parameters for duplicating a AmazonDsp Ads entity");
+export const DuplicateEntityOutputSchema = z
+    .object({
+    newEntity: z.record(z.any()).describe("Newly created duplicate entity data"),
+    sourceEntityId: z.string(),
+    entityType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity duplication result");
+export async function duplicateEntityLogic(input, context, sdkContext) {
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    const newEntity = await amazonDspService.duplicateEntity(input.entityType, input.entityId, input.options, context);
+    return {
+        newEntity: newEntity,
+        sourceEntityId: input.entityId,
+        entityType: input.entityType,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function duplicateEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} ${result.sourceEntityId} duplicated successfully\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: false,
+    },
+    inputExamples: [
+        {
+            label: "Duplicate an order (campaign)",
+            input: {
+                entityType: "order",
+                profileId: "1234567890",
+                entityId: "ord_123456789",
+            },
+        },
+        {
+            label: "Duplicate a line item with new name",
+            input: {
+                entityType: "lineItem",
+                profileId: "1234567890",
+                entityId: "li_123456789",
+                options: {
+                    name: "Copy of Line Item A",
+                },
+            },
+        },
+    ],
+    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<{
+    profileId: z.ZodString;
+    adId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    profileId: string;
+    adId: string;
+}, {
+    profileId: string;
+    adId: string;
+}>;
+export declare const GetAdPreviewOutputSchema: z.ZodObject<{
+    preview: z.ZodRecord<z.ZodString, z.ZodAny>;
+    adId: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    adId: string;
+    preview: Record<string, any>;
+}, {
+    timestamp: string;
+    adId: 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<{
+        profileId: z.ZodString;
+        adId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        profileId: string;
+        adId: string;
+    }, {
+        profileId: string;
+        adId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        preview: z.ZodRecord<z.ZodString, z.ZodAny>;
+        adId: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        adId: string;
+        preview: Record<string, any>;
+    }, {
+        timestamp: string;
+        adId: string;
+        preview: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            profileId: string;
+            adId: 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;AASnD,eAAO,MAAM,uBAAuB;;;;;;;;;EAKgC,CAAC;AAErE,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,63 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "amazon_dsp_get_ad_preview";
+const TOOL_TITLE = "Get AmazonDsp Ad Preview";
+const TOOL_DESCRIPTION = `Get a preview of how an Amazon DSP creative will appear to users.
+
+Returns preview data for the creative as served via the Amazon DSP platform.
+Uses the \`GET /dsp/creatives/{creativeId}/preview\` endpoint.`;
+export const GetAdPreviewInputSchema = z
+    .object({
+    profileId: z.string().min(1).describe("Amazon DSP Advertiser ID"),
+    adId: z.string().min(1).describe("The creative ID to preview"),
+})
+    .describe("Parameters for getting an Amazon DSP creative preview");
+export const GetAdPreviewOutputSchema = z
+    .object({
+    preview: z.record(z.any()).describe("Ad preview data from AmazonDsp"),
+    adId: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Ad preview result");
+export async function getAdPreviewLogic(input, context, sdkContext) {
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    const preview = await amazonDspService.getAdPreviews(input.adId, context);
+    return {
+        preview: preview,
+        adId: input.adId,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getAdPreviewResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Ad preview for ${result.adId}:\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: "Preview an Amazon DSP creative",
+            input: {
+                profileId: "1234567890",
+                adId: "cre_123456789",
+            },
+        },
+    ],
+    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,2BAA2B,CAAC;AAC9C,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,gBAAgB,GAAG;;;+DAGsC,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CAC/D,CAAC;KACD,QAAQ,CAAC,uDAAuD,CAAC,CAAC;AAErE,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,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,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,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,OAAO,EAAE,OAAkC;QAC3C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,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,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACrH;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,gCAAgC;YACvC,KAAK,EAAE;gBACL,SAAS,EAAE,YAAY;gBACvB,IAAI,EAAE,eAAe;aACtB;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}

package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetAudienceEstimateInputSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    targetingConfig: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    profileId: string;
+    targetingConfig: Record<string, any>;
+}, {
+    profileId: string;
+    targetingConfig: Record<string, any>;
+}>;
+export declare const GetAudienceEstimateOutputSchema: z.ZodObject<{
+    estimate: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    estimate: Record<string, any>;
+}, {
+    timestamp: string;
+    estimate: Record<string, any>;
+}>;
+type GetAudienceEstimateInput = z.infer<typeof GetAudienceEstimateInputSchema>;
+type GetAudienceEstimateOutput = z.infer<typeof GetAudienceEstimateOutputSchema>;
+export declare function getAudienceEstimateLogic(input: GetAudienceEstimateInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAudienceEstimateOutput>;
+export declare function getAudienceEstimateResponseFormatter(result: GetAudienceEstimateOutput): McpTextContent[];
+export declare const getAudienceEstimateTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        profileId: z.ZodString;
+        targetingConfig: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        profileId: string;
+        targetingConfig: Record<string, any>;
+    }, {
+        profileId: string;
+        targetingConfig: Record<string, any>;
+    }>;
+    outputSchema: z.ZodObject<{
+        estimate: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        estimate: Record<string, any>;
+    }, {
+        timestamp: string;
+        estimate: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            profileId: string;
+            targetingConfig: {
+                age: string[];
+                gender: string[];
+                location_ids: string[];
+                interest_category_ids?: undefined;
+            };
+        };
+    } | {
+        label: string;
+        input: {
+            profileId: string;
+            targetingConfig: {
+                age: string[];
+                location_ids: string[];
+                interest_category_ids: string[];
+                gender?: undefined;
+            };
+        };
+    })[];
+    logic: typeof getAudienceEstimateLogic;
+    responseFormatter: typeof getAudienceEstimateResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-audience-estimate.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-audience-estimate.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-audience-estimate.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;AAmBnD,eAAO,MAAM,8BAA8B;;;;;;;;;EAU6B,CAAC;AAEzE,eAAO,MAAM,+BAA+B;;;;;;;;;EAKL,CAAC;AAExC,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAYpC;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,EAAE,CAOxG;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCnC,CAAC"}

package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "amazon_dsp_get_audience_estimate";
+const TOOL_TITLE = "AmazonDsp Audience Size Estimate";
+const TOOL_DESCRIPTION = `Get an estimated audience size for a AmazonDsp targeting configuration.
+
+Use this to validate and tune targeting before creating ad groups.
+Returns estimated reach and audience size ranges.
+
+**Example targeting config:**
+\`\`\`json
+{
+  "age": ["AGE_18_24", "AGE_25_34"],
+  "gender": ["GENDER_FEMALE"],
+  "location_ids": ["JP"],
+  "interest_category_ids": ["123456789"]
+}
+\`\`\``;
+export const GetAudienceEstimateInputSchema = z
+    .object({
+    profileId: z
+        .string()
+        .min(1)
+        .describe("AmazonDsp Advertiser ID"),
+    targetingConfig: z
+        .record(z.any())
+        .describe("Targeting specification object with demographic and interest criteria"),
+})
+    .describe("Parameters for getting a AmazonDsp audience size estimate");
+export const GetAudienceEstimateOutputSchema = z
+    .object({
+    estimate: z.record(z.any()).describe("Audience size estimate data from AmazonDsp"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Audience estimate result");
+export async function getAudienceEstimateLogic(input, context, sdkContext) {
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    const estimate = await amazonDspService.getAudienceEstimate(input.targetingConfig, context);
+    return {
+        estimate: estimate,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getAudienceEstimateResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Audience size estimate:\n${JSON.stringify(result.estimate, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getAudienceEstimateTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetAudienceEstimateInputSchema,
+    outputSchema: GetAudienceEstimateOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Estimate audience for age and gender targeting",
+            input: {
+                profileId: "1234567890",
+                targetingConfig: {
+                    age: ["AGE_18_24", "AGE_25_34"],
+                    gender: ["GENDER_FEMALE"],
+                    location_ids: ["US"],
+                },
+            },
+        },
+        {
+            label: "Estimate audience with interest targeting",
+            input: {
+                profileId: "1234567890",
+                targetingConfig: {
+                    age: ["AGE_25_34"],
+                    location_ids: ["GB"],
+                    interest_category_ids: ["123456789", "987654321"],
+                },
+            },
+        },
+    ],
+    logic: getAudienceEstimateLogic,
+    responseFormatter: getAudienceEstimateResponseFormatter,
+};
+//# sourceMappingURL=get-audience-estimate.tool.js.map

package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-audience-estimate.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-audience-estimate.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,kCAAkC,CAAC;AACrD,MAAM,UAAU,GAAG,kCAAkC,CAAC;AACtD,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;OAalB,CAAC;AAER,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,yBAAyB,CAAC;IACtC,eAAe,EAAE,CAAC;SACf,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;SACf,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC;KACD,QAAQ,CAAC,2DAA2D,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAClF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA+B,EAC/B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,mBAAmB,CACzD,KAAK,CAAC,eAAe,EACrB,OAAO,CACR,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,QAAmC;QAC7C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,MAAiC;IACpF,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAC/G;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,8BAA8B;IAC3C,YAAY,EAAE,+BAA+B;IAC7C,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,gDAAgD;YACvD,KAAK,EAAE;gBACL,SAAS,EAAE,YAAY;gBACvB,eAAe,EAAE;oBACf,GAAG,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;oBAC/B,MAAM,EAAE,CAAC,eAAe,CAAC;oBACzB,YAAY,EAAE,CAAC,IAAI,CAAC;iBACrB;aACF;SACF;QACD;YACE,KAAK,EAAE,2CAA2C;YAClD,KAAK,EAAE;gBACL,SAAS,EAAE,YAAY;gBACvB,eAAe,EAAE;oBACf,GAAG,EAAE,CAAC,WAAW,CAAC;oBAClB,YAAY,EAAE,CAAC,IAAI,CAAC;oBACpB,qBAAqB,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;iBAClD;aACF;SACF;KACF;IACD,KAAK,EAAE,wBAAwB;IAC/B,iBAAiB,EAAE,oCAAoC;CACxD,CAAC"}

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

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    profileId: z.ZodString;
+    entityId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    entityType: string;
+    profileId: string;
+}, {
+    entityId: string;
+    entityType: string;
+    profileId: string;
+}>;
+export declare const GetEntityOutputSchema: z.ZodObject<{
+    entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    entity: Record<string, any>;
+}, {
+    timestamp: string;
+    entity: Record<string, any>;
+}>;
+type GetEntityInput = z.infer<typeof GetEntityInputSchema>;
+type GetEntityOutput = z.infer<typeof GetEntityOutputSchema>;
+export declare function getEntityLogic(input: GetEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetEntityOutput>;
+export declare function getEntityResponseFormatter(result: GetEntityOutput): McpTextContent[];
+export declare const getEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        profileId: z.ZodString;
+        entityId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        entityType: string;
+        profileId: string;
+    }, {
+        entityId: string;
+        entityType: string;
+        profileId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            profileId: string;
+            entityId: string;
+        };
+    }[];
+    logic: typeof getEntityLogic;
+    responseFormatter: typeof getEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-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;AAQnD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAM2B,CAAC;AAE7D,eAAO,MAAM,qBAAqB;;;;;;;;;EAKI,CAAC;AAEvC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCzB,CAAC"}

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

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "amazon_dsp_get_entity";
+const TOOL_TITLE = "Get AmazonDsp Ads Entity";
+const TOOL_DESCRIPTION = `Get a single AmazonDsp Ads entity by ID.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}`;
+export const GetEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to retrieve"),
+    profileId: z.string().min(1).describe("AmazonDsp Advertiser ID"),
+    entityId: z.string().min(1).describe("The entity ID to retrieve"),
+})
+    .describe("Parameters for getting a AmazonDsp Ads entity");
+export const GetEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Retrieved entity data"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity retrieval result");
+export async function getEntityLogic(input, context, sdkContext) {
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    const entity = await amazonDspService.getEntity(input.entityType, input.entityId, context);
+    return {
+        entity: entity,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Entity retrieved\n${JSON.stringify(result.entity, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetEntityInputSchema,
+    outputSchema: GetEntityOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get an order (campaign) by ID",
+            input: {
+                entityType: "campaign",
+                profileId: "1234567890",
+                entityId: "ord_123456789",
+            },
+        },
+        {
+            label: "Get a line item (ad group) by ID",
+            input: {
+                entityType: "adGroup",
+                profileId: "1234567890",
+                entityId: "li_123456789",
+            },
+        },
+    ],
+    logic: getEntityLogic,
+    responseFormatter: getEntityResponseFormatter,
+};
+//# sourceMappingURL=get-entity.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAA4B,MAAM,4BAA4B,CAAC;AAIzF,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAC1C,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,gBAAgB,GAAG;;8BAEK,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAClE,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAKvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAqB,EACrB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAC7C,KAAK,CAAC,UAAiC,EACvC,KAAK,CAAC,QAAQ,EACd,OAAO,CACR,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,MAA4C;QACpD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAuB;IAChE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,qBAAqB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACtG;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,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,+BAA+B;YACtC,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,SAAS,EAAE,YAAY;gBACvB,QAAQ,EAAE,eAAe;aAC1B;SACF;QACD;YACE,KAAK,EAAE,kCAAkC;YACzC,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,YAAY;gBACvB,QAAQ,EAAE,cAAc;aACzB;SACF;KACF;IACD,KAAK,EAAE,cAAc;IACrB,iBAAiB,EAAE,0BAA0B;CAC9C,CAAC"}