@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,134 @@
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_execute_entity_report";
5
+ const TOOL_TITLE = "Execute TTD Entity Report (GraphQL)";
6
+ const TOOL_DESCRIPTION = `Execute an immediate dimension-specific report for an entity via TTD GraphQL.
7
+
8
+ Returns a **direct download URL** with no polling required — unlike the MyReports async flow.
9
+ These are pre-built report types tied to specific entities (ad group, campaign, or advertiser).
10
+
11
+ **Report types** vary by entity. Use \`ttd_get_entity_report_types\` to discover available types
12
+ for a given entity and Kokai tile (e.g. AD_GROUP, SITE, GEO, DEVICE_TYPE, AD_FORMAT).
13
+
14
+ **vs. ttd_get_report:** This tool uses the GraphQL API and returns immediately.
15
+ \`ttd_get_report\` uses the MyReports REST API with fully custom dimensions/metrics.`;
16
+ export const ExecuteEntityReportInputSchema = z
17
+ .object({
18
+ entityType: z
19
+ .enum(["adGroup", "campaign", "advertiser"])
20
+ .describe("The type of entity to generate the report for"),
21
+ entityId: z.string().min(1).describe("ID of the entity (ad group, campaign, or advertiser)"),
22
+ reportType: z
23
+ .string()
24
+ .min(1)
25
+ .describe("Report type enum value (e.g. AD_GROUP, SITE, GEO, DEVICE_TYPE, AD_FORMAT, VIDEO_CREATIVE). " +
26
+ "Use ttd_get_entity_report_types to discover available values for your entity."),
27
+ })
28
+ .describe("Parameters for executing an entity-level report via TTD GraphQL");
29
+ export const ExecuteEntityReportOutputSchema = z
30
+ .object({
31
+ entityType: z.string(),
32
+ entityId: z.string(),
33
+ reportType: z.string(),
34
+ reportId: z.string().nullable().optional().describe("Report ID if returned"),
35
+ downloadUrl: z.string().optional().describe("Direct download URL for the report CSV"),
36
+ hasSampleData: z.boolean().optional().describe("Whether the report contains sample data"),
37
+ userErrors: z
38
+ .array(z.object({ field: z.string(), message: z.string() }))
39
+ .optional()
40
+ .describe("Validation errors from TTD"),
41
+ rawResponse: z.record(z.unknown()).optional(),
42
+ timestamp: z.string().datetime(),
43
+ })
44
+ .describe("Entity report execution result");
45
+ const MUTATION_KEYS = {
46
+ adGroup: "adGroupReportExecute",
47
+ campaign: "campaignReportExecute",
48
+ advertiser: "advertiserReportExecute",
49
+ };
50
+ export async function executeEntityReportLogic(input, context, sdkContext) {
51
+ const { ttdService } = resolveSessionServices(sdkContext);
52
+ const raw = (await ttdService.executeEntityReport(input.entityType, input.entityId, input.reportType, context));
53
+ throwIfGraphqlErrors(raw, "GraphQL error executing entity report");
54
+ const mutationKey = MUTATION_KEYS[input.entityType];
55
+ const gqlData = raw.data ?? {};
56
+ const mutationResult = gqlData[mutationKey] ?? {};
57
+ const reportData = mutationResult.data ?? {};
58
+ const userErrors = mutationResult.userErrors;
59
+ return {
60
+ entityType: input.entityType,
61
+ entityId: input.entityId,
62
+ reportType: input.reportType,
63
+ reportId: reportData.id ?? null,
64
+ downloadUrl: reportData.url,
65
+ hasSampleData: reportData.hasSampleData,
66
+ userErrors: userErrors?.length ? userErrors : undefined,
67
+ rawResponse: raw,
68
+ timestamp: new Date().toISOString(),
69
+ };
70
+ }
71
+ export function executeEntityReportResponseFormatter(result) {
72
+ if (result.userErrors?.length) {
73
+ return [
74
+ {
75
+ type: "text",
76
+ text: `Report execution failed for ${result.entityType} ${result.entityId}:\n\n` +
77
+ result.userErrors.map((e) => `- ${e.field}: ${e.message}`).join("\n") +
78
+ `\n\nTimestamp: ${result.timestamp}`,
79
+ },
80
+ ];
81
+ }
82
+ if (result.downloadUrl) {
83
+ return [
84
+ {
85
+ type: "text",
86
+ text: `Report ready for ${result.entityType} ${result.entityId} (${result.reportType}):\n\n` +
87
+ `Download URL: ${result.downloadUrl}\n` +
88
+ (result.hasSampleData ? `⚠ Contains sample data only.\n` : "") +
89
+ `\nUse \`ttd_download_report\` with this URL to fetch a bounded summary or paged row slice.\n\n` +
90
+ `Timestamp: ${result.timestamp}`,
91
+ },
92
+ ];
93
+ }
94
+ return [
95
+ {
96
+ type: "text",
97
+ text: `Report execution result:\n\n${JSON.stringify(result.rawResponse, null, 2)}\n\nTimestamp: ${result.timestamp}`,
98
+ },
99
+ ];
100
+ }
101
+ export const executeEntityReportTool = {
102
+ name: TOOL_NAME,
103
+ title: TOOL_TITLE,
104
+ description: TOOL_DESCRIPTION,
105
+ inputSchema: ExecuteEntityReportInputSchema,
106
+ outputSchema: ExecuteEntityReportOutputSchema,
107
+ annotations: {
108
+ readOnlyHint: false,
109
+ openWorldHint: true,
110
+ destructiveHint: false,
111
+ idempotentHint: false,
112
+ },
113
+ inputExamples: [
114
+ {
115
+ label: "Execute ad group report",
116
+ input: {
117
+ entityType: "adGroup",
118
+ entityId: "ag123456",
119
+ reportType: "AD_GROUP",
120
+ },
121
+ },
122
+ {
123
+ label: "Execute campaign geo report",
124
+ input: {
125
+ entityType: "campaign",
126
+ entityId: "c789012",
127
+ reportType: "GEO",
128
+ },
129
+ },
130
+ ],
131
+ logic: executeEntityReportLogic,
132
+ responseFormatter: executeEntityReportResponseFormatter,
133
+ };
134
+ //# sourceMappingURL=execute-entity-report.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execute-entity-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/execute-entity-report.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,80 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext } from "@cesteral/shared";
3
+ import type { SdkContext } from "@cesteral/shared";
4
+ export declare const GetAdPreviewInputSchema: z.ZodObject<{
5
+ creativeId: z.ZodString;
6
+ }, "strip", z.ZodTypeAny, {
7
+ creativeId: string;
8
+ }, {
9
+ creativeId: string;
10
+ }>;
11
+ export declare const GetAdPreviewOutputSchema: z.ZodObject<{
12
+ previewUrl: z.ZodOptional<z.ZodString>;
13
+ creativeName: z.ZodOptional<z.ZodString>;
14
+ clickUrl: z.ZodOptional<z.ZodString>;
15
+ adFormat: z.ZodOptional<z.ZodString>;
16
+ creativeId: z.ZodString;
17
+ }, "strip", z.ZodTypeAny, {
18
+ creativeId: string;
19
+ previewUrl?: string | undefined;
20
+ creativeName?: string | undefined;
21
+ clickUrl?: string | undefined;
22
+ adFormat?: string | undefined;
23
+ }, {
24
+ creativeId: string;
25
+ previewUrl?: string | undefined;
26
+ creativeName?: string | undefined;
27
+ clickUrl?: string | undefined;
28
+ adFormat?: string | undefined;
29
+ }>;
30
+ type GetAdPreviewInput = z.infer<typeof GetAdPreviewInputSchema>;
31
+ type GetAdPreviewOutput = z.infer<typeof GetAdPreviewOutputSchema>;
32
+ export declare function getAdPreviewLogic(input: GetAdPreviewInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdPreviewOutput>;
33
+ export declare function getAdPreviewResponseFormatter(result: GetAdPreviewOutput): McpTextContent[];
34
+ export declare const getAdPreviewTool: {
35
+ name: string;
36
+ title: string;
37
+ description: string;
38
+ inputSchema: z.ZodObject<{
39
+ creativeId: z.ZodString;
40
+ }, "strip", z.ZodTypeAny, {
41
+ creativeId: string;
42
+ }, {
43
+ creativeId: string;
44
+ }>;
45
+ outputSchema: z.ZodObject<{
46
+ previewUrl: z.ZodOptional<z.ZodString>;
47
+ creativeName: z.ZodOptional<z.ZodString>;
48
+ clickUrl: z.ZodOptional<z.ZodString>;
49
+ adFormat: z.ZodOptional<z.ZodString>;
50
+ creativeId: z.ZodString;
51
+ }, "strip", z.ZodTypeAny, {
52
+ creativeId: string;
53
+ previewUrl?: string | undefined;
54
+ creativeName?: string | undefined;
55
+ clickUrl?: string | undefined;
56
+ adFormat?: string | undefined;
57
+ }, {
58
+ creativeId: string;
59
+ previewUrl?: string | undefined;
60
+ creativeName?: string | undefined;
61
+ clickUrl?: string | undefined;
62
+ adFormat?: string | undefined;
63
+ }>;
64
+ annotations: {
65
+ readOnlyHint: boolean;
66
+ openWorldHint: boolean;
67
+ idempotentHint: boolean;
68
+ destructiveHint: boolean;
69
+ };
70
+ inputExamples: {
71
+ label: string;
72
+ input: {
73
+ creativeId: string;
74
+ };
75
+ }[];
76
+ logic: typeof getAdPreviewLogic;
77
+ responseFormatter: typeof getAdPreviewResponseFormatter;
78
+ };
79
+ export {};
80
+ //# sourceMappingURL=get-ad-preview.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-ad-preview.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.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;AAWnD,eAAO,MAAM,uBAAuB;;;;;;EAIwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EAQG,CAAC;AAEzC,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,CAmB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAmB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB5B,CAAC"}
@@ -0,0 +1,82 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "ttd_get_ad_preview";
4
+ const TOOL_TITLE = "Get TTD Creative Preview";
5
+ const TOOL_DESCRIPTION = `Get a preview URL for a TTD creative.
6
+
7
+ Fetches the creative entity and extracts its preview URL.
8
+ Returns creative metadata including name, format, and click URL.
9
+
10
+ **Usage:** Use creativeId from ttd_list_entities or ttd_create_entity.`;
11
+ export const GetAdPreviewInputSchema = z
12
+ .object({
13
+ creativeId: z.string().min(1).describe("TTD Creative ID"),
14
+ })
15
+ .describe("Parameters for getting a TTD creative preview");
16
+ export const GetAdPreviewOutputSchema = z
17
+ .object({
18
+ previewUrl: z.string().optional().describe("Preview URL for the creative"),
19
+ creativeName: z.string().optional().describe("Creative name"),
20
+ clickUrl: z.string().optional().describe("Click-through URL"),
21
+ adFormat: z.string().optional().describe("Ad format/type"),
22
+ creativeId: z.string(),
23
+ })
24
+ .describe("TTD creative preview info");
25
+ export async function getAdPreviewLogic(input, context, sdkContext) {
26
+ const { ttdService } = resolveSessionServices(sdkContext);
27
+ const creative = (await ttdService.getEntity("creative", input.creativeId, context));
28
+ return {
29
+ previewUrl: creative.PreviewUrl || creative.ShareLink,
30
+ creativeName: creative.CreativeName,
31
+ clickUrl: creative.ClickUrl ||
32
+ creative.TradeDeskHostedVideoAttributes?.ClickthroughUrl ||
33
+ creative.TradeDeskHostedVideoAttributes?.LandingPageUrl,
34
+ adFormat: creative.CreativeType,
35
+ creativeId: input.creativeId,
36
+ };
37
+ }
38
+ export function getAdPreviewResponseFormatter(result) {
39
+ const lines = ["TTD Creative Preview", "", `Creative ID: ${result.creativeId}`];
40
+ if (result.creativeName)
41
+ lines.push(`Name: ${result.creativeName}`);
42
+ if (result.adFormat)
43
+ lines.push(`Format: ${result.adFormat}`);
44
+ if (result.clickUrl)
45
+ lines.push(`Click URL: ${result.clickUrl}`);
46
+ if (result.previewUrl) {
47
+ lines.push("", `Preview URL: ${result.previewUrl}`);
48
+ }
49
+ else {
50
+ lines.push("", "No preview URL available for this creative.");
51
+ }
52
+ return [
53
+ {
54
+ type: "text",
55
+ text: lines.join("\n"),
56
+ },
57
+ ];
58
+ }
59
+ export const getAdPreviewTool = {
60
+ name: TOOL_NAME,
61
+ title: TOOL_TITLE,
62
+ description: TOOL_DESCRIPTION,
63
+ inputSchema: GetAdPreviewInputSchema,
64
+ outputSchema: GetAdPreviewOutputSchema,
65
+ annotations: {
66
+ readOnlyHint: true,
67
+ openWorldHint: false,
68
+ idempotentHint: true,
69
+ destructiveHint: false,
70
+ },
71
+ inputExamples: [
72
+ {
73
+ label: "Preview a TTD creative",
74
+ input: {
75
+ creativeId: "abcdef123456",
76
+ },
77
+ },
78
+ ],
79
+ logic: getAdPreviewLogic,
80
+ responseFormatter: getAdPreviewResponseFormatter,
81
+ };
82
+ //# sourceMappingURL=get-ad-preview.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-ad-preview.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,61 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
3
+ export declare const GetCampaignVersionInputSchema: z.ZodObject<{
4
+ campaignId: z.ZodString;
5
+ }, "strip", z.ZodTypeAny, {
6
+ campaignId: string;
7
+ }, {
8
+ campaignId: string;
9
+ }>;
10
+ export declare const GetCampaignVersionOutputSchema: z.ZodObject<{
11
+ campaignVersion: z.ZodRecord<z.ZodString, z.ZodUnknown>;
12
+ timestamp: z.ZodString;
13
+ }, "strip", z.ZodTypeAny, {
14
+ timestamp: string;
15
+ campaignVersion: Record<string, unknown>;
16
+ }, {
17
+ timestamp: string;
18
+ campaignVersion: Record<string, unknown>;
19
+ }>;
20
+ type GetCampaignVersionInput = z.infer<typeof GetCampaignVersionInputSchema>;
21
+ type GetCampaignVersionOutput = z.infer<typeof GetCampaignVersionOutputSchema>;
22
+ export declare function getCampaignVersionLogic(input: GetCampaignVersionInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetCampaignVersionOutput>;
23
+ export declare function getCampaignVersionResponseFormatter(result: GetCampaignVersionOutput): McpTextContent[];
24
+ export declare const getCampaignVersionTool: {
25
+ name: string;
26
+ title: string;
27
+ description: string;
28
+ inputSchema: z.ZodObject<{
29
+ campaignId: z.ZodString;
30
+ }, "strip", z.ZodTypeAny, {
31
+ campaignId: string;
32
+ }, {
33
+ campaignId: string;
34
+ }>;
35
+ outputSchema: z.ZodObject<{
36
+ campaignVersion: z.ZodRecord<z.ZodString, z.ZodUnknown>;
37
+ timestamp: z.ZodString;
38
+ }, "strip", z.ZodTypeAny, {
39
+ timestamp: string;
40
+ campaignVersion: Record<string, unknown>;
41
+ }, {
42
+ timestamp: string;
43
+ campaignVersion: 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
+ campaignId: string;
55
+ };
56
+ }[];
57
+ logic: typeof getCampaignVersionLogic;
58
+ responseFormatter: typeof getCampaignVersionResponseFormatter;
59
+ };
60
+ export {};
61
+ //# sourceMappingURL=get-campaign-version.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-campaign-version.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-campaign-version.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;AAQnF,eAAO,MAAM,6BAA6B;;;;;;EAExC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;EAGzC,CAAC;AAEH,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBlC,CAAC"}
@@ -0,0 +1,51 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "ttd_get_campaign_version";
4
+ const TOOL_TITLE = "TTD Get Campaign Version";
5
+ const TOOL_DESCRIPTION = `Get a campaign's Workflows version payload.
6
+
7
+ This is useful for debugging campaign workflow state and comparing versions across updates.`;
8
+ export const GetCampaignVersionInputSchema = z.object({
9
+ campaignId: z.string().min(1).describe("Campaign ID to retrieve version info for"),
10
+ });
11
+ export const GetCampaignVersionOutputSchema = z.object({
12
+ campaignVersion: z.record(z.unknown()).describe("Raw campaign version payload"),
13
+ timestamp: z.string().datetime(),
14
+ });
15
+ export async function getCampaignVersionLogic(input, context, sdkContext) {
16
+ const { ttdService } = resolveSessionServices(sdkContext);
17
+ const campaignVersion = (await ttdService.getCampaignVersion(input.campaignId, context));
18
+ return { campaignVersion, timestamp: new Date().toISOString() };
19
+ }
20
+ export function getCampaignVersionResponseFormatter(result) {
21
+ return [
22
+ {
23
+ type: "text",
24
+ text: `Campaign version:\n\n${JSON.stringify(result.campaignVersion, null, 2)}\n\nTimestamp: ${result.timestamp}`,
25
+ },
26
+ ];
27
+ }
28
+ export const getCampaignVersionTool = {
29
+ name: TOOL_NAME,
30
+ title: TOOL_TITLE,
31
+ description: TOOL_DESCRIPTION,
32
+ inputSchema: GetCampaignVersionInputSchema,
33
+ outputSchema: GetCampaignVersionOutputSchema,
34
+ annotations: {
35
+ readOnlyHint: true,
36
+ openWorldHint: false,
37
+ destructiveHint: false,
38
+ idempotentHint: true,
39
+ },
40
+ inputExamples: [
41
+ {
42
+ label: "Get campaign version",
43
+ input: {
44
+ campaignId: "camp123",
45
+ },
46
+ },
47
+ ],
48
+ logic: getCampaignVersionLogic,
49
+ responseFormatter: getCampaignVersionResponseFormatter,
50
+ };
51
+ //# sourceMappingURL=get-campaign-version.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-campaign-version.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-campaign-version.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAC7C,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,gBAAgB,GAAG;;4FAEmE,CAAC;AAE7F,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC/E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAKH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAA8B,EAC9B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,CAAC,MAAM,UAAU,CAAC,kBAAkB,CAC1D,KAAK,CAAC,UAAU,EAChB,OAAO,CACR,CAA4B,CAAC;IAC9B,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,MAAgC;IAEhC,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAClH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,6BAA6B;IAC1C,YAAY,EAAE,8BAA8B;IAC5C,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,sBAAsB;YAC7B,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;aACtB;SACF;KACF;IACD,KAAK,EAAE,uBAAuB;IAC9B,iBAAiB,EAAE,mCAAmC;CACvD,CAAC"}
@@ -0,0 +1,77 @@
1
+ import { z } from "zod";
2
+ import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
3
+ export declare const GetContextInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
4
+ export declare const GetContextOutputSchema: z.ZodObject<{
5
+ partners: z.ZodArray<z.ZodObject<{
6
+ id: z.ZodString;
7
+ name: z.ZodString;
8
+ }, "strip", z.ZodTypeAny, {
9
+ name: string;
10
+ id: string;
11
+ }, {
12
+ name: string;
13
+ id: string;
14
+ }>, "many">;
15
+ timestamp: z.ZodString;
16
+ }, "strip", z.ZodTypeAny, {
17
+ partners: {
18
+ name: string;
19
+ id: string;
20
+ }[];
21
+ timestamp: string;
22
+ }, {
23
+ partners: {
24
+ name: string;
25
+ id: string;
26
+ }[];
27
+ timestamp: string;
28
+ }>;
29
+ type GetContextInput = z.infer<typeof GetContextInputSchema>;
30
+ type GetContextOutput = z.infer<typeof GetContextOutputSchema>;
31
+ export declare function getContextLogic(_input: GetContextInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetContextOutput>;
32
+ export declare function getContextResponseFormatter(result: GetContextOutput): McpTextContent[];
33
+ export declare const getContextTool: {
34
+ name: string;
35
+ title: string;
36
+ description: string;
37
+ inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
38
+ outputSchema: z.ZodObject<{
39
+ partners: z.ZodArray<z.ZodObject<{
40
+ id: z.ZodString;
41
+ name: z.ZodString;
42
+ }, "strip", z.ZodTypeAny, {
43
+ name: string;
44
+ id: string;
45
+ }, {
46
+ name: string;
47
+ id: string;
48
+ }>, "many">;
49
+ timestamp: z.ZodString;
50
+ }, "strip", z.ZodTypeAny, {
51
+ partners: {
52
+ name: string;
53
+ id: string;
54
+ }[];
55
+ timestamp: string;
56
+ }, {
57
+ partners: {
58
+ name: string;
59
+ id: string;
60
+ }[];
61
+ timestamp: string;
62
+ }>;
63
+ annotations: {
64
+ readOnlyHint: boolean;
65
+ openWorldHint: boolean;
66
+ destructiveHint: boolean;
67
+ idempotentHint: boolean;
68
+ };
69
+ inputExamples: {
70
+ label: string;
71
+ input: {};
72
+ }[];
73
+ logic: typeof getContextLogic;
74
+ responseFormatter: typeof getContextResponseFormatter;
75
+ };
76
+ export {};
77
+ //# sourceMappingURL=get-context.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-context.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-context.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;AAgBnF,eAAO,MAAM,qBAAqB,gDAA8C,CAAC;AAEjF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAYD,CAAC;AAEnC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAI/D,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAqBtF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB1B,CAAC"}
@@ -0,0 +1,80 @@
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_context";
5
+ const TOOL_TITLE = "TTD Get Context";
6
+ const TOOL_DESCRIPTION = `Returns the TTD partner IDs and names accessible with the current credentials.
7
+
8
+ **Call this tool first** when you do not yet know a \`partnerId\`. The response lists every partner the authenticated account can access — pass the \`id\` field as \`partnerId\` to \`ttd_list_entities\` (entityType: "advertiser") to start exploring the account hierarchy.
9
+
10
+ This is a zero-argument cold-start tool. It requires no prior knowledge of the account.
11
+
12
+ ### Typical workflow
13
+ 1. \`ttd_get_context\` → get partner IDs
14
+ 2. \`ttd_list_entities\` (entityType: advertiser, partnerId: "...") → list advertisers
15
+ 3. \`ttd_list_entities\` (entityType: campaign, advertiserId: "...") → list campaigns`;
16
+ export const GetContextInputSchema = z.object({}).describe("No inputs required");
17
+ export const GetContextOutputSchema = z
18
+ .object({
19
+ partners: z
20
+ .array(z.object({
21
+ id: z.string().describe("Partner ID — use as partnerId in ttd_list_entities"),
22
+ name: z.string().describe("Human-readable partner name"),
23
+ }))
24
+ .describe("TTD partners accessible with the current credentials"),
25
+ timestamp: z.string().datetime(),
26
+ })
27
+ .describe("TTD account context");
28
+ const PARTNERS_QUERY = `{ partners { nodes { id name } } }`;
29
+ export async function getContextLogic(_input, context, sdkContext) {
30
+ const { ttdService } = resolveSessionServices(sdkContext);
31
+ const result = (await ttdService.graphqlQuery(PARTNERS_QUERY, undefined, context));
32
+ throwIfGraphqlErrors(result, "GraphQL error fetching partner context");
33
+ const data = result.data ?? result;
34
+ const partners = data.partners?.nodes ?? [];
35
+ return {
36
+ partners,
37
+ timestamp: new Date().toISOString(),
38
+ };
39
+ }
40
+ export function getContextResponseFormatter(result) {
41
+ if (result.partners.length === 0) {
42
+ return [
43
+ {
44
+ type: "text",
45
+ text: `No partners found for the current credentials.\n\nTimestamp: ${result.timestamp}`,
46
+ },
47
+ ];
48
+ }
49
+ const lines = result.partners.map((p) => `- ${p.name} (id: \`${p.id}\`)`).join("\n");
50
+ return [
51
+ {
52
+ type: "text",
53
+ text: `Found ${result.partners.length} partner(s):\n\n${lines}\n\n` +
54
+ `Use one of these IDs as \`partnerId\` when calling \`ttd_list_entities\` (entityType: "advertiser").\n\n` +
55
+ `Timestamp: ${result.timestamp}`,
56
+ },
57
+ ];
58
+ }
59
+ export const getContextTool = {
60
+ name: TOOL_NAME,
61
+ title: TOOL_TITLE,
62
+ description: TOOL_DESCRIPTION,
63
+ inputSchema: GetContextInputSchema,
64
+ outputSchema: GetContextOutputSchema,
65
+ annotations: {
66
+ readOnlyHint: true,
67
+ openWorldHint: false,
68
+ destructiveHint: false,
69
+ idempotentHint: true,
70
+ },
71
+ inputExamples: [
72
+ {
73
+ label: "Get partner IDs to start account discovery",
74
+ input: {},
75
+ },
76
+ ],
77
+ logic: getContextLogic,
78
+ responseFormatter: getContextResponseFormatter,
79
+ };
80
+ //# sourceMappingURL=get-context.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-context.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-context.tool.ts"],"names":[],"mappings":"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"}