@cesteral/msads-mcp 1.3.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/README.md +44 -30
  2. package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
  3. package/dist/auth/msads-auth-adapter.js +1 -1
  4. package/dist/auth/msads-auth-adapter.js.map +1 -1
  5. package/dist/cesteral-manifest.json +68 -16
  6. package/dist/config/index.d.ts +36 -67
  7. package/dist/config/index.d.ts.map +1 -1
  8. package/dist/index.js +13 -23
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
  11. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
  12. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
  13. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
  14. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
  15. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
  16. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
  17. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
  18. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
  19. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
  20. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
  21. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
  22. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
  23. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
  24. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
  25. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
  26. package/dist/mcp-server/prompts/index.d.ts +1 -1
  27. package/dist/mcp-server/prompts/index.d.ts.map +1 -1
  28. package/dist/mcp-server/prompts/index.js +15 -0
  29. package/dist/mcp-server/prompts/index.js.map +1 -1
  30. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
  31. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
  32. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
  33. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  34. package/dist/mcp-server/resources/definitions/index.js +10 -9
  35. package/dist/mcp-server/resources/definitions/index.js.map +1 -1
  36. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
  37. package/dist/mcp-server/resources/utils/field-rules.js +11 -11
  38. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
  39. package/dist/mcp-server/server.d.ts +2 -1
  40. package/dist/mcp-server/server.d.ts.map +1 -1
  41. package/dist/mcp-server/server.js +29 -100
  42. package/dist/mcp-server/server.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +26 -132
  44. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +73 -18
  46. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +31 -65
  48. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +44 -13
  50. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +31 -72
  52. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +40 -10
  54. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
  55. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +45 -118
  56. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
  57. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +30 -9
  58. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
  59. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
  60. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
  62. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
  63. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +24 -57
  64. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
  65. package/dist/mcp-server/tools/definitions/create-entity.tool.js +21 -6
  66. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
  67. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +29 -119
  68. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
  69. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +28 -55
  70. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
  71. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +25 -78
  72. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
  73. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +22 -20
  74. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
  75. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +12 -59
  76. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
  77. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +20 -37
  78. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
  79. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
  80. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
  81. package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
  82. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
  83. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
  84. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  85. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
  86. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
  88. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
  89. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
  90. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
  91. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
  92. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
  93. package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
  94. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
  95. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
  96. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
  98. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
  100. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
  101. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
  102. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
  103. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
  104. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
  105. package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
  106. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
  107. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
  108. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
  110. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +27 -57
  112. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
  113. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +40 -10
  114. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
  115. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  116. package/dist/mcp-server/tools/definitions/index.js +6 -0
  117. package/dist/mcp-server/tools/definitions/index.js.map +1 -1
  118. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
  119. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
  120. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
  121. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
  122. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
  123. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
  124. package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
  125. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
  126. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
  127. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
  128. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
  129. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
  130. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +24 -56
  131. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
  132. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +45 -6
  133. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
  134. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +36 -66
  135. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
  136. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +49 -8
  137. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
  138. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
  139. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
  140. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
  141. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
  142. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +35 -112
  143. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
  144. package/dist/mcp-server/tools/definitions/submit-report.tool.js +2 -1
  145. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
  146. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +37 -323
  147. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
  148. package/dist/mcp-server/tools/definitions/update-entity.tool.js +72 -85
  149. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
  150. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
  151. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
  152. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
  153. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
  154. package/dist/mcp-server/tools/index.d.ts +4 -1
  155. package/dist/mcp-server/tools/index.d.ts.map +1 -1
  156. package/dist/mcp-server/tools/index.js +7 -1
  157. package/dist/mcp-server/tools/index.js.map +1 -1
  158. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
  159. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
  160. package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
  161. package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
  162. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
  163. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
  164. package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
  165. package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
  166. package/dist/mcp-server/tools/utils/dry-run.d.ts +12 -3
  167. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  168. package/dist/mcp-server/tools/utils/dry-run.js +46 -8
  169. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
  170. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
  171. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
  172. package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
  173. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
  174. package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
  175. package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
  176. package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
  177. package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
  178. package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
  179. package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
  180. package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
  181. package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
  182. package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
  183. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
  184. package/dist/mcp-server/transports/streamable-http-transport.js +15 -51
  185. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
  186. package/dist/services/msads/msads-http-client.d.ts +5 -1
  187. package/dist/services/msads/msads-http-client.d.ts.map +1 -1
  188. package/dist/services/msads/msads-http-client.js +49 -2
  189. package/dist/services/msads/msads-http-client.js.map +1 -1
  190. package/dist/services/msads/msads-reporting-service.d.ts +3 -9
  191. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
  192. package/dist/services/msads/msads-reporting-service.js +62 -27
  193. package/dist/services/msads/msads-reporting-service.js.map +1 -1
  194. package/dist/services/msads/msads-service.d.ts +53 -5
  195. package/dist/services/msads/msads-service.d.ts.map +1 -1
  196. package/dist/services/msads/msads-service.js +235 -35
  197. package/dist/services/msads/msads-service.js.map +1 -1
  198. package/dist/services/msads/partial-errors.d.ts +34 -0
  199. package/dist/services/msads/partial-errors.d.ts.map +1 -0
  200. package/dist/services/msads/partial-errors.js +149 -0
  201. package/dist/services/msads/partial-errors.js.map +1 -0
  202. package/dist/services/msads/rate-limit-keys.d.ts +8 -2
  203. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
  204. package/dist/services/msads/rate-limit-keys.js +16 -2
  205. package/dist/services/msads/rate-limit-keys.js.map +1 -1
  206. package/dist/services/msads/types.d.ts +1 -2
  207. package/dist/services/msads/types.d.ts.map +1 -1
  208. package/dist/services/msads/types.js.map +1 -1
  209. package/dist/services/session-services.d.ts +2 -2
  210. package/dist/services/session-services.d.ts.map +1 -1
  211. package/dist/services/session-services.js +10 -10
  212. package/dist/services/session-services.js.map +1 -1
  213. package/dist/services/session-wiring.d.ts +7 -0
  214. package/dist/services/session-wiring.d.ts.map +1 -0
  215. package/dist/services/session-wiring.js +20 -0
  216. package/dist/services/session-wiring.js.map +1 -0
  217. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  218. package/dist/testkit/fixtures/index.js +3 -3
  219. package/dist/testkit/fixtures/index.js.map +1 -1
  220. package/package.json +8 -8
@@ -1,176 +1,29 @@
1
1
  import { z } from "zod";
2
2
  import type { RequestContext, McpTextContent } from "@cesteral/shared";
3
3
  import type { SdkContext } from "@cesteral/shared";
4
- export declare const UpdateEntityInputSchema: z.ZodDiscriminatedUnion<"entityType", [z.ZodObject<{
5
- entityType: z.ZodLiteral<"campaign">;
6
- entityId: z.ZodString;
7
- accountId: z.ZodString;
8
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
9
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
10
- }, "strip", z.ZodTypeAny, {
11
- entityType: "campaign";
12
- accountId: string;
13
- entityId: string;
14
- data: Record<string, unknown>;
15
- dry_run: boolean;
16
- }, {
17
- entityType: "campaign";
18
- accountId: string;
19
- entityId: string;
20
- data: Record<string, unknown>;
21
- dry_run?: boolean | undefined;
22
- }>, z.ZodObject<{
23
- entityType: z.ZodLiteral<"adGroup">;
24
- entityId: z.ZodString;
25
- campaignId: z.ZodString;
26
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
27
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
28
- }, "strip", z.ZodTypeAny, {
29
- entityType: "adGroup";
30
- entityId: string;
31
- campaignId: string;
32
- data: Record<string, unknown>;
33
- dry_run: boolean;
34
- }, {
35
- entityType: "adGroup";
36
- entityId: string;
37
- campaignId: string;
38
- data: Record<string, unknown>;
39
- dry_run?: boolean | undefined;
40
- }>, z.ZodObject<{
41
- entityType: z.ZodLiteral<"ad">;
42
- entityId: z.ZodString;
43
- adGroupId: z.ZodString;
44
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
45
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
46
- }, "strip", z.ZodTypeAny, {
47
- entityType: "ad";
48
- entityId: string;
49
- adGroupId: string;
50
- data: Record<string, unknown>;
51
- dry_run: boolean;
52
- }, {
53
- entityType: "ad";
54
- entityId: string;
55
- adGroupId: string;
56
- data: Record<string, unknown>;
57
- dry_run?: boolean | undefined;
58
- }>, z.ZodObject<{
59
- entityType: z.ZodLiteral<"keyword">;
60
- entityId: z.ZodString;
61
- adGroupId: z.ZodString;
62
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
63
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
64
- }, "strip", z.ZodTypeAny, {
65
- entityType: "keyword";
66
- entityId: string;
67
- adGroupId: string;
68
- data: Record<string, unknown>;
69
- dry_run: boolean;
70
- }, {
71
- entityType: "keyword";
72
- entityId: string;
73
- adGroupId: string;
74
- data: Record<string, unknown>;
75
- dry_run?: boolean | undefined;
76
- }>, z.ZodObject<{
77
- entityType: z.ZodLiteral<"budget">;
78
- entityId: z.ZodString;
79
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
80
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
81
- }, "strip", z.ZodTypeAny, {
82
- entityType: "budget";
83
- entityId: string;
84
- data: Record<string, unknown>;
85
- dry_run: boolean;
86
- }, {
87
- entityType: "budget";
88
- entityId: string;
89
- data: Record<string, unknown>;
90
- dry_run?: boolean | undefined;
91
- }>, z.ZodObject<{
92
- entityType: z.ZodLiteral<"adExtension">;
93
- entityId: z.ZodString;
94
- accountId: z.ZodString;
95
- adExtensionType: z.ZodString;
96
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
97
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
98
- }, "strip", z.ZodTypeAny, {
99
- entityType: "adExtension";
100
- accountId: string;
101
- entityId: string;
102
- adExtensionType: string;
103
- data: Record<string, unknown>;
104
- dry_run: boolean;
105
- }, {
106
- entityType: "adExtension";
107
- accountId: string;
108
- entityId: string;
109
- adExtensionType: string;
110
- data: Record<string, unknown>;
111
- dry_run?: boolean | undefined;
112
- }>, z.ZodObject<{
113
- entityType: z.ZodLiteral<"audience">;
114
- entityId: z.ZodString;
115
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
116
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
117
- }, "strip", z.ZodTypeAny, {
118
- entityType: "audience";
119
- entityId: string;
120
- data: Record<string, unknown>;
121
- dry_run: boolean;
122
- }, {
123
- entityType: "audience";
124
- entityId: string;
125
- data: Record<string, unknown>;
126
- dry_run?: boolean | undefined;
127
- }>, z.ZodObject<{
128
- entityType: z.ZodLiteral<"label">;
4
+ export declare const UpdateEntityInputSchema: z.ZodObject<{
5
+ entityType: z.ZodEnum<{
6
+ [x: string]: string;
7
+ }>;
129
8
  entityId: z.ZodString;
9
+ accountId: z.ZodOptional<z.ZodString>;
10
+ campaignId: z.ZodOptional<z.ZodString>;
11
+ adGroupId: z.ZodOptional<z.ZodString>;
12
+ adExtensionType: z.ZodOptional<z.ZodString>;
130
13
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
131
14
  dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
132
- }, "strip", z.ZodTypeAny, {
133
- entityType: "label";
134
- entityId: string;
135
- data: Record<string, unknown>;
136
- dry_run: boolean;
137
- }, {
138
- entityType: "label";
139
- entityId: string;
140
- data: Record<string, unknown>;
141
- dry_run?: boolean | undefined;
142
- }>]>;
15
+ }, z.core.$strip>;
143
16
  export declare const UpdateEntityOutputSchema: z.ZodObject<{
144
17
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
145
18
  entityId: z.ZodString;
146
19
  entityType: z.ZodString;
147
20
  updated: z.ZodBoolean;
148
21
  timestamp: z.ZodString;
149
- dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, z.ZodTypeDef, import("@cesteral/contract-schema").DryRunResult>>;
150
- before: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, z.ZodTypeDef, import("@cesteral/contract-schema").NormalizedEntitySnapshot>>;
151
- after: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, z.ZodTypeDef, import("@cesteral/contract-schema").NormalizedEntitySnapshot>>;
152
- dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, z.ZodTypeDef, import("@cesteral/contract-schema").DispatchedCapability>;
153
- }, "strip", z.ZodTypeAny, {
154
- entityType: string;
155
- entityId: string;
156
- timestamp: string;
157
- result: Record<string, any>;
158
- dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
159
- updated: boolean;
160
- dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
161
- after?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
162
- before?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
163
- }, {
164
- entityType: string;
165
- entityId: string;
166
- timestamp: string;
167
- result: Record<string, any>;
168
- dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
169
- updated: boolean;
170
- dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
171
- after?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
172
- before?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
173
- }>;
22
+ dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DryRunResult, unknown>>>;
23
+ before: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown>>>;
24
+ after: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown>>>;
25
+ dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DispatchedCapability, unknown>>;
26
+ }, z.core.$strip>;
174
27
  type UpdateEntityInput = z.infer<typeof UpdateEntityInputSchema>;
175
28
  type UpdateEntityOutput = z.infer<typeof UpdateEntityOutputSchema>;
176
29
  export declare function updateEntityLogic(input: UpdateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateEntityOutput>;
@@ -179,176 +32,29 @@ export declare const updateEntityTool: {
179
32
  name: string;
180
33
  title: string;
181
34
  description: string;
182
- inputSchema: z.ZodDiscriminatedUnion<"entityType", [z.ZodObject<{
183
- entityType: z.ZodLiteral<"campaign">;
35
+ inputSchema: z.ZodObject<{
36
+ entityType: z.ZodEnum<{
37
+ [x: string]: string;
38
+ }>;
184
39
  entityId: z.ZodString;
185
- accountId: z.ZodString;
40
+ accountId: z.ZodOptional<z.ZodString>;
41
+ campaignId: z.ZodOptional<z.ZodString>;
42
+ adGroupId: z.ZodOptional<z.ZodString>;
43
+ adExtensionType: z.ZodOptional<z.ZodString>;
186
44
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
187
45
  dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
188
- }, "strip", z.ZodTypeAny, {
189
- entityType: "campaign";
190
- accountId: string;
191
- entityId: string;
192
- data: Record<string, unknown>;
193
- dry_run: boolean;
194
- }, {
195
- entityType: "campaign";
196
- accountId: string;
197
- entityId: string;
198
- data: Record<string, unknown>;
199
- dry_run?: boolean | undefined;
200
- }>, z.ZodObject<{
201
- entityType: z.ZodLiteral<"adGroup">;
202
- entityId: z.ZodString;
203
- campaignId: z.ZodString;
204
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
205
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
206
- }, "strip", z.ZodTypeAny, {
207
- entityType: "adGroup";
208
- entityId: string;
209
- campaignId: string;
210
- data: Record<string, unknown>;
211
- dry_run: boolean;
212
- }, {
213
- entityType: "adGroup";
214
- entityId: string;
215
- campaignId: string;
216
- data: Record<string, unknown>;
217
- dry_run?: boolean | undefined;
218
- }>, z.ZodObject<{
219
- entityType: z.ZodLiteral<"ad">;
220
- entityId: z.ZodString;
221
- adGroupId: z.ZodString;
222
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
223
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
224
- }, "strip", z.ZodTypeAny, {
225
- entityType: "ad";
226
- entityId: string;
227
- adGroupId: string;
228
- data: Record<string, unknown>;
229
- dry_run: boolean;
230
- }, {
231
- entityType: "ad";
232
- entityId: string;
233
- adGroupId: string;
234
- data: Record<string, unknown>;
235
- dry_run?: boolean | undefined;
236
- }>, z.ZodObject<{
237
- entityType: z.ZodLiteral<"keyword">;
238
- entityId: z.ZodString;
239
- adGroupId: z.ZodString;
240
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
241
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
242
- }, "strip", z.ZodTypeAny, {
243
- entityType: "keyword";
244
- entityId: string;
245
- adGroupId: string;
246
- data: Record<string, unknown>;
247
- dry_run: boolean;
248
- }, {
249
- entityType: "keyword";
250
- entityId: string;
251
- adGroupId: string;
252
- data: Record<string, unknown>;
253
- dry_run?: boolean | undefined;
254
- }>, z.ZodObject<{
255
- entityType: z.ZodLiteral<"budget">;
256
- entityId: z.ZodString;
257
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
258
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
259
- }, "strip", z.ZodTypeAny, {
260
- entityType: "budget";
261
- entityId: string;
262
- data: Record<string, unknown>;
263
- dry_run: boolean;
264
- }, {
265
- entityType: "budget";
266
- entityId: string;
267
- data: Record<string, unknown>;
268
- dry_run?: boolean | undefined;
269
- }>, z.ZodObject<{
270
- entityType: z.ZodLiteral<"adExtension">;
271
- entityId: z.ZodString;
272
- accountId: z.ZodString;
273
- adExtensionType: z.ZodString;
274
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
275
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
276
- }, "strip", z.ZodTypeAny, {
277
- entityType: "adExtension";
278
- accountId: string;
279
- entityId: string;
280
- adExtensionType: string;
281
- data: Record<string, unknown>;
282
- dry_run: boolean;
283
- }, {
284
- entityType: "adExtension";
285
- accountId: string;
286
- entityId: string;
287
- adExtensionType: string;
288
- data: Record<string, unknown>;
289
- dry_run?: boolean | undefined;
290
- }>, z.ZodObject<{
291
- entityType: z.ZodLiteral<"audience">;
292
- entityId: z.ZodString;
293
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
294
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
295
- }, "strip", z.ZodTypeAny, {
296
- entityType: "audience";
297
- entityId: string;
298
- data: Record<string, unknown>;
299
- dry_run: boolean;
300
- }, {
301
- entityType: "audience";
302
- entityId: string;
303
- data: Record<string, unknown>;
304
- dry_run?: boolean | undefined;
305
- }>, z.ZodObject<{
306
- entityType: z.ZodLiteral<"label">;
307
- entityId: z.ZodString;
308
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
309
- dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
310
- }, "strip", z.ZodTypeAny, {
311
- entityType: "label";
312
- entityId: string;
313
- data: Record<string, unknown>;
314
- dry_run: boolean;
315
- }, {
316
- entityType: "label";
317
- entityId: string;
318
- data: Record<string, unknown>;
319
- dry_run?: boolean | undefined;
320
- }>]>;
46
+ }, z.core.$strip>;
321
47
  outputSchema: z.ZodObject<{
322
48
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
323
49
  entityId: z.ZodString;
324
50
  entityType: z.ZodString;
325
51
  updated: z.ZodBoolean;
326
52
  timestamp: z.ZodString;
327
- dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, z.ZodTypeDef, import("@cesteral/contract-schema").DryRunResult>>;
328
- before: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, z.ZodTypeDef, import("@cesteral/contract-schema").NormalizedEntitySnapshot>>;
329
- after: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, z.ZodTypeDef, import("@cesteral/contract-schema").NormalizedEntitySnapshot>>;
330
- dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, z.ZodTypeDef, import("@cesteral/contract-schema").DispatchedCapability>;
331
- }, "strip", z.ZodTypeAny, {
332
- entityType: string;
333
- entityId: string;
334
- timestamp: string;
335
- result: Record<string, any>;
336
- dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
337
- updated: boolean;
338
- dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
339
- after?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
340
- before?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
341
- }, {
342
- entityType: string;
343
- entityId: string;
344
- timestamp: string;
345
- result: Record<string, any>;
346
- dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
347
- updated: boolean;
348
- dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
349
- after?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
350
- before?: import("@cesteral/contract-schema").NormalizedEntitySnapshot | undefined;
351
- }>;
53
+ dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DryRunResult, unknown>>>;
54
+ before: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown>>>;
55
+ after: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").NormalizedEntitySnapshot, unknown>>>;
56
+ dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DispatchedCapability, unknown>>;
57
+ }, z.core.$strip>;
352
58
  annotations: {
353
59
  readOnlyHint: boolean;
354
60
  openWorldHint: boolean;
@@ -361,7 +67,7 @@ export declare const updateEntityTool: {
361
67
  platform: string;
362
68
  contractPlatformSlug: string;
363
69
  contractToolSlug: string;
364
- operation: ("resume" | "pause" | "update_status" | "update_budget" | "update")[];
70
+ operation: ("update" | "resume" | "pause" | "update_status" | "update_budget")[];
365
71
  entityKinds: ("campaign" | "ad" | "ad_group" | "campaign_budget")[];
366
72
  entityIdArgs: string[];
367
73
  readPartner: {
@@ -369,6 +75,10 @@ export declare const updateEntityTool: {
369
75
  argMap: {
370
76
  entityType: string;
371
77
  entityId: string;
78
+ accountId: string;
79
+ campaignId: string;
80
+ adGroupId: string;
81
+ adExtensionType: string;
372
82
  };
373
83
  };
374
84
  schemaVersion: number;
@@ -404,6 +114,10 @@ export declare const updateEntityTool: {
404
114
  })[];
405
115
  logic: typeof updateEntityLogic;
406
116
  responseFormatter: typeof updateEntityResponseFormatter;
117
+ untrustedContent: {
118
+ structuredPaths: string[];
119
+ contentBlocks: number[];
120
+ };
407
121
  };
408
122
  export {};
409
123
  //# sourceMappingURL=update-entity.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAgC,MAAM,kBAAkB,CAAC;AA4BjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyDyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBF,CAAC;AAEpC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAYnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA4E7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAoB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmE5B,CAAC"}
1
+ {"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAgC,MAAM,kBAAkB,CAAC;AAsBjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBA0CyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAoBF,CAAC;AAEpC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAoBnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAkG7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAoB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF5B,CAAC"}
@@ -1,9 +1,9 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
- import { getEntityConfig, getEntityTypeEnum, } from "../utils/entity-mapping.js";
4
- import { runMsAdsUpdateDryRun, resolveMsAdsDispatchedCapability } from "../utils/dry-run.js";
5
- import { captureMsAdsSnapshot, snapshotFromMsAdsEntity } from "../utils/capture-snapshot.js";
6
- import { DryRunResultSchema, NormalizedEntitySnapshotSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
3
+ import { entityContextReadParams, getEntityConfig, getEntityTypeEnum, getWriteParent, pickEntityContext, refineEntityContext, } from "../utils/entity-mapping.js";
4
+ import { runMsAdsUpdateDryRun, resolveMsAdsDispatchedCapability, symbolicValidate, } from "../utils/dry-run.js";
5
+ import { captureMsAdsSnapshot, resolveMsAdsCurrency, snapshotFromMsAdsEntity, } from "../utils/capture-snapshot.js";
6
+ import { McpError, JsonRpcErrorCode, DryRunResultSchema, NormalizedEntitySnapshotSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
7
7
  const TOOL_NAME = "msads_update_entity";
8
8
  const TOOL_TITLE = "Update Microsoft Ads Entity";
9
9
  const TOOL_DESCRIPTION = `Update an existing Microsoft Advertising entity.
@@ -14,78 +14,49 @@ Provide the entity ID plus the partial fields to change in \`data\` — Microsof
14
14
  supports partial updates, so only include fields you want to modify (do NOT include
15
15
  \`Id\`; it is injected). The tool wraps the patch in the entity's plural collection key.
16
16
 
17
- Some entity types require parent/account context so the read partner can capture
18
- before/after snapshots: campaign needs \`accountId\`, adGroup needs \`campaignId\`,
19
- ad needs \`adGroupId\`.`;
20
- const dataField = z
21
- .record(z.unknown())
22
- .describe("Partial fields to update (do not include Id — it is injected)");
23
- const dryRunField = z
24
- .boolean()
25
- .optional()
26
- .default(false)
27
- .describe("When true, validates the proposed mutation and returns a DryRunResult under `dryRun` without invoking the Microsoft Ads API. The underlying entity is never modified.");
17
+ Some entity types require their parent ID, which is sent as the request-body
18
+ parent element Microsoft Ads' Update operation takes next to the entity array and
19
+ is also used to read the entity back for before/after snapshots: campaign and
20
+ adExtension need \`accountId\` (AccountId), adGroup needs \`campaignId\`
21
+ (CampaignId), ad and keyword need \`adGroupId\` (AdGroupId).`;
28
22
  export const UpdateEntityInputSchema = z
29
- .discriminatedUnion("entityType", [
30
- z.object({
31
- entityType: z.literal("campaign"),
32
- entityId: z.string().min(1).describe("The campaign ID to update"),
33
- accountId: z.string().min(1).describe("AccountId required to read the campaign back"),
34
- data: dataField,
35
- dry_run: dryRunField,
36
- }),
37
- z.object({
38
- entityType: z.literal("adGroup"),
39
- entityId: z.string().min(1).describe("The ad group ID to update"),
40
- campaignId: z.string().min(1).describe("CampaignId required to read the ad group back"),
41
- data: dataField,
42
- dry_run: dryRunField,
43
- }),
44
- z.object({
45
- entityType: z.literal("ad"),
46
- entityId: z.string().min(1).describe("The ad ID to update"),
47
- adGroupId: z.string().min(1).describe("AdGroupId required to read the ad back"),
48
- data: dataField,
49
- dry_run: dryRunField,
50
- }),
51
- z.object({
52
- entityType: z.literal("keyword"),
53
- entityId: z.string().min(1).describe("The keyword ID to update"),
54
- adGroupId: z.string().min(1).describe("AdGroupId required to read the keyword back"),
55
- data: dataField,
56
- dry_run: dryRunField,
57
- }),
58
- z.object({
59
- entityType: z.literal("budget"),
60
- entityId: z.string().min(1).describe("The budget ID to update"),
61
- data: dataField,
62
- dry_run: dryRunField,
63
- }),
64
- z.object({
65
- entityType: z.literal("adExtension"),
66
- entityId: z.string().min(1).describe("The ad extension ID to update"),
67
- accountId: z.string().min(1).describe("AccountId required to read the ad extension back"),
68
- adExtensionType: z.string().min(1).describe("AdExtensionType required for the read"),
69
- data: dataField,
70
- dry_run: dryRunField,
71
- }),
72
- z.object({
73
- entityType: z.literal("audience"),
74
- entityId: z.string().min(1).describe("The audience ID to update"),
75
- data: dataField,
76
- dry_run: dryRunField,
77
- }),
78
- z.object({
79
- entityType: z.literal("label"),
80
- entityId: z.string().min(1).describe("The label ID to update"),
81
- data: dataField,
82
- dry_run: dryRunField,
83
- }),
84
- ])
23
+ .object({
24
+ entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to update"),
25
+ entityId: z.string().min(1).describe("The entity ID to update"),
26
+ accountId: z
27
+ .string()
28
+ .min(1)
29
+ .optional()
30
+ .describe("Account that owns the entity, sent as the request-body AccountId. Required for campaign and adExtension"),
31
+ campaignId: z
32
+ .string()
33
+ .min(1)
34
+ .optional()
35
+ .describe("Campaign that owns the ad group, sent as the request-body CampaignId. Required for adGroup"),
36
+ adGroupId: z
37
+ .string()
38
+ .min(1)
39
+ .optional()
40
+ .describe("Ad group that owns the ad or keyword, sent as the request-body AdGroupId. Required for ad and keyword"),
41
+ adExtensionType: z
42
+ .string()
43
+ .min(1)
44
+ .optional()
45
+ .describe("AdExtensionType, needed to read the ad extension. Required for adExtension"),
46
+ data: z
47
+ .record(z.string(), z.unknown())
48
+ .describe("Partial fields to update (do not include Id — it is injected)"),
49
+ dry_run: z
50
+ .boolean()
51
+ .optional()
52
+ .default(false)
53
+ .describe("When true, validates the proposed mutation and returns a DryRunResult under `dryRun` without invoking the Microsoft Ads API. The underlying entity is never modified."),
54
+ })
55
+ .superRefine(refineEntityContext)
85
56
  .describe("Parameters for updating a Microsoft Ads entity");
86
57
  export const UpdateEntityOutputSchema = z
87
58
  .object({
88
- result: z.record(z.any()),
59
+ result: z.record(z.string(), z.any()),
89
60
  entityId: z.string(),
90
61
  entityType: z.string(),
91
62
  updated: z.boolean(),
@@ -96,17 +67,15 @@ export const UpdateEntityOutputSchema = z
96
67
  dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to, derived from the `data` payload. Present on every response — dry-run and real write alike."),
97
68
  })
98
69
  .describe("Entity update result");
70
+ function buildWriteParentBody(input) {
71
+ const parent = getWriteParent(input.entityType);
72
+ if (!parent)
73
+ return {};
74
+ const value = input[parent.inputKey];
75
+ return typeof value === "string" ? { [parent.bodyField]: Number(value) } : {};
76
+ }
99
77
  function buildReadParams(input) {
100
- const params = {};
101
- if ("accountId" in input)
102
- params.AccountId = Number(input.accountId);
103
- if ("campaignId" in input)
104
- params.CampaignId = Number(input.campaignId);
105
- if ("adGroupId" in input)
106
- params.AdGroupId = Number(input.adGroupId);
107
- if ("adExtensionType" in input)
108
- params.AdExtensionType = input.adExtensionType;
109
- return params;
78
+ return entityContextReadParams(pickEntityContext(input.entityType, input));
110
79
  }
111
80
  export async function updateEntityLogic(input, context, sdkContext) {
112
81
  const { msadsService } = resolveSessionServices(sdkContext);
@@ -132,11 +101,18 @@ export async function updateEntityLogic(input, context, sdkContext) {
132
101
  const before = await captureMsAdsSnapshot(msadsService, input.entityType, input.entityId, readParams, context);
133
102
  const config = getEntityConfig(input.entityType);
134
103
  const entityItem = { Id: Number(input.entityId), ...input.data };
135
- const payload = { [config.pluralName]: [entityItem] };
104
+ const payload = { ...buildWriteParentBody(input), [config.pluralName]: [entityItem] };
105
+ if (Object.keys(input.data).length === 0) {
106
+ throw new McpError(JsonRpcErrorCode.InvalidParams, "`data` must contain at least one field to update a Microsoft Ads entity.");
107
+ }
108
+ const updateValidationErrors = symbolicValidate(entityItem);
109
+ if (updateValidationErrors.length > 0) {
110
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid update payload: ${updateValidationErrors.map((e) => e.message).join("; ")}`);
111
+ }
136
112
  const result = (await msadsService.updateEntity(input.entityType, payload, context));
137
113
  let after = await captureMsAdsSnapshot(msadsService, input.entityType, input.entityId, readParams, context);
138
114
  if (!after) {
139
- after = snapshotFromMsAdsEntity(input.entityType, input.entityId, entityItem);
115
+ after = snapshotFromMsAdsEntity(input.entityType, input.entityId, entityItem, await resolveMsAdsCurrency(msadsService, context));
140
116
  }
141
117
  return {
142
118
  result,
@@ -193,7 +169,14 @@ export const updateEntityTool = {
193
169
  entityIdArgs: ["entityId"],
194
170
  readPartner: {
195
171
  toolName: "msads_get_entity",
196
- argMap: { entityType: "entityType", entityId: "entityId" },
172
+ argMap: {
173
+ entityType: "entityType",
174
+ entityId: "entityId",
175
+ accountId: "accountId",
176
+ campaignId: "campaignId",
177
+ adGroupId: "adGroupId",
178
+ adExtensionType: "adExtensionType",
179
+ },
197
180
  },
198
181
  schemaVersion: 1,
199
182
  contractId: "msads.update_entity.v1",
@@ -224,5 +207,9 @@ export const updateEntityTool = {
224
207
  ],
225
208
  logic: updateEntityLogic,
226
209
  responseFormatter: updateEntityResponseFormatter,
210
+ untrustedContent: {
211
+ structuredPaths: ["$.result", "$.dryRun", "$.before", "$.after"],
212
+ contentBlocks: [0],
213
+ },
227
214
  };
228
215
  //# sourceMappingURL=update-entity.tool.js.map