@cesteral/msads-mcp 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cesteral-manifest.json +22 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +16 -16
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +92 -74
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +48 -25
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +4 -4
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +1929 -17
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +173 -11
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +11 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js +113 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts +13 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.js +98 -0
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts +11 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -0
- package/dist/testkit/fixtures/index.js +246 -0
- package/dist/testkit/fixtures/index.js.map +1 -0
- package/dist/testkit/index.d.ts +6 -0
- package/dist/testkit/index.d.ts.map +1 -0
- package/dist/testkit/index.js +26 -0
- package/dist/testkit/index.js.map +1 -0
- package/dist/testkit/types.d.ts +17 -0
- package/dist/testkit/types.d.ts.map +1 -0
- package/dist/testkit/types.js +2 -0
- package/dist/testkit/types.js.map +1 -0
- package/package.json +12 -2
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +0 -68
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +0 -1
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +0 -90
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +0 -1
- package/dist/types-global/mcp.d.ts +0 -2
- package/dist/types-global/mcp.d.ts.map +0 -1
- package/dist/types-global/mcp.js +0 -2
- package/dist/types-global/mcp.js.map +0 -1
- package/dist/utils/errors/index.d.ts +0 -2
- package/dist/utils/errors/index.d.ts.map +0 -1
- package/dist/utils/errors/index.js +0 -2
- package/dist/utils/errors/index.js.map +0 -1
- package/dist/utils/security/rate-limiter.d.ts +0 -3
- package/dist/utils/security/rate-limiter.d.ts.map +0 -1
- package/dist/utils/security/rate-limiter.js +0 -5
- package/dist/utils/security/rate-limiter.js.map +0 -1
- package/dist/utils/telemetry/index.d.ts +0 -2
- package/dist/utils/telemetry/index.d.ts.map +0 -1
- package/dist/utils/telemetry/index.js +0 -2
- package/dist/utils/telemetry/index.js.map +0 -1
- package/dist/utils/telemetry/tracing.d.ts +0 -3
- package/dist/utils/telemetry/tracing.d.ts.map +0 -1
- package/dist/utils/telemetry/tracing.js +0 -4
- package/dist/utils/telemetry/tracing.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,39 +1,172 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
-
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
3
|
+
import { getEntityConfig, getEntityTypeEnum, } from "../utils/entity-mapping.js";
|
|
4
|
+
import { runMsAdsUpdateDryRun, resolveMsAdsDispatchedCapability } from "../utils/dry-run.js";
|
|
5
|
+
import { captureMsAdsSnapshot, snapshotFromMsAdsEntity } from "../utils/capture-snapshot.js";
|
|
6
|
+
import { DryRunResultSchema, NormalizedEntitySnapshotSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
4
7
|
const TOOL_NAME = "msads_update_entity";
|
|
5
8
|
const TOOL_TITLE = "Update Microsoft Ads Entity";
|
|
6
9
|
const TOOL_DESCRIPTION = `Update an existing Microsoft Advertising entity.
|
|
7
10
|
|
|
8
|
-
|
|
9
|
-
|
|
11
|
+
**Supported entity types:** ${getEntityTypeEnum().join(", ")}
|
|
12
|
+
|
|
13
|
+
Provide the entity ID plus the partial fields to change in \`data\` — Microsoft Ads
|
|
14
|
+
supports partial updates, so only include fields you want to modify (do NOT include
|
|
15
|
+
\`Id\`; it is injected). The tool wraps the patch in the entity's plural collection key.
|
|
16
|
+
|
|
17
|
+
Some entity types require parent/account context so the read partner can capture
|
|
18
|
+
before/after snapshots: campaign needs \`accountId\`, adGroup needs \`campaignId\`,
|
|
19
|
+
ad needs \`adGroupId\`.`;
|
|
20
|
+
const dataField = z
|
|
21
|
+
.record(z.unknown())
|
|
22
|
+
.describe("Partial fields to update (do not include Id — it is injected)");
|
|
23
|
+
const dryRunField = z
|
|
24
|
+
.boolean()
|
|
25
|
+
.optional()
|
|
26
|
+
.default(false)
|
|
27
|
+
.describe("When true, validates the proposed mutation and returns a DryRunResult under `dryRun` without invoking the Microsoft Ads API. The underlying entity is never modified.");
|
|
10
28
|
export const UpdateEntityInputSchema = z
|
|
11
|
-
.
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
29
|
+
.discriminatedUnion("entityType", [
|
|
30
|
+
z.object({
|
|
31
|
+
entityType: z.literal("campaign"),
|
|
32
|
+
entityId: z.string().min(1).describe("The campaign ID to update"),
|
|
33
|
+
accountId: z.string().min(1).describe("AccountId required to read the campaign back"),
|
|
34
|
+
data: dataField,
|
|
35
|
+
dry_run: dryRunField,
|
|
36
|
+
}),
|
|
37
|
+
z.object({
|
|
38
|
+
entityType: z.literal("adGroup"),
|
|
39
|
+
entityId: z.string().min(1).describe("The ad group ID to update"),
|
|
40
|
+
campaignId: z.string().min(1).describe("CampaignId required to read the ad group back"),
|
|
41
|
+
data: dataField,
|
|
42
|
+
dry_run: dryRunField,
|
|
43
|
+
}),
|
|
44
|
+
z.object({
|
|
45
|
+
entityType: z.literal("ad"),
|
|
46
|
+
entityId: z.string().min(1).describe("The ad ID to update"),
|
|
47
|
+
adGroupId: z.string().min(1).describe("AdGroupId required to read the ad back"),
|
|
48
|
+
data: dataField,
|
|
49
|
+
dry_run: dryRunField,
|
|
50
|
+
}),
|
|
51
|
+
z.object({
|
|
52
|
+
entityType: z.literal("keyword"),
|
|
53
|
+
entityId: z.string().min(1).describe("The keyword ID to update"),
|
|
54
|
+
adGroupId: z.string().min(1).describe("AdGroupId required to read the keyword back"),
|
|
55
|
+
data: dataField,
|
|
56
|
+
dry_run: dryRunField,
|
|
57
|
+
}),
|
|
58
|
+
z.object({
|
|
59
|
+
entityType: z.literal("budget"),
|
|
60
|
+
entityId: z.string().min(1).describe("The budget ID to update"),
|
|
61
|
+
data: dataField,
|
|
62
|
+
dry_run: dryRunField,
|
|
63
|
+
}),
|
|
64
|
+
z.object({
|
|
65
|
+
entityType: z.literal("adExtension"),
|
|
66
|
+
entityId: z.string().min(1).describe("The ad extension ID to update"),
|
|
67
|
+
accountId: z.string().min(1).describe("AccountId required to read the ad extension back"),
|
|
68
|
+
adExtensionType: z.string().min(1).describe("AdExtensionType required for the read"),
|
|
69
|
+
data: dataField,
|
|
70
|
+
dry_run: dryRunField,
|
|
71
|
+
}),
|
|
72
|
+
z.object({
|
|
73
|
+
entityType: z.literal("audience"),
|
|
74
|
+
entityId: z.string().min(1).describe("The audience ID to update"),
|
|
75
|
+
data: dataField,
|
|
76
|
+
dry_run: dryRunField,
|
|
77
|
+
}),
|
|
78
|
+
z.object({
|
|
79
|
+
entityType: z.literal("label"),
|
|
80
|
+
entityId: z.string().min(1).describe("The label ID to update"),
|
|
81
|
+
data: dataField,
|
|
82
|
+
dry_run: dryRunField,
|
|
83
|
+
}),
|
|
84
|
+
])
|
|
15
85
|
.describe("Parameters for updating a Microsoft Ads entity");
|
|
16
86
|
export const UpdateEntityOutputSchema = z
|
|
17
87
|
.object({
|
|
18
88
|
result: z.record(z.any()),
|
|
89
|
+
entityId: z.string(),
|
|
19
90
|
entityType: z.string(),
|
|
91
|
+
updated: z.boolean(),
|
|
20
92
|
timestamp: z.string().datetime(),
|
|
93
|
+
dryRun: DryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. The mutation was NOT applied."),
|
|
94
|
+
before: NormalizedEntitySnapshotSchema.optional().describe("Pre-write canonical snapshot of the entity, captured at the start of the handler. Populated for governed entity types (campaign, adGroup, ad, budget) when the read partner returns the entity. Undefined for out-of-scope types or when the pre-read fails."),
|
|
95
|
+
after: NormalizedEntitySnapshotSchema.optional().describe("Post-write canonical snapshot of the entity, derived from the submitted patch merged onto the pre-read (re-read fallback). Undefined when the entity type is out of canonical scope or both reads fail."),
|
|
96
|
+
dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to, derived from the `data` payload. Present on every response — dry-run and real write alike."),
|
|
21
97
|
})
|
|
22
98
|
.describe("Entity update result");
|
|
99
|
+
function buildReadParams(input) {
|
|
100
|
+
const params = {};
|
|
101
|
+
if ("accountId" in input)
|
|
102
|
+
params.AccountId = Number(input.accountId);
|
|
103
|
+
if ("campaignId" in input)
|
|
104
|
+
params.CampaignId = Number(input.campaignId);
|
|
105
|
+
if ("adGroupId" in input)
|
|
106
|
+
params.AdGroupId = Number(input.adGroupId);
|
|
107
|
+
if ("adExtensionType" in input)
|
|
108
|
+
params.AdExtensionType = input.adExtensionType;
|
|
109
|
+
return params;
|
|
110
|
+
}
|
|
23
111
|
export async function updateEntityLogic(input, context, sdkContext) {
|
|
24
112
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
25
|
-
const
|
|
113
|
+
const dispatchedCapability = resolveMsAdsDispatchedCapability(input.entityType, input.data);
|
|
114
|
+
const readParams = buildReadParams(input);
|
|
115
|
+
if (input.dry_run === true) {
|
|
116
|
+
const dryRun = await runMsAdsUpdateDryRun({
|
|
117
|
+
entityType: input.entityType,
|
|
118
|
+
entityId: input.entityId,
|
|
119
|
+
data: input.data,
|
|
120
|
+
readParams,
|
|
121
|
+
}, msadsService, context);
|
|
122
|
+
return {
|
|
123
|
+
result: {},
|
|
124
|
+
entityId: input.entityId,
|
|
125
|
+
entityType: input.entityType,
|
|
126
|
+
updated: false,
|
|
127
|
+
timestamp: new Date().toISOString(),
|
|
128
|
+
dryRun,
|
|
129
|
+
dispatchedCapability,
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
const before = await captureMsAdsSnapshot(msadsService, input.entityType, input.entityId, readParams, context);
|
|
133
|
+
const config = getEntityConfig(input.entityType);
|
|
134
|
+
const entityItem = { Id: Number(input.entityId), ...input.data };
|
|
135
|
+
const payload = { [config.pluralName]: [entityItem] };
|
|
136
|
+
const result = (await msadsService.updateEntity(input.entityType, payload, context));
|
|
137
|
+
let after = await captureMsAdsSnapshot(msadsService, input.entityType, input.entityId, readParams, context);
|
|
138
|
+
if (!after) {
|
|
139
|
+
after = snapshotFromMsAdsEntity(input.entityType, input.entityId, entityItem);
|
|
140
|
+
}
|
|
26
141
|
return {
|
|
27
142
|
result,
|
|
143
|
+
entityId: input.entityId,
|
|
28
144
|
entityType: input.entityType,
|
|
145
|
+
updated: true,
|
|
29
146
|
timestamp: new Date().toISOString(),
|
|
147
|
+
...(before ? { before } : {}),
|
|
148
|
+
...(after ? { after } : {}),
|
|
149
|
+
dispatchedCapability,
|
|
30
150
|
};
|
|
31
151
|
}
|
|
32
152
|
export function updateEntityResponseFormatter(result) {
|
|
153
|
+
if (result.dryRun) {
|
|
154
|
+
const { wouldSucceed, validationErrors, validationSource, expectedStateSource } = result.dryRun;
|
|
155
|
+
const verdict = wouldSucceed ? "would succeed" : "would FAIL";
|
|
156
|
+
const errorLines = validationErrors.length
|
|
157
|
+
? "\n" + validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n")
|
|
158
|
+
: "";
|
|
159
|
+
return [
|
|
160
|
+
{
|
|
161
|
+
type: "text",
|
|
162
|
+
text: `Dry run: mutation ${verdict} (validation: ${validationSource}, expected-state: ${expectedStateSource}). The entity was NOT modified.${errorLines}\n\nTimestamp: ${result.timestamp}`,
|
|
163
|
+
},
|
|
164
|
+
];
|
|
165
|
+
}
|
|
33
166
|
return [
|
|
34
167
|
{
|
|
35
168
|
type: "text",
|
|
36
|
-
text: `Updated ${result.entityType}
|
|
169
|
+
text: `Updated ${result.entityType} ${result.entityId}\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
37
170
|
},
|
|
38
171
|
];
|
|
39
172
|
}
|
|
@@ -48,13 +181,42 @@ export const updateEntityTool = {
|
|
|
48
181
|
openWorldHint: false,
|
|
49
182
|
idempotentHint: true,
|
|
50
183
|
destructiveHint: false,
|
|
184
|
+
cesteral: {
|
|
185
|
+
kind: "write",
|
|
186
|
+
platform: "msads",
|
|
187
|
+
contractPlatformSlug: "msads",
|
|
188
|
+
contractToolSlug: "update_entity",
|
|
189
|
+
operation: ["update_budget", "pause", "resume", "update_status", "update"],
|
|
190
|
+
entityKinds: ["campaign", "ad_group", "ad", "campaign_budget"],
|
|
191
|
+
entityIdArgs: ["entityId"],
|
|
192
|
+
readPartner: {
|
|
193
|
+
toolName: "msads_get_entity",
|
|
194
|
+
argMap: { entityType: "entityType", entityId: "entityId" },
|
|
195
|
+
},
|
|
196
|
+
schemaVersion: 1,
|
|
197
|
+
contractId: "msads.update_entity.v1",
|
|
198
|
+
supportsDryRun: true,
|
|
199
|
+
supportsBeforeAfterSnapshot: true,
|
|
200
|
+
requiresValidation: true,
|
|
201
|
+
requiresSimulation: true,
|
|
202
|
+
},
|
|
51
203
|
},
|
|
52
204
|
inputExamples: [
|
|
53
205
|
{
|
|
54
|
-
label: "
|
|
206
|
+
label: "Pause a campaign",
|
|
55
207
|
input: {
|
|
56
208
|
entityType: "campaign",
|
|
57
|
-
|
|
209
|
+
entityId: "123456",
|
|
210
|
+
accountId: "789012",
|
|
211
|
+
data: { Status: "Paused" },
|
|
212
|
+
},
|
|
213
|
+
},
|
|
214
|
+
{
|
|
215
|
+
label: "Update a shared budget amount",
|
|
216
|
+
input: {
|
|
217
|
+
entityType: "budget",
|
|
218
|
+
entityId: "555000",
|
|
219
|
+
data: { Amount: 250 },
|
|
58
220
|
},
|
|
59
221
|
},
|
|
60
222
|
],
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"update-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,
|
|
1
|
+
{"version":3,"file":"update-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { CanonicalEntityKind, NormalizedEntitySnapshot, RequestContext } from "@cesteral/shared";
|
|
2
|
+
export interface MsAdsServiceLike {
|
|
3
|
+
getEntity?: (entityType: any, entityIds: string[], params?: Record<string, unknown>, context?: RequestContext) => Promise<{
|
|
4
|
+
entities: unknown[];
|
|
5
|
+
}>;
|
|
6
|
+
}
|
|
7
|
+
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>): NormalizedEntitySnapshot | null;
|
|
9
|
+
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>): NormalizedEntitySnapshot | undefined;
|
|
11
|
+
//# sourceMappingURL=capture-snapshot.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capture-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"AAuBA,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;CACvC;AAMD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAK/D,CAAC;AAuDF,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,GAC7B,wBAAwB,GAAG,IAAI,CA+CjC;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,CAW/C;AAUD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,wBAAwB,GAAG,SAAS,CActC"}
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
export const ENTITY_KIND_MAP = {
|
|
2
|
+
campaign: "campaign",
|
|
3
|
+
adGroup: "ad_group",
|
|
4
|
+
ad: "ad",
|
|
5
|
+
budget: "campaign_budget",
|
|
6
|
+
};
|
|
7
|
+
const STATUS_MAP = {
|
|
8
|
+
Active: "active",
|
|
9
|
+
Paused: "paused",
|
|
10
|
+
BudgetPaused: "paused",
|
|
11
|
+
BudgetAndManualPaused: "paused",
|
|
12
|
+
Suspended: "paused",
|
|
13
|
+
Expired: "paused",
|
|
14
|
+
Inactive: "paused",
|
|
15
|
+
Deleted: "deleted",
|
|
16
|
+
};
|
|
17
|
+
function normalizeStatus(raw) {
|
|
18
|
+
const platformRaw = typeof raw === "string" ? raw : "";
|
|
19
|
+
return { canonical: STATUS_MAP[platformRaw] ?? "unknown", platformRaw };
|
|
20
|
+
}
|
|
21
|
+
function toMinor(amount) {
|
|
22
|
+
if (amount == null)
|
|
23
|
+
return undefined;
|
|
24
|
+
const n = typeof amount === "string" ? Number(amount) : Number(amount);
|
|
25
|
+
if (!Number.isFinite(n))
|
|
26
|
+
return undefined;
|
|
27
|
+
return Math.round(n * 100);
|
|
28
|
+
}
|
|
29
|
+
function dateToIso(raw) {
|
|
30
|
+
if (!raw || typeof raw !== "object")
|
|
31
|
+
return null;
|
|
32
|
+
const d = raw;
|
|
33
|
+
const year = Number(d.Year);
|
|
34
|
+
const month = Number(d.Month);
|
|
35
|
+
const day = Number(d.Day);
|
|
36
|
+
if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day))
|
|
37
|
+
return null;
|
|
38
|
+
const pad = (n) => String(n).padStart(2, "0");
|
|
39
|
+
return `${year}-${pad(month)}-${pad(day)}`;
|
|
40
|
+
}
|
|
41
|
+
export function buildMsAdsSnapshot(entityType, entityId, current, patch) {
|
|
42
|
+
const entityKind = ENTITY_KIND_MAP[entityType];
|
|
43
|
+
if (!entityKind)
|
|
44
|
+
return null;
|
|
45
|
+
const merged = { ...current, ...patch };
|
|
46
|
+
let daily = null;
|
|
47
|
+
let lifetime = null;
|
|
48
|
+
const currency = "USD";
|
|
49
|
+
if (entityKind === "campaign_budget") {
|
|
50
|
+
const amountMinor = toMinor(merged.Amount);
|
|
51
|
+
if (amountMinor != null) {
|
|
52
|
+
const money = { amountMinor, currency };
|
|
53
|
+
if (merged.BudgetType === "MonthlyBudgetSpendUntilDepleted") {
|
|
54
|
+
lifetime = money;
|
|
55
|
+
}
|
|
56
|
+
else {
|
|
57
|
+
daily = money;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
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
|
+
return {
|
|
70
|
+
schemaVersion: 1,
|
|
71
|
+
platform: "msads",
|
|
72
|
+
entityKind,
|
|
73
|
+
platformEntityId: entityId,
|
|
74
|
+
displayName: typeof merged.Name === "string" ? merged.Name : null,
|
|
75
|
+
accountId: merged.AccountId != null ? String(merged.AccountId) : null,
|
|
76
|
+
status: normalizeStatus(merged.Status),
|
|
77
|
+
budget: { daily, lifetime },
|
|
78
|
+
schedule: {
|
|
79
|
+
startAt: dateToIso(merged.StartDate),
|
|
80
|
+
endAt: dateToIso(merged.EndDate),
|
|
81
|
+
},
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
export async function captureMsAdsSnapshot(service, entityType, entityId, params, context) {
|
|
85
|
+
if (!ENTITY_KIND_MAP[entityType] || !service.getEntity)
|
|
86
|
+
return undefined;
|
|
87
|
+
try {
|
|
88
|
+
const { entities } = await service.getEntity(entityType, [entityId], params, context);
|
|
89
|
+
const current = entities?.[0];
|
|
90
|
+
if (!current || typeof current !== "object")
|
|
91
|
+
return undefined;
|
|
92
|
+
const snapshot = buildMsAdsSnapshot(entityType, entityId, current, {});
|
|
93
|
+
return snapshot ?? undefined;
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
return undefined;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
export function snapshotFromMsAdsEntity(entityType, entityId, entity) {
|
|
100
|
+
if (!ENTITY_KIND_MAP[entityType])
|
|
101
|
+
return undefined;
|
|
102
|
+
if (!entity ||
|
|
103
|
+
(entity.Status == null &&
|
|
104
|
+
entity.Name == null &&
|
|
105
|
+
entity.Amount == null &&
|
|
106
|
+
entity.DailyBudget == null &&
|
|
107
|
+
entity.MonthlyBudget == null)) {
|
|
108
|
+
return undefined;
|
|
109
|
+
}
|
|
110
|
+
const snapshot = buildMsAdsSnapshot(entityType, entityId, entity, {});
|
|
111
|
+
return snapshot ?? undefined;
|
|
112
|
+
}
|
|
113
|
+
//# sourceMappingURL=capture-snapshot.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capture-snapshot.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/capture-snapshot.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { DispatchedCapability, DryRunResult, NormalizedEntitySnapshot, RequestContext } from "@cesteral/shared";
|
|
2
|
+
import { type MsAdsServiceLike } from "./capture-snapshot.js";
|
|
3
|
+
export type { MsAdsServiceLike };
|
|
4
|
+
export declare function applyMsAdsPatch(entityType: string, entityId: string, preState: Record<string, unknown>, data: Record<string, unknown>): NormalizedEntitySnapshot | undefined;
|
|
5
|
+
export declare function resolveMsAdsDispatchedCapability(entityType: string, data: Record<string, unknown>): DispatchedCapability;
|
|
6
|
+
export interface MsAdsDryRunArgs {
|
|
7
|
+
entityType: string;
|
|
8
|
+
entityId: string;
|
|
9
|
+
data: Record<string, unknown>;
|
|
10
|
+
readParams: Record<string, unknown>;
|
|
11
|
+
}
|
|
12
|
+
export declare function runMsAdsUpdateDryRun(input: MsAdsDryRunArgs, service: MsAdsServiceLike, context: RequestContext): Promise<DryRunResult>;
|
|
13
|
+
//# sourceMappingURL=dry-run.d.ts.map
|
|
@@ -0,0 +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,EAEZ,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnG,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAqEjC,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,GAC5B,wBAAwB,GAAG,SAAS,CAGtC;AAQD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,oBAAoB,CAmBtB;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,CAoCvB"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { assertGovernedDryRunResult } from "@cesteral/shared";
|
|
2
|
+
import { buildMsAdsSnapshot, ENTITY_KIND_MAP } from "./capture-snapshot.js";
|
|
3
|
+
const VALID_STATUSES = [
|
|
4
|
+
"Active",
|
|
5
|
+
"Paused",
|
|
6
|
+
"BudgetPaused",
|
|
7
|
+
"BudgetAndManualPaused",
|
|
8
|
+
"Suspended",
|
|
9
|
+
"Expired",
|
|
10
|
+
"Deleted",
|
|
11
|
+
];
|
|
12
|
+
const ACTIVE_STATUSES = new Set(["Active"]);
|
|
13
|
+
const PAUSED_STATUSES = new Set([
|
|
14
|
+
"Paused",
|
|
15
|
+
"BudgetPaused",
|
|
16
|
+
"BudgetAndManualPaused",
|
|
17
|
+
"Suspended",
|
|
18
|
+
"Expired",
|
|
19
|
+
]);
|
|
20
|
+
const BUDGET_FIELDS = ["Amount", "DailyBudget", "MonthlyBudget"];
|
|
21
|
+
function symbolicValidate(data) {
|
|
22
|
+
const errors = [];
|
|
23
|
+
if ("Status" in data) {
|
|
24
|
+
const status = data.Status;
|
|
25
|
+
if (typeof status !== "string" || !VALID_STATUSES.includes(status)) {
|
|
26
|
+
errors.push({
|
|
27
|
+
code: "INVALID_STATUS",
|
|
28
|
+
message: `Status must be one of ${VALID_STATUSES.join(", ")} — got ${String(status)}`,
|
|
29
|
+
field: "data.Status",
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
for (const field of BUDGET_FIELDS) {
|
|
34
|
+
if (field in data && data[field] != null) {
|
|
35
|
+
const raw = data[field];
|
|
36
|
+
const n = typeof raw === "string" ? Number(raw) : Number(raw);
|
|
37
|
+
if (!Number.isFinite(n) || n < 0) {
|
|
38
|
+
errors.push({
|
|
39
|
+
code: "INVALID_BUDGET",
|
|
40
|
+
message: `${field} must be a non-negative number (account currency major units)`,
|
|
41
|
+
field: `data.${field}`,
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return errors;
|
|
47
|
+
}
|
|
48
|
+
export function applyMsAdsPatch(entityType, entityId, preState, data) {
|
|
49
|
+
const snapshot = buildMsAdsSnapshot(entityType, entityId, preState, data);
|
|
50
|
+
return snapshot ?? undefined;
|
|
51
|
+
}
|
|
52
|
+
export function resolveMsAdsDispatchedCapability(entityType, data) {
|
|
53
|
+
const status = typeof data.Status === "string" ? data.Status : undefined;
|
|
54
|
+
let operation;
|
|
55
|
+
if (status && ACTIVE_STATUSES.has(status)) {
|
|
56
|
+
operation = "resume";
|
|
57
|
+
}
|
|
58
|
+
else if (status && PAUSED_STATUSES.has(status)) {
|
|
59
|
+
operation = "pause";
|
|
60
|
+
}
|
|
61
|
+
else if (status) {
|
|
62
|
+
operation = "update_status";
|
|
63
|
+
}
|
|
64
|
+
else if (BUDGET_FIELDS.some((f) => f in data)) {
|
|
65
|
+
operation = "update_budget";
|
|
66
|
+
}
|
|
67
|
+
else {
|
|
68
|
+
operation = "update";
|
|
69
|
+
}
|
|
70
|
+
return {
|
|
71
|
+
operation,
|
|
72
|
+
canonicalEntityKind: ENTITY_KIND_MAP[entityType] ?? entityType ?? "unknown",
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
export async function runMsAdsUpdateDryRun(input, service, context) {
|
|
76
|
+
const validationErrors = symbolicValidate(input.data);
|
|
77
|
+
let expectedPostState;
|
|
78
|
+
let expectedStateSource = "none";
|
|
79
|
+
if (ENTITY_KIND_MAP[input.entityType] && service.getEntity) {
|
|
80
|
+
const { entities } = await service.getEntity(input.entityType, [input.entityId], input.readParams, context);
|
|
81
|
+
const current = entities?.[0];
|
|
82
|
+
if (current && typeof current === "object") {
|
|
83
|
+
const snapshot = buildMsAdsSnapshot(input.entityType, input.entityId, current, input.data);
|
|
84
|
+
if (snapshot) {
|
|
85
|
+
expectedPostState = snapshot;
|
|
86
|
+
expectedStateSource = "server_symbolic_apply";
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return assertGovernedDryRunResult({
|
|
91
|
+
wouldSucceed: validationErrors.length === 0,
|
|
92
|
+
validationErrors,
|
|
93
|
+
validationSource: "symbolic",
|
|
94
|
+
expectedStateSource,
|
|
95
|
+
...(expectedPostState ? { expectedPostState } : {}),
|
|
96
|
+
}, "msads_update_entity");
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=dry-run.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/dry-run.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { MsAdsWriteFixture } from "../types.js";
|
|
2
|
+
export declare const updateBudgetCampaign: MsAdsWriteFixture;
|
|
3
|
+
export declare const updateBudgetBudget: MsAdsWriteFixture;
|
|
4
|
+
export declare const pauseCampaign: MsAdsWriteFixture;
|
|
5
|
+
export declare const pauseAdGroup: MsAdsWriteFixture;
|
|
6
|
+
export declare const pauseAd: MsAdsWriteFixture;
|
|
7
|
+
export declare const resumeCampaign: MsAdsWriteFixture;
|
|
8
|
+
export declare const resumeAdGroup: MsAdsWriteFixture;
|
|
9
|
+
export declare const resumeAd: MsAdsWriteFixture;
|
|
10
|
+
export declare const allFixtures: readonly MsAdsWriteFixture[];
|
|
11
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testkit/fixtures/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKrD,eAAO,MAAM,oBAAoB,EAAE,iBA+BlC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,iBA6BhC,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,iBA+B3B,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,iBA2B1B,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,iBAyBrB,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,iBA+B5B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,iBA2B3B,CAAC;AAGF,eAAO,MAAM,QAAQ,EAAE,iBAyBtB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,iBAAiB,EASnD,CAAC"}
|