@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.
- package/README.md +44 -30
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
- package/dist/auth/msads-auth-adapter.js +1 -1
- package/dist/auth/msads-auth-adapter.js.map +1 -1
- package/dist/cesteral-manifest.json +140 -4
- package/dist/config/index.d.ts +36 -67
- package/dist/config/index.d.ts.map +1 -1
- package/dist/index.js +13 -23
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.d.ts +1 -1
- package/dist/mcp-server/prompts/index.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.js +15 -0
- package/dist/mcp-server/prompts/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/index.js +10 -9
- package/dist/mcp-server/resources/definitions/index.js.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.js +11 -11
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
- package/dist/mcp-server/server.d.ts +2 -1
- package/dist/mcp-server/server.d.ts.map +1 -1
- package/dist/mcp-server/server.js +29 -99
- package/dist/mcp-server/server.js.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +46 -111
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +158 -15
- 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 +51 -44
- 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 +125 -9
- 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 +51 -51
- 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 +132 -7
- 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 +65 -97
- 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 +128 -7
- 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 +24 -62
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +47 -35
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +99 -3
- 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 +51 -100
- 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 +113 -33
- 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 +47 -53
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +129 -8
- 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 +34 -40
- 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 +79 -25
- 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 +84 -214
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +49 -38
- 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 +101 -10
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/index.js +6 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +46 -37
- 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 +106 -6
- 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 +58 -47
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +111 -8
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +57 -89
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +97 -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 +39 -1907
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +74 -85
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/index.d.ts +4 -1
- package/dist/mcp-server/tools/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/index.js +7 -1
- package/dist/mcp-server/tools/index.js.map +1 -1
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.d.ts +17 -2
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.js +71 -6
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
- package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
- package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
- package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
- package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.js +16 -51
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
- package/dist/services/msads/msads-http-client.d.ts +5 -1
- package/dist/services/msads/msads-http-client.d.ts.map +1 -1
- package/dist/services/msads/msads-http-client.js +49 -2
- package/dist/services/msads/msads-http-client.js.map +1 -1
- package/dist/services/msads/msads-reporting-service.d.ts +3 -9
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
- package/dist/services/msads/msads-reporting-service.js +62 -27
- package/dist/services/msads/msads-reporting-service.js.map +1 -1
- package/dist/services/msads/msads-service.d.ts +53 -5
- package/dist/services/msads/msads-service.d.ts.map +1 -1
- package/dist/services/msads/msads-service.js +235 -35
- package/dist/services/msads/msads-service.js.map +1 -1
- package/dist/services/msads/partial-errors.d.ts +34 -0
- package/dist/services/msads/partial-errors.d.ts.map +1 -0
- package/dist/services/msads/partial-errors.js +149 -0
- package/dist/services/msads/partial-errors.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +8 -2
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
- package/dist/services/msads/rate-limit-keys.js +16 -2
- package/dist/services/msads/rate-limit-keys.js.map +1 -1
- package/dist/services/msads/types.d.ts +1 -2
- package/dist/services/msads/types.d.ts.map +1 -1
- package/dist/services/msads/types.js.map +1 -1
- package/dist/services/session-services.d.ts +2 -2
- package/dist/services/session-services.d.ts.map +1 -1
- package/dist/services/session-services.js +10 -10
- package/dist/services/session-services.js.map +1 -1
- package/dist/services/session-wiring.d.ts +7 -0
- package/dist/services/session-wiring.d.ts.map +1 -0
- package/dist/services/session-wiring.js +20 -0
- package/dist/services/session-wiring.js.map +1 -0
- 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 +105 -3
- 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 +8 -8
|
@@ -1,40 +1,137 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
+
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
2
3
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
4
|
+
import { assertMsAdsChunkedBulkCapacity, chunkedBulkCapacityDryRunError, withBulkCapacityError, } from "../utils/bulk-capacity.js";
|
|
3
5
|
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
6
|
+
import { parentIdInputFields, resolveParentId, validateParentId } from "../utils/parent-ids.js";
|
|
7
|
+
import { assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
4
8
|
const TOOL_NAME = "msads_bulk_create_entities";
|
|
5
9
|
const TOOL_TITLE = "Bulk Create Microsoft Ads Entities";
|
|
6
10
|
const TOOL_DESCRIPTION = `Batch create multiple Microsoft Advertising entities in a single operation.
|
|
7
11
|
|
|
8
|
-
Items are automatically batched per entity type limits. Each batch is sent as a separate API call
|
|
12
|
+
Items are automatically batched per entity type limits. Each batch is sent as a separate API call.
|
|
13
|
+
|
|
14
|
+
All items in one call belong to one parent, sent as the request-body parent element
|
|
15
|
+
Microsoft Ads' Add operation requires: campaign and adExtension need \`accountId\`,
|
|
16
|
+
adGroup needs \`campaignId\`, ad and keyword need \`adGroupId\`. budget, label and
|
|
17
|
+
audience take no parent.`;
|
|
18
|
+
const EFFECT_KIND = "entities_created";
|
|
9
19
|
export const BulkCreateEntitiesInputSchema = z
|
|
10
20
|
.object({
|
|
11
21
|
entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to create"),
|
|
12
|
-
items: z
|
|
22
|
+
items: z
|
|
23
|
+
.array(z.record(z.string(), z.unknown()))
|
|
24
|
+
.min(1)
|
|
25
|
+
.describe("Array of entity data objects to create"),
|
|
26
|
+
...parentIdInputFields,
|
|
27
|
+
dry_run: z
|
|
28
|
+
.boolean()
|
|
29
|
+
.optional()
|
|
30
|
+
.default(false)
|
|
31
|
+
.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
32
|
})
|
|
14
33
|
.describe("Parameters for bulk creating Microsoft Ads entities");
|
|
15
34
|
export const BulkCreateEntitiesOutputSchema = z
|
|
16
35
|
.object({
|
|
17
|
-
results: z.array(z.record(z.any())),
|
|
36
|
+
results: z.array(z.record(z.string(), z.any())),
|
|
18
37
|
entityType: z.string(),
|
|
19
38
|
totalItems: z.number(),
|
|
20
39
|
timestamp: z.string().datetime(),
|
|
40
|
+
dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were created."),
|
|
41
|
+
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."),
|
|
42
|
+
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
43
|
})
|
|
22
44
|
.describe("Bulk creation result");
|
|
23
45
|
export async function bulkCreateEntitiesLogic(input, context, sdkContext) {
|
|
46
|
+
const dispatchedCapability = {
|
|
47
|
+
operation: "bulk_job",
|
|
48
|
+
canonicalEntityKind: null,
|
|
49
|
+
};
|
|
24
50
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
25
|
-
|
|
51
|
+
if (input.dry_run === true) {
|
|
52
|
+
const dryRun = withBulkCapacityError(buildBulkEffectDryRun(input), chunkedBulkCapacityDryRunError(msadsService.quotaScope, input.entityType, input.items.length, "items"));
|
|
53
|
+
return {
|
|
54
|
+
results: [],
|
|
55
|
+
entityType: input.entityType,
|
|
56
|
+
totalItems: 0,
|
|
57
|
+
timestamp: new Date().toISOString(),
|
|
58
|
+
dryRun,
|
|
59
|
+
dispatchedCapability,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
const preflight = buildBulkEffectDryRun(input);
|
|
63
|
+
if (!preflight.wouldSucceed) {
|
|
64
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid bulk create payload: ${preflight.validationErrors.map((e) => e.message).join("; ")}`);
|
|
65
|
+
}
|
|
66
|
+
assertMsAdsChunkedBulkCapacity(TOOL_NAME, msadsService.quotaScope, input.entityType, input.items.length);
|
|
67
|
+
const results = await msadsService.bulkCreateEntities(input.entityType, input.items, context, resolveParentId(input));
|
|
68
|
+
const requested = input.items.length;
|
|
69
|
+
const succeeded = results.filter((r) => r.success).length;
|
|
70
|
+
const failed = requested - succeeded;
|
|
71
|
+
const effect = {
|
|
72
|
+
effectKind: EFFECT_KIND,
|
|
73
|
+
summary: {
|
|
74
|
+
entity_kind: input.entityType,
|
|
75
|
+
requested,
|
|
76
|
+
succeeded,
|
|
77
|
+
failed,
|
|
78
|
+
partial_success: succeeded > 0 && failed > 0,
|
|
79
|
+
},
|
|
80
|
+
};
|
|
26
81
|
return {
|
|
27
82
|
results: results,
|
|
28
83
|
entityType: input.entityType,
|
|
29
84
|
totalItems: input.items.length,
|
|
30
85
|
timestamp: new Date().toISOString(),
|
|
86
|
+
effect,
|
|
87
|
+
dispatchedCapability,
|
|
31
88
|
};
|
|
32
89
|
}
|
|
90
|
+
function buildBulkEffectDryRun(input) {
|
|
91
|
+
const validationErrors = [...validateParentId(input)];
|
|
92
|
+
input.items.forEach((item, i) => {
|
|
93
|
+
if (!item || typeof item !== "object" || Object.keys(item).length === 0) {
|
|
94
|
+
validationErrors.push({
|
|
95
|
+
code: "EMPTY_ITEM",
|
|
96
|
+
message: `items[${i}] must be a non-empty entity object`,
|
|
97
|
+
field: `items.${i}`,
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
});
|
|
101
|
+
const expectedEffect = {
|
|
102
|
+
effectKind: EFFECT_KIND,
|
|
103
|
+
summary: { entity_kind: input.entityType, requested: input.items.length },
|
|
104
|
+
};
|
|
105
|
+
return assertGovernedEffectDryRun({
|
|
106
|
+
wouldSucceed: validationErrors.length === 0,
|
|
107
|
+
validationErrors,
|
|
108
|
+
validationSource: "symbolic",
|
|
109
|
+
expectedEffectSource: "symbolic",
|
|
110
|
+
expectedEffect,
|
|
111
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
|
|
112
|
+
}
|
|
33
113
|
export function bulkCreateEntitiesResponseFormatter(result) {
|
|
114
|
+
if (result.dryRun) {
|
|
115
|
+
const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
|
|
116
|
+
const verdict = wouldSucceed ? "would succeed" : "would FAIL";
|
|
117
|
+
const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
|
|
118
|
+
const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
|
|
119
|
+
return [
|
|
120
|
+
{
|
|
121
|
+
type: "text",
|
|
122
|
+
text: `Dry run: bulk-creating ${String(n)} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were created.` +
|
|
123
|
+
(errs ? `\n${errs}` : "") +
|
|
124
|
+
`\n\nTimestamp: ${result.timestamp}`,
|
|
125
|
+
},
|
|
126
|
+
];
|
|
127
|
+
}
|
|
128
|
+
const succeeded = result.results.filter((r) => r.success === true).length;
|
|
129
|
+
const failed = result.results.length - succeeded;
|
|
130
|
+
const failedNote = failed > 0 ? ` (${failed} rejected by Microsoft Ads)` : "";
|
|
34
131
|
return [
|
|
35
132
|
{
|
|
36
133
|
type: "text",
|
|
37
|
-
text: `Bulk created ${result.totalItems} ${result.entityType} entities\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
134
|
+
text: `Bulk created ${succeeded}/${result.totalItems} ${result.entityType} entities${failedNote}\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
38
135
|
},
|
|
39
136
|
];
|
|
40
137
|
}
|
|
@@ -49,20 +146,39 @@ export const bulkCreateEntitiesTool = {
|
|
|
49
146
|
openWorldHint: false,
|
|
50
147
|
idempotentHint: false,
|
|
51
148
|
destructiveHint: false,
|
|
149
|
+
cesteral: {
|
|
150
|
+
kind: "write",
|
|
151
|
+
writeClass: "effect",
|
|
152
|
+
executableArgsExclude: ["dry_run"],
|
|
153
|
+
platform: "msads",
|
|
154
|
+
contractPlatformSlug: "msads",
|
|
155
|
+
contractToolSlug: "bulk_create_entities",
|
|
156
|
+
operation: ["bulk_job"],
|
|
157
|
+
entityKinds: [],
|
|
158
|
+
entityIdArgs: [],
|
|
159
|
+
schemaVersion: 1,
|
|
160
|
+
contractId: "msads.bulk_create_entities.v1",
|
|
161
|
+
supportsDryRun: true,
|
|
162
|
+
supportsBeforeAfterSnapshot: false,
|
|
163
|
+
requiresValidation: true,
|
|
164
|
+
requiresSimulation: true,
|
|
165
|
+
},
|
|
52
166
|
},
|
|
53
167
|
inputExamples: [
|
|
54
168
|
{
|
|
55
169
|
label: "Bulk create ad groups",
|
|
56
170
|
input: {
|
|
57
171
|
entityType: "adGroup",
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
{ Name: "Ad Group 2", CampaignId: 123 },
|
|
61
|
-
],
|
|
172
|
+
campaignId: "123",
|
|
173
|
+
items: [{ Name: "Ad Group 1" }, { Name: "Ad Group 2" }],
|
|
62
174
|
},
|
|
63
175
|
},
|
|
64
176
|
],
|
|
65
177
|
logic: bulkCreateEntitiesLogic,
|
|
66
178
|
responseFormatter: bulkCreateEntitiesResponseFormatter,
|
|
179
|
+
untrustedContent: {
|
|
180
|
+
structuredPaths: ["$.results"],
|
|
181
|
+
contentBlocks: [0],
|
|
182
|
+
},
|
|
67
183
|
};
|
|
68
184
|
//# sourceMappingURL=bulk-create-entities.tool.js.map
|
|
@@ -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,37 +1,26 @@
|
|
|
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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
items:
|
|
12
|
-
}>;
|
|
4
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
5
|
+
accountId: z.ZodOptional<z.ZodString>;
|
|
6
|
+
campaignId: z.ZodOptional<z.ZodString>;
|
|
7
|
+
adGroupId: z.ZodOptional<z.ZodString>;
|
|
8
|
+
entityType: z.ZodEnum<{
|
|
9
|
+
[x: string]: string;
|
|
10
|
+
}>;
|
|
11
|
+
items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
12
|
+
}, z.core.$strip>;
|
|
13
13
|
export declare const BulkUpdateEntitiesOutputSchema: z.ZodObject<{
|
|
14
14
|
confirmed: z.ZodBoolean;
|
|
15
15
|
declineReason: z.ZodOptional<z.ZodString>;
|
|
16
|
-
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny
|
|
16
|
+
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
17
17
|
entityType: z.ZodString;
|
|
18
18
|
totalItems: z.ZodNumber;
|
|
19
19
|
timestamp: z.ZodString;
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
confirmed: boolean;
|
|
25
|
-
totalItems: number;
|
|
26
|
-
declineReason?: string | undefined;
|
|
27
|
-
}, {
|
|
28
|
-
entityType: string;
|
|
29
|
-
results: Record<string, any>[];
|
|
30
|
-
timestamp: string;
|
|
31
|
-
confirmed: boolean;
|
|
32
|
-
totalItems: number;
|
|
33
|
-
declineReason?: string | undefined;
|
|
34
|
-
}>;
|
|
20
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
|
|
21
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
|
|
22
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
|
|
23
|
+
}, z.core.$strip>;
|
|
35
24
|
type BulkUpdateEntitiesInput = z.infer<typeof BulkUpdateEntitiesInputSchema>;
|
|
36
25
|
type BulkUpdateEntitiesOutput = z.infer<typeof BulkUpdateEntitiesOutputSchema>;
|
|
37
26
|
export declare function bulkUpdateEntitiesLogic(input: BulkUpdateEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkUpdateEntitiesOutput>;
|
|
@@ -41,47 +30,54 @@ export declare const bulkUpdateEntitiesTool: {
|
|
|
41
30
|
title: string;
|
|
42
31
|
description: string;
|
|
43
32
|
inputSchema: z.ZodObject<{
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
items:
|
|
52
|
-
}>;
|
|
33
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
34
|
+
accountId: z.ZodOptional<z.ZodString>;
|
|
35
|
+
campaignId: z.ZodOptional<z.ZodString>;
|
|
36
|
+
adGroupId: z.ZodOptional<z.ZodString>;
|
|
37
|
+
entityType: z.ZodEnum<{
|
|
38
|
+
[x: string]: string;
|
|
39
|
+
}>;
|
|
40
|
+
items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
41
|
+
}, z.core.$strip>;
|
|
53
42
|
outputSchema: z.ZodObject<{
|
|
54
43
|
confirmed: z.ZodBoolean;
|
|
55
44
|
declineReason: z.ZodOptional<z.ZodString>;
|
|
56
|
-
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny
|
|
45
|
+
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
57
46
|
entityType: z.ZodString;
|
|
58
47
|
totalItems: z.ZodNumber;
|
|
59
48
|
timestamp: z.ZodString;
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
confirmed: boolean;
|
|
65
|
-
totalItems: number;
|
|
66
|
-
declineReason?: string | undefined;
|
|
67
|
-
}, {
|
|
68
|
-
entityType: string;
|
|
69
|
-
results: Record<string, any>[];
|
|
70
|
-
timestamp: string;
|
|
71
|
-
confirmed: boolean;
|
|
72
|
-
totalItems: number;
|
|
73
|
-
declineReason?: string | undefined;
|
|
74
|
-
}>;
|
|
49
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
|
|
50
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
|
|
51
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
|
|
52
|
+
}, z.core.$strip>;
|
|
75
53
|
annotations: {
|
|
76
54
|
readOnlyHint: boolean;
|
|
77
55
|
openWorldHint: boolean;
|
|
78
56
|
idempotentHint: boolean;
|
|
79
57
|
destructiveHint: boolean;
|
|
58
|
+
cesteral: {
|
|
59
|
+
kind: "write";
|
|
60
|
+
writeClass: "effect";
|
|
61
|
+
executableArgsExclude: string[];
|
|
62
|
+
platform: string;
|
|
63
|
+
contractPlatformSlug: string;
|
|
64
|
+
contractToolSlug: string;
|
|
65
|
+
operation: "bulk_job"[];
|
|
66
|
+
entityKinds: never[];
|
|
67
|
+
entityIdArgs: never[];
|
|
68
|
+
schemaVersion: number;
|
|
69
|
+
contractId: string;
|
|
70
|
+
supportsDryRun: true;
|
|
71
|
+
supportsBeforeAfterSnapshot: false;
|
|
72
|
+
requiresValidation: true;
|
|
73
|
+
requiresSimulation: true;
|
|
74
|
+
};
|
|
80
75
|
};
|
|
81
76
|
inputExamples: {
|
|
82
77
|
label: string;
|
|
83
78
|
input: {
|
|
84
79
|
entityType: string;
|
|
80
|
+
accountId: string;
|
|
85
81
|
items: {
|
|
86
82
|
Id: number;
|
|
87
83
|
DailyBudget: number;
|
|
@@ -90,6 +86,10 @@ export declare const bulkUpdateEntitiesTool: {
|
|
|
90
86
|
}[];
|
|
91
87
|
logic: typeof bulkUpdateEntitiesLogic;
|
|
92
88
|
responseFormatter: typeof bulkUpdateEntitiesResponseFormatter;
|
|
89
|
+
untrustedContent: {
|
|
90
|
+
structuredPaths: string[];
|
|
91
|
+
contentBlocks: number[];
|
|
92
|
+
};
|
|
93
93
|
};
|
|
94
94
|
export {};
|
|
95
95
|
//# sourceMappingURL=bulk-update-entities.tool.d.ts.map
|
|
@@ -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;AAmBxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAe1B,eAAO,MAAM,6BAA6B;;;;;;;;;iBAgBwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B;;;;;;;;;;iBAkBV,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,CAgHnC;AA+CD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAkClB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDlC,CAAC"}
|
|
@@ -1,33 +1,72 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { assertMsAdsChunkedBulkCapacity, chunkedBulkCapacityDryRunError, withBulkCapacityError, } from "../utils/bulk-capacity.js";
|
|
3
4
|
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
-
import {
|
|
5
|
+
import { parentIdInputFields, resolveParentId, validateParentId } from "../utils/parent-ids.js";
|
|
6
|
+
import { McpError, JsonRpcErrorCode, elicitBulkMutationConfirmation, hasSensitiveBulkField, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
5
7
|
const TOOL_NAME = "msads_bulk_update_entities";
|
|
6
8
|
const TOOL_TITLE = "Bulk Update Microsoft Ads Entities";
|
|
7
9
|
const TOOL_DESCRIPTION = `Batch update multiple Microsoft Advertising entities.
|
|
8
10
|
|
|
9
|
-
Each item must include the Id field. Only include fields you want to change
|
|
11
|
+
Each item must include the Id field. Only include fields you want to change.
|
|
12
|
+
|
|
13
|
+
All items in one call belong to one parent, sent as the request-body parent element
|
|
14
|
+
Microsoft Ads' Update operation requires: campaign and adExtension need \`accountId\`,
|
|
15
|
+
adGroup needs \`campaignId\`, ad and keyword need \`adGroupId\`. budget, label and
|
|
16
|
+
audience take no parent.`;
|
|
17
|
+
const EFFECT_KIND = "entities_updated";
|
|
10
18
|
export const BulkUpdateEntitiesInputSchema = z
|
|
11
19
|
.object({
|
|
12
20
|
entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
|
|
13
21
|
items: z
|
|
14
|
-
.array(z.record(z.unknown()))
|
|
22
|
+
.array(z.record(z.string(), z.unknown()))
|
|
15
23
|
.min(1)
|
|
16
24
|
.describe("Array of entity data objects with Id and fields to update"),
|
|
25
|
+
...parentIdInputFields,
|
|
26
|
+
dry_run: z
|
|
27
|
+
.boolean()
|
|
28
|
+
.optional()
|
|
29
|
+
.default(false)
|
|
30
|
+
.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
31
|
})
|
|
18
32
|
.describe("Parameters for bulk updating Microsoft Ads entities");
|
|
19
33
|
export const BulkUpdateEntitiesOutputSchema = z
|
|
20
34
|
.object({
|
|
21
35
|
confirmed: z.boolean(),
|
|
22
36
|
declineReason: z.string().optional(),
|
|
23
|
-
results: z.array(z.record(z.any())),
|
|
37
|
+
results: z.array(z.record(z.string(), z.any())),
|
|
24
38
|
entityType: z.string(),
|
|
25
39
|
totalItems: z.number(),
|
|
26
40
|
timestamp: z.string().datetime(),
|
|
41
|
+
dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entities were updated."),
|
|
42
|
+
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."),
|
|
43
|
+
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
44
|
})
|
|
28
45
|
.describe("Bulk update result");
|
|
29
46
|
export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
|
|
47
|
+
const dispatchedCapability = {
|
|
48
|
+
operation: "bulk_job",
|
|
49
|
+
canonicalEntityKind: null,
|
|
50
|
+
};
|
|
51
|
+
const { msadsService } = resolveSessionServices(sdkContext);
|
|
52
|
+
if (input.dry_run === true) {
|
|
53
|
+
const dryRun = withBulkCapacityError(buildBulkEffectDryRun(input), chunkedBulkCapacityDryRunError(msadsService.quotaScope, input.entityType, input.items.length, "items"));
|
|
54
|
+
return {
|
|
55
|
+
confirmed: true,
|
|
56
|
+
results: [],
|
|
57
|
+
entityType: input.entityType,
|
|
58
|
+
totalItems: 0,
|
|
59
|
+
timestamp: new Date().toISOString(),
|
|
60
|
+
dryRun,
|
|
61
|
+
dispatchedCapability,
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
const parentErrors = validateParentId(input);
|
|
65
|
+
if (parentErrors.length > 0) {
|
|
66
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid bulk update payload: ${parentErrors.map((e) => e.message).join("; ")}`);
|
|
67
|
+
}
|
|
30
68
|
const items = input.items;
|
|
69
|
+
assertMsAdsChunkedBulkCapacity(TOOL_NAME, msadsService.quotaScope, input.entityType, items.length);
|
|
31
70
|
const confirmed = await elicitBulkMutationConfirmation({
|
|
32
71
|
count: items.length,
|
|
33
72
|
entityLabel: input.entityType,
|
|
@@ -44,19 +83,80 @@ export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
|
|
|
44
83
|
entityType: input.entityType,
|
|
45
84
|
totalItems: items.length,
|
|
46
85
|
timestamp: new Date().toISOString(),
|
|
86
|
+
dispatchedCapability,
|
|
47
87
|
};
|
|
48
88
|
}
|
|
49
|
-
const
|
|
50
|
-
const
|
|
89
|
+
const results = await msadsService.bulkUpdateEntities(input.entityType, input.items, context, resolveParentId(input));
|
|
90
|
+
const requested = input.items.length;
|
|
91
|
+
const succeeded = results.filter((r) => r.success).length;
|
|
92
|
+
const failed = requested - succeeded;
|
|
93
|
+
const effect = {
|
|
94
|
+
effectKind: EFFECT_KIND,
|
|
95
|
+
summary: {
|
|
96
|
+
entity_kind: input.entityType,
|
|
97
|
+
requested,
|
|
98
|
+
succeeded,
|
|
99
|
+
failed,
|
|
100
|
+
partial_success: succeeded > 0 && failed > 0,
|
|
101
|
+
},
|
|
102
|
+
};
|
|
51
103
|
return {
|
|
52
104
|
confirmed: true,
|
|
53
105
|
results: results,
|
|
54
106
|
entityType: input.entityType,
|
|
55
107
|
totalItems: input.items.length,
|
|
56
108
|
timestamp: new Date().toISOString(),
|
|
109
|
+
effect,
|
|
110
|
+
dispatchedCapability,
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
function buildBulkEffectDryRun(input) {
|
|
114
|
+
const validationErrors = [...validateParentId(input)];
|
|
115
|
+
input.items.forEach((item, i) => {
|
|
116
|
+
if (!item || typeof item !== "object" || Object.keys(item).length === 0) {
|
|
117
|
+
validationErrors.push({
|
|
118
|
+
code: "EMPTY_UPDATE",
|
|
119
|
+
message: `items[${i}] must be a non-empty entity record`,
|
|
120
|
+
field: `items.${i}`,
|
|
121
|
+
});
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
124
|
+
const id = item.Id ?? item.id;
|
|
125
|
+
if (id === undefined || id === null || String(id).trim().length === 0) {
|
|
126
|
+
validationErrors.push({
|
|
127
|
+
code: "MISSING_ID",
|
|
128
|
+
message: `items[${i}] must include an Id to target for update`,
|
|
129
|
+
field: `items.${i}.Id`,
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
});
|
|
133
|
+
const expectedEffect = {
|
|
134
|
+
effectKind: EFFECT_KIND,
|
|
135
|
+
summary: { entity_kind: input.entityType, requested: input.items.length },
|
|
57
136
|
};
|
|
137
|
+
return assertGovernedEffectDryRun({
|
|
138
|
+
wouldSucceed: validationErrors.length === 0,
|
|
139
|
+
validationErrors,
|
|
140
|
+
validationSource: "symbolic",
|
|
141
|
+
expectedEffectSource: "symbolic",
|
|
142
|
+
expectedEffect,
|
|
143
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true });
|
|
58
144
|
}
|
|
59
145
|
export function bulkUpdateEntitiesResponseFormatter(result) {
|
|
146
|
+
if (result.dryRun) {
|
|
147
|
+
const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
|
|
148
|
+
const verdict = wouldSucceed ? "would succeed" : "would FAIL";
|
|
149
|
+
const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
|
|
150
|
+
const n = result.dryRun.expectedEffect?.summary.requested ?? 0;
|
|
151
|
+
return [
|
|
152
|
+
{
|
|
153
|
+
type: "text",
|
|
154
|
+
text: `Dry run: bulk-updating ${String(n)} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No entities were updated.` +
|
|
155
|
+
(errs ? `\n${errs}` : "") +
|
|
156
|
+
`\n\nTimestamp: ${result.timestamp}`,
|
|
157
|
+
},
|
|
158
|
+
];
|
|
159
|
+
}
|
|
60
160
|
if (!result.confirmed) {
|
|
61
161
|
return [
|
|
62
162
|
{
|
|
@@ -65,10 +165,13 @@ export function bulkUpdateEntitiesResponseFormatter(result) {
|
|
|
65
165
|
},
|
|
66
166
|
];
|
|
67
167
|
}
|
|
168
|
+
const succeeded = result.results.filter((r) => r.success === true).length;
|
|
169
|
+
const failed = result.results.length - succeeded;
|
|
170
|
+
const failedNote = failed > 0 ? ` (${failed} rejected by Microsoft Ads)` : "";
|
|
68
171
|
return [
|
|
69
172
|
{
|
|
70
173
|
type: "text",
|
|
71
|
-
text: `Bulk updated ${result.totalItems} ${result.entityType} entities\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
174
|
+
text: `Bulk updated ${succeeded}/${result.totalItems} ${result.entityType} entities${failedNote}\n\nResults:\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
72
175
|
},
|
|
73
176
|
];
|
|
74
177
|
}
|
|
@@ -83,12 +186,30 @@ export const bulkUpdateEntitiesTool = {
|
|
|
83
186
|
openWorldHint: false,
|
|
84
187
|
idempotentHint: true,
|
|
85
188
|
destructiveHint: false,
|
|
189
|
+
cesteral: {
|
|
190
|
+
kind: "write",
|
|
191
|
+
writeClass: "effect",
|
|
192
|
+
executableArgsExclude: ["dry_run"],
|
|
193
|
+
platform: "msads",
|
|
194
|
+
contractPlatformSlug: "msads",
|
|
195
|
+
contractToolSlug: "bulk_update_entities",
|
|
196
|
+
operation: ["bulk_job"],
|
|
197
|
+
entityKinds: [],
|
|
198
|
+
entityIdArgs: [],
|
|
199
|
+
schemaVersion: 1,
|
|
200
|
+
contractId: "msads.bulk_update_entities.v1",
|
|
201
|
+
supportsDryRun: true,
|
|
202
|
+
supportsBeforeAfterSnapshot: false,
|
|
203
|
+
requiresValidation: true,
|
|
204
|
+
requiresSimulation: true,
|
|
205
|
+
},
|
|
86
206
|
},
|
|
87
207
|
inputExamples: [
|
|
88
208
|
{
|
|
89
209
|
label: "Bulk update campaign budgets",
|
|
90
210
|
input: {
|
|
91
211
|
entityType: "campaign",
|
|
212
|
+
accountId: "789012",
|
|
92
213
|
items: [
|
|
93
214
|
{ Id: 123, DailyBudget: 100.0 },
|
|
94
215
|
{ Id: 456, DailyBudget: 200.0 },
|
|
@@ -98,5 +219,9 @@ export const bulkUpdateEntitiesTool = {
|
|
|
98
219
|
],
|
|
99
220
|
logic: bulkUpdateEntitiesLogic,
|
|
100
221
|
responseFormatter: bulkUpdateEntitiesResponseFormatter,
|
|
222
|
+
untrustedContent: {
|
|
223
|
+
structuredPaths: ["$.results"],
|
|
224
|
+
contentBlocks: [0],
|
|
225
|
+
},
|
|
101
226
|
};
|
|
102
227
|
//# sourceMappingURL=bulk-update-entities.tool.js.map
|
|
@@ -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,EAAE,
|
|
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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"}
|