@cesteral/amazon-dsp-mcp 1.0.0

package/dist/mcp-server/tools/definitions/search-targeting.tool.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "amazon_dsp_search_targeting";
+const TOOL_TITLE = "Amazon DSP Search Audience Segments";
+const TOOL_DESCRIPTION = `Search Amazon DSP audience segments by name.
+
+Returns available audience segments from the Amazon DSP Advertising API
+(\`GET /dsp/audienceSegments\`). Use the segment IDs in line item targeting configurations.
+
+**Examples of segment types available:**
+- First-party audiences (advertiser remarketing lists)
+- Amazon-owned audiences (in-market, lifestyle segments)
+- Third-party data provider segments`;
+export const SearchTargetingInputSchema = z
+    .object({
+    profileId: z
+        .string()
+        .min(1)
+        .describe("Amazon DSP Advertiser ID"),
+    query: z
+        .string()
+        .optional()
+        .describe("Search keyword to filter segments by name (optional — returns top segments if omitted)"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(20)
+        .describe("Maximum number of results (default 20)"),
+})
+    .describe("Parameters for searching Amazon DSP audience segments");
+export const SearchTargetingOutputSchema = z
+    .object({
+    results: z.array(z.record(z.any())).describe("Audience segments matching the query"),
+    count: z.number().describe("Number of results returned"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Audience segment search result");
+export async function searchTargetingLogic(input, context, sdkContext) {
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    const results = (await amazonDspService.searchAudienceSegments(input.query, input.limit, context));
+    const list = Array.isArray(results)
+        ? results
+        : (results.audienceSegments ?? []);
+    return {
+        results: list,
+        count: list.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function searchTargetingResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Found ${result.count} audience segments\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const searchTargetingTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: SearchTargetingInputSchema,
+    outputSchema: SearchTargetingOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Search for gaming audience segments",
+            input: {
+                profileId: "1234567890",
+                query: "gaming",
+                limit: 20,
+            },
+        },
+        {
+            label: "Browse all available audience segments",
+            input: {
+                profileId: "1234567890",
+                limit: 30,
+            },
+        },
+    ],
+    logic: searchTargetingLogic,
+    responseFormatter: searchTargetingResponseFormatter,
+};
+//# sourceMappingURL=search-targeting.tool.js.map

package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map

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

package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
+    datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<["CAMPAIGN", "INVENTORY", "AUDIENCE", "PRODUCTS", "TECHNOLOGY", "GEOGRAPHY", "CONVERSION_SOURCE"]>;
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    timeUnit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["DAILY", "SUMMARY"]>>>;
+}, "strip", z.ZodTypeAny, {
+    type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+    timeUnit: "DAILY" | "SUMMARY";
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    dimensions?: string[] | undefined;
+    metrics?: string[] | undefined;
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+}, {
+    type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    timeUnit?: "DAILY" | "SUMMARY" | undefined;
+    dimensions?: string[] | undefined;
+    metrics?: string[] | undefined;
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+}>, {
+    type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+    timeUnit: "DAILY" | "SUMMARY";
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    dimensions?: string[] | undefined;
+    metrics?: string[] | undefined;
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+}, {
+    type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    timeUnit?: "DAILY" | "SUMMARY" | undefined;
+    dimensions?: string[] | undefined;
+    metrics?: string[] | undefined;
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+}>;
+export declare const SubmitReportOutputSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    timestamp: string;
+}, {
+    taskId: string;
+    timestamp: string;
+}>;
+type SubmitReportInput = z.infer<typeof SubmitReportInputSchema>;
+type SubmitReportOutput = z.infer<typeof SubmitReportOutputSchema>;
+export declare function submitReportLogic(input: SubmitReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<SubmitReportOutput>;
+export declare function submitReportResponseFormatter(result: SubmitReportOutput): McpTextContent[];
+export declare const submitReportTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<["CAMPAIGN", "INVENTORY", "AUDIENCE", "PRODUCTS", "TECHNOLOGY", "GEOGRAPHY", "CONVERSION_SOURCE"]>;
+        dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        timeUnit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["DAILY", "SUMMARY"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+        timeUnit: "DAILY" | "SUMMARY";
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        dimensions?: string[] | undefined;
+        metrics?: string[] | undefined;
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    }, {
+        type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        timeUnit?: "DAILY" | "SUMMARY" | undefined;
+        dimensions?: string[] | undefined;
+        metrics?: string[] | undefined;
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    }>, {
+        type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+        timeUnit: "DAILY" | "SUMMARY";
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        dimensions?: string[] | undefined;
+        metrics?: string[] | undefined;
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    }, {
+        type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        timeUnit?: "DAILY" | "SUMMARY" | undefined;
+        dimensions?: string[] | undefined;
+        metrics?: string[] | undefined;
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        taskId: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        taskId: string;
+        timestamp: string;
+    }, {
+        taskId: string;
+        timestamp: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            datePreset: string;
+            type: string;
+            dimensions: string[];
+            metrics: string[];
+            timeUnit: string;
+        };
+    }[];
+    logic: typeof submitReportLogic;
+    responseFormatter: typeof submitReportResponseFormatter;
+};
+export {};
+//# sourceMappingURL=submit-report.tool.d.ts.map

package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.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;AAmBnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;EAKE,CAAC;AAExC,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,CA2B7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B5B,CAAC"}

package/dist/mcp-server/tools/definitions/submit-report.tool.js

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { resolveDatePreset, DATE_PRESET_VALUES } from "@cesteral/shared";
+import { AMAZON_DSP_REPORTING_CONTRACT } from "../../../services/amazon-dsp/amazon-dsp-api-contract.js";
+const TOOL_NAME = "amazon_dsp_submit_report";
+const TOOL_TITLE = "Submit Amazon DSP Report";
+const TOOL_DESCRIPTION = `Submit an Amazon DSP report (legacy /dsp/reports API) without waiting for completion.
+
+Returns a \`taskId\` immediately. Use \`amazon_dsp_check_report_status\` to poll for completion (\`SUCCESS\` or \`FAILURE\`), then \`amazon_dsp_download_report\` to fetch results.
+
+**Non-blocking workflow:**
+1. \`amazon_dsp_submit_report\` → get \`taskId\`
+2. \`amazon_dsp_check_report_status\` (repeat every 10s) → wait for \`SUCCESS\`
+3. \`amazon_dsp_download_report\` with the \`downloadUrl\` → parsed data
+
+Use \`amazon_dsp_get_report\` instead for a blocking convenience shortcut.
+
+**Report shape:** each \`type\` (CAMPAIGN, INVENTORY, AUDIENCE, PRODUCTS, TECHNOLOGY, GEOGRAPHY, CONVERSION_SOURCE) is a fixed report category. CAMPAIGN supports breaking down by \`ORDER | LINE_ITEM | CREATIVE\` via \`dimensions\`. \`metrics\` is the list of metric names (impressions, totalCost, viewableImpressions, viewabilityRate, …) — sent to Amazon as a comma-separated string.
+
+Note: Amazon DSP has a maximum 95-day lookback. LAST_90_DAYS is the longest supported preset.`;
+export const SubmitReportInputSchema = z
+    .object({
+    datePreset: z
+        .enum(DATE_PRESET_VALUES)
+        .optional()
+        .describe("Preset date range. Use this OR startDate+endDate (not both). Max 95-day lookback — LAST_90_DAYS is the longest supported preset"),
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional()
+        .describe("Start date (YYYY-MM-DD format, e.g. 2026-05-01). Max 95-day lookback. Required if datePreset not provided. Converted to YYYYMMDD for the upstream API."),
+    endDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional()
+        .describe("End date (YYYY-MM-DD format). Required if datePreset not provided. Converted to YYYYMMDD for the upstream API."),
+    type: z
+        .enum(AMAZON_DSP_REPORTING_CONTRACT.reportTypes)
+        .describe(`Report category. One of: ${AMAZON_DSP_REPORTING_CONTRACT.reportTypes.join(", ")}.`),
+    dimensions: z
+        .array(z.string())
+        .optional()
+        .describe("Optional grouping dimensions (type-specific). CAMPAIGN supports ORDER, LINE_ITEM, CREATIVE."),
+    metrics: z
+        .array(z.string())
+        .optional()
+        .describe("Metric names to include (e.g. ['impressions', 'totalCost']). Joined to a comma-separated string upstream. Amazon will 422 with the authoritative invalid-list if any name is unknown."),
+    timeUnit: z
+        .enum(["DAILY", "SUMMARY"])
+        .optional()
+        .default("DAILY")
+        .describe("Time unit for the report (default: DAILY)"),
+})
+    .refine((data) => data.datePreset !== undefined || (data.startDate !== undefined && data.endDate !== undefined), { message: "Provide either datePreset or both startDate and endDate" })
+    .describe("Parameters for submitting an Amazon DSP report");
+export const SubmitReportOutputSchema = z
+    .object({
+    taskId: z.string().describe("Report task ID for status polling"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Report submission result");
+export async function submitReportLogic(input, context, sdkContext) {
+    const { amazonDspReportingService } = resolveSessionServices(sdkContext);
+    let resolvedStartDate = input.startDate;
+    let resolvedEndDate = input.endDate;
+    if (input.datePreset) {
+        const resolved = resolveDatePreset(input.datePreset);
+        resolvedStartDate = resolved.startDate;
+        resolvedEndDate = resolved.endDate;
+    }
+    const result = await amazonDspReportingService.submitReport({
+        startDate: resolvedStartDate,
+        endDate: resolvedEndDate,
+        type: input.type,
+        dimensions: input.dimensions,
+        metrics: input.metrics,
+        timeUnit: input.timeUnit,
+    }, context);
+    return {
+        taskId: result.taskId,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function submitReportResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Report submitted: ${result.taskId}\n\nUse \`amazon_dsp_check_report_status\` with this taskId to poll for completion.\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const submitReportTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: SubmitReportInputSchema,
+    outputSchema: SubmitReportOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Daily order-level CAMPAIGN report, last 7 days",
+            input: {
+                datePreset: "LAST_7_DAYS",
+                type: "CAMPAIGN",
+                dimensions: ["ORDER"],
+                metrics: ["impressions", "totalCost"],
+                timeUnit: "DAILY",
+            },
+        },
+    ],
+    logic: submitReportLogic,
+    responseFormatter: submitReportResponseFormatter,
+};
+//# sourceMappingURL=submit-report.tool.js.map

package/dist/mcp-server/tools/definitions/submit-report.tool.js.map

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

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

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const UpdateEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    profileId: z.ZodString;
+    entityId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    entityType: string;
+    profileId: string;
+    data: Record<string, any>;
+}, {
+    entityId: string;
+    entityType: string;
+    profileId: string;
+    data: Record<string, any>;
+}>;
+export declare const UpdateEntityOutputSchema: z.ZodObject<{
+    entityId: z.ZodString;
+    entityType: z.ZodString;
+    updated: z.ZodBoolean;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    entityType: string;
+    timestamp: string;
+    updated: boolean;
+}, {
+    entityId: string;
+    entityType: string;
+    timestamp: string;
+    updated: boolean;
+}>;
+type UpdateEntityInput = z.infer<typeof UpdateEntityInputSchema>;
+type UpdateEntityOutput = z.infer<typeof UpdateEntityOutputSchema>;
+export declare function updateEntityLogic(input: UpdateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateEntityOutput>;
+export declare function updateEntityResponseFormatter(result: UpdateEntityOutput): McpTextContent[];
+export declare const updateEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        profileId: z.ZodString;
+        entityId: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        entityType: string;
+        profileId: string;
+        data: Record<string, any>;
+    }, {
+        entityId: string;
+        entityType: string;
+        profileId: string;
+        data: Record<string, any>;
+    }>;
+    outputSchema: z.ZodObject<{
+        entityId: z.ZodString;
+        entityType: z.ZodString;
+        updated: z.ZodBoolean;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        entityType: string;
+        timestamp: string;
+        updated: boolean;
+    }, {
+        entityId: string;
+        entityType: string;
+        timestamp: string;
+        updated: boolean;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            profileId: string;
+            entityId: string;
+            data: {
+                name: string;
+                budget: number;
+                bidding?: undefined;
+            };
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            profileId: string;
+            entityId: string;
+            data: {
+                bidding: {
+                    bidOptimization: string;
+                    bidAmount: number;
+                };
+                name?: undefined;
+                budget?: undefined;
+            };
+        };
+    })[];
+    logic: typeof updateEntityLogic;
+    responseFormatter: typeof updateEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=update-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-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;AAcnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAOyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAOF,CAAC;AAEpC,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,CAgB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC5B,CAAC"}

package/dist/mcp-server/tools/definitions/update-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 = "amazon_dsp_update_entity";
+const TOOL_TITLE = "Update AmazonDsp Ads Entity";
+const TOOL_DESCRIPTION = `Update a AmazonDsp Ads entity.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+AmazonDsp uses PUT to the entity-specific resource. Only provided fields are modified.
+
+**Gotchas:**
+- Use \`amazon_dsp_bulk_update_status\` for status-only changes (more efficient)
+- profile_id is automatically injected`;
+export const UpdateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to update"),
+    profileId: z.string().min(1).describe("AmazonDsp Advertiser ID"),
+    entityId: z.string().min(1).describe("The entity ID to update"),
+    data: z.record(z.any()).describe("Fields to update as key-value pairs"),
+})
+    .describe("Parameters for updating a AmazonDsp Ads entity");
+export const UpdateEntityOutputSchema = z
+    .object({
+    entityId: z.string(),
+    entityType: z.string(),
+    updated: z.boolean(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity update result");
+export async function updateEntityLogic(input, context, sdkContext) {
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    await amazonDspService.updateEntity(input.entityType, input.entityId, input.data, context);
+    return {
+        entityId: input.entityId,
+        entityType: input.entityType,
+        updated: true,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function updateEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} ${result.entityId} updated successfully\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const updateEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: UpdateEntityInputSchema,
+    outputSchema: UpdateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Update order (campaign) name and budget",
+            input: {
+                entityType: "campaign",
+                profileId: "1234567890",
+                entityId: "ord_123456789",
+                data: {
+                    name: "Updated Order Name",
+                    budget: 20000,
+                },
+            },
+        },
+        {
+            label: "Update line item bid",
+            input: {
+                entityType: "adGroup",
+                profileId: "1234567890",
+                entityId: "li_123456789",
+                data: {
+                    bidding: { bidOptimization: "MANUAL", bidAmount: 2.0 },
+                },
+            },
+        },
+    ],
+    logic: updateEntityLogic,
+    responseFormatter: updateEntityResponseFormatter,
+};
+//# sourceMappingURL=update-entity.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-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,0BAA0B,CAAC;AAC7C,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;8BAEK,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;uCAMrB,CAAC;AAExC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5E,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,yBAAyB,CAAC;IAC/D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACxE,CAAC;KACD,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAKpC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,gBAAgB,CAAC,YAAY,CACjC,KAAK,CAAC,UAAiC,EACvC,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,IAAI,EACV,OAAO,CACR,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,IAAI;QACb,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,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,uCAAuC,MAAM,CAAC,SAAS,EAAE;SACvG;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,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,yCAAyC;YAChD,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,SAAS,EAAE,YAAY;gBACvB,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE;oBACJ,IAAI,EAAE,oBAAoB;oBAC1B,MAAM,EAAE,KAAK;iBACd;aACF;SACF;QACD;YACE,KAAK,EAAE,sBAAsB;YAC7B,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,YAAY;gBACvB,QAAQ,EAAE,cAAc;gBACxB,IAAI,EAAE;oBACJ,OAAO,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;iBACvD;aACF;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}