@cesteral/meta-mcp 1.0.0

package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts

@@ -0,0 +1,274 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetInsightsInputSchema: z.ZodObject<{
+    entityId: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    datePreset: z.ZodOptional<z.ZodString>;
+    timeRange: z.ZodOptional<z.ZodObject<{
+        since: z.ZodString;
+        until: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        since: string;
+        until: string;
+    }, {
+        since: string;
+        until: string;
+    }>>;
+    timeIncrement: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+    includeComputedMetrics: 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"]>>>;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    includeComputedMetrics: boolean;
+    mode: "summary" | "rows";
+    fields?: string[] | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    datePreset?: string | undefined;
+    level?: string | undefined;
+    timeRange?: {
+        since: string;
+        until: string;
+    } | undefined;
+    timeIncrement?: string | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+}, {
+    entityId: string;
+    fields?: string[] | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    datePreset?: string | undefined;
+    level?: string | undefined;
+    timeRange?: {
+        since: string;
+        until: string;
+    } | undefined;
+    timeIncrement?: string | undefined;
+    includeComputedMetrics?: boolean | undefined;
+    mode?: "summary" | "rows" | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+}>;
+export declare const GetInsightsOutputSchema: z.ZodObject<{
+    nextCursor: z.ZodOptional<z.ZodString>;
+    has_more: z.ZodBoolean;
+    summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    totalCount: z.ZodNumber;
+    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, {
+    timestamp: string;
+    mode: "summary" | "rows";
+    has_more: boolean;
+    totalCount: number;
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    headers: string[];
+    selectedColumns: string[];
+    warnings: string[];
+    nextCursor?: string | undefined;
+    summary?: Record<string, any> | undefined;
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+}, {
+    timestamp: string;
+    mode: "summary" | "rows";
+    has_more: boolean;
+    totalCount: number;
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    headers: string[];
+    selectedColumns: string[];
+    warnings: string[];
+    nextCursor?: string | undefined;
+    summary?: Record<string, any> | undefined;
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+}>;
+type GetInsightsInput = z.infer<typeof GetInsightsInputSchema>;
+type GetInsightsOutput = z.infer<typeof GetInsightsOutputSchema>;
+export declare function getInsightsLogic(input: GetInsightsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetInsightsOutput>;
+export declare function getInsightsResponseFormatter(result: GetInsightsOutput): McpTextContent[];
+export declare const getInsightsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityId: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        datePreset: z.ZodOptional<z.ZodString>;
+        timeRange: z.ZodOptional<z.ZodObject<{
+            since: z.ZodString;
+            until: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            since: string;
+            until: string;
+        }, {
+            since: string;
+            until: string;
+        }>>;
+        timeIncrement: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodString>;
+        includeComputedMetrics: 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"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        includeComputedMetrics: boolean;
+        mode: "summary" | "rows";
+        fields?: string[] | undefined;
+        limit?: number | undefined;
+        after?: string | undefined;
+        datePreset?: string | undefined;
+        level?: string | undefined;
+        timeRange?: {
+            since: string;
+            until: string;
+        } | undefined;
+        timeIncrement?: string | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    }, {
+        entityId: string;
+        fields?: string[] | undefined;
+        limit?: number | undefined;
+        after?: string | undefined;
+        datePreset?: string | undefined;
+        level?: string | undefined;
+        timeRange?: {
+            since: string;
+            until: string;
+        } | undefined;
+        timeIncrement?: string | undefined;
+        includeComputedMetrics?: boolean | undefined;
+        mode?: "summary" | "rows" | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        nextCursor: z.ZodOptional<z.ZodString>;
+        has_more: z.ZodBoolean;
+        summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        totalCount: z.ZodNumber;
+        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, {
+        timestamp: string;
+        mode: "summary" | "rows";
+        has_more: boolean;
+        totalCount: number;
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        headers: string[];
+        selectedColumns: string[];
+        warnings: string[];
+        nextCursor?: string | undefined;
+        summary?: Record<string, any> | undefined;
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+    }, {
+        timestamp: string;
+        mode: "summary" | "rows";
+        has_more: boolean;
+        totalCount: number;
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        headers: string[];
+        selectedColumns: string[];
+        warnings: string[];
+        nextCursor?: string | undefined;
+        summary?: Record<string, any> | undefined;
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityId: string;
+            datePreset: string;
+            fields?: undefined;
+            timeRange?: undefined;
+            timeIncrement?: undefined;
+            level?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityId: string;
+            fields: string[];
+            timeRange: {
+                since: string;
+                until: string;
+            };
+            timeIncrement: string;
+            level: string;
+            datePreset?: undefined;
+        };
+    })[];
+    logic: typeof getInsightsLogic;
+    responseFormatter: typeof getInsightsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-insights.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-insights.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-insights.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA2BnD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDoB,CAAC;AAExD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASA,CAAC;AAErC,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEjE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAwE5B;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAYxF;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC3B,CAAC"}

package/dist/mcp-server/tools/definitions/get-insights.tool.js

@@ -0,0 +1,188 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { computeMetrics, createReportView, formatReportViewResponse, getReportViewFetchLimit, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
+const TOOL_NAME = "meta_get_insights";
+const TOOL_TITLE = "Get Meta Ads Insights";
+const TOOL_DESCRIPTION = `Get performance insights for a Meta Ads entity (account, campaign, ad set, or ad).
+
+Uses GET /{entityId}/insights with date presets or custom date ranges.
+
+**Common date presets:** today, yesterday, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, this_week_mon_today, this_week_sun_today, maximum, data_maximum
+
+**Common metrics (fields):** impressions, clicks, spend, cpc, cpm, ctr, reach, frequency, actions, action_values, conversions, cost_per_action_type
+
+**Gotchas:**
+- Data may lag up to 48 hours.
+- Max 37-month date range.
+- Limit ~20 metrics per call for best performance.
+- Use \`time_increment\` for daily/weekly breakdowns (e.g., "1" for daily, "7" for weekly).
+- Use \`level\` to aggregate at different levels (e.g., "campaign", "adset", "ad").`;
+export const GetInsightsInputSchema = z
+    .object({
+    entityId: z
+        .string()
+        .min(1)
+        .describe("Entity ID to get insights for (account act_XXX, campaign, ad set, or ad ID)"),
+    fields: z
+        .array(z.string())
+        .optional()
+        .describe("Metrics/fields to return (defaults to common metrics)"),
+    datePreset: z
+        .string()
+        .optional()
+        .describe("Date preset (today, yesterday, last_7d, last_30d, etc.)"),
+    timeRange: z
+        .object({
+        since: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+            .describe("Start date YYYY-MM-DD"),
+        until: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+            .describe("End date YYYY-MM-DD"),
+    })
+        .optional()
+        .describe("Custom date range (mutually exclusive with datePreset)"),
+    timeIncrement: z
+        .string()
+        .optional()
+        .describe("Time granularity: '1' for daily, '7' for weekly, 'monthly', 'all_days'"),
+    level: z
+        .string()
+        .optional()
+        .describe("Aggregation level: 'account', 'campaign', 'adset', 'ad'"),
+    limit: z
+        .number()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe("Deprecated. Use maxRows for the returned row count."),
+    after: z.string().optional().describe("Cursor for next page"),
+    includeComputedMetrics: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Include computed CPA, ROAS, CPM, CTR, CPC derived from raw metrics"),
+})
+    .merge(ReportViewInputSchema)
+    .describe("Parameters for getting Meta Ads insights");
+export const GetInsightsOutputSchema = z
+    .object({
+    ...ReportViewOutputSchema.shape,
+    nextCursor: z.string().optional().describe("Cursor for next page"),
+    has_more: z.boolean().describe("Whether more results are available via pagination"),
+    summary: z.record(z.any()).optional().describe("Summary statistics"),
+    totalCount: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Insights query result");
+export async function getInsightsLogic(input, context, sdkContext) {
+    const { metaInsightsService } = resolveSessionServices(sdkContext);
+    const viewInput = input.maxRows === undefined && input.limit !== undefined
+        ? { ...input, maxRows: input.limit }
+        : input;
+    const result = await metaInsightsService.getInsights(input.entityId, {
+        fields: input.fields,
+        datePreset: input.datePreset,
+        timeRange: input.timeRange,
+        timeIncrement: input.timeIncrement,
+        level: input.level,
+        limit: getReportViewFetchLimit(viewInput),
+        after: input.after,
+    }, context);
+    let rows = result.data;
+    if (input.includeComputedMetrics) {
+        rows = rows.map((row) => {
+            const cost = Number(row.spend || 0);
+            const impressions = Number(row.impressions || 0);
+            const clicks = Number(row.clicks || 0);
+            const isConversionAction = (actionType) => actionType.startsWith("offsite_conversion") ||
+                actionType === "purchase" ||
+                actionType === "complete_registration" ||
+                actionType === "lead";
+            const conversions = Array.isArray(row.actions)
+                ? row.actions
+                    .filter((a) => isConversionAction(a.action_type ?? ""))
+                    .reduce((sum, a) => sum + Number(a.value || 0), 0)
+                : 0;
+            const conversionValue = Array.isArray(row.action_values)
+                ? row.action_values
+                    .filter((a) => isConversionAction(a.action_type ?? ""))
+                    .reduce((sum, a) => sum + Number(a.value || 0), 0)
+                : 0;
+            return {
+                ...row,
+                computedMetrics: computeMetrics({
+                    cost,
+                    impressions,
+                    clicks,
+                    conversions,
+                    conversionValue,
+                }),
+            };
+        });
+    }
+    return {
+        ...createReportView({
+            rows,
+            totalRows: rows.length + (result.nextCursor ? 1 : 0),
+            input: viewInput,
+            warnings: result.nextCursor
+                ? ["More rows are available. Call again with after set to nextCursor to continue."]
+                : [],
+        }),
+        nextCursor: result.nextCursor,
+        has_more: !!result.nextCursor,
+        summary: result.summary,
+        totalCount: rows.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getInsightsResponseFormatter(result) {
+    const summary = `Retrieved ${result.returnedRows} insight row(s)`;
+    const pagination = result.nextCursor
+        ? `\n\nMore results available. Use after: "${result.nextCursor}"`
+        : "";
+    return [
+        {
+            type: "text",
+            text: `${summary}\n\n${formatReportViewResponse(result, "Insight data")}${pagination}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getInsightsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetInsightsInputSchema,
+    outputSchema: GetInsightsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get last 7 days insights for a campaign",
+            input: {
+                entityId: "23456789012345",
+                datePreset: "last_7d",
+            },
+        },
+        {
+            label: "Get daily insights with custom date range",
+            input: {
+                entityId: "act_123456789",
+                fields: ["impressions", "clicks", "spend", "cpc", "ctr"],
+                timeRange: { since: "2026-01-01", until: "2026-01-31" },
+                timeIncrement: "1",
+                level: "campaign",
+            },
+        },
+    ],
+    logic: getInsightsLogic,
+    responseFormatter: getInsightsResponseFormatter,
+};
+//# sourceMappingURL=get-insights.tool.js.map

package/dist/mcp-server/tools/definitions/get-insights.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext, ToolDefinition } from "@cesteral/shared";
+export declare const GetPacingStatusInputSchema: z.ZodObject<{
+    adAccountId: z.ZodString;
+    campaignId: z.ZodString;
+    spendToDate: z.ZodNumber;
+    budgetTotal: z.ZodNumber;
+    flightStartDate: z.ZodString;
+    flightEndDate: z.ZodString;
+    currency: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    adAccountId: string;
+    campaignId: string;
+    spendToDate: number;
+    budgetTotal: number;
+    flightStartDate: string;
+    flightEndDate: string;
+}, {
+    adAccountId: string;
+    campaignId: string;
+    spendToDate: number;
+    budgetTotal: number;
+    flightStartDate: string;
+    flightEndDate: string;
+    currency?: string | undefined;
+}>;
+export declare const GetPacingStatusOutputSchema: z.ZodObject<{
+    adAccountId: z.ZodString;
+    campaignId: z.ZodString;
+    budget: z.ZodObject<{
+        total: z.ZodNumber;
+        spent: z.ZodNumber;
+        remaining: z.ZodNumber;
+        currency: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    }, {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    }>;
+    flight: z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        daysElapsed: z.ZodNumber;
+        daysRemaining: z.ZodNumber;
+        totalDays: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    }, {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    }>;
+    pacing: z.ZodObject<{
+        expectedSpendPercent: z.ZodNumber;
+        actualSpendPercent: z.ZodNumber;
+        pacingRatio: z.ZodNumber;
+        status: z.ZodEnum<["ON_PACE", "AHEAD", "BEHIND", "SEVERELY_BEHIND"]>;
+        projectedEndSpend: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    }, {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    adAccountId: string;
+    timestamp: string;
+    campaignId: string;
+    budget: {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    };
+    flight: {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    };
+    pacing: {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    };
+}, {
+    adAccountId: string;
+    timestamp: string;
+    campaignId: string;
+    budget: {
+        currency: string;
+        total: number;
+        spent: number;
+        remaining: number;
+    };
+    flight: {
+        startDate: string;
+        endDate: string;
+        daysElapsed: number;
+        daysRemaining: number;
+        totalDays: number;
+    };
+    pacing: {
+        status: "ON_PACE" | "AHEAD" | "BEHIND" | "SEVERELY_BEHIND";
+        expectedSpendPercent: number;
+        actualSpendPercent: number;
+        pacingRatio: number;
+        projectedEndSpend: number;
+    };
+}>;
+export type GetPacingStatusInput = z.infer<typeof GetPacingStatusInputSchema>;
+export type GetPacingStatusOutput = z.infer<typeof GetPacingStatusOutputSchema>;
+export declare function getPacingStatusLogic(input: GetPacingStatusInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<GetPacingStatusOutput>;
+export declare function getPacingStatusResponseFormatter(result: GetPacingStatusOutput, _input: GetPacingStatusInput): McpTextContent[];
+export declare const getPacingStatusTool: ToolDefinition<typeof GetPacingStatusInputSchema, typeof GetPacingStatusOutputSchema>;
+//# sourceMappingURL=get-pacing-status.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pacing-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-pacing-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAUnE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;EAgBsB,CAAC;AAK9D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BI,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAKhF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,qBAAqB,CAAC,CAiChC;AAKD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,oBAAoB,GAC3B,cAAc,EAAE,CAkClB;AAKD,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAC9C,OAAO,0BAA0B,EACjC,OAAO,2BAA2B,CAyCnC,CAAC"}