@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,134 +1,22 @@
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 GetEntityInputSchema: z.ZodDiscriminatedUnion<"entityType", [z.ZodObject<{
5
- entityType: z.ZodLiteral<"campaign">;
6
- entityId: z.ZodString;
7
- accountId: z.ZodString;
8
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9
- }, "strip", z.ZodTypeAny, {
10
- entityType: "campaign";
11
- accountId: string;
12
- entityId: string;
13
- additionalParams?: Record<string, unknown> | undefined;
14
- }, {
15
- entityType: "campaign";
16
- accountId: string;
17
- entityId: string;
18
- additionalParams?: Record<string, unknown> | undefined;
19
- }>, z.ZodObject<{
20
- entityType: z.ZodLiteral<"adGroup">;
21
- entityId: z.ZodString;
22
- campaignId: z.ZodString;
23
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
24
- }, "strip", z.ZodTypeAny, {
25
- entityType: "adGroup";
26
- entityId: string;
27
- campaignId: string;
28
- additionalParams?: Record<string, unknown> | undefined;
29
- }, {
30
- entityType: "adGroup";
31
- entityId: string;
32
- campaignId: string;
33
- additionalParams?: Record<string, unknown> | undefined;
34
- }>, z.ZodObject<{
35
- entityType: z.ZodLiteral<"ad">;
36
- entityId: z.ZodString;
37
- adGroupId: z.ZodString;
38
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
39
- }, "strip", z.ZodTypeAny, {
40
- entityType: "ad";
41
- entityId: string;
42
- adGroupId: string;
43
- additionalParams?: Record<string, unknown> | undefined;
44
- }, {
45
- entityType: "ad";
46
- entityId: string;
47
- adGroupId: string;
48
- additionalParams?: Record<string, unknown> | undefined;
49
- }>, z.ZodObject<{
50
- entityType: z.ZodLiteral<"keyword">;
51
- entityId: z.ZodString;
52
- adGroupId: z.ZodString;
53
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
54
- }, "strip", z.ZodTypeAny, {
55
- entityType: "keyword";
56
- entityId: string;
57
- adGroupId: string;
58
- additionalParams?: Record<string, unknown> | undefined;
59
- }, {
60
- entityType: "keyword";
61
- entityId: string;
62
- adGroupId: string;
63
- additionalParams?: Record<string, unknown> | undefined;
64
- }>, z.ZodObject<{
65
- entityType: z.ZodLiteral<"adExtension">;
66
- entityId: z.ZodString;
67
- accountId: z.ZodString;
68
- adExtensionType: z.ZodString;
69
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
70
- }, "strip", z.ZodTypeAny, {
71
- entityType: "adExtension";
72
- accountId: string;
73
- entityId: string;
74
- adExtensionType: string;
75
- additionalParams?: Record<string, unknown> | undefined;
76
- }, {
77
- entityType: "adExtension";
78
- accountId: string;
79
- entityId: string;
80
- adExtensionType: string;
81
- additionalParams?: Record<string, unknown> | undefined;
82
- }>, z.ZodObject<{
83
- entityType: z.ZodLiteral<"budget">;
84
- entityId: z.ZodString;
85
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
86
- }, "strip", z.ZodTypeAny, {
87
- entityType: "budget";
88
- entityId: string;
89
- additionalParams?: Record<string, unknown> | undefined;
90
- }, {
91
- entityType: "budget";
92
- entityId: string;
93
- additionalParams?: Record<string, unknown> | undefined;
94
- }>, z.ZodObject<{
95
- entityType: z.ZodLiteral<"audience">;
96
- entityId: z.ZodString;
97
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
98
- }, "strip", z.ZodTypeAny, {
99
- entityType: "audience";
100
- entityId: string;
101
- additionalParams?: Record<string, unknown> | undefined;
102
- }, {
103
- entityType: "audience";
104
- entityId: string;
105
- additionalParams?: Record<string, unknown> | undefined;
106
- }>, z.ZodObject<{
107
- entityType: z.ZodLiteral<"label">;
4
+ export declare const GetEntityInputSchema: z.ZodObject<{
5
+ entityType: z.ZodEnum<{
6
+ [x: string]: string;
7
+ }>;
108
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>;
109
13
  additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
110
- }, "strip", z.ZodTypeAny, {
111
- entityType: "label";
112
- entityId: string;
113
- additionalParams?: Record<string, unknown> | undefined;
114
- }, {
115
- entityType: "label";
116
- entityId: string;
117
- additionalParams?: Record<string, unknown> | undefined;
118
- }>]>;
14
+ }, z.core.$strip>;
119
15
  export declare const GetEntityOutputSchema: z.ZodObject<{
120
16
  entity: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>;
121
17
  entityType: z.ZodString;
122
18
  timestamp: z.ZodString;
123
- }, "strip", z.ZodTypeAny, {
124
- entityType: string;
125
- timestamp: string;
126
- entity: Record<string, any> | null;
127
- }, {
128
- entityType: string;
129
- timestamp: string;
130
- entity: Record<string, any> | null;
131
- }>;
19
+ }, z.core.$strip>;
132
20
  type GetEntityInput = z.infer<typeof GetEntityInputSchema>;
133
21
  type GetEntityOutput = z.infer<typeof GetEntityOutputSchema>;
134
22
  export declare function getEntityLogic(input: GetEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetEntityOutput>;
@@ -137,134 +25,22 @@ export declare const getEntityTool: {
137
25
  name: string;
138
26
  title: string;
139
27
  description: string;
140
- inputSchema: z.ZodDiscriminatedUnion<"entityType", [z.ZodObject<{
141
- entityType: z.ZodLiteral<"campaign">;
28
+ inputSchema: z.ZodObject<{
29
+ entityType: z.ZodEnum<{
30
+ [x: string]: string;
31
+ }>;
142
32
  entityId: z.ZodString;
143
- accountId: z.ZodString;
33
+ accountId: z.ZodOptional<z.ZodString>;
34
+ campaignId: z.ZodOptional<z.ZodString>;
35
+ adGroupId: z.ZodOptional<z.ZodString>;
36
+ adExtensionType: z.ZodOptional<z.ZodString>;
144
37
  additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
145
- }, "strip", z.ZodTypeAny, {
146
- entityType: "campaign";
147
- accountId: string;
148
- entityId: string;
149
- additionalParams?: Record<string, unknown> | undefined;
150
- }, {
151
- entityType: "campaign";
152
- accountId: string;
153
- entityId: string;
154
- additionalParams?: Record<string, unknown> | undefined;
155
- }>, z.ZodObject<{
156
- entityType: z.ZodLiteral<"adGroup">;
157
- entityId: z.ZodString;
158
- campaignId: z.ZodString;
159
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
160
- }, "strip", z.ZodTypeAny, {
161
- entityType: "adGroup";
162
- entityId: string;
163
- campaignId: string;
164
- additionalParams?: Record<string, unknown> | undefined;
165
- }, {
166
- entityType: "adGroup";
167
- entityId: string;
168
- campaignId: string;
169
- additionalParams?: Record<string, unknown> | undefined;
170
- }>, z.ZodObject<{
171
- entityType: z.ZodLiteral<"ad">;
172
- entityId: z.ZodString;
173
- adGroupId: z.ZodString;
174
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
175
- }, "strip", z.ZodTypeAny, {
176
- entityType: "ad";
177
- entityId: string;
178
- adGroupId: string;
179
- additionalParams?: Record<string, unknown> | undefined;
180
- }, {
181
- entityType: "ad";
182
- entityId: string;
183
- adGroupId: string;
184
- additionalParams?: Record<string, unknown> | undefined;
185
- }>, z.ZodObject<{
186
- entityType: z.ZodLiteral<"keyword">;
187
- entityId: z.ZodString;
188
- adGroupId: z.ZodString;
189
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
190
- }, "strip", z.ZodTypeAny, {
191
- entityType: "keyword";
192
- entityId: string;
193
- adGroupId: string;
194
- additionalParams?: Record<string, unknown> | undefined;
195
- }, {
196
- entityType: "keyword";
197
- entityId: string;
198
- adGroupId: string;
199
- additionalParams?: Record<string, unknown> | undefined;
200
- }>, z.ZodObject<{
201
- entityType: z.ZodLiteral<"adExtension">;
202
- entityId: z.ZodString;
203
- accountId: z.ZodString;
204
- adExtensionType: z.ZodString;
205
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
206
- }, "strip", z.ZodTypeAny, {
207
- entityType: "adExtension";
208
- accountId: string;
209
- entityId: string;
210
- adExtensionType: string;
211
- additionalParams?: Record<string, unknown> | undefined;
212
- }, {
213
- entityType: "adExtension";
214
- accountId: string;
215
- entityId: string;
216
- adExtensionType: string;
217
- additionalParams?: Record<string, unknown> | undefined;
218
- }>, z.ZodObject<{
219
- entityType: z.ZodLiteral<"budget">;
220
- entityId: z.ZodString;
221
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
222
- }, "strip", z.ZodTypeAny, {
223
- entityType: "budget";
224
- entityId: string;
225
- additionalParams?: Record<string, unknown> | undefined;
226
- }, {
227
- entityType: "budget";
228
- entityId: string;
229
- additionalParams?: Record<string, unknown> | undefined;
230
- }>, z.ZodObject<{
231
- entityType: z.ZodLiteral<"audience">;
232
- entityId: z.ZodString;
233
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
234
- }, "strip", z.ZodTypeAny, {
235
- entityType: "audience";
236
- entityId: string;
237
- additionalParams?: Record<string, unknown> | undefined;
238
- }, {
239
- entityType: "audience";
240
- entityId: string;
241
- additionalParams?: Record<string, unknown> | undefined;
242
- }>, z.ZodObject<{
243
- entityType: z.ZodLiteral<"label">;
244
- entityId: z.ZodString;
245
- additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
246
- }, "strip", z.ZodTypeAny, {
247
- entityType: "label";
248
- entityId: string;
249
- additionalParams?: Record<string, unknown> | undefined;
250
- }, {
251
- entityType: "label";
252
- entityId: string;
253
- additionalParams?: Record<string, unknown> | undefined;
254
- }>]>;
38
+ }, z.core.$strip>;
255
39
  outputSchema: z.ZodObject<{
256
40
  entity: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>;
257
41
  entityType: z.ZodString;
258
42
  timestamp: z.ZodString;
259
- }, "strip", z.ZodTypeAny, {
260
- entityType: string;
261
- timestamp: string;
262
- entity: Record<string, any> | null;
263
- }, {
264
- entityType: string;
265
- timestamp: string;
266
- entity: Record<string, any> | null;
267
- }>;
43
+ }, z.core.$strip>;
268
44
  annotations: {
269
45
  readOnlyHint: boolean;
270
46
  openWorldHint: boolean;
@@ -298,6 +74,10 @@ export declare const getEntityTool: {
298
74
  })[];
299
75
  logic: typeof getEntityLogic;
300
76
  responseFormatter: typeof getEntityResponseFormatter;
77
+ untrustedContent: {
78
+ structuredPaths: string[];
79
+ contentBlocks: number[];
80
+ };
301
81
  };
302
82
  export {};
303
83
  //# sourceMappingURL=get-entity.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,kBAAkB,CAAC;AAiBhF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiDiC,CAAC;AAEnE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAMI,CAAC;AAEvC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CASpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCzB,CAAC"}
1
+ {"version":3,"file":"get-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,kBAAkB,CAAC;AAchF,eAAO,MAAM,oBAAoB;;;;;;;;;;iBA8BiC,CAAC;AAEnE,eAAO,MAAM,qBAAqB;;;;iBASI,CAAC;AAEvC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CASpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CzB,CAAC"}
@@ -1,5 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { entityContextReadParams, getEntityTypeEnum, pickEntityContext, refineEntityContext, } from "../utils/entity-mapping.js";
3
4
  const TOOL_NAME = "msads_get_entity";
4
5
  const TOOL_TITLE = "Get Microsoft Ads Entity";
5
6
  const TOOL_DESCRIPTION = `Retrieve a single Microsoft Advertising entity by its ID.
@@ -8,86 +9,55 @@ Returns full entity details for the specified entity type and ID.
8
9
 
9
10
  Some Microsoft Advertising query operations require parent or account context in
10
11
  addition to the ID (campaign needs accountId, adGroup needs campaignId, etc.).`;
11
- const idField = z.string().min(1).describe("The entity ID to retrieve");
12
- const additionalParamsField = z
13
- .record(z.unknown())
14
- .optional()
15
- .describe("Additional parameters such as ReturnAdditionalFields");
16
12
  export const GetEntityInputSchema = z
17
- .discriminatedUnion("entityType", [
18
- z.object({
19
- entityType: z.literal("campaign"),
20
- entityId: idField,
21
- accountId: z.string().describe("AccountId required by GetCampaignsByIds"),
22
- additionalParams: additionalParamsField,
23
- }),
24
- z.object({
25
- entityType: z.literal("adGroup"),
26
- entityId: idField,
27
- campaignId: z.string().describe("CampaignId required by GetAdGroupsByIds"),
28
- additionalParams: additionalParamsField,
29
- }),
30
- z.object({
31
- entityType: z.literal("ad"),
32
- entityId: idField,
33
- adGroupId: z.string().describe("AdGroupId required by GetAdsByIds"),
34
- additionalParams: additionalParamsField,
35
- }),
36
- z.object({
37
- entityType: z.literal("keyword"),
38
- entityId: idField,
39
- adGroupId: z.string().describe("AdGroupId required by GetKeywordsByIds"),
40
- additionalParams: additionalParamsField,
41
- }),
42
- z.object({
43
- entityType: z.literal("adExtension"),
44
- entityId: idField,
45
- accountId: z.string().describe("AccountId required by GetAdExtensionsByIds"),
46
- adExtensionType: z.string().describe("AdExtensionType required by GetAdExtensionsByIds"),
47
- additionalParams: additionalParamsField,
48
- }),
49
- z.object({
50
- entityType: z.literal("budget"),
51
- entityId: idField,
52
- additionalParams: additionalParamsField,
53
- }),
54
- z.object({
55
- entityType: z.literal("audience"),
56
- entityId: idField,
57
- additionalParams: additionalParamsField,
58
- }),
59
- z.object({
60
- entityType: z.literal("label"),
61
- entityId: idField,
62
- additionalParams: additionalParamsField,
63
- }),
64
- ])
13
+ .object({
14
+ entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to retrieve"),
15
+ entityId: z.string().min(1).describe("The entity ID to retrieve"),
16
+ accountId: z
17
+ .string()
18
+ .min(1)
19
+ .optional()
20
+ .describe("AccountId. Required for campaign (GetCampaignsByIds) and adExtension"),
21
+ campaignId: z
22
+ .string()
23
+ .min(1)
24
+ .optional()
25
+ .describe("CampaignId. Required for adGroup (GetAdGroupsByIds)"),
26
+ adGroupId: z
27
+ .string()
28
+ .min(1)
29
+ .optional()
30
+ .describe("AdGroupId. Required for ad (GetAdsByIds) and keyword (GetKeywordsByIds)"),
31
+ adExtensionType: z
32
+ .string()
33
+ .min(1)
34
+ .optional()
35
+ .describe("AdExtensionType. Required for adExtension (GetAdExtensionsByIds)"),
36
+ additionalParams: z
37
+ .record(z.string(), z.unknown())
38
+ .optional()
39
+ .describe("Additional parameters such as ReturnAdditionalFields"),
40
+ })
41
+ .superRefine(refineEntityContext)
65
42
  .describe("Parameters for getting a Microsoft Ads entity by ID");
66
43
  export const GetEntityOutputSchema = z
67
44
  .object({
68
- entity: z.record(z.any()).nullable().describe("Retrieved entity data, or null if not found"),
45
+ entity: z
46
+ .record(z.string(), z.any())
47
+ .nullable()
48
+ .describe("Retrieved entity data, or null if not found"),
69
49
  entityType: z.string(),
70
50
  timestamp: z.string().datetime(),
71
51
  })
72
52
  .describe("Entity retrieval result");
73
53
  export async function getEntityLogic(input, context, sdkContext) {
74
54
  const { msadsService } = resolveSessionServices(sdkContext);
55
+ const entityType = input.entityType;
75
56
  const additionalParams = {
76
57
  ...(input.additionalParams ?? {}),
58
+ ...entityContextReadParams(pickEntityContext(entityType, input)),
77
59
  };
78
- if ("accountId" in input) {
79
- additionalParams.AccountId = Number(input.accountId);
80
- }
81
- if ("campaignId" in input) {
82
- additionalParams.CampaignId = Number(input.campaignId);
83
- }
84
- if ("adGroupId" in input) {
85
- additionalParams.AdGroupId = Number(input.adGroupId);
86
- }
87
- if ("adExtensionType" in input) {
88
- additionalParams.AdExtensionType = input.adExtensionType;
89
- }
90
- const { entities: rawEntities } = await msadsService.getEntity(input.entityType, [input.entityId], additionalParams, context);
60
+ const { entities: rawEntities } = await msadsService.getEntity(entityType, [input.entityId], additionalParams, context);
91
61
  const entity = rawEntities[0] ?? null;
92
62
  return {
93
63
  entity,
@@ -139,5 +109,9 @@ export const getEntityTool = {
139
109
  ],
140
110
  logic: getEntityLogic,
141
111
  responseFormatter: getEntityResponseFormatter,
112
+ untrustedContent: {
113
+ structuredPaths: ["$.entity"],
114
+ contentBlocks: [0],
115
+ },
142
116
  };
143
117
  //# sourceMappingURL=get-entity.tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare const getPacingStatusTool: import("@cesteral/shared").PacingTool<"accountId">;
2
+ //# sourceMappingURL=get-pacing-status.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-pacing-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-pacing-status.tool.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,oDAiB9B,CAAC"}
@@ -0,0 +1,20 @@
1
+ import { z } from "zod";
2
+ import { createPacingTool } from "@cesteral/shared";
3
+ export const getPacingStatusTool = createPacingTool({
4
+ toolName: "msads_get_pacing_status",
5
+ accountId: {
6
+ field: "accountId",
7
+ schema: z.string().min(1).describe("Microsoft Advertising Account ID"),
8
+ },
9
+ campaignIdSchema: z
10
+ .string()
11
+ .min(1)
12
+ .describe("Microsoft Advertising Campaign ID to check pacing for"),
13
+ platformApi: "the Microsoft Advertising API",
14
+ populateGuidance: "To populate spend, first call `msads_get_report`; to populate budget and flight dates, first call `msads_get_entity` for the campaign.",
15
+ exampleIds: [
16
+ { accountId: "123456789", campaignId: "9876543210" },
17
+ { accountId: "987654321", campaignId: "1122334455" },
18
+ ],
19
+ });
20
+ //# sourceMappingURL=get-pacing-status.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-pacing-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-pacing-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;IAClD,QAAQ,EAAE,yBAAyB;IACnC,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KACvE;IACD,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,uDAAuD,CAAC;IACpE,WAAW,EAAE,+BAA+B;IAC5C,gBAAgB,EACd,wIAAwI;IAC1I,UAAU,EAAE;QACV,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE;QACpD,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE;KACrD;CACF,CAAC,CAAC"}