@cesteral/msads-mcp 1.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 (255) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +179 -0
  3. package/dist/auth/index.d.ts +3 -0
  4. package/dist/auth/index.d.ts.map +1 -0
  5. package/dist/auth/index.js +3 -0
  6. package/dist/auth/index.js.map +1 -0
  7. package/dist/auth/msads-auth-adapter.d.ts +27 -0
  8. package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/msads-auth-adapter.js +79 -0
  10. package/dist/auth/msads-auth-adapter.js.map +1 -0
  11. package/dist/auth/msads-auth-strategy.d.ts +8 -0
  12. package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/msads-auth-strategy.js +36 -0
  14. package/dist/auth/msads-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +112 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +56 -0
  18. package/dist/config/index.js.map +1 -0
  19. package/dist/index.d.ts +3 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +47 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  24. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  25. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +54 -0
  26. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +147 -0
  30. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
  34. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +55 -0
  38. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +47 -0
  42. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/index.d.ts +9 -0
  44. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/index.js +49 -0
  46. package/dist/mcp-server/prompts/index.js.map +1 -0
  47. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  48. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  49. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +84 -0
  50. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  51. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  52. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  53. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +54 -0
  54. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  55. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  56. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  57. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +54 -0
  58. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  59. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
  60. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
  61. package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
  62. package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
  63. package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
  64. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  65. package/dist/mcp-server/resources/definitions/index.js +79 -0
  66. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  67. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
  68. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
  69. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +64 -0
  70. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
  71. package/dist/mcp-server/resources/index.d.ts +3 -0
  72. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/index.js +2 -0
  74. package/dist/mcp-server/resources/index.js.map +1 -0
  75. package/dist/mcp-server/resources/types.d.ts +8 -0
  76. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/types.js +2 -0
  78. package/dist/mcp-server/resources/types.js.map +1 -0
  79. package/dist/mcp-server/resources/utils/field-rules.d.ts +9 -0
  80. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/utils/field-rules.js +106 -0
  82. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
  83. package/dist/mcp-server/server.d.ts +5 -0
  84. package/dist/mcp-server/server.d.ts.map +1 -0
  85. package/dist/mcp-server/server.js +142 -0
  86. package/dist/mcp-server/server.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -0
  88. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  89. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +124 -0
  90. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  91. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +83 -0
  92. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  93. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +68 -0
  94. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  95. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +95 -0
  96. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +102 -0
  98. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +151 -0
  100. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  101. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
  102. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  103. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +111 -0
  104. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  105. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +73 -0
  106. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +81 -0
  108. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/create-entity.tool.js +74 -0
  110. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
  112. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
  114. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -0
  116. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +94 -0
  118. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
  120. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
  122. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -0
  124. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/download-report.tool.js +85 -0
  126. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
  128. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
  130. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +68 -0
  132. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +90 -0
  134. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +285 -0
  136. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/get-entity.tool.js +120 -0
  138. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +280 -0
  140. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +138 -0
  142. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +260 -0
  144. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/get-report.tool.js +118 -0
  146. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
  148. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
  150. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
  152. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/index.js +53 -0
  154. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
  156. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
  158. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -0
  160. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/list-entities.tool.js +100 -0
  162. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
  164. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
  166. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
  168. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
  170. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
  172. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
  174. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -0
  176. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +105 -0
  178. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +132 -0
  180. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/submit-report.tool.js +94 -0
  182. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +79 -0
  184. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/update-entity.tool.js +64 -0
  186. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +174 -0
  188. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +142 -0
  190. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/index.d.ts +2 -0
  192. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/index.js +2 -0
  194. package/dist/mcp-server/tools/index.js.map +1 -0
  195. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +20 -0
  196. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/utils/entity-mapping.js +118 -0
  198. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  199. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  200. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  202. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  203. package/dist/mcp-server/transports/streamable-http-transport.d.ts +55 -0
  204. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  205. package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
  206. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  207. package/dist/services/msads/msads-http-client.d.ts +16 -0
  208. package/dist/services/msads/msads-http-client.d.ts.map +1 -0
  209. package/dist/services/msads/msads-http-client.js +89 -0
  210. package/dist/services/msads/msads-http-client.js.map +1 -0
  211. package/dist/services/msads/msads-reporting-service.d.ts +58 -0
  212. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
  213. package/dist/services/msads/msads-reporting-service.js +153 -0
  214. package/dist/services/msads/msads-reporting-service.js.map +1 -0
  215. package/dist/services/msads/msads-service.d.ts +54 -0
  216. package/dist/services/msads/msads-service.d.ts.map +1 -0
  217. package/dist/services/msads/msads-service.js +179 -0
  218. package/dist/services/msads/msads-service.js.map +1 -0
  219. package/dist/services/msads/rate-limit-keys.d.ts +3 -0
  220. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
  221. package/dist/services/msads/rate-limit-keys.js +3 -0
  222. package/dist/services/msads/rate-limit-keys.js.map +1 -0
  223. package/dist/services/msads/types.d.ts +196 -0
  224. package/dist/services/msads/types.d.ts.map +1 -0
  225. package/dist/services/msads/types.js +47 -0
  226. package/dist/services/msads/types.js.map +1 -0
  227. package/dist/services/session-services.d.ts +22 -0
  228. package/dist/services/session-services.d.ts.map +1 -0
  229. package/dist/services/session-services.js +22 -0
  230. package/dist/services/session-services.js.map +1 -0
  231. package/dist/types-global/mcp.d.ts +2 -0
  232. package/dist/types-global/mcp.d.ts.map +1 -0
  233. package/dist/types-global/mcp.js +2 -0
  234. package/dist/types-global/mcp.js.map +1 -0
  235. package/dist/utils/errors/index.d.ts +2 -0
  236. package/dist/utils/errors/index.d.ts.map +1 -0
  237. package/dist/utils/errors/index.js +2 -0
  238. package/dist/utils/errors/index.js.map +1 -0
  239. package/dist/utils/platform.d.ts +3 -0
  240. package/dist/utils/platform.d.ts.map +1 -0
  241. package/dist/utils/platform.js +5 -0
  242. package/dist/utils/platform.js.map +1 -0
  243. package/dist/utils/security/rate-limiter.d.ts +3 -0
  244. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  245. package/dist/utils/security/rate-limiter.js +5 -0
  246. package/dist/utils/security/rate-limiter.js.map +1 -0
  247. package/dist/utils/telemetry/index.d.ts +2 -0
  248. package/dist/utils/telemetry/index.d.ts.map +1 -0
  249. package/dist/utils/telemetry/index.js +2 -0
  250. package/dist/utils/telemetry/index.js.map +1 -0
  251. package/dist/utils/telemetry/tracing.d.ts +3 -0
  252. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  253. package/dist/utils/telemetry/tracing.js +4 -0
  254. package/dist/utils/telemetry/tracing.js.map +1 -0
  255. package/package.json +56 -0
@@ -0,0 +1,68 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const GetAdDetailsInputSchema: z.ZodObject<{
4
+ adIds: z.ZodArray<z.ZodString, "many">;
5
+ adGroupId: z.ZodString;
6
+ }, "strip", z.ZodTypeAny, {
7
+ adGroupId: string;
8
+ adIds: string[];
9
+ }, {
10
+ adGroupId: string;
11
+ adIds: string[];
12
+ }>;
13
+ export declare const GetAdDetailsOutputSchema: z.ZodObject<{
14
+ ads: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
15
+ timestamp: z.ZodString;
16
+ }, "strip", z.ZodTypeAny, {
17
+ timestamp: string;
18
+ ads: Record<string, any>[];
19
+ }, {
20
+ timestamp: string;
21
+ ads: Record<string, any>[];
22
+ }>;
23
+ type GetAdDetailsInput = z.infer<typeof GetAdDetailsInputSchema>;
24
+ type GetAdDetailsOutput = z.infer<typeof GetAdDetailsOutputSchema>;
25
+ export declare function getAdDetailsLogic(input: GetAdDetailsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdDetailsOutput>;
26
+ export declare function getAdDetailsResponseFormatter(result: GetAdDetailsOutput): McpTextContent[];
27
+ export declare const getAdDetailsTool: {
28
+ name: string;
29
+ title: string;
30
+ description: string;
31
+ inputSchema: z.ZodObject<{
32
+ adIds: z.ZodArray<z.ZodString, "many">;
33
+ adGroupId: z.ZodString;
34
+ }, "strip", z.ZodTypeAny, {
35
+ adGroupId: string;
36
+ adIds: string[];
37
+ }, {
38
+ adGroupId: string;
39
+ adIds: string[];
40
+ }>;
41
+ outputSchema: z.ZodObject<{
42
+ ads: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
43
+ timestamp: z.ZodString;
44
+ }, "strip", z.ZodTypeAny, {
45
+ timestamp: string;
46
+ ads: Record<string, any>[];
47
+ }, {
48
+ timestamp: string;
49
+ ads: Record<string, any>[];
50
+ }>;
51
+ annotations: {
52
+ readOnlyHint: boolean;
53
+ openWorldHint: boolean;
54
+ idempotentHint: boolean;
55
+ destructiveHint: boolean;
56
+ };
57
+ inputExamples: {
58
+ label: string;
59
+ input: {
60
+ adIds: string[];
61
+ adGroupId: string;
62
+ };
63
+ }[];
64
+ logic: typeof getAdDetailsLogic;
65
+ responseFormatter: typeof getAdDetailsResponseFormatter;
66
+ };
67
+ export {};
68
+ //# sourceMappingURL=get-ad-details.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-ad-details.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-details.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnF,eAAO,MAAM,uBAAuB;;;;;;;;;EAKY,CAAC;AAEjD,eAAO,MAAM,wBAAwB;;;;;;;;;EAKL,CAAC;AAEjC,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,CAmB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CA2B1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC"}
@@ -0,0 +1,85 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "msads_get_ad_details";
4
+ const TOOL_TITLE = "Get Microsoft Ads Ad Details";
5
+ const TOOL_DESCRIPTION = `Get the full details of one or more Microsoft Advertising ads — copy, URLs, status, and other fields. Microsoft Advertising does not expose a rendered ad-preview endpoint; this tool returns the stored ad payload via the CampaignManagement /Ads/QueryByIds operation.`;
6
+ export const GetAdDetailsInputSchema = z
7
+ .object({
8
+ adIds: z.array(z.string()).min(1).describe("Ad IDs to retrieve"),
9
+ adGroupId: z.string().describe("Ad Group ID containing the ads"),
10
+ })
11
+ .describe("Parameters for getting ad details");
12
+ export const GetAdDetailsOutputSchema = z
13
+ .object({
14
+ ads: z.array(z.record(z.any())),
15
+ timestamp: z.string().datetime(),
16
+ })
17
+ .describe("Ad details result");
18
+ export async function getAdDetailsLogic(input, context, sdkContext) {
19
+ const { msadsService } = resolveSessionServices(sdkContext);
20
+ const result = (await msadsService.executeReadOperation("/Ads/QueryByIds", {
21
+ AdIds: input.adIds.map(Number),
22
+ AdGroupId: Number(input.adGroupId),
23
+ AdTypes: null,
24
+ }, context));
25
+ const ads = result.Ads ?? [];
26
+ return {
27
+ ads,
28
+ timestamp: new Date().toISOString(),
29
+ };
30
+ }
31
+ export function getAdDetailsResponseFormatter(result) {
32
+ if (result.ads.length === 0) {
33
+ return [{ type: "text", text: "No ads found for the given IDs." }];
34
+ }
35
+ const details = result.ads.map((ad) => {
36
+ const lines = [
37
+ `Ad ID: ${ad.Id}`,
38
+ `Type: ${ad.Type ?? "Unknown"}`,
39
+ `Status: ${ad.Status ?? "Unknown"}`,
40
+ ];
41
+ if (ad.TitlePart1)
42
+ lines.push(`Title 1: ${ad.TitlePart1}`);
43
+ if (ad.TitlePart2)
44
+ lines.push(`Title 2: ${ad.TitlePart2}`);
45
+ if (ad.TitlePart3)
46
+ lines.push(`Title 3: ${ad.TitlePart3}`);
47
+ if (ad.Text)
48
+ lines.push(`Description: ${ad.Text}`);
49
+ if (ad.TextPart2)
50
+ lines.push(`Description 2: ${ad.TextPart2}`);
51
+ if (ad.FinalUrls)
52
+ lines.push(`Final URL: ${JSON.stringify(ad.FinalUrls)}`);
53
+ if (ad.Path1)
54
+ lines.push(`Path: /${ad.Path1}${ad.Path2 ? `/${ad.Path2}` : ""}`);
55
+ return lines.join("\n");
56
+ });
57
+ return [
58
+ {
59
+ type: "text",
60
+ text: `Ad Details:\n\n${details.join("\n\n---\n\n")}\n\nTimestamp: ${result.timestamp}`,
61
+ },
62
+ ];
63
+ }
64
+ export const getAdDetailsTool = {
65
+ name: TOOL_NAME,
66
+ title: TOOL_TITLE,
67
+ description: TOOL_DESCRIPTION,
68
+ inputSchema: GetAdDetailsInputSchema,
69
+ outputSchema: GetAdDetailsOutputSchema,
70
+ annotations: {
71
+ readOnlyHint: true,
72
+ openWorldHint: false,
73
+ idempotentHint: true,
74
+ destructiveHint: false,
75
+ },
76
+ inputExamples: [
77
+ {
78
+ label: "Get ad details",
79
+ input: { adIds: ["111", "222"], adGroupId: "333" },
80
+ },
81
+ ],
82
+ logic: getAdDetailsLogic,
83
+ responseFormatter: getAdDetailsResponseFormatter,
84
+ };
85
+ //# sourceMappingURL=get-ad-details.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-ad-details.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-details.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const GetAdPreviewInputSchema: z.ZodObject<{
4
+ adIds: z.ZodArray<z.ZodString, "many">;
5
+ adGroupId: z.ZodString;
6
+ }, "strip", z.ZodTypeAny, {
7
+ adGroupId: string;
8
+ adIds: string[];
9
+ }, {
10
+ adGroupId: string;
11
+ adIds: string[];
12
+ }>;
13
+ export declare const GetAdPreviewOutputSchema: z.ZodObject<{
14
+ ads: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
15
+ timestamp: z.ZodString;
16
+ }, "strip", z.ZodTypeAny, {
17
+ timestamp: string;
18
+ ads: Record<string, any>[];
19
+ }, {
20
+ timestamp: string;
21
+ ads: Record<string, any>[];
22
+ }>;
23
+ type GetAdPreviewInput = z.infer<typeof GetAdPreviewInputSchema>;
24
+ type GetAdPreviewOutput = z.infer<typeof GetAdPreviewOutputSchema>;
25
+ export declare function getAdPreviewLogic(input: GetAdPreviewInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdPreviewOutput>;
26
+ export declare function getAdPreviewResponseFormatter(result: GetAdPreviewOutput): McpTextContent[];
27
+ export declare const getAdPreviewTool: {
28
+ name: string;
29
+ title: string;
30
+ description: string;
31
+ inputSchema: z.ZodObject<{
32
+ adIds: z.ZodArray<z.ZodString, "many">;
33
+ adGroupId: z.ZodString;
34
+ }, "strip", z.ZodTypeAny, {
35
+ adGroupId: string;
36
+ adIds: string[];
37
+ }, {
38
+ adGroupId: string;
39
+ adIds: string[];
40
+ }>;
41
+ outputSchema: z.ZodObject<{
42
+ ads: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
43
+ timestamp: z.ZodString;
44
+ }, "strip", z.ZodTypeAny, {
45
+ timestamp: string;
46
+ ads: Record<string, any>[];
47
+ }, {
48
+ timestamp: string;
49
+ ads: Record<string, any>[];
50
+ }>;
51
+ annotations: {
52
+ readOnlyHint: boolean;
53
+ openWorldHint: boolean;
54
+ idempotentHint: boolean;
55
+ destructiveHint: boolean;
56
+ };
57
+ inputExamples: {
58
+ label: string;
59
+ input: {
60
+ adIds: string[];
61
+ adGroupId: string;
62
+ };
63
+ }[];
64
+ logic: typeof getAdPreviewLogic;
65
+ responseFormatter: typeof getAdPreviewResponseFormatter;
66
+ };
67
+ export {};
68
+ //# sourceMappingURL=get-ad-preview.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-ad-preview.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnF,eAAO,MAAM,uBAAuB;;;;;;;;;EAUa,CAAC;AAElD,eAAO,MAAM,wBAAwB;;;;;;;;;EAKL,CAAC;AAEjC,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,CAmB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CA2B1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC"}
@@ -0,0 +1,90 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "msads_get_ad_preview";
4
+ const TOOL_TITLE = "Get Microsoft Ads Ad Preview";
5
+ const TOOL_DESCRIPTION = `Get a preview of a Microsoft Advertising ad by retrieving its full details including ad copy, URLs, and extensions.`;
6
+ export const GetAdPreviewInputSchema = z
7
+ .object({
8
+ adIds: z
9
+ .array(z.string())
10
+ .min(1)
11
+ .describe("Ad IDs to preview"),
12
+ adGroupId: z
13
+ .string()
14
+ .describe("Ad Group ID containing the ads"),
15
+ })
16
+ .describe("Parameters for getting ad previews");
17
+ export const GetAdPreviewOutputSchema = z
18
+ .object({
19
+ ads: z.array(z.record(z.any())),
20
+ timestamp: z.string().datetime(),
21
+ })
22
+ .describe("Ad preview result");
23
+ export async function getAdPreviewLogic(input, context, sdkContext) {
24
+ const { msadsService } = resolveSessionServices(sdkContext);
25
+ const result = (await msadsService.executeReadOperation("/Ads/QueryByIds", {
26
+ AdIds: input.adIds.map(Number),
27
+ AdGroupId: Number(input.adGroupId),
28
+ AdTypes: null,
29
+ }, context));
30
+ const ads = result.Ads ?? [];
31
+ return {
32
+ ads,
33
+ timestamp: new Date().toISOString(),
34
+ };
35
+ }
36
+ export function getAdPreviewResponseFormatter(result) {
37
+ if (result.ads.length === 0) {
38
+ return [{ type: "text", text: "No ads found for the given IDs." }];
39
+ }
40
+ const previews = result.ads.map((ad) => {
41
+ const lines = [
42
+ `Ad ID: ${ad.Id}`,
43
+ `Type: ${ad.Type ?? "Unknown"}`,
44
+ `Status: ${ad.Status ?? "Unknown"}`,
45
+ ];
46
+ if (ad.TitlePart1)
47
+ lines.push(`Title 1: ${ad.TitlePart1}`);
48
+ if (ad.TitlePart2)
49
+ lines.push(`Title 2: ${ad.TitlePart2}`);
50
+ if (ad.TitlePart3)
51
+ lines.push(`Title 3: ${ad.TitlePart3}`);
52
+ if (ad.Text)
53
+ lines.push(`Description: ${ad.Text}`);
54
+ if (ad.TextPart2)
55
+ lines.push(`Description 2: ${ad.TextPart2}`);
56
+ if (ad.FinalUrls)
57
+ lines.push(`Final URL: ${JSON.stringify(ad.FinalUrls)}`);
58
+ if (ad.Path1)
59
+ lines.push(`Path: /${ad.Path1}${ad.Path2 ? `/${ad.Path2}` : ""}`);
60
+ return lines.join("\n");
61
+ });
62
+ return [
63
+ {
64
+ type: "text",
65
+ text: `Ad Previews:\n\n${previews.join("\n\n---\n\n")}\n\nTimestamp: ${result.timestamp}`,
66
+ },
67
+ ];
68
+ }
69
+ export const getAdPreviewTool = {
70
+ name: TOOL_NAME,
71
+ title: TOOL_TITLE,
72
+ description: TOOL_DESCRIPTION,
73
+ inputSchema: GetAdPreviewInputSchema,
74
+ outputSchema: GetAdPreviewOutputSchema,
75
+ annotations: {
76
+ readOnlyHint: true,
77
+ openWorldHint: false,
78
+ idempotentHint: true,
79
+ destructiveHint: false,
80
+ },
81
+ inputExamples: [
82
+ {
83
+ label: "Preview ads",
84
+ input: { adIds: ["111", "222"], adGroupId: "333" },
85
+ },
86
+ ],
87
+ logic: getAdPreviewLogic,
88
+ responseFormatter: getAdPreviewResponseFormatter,
89
+ };
90
+ //# sourceMappingURL=get-ad-preview.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-ad-preview.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,285 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const GetEntityInputSchema: z.ZodDiscriminatedUnion<"entityType", [z.ZodObject<{
4
+ entityIds: z.ZodArray<z.ZodString, "many">;
5
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6
+ entityType: z.ZodLiteral<"campaign">;
7
+ accountId: z.ZodString;
8
+ }, "strip", z.ZodTypeAny, {
9
+ entityType: "campaign";
10
+ accountId: string;
11
+ entityIds: string[];
12
+ additionalParams?: Record<string, unknown> | undefined;
13
+ }, {
14
+ entityType: "campaign";
15
+ accountId: string;
16
+ entityIds: string[];
17
+ additionalParams?: Record<string, unknown> | undefined;
18
+ }>, z.ZodObject<{
19
+ entityIds: z.ZodArray<z.ZodString, "many">;
20
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
21
+ entityType: z.ZodLiteral<"adGroup">;
22
+ campaignId: z.ZodString;
23
+ }, "strip", z.ZodTypeAny, {
24
+ entityType: "adGroup";
25
+ entityIds: string[];
26
+ campaignId: string;
27
+ additionalParams?: Record<string, unknown> | undefined;
28
+ }, {
29
+ entityType: "adGroup";
30
+ entityIds: string[];
31
+ campaignId: string;
32
+ additionalParams?: Record<string, unknown> | undefined;
33
+ }>, z.ZodObject<{
34
+ entityIds: z.ZodArray<z.ZodString, "many">;
35
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
36
+ entityType: z.ZodLiteral<"ad">;
37
+ adGroupId: z.ZodString;
38
+ }, "strip", z.ZodTypeAny, {
39
+ entityType: "ad";
40
+ entityIds: string[];
41
+ adGroupId: string;
42
+ additionalParams?: Record<string, unknown> | undefined;
43
+ }, {
44
+ entityType: "ad";
45
+ entityIds: string[];
46
+ adGroupId: string;
47
+ additionalParams?: Record<string, unknown> | undefined;
48
+ }>, z.ZodObject<{
49
+ entityIds: z.ZodArray<z.ZodString, "many">;
50
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
51
+ entityType: z.ZodLiteral<"keyword">;
52
+ adGroupId: z.ZodString;
53
+ }, "strip", z.ZodTypeAny, {
54
+ entityType: "keyword";
55
+ entityIds: string[];
56
+ adGroupId: string;
57
+ additionalParams?: Record<string, unknown> | undefined;
58
+ }, {
59
+ entityType: "keyword";
60
+ entityIds: string[];
61
+ adGroupId: string;
62
+ additionalParams?: Record<string, unknown> | undefined;
63
+ }>, z.ZodObject<{
64
+ entityIds: z.ZodArray<z.ZodString, "many">;
65
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
66
+ entityType: z.ZodLiteral<"adExtension">;
67
+ accountId: z.ZodString;
68
+ adExtensionType: z.ZodString;
69
+ }, "strip", z.ZodTypeAny, {
70
+ entityType: "adExtension";
71
+ accountId: string;
72
+ entityIds: string[];
73
+ adExtensionType: string;
74
+ additionalParams?: Record<string, unknown> | undefined;
75
+ }, {
76
+ entityType: "adExtension";
77
+ accountId: string;
78
+ entityIds: string[];
79
+ adExtensionType: string;
80
+ additionalParams?: Record<string, unknown> | undefined;
81
+ }>, z.ZodObject<{
82
+ entityIds: z.ZodArray<z.ZodString, "many">;
83
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
84
+ entityType: z.ZodLiteral<"budget">;
85
+ }, "strip", z.ZodTypeAny, {
86
+ entityType: "budget";
87
+ entityIds: string[];
88
+ additionalParams?: Record<string, unknown> | undefined;
89
+ }, {
90
+ entityType: "budget";
91
+ entityIds: string[];
92
+ additionalParams?: Record<string, unknown> | undefined;
93
+ }>, z.ZodObject<{
94
+ entityIds: z.ZodArray<z.ZodString, "many">;
95
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
96
+ entityType: z.ZodLiteral<"audience">;
97
+ }, "strip", z.ZodTypeAny, {
98
+ entityType: "audience";
99
+ entityIds: string[];
100
+ additionalParams?: Record<string, unknown> | undefined;
101
+ }, {
102
+ entityType: "audience";
103
+ entityIds: string[];
104
+ additionalParams?: Record<string, unknown> | undefined;
105
+ }>, z.ZodObject<{
106
+ entityIds: z.ZodArray<z.ZodString, "many">;
107
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
108
+ entityType: z.ZodLiteral<"label">;
109
+ }, "strip", z.ZodTypeAny, {
110
+ entityType: "label";
111
+ entityIds: string[];
112
+ additionalParams?: Record<string, unknown> | undefined;
113
+ }, {
114
+ entityType: "label";
115
+ entityIds: string[];
116
+ additionalParams?: Record<string, unknown> | undefined;
117
+ }>]>;
118
+ export declare const GetEntityOutputSchema: z.ZodObject<{
119
+ entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
120
+ entityType: z.ZodString;
121
+ timestamp: z.ZodString;
122
+ }, "strip", z.ZodTypeAny, {
123
+ entityType: string;
124
+ entities: Record<string, any>[];
125
+ timestamp: string;
126
+ }, {
127
+ entityType: string;
128
+ entities: Record<string, any>[];
129
+ timestamp: string;
130
+ }>;
131
+ type GetEntityInput = z.infer<typeof GetEntityInputSchema>;
132
+ type GetEntityOutput = z.infer<typeof GetEntityOutputSchema>;
133
+ export declare function getEntityLogic(input: GetEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetEntityOutput>;
134
+ export declare function getEntityResponseFormatter(result: GetEntityOutput): McpTextContent[];
135
+ export declare const getEntityTool: {
136
+ name: string;
137
+ title: string;
138
+ description: string;
139
+ inputSchema: z.ZodDiscriminatedUnion<"entityType", [z.ZodObject<{
140
+ entityIds: z.ZodArray<z.ZodString, "many">;
141
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
142
+ entityType: z.ZodLiteral<"campaign">;
143
+ accountId: z.ZodString;
144
+ }, "strip", z.ZodTypeAny, {
145
+ entityType: "campaign";
146
+ accountId: string;
147
+ entityIds: string[];
148
+ additionalParams?: Record<string, unknown> | undefined;
149
+ }, {
150
+ entityType: "campaign";
151
+ accountId: string;
152
+ entityIds: string[];
153
+ additionalParams?: Record<string, unknown> | undefined;
154
+ }>, z.ZodObject<{
155
+ entityIds: z.ZodArray<z.ZodString, "many">;
156
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
157
+ entityType: z.ZodLiteral<"adGroup">;
158
+ campaignId: z.ZodString;
159
+ }, "strip", z.ZodTypeAny, {
160
+ entityType: "adGroup";
161
+ entityIds: string[];
162
+ campaignId: string;
163
+ additionalParams?: Record<string, unknown> | undefined;
164
+ }, {
165
+ entityType: "adGroup";
166
+ entityIds: string[];
167
+ campaignId: string;
168
+ additionalParams?: Record<string, unknown> | undefined;
169
+ }>, z.ZodObject<{
170
+ entityIds: z.ZodArray<z.ZodString, "many">;
171
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
172
+ entityType: z.ZodLiteral<"ad">;
173
+ adGroupId: z.ZodString;
174
+ }, "strip", z.ZodTypeAny, {
175
+ entityType: "ad";
176
+ entityIds: string[];
177
+ adGroupId: string;
178
+ additionalParams?: Record<string, unknown> | undefined;
179
+ }, {
180
+ entityType: "ad";
181
+ entityIds: string[];
182
+ adGroupId: string;
183
+ additionalParams?: Record<string, unknown> | undefined;
184
+ }>, z.ZodObject<{
185
+ entityIds: z.ZodArray<z.ZodString, "many">;
186
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
187
+ entityType: z.ZodLiteral<"keyword">;
188
+ adGroupId: z.ZodString;
189
+ }, "strip", z.ZodTypeAny, {
190
+ entityType: "keyword";
191
+ entityIds: string[];
192
+ adGroupId: string;
193
+ additionalParams?: Record<string, unknown> | undefined;
194
+ }, {
195
+ entityType: "keyword";
196
+ entityIds: string[];
197
+ adGroupId: string;
198
+ additionalParams?: Record<string, unknown> | undefined;
199
+ }>, z.ZodObject<{
200
+ entityIds: z.ZodArray<z.ZodString, "many">;
201
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
202
+ entityType: z.ZodLiteral<"adExtension">;
203
+ accountId: z.ZodString;
204
+ adExtensionType: z.ZodString;
205
+ }, "strip", z.ZodTypeAny, {
206
+ entityType: "adExtension";
207
+ accountId: string;
208
+ entityIds: string[];
209
+ adExtensionType: string;
210
+ additionalParams?: Record<string, unknown> | undefined;
211
+ }, {
212
+ entityType: "adExtension";
213
+ accountId: string;
214
+ entityIds: string[];
215
+ adExtensionType: string;
216
+ additionalParams?: Record<string, unknown> | undefined;
217
+ }>, z.ZodObject<{
218
+ entityIds: z.ZodArray<z.ZodString, "many">;
219
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
220
+ entityType: z.ZodLiteral<"budget">;
221
+ }, "strip", z.ZodTypeAny, {
222
+ entityType: "budget";
223
+ entityIds: string[];
224
+ additionalParams?: Record<string, unknown> | undefined;
225
+ }, {
226
+ entityType: "budget";
227
+ entityIds: string[];
228
+ additionalParams?: Record<string, unknown> | undefined;
229
+ }>, z.ZodObject<{
230
+ entityIds: z.ZodArray<z.ZodString, "many">;
231
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
232
+ entityType: z.ZodLiteral<"audience">;
233
+ }, "strip", z.ZodTypeAny, {
234
+ entityType: "audience";
235
+ entityIds: string[];
236
+ additionalParams?: Record<string, unknown> | undefined;
237
+ }, {
238
+ entityType: "audience";
239
+ entityIds: string[];
240
+ additionalParams?: Record<string, unknown> | undefined;
241
+ }>, z.ZodObject<{
242
+ entityIds: z.ZodArray<z.ZodString, "many">;
243
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
244
+ entityType: z.ZodLiteral<"label">;
245
+ }, "strip", z.ZodTypeAny, {
246
+ entityType: "label";
247
+ entityIds: string[];
248
+ additionalParams?: Record<string, unknown> | undefined;
249
+ }, {
250
+ entityType: "label";
251
+ entityIds: string[];
252
+ additionalParams?: Record<string, unknown> | undefined;
253
+ }>]>;
254
+ outputSchema: z.ZodObject<{
255
+ entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
256
+ entityType: z.ZodString;
257
+ timestamp: z.ZodString;
258
+ }, "strip", z.ZodTypeAny, {
259
+ entityType: string;
260
+ entities: Record<string, any>[];
261
+ timestamp: string;
262
+ }, {
263
+ entityType: string;
264
+ entities: Record<string, any>[];
265
+ timestamp: string;
266
+ }>;
267
+ annotations: {
268
+ readOnlyHint: boolean;
269
+ openWorldHint: boolean;
270
+ idempotentHint: boolean;
271
+ destructiveHint: boolean;
272
+ };
273
+ inputExamples: {
274
+ label: string;
275
+ input: {
276
+ entityType: string;
277
+ entityIds: string[];
278
+ accountId: string;
279
+ };
280
+ }[];
281
+ logic: typeof getEntityLogic;
282
+ responseFormatter: typeof getEntityResponseFormatter;
283
+ };
284
+ export {};
285
+ //# sourceMappingURL=get-entity.tool.d.ts.map
@@ -0,0 +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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAkBnF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyCiC,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,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBzB,CAAC"}