@cesteral/ttd-mcp 1.0.0

package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { throwIfGraphqlErrors } from "../utils/graphql-errors.js";
+const TOOL_NAME = "ttd_cancel_report_execution";
+const TOOL_TITLE = "Cancel TTD Report Execution (GraphQL)";
+const TOOL_DESCRIPTION = `Cancel an in-progress TTD report execution via GraphQL (\`myReportsReportExecutionCancel\`).
+
+Use this to stop a report that is currently generating. Only reports in the \`IN_PROGRESS\` state can be cancelled.
+
+**Important distinctions:**
+- This tool cancels a **report execution** (an in-progress run), not a report schedule
+- The \`executionId\` is distinct from a schedule ID — use \`ttd_list_report_schedules\` or execution history to find execution IDs
+- To delete a schedule entirely, use \`ttd_delete_report_schedule\` instead
+- Cancelled report executions remain accessible; only the generation process is stopped
+
+**Workflow:**
+1. Identify the \`executionId\` of the in-progress report you want to cancel
+2. Call this tool with the execution ID
+3. Check \`isCancelled\` in the response to confirm the cancellation succeeded`;
+export const CancelReportExecutionInputSchema = z
+    .object({
+    executionId: z.string().min(1).describe("Execution ID of the in-progress report to cancel"),
+})
+    .describe("Parameters for cancelling a TTD report execution");
+export const CancelReportExecutionOutputSchema = z
+    .object({
+    executionId: z.string().describe("Execution ID echoed from input"),
+    isCancelled: z
+        .boolean()
+        .optional()
+        .describe("Whether the execution was successfully cancelled"),
+    errors: z
+        .array(z.object({ field: z.string().optional(), message: z.string() }))
+        .optional()
+        .describe("Mutation errors from TTD"),
+    rawResponse: z.record(z.unknown()).optional(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Result of report execution cancellation");
+const CANCEL_REPORT_EXECUTION_MUTATION = `mutation CancelReportExecution($input: MyReportsReportExecutionCancelInput!) {
+  myReportsReportExecutionCancel(input: $input) {
+    data {
+      isCancelled
+    }
+    errors {
+      __typename
+      ... on MutationError {
+        field
+        message
+      }
+    }
+  }
+}`;
+export async function cancelReportExecutionLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const variables = {
+        input: {
+            executionId: input.executionId,
+        },
+    };
+    const raw = (await ttdService.graphqlQuery(CANCEL_REPORT_EXECUTION_MUTATION, variables, context));
+    throwIfGraphqlErrors(raw, "GraphQL error cancelling report execution");
+    const gqlData = raw.data ?? {};
+    const mutationResult = gqlData.myReportsReportExecutionCancel ?? {};
+    const executionData = mutationResult.data ?? {};
+    const errors = mutationResult.errors;
+    return {
+        executionId: input.executionId,
+        isCancelled: executionData.isCancelled,
+        errors: errors?.length ? errors : undefined,
+        rawResponse: raw,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function cancelReportExecutionResponseFormatter(result) {
+    if (result.errors?.length) {
+        return [
+            {
+                type: "text",
+                text: `Report execution cancellation failed:\n\n` +
+                    result.errors.map((e) => `- ${e.field ? `${e.field}: ` : ""}${e.message}`).join("\n") +
+                    `\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (result.isCancelled === true) {
+        return [
+            {
+                type: "text",
+                text: `Report execution \`${result.executionId}\` was successfully cancelled.\n\n` +
+                    `Timestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (result.isCancelled === false) {
+        return [
+            {
+                type: "text",
+                text: `Report execution \`${result.executionId}\` could not be cancelled (may have already completed or been cancelled).\n\n` +
+                    `Timestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Report execution cancellation result:\n\n${JSON.stringify(result.rawResponse, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const cancelReportExecutionTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: CancelReportExecutionInputSchema,
+    outputSchema: CancelReportExecutionOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Cancel an in-progress report execution",
+            input: {
+                executionId: "exec-abc123",
+            },
+        },
+    ],
+    logic: cancelReportExecutionLogic,
+    responseFormatter: cancelReportExecutionResponseFormatter,
+};
+//# sourceMappingURL=cancel-report-execution.tool.js.map

package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-report-execution.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/cancel-report-execution.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAChD,MAAM,UAAU,GAAG,uCAAuC,CAAC;AAC3D,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;+EAasD,CAAC;AAEhF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAC5F,CAAC;KACD,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC;KAC/C,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAClE,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SACtE,QAAQ,EAAE;SACV,QAAQ,CAAC,0BAA0B,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,yCAAyC,CAAC,CAAC;AAKvD,MAAM,gCAAgC,GAAG;;;;;;;;;;;;;EAavC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAiC,EACjC,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE1D,MAAM,SAAS,GAAG;QAChB,KAAK,EAAE;YACL,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B;KACF,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,MAAM,UAAU,CAAC,YAAY,CACxC,gCAAgC,EAChC,SAAS,EACT,OAAO,CACR,CAA4B,CAAC;IAE9B,oBAAoB,CAAC,GAAG,EAAE,2CAA2C,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAI,GAAG,CAAC,IAA4C,IAAI,EAAE,CAAC;IACxE,MAAM,cAAc,GACjB,OAAO,CAAC,8BAAsE,IAAI,EAAE,CAAC;IACxF,MAAM,aAAa,GAAI,cAAc,CAAC,IAA4C,IAAI,EAAE,CAAC;IACzF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAgE,CAAC;IAE/F,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,aAAa,CAAC,WAAkC;QAC7D,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAC3C,WAAW,EAAE,GAA8B;QAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,MAAmC;IAEnC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,2CAA2C;oBAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrF,kBAAkB,MAAM,CAAC,SAAS,EAAE;aACvC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,sBAAsB,MAAM,CAAC,WAAW,oCAAoC;oBAC5E,cAAc,MAAM,CAAC,SAAS,EAAE;aACnC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QACjC,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,sBAAsB,MAAM,CAAC,WAAW,+EAA+E;oBACvH,cAAc,MAAM,CAAC,SAAS,EAAE;aACnC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,4CAA4C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAClI;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gCAAgC;IAC7C,YAAY,EAAE,iCAAiC;IAC/C,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,wCAAwC;YAC/C,KAAK,EAAE;gBACL,WAAW,EAAE,aAAa;aAC3B;SACF;KACF;IACD,KAAK,EAAE,0BAA0B;IACjC,iBAAiB,EAAE,sCAAsC;CAC1D,CAAC"}

package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const CheckReportStatusInputSchema: z.ZodObject<{
+    reportScheduleId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reportScheduleId: string;
+}, {
+    reportScheduleId: string;
+}>;
+export declare const CheckReportStatusOutputSchema: z.ZodObject<{
+    state: z.ZodEnum<["pending", "running", "complete", "failed", "cancelled"]>;
+    progress: z.ZodOptional<z.ZodNumber>;
+    downloadUrl: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    submittedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+} & {
+    reportScheduleId: z.ZodString;
+    isComplete: z.ZodBoolean;
+    execution: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reportScheduleId: string;
+    state: "pending" | "running" | "complete" | "failed" | "cancelled";
+    execution: Record<string, any>;
+    timestamp: string;
+    isComplete: boolean;
+    errors?: string[] | undefined;
+    downloadUrl?: string | undefined;
+    progress?: number | undefined;
+    submittedAt?: string | undefined;
+    completedAt?: string | undefined;
+}, {
+    reportScheduleId: string;
+    state: "pending" | "running" | "complete" | "failed" | "cancelled";
+    execution: Record<string, any>;
+    timestamp: string;
+    isComplete: boolean;
+    errors?: string[] | undefined;
+    downloadUrl?: string | undefined;
+    progress?: number | undefined;
+    submittedAt?: string | undefined;
+    completedAt?: string | undefined;
+}>;
+type CheckReportStatusInput = z.infer<typeof CheckReportStatusInputSchema>;
+type CheckReportStatusOutput = z.infer<typeof CheckReportStatusOutputSchema>;
+export declare function checkReportStatusLogic(input: CheckReportStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<CheckReportStatusOutput>;
+export declare function checkReportStatusResponseFormatter(result: CheckReportStatusOutput): McpTextContent[];
+export declare const checkReportStatusTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        reportScheduleId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reportScheduleId: string;
+    }, {
+        reportScheduleId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        state: z.ZodEnum<["pending", "running", "complete", "failed", "cancelled"]>;
+        progress: z.ZodOptional<z.ZodNumber>;
+        downloadUrl: z.ZodOptional<z.ZodString>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        submittedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+    } & {
+        reportScheduleId: z.ZodString;
+        isComplete: z.ZodBoolean;
+        execution: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reportScheduleId: string;
+        state: "pending" | "running" | "complete" | "failed" | "cancelled";
+        execution: Record<string, any>;
+        timestamp: string;
+        isComplete: boolean;
+        errors?: string[] | undefined;
+        downloadUrl?: string | undefined;
+        progress?: number | undefined;
+        submittedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }, {
+        reportScheduleId: string;
+        state: "pending" | "running" | "complete" | "failed" | "cancelled";
+        execution: Record<string, any>;
+        timestamp: string;
+        isComplete: boolean;
+        errors?: string[] | undefined;
+        downloadUrl?: string | undefined;
+        progress?: number | undefined;
+        submittedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            reportScheduleId: string;
+        };
+    }[];
+    logic: typeof checkReportStatusLogic;
+    responseFormatter: typeof checkReportStatusResponseFormatter;
+};
+export {};
+//# sourceMappingURL=check-report-status.tool.d.ts.map

package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-report-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/check-report-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAYnD,eAAO,MAAM,4BAA4B;;;;;;EAIe,CAAC;AAEzD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKD,CAAC;AAE1C,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAC3E,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE7E,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,uBAAuB,GAC9B,cAAc,EAAE,CAkClB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBjC,CAAC"}

package/dist/mcp-server/tools/definitions/check-report-status.tool.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { fromTtdStatus, ReportStatusSchema } from "@cesteral/shared";
+const TOOL_NAME = "ttd_check_report_status";
+const TOOL_TITLE = "Check TTD Report Status";
+const TOOL_DESCRIPTION = `Check the status of a previously submitted TTD report.
+
+Makes a single API call to check execution state. Does not poll or wait.
+
+**States** (canonical): \`pending\`, \`running\`, \`complete\`, \`failed\`, \`cancelled\`
+- If \`complete\` with a \`downloadUrl\`, use \`ttd_download_report\` to fetch results.
+- If not complete, call this tool again in 5-10 seconds.`;
+export const CheckReportStatusInputSchema = z
+    .object({
+    reportScheduleId: z.string().min(1).describe("Report schedule ID from ttd_submit_report"),
+})
+    .describe("Parameters for checking TTD report status");
+export const CheckReportStatusOutputSchema = ReportStatusSchema.extend({
+    reportScheduleId: z.string().describe("Report schedule ID"),
+    isComplete: z.boolean().describe("Whether the report is complete"),
+    execution: z.record(z.any()).describe("Full execution details"),
+    timestamp: z.string().datetime(),
+}).describe("Report status check result");
+export async function checkReportStatusLogic(input, context, sdkContext) {
+    const { ttdReportingService } = resolveSessionServices(sdkContext);
+    const result = await ttdReportingService.checkReportExecution(input.reportScheduleId, context);
+    const canonical = fromTtdStatus({
+        ExecutionState: result.state,
+        ReportDownloadUrl: result.downloadUrl,
+    });
+    return {
+        ...canonical,
+        reportScheduleId: result.reportScheduleId,
+        isComplete: canonical.state === "complete",
+        execution: result.execution,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function checkReportStatusResponseFormatter(result) {
+    if (result.isComplete && result.downloadUrl) {
+        return [
+            {
+                type: "text",
+                text: `Report complete: ${result.reportScheduleId}\n\nDownload URL: ${result.downloadUrl}\n\nUse \`ttd_download_report\` with this URL to fetch a bounded summary or paged row slice.\n\nExecution details:\n${JSON.stringify(result.execution, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (result.isComplete) {
+        return [
+            {
+                type: "text",
+                text: `Report complete: ${result.reportScheduleId}\n\nNo download URL available.\n\nExecution details:\n${JSON.stringify(result.execution, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (result.state === "failed") {
+        return [
+            {
+                type: "text",
+                text: `Report failed: ${result.reportScheduleId}\n\nExecution details:\n${JSON.stringify(result.execution, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Report in progress: ${result.reportScheduleId}\nState: ${result.state}\n\nCall \`ttd_check_report_status\` again in 5-10 seconds.\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const checkReportStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: CheckReportStatusInputSchema,
+    outputSchema: CheckReportStatusOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Check report status",
+            input: {
+                reportScheduleId: "abc123-def456",
+            },
+        },
+    ],
+    logic: checkReportStatusLogic,
+    responseFormatter: checkReportStatusResponseFormatter,
+};
+//# sourceMappingURL=check-report-status.tool.js.map

package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-report-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/check-report-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAIrE,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAC7C,MAAM,gBAAgB,GAAG;;;;;;yDAMgC,CAAC;AAE1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC1F,CAAC;KACD,QAAQ,CAAC,2CAA2C,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACrE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC3D,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;AAK1C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA6B,EAC7B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,mBAAmB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE/F,MAAM,SAAS,GAAG,aAAa,CAAC;QAC9B,cAAc,EAAE,MAAM,CAAC,KAAK;QAC5B,iBAAiB,EAAE,MAAM,CAAC,WAAW;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,SAAS;QACZ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,SAAS,CAAC,KAAK,KAAK,UAAU;QAC1C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,MAA+B;IAE/B,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,oBAAoB,MAAM,CAAC,gBAAgB,qBAAqB,MAAM,CAAC,WAAW,uHAAuH,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;aAC7R;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,oBAAoB,MAAM,CAAC,gBAAgB,yDAAyD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;aACxL;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,kBAAkB,MAAM,CAAC,gBAAgB,2BAA2B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;aACxJ;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,uBAAuB,MAAM,CAAC,gBAAgB,YAAY,MAAM,CAAC,KAAK,6EAA6E,MAAM,CAAC,SAAS,EAAE;SAC5K;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,4BAA4B;IACzC,YAAY,EAAE,6BAA6B;IAC3C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,qBAAqB;YAC5B,KAAK,EAAE;gBACL,gBAAgB,EAAE,eAAe;aAClC;SACF;KACF;IACD,KAAK,EAAE,sBAAsB;IAC7B,iBAAiB,EAAE,kCAAkC;CACtD,CAAC"}

package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.d.ts

@@ -0,0 +1,181 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const CreateAdGroupWorkflowToolInputSchema: z.ZodObject<{
+    primaryInput: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        isEnabled: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodOptional<z.ZodString>;
+        marketType: z.ZodOptional<z.ZodString>;
+        budget: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        audienceTargeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodOptional<z.ZodString>;
+        isEnabled: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodOptional<z.ZodString>;
+        marketType: z.ZodOptional<z.ZodString>;
+        budget: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        audienceTargeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodOptional<z.ZodString>;
+        isEnabled: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodOptional<z.ZodString>;
+        marketType: z.ZodOptional<z.ZodString>;
+        budget: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        audienceTargeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    campaignId: z.ZodNullable<z.ZodString>;
+    advancedInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    campaignId: string | null;
+    primaryInput: {
+        campaignId?: string | null | undefined;
+        name?: string | undefined;
+        isEnabled?: boolean | undefined;
+        description?: string | undefined;
+        channel?: string | undefined;
+        marketType?: string | undefined;
+        budget?: Record<string, any> | undefined;
+        audienceTargeting?: Record<string, any> | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    advancedInput?: Record<string, any> | undefined;
+    validateInputOnly?: boolean | null | undefined;
+}, {
+    campaignId: string | null;
+    primaryInput: {
+        campaignId?: string | null | undefined;
+        name?: string | undefined;
+        isEnabled?: boolean | undefined;
+        description?: string | undefined;
+        channel?: string | undefined;
+        marketType?: string | undefined;
+        budget?: Record<string, any> | undefined;
+        audienceTargeting?: Record<string, any> | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    advancedInput?: Record<string, any> | undefined;
+    validateInputOnly?: boolean | null | undefined;
+}>;
+export declare const CreateAdGroupWorkflowToolOutputSchema: z.ZodObject<{
+    adGroup: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    adGroup: Record<string, unknown>;
+}, {
+    timestamp: string;
+    adGroup: Record<string, unknown>;
+}>;
+type CreateAdGroupWorkflowToolInput = z.infer<typeof CreateAdGroupWorkflowToolInputSchema>;
+type CreateAdGroupWorkflowToolOutput = z.infer<typeof CreateAdGroupWorkflowToolOutputSchema>;
+export declare function createAdGroupWorkflowLogic(input: CreateAdGroupWorkflowToolInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateAdGroupWorkflowToolOutput>;
+export declare function createAdGroupWorkflowResponseFormatter(result: CreateAdGroupWorkflowToolOutput): McpTextContent[];
+export declare const createAdGroupWorkflowTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        primaryInput: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            isEnabled: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+            campaignId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            channel: z.ZodOptional<z.ZodString>;
+            marketType: z.ZodOptional<z.ZodString>;
+            budget: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            audienceTargeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodOptional<z.ZodString>;
+            isEnabled: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+            campaignId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            channel: z.ZodOptional<z.ZodString>;
+            marketType: z.ZodOptional<z.ZodString>;
+            budget: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            audienceTargeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodOptional<z.ZodString>;
+            isEnabled: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+            campaignId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            channel: z.ZodOptional<z.ZodString>;
+            marketType: z.ZodOptional<z.ZodString>;
+            budget: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            audienceTargeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.ZodTypeAny, "passthrough">>;
+        campaignId: z.ZodNullable<z.ZodString>;
+        advancedInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        validateInputOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        campaignId: string | null;
+        primaryInput: {
+            campaignId?: string | null | undefined;
+            name?: string | undefined;
+            isEnabled?: boolean | undefined;
+            description?: string | undefined;
+            channel?: string | undefined;
+            marketType?: string | undefined;
+            budget?: Record<string, any> | undefined;
+            audienceTargeting?: Record<string, any> | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }, {
+        campaignId: string | null;
+        primaryInput: {
+            campaignId?: string | null | undefined;
+            name?: string | undefined;
+            isEnabled?: boolean | undefined;
+            description?: string | undefined;
+            channel?: string | undefined;
+            marketType?: string | undefined;
+            budget?: Record<string, any> | undefined;
+            audienceTargeting?: Record<string, any> | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        advancedInput?: Record<string, any> | undefined;
+        validateInputOnly?: boolean | null | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        adGroup: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        adGroup: Record<string, unknown>;
+    }, {
+        timestamp: string;
+        adGroup: Record<string, unknown>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            campaignId: string;
+            primaryInput: {
+                name: string;
+                channel: string;
+            };
+        };
+    }[];
+    logic: typeof createAdGroupWorkflowLogic;
+    responseFormatter: typeof createAdGroupWorkflowResponseFormatter;
+};
+export {};
+//# sourceMappingURL=create-ad-group-workflow.tool.d.ts.map

package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-ad-group-workflow.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-ad-group-workflow.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhD,CAAC;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;EAGhD,CAAC;AAEH,KAAK,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAC3F,KAAK,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAE7F,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,8BAA8B,EACrC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,+BAA+B,CAAC,CAO1C;AAED,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,+BAA+B,GACtC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BrC,CAAC"}

package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { AdGroupCreateWorkflowInputSchema } from "../utils/workflow-schemas.js";
+const TOOL_NAME = "ttd_create_ad_group_workflow";
+const TOOL_TITLE = "TTD Create Ad Group Workflow";
+const TOOL_DESCRIPTION = `Create an ad group through the TTD Workflows API using workflow-aware payloads.`;
+export const CreateAdGroupWorkflowToolInputSchema = AdGroupCreateWorkflowInputSchema.describe("Parameters for creating an ad group via the TTD Workflows API");
+export const CreateAdGroupWorkflowToolOutputSchema = z.object({
+    adGroup: z.record(z.unknown()).describe("Raw ad group workflow response"),
+    timestamp: z.string().datetime(),
+});
+export async function createAdGroupWorkflowLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const adGroup = (await ttdService.createAdGroupWorkflow(input, context));
+    return { adGroup, timestamp: new Date().toISOString() };
+}
+export function createAdGroupWorkflowResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Ad group workflow response:\n\n${JSON.stringify(result.adGroup, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const createAdGroupWorkflowTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: CreateAdGroupWorkflowToolInputSchema,
+    outputSchema: CreateAdGroupWorkflowToolOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Create ad group workflow",
+            input: {
+                campaignId: "camp123",
+                primaryInput: {
+                    name: "Workflow Ad Group",
+                    channel: "DISPLAY",
+                },
+            },
+        },
+    ],
+    logic: createAdGroupWorkflowLogic,
+    responseFormatter: createAdGroupWorkflowResponseFormatter,
+};
+//# sourceMappingURL=create-ad-group-workflow.tool.js.map

package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-ad-group-workflow.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-ad-group-workflow.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAGhF,MAAM,SAAS,GAAG,8BAA8B,CAAC;AACjD,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAClD,MAAM,gBAAgB,GAAG,iFAAiF,CAAC;AAE3G,MAAM,CAAC,MAAM,oCAAoC,GAAG,gCAAgC,CAAC,QAAQ,CAC3F,+DAA+D,CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAKH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAqC,EACrC,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,CAAC,MAAM,UAAU,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAGtE,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,MAAuC;IAEvC,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,kCAAkC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACpH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,oCAAoC;IACjD,YAAY,EAAE,qCAAqC;IACnD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,0BAA0B;YACjC,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;gBACrB,YAAY,EAAE;oBACZ,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,SAAS;iBACnB;aACF;SACF;KACF;IACD,KAAK,EAAE,0BAA0B;IACjC,iBAAiB,EAAE,sCAAsC;CAC1D,CAAC"}