@cesteral/msads-mcp 1.2.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.
- package/dist/cesteral-manifest.json +87 -3
- package/dist/mcp-server/server.d.ts.map +1 -1
- package/dist/mcp-server/server.js +2 -1
- package/dist/mcp-server/server.js.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +89 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +96 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +101 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +4 -4
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +46 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +82 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +54 -13
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +109 -2
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +48 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +123 -4
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +48 -7
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +75 -4
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +8 -8
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +48 -7
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +63 -2
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +48 -7
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +63 -2
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +52 -11
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +64 -2
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +52 -7
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +96 -2
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +26 -1608
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +2 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.d.ts +6 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.js +27 -0
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.js +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
- package/dist/testkit/fixtures/index.d.ts +4 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -1
- package/dist/testkit/fixtures/index.js +102 -0
- package/dist/testkit/fixtures/index.js.map +1 -1
- package/dist/testkit/types.d.ts +2 -2
- package/dist/testkit/types.d.ts.map +1 -1
- package/package.json +2 -2
|
@@ -1,15 +1,22 @@
|
|
|
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 { assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
4
5
|
const TOOL_NAME = "msads_bulk_create_entities";
|
|
5
6
|
const TOOL_TITLE = "Bulk Create Microsoft Ads Entities";
|
|
6
7
|
const TOOL_DESCRIPTION = `Batch create multiple Microsoft Advertising entities in a single operation.
|
|
7
8
|
|
|
8
9
|
Items are automatically batched per entity type limits. Each batch is sent as a separate API call.`;
|
|
10
|
+
const EFFECT_KIND = "entities_created";
|
|
9
11
|
export const BulkCreateEntitiesInputSchema = z
|
|
10
12
|
.object({
|
|
11
13
|
entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to create"),
|
|
12
14
|
items: z.array(z.record(z.unknown())).min(1).describe("Array of entity data objects to create"),
|
|
15
|
+
dry_run: z
|
|
16
|
+
.boolean()
|
|
17
|
+
.optional()
|
|
18
|
+
.default(false)
|
|
19
|
+
.describe("When true, symbolically validates the batch and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bulk create) without calling the Microsoft Ads API. No entities are created."),
|
|
13
20
|
})
|
|
14
21
|
.describe("Parameters for bulk creating Microsoft Ads entities");
|
|
15
22
|
export const BulkCreateEntitiesOutputSchema = z
|
|
@@ -18,19 +25,80 @@ export const BulkCreateEntitiesOutputSchema = z
|
|
|
18
25
|
entityType: z.string(),
|
|
19
26
|
totalItems: z.number(),
|
|
20
27
|
timestamp: z.string().datetime(),
|
|
28
|
+
dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were created."),
|
|
29
|
+
effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `entities_created` + scalar batch audit summary). Present on a confirmed execute. A bulk write is governed as a single batch effect — it carries no per-entity canonical snapshot."),
|
|
30
|
+
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."),
|
|
21
31
|
})
|
|
22
32
|
.describe("Bulk creation result");
|
|
23
33
|
export async function bulkCreateEntitiesLogic(input, context, sdkContext) {
|
|
34
|
+
const dispatchedCapability = {
|
|
35
|
+
operation: "bulk_job",
|
|
36
|
+
canonicalEntityKind: null,
|
|
37
|
+
};
|
|
38
|
+
if (input.dry_run === true) {
|
|
39
|
+
const dryRun = buildBulkEffectDryRun(input);
|
|
40
|
+
return {
|
|
41
|
+
results: [],
|
|
42
|
+
entityType: input.entityType,
|
|
43
|
+
totalItems: 0,
|
|
44
|
+
timestamp: new Date().toISOString(),
|
|
45
|
+
dryRun,
|
|
46
|
+
dispatchedCapability,
|
|
47
|
+
};
|
|
48
|
+
}
|
|
24
49
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
25
50
|
const results = await msadsService.bulkCreateEntities(input.entityType, input.items, context);
|
|
51
|
+
const effect = {
|
|
52
|
+
effectKind: EFFECT_KIND,
|
|
53
|
+
summary: { entity_kind: input.entityType, requested: input.items.length },
|
|
54
|
+
};
|
|
26
55
|
return {
|
|
27
56
|
results: results,
|
|
28
57
|
entityType: input.entityType,
|
|
29
58
|
totalItems: input.items.length,
|
|
30
59
|
timestamp: new Date().toISOString(),
|
|
60
|
+
effect,
|
|
61
|
+
dispatchedCapability,
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
function buildBulkEffectDryRun(input) {
|
|
65
|
+
const validationErrors = [];
|
|
66
|
+
input.items.forEach((item, i) => {
|
|
67
|
+
if (!item || typeof item !== "object" || Object.keys(item).length === 0) {
|
|
68
|
+
validationErrors.push({
|
|
69
|
+
code: "EMPTY_ITEM",
|
|
70
|
+
message: `items[${i}] must be a non-empty entity object`,
|
|
71
|
+
field: `items.${i}`,
|
|
72
|
+
});
|
|
73
|
+
}
|
|
74
|
+
});
|
|
75
|
+
const expectedEffect = {
|
|
76
|
+
effectKind: EFFECT_KIND,
|
|
77
|
+
summary: { entity_kind: input.entityType, requested: input.items.length },
|
|
31
78
|
};
|
|
79
|
+
return assertGovernedEffectDryRun({
|
|
80
|
+
wouldSucceed: validationErrors.length === 0,
|
|
81
|
+
validationErrors,
|
|
82
|
+
validationSource: "symbolic",
|
|
83
|
+
expectedEffectSource: "symbolic",
|
|
84
|
+
expectedEffect,
|
|
85
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
|
|
32
86
|
}
|
|
33
87
|
export function bulkCreateEntitiesResponseFormatter(result) {
|
|
88
|
+
if (result.dryRun) {
|
|
89
|
+
const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
|
|
90
|
+
const verdict = wouldSucceed ? "would succeed" : "would FAIL";
|
|
91
|
+
const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
|
|
92
|
+
const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
|
|
93
|
+
return [
|
|
94
|
+
{
|
|
95
|
+
type: "text",
|
|
96
|
+
text: `Dry run: bulk-creating ${String(n)} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were created.` +
|
|
97
|
+
(errs ? `\n${errs}` : "") +
|
|
98
|
+
`\n\nTimestamp: ${result.timestamp}`,
|
|
99
|
+
},
|
|
100
|
+
];
|
|
101
|
+
}
|
|
34
102
|
return [
|
|
35
103
|
{
|
|
36
104
|
type: "text",
|
|
@@ -49,6 +117,23 @@ export const bulkCreateEntitiesTool = {
|
|
|
49
117
|
openWorldHint: false,
|
|
50
118
|
idempotentHint: false,
|
|
51
119
|
destructiveHint: false,
|
|
120
|
+
cesteral: {
|
|
121
|
+
kind: "write",
|
|
122
|
+
writeClass: "effect",
|
|
123
|
+
executableArgsExclude: ["dry_run"],
|
|
124
|
+
platform: "msads",
|
|
125
|
+
contractPlatformSlug: "msads",
|
|
126
|
+
contractToolSlug: "bulk_create_entities",
|
|
127
|
+
operation: ["bulk_job"],
|
|
128
|
+
entityKinds: [],
|
|
129
|
+
entityIdArgs: [],
|
|
130
|
+
schemaVersion: 1,
|
|
131
|
+
contractId: "msads.bulk_create_entities.v1",
|
|
132
|
+
supportsDryRun: true,
|
|
133
|
+
supportsBeforeAfterSnapshot: false,
|
|
134
|
+
requiresValidation: true,
|
|
135
|
+
requiresSimulation: true,
|
|
136
|
+
},
|
|
52
137
|
},
|
|
53
138
|
inputExamples: [
|
|
54
139
|
{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk-create-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.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;
|
|
1
|
+
{"version":3,"file":"bulk-create-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,14 +1,17 @@
|
|
|
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 BulkUpdateEntitiesInputSchema: z.ZodObject<{
|
|
4
4
|
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
5
5
|
items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
|
|
6
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
6
7
|
}, "strip", z.ZodTypeAny, {
|
|
7
8
|
entityType: string;
|
|
9
|
+
dry_run: boolean;
|
|
8
10
|
items: Record<string, unknown>[];
|
|
9
11
|
}, {
|
|
10
12
|
entityType: string;
|
|
11
13
|
items: Record<string, unknown>[];
|
|
14
|
+
dry_run?: boolean | undefined;
|
|
12
15
|
}>;
|
|
13
16
|
export declare const BulkUpdateEntitiesOutputSchema: z.ZodObject<{
|
|
14
17
|
confirmed: z.ZodBoolean;
|
|
@@ -17,19 +20,28 @@ export declare const BulkUpdateEntitiesOutputSchema: z.ZodObject<{
|
|
|
17
20
|
entityType: z.ZodString;
|
|
18
21
|
totalItems: z.ZodNumber;
|
|
19
22
|
timestamp: z.ZodString;
|
|
23
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
|
|
24
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
25
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
20
26
|
}, "strip", z.ZodTypeAny, {
|
|
21
27
|
entityType: string;
|
|
22
28
|
results: Record<string, any>[];
|
|
23
29
|
timestamp: string;
|
|
30
|
+
dispatchedCapability: DispatchedCapability;
|
|
24
31
|
confirmed: boolean;
|
|
25
32
|
totalItems: number;
|
|
33
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
34
|
+
effect?: EffectResult | undefined;
|
|
26
35
|
declineReason?: string | undefined;
|
|
27
36
|
}, {
|
|
28
37
|
entityType: string;
|
|
29
38
|
results: Record<string, any>[];
|
|
30
39
|
timestamp: string;
|
|
40
|
+
dispatchedCapability: DispatchedCapability;
|
|
31
41
|
confirmed: boolean;
|
|
32
42
|
totalItems: number;
|
|
43
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
44
|
+
effect?: EffectResult | undefined;
|
|
33
45
|
declineReason?: string | undefined;
|
|
34
46
|
}>;
|
|
35
47
|
type BulkUpdateEntitiesInput = z.infer<typeof BulkUpdateEntitiesInputSchema>;
|
|
@@ -43,12 +55,15 @@ export declare const bulkUpdateEntitiesTool: {
|
|
|
43
55
|
inputSchema: z.ZodObject<{
|
|
44
56
|
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
45
57
|
items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
|
|
58
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
46
59
|
}, "strip", z.ZodTypeAny, {
|
|
47
60
|
entityType: string;
|
|
61
|
+
dry_run: boolean;
|
|
48
62
|
items: Record<string, unknown>[];
|
|
49
63
|
}, {
|
|
50
64
|
entityType: string;
|
|
51
65
|
items: Record<string, unknown>[];
|
|
66
|
+
dry_run?: boolean | undefined;
|
|
52
67
|
}>;
|
|
53
68
|
outputSchema: z.ZodObject<{
|
|
54
69
|
confirmed: z.ZodBoolean;
|
|
@@ -57,19 +72,28 @@ export declare const bulkUpdateEntitiesTool: {
|
|
|
57
72
|
entityType: z.ZodString;
|
|
58
73
|
totalItems: z.ZodNumber;
|
|
59
74
|
timestamp: z.ZodString;
|
|
75
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
|
|
76
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
77
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
60
78
|
}, "strip", z.ZodTypeAny, {
|
|
61
79
|
entityType: string;
|
|
62
80
|
results: Record<string, any>[];
|
|
63
81
|
timestamp: string;
|
|
82
|
+
dispatchedCapability: DispatchedCapability;
|
|
64
83
|
confirmed: boolean;
|
|
65
84
|
totalItems: number;
|
|
85
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
86
|
+
effect?: EffectResult | undefined;
|
|
66
87
|
declineReason?: string | undefined;
|
|
67
88
|
}, {
|
|
68
89
|
entityType: string;
|
|
69
90
|
results: Record<string, any>[];
|
|
70
91
|
timestamp: string;
|
|
92
|
+
dispatchedCapability: DispatchedCapability;
|
|
71
93
|
confirmed: boolean;
|
|
72
94
|
totalItems: number;
|
|
95
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
96
|
+
effect?: EffectResult | undefined;
|
|
73
97
|
declineReason?: string | undefined;
|
|
74
98
|
}>;
|
|
75
99
|
annotations: {
|
|
@@ -77,6 +101,23 @@ export declare const bulkUpdateEntitiesTool: {
|
|
|
77
101
|
openWorldHint: boolean;
|
|
78
102
|
idempotentHint: boolean;
|
|
79
103
|
destructiveHint: boolean;
|
|
104
|
+
cesteral: {
|
|
105
|
+
kind: "write";
|
|
106
|
+
writeClass: "effect";
|
|
107
|
+
executableArgsExclude: string[];
|
|
108
|
+
platform: string;
|
|
109
|
+
contractPlatformSlug: string;
|
|
110
|
+
contractToolSlug: string;
|
|
111
|
+
operation: "bulk_job"[];
|
|
112
|
+
entityKinds: never[];
|
|
113
|
+
entityIdArgs: never[];
|
|
114
|
+
schemaVersion: number;
|
|
115
|
+
contractId: string;
|
|
116
|
+
supportsDryRun: true;
|
|
117
|
+
supportsBeforeAfterSnapshot: false;
|
|
118
|
+
requiresValidation: true;
|
|
119
|
+
requiresSimulation: true;
|
|
120
|
+
};
|
|
80
121
|
};
|
|
81
122
|
inputExamples: {
|
|
82
123
|
label: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk-update-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"bulk-update-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAU1B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAewB,CAAC;AAEnE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBV,CAAC;AAElC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAuEnC;AA+CD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CA+BlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6ClC,CAAC"}
|
|
@@ -1,12 +1,13 @@
|
|
|
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 { elicitBulkMutationConfirmation, hasSensitiveBulkField } from "@cesteral/shared";
|
|
4
|
+
import { elicitBulkMutationConfirmation, hasSensitiveBulkField, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
5
5
|
const TOOL_NAME = "msads_bulk_update_entities";
|
|
6
6
|
const TOOL_TITLE = "Bulk Update Microsoft Ads Entities";
|
|
7
7
|
const TOOL_DESCRIPTION = `Batch update multiple Microsoft Advertising entities.
|
|
8
8
|
|
|
9
9
|
Each item must include the Id field. Only include fields you want to change.`;
|
|
10
|
+
const EFFECT_KIND = "entities_updated";
|
|
10
11
|
export const BulkUpdateEntitiesInputSchema = z
|
|
11
12
|
.object({
|
|
12
13
|
entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
|
|
@@ -14,6 +15,11 @@ export const BulkUpdateEntitiesInputSchema = z
|
|
|
14
15
|
.array(z.record(z.unknown()))
|
|
15
16
|
.min(1)
|
|
16
17
|
.describe("Array of entity data objects with Id and fields to update"),
|
|
18
|
+
dry_run: z
|
|
19
|
+
.boolean()
|
|
20
|
+
.optional()
|
|
21
|
+
.default(false)
|
|
22
|
+
.describe("When true, symbolically validates the batch and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bulk update) without prompting for confirmation or calling the Microsoft Ads API. No entities are updated."),
|
|
17
23
|
})
|
|
18
24
|
.describe("Parameters for bulk updating Microsoft Ads entities");
|
|
19
25
|
export const BulkUpdateEntitiesOutputSchema = z
|
|
@@ -24,9 +30,28 @@ export const BulkUpdateEntitiesOutputSchema = z
|
|
|
24
30
|
entityType: z.string(),
|
|
25
31
|
totalItems: z.number(),
|
|
26
32
|
timestamp: z.string().datetime(),
|
|
33
|
+
dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were updated."),
|
|
34
|
+
effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `entities_updated` + scalar batch audit summary). Present on a confirmed execute. A bulk write is governed as a single batch effect — it carries no per-entity canonical snapshot."),
|
|
35
|
+
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."),
|
|
27
36
|
})
|
|
28
37
|
.describe("Bulk update result");
|
|
29
38
|
export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
|
|
39
|
+
const dispatchedCapability = {
|
|
40
|
+
operation: "bulk_job",
|
|
41
|
+
canonicalEntityKind: null,
|
|
42
|
+
};
|
|
43
|
+
if (input.dry_run === true) {
|
|
44
|
+
const dryRun = buildBulkEffectDryRun(input);
|
|
45
|
+
return {
|
|
46
|
+
confirmed: true,
|
|
47
|
+
results: [],
|
|
48
|
+
entityType: input.entityType,
|
|
49
|
+
totalItems: 0,
|
|
50
|
+
timestamp: new Date().toISOString(),
|
|
51
|
+
dryRun,
|
|
52
|
+
dispatchedCapability,
|
|
53
|
+
};
|
|
54
|
+
}
|
|
30
55
|
const items = input.items;
|
|
31
56
|
const confirmed = await elicitBulkMutationConfirmation({
|
|
32
57
|
count: items.length,
|
|
@@ -44,19 +69,72 @@ export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
|
|
|
44
69
|
entityType: input.entityType,
|
|
45
70
|
totalItems: items.length,
|
|
46
71
|
timestamp: new Date().toISOString(),
|
|
72
|
+
dispatchedCapability,
|
|
47
73
|
};
|
|
48
74
|
}
|
|
49
75
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
50
76
|
const results = await msadsService.bulkUpdateEntities(input.entityType, input.items, context);
|
|
77
|
+
const effect = {
|
|
78
|
+
effectKind: EFFECT_KIND,
|
|
79
|
+
summary: { entity_kind: input.entityType, requested: input.items.length },
|
|
80
|
+
};
|
|
51
81
|
return {
|
|
52
82
|
confirmed: true,
|
|
53
83
|
results: results,
|
|
54
84
|
entityType: input.entityType,
|
|
55
85
|
totalItems: input.items.length,
|
|
56
86
|
timestamp: new Date().toISOString(),
|
|
87
|
+
effect,
|
|
88
|
+
dispatchedCapability,
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
function buildBulkEffectDryRun(input) {
|
|
92
|
+
const validationErrors = [];
|
|
93
|
+
input.items.forEach((item, i) => {
|
|
94
|
+
if (!item || typeof item !== "object" || Object.keys(item).length === 0) {
|
|
95
|
+
validationErrors.push({
|
|
96
|
+
code: "EMPTY_UPDATE",
|
|
97
|
+
message: `items[${i}] must be a non-empty entity record`,
|
|
98
|
+
field: `items.${i}`,
|
|
99
|
+
});
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
const id = item.Id ?? item.id;
|
|
103
|
+
if (id === undefined || id === null || String(id).trim().length === 0) {
|
|
104
|
+
validationErrors.push({
|
|
105
|
+
code: "MISSING_ID",
|
|
106
|
+
message: `items[${i}] must include an Id to target for update`,
|
|
107
|
+
field: `items.${i}.Id`,
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
});
|
|
111
|
+
const expectedEffect = {
|
|
112
|
+
effectKind: EFFECT_KIND,
|
|
113
|
+
summary: { entity_kind: input.entityType, requested: input.items.length },
|
|
57
114
|
};
|
|
115
|
+
return assertGovernedEffectDryRun({
|
|
116
|
+
wouldSucceed: validationErrors.length === 0,
|
|
117
|
+
validationErrors,
|
|
118
|
+
validationSource: "symbolic",
|
|
119
|
+
expectedEffectSource: "symbolic",
|
|
120
|
+
expectedEffect,
|
|
121
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
|
|
58
122
|
}
|
|
59
123
|
export function bulkUpdateEntitiesResponseFormatter(result) {
|
|
124
|
+
if (result.dryRun) {
|
|
125
|
+
const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
|
|
126
|
+
const verdict = wouldSucceed ? "would succeed" : "would FAIL";
|
|
127
|
+
const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
|
|
128
|
+
const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
|
|
129
|
+
return [
|
|
130
|
+
{
|
|
131
|
+
type: "text",
|
|
132
|
+
text: `Dry run: bulk-updating ${String(n)} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were updated.` +
|
|
133
|
+
(errs ? `\n${errs}` : "") +
|
|
134
|
+
`\n\nTimestamp: ${result.timestamp}`,
|
|
135
|
+
},
|
|
136
|
+
];
|
|
137
|
+
}
|
|
60
138
|
if (!result.confirmed) {
|
|
61
139
|
return [
|
|
62
140
|
{
|
|
@@ -83,6 +161,23 @@ export const bulkUpdateEntitiesTool = {
|
|
|
83
161
|
openWorldHint: false,
|
|
84
162
|
idempotentHint: true,
|
|
85
163
|
destructiveHint: false,
|
|
164
|
+
cesteral: {
|
|
165
|
+
kind: "write",
|
|
166
|
+
writeClass: "effect",
|
|
167
|
+
executableArgsExclude: ["dry_run"],
|
|
168
|
+
platform: "msads",
|
|
169
|
+
contractPlatformSlug: "msads",
|
|
170
|
+
contractToolSlug: "bulk_update_entities",
|
|
171
|
+
operation: ["bulk_job"],
|
|
172
|
+
entityKinds: [],
|
|
173
|
+
entityIdArgs: [],
|
|
174
|
+
schemaVersion: 1,
|
|
175
|
+
contractId: "msads.bulk_update_entities.v1",
|
|
176
|
+
supportsDryRun: true,
|
|
177
|
+
supportsBeforeAfterSnapshot: false,
|
|
178
|
+
requiresValidation: true,
|
|
179
|
+
requiresSimulation: true,
|
|
180
|
+
},
|
|
86
181
|
},
|
|
87
182
|
inputExamples: [
|
|
88
183
|
{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk-update-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.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;AACrF,OAAO,
|
|
1
|
+
{"version":3,"file":"bulk-update-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-entities.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,17 +1,20 @@
|
|
|
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 BulkUpdateStatusInputSchema: z.ZodObject<{
|
|
4
4
|
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
5
5
|
entityIds: z.ZodArray<z.ZodString, "many">;
|
|
6
6
|
status: z.ZodString;
|
|
7
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
7
8
|
}, "strip", z.ZodTypeAny, {
|
|
8
9
|
status: string;
|
|
9
10
|
entityType: string;
|
|
10
11
|
entityIds: string[];
|
|
12
|
+
dry_run: boolean;
|
|
11
13
|
}, {
|
|
12
14
|
status: string;
|
|
13
15
|
entityType: string;
|
|
14
16
|
entityIds: string[];
|
|
17
|
+
dry_run?: boolean | undefined;
|
|
15
18
|
}>;
|
|
16
19
|
export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
|
|
17
20
|
confirmed: z.ZodBoolean;
|
|
@@ -34,6 +37,9 @@ export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
|
|
|
34
37
|
failureCount: z.ZodNumber;
|
|
35
38
|
status: z.ZodString;
|
|
36
39
|
timestamp: z.ZodString;
|
|
40
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
|
|
41
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
42
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
37
43
|
}, "strip", z.ZodTypeAny, {
|
|
38
44
|
status: string;
|
|
39
45
|
entityType: string;
|
|
@@ -43,9 +49,12 @@ export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
|
|
|
43
49
|
error?: string | undefined;
|
|
44
50
|
}[];
|
|
45
51
|
timestamp: string;
|
|
52
|
+
dispatchedCapability: DispatchedCapability;
|
|
46
53
|
confirmed: boolean;
|
|
47
54
|
successCount: number;
|
|
48
55
|
failureCount: number;
|
|
56
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
57
|
+
effect?: EffectResult | undefined;
|
|
49
58
|
declineReason?: string | undefined;
|
|
50
59
|
}, {
|
|
51
60
|
status: string;
|
|
@@ -56,9 +65,12 @@ export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
|
|
|
56
65
|
error?: string | undefined;
|
|
57
66
|
}[];
|
|
58
67
|
timestamp: string;
|
|
68
|
+
dispatchedCapability: DispatchedCapability;
|
|
59
69
|
confirmed: boolean;
|
|
60
70
|
successCount: number;
|
|
61
71
|
failureCount: number;
|
|
72
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
73
|
+
effect?: EffectResult | undefined;
|
|
62
74
|
declineReason?: string | undefined;
|
|
63
75
|
}>;
|
|
64
76
|
type BulkUpdateStatusInput = z.infer<typeof BulkUpdateStatusInputSchema>;
|
|
@@ -73,14 +85,17 @@ export declare const bulkUpdateStatusTool: {
|
|
|
73
85
|
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
74
86
|
entityIds: z.ZodArray<z.ZodString, "many">;
|
|
75
87
|
status: z.ZodString;
|
|
88
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
76
89
|
}, "strip", z.ZodTypeAny, {
|
|
77
90
|
status: string;
|
|
78
91
|
entityType: string;
|
|
79
92
|
entityIds: string[];
|
|
93
|
+
dry_run: boolean;
|
|
80
94
|
}, {
|
|
81
95
|
status: string;
|
|
82
96
|
entityType: string;
|
|
83
97
|
entityIds: string[];
|
|
98
|
+
dry_run?: boolean | undefined;
|
|
84
99
|
}>;
|
|
85
100
|
outputSchema: z.ZodObject<{
|
|
86
101
|
confirmed: z.ZodBoolean;
|
|
@@ -103,6 +118,9 @@ export declare const bulkUpdateStatusTool: {
|
|
|
103
118
|
failureCount: z.ZodNumber;
|
|
104
119
|
status: z.ZodString;
|
|
105
120
|
timestamp: z.ZodString;
|
|
121
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
|
|
122
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
123
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
106
124
|
}, "strip", z.ZodTypeAny, {
|
|
107
125
|
status: string;
|
|
108
126
|
entityType: string;
|
|
@@ -112,9 +130,12 @@ export declare const bulkUpdateStatusTool: {
|
|
|
112
130
|
error?: string | undefined;
|
|
113
131
|
}[];
|
|
114
132
|
timestamp: string;
|
|
133
|
+
dispatchedCapability: DispatchedCapability;
|
|
115
134
|
confirmed: boolean;
|
|
116
135
|
successCount: number;
|
|
117
136
|
failureCount: number;
|
|
137
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
138
|
+
effect?: EffectResult | undefined;
|
|
118
139
|
declineReason?: string | undefined;
|
|
119
140
|
}, {
|
|
120
141
|
status: string;
|
|
@@ -125,9 +146,12 @@ export declare const bulkUpdateStatusTool: {
|
|
|
125
146
|
error?: string | undefined;
|
|
126
147
|
}[];
|
|
127
148
|
timestamp: string;
|
|
149
|
+
dispatchedCapability: DispatchedCapability;
|
|
128
150
|
confirmed: boolean;
|
|
129
151
|
successCount: number;
|
|
130
152
|
failureCount: number;
|
|
153
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
154
|
+
effect?: EffectResult | undefined;
|
|
131
155
|
declineReason?: string | undefined;
|
|
132
156
|
}>;
|
|
133
157
|
annotations: {
|
|
@@ -135,6 +159,23 @@ export declare const bulkUpdateStatusTool: {
|
|
|
135
159
|
openWorldHint: boolean;
|
|
136
160
|
idempotentHint: boolean;
|
|
137
161
|
destructiveHint: boolean;
|
|
162
|
+
cesteral: {
|
|
163
|
+
kind: "write";
|
|
164
|
+
writeClass: "effect";
|
|
165
|
+
executableArgsExclude: string[];
|
|
166
|
+
platform: string;
|
|
167
|
+
contractPlatformSlug: string;
|
|
168
|
+
contractToolSlug: string;
|
|
169
|
+
operation: "bulk_job"[];
|
|
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":"bulk-update-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"bulk-update-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAS1B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAaQ,CAAC;AAEjD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BwB,CAAC;AAElE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACzE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAkFjC;AA0CD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAsClB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ChC,CAAC"}
|