@cesteral/cm360-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +428 -0
  3. package/dist/config/index.d.ts +88 -0
  4. package/dist/config/index.d.ts.map +1 -0
  5. package/dist/config/index.js +31 -0
  6. package/dist/config/index.js.map +1 -0
  7. package/dist/generated/types.d.ts +2058 -0
  8. package/dist/generated/types.d.ts.map +1 -0
  9. package/dist/generated/types.js +2 -0
  10. package/dist/generated/types.js.map +1 -0
  11. package/dist/index.d.ts +3 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +52 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  16. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  17. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +92 -0
  18. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  19. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  20. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  21. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +171 -0
  22. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
  24. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
  25. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +74 -0
  26. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +74 -0
  30. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +92 -0
  34. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/floodlight-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/floodlight-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/floodlight-workflow.prompt.js +114 -0
  38. package/dist/mcp-server/prompts/definitions/floodlight-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +101 -0
  42. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
  44. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +52 -0
  46. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
  47. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
  48. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
  49. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +106 -0
  50. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
  51. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  52. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  53. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +69 -0
  54. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  55. package/dist/mcp-server/prompts/index.d.ts +9 -0
  56. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  57. package/dist/mcp-server/prompts/index.js +89 -0
  58. package/dist/mcp-server/prompts/index.js.map +1 -0
  59. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  60. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  61. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +140 -0
  62. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  63. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  64. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  65. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +104 -0
  66. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  67. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  68. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  69. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +111 -0
  70. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  71. package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
  72. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/definitions/index.js +49 -0
  74. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  75. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
  76. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +62 -0
  78. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
  79. package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
  80. package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +46 -0
  82. package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
  83. package/dist/mcp-server/resources/index.d.ts +3 -0
  84. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  85. package/dist/mcp-server/resources/index.js +2 -0
  86. package/dist/mcp-server/resources/index.js.map +1 -0
  87. package/dist/mcp-server/resources/types.d.ts +8 -0
  88. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  89. package/dist/mcp-server/resources/types.js +2 -0
  90. package/dist/mcp-server/resources/types.js.map +1 -0
  91. package/dist/mcp-server/server.d.ts +5 -0
  92. package/dist/mcp-server/server.d.ts.map +1 -0
  93. package/dist/mcp-server/server.js +124 -0
  94. package/dist/mcp-server/server.js.map +1 -0
  95. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +147 -0
  96. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +109 -0
  98. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +187 -0
  100. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  101. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +141 -0
  102. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  103. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +147 -0
  104. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  105. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +168 -0
  106. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +138 -0
  108. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +82 -0
  110. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +101 -0
  112. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/create-entity.tool.js +84 -0
  114. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +384 -0
  116. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +141 -0
  118. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +94 -0
  120. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +93 -0
  122. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +86 -0
  124. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +91 -0
  126. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +164 -0
  128. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/download-report.tool.js +144 -0
  130. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +87 -0
  132. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +72 -0
  134. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +76 -0
  136. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/get-entity.tool.js +71 -0
  138. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +208 -0
  140. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +143 -0
  142. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +206 -0
  144. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/get-report.tool.js +114 -0
  146. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/index.d.ts +23 -0
  148. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/index.js +69 -0
  150. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +177 -0
  152. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/list-entities.tool.js +105 -0
  154. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +275 -0
  156. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +90 -0
  158. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/list-targeting-options.tool.d.ts +163 -0
  160. package/dist/mcp-server/tools/definitions/list-targeting-options.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/list-targeting-options.tool.js +105 -0
  162. package/dist/mcp-server/tools/definitions/list-targeting-options.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/list-user-profiles.tool.d.ts +53 -0
  164. package/dist/mcp-server/tools/definitions/list-user-profiles.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/list-user-profiles.tool.js +58 -0
  166. package/dist/mcp-server/tools/definitions/list-user-profiles.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +195 -0
  168. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/submit-report.tool.js +107 -0
  170. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +89 -0
  172. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/update-entity.tool.js +76 -0
  174. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +184 -0
  176. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +260 -0
  178. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/index.d.ts +2 -0
  180. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/index.js +2 -0
  182. package/dist/mcp-server/tools/index.js.map +1 -0
  183. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +12 -0
  184. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/utils/entity-mapping.js +67 -0
  186. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  187. package/dist/mcp-server/tools/utils/report-config.d.ts +73 -0
  188. package/dist/mcp-server/tools/utils/report-config.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/utils/report-config.js +161 -0
  190. package/dist/mcp-server/tools/utils/report-config.js.map +1 -0
  191. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  192. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  194. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  195. package/dist/mcp-server/transports/streamable-http-transport.d.ts +43 -0
  196. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  197. package/dist/mcp-server/transports/streamable-http-transport.js +58 -0
  198. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  199. package/dist/services/cm360/cm360-http-client.d.ts +12 -0
  200. package/dist/services/cm360/cm360-http-client.d.ts.map +1 -0
  201. package/dist/services/cm360/cm360-http-client.js +77 -0
  202. package/dist/services/cm360/cm360-http-client.js.map +1 -0
  203. package/dist/services/cm360/cm360-reporting-service.d.ts +50 -0
  204. package/dist/services/cm360/cm360-reporting-service.d.ts.map +1 -0
  205. package/dist/services/cm360/cm360-reporting-service.js +123 -0
  206. package/dist/services/cm360/cm360-reporting-service.js.map +1 -0
  207. package/dist/services/cm360/cm360-service.d.ts +60 -0
  208. package/dist/services/cm360/cm360-service.d.ts.map +1 -0
  209. package/dist/services/cm360/cm360-service.js +146 -0
  210. package/dist/services/cm360/cm360-service.js.map +1 -0
  211. package/dist/services/session-services.d.ts +16 -0
  212. package/dist/services/session-services.d.ts.map +1 -0
  213. package/dist/services/session-services.js +15 -0
  214. package/dist/services/session-services.js.map +1 -0
  215. package/dist/types-global/mcp.d.ts +2 -0
  216. package/dist/types-global/mcp.d.ts.map +1 -0
  217. package/dist/types-global/mcp.js +2 -0
  218. package/dist/types-global/mcp.js.map +1 -0
  219. package/dist/utils/errors/index.d.ts +2 -0
  220. package/dist/utils/errors/index.d.ts.map +1 -0
  221. package/dist/utils/errors/index.js +2 -0
  222. package/dist/utils/errors/index.js.map +1 -0
  223. package/dist/utils/platform.d.ts +3 -0
  224. package/dist/utils/platform.d.ts.map +1 -0
  225. package/dist/utils/platform.js +5 -0
  226. package/dist/utils/platform.js.map +1 -0
  227. package/dist/utils/security/rate-limiter.d.ts +3 -0
  228. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  229. package/dist/utils/security/rate-limiter.js +5 -0
  230. package/dist/utils/security/rate-limiter.js.map +1 -0
  231. package/dist/utils/telemetry/index.d.ts +2 -0
  232. package/dist/utils/telemetry/index.d.ts.map +1 -0
  233. package/dist/utils/telemetry/index.js +2 -0
  234. package/dist/utils/telemetry/index.js.map +1 -0
  235. package/dist/utils/telemetry/tracing.d.ts +3 -0
  236. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  237. package/dist/utils/telemetry/tracing.js +4 -0
  238. package/dist/utils/telemetry/tracing.js.map +1 -0
  239. package/package.json +58 -0
@@ -0,0 +1,93 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { getDeletableEntityTypeEnum } from "../utils/entity-mapping.js";
4
+ import { elicitDeleteConfirmation } from "@cesteral/shared";
5
+ const TOOL_NAME = "cm360_delete_entity";
6
+ const TOOL_TITLE = "Delete CM360 Entity";
7
+ const TOOL_DESCRIPTION = `Delete a Campaign Manager 360 entity.
8
+
9
+ **Supported entity types:** ${getDeletableEntityTypeEnum().join(", ")}
10
+
11
+ Only floodlightActivity supports deletion. Other entity types must be archived by updating their status.`;
12
+ export const DeleteEntityInputSchema = z
13
+ .object({
14
+ profileId: z.string().min(1).describe("CM360 User Profile ID"),
15
+ entityType: z.enum(getDeletableEntityTypeEnum()).describe("Type of entity to delete"),
16
+ entityId: z.string().min(1).describe("The entity ID to delete"),
17
+ })
18
+ .describe("Parameters for deleting a CM360 entity");
19
+ export const DeleteEntityOutputSchema = z
20
+ .object({
21
+ confirmed: z.boolean(),
22
+ declineReason: z.string().optional(),
23
+ deleted: z.boolean().describe("Whether the entity was deleted"),
24
+ entityId: z.string().describe("ID of the deleted entity"),
25
+ timestamp: z.string().datetime(),
26
+ })
27
+ .describe("Entity deletion result");
28
+ export async function deleteEntityLogic(input, context, sdkContext) {
29
+ const confirmed = await elicitDeleteConfirmation({
30
+ entityLabel: input.entityType,
31
+ entityId: input.entityId,
32
+ sdkContext,
33
+ });
34
+ if (!confirmed) {
35
+ return {
36
+ confirmed: false,
37
+ declineReason: "user_declined",
38
+ deleted: false,
39
+ entityId: input.entityId,
40
+ timestamp: new Date().toISOString(),
41
+ };
42
+ }
43
+ const { cm360Service } = resolveSessionServices(sdkContext);
44
+ await cm360Service.deleteEntity(input.entityType, input.profileId, input.entityId, context);
45
+ return {
46
+ confirmed: true,
47
+ deleted: true,
48
+ entityId: input.entityId,
49
+ timestamp: new Date().toISOString(),
50
+ };
51
+ }
52
+ export function deleteEntityResponseFormatter(result) {
53
+ if (!result.confirmed) {
54
+ return [
55
+ {
56
+ type: "text",
57
+ text: `Deletion of ${result.entityId} cancelled by user.\n\nTimestamp: ${result.timestamp}`,
58
+ },
59
+ ];
60
+ }
61
+ return [
62
+ {
63
+ type: "text",
64
+ text: `Entity ${result.entityId} deleted successfully\n\nTimestamp: ${result.timestamp}`,
65
+ },
66
+ ];
67
+ }
68
+ export const deleteEntityTool = {
69
+ name: TOOL_NAME,
70
+ title: TOOL_TITLE,
71
+ description: TOOL_DESCRIPTION,
72
+ inputSchema: DeleteEntityInputSchema,
73
+ outputSchema: DeleteEntityOutputSchema,
74
+ annotations: {
75
+ readOnlyHint: false,
76
+ openWorldHint: true,
77
+ destructiveHint: true,
78
+ idempotentHint: true,
79
+ },
80
+ inputExamples: [
81
+ {
82
+ label: "Delete a floodlight activity",
83
+ input: {
84
+ profileId: "123456",
85
+ entityType: "floodlightActivity",
86
+ entityId: "345678",
87
+ },
88
+ },
89
+ ],
90
+ logic: deleteEntityLogic,
91
+ responseFormatter: deleteEntityResponseFormatter,
92
+ };
93
+ //# sourceMappingURL=delete-entity.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delete-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAwB,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI5D,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AACzC,MAAM,gBAAgB,GAAG;;8BAEK,0BAA0B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;yGAEoC,CAAC;AAE1G,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC9D,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAChE,CAAC;KACD,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAKtC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC;QAC/C,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU;KACX,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,YAAY,CAAC,YAAY,CAC7B,KAAK,CAAC,UAA6B,EACnC,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,QAAQ,EACd,OAAO,CACR,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,eAAe,MAAM,CAAC,QAAQ,qCAAqC,MAAM,CAAC,SAAS,EAAE;aAC5F;SACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,UAAU,MAAM,CAAC,QAAQ,uCAAuC,MAAM,CAAC,SAAS,EAAE;SACzF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;KACrB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,8BAA8B;YACrC,KAAK,EAAE;gBACL,SAAS,EAAE,QAAQ;gBACnB,UAAU,EAAE,oBAAoB;gBAChC,QAAQ,EAAE,QAAQ;aACnB;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
@@ -0,0 +1,86 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const DeleteReportScheduleInputSchema: z.ZodObject<{
4
+ profileId: z.ZodString;
5
+ reportId: z.ZodString;
6
+ }, "strip", z.ZodTypeAny, {
7
+ reportId: string;
8
+ profileId: string;
9
+ }, {
10
+ reportId: string;
11
+ profileId: string;
12
+ }>;
13
+ export declare const DeleteReportScheduleOutputSchema: z.ZodObject<{
14
+ confirmed: z.ZodBoolean;
15
+ declineReason: z.ZodOptional<z.ZodString>;
16
+ reportId: z.ZodString;
17
+ deleted: z.ZodBoolean;
18
+ timestamp: z.ZodString;
19
+ }, "strip", z.ZodTypeAny, {
20
+ reportId: string;
21
+ timestamp: string;
22
+ confirmed: boolean;
23
+ deleted: boolean;
24
+ declineReason?: string | undefined;
25
+ }, {
26
+ reportId: string;
27
+ timestamp: string;
28
+ confirmed: boolean;
29
+ deleted: boolean;
30
+ declineReason?: string | undefined;
31
+ }>;
32
+ type DeleteReportScheduleInput = z.infer<typeof DeleteReportScheduleInputSchema>;
33
+ type DeleteReportScheduleOutput = z.infer<typeof DeleteReportScheduleOutputSchema>;
34
+ export declare function deleteReportScheduleLogic(input: DeleteReportScheduleInput, context: RequestContext, sdkContext?: SdkContext): Promise<DeleteReportScheduleOutput>;
35
+ export declare function deleteReportScheduleResponseFormatter(result: DeleteReportScheduleOutput): McpTextContent[];
36
+ export declare const deleteReportScheduleTool: {
37
+ name: string;
38
+ title: string;
39
+ description: string;
40
+ inputSchema: z.ZodObject<{
41
+ profileId: z.ZodString;
42
+ reportId: z.ZodString;
43
+ }, "strip", z.ZodTypeAny, {
44
+ reportId: string;
45
+ profileId: string;
46
+ }, {
47
+ reportId: string;
48
+ profileId: string;
49
+ }>;
50
+ outputSchema: z.ZodObject<{
51
+ confirmed: z.ZodBoolean;
52
+ declineReason: z.ZodOptional<z.ZodString>;
53
+ reportId: z.ZodString;
54
+ deleted: z.ZodBoolean;
55
+ timestamp: z.ZodString;
56
+ }, "strip", z.ZodTypeAny, {
57
+ reportId: string;
58
+ timestamp: string;
59
+ confirmed: boolean;
60
+ deleted: boolean;
61
+ declineReason?: string | undefined;
62
+ }, {
63
+ reportId: string;
64
+ timestamp: string;
65
+ confirmed: boolean;
66
+ deleted: boolean;
67
+ declineReason?: string | undefined;
68
+ }>;
69
+ annotations: {
70
+ readOnlyHint: boolean;
71
+ openWorldHint: boolean;
72
+ destructiveHint: boolean;
73
+ idempotentHint: boolean;
74
+ };
75
+ inputExamples: {
76
+ label: string;
77
+ input: {
78
+ profileId: string;
79
+ reportId: string;
80
+ };
81
+ }[];
82
+ logic: typeof deleteReportScheduleLogic;
83
+ responseFormatter: typeof deleteReportScheduleResponseFormatter;
84
+ };
85
+ export {};
86
+ //# sourceMappingURL=delete-report-schedule.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delete-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-report-schedule.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;AAQnF,eAAO,MAAM,+BAA+B;;;;;;;;;EAUkB,CAAC;AAE/D,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;EAQT,CAAC;AAErC,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,CA0BrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAelB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBpC,CAAC"}
@@ -0,0 +1,91 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { elicitDeleteConfirmation } from "@cesteral/shared";
4
+ const TOOL_NAME = "cm360_delete_report_schedule";
5
+ const TOOL_TITLE = "Delete CM360 Report Schedule";
6
+ const TOOL_DESCRIPTION = `Delete a CM360 scheduled report (and its schedule).
7
+
8
+ This permanently deletes the report resource. Use cm360_list_report_schedules to find the reportId.`;
9
+ export const DeleteReportScheduleInputSchema = z
10
+ .object({
11
+ profileId: z.string().min(1).describe("CM360 User Profile ID"),
12
+ reportId: z
13
+ .string()
14
+ .min(1)
15
+ .describe("Report ID to delete (from cm360_create_report_schedule or cm360_list_report_schedules)"),
16
+ })
17
+ .describe("Parameters for deleting a CM360 report schedule");
18
+ export const DeleteReportScheduleOutputSchema = z
19
+ .object({
20
+ confirmed: z.boolean(),
21
+ declineReason: z.string().optional(),
22
+ reportId: z.string(),
23
+ deleted: z.boolean(),
24
+ timestamp: z.string().datetime(),
25
+ })
26
+ .describe("Deletion confirmation");
27
+ export async function deleteReportScheduleLogic(input, context, sdkContext) {
28
+ const confirmed = await elicitDeleteConfirmation({
29
+ entityLabel: "report schedule",
30
+ entityId: input.reportId,
31
+ sdkContext,
32
+ });
33
+ if (!confirmed) {
34
+ return {
35
+ confirmed: false,
36
+ declineReason: "user_declined",
37
+ reportId: input.reportId,
38
+ deleted: false,
39
+ timestamp: new Date().toISOString(),
40
+ };
41
+ }
42
+ const { cm360ReportingService } = resolveSessionServices(sdkContext);
43
+ await cm360ReportingService.deleteReportSchedule(input.profileId, input.reportId, context);
44
+ return {
45
+ confirmed: true,
46
+ reportId: input.reportId,
47
+ deleted: true,
48
+ timestamp: new Date().toISOString(),
49
+ };
50
+ }
51
+ export function deleteReportScheduleResponseFormatter(result) {
52
+ if (!result.confirmed) {
53
+ return [
54
+ {
55
+ type: "text",
56
+ text: `Deletion of report ${result.reportId} cancelled by user.\nTimestamp: ${result.timestamp}`,
57
+ },
58
+ ];
59
+ }
60
+ return [
61
+ {
62
+ type: "text",
63
+ text: `Report ${result.reportId} deleted successfully.\nTimestamp: ${result.timestamp}`,
64
+ },
65
+ ];
66
+ }
67
+ export const deleteReportScheduleTool = {
68
+ name: TOOL_NAME,
69
+ title: TOOL_TITLE,
70
+ description: TOOL_DESCRIPTION,
71
+ inputSchema: DeleteReportScheduleInputSchema,
72
+ outputSchema: DeleteReportScheduleOutputSchema,
73
+ annotations: {
74
+ readOnlyHint: false,
75
+ openWorldHint: true,
76
+ destructiveHint: true,
77
+ idempotentHint: true,
78
+ },
79
+ inputExamples: [
80
+ {
81
+ label: "Delete a scheduled report",
82
+ input: {
83
+ profileId: "123456",
84
+ reportId: "789012345",
85
+ },
86
+ },
87
+ ],
88
+ logic: deleteReportScheduleLogic,
89
+ responseFormatter: deleteReportScheduleResponseFormatter,
90
+ };
91
+ //# sourceMappingURL=delete-report-schedule.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delete-report-schedule.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-report-schedule.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,164 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent } from "@cesteral/shared";
3
+ import type { SdkContext } from "@cesteral/shared";
4
+ export declare const DownloadReportInputSchema: z.ZodObject<{
5
+ downloadUrl: z.ZodString;
6
+ } & {
7
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
8
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
9
+ offset: z.ZodOptional<z.ZodNumber>;
10
+ maxRows: z.ZodOptional<z.ZodNumber>;
11
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
12
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
13
+ } & {
14
+ includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
15
+ }, "strip", z.ZodTypeAny, {
16
+ downloadUrl: string;
17
+ mode: "summary" | "rows";
18
+ includeComputedMetrics: boolean;
19
+ columns?: string[] | undefined;
20
+ offset?: number | undefined;
21
+ maxRows?: number | undefined;
22
+ aggregateBy?: string[] | undefined;
23
+ aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
24
+ }, {
25
+ downloadUrl: string;
26
+ mode?: "summary" | "rows" | undefined;
27
+ columns?: string[] | undefined;
28
+ offset?: number | undefined;
29
+ maxRows?: number | undefined;
30
+ aggregateBy?: string[] | undefined;
31
+ aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
32
+ includeComputedMetrics?: boolean | undefined;
33
+ }>;
34
+ export declare const DownloadReportOutputSchema: z.ZodObject<{
35
+ timestamp: z.ZodString;
36
+ totalRows: z.ZodNumber;
37
+ returnedRows: z.ZodNumber;
38
+ truncated: z.ZodBoolean;
39
+ nextOffset: z.ZodNullable<z.ZodNumber>;
40
+ headers: z.ZodArray<z.ZodString, "many">;
41
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
42
+ mode: z.ZodEnum<["summary", "rows"]>;
43
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
44
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
45
+ warnings: z.ZodArray<z.ZodString, "many">;
46
+ }, "strip", z.ZodTypeAny, {
47
+ timestamp: string;
48
+ mode: "summary" | "rows";
49
+ totalRows: number;
50
+ returnedRows: number;
51
+ truncated: boolean;
52
+ nextOffset: number | null;
53
+ headers: string[];
54
+ selectedColumns: string[];
55
+ warnings: string[];
56
+ rows?: Record<string, any>[] | undefined;
57
+ previewRows?: Record<string, any>[] | undefined;
58
+ }, {
59
+ timestamp: string;
60
+ mode: "summary" | "rows";
61
+ totalRows: number;
62
+ returnedRows: number;
63
+ truncated: boolean;
64
+ nextOffset: number | null;
65
+ headers: string[];
66
+ selectedColumns: string[];
67
+ warnings: string[];
68
+ rows?: Record<string, any>[] | undefined;
69
+ previewRows?: Record<string, any>[] | undefined;
70
+ }>;
71
+ type DownloadReportInput = z.infer<typeof DownloadReportInputSchema>;
72
+ type DownloadReportOutput = z.infer<typeof DownloadReportOutputSchema>;
73
+ export declare function downloadReportLogic(input: DownloadReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<DownloadReportOutput>;
74
+ export declare function downloadReportResponseFormatter(result: DownloadReportOutput): McpTextContent[];
75
+ export declare const downloadReportTool: {
76
+ name: string;
77
+ title: string;
78
+ description: string;
79
+ inputSchema: z.ZodObject<{
80
+ downloadUrl: z.ZodString;
81
+ } & {
82
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
83
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
84
+ offset: z.ZodOptional<z.ZodNumber>;
85
+ maxRows: z.ZodOptional<z.ZodNumber>;
86
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
87
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
88
+ } & {
89
+ includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
90
+ }, "strip", z.ZodTypeAny, {
91
+ downloadUrl: string;
92
+ mode: "summary" | "rows";
93
+ includeComputedMetrics: boolean;
94
+ columns?: string[] | undefined;
95
+ offset?: number | undefined;
96
+ maxRows?: number | undefined;
97
+ aggregateBy?: string[] | undefined;
98
+ aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
99
+ }, {
100
+ downloadUrl: string;
101
+ mode?: "summary" | "rows" | undefined;
102
+ columns?: string[] | undefined;
103
+ offset?: number | undefined;
104
+ maxRows?: number | undefined;
105
+ aggregateBy?: string[] | undefined;
106
+ aggregateMetrics?: Record<string, "sum" | "avg" | "count" | "min" | "max"> | undefined;
107
+ includeComputedMetrics?: boolean | undefined;
108
+ }>;
109
+ outputSchema: z.ZodObject<{
110
+ timestamp: z.ZodString;
111
+ totalRows: z.ZodNumber;
112
+ returnedRows: z.ZodNumber;
113
+ truncated: z.ZodBoolean;
114
+ nextOffset: z.ZodNullable<z.ZodNumber>;
115
+ headers: z.ZodArray<z.ZodString, "many">;
116
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
117
+ mode: z.ZodEnum<["summary", "rows"]>;
118
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
119
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
120
+ warnings: z.ZodArray<z.ZodString, "many">;
121
+ }, "strip", z.ZodTypeAny, {
122
+ timestamp: string;
123
+ mode: "summary" | "rows";
124
+ totalRows: number;
125
+ returnedRows: number;
126
+ truncated: boolean;
127
+ nextOffset: number | null;
128
+ headers: string[];
129
+ selectedColumns: string[];
130
+ warnings: string[];
131
+ rows?: Record<string, any>[] | undefined;
132
+ previewRows?: Record<string, any>[] | undefined;
133
+ }, {
134
+ timestamp: string;
135
+ mode: "summary" | "rows";
136
+ totalRows: number;
137
+ returnedRows: number;
138
+ truncated: boolean;
139
+ nextOffset: number | null;
140
+ headers: string[];
141
+ selectedColumns: string[];
142
+ warnings: string[];
143
+ rows?: Record<string, any>[] | undefined;
144
+ previewRows?: Record<string, any>[] | undefined;
145
+ }>;
146
+ annotations: {
147
+ readOnlyHint: boolean;
148
+ openWorldHint: boolean;
149
+ destructiveHint: boolean;
150
+ idempotentHint: boolean;
151
+ };
152
+ inputExamples: {
153
+ label: string;
154
+ input: {
155
+ downloadUrl: string;
156
+ mode: string;
157
+ maxRows: number;
158
+ };
159
+ }[];
160
+ logic: typeof downloadReportLogic;
161
+ responseFormatter: typeof downloadReportResponseFormatter;
162
+ };
163
+ export {};
164
+ //# sourceMappingURL=download-report.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/download-report.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;AASnD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASkB,CAAC;AAEzD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKF,CAAC;AAEtC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAiE/B;AAsCD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAgB9F;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyB9B,CAAC"}
@@ -0,0 +1,144 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { appendComputedMetricsToRows, ComputedMetricsFlagSchema, createReportView, formatReportViewResponse, parseCSV, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
4
+ import { McpError, JsonRpcErrorCode, mapHttpStatusToJsonRpc } from "@cesteral/shared";
5
+ const TOOL_NAME = "cm360_download_report";
6
+ const TOOL_TITLE = "Download CM360 Report";
7
+ const TOOL_DESCRIPTION = `Download and parse a CM360 report from its download URL.
8
+
9
+ Use the downloadUrl from cm360_get_report or cm360_check_report_status. Returns a bounded summary or paged row slice.`;
10
+ export const DownloadReportInputSchema = z
11
+ .object({
12
+ downloadUrl: z
13
+ .string()
14
+ .url()
15
+ .describe("Report download URL (from cm360_get_report or cm360_check_report_status)"),
16
+ })
17
+ .merge(ReportViewInputSchema)
18
+ .merge(ComputedMetricsFlagSchema)
19
+ .describe("Parameters for downloading a CM360 report");
20
+ export const DownloadReportOutputSchema = z
21
+ .object({
22
+ ...ReportViewOutputSchema.shape,
23
+ timestamp: z.string().datetime(),
24
+ })
25
+ .describe("Report download result");
26
+ export async function downloadReportLogic(input, context, sdkContext) {
27
+ const { cm360ReportingService } = resolveSessionServices(sdkContext);
28
+ const response = await cm360ReportingService.downloadReportFile(input.downloadUrl, 30_000, context);
29
+ if (!response.ok) {
30
+ const errorBody = await response.text().catch(() => "");
31
+ const detail = errorBody ? ` — ${errorBody.substring(0, 500)}` : "";
32
+ throw new McpError(mapHttpStatusToJsonRpc(response.status), `Failed to download report: ${response.status} ${response.statusText}${detail}`);
33
+ }
34
+ const format = inferReportFormat(input.downloadUrl, response);
35
+ if (format !== "CSV") {
36
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Unsupported CM360 report format: ${format}. cm360_download_report only supports CSV downloads.`);
37
+ }
38
+ const csvText = await response.text();
39
+ const { headers, rows } = parseCSV(csvText);
40
+ if (headers.length === 0 && rows.length === 0) {
41
+ return {
42
+ headers: [],
43
+ selectedColumns: [],
44
+ totalRows: 0,
45
+ returnedRows: 0,
46
+ truncated: false,
47
+ nextOffset: null,
48
+ mode: input.mode ?? "summary",
49
+ previewRows: input.mode === "rows" ? undefined : [],
50
+ rows: input.mode === "rows" ? [] : undefined,
51
+ warnings: [],
52
+ timestamp: new Date().toISOString(),
53
+ };
54
+ }
55
+ const augmented = input.includeComputedMetrics
56
+ ? appendComputedMetricsToRows(rows, CM360_COMPUTED_METRIC_ALIASES)
57
+ : rows;
58
+ const computedWarning = input.includeComputedMetrics
59
+ ? augmented[0]?._computedMetricsWarnings
60
+ : undefined;
61
+ const augmentedHeaders = input.includeComputedMetrics
62
+ ? [...headers, "cpa", "roas", "cpm", "ctr", "cpc"]
63
+ : headers;
64
+ return {
65
+ ...createReportView({
66
+ headers: augmentedHeaders,
67
+ rows: augmented,
68
+ totalRows: rows.length,
69
+ input,
70
+ warnings: computedWarning ? [`computed metrics: ${computedWarning}`] : undefined,
71
+ }),
72
+ timestamp: new Date().toISOString(),
73
+ };
74
+ }
75
+ const CM360_COMPUTED_METRIC_ALIASES = {
76
+ cost: ["mediaCost", "cost", "dfa:mediaCost", "Media Cost", "MediaCost"],
77
+ impressions: ["impressions", "dfa:impressions", "Impressions"],
78
+ clicks: ["clicks", "dfa:clicks", "Clicks"],
79
+ conversions: ["totalConversions", "conversions", "dfa:totalConversions", "Total Conversions"],
80
+ conversionValue: ["floodlightRevenue", "revenue", "totalRevenue", "dfa:floodlightRevenue"],
81
+ };
82
+ function inferReportFormat(downloadUrl, response) {
83
+ const contentType = response.headers?.get?.("content-type")?.toLowerCase() ?? "";
84
+ if (contentType.includes("spreadsheetml") || contentType.includes("application/vnd.ms-excel")) {
85
+ return "EXCEL";
86
+ }
87
+ if (contentType.includes("text/csv") ||
88
+ contentType.includes("application/csv") ||
89
+ contentType.includes("text/plain")) {
90
+ return "CSV";
91
+ }
92
+ const normalizedUrl = downloadUrl.toLowerCase();
93
+ if (normalizedUrl.includes(".csv") || normalizedUrl.includes("format=csv")) {
94
+ return "CSV";
95
+ }
96
+ if (normalizedUrl.includes(".xls") ||
97
+ normalizedUrl.includes(".xlsx") ||
98
+ normalizedUrl.includes("format=excel")) {
99
+ return "EXCEL";
100
+ }
101
+ return "UNKNOWN";
102
+ }
103
+ export function downloadReportResponseFormatter(result) {
104
+ if (result.returnedRows === 0) {
105
+ return [
106
+ {
107
+ type: "text",
108
+ text: `Report is empty — no data rows.\n\nTimestamp: ${result.timestamp}`,
109
+ },
110
+ ];
111
+ }
112
+ return [
113
+ {
114
+ type: "text",
115
+ text: formatReportViewResponse(result, "Report data"),
116
+ },
117
+ ];
118
+ }
119
+ export const downloadReportTool = {
120
+ name: TOOL_NAME,
121
+ title: TOOL_TITLE,
122
+ description: TOOL_DESCRIPTION,
123
+ inputSchema: DownloadReportInputSchema,
124
+ outputSchema: DownloadReportOutputSchema,
125
+ annotations: {
126
+ readOnlyHint: true,
127
+ openWorldHint: true,
128
+ destructiveHint: false,
129
+ idempotentHint: true,
130
+ },
131
+ inputExamples: [
132
+ {
133
+ label: "Download a report",
134
+ input: {
135
+ downloadUrl: "https://dfareporting.googleapis.com/dfareporting/v5/userprofiles/123456/reports/789012/files/345678?alt=media",
136
+ mode: "rows",
137
+ maxRows: 50,
138
+ },
139
+ },
140
+ ],
141
+ logic: downloadReportLogic,
142
+ responseFormatter: downloadReportResponseFormatter,
143
+ };
144
+ //# sourceMappingURL=download-report.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/download-report.tool.ts"],"names":[],"mappings":"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"}