@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,138 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "ttd_get_report";
4
+ const TOOL_TITLE = "Get TTD Report";
5
+ const TOOL_DESCRIPTION = `Generate and retrieve a report from The Trade Desk.
6
+
7
+ Uses the TTD MyReports API to create a report schedule, poll for execution, and return results. This is an async operation that may take several seconds to complete.
8
+
9
+ Provide report configuration including dimensions, metrics, date range, and optional filters.`;
10
+ export const GetReportInputSchema = z
11
+ .object({
12
+ reportName: z.string().describe("Name for the report"),
13
+ dateRange: z
14
+ .enum([
15
+ "Yesterday",
16
+ "Last7Days",
17
+ "Last14Days",
18
+ "Last30Days",
19
+ "LastXDays",
20
+ "MonthToDate",
21
+ "LastMonth",
22
+ "QuarterToDate",
23
+ "LastQuarter",
24
+ "YearToDate",
25
+ "Custom",
26
+ ])
27
+ .describe("Date range for the report (per TTD MyReports reportschedule/facets)"),
28
+ reportTemplateId: z
29
+ .number()
30
+ .describe("TTD report template ID — REQUIRED by TTD. Find IDs via ttd_list_report_templates or the TTD UI."),
31
+ fileFormat: z
32
+ .enum(["CSV", "TSV", "ExcelPivot"])
33
+ .optional()
34
+ .default("CSV")
35
+ .describe("Report file format. Must match the template's format. Use ExcelPivot for Excel-shaped templates. CSV-only output is parseable by ttd_download_report."),
36
+ scheduleStartDate: z
37
+ .string()
38
+ .optional()
39
+ .describe("ISO date or datetime when the schedule should first run. Defaults to today UTC at 00:00."),
40
+ advertiserIds: z.array(z.string()).optional().describe("Filter by advertiser IDs"),
41
+ dimensions: z
42
+ .array(z.string())
43
+ .optional()
44
+ .describe("(legacy/ignored when ReportTemplateId is set)"),
45
+ metrics: z
46
+ .array(z.string())
47
+ .optional()
48
+ .describe("(legacy/ignored when ReportTemplateId is set)"),
49
+ additionalConfig: z
50
+ .record(z.any())
51
+ .optional()
52
+ .describe("Additional report configuration fields (merged last)"),
53
+ })
54
+ .describe("Parameters for generating a TTD report");
55
+ export const GetReportOutputSchema = z
56
+ .object({
57
+ reportScheduleId: z.string().describe("Report schedule ID"),
58
+ execution: z.record(z.any()).describe("Report execution details"),
59
+ downloadUrl: z.string().optional().describe("URL to download report results"),
60
+ timestamp: z.string().datetime(),
61
+ })
62
+ .describe("Report generation result");
63
+ export async function getReportLogic(input, context, sdkContext) {
64
+ const { ttdReportingService } = resolveSessionServices(sdkContext);
65
+ const startDate = input.scheduleStartDate ?? new Date().toISOString().slice(0, 10) + "T00:00:00";
66
+ const reportConfig = {
67
+ ReportScheduleName: input.reportName,
68
+ ReportTemplateId: input.reportTemplateId,
69
+ ReportFileFormat: input.fileFormat,
70
+ ReportDateRange: input.dateRange,
71
+ ReportFrequency: "Once",
72
+ ScheduleStartDate: startDate,
73
+ TimeZone: "UTC",
74
+ ReportDateFormat: "Sortable",
75
+ ReportNumericFormat: "US",
76
+ IncludeHeaders: true,
77
+ ...(input.dimensions && { ReportDimensions: input.dimensions }),
78
+ ...(input.metrics && { ReportMetrics: input.metrics }),
79
+ ...(input.advertiserIds && { AdvertiserFilters: input.advertiserIds }),
80
+ ...input.additionalConfig,
81
+ };
82
+ const result = (await ttdReportingService.runReport(reportConfig, context));
83
+ return {
84
+ reportScheduleId: result.reportScheduleId,
85
+ execution: result.execution || {},
86
+ downloadUrl: result.downloadUrl,
87
+ timestamp: new Date().toISOString(),
88
+ };
89
+ }
90
+ export function getReportResponseFormatter(result) {
91
+ const downloadInfo = result.downloadUrl
92
+ ? `\n\nDownload URL: ${result.downloadUrl}`
93
+ : "\n\nNo download URL available yet.";
94
+ return [
95
+ {
96
+ type: "text",
97
+ text: `Report generated: ${result.reportScheduleId}${downloadInfo}\n\nExecution details:\n${JSON.stringify(result.execution, null, 2)}\n\nTimestamp: ${result.timestamp}`,
98
+ },
99
+ ];
100
+ }
101
+ export const getReportTool = {
102
+ name: TOOL_NAME,
103
+ title: TOOL_TITLE,
104
+ description: TOOL_DESCRIPTION,
105
+ inputSchema: GetReportInputSchema,
106
+ outputSchema: GetReportOutputSchema,
107
+ annotations: {
108
+ readOnlyHint: true,
109
+ openWorldHint: false,
110
+ destructiveHint: false,
111
+ idempotentHint: false,
112
+ },
113
+ inputExamples: [
114
+ {
115
+ label: "Campaign performance report for last 7 days (CSV template)",
116
+ input: {
117
+ reportName: "Campaign Performance - Last 7 Days",
118
+ dateRange: "Last7Days",
119
+ reportTemplateId: 16353,
120
+ fileFormat: "ExcelPivot",
121
+ advertiserIds: ["adv123abc"],
122
+ },
123
+ },
124
+ {
125
+ label: "Yesterday report with explicit CSV template",
126
+ input: {
127
+ reportName: "Daily Summary",
128
+ dateRange: "Yesterday",
129
+ reportTemplateId: 12345,
130
+ fileFormat: "CSV",
131
+ advertiserIds: ["adv123abc"],
132
+ },
133
+ },
134
+ ],
135
+ logic: getReportLogic,
136
+ responseFormatter: getReportResponseFormatter,
137
+ };
138
+ //# sourceMappingURL=get-report.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,104 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
3
+ export declare const GetThirdPartyDataJobToolInputSchema: z.ZodObject<{
4
+ partnerId: z.ZodString;
5
+ queryShape: z.ZodOptional<z.ZodNullable<z.ZodString>>;
6
+ callbackInput: z.ZodOptional<z.ZodObject<{
7
+ callbackUrl: z.ZodString;
8
+ callbackHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
9
+ }, "strip", z.ZodTypeAny, {
10
+ callbackUrl: string;
11
+ callbackHeaders?: Record<string, string> | null | undefined;
12
+ }, {
13
+ callbackUrl: string;
14
+ callbackHeaders?: Record<string, string> | null | undefined;
15
+ }>>;
16
+ }, "strip", z.ZodTypeAny, {
17
+ partnerId: string;
18
+ queryShape?: string | null | undefined;
19
+ callbackInput?: {
20
+ callbackUrl: string;
21
+ callbackHeaders?: Record<string, string> | null | undefined;
22
+ } | undefined;
23
+ }, {
24
+ partnerId: string;
25
+ queryShape?: string | null | undefined;
26
+ callbackInput?: {
27
+ callbackUrl: string;
28
+ callbackHeaders?: Record<string, string> | null | undefined;
29
+ } | undefined;
30
+ }>;
31
+ export declare const GetThirdPartyDataJobToolOutputSchema: z.ZodObject<{
32
+ job: z.ZodRecord<z.ZodString, z.ZodUnknown>;
33
+ timestamp: z.ZodString;
34
+ }, "strip", z.ZodTypeAny, {
35
+ timestamp: string;
36
+ job: Record<string, unknown>;
37
+ }, {
38
+ timestamp: string;
39
+ job: Record<string, unknown>;
40
+ }>;
41
+ type GetThirdPartyDataJobToolInput = z.infer<typeof GetThirdPartyDataJobToolInputSchema>;
42
+ type GetThirdPartyDataJobToolOutput = z.infer<typeof GetThirdPartyDataJobToolOutputSchema>;
43
+ export declare function getThirdPartyDataJobLogic(input: GetThirdPartyDataJobToolInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetThirdPartyDataJobToolOutput>;
44
+ export declare function getThirdPartyDataJobResponseFormatter(result: GetThirdPartyDataJobToolOutput): McpTextContent[];
45
+ export declare const getThirdPartyDataJobTool: {
46
+ name: string;
47
+ title: string;
48
+ description: string;
49
+ inputSchema: z.ZodObject<{
50
+ partnerId: z.ZodString;
51
+ queryShape: z.ZodOptional<z.ZodNullable<z.ZodString>>;
52
+ callbackInput: z.ZodOptional<z.ZodObject<{
53
+ callbackUrl: z.ZodString;
54
+ callbackHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
55
+ }, "strip", z.ZodTypeAny, {
56
+ callbackUrl: string;
57
+ callbackHeaders?: Record<string, string> | null | undefined;
58
+ }, {
59
+ callbackUrl: string;
60
+ callbackHeaders?: Record<string, string> | null | undefined;
61
+ }>>;
62
+ }, "strip", z.ZodTypeAny, {
63
+ partnerId: string;
64
+ queryShape?: string | null | undefined;
65
+ callbackInput?: {
66
+ callbackUrl: string;
67
+ callbackHeaders?: Record<string, string> | null | undefined;
68
+ } | undefined;
69
+ }, {
70
+ partnerId: string;
71
+ queryShape?: string | null | undefined;
72
+ callbackInput?: {
73
+ callbackUrl: string;
74
+ callbackHeaders?: Record<string, string> | null | undefined;
75
+ } | undefined;
76
+ }>;
77
+ outputSchema: z.ZodObject<{
78
+ job: z.ZodRecord<z.ZodString, z.ZodUnknown>;
79
+ timestamp: z.ZodString;
80
+ }, "strip", z.ZodTypeAny, {
81
+ timestamp: string;
82
+ job: Record<string, unknown>;
83
+ }, {
84
+ timestamp: string;
85
+ job: Record<string, unknown>;
86
+ }>;
87
+ annotations: {
88
+ readOnlyHint: boolean;
89
+ openWorldHint: boolean;
90
+ destructiveHint: boolean;
91
+ idempotentHint: boolean;
92
+ };
93
+ inputExamples: {
94
+ label: string;
95
+ input: {
96
+ partnerId: string;
97
+ queryShape: string;
98
+ };
99
+ }[];
100
+ logic: typeof getThirdPartyDataJobLogic;
101
+ responseFormatter: typeof getThirdPartyDataJobResponseFormatter;
102
+ };
103
+ export {};
104
+ //# sourceMappingURL=get-third-party-data-job.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-third-party-data-job.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-third-party-data-job.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/C,CAAC;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;EAG/C,CAAC;AAEH,KAAK,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AACzF,KAAK,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAE3F,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,8BAA8B,CAAC,CAazC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,8BAA8B,GACrC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBpC,CAAC"}
@@ -0,0 +1,57 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { ThirdPartyDataJobInputSchema, toWorkflowCallbackInput, } from "../utils/workflow-schemas.js";
4
+ const TOOL_NAME = "ttd_get_third_party_data_job";
5
+ const TOOL_TITLE = "TTD Get Third-Party Data Job";
6
+ const TOOL_DESCRIPTION = `Submit a Workflows job for third-party data retrieval for a partner.
7
+
8
+ The returned job ID can be polled with \`ttd_get_job_status\`.`;
9
+ export const GetThirdPartyDataJobToolInputSchema = ThirdPartyDataJobInputSchema.describe("Parameters for submitting a third-party data retrieval job");
10
+ export const GetThirdPartyDataJobToolOutputSchema = z.object({
11
+ job: z.record(z.unknown()).describe("Raw job submission response"),
12
+ timestamp: z.string().datetime(),
13
+ });
14
+ export async function getThirdPartyDataJobLogic(input, context, sdkContext) {
15
+ const { ttdService } = resolveSessionServices(sdkContext);
16
+ const job = (await ttdService.getThirdPartyDataJob({
17
+ partnerId: input.partnerId,
18
+ ...(input.queryShape !== undefined ? { queryShape: input.queryShape } : {}),
19
+ ...(input.callbackInput
20
+ ? { callbackInput: toWorkflowCallbackInput(input.callbackInput) }
21
+ : {}),
22
+ }, context));
23
+ return { job, timestamp: new Date().toISOString() };
24
+ }
25
+ export function getThirdPartyDataJobResponseFormatter(result) {
26
+ return [
27
+ {
28
+ type: "text",
29
+ text: `Third-party data job submitted:\n\n${JSON.stringify(result.job, null, 2)}\n\nTimestamp: ${result.timestamp}`,
30
+ },
31
+ ];
32
+ }
33
+ export const getThirdPartyDataJobTool = {
34
+ name: TOOL_NAME,
35
+ title: TOOL_TITLE,
36
+ description: TOOL_DESCRIPTION,
37
+ inputSchema: GetThirdPartyDataJobToolInputSchema,
38
+ outputSchema: GetThirdPartyDataJobToolOutputSchema,
39
+ annotations: {
40
+ readOnlyHint: false,
41
+ openWorldHint: false,
42
+ destructiveHint: false,
43
+ idempotentHint: false,
44
+ },
45
+ inputExamples: [
46
+ {
47
+ label: "Submit third-party data job",
48
+ input: {
49
+ partnerId: "partner123",
50
+ queryShape: "nodes { id name providerId }",
51
+ },
52
+ },
53
+ ],
54
+ logic: getThirdPartyDataJobLogic,
55
+ responseFormatter: getThirdPartyDataJobResponseFormatter,
56
+ };
57
+ //# sourceMappingURL=get-third-party-data-job.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-third-party-data-job.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-third-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,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,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,SAAS,EAAE,YAAY;gBACvB,UAAU,EAAE,8BAA8B;aAC3C;SACF;KACF;IACD,KAAK,EAAE,yBAAyB;IAChC,iBAAiB,EAAE,qCAAqC;CACzD,CAAC"}
@@ -0,0 +1,92 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext } from "@cesteral/shared";
3
+ import type { SdkContext } from "@cesteral/shared";
4
+ export declare const GraphqlBulkJobInputSchema: z.ZodObject<{
5
+ jobId: z.ZodString;
6
+ }, "strip", z.ZodTypeAny, {
7
+ jobId: string;
8
+ }, {
9
+ jobId: string;
10
+ }>;
11
+ export declare const GraphqlBulkJobOutputSchema: z.ZodObject<{
12
+ jobId: z.ZodString;
13
+ status: z.ZodString;
14
+ jobType: z.ZodOptional<z.ZodString>;
15
+ resultUrl: z.ZodOptional<z.ZodString>;
16
+ createdAt: z.ZodOptional<z.ZodString>;
17
+ completedAt: z.ZodOptional<z.ZodString>;
18
+ timestamp: z.ZodString;
19
+ }, "strip", z.ZodTypeAny, {
20
+ status: string;
21
+ timestamp: string;
22
+ jobId: string;
23
+ completedAt?: string | undefined;
24
+ jobType?: string | undefined;
25
+ resultUrl?: string | undefined;
26
+ createdAt?: string | undefined;
27
+ }, {
28
+ status: string;
29
+ timestamp: string;
30
+ jobId: string;
31
+ completedAt?: string | undefined;
32
+ jobType?: string | undefined;
33
+ resultUrl?: string | undefined;
34
+ createdAt?: string | undefined;
35
+ }>;
36
+ type GraphqlBulkJobInput = z.infer<typeof GraphqlBulkJobInputSchema>;
37
+ type GraphqlBulkJobOutput = z.infer<typeof GraphqlBulkJobOutputSchema>;
38
+ export declare function graphqlBulkJobLogic(input: GraphqlBulkJobInput, context: RequestContext, sdkContext?: SdkContext): Promise<GraphqlBulkJobOutput>;
39
+ export declare function graphqlBulkJobResponseFormatter(result: GraphqlBulkJobOutput): McpTextContent[];
40
+ export declare const graphqlBulkJobTool: {
41
+ name: string;
42
+ title: string;
43
+ description: string;
44
+ inputSchema: z.ZodObject<{
45
+ jobId: z.ZodString;
46
+ }, "strip", z.ZodTypeAny, {
47
+ jobId: string;
48
+ }, {
49
+ jobId: string;
50
+ }>;
51
+ outputSchema: z.ZodObject<{
52
+ jobId: z.ZodString;
53
+ status: z.ZodString;
54
+ jobType: z.ZodOptional<z.ZodString>;
55
+ resultUrl: z.ZodOptional<z.ZodString>;
56
+ createdAt: z.ZodOptional<z.ZodString>;
57
+ completedAt: z.ZodOptional<z.ZodString>;
58
+ timestamp: z.ZodString;
59
+ }, "strip", z.ZodTypeAny, {
60
+ status: string;
61
+ timestamp: string;
62
+ jobId: string;
63
+ completedAt?: string | undefined;
64
+ jobType?: string | undefined;
65
+ resultUrl?: string | undefined;
66
+ createdAt?: string | undefined;
67
+ }, {
68
+ status: string;
69
+ timestamp: string;
70
+ jobId: string;
71
+ completedAt?: string | undefined;
72
+ jobType?: string | undefined;
73
+ resultUrl?: string | undefined;
74
+ createdAt?: string | undefined;
75
+ }>;
76
+ annotations: {
77
+ readOnlyHint: boolean;
78
+ openWorldHint: boolean;
79
+ destructiveHint: boolean;
80
+ idempotentHint: boolean;
81
+ };
82
+ inputExamples: {
83
+ label: string;
84
+ input: {
85
+ jobId: string;
86
+ };
87
+ }[];
88
+ logic: typeof graphqlBulkJobLogic;
89
+ responseFormatter: typeof graphqlBulkJobResponseFormatter;
90
+ };
91
+ export {};
92
+ //# sourceMappingURL=graphql-bulk-job.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graphql-bulk-job.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/graphql-bulk-job.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA+BnD,eAAO,MAAM,yBAAyB;;;;;;EAOgB,CAAC;AAEvD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;EAUF,CAAC;AAEtC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAgC/B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CA4B9F;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B9B,CAAC"}
@@ -0,0 +1,124 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
4
+ const TOOL_NAME = "ttd_graphql_bulk_job";
5
+ const TOOL_TITLE = "TTD GraphQL Bulk Job Status";
6
+ const TOOL_DESCRIPTION = `Check the status of a bulk GraphQL job and retrieve its result URL when complete.
7
+
8
+ Returns job progress, status, and a download URL when the job finishes. Result URLs expire after **1 hour** — use \`ttd_download_report\` to download promptly.
9
+
10
+ ### Status Values
11
+ - **QUEUED** — waiting to start
12
+ - **RUNNING** — in progress
13
+ - **SUCCESS** — finished; url available
14
+ - **FAILURE** — job failed
15
+ - **CANCELLED** — job was cancelled`;
16
+ const BULK_JOB_QUERY = `query BulkJob($id: ID!) {
17
+ bulkJob(id: $id) {
18
+ __typename
19
+ id
20
+ status
21
+ createdAt
22
+ completedAt
23
+ ... on BulkQueryJob {
24
+ url
25
+ }
26
+ ... on BulkMutationJob {
27
+ url
28
+ }
29
+ }
30
+ }`;
31
+ export const GraphqlBulkJobInputSchema = z
32
+ .object({
33
+ jobId: z
34
+ .string()
35
+ .min(1)
36
+ .describe("Bulk job ID returned by createQueryBulk or createMutationBulk"),
37
+ })
38
+ .describe("Parameters for checking bulk job status");
39
+ export const GraphqlBulkJobOutputSchema = z
40
+ .object({
41
+ jobId: z.string().describe("Bulk job ID"),
42
+ status: z.string().describe("Job status (QUEUED, RUNNING, SUCCESS, FAILURE, CANCELLED)"),
43
+ jobType: z.string().optional().describe("Concrete job type (BulkQueryJob or BulkMutationJob)"),
44
+ resultUrl: z.string().optional().describe("URL to download results (available on SUCCESS)"),
45
+ createdAt: z.string().optional().describe("ISO datetime when the job was created"),
46
+ completedAt: z.string().optional().describe("ISO datetime when the job completed"),
47
+ timestamp: z.string().datetime(),
48
+ })
49
+ .describe("Bulk job status result");
50
+ export async function graphqlBulkJobLogic(input, context, sdkContext) {
51
+ const { ttdService } = resolveSessionServices(sdkContext);
52
+ const result = (await ttdService.graphqlQuery(BULK_JOB_QUERY, { id: input.jobId }, context));
53
+ const errors = result.errors ?? result.data?.errors;
54
+ if (Array.isArray(errors) && errors.length > 0) {
55
+ const messages = errors.map((e) => e.message ?? JSON.stringify(e)).join("; ");
56
+ throw new McpError(JsonRpcErrorCode.InvalidRequest, `GraphQL error: ${messages}`);
57
+ }
58
+ const job = result.data?.bulkJob ?? result.bulkJob;
59
+ if (!job) {
60
+ throw new McpError(JsonRpcErrorCode.InvalidRequest, "GraphQL response contained no bulkJob data");
61
+ }
62
+ return {
63
+ jobId: job.id ?? input.jobId,
64
+ status: job.status,
65
+ ...(job.__typename && { jobType: job.__typename }),
66
+ ...(job.url && { resultUrl: job.url }),
67
+ ...(job.createdAt && { createdAt: job.createdAt }),
68
+ ...(job.completedAt && { completedAt: job.completedAt }),
69
+ timestamp: new Date().toISOString(),
70
+ };
71
+ }
72
+ export function graphqlBulkJobResponseFormatter(result) {
73
+ const lines = [`Bulk job: ${result.jobId}`, `Status: ${result.status}`];
74
+ if (result.jobType) {
75
+ lines.push(`Type: ${result.jobType}`);
76
+ }
77
+ if (result.createdAt) {
78
+ lines.push(`Created: ${result.createdAt}`);
79
+ }
80
+ if (result.completedAt) {
81
+ lines.push(`Completed: ${result.completedAt}`);
82
+ }
83
+ if (result.resultUrl) {
84
+ lines.push(`\nResult URL: ${result.resultUrl}`);
85
+ lines.push(`⚠️ Result URL expires ~1 hour after the job completes. Download promptly.`);
86
+ }
87
+ lines.push(`\nTimestamp: ${result.timestamp}`);
88
+ return [
89
+ {
90
+ type: "text",
91
+ text: lines.join("\n"),
92
+ },
93
+ ];
94
+ }
95
+ export const graphqlBulkJobTool = {
96
+ name: TOOL_NAME,
97
+ title: TOOL_TITLE,
98
+ description: TOOL_DESCRIPTION,
99
+ inputSchema: GraphqlBulkJobInputSchema,
100
+ outputSchema: GraphqlBulkJobOutputSchema,
101
+ annotations: {
102
+ readOnlyHint: true,
103
+ openWorldHint: false,
104
+ destructiveHint: false,
105
+ idempotentHint: true,
106
+ },
107
+ inputExamples: [
108
+ {
109
+ label: "Check status of a bulk query job",
110
+ input: {
111
+ jobId: "2989826",
112
+ },
113
+ },
114
+ {
115
+ label: "Poll a bulk mutation job for completion",
116
+ input: {
117
+ jobId: "2989827",
118
+ },
119
+ },
120
+ ],
121
+ logic: graphqlBulkJobLogic,
122
+ responseFormatter: graphqlBulkJobResponseFormatter,
123
+ };
124
+ //# sourceMappingURL=graphql-bulk-job.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graphql-bulk-job.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/graphql-bulk-job.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext } from "@cesteral/shared";
3
+ import type { SdkContext } from "@cesteral/shared";
4
+ export declare const GraphqlCancelBulkJobInputSchema: z.ZodObject<{
5
+ jobId: z.ZodString;
6
+ }, "strip", z.ZodTypeAny, {
7
+ jobId: string;
8
+ }, {
9
+ jobId: string;
10
+ }>;
11
+ export declare const GraphqlCancelBulkJobOutputSchema: z.ZodObject<{
12
+ jobId: z.ZodString;
13
+ status: z.ZodString;
14
+ timestamp: z.ZodString;
15
+ }, "strip", z.ZodTypeAny, {
16
+ status: string;
17
+ timestamp: string;
18
+ jobId: string;
19
+ }, {
20
+ status: string;
21
+ timestamp: string;
22
+ jobId: string;
23
+ }>;
24
+ type GraphqlCancelBulkJobInput = z.infer<typeof GraphqlCancelBulkJobInputSchema>;
25
+ type GraphqlCancelBulkJobOutput = z.infer<typeof GraphqlCancelBulkJobOutputSchema>;
26
+ export declare function graphqlCancelBulkJobLogic(input: GraphqlCancelBulkJobInput, context: RequestContext, sdkContext?: SdkContext): Promise<GraphqlCancelBulkJobOutput>;
27
+ export declare function graphqlCancelBulkJobResponseFormatter(result: GraphqlCancelBulkJobOutput): McpTextContent[];
28
+ export declare const graphqlCancelBulkJobTool: {
29
+ name: string;
30
+ title: string;
31
+ description: string;
32
+ inputSchema: z.ZodObject<{
33
+ jobId: z.ZodString;
34
+ }, "strip", z.ZodTypeAny, {
35
+ jobId: string;
36
+ }, {
37
+ jobId: string;
38
+ }>;
39
+ outputSchema: z.ZodObject<{
40
+ jobId: z.ZodString;
41
+ status: z.ZodString;
42
+ timestamp: z.ZodString;
43
+ }, "strip", z.ZodTypeAny, {
44
+ status: string;
45
+ timestamp: string;
46
+ jobId: string;
47
+ }, {
48
+ status: string;
49
+ timestamp: string;
50
+ jobId: string;
51
+ }>;
52
+ annotations: {
53
+ readOnlyHint: boolean;
54
+ openWorldHint: boolean;
55
+ destructiveHint: boolean;
56
+ idempotentHint: boolean;
57
+ };
58
+ inputExamples: {
59
+ label: string;
60
+ input: {
61
+ jobId: string;
62
+ };
63
+ }[];
64
+ logic: typeof graphqlCancelBulkJobLogic;
65
+ responseFormatter: typeof graphqlCancelBulkJobResponseFormatter;
66
+ };
67
+ export {};
68
+ //# sourceMappingURL=graphql-cancel-bulk-job.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graphql-cancel-bulk-job.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/graphql-cancel-bulk-job.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqBnD,eAAO,MAAM,+BAA+B;;;;;;EAOa,CAAC;AAE1D,eAAO,MAAM,gCAAgC;;;;;;;;;;;;EAMF,CAAC;AAE5C,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,CAyCrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BpC,CAAC"}