@cesteral/msads-mcp 1.1.0 → 1.3.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 (72) hide show
  1. package/dist/cesteral-manifest.json +87 -3
  2. package/dist/mcp-server/server.d.ts.map +1 -1
  3. package/dist/mcp-server/server.js +2 -1
  4. package/dist/mcp-server/server.js.map +1 -1
  5. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +42 -1
  6. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
  7. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +89 -1
  8. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
  9. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +42 -1
  10. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
  11. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +85 -0
  12. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
  13. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +42 -1
  14. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
  15. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +96 -1
  16. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
  17. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +42 -1
  18. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +101 -1
  20. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +4 -4
  22. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +46 -1
  23. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
  24. package/dist/mcp-server/tools/definitions/create-entity.tool.js +82 -1
  25. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
  26. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +54 -13
  27. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
  28. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +109 -2
  29. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
  30. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +48 -1
  31. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
  32. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +123 -4
  33. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
  34. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +48 -7
  35. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
  36. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +75 -4
  37. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
  38. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +8 -8
  39. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +48 -7
  40. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
  41. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +63 -2
  42. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +48 -7
  44. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +63 -2
  46. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +52 -11
  48. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +64 -2
  50. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +52 -7
  52. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/submit-report.tool.js +96 -2
  54. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
  55. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +26 -1608
  56. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
  57. package/dist/mcp-server/tools/definitions/update-entity.tool.js +2 -0
  58. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
  59. package/dist/mcp-server/tools/utils/dry-run.d.ts +6 -0
  60. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/utils/dry-run.js +27 -0
  62. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
  63. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
  64. package/dist/mcp-server/transports/streamable-http-transport.js +1 -0
  65. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
  66. package/dist/testkit/fixtures/index.d.ts +4 -0
  67. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  68. package/dist/testkit/fixtures/index.js +110 -0
  69. package/dist/testkit/fixtures/index.js.map +1 -1
  70. package/dist/testkit/types.d.ts +2 -1
  71. package/dist/testkit/types.d.ts.map +1 -1
  72. package/package.json +2 -2
@@ -1,9 +1,10 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
3
  import { getEntityTypeEnum } from "../utils/entity-mapping.js";
4
- import { elicitBulkStatusChangeConfirmation } from "@cesteral/shared";
4
+ import { elicitBulkStatusChangeConfirmation, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
5
5
  const TOOL_NAME = "msads_bulk_update_status";
6
6
  const TOOL_TITLE = "Bulk Update Microsoft Ads Entity Status";
7
+ const EFFECT_KIND = "entity_statuses_updated";
7
8
  const TOOL_DESCRIPTION = `Batch update the status of multiple Microsoft Advertising entities.
8
9
 
9
10
  Valid statuses: Active, Paused, Deleted (varies by entity type).`;
@@ -12,6 +13,11 @@ export const BulkUpdateStatusInputSchema = z
12
13
  entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
13
14
  entityIds: z.array(z.string()).min(1).describe("Array of entity IDs"),
14
15
  status: z.string().describe("New status (Active, Paused, Deleted)"),
16
+ dry_run: z
17
+ .boolean()
18
+ .optional()
19
+ .default(false)
20
+ .describe("When true, symbolically validates the batch and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bulk status change) without prompting for confirmation or calling the Microsoft Ads API. No statuses are changed."),
15
21
  })
16
22
  .describe("Parameters for bulk status update");
17
23
  export const BulkUpdateStatusOutputSchema = z
@@ -28,9 +34,30 @@ export const BulkUpdateStatusOutputSchema = z
28
34
  failureCount: z.number(),
29
35
  status: z.string(),
30
36
  timestamp: z.string().datetime(),
37
+ dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No statuses were changed."),
38
+ effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `entity_statuses_updated` + scalar batch audit summary incl. target_status). Present on a confirmed execute. A bulk status change is governed as a single batch effect — it carries no per-entity canonical snapshot."),
39
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `bulk_job` with `canonicalEntityKind: null` (effect class; the governed result is the batch effect, not one entity). Present on every response."),
31
40
  })
32
41
  .describe("Bulk status update result with per-entity outcomes");
33
42
  export async function bulkUpdateStatusLogic(input, context, sdkContext) {
43
+ const dispatchedCapability = {
44
+ operation: "bulk_job",
45
+ canonicalEntityKind: null,
46
+ };
47
+ if (input.dry_run === true) {
48
+ const dryRun = buildBulkEffectDryRun(input);
49
+ return {
50
+ confirmed: true,
51
+ results: [],
52
+ entityType: input.entityType,
53
+ successCount: 0,
54
+ failureCount: 0,
55
+ status: input.status,
56
+ timestamp: new Date().toISOString(),
57
+ dryRun,
58
+ dispatchedCapability,
59
+ };
60
+ }
34
61
  const confirmed = await elicitBulkStatusChangeConfirmation({
35
62
  count: input.entityIds.length,
36
63
  entityLabel: input.entityType,
@@ -48,12 +75,24 @@ export async function bulkUpdateStatusLogic(input, context, sdkContext) {
48
75
  failureCount: 0,
49
76
  status: input.status,
50
77
  timestamp: new Date().toISOString(),
78
+ dispatchedCapability,
51
79
  };
52
80
  }
53
81
  const { msadsService } = resolveSessionServices(sdkContext);
54
82
  const { results } = await msadsService.bulkUpdateStatus(input.entityType, input.entityIds, input.status, context);
55
83
  const successCount = results.filter((r) => r.success).length;
56
84
  const failureCount = results.length - successCount;
85
+ const effect = {
86
+ effectKind: EFFECT_KIND,
87
+ summary: {
88
+ entity_kind: input.entityType,
89
+ requested: input.entityIds.length,
90
+ succeeded: successCount,
91
+ failed: failureCount,
92
+ partial_success: successCount > 0 && failureCount > 0,
93
+ target_status: input.status,
94
+ },
95
+ };
57
96
  return {
58
97
  confirmed: true,
59
98
  results,
@@ -62,9 +101,53 @@ export async function bulkUpdateStatusLogic(input, context, sdkContext) {
62
101
  failureCount,
63
102
  status: input.status,
64
103
  timestamp: new Date().toISOString(),
104
+ effect,
105
+ dispatchedCapability,
65
106
  };
66
107
  }
108
+ function buildBulkEffectDryRun(input) {
109
+ const validationErrors = [];
110
+ input.entityIds.forEach((id, i) => {
111
+ if (!id || id.trim().length === 0) {
112
+ validationErrors.push({
113
+ code: "INVALID_ENTITY_ID",
114
+ message: `entityIds[${i}] must be a non-empty entity ID`,
115
+ field: `entityIds.${i}`,
116
+ });
117
+ }
118
+ });
119
+ const expectedEffect = {
120
+ effectKind: EFFECT_KIND,
121
+ summary: {
122
+ entity_kind: input.entityType,
123
+ requested: input.entityIds.length,
124
+ target_status: input.status,
125
+ },
126
+ };
127
+ return assertGovernedEffectDryRun({
128
+ wouldSucceed: validationErrors.length === 0,
129
+ validationErrors,
130
+ validationSource: "symbolic",
131
+ expectedEffectSource: "symbolic",
132
+ expectedEffect,
133
+ }, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
134
+ }
67
135
  export function bulkUpdateStatusResponseFormatter(result) {
136
+ if (result.dryRun) {
137
+ const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
138
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
139
+ const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
140
+ const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
141
+ const status = result.dryRun.expectedEffect?.summary.target_status ?? "?";
142
+ return [
143
+ {
144
+ type: "text",
145
+ text: `Dry run: bulk status change of ${String(n)} ${result.entityType}(s) to ${String(status)} ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No statuses were changed.` +
146
+ (errs ? `\n${errs}` : "") +
147
+ `\n\nTimestamp: ${result.timestamp}`,
148
+ },
149
+ ];
150
+ }
68
151
  if (!result.confirmed) {
69
152
  return [
70
153
  {
@@ -95,6 +178,23 @@ export const bulkUpdateStatusTool = {
95
178
  openWorldHint: false,
96
179
  idempotentHint: true,
97
180
  destructiveHint: true,
181
+ cesteral: {
182
+ kind: "write",
183
+ writeClass: "effect",
184
+ executableArgsExclude: ["dry_run"],
185
+ platform: "msads",
186
+ contractPlatformSlug: "msads",
187
+ contractToolSlug: "bulk_update_status",
188
+ operation: ["bulk_job"],
189
+ entityKinds: [],
190
+ entityIdArgs: [],
191
+ schemaVersion: 1,
192
+ contractId: "msads.bulk_update_status.v1",
193
+ supportsDryRun: true,
194
+ supportsBeforeAfterSnapshot: false,
195
+ requiresValidation: true,
196
+ requiresSimulation: true,
197
+ },
98
198
  },
99
199
  inputExamples: [
100
200
  {
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-update-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"bulk-update-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.tool.ts"],"names":[],"mappings":"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"}
@@ -24,7 +24,7 @@ export declare const CheckReportStatusOutputSchema: z.ZodObject<{
24
24
  timestamp: string;
25
25
  rawStatus: string;
26
26
  isComplete: boolean;
27
- state: "pending" | "running" | "complete" | "failed" | "cancelled";
27
+ state: "failed" | "pending" | "running" | "complete" | "cancelled";
28
28
  downloadUrl?: string | undefined;
29
29
  progress?: number | undefined;
30
30
  errors?: string[] | undefined;
@@ -35,7 +35,7 @@ export declare const CheckReportStatusOutputSchema: z.ZodObject<{
35
35
  timestamp: string;
36
36
  rawStatus: string;
37
37
  isComplete: boolean;
38
- state: "pending" | "running" | "complete" | "failed" | "cancelled";
38
+ state: "failed" | "pending" | "running" | "complete" | "cancelled";
39
39
  downloadUrl?: string | undefined;
40
40
  progress?: number | undefined;
41
41
  errors?: string[] | undefined;
@@ -74,7 +74,7 @@ export declare const checkReportStatusTool: {
74
74
  timestamp: string;
75
75
  rawStatus: string;
76
76
  isComplete: boolean;
77
- state: "pending" | "running" | "complete" | "failed" | "cancelled";
77
+ state: "failed" | "pending" | "running" | "complete" | "cancelled";
78
78
  downloadUrl?: string | undefined;
79
79
  progress?: number | undefined;
80
80
  errors?: string[] | undefined;
@@ -85,7 +85,7 @@ export declare const checkReportStatusTool: {
85
85
  timestamp: string;
86
86
  rawStatus: string;
87
87
  isComplete: boolean;
88
- state: "pending" | "running" | "complete" | "failed" | "cancelled";
88
+ state: "failed" | "pending" | "running" | "complete" | "cancelled";
89
89
  downloadUrl?: string | undefined;
90
90
  progress?: number | undefined;
91
91
  errors?: string[] | undefined;
@@ -1,27 +1,39 @@
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
4
  entityType: z.ZodEnum<[string, ...string[]]>;
5
5
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
6
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6
7
  }, "strip", z.ZodTypeAny, {
7
8
  entityType: string;
8
9
  data: Record<string, unknown>;
10
+ dry_run: boolean;
9
11
  }, {
10
12
  entityType: string;
11
13
  data: Record<string, unknown>;
14
+ dry_run?: boolean | undefined;
12
15
  }>;
13
16
  export declare const CreateEntityOutputSchema: z.ZodObject<{
14
17
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
15
18
  entityType: z.ZodString;
16
19
  timestamp: z.ZodString;
20
+ dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, z.ZodTypeDef, import("@cesteral/contract-schema").DryRunResult>>;
21
+ after: z.ZodOptional<z.ZodType<NormalizedEntitySnapshot, z.ZodTypeDef, NormalizedEntitySnapshot>>;
22
+ dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, z.ZodTypeDef, import("@cesteral/contract-schema").DispatchedCapability>;
17
23
  }, "strip", z.ZodTypeAny, {
18
24
  entityType: string;
19
25
  timestamp: string;
20
26
  result: Record<string, any>;
27
+ dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
28
+ dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
29
+ after?: NormalizedEntitySnapshot | undefined;
21
30
  }, {
22
31
  entityType: string;
23
32
  timestamp: string;
24
33
  result: Record<string, any>;
34
+ dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
35
+ dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
36
+ after?: NormalizedEntitySnapshot | undefined;
25
37
  }>;
26
38
  type CreateEntityInput = z.infer<typeof CreateEntityInputSchema>;
27
39
  type CreateEntityOutput = z.infer<typeof CreateEntityOutputSchema>;
@@ -34,31 +46,64 @@ export declare const createEntityTool: {
34
46
  inputSchema: z.ZodObject<{
35
47
  entityType: z.ZodEnum<[string, ...string[]]>;
36
48
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
49
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
37
50
  }, "strip", z.ZodTypeAny, {
38
51
  entityType: string;
39
52
  data: Record<string, unknown>;
53
+ dry_run: boolean;
40
54
  }, {
41
55
  entityType: string;
42
56
  data: Record<string, unknown>;
57
+ dry_run?: boolean | undefined;
43
58
  }>;
44
59
  outputSchema: z.ZodObject<{
45
60
  result: z.ZodRecord<z.ZodString, z.ZodAny>;
46
61
  entityType: z.ZodString;
47
62
  timestamp: z.ZodString;
63
+ dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, z.ZodTypeDef, import("@cesteral/contract-schema").DryRunResult>>;
64
+ after: z.ZodOptional<z.ZodType<NormalizedEntitySnapshot, z.ZodTypeDef, NormalizedEntitySnapshot>>;
65
+ dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, z.ZodTypeDef, import("@cesteral/contract-schema").DispatchedCapability>;
48
66
  }, "strip", z.ZodTypeAny, {
49
67
  entityType: string;
50
68
  timestamp: string;
51
69
  result: Record<string, any>;
70
+ dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
71
+ dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
72
+ after?: NormalizedEntitySnapshot | undefined;
52
73
  }, {
53
74
  entityType: string;
54
75
  timestamp: string;
55
76
  result: Record<string, any>;
77
+ dispatchedCapability: import("@cesteral/contract-schema").DispatchedCapability;
78
+ dryRun?: import("@cesteral/contract-schema").DryRunResult | undefined;
79
+ after?: NormalizedEntitySnapshot | undefined;
56
80
  }>;
57
81
  annotations: {
58
82
  readOnlyHint: boolean;
59
83
  openWorldHint: boolean;
60
84
  idempotentHint: boolean;
61
85
  destructiveHint: boolean;
86
+ cesteral: {
87
+ kind: "write";
88
+ writeClass: "entity";
89
+ executableArgsExclude: string[];
90
+ platform: string;
91
+ contractPlatformSlug: string;
92
+ contractToolSlug: string;
93
+ operation: "create"[];
94
+ entityKinds: ("campaign" | "ad" | "ad_group" | "campaign_budget")[];
95
+ entityIdArgs: never[];
96
+ readPartner: {
97
+ toolName: string;
98
+ argMap: {};
99
+ };
100
+ schemaVersion: number;
101
+ contractId: string;
102
+ supportsDryRun: true;
103
+ supportsBeforeAfterSnapshot: true;
104
+ requiresValidation: true;
105
+ requiresSimulation: true;
106
+ };
62
107
  };
63
108
  inputExamples: {
64
109
  label: string;
@@ -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;AAcxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,wBAAwB,EAEzB,MAAM,kBAAkB,CAAC;AAwC1B,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAYyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAeA,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,CA2C7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAoB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4D5B,CAAC"}
@@ -1,17 +1,45 @@
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 } from "../utils/dry-run.js";
5
+ import { snapshotFromMsAdsEntity } from "../utils/capture-snapshot.js";
6
+ import { DryRunResultSchema, NormalizedEntitySnapshotSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
4
7
  const TOOL_NAME = "msads_create_entity";
5
8
  const TOOL_TITLE = "Create Microsoft Ads Entity";
6
9
  const TOOL_DESCRIPTION = `Create a new Microsoft Advertising entity.
7
10
 
11
+ **Supported entity types:** ${getEntityTypeEnum().join(", ")}
12
+
8
13
  The data object should follow Microsoft Ads API v13 format. Wrap entities in their plural key (e.g., { "Campaigns": [{ "Name": "..." }] }).
9
14
 
10
15
  Use the entity-schema and entity-examples MCP resources to discover required fields.`;
16
+ function unwrapEntityItem(entityType, data) {
17
+ const config = getEntityConfig(entityType);
18
+ const collection = data[config.pluralName];
19
+ if (Array.isArray(collection) && collection.length > 0 && typeof collection[0] === "object") {
20
+ return (collection[0] ?? {});
21
+ }
22
+ return {};
23
+ }
24
+ function extractCreatedId(result) {
25
+ for (const [key, value] of Object.entries(result)) {
26
+ if (key.endsWith("Ids") && Array.isArray(value)) {
27
+ const first = value.find((v) => v != null);
28
+ if (first != null)
29
+ return String(first);
30
+ }
31
+ }
32
+ return "";
33
+ }
11
34
  export const CreateEntityInputSchema = z
12
35
  .object({
13
36
  entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
14
37
  data: z.record(z.unknown()).describe("Entity data payload following Microsoft Ads API format"),
38
+ dry_run: z
39
+ .boolean()
40
+ .optional()
41
+ .default(false)
42
+ .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
43
  })
16
44
  .describe("Parameters for creating a Microsoft Ads entity");
17
45
  export const CreateEntityOutputSchema = z
@@ -19,18 +47,50 @@ export const CreateEntityOutputSchema = z
19
47
  result: z.record(z.any()).describe("API response with created entity IDs"),
20
48
  entityType: z.string(),
21
49
  timestamp: z.string().datetime(),
50
+ dryRun: DryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entity was created."),
51
+ 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`."),
52
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to. Present on every response."),
22
53
  })
23
54
  .describe("Entity creation result");
24
55
  export async function createEntityLogic(input, context, sdkContext) {
25
56
  const { msadsService } = resolveSessionServices(sdkContext);
57
+ const dispatchedCapability = resolveMsAdsCreateCapability(input.entityType);
58
+ const entityItem = unwrapEntityItem(input.entityType, input.data);
59
+ if (input.dry_run === true) {
60
+ const dryRun = await runMsAdsCreateDryRun({ entityType: input.entityType, data: entityItem }, msadsService, context);
61
+ return {
62
+ result: {},
63
+ entityType: input.entityType,
64
+ timestamp: new Date().toISOString(),
65
+ dryRun,
66
+ dispatchedCapability,
67
+ };
68
+ }
26
69
  const result = (await msadsService.createEntity(input.entityType, input.data, context));
70
+ const createdId = extractCreatedId(result);
71
+ const after = snapshotFromMsAdsEntity(input.entityType, createdId, entityItem);
27
72
  return {
28
73
  result,
29
74
  entityType: input.entityType,
30
75
  timestamp: new Date().toISOString(),
76
+ ...(after ? { after } : {}),
77
+ dispatchedCapability,
31
78
  };
32
79
  }
33
80
  export function createEntityResponseFormatter(result) {
81
+ if (result.dryRun) {
82
+ const { wouldSucceed, validationErrors, validationSource, expectedStateSource } = result.dryRun;
83
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
84
+ const errorLines = validationErrors.length
85
+ ? "\n" + validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n")
86
+ : "";
87
+ return [
88
+ {
89
+ type: "text",
90
+ text: `Dry run: creating ${result.entityType} ${verdict} (validation: ${validationSource}, expected-state: ${expectedStateSource}). No entity was created.${errorLines}\n\nTimestamp: ${result.timestamp}`,
91
+ },
92
+ ];
93
+ }
34
94
  return [
35
95
  {
36
96
  type: "text",
@@ -49,6 +109,27 @@ export const createEntityTool = {
49
109
  openWorldHint: false,
50
110
  idempotentHint: false,
51
111
  destructiveHint: false,
112
+ cesteral: {
113
+ kind: "write",
114
+ writeClass: "entity",
115
+ executableArgsExclude: ["dry_run"],
116
+ platform: "msads",
117
+ contractPlatformSlug: "msads",
118
+ contractToolSlug: "create_entity",
119
+ operation: ["create"],
120
+ entityKinds: ["campaign", "ad_group", "ad", "campaign_budget"],
121
+ entityIdArgs: [],
122
+ readPartner: {
123
+ toolName: "msads_get_entity",
124
+ argMap: {},
125
+ },
126
+ schemaVersion: 1,
127
+ contractId: "msads.create_entity.v1",
128
+ supportsDryRun: true,
129
+ supportsBeforeAfterSnapshot: true,
130
+ requiresValidation: true,
131
+ requiresSimulation: true,
132
+ },
52
133
  },
53
134
  inputExamples: [
54
135
  {
@@ -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,5 +1,5 @@
1
1
  import { z } from "zod";
2
- import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
2
+ import type { RequestContext, McpTextContent, SdkContext, EffectResult, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
3
3
  export declare const CreateReportScheduleInputSchema: z.ZodObject<{
4
4
  accountId: z.ZodString;
5
5
  scheduleName: z.ZodString;
@@ -21,10 +21,12 @@ export declare const CreateReportScheduleInputSchema: z.ZodObject<{
21
21
  Frequency: "Daily" | "Weekly" | "Monthly";
22
22
  EndDate?: string | undefined;
23
23
  }>;
24
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
24
25
  }, "strip", z.ZodTypeAny, {
25
26
  accountId: string;
26
27
  reportType: string;
27
28
  scheduleName: string;
29
+ dry_run: boolean;
28
30
  columns: string[];
29
31
  startDate: string;
30
32
  endDate: string;
@@ -46,20 +48,30 @@ export declare const CreateReportScheduleInputSchema: z.ZodObject<{
46
48
  Frequency: "Daily" | "Weekly" | "Monthly";
47
49
  EndDate?: string | undefined;
48
50
  };
51
+ dry_run?: boolean | undefined;
49
52
  aggregation?: string | undefined;
50
53
  }>;
51
54
  export declare const CreateReportScheduleOutputSchema: z.ZodObject<{
52
- scheduleId: z.ZodString;
53
- scheduleName: z.ZodString;
55
+ scheduleId: z.ZodOptional<z.ZodString>;
56
+ scheduleName: z.ZodOptional<z.ZodString>;
54
57
  timestamp: z.ZodString;
58
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
59
+ effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
60
+ dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
55
61
  }, "strip", z.ZodTypeAny, {
56
- scheduleName: string;
57
- scheduleId: string;
58
62
  timestamp: string;
63
+ dispatchedCapability: DispatchedCapability;
64
+ scheduleName?: string | undefined;
65
+ scheduleId?: string | undefined;
66
+ dryRun?: EffectDryRunResult | undefined;
67
+ effect?: EffectResult | undefined;
59
68
  }, {
60
- scheduleName: string;
61
- scheduleId: string;
62
69
  timestamp: string;
70
+ dispatchedCapability: DispatchedCapability;
71
+ scheduleName?: string | undefined;
72
+ scheduleId?: string | undefined;
73
+ dryRun?: EffectDryRunResult | undefined;
74
+ effect?: EffectResult | undefined;
63
75
  }>;
64
76
  type CreateReportScheduleInput = z.infer<typeof CreateReportScheduleInputSchema>;
65
77
  type CreateReportScheduleOutput = z.infer<typeof CreateReportScheduleOutputSchema>;
@@ -90,10 +102,12 @@ export declare const createReportScheduleTool: {
90
102
  Frequency: "Daily" | "Weekly" | "Monthly";
91
103
  EndDate?: string | undefined;
92
104
  }>;
105
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
93
106
  }, "strip", z.ZodTypeAny, {
94
107
  accountId: string;
95
108
  reportType: string;
96
109
  scheduleName: string;
110
+ dry_run: boolean;
97
111
  columns: string[];
98
112
  startDate: string;
99
113
  endDate: string;
@@ -115,26 +129,53 @@ export declare const createReportScheduleTool: {
115
129
  Frequency: "Daily" | "Weekly" | "Monthly";
116
130
  EndDate?: string | undefined;
117
131
  };
132
+ dry_run?: boolean | undefined;
118
133
  aggregation?: string | undefined;
119
134
  }>;
120
135
  outputSchema: z.ZodObject<{
121
- scheduleId: z.ZodString;
122
- scheduleName: z.ZodString;
136
+ scheduleId: z.ZodOptional<z.ZodString>;
137
+ scheduleName: z.ZodOptional<z.ZodString>;
123
138
  timestamp: z.ZodString;
139
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
140
+ effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
141
+ dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
124
142
  }, "strip", z.ZodTypeAny, {
125
- scheduleName: string;
126
- scheduleId: string;
127
143
  timestamp: string;
144
+ dispatchedCapability: DispatchedCapability;
145
+ scheduleName?: string | undefined;
146
+ scheduleId?: string | undefined;
147
+ dryRun?: EffectDryRunResult | undefined;
148
+ effect?: EffectResult | undefined;
128
149
  }, {
129
- scheduleName: string;
130
- scheduleId: string;
131
150
  timestamp: string;
151
+ dispatchedCapability: DispatchedCapability;
152
+ scheduleName?: string | undefined;
153
+ scheduleId?: string | undefined;
154
+ dryRun?: EffectDryRunResult | undefined;
155
+ effect?: EffectResult | undefined;
132
156
  }>;
133
157
  annotations: {
134
158
  readOnlyHint: boolean;
135
159
  openWorldHint: boolean;
136
160
  destructiveHint: boolean;
137
161
  idempotentHint: boolean;
162
+ cesteral: {
163
+ kind: "write";
164
+ writeClass: "effect";
165
+ executableArgsExclude: string[];
166
+ platform: string;
167
+ contractPlatformSlug: string;
168
+ contractToolSlug: string;
169
+ operation: "create_schedule"[];
170
+ entityKinds: never[];
171
+ entityIdArgs: never[];
172
+ schemaVersion: number;
173
+ contractId: string;
174
+ supportsDryRun: true;
175
+ supportsBeforeAfterSnapshot: false;
176
+ requiresValidation: true;
177
+ requiresSimulation: true;
178
+ };
138
179
  };
139
180
  inputExamples: {
140
181
  label: string;
@@ -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;AAQxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAwB1B,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B2B,CAAC;AAExE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;EAoBP,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,CA8CrC;AA6DD,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAsBlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDpC,CAAC"}