@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,28 +1,20 @@
1
1
  import { z } from "zod";
2
- import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
2
+ import type { RequestContext, McpTextContent, SdkContext, NormalizedEntitySnapshot } from "@cesteral/shared";
3
3
  export declare const CreateEntityInputSchema: z.ZodObject<{
4
- entityType: z.ZodEnum<[string, ...string[]]>;
4
+ entityType: z.ZodEnum<{
5
+ [x: string]: string;
6
+ }>;
5
7
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
6
- }, "strip", z.ZodTypeAny, {
7
- entityType: string;
8
- data: Record<string, unknown>;
9
- }, {
10
- entityType: string;
11
- data: Record<string, unknown>;
12
- }>;
8
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
9
+ }, z.core.$strip>;
13
10
  export declare const CreateEntityOutputSchema: z.ZodObject<{
14
11
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
15
12
  entityType: z.ZodString;
16
13
  timestamp: z.ZodString;
17
- }, "strip", z.ZodTypeAny, {
18
- entityType: string;
19
- timestamp: string;
20
- result: Record<string, any>;
21
- }, {
22
- entityType: string;
23
- timestamp: string;
24
- result: Record<string, any>;
25
- }>;
14
+ dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DryRunResult, unknown>>>;
15
+ after: z.ZodOptional<z.ZodType<NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<NormalizedEntitySnapshot, unknown>>>;
16
+ dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DispatchedCapability, unknown>>;
17
+ }, z.core.$strip>;
26
18
  type CreateEntityInput = z.infer<typeof CreateEntityInputSchema>;
27
19
  type CreateEntityOutput = z.infer<typeof CreateEntityOutputSchema>;
28
20
  export declare function createEntityLogic(input: CreateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateEntityOutput>;
@@ -32,39 +24,55 @@ export declare const createEntityTool: {
32
24
  title: string;
33
25
  description: string;
34
26
  inputSchema: z.ZodObject<{
35
- entityType: z.ZodEnum<[string, ...string[]]>;
27
+ entityType: z.ZodEnum<{
28
+ [x: string]: string;
29
+ }>;
36
30
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
37
- }, "strip", z.ZodTypeAny, {
38
- entityType: string;
39
- data: Record<string, unknown>;
40
- }, {
41
- entityType: string;
42
- data: Record<string, unknown>;
43
- }>;
31
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
32
+ }, z.core.$strip>;
44
33
  outputSchema: z.ZodObject<{
45
34
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
46
35
  entityType: z.ZodString;
47
36
  timestamp: z.ZodString;
48
- }, "strip", z.ZodTypeAny, {
49
- entityType: string;
50
- timestamp: string;
51
- result: Record<string, any>;
52
- }, {
53
- entityType: string;
54
- timestamp: string;
55
- result: Record<string, any>;
56
- }>;
37
+ dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DryRunResult, unknown>>>;
38
+ after: z.ZodOptional<z.ZodType<NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<NormalizedEntitySnapshot, unknown>>>;
39
+ dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DispatchedCapability, unknown>>;
40
+ }, z.core.$strip>;
57
41
  annotations: {
58
42
  readOnlyHint: boolean;
59
43
  openWorldHint: boolean;
60
44
  idempotentHint: boolean;
61
45
  destructiveHint: boolean;
46
+ cesteral: {
47
+ kind: "write";
48
+ writeClass: "entity";
49
+ executableArgsExclude: string[];
50
+ platform: string;
51
+ contractPlatformSlug: string;
52
+ contractToolSlug: string;
53
+ operation: "create"[];
54
+ entityKinds: ("campaign" | "ad" | "ad_group" | "campaign_budget")[];
55
+ entityIdArgs: never[];
56
+ readPartner: {
57
+ toolName: string;
58
+ argMap: {
59
+ entityType: string;
60
+ };
61
+ };
62
+ schemaVersion: number;
63
+ contractId: string;
64
+ supportsDryRun: true;
65
+ supportsBeforeAfterSnapshot: true;
66
+ requiresValidation: true;
67
+ requiresSimulation: true;
68
+ };
62
69
  };
63
70
  inputExamples: {
64
71
  label: string;
65
72
  input: {
66
73
  entityType: string;
67
74
  data: {
75
+ AccountId: number;
68
76
  Campaigns: {
69
77
  Name: string;
70
78
  BudgetType: string;
@@ -76,6 +84,10 @@ export declare const createEntityTool: {
76
84
  }[];
77
85
  logic: typeof createEntityLogic;
78
86
  responseFormatter: typeof createEntityResponseFormatter;
87
+ untrustedContent: {
88
+ structuredPaths: string[];
89
+ contentBlocks: number[];
90
+ };
79
91
  };
80
92
  export {};
81
93
  //# sourceMappingURL=create-entity.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-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;AAUnF,eAAO,MAAM,uBAAuB;;;;;;;;;EAKyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC5B,CAAC"}
1
+ {"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,wBAAwB,EAEzB,MAAM,kBAAkB,CAAC;AAwC1B,eAAO,MAAM,uBAAuB;;;;;;iBAcyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;iBAeA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA6D7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAoB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqE5B,CAAC"}
@@ -1,36 +1,106 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
- import { getEntityTypeEnum } from "../utils/entity-mapping.js";
3
+ import { getEntityConfig, getEntityTypeEnum, } from "../utils/entity-mapping.js";
4
+ import { runMsAdsCreateDryRun, resolveMsAdsCreateCapability, symbolicValidate, } from "../utils/dry-run.js";
5
+ import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
6
+ import { resolveMsAdsCurrency, snapshotFromMsAdsEntity } from "../utils/capture-snapshot.js";
7
+ import { DryRunResultSchema, NormalizedEntitySnapshotSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
4
8
  const TOOL_NAME = "msads_create_entity";
5
9
  const TOOL_TITLE = "Create Microsoft Ads Entity";
6
10
  const TOOL_DESCRIPTION = `Create a new Microsoft Advertising entity.
7
11
 
12
+ **Supported entity types:** ${getEntityTypeEnum().join(", ")}
13
+
8
14
  The data object should follow Microsoft Ads API v13 format. Wrap entities in their plural key (e.g., { "Campaigns": [{ "Name": "..." }] }).
9
15
 
10
16
  Use the entity-schema and entity-examples MCP resources to discover required fields.`;
17
+ function unwrapEntityItem(entityType, data) {
18
+ const config = getEntityConfig(entityType);
19
+ const collection = data[config.pluralName];
20
+ if (Array.isArray(collection) && collection.length > 0 && typeof collection[0] === "object") {
21
+ return (collection[0] ?? {});
22
+ }
23
+ return {};
24
+ }
25
+ function extractCreatedId(result) {
26
+ for (const [key, value] of Object.entries(result)) {
27
+ if (key.endsWith("Ids") && Array.isArray(value)) {
28
+ const first = value.find((v) => v != null);
29
+ if (first != null)
30
+ return String(first);
31
+ }
32
+ }
33
+ return "";
34
+ }
11
35
  export const CreateEntityInputSchema = z
12
36
  .object({
13
37
  entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
14
- data: z.record(z.unknown()).describe("Entity data payload following Microsoft Ads API format"),
38
+ data: z
39
+ .record(z.string(), z.unknown())
40
+ .describe("Entity data payload following Microsoft Ads API format"),
41
+ dry_run: z
42
+ .boolean()
43
+ .optional()
44
+ .default(false)
45
+ .describe("When true, validates the creation and returns a DryRunResult under `dryRun` (expected post-state = the would-be-created entity) without calling the Microsoft Ads API. No entity is created."),
15
46
  })
16
47
  .describe("Parameters for creating a Microsoft Ads entity");
17
48
  export const CreateEntityOutputSchema = z
18
49
  .object({
19
- result: z.record(z.any()).describe("API response with created entity IDs"),
50
+ result: z.record(z.string(), z.any()).describe("API response with created entity IDs"),
20
51
  entityType: z.string(),
21
52
  timestamp: z.string().datetime(),
53
+ dryRun: DryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entity was created."),
54
+ after: NormalizedEntitySnapshotSchema.optional().describe("Post-create canonical snapshot, normalized from the submitted entity payload (in-scope kinds: campaign, ad_group, ad, campaign_budget). Create has no `before`."),
55
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to. Present on every response."),
22
56
  })
23
57
  .describe("Entity creation result");
24
58
  export async function createEntityLogic(input, context, sdkContext) {
25
59
  const { msadsService } = resolveSessionServices(sdkContext);
60
+ const dispatchedCapability = resolveMsAdsCreateCapability(input.entityType);
61
+ const entityItem = unwrapEntityItem(input.entityType, input.data);
62
+ if (input.dry_run === true) {
63
+ const dryRun = await runMsAdsCreateDryRun({ entityType: input.entityType, data: entityItem }, msadsService, context);
64
+ return {
65
+ result: {},
66
+ entityType: input.entityType,
67
+ timestamp: new Date().toISOString(),
68
+ dryRun,
69
+ dispatchedCapability,
70
+ };
71
+ }
72
+ if (Object.keys(entityItem).length === 0) {
73
+ throw new McpError(JsonRpcErrorCode.InvalidParams, "`data` must contain at least one field to create a Microsoft Ads entity.");
74
+ }
75
+ const createValidationErrors = symbolicValidate(entityItem);
76
+ if (createValidationErrors.length > 0) {
77
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid create payload: ${createValidationErrors.map((e) => e.message).join("; ")}`);
78
+ }
26
79
  const result = (await msadsService.createEntity(input.entityType, input.data, context));
80
+ const createdId = extractCreatedId(result);
81
+ const after = snapshotFromMsAdsEntity(input.entityType, createdId, entityItem, await resolveMsAdsCurrency(msadsService, context));
27
82
  return {
28
83
  result,
29
84
  entityType: input.entityType,
30
85
  timestamp: new Date().toISOString(),
86
+ ...(after ? { after } : {}),
87
+ dispatchedCapability,
31
88
  };
32
89
  }
33
90
  export function createEntityResponseFormatter(result) {
91
+ if (result.dryRun) {
92
+ const { wouldSucceed, validationErrors, validationSource, expectedStateSource } = result.dryRun;
93
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
94
+ const errorLines = validationErrors.length
95
+ ? "\n" + validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n")
96
+ : "";
97
+ return [
98
+ {
99
+ type: "text",
100
+ text: `Dry run: creating ${result.entityType} ${verdict} (validation: ${validationSource}, expected-state: ${expectedStateSource}). No entity was created.${errorLines}\n\nTimestamp: ${result.timestamp}`,
101
+ },
102
+ ];
103
+ }
34
104
  return [
35
105
  {
36
106
  type: "text",
@@ -49,6 +119,27 @@ export const createEntityTool = {
49
119
  openWorldHint: false,
50
120
  idempotentHint: false,
51
121
  destructiveHint: false,
122
+ cesteral: {
123
+ kind: "write",
124
+ writeClass: "entity",
125
+ executableArgsExclude: ["dry_run"],
126
+ platform: "msads",
127
+ contractPlatformSlug: "msads",
128
+ contractToolSlug: "create_entity",
129
+ operation: ["create"],
130
+ entityKinds: ["campaign", "ad_group", "ad", "campaign_budget"],
131
+ entityIdArgs: [],
132
+ readPartner: {
133
+ toolName: "msads_get_entity",
134
+ argMap: { entityType: "entityType" },
135
+ },
136
+ schemaVersion: 1,
137
+ contractId: "msads.create_entity.v1",
138
+ supportsDryRun: true,
139
+ supportsBeforeAfterSnapshot: true,
140
+ requiresValidation: true,
141
+ requiresSimulation: true,
142
+ },
52
143
  },
53
144
  inputExamples: [
54
145
  {
@@ -56,6 +147,7 @@ export const createEntityTool = {
56
147
  input: {
57
148
  entityType: "campaign",
58
149
  data: {
150
+ AccountId: 123456789,
59
151
  Campaigns: [
60
152
  {
61
153
  Name: "My Campaign",
@@ -70,5 +162,9 @@ export const createEntityTool = {
70
162
  ],
71
163
  logic: createEntityLogic,
72
164
  responseFormatter: createEntityResponseFormatter,
165
+ untrustedContent: {
166
+ structuredPaths: ["$.result", "$.after"],
167
+ contentBlocks: [0],
168
+ },
73
169
  };
74
170
  //# sourceMappingURL=create-entity.tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAwB,MAAM,4BAA4B,CAAC;AAGrF,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;;;qFAI4D,CAAC;AAEtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CAC/F,CAAC;KACD,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAKtC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAC7C,KAAK,CAAC,UAA6B,EACnC,KAAK,CAAC,IAAI,EACV,OAAO,CACR,CAA4B,CAAC;IAE9B,OAAO;QACL,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,WAAW,MAAM,CAAC,UAAU,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACpI;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,KAAK;QACrB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,IAAI,EAAE;oBACJ,SAAS,EAAE;wBACT;4BACE,IAAI,EAAE,aAAa;4BACnB,UAAU,EAAE,qBAAqB;4BACjC,WAAW,EAAE,IAAI;4BACjB,QAAQ,EAAE,qBAAqB;yBAChC;qBACF;iBACF;aACF;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
1
+ {"version":3,"file":"create-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"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"}
@@ -1,69 +1,36 @@
1
1
  import { z } from "zod";
2
- import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
2
+ import type { RequestContext, McpTextContent, SdkContext, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
3
+ export declare const MSADS_NO_REPORT_SCHEDULES_MESSAGE = "Microsoft Advertising Reporting API v13 has no report schedules \u2014 it exposes only GenerateReport/Submit and GenerateReport/Poll, and ReportRequest has no Schedule element. Nothing was scheduled. Run a one-off report with msads_submit_report / msads_get_report instead.";
3
4
  export declare const CreateReportScheduleInputSchema: z.ZodObject<{
4
5
  accountId: z.ZodString;
5
6
  scheduleName: z.ZodString;
6
7
  reportType: z.ZodString;
7
- columns: z.ZodArray<z.ZodString, "many">;
8
+ columns: z.ZodArray<z.ZodString>;
8
9
  startDate: z.ZodString;
9
10
  endDate: z.ZodString;
10
11
  aggregation: z.ZodOptional<z.ZodString>;
11
12
  schedule: z.ZodObject<{
12
13
  StartDate: z.ZodString;
13
14
  EndDate: z.ZodOptional<z.ZodString>;
14
- Frequency: z.ZodEnum<["Daily", "Weekly", "Monthly"]>;
15
- }, "strip", z.ZodTypeAny, {
16
- StartDate: string;
17
- Frequency: "Daily" | "Weekly" | "Monthly";
18
- EndDate?: string | undefined;
19
- }, {
20
- StartDate: string;
21
- Frequency: "Daily" | "Weekly" | "Monthly";
22
- EndDate?: string | undefined;
23
- }>;
24
- }, "strip", z.ZodTypeAny, {
25
- accountId: string;
26
- reportType: string;
27
- scheduleName: string;
28
- columns: string[];
29
- startDate: string;
30
- endDate: string;
31
- schedule: {
32
- StartDate: string;
33
- Frequency: "Daily" | "Weekly" | "Monthly";
34
- EndDate?: string | undefined;
35
- };
36
- aggregation?: string | undefined;
37
- }, {
38
- accountId: string;
39
- reportType: string;
40
- scheduleName: string;
41
- columns: string[];
42
- startDate: string;
43
- endDate: string;
44
- schedule: {
45
- StartDate: string;
46
- Frequency: "Daily" | "Weekly" | "Monthly";
47
- EndDate?: string | undefined;
48
- };
49
- aggregation?: string | undefined;
50
- }>;
15
+ Frequency: z.ZodEnum<{
16
+ Daily: "Daily";
17
+ Weekly: "Weekly";
18
+ Monthly: "Monthly";
19
+ }>;
20
+ }, z.core.$strip>;
21
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22
+ }, z.core.$strip>;
51
23
  export declare const CreateReportScheduleOutputSchema: z.ZodObject<{
52
- scheduleId: z.ZodString;
53
- scheduleName: z.ZodString;
24
+ scheduleId: z.ZodOptional<z.ZodString>;
25
+ scheduleName: z.ZodOptional<z.ZodString>;
54
26
  timestamp: z.ZodString;
55
- }, "strip", z.ZodTypeAny, {
56
- scheduleName: string;
57
- scheduleId: string;
58
- timestamp: string;
59
- }, {
60
- scheduleName: string;
61
- scheduleId: string;
62
- timestamp: string;
63
- }>;
27
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
28
+ effect: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").EffectResult, unknown>>>;
29
+ dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
30
+ }, z.core.$strip>;
64
31
  type CreateReportScheduleInput = z.infer<typeof CreateReportScheduleInputSchema>;
65
32
  type CreateReportScheduleOutput = z.infer<typeof CreateReportScheduleOutputSchema>;
66
- export declare function createReportScheduleLogic(input: CreateReportScheduleInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateReportScheduleOutput>;
33
+ export declare function createReportScheduleLogic(input: CreateReportScheduleInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<CreateReportScheduleOutput>;
67
34
  export declare function createReportScheduleResponseFormatter(result: CreateReportScheduleOutput): McpTextContent[];
68
35
  export declare const createReportScheduleTool: {
69
36
  name: string;
@@ -73,68 +40,51 @@ export declare const createReportScheduleTool: {
73
40
  accountId: z.ZodString;
74
41
  scheduleName: z.ZodString;
75
42
  reportType: z.ZodString;
76
- columns: z.ZodArray<z.ZodString, "many">;
43
+ columns: z.ZodArray<z.ZodString>;
77
44
  startDate: z.ZodString;
78
45
  endDate: z.ZodString;
79
46
  aggregation: z.ZodOptional<z.ZodString>;
80
47
  schedule: z.ZodObject<{
81
48
  StartDate: z.ZodString;
82
49
  EndDate: z.ZodOptional<z.ZodString>;
83
- Frequency: z.ZodEnum<["Daily", "Weekly", "Monthly"]>;
84
- }, "strip", z.ZodTypeAny, {
85
- StartDate: string;
86
- Frequency: "Daily" | "Weekly" | "Monthly";
87
- EndDate?: string | undefined;
88
- }, {
89
- StartDate: string;
90
- Frequency: "Daily" | "Weekly" | "Monthly";
91
- EndDate?: string | undefined;
92
- }>;
93
- }, "strip", z.ZodTypeAny, {
94
- accountId: string;
95
- reportType: string;
96
- scheduleName: string;
97
- columns: string[];
98
- startDate: string;
99
- endDate: string;
100
- schedule: {
101
- StartDate: string;
102
- Frequency: "Daily" | "Weekly" | "Monthly";
103
- EndDate?: string | undefined;
104
- };
105
- aggregation?: string | undefined;
106
- }, {
107
- accountId: string;
108
- reportType: string;
109
- scheduleName: string;
110
- columns: string[];
111
- startDate: string;
112
- endDate: string;
113
- schedule: {
114
- StartDate: string;
115
- Frequency: "Daily" | "Weekly" | "Monthly";
116
- EndDate?: string | undefined;
117
- };
118
- aggregation?: string | undefined;
119
- }>;
50
+ Frequency: z.ZodEnum<{
51
+ Daily: "Daily";
52
+ Weekly: "Weekly";
53
+ Monthly: "Monthly";
54
+ }>;
55
+ }, z.core.$strip>;
56
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
57
+ }, z.core.$strip>;
120
58
  outputSchema: z.ZodObject<{
121
- scheduleId: z.ZodString;
122
- scheduleName: z.ZodString;
59
+ scheduleId: z.ZodOptional<z.ZodString>;
60
+ scheduleName: z.ZodOptional<z.ZodString>;
123
61
  timestamp: z.ZodString;
124
- }, "strip", z.ZodTypeAny, {
125
- scheduleName: string;
126
- scheduleId: string;
127
- timestamp: string;
128
- }, {
129
- scheduleName: string;
130
- scheduleId: string;
131
- timestamp: string;
132
- }>;
62
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
63
+ effect: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").EffectResult, unknown>>>;
64
+ dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
65
+ }, z.core.$strip>;
133
66
  annotations: {
134
67
  readOnlyHint: boolean;
135
68
  openWorldHint: boolean;
136
69
  destructiveHint: boolean;
137
70
  idempotentHint: boolean;
71
+ cesteral: {
72
+ kind: "write";
73
+ writeClass: "effect";
74
+ executableArgsExclude: string[];
75
+ platform: string;
76
+ contractPlatformSlug: string;
77
+ contractToolSlug: string;
78
+ operation: "create_schedule"[];
79
+ entityKinds: never[];
80
+ entityIdArgs: never[];
81
+ schemaVersion: number;
82
+ contractId: string;
83
+ supportsDryRun: true;
84
+ supportsBeforeAfterSnapshot: false;
85
+ requiresValidation: true;
86
+ requiresSimulation: false;
87
+ };
138
88
  };
139
89
  inputExamples: {
140
90
  label: string;
@@ -155,6 +105,7 @@ export declare const createReportScheduleTool: {
155
105
  }[];
156
106
  logic: typeof createReportScheduleLogic;
157
107
  responseFormatter: typeof createReportScheduleResponseFormatter;
108
+ untrustedContent: Readonly<import("@cesteral/shared").ToolUntrustedDeclaration>;
158
109
  };
159
110
  export {};
160
111
  //# sourceMappingURL=create-report-schedule.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.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;AAqBnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB2B,CAAC;AAExE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;EAMP,CAAC;AAEvC,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAqBrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpC,CAAC"}
1
+ {"version":3,"file":"create-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAoB1B,eAAO,MAAM,iCAAiC,sRACkO,CAAC;AAEjR,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;iBA2B2B,CAAC;AAExE,eAAO,MAAM,gCAAgC;;;;;;;iBAoBP,CAAC;AAEvC,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,0BAA0B,CAAC,CAyBrC;AA6DD,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAsBlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDpC,CAAC"}