@cesteral/amazon-dsp-mcp 1.0.0

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

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import type { AmazonDspPublicEntityType } from "../../../services/amazon-dsp/amazon-dsp-api-contract.js";
+export declare const validateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[AmazonDspPublicEntityType, ...AmazonDspPublicEntityType[]]>;
+        mode: z.ZodEnum<["create", "update"]>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: AmazonDspPublicEntityType;
+        data: Record<string, unknown>;
+        mode: "create" | "update";
+    }, {
+        entityType: AmazonDspPublicEntityType;
+        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: AmazonDspPublicEntityType;
+        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<[AmazonDspPublicEntityType, ...AmazonDspPublicEntityType[]]>;
+    mode: z.ZodEnum<["create", "update"]>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    entityType: AmazonDspPublicEntityType;
+    data: Record<string, unknown>;
+    mode: "create" | "update";
+}, {
+    entityType: AmazonDspPublicEntityType;
+    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: AmazonDspPublicEntityType;
+    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":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yDAAyD,CAAC;AAGzG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAyGoT,CAAC;2BAAiD,CAAC;oBAA4C,CAAC;;;;;gBAA4M,CAAC;2BAAiD,CAAC;oBAA4C,CAAC;;;;;;;;;gBAAsV,CAAC;2BAAiD,CAAC;oBAA4C,CAAC;;;;;;kBAAuK,CAAC;;;;;;gBAA6M,CAAC;2BAAiD,CAAC;oBAA4C,CAAC;;;;;;kBAAuK,CAAC;;;;;;;;;;;;;;;;;;CALhxD,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAAiC,CAAC;AACxE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;YAE4S,CAAC;uBAAiD,CAAC;gBAA4C,CAAC;;;;;YAA4M,CAAC;uBAAiD,CAAC;gBAA4C,CAAC;;;;;;;;;YAAsV,CAAC;uBAAiD,CAAC;gBAA4C,CAAC;;;;;;;;;;;;YAAqX,CAAC;uBAAiD,CAAC;gBAA4C,CAAC;;;;;;;EAFjiD,CAAC;AAC1E,eAAO,MAAM,mBAAmB;;;;wKAA2B,CAAC"}

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

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { getEntityContract, getEntityTypeEnum, getCanonicalEntityType, } from "../utils/entity-mapping.js";
+import { createValidateEntityTool } from "@cesteral/shared";
+export const validateEntityTool = createValidateEntityTool({
+    toolName: "amazon_dsp_validate_entity",
+    toolTitle: "AmazonDsp Ads Entity Validation (Client-Side)",
+    toolDescription: `Validate an entity payload against known AmazonDsp Ads requirements without calling the API.
+
+Checks required fields, data types, and common configuration mistakes.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+This is a pure client-side check — it catches missing required fields and
+obvious type errors. The AmazonDsp API may still reject payloads for business-rule
+reasons (e.g., invalid objective/placement combinations).`,
+    entityTypeEnum: getEntityTypeEnum(),
+    getRules: (entityType) => getEntityContract(entityType).requiredOnCreate,
+    getReadOnlyFields: (entityType) => getEntityContract(entityType).readOnlyFields,
+    extraInputSchema: {
+        profileId: z.string().optional().describe("Advertiser ID (recommended for create mode)"),
+    },
+    extraValidate: ({ entityType, mode, data, issues }) => {
+        const canonical = getCanonicalEntityType(entityType);
+        if (mode === "create" && canonical === "creative" && !data.clickThroughUrl) {
+            issues.push({
+                field: "clickThroughUrl",
+                code: "missing",
+                message: 'Creative should include "clickThroughUrl" for click tracking',
+                severity: "warning",
+            });
+        }
+        const budgetValue = data.budget;
+        if (budgetValue !== undefined) {
+            if (typeof budgetValue === "number") {
+                if (canonical === "lineItem") {
+                    issues.push({
+                        field: "budget",
+                        code: "wrongType",
+                        message: 'Field "budget" for lineItem must be an object: { budgetType: "DAILY" | "LIFETIME", budget: number }',
+                        suggestedValues: ["DAILY", "LIFETIME"],
+                        severity: "error",
+                    });
+                }
+                else if (budgetValue <= 0) {
+                    issues.push({
+                        field: "budget",
+                        code: "invalidValue",
+                        message: 'Field "budget" must be a positive number',
+                        severity: "error",
+                    });
+                }
+            }
+            else if (typeof budgetValue === "object" && budgetValue !== null) {
+                const budgetObj = budgetValue;
+                if (typeof budgetObj.budget !== "number" || budgetObj.budget <= 0) {
+                    issues.push({
+                        field: "budget.budget",
+                        code: "invalidValue",
+                        message: 'Field "budget.budget" must be a positive number',
+                        severity: "error",
+                    });
+                }
+                if (!budgetObj.budgetType) {
+                    issues.push({
+                        field: "budget.budgetType",
+                        code: "missing",
+                        message: 'Field "budget.budgetType" is required ("DAILY" or "LIFETIME")',
+                        suggestedValues: ["DAILY", "LIFETIME"],
+                        severity: "error",
+                    });
+                }
+            }
+        }
+    },
+    inputExamples: [
+        {
+            label: "Valid order create",
+            input: {
+                entityType: "campaign",
+                mode: "create",
+                profileId: "1234567890",
+                data: {
+                    name: "Summer Sale 2026",
+                    advertiserId: "adv_123",
+                    startDateTime: "2026-07-01T00:00:00Z",
+                    endDateTime: "2026-07-31T23:59:59Z",
+                },
+            },
+        },
+        {
+            label: "Missing required fields (line item)",
+            input: {
+                entityType: "lineItem",
+                mode: "create",
+                profileId: "1234567890",
+                data: { name: "Test Line Item" },
+            },
+        },
+    ],
+});
+export const ValidateEntityInputSchema = validateEntityTool.inputSchema;
+export const ValidateEntityOutputSchema = validateEntityTool.outputSchema;
+export const validateEntityLogic = validateEntityTool.logic;
+//# sourceMappingURL=validate-entity.tool.js.map

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

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

package/dist/mcp-server/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { allTools } from "./definitions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/tools/index.js

@@ -0,0 +1,2 @@
+export { allTools } from "./definitions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/tools/utils/entity-mapping.d.ts

@@ -0,0 +1,24 @@
+import { type AmazonDspCanonicalEntityType, type AmazonDspPublicEntityType } from "../../../services/amazon-dsp/amazon-dsp-api-contract.js";
+export type AmazonDspEntityType = AmazonDspPublicEntityType;
+export type CanonicalAmazonDspEntityType = AmazonDspCanonicalEntityType;
+export interface AmazonDspEntityConfig {
+    listPath: string;
+    getPath: string;
+    createPath: string;
+    updatePath: string;
+    createMediaType?: string;
+    updateMediaType?: string;
+    idField: string;
+    responseKey: string;
+    listFilterParam: string;
+    displayName: string;
+    defaultFields: string[];
+}
+export declare function getEntityConfig(entityType: AmazonDspEntityType): AmazonDspEntityConfig;
+export declare function getSupportedEntityTypes(): AmazonDspEntityType[];
+export declare function getCanonicalEntityTypes(): AmazonDspCanonicalEntityType[];
+export declare function getEntityTypeEnum(): [string, ...string[]];
+export declare function getCanonicalEntityType(entityType: AmazonDspEntityType): AmazonDspCanonicalEntityType;
+export declare function getEntityContract(entityType: AmazonDspEntityType): import("../../../services/amazon-dsp/amazon-dsp-api-contract.js").AmazonDspEntityContract;
+export declare function interpolatePath(path: string, params: Record<string, string>): string;
+//# sourceMappingURL=entity-mapping.d.ts.map

package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC/B,MAAM,yDAAyD,CAAC;AASjE,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,MAAM,4BAA4B,GAAG,4BAA4B,CAAC;AAExE,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IAEnB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IAEpB,eAAe,EAAE,MAAM,CAAC;IAExB,WAAW,EAAE,MAAM,CAAC;IAEpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAyBD,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,qBAAqB,CAEtF;AAED,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D;AAED,wBAAgB,uBAAuB,IAAI,4BAA4B,EAAE,CAExE;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAEzD;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,mBAAmB,GAC9B,4BAA4B,CAE9B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,mBAAmB,6FAEhE;AAKD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEpF"}

package/dist/mcp-server/tools/utils/entity-mapping.js

@@ -0,0 +1,42 @@
+import { AMAZON_DSP_CANONICAL_ENTITY_TYPES, AMAZON_DSP_ENTITY_CONTRACT, AMAZON_DSP_PUBLIC_ENTITY_TYPES, getAmazonDspEntityContract, normalizeAmazonDspEntityType, } from "../../../services/amazon-dsp/amazon-dsp-api-contract.js";
+const ENTITY_CONFIGS = Object.fromEntries(AMAZON_DSP_CANONICAL_ENTITY_TYPES.map((entityType) => {
+    const contract = AMAZON_DSP_ENTITY_CONTRACT[entityType];
+    return [
+        entityType,
+        {
+            listPath: contract.listPath,
+            getPath: contract.getPath,
+            createPath: contract.createPath,
+            updatePath: contract.updatePath,
+            createMediaType: contract.createMediaType,
+            updateMediaType: contract.updateMediaType,
+            idField: contract.idField,
+            responseKey: contract.responseKey,
+            listFilterParam: contract.listFilterParam,
+            displayName: contract.displayName,
+            defaultFields: [contract.idField, contract.listFilterParam, "name", "state"],
+        },
+    ];
+}));
+export function getEntityConfig(entityType) {
+    return ENTITY_CONFIGS[normalizeAmazonDspEntityType(entityType)];
+}
+export function getSupportedEntityTypes() {
+    return [...AMAZON_DSP_PUBLIC_ENTITY_TYPES];
+}
+export function getCanonicalEntityTypes() {
+    return [...AMAZON_DSP_CANONICAL_ENTITY_TYPES];
+}
+export function getEntityTypeEnum() {
+    return getSupportedEntityTypes();
+}
+export function getCanonicalEntityType(entityType) {
+    return normalizeAmazonDspEntityType(entityType);
+}
+export function getEntityContract(entityType) {
+    return getAmazonDspEntityContract(entityType);
+}
+export function interpolatePath(path, params) {
+    return Object.entries(params).reduce((acc, [key, val]) => acc.replace(`{${key}}`, val), path);
+}
+//# sourceMappingURL=entity-mapping.js.map

package/dist/mcp-server/tools/utils/entity-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iCAAiC,EACjC,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,GAG7B,MAAM,yDAAyD,CAAC;AAqCjE,MAAM,cAAc,GAClB,MAAM,CAAC,WAAW,CAChB,iCAAiC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;IACnD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACxD,OAAO;QACL,UAAU;QACV;YACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,aAAa,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC;SAC7C;KAClC,CAAC;AACJ,CAAC,CAAC,CAC4D,CAAC;AAEnE,MAAM,UAAU,eAAe,CAAC,UAA+B;IAC7D,OAAO,cAAc,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,8BAA8B,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,iCAAiC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,uBAAuB,EAA2B,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA+B;IAE/B,OAAO,4BAA4B,CAAC,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAA+B;IAC/D,OAAO,0BAA0B,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAA8B;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAChG,CAAC"}

package/dist/mcp-server/tools/utils/resolve-session.d.ts

@@ -0,0 +1,4 @@
+import { type SessionServices } from "../../../services/session-services.js";
+import type { SdkContext } from "@cesteral/shared";
+export declare function resolveSessionServices(sdkContext?: SdkContext): SessionServices;
+//# sourceMappingURL=resolve-session.d.ts.map

package/dist/mcp-server/tools/utils/resolve-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,eAAe,CAE/E"}

package/dist/mcp-server/tools/utils/resolve-session.js

@@ -0,0 +1,6 @@
+import { resolveSessionServicesFromStore } from "@cesteral/shared";
+import { sessionServiceStore } from "../../../services/session-services.js";
+export function resolveSessionServices(sdkContext) {
+    return resolveSessionServicesFromStore(sessionServiceStore, sdkContext);
+}
+//# sourceMappingURL=resolve-session.js.map

package/dist/mcp-server/tools/utils/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAOlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.d.ts

@@ -0,0 +1,57 @@
+import type { Logger } from "pino";
+export declare const createMcpHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "amazon-dsp-bearer" | "jwt" | "none";
+    amazonDspApiBaseUrl: string;
+    amazonDspApiVersion: string;
+    amazonDspRateLimitPerMinute: number;
+    amazonDspReportPollIntervalMs: number;
+    amazonDspReportMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    amazonDspAccessToken?: string | undefined;
+    amazonDspProfileId?: string | undefined;
+    amazonDspClientId?: string | undefined;
+    amazonDspAppId?: string | undefined;
+    amazonDspAppSecret?: string | undefined;
+    amazonDspRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "amazon-dsp-bearer" | "jwt" | "none";
+    amazonDspApiBaseUrl: string;
+    amazonDspApiVersion: string;
+    amazonDspRateLimitPerMinute: number;
+    amazonDspReportPollIntervalMs: number;
+    amazonDspReportMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    amazonDspAccessToken?: string | undefined;
+    amazonDspProfileId?: string | undefined;
+    amazonDspClientId?: string | undefined;
+    amazonDspAppId?: string | undefined;
+    amazonDspAppSecret?: string | undefined;
+    amazonDspRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
+//# sourceMappingURL=streamable-http-transport.d.ts.map

package/dist/mcp-server/transports/streamable-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA2JnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.js

@@ -0,0 +1,105 @@
+import { createMcpServer } from "../server.js";
+import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
+import { AmazonDspBearerAuthStrategy } from "../../auth/amazon-dsp-auth-strategy.js";
+import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
+import { rateLimiter } from "../../utils/platform.js";
+function buildPlatformConfig(config, logger) {
+    return {
+        authStrategy: config.mcpAuthMode === "amazon-dsp-bearer"
+            ? new AmazonDspBearerAuthStrategy(config.amazonDspApiBaseUrl, logger)
+            : createAuthStrategy(config.mcpAuthMode, {
+                jwtSecret: config.mcpAuthSecretKey,
+                logger,
+            }),
+        corsAllowHeaders: [
+            "Content-Type",
+            "Authorization",
+            "Mcp-Session-Id",
+            "MCP-Protocol-Version",
+            "Amazon-Advertising-API-Scope",
+            "Amazon-Advertising-API-ClientId",
+            "X-AmazonDsp-App-Id",
+            "X-AmazonDsp-App-Secret",
+            "X-AmazonDsp-Refresh-Token",
+        ],
+        authErrorHint: config.mcpAuthMode === "amazon-dsp-bearer"
+            ? "Provide an Amazon access token via Authorization: Bearer <token>, profile ID via Amazon-Advertising-API-Scope, and client ID via Amazon-Advertising-API-ClientId."
+            : "Provide a valid Bearer token in the Authorization header.",
+        sessionServiceStore,
+        rateLimiter,
+        async createSessionForAuth(authResult, sessionId, appConfig, log) {
+            const adapter = authResult.platformAuthAdapter;
+            if (adapter) {
+                const cfg = appConfig;
+                const services = createSessionServices(adapter, {
+                    baseUrl: cfg.amazonDspApiBaseUrl,
+                    reportPollIntervalMs: cfg.amazonDspReportPollIntervalMs,
+                    reportMaxPollAttempts: cfg.amazonDspReportMaxPollAttempts,
+                }, log, rateLimiter);
+                sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                return { services };
+            }
+            if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
+                const cfg = appConfig;
+                const amazonDspProfileId = cfg.amazonDspProfileId;
+                if (cfg.amazonDspAppId &&
+                    cfg.amazonDspAppSecret &&
+                    cfg.amazonDspRefreshToken &&
+                    amazonDspProfileId) {
+                    const { AmazonDspRefreshTokenAdapter } = await import("../../auth/amazon-dsp-auth-adapter.js");
+                    const envAdapter = new AmazonDspRefreshTokenAdapter({
+                        appId: cfg.amazonDspAppId,
+                        appSecret: cfg.amazonDspAppSecret,
+                        refreshToken: cfg.amazonDspRefreshToken,
+                    }, amazonDspProfileId, cfg.amazonDspApiBaseUrl);
+                    await envAdapter.validate();
+                    const services = createSessionServices(envAdapter, {
+                        baseUrl: cfg.amazonDspApiBaseUrl,
+                        reportPollIntervalMs: cfg.amazonDspReportPollIntervalMs,
+                        reportMaxPollAttempts: cfg.amazonDspReportMaxPollAttempts,
+                    }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                const amazonDspToken = cfg.amazonDspAccessToken;
+                if (amazonDspToken && amazonDspProfileId) {
+                    const { AmazonDspAccessTokenAdapter } = await import("../../auth/amazon-dsp-auth-adapter.js");
+                    const envAdapter = new AmazonDspAccessTokenAdapter(amazonDspToken, amazonDspProfileId, cfg.amazonDspApiBaseUrl);
+                    await envAdapter.validate();
+                    const cfgFallback = appConfig;
+                    const services = createSessionServices(envAdapter, {
+                        baseUrl: cfgFallback.amazonDspApiBaseUrl,
+                        reportPollIntervalMs: cfgFallback.amazonDspReportPollIntervalMs,
+                        reportMaxPollAttempts: cfgFallback.amazonDspReportMaxPollAttempts,
+                    }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                if (appConfig.mcpAuthMode !== "none") {
+                    return {
+                        services: null,
+                        error: {
+                            message: "Amazon DSP access token and profile ID required. Set AMAZON_DSP_ACCESS_TOKEN and AMAZON_DSP_PROFILE_ID env vars, or use MCP_AUTH_MODE=amazon-dsp-bearer.",
+                            status: 400,
+                        },
+                    };
+                }
+                return { services: null };
+            }
+            return {
+                services: null,
+                error: {
+                    message: "AmazonDsp API credentials required for this server.",
+                    status: 400,
+                },
+            };
+        },
+        async createMcpServer(log, sessionId, gcsBucket) {
+            return createMcpServer(log, sessionId, gcsBucket);
+        },
+        packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
+        serverCard: buildServerCardExtras("amazon-dsp-mcp"),
+    };
+}
+export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
+//# sourceMappingURL=streamable-http-transport.js.map

package/dist/mcp-server/transports/streamable-http-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"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"}

package/dist/services/amazon-dsp/amazon-dsp-api-contract.d.ts

@@ -0,0 +1,43 @@
+export type AmazonDspCanonicalEntityType = "order" | "lineItem" | "creative" | "target" | "creativeAssociation";
+export type AmazonDspPublicEntityType = AmazonDspCanonicalEntityType | "campaign" | "adGroup";
+export interface AmazonDspContractFieldRule {
+    field: string;
+    expectedType: "string" | "number" | "object";
+    hint?: string;
+}
+export interface AmazonDspEntityContract {
+    canonicalType: AmazonDspCanonicalEntityType;
+    aliases: string[];
+    listPath: string;
+    getPath: string;
+    createPath: string;
+    updatePath: string;
+    createMediaType?: string;
+    updateMediaType?: string;
+    idField: string;
+    responseKey: string;
+    listFilterParam: string;
+    displayName: string;
+    requiredOnCreate: AmazonDspContractFieldRule[];
+    readOnlyFields: string[];
+    notes: string[];
+}
+export declare const AMAZON_DSP_ENTITY_ALIASES: Record<string, AmazonDspCanonicalEntityType>;
+export declare const AMAZON_DSP_ENTITY_CONTRACT: Record<AmazonDspCanonicalEntityType, AmazonDspEntityContract>;
+export declare const AMAZON_DSP_CANONICAL_ENTITY_TYPES: AmazonDspCanonicalEntityType[];
+export declare const AMAZON_DSP_PUBLIC_ENTITY_TYPES: readonly [...AmazonDspCanonicalEntityType[], "campaign", "adGroup"];
+export declare const AMAZON_DSP_REPORTING_CONTRACT: {
+    readonly submitPathTemplate: "/dsp/reports";
+    readonly statusPathTemplate: "/dsp/reports/{reportId}";
+    readonly statuses: readonly ["IN_PROGRESS", "SUCCESS", "FAILURE"];
+    readonly defaultTimeUnit: "DAILY";
+    readonly reportTypes: readonly ["CAMPAIGN", "INVENTORY", "AUDIENCE", "PRODUCTS", "TECHNOLOGY", "GEOGRAPHY", "CONVERSION_SOURCE"];
+    readonly dimensionsByType: {
+        readonly CAMPAIGN: readonly ["ORDER", "LINE_ITEM", "CREATIVE"];
+    };
+    readonly knownMetrics: readonly ["impressions", "totalCost", "viewableImpressions", "viewabilityRate"];
+    readonly notes: readonly ["POST /dsp/reports body shape: { startDate (YYYYMMDD), endDate (YYYYMMDD), type (one of reportTypes), dimensions?: string[], metrics?: string (comma-separated), timeUnit?: 'DAILY' }.", "Returns 202 with { reportId, type, format, status:'IN_PROGRESS', location:'', expiration } — poll GET /dsp/reports/{reportId} until status === 'SUCCESS' (returns presigned S3 download `location`) or 'FAILURE'.", "Plain application/json Content-Type works — no vendor media type required (unlike entity writes).", "Endpoint is NOT account-scoped — `accountId` is not part of the URL path. The Amazon-Advertising-API-Scope header still identifies the profile."];
+};
+export declare function normalizeAmazonDspEntityType(entityType: AmazonDspPublicEntityType | string): AmazonDspCanonicalEntityType;
+export declare function getAmazonDspEntityContract(entityType: AmazonDspPublicEntityType | string): AmazonDspEntityContract;
+//# sourceMappingURL=amazon-dsp-api-contract.d.ts.map

package/dist/services/amazon-dsp/amazon-dsp-api-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amazon-dsp-api-contract.d.ts","sourceRoot":"","sources":["../../../src/services/amazon-dsp/amazon-dsp-api-contract.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,4BAA4B,GACpC,OAAO,GACP,UAAU,GACV,UAAU,GACV,QAAQ,GACR,qBAAqB,CAAC;AAE1B,MAAM,MAAM,yBAAyB,GAAG,4BAA4B,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,4BAA4B,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IASnB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAGlF,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,4BAA4B,EAC5B,uBAAuB,CA+IxB,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAEzC,4BAA4B,EAAE,CAAC;AAEpC,eAAO,MAAM,8BAA8B,qEAIc,CAAC;AAiB1D,eAAO,MAAM,6BAA6B;;;;;;;;;;;CAgChC,CAAC;AAEX,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,yBAAyB,GAAG,MAAM,GAC7C,4BAA4B,CAc9B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,yBAAyB,GAAG,MAAM,GAC7C,uBAAuB,CAEzB"}