@cesteral/msads-mcp 1.3.0 → 2.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 (220) hide show
  1. package/README.md +44 -30
  2. package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
  3. package/dist/auth/msads-auth-adapter.js +1 -1
  4. package/dist/auth/msads-auth-adapter.js.map +1 -1
  5. package/dist/cesteral-manifest.json +68 -16
  6. package/dist/config/index.d.ts +36 -67
  7. package/dist/config/index.d.ts.map +1 -1
  8. package/dist/index.js +13 -23
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
  11. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
  12. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
  13. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
  14. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
  15. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
  16. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
  17. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
  18. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
  19. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
  20. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
  21. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
  22. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
  23. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
  24. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
  25. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
  26. package/dist/mcp-server/prompts/index.d.ts +1 -1
  27. package/dist/mcp-server/prompts/index.d.ts.map +1 -1
  28. package/dist/mcp-server/prompts/index.js +15 -0
  29. package/dist/mcp-server/prompts/index.js.map +1 -1
  30. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
  31. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
  32. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
  33. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  34. package/dist/mcp-server/resources/definitions/index.js +10 -9
  35. package/dist/mcp-server/resources/definitions/index.js.map +1 -1
  36. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
  37. package/dist/mcp-server/resources/utils/field-rules.js +11 -11
  38. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
  39. package/dist/mcp-server/server.d.ts +2 -1
  40. package/dist/mcp-server/server.d.ts.map +1 -1
  41. package/dist/mcp-server/server.js +29 -100
  42. package/dist/mcp-server/server.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +26 -132
  44. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +73 -18
  46. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +31 -65
  48. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +44 -13
  50. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +31 -72
  52. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +40 -10
  54. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
  55. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +45 -118
  56. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
  57. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +30 -9
  58. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
  59. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
  60. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
  62. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
  63. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +24 -57
  64. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
  65. package/dist/mcp-server/tools/definitions/create-entity.tool.js +21 -6
  66. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
  67. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +29 -119
  68. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
  69. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +28 -55
  70. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
  71. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +25 -78
  72. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
  73. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +22 -20
  74. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
  75. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +12 -59
  76. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
  77. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +20 -37
  78. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
  79. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
  80. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
  81. package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
  82. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
  83. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
  84. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  85. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
  86. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
  88. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
  89. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
  90. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
  91. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
  92. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
  93. package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
  94. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
  95. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
  96. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
  98. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
  100. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
  101. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
  102. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
  103. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
  104. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
  105. package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
  106. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
  107. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
  108. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
  110. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +27 -57
  112. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
  113. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +40 -10
  114. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
  115. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  116. package/dist/mcp-server/tools/definitions/index.js +6 -0
  117. package/dist/mcp-server/tools/definitions/index.js.map +1 -1
  118. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
  119. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
  120. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
  121. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
  122. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
  123. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
  124. package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
  125. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
  126. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
  127. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
  128. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
  129. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
  130. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +24 -56
  131. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
  132. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +45 -6
  133. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
  134. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +36 -66
  135. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
  136. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +49 -8
  137. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
  138. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
  139. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
  140. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
  141. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
  142. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +35 -112
  143. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
  144. package/dist/mcp-server/tools/definitions/submit-report.tool.js +2 -1
  145. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
  146. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +37 -323
  147. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
  148. package/dist/mcp-server/tools/definitions/update-entity.tool.js +72 -85
  149. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
  150. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
  151. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
  152. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
  153. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
  154. package/dist/mcp-server/tools/index.d.ts +4 -1
  155. package/dist/mcp-server/tools/index.d.ts.map +1 -1
  156. package/dist/mcp-server/tools/index.js +7 -1
  157. package/dist/mcp-server/tools/index.js.map +1 -1
  158. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
  159. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
  160. package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
  161. package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
  162. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
  163. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
  164. package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
  165. package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
  166. package/dist/mcp-server/tools/utils/dry-run.d.ts +12 -3
  167. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  168. package/dist/mcp-server/tools/utils/dry-run.js +46 -8
  169. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
  170. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
  171. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
  172. package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
  173. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
  174. package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
  175. package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
  176. package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
  177. package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
  178. package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
  179. package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
  180. package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
  181. package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
  182. package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
  183. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
  184. package/dist/mcp-server/transports/streamable-http-transport.js +15 -51
  185. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
  186. package/dist/services/msads/msads-http-client.d.ts +5 -1
  187. package/dist/services/msads/msads-http-client.d.ts.map +1 -1
  188. package/dist/services/msads/msads-http-client.js +49 -2
  189. package/dist/services/msads/msads-http-client.js.map +1 -1
  190. package/dist/services/msads/msads-reporting-service.d.ts +3 -9
  191. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
  192. package/dist/services/msads/msads-reporting-service.js +62 -27
  193. package/dist/services/msads/msads-reporting-service.js.map +1 -1
  194. package/dist/services/msads/msads-service.d.ts +53 -5
  195. package/dist/services/msads/msads-service.d.ts.map +1 -1
  196. package/dist/services/msads/msads-service.js +235 -35
  197. package/dist/services/msads/msads-service.js.map +1 -1
  198. package/dist/services/msads/partial-errors.d.ts +34 -0
  199. package/dist/services/msads/partial-errors.d.ts.map +1 -0
  200. package/dist/services/msads/partial-errors.js +149 -0
  201. package/dist/services/msads/partial-errors.js.map +1 -0
  202. package/dist/services/msads/rate-limit-keys.d.ts +8 -2
  203. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
  204. package/dist/services/msads/rate-limit-keys.js +16 -2
  205. package/dist/services/msads/rate-limit-keys.js.map +1 -1
  206. package/dist/services/msads/types.d.ts +1 -2
  207. package/dist/services/msads/types.d.ts.map +1 -1
  208. package/dist/services/msads/types.js.map +1 -1
  209. package/dist/services/session-services.d.ts +2 -2
  210. package/dist/services/session-services.d.ts.map +1 -1
  211. package/dist/services/session-services.js +10 -10
  212. package/dist/services/session-services.js.map +1 -1
  213. package/dist/services/session-wiring.d.ts +7 -0
  214. package/dist/services/session-wiring.d.ts.map +1 -0
  215. package/dist/services/session-wiring.js +20 -0
  216. package/dist/services/session-wiring.js.map +1 -0
  217. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  218. package/dist/testkit/fixtures/index.js +3 -3
  219. package/dist/testkit/fixtures/index.js.map +1 -1
  220. package/package.json +8 -8
@@ -1,14 +1,23 @@
1
- import type { DispatchedCapability, DryRunResult, NormalizedEntitySnapshot, RequestContext } from "@cesteral/shared";
1
+ import type { DispatchedCapability, DryRunResult, DryRunValidationError, NormalizedEntitySnapshot, RequestContext } from "@cesteral/shared";
2
2
  import { type MsAdsServiceLike } from "./capture-snapshot.js";
3
3
  export type { MsAdsServiceLike };
4
- export declare function applyMsAdsPatch(entityType: string, entityId: string, preState: Record<string, unknown>, data: Record<string, unknown>): NormalizedEntitySnapshot | undefined;
4
+ export declare function symbolicValidate(data: Record<string, unknown>): DryRunValidationError[];
5
+ export declare function applyMsAdsPatch(entityType: string, entityId: string, preState: Record<string, unknown>, data: Record<string, unknown>, currency?: string): NormalizedEntitySnapshot | undefined;
5
6
  export declare function resolveMsAdsDispatchedCapability(entityType: string, data: Record<string, unknown>): DispatchedCapability;
6
7
  export declare function resolveMsAdsCreateCapability(entityType: string): DispatchedCapability;
8
+ export declare function resolveMsAdsDuplicateCapability(entityType: string): DispatchedCapability;
9
+ export interface MsAdsDuplicateDryRunArgs {
10
+ entityType: string;
11
+ accountId: string;
12
+ entityId: string;
13
+ options?: Record<string, unknown>;
14
+ }
15
+ export declare function runMsAdsDuplicateDryRun(input: MsAdsDuplicateDryRunArgs, service: MsAdsServiceLike, context: RequestContext): Promise<DryRunResult>;
7
16
  export interface MsAdsCreateDryRunArgs {
8
17
  entityType: string;
9
18
  data: Record<string, unknown>;
10
19
  }
11
- export declare function runMsAdsCreateDryRun(input: MsAdsCreateDryRunArgs, _service: MsAdsServiceLike, _context: RequestContext): Promise<DryRunResult>;
20
+ export declare function runMsAdsCreateDryRun(input: MsAdsCreateDryRunArgs, service: MsAdsServiceLike, context: RequestContext): Promise<DryRunResult>;
12
21
  export interface MsAdsDryRunArgs {
13
22
  entityType: string;
14
23
  entityId: string;
@@ -1 +1 @@
1
- {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAEZ,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnG,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAqEjC,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,wBAAwB,GAAG,SAAS,CAGtC;AAQD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,oBAAoB,CAmBtB;AAQD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAKrF;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AASD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAoCvB"}
1
+ {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAqCjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,EAAE,CA6BvF;AAYD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,GAAE,MAAc,GACvB,wBAAwB,GAAG,SAAS,CAGtC;AAQD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,oBAAoB,CAmBtB;AAQD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAKrF;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAKxF;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AASD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAyCvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAUD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CA2CvB"}
@@ -1,5 +1,6 @@
1
1
  import { assertGovernedDryRunResult } from "@cesteral/shared";
2
- import { buildMsAdsSnapshot, ENTITY_KIND_MAP } from "./capture-snapshot.js";
2
+ import { buildMsAdsSnapshot, ENTITY_KIND_MAP, resolveMsAdsCurrency, } from "./capture-snapshot.js";
3
+ import { MSADS_DUPLICATE_COPY_STATUS } from "../../../services/msads/msads-service.js";
3
4
  const VALID_STATUSES = [
4
5
  "Active",
5
6
  "Paused",
@@ -17,8 +18,8 @@ const PAUSED_STATUSES = new Set([
17
18
  "Suspended",
18
19
  "Expired",
19
20
  ]);
20
- const BUDGET_FIELDS = ["Amount", "DailyBudget", "MonthlyBudget"];
21
- function symbolicValidate(data) {
21
+ const BUDGET_FIELDS = ["Amount", "DailyBudget"];
22
+ export function symbolicValidate(data) {
22
23
  const errors = [];
23
24
  if ("Status" in data) {
24
25
  const status = data.Status;
@@ -45,8 +46,8 @@ function symbolicValidate(data) {
45
46
  }
46
47
  return errors;
47
48
  }
48
- export function applyMsAdsPatch(entityType, entityId, preState, data) {
49
- const snapshot = buildMsAdsSnapshot(entityType, entityId, preState, data);
49
+ export function applyMsAdsPatch(entityType, entityId, preState, data, currency = "USD") {
50
+ const snapshot = buildMsAdsSnapshot(entityType, entityId, preState, data, currency);
50
51
  return snapshot ?? undefined;
51
52
  }
52
53
  export function resolveMsAdsDispatchedCapability(entityType, data) {
@@ -78,12 +79,48 @@ export function resolveMsAdsCreateCapability(entityType) {
78
79
  canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? null,
79
80
  };
80
81
  }
81
- export async function runMsAdsCreateDryRun(input, _service, _context) {
82
+ export function resolveMsAdsDuplicateCapability(entityType) {
83
+ return {
84
+ operation: "duplicate",
85
+ canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? null,
86
+ };
87
+ }
88
+ export async function runMsAdsDuplicateDryRun(input, service, context) {
89
+ const validationErrors = [];
90
+ let expectedPostState;
91
+ let expectedStateSource = "none";
92
+ const inScope = Boolean(ENTITY_KIND_MAP[input.entityType]);
93
+ if (inScope && service.getEntity) {
94
+ const { entities } = await service.getEntity(input.entityType, [input.entityId], { AccountId: Number(input.accountId) }, context);
95
+ const source = (entities[0] ?? {});
96
+ if (Object.keys(source).length > 0) {
97
+ const currency = await resolveMsAdsCurrency(service, context);
98
+ const snapshot = buildMsAdsSnapshot(input.entityType, "", source, {
99
+ ...(input.options ?? {}),
100
+ Status: MSADS_DUPLICATE_COPY_STATUS,
101
+ }, currency);
102
+ if (snapshot) {
103
+ expectedPostState = snapshot;
104
+ expectedStateSource = "server_symbolic_apply";
105
+ }
106
+ }
107
+ }
108
+ const result = {
109
+ wouldSucceed: validationErrors.length === 0 && (!inScope || expectedPostState !== undefined),
110
+ validationErrors,
111
+ validationSource: "symbolic",
112
+ expectedStateSource,
113
+ ...(expectedPostState ? { expectedPostState } : {}),
114
+ };
115
+ return inScope ? assertGovernedDryRunResult(result, "msads_duplicate_entity") : result;
116
+ }
117
+ export async function runMsAdsCreateDryRun(input, service, context) {
82
118
  const validationErrors = symbolicValidate(input.data);
83
119
  let expectedPostState;
84
120
  let expectedStateSource = "none";
85
121
  if (ENTITY_KIND_MAP[input.entityType]) {
86
- const snapshot = buildMsAdsSnapshot(input.entityType, "", {}, input.data);
122
+ const currency = await resolveMsAdsCurrency(service, context);
123
+ const snapshot = buildMsAdsSnapshot(input.entityType, "", {}, input.data, currency);
87
124
  if (snapshot) {
88
125
  expectedPostState = snapshot;
89
126
  expectedStateSource = "server_symbolic_apply";
@@ -107,7 +144,8 @@ export async function runMsAdsUpdateDryRun(input, service, context) {
107
144
  const { entities } = await service.getEntity(input.entityType, [input.entityId], input.readParams, context);
108
145
  const current = entities?.[0];
109
146
  if (current && typeof current === "object") {
110
- const snapshot = buildMsAdsSnapshot(input.entityType, input.entityId, current, input.data);
147
+ const currency = await resolveMsAdsCurrency(service, context);
148
+ const snapshot = buildMsAdsSnapshot(input.entityType, input.entityId, current, input.data, currency);
111
149
  if (snapshot) {
112
150
  expectedPostState = snapshot;
113
151
  expectedStateSource = "server_symbolic_apply";
@@ -1 +1 @@
1
- {"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ import { z } from "zod";
1
2
  export type MsAdsEntityType = "campaign" | "adGroup" | "ad" | "keyword" | "budget" | "adExtension" | "audience" | "label";
2
3
  export interface MsAdsEntityConfig {
3
4
  addOperation: string;
@@ -13,8 +14,34 @@ export interface MsAdsEntityConfig {
13
14
  idsField: string;
14
15
  batchLimit: number;
15
16
  requiredGetByIdsFields?: string[];
17
+ supportsDuplicate?: boolean;
18
+ writeParentIdField?: MsAdsWriteParentIdField;
19
+ deleteParentIdFields?: readonly string[];
20
+ defaultReadFields?: Record<string, unknown>;
16
21
  }
22
+ export type MsAdsWriteParentIdField = "AccountId" | "CampaignId" | "AdGroupId";
23
+ export declare const MSADS_ALL_CAMPAIGN_TYPES = "Search, Shopping, DynamicSearchAds, Audience, Hotel, PerformanceMax, App";
17
24
  export declare function getEntityConfig(entityType: MsAdsEntityType): MsAdsEntityConfig;
18
25
  export declare function getSupportedEntityTypes(): MsAdsEntityType[];
19
26
  export declare function getEntityTypeEnum(): [string, ...string[]];
27
+ export declare function getDuplicateSupportedEntityTypes(): MsAdsEntityType[];
28
+ export declare function getDuplicateEntityTypeEnum(): [string, ...string[]];
29
+ export declare function getWriteParent(entityType: MsAdsEntityType): {
30
+ bodyField: MsAdsWriteParentIdField;
31
+ inputKey: "accountId" | "campaignId" | "adGroupId";
32
+ } | undefined;
33
+ export declare function missingWriteParentMessage(entityType: MsAdsEntityType, parentIds: {
34
+ accountId?: string;
35
+ campaignId?: string;
36
+ adGroupId?: string;
37
+ }): string | undefined;
38
+ export declare function missingDeleteParentMessage(entityType: MsAdsEntityType, params: Record<string, unknown> | undefined): string | undefined;
39
+ export type MsAdsEntityContextKey = "accountId" | "campaignId" | "adGroupId" | "adExtensionType";
40
+ export type MsAdsEntityContext = Partial<Record<MsAdsEntityContextKey, string>>;
41
+ export declare function getEntityContextKeys(entityType: MsAdsEntityType): MsAdsEntityContextKey[];
42
+ export declare function pickEntityContext(entityType: MsAdsEntityType, input: MsAdsEntityContext): MsAdsEntityContext;
43
+ export declare function entityContextReadParams(context: MsAdsEntityContext): Record<string, unknown>;
44
+ export declare function refineEntityContext(input: MsAdsEntityContext & {
45
+ entityType: string;
46
+ }, ctx: z.RefinementCtx): void;
20
47
  //# sourceMappingURL=entity-mapping.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,SAAS,GACT,IAAI,GACJ,SAAS,GACT,QAAQ,GACR,aAAa,GACb,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAEhC,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,eAAe,EAAE,MAAM,CAAC;IAExB,eAAe,EAAE,MAAM,CAAC;IAExB,OAAO,EAAE,MAAM,CAAC;IAEhB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAyGD,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,iBAAiB,CAS9E;AAED,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGzD"}
1
+ {"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,6 @@
1
1
  import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
2
+ import { z } from "zod";
3
+ export const MSADS_ALL_CAMPAIGN_TYPES = "Search, Shopping, DynamicSearchAds, Audience, Hotel, PerformanceMax, App";
2
4
  const ENTITY_CONFIGS = {
3
5
  campaign: {
4
6
  addOperation: "/Campaigns",
@@ -12,6 +14,10 @@ const ENTITY_CONFIGS = {
12
14
  idsField: "CampaignIds",
13
15
  batchLimit: 100,
14
16
  requiredGetByIdsFields: ["AccountId"],
17
+ supportsDuplicate: true,
18
+ writeParentIdField: "AccountId",
19
+ deleteParentIdFields: ["AccountId"],
20
+ defaultReadFields: { CampaignType: MSADS_ALL_CAMPAIGN_TYPES },
15
21
  },
16
22
  adGroup: {
17
23
  addOperation: "/AdGroups",
@@ -26,6 +32,8 @@ const ENTITY_CONFIGS = {
26
32
  idsField: "AdGroupIds",
27
33
  batchLimit: 1000,
28
34
  requiredGetByIdsFields: ["CampaignId"],
35
+ writeParentIdField: "CampaignId",
36
+ deleteParentIdFields: ["CampaignId"],
29
37
  },
30
38
  ad: {
31
39
  addOperation: "/Ads",
@@ -40,6 +48,8 @@ const ENTITY_CONFIGS = {
40
48
  idsField: "AdIds",
41
49
  batchLimit: 50,
42
50
  requiredGetByIdsFields: ["AdGroupId"],
51
+ writeParentIdField: "AdGroupId",
52
+ deleteParentIdFields: ["AdGroupId"],
43
53
  },
44
54
  keyword: {
45
55
  addOperation: "/Keywords",
@@ -54,6 +64,8 @@ const ENTITY_CONFIGS = {
54
64
  idsField: "KeywordIds",
55
65
  batchLimit: 1000,
56
66
  requiredGetByIdsFields: ["AdGroupId"],
67
+ writeParentIdField: "AdGroupId",
68
+ deleteParentIdFields: ["AdGroupId", "AssetGroupId"],
57
69
  },
58
70
  budget: {
59
71
  addOperation: "/Budgets",
@@ -77,6 +89,8 @@ const ENTITY_CONFIGS = {
77
89
  idsField: "AdExtensionIds",
78
90
  batchLimit: 100,
79
91
  requiredGetByIdsFields: ["AccountId", "AdExtensionType"],
92
+ writeParentIdField: "AccountId",
93
+ deleteParentIdFields: ["AccountId"],
80
94
  },
81
95
  audience: {
82
96
  addOperation: "/Audiences",
@@ -115,4 +129,95 @@ export function getEntityTypeEnum() {
115
129
  const types = getSupportedEntityTypes();
116
130
  return types;
117
131
  }
132
+ export function getDuplicateSupportedEntityTypes() {
133
+ return Object.entries(ENTITY_CONFIGS)
134
+ .filter(([, config]) => config.supportsDuplicate)
135
+ .map(([type]) => type);
136
+ }
137
+ export function getDuplicateEntityTypeEnum() {
138
+ return getDuplicateSupportedEntityTypes();
139
+ }
140
+ const PARENT_INPUT_KEYS = {
141
+ AccountId: "accountId",
142
+ CampaignId: "campaignId",
143
+ AdGroupId: "adGroupId",
144
+ };
145
+ export function getWriteParent(entityType) {
146
+ const field = getEntityConfig(entityType).writeParentIdField;
147
+ return field ? { bodyField: field, inputKey: PARENT_INPUT_KEYS[field] } : undefined;
148
+ }
149
+ export function missingWriteParentMessage(entityType, parentIds) {
150
+ const parent = getWriteParent(entityType);
151
+ if (!parent)
152
+ return undefined;
153
+ const value = parentIds[parent.inputKey];
154
+ if (typeof value === "string" && value.trim().length > 0)
155
+ return undefined;
156
+ return `${parent.inputKey} is required for entityType '${entityType}' — Microsoft Ads needs ${parent.bodyField} in the request body next to the ${getEntityConfig(entityType).pluralName} array`;
157
+ }
158
+ export function missingDeleteParentMessage(entityType, params) {
159
+ const config = getEntityConfig(entityType);
160
+ const fields = config.deleteParentIdFields ?? [];
161
+ if (fields.length === 0)
162
+ return undefined;
163
+ const present = fields.some((field) => {
164
+ const value = params?.[field];
165
+ if (typeof value === "number")
166
+ return Number.isFinite(value);
167
+ return typeof value === "string" && value.trim().length > 0;
168
+ });
169
+ if (present)
170
+ return undefined;
171
+ const names = fields.map((f) => `additionalParams.${f}`).join(" or ");
172
+ return `${names} is required for entityType '${entityType}' — Microsoft Ads' Delete${config.pluralName} request needs ${fields.join(" or ")} next to ${config.idsField}`;
173
+ }
174
+ const CONTEXT_INPUT_KEYS = {
175
+ AccountId: "accountId",
176
+ CampaignId: "campaignId",
177
+ AdGroupId: "adGroupId",
178
+ AdExtensionType: "adExtensionType",
179
+ };
180
+ export function getEntityContextKeys(entityType) {
181
+ return (getEntityConfig(entityType).requiredGetByIdsFields ?? []).map((field) => {
182
+ const key = CONTEXT_INPUT_KEYS[field];
183
+ if (!key)
184
+ throw new Error(`No tool input key for Get*ByIds field ${field}`);
185
+ return key;
186
+ });
187
+ }
188
+ export function pickEntityContext(entityType, input) {
189
+ const picked = {};
190
+ for (const key of getEntityContextKeys(entityType)) {
191
+ const value = input[key];
192
+ if (typeof value === "string")
193
+ picked[key] = value;
194
+ }
195
+ return picked;
196
+ }
197
+ export function entityContextReadParams(context) {
198
+ const params = {};
199
+ if (context.accountId !== undefined)
200
+ params.AccountId = Number(context.accountId);
201
+ if (context.campaignId !== undefined)
202
+ params.CampaignId = Number(context.campaignId);
203
+ if (context.adGroupId !== undefined)
204
+ params.AdGroupId = Number(context.adGroupId);
205
+ if (context.adExtensionType !== undefined)
206
+ params.AdExtensionType = context.adExtensionType;
207
+ return params;
208
+ }
209
+ export function refineEntityContext(input, ctx) {
210
+ if (!(input.entityType in ENTITY_CONFIGS))
211
+ return;
212
+ for (const key of getEntityContextKeys(input.entityType)) {
213
+ const value = input[key];
214
+ if (typeof value !== "string" || value.trim().length === 0) {
215
+ ctx.addIssue({
216
+ code: z.ZodIssueCode.custom,
217
+ path: [key],
218
+ message: `${key} is required when entityType is ${input.entityType}`,
219
+ });
220
+ }
221
+ }
222
+ }
118
223
  //# sourceMappingURL=entity-mapping.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { z } from "zod";
2
+ import type { DryRunValidationError } from "@cesteral/shared";
3
+ export declare const parentIdInputFields: {
4
+ accountId: z.ZodOptional<z.ZodString>;
5
+ campaignId: z.ZodOptional<z.ZodString>;
6
+ adGroupId: z.ZodOptional<z.ZodString>;
7
+ };
8
+ export interface ParentIdInput {
9
+ entityType: string;
10
+ accountId?: string;
11
+ campaignId?: string;
12
+ adGroupId?: string;
13
+ }
14
+ export declare function resolveParentId(input: ParentIdInput): string | undefined;
15
+ export declare function validateParentId(input: ParentIdInput): DryRunValidationError[];
16
+ //# sourceMappingURL=parent-ids.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parent-ids.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/parent-ids.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAO9D,eAAO,MAAM,mBAAmB;;;;CAmB/B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAGxE;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,qBAAqB,EAAE,CAK9E"}
@@ -0,0 +1,28 @@
1
+ import { z } from "zod";
2
+ import { getWriteParent, missingWriteParentMessage, } from "./entity-mapping.js";
3
+ export const parentIdInputFields = {
4
+ accountId: z
5
+ .string()
6
+ .optional()
7
+ .describe("Required for campaign and adExtension: the account that owns them, sent as the request-body AccountId"),
8
+ campaignId: z
9
+ .string()
10
+ .optional()
11
+ .describe("Required for adGroup: the campaign that owns every ad group in this call, sent as the request-body CampaignId"),
12
+ adGroupId: z
13
+ .string()
14
+ .optional()
15
+ .describe("Required for ad and keyword: the ad group that owns every item in this call, sent as the request-body AdGroupId"),
16
+ };
17
+ export function resolveParentId(input) {
18
+ const parent = getWriteParent(input.entityType);
19
+ return parent ? input[parent.inputKey] : undefined;
20
+ }
21
+ export function validateParentId(input) {
22
+ const message = missingWriteParentMessage(input.entityType, input);
23
+ if (!message)
24
+ return [];
25
+ const parent = getWriteParent(input.entityType);
26
+ return [{ code: "MISSING_PARENT_ID", message, field: parent?.inputKey ?? "parentId" }];
27
+ }
28
+ //# sourceMappingURL=parent-ids.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parent-ids.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/parent-ids.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,cAAc,EACd,yBAAyB,GAE1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uGAAuG,CACxG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+GAA+G,CAChH;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;CACJ,CAAC;AAUF,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,UAA6B,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,UAA6B,EAAE,KAAK,CAAC,CAAC;IACtF,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,UAA6B,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,IAAI,UAAU,EAAE,CAAC,CAAC;AACzF,CAAC"}
@@ -0,0 +1,9 @@
1
+ export declare const MSADS_AGE_RANGES: ReadonlyArray<{
2
+ Id: string;
3
+ Name: string;
4
+ }>;
5
+ export declare const MSADS_GENDERS: ReadonlyArray<{
6
+ Id: string;
7
+ Name: string;
8
+ }>;
9
+ //# sourceMappingURL=targeting-values.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"targeting-values.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/targeting-values.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CASxE,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAIrE,CAAC"}
@@ -0,0 +1,16 @@
1
+ export const MSADS_AGE_RANGES = [
2
+ { Id: "EighteenToTwentyFour", Name: "18-24" },
3
+ { Id: "TwentyFiveToThirtyFour", Name: "25-34" },
4
+ { Id: "ThirtyFiveToFourtyNine", Name: "35-49" },
5
+ { Id: "ThirtyFiveToFiftyFour", Name: "35-54" },
6
+ { Id: "FiftyToSixtyFour", Name: "50-64" },
7
+ { Id: "FiftyFiveAndAbove", Name: "55+" },
8
+ { Id: "SixtyFiveAndAbove", Name: "65+" },
9
+ { Id: "Unknown", Name: "Unknown age" },
10
+ ];
11
+ export const MSADS_GENDERS = [
12
+ { Id: "Male", Name: "Male" },
13
+ { Id: "Female", Name: "Female" },
14
+ { Id: "Unknown", Name: "Unknown (Audience campaign ad groups only)" },
15
+ ];
16
+ //# sourceMappingURL=targeting-values.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"targeting-values.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/targeting-values.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7C,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/C,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/C,EAAE,EAAE,EAAE,uBAAuB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9C,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE;IACzC,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE;IACxC,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE;IACxC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE;CACvC,CAAC;AAMF,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5B,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,4CAA4C,EAAE;CACtE,CAAC"}
@@ -1,5 +1,11 @@
1
1
  import type { Logger } from "pino";
2
2
  export declare const createMcpHttpServer: (config: {
3
+ host: string;
4
+ nodeEnv: "development" | "production" | "test";
5
+ mcpStatefulSessionTimeoutMs: number;
6
+ logLevel: "error" | "info" | "debug" | "warning" | "notice";
7
+ mcpLogLevel: "error" | "info" | "debug" | "warning" | "notice";
8
+ otelEnabled: boolean;
3
9
  serviceName: string;
4
10
  port: number;
5
11
  otelServiceName: string;
@@ -10,22 +16,23 @@ export declare const createMcpHttpServer: (config: {
10
16
  msadsRateLimitPerMinute: number;
11
17
  msadsReportPollIntervalMs: number;
12
18
  msadsReportMaxPollAttempts: number;
13
- host: string;
14
- nodeEnv: "development" | "production" | "test";
15
- mcpStatefulSessionTimeoutMs: number;
16
- logLevel: "debug" | "info" | "notice" | "warning" | "error";
17
- mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
18
- otelEnabled: boolean;
19
- msadsAccessToken?: string | undefined;
20
- msadsDeveloperToken?: string | undefined;
21
- msadsCustomerId?: string | undefined;
22
- msadsAccountId?: string | undefined;
23
19
  mcpAuthSecretKey?: string | undefined;
24
20
  mcpAllowedOrigins?: string | undefined;
21
+ mcpAllowedHosts?: string | undefined;
25
22
  otelExporterOtlpTracesEndpoint?: string | undefined;
26
23
  otelExporterOtlpMetricsEndpoint?: string | undefined;
27
24
  gcsBucketName?: string | undefined;
25
+ msadsAccessToken?: string | undefined;
26
+ msadsDeveloperToken?: string | undefined;
27
+ msadsCustomerId?: string | undefined;
28
+ msadsAccountId?: string | undefined;
28
29
  }, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
30
+ host: string;
31
+ nodeEnv: "development" | "production" | "test";
32
+ mcpStatefulSessionTimeoutMs: number;
33
+ logLevel: "error" | "info" | "debug" | "warning" | "notice";
34
+ mcpLogLevel: "error" | "info" | "debug" | "warning" | "notice";
35
+ otelEnabled: boolean;
29
36
  serviceName: string;
30
37
  port: number;
31
38
  otelServiceName: string;
@@ -36,20 +43,15 @@ export declare const createMcpHttpServer: (config: {
36
43
  msadsRateLimitPerMinute: number;
37
44
  msadsReportPollIntervalMs: number;
38
45
  msadsReportMaxPollAttempts: number;
39
- host: string;
40
- nodeEnv: "development" | "production" | "test";
41
- mcpStatefulSessionTimeoutMs: number;
42
- logLevel: "debug" | "info" | "notice" | "warning" | "error";
43
- mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
44
- otelEnabled: boolean;
45
- msadsAccessToken?: string | undefined;
46
- msadsDeveloperToken?: string | undefined;
47
- msadsCustomerId?: string | undefined;
48
- msadsAccountId?: string | undefined;
49
46
  mcpAuthSecretKey?: string | undefined;
50
47
  mcpAllowedOrigins?: string | undefined;
48
+ mcpAllowedHosts?: string | undefined;
51
49
  otelExporterOtlpTracesEndpoint?: string | undefined;
52
50
  otelExporterOtlpMetricsEndpoint?: string | undefined;
53
51
  gcsBucketName?: string | undefined;
52
+ msadsAccessToken?: string | undefined;
53
+ msadsDeveloperToken?: string | undefined;
54
+ msadsCustomerId?: string | undefined;
55
+ msadsAccountId?: string | undefined;
54
56
  }, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
55
57
  //# sourceMappingURL=streamable-http-transport.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAwHnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}
1
+ {"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAqEnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}
@@ -1,8 +1,10 @@
1
1
  import { createMcpServer } from "../server.js";
2
- import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
2
+ import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, createSessionForAuthWithEnvFallback, } from "@cesteral/shared";
3
3
  import { MsAdsBearerAuthStrategy } from "../../auth/msads-auth-strategy.js";
4
- import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
4
+ import { sessionServiceStore } from "../../services/session-services.js";
5
+ import { buildEnvAuthAdapter, buildSessionServices } from "../../services/session-wiring.js";
5
6
  import { rateLimiter } from "../../utils/platform.js";
7
+ import { MSADS_RETRY_CONFIG } from "../../services/msads/msads-http-client.js";
6
8
  function buildPlatformConfig(config, logger) {
7
9
  return {
8
10
  authStrategy: config.mcpAuthMode === "msads-bearer"
@@ -26,56 +28,18 @@ function buildPlatformConfig(config, logger) {
26
28
  : "Provide a valid Bearer token in the Authorization header.",
27
29
  sessionServiceStore,
28
30
  rateLimiter,
29
- async createSessionForAuth(authResult, sessionId, appConfig, log) {
30
- const adapter = authResult.platformAuthAdapter;
31
- if (adapter) {
32
- const cfg = appConfig;
33
- const services = createSessionServices(adapter, {
34
- campaignApiBaseUrl: cfg.msadsCampaignApiBaseUrl,
35
- reportingApiBaseUrl: cfg.msadsReportingApiBaseUrl,
36
- customerApiBaseUrl: cfg.msadsCustomerApiBaseUrl,
37
- reportPollIntervalMs: cfg.msadsReportPollIntervalMs,
38
- reportMaxPollAttempts: cfg.msadsReportMaxPollAttempts,
39
- }, log, rateLimiter);
40
- sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
41
- return { services };
42
- }
43
- if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
44
- const cfg = appConfig;
45
- const { msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId } = cfg;
46
- if (msadsAccessToken && msadsDeveloperToken && msadsCustomerId && msadsAccountId) {
47
- const { MsAdsAccessTokenAdapter } = await import("../../auth/msads-auth-adapter.js");
48
- const envAdapter = new MsAdsAccessTokenAdapter(msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId, cfg.msadsCustomerApiBaseUrl);
49
- await envAdapter.validate();
50
- const services = createSessionServices(envAdapter, {
51
- campaignApiBaseUrl: cfg.msadsCampaignApiBaseUrl,
52
- reportingApiBaseUrl: cfg.msadsReportingApiBaseUrl,
53
- customerApiBaseUrl: cfg.msadsCustomerApiBaseUrl,
54
- reportPollIntervalMs: cfg.msadsReportPollIntervalMs,
55
- reportMaxPollAttempts: cfg.msadsReportMaxPollAttempts,
56
- }, log, rateLimiter);
57
- sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
58
- return { services };
59
- }
60
- if (appConfig.mcpAuthMode !== "none") {
61
- return {
62
- services: null,
63
- error: {
64
- message: "Microsoft Ads credentials required. Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID env vars, or use MCP_AUTH_MODE=msads-bearer.",
65
- status: 400,
66
- },
67
- };
68
- }
69
- return { services: null };
70
- }
71
- return {
72
- services: null,
73
- error: {
74
- message: "Microsoft Ads API credentials required for this server.",
75
- status: 400,
76
- },
77
- };
31
+ retryDescriptor: {
32
+ maxRetries: MSADS_RETRY_CONFIG.maxRetries,
78
33
  },
34
+ createSessionForAuth: createSessionForAuthWithEnvFallback({
35
+ sessionServiceStore,
36
+ adapterFromAuth: (authResult) => authResult.platformAuthAdapter,
37
+ validateAuthAdapter: false,
38
+ buildServices: buildSessionServices,
39
+ buildEnvAdapter: buildEnvAuthAdapter,
40
+ credentialsRequiredMessage: "Microsoft Ads credentials required. Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID env vars, or use MCP_AUTH_MODE=msads-bearer.",
41
+ unsupportedModeMessage: "Microsoft Ads API credentials required for this server.",
42
+ }),
79
43
  async createMcpServer(log, sessionId, gcsBucket) {
80
44
  return createMcpServer(log, sessionId, gcsBucket);
81
45
  },