@cesteral/msads-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 (255) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +179 -0
  3. package/dist/auth/index.d.ts +3 -0
  4. package/dist/auth/index.d.ts.map +1 -0
  5. package/dist/auth/index.js +3 -0
  6. package/dist/auth/index.js.map +1 -0
  7. package/dist/auth/msads-auth-adapter.d.ts +27 -0
  8. package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/msads-auth-adapter.js +79 -0
  10. package/dist/auth/msads-auth-adapter.js.map +1 -0
  11. package/dist/auth/msads-auth-strategy.d.ts +8 -0
  12. package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/msads-auth-strategy.js +36 -0
  14. package/dist/auth/msads-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +112 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +56 -0
  18. package/dist/config/index.js.map +1 -0
  19. package/dist/index.d.ts +3 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +47 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  24. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  25. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +54 -0
  26. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +147 -0
  30. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
  34. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +55 -0
  38. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +47 -0
  42. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/index.d.ts +9 -0
  44. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/index.js +49 -0
  46. package/dist/mcp-server/prompts/index.js.map +1 -0
  47. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  48. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  49. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +84 -0
  50. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  51. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  52. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  53. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +54 -0
  54. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  55. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  56. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  57. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +54 -0
  58. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  59. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
  60. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
  61. package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
  62. package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
  63. package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
  64. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  65. package/dist/mcp-server/resources/definitions/index.js +79 -0
  66. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  67. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
  68. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
  69. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +64 -0
  70. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
  71. package/dist/mcp-server/resources/index.d.ts +3 -0
  72. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/index.js +2 -0
  74. package/dist/mcp-server/resources/index.js.map +1 -0
  75. package/dist/mcp-server/resources/types.d.ts +8 -0
  76. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/types.js +2 -0
  78. package/dist/mcp-server/resources/types.js.map +1 -0
  79. package/dist/mcp-server/resources/utils/field-rules.d.ts +9 -0
  80. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/utils/field-rules.js +106 -0
  82. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
  83. package/dist/mcp-server/server.d.ts +5 -0
  84. package/dist/mcp-server/server.d.ts.map +1 -0
  85. package/dist/mcp-server/server.js +142 -0
  86. package/dist/mcp-server/server.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -0
  88. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  89. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +124 -0
  90. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  91. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +83 -0
  92. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  93. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +68 -0
  94. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  95. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +95 -0
  96. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +102 -0
  98. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +151 -0
  100. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  101. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
  102. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  103. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +111 -0
  104. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  105. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +73 -0
  106. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +81 -0
  108. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/create-entity.tool.js +74 -0
  110. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
  112. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
  114. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -0
  116. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +94 -0
  118. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
  120. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
  122. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -0
  124. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/download-report.tool.js +85 -0
  126. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
  128. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
  130. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +68 -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 +90 -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 +285 -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 +120 -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 +280 -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 +138 -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 +260 -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 +118 -0
  146. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
  148. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
  150. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
  152. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/index.js +53 -0
  154. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
  156. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
  158. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -0
  160. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/list-entities.tool.js +100 -0
  162. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
  164. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
  166. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
  168. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
  170. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
  172. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
  174. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -0
  176. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +105 -0
  178. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +132 -0
  180. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/submit-report.tool.js +94 -0
  182. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +79 -0
  184. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/update-entity.tool.js +64 -0
  186. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +174 -0
  188. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +142 -0
  190. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/index.d.ts +2 -0
  192. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/index.js +2 -0
  194. package/dist/mcp-server/tools/index.js.map +1 -0
  195. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +20 -0
  196. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/utils/entity-mapping.js +118 -0
  198. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  199. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  200. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  202. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  203. package/dist/mcp-server/transports/streamable-http-transport.d.ts +55 -0
  204. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  205. package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
  206. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  207. package/dist/services/msads/msads-http-client.d.ts +16 -0
  208. package/dist/services/msads/msads-http-client.d.ts.map +1 -0
  209. package/dist/services/msads/msads-http-client.js +89 -0
  210. package/dist/services/msads/msads-http-client.js.map +1 -0
  211. package/dist/services/msads/msads-reporting-service.d.ts +58 -0
  212. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
  213. package/dist/services/msads/msads-reporting-service.js +153 -0
  214. package/dist/services/msads/msads-reporting-service.js.map +1 -0
  215. package/dist/services/msads/msads-service.d.ts +54 -0
  216. package/dist/services/msads/msads-service.d.ts.map +1 -0
  217. package/dist/services/msads/msads-service.js +179 -0
  218. package/dist/services/msads/msads-service.js.map +1 -0
  219. package/dist/services/msads/rate-limit-keys.d.ts +3 -0
  220. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
  221. package/dist/services/msads/rate-limit-keys.js +3 -0
  222. package/dist/services/msads/rate-limit-keys.js.map +1 -0
  223. package/dist/services/msads/types.d.ts +196 -0
  224. package/dist/services/msads/types.d.ts.map +1 -0
  225. package/dist/services/msads/types.js +47 -0
  226. package/dist/services/msads/types.js.map +1 -0
  227. package/dist/services/session-services.d.ts +22 -0
  228. package/dist/services/session-services.d.ts.map +1 -0
  229. package/dist/services/session-services.js +22 -0
  230. package/dist/services/session-services.js.map +1 -0
  231. package/dist/types-global/mcp.d.ts +2 -0
  232. package/dist/types-global/mcp.d.ts.map +1 -0
  233. package/dist/types-global/mcp.js +2 -0
  234. package/dist/types-global/mcp.js.map +1 -0
  235. package/dist/utils/errors/index.d.ts +2 -0
  236. package/dist/utils/errors/index.d.ts.map +1 -0
  237. package/dist/utils/errors/index.js +2 -0
  238. package/dist/utils/errors/index.js.map +1 -0
  239. package/dist/utils/platform.d.ts +3 -0
  240. package/dist/utils/platform.d.ts.map +1 -0
  241. package/dist/utils/platform.js +5 -0
  242. package/dist/utils/platform.js.map +1 -0
  243. package/dist/utils/security/rate-limiter.d.ts +3 -0
  244. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  245. package/dist/utils/security/rate-limiter.js +5 -0
  246. package/dist/utils/security/rate-limiter.js.map +1 -0
  247. package/dist/utils/telemetry/index.d.ts +2 -0
  248. package/dist/utils/telemetry/index.d.ts.map +1 -0
  249. package/dist/utils/telemetry/index.js +2 -0
  250. package/dist/utils/telemetry/index.js.map +1 -0
  251. package/dist/utils/telemetry/tracing.d.ts +3 -0
  252. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  253. package/dist/utils/telemetry/tracing.js +4 -0
  254. package/dist/utils/telemetry/tracing.js.map +1 -0
  255. package/package.json +56 -0
@@ -0,0 +1,94 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { getEntityTypeEnum } from "../utils/entity-mapping.js";
4
+ import { elicitBulkDeleteConfirmation } from "@cesteral/shared";
5
+ const TOOL_NAME = "msads_delete_entity";
6
+ const TOOL_TITLE = "Delete Microsoft Ads Entity";
7
+ const TOOL_DESCRIPTION = `Delete one or more Microsoft Advertising entities by their IDs.
8
+
9
+ This is a destructive operation — entities will be permanently deleted.`;
10
+ export const DeleteEntityInputSchema = z
11
+ .object({
12
+ entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to delete"),
13
+ entityIds: z.array(z.string()).min(1).describe("Array of entity IDs to delete"),
14
+ additionalParams: z
15
+ .record(z.unknown())
16
+ .optional()
17
+ .describe("Additional parameters (e.g., AccountId)"),
18
+ })
19
+ .describe("Parameters for deleting Microsoft Ads entities");
20
+ export const DeleteEntityOutputSchema = z
21
+ .object({
22
+ confirmed: z.boolean(),
23
+ declineReason: z.string().optional(),
24
+ result: z.record(z.any()),
25
+ entityType: z.string(),
26
+ deletedCount: z.number(),
27
+ timestamp: z.string().datetime(),
28
+ })
29
+ .describe("Entity deletion result");
30
+ export async function deleteEntityLogic(input, context, sdkContext) {
31
+ const confirmed = await elicitBulkDeleteConfirmation({
32
+ count: input.entityIds.length,
33
+ entityLabel: input.entityType,
34
+ impactPreview: input.entityIds,
35
+ sdkContext,
36
+ });
37
+ if (!confirmed) {
38
+ return {
39
+ confirmed: false,
40
+ declineReason: "user_declined",
41
+ result: {},
42
+ entityType: input.entityType,
43
+ deletedCount: 0,
44
+ timestamp: new Date().toISOString(),
45
+ };
46
+ }
47
+ const { msadsService } = resolveSessionServices(sdkContext);
48
+ const result = (await msadsService.deleteEntity(input.entityType, input.entityIds, input.additionalParams, context));
49
+ return {
50
+ confirmed: true,
51
+ result,
52
+ entityType: input.entityType,
53
+ deletedCount: input.entityIds.length,
54
+ timestamp: new Date().toISOString(),
55
+ };
56
+ }
57
+ export function deleteEntityResponseFormatter(result) {
58
+ if (!result.confirmed) {
59
+ return [
60
+ {
61
+ type: "text",
62
+ text: `Bulk deletion of ${result.entityType} entities cancelled by user.\n\nTimestamp: ${result.timestamp}`,
63
+ },
64
+ ];
65
+ }
66
+ return [
67
+ {
68
+ type: "text",
69
+ text: `Deleted ${result.deletedCount} ${result.entityType} entities\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
70
+ },
71
+ ];
72
+ }
73
+ export const deleteEntityTool = {
74
+ name: TOOL_NAME,
75
+ title: TOOL_TITLE,
76
+ description: TOOL_DESCRIPTION,
77
+ inputSchema: DeleteEntityInputSchema,
78
+ outputSchema: DeleteEntityOutputSchema,
79
+ annotations: {
80
+ readOnlyHint: false,
81
+ openWorldHint: false,
82
+ idempotentHint: false,
83
+ destructiveHint: true,
84
+ },
85
+ inputExamples: [
86
+ {
87
+ label: "Delete campaigns",
88
+ input: { entityType: "campaign", entityIds: ["123456", "789012"] },
89
+ },
90
+ ],
91
+ logic: deleteEntityLogic,
92
+ responseFormatter: deleteEntityResponseFormatter,
93
+ };
94
+ //# 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":"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"}
@@ -0,0 +1,79 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const DeleteReportScheduleInputSchema: z.ZodObject<{
4
+ scheduleId: z.ZodString;
5
+ }, "strip", z.ZodTypeAny, {
6
+ scheduleId: string;
7
+ }, {
8
+ scheduleId: string;
9
+ }>;
10
+ export declare const DeleteReportScheduleOutputSchema: z.ZodObject<{
11
+ confirmed: z.ZodBoolean;
12
+ declineReason: z.ZodOptional<z.ZodString>;
13
+ scheduleId: z.ZodString;
14
+ note: z.ZodString;
15
+ timestamp: z.ZodString;
16
+ }, "strip", z.ZodTypeAny, {
17
+ scheduleId: string;
18
+ note: string;
19
+ timestamp: string;
20
+ confirmed: boolean;
21
+ declineReason?: string | undefined;
22
+ }, {
23
+ scheduleId: string;
24
+ note: string;
25
+ timestamp: string;
26
+ confirmed: boolean;
27
+ declineReason?: string | undefined;
28
+ }>;
29
+ type DeleteReportScheduleInput = z.infer<typeof DeleteReportScheduleInputSchema>;
30
+ type DeleteReportScheduleOutput = z.infer<typeof DeleteReportScheduleOutputSchema>;
31
+ export declare function deleteReportScheduleLogic(input: DeleteReportScheduleInput, context: RequestContext, sdkContext?: SdkContext): Promise<DeleteReportScheduleOutput>;
32
+ export declare function deleteReportScheduleResponseFormatter(result: DeleteReportScheduleOutput): McpTextContent[];
33
+ export declare const deleteReportScheduleTool: {
34
+ name: string;
35
+ title: string;
36
+ description: string;
37
+ inputSchema: z.ZodObject<{
38
+ scheduleId: z.ZodString;
39
+ }, "strip", z.ZodTypeAny, {
40
+ scheduleId: string;
41
+ }, {
42
+ scheduleId: string;
43
+ }>;
44
+ outputSchema: z.ZodObject<{
45
+ confirmed: z.ZodBoolean;
46
+ declineReason: z.ZodOptional<z.ZodString>;
47
+ scheduleId: z.ZodString;
48
+ note: z.ZodString;
49
+ timestamp: z.ZodString;
50
+ }, "strip", z.ZodTypeAny, {
51
+ scheduleId: string;
52
+ note: string;
53
+ timestamp: string;
54
+ confirmed: boolean;
55
+ declineReason?: string | undefined;
56
+ }, {
57
+ scheduleId: string;
58
+ note: string;
59
+ timestamp: string;
60
+ confirmed: boolean;
61
+ declineReason?: string | undefined;
62
+ }>;
63
+ annotations: {
64
+ readOnlyHint: boolean;
65
+ openWorldHint: boolean;
66
+ destructiveHint: boolean;
67
+ idempotentHint: boolean;
68
+ };
69
+ inputExamples: {
70
+ label: string;
71
+ input: {
72
+ scheduleId: string;
73
+ };
74
+ }[];
75
+ logic: typeof deleteReportScheduleLogic;
76
+ responseFormatter: typeof deleteReportScheduleResponseFormatter;
77
+ };
78
+ export {};
79
+ //# 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;AAUnF,eAAO,MAAM,+BAA+B;;;;;;EAI0B,CAAC;AAEvE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;EAQN,CAAC;AAExC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBpC,CAAC"}
@@ -0,0 +1,88 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { elicitDeleteConfirmation } from "@cesteral/shared";
4
+ const TOOL_NAME = "msads_delete_report_schedule";
5
+ const TOOL_TITLE = "Delete Microsoft Ads Report Schedule";
6
+ const TOOL_DESCRIPTION = `Delete (cancel) a Microsoft Advertising report schedule.
7
+
8
+ Note: The Microsoft Advertising API v13 JSON endpoints do not provide a programmatic endpoint to cancel or delete scheduled reports. Deletion must be performed via the Microsoft Advertising UI at app.ads.microsoft.com → Reports → Scheduled Reports.
9
+
10
+ This tool logs the deletion request and returns instructions for manual removal.`;
11
+ export const DeleteReportScheduleInputSchema = z
12
+ .object({
13
+ scheduleId: z.string().min(1).describe("Schedule ID returned by msads_create_report_schedule"),
14
+ })
15
+ .describe("Parameters for deleting a Microsoft Ads report schedule");
16
+ export const DeleteReportScheduleOutputSchema = z
17
+ .object({
18
+ confirmed: z.boolean(),
19
+ declineReason: z.string().optional(),
20
+ scheduleId: z.string(),
21
+ note: z.string().describe("Instructions for completing deletion"),
22
+ timestamp: z.string().datetime(),
23
+ })
24
+ .describe("Delete schedule response");
25
+ export async function deleteReportScheduleLogic(input, context, sdkContext) {
26
+ const confirmed = await elicitDeleteConfirmation({
27
+ entityLabel: "report schedule",
28
+ entityId: input.scheduleId,
29
+ sdkContext,
30
+ });
31
+ if (!confirmed) {
32
+ return {
33
+ confirmed: false,
34
+ declineReason: "user_declined",
35
+ scheduleId: input.scheduleId,
36
+ note: "Deletion cancelled by user.",
37
+ timestamp: new Date().toISOString(),
38
+ };
39
+ }
40
+ const { msadsReportingService } = resolveSessionServices(sdkContext);
41
+ await msadsReportingService.deleteReportSchedule(input.scheduleId, context);
42
+ return {
43
+ confirmed: true,
44
+ scheduleId: input.scheduleId,
45
+ note: `To delete schedule ${input.scheduleId}: visit app.ads.microsoft.com → Reports → Scheduled Reports and remove the report manually. The Microsoft Advertising REST API does not provide a programmatic delete endpoint.`,
46
+ timestamp: new Date().toISOString(),
47
+ };
48
+ }
49
+ export function deleteReportScheduleResponseFormatter(result) {
50
+ if (!result.confirmed) {
51
+ return [
52
+ {
53
+ type: "text",
54
+ text: `Deletion of report schedule ${result.scheduleId} cancelled by user.\n\nTimestamp: ${result.timestamp}`,
55
+ },
56
+ ];
57
+ }
58
+ return [
59
+ {
60
+ type: "text",
61
+ text: `Schedule ${result.scheduleId} deletion requested.\n\n${result.note}\n\nTimestamp: ${result.timestamp}`,
62
+ },
63
+ ];
64
+ }
65
+ export const deleteReportScheduleTool = {
66
+ name: TOOL_NAME,
67
+ title: TOOL_TITLE,
68
+ description: TOOL_DESCRIPTION,
69
+ inputSchema: DeleteReportScheduleInputSchema,
70
+ outputSchema: DeleteReportScheduleOutputSchema,
71
+ annotations: {
72
+ readOnlyHint: false,
73
+ openWorldHint: false,
74
+ destructiveHint: true,
75
+ idempotentHint: true,
76
+ },
77
+ inputExamples: [
78
+ {
79
+ label: "Delete a scheduled report",
80
+ input: {
81
+ scheduleId: "abc123def456",
82
+ },
83
+ },
84
+ ],
85
+ logic: deleteReportScheduleLogic,
86
+ responseFormatter: deleteReportScheduleResponseFormatter,
87
+ };
88
+ //# 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,287 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const DownloadReportInputSchema: z.ZodObject<{
4
+ downloadUrl: z.ZodString;
5
+ storeRawCsv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
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: "rows" | "summary";
18
+ storeRawCsv: boolean;
19
+ includeComputedMetrics: boolean;
20
+ columns?: string[] | undefined;
21
+ offset?: number | undefined;
22
+ maxRows?: number | undefined;
23
+ aggregateBy?: string[] | undefined;
24
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
25
+ }, {
26
+ downloadUrl: string;
27
+ columns?: string[] | undefined;
28
+ mode?: "rows" | "summary" | undefined;
29
+ offset?: number | undefined;
30
+ maxRows?: number | undefined;
31
+ aggregateBy?: string[] | undefined;
32
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
33
+ storeRawCsv?: boolean | undefined;
34
+ includeComputedMetrics?: boolean | undefined;
35
+ }>;
36
+ export declare const DownloadReportOutputSchema: z.ZodObject<{
37
+ rawCsvResourceUri: z.ZodOptional<z.ZodString>;
38
+ rawCsvByteLength: z.ZodOptional<z.ZodNumber>;
39
+ spill: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
40
+ bucket: z.ZodString;
41
+ objectName: z.ZodString;
42
+ bytes: z.ZodNumber;
43
+ rowCount: z.ZodOptional<z.ZodNumber>;
44
+ signedUrl: z.ZodString;
45
+ expiresAt: z.ZodString;
46
+ mimeType: z.ZodString;
47
+ }, "strip", z.ZodTypeAny, {
48
+ bucket: string;
49
+ objectName: string;
50
+ bytes: number;
51
+ signedUrl: string;
52
+ expiresAt: string;
53
+ mimeType: string;
54
+ rowCount?: number | undefined;
55
+ }, {
56
+ bucket: string;
57
+ objectName: string;
58
+ bytes: number;
59
+ signedUrl: string;
60
+ expiresAt: string;
61
+ mimeType: string;
62
+ rowCount?: number | undefined;
63
+ }>, z.ZodObject<{
64
+ error: z.ZodString;
65
+ }, "strip", z.ZodTypeAny, {
66
+ error: string;
67
+ }, {
68
+ error: string;
69
+ }>]>>;
70
+ timestamp: z.ZodString;
71
+ totalRows: z.ZodNumber;
72
+ returnedRows: z.ZodNumber;
73
+ truncated: z.ZodBoolean;
74
+ nextOffset: z.ZodNullable<z.ZodNumber>;
75
+ headers: z.ZodArray<z.ZodString, "many">;
76
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
77
+ mode: z.ZodEnum<["summary", "rows"]>;
78
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
79
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
80
+ warnings: z.ZodArray<z.ZodString, "many">;
81
+ }, "strip", z.ZodTypeAny, {
82
+ headers: string[];
83
+ totalRows: number;
84
+ timestamp: string;
85
+ mode: "rows" | "summary";
86
+ returnedRows: number;
87
+ truncated: boolean;
88
+ nextOffset: number | null;
89
+ selectedColumns: string[];
90
+ warnings: string[];
91
+ rows?: Record<string, any>[] | undefined;
92
+ previewRows?: Record<string, any>[] | undefined;
93
+ rawCsvResourceUri?: string | undefined;
94
+ rawCsvByteLength?: number | undefined;
95
+ spill?: {
96
+ bucket: string;
97
+ objectName: string;
98
+ bytes: number;
99
+ signedUrl: string;
100
+ expiresAt: string;
101
+ mimeType: string;
102
+ rowCount?: number | undefined;
103
+ } | {
104
+ error: string;
105
+ } | undefined;
106
+ }, {
107
+ headers: string[];
108
+ totalRows: number;
109
+ timestamp: string;
110
+ mode: "rows" | "summary";
111
+ returnedRows: number;
112
+ truncated: boolean;
113
+ nextOffset: number | null;
114
+ selectedColumns: string[];
115
+ warnings: string[];
116
+ rows?: Record<string, any>[] | undefined;
117
+ previewRows?: Record<string, any>[] | undefined;
118
+ rawCsvResourceUri?: string | undefined;
119
+ rawCsvByteLength?: number | undefined;
120
+ spill?: {
121
+ bucket: string;
122
+ objectName: string;
123
+ bytes: number;
124
+ signedUrl: string;
125
+ expiresAt: string;
126
+ mimeType: string;
127
+ rowCount?: number | undefined;
128
+ } | {
129
+ error: string;
130
+ } | undefined;
131
+ }>;
132
+ type DownloadReportInput = z.infer<typeof DownloadReportInputSchema>;
133
+ type DownloadReportOutput = z.infer<typeof DownloadReportOutputSchema>;
134
+ export declare function downloadReportLogic(input: DownloadReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<DownloadReportOutput>;
135
+ export declare function downloadReportResponseFormatter(result: DownloadReportOutput): McpTextContent[];
136
+ export declare const downloadReportTool: {
137
+ name: string;
138
+ title: string;
139
+ description: string;
140
+ inputSchema: z.ZodObject<{
141
+ downloadUrl: z.ZodString;
142
+ storeRawCsv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
143
+ } & {
144
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
145
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
146
+ offset: z.ZodOptional<z.ZodNumber>;
147
+ maxRows: z.ZodOptional<z.ZodNumber>;
148
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
149
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
150
+ } & {
151
+ includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
152
+ }, "strip", z.ZodTypeAny, {
153
+ downloadUrl: string;
154
+ mode: "rows" | "summary";
155
+ storeRawCsv: boolean;
156
+ includeComputedMetrics: boolean;
157
+ columns?: string[] | undefined;
158
+ offset?: number | undefined;
159
+ maxRows?: number | undefined;
160
+ aggregateBy?: string[] | undefined;
161
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
162
+ }, {
163
+ downloadUrl: string;
164
+ columns?: string[] | undefined;
165
+ mode?: "rows" | "summary" | undefined;
166
+ offset?: number | undefined;
167
+ maxRows?: number | undefined;
168
+ aggregateBy?: string[] | undefined;
169
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
170
+ storeRawCsv?: boolean | undefined;
171
+ includeComputedMetrics?: boolean | undefined;
172
+ }>;
173
+ outputSchema: z.ZodObject<{
174
+ rawCsvResourceUri: z.ZodOptional<z.ZodString>;
175
+ rawCsvByteLength: z.ZodOptional<z.ZodNumber>;
176
+ spill: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
177
+ bucket: z.ZodString;
178
+ objectName: z.ZodString;
179
+ bytes: z.ZodNumber;
180
+ rowCount: z.ZodOptional<z.ZodNumber>;
181
+ signedUrl: z.ZodString;
182
+ expiresAt: z.ZodString;
183
+ mimeType: z.ZodString;
184
+ }, "strip", z.ZodTypeAny, {
185
+ bucket: string;
186
+ objectName: string;
187
+ bytes: number;
188
+ signedUrl: string;
189
+ expiresAt: string;
190
+ mimeType: string;
191
+ rowCount?: number | undefined;
192
+ }, {
193
+ bucket: string;
194
+ objectName: string;
195
+ bytes: number;
196
+ signedUrl: string;
197
+ expiresAt: string;
198
+ mimeType: string;
199
+ rowCount?: number | undefined;
200
+ }>, z.ZodObject<{
201
+ error: z.ZodString;
202
+ }, "strip", z.ZodTypeAny, {
203
+ error: string;
204
+ }, {
205
+ error: string;
206
+ }>]>>;
207
+ timestamp: z.ZodString;
208
+ totalRows: z.ZodNumber;
209
+ returnedRows: z.ZodNumber;
210
+ truncated: z.ZodBoolean;
211
+ nextOffset: z.ZodNullable<z.ZodNumber>;
212
+ headers: z.ZodArray<z.ZodString, "many">;
213
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
214
+ mode: z.ZodEnum<["summary", "rows"]>;
215
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
216
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
217
+ warnings: z.ZodArray<z.ZodString, "many">;
218
+ }, "strip", z.ZodTypeAny, {
219
+ headers: string[];
220
+ totalRows: number;
221
+ timestamp: string;
222
+ mode: "rows" | "summary";
223
+ returnedRows: number;
224
+ truncated: boolean;
225
+ nextOffset: number | null;
226
+ selectedColumns: string[];
227
+ warnings: string[];
228
+ rows?: Record<string, any>[] | undefined;
229
+ previewRows?: Record<string, any>[] | undefined;
230
+ rawCsvResourceUri?: string | undefined;
231
+ rawCsvByteLength?: number | undefined;
232
+ spill?: {
233
+ bucket: string;
234
+ objectName: string;
235
+ bytes: number;
236
+ signedUrl: string;
237
+ expiresAt: string;
238
+ mimeType: string;
239
+ rowCount?: number | undefined;
240
+ } | {
241
+ error: string;
242
+ } | undefined;
243
+ }, {
244
+ headers: string[];
245
+ totalRows: number;
246
+ timestamp: string;
247
+ mode: "rows" | "summary";
248
+ returnedRows: number;
249
+ truncated: boolean;
250
+ nextOffset: number | null;
251
+ selectedColumns: string[];
252
+ warnings: string[];
253
+ rows?: Record<string, any>[] | undefined;
254
+ previewRows?: Record<string, any>[] | undefined;
255
+ rawCsvResourceUri?: string | undefined;
256
+ rawCsvByteLength?: number | undefined;
257
+ spill?: {
258
+ bucket: string;
259
+ objectName: string;
260
+ bytes: number;
261
+ signedUrl: string;
262
+ expiresAt: string;
263
+ mimeType: string;
264
+ rowCount?: number | undefined;
265
+ } | {
266
+ error: string;
267
+ } | undefined;
268
+ }>;
269
+ annotations: {
270
+ readOnlyHint: boolean;
271
+ openWorldHint: boolean;
272
+ idempotentHint: boolean;
273
+ destructiveHint: boolean;
274
+ };
275
+ inputExamples: {
276
+ label: string;
277
+ input: {
278
+ downloadUrl: string;
279
+ mode: string;
280
+ maxRows: number;
281
+ };
282
+ }[];
283
+ logic: typeof downloadReportLogic;
284
+ responseFormatter: typeof downloadReportResponseFormatter;
285
+ };
286
+ export {};
287
+ //# 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;AAaxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc0B,CAAC;AAEjE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;gBAlBuD,CAAC;;;;;;;;gBAOzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB8B,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;AAUvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAgB/B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAO9F;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBApE+D,CAAC;;;;;;;;oBAOzF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFN,CAAC"}
@@ -0,0 +1,85 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { reportCsvStore } from "../../../services/session-services.js";
4
+ import { ComputedMetricsFlagSchema, createServiceDownloadedReportView, extractReportIdFromUrl, formatReportViewResponse, ReportViewInputSchema, ReportViewOutputSchema, StoredReportBodyOutputSchema, spillBodyToGcs, } from "@cesteral/shared";
5
+ const TOOL_NAME = "msads_download_report";
6
+ const TOOL_TITLE = "Download Microsoft Ads Report";
7
+ const TOOL_DESCRIPTION = `Download and parse a completed Microsoft Advertising report from its download URL.
8
+
9
+ Use after msads_check_report_status returns a downloadUrl. Returns a bounded summary or paged row slice.`;
10
+ export const DownloadReportInputSchema = z
11
+ .object({
12
+ downloadUrl: z.string().url().describe("Report download URL from check-report-status"),
13
+ storeRawCsv: z
14
+ .boolean()
15
+ .optional()
16
+ .default(false)
17
+ .describe("Persist the full CSV body in the in-process report-csv store and return " +
18
+ "a `report-csv://{id}` resource URI. Entries expire after 30 minutes."),
19
+ })
20
+ .merge(ReportViewInputSchema)
21
+ .merge(ComputedMetricsFlagSchema)
22
+ .describe("Parameters for downloading a Microsoft Ads report");
23
+ export const DownloadReportOutputSchema = z
24
+ .object({
25
+ ...ReportViewOutputSchema.shape,
26
+ timestamp: z.string().datetime(),
27
+ ...StoredReportBodyOutputSchema.shape,
28
+ })
29
+ .describe("Downloaded report data");
30
+ const MSADS_COMPUTED_METRIC_ALIASES = {
31
+ cost: ["Spend", "spend", "Cost", "cost"],
32
+ impressions: ["Impressions", "impressions"],
33
+ clicks: ["Clicks", "clicks"],
34
+ conversions: ["Conversions", "conversions", "AllConversions"],
35
+ conversionValue: ["Revenue", "revenue", "AllRevenue"],
36
+ };
37
+ export async function downloadReportLogic(input, context, sdkContext) {
38
+ const { msadsReportingService } = resolveSessionServices(sdkContext);
39
+ return createServiceDownloadedReportView({
40
+ input,
41
+ sessionId: sdkContext?.sessionId,
42
+ reportCsvStore,
43
+ spillBodyToGcs,
44
+ spillServer: "microsoft",
45
+ reportId: extractReportIdFromUrl(input.downloadUrl),
46
+ computedMetricAliases: MSADS_COMPUTED_METRIC_ALIASES,
47
+ download: ({ fetchLimit, includeRawCsv }) => msadsReportingService.downloadReport(input.downloadUrl, fetchLimit, context, {
48
+ includeRawCsv,
49
+ }),
50
+ });
51
+ }
52
+ export function downloadReportResponseFormatter(result) {
53
+ return [
54
+ {
55
+ type: "text",
56
+ text: formatReportViewResponse(result, "Downloaded report"),
57
+ },
58
+ ];
59
+ }
60
+ export const downloadReportTool = {
61
+ name: TOOL_NAME,
62
+ title: TOOL_TITLE,
63
+ description: TOOL_DESCRIPTION,
64
+ inputSchema: DownloadReportInputSchema,
65
+ outputSchema: DownloadReportOutputSchema,
66
+ annotations: {
67
+ readOnlyHint: true,
68
+ openWorldHint: false,
69
+ idempotentHint: true,
70
+ destructiveHint: false,
71
+ },
72
+ inputExamples: [
73
+ {
74
+ label: "Download a report",
75
+ input: {
76
+ downloadUrl: "https://download.api.bingads.microsoft.com/reports/...",
77
+ mode: "rows",
78
+ maxRows: 50,
79
+ },
80
+ },
81
+ ],
82
+ logic: downloadReportLogic,
83
+ responseFormatter: downloadReportResponseFormatter,
84
+ };
85
+ //# 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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"}