@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
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { assertBulkCapacity, projectBulkCapacity, McpError, JsonRpcErrorCode, } from "@cesteral/shared";
|
|
2
|
+
import { rateLimiter } from "../../../utils/platform.js";
|
|
3
|
+
import { msadsQuotaBuckets, } from "../../../services/msads/rate-limit-keys.js";
|
|
4
|
+
import { getEntityConfig } from "./entity-mapping.js";
|
|
5
|
+
function oneWritePerChunk(scope) {
|
|
6
|
+
return msadsQuotaBuckets(scope, "write", [3]);
|
|
7
|
+
}
|
|
8
|
+
export function oneStatusWritePerItem(scope) {
|
|
9
|
+
return msadsQuotaBuckets(scope, "write", [1]);
|
|
10
|
+
}
|
|
11
|
+
export function assertMsAdsBulkCapacity(toolName, itemCount, buckets) {
|
|
12
|
+
return assertBulkCapacity({ rateLimiter, toolName, itemCount, buckets });
|
|
13
|
+
}
|
|
14
|
+
function projectChunked(scope, entityType, itemCount) {
|
|
15
|
+
const chunkSize = getEntityConfig(entityType).batchLimit;
|
|
16
|
+
const chunkCount = Math.ceil(itemCount / chunkSize);
|
|
17
|
+
const projection = projectBulkCapacity({
|
|
18
|
+
rateLimiter,
|
|
19
|
+
toolName: "",
|
|
20
|
+
itemCount: chunkCount,
|
|
21
|
+
buckets: oneWritePerChunk(scope),
|
|
22
|
+
});
|
|
23
|
+
return {
|
|
24
|
+
itemCount,
|
|
25
|
+
chunkSize,
|
|
26
|
+
chunkCount,
|
|
27
|
+
chunksThatFit: projection.itemsThatFit,
|
|
28
|
+
itemsThatFit: Math.min(itemCount, projection.itemsThatFit * chunkSize),
|
|
29
|
+
projectedWaitMs: projection.projectedWaitMs,
|
|
30
|
+
budgetMs: projection.budgetMs,
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
function describeChunkedRefusal(p) {
|
|
34
|
+
const wait = Number.isFinite(p.projectedWaitMs)
|
|
35
|
+
? `${Math.ceil(p.projectedWaitMs / 1000)}s`
|
|
36
|
+
: "never (a request costs more than the whole limit)";
|
|
37
|
+
return (`${p.itemCount} items are sent as ${p.chunkCount} requests of up to ${p.chunkSize}, which ` +
|
|
38
|
+
`would take ${wait} to clear the Microsoft Ads rate limit, more than the ` +
|
|
39
|
+
`${Math.ceil(p.budgetMs / 1000)}s budget. ${p.itemsThatFit} item(s) ` +
|
|
40
|
+
`(${p.chunksThatFit} request(s)) fit right now — split the batch into calls of at most ` +
|
|
41
|
+
`${Math.max(p.itemsThatFit, 1)} items.`);
|
|
42
|
+
}
|
|
43
|
+
export function assertMsAdsChunkedBulkCapacity(toolName, scope, entityType, itemCount) {
|
|
44
|
+
const p = projectChunked(scope, entityType, itemCount);
|
|
45
|
+
if (p.chunksThatFit >= p.chunkCount)
|
|
46
|
+
return;
|
|
47
|
+
throw new McpError(JsonRpcErrorCode.RateLimited, `${toolName}: ${describeChunkedRefusal(p)} Nothing was sent.`, {
|
|
48
|
+
reason: "bulk_exceeds_capacity",
|
|
49
|
+
itemCount: p.itemCount,
|
|
50
|
+
itemsThatFit: p.itemsThatFit,
|
|
51
|
+
chunkSize: p.chunkSize,
|
|
52
|
+
chunkCount: p.chunkCount,
|
|
53
|
+
chunksThatFit: p.chunksThatFit,
|
|
54
|
+
projectedWaitMs: Number.isFinite(p.projectedWaitMs) ? p.projectedWaitMs : null,
|
|
55
|
+
budgetMs: p.budgetMs,
|
|
56
|
+
retryAfterMs: Number.isFinite(p.projectedWaitMs)
|
|
57
|
+
? Math.max(0, p.projectedWaitMs - p.budgetMs)
|
|
58
|
+
: null,
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
export function chunkedBulkCapacityDryRunError(scope, entityType, itemCount, field) {
|
|
62
|
+
const p = projectChunked(scope, entityType, itemCount);
|
|
63
|
+
if (p.chunksThatFit >= p.chunkCount)
|
|
64
|
+
return undefined;
|
|
65
|
+
return {
|
|
66
|
+
code: "BULK_EXCEEDS_CAPACITY",
|
|
67
|
+
message: `${describeChunkedRefusal(p)} The call would be refused before any write.`,
|
|
68
|
+
field,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
export function bulkCapacityDryRunError(toolName, itemCount, buckets, field) {
|
|
72
|
+
const projection = projectBulkCapacity({ rateLimiter, toolName, itemCount, buckets });
|
|
73
|
+
if (projection.itemsThatFit >= itemCount)
|
|
74
|
+
return undefined;
|
|
75
|
+
const wait = Number.isFinite(projection.projectedWaitMs)
|
|
76
|
+
? `${Math.ceil(projection.projectedWaitMs / 1000)}s`
|
|
77
|
+
: "never (an item costs more than the whole limit)";
|
|
78
|
+
return {
|
|
79
|
+
code: "BULK_EXCEEDS_CAPACITY",
|
|
80
|
+
message: `${itemCount} items would take ${wait} to clear the Microsoft Ads rate limit, more than the ` +
|
|
81
|
+
`${Math.ceil(projection.budgetMs / 1000)}s budget, so the call would be refused before any ` +
|
|
82
|
+
`write. ${projection.itemsThatFit} item(s) fit right now — split the batch into chunks of ` +
|
|
83
|
+
`at most ${Math.max(projection.itemsThatFit, 1)}.`,
|
|
84
|
+
field,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
export function withBulkCapacityError(dryRun, error) {
|
|
88
|
+
if (!error)
|
|
89
|
+
return dryRun;
|
|
90
|
+
return {
|
|
91
|
+
...dryRun,
|
|
92
|
+
wouldSucceed: false,
|
|
93
|
+
validationErrors: [...dryRun.validationErrors, error],
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
//# sourceMappingURL=bulk-capacity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bulk-capacity.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/bulk-capacity.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,9 +3,12 @@ export interface MsAdsServiceLike {
|
|
|
3
3
|
getEntity?: (entityType: any, entityIds: string[], params?: Record<string, unknown>, context?: RequestContext) => Promise<{
|
|
4
4
|
entities: unknown[];
|
|
5
5
|
}>;
|
|
6
|
+
getAccountCurrency?: (context?: RequestContext) => Promise<string>;
|
|
6
7
|
}
|
|
8
|
+
export declare const MSADS_UNKNOWN_CURRENCY = "XXX";
|
|
9
|
+
export declare function resolveMsAdsCurrency(service: MsAdsServiceLike, context?: RequestContext): Promise<string>;
|
|
7
10
|
export declare const ENTITY_KIND_MAP: Record<string, CanonicalEntityKind>;
|
|
8
|
-
export declare function buildMsAdsSnapshot(entityType: string, entityId: string, current: Record<string, unknown>, patch: Record<string, unknown
|
|
11
|
+
export declare function buildMsAdsSnapshot(entityType: string, entityId: string, current: Record<string, unknown>, patch: Record<string, unknown>, currency: string): NormalizedEntitySnapshot | null;
|
|
9
12
|
export declare function captureMsAdsSnapshot(service: MsAdsServiceLike, entityType: string, entityId: string, params: Record<string, unknown>, context: RequestContext): Promise<NormalizedEntitySnapshot | undefined>;
|
|
10
|
-
export declare function snapshotFromMsAdsEntity(entityType: string, entityId: string, entity: Record<string, unknown
|
|
13
|
+
export declare function snapshotFromMsAdsEntity(entityType: string, entityId: string, entity: Record<string, unknown>, currency: string): NormalizedEntitySnapshot | undefined;
|
|
11
14
|
//# sourceMappingURL=capture-snapshot.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"capture-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"capture-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EACV,mBAAmB,EAGnB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAG/B,SAAS,CAAC,EAAE,CACV,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAEtC,kBAAkB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpE;AAOD,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAO5C,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAMD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAK/D,CAAC;AAwEF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,GACf,wBAAwB,GAAG,IAAI,CA0CjC;AAQD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAY/C;AAUD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GACf,wBAAwB,GAAG,SAAS,CAatC"}
|
|
@@ -1,3 +1,14 @@
|
|
|
1
|
+
export const MSADS_UNKNOWN_CURRENCY = "XXX";
|
|
2
|
+
export async function resolveMsAdsCurrency(service, context) {
|
|
3
|
+
if (!service.getAccountCurrency)
|
|
4
|
+
return MSADS_UNKNOWN_CURRENCY;
|
|
5
|
+
try {
|
|
6
|
+
return await service.getAccountCurrency(context);
|
|
7
|
+
}
|
|
8
|
+
catch {
|
|
9
|
+
return MSADS_UNKNOWN_CURRENCY;
|
|
10
|
+
}
|
|
11
|
+
}
|
|
1
12
|
export const ENTITY_KIND_MAP = {
|
|
2
13
|
campaign: "campaign",
|
|
3
14
|
adGroup: "ad_group",
|
|
@@ -18,13 +29,25 @@ function normalizeStatus(raw) {
|
|
|
18
29
|
const platformRaw = typeof raw === "string" ? raw : "";
|
|
19
30
|
return { canonical: STATUS_MAP[platformRaw] ?? "unknown", platformRaw };
|
|
20
31
|
}
|
|
21
|
-
function
|
|
32
|
+
function currencyExponent(currency) {
|
|
33
|
+
if (currency === MSADS_UNKNOWN_CURRENCY)
|
|
34
|
+
return 2;
|
|
35
|
+
try {
|
|
36
|
+
const digits = new Intl.NumberFormat("en", { style: "currency", currency }).resolvedOptions()
|
|
37
|
+
.maximumFractionDigits;
|
|
38
|
+
return typeof digits === "number" ? digits : 2;
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return 2;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
function toMinor(amount, currency) {
|
|
22
45
|
if (amount == null)
|
|
23
46
|
return undefined;
|
|
24
47
|
const n = typeof amount === "string" ? Number(amount) : Number(amount);
|
|
25
48
|
if (!Number.isFinite(n))
|
|
26
49
|
return undefined;
|
|
27
|
-
return Math.round(n *
|
|
50
|
+
return Math.round(n * 10 ** currencyExponent(currency));
|
|
28
51
|
}
|
|
29
52
|
function dateToIso(raw) {
|
|
30
53
|
if (!raw || typeof raw !== "object")
|
|
@@ -38,19 +61,23 @@ function dateToIso(raw) {
|
|
|
38
61
|
const pad = (n) => String(n).padStart(2, "0");
|
|
39
62
|
return `${year}-${pad(month)}-${pad(day)}`;
|
|
40
63
|
}
|
|
41
|
-
export function buildMsAdsSnapshot(entityType, entityId, current, patch) {
|
|
64
|
+
export function buildMsAdsSnapshot(entityType, entityId, current, patch, currency) {
|
|
42
65
|
const entityKind = ENTITY_KIND_MAP[entityType];
|
|
43
66
|
if (!entityKind)
|
|
44
67
|
return null;
|
|
45
68
|
const merged = { ...current, ...patch };
|
|
46
69
|
let daily = null;
|
|
47
70
|
let lifetime = null;
|
|
48
|
-
const currency = "USD";
|
|
49
71
|
if (entityKind === "campaign_budget") {
|
|
50
|
-
const amountMinor = toMinor(merged.Amount);
|
|
72
|
+
const amountMinor = toMinor(merged.Amount, currency);
|
|
73
|
+
if (amountMinor != null)
|
|
74
|
+
daily = { amountMinor, currency };
|
|
75
|
+
}
|
|
76
|
+
else if (entityKind === "campaign") {
|
|
77
|
+
const amountMinor = toMinor(merged.DailyBudget, currency);
|
|
51
78
|
if (amountMinor != null) {
|
|
52
79
|
const money = { amountMinor, currency };
|
|
53
|
-
if (merged.BudgetType === "
|
|
80
|
+
if (merged.BudgetType === "LifetimeBudgetStandard") {
|
|
54
81
|
lifetime = money;
|
|
55
82
|
}
|
|
56
83
|
else {
|
|
@@ -58,14 +85,6 @@ export function buildMsAdsSnapshot(entityType, entityId, current, patch) {
|
|
|
58
85
|
}
|
|
59
86
|
}
|
|
60
87
|
}
|
|
61
|
-
else if (entityKind === "campaign") {
|
|
62
|
-
const dailyMinor = toMinor(merged.DailyBudget);
|
|
63
|
-
const monthlyMinor = toMinor(merged.MonthlyBudget);
|
|
64
|
-
if (dailyMinor != null)
|
|
65
|
-
daily = { amountMinor: dailyMinor, currency };
|
|
66
|
-
if (monthlyMinor != null)
|
|
67
|
-
lifetime = { amountMinor: monthlyMinor, currency };
|
|
68
|
-
}
|
|
69
88
|
return {
|
|
70
89
|
schemaVersion: 1,
|
|
71
90
|
platform: "msads",
|
|
@@ -89,25 +108,25 @@ export async function captureMsAdsSnapshot(service, entityType, entityId, params
|
|
|
89
108
|
const current = entities?.[0];
|
|
90
109
|
if (!current || typeof current !== "object")
|
|
91
110
|
return undefined;
|
|
92
|
-
const
|
|
111
|
+
const currency = await resolveMsAdsCurrency(service, context);
|
|
112
|
+
const snapshot = buildMsAdsSnapshot(entityType, entityId, current, {}, currency);
|
|
93
113
|
return snapshot ?? undefined;
|
|
94
114
|
}
|
|
95
115
|
catch {
|
|
96
116
|
return undefined;
|
|
97
117
|
}
|
|
98
118
|
}
|
|
99
|
-
export function snapshotFromMsAdsEntity(entityType, entityId, entity) {
|
|
119
|
+
export function snapshotFromMsAdsEntity(entityType, entityId, entity, currency) {
|
|
100
120
|
if (!ENTITY_KIND_MAP[entityType])
|
|
101
121
|
return undefined;
|
|
102
122
|
if (!entity ||
|
|
103
123
|
(entity.Status == null &&
|
|
104
124
|
entity.Name == null &&
|
|
105
125
|
entity.Amount == null &&
|
|
106
|
-
entity.DailyBudget == null
|
|
107
|
-
entity.MonthlyBudget == null)) {
|
|
126
|
+
entity.DailyBudget == null)) {
|
|
108
127
|
return undefined;
|
|
109
128
|
}
|
|
110
|
-
const snapshot = buildMsAdsSnapshot(entityType, entityId, entity, {});
|
|
129
|
+
const snapshot = buildMsAdsSnapshot(entityType, entityId, entity, {}, currency);
|
|
111
130
|
return snapshot ?? undefined;
|
|
112
131
|
}
|
|
113
132
|
//# sourceMappingURL=capture-snapshot.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"capture-snapshot.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"capture-snapshot.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,8 +1,23 @@
|
|
|
1
|
-
import type { DispatchedCapability, DryRunResult, NormalizedEntitySnapshot, RequestContext } from "@cesteral/shared";
|
|
1
|
+
import type { DispatchedCapability, DryRunResult, DryRunValidationError, NormalizedEntitySnapshot, RequestContext } from "@cesteral/shared";
|
|
2
2
|
import { type MsAdsServiceLike } from "./capture-snapshot.js";
|
|
3
3
|
export type { MsAdsServiceLike };
|
|
4
|
-
export declare function
|
|
4
|
+
export declare function symbolicValidate(data: Record<string, unknown>): DryRunValidationError[];
|
|
5
|
+
export declare function applyMsAdsPatch(entityType: string, entityId: string, preState: Record<string, unknown>, data: Record<string, unknown>, currency?: string): NormalizedEntitySnapshot | undefined;
|
|
5
6
|
export declare function resolveMsAdsDispatchedCapability(entityType: string, data: Record<string, unknown>): DispatchedCapability;
|
|
7
|
+
export declare function resolveMsAdsCreateCapability(entityType: string): DispatchedCapability;
|
|
8
|
+
export declare function resolveMsAdsDuplicateCapability(entityType: string): DispatchedCapability;
|
|
9
|
+
export interface MsAdsDuplicateDryRunArgs {
|
|
10
|
+
entityType: string;
|
|
11
|
+
accountId: string;
|
|
12
|
+
entityId: string;
|
|
13
|
+
options?: Record<string, unknown>;
|
|
14
|
+
}
|
|
15
|
+
export declare function runMsAdsDuplicateDryRun(input: MsAdsDuplicateDryRunArgs, service: MsAdsServiceLike, context: RequestContext): Promise<DryRunResult>;
|
|
16
|
+
export interface MsAdsCreateDryRunArgs {
|
|
17
|
+
entityType: string;
|
|
18
|
+
data: Record<string, unknown>;
|
|
19
|
+
}
|
|
20
|
+
export declare function runMsAdsCreateDryRun(input: MsAdsCreateDryRunArgs, service: MsAdsServiceLike, context: RequestContext): Promise<DryRunResult>;
|
|
6
21
|
export interface MsAdsDryRunArgs {
|
|
7
22
|
entityType: string;
|
|
8
23
|
entityId: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,
|
|
1
|
+
{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAqCjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,EAAE,CA6BvF;AAYD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,GAAE,MAAc,GACvB,wBAAwB,GAAG,SAAS,CAGtC;AAQD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,oBAAoB,CAmBtB;AAQD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAKrF;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAKxF;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AASD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAyCvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAUD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CA2CvB"}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { assertGovernedDryRunResult } from "@cesteral/shared";
|
|
2
|
-
import { buildMsAdsSnapshot, ENTITY_KIND_MAP } from "./capture-snapshot.js";
|
|
2
|
+
import { buildMsAdsSnapshot, ENTITY_KIND_MAP, resolveMsAdsCurrency, } from "./capture-snapshot.js";
|
|
3
|
+
import { MSADS_DUPLICATE_COPY_STATUS } from "../../../services/msads/msads-service.js";
|
|
3
4
|
const VALID_STATUSES = [
|
|
4
5
|
"Active",
|
|
5
6
|
"Paused",
|
|
@@ -17,8 +18,8 @@ const PAUSED_STATUSES = new Set([
|
|
|
17
18
|
"Suspended",
|
|
18
19
|
"Expired",
|
|
19
20
|
]);
|
|
20
|
-
const BUDGET_FIELDS = ["Amount", "DailyBudget"
|
|
21
|
-
function symbolicValidate(data) {
|
|
21
|
+
const BUDGET_FIELDS = ["Amount", "DailyBudget"];
|
|
22
|
+
export function symbolicValidate(data) {
|
|
22
23
|
const errors = [];
|
|
23
24
|
if ("Status" in data) {
|
|
24
25
|
const status = data.Status;
|
|
@@ -45,8 +46,8 @@ function symbolicValidate(data) {
|
|
|
45
46
|
}
|
|
46
47
|
return errors;
|
|
47
48
|
}
|
|
48
|
-
export function applyMsAdsPatch(entityType, entityId, preState, data) {
|
|
49
|
-
const snapshot = buildMsAdsSnapshot(entityType, entityId, preState, data);
|
|
49
|
+
export function applyMsAdsPatch(entityType, entityId, preState, data, currency = "USD") {
|
|
50
|
+
const snapshot = buildMsAdsSnapshot(entityType, entityId, preState, data, currency);
|
|
50
51
|
return snapshot ?? undefined;
|
|
51
52
|
}
|
|
52
53
|
export function resolveMsAdsDispatchedCapability(entityType, data) {
|
|
@@ -72,6 +73,69 @@ export function resolveMsAdsDispatchedCapability(entityType, data) {
|
|
|
72
73
|
canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? entityType ?? "unknown",
|
|
73
74
|
};
|
|
74
75
|
}
|
|
76
|
+
export function resolveMsAdsCreateCapability(entityType) {
|
|
77
|
+
return {
|
|
78
|
+
operation: "create",
|
|
79
|
+
canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? null,
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
export function resolveMsAdsDuplicateCapability(entityType) {
|
|
83
|
+
return {
|
|
84
|
+
operation: "duplicate",
|
|
85
|
+
canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? null,
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
export async function runMsAdsDuplicateDryRun(input, service, context) {
|
|
89
|
+
const validationErrors = [];
|
|
90
|
+
let expectedPostState;
|
|
91
|
+
let expectedStateSource = "none";
|
|
92
|
+
const inScope = Boolean(ENTITY_KIND_MAP[input.entityType]);
|
|
93
|
+
if (inScope && service.getEntity) {
|
|
94
|
+
const { entities } = await service.getEntity(input.entityType, [input.entityId], { AccountId: Number(input.accountId) }, context);
|
|
95
|
+
const source = (entities[0] ?? {});
|
|
96
|
+
if (Object.keys(source).length > 0) {
|
|
97
|
+
const currency = await resolveMsAdsCurrency(service, context);
|
|
98
|
+
const snapshot = buildMsAdsSnapshot(input.entityType, "", source, {
|
|
99
|
+
...(input.options ?? {}),
|
|
100
|
+
Status: MSADS_DUPLICATE_COPY_STATUS,
|
|
101
|
+
}, currency);
|
|
102
|
+
if (snapshot) {
|
|
103
|
+
expectedPostState = snapshot;
|
|
104
|
+
expectedStateSource = "server_symbolic_apply";
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
const result = {
|
|
109
|
+
wouldSucceed: validationErrors.length === 0 && (!inScope || expectedPostState !== undefined),
|
|
110
|
+
validationErrors,
|
|
111
|
+
validationSource: "symbolic",
|
|
112
|
+
expectedStateSource,
|
|
113
|
+
...(expectedPostState ? { expectedPostState } : {}),
|
|
114
|
+
};
|
|
115
|
+
return inScope ? assertGovernedDryRunResult(result, "msads_duplicate_entity") : result;
|
|
116
|
+
}
|
|
117
|
+
export async function runMsAdsCreateDryRun(input, service, context) {
|
|
118
|
+
const validationErrors = symbolicValidate(input.data);
|
|
119
|
+
let expectedPostState;
|
|
120
|
+
let expectedStateSource = "none";
|
|
121
|
+
if (ENTITY_KIND_MAP[input.entityType]) {
|
|
122
|
+
const currency = await resolveMsAdsCurrency(service, context);
|
|
123
|
+
const snapshot = buildMsAdsSnapshot(input.entityType, "", {}, input.data, currency);
|
|
124
|
+
if (snapshot) {
|
|
125
|
+
expectedPostState = snapshot;
|
|
126
|
+
expectedStateSource = "server_symbolic_apply";
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
const inScope = Boolean(ENTITY_KIND_MAP[input.entityType]);
|
|
130
|
+
const result = {
|
|
131
|
+
wouldSucceed: validationErrors.length === 0 && (!inScope || expectedPostState !== undefined),
|
|
132
|
+
validationErrors,
|
|
133
|
+
validationSource: "symbolic",
|
|
134
|
+
expectedStateSource,
|
|
135
|
+
...(expectedPostState ? { expectedPostState } : {}),
|
|
136
|
+
};
|
|
137
|
+
return inScope ? assertGovernedDryRunResult(result, "msads_create_entity") : result;
|
|
138
|
+
}
|
|
75
139
|
export async function runMsAdsUpdateDryRun(input, service, context) {
|
|
76
140
|
const validationErrors = symbolicValidate(input.data);
|
|
77
141
|
let expectedPostState;
|
|
@@ -80,7 +144,8 @@ export async function runMsAdsUpdateDryRun(input, service, context) {
|
|
|
80
144
|
const { entities } = await service.getEntity(input.entityType, [input.entityId], input.readParams, context);
|
|
81
145
|
const current = entities?.[0];
|
|
82
146
|
if (current && typeof current === "object") {
|
|
83
|
-
const
|
|
147
|
+
const currency = await resolveMsAdsCurrency(service, context);
|
|
148
|
+
const snapshot = buildMsAdsSnapshot(input.entityType, input.entityId, current, input.data, currency);
|
|
84
149
|
if (snapshot) {
|
|
85
150
|
expectedPostState = snapshot;
|
|
86
151
|
expectedStateSource = "server_symbolic_apply";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAQ9D,OAAO,
|
|
1
|
+
{"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
1
2
|
export type MsAdsEntityType = "campaign" | "adGroup" | "ad" | "keyword" | "budget" | "adExtension" | "audience" | "label";
|
|
2
3
|
export interface MsAdsEntityConfig {
|
|
3
4
|
addOperation: string;
|
|
@@ -13,8 +14,34 @@ export interface MsAdsEntityConfig {
|
|
|
13
14
|
idsField: string;
|
|
14
15
|
batchLimit: number;
|
|
15
16
|
requiredGetByIdsFields?: string[];
|
|
17
|
+
supportsDuplicate?: boolean;
|
|
18
|
+
writeParentIdField?: MsAdsWriteParentIdField;
|
|
19
|
+
deleteParentIdFields?: readonly string[];
|
|
20
|
+
defaultReadFields?: Record<string, unknown>;
|
|
16
21
|
}
|
|
22
|
+
export type MsAdsWriteParentIdField = "AccountId" | "CampaignId" | "AdGroupId";
|
|
23
|
+
export declare const MSADS_ALL_CAMPAIGN_TYPES = "Search, Shopping, DynamicSearchAds, Audience, Hotel, PerformanceMax, App";
|
|
17
24
|
export declare function getEntityConfig(entityType: MsAdsEntityType): MsAdsEntityConfig;
|
|
18
25
|
export declare function getSupportedEntityTypes(): MsAdsEntityType[];
|
|
19
26
|
export declare function getEntityTypeEnum(): [string, ...string[]];
|
|
27
|
+
export declare function getDuplicateSupportedEntityTypes(): MsAdsEntityType[];
|
|
28
|
+
export declare function getDuplicateEntityTypeEnum(): [string, ...string[]];
|
|
29
|
+
export declare function getWriteParent(entityType: MsAdsEntityType): {
|
|
30
|
+
bodyField: MsAdsWriteParentIdField;
|
|
31
|
+
inputKey: "accountId" | "campaignId" | "adGroupId";
|
|
32
|
+
} | undefined;
|
|
33
|
+
export declare function missingWriteParentMessage(entityType: MsAdsEntityType, parentIds: {
|
|
34
|
+
accountId?: string;
|
|
35
|
+
campaignId?: string;
|
|
36
|
+
adGroupId?: string;
|
|
37
|
+
}): string | undefined;
|
|
38
|
+
export declare function missingDeleteParentMessage(entityType: MsAdsEntityType, params: Record<string, unknown> | undefined): string | undefined;
|
|
39
|
+
export type MsAdsEntityContextKey = "accountId" | "campaignId" | "adGroupId" | "adExtensionType";
|
|
40
|
+
export type MsAdsEntityContext = Partial<Record<MsAdsEntityContextKey, string>>;
|
|
41
|
+
export declare function getEntityContextKeys(entityType: MsAdsEntityType): MsAdsEntityContextKey[];
|
|
42
|
+
export declare function pickEntityContext(entityType: MsAdsEntityType, input: MsAdsEntityContext): MsAdsEntityContext;
|
|
43
|
+
export declare function entityContextReadParams(context: MsAdsEntityContext): Record<string, unknown>;
|
|
44
|
+
export declare function refineEntityContext(input: MsAdsEntityContext & {
|
|
45
|
+
entityType: string;
|
|
46
|
+
}, ctx: z.RefinementCtx): void;
|
|
20
47
|
//# sourceMappingURL=entity-mapping.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
export const MSADS_ALL_CAMPAIGN_TYPES = "Search, Shopping, DynamicSearchAds, Audience, Hotel, PerformanceMax, App";
|
|
2
4
|
const ENTITY_CONFIGS = {
|
|
3
5
|
campaign: {
|
|
4
6
|
addOperation: "/Campaigns",
|
|
@@ -12,6 +14,10 @@ const ENTITY_CONFIGS = {
|
|
|
12
14
|
idsField: "CampaignIds",
|
|
13
15
|
batchLimit: 100,
|
|
14
16
|
requiredGetByIdsFields: ["AccountId"],
|
|
17
|
+
supportsDuplicate: true,
|
|
18
|
+
writeParentIdField: "AccountId",
|
|
19
|
+
deleteParentIdFields: ["AccountId"],
|
|
20
|
+
defaultReadFields: { CampaignType: MSADS_ALL_CAMPAIGN_TYPES },
|
|
15
21
|
},
|
|
16
22
|
adGroup: {
|
|
17
23
|
addOperation: "/AdGroups",
|
|
@@ -26,6 +32,8 @@ const ENTITY_CONFIGS = {
|
|
|
26
32
|
idsField: "AdGroupIds",
|
|
27
33
|
batchLimit: 1000,
|
|
28
34
|
requiredGetByIdsFields: ["CampaignId"],
|
|
35
|
+
writeParentIdField: "CampaignId",
|
|
36
|
+
deleteParentIdFields: ["CampaignId"],
|
|
29
37
|
},
|
|
30
38
|
ad: {
|
|
31
39
|
addOperation: "/Ads",
|
|
@@ -40,6 +48,8 @@ const ENTITY_CONFIGS = {
|
|
|
40
48
|
idsField: "AdIds",
|
|
41
49
|
batchLimit: 50,
|
|
42
50
|
requiredGetByIdsFields: ["AdGroupId"],
|
|
51
|
+
writeParentIdField: "AdGroupId",
|
|
52
|
+
deleteParentIdFields: ["AdGroupId"],
|
|
43
53
|
},
|
|
44
54
|
keyword: {
|
|
45
55
|
addOperation: "/Keywords",
|
|
@@ -54,6 +64,8 @@ const ENTITY_CONFIGS = {
|
|
|
54
64
|
idsField: "KeywordIds",
|
|
55
65
|
batchLimit: 1000,
|
|
56
66
|
requiredGetByIdsFields: ["AdGroupId"],
|
|
67
|
+
writeParentIdField: "AdGroupId",
|
|
68
|
+
deleteParentIdFields: ["AdGroupId", "AssetGroupId"],
|
|
57
69
|
},
|
|
58
70
|
budget: {
|
|
59
71
|
addOperation: "/Budgets",
|
|
@@ -77,6 +89,8 @@ const ENTITY_CONFIGS = {
|
|
|
77
89
|
idsField: "AdExtensionIds",
|
|
78
90
|
batchLimit: 100,
|
|
79
91
|
requiredGetByIdsFields: ["AccountId", "AdExtensionType"],
|
|
92
|
+
writeParentIdField: "AccountId",
|
|
93
|
+
deleteParentIdFields: ["AccountId"],
|
|
80
94
|
},
|
|
81
95
|
audience: {
|
|
82
96
|
addOperation: "/Audiences",
|
|
@@ -115,4 +129,95 @@ export function getEntityTypeEnum() {
|
|
|
115
129
|
const types = getSupportedEntityTypes();
|
|
116
130
|
return types;
|
|
117
131
|
}
|
|
132
|
+
export function getDuplicateSupportedEntityTypes() {
|
|
133
|
+
return Object.entries(ENTITY_CONFIGS)
|
|
134
|
+
.filter(([, config]) => config.supportsDuplicate)
|
|
135
|
+
.map(([type]) => type);
|
|
136
|
+
}
|
|
137
|
+
export function getDuplicateEntityTypeEnum() {
|
|
138
|
+
return getDuplicateSupportedEntityTypes();
|
|
139
|
+
}
|
|
140
|
+
const PARENT_INPUT_KEYS = {
|
|
141
|
+
AccountId: "accountId",
|
|
142
|
+
CampaignId: "campaignId",
|
|
143
|
+
AdGroupId: "adGroupId",
|
|
144
|
+
};
|
|
145
|
+
export function getWriteParent(entityType) {
|
|
146
|
+
const field = getEntityConfig(entityType).writeParentIdField;
|
|
147
|
+
return field ? { bodyField: field, inputKey: PARENT_INPUT_KEYS[field] } : undefined;
|
|
148
|
+
}
|
|
149
|
+
export function missingWriteParentMessage(entityType, parentIds) {
|
|
150
|
+
const parent = getWriteParent(entityType);
|
|
151
|
+
if (!parent)
|
|
152
|
+
return undefined;
|
|
153
|
+
const value = parentIds[parent.inputKey];
|
|
154
|
+
if (typeof value === "string" && value.trim().length > 0)
|
|
155
|
+
return undefined;
|
|
156
|
+
return `${parent.inputKey} is required for entityType '${entityType}' — Microsoft Ads needs ${parent.bodyField} in the request body next to the ${getEntityConfig(entityType).pluralName} array`;
|
|
157
|
+
}
|
|
158
|
+
export function missingDeleteParentMessage(entityType, params) {
|
|
159
|
+
const config = getEntityConfig(entityType);
|
|
160
|
+
const fields = config.deleteParentIdFields ?? [];
|
|
161
|
+
if (fields.length === 0)
|
|
162
|
+
return undefined;
|
|
163
|
+
const present = fields.some((field) => {
|
|
164
|
+
const value = params?.[field];
|
|
165
|
+
if (typeof value === "number")
|
|
166
|
+
return Number.isFinite(value);
|
|
167
|
+
return typeof value === "string" && value.trim().length > 0;
|
|
168
|
+
});
|
|
169
|
+
if (present)
|
|
170
|
+
return undefined;
|
|
171
|
+
const names = fields.map((f) => `additionalParams.${f}`).join(" or ");
|
|
172
|
+
return `${names} is required for entityType '${entityType}' — Microsoft Ads' Delete${config.pluralName} request needs ${fields.join(" or ")} next to ${config.idsField}`;
|
|
173
|
+
}
|
|
174
|
+
const CONTEXT_INPUT_KEYS = {
|
|
175
|
+
AccountId: "accountId",
|
|
176
|
+
CampaignId: "campaignId",
|
|
177
|
+
AdGroupId: "adGroupId",
|
|
178
|
+
AdExtensionType: "adExtensionType",
|
|
179
|
+
};
|
|
180
|
+
export function getEntityContextKeys(entityType) {
|
|
181
|
+
return (getEntityConfig(entityType).requiredGetByIdsFields ?? []).map((field) => {
|
|
182
|
+
const key = CONTEXT_INPUT_KEYS[field];
|
|
183
|
+
if (!key)
|
|
184
|
+
throw new Error(`No tool input key for Get*ByIds field ${field}`);
|
|
185
|
+
return key;
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
export function pickEntityContext(entityType, input) {
|
|
189
|
+
const picked = {};
|
|
190
|
+
for (const key of getEntityContextKeys(entityType)) {
|
|
191
|
+
const value = input[key];
|
|
192
|
+
if (typeof value === "string")
|
|
193
|
+
picked[key] = value;
|
|
194
|
+
}
|
|
195
|
+
return picked;
|
|
196
|
+
}
|
|
197
|
+
export function entityContextReadParams(context) {
|
|
198
|
+
const params = {};
|
|
199
|
+
if (context.accountId !== undefined)
|
|
200
|
+
params.AccountId = Number(context.accountId);
|
|
201
|
+
if (context.campaignId !== undefined)
|
|
202
|
+
params.CampaignId = Number(context.campaignId);
|
|
203
|
+
if (context.adGroupId !== undefined)
|
|
204
|
+
params.AdGroupId = Number(context.adGroupId);
|
|
205
|
+
if (context.adExtensionType !== undefined)
|
|
206
|
+
params.AdExtensionType = context.adExtensionType;
|
|
207
|
+
return params;
|
|
208
|
+
}
|
|
209
|
+
export function refineEntityContext(input, ctx) {
|
|
210
|
+
if (!(input.entityType in ENTITY_CONFIGS))
|
|
211
|
+
return;
|
|
212
|
+
for (const key of getEntityContextKeys(input.entityType)) {
|
|
213
|
+
const value = input[key];
|
|
214
|
+
if (typeof value !== "string" || value.trim().length === 0) {
|
|
215
|
+
ctx.addIssue({
|
|
216
|
+
code: z.ZodIssueCode.custom,
|
|
217
|
+
path: [key],
|
|
218
|
+
message: `${key} is required when entityType is ${input.entityType}`,
|
|
219
|
+
});
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
}
|
|
118
223
|
//# sourceMappingURL=entity-mapping.js.map
|