@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,297 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } 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;
+    mode: "summary" | "rows";
+    storeRawCsv: boolean;
+    includeComputedMetrics: boolean;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
+}, {
+    downloadUrl: string;
+    mode?: "summary" | "rows" | undefined;
+    storeRawCsv?: boolean | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
+    includeComputedMetrics?: 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[];
+    timestamp: string;
+    mode: "summary" | "rows";
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    selectedColumns: string[];
+    warnings: string[];
+    spill?: {
+        bucket: string;
+        objectName: string;
+        bytes: number;
+        signedUrl: string;
+        expiresAt: string;
+        mimeType: string;
+        rowCount?: number | undefined;
+    } | {
+        error: string;
+    } | undefined;
+    rows?: Record<string, any>[] | undefined;
+    rawCsvResourceUri?: string | undefined;
+    rawCsvByteLength?: number | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+}, {
+    headers: string[];
+    timestamp: string;
+    mode: "summary" | "rows";
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    selectedColumns: string[];
+    warnings: string[];
+    spill?: {
+        bucket: string;
+        objectName: string;
+        bytes: number;
+        signedUrl: string;
+        expiresAt: string;
+        mimeType: string;
+        rowCount?: number | undefined;
+    } | {
+        error: string;
+    } | undefined;
+    rows?: Record<string, any>[] | undefined;
+    rawCsvResourceUri?: string | undefined;
+    rawCsvByteLength?: number | undefined;
+    previewRows?: Record<string, any>[] | 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;
+        mode: "summary" | "rows";
+        storeRawCsv: boolean;
+        includeComputedMetrics: boolean;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
+    }, {
+        downloadUrl: string;
+        mode?: "summary" | "rows" | undefined;
+        storeRawCsv?: boolean | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
+        includeComputedMetrics?: 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[];
+        timestamp: string;
+        mode: "summary" | "rows";
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        selectedColumns: string[];
+        warnings: string[];
+        spill?: {
+            bucket: string;
+            objectName: string;
+            bytes: number;
+            signedUrl: string;
+            expiresAt: string;
+            mimeType: string;
+            rowCount?: number | undefined;
+        } | {
+            error: string;
+        } | undefined;
+        rows?: Record<string, any>[] | undefined;
+        rawCsvResourceUri?: string | undefined;
+        rawCsvByteLength?: number | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+    }, {
+        headers: string[];
+        timestamp: string;
+        mode: "summary" | "rows";
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        selectedColumns: string[];
+        warnings: string[];
+        spill?: {
+            bucket: string;
+            objectName: string;
+            bytes: number;
+            signedUrl: string;
+            expiresAt: string;
+            mimeType: string;
+            rowCount?: number | undefined;
+        } | {
+            error: string;
+        } | undefined;
+        rows?: Record<string, any>[] | undefined;
+        rawCsvResourceUri?: string | undefined;
+        rawCsvByteLength?: number | undefined;
+        previewRows?: Record<string, any>[] | 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;AAmBxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAkBnD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBgB,CAAC;AAEvD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;gBAhCe,CAAC;;;;;;;;gBAE0H,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC7I,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;AAoDjE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,EAAE,CAOxF;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBApKuB,CAAC;;;;;;;;oBAE0H,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiMjL,CAAC"}

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

@@ -0,0 +1,160 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { reportCsvStore } from "../../../services/session-services.js";
+import { ComputedMetricsFlagSchema, createServiceDownloadedReportView, extractReportIdFromUrl, fetchWithTimeout, formatReportViewResponse, parseCSV, ReportViewInputSchema, ReportViewOutputSchema, StoredReportBodyOutputSchema, spillBodyToGcs, McpError, JsonRpcErrorCode, mapHttpStatusToJsonRpc, } from "@cesteral/shared";
+const TOOL_NAME = "ttd_download_report";
+const TOOL_TITLE = "Download TTD Report";
+const TOOL_DESCRIPTION = `Download and parse a TTD report from a download URL.
+
+After generating a report with \`ttd_get_report\`, use the returned \`downloadUrl\` to fetch and parse the CSV data. TTD-hosted report URLs require server-side \`TTD-Auth\`, so this tool fetches the report and returns a bounded view that stays within MCP response-size limits.
+
+**Workflow:**
+1. Run \`ttd_get_report\` → get \`downloadUrl\`
+2. Run \`ttd_download_report\` with that URL → get a summary preview or a 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 ttd_get_report"),
+    storeRawCsv: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Persist the full CSV body in the in-process report-csv store and return " +
+        "a `report-csv://{id}` resource URI. Use when a downstream tool/user needs " +
+        "the complete CSV but the model only needs a bounded preview. Entries " +
+        "expire after 30 minutes. Sensitive token-like values are redacted before storage."),
+})
+    .merge(ReportViewInputSchema)
+    .merge(ComputedMetricsFlagSchema)
+    .describe("Parameters for downloading a TTD report");
+export const DownloadReportOutputSchema = z
+    .object({
+    ...ReportViewOutputSchema.shape,
+    timestamp: z.string().datetime(),
+    ...StoredReportBodyOutputSchema.shape,
+})
+    .describe("Downloaded report data");
+const TTD_COMPUTED_METRIC_ALIASES = {
+    cost: ["TotalCost", "AdvertiserCost", "PartnerCost"],
+    impressions: ["Impressions"],
+    clicks: ["Clicks"],
+    conversions: ["TotalConversions", "Conversions"],
+    conversionValue: ["TotalConversionsValue", "ConversionValue"],
+};
+const ALLOWED_REPORT_HOSTNAME_PATTERN = /(?:^|\.)(?:thetradedesk\.com|amazonaws\.com)$/;
+function isAllowedReportUrl(rawUrl) {
+    try {
+        const { hostname } = new URL(rawUrl);
+        return ALLOWED_REPORT_HOSTNAME_PATTERN.test(hostname);
+    }
+    catch {
+        return false;
+    }
+}
+function detectBinarySpreadsheet(bytes, contentType, downloadUrl) {
+    const normalizedType = contentType?.toLowerCase() ?? "";
+    const lowerUrl = downloadUrl.toLowerCase();
+    const isZipSignature = bytes.length >= 4 &&
+        bytes[0] === 0x50 &&
+        bytes[1] === 0x4b &&
+        bytes[2] === 0x03 &&
+        bytes[3] === 0x04;
+    const looksLikeSpreadsheet = normalizedType.includes("spreadsheetml") ||
+        normalizedType.includes("application/zip") ||
+        normalizedType.includes("application/octet-stream") ||
+        lowerUrl.includes(".xlsx") ||
+        isZipSignature;
+    if (!looksLikeSpreadsheet)
+        return null;
+    return ("This download appears to be an XLSX/ExcelPivot report, not CSV. " +
+        "ttd_download_report currently supports CSV parsing only. " +
+        "Regenerate the report in CSV format or use a CSV-based report workflow before calling this tool.");
+}
+export async function downloadReportLogic(input, _context, sdkContext) {
+    const { authAdapter } = resolveSessionServices(sdkContext);
+    if (!isAllowedReportUrl(input.downloadUrl)) {
+        throw new McpError(JsonRpcErrorCode.InvalidParams, `Report download URL must be from *.thetradedesk.com or *.amazonaws.com. Got: ${new URL(input.downloadUrl).hostname}`);
+    }
+    return createServiceDownloadedReportView({
+        input,
+        sessionId: sdkContext?.sessionId,
+        reportCsvStore,
+        spillBodyToGcs,
+        spillServer: "ttd",
+        reportId: extractReportIdFromUrl(input.downloadUrl),
+        computedMetricAliases: TTD_COMPUTED_METRIC_ALIASES,
+        download: async ({ fetchLimit }) => {
+            const { hostname } = new URL(input.downloadUrl);
+            const requestInit = /thetradedesk\.com$/.test(hostname)
+                ? { headers: { "TTD-Auth": await authAdapter.getAccessToken() } }
+                : {};
+            const response = await fetchWithTimeout(input.downloadUrl, 60_000, undefined, requestInit);
+            if (!response.ok) {
+                throw new McpError(mapHttpStatusToJsonRpc(response.status), `Failed to download report: ${response.status} ${response.statusText}`);
+            }
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            const contentType = response.headers.get("content-type");
+            const binarySpreadsheetError = detectBinarySpreadsheet(bytes, contentType, input.downloadUrl);
+            if (binarySpreadsheetError) {
+                throw new McpError(JsonRpcErrorCode.InvalidRequest, binarySpreadsheetError);
+            }
+            const csvText = new TextDecoder("utf-8").decode(bytes);
+            const { headers, rows: recordRows } = parseCSV(csvText);
+            const limited = recordRows.slice(0, fetchLimit);
+            const rows = limited.map((record) => headers.map((h) => record[h] ?? ""));
+            return {
+                headers,
+                rows,
+                totalRows: recordRows.length,
+                rawCsv: csvText,
+                rawMimeType: "text/csv",
+            };
+        },
+    });
+}
+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://reports.thetradedesk.com/results/abc123def456/report.csv",
+            },
+        },
+        {
+            label: "Download selected columns as a paged row slice",
+            input: {
+                downloadUrl: "https://reports.thetradedesk.com/results/xyz789uvw012/report.csv",
+                mode: "rows",
+                columns: ["Site", "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/execute-entity-report.tool.d.ts

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const ExecuteEntityReportInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<["adGroup", "campaign", "advertiser"]>;
+    entityId: z.ZodString;
+    reportType: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: "advertiser" | "campaign" | "adGroup";
+    entityId: string;
+    reportType: string;
+}, {
+    entityType: "advertiser" | "campaign" | "adGroup";
+    entityId: string;
+    reportType: string;
+}>;
+export declare const ExecuteEntityReportOutputSchema: z.ZodObject<{
+    entityType: z.ZodString;
+    entityId: z.ZodString;
+    reportType: z.ZodString;
+    reportId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    downloadUrl: z.ZodOptional<z.ZodString>;
+    hasSampleData: z.ZodOptional<z.ZodBoolean>;
+    userErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        field: string;
+    }, {
+        message: string;
+        field: string;
+    }>, "many">>;
+    rawResponse: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    entityId: string;
+    reportType: string;
+    downloadUrl?: string | undefined;
+    reportId?: string | null | undefined;
+    hasSampleData?: boolean | undefined;
+    userErrors?: {
+        message: string;
+        field: string;
+    }[] | undefined;
+    rawResponse?: Record<string, unknown> | undefined;
+}, {
+    entityType: string;
+    timestamp: string;
+    entityId: string;
+    reportType: string;
+    downloadUrl?: string | undefined;
+    reportId?: string | null | undefined;
+    hasSampleData?: boolean | undefined;
+    userErrors?: {
+        message: string;
+        field: string;
+    }[] | undefined;
+    rawResponse?: Record<string, unknown> | undefined;
+}>;
+type ExecuteEntityReportInput = z.infer<typeof ExecuteEntityReportInputSchema>;
+type ExecuteEntityReportOutput = z.infer<typeof ExecuteEntityReportOutputSchema>;
+export declare function executeEntityReportLogic(input: ExecuteEntityReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<ExecuteEntityReportOutput>;
+export declare function executeEntityReportResponseFormatter(result: ExecuteEntityReportOutput): McpTextContent[];
+export declare const executeEntityReportTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<["adGroup", "campaign", "advertiser"]>;
+        entityId: z.ZodString;
+        reportType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: "advertiser" | "campaign" | "adGroup";
+        entityId: string;
+        reportType: string;
+    }, {
+        entityType: "advertiser" | "campaign" | "adGroup";
+        entityId: string;
+        reportType: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        entityType: z.ZodString;
+        entityId: z.ZodString;
+        reportType: z.ZodString;
+        reportId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        downloadUrl: z.ZodOptional<z.ZodString>;
+        hasSampleData: z.ZodOptional<z.ZodBoolean>;
+        userErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            field: string;
+        }, {
+            message: string;
+            field: string;
+        }>, "many">>;
+        rawResponse: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        entityId: string;
+        reportType: string;
+        downloadUrl?: string | undefined;
+        reportId?: string | null | undefined;
+        hasSampleData?: boolean | undefined;
+        userErrors?: {
+            message: string;
+            field: string;
+        }[] | undefined;
+        rawResponse?: Record<string, unknown> | undefined;
+    }, {
+        entityType: string;
+        timestamp: string;
+        entityId: string;
+        reportType: string;
+        downloadUrl?: string | undefined;
+        reportId?: string | null | undefined;
+        hasSampleData?: boolean | undefined;
+        userErrors?: {
+            message: string;
+            field: string;
+        }[] | undefined;
+        rawResponse?: Record<string, unknown> | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            entityId: string;
+            reportType: string;
+        };
+    }[];
+    logic: typeof executeEntityReportLogic;
+    responseFormatter: typeof executeEntityReportResponseFormatter;
+};
+export {};
+//# sourceMappingURL=execute-entity-report.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute-entity-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/execute-entity-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgBnF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAcmC,CAAC;AAE/E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeC,CAAC;AAE9C,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;AAQjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CA+BpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAiClB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCnC,CAAC"}