@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,128 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { fromTtdSchedule, ReportScheduleSummarySchema, PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+const TOOL_NAME = "ttd_list_report_schedules";
+const TOOL_TITLE = "List TTD Report Schedules";
+const TOOL_DESCRIPTION = `List report schedules (saved recurring or one-time reports).
+
+Returns all report schedules accessible to the authenticated partner.
+Filter by advertiser IDs to narrow results.
+
+Use \`ttd_get_report_schedule\` to fetch full details for a specific schedule.
+Use \`ttd_delete_report_schedule\` to remove a schedule.`;
+export const ListReportSchedulesInputSchema = z
+    .object({
+    advertiserIds: z
+        .array(z.string())
+        .optional()
+        .describe("Filter to schedules belonging to these advertiser IDs"),
+    pageSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(50)
+        .describe("Number of results per page (default 50, max 100)"),
+    pageStartIndex: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .default(0)
+        .describe("Zero-based start index for pagination"),
+})
+    .describe("Parameters for listing TTD report schedules");
+export const ListReportSchedulesOutputSchema = z
+    .object({
+    schedules: z
+        .array(ReportScheduleSummarySchema)
+        .describe("Canonical ReportScheduleSummary entries"),
+    raw: z
+        .array(z.record(z.unknown()))
+        .optional()
+        .describe("Raw TTD schedule envelopes (kept for platform-specific debugging)"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("List of report schedules (normalized to ReportScheduleSummary)");
+export async function listReportSchedulesLogic(input, context, sdkContext) {
+    const { ttdReportingService } = resolveSessionServices(sdkContext);
+    const pageSize = input.pageSize ?? 50;
+    const pageStartIndex = input.pageStartIndex ?? 0;
+    const query = {
+        PageSize: pageSize,
+        PageStartIndex: pageStartIndex,
+    };
+    if (input.advertiserIds && input.advertiserIds.length > 0) {
+        query.AdvertiserFilters = input.advertiserIds.map((id) => ({
+            Type: "AdvertiserId",
+            Value: id,
+        }));
+    }
+    const result = (await ttdReportingService.listReportSchedules(query, context));
+    const rawSchedules = result.Result ?? [];
+    const totalCount = result.TotalFilteredCount;
+    const schedules = rawSchedules.map((r) => fromTtdSchedule(r));
+    const hasMore = totalCount !== undefined ? pageStartIndex + schedules.length < totalCount : false;
+    const nextStartIndex = pageStartIndex + schedules.length;
+    return {
+        schedules,
+        raw: rawSchedules,
+        pagination: buildPaginationOutput({
+            nextCursor: hasMore ? String(nextStartIndex) : null,
+            pageSize: schedules.length,
+            totalCount,
+            nextPageInputKey: "pageStartIndex",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listReportSchedulesResponseFormatter(result) {
+    if (result.schedules.length === 0) {
+        return [
+            {
+                type: "text",
+                text: `No report schedules found.\n\nUse \`ttd_create_report_schedule\` to create one.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const { pageSize, totalCount } = result.pagination;
+    return [
+        {
+            type: "text",
+            text: `Found ${pageSize} report schedule(s)` +
+                (totalCount !== undefined ? ` (${totalCount} total)` : "") +
+                `:\n\n${JSON.stringify(result.schedules, null, 2)}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listReportSchedulesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListReportSchedulesInputSchema,
+    outputSchema: ListReportSchedulesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all schedules",
+            input: {},
+        },
+        {
+            label: "Filter by advertiser",
+            input: {
+                advertiserIds: ["adv123"],
+                pageSize: 25,
+            },
+        },
+    ],
+    logic: listReportSchedulesLogic,
+    responseFormatter: listReportSchedulesResponseFormatter,
+};
+//# sourceMappingURL=list-report-schedules.tool.js.map

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

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

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

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const ListReportTemplatesInputSchema: z.ZodObject<{
+    first: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    after: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    first: number;
+    after?: string | undefined;
+}, {
+    first?: number | undefined;
+    after?: string | undefined;
+}>;
+export declare const ListReportTemplatesOutputSchema: z.ZodObject<{
+    templates: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+        pageSize: z.ZodNumber;
+        totalCount: z.ZodOptional<z.ZodNumber>;
+        nextPageInputKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    templates: Record<string, unknown>[];
+}, {
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    templates: Record<string, unknown>[];
+}>;
+type ListReportTemplatesInput = z.infer<typeof ListReportTemplatesInputSchema>;
+type ListReportTemplatesOutput = z.infer<typeof ListReportTemplatesOutputSchema>;
+export declare function listReportTemplatesLogic(input: ListReportTemplatesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListReportTemplatesOutput>;
+export declare function listReportTemplatesResponseFormatter(result: ListReportTemplatesOutput): McpTextContent[];
+export declare const listReportTemplatesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        first: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        after: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        first: number;
+        after?: string | undefined;
+    }, {
+        first?: number | undefined;
+        after?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        templates: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        pagination: z.ZodObject<{
+            nextCursor: z.ZodNullable<z.ZodString>;
+            hasMore: z.ZodBoolean;
+            pageSize: z.ZodNumber;
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextPageInputKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        templates: Record<string, unknown>[];
+    }, {
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        templates: Record<string, unknown>[];
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            first: number;
+            after?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            first: number;
+            after: string;
+        };
+    })[];
+    logic: typeof listReportTemplatesLogic;
+    responseFormatter: typeof listReportTemplatesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-report-templates.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-report-templates.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-report-templates.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWnF,eAAO,MAAM,8BAA8B;;;;;;;;;EAYe,CAAC;AAE3D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAME,CAAC;AAE/C,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;AAkBjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAkCpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAoBlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BnC,CAAC"}

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

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+import { MYREPORTS_TEMPLATE_ACCESS_ERROR, throwIfGraphqlErrors } from "../utils/graphql-errors.js";
+const TOOL_NAME = "ttd_list_report_templates";
+const TOOL_TITLE = "List TTD Report Templates (GraphQL)";
+const TOOL_DESCRIPTION = `List report template headers from TTD MyReports via GraphQL (\`myReportsReportTemplates\`).
+
+This is the docs-aligned way to discover template IDs before retrieving structure with \`ttd_get_report_template\` or scheduling runs with \`ttd_create_template_schedule\`.
+
+**Note:** If you receive an \`UNAUTHORIZED_FIELD_OR_TYPE\` error, your TTD account does not have MyReports API access enabled. Contact your TTD Account Manager or Technical Account Manager (TAM) to request this entitlement. Use \`GET /v3/myreports/reporttemplate/facets\` or \`POST /v3/myreports/reporttemplateheader/query\` once enabled.`;
+export const ListReportTemplatesInputSchema = z
+    .object({
+    first: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(50)
+        .describe("GraphQL page size (default 50, max 100)"),
+    after: z.string().optional().describe("GraphQL end cursor from a previous call"),
+})
+    .describe("Parameters for listing TTD report templates");
+export const ListReportTemplatesOutputSchema = z
+    .object({
+    templates: z.array(z.record(z.unknown())).describe("List of report template header objects"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("List of report template headers");
+const LIST_REPORT_TEMPLATES_QUERY = `query GetReportTemplates($first: Int, $after: String) {
+  myReportsReportTemplates(first: $first, after: $after) {
+    pageInfo {
+      startCursor
+      hasNextPage
+      endCursor
+    }
+    totalCount
+    nodes {
+      id
+      name
+      format
+    }
+  }
+}`;
+export async function listReportTemplatesLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const pageSize = input.first ?? 50;
+    const raw = (await ttdService.graphqlQuery(LIST_REPORT_TEMPLATES_QUERY, { first: pageSize, after: input.after }, context));
+    throwIfGraphqlErrors(raw, "GraphQL error listing report templates", {
+        unauthorizedMessage: MYREPORTS_TEMPLATE_ACCESS_ERROR,
+    });
+    const gqlData = raw.data ?? {};
+    const connection = gqlData.myReportsReportTemplates ?? {};
+    const pageInfo = connection.pageInfo ?? {};
+    const nodes = connection.nodes ?? [];
+    const hasNextPage = pageInfo.hasNextPage;
+    const endCursor = pageInfo.endCursor;
+    return {
+        templates: nodes,
+        pagination: buildPaginationOutput({
+            nextCursor: hasNextPage === true ? (endCursor ?? null) : null,
+            pageSize: nodes.length,
+            totalCount: connection.totalCount,
+            nextPageInputKey: "after",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listReportTemplatesResponseFormatter(result) {
+    if (result.templates.length === 0) {
+        return [
+            {
+                type: "text",
+                text: `No report templates found.\n\nUse \`ttd_create_report_template\` to create one or verify access to existing MyReports templates.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const { pageSize, totalCount } = result.pagination;
+    return [
+        {
+            type: "text",
+            text: `Found ${pageSize} report template(s)` +
+                (totalCount !== undefined ? ` (${totalCount} total)` : "") +
+                `:\n\n${JSON.stringify(result.templates, null, 2)}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listReportTemplatesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListReportTemplatesInputSchema,
+    outputSchema: ListReportTemplatesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all templates",
+            input: { first: 25 },
+        },
+        {
+            label: "Continue from a cursor",
+            input: {
+                first: 10,
+                after: "opaque-cursor-placeholder",
+            },
+        },
+    ],
+    logic: listReportTemplatesLogic,
+    responseFormatter: listReportTemplatesResponseFormatter,
+};
+//# sourceMappingURL=list-report-templates.tool.js.map

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

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

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

@@ -0,0 +1,97 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const ListReportTypesInputSchema: z.ZodObject<{
+    format: z.ZodDefault<z.ZodEnum<["EXCEL"]>>;
+}, "strip", z.ZodTypeAny, {
+    format: "EXCEL";
+}, {
+    format?: "EXCEL" | undefined;
+}>;
+export declare const ListReportTypesOutputSchema: z.ZodObject<{
+    reportTypes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+    }, {
+        name: string;
+        id: string;
+    }>, "many">;
+    count: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    count: number;
+    reportTypes: {
+        name: string;
+        id: string;
+    }[];
+}, {
+    timestamp: string;
+    count: number;
+    reportTypes: {
+        name: string;
+        id: string;
+    }[];
+}>;
+type ListReportTypesInput = z.infer<typeof ListReportTypesInputSchema>;
+type ListReportTypesOutput = z.infer<typeof ListReportTypesOutputSchema>;
+export declare function listReportTypesLogic(input: ListReportTypesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListReportTypesOutput>;
+export declare function listReportTypesResponseFormatter(result: ListReportTypesOutput): McpTextContent[];
+export declare const listReportTypesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        format: z.ZodDefault<z.ZodEnum<["EXCEL"]>>;
+    }, "strip", z.ZodTypeAny, {
+        format: "EXCEL";
+    }, {
+        format?: "EXCEL" | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        reportTypes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            id: string;
+        }, {
+            name: string;
+            id: string;
+        }>, "many">;
+        count: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        count: number;
+        reportTypes: {
+            name: string;
+            id: string;
+        }[];
+    }, {
+        timestamp: string;
+        count: number;
+        reportTypes: {
+            name: string;
+            id: string;
+        }[];
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            format: string;
+        };
+    }[];
+    logic: typeof listReportTypesLogic;
+    responseFormatter: typeof listReportTypesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-report-types.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-report-types.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-report-types.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;AASnF,eAAO,MAAM,0BAA0B;;;;;;EAOe,CAAC;AAOvD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMS,CAAC;AAElD,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AASzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAmBhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAwBhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB/B,CAAC"}

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { throwIfGraphqlErrors } from "../utils/graphql-errors.js";
+const TOOL_NAME = "ttd_list_report_types";
+const TOOL_TITLE = "List TTD Report Types (GraphQL)";
+const TOOL_DESCRIPTION = `List all available report types from the TTD GraphQL API.
+
+Returns the ID and name of each report type. Use the returned report type ID with \`ttd_get_report_type_schema\` to discover the available fields and metrics for that report type, then use those IDs when building a report template with \`ttd_create_report_template\`.`;
+export const ListReportTypesInputSchema = z
+    .object({
+    format: z
+        .enum(["EXCEL"])
+        .default("EXCEL")
+        .describe("Report format (currently only EXCEL is supported)"),
+})
+    .describe("Parameters for listing TTD report types");
+const ReportTypeItemSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+});
+export const ListReportTypesOutputSchema = z
+    .object({
+    reportTypes: z.array(ReportTypeItemSchema).describe("Available report types"),
+    count: z.number().describe("Number of report types returned"),
+    timestamp: z.string().datetime(),
+})
+    .describe("List of available TTD report types");
+const LIST_REPORT_TYPES_QUERY = `query ListReportTypes($input: ReportTypesInput!) {
+  reportTypes(input: $input) {
+    id
+    name
+  }
+}`;
+export async function listReportTypesLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const raw = (await ttdService.graphqlQuery(LIST_REPORT_TYPES_QUERY, { input: { format: input.format ?? "EXCEL" } }, context));
+    throwIfGraphqlErrors(raw, "GraphQL error listing report types");
+    const gqlData = raw.data ?? {};
+    const reportTypes = gqlData.reportTypes ?? [];
+    return {
+        reportTypes,
+        count: reportTypes.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listReportTypesResponseFormatter(result) {
+    if (result.reportTypes.length === 0) {
+        return [
+            {
+                type: "text",
+                text: `No report types found for the specified format.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const lines = result.reportTypes
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((rt) => `- ${rt.name} (ID: ${rt.id})`);
+    return [
+        {
+            type: "text",
+            text: `Found ${result.count} report types:\n\n` +
+                lines.join("\n") +
+                `\n\nUse \`ttd_get_report_type_schema\` with a report type ID to see its available fields and metrics.\n\n` +
+                `Timestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listReportTypesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListReportTypesInputSchema,
+    outputSchema: ListReportTypesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all available report types",
+            input: { format: "EXCEL" },
+        },
+    ],
+    logic: listReportTypesLogic,
+    responseFormatter: listReportTypesResponseFormatter,
+};
+//# sourceMappingURL=list-report-types.tool.js.map

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

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