@cesteral/msads-mcp 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cesteral-manifest.json +87 -3
- package/dist/mcp-server/server.d.ts.map +1 -1
- package/dist/mcp-server/server.js +2 -1
- package/dist/mcp-server/server.js.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +89 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +96 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +42 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +101 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +4 -4
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +46 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +82 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +54 -13
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +109 -2
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +48 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +123 -4
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +48 -7
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +75 -4
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +8 -8
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +48 -7
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +63 -2
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +48 -7
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +63 -2
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +52 -11
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +64 -2
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +52 -7
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +96 -2
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +26 -1608
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +2 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.d.ts +6 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.js +27 -0
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.js +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
- package/dist/testkit/fixtures/index.d.ts +4 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -1
- package/dist/testkit/fixtures/index.js +102 -0
- package/dist/testkit/fixtures/index.js.map +1 -1
- package/dist/testkit/types.d.ts +2 -2
- package/dist/testkit/types.d.ts.map +1 -1
- package/package.json +2 -2
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
-
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
3
|
+
import { McpError, JsonRpcErrorCode, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
4
4
|
const TOOL_NAME = "msads_manage_ad_extensions";
|
|
5
5
|
const TOOL_TITLE = "Manage Microsoft Ads Ad Extensions";
|
|
6
6
|
const TOOL_DESCRIPTION = `Manage ad extensions in Microsoft Advertising — associate/disassociate extensions with campaigns or ad groups.
|
|
@@ -15,13 +15,21 @@ export const ManageAdExtensionsInputSchema = z
|
|
|
15
15
|
.enum(["setAssociations", "deleteAssociations", "getAssociations"])
|
|
16
16
|
.describe("Operation to perform"),
|
|
17
17
|
data: z.record(z.unknown()).describe("Operation data (varies by operation)"),
|
|
18
|
+
dry_run: z
|
|
19
|
+
.boolean()
|
|
20
|
+
.optional()
|
|
21
|
+
.default(false)
|
|
22
|
+
.describe("When true, validates the request and returns an EffectDryRunResult under `dryRun` without calling the Microsoft Ads API. No associations are changed."),
|
|
18
23
|
})
|
|
19
24
|
.describe("Parameters for managing ad extensions");
|
|
20
25
|
export const ManageAdExtensionsOutputSchema = z
|
|
21
26
|
.object({
|
|
22
|
-
result: z.record(z.any()),
|
|
27
|
+
result: z.record(z.any()).optional(),
|
|
23
28
|
operation: z.string(),
|
|
24
29
|
timestamp: z.string().datetime(),
|
|
30
|
+
dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No associations were changed."),
|
|
31
|
+
effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `ad_extensions_managed` + scalar audit summary). Present on a confirmed execute."),
|
|
32
|
+
dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `manage` with `canonicalEntityKind: null` (effect class). Present on every response."),
|
|
25
33
|
})
|
|
26
34
|
.describe("Ad extension management result");
|
|
27
35
|
const OPERATION_PATHS = {
|
|
@@ -30,19 +38,55 @@ const OPERATION_PATHS = {
|
|
|
30
38
|
getAssociations: { path: "/AdExtensionsAssociations/Query", method: "POST" },
|
|
31
39
|
};
|
|
32
40
|
export async function manageAdExtensionsLogic(input, context, sdkContext) {
|
|
41
|
+
const dispatchedCapability = {
|
|
42
|
+
operation: "manage",
|
|
43
|
+
canonicalEntityKind: null,
|
|
44
|
+
};
|
|
45
|
+
if (input.dry_run === true) {
|
|
46
|
+
return {
|
|
47
|
+
operation: input.operation,
|
|
48
|
+
timestamp: new Date().toISOString(),
|
|
49
|
+
dryRun: assertGovernedEffectDryRun({
|
|
50
|
+
wouldSucceed: true,
|
|
51
|
+
validationErrors: [],
|
|
52
|
+
validationSource: "symbolic",
|
|
53
|
+
expectedEffectSource: "symbolic",
|
|
54
|
+
expectedEffect: {
|
|
55
|
+
effectKind: "ad_extensions_managed",
|
|
56
|
+
summary: { operation: input.operation },
|
|
57
|
+
},
|
|
58
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true }),
|
|
59
|
+
dispatchedCapability,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
33
62
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
34
63
|
const op = OPERATION_PATHS[input.operation];
|
|
35
64
|
if (!op) {
|
|
36
65
|
throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown ad extension operation: ${input.operation}`);
|
|
37
66
|
}
|
|
38
67
|
const result = (await msadsService.executeOperation(op.path, input.data, context, op.method));
|
|
68
|
+
const effect = {
|
|
69
|
+
effectKind: "ad_extensions_managed",
|
|
70
|
+
summary: { operation: input.operation },
|
|
71
|
+
};
|
|
39
72
|
return {
|
|
40
73
|
result,
|
|
41
74
|
operation: input.operation,
|
|
42
75
|
timestamp: new Date().toISOString(),
|
|
76
|
+
effect,
|
|
77
|
+
dispatchedCapability,
|
|
43
78
|
};
|
|
44
79
|
}
|
|
45
80
|
export function manageAdExtensionsResponseFormatter(result) {
|
|
81
|
+
if (result.dryRun) {
|
|
82
|
+
const { wouldSucceed, validationSource, expectedEffectSource } = result.dryRun;
|
|
83
|
+
return [
|
|
84
|
+
{
|
|
85
|
+
type: "text",
|
|
86
|
+
text: `Dry run: ad extension ${result.operation} ${wouldSucceed ? "would succeed" : "would FAIL"} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No associations were changed.\n\nTimestamp: ${result.timestamp}`,
|
|
87
|
+
},
|
|
88
|
+
];
|
|
89
|
+
}
|
|
46
90
|
return [
|
|
47
91
|
{
|
|
48
92
|
type: "text",
|
|
@@ -61,6 +105,23 @@ export const manageAdExtensionsTool = {
|
|
|
61
105
|
openWorldHint: false,
|
|
62
106
|
idempotentHint: false,
|
|
63
107
|
destructiveHint: true,
|
|
108
|
+
cesteral: {
|
|
109
|
+
kind: "write",
|
|
110
|
+
writeClass: "effect",
|
|
111
|
+
executableArgsExclude: ["dry_run"],
|
|
112
|
+
platform: "msads",
|
|
113
|
+
contractPlatformSlug: "msads",
|
|
114
|
+
contractToolSlug: "manage_ad_extensions",
|
|
115
|
+
operation: ["manage"],
|
|
116
|
+
entityKinds: [],
|
|
117
|
+
entityIdArgs: [],
|
|
118
|
+
schemaVersion: 1,
|
|
119
|
+
contractId: "msads.manage_ad_extensions.v1",
|
|
120
|
+
supportsDryRun: true,
|
|
121
|
+
supportsBeforeAfterSnapshot: false,
|
|
122
|
+
requiresValidation: true,
|
|
123
|
+
requiresSimulation: true,
|
|
124
|
+
},
|
|
64
125
|
},
|
|
65
126
|
inputExamples: [
|
|
66
127
|
{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manage-ad-extensions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-ad-extensions.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":"manage-ad-extensions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-ad-extensions.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,33 +1,45 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext, EffectResult, DispatchedCapability } from "@cesteral/shared";
|
|
3
3
|
export declare const ManageCriterionsInputSchema: z.ZodObject<{
|
|
4
4
|
operation: z.ZodEnum<["add", "update", "delete", "getByCampaign", "getByAdGroup"]>;
|
|
5
5
|
entityLevel: z.ZodEnum<["campaign", "adGroup"]>;
|
|
6
6
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
7
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
7
8
|
}, "strip", z.ZodTypeAny, {
|
|
8
9
|
data: Record<string, unknown>;
|
|
9
|
-
|
|
10
|
+
dry_run: boolean;
|
|
11
|
+
operation: "update" | "delete" | "add" | "getByCampaign" | "getByAdGroup";
|
|
10
12
|
entityLevel: "campaign" | "adGroup";
|
|
11
13
|
}, {
|
|
12
14
|
data: Record<string, unknown>;
|
|
13
|
-
operation: "update" | "
|
|
15
|
+
operation: "update" | "delete" | "add" | "getByCampaign" | "getByAdGroup";
|
|
14
16
|
entityLevel: "campaign" | "adGroup";
|
|
17
|
+
dry_run?: boolean | undefined;
|
|
15
18
|
}>;
|
|
16
19
|
export declare const ManageCriterionsOutputSchema: z.ZodObject<{
|
|
17
|
-
result: z.ZodRecord<z.ZodString, z.ZodAny
|
|
20
|
+
result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
18
21
|
operation: z.ZodString;
|
|
19
22
|
entityLevel: z.ZodString;
|
|
20
23
|
timestamp: z.ZodString;
|
|
24
|
+
dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectDryRunResult, z.ZodTypeDef, import("@cesteral/contract-schema").EffectDryRunResult>>;
|
|
25
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
26
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
21
27
|
}, "strip", z.ZodTypeAny, {
|
|
22
28
|
timestamp: string;
|
|
23
|
-
|
|
29
|
+
dispatchedCapability: DispatchedCapability;
|
|
24
30
|
operation: string;
|
|
25
31
|
entityLevel: string;
|
|
32
|
+
result?: Record<string, any> | undefined;
|
|
33
|
+
dryRun?: import("@cesteral/contract-schema").EffectDryRunResult | undefined;
|
|
34
|
+
effect?: EffectResult | undefined;
|
|
26
35
|
}, {
|
|
27
36
|
timestamp: string;
|
|
28
|
-
|
|
37
|
+
dispatchedCapability: DispatchedCapability;
|
|
29
38
|
operation: string;
|
|
30
39
|
entityLevel: string;
|
|
40
|
+
result?: Record<string, any> | undefined;
|
|
41
|
+
dryRun?: import("@cesteral/contract-schema").EffectDryRunResult | undefined;
|
|
42
|
+
effect?: EffectResult | undefined;
|
|
31
43
|
}>;
|
|
32
44
|
type ManageCriterionsInput = z.infer<typeof ManageCriterionsInputSchema>;
|
|
33
45
|
type ManageCriterionsOutput = z.infer<typeof ManageCriterionsOutputSchema>;
|
|
@@ -41,36 +53,65 @@ export declare const manageCriterionsTool: {
|
|
|
41
53
|
operation: z.ZodEnum<["add", "update", "delete", "getByCampaign", "getByAdGroup"]>;
|
|
42
54
|
entityLevel: z.ZodEnum<["campaign", "adGroup"]>;
|
|
43
55
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
56
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
44
57
|
}, "strip", z.ZodTypeAny, {
|
|
45
58
|
data: Record<string, unknown>;
|
|
46
|
-
|
|
59
|
+
dry_run: boolean;
|
|
60
|
+
operation: "update" | "delete" | "add" | "getByCampaign" | "getByAdGroup";
|
|
47
61
|
entityLevel: "campaign" | "adGroup";
|
|
48
62
|
}, {
|
|
49
63
|
data: Record<string, unknown>;
|
|
50
|
-
operation: "update" | "
|
|
64
|
+
operation: "update" | "delete" | "add" | "getByCampaign" | "getByAdGroup";
|
|
51
65
|
entityLevel: "campaign" | "adGroup";
|
|
66
|
+
dry_run?: boolean | undefined;
|
|
52
67
|
}>;
|
|
53
68
|
outputSchema: z.ZodObject<{
|
|
54
|
-
result: z.ZodRecord<z.ZodString, z.ZodAny
|
|
69
|
+
result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
55
70
|
operation: z.ZodString;
|
|
56
71
|
entityLevel: z.ZodString;
|
|
57
72
|
timestamp: z.ZodString;
|
|
73
|
+
dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectDryRunResult, z.ZodTypeDef, import("@cesteral/contract-schema").EffectDryRunResult>>;
|
|
74
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
75
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
58
76
|
}, "strip", z.ZodTypeAny, {
|
|
59
77
|
timestamp: string;
|
|
60
|
-
|
|
78
|
+
dispatchedCapability: DispatchedCapability;
|
|
61
79
|
operation: string;
|
|
62
80
|
entityLevel: string;
|
|
81
|
+
result?: Record<string, any> | undefined;
|
|
82
|
+
dryRun?: import("@cesteral/contract-schema").EffectDryRunResult | undefined;
|
|
83
|
+
effect?: EffectResult | undefined;
|
|
63
84
|
}, {
|
|
64
85
|
timestamp: string;
|
|
65
|
-
|
|
86
|
+
dispatchedCapability: DispatchedCapability;
|
|
66
87
|
operation: string;
|
|
67
88
|
entityLevel: string;
|
|
89
|
+
result?: Record<string, any> | undefined;
|
|
90
|
+
dryRun?: import("@cesteral/contract-schema").EffectDryRunResult | undefined;
|
|
91
|
+
effect?: EffectResult | undefined;
|
|
68
92
|
}>;
|
|
69
93
|
annotations: {
|
|
70
94
|
readOnlyHint: boolean;
|
|
71
95
|
openWorldHint: boolean;
|
|
72
96
|
idempotentHint: boolean;
|
|
73
97
|
destructiveHint: boolean;
|
|
98
|
+
cesteral: {
|
|
99
|
+
kind: "write";
|
|
100
|
+
writeClass: "effect";
|
|
101
|
+
executableArgsExclude: string[];
|
|
102
|
+
platform: string;
|
|
103
|
+
contractPlatformSlug: string;
|
|
104
|
+
contractToolSlug: string;
|
|
105
|
+
operation: "manage"[];
|
|
106
|
+
entityKinds: never[];
|
|
107
|
+
entityIdArgs: never[];
|
|
108
|
+
schemaVersion: number;
|
|
109
|
+
contractId: string;
|
|
110
|
+
supportsDryRun: true;
|
|
111
|
+
supportsBeforeAfterSnapshot: false;
|
|
112
|
+
requiresValidation: true;
|
|
113
|
+
requiresSimulation: true;
|
|
114
|
+
};
|
|
74
115
|
};
|
|
75
116
|
inputExamples: {
|
|
76
117
|
label: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manage-criterions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-criterions.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"manage-criterions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-criterions.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,oBAAoB,EAErB,MAAM,kBAAkB,CAAC;AAa1B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAiBmB,CAAC;AAE5D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;EAgBC,CAAC;AAE3C,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACzE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAqB3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAuDjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAgBlB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChC,CAAC"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
-
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
3
|
+
import { McpError, JsonRpcErrorCode, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
4
4
|
const TOOL_NAME = "msads_manage_criterions";
|
|
5
5
|
const TOOL_TITLE = "Manage Microsoft Ads Targeting Criterions";
|
|
6
6
|
const TOOL_DESCRIPTION = `Manage targeting criterions for Microsoft Advertising campaigns and ad groups.
|
|
@@ -20,14 +20,22 @@ export const ManageCriterionsInputSchema = z
|
|
|
20
20
|
.enum(["campaign", "adGroup"])
|
|
21
21
|
.describe("Whether targeting is at campaign or ad group level"),
|
|
22
22
|
data: z.record(z.unknown()).describe("Operation data (varies by operation)"),
|
|
23
|
+
dry_run: z
|
|
24
|
+
.boolean()
|
|
25
|
+
.optional()
|
|
26
|
+
.default(false)
|
|
27
|
+
.describe("When true, validates the request and returns an EffectDryRunResult under `dryRun` without calling the Microsoft Ads API. No criterions are changed."),
|
|
23
28
|
})
|
|
24
29
|
.describe("Parameters for managing targeting criterions");
|
|
25
30
|
export const ManageCriterionsOutputSchema = z
|
|
26
31
|
.object({
|
|
27
|
-
result: z.record(z.any()),
|
|
32
|
+
result: z.record(z.any()).optional(),
|
|
28
33
|
operation: z.string(),
|
|
29
34
|
entityLevel: z.string(),
|
|
30
35
|
timestamp: z.string().datetime(),
|
|
36
|
+
dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No criterions were changed."),
|
|
37
|
+
effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `criterions_managed` + scalar audit summary incl. operation + entity level). Present on a confirmed execute."),
|
|
38
|
+
dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `manage` with `canonicalEntityKind: null` (effect class). Present on every response."),
|
|
31
39
|
})
|
|
32
40
|
.describe("Criterion management result");
|
|
33
41
|
function getOperation(operation, entityLevel) {
|
|
@@ -46,17 +54,54 @@ function getOperation(operation, entityLevel) {
|
|
|
46
54
|
return op;
|
|
47
55
|
}
|
|
48
56
|
export async function manageCriterionsLogic(input, context, sdkContext) {
|
|
57
|
+
const dispatchedCapability = {
|
|
58
|
+
operation: "manage",
|
|
59
|
+
canonicalEntityKind: null,
|
|
60
|
+
};
|
|
61
|
+
if (input.dry_run === true) {
|
|
62
|
+
return {
|
|
63
|
+
operation: input.operation,
|
|
64
|
+
entityLevel: input.entityLevel,
|
|
65
|
+
timestamp: new Date().toISOString(),
|
|
66
|
+
dryRun: assertGovernedEffectDryRun({
|
|
67
|
+
wouldSucceed: true,
|
|
68
|
+
validationErrors: [],
|
|
69
|
+
validationSource: "symbolic",
|
|
70
|
+
expectedEffectSource: "symbolic",
|
|
71
|
+
expectedEffect: {
|
|
72
|
+
effectKind: "criterions_managed",
|
|
73
|
+
summary: { operation: input.operation, entity_level: input.entityLevel },
|
|
74
|
+
},
|
|
75
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true }),
|
|
76
|
+
dispatchedCapability,
|
|
77
|
+
};
|
|
78
|
+
}
|
|
49
79
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
50
80
|
const op = getOperation(input.operation, input.entityLevel);
|
|
51
81
|
const result = (await msadsService.executeOperation(op.path, input.data, context, op.method));
|
|
82
|
+
const effect = {
|
|
83
|
+
effectKind: "criterions_managed",
|
|
84
|
+
summary: { operation: input.operation, entity_level: input.entityLevel },
|
|
85
|
+
};
|
|
52
86
|
return {
|
|
53
87
|
result,
|
|
54
88
|
operation: input.operation,
|
|
55
89
|
entityLevel: input.entityLevel,
|
|
56
90
|
timestamp: new Date().toISOString(),
|
|
91
|
+
effect,
|
|
92
|
+
dispatchedCapability,
|
|
57
93
|
};
|
|
58
94
|
}
|
|
59
95
|
export function manageCriterionsResponseFormatter(result) {
|
|
96
|
+
if (result.dryRun) {
|
|
97
|
+
const { wouldSucceed, validationSource, expectedEffectSource } = result.dryRun;
|
|
98
|
+
return [
|
|
99
|
+
{
|
|
100
|
+
type: "text",
|
|
101
|
+
text: `Dry run: ${result.entityLevel} criterion ${result.operation} ${wouldSucceed ? "would succeed" : "would FAIL"} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No criterions were changed.\n\nTimestamp: ${result.timestamp}`,
|
|
102
|
+
},
|
|
103
|
+
];
|
|
104
|
+
}
|
|
60
105
|
return [
|
|
61
106
|
{
|
|
62
107
|
type: "text",
|
|
@@ -75,6 +120,23 @@ export const manageCriterionsTool = {
|
|
|
75
120
|
openWorldHint: false,
|
|
76
121
|
idempotentHint: false,
|
|
77
122
|
destructiveHint: true,
|
|
123
|
+
cesteral: {
|
|
124
|
+
kind: "write",
|
|
125
|
+
writeClass: "effect",
|
|
126
|
+
executableArgsExclude: ["dry_run"],
|
|
127
|
+
platform: "msads",
|
|
128
|
+
contractPlatformSlug: "msads",
|
|
129
|
+
contractToolSlug: "manage_criterions",
|
|
130
|
+
operation: ["manage"],
|
|
131
|
+
entityKinds: [],
|
|
132
|
+
entityIdArgs: [],
|
|
133
|
+
schemaVersion: 1,
|
|
134
|
+
contractId: "msads.manage_criterions.v1",
|
|
135
|
+
supportsDryRun: true,
|
|
136
|
+
supportsBeforeAfterSnapshot: false,
|
|
137
|
+
requiresValidation: true,
|
|
138
|
+
requiresSimulation: true,
|
|
139
|
+
},
|
|
78
140
|
},
|
|
79
141
|
inputExamples: [
|
|
80
142
|
{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manage-criterions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-criterions.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":"manage-criterions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-criterions.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext, EffectResult, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
|
|
3
3
|
export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
4
4
|
reportType: z.ZodString;
|
|
5
5
|
accountId: z.ZodString;
|
|
@@ -8,9 +8,11 @@ export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
|
8
8
|
startDate: z.ZodOptional<z.ZodString>;
|
|
9
9
|
endDate: z.ZodOptional<z.ZodString>;
|
|
10
10
|
aggregation: z.ZodOptional<z.ZodString>;
|
|
11
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
11
12
|
}, "strip", z.ZodTypeAny, {
|
|
12
13
|
accountId: string;
|
|
13
14
|
reportType: string;
|
|
15
|
+
dry_run: boolean;
|
|
14
16
|
columns: string[];
|
|
15
17
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
16
18
|
startDate?: string | undefined;
|
|
@@ -20,6 +22,7 @@ export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
|
20
22
|
accountId: string;
|
|
21
23
|
reportType: string;
|
|
22
24
|
columns: string[];
|
|
25
|
+
dry_run?: boolean | undefined;
|
|
23
26
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
24
27
|
startDate?: string | undefined;
|
|
25
28
|
endDate?: string | undefined;
|
|
@@ -27,6 +30,7 @@ export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
|
27
30
|
}>, {
|
|
28
31
|
accountId: string;
|
|
29
32
|
reportType: string;
|
|
33
|
+
dry_run: boolean;
|
|
30
34
|
columns: string[];
|
|
31
35
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
32
36
|
startDate?: string | undefined;
|
|
@@ -36,20 +40,30 @@ export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
|
36
40
|
accountId: string;
|
|
37
41
|
reportType: string;
|
|
38
42
|
columns: string[];
|
|
43
|
+
dry_run?: boolean | undefined;
|
|
39
44
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
40
45
|
startDate?: string | undefined;
|
|
41
46
|
endDate?: string | undefined;
|
|
42
47
|
aggregation?: string | undefined;
|
|
43
48
|
}>;
|
|
44
49
|
export declare const SubmitReportOutputSchema: z.ZodObject<{
|
|
45
|
-
reportRequestId: z.ZodString
|
|
50
|
+
reportRequestId: z.ZodOptional<z.ZodString>;
|
|
46
51
|
timestamp: z.ZodString;
|
|
52
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
|
|
53
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
54
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
47
55
|
}, "strip", z.ZodTypeAny, {
|
|
48
|
-
reportRequestId: string;
|
|
49
56
|
timestamp: string;
|
|
57
|
+
dispatchedCapability: DispatchedCapability;
|
|
58
|
+
reportRequestId?: string | undefined;
|
|
59
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
60
|
+
effect?: EffectResult | undefined;
|
|
50
61
|
}, {
|
|
51
|
-
reportRequestId: string;
|
|
52
62
|
timestamp: string;
|
|
63
|
+
dispatchedCapability: DispatchedCapability;
|
|
64
|
+
reportRequestId?: string | undefined;
|
|
65
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
66
|
+
effect?: EffectResult | undefined;
|
|
53
67
|
}>;
|
|
54
68
|
type SubmitReportInput = z.infer<typeof SubmitReportInputSchema>;
|
|
55
69
|
type SubmitReportOutput = z.infer<typeof SubmitReportOutputSchema>;
|
|
@@ -67,9 +81,11 @@ export declare const submitReportTool: {
|
|
|
67
81
|
startDate: z.ZodOptional<z.ZodString>;
|
|
68
82
|
endDate: z.ZodOptional<z.ZodString>;
|
|
69
83
|
aggregation: z.ZodOptional<z.ZodString>;
|
|
84
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
70
85
|
}, "strip", z.ZodTypeAny, {
|
|
71
86
|
accountId: string;
|
|
72
87
|
reportType: string;
|
|
88
|
+
dry_run: boolean;
|
|
73
89
|
columns: string[];
|
|
74
90
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
75
91
|
startDate?: string | undefined;
|
|
@@ -79,6 +95,7 @@ export declare const submitReportTool: {
|
|
|
79
95
|
accountId: string;
|
|
80
96
|
reportType: string;
|
|
81
97
|
columns: string[];
|
|
98
|
+
dry_run?: boolean | undefined;
|
|
82
99
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
83
100
|
startDate?: string | undefined;
|
|
84
101
|
endDate?: string | undefined;
|
|
@@ -86,6 +103,7 @@ export declare const submitReportTool: {
|
|
|
86
103
|
}>, {
|
|
87
104
|
accountId: string;
|
|
88
105
|
reportType: string;
|
|
106
|
+
dry_run: boolean;
|
|
89
107
|
columns: string[];
|
|
90
108
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
91
109
|
startDate?: string | undefined;
|
|
@@ -95,26 +113,53 @@ export declare const submitReportTool: {
|
|
|
95
113
|
accountId: string;
|
|
96
114
|
reportType: string;
|
|
97
115
|
columns: string[];
|
|
116
|
+
dry_run?: boolean | undefined;
|
|
98
117
|
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
99
118
|
startDate?: string | undefined;
|
|
100
119
|
endDate?: string | undefined;
|
|
101
120
|
aggregation?: string | undefined;
|
|
102
121
|
}>;
|
|
103
122
|
outputSchema: z.ZodObject<{
|
|
104
|
-
reportRequestId: z.ZodString
|
|
123
|
+
reportRequestId: z.ZodOptional<z.ZodString>;
|
|
105
124
|
timestamp: z.ZodString;
|
|
125
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
|
|
126
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
|
|
127
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
|
|
106
128
|
}, "strip", z.ZodTypeAny, {
|
|
107
|
-
reportRequestId: string;
|
|
108
129
|
timestamp: string;
|
|
130
|
+
dispatchedCapability: DispatchedCapability;
|
|
131
|
+
reportRequestId?: string | undefined;
|
|
132
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
133
|
+
effect?: EffectResult | undefined;
|
|
109
134
|
}, {
|
|
110
|
-
reportRequestId: string;
|
|
111
135
|
timestamp: string;
|
|
136
|
+
dispatchedCapability: DispatchedCapability;
|
|
137
|
+
reportRequestId?: string | undefined;
|
|
138
|
+
dryRun?: EffectDryRunResult | undefined;
|
|
139
|
+
effect?: EffectResult | undefined;
|
|
112
140
|
}>;
|
|
113
141
|
annotations: {
|
|
114
142
|
readOnlyHint: boolean;
|
|
115
143
|
openWorldHint: boolean;
|
|
116
144
|
idempotentHint: boolean;
|
|
117
145
|
destructiveHint: boolean;
|
|
146
|
+
cesteral: {
|
|
147
|
+
kind: "write";
|
|
148
|
+
writeClass: "effect";
|
|
149
|
+
executableArgsExclude: string[];
|
|
150
|
+
platform: string;
|
|
151
|
+
contractPlatformSlug: string;
|
|
152
|
+
contractToolSlug: string;
|
|
153
|
+
operation: "submit_report"[];
|
|
154
|
+
entityKinds: never[];
|
|
155
|
+
entityIdArgs: never[];
|
|
156
|
+
schemaVersion: number;
|
|
157
|
+
contractId: string;
|
|
158
|
+
supportsDryRun: true;
|
|
159
|
+
supportsBeforeAfterSnapshot: false;
|
|
160
|
+
requiresValidation: true;
|
|
161
|
+
requiresSimulation: true;
|
|
162
|
+
};
|
|
118
163
|
};
|
|
119
164
|
inputExamples: {
|
|
120
165
|
label: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"submit-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"submit-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAQ1B,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkC2B,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EAmBE,CAAC;AAExC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAuDD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAuB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C5B,CAAC"}
|