@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const GetEntityReportTypesInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<["adGroup", "campaign", "advertiser"]>;
+    entityId: z.ZodString;
+    tile: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: "advertiser" | "campaign" | "adGroup";
+    tile: string;
+    entityId: string;
+}, {
+    entityType: "advertiser" | "campaign" | "adGroup";
+    tile: string;
+    entityId: string;
+}>;
+export declare const GetEntityReportTypesOutputSchema: z.ZodObject<{
+    entityType: z.ZodString;
+    entityId: z.ZodString;
+    tile: z.ZodString;
+    reportTypes: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        available: z.ZodBoolean;
+        schedule: z.ZodUnion<[z.ZodBoolean, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        schedule: string | boolean;
+        available: boolean;
+    }, {
+        type: string;
+        schedule: string | boolean;
+        available: boolean;
+    }>, "many">;
+    userErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        field: string;
+    }, {
+        message: string;
+        field: string;
+    }>, "many">>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    tile: string;
+    timestamp: string;
+    entityId: string;
+    reportTypes: {
+        type: string;
+        schedule: string | boolean;
+        available: boolean;
+    }[];
+    userErrors?: {
+        message: string;
+        field: string;
+    }[] | undefined;
+}, {
+    entityType: string;
+    tile: string;
+    timestamp: string;
+    entityId: string;
+    reportTypes: {
+        type: string;
+        schedule: string | boolean;
+        available: boolean;
+    }[];
+    userErrors?: {
+        message: string;
+        field: string;
+    }[] | undefined;
+}>;
+type GetEntityReportTypesInput = z.infer<typeof GetEntityReportTypesInputSchema>;
+type GetEntityReportTypesOutput = z.infer<typeof GetEntityReportTypesOutputSchema>;
+export declare function getEntityReportTypesLogic(input: GetEntityReportTypesInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetEntityReportTypesOutput>;
+export declare function getEntityReportTypesResponseFormatter(result: GetEntityReportTypesOutput): McpTextContent[];
+export declare const getEntityReportTypesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<["adGroup", "campaign", "advertiser"]>;
+        entityId: z.ZodString;
+        tile: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: "advertiser" | "campaign" | "adGroup";
+        tile: string;
+        entityId: string;
+    }, {
+        entityType: "advertiser" | "campaign" | "adGroup";
+        tile: string;
+        entityId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        entityType: z.ZodString;
+        entityId: z.ZodString;
+        tile: z.ZodString;
+        reportTypes: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            available: z.ZodBoolean;
+            schedule: z.ZodUnion<[z.ZodBoolean, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            schedule: string | boolean;
+            available: boolean;
+        }, {
+            type: string;
+            schedule: string | boolean;
+            available: boolean;
+        }>, "many">;
+        userErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            field: string;
+        }, {
+            message: string;
+            field: string;
+        }>, "many">>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        tile: string;
+        timestamp: string;
+        entityId: string;
+        reportTypes: {
+            type: string;
+            schedule: string | boolean;
+            available: boolean;
+        }[];
+        userErrors?: {
+            message: string;
+            field: string;
+        }[] | undefined;
+    }, {
+        entityType: string;
+        tile: string;
+        timestamp: string;
+        entityId: string;
+        reportTypes: {
+            type: string;
+            schedule: string | boolean;
+            available: boolean;
+        }[];
+        userErrors?: {
+            message: string;
+            field: string;
+        }[] | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            entityId: string;
+            tile: string;
+        };
+    }[];
+    logic: typeof getEntityReportTypesLogic;
+    responseFormatter: typeof getEntityReportTypesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-entity-report-types.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-report-types.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity-report-types.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAenF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAc8B,CAAC;AAE3E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBD,CAAC;AAE7C,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA8BrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CA6ClB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCpC,CAAC"}

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

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { throwIfGraphqlErrors } from "../utils/graphql-errors.js";
+const TOOL_NAME = "ttd_get_entity_report_types";
+const TOOL_TITLE = "Get TTD Entity Report Types (GraphQL)";
+const TOOL_DESCRIPTION = `Discover available dimension-specific report types for a TTD entity.
+
+Returns which report types are available for a given entity and Kokai tile,
+and whether each report can be downloaded immediately or requires scheduling.
+
+**tile** is the abbreviation shown in the TTD programmatic table UI (e.g. Ag = Ad Group, Ca = Campaign, Af = Advertiser).
+Common tile abbreviations: Ag (Ad Group), Ca (Campaign), Af (Advertiser).
+
+Use the returned \`type\` values with \`ttd_execute_entity_report\` to generate reports.`;
+export const GetEntityReportTypesInputSchema = z
+    .object({
+    entityType: z
+        .enum(["adGroup", "campaign", "advertiser"])
+        .describe("The type of entity to query report types for"),
+    entityId: z.string().min(1).describe("ID of the entity"),
+    tile: z
+        .string()
+        .min(1)
+        .describe("Kokai tile abbreviation from the TTD programmatic table (e.g. Ag, Ca, Af). " +
+        "Controls which dimension-specific report types are returned."),
+})
+    .describe("Parameters for querying entity report types via TTD GraphQL");
+export const GetEntityReportTypesOutputSchema = z
+    .object({
+    entityType: z.string(),
+    entityId: z.string(),
+    tile: z.string(),
+    reportTypes: z
+        .array(z.object({
+        type: z.string().describe("Report type value to pass to ttd_execute_entity_report"),
+        available: z.boolean().describe("Whether report can be downloaded immediately"),
+        schedule: z
+            .union([z.boolean(), z.string()])
+            .describe("Whether report requires scheduling/email delivery"),
+    }))
+        .describe("Available report types for this entity"),
+    userErrors: z.array(z.object({ field: z.string(), message: z.string() })).optional(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Available entity report types");
+export async function getEntityReportTypesLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const raw = (await ttdService.getEntityReportMetadata(input.entityType, input.entityId, input.tile, context));
+    throwIfGraphqlErrors(raw, "GraphQL error retrieving entity report types");
+    const gqlData = raw.data ?? {};
+    const metadata = gqlData.programmaticTileReportMetadata ?? {};
+    const reportTypes = metadata.data ?? [];
+    const userErrors = metadata.userErrors;
+    return {
+        entityType: input.entityType,
+        entityId: input.entityId,
+        tile: input.tile,
+        reportTypes: reportTypes.map((r) => ({
+            type: r.type,
+            available: r.available,
+            schedule: r.schedule,
+        })),
+        userErrors: userErrors?.length ? userErrors : undefined,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getEntityReportTypesResponseFormatter(result) {
+    if (result.userErrors?.length) {
+        return [
+            {
+                type: "text",
+                text: `Could not retrieve report types:\n\n` +
+                    result.userErrors.map((e) => `- ${e.field}: ${e.message}`).join("\n") +
+                    `\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (result.reportTypes.length === 0) {
+        return [
+            {
+                type: "text",
+                text: `No report types found for ${result.entityType} ${result.entityId} with tile "${result.tile}".\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const available = result.reportTypes.filter((r) => r.available);
+    const scheduled = result.reportTypes.filter((r) => !r.available && r.schedule);
+    const lines = [
+        `Report types for ${result.entityType} ${result.entityId} (tile: ${result.tile}):`,
+        "",
+    ];
+    if (available.length > 0) {
+        lines.push(`**Immediately downloadable** (use ttd_execute_entity_report):`);
+        available.forEach((r) => lines.push(`  - ${r.type}`));
+        lines.push("");
+    }
+    if (scheduled.length > 0) {
+        lines.push(`**Requires scheduling** (email delivery):`);
+        scheduled.forEach((r) => lines.push(`  - ${r.type}`));
+        lines.push("");
+    }
+    lines.push(`Timestamp: ${result.timestamp}`);
+    return [{ type: "text", text: lines.join("\n") }];
+}
+export const getEntityReportTypesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetEntityReportTypesInputSchema,
+    outputSchema: GetEntityReportTypesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Get ad group report types",
+            input: {
+                entityType: "adGroup",
+                entityId: "ag123456",
+                tile: "Ag",
+            },
+        },
+        {
+            label: "Get campaign report types",
+            input: {
+                entityType: "campaign",
+                entityId: "c789012",
+                tile: "Ca",
+            },
+        },
+    ],
+    logic: getEntityReportTypesLogic,
+    responseFormatter: getEntityReportTypesResponseFormatter,
+};
+//# sourceMappingURL=get-entity-report-types.tool.js.map

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

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

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

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityId: z.ZodString;
+    advertiserId: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    adGroupId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+}, {
+    entityType: string;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+}>, {
+    entityType: string;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+}, {
+    entityType: string;
+    entityId: string;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+}>;
+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[]]>;
+        entityId: z.ZodString;
+        advertiserId: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodString>;
+        adGroupId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+    }, {
+        entityType: string;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+    }>, {
+        entityType: string;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+    }, {
+        entityType: string;
+        entityId: string;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+    }>;
+    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;
+            entityId: string;
+            advertiserId: string;
+            campaignId?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            entityId: string;
+            advertiserId: string;
+            campaignId: string;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            entityId: string;
+            advertiserId?: undefined;
+            campaignId?: undefined;
+        };
+    })[];
+    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;AAQnD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBiB,CAAC;AAEnD,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,CAa1B;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,88 @@
+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 = "ttd_get_entity";
+const TOOL_TITLE = "Get TTD Entity";
+const TOOL_DESCRIPTION = `Get a single The Trade Desk entity by ID.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}`;
+export const GetEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to retrieve"),
+    entityId: z.string().min(1).describe("The entity ID to retrieve"),
+    advertiserId: z
+        .string()
+        .optional()
+        .describe("Advertiser ID (required for most non-advertiser entities)"),
+    campaignId: z.string().optional().describe("Campaign ID (required for adGroup)"),
+    adGroupId: z.string().optional().describe("Ad Group ID (required for ad)"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input);
+})
+    .describe("Parameters for getting a TTD 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 { ttdService } = resolveSessionServices(sdkContext);
+    const entity = await ttdService.getEntity(input.entityType, 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",
+                entityId: "camp456def",
+                advertiserId: "adv123abc",
+            },
+        },
+        {
+            label: "Get an ad group by ID",
+            input: {
+                entityType: "adGroup",
+                entityId: "adg111aaa",
+                advertiserId: "adv123abc",
+                campaignId: "camp456def",
+            },
+        },
+        {
+            label: "Get an advertiser by ID",
+            input: {
+                entityType: "advertiser",
+                entityId: "adv123abc",
+            },
+        },
+    ],
+    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-first-party-data-job.tool.d.ts

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const GetFirstPartyDataJobToolInputSchema: z.ZodObject<{
+    advertiserId: z.ZodString;
+    nameFilter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    queryShape: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callbackInput: z.ZodOptional<z.ZodObject<{
+        callbackUrl: z.ZodString;
+        callbackHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, "strip", z.ZodTypeAny, {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    }, {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    advertiserId: string;
+    nameFilter?: string | null | undefined;
+    queryShape?: string | null | undefined;
+    callbackInput?: {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    } | undefined;
+}, {
+    advertiserId: string;
+    nameFilter?: string | null | undefined;
+    queryShape?: string | null | undefined;
+    callbackInput?: {
+        callbackUrl: string;
+        callbackHeaders?: Record<string, string> | null | undefined;
+    } | undefined;
+}>;
+export declare const GetFirstPartyDataJobToolOutputSchema: z.ZodObject<{
+    job: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    job: Record<string, unknown>;
+}, {
+    timestamp: string;
+    job: Record<string, unknown>;
+}>;
+type GetFirstPartyDataJobToolInput = z.infer<typeof GetFirstPartyDataJobToolInputSchema>;
+type GetFirstPartyDataJobToolOutput = z.infer<typeof GetFirstPartyDataJobToolOutputSchema>;
+export declare function getFirstPartyDataJobLogic(input: GetFirstPartyDataJobToolInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetFirstPartyDataJobToolOutput>;
+export declare function getFirstPartyDataJobResponseFormatter(result: GetFirstPartyDataJobToolOutput): McpTextContent[];
+export declare const getFirstPartyDataJobTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        advertiserId: z.ZodString;
+        nameFilter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        queryShape: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callbackInput: z.ZodOptional<z.ZodObject<{
+            callbackUrl: z.ZodString;
+            callbackHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, "strip", z.ZodTypeAny, {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        }, {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        advertiserId: string;
+        nameFilter?: string | null | undefined;
+        queryShape?: string | null | undefined;
+        callbackInput?: {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        } | undefined;
+    }, {
+        advertiserId: string;
+        nameFilter?: string | null | undefined;
+        queryShape?: string | null | undefined;
+        callbackInput?: {
+            callbackUrl: string;
+            callbackHeaders?: Record<string, string> | null | undefined;
+        } | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        job: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        job: Record<string, unknown>;
+    }, {
+        timestamp: string;
+        job: Record<string, unknown>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            advertiserId: string;
+            queryShape: string;
+        };
+    }[];
+    logic: typeof getFirstPartyDataJobLogic;
+    responseFormatter: typeof getFirstPartyDataJobResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-first-party-data-job.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-first-party-data-job.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-first-party-data-job.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-first-party-data-job.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/C,CAAC;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;EAG/C,CAAC;AAEH,KAAK,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AACzF,KAAK,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAE3F,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,8BAA8B,CAAC,CAczC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,8BAA8B,GACrC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBpC,CAAC"}