@cesteral/amazon-dsp-mcp 1.0.0

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

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { elicitBulkDeleteConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "amazon_dsp_delete_entity";
+const TOOL_TITLE = "Delete AmazonDsp Ads Entity";
+const TOOL_DESCRIPTION = `Archive one or more Amazon DSP entities (equivalent to deletion).
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Amazon DSP has no DELETE endpoint. Archiving sets state to ARCHIVED via PUT.
+Archived entities cannot be recovered. Consider using \`amazon_dsp_bulk_update_status\` with PAUSED first.`;
+export const DeleteEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to delete"),
+    profileId: z.string().min(1).describe("AmazonDsp Advertiser ID"),
+    entityIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(20)
+        .describe("Array of entity IDs to delete (max 20)"),
+})
+    .describe("Parameters for deleting AmazonDsp Ads entities");
+export const DeleteEntityOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    entityType: z.string(),
+    totalRequested: z.number(),
+    totalSucceeded: z.number(),
+    totalFailed: z.number(),
+    results: z.array(z.object({
+        entityId: z.string(),
+        success: z.boolean(),
+        error: z.string().optional(),
+    })),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity delete result");
+export async function deleteEntityLogic(input, context, sdkContext) {
+    const confirmed = await elicitBulkDeleteConfirmation({
+        count: input.entityIds.length,
+        entityLabel: input.entityType,
+        impactPreview: input.entityIds,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            entityType: input.entityType,
+            totalRequested: input.entityIds.length,
+            totalSucceeded: 0,
+            totalFailed: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { amazonDspService } = resolveSessionServices(sdkContext);
+    const results = [];
+    for (const entityId of input.entityIds) {
+        try {
+            await amazonDspService.deleteEntity(input.entityType, entityId, context);
+            results.push({ entityId, success: true });
+        }
+        catch (error) {
+            results.push({
+                entityId,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    const totalSucceeded = results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        entityType: input.entityType,
+        totalRequested: input.entityIds.length,
+        totalSucceeded,
+        totalFailed: input.entityIds.length - totalSucceeded,
+        results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function deleteEntityResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk archive of ${result.totalRequested} ${result.entityType}(s) cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const lines = [
+        `${result.entityType} deletions: ${result.totalSucceeded}/${result.totalRequested} succeeded, ${result.totalFailed} failed`,
+        "",
+    ];
+    for (const r of result.results) {
+        if (r.success) {
+            lines.push(`  ${r.entityId}: archived`);
+        }
+        else {
+            lines.push(`  ${r.entityId}: FAILED - ${r.error}`);
+        }
+    }
+    lines.push("", `Timestamp: ${result.timestamp}`);
+    return [{ type: "text", text: lines.join("\n") }];
+}
+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: "Archive a single order (campaign)",
+            input: {
+                entityType: "order",
+                profileId: "1234567890",
+                entityIds: ["ord_123456789"],
+            },
+        },
+        {
+            label: "Archive multiple line items",
+            input: {
+                entityType: "lineItem",
+                profileId: "1234567890",
+                entityIds: ["li_111111", "li_222222"],
+            },
+        },
+    ],
+    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/download-report.tool.d.ts

@@ -0,0 +1,297 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const DownloadReportInputSchema: z.ZodObject<{
+    downloadUrl: z.ZodString;
+    storeRawCsv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+} & {
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
+} & {
+    includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    downloadUrl: string;
+    includeComputedMetrics: boolean;
+    mode: "rows" | "summary";
+    storeRawCsv: boolean;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+}, {
+    downloadUrl: string;
+    includeComputedMetrics?: boolean | undefined;
+    mode?: "rows" | "summary" | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    storeRawCsv?: boolean | undefined;
+}>;
+export declare const DownloadReportOutputSchema: z.ZodObject<{
+    rawCsvResourceUri: z.ZodOptional<z.ZodString>;
+    rawCsvByteLength: z.ZodOptional<z.ZodNumber>;
+    spill: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        bucket: z.ZodString;
+        objectName: z.ZodString;
+        bytes: z.ZodNumber;
+        rowCount: z.ZodOptional<z.ZodNumber>;
+        signedUrl: z.ZodString;
+        expiresAt: z.ZodString;
+        mimeType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        bucket: string;
+        objectName: string;
+        bytes: number;
+        signedUrl: string;
+        expiresAt: string;
+        mimeType: string;
+        rowCount?: number | undefined;
+    }, {
+        bucket: string;
+        objectName: string;
+        bytes: number;
+        signedUrl: string;
+        expiresAt: string;
+        mimeType: string;
+        rowCount?: number | undefined;
+    }>, z.ZodObject<{
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+    }, {
+        error: string;
+    }>]>>;
+    timestamp: z.ZodString;
+    totalRows: z.ZodNumber;
+    returnedRows: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    nextOffset: z.ZodNullable<z.ZodNumber>;
+    headers: z.ZodArray<z.ZodString, "many">;
+    selectedColumns: z.ZodArray<z.ZodString, "many">;
+    mode: z.ZodEnum<["summary", "rows"]>;
+    previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+    warnings: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    headers: string[];
+    totalRows: number;
+    timestamp: string;
+    mode: "rows" | "summary";
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    selectedColumns: string[];
+    warnings: string[];
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+    rawCsvResourceUri?: string | undefined;
+    rawCsvByteLength?: number | undefined;
+    spill?: {
+        bucket: string;
+        objectName: string;
+        bytes: number;
+        signedUrl: string;
+        expiresAt: string;
+        mimeType: string;
+        rowCount?: number | undefined;
+    } | {
+        error: string;
+    } | undefined;
+}, {
+    headers: string[];
+    totalRows: number;
+    timestamp: string;
+    mode: "rows" | "summary";
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    selectedColumns: string[];
+    warnings: string[];
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+    rawCsvResourceUri?: string | undefined;
+    rawCsvByteLength?: number | undefined;
+    spill?: {
+        bucket: string;
+        objectName: string;
+        bytes: number;
+        signedUrl: string;
+        expiresAt: string;
+        mimeType: string;
+        rowCount?: number | undefined;
+    } | {
+        error: string;
+    } | undefined;
+}>;
+type DownloadInput = z.infer<typeof DownloadReportInputSchema>;
+type DownloadOutput = z.infer<typeof DownloadReportOutputSchema>;
+export declare function downloadReportLogic(input: DownloadInput, _context: RequestContext, sdkContext?: SdkContext): Promise<DownloadOutput>;
+export declare function downloadReportResponseFormatter(result: DownloadOutput): McpTextContent[];
+export declare const downloadReportTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        downloadUrl: z.ZodString;
+        storeRawCsv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
+        columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
+    } & {
+        includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        downloadUrl: string;
+        includeComputedMetrics: boolean;
+        mode: "rows" | "summary";
+        storeRawCsv: boolean;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    }, {
+        downloadUrl: string;
+        includeComputedMetrics?: boolean | undefined;
+        mode?: "rows" | "summary" | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+        storeRawCsv?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        rawCsvResourceUri: z.ZodOptional<z.ZodString>;
+        rawCsvByteLength: z.ZodOptional<z.ZodNumber>;
+        spill: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            bucket: z.ZodString;
+            objectName: z.ZodString;
+            bytes: z.ZodNumber;
+            rowCount: z.ZodOptional<z.ZodNumber>;
+            signedUrl: z.ZodString;
+            expiresAt: z.ZodString;
+            mimeType: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            bucket: string;
+            objectName: string;
+            bytes: number;
+            signedUrl: string;
+            expiresAt: string;
+            mimeType: string;
+            rowCount?: number | undefined;
+        }, {
+            bucket: string;
+            objectName: string;
+            bytes: number;
+            signedUrl: string;
+            expiresAt: string;
+            mimeType: string;
+            rowCount?: number | undefined;
+        }>, z.ZodObject<{
+            error: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            error: string;
+        }, {
+            error: string;
+        }>]>>;
+        timestamp: z.ZodString;
+        totalRows: z.ZodNumber;
+        returnedRows: z.ZodNumber;
+        truncated: z.ZodBoolean;
+        nextOffset: z.ZodNullable<z.ZodNumber>;
+        headers: z.ZodArray<z.ZodString, "many">;
+        selectedColumns: z.ZodArray<z.ZodString, "many">;
+        mode: z.ZodEnum<["summary", "rows"]>;
+        previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+        rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+        warnings: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        headers: string[];
+        totalRows: number;
+        timestamp: string;
+        mode: "rows" | "summary";
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        selectedColumns: string[];
+        warnings: string[];
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+        rawCsvResourceUri?: string | undefined;
+        rawCsvByteLength?: number | undefined;
+        spill?: {
+            bucket: string;
+            objectName: string;
+            bytes: number;
+            signedUrl: string;
+            expiresAt: string;
+            mimeType: string;
+            rowCount?: number | undefined;
+        } | {
+            error: string;
+        } | undefined;
+    }, {
+        headers: string[];
+        totalRows: number;
+        timestamp: string;
+        mode: "rows" | "summary";
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        selectedColumns: string[];
+        warnings: string[];
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+        rawCsvResourceUri?: string | undefined;
+        rawCsvByteLength?: number | undefined;
+        spill?: {
+            bucket: string;
+            objectName: string;
+            bytes: number;
+            signedUrl: string;
+            expiresAt: string;
+            mimeType: string;
+            rowCount?: number | undefined;
+        } | {
+            error: string;
+        } | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            downloadUrl: string;
+            mode?: undefined;
+            columns?: undefined;
+            maxRows?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            downloadUrl: string;
+            mode: string;
+            columns: string[];
+            maxRows: number;
+        };
+    })[];
+    logic: typeof downloadReportLogic;
+    responseFormatter: typeof downloadReportResponseFormatter;
+};
+export {};
+//# sourceMappingURL=download-report.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/download-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmBnD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBsB,CAAC;AAE7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;gBAjCsC,CAAC;;;;;;;;gBAKxE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkC8B,CAAC;AAEtC,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC/D,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAUjE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,EAAE,CAOxF;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAnF8C,CAAC;;;;;;;;oBAKxE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6GN,CAAC"}

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

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { reportCsvStore } from "../../../services/session-services.js";
+import { ComputedMetricsFlagSchema, createServiceDownloadedReportView, extractReportIdFromUrl, formatReportViewResponse, ReportViewInputSchema, ReportViewOutputSchema, StoredReportBodyOutputSchema, spillBodyToGcs, } from "@cesteral/shared";
+const TOOL_NAME = "amazon_dsp_download_report";
+const TOOL_TITLE = "Download AmazonDsp Report";
+const TOOL_DESCRIPTION = `Download and parse a AmazonDsp report from a download URL.
+
+After a report task is COMPLETED (via \`amazon_dsp_check_report_status\`), use the \`downloadUrl\` to fetch and parse the report data.
+
+**Workflow:**
+1. \`amazon_dsp_submit_report\` → get \`taskId\`
+2. \`amazon_dsp_check_report_status\` → get \`downloadUrl\` when COMPLETED
+3. \`amazon_dsp_download_report\` with that URL → get a bounded summary or paged row slice
+
+**Options:**
+- \`mode: "summary"\` (default) returns headers, counts, and a small preview
+- \`mode: "rows"\` returns one bounded page of rows
+- \`columns\` projects returned rows to selected columns
+- \`offset\` and \`maxRows\` page through rows; \`maxRows\` is capped at 200`;
+export const DownloadReportInputSchema = z
+    .object({
+    downloadUrl: z
+        .string()
+        .url()
+        .describe("Report download URL from amazon_dsp_check_report_status"),
+    storeRawCsv: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Persist the full report body (JSON or CSV, depending on report type) in " +
+        "the in-process report-csv store and return a `report-csv://{id}` resource URI. " +
+        "Entries expire after 30 minutes."),
+})
+    .merge(ReportViewInputSchema)
+    .merge(ComputedMetricsFlagSchema)
+    .describe("Parameters for downloading a AmazonDsp report");
+export const DownloadReportOutputSchema = z
+    .object({
+    ...ReportViewOutputSchema.shape,
+    timestamp: z.string().datetime(),
+    ...StoredReportBodyOutputSchema.shape,
+})
+    .describe("Downloaded report data");
+const AMAZON_DSP_COMPUTED_METRIC_ALIASES = {
+    cost: ["totalCost", "cost", "spend"],
+    impressions: ["impressions"],
+    clicks: ["clickThroughs", "clicks"],
+    conversions: ["purchases14d", "purchases", "totalPurchases"],
+    conversionValue: ["sales14d", "totalSales", "purchasesValue14d"],
+};
+export async function downloadReportLogic(input, _context, sdkContext) {
+    const { amazonDspReportingService } = resolveSessionServices(sdkContext);
+    return createServiceDownloadedReportView({
+        input,
+        sessionId: sdkContext?.sessionId,
+        reportCsvStore,
+        spillBodyToGcs,
+        spillServer: "amazonDsp",
+        reportId: extractReportIdFromUrl(input.downloadUrl),
+        computedMetricAliases: AMAZON_DSP_COMPUTED_METRIC_ALIASES,
+        download: ({ fetchLimit, includeRawCsv }) => amazonDspReportingService.downloadReport(input.downloadUrl, fetchLimit, undefined, {
+            includeRawCsv,
+        }),
+    });
+}
+export function downloadReportResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: formatReportViewResponse(result, "Report data"),
+        },
+    ];
+}
+export const downloadReportTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: DownloadReportInputSchema,
+    outputSchema: DownloadReportOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Download report summary preview",
+            input: {
+                downloadUrl: "https://analytics.amazonDsp.com/reports/task-abc123/report.csv",
+            },
+        },
+        {
+            label: "Download selected columns as a paged row slice",
+            input: {
+                downloadUrl: "https://analytics.amazonDsp.com/reports/task-xyz789/report.csv",
+                mode: "rows",
+                columns: ["lineItem", "impressions", "totalCost"],
+                maxRows: 50,
+            },
+        },
+    ],
+    logic: downloadReportLogic,
+    responseFormatter: downloadReportResponseFormatter,
+};
+//# sourceMappingURL=download-report.tool.js.map

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

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

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

@@ -0,0 +1,105 @@
+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[]]>;
+    profileId: z.ZodString;
+    entityId: z.ZodString;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    entityType: string;
+    profileId: string;
+    options?: Record<string, any> | undefined;
+}, {
+    entityId: string;
+    entityType: string;
+    profileId: string;
+    options?: Record<string, any> | undefined;
+}>;
+export declare const DuplicateEntityOutputSchema: z.ZodObject<{
+    newEntity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    sourceEntityId: z.ZodString;
+    entityType: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    newEntity: Record<string, any>;
+    sourceEntityId: string;
+}, {
+    entityType: string;
+    timestamp: string;
+    newEntity: Record<string, any>;
+    sourceEntityId: string;
+}>;
+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[]]>;
+        profileId: z.ZodString;
+        entityId: z.ZodString;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        entityType: string;
+        profileId: string;
+        options?: Record<string, any> | undefined;
+    }, {
+        entityId: string;
+        entityType: string;
+        profileId: string;
+        options?: Record<string, any> | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        newEntity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        sourceEntityId: z.ZodString;
+        entityType: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        newEntity: Record<string, any>;
+        sourceEntityId: string;
+    }, {
+        entityType: string;
+        timestamp: string;
+        newEntity: Record<string, any>;
+        sourceEntityId: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            profileId: string;
+            entityId: string;
+            options?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            profileId: string;
+            entityId: string;
+            options: {
+                name: 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;AAWnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAUyB,CAAC;AAEjE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAOA,CAAC;AAEzC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC/B,CAAC"}