@cesteral/msads-mcp 1.2.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 (223) 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 +140 -4
  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 -99
  42. package/dist/mcp-server/server.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +46 -111
  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 +158 -15
  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 +51 -44
  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 +125 -9
  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 +51 -51
  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 +132 -7
  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 +65 -97
  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 +128 -7
  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 +47 -35
  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 +99 -3
  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 +51 -100
  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 +113 -33
  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 +47 -53
  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 +129 -8
  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 +34 -40
  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 +79 -25
  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 +49 -38
  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 +101 -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 +46 -37
  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 +106 -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 +58 -47
  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 +111 -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 +57 -89
  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 +97 -2
  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 +39 -1907
  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 +74 -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 +17 -2
  167. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  168. package/dist/mcp-server/tools/utils/dry-run.js +71 -6
  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 +16 -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 +4 -0
  218. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  219. package/dist/testkit/fixtures/index.js +105 -3
  220. package/dist/testkit/fixtures/index.js.map +1 -1
  221. package/dist/testkit/types.d.ts +2 -2
  222. package/dist/testkit/types.d.ts.map +1 -1
  223. package/package.json +8 -8
@@ -0,0 +1,96 @@
1
+ import { assertBulkCapacity, projectBulkCapacity, McpError, JsonRpcErrorCode, } from "@cesteral/shared";
2
+ import { rateLimiter } from "../../../utils/platform.js";
3
+ import { msadsQuotaBuckets, } from "../../../services/msads/rate-limit-keys.js";
4
+ import { getEntityConfig } from "./entity-mapping.js";
5
+ function oneWritePerChunk(scope) {
6
+ return msadsQuotaBuckets(scope, "write", [3]);
7
+ }
8
+ export function oneStatusWritePerItem(scope) {
9
+ return msadsQuotaBuckets(scope, "write", [1]);
10
+ }
11
+ export function assertMsAdsBulkCapacity(toolName, itemCount, buckets) {
12
+ return assertBulkCapacity({ rateLimiter, toolName, itemCount, buckets });
13
+ }
14
+ function projectChunked(scope, entityType, itemCount) {
15
+ const chunkSize = getEntityConfig(entityType).batchLimit;
16
+ const chunkCount = Math.ceil(itemCount / chunkSize);
17
+ const projection = projectBulkCapacity({
18
+ rateLimiter,
19
+ toolName: "",
20
+ itemCount: chunkCount,
21
+ buckets: oneWritePerChunk(scope),
22
+ });
23
+ return {
24
+ itemCount,
25
+ chunkSize,
26
+ chunkCount,
27
+ chunksThatFit: projection.itemsThatFit,
28
+ itemsThatFit: Math.min(itemCount, projection.itemsThatFit * chunkSize),
29
+ projectedWaitMs: projection.projectedWaitMs,
30
+ budgetMs: projection.budgetMs,
31
+ };
32
+ }
33
+ function describeChunkedRefusal(p) {
34
+ const wait = Number.isFinite(p.projectedWaitMs)
35
+ ? `${Math.ceil(p.projectedWaitMs / 1000)}s`
36
+ : "never (a request costs more than the whole limit)";
37
+ return (`${p.itemCount} items are sent as ${p.chunkCount} requests of up to ${p.chunkSize}, which ` +
38
+ `would take ${wait} to clear the Microsoft Ads rate limit, more than the ` +
39
+ `${Math.ceil(p.budgetMs / 1000)}s budget. ${p.itemsThatFit} item(s) ` +
40
+ `(${p.chunksThatFit} request(s)) fit right now — split the batch into calls of at most ` +
41
+ `${Math.max(p.itemsThatFit, 1)} items.`);
42
+ }
43
+ export function assertMsAdsChunkedBulkCapacity(toolName, scope, entityType, itemCount) {
44
+ const p = projectChunked(scope, entityType, itemCount);
45
+ if (p.chunksThatFit >= p.chunkCount)
46
+ return;
47
+ throw new McpError(JsonRpcErrorCode.RateLimited, `${toolName}: ${describeChunkedRefusal(p)} Nothing was sent.`, {
48
+ reason: "bulk_exceeds_capacity",
49
+ itemCount: p.itemCount,
50
+ itemsThatFit: p.itemsThatFit,
51
+ chunkSize: p.chunkSize,
52
+ chunkCount: p.chunkCount,
53
+ chunksThatFit: p.chunksThatFit,
54
+ projectedWaitMs: Number.isFinite(p.projectedWaitMs) ? p.projectedWaitMs : null,
55
+ budgetMs: p.budgetMs,
56
+ retryAfterMs: Number.isFinite(p.projectedWaitMs)
57
+ ? Math.max(0, p.projectedWaitMs - p.budgetMs)
58
+ : null,
59
+ });
60
+ }
61
+ export function chunkedBulkCapacityDryRunError(scope, entityType, itemCount, field) {
62
+ const p = projectChunked(scope, entityType, itemCount);
63
+ if (p.chunksThatFit >= p.chunkCount)
64
+ return undefined;
65
+ return {
66
+ code: "BULK_EXCEEDS_CAPACITY",
67
+ message: `${describeChunkedRefusal(p)} The call would be refused before any write.`,
68
+ field,
69
+ };
70
+ }
71
+ export function bulkCapacityDryRunError(toolName, itemCount, buckets, field) {
72
+ const projection = projectBulkCapacity({ rateLimiter, toolName, itemCount, buckets });
73
+ if (projection.itemsThatFit >= itemCount)
74
+ return undefined;
75
+ const wait = Number.isFinite(projection.projectedWaitMs)
76
+ ? `${Math.ceil(projection.projectedWaitMs / 1000)}s`
77
+ : "never (an item costs more than the whole limit)";
78
+ return {
79
+ code: "BULK_EXCEEDS_CAPACITY",
80
+ message: `${itemCount} items would take ${wait} to clear the Microsoft Ads rate limit, more than the ` +
81
+ `${Math.ceil(projection.budgetMs / 1000)}s budget, so the call would be refused before any ` +
82
+ `write. ${projection.itemsThatFit} item(s) fit right now — split the batch into chunks of ` +
83
+ `at most ${Math.max(projection.itemsThatFit, 1)}.`,
84
+ field,
85
+ };
86
+ }
87
+ export function withBulkCapacityError(dryRun, error) {
88
+ if (!error)
89
+ return dryRun;
90
+ return {
91
+ ...dryRun,
92
+ wouldSucceed: false,
93
+ validationErrors: [...dryRun.validationErrors, error],
94
+ };
95
+ }
96
+ //# sourceMappingURL=bulk-capacity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bulk-capacity.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/bulk-capacity.ts"],"names":[],"mappings":"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"}
@@ -3,9 +3,12 @@ export interface MsAdsServiceLike {
3
3
  getEntity?: (entityType: any, entityIds: string[], params?: Record<string, unknown>, context?: RequestContext) => Promise<{
4
4
  entities: unknown[];
5
5
  }>;
6
+ getAccountCurrency?: (context?: RequestContext) => Promise<string>;
6
7
  }
8
+ export declare const MSADS_UNKNOWN_CURRENCY = "XXX";
9
+ export declare function resolveMsAdsCurrency(service: MsAdsServiceLike, context?: RequestContext): Promise<string>;
7
10
  export declare const ENTITY_KIND_MAP: Record<string, CanonicalEntityKind>;
8
- export declare function buildMsAdsSnapshot(entityType: string, entityId: string, current: Record<string, unknown>, patch: Record<string, unknown>): NormalizedEntitySnapshot | null;
11
+ export declare function buildMsAdsSnapshot(entityType: string, entityId: string, current: Record<string, unknown>, patch: Record<string, unknown>, currency: string): NormalizedEntitySnapshot | null;
9
12
  export declare function captureMsAdsSnapshot(service: MsAdsServiceLike, entityType: string, entityId: string, params: Record<string, unknown>, context: RequestContext): Promise<NormalizedEntitySnapshot | undefined>;
10
- export declare function snapshotFromMsAdsEntity(entityType: string, entityId: string, entity: Record<string, unknown>): NormalizedEntitySnapshot | undefined;
13
+ export declare function snapshotFromMsAdsEntity(entityType: string, entityId: string, entity: Record<string, unknown>, currency: string): NormalizedEntitySnapshot | undefined;
11
14
  //# sourceMappingURL=capture-snapshot.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"capture-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,mBAAmB,EAGnB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAG/B,SAAS,CAAC,EAAE,CACV,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CACvC;AAMD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAK/D,CAAC;AAuDF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,wBAAwB,GAAG,IAAI,CA+CjC;AAQD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAW/C;AAUD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,wBAAwB,GAAG,SAAS,CActC"}
1
+ {"version":3,"file":"capture-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EACV,mBAAmB,EAGnB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAG/B,SAAS,CAAC,EAAE,CACV,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAEtC,kBAAkB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpE;AAOD,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAO5C,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAMD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAK/D,CAAC;AAwEF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,GACf,wBAAwB,GAAG,IAAI,CA0CjC;AAQD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAY/C;AAUD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GACf,wBAAwB,GAAG,SAAS,CAatC"}
@@ -1,3 +1,14 @@
1
+ export const MSADS_UNKNOWN_CURRENCY = "XXX";
2
+ export async function resolveMsAdsCurrency(service, context) {
3
+ if (!service.getAccountCurrency)
4
+ return MSADS_UNKNOWN_CURRENCY;
5
+ try {
6
+ return await service.getAccountCurrency(context);
7
+ }
8
+ catch {
9
+ return MSADS_UNKNOWN_CURRENCY;
10
+ }
11
+ }
1
12
  export const ENTITY_KIND_MAP = {
2
13
  campaign: "campaign",
3
14
  adGroup: "ad_group",
@@ -18,13 +29,25 @@ function normalizeStatus(raw) {
18
29
  const platformRaw = typeof raw === "string" ? raw : "";
19
30
  return { canonical: STATUS_MAP[platformRaw] ?? "unknown", platformRaw };
20
31
  }
21
- function toMinor(amount) {
32
+ function currencyExponent(currency) {
33
+ if (currency === MSADS_UNKNOWN_CURRENCY)
34
+ return 2;
35
+ try {
36
+ const digits = new Intl.NumberFormat("en", { style: "currency", currency }).resolvedOptions()
37
+ .maximumFractionDigits;
38
+ return typeof digits === "number" ? digits : 2;
39
+ }
40
+ catch {
41
+ return 2;
42
+ }
43
+ }
44
+ function toMinor(amount, currency) {
22
45
  if (amount == null)
23
46
  return undefined;
24
47
  const n = typeof amount === "string" ? Number(amount) : Number(amount);
25
48
  if (!Number.isFinite(n))
26
49
  return undefined;
27
- return Math.round(n * 100);
50
+ return Math.round(n * 10 ** currencyExponent(currency));
28
51
  }
29
52
  function dateToIso(raw) {
30
53
  if (!raw || typeof raw !== "object")
@@ -38,19 +61,23 @@ function dateToIso(raw) {
38
61
  const pad = (n) => String(n).padStart(2, "0");
39
62
  return `${year}-${pad(month)}-${pad(day)}`;
40
63
  }
41
- export function buildMsAdsSnapshot(entityType, entityId, current, patch) {
64
+ export function buildMsAdsSnapshot(entityType, entityId, current, patch, currency) {
42
65
  const entityKind = ENTITY_KIND_MAP[entityType];
43
66
  if (!entityKind)
44
67
  return null;
45
68
  const merged = { ...current, ...patch };
46
69
  let daily = null;
47
70
  let lifetime = null;
48
- const currency = "USD";
49
71
  if (entityKind === "campaign_budget") {
50
- const amountMinor = toMinor(merged.Amount);
72
+ const amountMinor = toMinor(merged.Amount, currency);
73
+ if (amountMinor != null)
74
+ daily = { amountMinor, currency };
75
+ }
76
+ else if (entityKind === "campaign") {
77
+ const amountMinor = toMinor(merged.DailyBudget, currency);
51
78
  if (amountMinor != null) {
52
79
  const money = { amountMinor, currency };
53
- if (merged.BudgetType === "MonthlyBudgetSpendUntilDepleted") {
80
+ if (merged.BudgetType === "LifetimeBudgetStandard") {
54
81
  lifetime = money;
55
82
  }
56
83
  else {
@@ -58,14 +85,6 @@ export function buildMsAdsSnapshot(entityType, entityId, current, patch) {
58
85
  }
59
86
  }
60
87
  }
61
- else if (entityKind === "campaign") {
62
- const dailyMinor = toMinor(merged.DailyBudget);
63
- const monthlyMinor = toMinor(merged.MonthlyBudget);
64
- if (dailyMinor != null)
65
- daily = { amountMinor: dailyMinor, currency };
66
- if (monthlyMinor != null)
67
- lifetime = { amountMinor: monthlyMinor, currency };
68
- }
69
88
  return {
70
89
  schemaVersion: 1,
71
90
  platform: "msads",
@@ -89,25 +108,25 @@ export async function captureMsAdsSnapshot(service, entityType, entityId, params
89
108
  const current = entities?.[0];
90
109
  if (!current || typeof current !== "object")
91
110
  return undefined;
92
- const snapshot = buildMsAdsSnapshot(entityType, entityId, current, {});
111
+ const currency = await resolveMsAdsCurrency(service, context);
112
+ const snapshot = buildMsAdsSnapshot(entityType, entityId, current, {}, currency);
93
113
  return snapshot ?? undefined;
94
114
  }
95
115
  catch {
96
116
  return undefined;
97
117
  }
98
118
  }
99
- export function snapshotFromMsAdsEntity(entityType, entityId, entity) {
119
+ export function snapshotFromMsAdsEntity(entityType, entityId, entity, currency) {
100
120
  if (!ENTITY_KIND_MAP[entityType])
101
121
  return undefined;
102
122
  if (!entity ||
103
123
  (entity.Status == null &&
104
124
  entity.Name == null &&
105
125
  entity.Amount == null &&
106
- entity.DailyBudget == null &&
107
- entity.MonthlyBudget == null)) {
126
+ entity.DailyBudget == null)) {
108
127
  return undefined;
109
128
  }
110
- const snapshot = buildMsAdsSnapshot(entityType, entityId, entity, {});
129
+ const snapshot = buildMsAdsSnapshot(entityType, entityId, entity, {}, currency);
111
130
  return snapshot ?? undefined;
112
131
  }
113
132
  //# sourceMappingURL=capture-snapshot.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"capture-snapshot.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"capture-snapshot.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"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"}
@@ -1,8 +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;
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>;
16
+ export interface MsAdsCreateDryRunArgs {
17
+ entityType: string;
18
+ data: Record<string, unknown>;
19
+ }
20
+ export declare function runMsAdsCreateDryRun(input: MsAdsCreateDryRunArgs, service: MsAdsServiceLike, context: RequestContext): Promise<DryRunResult>;
6
21
  export interface MsAdsDryRunArgs {
7
22
  entityType: string;
8
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;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) {
@@ -72,6 +73,69 @@ export function resolveMsAdsDispatchedCapability(entityType, data) {
72
73
  canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? entityType ?? "unknown",
73
74
  };
74
75
  }
76
+ export function resolveMsAdsCreateCapability(entityType) {
77
+ return {
78
+ operation: "create",
79
+ canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? null,
80
+ };
81
+ }
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) {
118
+ const validationErrors = symbolicValidate(input.data);
119
+ let expectedPostState;
120
+ let expectedStateSource = "none";
121
+ if (ENTITY_KIND_MAP[input.entityType]) {
122
+ const currency = await resolveMsAdsCurrency(service, context);
123
+ const snapshot = buildMsAdsSnapshot(input.entityType, "", {}, input.data, currency);
124
+ if (snapshot) {
125
+ expectedPostState = snapshot;
126
+ expectedStateSource = "server_symbolic_apply";
127
+ }
128
+ }
129
+ const inScope = Boolean(ENTITY_KIND_MAP[input.entityType]);
130
+ const result = {
131
+ wouldSucceed: validationErrors.length === 0 && (!inScope || expectedPostState !== undefined),
132
+ validationErrors,
133
+ validationSource: "symbolic",
134
+ expectedStateSource,
135
+ ...(expectedPostState ? { expectedPostState } : {}),
136
+ };
137
+ return inScope ? assertGovernedDryRunResult(result, "msads_create_entity") : result;
138
+ }
75
139
  export async function runMsAdsUpdateDryRun(input, service, context) {
76
140
  const validationErrors = symbolicValidate(input.data);
77
141
  let expectedPostState;
@@ -80,7 +144,8 @@ export async function runMsAdsUpdateDryRun(input, service, context) {
80
144
  const { entities } = await service.getEntity(input.entityType, [input.entityId], input.readParams, context);
81
145
  const current = entities?.[0];
82
146
  if (current && typeof current === "object") {
83
- 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);
84
149
  if (snapshot) {
85
150
  expectedPostState = snapshot;
86
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