@cesteral/ttd-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 (427) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +308 -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/ttd-auth-adapter.d.ts +21 -0
  8. package/dist/auth/ttd-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/ttd-auth-adapter.js +70 -0
  10. package/dist/auth/ttd-auth-adapter.js.map +1 -0
  11. package/dist/auth/ttd-auth-strategy.d.ts +10 -0
  12. package/dist/auth/ttd-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/ttd-auth-strategy.js +28 -0
  14. package/dist/auth/ttd-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +100 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +47 -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 +45 -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 +286 -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 +245 -0
  30. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.js +102 -0
  34. package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
  38. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
  42. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
  44. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +215 -0
  46. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
  47. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
  48. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
  49. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +162 -0
  50. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
  51. package/dist/mcp-server/prompts/definitions/report-generation-workflow.prompt.d.ts +4 -0
  52. package/dist/mcp-server/prompts/definitions/report-generation-workflow.prompt.d.ts.map +1 -0
  53. package/dist/mcp-server/prompts/definitions/report-generation-workflow.prompt.js +163 -0
  54. package/dist/mcp-server/prompts/definitions/report-generation-workflow.prompt.js.map +1 -0
  55. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
  56. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
  57. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +259 -0
  58. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
  59. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
  60. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
  61. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +193 -0
  62. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
  63. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  64. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  65. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +119 -0
  66. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  67. package/dist/mcp-server/prompts/index.d.ts +9 -0
  68. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  69. package/dist/mcp-server/prompts/index.js +97 -0
  70. package/dist/mcp-server/prompts/index.js.map +1 -0
  71. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  72. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +388 -0
  74. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  75. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  76. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +145 -0
  78. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  79. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  80. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +318 -0
  82. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  83. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
  84. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
  85. package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
  86. package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
  87. package/dist/mcp-server/resources/definitions/graphql-reference.resource.d.ts +3 -0
  88. package/dist/mcp-server/resources/definitions/graphql-reference.resource.d.ts.map +1 -0
  89. package/dist/mcp-server/resources/definitions/graphql-reference.resource.js +442 -0
  90. package/dist/mcp-server/resources/definitions/graphql-reference.resource.js.map +1 -0
  91. package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
  92. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  93. package/dist/mcp-server/resources/definitions/index.js +108 -0
  94. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  95. package/dist/mcp-server/resources/definitions/report-reference.resource.d.ts +3 -0
  96. package/dist/mcp-server/resources/definitions/report-reference.resource.d.ts.map +1 -0
  97. package/dist/mcp-server/resources/definitions/report-reference.resource.js +291 -0
  98. package/dist/mcp-server/resources/definitions/report-reference.resource.js.map +1 -0
  99. package/dist/mcp-server/resources/index.d.ts +3 -0
  100. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  101. package/dist/mcp-server/resources/index.js +2 -0
  102. package/dist/mcp-server/resources/index.js.map +1 -0
  103. package/dist/mcp-server/resources/types.d.ts +8 -0
  104. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  105. package/dist/mcp-server/resources/types.js +2 -0
  106. package/dist/mcp-server/resources/types.js.map +1 -0
  107. package/dist/mcp-server/resources/utils/field-rules.d.ts +18 -0
  108. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
  109. package/dist/mcp-server/resources/utils/field-rules.js +117 -0
  110. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
  111. package/dist/mcp-server/server.d.ts +5 -0
  112. package/dist/mcp-server/server.d.ts.map +1 -0
  113. package/dist/mcp-server/server.js +162 -0
  114. package/dist/mcp-server/server.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +1137 -0
  116. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +165 -0
  118. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/archive-entities.tool.d.ts +145 -0
  120. package/dist/mcp-server/tools/definitions/archive-entities.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/archive-entities.tool.js +120 -0
  122. package/dist/mcp-server/tools/definitions/archive-entities.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/bid-list-bulk.tool.d.ts +174 -0
  124. package/dist/mcp-server/tools/definitions/bid-list-bulk.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/bid-list-bulk.tool.js +141 -0
  126. package/dist/mcp-server/tools/definitions/bid-list-bulk.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/bid-list.tool.d.ts +225 -0
  128. package/dist/mcp-server/tools/definitions/bid-list.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/bid-list.tool.js +169 -0
  130. package/dist/mcp-server/tools/definitions/bid-list.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +198 -0
  132. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +135 -0
  134. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +258 -0
  136. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +187 -0
  138. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +170 -0
  140. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +137 -0
  142. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.d.ts +109 -0
  144. package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.js +134 -0
  146. package/dist/mcp-server/tools/definitions/cancel-report-execution.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +112 -0
  148. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +94 -0
  150. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.d.ts +181 -0
  152. package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.js +52 -0
  154. package/dist/mcp-server/tools/definitions/create-ad-group-workflow.tool.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/create-ad-groups-job.tool.d.ts +300 -0
  156. package/dist/mcp-server/tools/definitions/create-ad-groups-job.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/create-ad-groups-job.tool.js +63 -0
  158. package/dist/mcp-server/tools/definitions/create-ad-groups-job.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/create-ad-groups.tool.d.ts +482 -0
  160. package/dist/mcp-server/tools/definitions/create-ad-groups.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/create-ad-groups.tool.js +121 -0
  162. package/dist/mcp-server/tools/definitions/create-ad-groups.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/create-campaign-workflow.tool.d.ts +172 -0
  164. package/dist/mcp-server/tools/definitions/create-campaign-workflow.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/create-campaign-workflow.tool.js +55 -0
  166. package/dist/mcp-server/tools/definitions/create-campaign-workflow.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/create-campaigns-job.tool.d.ts +286 -0
  168. package/dist/mcp-server/tools/definitions/create-campaigns-job.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/create-campaigns-job.tool.js +63 -0
  170. package/dist/mcp-server/tools/definitions/create-campaigns-job.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/create-campaigns.tool.d.ts +458 -0
  172. package/dist/mcp-server/tools/definitions/create-campaigns.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/create-campaigns.tool.js +124 -0
  174. package/dist/mcp-server/tools/definitions/create-campaigns.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +196 -0
  176. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/create-entity.tool.js +126 -0
  178. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +147 -0
  180. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +171 -0
  182. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/create-report-template.tool.d.ts +370 -0
  184. package/dist/mcp-server/tools/definitions/create-report-template.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/create-report-template.tool.js +224 -0
  186. package/dist/mcp-server/tools/definitions/create-report-template.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/create-template-schedule.tool.d.ts +316 -0
  188. package/dist/mcp-server/tools/definitions/create-template-schedule.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/create-template-schedule.tool.js +247 -0
  190. package/dist/mcp-server/tools/definitions/create-template-schedule.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +147 -0
  192. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +112 -0
  194. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  195. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
  196. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +89 -0
  198. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
  199. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +297 -0
  200. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/definitions/download-report.tool.js +160 -0
  202. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  203. package/dist/mcp-server/tools/definitions/execute-entity-report.tool.d.ts +147 -0
  204. package/dist/mcp-server/tools/definitions/execute-entity-report.tool.d.ts.map +1 -0
  205. package/dist/mcp-server/tools/definitions/execute-entity-report.tool.js +134 -0
  206. package/dist/mcp-server/tools/definitions/execute-entity-report.tool.js.map +1 -0
  207. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +80 -0
  208. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  209. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +82 -0
  210. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  211. package/dist/mcp-server/tools/definitions/get-campaign-version.tool.d.ts +61 -0
  212. package/dist/mcp-server/tools/definitions/get-campaign-version.tool.d.ts.map +1 -0
  213. package/dist/mcp-server/tools/definitions/get-campaign-version.tool.js +51 -0
  214. package/dist/mcp-server/tools/definitions/get-campaign-version.tool.js.map +1 -0
  215. package/dist/mcp-server/tools/definitions/get-context.tool.d.ts +77 -0
  216. package/dist/mcp-server/tools/definitions/get-context.tool.d.ts.map +1 -0
  217. package/dist/mcp-server/tools/definitions/get-context.tool.js +80 -0
  218. package/dist/mcp-server/tools/definitions/get-context.tool.js.map +1 -0
  219. package/dist/mcp-server/tools/definitions/get-entity-report-types.tool.d.ts +169 -0
  220. package/dist/mcp-server/tools/definitions/get-entity-report-types.tool.d.ts.map +1 -0
  221. package/dist/mcp-server/tools/definitions/get-entity-report-types.tool.js +138 -0
  222. package/dist/mcp-server/tools/definitions/get-entity-report-types.tool.js.map +1 -0
  223. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +129 -0
  224. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  225. package/dist/mcp-server/tools/definitions/get-entity.tool.js +88 -0
  226. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  227. package/dist/mcp-server/tools/definitions/get-first-party-data-job.tool.d.ts +110 -0
  228. package/dist/mcp-server/tools/definitions/get-first-party-data-job.tool.d.ts.map +1 -0
  229. package/dist/mcp-server/tools/definitions/get-first-party-data-job.tool.js +58 -0
  230. package/dist/mcp-server/tools/definitions/get-first-party-data-job.tool.js.map +1 -0
  231. package/dist/mcp-server/tools/definitions/get-job-status.tool.d.ts +61 -0
  232. package/dist/mcp-server/tools/definitions/get-job-status.tool.d.ts.map +1 -0
  233. package/dist/mcp-server/tools/definitions/get-job-status.tool.js +54 -0
  234. package/dist/mcp-server/tools/definitions/get-job-status.tool.js.map +1 -0
  235. package/dist/mcp-server/tools/definitions/get-report-executions.tool.d.ts +131 -0
  236. package/dist/mcp-server/tools/definitions/get-report-executions.tool.d.ts.map +1 -0
  237. package/dist/mcp-server/tools/definitions/get-report-executions.tool.js +253 -0
  238. package/dist/mcp-server/tools/definitions/get-report-executions.tool.js.map +1 -0
  239. package/dist/mcp-server/tools/definitions/get-report-schedule.tool.d.ts +197 -0
  240. package/dist/mcp-server/tools/definitions/get-report-schedule.tool.d.ts.map +1 -0
  241. package/dist/mcp-server/tools/definitions/get-report-schedule.tool.js +66 -0
  242. package/dist/mcp-server/tools/definitions/get-report-schedule.tool.js.map +1 -0
  243. package/dist/mcp-server/tools/definitions/get-report-template.tool.d.ts +303 -0
  244. package/dist/mcp-server/tools/definitions/get-report-template.tool.d.ts.map +1 -0
  245. package/dist/mcp-server/tools/definitions/get-report-template.tool.js +139 -0
  246. package/dist/mcp-server/tools/definitions/get-report-template.tool.js.map +1 -0
  247. package/dist/mcp-server/tools/definitions/get-report-type-schema.tool.d.ts +152 -0
  248. package/dist/mcp-server/tools/definitions/get-report-type-schema.tool.d.ts.map +1 -0
  249. package/dist/mcp-server/tools/definitions/get-report-type-schema.tool.js +167 -0
  250. package/dist/mcp-server/tools/definitions/get-report-type-schema.tool.js.map +1 -0
  251. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +126 -0
  252. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
  253. package/dist/mcp-server/tools/definitions/get-report.tool.js +138 -0
  254. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  255. package/dist/mcp-server/tools/definitions/get-third-party-data-job.tool.d.ts +104 -0
  256. package/dist/mcp-server/tools/definitions/get-third-party-data-job.tool.d.ts.map +1 -0
  257. package/dist/mcp-server/tools/definitions/get-third-party-data-job.tool.js +57 -0
  258. package/dist/mcp-server/tools/definitions/get-third-party-data-job.tool.js.map +1 -0
  259. package/dist/mcp-server/tools/definitions/graphql-bulk-job.tool.d.ts +92 -0
  260. package/dist/mcp-server/tools/definitions/graphql-bulk-job.tool.d.ts.map +1 -0
  261. package/dist/mcp-server/tools/definitions/graphql-bulk-job.tool.js +124 -0
  262. package/dist/mcp-server/tools/definitions/graphql-bulk-job.tool.js.map +1 -0
  263. package/dist/mcp-server/tools/definitions/graphql-cancel-bulk-job.tool.d.ts +68 -0
  264. package/dist/mcp-server/tools/definitions/graphql-cancel-bulk-job.tool.d.ts.map +1 -0
  265. package/dist/mcp-server/tools/definitions/graphql-cancel-bulk-job.tool.js +102 -0
  266. package/dist/mcp-server/tools/definitions/graphql-cancel-bulk-job.tool.js.map +1 -0
  267. package/dist/mcp-server/tools/definitions/graphql-mutation-bulk.tool.d.ts +102 -0
  268. package/dist/mcp-server/tools/definitions/graphql-mutation-bulk.tool.d.ts.map +1 -0
  269. package/dist/mcp-server/tools/definitions/graphql-mutation-bulk.tool.js +152 -0
  270. package/dist/mcp-server/tools/definitions/graphql-mutation-bulk.tool.js.map +1 -0
  271. package/dist/mcp-server/tools/definitions/graphql-query-bulk.tool.d.ts +93 -0
  272. package/dist/mcp-server/tools/definitions/graphql-query-bulk.tool.d.ts.map +1 -0
  273. package/dist/mcp-server/tools/definitions/graphql-query-bulk.tool.js +133 -0
  274. package/dist/mcp-server/tools/definitions/graphql-query-bulk.tool.js.map +1 -0
  275. package/dist/mcp-server/tools/definitions/graphql-query.tool.d.ts +189 -0
  276. package/dist/mcp-server/tools/definitions/graphql-query.tool.d.ts.map +1 -0
  277. package/dist/mcp-server/tools/definitions/graphql-query.tool.js +143 -0
  278. package/dist/mcp-server/tools/definitions/graphql-query.tool.js.map +1 -0
  279. package/dist/mcp-server/tools/definitions/index.d.ts +45 -0
  280. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  281. package/dist/mcp-server/tools/definitions/index.js +135 -0
  282. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  283. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +231 -0
  284. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  285. package/dist/mcp-server/tools/definitions/list-entities.tool.js +147 -0
  286. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  287. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +282 -0
  288. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
  289. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +128 -0
  290. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
  291. package/dist/mcp-server/tools/definitions/list-report-templates.tool.d.ts +140 -0
  292. package/dist/mcp-server/tools/definitions/list-report-templates.tool.d.ts.map +1 -0
  293. package/dist/mcp-server/tools/definitions/list-report-templates.tool.js +118 -0
  294. package/dist/mcp-server/tools/definitions/list-report-templates.tool.js.map +1 -0
  295. package/dist/mcp-server/tools/definitions/list-report-types.tool.d.ts +97 -0
  296. package/dist/mcp-server/tools/definitions/list-report-types.tool.d.ts.map +1 -0
  297. package/dist/mcp-server/tools/definitions/list-report-types.tool.js +89 -0
  298. package/dist/mcp-server/tools/definitions/list-report-types.tool.js.map +1 -0
  299. package/dist/mcp-server/tools/definitions/rerun-report-schedule.tool.d.ts +109 -0
  300. package/dist/mcp-server/tools/definitions/rerun-report-schedule.tool.d.ts.map +1 -0
  301. package/dist/mcp-server/tools/definitions/rerun-report-schedule.tool.js +130 -0
  302. package/dist/mcp-server/tools/definitions/rerun-report-schedule.tool.js.map +1 -0
  303. package/dist/mcp-server/tools/definitions/rest-request.tool.d.ts +74 -0
  304. package/dist/mcp-server/tools/definitions/rest-request.tool.d.ts.map +1 -0
  305. package/dist/mcp-server/tools/definitions/rest-request.tool.js +54 -0
  306. package/dist/mcp-server/tools/definitions/rest-request.tool.js.map +1 -0
  307. package/dist/mcp-server/tools/definitions/seed.tool.d.ts +156 -0
  308. package/dist/mcp-server/tools/definitions/seed.tool.d.ts.map +1 -0
  309. package/dist/mcp-server/tools/definitions/seed.tool.js +316 -0
  310. package/dist/mcp-server/tools/definitions/seed.tool.js.map +1 -0
  311. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +114 -0
  312. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  313. package/dist/mcp-server/tools/definitions/submit-report.tool.js +136 -0
  314. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  315. package/dist/mcp-server/tools/definitions/update-ad-group-workflow.tool.d.ts +82 -0
  316. package/dist/mcp-server/tools/definitions/update-ad-group-workflow.tool.d.ts.map +1 -0
  317. package/dist/mcp-server/tools/definitions/update-ad-group-workflow.tool.js +51 -0
  318. package/dist/mcp-server/tools/definitions/update-ad-group-workflow.tool.js.map +1 -0
  319. package/dist/mcp-server/tools/definitions/update-ad-groups-job.tool.d.ts +158 -0
  320. package/dist/mcp-server/tools/definitions/update-ad-groups-job.tool.d.ts.map +1 -0
  321. package/dist/mcp-server/tools/definitions/update-ad-groups-job.tool.js +63 -0
  322. package/dist/mcp-server/tools/definitions/update-ad-groups-job.tool.js.map +1 -0
  323. package/dist/mcp-server/tools/definitions/update-ad-groups.tool.d.ts +241 -0
  324. package/dist/mcp-server/tools/definitions/update-ad-groups.tool.d.ts.map +1 -0
  325. package/dist/mcp-server/tools/definitions/update-ad-groups.tool.js +120 -0
  326. package/dist/mcp-server/tools/definitions/update-ad-groups.tool.js.map +1 -0
  327. package/dist/mcp-server/tools/definitions/update-campaign-workflow.tool.d.ts +82 -0
  328. package/dist/mcp-server/tools/definitions/update-campaign-workflow.tool.d.ts.map +1 -0
  329. package/dist/mcp-server/tools/definitions/update-campaign-workflow.tool.js +53 -0
  330. package/dist/mcp-server/tools/definitions/update-campaign-workflow.tool.js.map +1 -0
  331. package/dist/mcp-server/tools/definitions/update-campaigns-job.tool.d.ts +158 -0
  332. package/dist/mcp-server/tools/definitions/update-campaigns-job.tool.d.ts.map +1 -0
  333. package/dist/mcp-server/tools/definitions/update-campaigns-job.tool.js +63 -0
  334. package/dist/mcp-server/tools/definitions/update-campaigns-job.tool.js.map +1 -0
  335. package/dist/mcp-server/tools/definitions/update-campaigns.tool.d.ts +241 -0
  336. package/dist/mcp-server/tools/definitions/update-campaigns.tool.d.ts.map +1 -0
  337. package/dist/mcp-server/tools/definitions/update-campaigns.tool.js +120 -0
  338. package/dist/mcp-server/tools/definitions/update-campaigns.tool.js.map +1 -0
  339. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +164 -0
  340. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  341. package/dist/mcp-server/tools/definitions/update-entity.tool.js +101 -0
  342. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  343. package/dist/mcp-server/tools/definitions/update-report-schedule.tool.d.ts +116 -0
  344. package/dist/mcp-server/tools/definitions/update-report-schedule.tool.d.ts.map +1 -0
  345. package/dist/mcp-server/tools/definitions/update-report-schedule.tool.js +134 -0
  346. package/dist/mcp-server/tools/definitions/update-report-schedule.tool.js.map +1 -0
  347. package/dist/mcp-server/tools/definitions/update-report-template.tool.d.ts +358 -0
  348. package/dist/mcp-server/tools/definitions/update-report-template.tool.d.ts.map +1 -0
  349. package/dist/mcp-server/tools/definitions/update-report-template.tool.js +156 -0
  350. package/dist/mcp-server/tools/definitions/update-report-template.tool.js.map +1 -0
  351. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +226 -0
  352. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  353. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +205 -0
  354. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  355. package/dist/mcp-server/tools/index.d.ts +2 -0
  356. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  357. package/dist/mcp-server/tools/index.js +2 -0
  358. package/dist/mcp-server/tools/index.js.map +1 -0
  359. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +18 -0
  360. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  361. package/dist/mcp-server/tools/utils/entity-mapping.js +66 -0
  362. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  363. package/dist/mcp-server/tools/utils/graphql-errors.d.ts +13 -0
  364. package/dist/mcp-server/tools/utils/graphql-errors.d.ts.map +1 -0
  365. package/dist/mcp-server/tools/utils/graphql-errors.js +48 -0
  366. package/dist/mcp-server/tools/utils/graphql-errors.js.map +1 -0
  367. package/dist/mcp-server/tools/utils/parent-id-validation.d.ts +11 -0
  368. package/dist/mcp-server/tools/utils/parent-id-validation.d.ts.map +1 -0
  369. package/dist/mcp-server/tools/utils/parent-id-validation.js +60 -0
  370. package/dist/mcp-server/tools/utils/parent-id-validation.js.map +1 -0
  371. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  372. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  373. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  374. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  375. package/dist/mcp-server/tools/utils/workflow-schemas.d.ts +646 -0
  376. package/dist/mcp-server/tools/utils/workflow-schemas.d.ts.map +1 -0
  377. package/dist/mcp-server/tools/utils/workflow-schemas.js +173 -0
  378. package/dist/mcp-server/tools/utils/workflow-schemas.js.map +1 -0
  379. package/dist/mcp-server/transports/streamable-http-transport.d.ts +49 -0
  380. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  381. package/dist/mcp-server/transports/streamable-http-transport.js +74 -0
  382. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  383. package/dist/services/session-services.d.ts +22 -0
  384. package/dist/services/session-services.d.ts.map +1 -0
  385. package/dist/services/session-services.js +24 -0
  386. package/dist/services/session-services.js.map +1 -0
  387. package/dist/services/ttd/ttd-http-client.d.ts +13 -0
  388. package/dist/services/ttd/ttd-http-client.d.ts.map +1 -0
  389. package/dist/services/ttd/ttd-http-client.js +70 -0
  390. package/dist/services/ttd/ttd-http-client.js.map +1 -0
  391. package/dist/services/ttd/ttd-reporting-service.d.ts +79 -0
  392. package/dist/services/ttd/ttd-reporting-service.d.ts.map +1 -0
  393. package/dist/services/ttd/ttd-reporting-service.js +180 -0
  394. package/dist/services/ttd/ttd-reporting-service.js.map +1 -0
  395. package/dist/services/ttd/ttd-service.d.ts +107 -0
  396. package/dist/services/ttd/ttd-service.d.ts.map +1 -0
  397. package/dist/services/ttd/ttd-service.js +307 -0
  398. package/dist/services/ttd/ttd-service.js.map +1 -0
  399. package/dist/services/ttd/types.d.ts +153 -0
  400. package/dist/services/ttd/types.d.ts.map +1 -0
  401. package/dist/services/ttd/types.js +30 -0
  402. package/dist/services/ttd/types.js.map +1 -0
  403. package/dist/types-global/mcp.d.ts +2 -0
  404. package/dist/types-global/mcp.d.ts.map +1 -0
  405. package/dist/types-global/mcp.js +2 -0
  406. package/dist/types-global/mcp.js.map +1 -0
  407. package/dist/utils/errors/index.d.ts +2 -0
  408. package/dist/utils/errors/index.d.ts.map +1 -0
  409. package/dist/utils/errors/index.js +2 -0
  410. package/dist/utils/errors/index.js.map +1 -0
  411. package/dist/utils/platform.d.ts +3 -0
  412. package/dist/utils/platform.d.ts.map +1 -0
  413. package/dist/utils/platform.js +5 -0
  414. package/dist/utils/platform.js.map +1 -0
  415. package/dist/utils/security/rate-limiter.d.ts +3 -0
  416. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  417. package/dist/utils/security/rate-limiter.js +5 -0
  418. package/dist/utils/security/rate-limiter.js.map +1 -0
  419. package/dist/utils/telemetry/index.d.ts +2 -0
  420. package/dist/utils/telemetry/index.d.ts.map +1 -0
  421. package/dist/utils/telemetry/index.js +2 -0
  422. package/dist/utils/telemetry/index.js.map +1 -0
  423. package/dist/utils/telemetry/tracing.d.ts +3 -0
  424. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  425. package/dist/utils/telemetry/tracing.js +4 -0
  426. package/dist/utils/telemetry/tracing.js.map +1 -0
  427. package/package.json +56 -0
@@ -0,0 +1,58 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { FirstPartyDataJobInputSchema, toWorkflowCallbackInput, } from "../utils/workflow-schemas.js";
4
+ const TOOL_NAME = "ttd_get_first_party_data_job";
5
+ const TOOL_TITLE = "TTD Get First-Party Data Job";
6
+ const TOOL_DESCRIPTION = `Submit a Workflows job for first-party data retrieval for an advertiser.
7
+
8
+ The returned job ID can be polled with \`ttd_get_job_status\`.`;
9
+ export const GetFirstPartyDataJobToolInputSchema = FirstPartyDataJobInputSchema.describe("Parameters for submitting a first-party data retrieval job");
10
+ export const GetFirstPartyDataJobToolOutputSchema = z.object({
11
+ job: z.record(z.unknown()).describe("Raw job submission response"),
12
+ timestamp: z.string().datetime(),
13
+ });
14
+ export async function getFirstPartyDataJobLogic(input, context, sdkContext) {
15
+ const { ttdService } = resolveSessionServices(sdkContext);
16
+ const job = (await ttdService.getFirstPartyDataJob({
17
+ advertiserId: input.advertiserId,
18
+ ...(input.nameFilter !== undefined ? { nameFilter: input.nameFilter } : {}),
19
+ ...(input.queryShape !== undefined ? { queryShape: input.queryShape } : {}),
20
+ ...(input.callbackInput
21
+ ? { callbackInput: toWorkflowCallbackInput(input.callbackInput) }
22
+ : {}),
23
+ }, context));
24
+ return { job, timestamp: new Date().toISOString() };
25
+ }
26
+ export function getFirstPartyDataJobResponseFormatter(result) {
27
+ return [
28
+ {
29
+ type: "text",
30
+ text: `First-party data job submitted:\n\n${JSON.stringify(result.job, null, 2)}\n\nTimestamp: ${result.timestamp}`,
31
+ },
32
+ ];
33
+ }
34
+ export const getFirstPartyDataJobTool = {
35
+ name: TOOL_NAME,
36
+ title: TOOL_TITLE,
37
+ description: TOOL_DESCRIPTION,
38
+ inputSchema: GetFirstPartyDataJobToolInputSchema,
39
+ outputSchema: GetFirstPartyDataJobToolOutputSchema,
40
+ annotations: {
41
+ readOnlyHint: false,
42
+ openWorldHint: false,
43
+ destructiveHint: false,
44
+ idempotentHint: false,
45
+ },
46
+ inputExamples: [
47
+ {
48
+ label: "Submit first-party data job",
49
+ input: {
50
+ advertiserId: "adv123",
51
+ queryShape: "nodes { id name }",
52
+ },
53
+ },
54
+ ],
55
+ logic: getFirstPartyDataJobLogic,
56
+ responseFormatter: getFirstPartyDataJobResponseFormatter,
57
+ };
58
+ //# sourceMappingURL=get-first-party-data-job.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-first-party-data-job.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-first-party-data-job.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,SAAS,GAAG,8BAA8B,CAAC;AACjD,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAClD,MAAM,gBAAgB,GAAG;;+DAEsC,CAAC;AAEhE,MAAM,CAAC,MAAM,mCAAmC,GAAG,4BAA4B,CAAC,QAAQ,CACtF,4DAA4D,CAC7D,CAAC;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAKH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAoC,EACpC,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,CAAC,MAAM,UAAU,CAAC,oBAAoB,CAChD;QACE,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,aAAa;YACrB,CAAC,CAAC,EAAE,aAAa,EAAE,uBAAuB,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE;YACjE,CAAC,CAAC,EAAE,CAAC;KACR,EACD,OAAO,CACR,CAA4B,CAAC;IAC9B,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,MAAsC;IAEtC,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACpH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,mCAAmC;IAChD,YAAY,EAAE,oCAAoC;IAClD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,6BAA6B;YACpC,KAAK,EAAE;gBACL,YAAY,EAAE,QAAQ;gBACtB,UAAU,EAAE,mBAAmB;aAChC;SACF;KACF;IACD,KAAK,EAAE,yBAAyB;IAChC,iBAAiB,EAAE,qCAAqC;CACzD,CAAC"}
@@ -0,0 +1,61 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
3
+ export declare const GetJobStatusInputSchema: z.ZodObject<{
4
+ jobId: z.ZodNumber;
5
+ }, "strip", z.ZodTypeAny, {
6
+ jobId: number;
7
+ }, {
8
+ jobId: number;
9
+ }>;
10
+ export declare const GetJobStatusOutputSchema: z.ZodObject<{
11
+ jobStatus: z.ZodRecord<z.ZodString, z.ZodUnknown>;
12
+ timestamp: z.ZodString;
13
+ }, "strip", z.ZodTypeAny, {
14
+ timestamp: string;
15
+ jobStatus: Record<string, unknown>;
16
+ }, {
17
+ timestamp: string;
18
+ jobStatus: Record<string, unknown>;
19
+ }>;
20
+ type GetJobStatusInput = z.infer<typeof GetJobStatusInputSchema>;
21
+ type GetJobStatusOutput = z.infer<typeof GetJobStatusOutputSchema>;
22
+ export declare function getJobStatusLogic(input: GetJobStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetJobStatusOutput>;
23
+ export declare function getJobStatusResponseFormatter(result: GetJobStatusOutput): McpTextContent[];
24
+ export declare const getJobStatusTool: {
25
+ name: string;
26
+ title: string;
27
+ description: string;
28
+ inputSchema: z.ZodObject<{
29
+ jobId: z.ZodNumber;
30
+ }, "strip", z.ZodTypeAny, {
31
+ jobId: number;
32
+ }, {
33
+ jobId: number;
34
+ }>;
35
+ outputSchema: z.ZodObject<{
36
+ jobStatus: z.ZodRecord<z.ZodString, z.ZodUnknown>;
37
+ timestamp: z.ZodString;
38
+ }, "strip", z.ZodTypeAny, {
39
+ timestamp: string;
40
+ jobStatus: Record<string, unknown>;
41
+ }, {
42
+ timestamp: string;
43
+ jobStatus: Record<string, unknown>;
44
+ }>;
45
+ annotations: {
46
+ readOnlyHint: boolean;
47
+ openWorldHint: boolean;
48
+ destructiveHint: boolean;
49
+ idempotentHint: boolean;
50
+ };
51
+ inputExamples: {
52
+ label: string;
53
+ input: {
54
+ jobId: number;
55
+ };
56
+ }[];
57
+ logic: typeof getJobStatusLogic;
58
+ responseFormatter: typeof getJobStatusResponseFormatter;
59
+ };
60
+ export {};
61
+ //# sourceMappingURL=get-job-status.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-job-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-job-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnF,eAAO,MAAM,uBAAuB;;;;;;EAMlC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC"}
@@ -0,0 +1,54 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "ttd_get_job_status";
4
+ const TOOL_TITLE = "TTD Get Job Status";
5
+ const TOOL_DESCRIPTION = `Get the status of a previously submitted standard Workflows job.
6
+
7
+ Use this after tools like \`ttd_get_first_party_data_job\`, \`ttd_get_third_party_data_job\`,
8
+ or any of \`ttd_create_campaigns\`/\`ttd_update_campaigns\`/\`ttd_create_ad_groups\`/\`ttd_update_ad_groups\` invoked with \`mode: "batch"\`.`;
9
+ export const GetJobStatusInputSchema = z.object({
10
+ jobId: z
11
+ .number()
12
+ .int()
13
+ .positive()
14
+ .describe("Standard job ID returned by a TTD Workflows async endpoint"),
15
+ });
16
+ export const GetJobStatusOutputSchema = z.object({
17
+ jobStatus: z.record(z.unknown()).describe("Raw standard job status payload"),
18
+ timestamp: z.string().datetime(),
19
+ });
20
+ export async function getJobStatusLogic(input, context, sdkContext) {
21
+ const { ttdService } = resolveSessionServices(sdkContext);
22
+ const jobStatus = (await ttdService.getJobStatus(input.jobId, context));
23
+ return { jobStatus, timestamp: new Date().toISOString() };
24
+ }
25
+ export function getJobStatusResponseFormatter(result) {
26
+ return [
27
+ {
28
+ type: "text",
29
+ text: `Job status:\n\n${JSON.stringify(result.jobStatus, null, 2)}\n\nTimestamp: ${result.timestamp}`,
30
+ },
31
+ ];
32
+ }
33
+ export const getJobStatusTool = {
34
+ name: TOOL_NAME,
35
+ title: TOOL_TITLE,
36
+ description: TOOL_DESCRIPTION,
37
+ inputSchema: GetJobStatusInputSchema,
38
+ outputSchema: GetJobStatusOutputSchema,
39
+ annotations: {
40
+ readOnlyHint: true,
41
+ openWorldHint: false,
42
+ destructiveHint: false,
43
+ idempotentHint: true,
44
+ },
45
+ inputExamples: [
46
+ {
47
+ label: "Check standard job status",
48
+ input: { jobId: 412651 },
49
+ },
50
+ ],
51
+ logic: getJobStatusLogic,
52
+ responseFormatter: getJobStatusResponseFormatter,
53
+ };
54
+ //# sourceMappingURL=get-job-status.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-job-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-job-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,UAAU,GAAG,oBAAoB,CAAC;AACxC,MAAM,gBAAgB,GAAG;;;8IAGqH,CAAC;AAE/I,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAKH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAGrE,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACtG;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,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SACzB;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
@@ -0,0 +1,131 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
3
+ export declare const GetReportExecutionsInputSchema: z.ZodObject<{
4
+ scheduleId: z.ZodOptional<z.ZodString>;
5
+ lastStatusChangeAfter: z.ZodOptional<z.ZodString>;
6
+ first: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
7
+ after: z.ZodOptional<z.ZodString>;
8
+ }, "strip", z.ZodTypeAny, {
9
+ scheduleId?: string | undefined;
10
+ first?: number | undefined;
11
+ after?: string | undefined;
12
+ lastStatusChangeAfter?: string | undefined;
13
+ }, {
14
+ scheduleId?: string | undefined;
15
+ first?: number | undefined;
16
+ after?: string | undefined;
17
+ lastStatusChangeAfter?: string | undefined;
18
+ }>;
19
+ export declare const GetReportExecutionsOutputSchema: z.ZodObject<{
20
+ mode: z.ZodEnum<["single", "list"]>;
21
+ scheduleId: z.ZodOptional<z.ZodString>;
22
+ schedule: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
23
+ schedules: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
24
+ hasNextPage: z.ZodOptional<z.ZodBoolean>;
25
+ endCursor: z.ZodOptional<z.ZodString>;
26
+ rawResponse: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
27
+ timestamp: z.ZodString;
28
+ }, "strip", z.ZodTypeAny, {
29
+ timestamp: string;
30
+ mode: "single" | "list";
31
+ schedules?: Record<string, unknown>[] | undefined;
32
+ scheduleId?: string | undefined;
33
+ schedule?: Record<string, unknown> | undefined;
34
+ hasNextPage?: boolean | undefined;
35
+ endCursor?: string | undefined;
36
+ rawResponse?: Record<string, unknown> | undefined;
37
+ }, {
38
+ timestamp: string;
39
+ mode: "single" | "list";
40
+ schedules?: Record<string, unknown>[] | undefined;
41
+ scheduleId?: string | undefined;
42
+ schedule?: Record<string, unknown> | undefined;
43
+ hasNextPage?: boolean | undefined;
44
+ endCursor?: string | undefined;
45
+ rawResponse?: Record<string, unknown> | undefined;
46
+ }>;
47
+ type GetReportExecutionsInput = z.infer<typeof GetReportExecutionsInputSchema>;
48
+ type GetReportExecutionsOutput = z.infer<typeof GetReportExecutionsOutputSchema>;
49
+ export declare function getReportExecutionsLogic(input: GetReportExecutionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetReportExecutionsOutput>;
50
+ export declare function getReportExecutionsResponseFormatter(result: GetReportExecutionsOutput): McpTextContent[];
51
+ export declare const getReportExecutionsTool: {
52
+ name: string;
53
+ title: string;
54
+ description: string;
55
+ inputSchema: z.ZodObject<{
56
+ scheduleId: z.ZodOptional<z.ZodString>;
57
+ lastStatusChangeAfter: z.ZodOptional<z.ZodString>;
58
+ first: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
59
+ after: z.ZodOptional<z.ZodString>;
60
+ }, "strip", z.ZodTypeAny, {
61
+ scheduleId?: string | undefined;
62
+ first?: number | undefined;
63
+ after?: string | undefined;
64
+ lastStatusChangeAfter?: string | undefined;
65
+ }, {
66
+ scheduleId?: string | undefined;
67
+ first?: number | undefined;
68
+ after?: string | undefined;
69
+ lastStatusChangeAfter?: string | undefined;
70
+ }>;
71
+ outputSchema: z.ZodObject<{
72
+ mode: z.ZodEnum<["single", "list"]>;
73
+ scheduleId: z.ZodOptional<z.ZodString>;
74
+ schedule: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
75
+ schedules: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
76
+ hasNextPage: z.ZodOptional<z.ZodBoolean>;
77
+ endCursor: z.ZodOptional<z.ZodString>;
78
+ rawResponse: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
79
+ timestamp: z.ZodString;
80
+ }, "strip", z.ZodTypeAny, {
81
+ timestamp: string;
82
+ mode: "single" | "list";
83
+ schedules?: Record<string, unknown>[] | undefined;
84
+ scheduleId?: string | undefined;
85
+ schedule?: Record<string, unknown> | undefined;
86
+ hasNextPage?: boolean | undefined;
87
+ endCursor?: string | undefined;
88
+ rawResponse?: Record<string, unknown> | undefined;
89
+ }, {
90
+ timestamp: string;
91
+ mode: "single" | "list";
92
+ schedules?: Record<string, unknown>[] | undefined;
93
+ scheduleId?: string | undefined;
94
+ schedule?: Record<string, unknown> | undefined;
95
+ hasNextPage?: boolean | undefined;
96
+ endCursor?: string | undefined;
97
+ rawResponse?: Record<string, unknown> | undefined;
98
+ }>;
99
+ annotations: {
100
+ readOnlyHint: boolean;
101
+ destructiveHint: boolean;
102
+ idempotentHint: boolean;
103
+ openWorldHint: boolean;
104
+ };
105
+ inputExamples: ({
106
+ label: string;
107
+ input: {
108
+ scheduleId: string;
109
+ lastStatusChangeAfter?: undefined;
110
+ first?: undefined;
111
+ };
112
+ } | {
113
+ label: string;
114
+ input: {
115
+ lastStatusChangeAfter: string;
116
+ first: number;
117
+ scheduleId?: undefined;
118
+ };
119
+ } | {
120
+ label: string;
121
+ input: {
122
+ first: number;
123
+ scheduleId?: undefined;
124
+ lastStatusChangeAfter?: undefined;
125
+ };
126
+ })[];
127
+ logic: typeof getReportExecutionsLogic;
128
+ responseFormatter: typeof getReportExecutionsResponseFormatter;
129
+ };
130
+ export {};
131
+ //# sourceMappingURL=get-report-executions.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-report-executions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report-executions.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAenF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAsB4B,CAAC;AAExE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWI,CAAC;AAEjD,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAsDjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CA0DpC;AA0CD,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAoElB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCnC,CAAC"}
@@ -0,0 +1,253 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { throwIfGraphqlErrors } from "../utils/graphql-errors.js";
4
+ const TOOL_NAME = "ttd_get_report_executions";
5
+ const TOOL_TITLE = "Get TTD Report Schedule Executions (GraphQL)";
6
+ const TOOL_DESCRIPTION = `Primary tool for checking TTD report schedule status and retrieving download links via GraphQL.
7
+
8
+ Use this after \`ttd_create_template_schedule\` or \`ttd_rerun_report_schedule\` to check whether a report is ready and get the download link.
9
+
10
+ **Two modes:**
11
+ - **Single schedule** (provide \`scheduleId\`): Uses \`myReportsReportSchedule\` — fastest when you know the schedule ID. Returns status, filters, and all executions.
12
+ - **List mode** (omit \`scheduleId\`): Uses \`myReportsReportSchedules\` — supports pagination and optional filtering by recent execution activity via \`lastStatusChangeAfter\`.
13
+
14
+ **Download links** appear in \`delivery.downloadLink\` when an execution's \`state\` is \`COMPLETED\`.`;
15
+ export const GetReportExecutionsInputSchema = z
16
+ .object({
17
+ scheduleId: z
18
+ .string()
19
+ .optional()
20
+ .describe("If provided, fetch a single schedule by ID using myReportsReportSchedule"),
21
+ lastStatusChangeAfter: z
22
+ .string()
23
+ .optional()
24
+ .describe("ISO date filter for executions, e.g. 2025-07-01 (only used when scheduleId is not provided)"),
25
+ first: z
26
+ .number()
27
+ .int()
28
+ .min(1)
29
+ .max(100)
30
+ .default(10)
31
+ .optional()
32
+ .describe("Number of schedules to return (list mode only, default 10)"),
33
+ after: z.string().optional().describe("Cursor for pagination (list mode only)"),
34
+ })
35
+ .describe("Parameters for retrieving TTD report schedule executions");
36
+ export const GetReportExecutionsOutputSchema = z
37
+ .object({
38
+ mode: z.enum(["single", "list"]),
39
+ scheduleId: z.string().optional(),
40
+ schedule: z.record(z.unknown()).optional(),
41
+ schedules: z.array(z.record(z.unknown())).optional(),
42
+ hasNextPage: z.boolean().optional(),
43
+ endCursor: z.string().optional(),
44
+ rawResponse: z.record(z.unknown()).optional(),
45
+ timestamp: z.string().datetime(),
46
+ })
47
+ .describe("Report schedule executions result");
48
+ const SINGLE_QUERY = `query GetReportSchedule($id: ID!) {
49
+ myReportsReportSchedule(id: $id) {
50
+ status
51
+ filters {
52
+ advertiserFilters { name }
53
+ partnerFilters { name }
54
+ }
55
+ executions {
56
+ nodes {
57
+ reportStartDateInclusive
58
+ reportEndDateExclusive
59
+ lastStatusChangeDate
60
+ state
61
+ delivery {
62
+ downloadLink
63
+ deliveredDate
64
+ }
65
+ }
66
+ }
67
+ }
68
+ }`;
69
+ const LIST_QUERY = `query GetReportSchedules($where: MyReportsReportScheduleFilterInput, $first: Int, $after: String) {
70
+ myReportsReportSchedules(where: $where, first: $first, after: $after) {
71
+ nodes {
72
+ name
73
+ status
74
+ filters {
75
+ advertiserFilters { name }
76
+ partnerFilters { name }
77
+ }
78
+ timezone
79
+ executions {
80
+ nodes {
81
+ reportStartDateInclusive
82
+ reportEndDateExclusive
83
+ lastStatusChangeDate
84
+ state
85
+ delivery {
86
+ downloadLink
87
+ deliveredDate
88
+ }
89
+ }
90
+ }
91
+ }
92
+ pageInfo {
93
+ hasNextPage
94
+ endCursor
95
+ }
96
+ }
97
+ }`;
98
+ export async function getReportExecutionsLogic(input, context, sdkContext) {
99
+ const { ttdService } = resolveSessionServices(sdkContext);
100
+ if (input.scheduleId) {
101
+ const raw = (await ttdService.graphqlQuery(SINGLE_QUERY, { id: input.scheduleId }, context));
102
+ throwIfGraphqlErrors(raw, "GraphQL error fetching report schedule");
103
+ const gqlData = raw.data ?? {};
104
+ const schedule = gqlData.myReportsReportSchedule ?? {};
105
+ return {
106
+ mode: "single",
107
+ scheduleId: input.scheduleId,
108
+ schedule,
109
+ rawResponse: raw,
110
+ timestamp: new Date().toISOString(),
111
+ };
112
+ }
113
+ let where;
114
+ if (input.lastStatusChangeAfter) {
115
+ where = {
116
+ executions: {
117
+ some: {
118
+ lastStatusChangeDate: { gte: input.lastStatusChangeAfter },
119
+ },
120
+ },
121
+ };
122
+ }
123
+ const raw = (await ttdService.graphqlQuery(LIST_QUERY, { where, first: input.first ?? 10, after: input.after }, context));
124
+ throwIfGraphqlErrors(raw, "GraphQL error listing report schedules");
125
+ const gqlData = raw.data ?? {};
126
+ const listResult = gqlData.myReportsReportSchedules ?? {};
127
+ const nodes = listResult.nodes ?? [];
128
+ const pageInfo = listResult.pageInfo ?? {};
129
+ return {
130
+ mode: "list",
131
+ schedules: nodes,
132
+ hasNextPage: pageInfo.hasNextPage,
133
+ endCursor: pageInfo.endCursor,
134
+ rawResponse: raw,
135
+ timestamp: new Date().toISOString(),
136
+ };
137
+ }
138
+ function formatExecutions(executions) {
139
+ if (!executions.length)
140
+ return [" (no executions)"];
141
+ return executions.map((ex, i) => {
142
+ const dateRange = ex.reportStartDateInclusive && ex.reportEndDateExclusive
143
+ ? `${ex.reportStartDateInclusive} → ${ex.reportEndDateExclusive}`
144
+ : "(date range unknown)";
145
+ const downloadLink = ex.state === "COMPLETED" && ex.delivery?.downloadLink
146
+ ? ex.delivery.downloadLink
147
+ : "not available";
148
+ return ` [${i + 1}] ${ex.state ?? "UNKNOWN"} | ${dateRange} | Download: ${downloadLink}`;
149
+ });
150
+ }
151
+ function formatFilters(filters) {
152
+ if (!filters)
153
+ return "(none)";
154
+ const parts = [];
155
+ const advertiserFilters = filters.advertiserFilters;
156
+ const partnerFilters = filters.partnerFilters;
157
+ if (advertiserFilters?.length) {
158
+ parts.push(`Advertisers: ${advertiserFilters.map((f) => f.name ?? "?").join(", ")}`);
159
+ }
160
+ if (partnerFilters?.length) {
161
+ parts.push(`Partners: ${partnerFilters.map((f) => f.name ?? "?").join(", ")}`);
162
+ }
163
+ return parts.length ? parts.join(" | ") : "(none)";
164
+ }
165
+ export function getReportExecutionsResponseFormatter(result) {
166
+ if (result.mode === "single") {
167
+ const schedule = result.schedule ?? {};
168
+ if (!schedule || Object.keys(schedule).length === 0) {
169
+ return [
170
+ {
171
+ type: "text",
172
+ text: `No report schedule found for ID: ${result.scheduleId ?? "(unknown)"}\n\nRaw response:\n${JSON.stringify(result.rawResponse, null, 2)}\n\nTimestamp: ${result.timestamp}`,
173
+ },
174
+ ];
175
+ }
176
+ const executionsData = schedule.executions;
177
+ const executions = executionsData?.nodes ?? [];
178
+ const filters = schedule.filters;
179
+ const lines = [
180
+ `Schedule ID: ${result.scheduleId ?? "(unknown)"}`,
181
+ `Status: ${schedule.status ?? "unknown"}`,
182
+ `Filters: ${formatFilters(filters)}`,
183
+ "",
184
+ `Executions (${executions.length}):`,
185
+ ...formatExecutions(executions),
186
+ "",
187
+ `Timestamp: ${result.timestamp}`,
188
+ ];
189
+ return [{ type: "text", text: lines.join("\n") }];
190
+ }
191
+ const schedules = result.schedules ?? [];
192
+ if (!schedules.length) {
193
+ return [
194
+ {
195
+ type: "text",
196
+ text: `No report schedules found.\n\nRaw response:\n${JSON.stringify(result.rawResponse, null, 2)}\n\nTimestamp: ${result.timestamp}`,
197
+ },
198
+ ];
199
+ }
200
+ const lines = [`Report Schedules (${schedules.length}):`, ""];
201
+ schedules.forEach((sched, i) => {
202
+ const executionsData = sched.executions;
203
+ const execNodes = executionsData?.nodes ?? [];
204
+ const latest = execNodes[0];
205
+ const latestState = latest?.state ?? "no executions";
206
+ const latestDownload = latest?.state === "COMPLETED" && latest?.delivery?.downloadLink
207
+ ? latest.delivery.downloadLink
208
+ : "pending";
209
+ lines.push(` [${i + 1}] ${sched.name ?? "(unnamed)"} — ${sched.status ?? "unknown"}`);
210
+ lines.push(` Latest: ${latestState} | Download: ${latestDownload}`);
211
+ lines.push("");
212
+ });
213
+ lines.push(`hasNextPage: ${result.hasNextPage ?? false} | cursor: ${result.endCursor ?? "(none)"}`);
214
+ lines.push(`\nTimestamp: ${result.timestamp}`);
215
+ return [{ type: "text", text: lines.join("\n") }];
216
+ }
217
+ export const getReportExecutionsTool = {
218
+ name: TOOL_NAME,
219
+ title: TOOL_TITLE,
220
+ description: TOOL_DESCRIPTION,
221
+ inputSchema: GetReportExecutionsInputSchema,
222
+ outputSchema: GetReportExecutionsOutputSchema,
223
+ annotations: {
224
+ readOnlyHint: true,
225
+ destructiveHint: false,
226
+ idempotentHint: true,
227
+ openWorldHint: true,
228
+ },
229
+ inputExamples: [
230
+ {
231
+ label: "Check executions for a known schedule",
232
+ input: {
233
+ scheduleId: "sched-abc123",
234
+ },
235
+ },
236
+ {
237
+ label: "List schedules with recent activity",
238
+ input: {
239
+ lastStatusChangeAfter: "2025-07-01",
240
+ first: 10,
241
+ },
242
+ },
243
+ {
244
+ label: "List all schedules (first page)",
245
+ input: {
246
+ first: 20,
247
+ },
248
+ },
249
+ ],
250
+ logic: getReportExecutionsLogic,
251
+ responseFormatter: getReportExecutionsResponseFormatter,
252
+ };
253
+ //# sourceMappingURL=get-report-executions.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-report-executions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report-executions.tool.ts"],"names":[],"mappings":"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"}