@cesteral/gads-mcp 1.0.0

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

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    entityId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}>, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}>;
+export declare const GetEntityOutputSchema: z.ZodObject<{
+    entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    entity: Record<string, any>;
+}, {
+    timestamp: string;
+    entity: Record<string, any>;
+}>;
+type GetEntityInput = z.infer<typeof GetEntityInputSchema>;
+type GetEntityOutput = z.infer<typeof GetEntityOutputSchema>;
+export declare function getEntityLogic(input: GetEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetEntityOutput>;
+export declare function getEntityResponseFormatter(result: GetEntityOutput): McpTextContent[];
+export declare const getEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        entityId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }>, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            entityId: string;
+        };
+    }[];
+    logic: typeof getEntityLogic;
+    responseFormatter: typeof getEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAYnD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;EAawB,CAAC;AAE1D,eAAO,MAAM,qBAAqB;;;;;;;;;EAKI,CAAC;AAEvC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCzB,CAAC"}

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

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue } from "../utils/parent-id-validation.js";
+const TOOL_NAME = "gads_get_entity";
+const TOOL_TITLE = "Get Google Ads Entity";
+const TOOL_DESCRIPTION = `Get a single Google Ads entity by type and ID using a GAQL query.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Returns all default fields for the entity type. Use \`gads_gaql_search\` for custom field selection.
+
+**Note on entity IDs:** For \`ad\` entities, use the ad's simple ID. For \`keyword\` entities, use the criterion ID. GAQL queries filter by the simple ID field, so composite IDs are not needed for reads.`;
+export const GetEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to retrieve"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    entityId: z.string().min(1).describe("The entity ID to retrieve"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input);
+})
+    .describe("Parameters for getting a Google Ads entity");
+export const GetEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Retrieved entity data"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity retrieval result");
+export async function getEntityLogic(input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const entity = await gadsService.getEntity(input.entityType, input.customerId, input.entityId, context);
+    return {
+        entity: entity,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Entity retrieved\n${JSON.stringify(result.entity, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetEntityInputSchema,
+    outputSchema: GetEntityOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Get a campaign by ID",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                entityId: "9876543210",
+            },
+        },
+        {
+            label: "Get an ad group by ID",
+            input: {
+                entityType: "adGroup",
+                customerId: "1234567890",
+                entityId: "1122334455",
+            },
+        },
+        {
+            label: "Get a keyword by criterion ID",
+            input: {
+                entityType: "keyword",
+                customerId: "1234567890",
+                entityId: "6677889900",
+            },
+        },
+    ],
+    logic: getEntityLogic,
+    responseFormatter: getEntityResponseFormatter,
+};
+//# sourceMappingURL=get-entity.tool.js.map

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

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

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

@@ -0,0 +1,382 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetInsightsInputSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    customerId: z.ZodString;
+    entityType: z.ZodEnum<["campaign", "adGroup", "ad", "keyword"]>;
+    entityId: z.ZodOptional<z.ZodString>;
+    dateRange: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    includeComputedMetrics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+} & {
+    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, {
+    customerId: string;
+    entityType: "campaign" | "adGroup" | "ad" | "keyword";
+    mode: "summary" | "rows";
+    includeComputedMetrics: boolean;
+    entityId?: string | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    limit?: number | undefined;
+}, {
+    customerId: string;
+    entityType: "campaign" | "adGroup" | "ad" | "keyword";
+    entityId?: string | 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;
+    dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    includeComputedMetrics?: boolean | undefined;
+    limit?: number | undefined;
+}>, {
+    customerId: string;
+    entityType: "campaign" | "adGroup" | "ad" | "keyword";
+    mode: "summary" | "rows";
+    includeComputedMetrics: boolean;
+    entityId?: string | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    limit?: number | undefined;
+}, {
+    customerId: string;
+    entityType: "campaign" | "adGroup" | "ad" | "keyword";
+    entityId?: string | 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;
+    dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    includeComputedMetrics?: boolean | undefined;
+    limit?: number | undefined;
+}>, {
+    customerId: string;
+    entityType: "campaign" | "adGroup" | "ad" | "keyword";
+    mode: "summary" | "rows";
+    includeComputedMetrics: boolean;
+    entityId?: string | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    limit?: number | undefined;
+}, {
+    customerId: string;
+    entityType: "campaign" | "adGroup" | "ad" | "keyword";
+    entityId?: string | 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;
+    dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    includeComputedMetrics?: boolean | undefined;
+    limit?: number | undefined;
+}>;
+export declare const GetInsightsOutputSchema: z.ZodObject<{
+    totalResults: z.ZodNumber;
+    dateRange: z.ZodString;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    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, {
+    mode: "summary" | "rows";
+    timestamp: string;
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    headers: string[];
+    selectedColumns: string[];
+    warnings: string[];
+    dateRange: string;
+    totalResults: number;
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, {
+    mode: "summary" | "rows";
+    timestamp: string;
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    headers: string[];
+    selectedColumns: string[];
+    warnings: string[];
+    dateRange: string;
+    totalResults: number;
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+    startDate?: string | undefined;
+    endDate?: string | 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.ZodEffects<z.ZodEffects<z.ZodObject<{
+        customerId: z.ZodString;
+        entityType: z.ZodEnum<["campaign", "adGroup", "ad", "keyword"]>;
+        entityId: z.ZodOptional<z.ZodString>;
+        dateRange: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        includeComputedMetrics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    } & {
+        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, {
+        customerId: string;
+        entityType: "campaign" | "adGroup" | "ad" | "keyword";
+        mode: "summary" | "rows";
+        includeComputedMetrics: boolean;
+        entityId?: string | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+        dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        limit?: number | undefined;
+    }, {
+        customerId: string;
+        entityType: "campaign" | "adGroup" | "ad" | "keyword";
+        entityId?: string | 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;
+        dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        includeComputedMetrics?: boolean | undefined;
+        limit?: number | undefined;
+    }>, {
+        customerId: string;
+        entityType: "campaign" | "adGroup" | "ad" | "keyword";
+        mode: "summary" | "rows";
+        includeComputedMetrics: boolean;
+        entityId?: string | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+        dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        limit?: number | undefined;
+    }, {
+        customerId: string;
+        entityType: "campaign" | "adGroup" | "ad" | "keyword";
+        entityId?: string | 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;
+        dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        includeComputedMetrics?: boolean | undefined;
+        limit?: number | undefined;
+    }>, {
+        customerId: string;
+        entityType: "campaign" | "adGroup" | "ad" | "keyword";
+        mode: "summary" | "rows";
+        includeComputedMetrics: boolean;
+        entityId?: string | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+        dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        limit?: number | undefined;
+    }, {
+        customerId: string;
+        entityType: "campaign" | "adGroup" | "ad" | "keyword";
+        entityId?: string | 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;
+        dateRange?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        includeComputedMetrics?: boolean | undefined;
+        limit?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        totalResults: z.ZodNumber;
+        dateRange: z.ZodString;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        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, {
+        mode: "summary" | "rows";
+        timestamp: string;
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        headers: string[];
+        selectedColumns: string[];
+        warnings: string[];
+        dateRange: string;
+        totalResults: number;
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }, {
+        mode: "summary" | "rows";
+        timestamp: string;
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        headers: string[];
+        selectedColumns: string[];
+        warnings: string[];
+        dateRange: string;
+        totalResults: number;
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            customerId: string;
+            entityType: string;
+            dateRange: string;
+            limit?: undefined;
+            startDate?: undefined;
+            endDate?: undefined;
+            includeComputedMetrics?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            customerId: string;
+            entityType: string;
+            dateRange: string;
+            limit: number;
+            startDate?: undefined;
+            endDate?: undefined;
+            includeComputedMetrics?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            customerId: string;
+            entityType: string;
+            startDate: string;
+            endDate: string;
+            includeComputedMetrics: boolean;
+            dateRange?: undefined;
+            limit?: 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;AAWxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA6DnD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8EkC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASU,CAAC;AAE/C,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAuCjE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA0C5B;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAOxF;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C3B,CAAC"}