@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
@@ -1,40 +1,137 @@
1
1
  import { z } from "zod";
2
+ import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
2
3
  import { resolveSessionServices } from "../utils/resolve-session.js";
4
+ import { assertMsAdsChunkedBulkCapacity, chunkedBulkCapacityDryRunError, withBulkCapacityError, } from "../utils/bulk-capacity.js";
3
5
  import { getEntityTypeEnum } from "../utils/entity-mapping.js";
6
+ import { parentIdInputFields, resolveParentId, validateParentId } from "../utils/parent-ids.js";
7
+ import { assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
4
8
  const TOOL_NAME = "msads_bulk_create_entities";
5
9
  const TOOL_TITLE = "Bulk Create Microsoft Ads Entities";
6
10
  const TOOL_DESCRIPTION = `Batch create multiple Microsoft Advertising entities in a single operation.
7
11
 
8
- Items are automatically batched per entity type limits. Each batch is sent as a separate API call.`;
12
+ Items are automatically batched per entity type limits. Each batch is sent as a separate API call.
13
+
14
+ All items in one call belong to one parent, sent as the request-body parent element
15
+ Microsoft Ads' Add operation requires: campaign and adExtension need \`accountId\`,
16
+ adGroup needs \`campaignId\`, ad and keyword need \`adGroupId\`. budget, label and
17
+ audience take no parent.`;
18
+ const EFFECT_KIND = "entities_created";
9
19
  export const BulkCreateEntitiesInputSchema = z
10
20
  .object({
11
21
  entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to create"),
12
- items: z.array(z.record(z.unknown())).min(1).describe("Array of entity data objects to create"),
22
+ items: z
23
+ .array(z.record(z.string(), z.unknown()))
24
+ .min(1)
25
+ .describe("Array of entity data objects to create"),
26
+ ...parentIdInputFields,
27
+ dry_run: z
28
+ .boolean()
29
+ .optional()
30
+ .default(false)
31
+ .describe("When true, symbolically validates the batch and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bulk create) without calling the Microsoft Ads API. No entities are created."),
13
32
  })
14
33
  .describe("Parameters for bulk creating Microsoft Ads entities");
15
34
  export const BulkCreateEntitiesOutputSchema = z
16
35
  .object({
17
- results: z.array(z.record(z.any())),
36
+ results: z.array(z.record(z.string(), z.any())),
18
37
  entityType: z.string(),
19
38
  totalItems: z.number(),
20
39
  timestamp: z.string().datetime(),
40
+ dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were created."),
41
+ effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `entities_created` + scalar batch audit summary). Present on a confirmed execute. A bulk write is governed as a single batch effect — it carries no per-entity canonical snapshot."),
42
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `bulk_job` with `canonicalEntityKind: null` (effect class; the governed result is the batch effect, not one entity). Present on every response."),
21
43
  })
22
44
  .describe("Bulk creation result");
23
45
  export async function bulkCreateEntitiesLogic(input, context, sdkContext) {
46
+ const dispatchedCapability = {
47
+ operation: "bulk_job",
48
+ canonicalEntityKind: null,
49
+ };
24
50
  const { msadsService } = resolveSessionServices(sdkContext);
25
- const results = await msadsService.bulkCreateEntities(input.entityType, input.items, context);
51
+ if (input.dry_run === true) {
52
+ const dryRun = withBulkCapacityError(buildBulkEffectDryRun(input), chunkedBulkCapacityDryRunError(msadsService.quotaScope, input.entityType, input.items.length, "items"));
53
+ return {
54
+ results: [],
55
+ entityType: input.entityType,
56
+ totalItems: 0,
57
+ timestamp: new Date().toISOString(),
58
+ dryRun,
59
+ dispatchedCapability,
60
+ };
61
+ }
62
+ const preflight = buildBulkEffectDryRun(input);
63
+ if (!preflight.wouldSucceed) {
64
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid bulk create payload: ${preflight.validationErrors.map((e) => e.message).join("; ")}`);
65
+ }
66
+ assertMsAdsChunkedBulkCapacity(TOOL_NAME, msadsService.quotaScope, input.entityType, input.items.length);
67
+ const results = await msadsService.bulkCreateEntities(input.entityType, input.items, context, resolveParentId(input));
68
+ const requested = input.items.length;
69
+ const succeeded = results.filter((r) => r.success).length;
70
+ const failed = requested - succeeded;
71
+ const effect = {
72
+ effectKind: EFFECT_KIND,
73
+ summary: {
74
+ entity_kind: input.entityType,
75
+ requested,
76
+ succeeded,
77
+ failed,
78
+ partial_success: succeeded > 0 && failed > 0,
79
+ },
80
+ };
26
81
  return {
27
82
  results: results,
28
83
  entityType: input.entityType,
29
84
  totalItems: input.items.length,
30
85
  timestamp: new Date().toISOString(),
86
+ effect,
87
+ dispatchedCapability,
31
88
  };
32
89
  }
90
+ function buildBulkEffectDryRun(input) {
91
+ const validationErrors = [...validateParentId(input)];
92
+ input.items.forEach((item, i) => {
93
+ if (!item || typeof item !== "object" || Object.keys(item).length === 0) {
94
+ validationErrors.push({
95
+ code: "EMPTY_ITEM",
96
+ message: `items[${i}] must be a non-empty entity object`,
97
+ field: `items.${i}`,
98
+ });
99
+ }
100
+ });
101
+ const expectedEffect = {
102
+ effectKind: EFFECT_KIND,
103
+ summary: { entity_kind: input.entityType, requested: input.items.length },
104
+ };
105
+ return assertGovernedEffectDryRun({
106
+ wouldSucceed: validationErrors.length === 0,
107
+ validationErrors,
108
+ validationSource: "symbolic",
109
+ expectedEffectSource: "symbolic",
110
+ expectedEffect,
111
+ }, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
112
+ }
33
113
  export function bulkCreateEntitiesResponseFormatter(result) {
114
+ if (result.dryRun) {
115
+ const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
116
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
117
+ const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
118
+ const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
119
+ return [
120
+ {
121
+ type: "text",
122
+ text: `Dry run: bulk-creating ${String(n)} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were created.` +
123
+ (errs ? `\n${errs}` : "") +
124
+ `\n\nTimestamp: ${result.timestamp}`,
125
+ },
126
+ ];
127
+ }
128
+ const succeeded = result.results.filter((r) => r.success === true).length;
129
+ const failed = result.results.length - succeeded;
130
+ const failedNote = failed > 0 ? ` (${failed} rejected by Microsoft Ads)` : "";
34
131
  return [
35
132
  {
36
133
  type: "text",
37
- text: `Bulk created ${result.totalItems} ${result.entityType} entities\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
134
+ text: `Bulk created ${succeeded}/${result.totalItems} ${result.entityType} entities${failedNote}\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
38
135
  },
39
136
  ];
40
137
  }
@@ -49,20 +146,39 @@ export const bulkCreateEntitiesTool = {
49
146
  openWorldHint: false,
50
147
  idempotentHint: false,
51
148
  destructiveHint: false,
149
+ cesteral: {
150
+ kind: "write",
151
+ writeClass: "effect",
152
+ executableArgsExclude: ["dry_run"],
153
+ platform: "msads",
154
+ contractPlatformSlug: "msads",
155
+ contractToolSlug: "bulk_create_entities",
156
+ operation: ["bulk_job"],
157
+ entityKinds: [],
158
+ entityIdArgs: [],
159
+ schemaVersion: 1,
160
+ contractId: "msads.bulk_create_entities.v1",
161
+ supportsDryRun: true,
162
+ supportsBeforeAfterSnapshot: false,
163
+ requiresValidation: true,
164
+ requiresSimulation: true,
165
+ },
52
166
  },
53
167
  inputExamples: [
54
168
  {
55
169
  label: "Bulk create ad groups",
56
170
  input: {
57
171
  entityType: "adGroup",
58
- items: [
59
- { Name: "Ad Group 1", CampaignId: 123 },
60
- { Name: "Ad Group 2", CampaignId: 123 },
61
- ],
172
+ campaignId: "123",
173
+ items: [{ Name: "Ad Group 1" }, { Name: "Ad Group 2" }],
62
174
  },
63
175
  },
64
176
  ],
65
177
  logic: bulkCreateEntitiesLogic,
66
178
  responseFormatter: bulkCreateEntitiesResponseFormatter,
179
+ untrustedContent: {
180
+ structuredPaths: ["$.results"],
181
+ contentBlocks: [0],
182
+ },
67
183
  };
68
184
  //# sourceMappingURL=bulk-create-entities.tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-create-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"bulk-create-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"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"}
@@ -1,37 +1,26 @@
1
1
  import { z } from "zod";
2
- import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
2
+ import type { RequestContext, McpTextContent, SdkContext, EffectResult, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
3
3
  export declare const BulkUpdateEntitiesInputSchema: z.ZodObject<{
4
- entityType: z.ZodEnum<[string, ...string[]]>;
5
- items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
6
- }, "strip", z.ZodTypeAny, {
7
- entityType: string;
8
- items: Record<string, unknown>[];
9
- }, {
10
- entityType: string;
11
- items: Record<string, unknown>[];
12
- }>;
4
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
5
+ accountId: z.ZodOptional<z.ZodString>;
6
+ campaignId: z.ZodOptional<z.ZodString>;
7
+ adGroupId: z.ZodOptional<z.ZodString>;
8
+ entityType: z.ZodEnum<{
9
+ [x: string]: string;
10
+ }>;
11
+ items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
12
+ }, z.core.$strip>;
13
13
  export declare const BulkUpdateEntitiesOutputSchema: z.ZodObject<{
14
14
  confirmed: z.ZodBoolean;
15
15
  declineReason: z.ZodOptional<z.ZodString>;
16
- results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
16
+ results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
17
17
  entityType: z.ZodString;
18
18
  totalItems: z.ZodNumber;
19
19
  timestamp: z.ZodString;
20
- }, "strip", z.ZodTypeAny, {
21
- entityType: string;
22
- results: Record<string, any>[];
23
- timestamp: string;
24
- confirmed: boolean;
25
- totalItems: number;
26
- declineReason?: string | undefined;
27
- }, {
28
- entityType: string;
29
- results: Record<string, any>[];
30
- timestamp: string;
31
- confirmed: boolean;
32
- totalItems: number;
33
- declineReason?: string | undefined;
34
- }>;
20
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
21
+ effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
22
+ dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
23
+ }, z.core.$strip>;
35
24
  type BulkUpdateEntitiesInput = z.infer<typeof BulkUpdateEntitiesInputSchema>;
36
25
  type BulkUpdateEntitiesOutput = z.infer<typeof BulkUpdateEntitiesOutputSchema>;
37
26
  export declare function bulkUpdateEntitiesLogic(input: BulkUpdateEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkUpdateEntitiesOutput>;
@@ -41,47 +30,54 @@ export declare const bulkUpdateEntitiesTool: {
41
30
  title: string;
42
31
  description: string;
43
32
  inputSchema: z.ZodObject<{
44
- entityType: z.ZodEnum<[string, ...string[]]>;
45
- items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
46
- }, "strip", z.ZodTypeAny, {
47
- entityType: string;
48
- items: Record<string, unknown>[];
49
- }, {
50
- entityType: string;
51
- items: Record<string, unknown>[];
52
- }>;
33
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
34
+ accountId: z.ZodOptional<z.ZodString>;
35
+ campaignId: z.ZodOptional<z.ZodString>;
36
+ adGroupId: z.ZodOptional<z.ZodString>;
37
+ entityType: z.ZodEnum<{
38
+ [x: string]: string;
39
+ }>;
40
+ items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
41
+ }, z.core.$strip>;
53
42
  outputSchema: z.ZodObject<{
54
43
  confirmed: z.ZodBoolean;
55
44
  declineReason: z.ZodOptional<z.ZodString>;
56
- results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
45
+ results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
57
46
  entityType: z.ZodString;
58
47
  totalItems: z.ZodNumber;
59
48
  timestamp: z.ZodString;
60
- }, "strip", z.ZodTypeAny, {
61
- entityType: string;
62
- results: Record<string, any>[];
63
- timestamp: string;
64
- confirmed: boolean;
65
- totalItems: number;
66
- declineReason?: string | undefined;
67
- }, {
68
- entityType: string;
69
- results: Record<string, any>[];
70
- timestamp: string;
71
- confirmed: boolean;
72
- totalItems: number;
73
- declineReason?: string | undefined;
74
- }>;
49
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
50
+ effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
51
+ dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
52
+ }, z.core.$strip>;
75
53
  annotations: {
76
54
  readOnlyHint: boolean;
77
55
  openWorldHint: boolean;
78
56
  idempotentHint: boolean;
79
57
  destructiveHint: boolean;
58
+ cesteral: {
59
+ kind: "write";
60
+ writeClass: "effect";
61
+ executableArgsExclude: string[];
62
+ platform: string;
63
+ contractPlatformSlug: string;
64
+ contractToolSlug: string;
65
+ operation: "bulk_job"[];
66
+ entityKinds: never[];
67
+ entityIdArgs: never[];
68
+ schemaVersion: number;
69
+ contractId: string;
70
+ supportsDryRun: true;
71
+ supportsBeforeAfterSnapshot: false;
72
+ requiresValidation: true;
73
+ requiresSimulation: true;
74
+ };
80
75
  };
81
76
  inputExamples: {
82
77
  label: string;
83
78
  input: {
84
79
  entityType: string;
80
+ accountId: string;
85
81
  items: {
86
82
  Id: number;
87
83
  DailyBudget: number;
@@ -90,6 +86,10 @@ export declare const bulkUpdateEntitiesTool: {
90
86
  }[];
91
87
  logic: typeof bulkUpdateEntitiesLogic;
92
88
  responseFormatter: typeof bulkUpdateEntitiesResponseFormatter;
89
+ untrustedContent: {
90
+ structuredPaths: string[];
91
+ contentBlocks: number[];
92
+ };
93
93
  };
94
94
  export {};
95
95
  //# sourceMappingURL=bulk-update-entities.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-update-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,6BAA6B;;;;;;;;;EAQwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;EASV,CAAC;AAElC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAsCnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAelB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BlC,CAAC"}
1
+ {"version":3,"file":"bulk-update-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAe1B,eAAO,MAAM,6BAA6B;;;;;;;;;iBAgBwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B;;;;;;;;;;iBAkBV,CAAC;AAElC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAgHnC;AA+CD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAkClB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDlC,CAAC"}
@@ -1,33 +1,72 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { assertMsAdsChunkedBulkCapacity, chunkedBulkCapacityDryRunError, withBulkCapacityError, } from "../utils/bulk-capacity.js";
3
4
  import { getEntityTypeEnum } from "../utils/entity-mapping.js";
4
- import { elicitBulkMutationConfirmation, hasSensitiveBulkField } from "@cesteral/shared";
5
+ import { parentIdInputFields, resolveParentId, validateParentId } from "../utils/parent-ids.js";
6
+ import { McpError, JsonRpcErrorCode, elicitBulkMutationConfirmation, hasSensitiveBulkField, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
5
7
  const TOOL_NAME = "msads_bulk_update_entities";
6
8
  const TOOL_TITLE = "Bulk Update Microsoft Ads Entities";
7
9
  const TOOL_DESCRIPTION = `Batch update multiple Microsoft Advertising entities.
8
10
 
9
- Each item must include the Id field. Only include fields you want to change.`;
11
+ Each item must include the Id field. Only include fields you want to change.
12
+
13
+ All items in one call belong to one parent, sent as the request-body parent element
14
+ Microsoft Ads' Update operation requires: campaign and adExtension need \`accountId\`,
15
+ adGroup needs \`campaignId\`, ad and keyword need \`adGroupId\`. budget, label and
16
+ audience take no parent.`;
17
+ const EFFECT_KIND = "entities_updated";
10
18
  export const BulkUpdateEntitiesInputSchema = z
11
19
  .object({
12
20
  entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
13
21
  items: z
14
- .array(z.record(z.unknown()))
22
+ .array(z.record(z.string(), z.unknown()))
15
23
  .min(1)
16
24
  .describe("Array of entity data objects with Id and fields to update"),
25
+ ...parentIdInputFields,
26
+ dry_run: z
27
+ .boolean()
28
+ .optional()
29
+ .default(false)
30
+ .describe("When true, symbolically validates the batch and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bulk update) without prompting for confirmation or calling the Microsoft Ads API. No entities are updated."),
17
31
  })
18
32
  .describe("Parameters for bulk updating Microsoft Ads entities");
19
33
  export const BulkUpdateEntitiesOutputSchema = z
20
34
  .object({
21
35
  confirmed: z.boolean(),
22
36
  declineReason: z.string().optional(),
23
- results: z.array(z.record(z.any())),
37
+ results: z.array(z.record(z.string(), z.any())),
24
38
  entityType: z.string(),
25
39
  totalItems: z.number(),
26
40
  timestamp: z.string().datetime(),
41
+ dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were updated."),
42
+ effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `entities_updated` + scalar batch audit summary). Present on a confirmed execute. A bulk write is governed as a single batch effect — it carries no per-entity canonical snapshot."),
43
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `bulk_job` with `canonicalEntityKind: null` (effect class; the governed result is the batch effect, not one entity). Present on every response."),
27
44
  })
28
45
  .describe("Bulk update result");
29
46
  export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
47
+ const dispatchedCapability = {
48
+ operation: "bulk_job",
49
+ canonicalEntityKind: null,
50
+ };
51
+ const { msadsService } = resolveSessionServices(sdkContext);
52
+ if (input.dry_run === true) {
53
+ const dryRun = withBulkCapacityError(buildBulkEffectDryRun(input), chunkedBulkCapacityDryRunError(msadsService.quotaScope, input.entityType, input.items.length, "items"));
54
+ return {
55
+ confirmed: true,
56
+ results: [],
57
+ entityType: input.entityType,
58
+ totalItems: 0,
59
+ timestamp: new Date().toISOString(),
60
+ dryRun,
61
+ dispatchedCapability,
62
+ };
63
+ }
64
+ const parentErrors = validateParentId(input);
65
+ if (parentErrors.length > 0) {
66
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid bulk update payload: ${parentErrors.map((e) => e.message).join("; ")}`);
67
+ }
30
68
  const items = input.items;
69
+ assertMsAdsChunkedBulkCapacity(TOOL_NAME, msadsService.quotaScope, input.entityType, items.length);
31
70
  const confirmed = await elicitBulkMutationConfirmation({
32
71
  count: items.length,
33
72
  entityLabel: input.entityType,
@@ -44,19 +83,80 @@ export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
44
83
  entityType: input.entityType,
45
84
  totalItems: items.length,
46
85
  timestamp: new Date().toISOString(),
86
+ dispatchedCapability,
47
87
  };
48
88
  }
49
- const { msadsService } = resolveSessionServices(sdkContext);
50
- const results = await msadsService.bulkUpdateEntities(input.entityType, input.items, context);
89
+ const results = await msadsService.bulkUpdateEntities(input.entityType, input.items, context, resolveParentId(input));
90
+ const requested = input.items.length;
91
+ const succeeded = results.filter((r) => r.success).length;
92
+ const failed = requested - succeeded;
93
+ const effect = {
94
+ effectKind: EFFECT_KIND,
95
+ summary: {
96
+ entity_kind: input.entityType,
97
+ requested,
98
+ succeeded,
99
+ failed,
100
+ partial_success: succeeded > 0 && failed > 0,
101
+ },
102
+ };
51
103
  return {
52
104
  confirmed: true,
53
105
  results: results,
54
106
  entityType: input.entityType,
55
107
  totalItems: input.items.length,
56
108
  timestamp: new Date().toISOString(),
109
+ effect,
110
+ dispatchedCapability,
111
+ };
112
+ }
113
+ function buildBulkEffectDryRun(input) {
114
+ const validationErrors = [...validateParentId(input)];
115
+ input.items.forEach((item, i) => {
116
+ if (!item || typeof item !== "object" || Object.keys(item).length === 0) {
117
+ validationErrors.push({
118
+ code: "EMPTY_UPDATE",
119
+ message: `items[${i}] must be a non-empty entity record`,
120
+ field: `items.${i}`,
121
+ });
122
+ return;
123
+ }
124
+ const id = item.Id ?? item.id;
125
+ if (id === undefined || id === null || String(id).trim().length === 0) {
126
+ validationErrors.push({
127
+ code: "MISSING_ID",
128
+ message: `items[${i}] must include an Id to target for update`,
129
+ field: `items.${i}.Id`,
130
+ });
131
+ }
132
+ });
133
+ const expectedEffect = {
134
+ effectKind: EFFECT_KIND,
135
+ summary: { entity_kind: input.entityType, requested: input.items.length },
57
136
  };
137
+ return assertGovernedEffectDryRun({
138
+ wouldSucceed: validationErrors.length === 0,
139
+ validationErrors,
140
+ validationSource: "symbolic",
141
+ expectedEffectSource: "symbolic",
142
+ expectedEffect,
143
+ }, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
58
144
  }
59
145
  export function bulkUpdateEntitiesResponseFormatter(result) {
146
+ if (result.dryRun) {
147
+ const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
148
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
149
+ const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
150
+ const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
151
+ return [
152
+ {
153
+ type: "text",
154
+ text: `Dry run: bulk-updating ${String(n)} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were updated.` +
155
+ (errs ? `\n${errs}` : "") +
156
+ `\n\nTimestamp: ${result.timestamp}`,
157
+ },
158
+ ];
159
+ }
60
160
  if (!result.confirmed) {
61
161
  return [
62
162
  {
@@ -65,10 +165,13 @@ export function bulkUpdateEntitiesResponseFormatter(result) {
65
165
  },
66
166
  ];
67
167
  }
168
+ const succeeded = result.results.filter((r) => r.success === true).length;
169
+ const failed = result.results.length - succeeded;
170
+ const failedNote = failed > 0 ? ` (${failed} rejected by Microsoft Ads)` : "";
68
171
  return [
69
172
  {
70
173
  type: "text",
71
- text: `Bulk updated ${result.totalItems} ${result.entityType} entities\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
174
+ text: `Bulk updated ${succeeded}/${result.totalItems} ${result.entityType} entities${failedNote}\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
72
175
  },
73
176
  ];
74
177
  }
@@ -83,12 +186,30 @@ export const bulkUpdateEntitiesTool = {
83
186
  openWorldHint: false,
84
187
  idempotentHint: true,
85
188
  destructiveHint: false,
189
+ cesteral: {
190
+ kind: "write",
191
+ writeClass: "effect",
192
+ executableArgsExclude: ["dry_run"],
193
+ platform: "msads",
194
+ contractPlatformSlug: "msads",
195
+ contractToolSlug: "bulk_update_entities",
196
+ operation: ["bulk_job"],
197
+ entityKinds: [],
198
+ entityIdArgs: [],
199
+ schemaVersion: 1,
200
+ contractId: "msads.bulk_update_entities.v1",
201
+ supportsDryRun: true,
202
+ supportsBeforeAfterSnapshot: false,
203
+ requiresValidation: true,
204
+ requiresSimulation: true,
205
+ },
86
206
  },
87
207
  inputExamples: [
88
208
  {
89
209
  label: "Bulk update campaign budgets",
90
210
  input: {
91
211
  entityType: "campaign",
212
+ accountId: "789012",
92
213
  items: [
93
214
  { Id: 123, DailyBudget: 100.0 },
94
215
  { Id: 456, DailyBudget: 200.0 },
@@ -98,5 +219,9 @@ export const bulkUpdateEntitiesTool = {
98
219
  ],
99
220
  logic: bulkUpdateEntitiesLogic,
100
221
  responseFormatter: bulkUpdateEntitiesResponseFormatter,
222
+ untrustedContent: {
223
+ structuredPaths: ["$.results"],
224
+ contentBlocks: [0],
225
+ },
101
226
  };
102
227
  //# sourceMappingURL=bulk-update-entities.tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-update-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"bulk-update-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"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"}