@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,23 +1,13 @@
1
1
  import { z } from "zod";
2
- import { resolveSessionServices } from "../utils/resolve-session.js";
2
+ import { McpError, JsonRpcErrorCode, NO_UNTRUSTED_CONTENT, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
3
3
  const TOOL_NAME = "msads_create_report_schedule";
4
4
  const TOOL_TITLE = "Create Microsoft Ads Report Schedule";
5
- const TOOL_DESCRIPTION = `Create a scheduled report request in Microsoft Advertising.
5
+ const TOOL_DESCRIPTION = `NOT SUPPORTED — always fails without calling Microsoft Advertising. Nothing is scheduled.
6
6
 
7
- Submits a report request with a Schedule object, which Microsoft Advertising will re-run on the configured frequency. Returns a scheduleId to reference this schedule.
7
+ The Microsoft Advertising Reporting API v13 has no report schedules: it exposes only GenerateReport/Submit and GenerateReport/Poll, and ReportRequest has no Schedule element. No API call can create, list or delete a report schedule.
8
8
 
9
- **Frequency values:** Daily, Weekly, Monthly
10
-
11
- **Example schedule:**
12
- \`\`\`json
13
- {
14
- "StartDate": "2026-04-07",
15
- "EndDate": "2026-12-31",
16
- "Frequency": "Weekly"
17
- }
18
- \`\`\`
19
-
20
- Note: Microsoft Advertising's API has limited schedule management. Use the UI at app.ads.microsoft.com to view, edit, or delete existing schedules.`;
9
+ For a one-off report use msads_submit_report + msads_check_report_status, or msads_get_report.`;
10
+ export const MSADS_NO_REPORT_SCHEDULES_MESSAGE = "Microsoft Advertising Reporting API v13 has no report schedules — it exposes only GenerateReport/Submit and GenerateReport/Poll, and ReportRequest has no Schedule element. Nothing was scheduled. Run a one-off report with msads_submit_report / msads_get_report instead.";
21
11
  export const CreateReportScheduleInputSchema = z
22
12
  .object({
23
13
  accountId: z.string().describe("Microsoft Ads Account ID"),
@@ -37,37 +27,109 @@ export const CreateReportScheduleInputSchema = z
37
27
  Frequency: z.enum(["Daily", "Weekly", "Monthly"]).describe("How often the report runs"),
38
28
  })
39
29
  .describe("Schedule configuration"),
30
+ dry_run: z
31
+ .boolean()
32
+ .optional()
33
+ .default(false)
34
+ .describe("When true, returns an EffectDryRunResult under `dryRun` that always reports wouldSucceed: false (Microsoft Advertising has no report schedules). Never calls the Microsoft Ads API."),
40
35
  })
41
36
  .describe("Parameters for creating a scheduled Microsoft Ads report");
42
37
  export const CreateReportScheduleOutputSchema = z
43
38
  .object({
44
- scheduleId: z.string().describe("Schedule ID (ReportRequestId of first scheduled run)"),
45
- scheduleName: z.string(),
39
+ scheduleId: z
40
+ .string()
41
+ .optional()
42
+ .describe("Never populated: Microsoft Advertising has no report schedules, so this tool creates nothing."),
43
+ scheduleName: z.string().optional(),
46
44
  timestamp: z.string().datetime(),
45
+ dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No schedule was created."),
46
+ effect: EffectResultSchema.optional().describe("Never emitted: every execute call fails, so no schedule is ever saved."),
47
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `create_schedule` with `canonicalEntityKind: null` (effect class). Present on every response."),
47
48
  })
48
49
  .describe("Created report schedule");
49
- export async function createReportScheduleLogic(input, context, sdkContext) {
50
- const { msadsReportingService } = resolveSessionServices(sdkContext);
51
- const result = await msadsReportingService.createReportSchedule({
52
- reportType: input.reportType,
53
- accountId: input.accountId,
54
- columns: input.columns,
55
- dateRange: { startDate: input.startDate, endDate: input.endDate },
56
- aggregation: input.aggregation,
57
- scheduleName: input.scheduleName,
58
- schedule: input.schedule,
59
- }, context);
60
- return {
61
- scheduleId: result.scheduleId,
62
- scheduleName: result.scheduleName,
63
- timestamp: new Date().toISOString(),
50
+ export async function createReportScheduleLogic(input, _context, _sdkContext) {
51
+ const dispatchedCapability = {
52
+ operation: "create_schedule",
53
+ canonicalEntityKind: null,
64
54
  };
55
+ if (input.dry_run === true) {
56
+ const dryRun = buildEffectDryRun(input);
57
+ return {
58
+ timestamp: new Date().toISOString(),
59
+ dryRun,
60
+ dispatchedCapability,
61
+ };
62
+ }
63
+ throw new McpError(JsonRpcErrorCode.InvalidRequest, MSADS_NO_REPORT_SCHEDULES_MESSAGE, {
64
+ platform: "msads",
65
+ tool: TOOL_NAME,
66
+ unsupported: true,
67
+ });
68
+ }
69
+ function buildEffectDryRun(input) {
70
+ const validationErrors = [
71
+ {
72
+ code: "UNSUPPORTED_OPERATION",
73
+ message: MSADS_NO_REPORT_SCHEDULES_MESSAGE,
74
+ field: "schedule",
75
+ },
76
+ ];
77
+ if (input.scheduleName.trim().length === 0) {
78
+ validationErrors.push({
79
+ code: "INVALID_SCHEDULE_NAME",
80
+ message: "scheduleName must be a non-empty schedule name",
81
+ field: "scheduleName",
82
+ });
83
+ }
84
+ const dateRe = /^\d{4}-\d{2}-\d{2}$/;
85
+ const startOk = dateRe.test(input.startDate);
86
+ const endOk = dateRe.test(input.endDate);
87
+ if (!startOk) {
88
+ validationErrors.push({
89
+ code: "INVALID_DATE_FORMAT",
90
+ message: `startDate must be YYYY-MM-DD — got "${input.startDate}"`,
91
+ field: "startDate",
92
+ });
93
+ }
94
+ if (!endOk) {
95
+ validationErrors.push({
96
+ code: "INVALID_DATE_FORMAT",
97
+ message: `endDate must be YYYY-MM-DD — got "${input.endDate}"`,
98
+ field: "endDate",
99
+ });
100
+ }
101
+ if (startOk && endOk && input.startDate > input.endDate) {
102
+ validationErrors.push({
103
+ code: "INVALID_DATE_RANGE",
104
+ message: `startDate (${input.startDate}) must be on or before endDate (${input.endDate})`,
105
+ field: "startDate",
106
+ });
107
+ }
108
+ return assertGovernedEffectDryRun({
109
+ wouldSucceed: false,
110
+ validationErrors,
111
+ validationSource: "symbolic",
112
+ expectedEffectSource: "none",
113
+ }, TOOL_NAME, { requiresValidation: true, requiresSimulation: false });
65
114
  }
66
115
  export function createReportScheduleResponseFormatter(result) {
116
+ if (result.dryRun) {
117
+ const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
118
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
119
+ const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
120
+ return [
121
+ {
122
+ type: "text",
123
+ text: `Dry run: creating a report schedule ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). Microsoft Advertising has no report schedules; no schedule was created.` +
124
+ (errs ? `\n${errs}` : "") +
125
+ `\n\nTimestamp: ${result.timestamp}`,
126
+ },
127
+ ];
128
+ }
67
129
  return [
68
130
  {
69
131
  type: "text",
70
- text: `Scheduled report created: ${result.scheduleId}\nName: ${result.scheduleName}\nTimestamp: ${result.timestamp}`,
132
+ text: `${MSADS_NO_REPORT_SCHEDULES_MESSAGE}\n\nTimestamp: ${result.timestamp}`,
71
133
  },
72
134
  ];
73
135
  }
@@ -82,6 +144,23 @@ export const createReportScheduleTool = {
82
144
  openWorldHint: false,
83
145
  destructiveHint: false,
84
146
  idempotentHint: false,
147
+ cesteral: {
148
+ kind: "write",
149
+ writeClass: "effect",
150
+ executableArgsExclude: ["dry_run"],
151
+ platform: "msads",
152
+ contractPlatformSlug: "msads",
153
+ contractToolSlug: "create_report_schedule",
154
+ operation: ["create_schedule"],
155
+ entityKinds: [],
156
+ entityIdArgs: [],
157
+ schemaVersion: 1,
158
+ contractId: "msads.create_report_schedule.v1",
159
+ supportsDryRun: true,
160
+ supportsBeforeAfterSnapshot: false,
161
+ requiresValidation: true,
162
+ requiresSimulation: false,
163
+ },
85
164
  },
86
165
  inputExamples: [
87
166
  {
@@ -104,5 +183,6 @@ export const createReportScheduleTool = {
104
183
  ],
105
184
  logic: createReportScheduleLogic,
106
185
  responseFormatter: createReportScheduleResponseFormatter,
186
+ untrustedContent: NO_UNTRUSTED_CONTENT,
107
187
  };
108
188
  //# sourceMappingURL=create-report-schedule.tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-report-schedule.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"create-report-schedule.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"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"}
@@ -1,40 +1,25 @@
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 DeleteEntityInputSchema: z.ZodObject<{
4
- entityType: z.ZodEnum<[string, ...string[]]>;
5
- entityIds: z.ZodArray<z.ZodString, "many">;
4
+ entityType: z.ZodEnum<{
5
+ [x: string]: string;
6
+ }>;
7
+ entityIds: z.ZodArray<z.ZodString>;
6
8
  additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
7
- }, "strip", z.ZodTypeAny, {
8
- entityType: string;
9
- entityIds: string[];
10
- additionalParams?: Record<string, unknown> | undefined;
11
- }, {
12
- entityType: string;
13
- entityIds: string[];
14
- additionalParams?: Record<string, unknown> | undefined;
15
- }>;
9
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
10
+ }, z.core.$strip>;
16
11
  export declare const DeleteEntityOutputSchema: z.ZodObject<{
17
12
  confirmed: z.ZodBoolean;
18
13
  declineReason: z.ZodOptional<z.ZodString>;
19
14
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
20
15
  entityType: z.ZodString;
21
16
  deletedCount: z.ZodNumber;
17
+ failedCount: z.ZodNumber;
22
18
  timestamp: z.ZodString;
23
- }, "strip", z.ZodTypeAny, {
24
- entityType: string;
25
- timestamp: string;
26
- result: Record<string, any>;
27
- confirmed: boolean;
28
- deletedCount: number;
29
- declineReason?: string | undefined;
30
- }, {
31
- entityType: string;
32
- timestamp: string;
33
- result: Record<string, any>;
34
- confirmed: boolean;
35
- deletedCount: number;
36
- declineReason?: string | undefined;
37
- }>;
19
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
20
+ effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
21
+ dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
22
+ }, z.core.$strip>;
38
23
  type DeleteEntityInput = z.infer<typeof DeleteEntityInputSchema>;
39
24
  type DeleteEntityOutput = z.infer<typeof DeleteEntityOutputSchema>;
40
25
  export declare function deleteEntityLogic(input: DeleteEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<DeleteEntityOutput>;
@@ -44,55 +29,64 @@ export declare const deleteEntityTool: {
44
29
  title: string;
45
30
  description: string;
46
31
  inputSchema: z.ZodObject<{
47
- entityType: z.ZodEnum<[string, ...string[]]>;
48
- entityIds: z.ZodArray<z.ZodString, "many">;
32
+ entityType: z.ZodEnum<{
33
+ [x: string]: string;
34
+ }>;
35
+ entityIds: z.ZodArray<z.ZodString>;
49
36
  additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
50
- }, "strip", z.ZodTypeAny, {
51
- entityType: string;
52
- entityIds: string[];
53
- additionalParams?: Record<string, unknown> | undefined;
54
- }, {
55
- entityType: string;
56
- entityIds: string[];
57
- additionalParams?: Record<string, unknown> | undefined;
58
- }>;
37
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
38
+ }, z.core.$strip>;
59
39
  outputSchema: z.ZodObject<{
60
40
  confirmed: z.ZodBoolean;
61
41
  declineReason: z.ZodOptional<z.ZodString>;
62
42
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
63
43
  entityType: z.ZodString;
64
44
  deletedCount: z.ZodNumber;
45
+ failedCount: z.ZodNumber;
65
46
  timestamp: z.ZodString;
66
- }, "strip", z.ZodTypeAny, {
67
- entityType: string;
68
- timestamp: string;
69
- result: Record<string, any>;
70
- confirmed: boolean;
71
- deletedCount: number;
72
- declineReason?: string | undefined;
73
- }, {
74
- entityType: string;
75
- timestamp: string;
76
- result: Record<string, any>;
77
- confirmed: boolean;
78
- deletedCount: number;
79
- declineReason?: string | undefined;
80
- }>;
47
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
48
+ effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
49
+ dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
50
+ }, z.core.$strip>;
81
51
  annotations: {
82
52
  readOnlyHint: boolean;
83
53
  openWorldHint: boolean;
84
54
  idempotentHint: boolean;
85
55
  destructiveHint: boolean;
56
+ cesteral: {
57
+ kind: "write";
58
+ writeClass: "effect";
59
+ executableArgsExclude: string[];
60
+ platform: string;
61
+ contractPlatformSlug: string;
62
+ contractToolSlug: string;
63
+ operation: "bulk_job"[];
64
+ entityKinds: never[];
65
+ entityIdArgs: never[];
66
+ schemaVersion: number;
67
+ contractId: string;
68
+ supportsDryRun: true;
69
+ supportsBeforeAfterSnapshot: false;
70
+ requiresValidation: true;
71
+ requiresSimulation: true;
72
+ };
86
73
  };
87
74
  inputExamples: {
88
75
  label: string;
89
76
  input: {
90
77
  entityType: string;
91
78
  entityIds: string[];
79
+ additionalParams: {
80
+ AccountId: string;
81
+ };
92
82
  };
93
83
  }[];
94
84
  logic: typeof deleteEntityLogic;
95
85
  responseFormatter: typeof deleteEntityResponseFormatter;
86
+ untrustedContent: {
87
+ structuredPaths: string[];
88
+ contentBlocks: number[];
89
+ };
96
90
  };
97
91
  export {};
98
92
  //# sourceMappingURL=delete-entity.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"delete-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.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,uBAAuB;;;;;;;;;;;;EASyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EASA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAkC7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAe1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC"}
1
+ {"version":3,"file":"delete-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAU1B,eAAO,MAAM,uBAAuB;;;;;;;iBAgByB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAqBA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA8E7B;AAkDD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAmC1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD5B,CAAC"}
@@ -1,33 +1,63 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
- import { getEntityTypeEnum } from "../utils/entity-mapping.js";
4
- import { elicitBulkDeleteConfirmation } from "@cesteral/shared";
3
+ import { getEntityTypeEnum, missingDeleteParentMessage, } from "../utils/entity-mapping.js";
4
+ import { mapMsAdsItemOutcomes } from "../../../services/msads/partial-errors.js";
5
+ import { elicitBulkDeleteConfirmation, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
5
6
  const TOOL_NAME = "msads_delete_entity";
6
7
  const TOOL_TITLE = "Delete Microsoft Ads Entity";
7
8
  const TOOL_DESCRIPTION = `Delete one or more Microsoft Advertising entities by their IDs.
8
9
 
9
10
  This is a destructive operation — entities will be permanently deleted.`;
11
+ const EFFECT_KIND = "entities_deleted";
10
12
  export const DeleteEntityInputSchema = z
11
13
  .object({
12
14
  entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to delete"),
13
15
  entityIds: z.array(z.string()).min(1).describe("Array of entity IDs to delete"),
14
16
  additionalParams: z
15
- .record(z.unknown())
17
+ .record(z.string(), z.unknown())
16
18
  .optional()
17
19
  .describe("Additional parameters (e.g., AccountId)"),
20
+ dry_run: z
21
+ .boolean()
22
+ .optional()
23
+ .default(false)
24
+ .describe("When true, symbolically validates the batch and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bulk delete) without prompting for confirmation or calling the Microsoft Ads API. No entities are deleted."),
18
25
  })
19
26
  .describe("Parameters for deleting Microsoft Ads entities");
20
27
  export const DeleteEntityOutputSchema = z
21
28
  .object({
22
29
  confirmed: z.boolean(),
23
30
  declineReason: z.string().optional(),
24
- result: z.record(z.any()),
31
+ result: z.record(z.string(), z.any()),
25
32
  entityType: z.string(),
26
- deletedCount: z.number(),
33
+ deletedCount: z
34
+ .number()
35
+ .describe("Number of ids Microsoft Ads accepted (requested − PartialErrors)"),
36
+ failedCount: z.number().describe("Number of ids Microsoft Ads rejected via PartialErrors"),
27
37
  timestamp: z.string().datetime(),
38
+ dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were deleted."),
39
+ effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `entities_deleted` + scalar batch audit summary with requested/succeeded/failed counts derived from the Microsoft Ads PartialErrors). Present on a confirmed execute. A bulk delete is governed as a single batch effect — it carries no per-entity canonical snapshot."),
40
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `bulk_job` with `canonicalEntityKind: null` (effect class). Present on every response."),
28
41
  })
29
42
  .describe("Entity deletion result");
30
43
  export async function deleteEntityLogic(input, context, sdkContext) {
44
+ const dispatchedCapability = {
45
+ operation: "bulk_job",
46
+ canonicalEntityKind: null,
47
+ };
48
+ if (input.dry_run === true) {
49
+ const dryRun = buildBulkEffectDryRun(input);
50
+ return {
51
+ confirmed: true,
52
+ result: {},
53
+ entityType: input.entityType,
54
+ deletedCount: 0,
55
+ failedCount: 0,
56
+ timestamp: new Date().toISOString(),
57
+ dryRun,
58
+ dispatchedCapability,
59
+ };
60
+ }
31
61
  const confirmed = await elicitBulkDeleteConfirmation({
32
62
  count: input.entityIds.length,
33
63
  entityLabel: input.entityType,
@@ -41,20 +71,84 @@ export async function deleteEntityLogic(input, context, sdkContext) {
41
71
  result: {},
42
72
  entityType: input.entityType,
43
73
  deletedCount: 0,
74
+ failedCount: 0,
44
75
  timestamp: new Date().toISOString(),
76
+ dispatchedCapability,
45
77
  };
46
78
  }
47
79
  const { msadsService } = resolveSessionServices(sdkContext);
48
80
  const result = (await msadsService.deleteEntity(input.entityType, input.entityIds, input.additionalParams, context));
81
+ const requested = input.entityIds.length;
82
+ const failedCount = mapMsAdsItemOutcomes(result, requested).filter((o) => !o.success).length;
83
+ const succeeded = requested - failedCount;
84
+ const effect = {
85
+ effectKind: EFFECT_KIND,
86
+ summary: {
87
+ entity_kind: input.entityType,
88
+ requested,
89
+ succeeded,
90
+ failed: failedCount,
91
+ partial_success: succeeded > 0 && failedCount > 0,
92
+ },
93
+ };
49
94
  return {
50
95
  confirmed: true,
51
96
  result,
52
97
  entityType: input.entityType,
53
- deletedCount: input.entityIds.length,
98
+ deletedCount: succeeded,
99
+ failedCount,
54
100
  timestamp: new Date().toISOString(),
101
+ effect,
102
+ dispatchedCapability,
103
+ };
104
+ }
105
+ function buildBulkEffectDryRun(input) {
106
+ const validationErrors = [];
107
+ const missingParent = missingDeleteParentMessage(input.entityType, input.additionalParams);
108
+ if (missingParent) {
109
+ validationErrors.push({
110
+ code: "MISSING_PARENT_ID",
111
+ message: missingParent,
112
+ field: "additionalParams",
113
+ });
114
+ }
115
+ input.entityIds.forEach((entityId, i) => {
116
+ if (!entityId || entityId.trim().length === 0) {
117
+ validationErrors.push({
118
+ code: "INVALID_ENTITY_ID",
119
+ message: `entityIds[${i}] must be a non-empty entity ID`,
120
+ field: `entityIds.${i}`,
121
+ });
122
+ }
123
+ });
124
+ const expectedEffect = {
125
+ effectKind: EFFECT_KIND,
126
+ summary: { entity_kind: input.entityType, requested: input.entityIds.length },
55
127
  };
128
+ return assertGovernedEffectDryRun({
129
+ wouldSucceed: validationErrors.length === 0,
130
+ validationErrors,
131
+ validationSource: "symbolic",
132
+ expectedEffectSource: "symbolic",
133
+ expectedEffect,
134
+ }, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
56
135
  }
57
136
  export function deleteEntityResponseFormatter(result) {
137
+ if (result.dryRun) {
138
+ const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
139
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
140
+ const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
141
+ const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
142
+ const kind = result.dryRun.expectedEffect?.summary.entity_kind ?? "entity";
143
+ return [
144
+ {
145
+ type: "text",
146
+ text: `Dry run: bulk-deleting ${String(n)} ${String(kind)}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were deleted.` +
147
+ (errs ? `\n${errs}` : "") +
148
+ `\n\nTimestamp: ${result.timestamp}`,
149
+ },
150
+ ];
151
+ }
58
152
  if (!result.confirmed) {
59
153
  return [
60
154
  {
@@ -63,10 +157,12 @@ export function deleteEntityResponseFormatter(result) {
63
157
  },
64
158
  ];
65
159
  }
160
+ const total = result.deletedCount + result.failedCount;
161
+ const failedNote = result.failedCount > 0 ? ` (${result.failedCount} rejected via PartialErrors)` : "";
66
162
  return [
67
163
  {
68
164
  type: "text",
69
- text: `Deleted ${result.deletedCount} ${result.entityType} entities\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
165
+ text: `Deleted ${result.deletedCount}/${total} ${result.entityType} entities${failedNote}\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
70
166
  },
71
167
  ];
72
168
  }
@@ -81,14 +177,39 @@ export const deleteEntityTool = {
81
177
  openWorldHint: false,
82
178
  idempotentHint: false,
83
179
  destructiveHint: true,
180
+ cesteral: {
181
+ kind: "write",
182
+ writeClass: "effect",
183
+ executableArgsExclude: ["dry_run"],
184
+ platform: "msads",
185
+ contractPlatformSlug: "msads",
186
+ contractToolSlug: "delete_entity",
187
+ operation: ["bulk_job"],
188
+ entityKinds: [],
189
+ entityIdArgs: [],
190
+ schemaVersion: 1,
191
+ contractId: "msads.delete_entity.v1",
192
+ supportsDryRun: true,
193
+ supportsBeforeAfterSnapshot: false,
194
+ requiresValidation: true,
195
+ requiresSimulation: true,
196
+ },
84
197
  },
85
198
  inputExamples: [
86
199
  {
87
200
  label: "Delete campaigns",
88
- input: { entityType: "campaign", entityIds: ["123456", "789012"] },
201
+ input: {
202
+ entityType: "campaign",
203
+ entityIds: ["123456", "789012"],
204
+ additionalParams: { AccountId: "987654321" },
205
+ },
89
206
  },
90
207
  ],
91
208
  logic: deleteEntityLogic,
92
209
  responseFormatter: deleteEntityResponseFormatter,
210
+ untrustedContent: {
211
+ structuredPaths: ["$.result"],
212
+ contentBlocks: [0],
213
+ },
93
214
  };
94
215
  //# sourceMappingURL=delete-entity.tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"delete-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"delete-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"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"}