@cesteral/cm360-mcp 1.0.0

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

@@ -0,0 +1,177 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListEntitiesInputSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    profileId: string;
+    pageToken?: string | undefined;
+    maxResults?: number | undefined;
+    filters?: Record<string, unknown> | undefined;
+}, {
+    entityType: string;
+    profileId: string;
+    pageToken?: string | undefined;
+    maxResults?: number | undefined;
+    filters?: Record<string, unknown> | 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.ZodObject<{
+        profileId: z.ZodString;
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        pageToken: z.ZodOptional<z.ZodString>;
+        maxResults: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        profileId: string;
+        pageToken?: string | undefined;
+        maxResults?: number | undefined;
+        filters?: Record<string, unknown> | undefined;
+    }, {
+        entityType: string;
+        profileId: string;
+        pageToken?: string | undefined;
+        maxResults?: number | undefined;
+        filters?: Record<string, unknown> | 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: {
+            profileId: string;
+            entityType: string;
+            maxResults: number;
+            filters?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            profileId: string;
+            entityType: string;
+            filters: {
+                campaignIds: string;
+                advertiserId?: undefined;
+            };
+            maxResults: number;
+        };
+    } | {
+        label: string;
+        input: {
+            profileId: string;
+            entityType: string;
+            filters: {
+                advertiserId: string;
+                campaignIds?: undefined;
+            };
+            maxResults?: 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;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAkBgB,CAAC;AAErD,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,CAsB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAc1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC5B,CAAC"}

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

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+const TOOL_NAME = "cm360_list_entities";
+const TOOL_TITLE = "List CM360 Entities";
+const TOOL_DESCRIPTION = `List Campaign Manager 360 entities with optional filtering and pagination.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+All operations require a profileId (use cm360_list_user_profiles to discover yours).`;
+export const ListEntitiesInputSchema = z
+    .object({
+    profileId: z.string().min(1).describe("CM360 User Profile ID"),
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to list"),
+    filters: z
+        .record(z.unknown())
+        .optional()
+        .describe("Filter fields to pass as query parameters (e.g., advertiserId, campaignId, searchString)"),
+    pageToken: z.string().optional().describe("Page token for pagination"),
+    maxResults: z
+        .number()
+        .min(1)
+        .max(1000)
+        .optional()
+        .describe("Maximum number of results per page"),
+})
+    .describe("Parameters for listing CM360 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 { cm360Service } = resolveSessionServices(sdkContext);
+    const result = await cm360Service.listEntities(input.entityType, input.profileId, input.filters, input.pageToken, input.maxResults, 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: true,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List campaigns for a profile",
+            input: {
+                profileId: "123456",
+                entityType: "campaign",
+                maxResults: 50,
+            },
+        },
+        {
+            label: "List placements filtered by campaign",
+            input: {
+                profileId: "123456",
+                entityType: "placement",
+                filters: { campaignIds: "789012" },
+                maxResults: 25,
+            },
+        },
+        {
+            label: "List floodlight activities",
+            input: {
+                profileId: "123456",
+                entityType: "floodlightActivity",
+                filters: { advertiserId: "456789" },
+            },
+        },
+    ],
+    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,275 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
+export declare const ListReportSchedulesInputSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    profileId: string;
+    pageToken?: string | undefined;
+    maxResults?: number | undefined;
+}, {
+    profileId: string;
+    pageToken?: string | undefined;
+    maxResults?: 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<{
+        profileId: z.ZodString;
+        maxResults: z.ZodOptional<z.ZodNumber>;
+        pageToken: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        profileId: string;
+        pageToken?: string | undefined;
+        maxResults?: number | undefined;
+    }, {
+        profileId: string;
+        pageToken?: string | undefined;
+        maxResults?: 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: {
+            profileId: string;
+        };
+    }[];
+    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;AAQnF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAYiB,CAAC;AAE7D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYkC,CAAC;AAE/E,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,CAsBpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAgBlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBnC,CAAC"}

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

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { fromCm360Schedule, ReportScheduleSummarySchema, PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+const TOOL_NAME = "cm360_list_report_schedules";
+const TOOL_TITLE = "List CM360 Report Schedules";
+const TOOL_DESCRIPTION = `List CM360 reports that have an active schedule.
+
+Returns canonical ReportScheduleSummary entries for reports in the profile that contain an active schedule object. The original CM360 report envelopes are preserved on the sibling \`raw\` field for platform-specific debugging. Use a returned schedule's \`scheduleId\` as the handle for cm360_delete_report_schedule.`;
+export const ListReportSchedulesInputSchema = z
+    .object({
+    profileId: z.string().min(1).describe("CM360 User Profile ID"),
+    maxResults: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .optional()
+        .describe("Maximum number of reports to return (default: all)"),
+    pageToken: z.string().optional().describe("Pagination token from a previous response"),
+})
+    .describe("Parameters for listing CM360 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 CM360 report envelopes (kept for platform-specific debugging)"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("List of scheduled reports (normalized to ReportScheduleSummary)");
+export async function listReportSchedulesLogic(input, context, sdkContext) {
+    const { cm360ReportingService } = resolveSessionServices(sdkContext);
+    const result = await cm360ReportingService.listReportSchedules(input.profileId, { maxResults: input.maxResults, pageToken: input.pageToken }, context);
+    const rawReports = result.reports;
+    const schedules = rawReports.map((r) => fromCm360Schedule(r));
+    return {
+        schedules,
+        raw: rawReports,
+        pagination: buildPaginationOutput({
+            nextCursor: result.nextPageToken,
+            pageSize: schedules.length,
+            nextPageInputKey: "pageToken",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listReportSchedulesResponseFormatter(result) {
+    if (result.schedules.length === 0) {
+        return [
+            {
+                type: "text",
+                text: `No scheduled reports found.${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `${result.pagination.pageSize} scheduled report(s):\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: true,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all scheduled reports for a profile",
+            input: {
+                profileId: "123456",
+            },
+        },
+    ],
+    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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"}