@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,231 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListEntitiesInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    partnerId: z.ZodOptional<z.ZodString>;
+    advertiserId: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    adGroupId: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    pageSize: number;
+    filter?: Record<string, unknown> | undefined;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    pageToken?: string | undefined;
+}, {
+    entityType: string;
+    filter?: Record<string, unknown> | undefined;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}>, {
+    entityType: string;
+    pageSize: number;
+    filter?: Record<string, unknown> | undefined;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    pageToken?: string | undefined;
+}, {
+    entityType: string;
+    filter?: Record<string, unknown> | undefined;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}>;
+export declare const ListEntitiesOutputSchema: z.ZodObject<{
+    entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "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, {
+    entities: Record<string, any>[];
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+}, {
+    entities: Record<string, any>[];
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+}>;
+type ListEntitiesInput = z.infer<typeof ListEntitiesInputSchema>;
+type ListEntitiesOutput = z.infer<typeof ListEntitiesOutputSchema>;
+export declare function listEntitiesLogic(input: ListEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListEntitiesOutput>;
+export declare function listEntitiesResponseFormatter(result: ListEntitiesOutput): McpTextContent[];
+export declare const listEntitiesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        partnerId: z.ZodOptional<z.ZodString>;
+        advertiserId: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodString>;
+        adGroupId: z.ZodOptional<z.ZodString>;
+        filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        pageToken: z.ZodOptional<z.ZodString>;
+        pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        pageSize: number;
+        filter?: Record<string, unknown> | undefined;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        pageToken?: string | undefined;
+    }, {
+        entityType: string;
+        filter?: Record<string, unknown> | undefined;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        pageToken?: string | undefined;
+        pageSize?: number | undefined;
+    }>, {
+        entityType: string;
+        pageSize: number;
+        filter?: Record<string, unknown> | undefined;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        pageToken?: string | undefined;
+    }, {
+        entityType: string;
+        filter?: Record<string, unknown> | undefined;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        pageToken?: string | undefined;
+        pageSize?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "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, {
+        entities: Record<string, any>[];
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+    }, {
+        entities: Record<string, any>[];
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            pageSize: number;
+            campaignId?: undefined;
+            partnerId?: undefined;
+            pageToken?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            campaignId: string;
+            pageSize: number;
+            partnerId?: undefined;
+            pageToken?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            partnerId: string;
+            pageSize: number;
+            pageToken: string;
+            advertiserId?: undefined;
+            campaignId?: undefined;
+        };
+    })[];
+    logic: typeof listEntitiesLogic;
+    responseFormatter: typeof listEntitiesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-entities.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+Cc,CAAC;AAEnD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMJ,CAAC;AAElC,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,CAmC7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAc1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C5B,CAAC"}

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

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, DEFAULT_PAGE_SIZE, } from "@cesteral/shared";
+const TOOL_NAME = "ttd_list_entities";
+const TOOL_TITLE = "List TTD Entities";
+const TOOL_DESCRIPTION = `List The Trade Desk entities with optional filtering and pagination. Required scope IDs: advertiser (partnerId), campaign/adGroup/creative/conversionTracker (advertiserId). For adGroup, optionally pass campaignId to filter to a single campaign. See entity-hierarchy://ttd resource for details.
+
+**Note:** Ads (ad group + creative associations), deals, bid lists, and publisher lists (site lists) have no REST query endpoints in TTD. Use the ttd_graphql_query tool for these entities.`;
+export const ListEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to list"),
+    partnerId: z
+        .string()
+        .optional()
+        .describe("Partner ID (required when listing advertiser entities)"),
+    advertiserId: z
+        .string()
+        .optional()
+        .describe("Advertiser ID (required for all entity types except advertiser)"),
+    campaignId: z
+        .string()
+        .optional()
+        .describe("Campaign ID (optional — filters adGroup queries to a single campaign)"),
+    adGroupId: z.string().optional().describe("Ad Group ID (required for ad queries)"),
+    filter: z
+        .record(z.unknown())
+        .optional()
+        .describe("Additional filter fields to pass to the TTD query endpoint"),
+    pageToken: z.string().optional().describe("Page token for pagination (start index)"),
+    pageSize: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(DEFAULT_PAGE_SIZE)
+        .describe(`Number of entities to return per page (default ${DEFAULT_PAGE_SIZE})`),
+})
+    .superRefine((data, ctx) => {
+    if (data.entityType === "advertiser" && !data.partnerId) {
+        ctx.addIssue({
+            code: "custom",
+            message: "partnerId is required when listing advertiser entities",
+            path: ["partnerId"],
+        });
+    }
+    const needsAdvertiser = ["campaign", "adGroup", "creative", "conversionTracker"];
+    if (needsAdvertiser.includes(data.entityType) && !data.advertiserId) {
+        ctx.addIssue({
+            code: "custom",
+            message: `advertiserId is required when listing ${data.entityType} entities`,
+            path: ["advertiserId"],
+        });
+    }
+})
+    .describe("Parameters for listing TTD entities");
+export const ListEntitiesOutputSchema = z
+    .object({
+    entities: z.array(z.record(z.any())).describe("List of entities"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity list result");
+export async function listEntitiesLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const filters = { ...input.filter };
+    if (input.partnerId) {
+        filters.PartnerId = input.partnerId;
+    }
+    if (input.advertiserId) {
+        filters.AdvertiserId = input.advertiserId;
+    }
+    if (input.campaignId) {
+        filters.CampaignId = input.campaignId;
+    }
+    if (input.adGroupId) {
+        filters.AdGroupId = input.adGroupId;
+    }
+    const result = await ttdService.listEntities(input.entityType, filters, input.pageToken, input.pageSize, context);
+    const entities = result.entities;
+    return {
+        entities,
+        pagination: buildPaginationOutput({
+            nextCursor: result.nextPageToken,
+            pageSize: entities.length,
+            nextPageInputKey: "pageToken",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listEntitiesResponseFormatter(result) {
+    const count = result.pagination.pageSize;
+    const summary = `Found ${count} entities`;
+    const entities = count > 0
+        ? `\n\nEntities:\n${JSON.stringify(result.entities, null, 2)}`
+        : "\n\nNo entities found";
+    return [
+        {
+            type: "text",
+            text: `${summary}${entities}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListEntitiesInputSchema,
+    outputSchema: ListEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all campaigns for an advertiser",
+            input: {
+                entityType: "campaign",
+                advertiserId: "adv123abc",
+                pageSize: 50,
+            },
+        },
+        {
+            label: "List ad groups for a specific campaign",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "adv123abc",
+                campaignId: "camp456def",
+                pageSize: 25,
+            },
+        },
+        {
+            label: "List advertisers with pagination",
+            input: {
+                entityType: "advertiser",
+                partnerId: "partner123",
+                pageSize: 20,
+                pageToken: "100",
+            },
+        },
+    ],
+    logic: listEntitiesLogic,
+    responseFormatter: listEntitiesResponseFormatter,
+};
+//# sourceMappingURL=list-entities.tool.js.map

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

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

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

@@ -0,0 +1,282 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const ListReportSchedulesInputSchema: z.ZodObject<{
+    advertiserIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pageStartIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    pageSize: number;
+    pageStartIndex: number;
+    advertiserIds?: string[] | undefined;
+}, {
+    pageSize?: number | undefined;
+    advertiserIds?: string[] | undefined;
+    pageStartIndex?: number | undefined;
+}>;
+export declare const ListReportSchedulesOutputSchema: z.ZodObject<{
+    schedules: z.ZodArray<z.ZodObject<{
+        scheduleId: z.ZodString;
+        name: z.ZodString;
+        platform: z.ZodEnum<["ttd", "meta", "google", "dbm", "cm360", "sa360", "tiktok", "linkedin", "pinterest", "snapchat", "amazonDsp", "microsoft"]>;
+        frequency: z.ZodEnum<["SINGLE_RUN", "DAILY", "WEEKLY", "MONTHLY", "QUARTERLY", "CUSTOM"]>;
+        status: z.ZodEnum<["ACTIVE", "DISABLED"]>;
+        reportType: z.ZodOptional<z.ZodString>;
+        advertiserIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        nextRunAt: z.ZodOptional<z.ZodString>;
+        lastRunAt: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        platformSpecific: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: "ACTIVE" | "DISABLED";
+        platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+        scheduleId: string;
+        frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+        advertiserIds?: string[] | undefined;
+        reportType?: string | undefined;
+        nextRunAt?: string | undefined;
+        lastRunAt?: string | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        platformSpecific?: Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        status: "ACTIVE" | "DISABLED";
+        platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+        scheduleId: string;
+        frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+        advertiserIds?: string[] | undefined;
+        reportType?: string | undefined;
+        nextRunAt?: string | undefined;
+        lastRunAt?: string | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        platformSpecific?: Record<string, unknown> | undefined;
+    }>, "many">;
+    raw: z.ZodOptional<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;
+    };
+    schedules: {
+        name: string;
+        status: "ACTIVE" | "DISABLED";
+        platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+        scheduleId: string;
+        frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+        advertiserIds?: string[] | undefined;
+        reportType?: string | undefined;
+        nextRunAt?: string | undefined;
+        lastRunAt?: string | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        platformSpecific?: Record<string, unknown> | undefined;
+    }[];
+    raw?: Record<string, unknown>[] | undefined;
+}, {
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    schedules: {
+        name: string;
+        status: "ACTIVE" | "DISABLED";
+        platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+        scheduleId: string;
+        frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+        advertiserIds?: string[] | undefined;
+        reportType?: string | undefined;
+        nextRunAt?: string | undefined;
+        lastRunAt?: string | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        platformSpecific?: Record<string, unknown> | undefined;
+    }[];
+    raw?: Record<string, unknown>[] | undefined;
+}>;
+type ListReportSchedulesInput = z.infer<typeof ListReportSchedulesInputSchema>;
+type ListReportSchedulesOutput = z.infer<typeof ListReportSchedulesOutputSchema>;
+export declare function listReportSchedulesLogic(input: ListReportSchedulesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListReportSchedulesOutput>;
+export declare function listReportSchedulesResponseFormatter(result: ListReportSchedulesOutput): McpTextContent[];
+export declare const listReportSchedulesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        advertiserIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pageStartIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        pageSize: number;
+        pageStartIndex: number;
+        advertiserIds?: string[] | undefined;
+    }, {
+        pageSize?: number | undefined;
+        advertiserIds?: string[] | undefined;
+        pageStartIndex?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        schedules: z.ZodArray<z.ZodObject<{
+            scheduleId: z.ZodString;
+            name: z.ZodString;
+            platform: z.ZodEnum<["ttd", "meta", "google", "dbm", "cm360", "sa360", "tiktok", "linkedin", "pinterest", "snapchat", "amazonDsp", "microsoft"]>;
+            frequency: z.ZodEnum<["SINGLE_RUN", "DAILY", "WEEKLY", "MONTHLY", "QUARTERLY", "CUSTOM"]>;
+            status: z.ZodEnum<["ACTIVE", "DISABLED"]>;
+            reportType: z.ZodOptional<z.ZodString>;
+            advertiserIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            nextRunAt: z.ZodOptional<z.ZodString>;
+            lastRunAt: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            platformSpecific: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            status: "ACTIVE" | "DISABLED";
+            platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+            scheduleId: string;
+            frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+            advertiserIds?: string[] | undefined;
+            reportType?: string | undefined;
+            nextRunAt?: string | undefined;
+            lastRunAt?: string | undefined;
+            createdAt?: string | undefined;
+            updatedAt?: string | undefined;
+            platformSpecific?: Record<string, unknown> | undefined;
+        }, {
+            name: string;
+            status: "ACTIVE" | "DISABLED";
+            platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+            scheduleId: string;
+            frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+            advertiserIds?: string[] | undefined;
+            reportType?: string | undefined;
+            nextRunAt?: string | undefined;
+            lastRunAt?: string | undefined;
+            createdAt?: string | undefined;
+            updatedAt?: string | undefined;
+            platformSpecific?: Record<string, unknown> | undefined;
+        }>, "many">;
+        raw: z.ZodOptional<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;
+        };
+        schedules: {
+            name: string;
+            status: "ACTIVE" | "DISABLED";
+            platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+            scheduleId: string;
+            frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+            advertiserIds?: string[] | undefined;
+            reportType?: string | undefined;
+            nextRunAt?: string | undefined;
+            lastRunAt?: string | undefined;
+            createdAt?: string | undefined;
+            updatedAt?: string | undefined;
+            platformSpecific?: Record<string, unknown> | undefined;
+        }[];
+        raw?: Record<string, unknown>[] | undefined;
+    }, {
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        schedules: {
+            name: string;
+            status: "ACTIVE" | "DISABLED";
+            platform: "ttd" | "meta" | "google" | "dbm" | "cm360" | "sa360" | "tiktok" | "linkedin" | "pinterest" | "snapchat" | "amazonDsp" | "microsoft";
+            scheduleId: string;
+            frequency: "SINGLE_RUN" | "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "CUSTOM";
+            advertiserIds?: string[] | undefined;
+            reportType?: string | undefined;
+            nextRunAt?: string | undefined;
+            lastRunAt?: string | undefined;
+            createdAt?: string | undefined;
+            updatedAt?: string | undefined;
+            platformSpecific?: Record<string, unknown> | undefined;
+        }[];
+        raw?: Record<string, unknown>[] | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            advertiserIds?: undefined;
+            pageSize?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            advertiserIds: string[];
+            pageSize: number;
+        };
+    })[];
+    logic: typeof listReportSchedulesLogic;
+    responseFormatter: typeof listReportSchedulesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-report-schedules.tool.d.ts.map

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

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