@cesteral/msads-mcp 1.2.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -30
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
- package/dist/auth/msads-auth-adapter.js +1 -1
- package/dist/auth/msads-auth-adapter.js.map +1 -1
- package/dist/cesteral-manifest.json +140 -4
- package/dist/config/index.d.ts +36 -67
- package/dist/config/index.d.ts.map +1 -1
- package/dist/index.js +13 -23
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.d.ts +1 -1
- package/dist/mcp-server/prompts/index.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.js +15 -0
- package/dist/mcp-server/prompts/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/index.js +10 -9
- package/dist/mcp-server/resources/definitions/index.js.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.js +11 -11
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
- package/dist/mcp-server/server.d.ts +2 -1
- package/dist/mcp-server/server.d.ts.map +1 -1
- package/dist/mcp-server/server.js +29 -99
- package/dist/mcp-server/server.js.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +46 -111
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +158 -15
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +51 -44
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +125 -9
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +51 -51
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +132 -7
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +65 -97
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +128 -7
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +47 -35
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +99 -3
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +51 -100
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +113 -33
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +47 -53
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +129 -8
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +34 -40
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +79 -25
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +49 -38
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +101 -10
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/index.js +6 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +46 -37
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +106 -6
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +58 -47
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +111 -8
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +57 -89
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +97 -2
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +39 -1907
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +74 -85
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/index.d.ts +4 -1
- package/dist/mcp-server/tools/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/index.js +7 -1
- package/dist/mcp-server/tools/index.js.map +1 -1
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.d.ts +17 -2
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.js +71 -6
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
- package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
- package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
- package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
- package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.js +16 -51
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
- package/dist/services/msads/msads-http-client.d.ts +5 -1
- package/dist/services/msads/msads-http-client.d.ts.map +1 -1
- package/dist/services/msads/msads-http-client.js +49 -2
- package/dist/services/msads/msads-http-client.js.map +1 -1
- package/dist/services/msads/msads-reporting-service.d.ts +3 -9
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
- package/dist/services/msads/msads-reporting-service.js +62 -27
- package/dist/services/msads/msads-reporting-service.js.map +1 -1
- package/dist/services/msads/msads-service.d.ts +53 -5
- package/dist/services/msads/msads-service.d.ts.map +1 -1
- package/dist/services/msads/msads-service.js +235 -35
- package/dist/services/msads/msads-service.js.map +1 -1
- package/dist/services/msads/partial-errors.d.ts +34 -0
- package/dist/services/msads/partial-errors.d.ts.map +1 -0
- package/dist/services/msads/partial-errors.js +149 -0
- package/dist/services/msads/partial-errors.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +8 -2
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
- package/dist/services/msads/rate-limit-keys.js +16 -2
- package/dist/services/msads/rate-limit-keys.js.map +1 -1
- package/dist/services/msads/types.d.ts +1 -2
- package/dist/services/msads/types.d.ts.map +1 -1
- package/dist/services/msads/types.js.map +1 -1
- package/dist/services/session-services.d.ts +2 -2
- package/dist/services/session-services.d.ts.map +1 -1
- package/dist/services/session-services.js +10 -10
- package/dist/services/session-services.js.map +1 -1
- package/dist/services/session-wiring.d.ts +7 -0
- package/dist/services/session-wiring.d.ts.map +1 -0
- package/dist/services/session-wiring.js +20 -0
- package/dist/services/session-wiring.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts +4 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -1
- package/dist/testkit/fixtures/index.js +105 -3
- package/dist/testkit/fixtures/index.js.map +1 -1
- package/dist/testkit/types.d.ts +2 -2
- package/dist/testkit/types.d.ts.map +1 -1
- package/package.json +8 -8
|
@@ -1,34 +1,29 @@
|
|
|
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
|
-
operation: z.ZodEnum<
|
|
5
|
-
|
|
4
|
+
operation: z.ZodEnum<{
|
|
5
|
+
update: "update";
|
|
6
|
+
delete: "delete";
|
|
7
|
+
add: "add";
|
|
8
|
+
getByCampaign: "getByCampaign";
|
|
9
|
+
getByAdGroup: "getByAdGroup";
|
|
10
|
+
}>;
|
|
11
|
+
entityLevel: z.ZodEnum<{
|
|
12
|
+
campaign: "campaign";
|
|
13
|
+
adGroup: "adGroup";
|
|
14
|
+
}>;
|
|
6
15
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
operation: "update" | "add" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
10
|
-
entityLevel: "campaign" | "adGroup";
|
|
11
|
-
}, {
|
|
12
|
-
data: Record<string, unknown>;
|
|
13
|
-
operation: "update" | "add" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
14
|
-
entityLevel: "campaign" | "adGroup";
|
|
15
|
-
}>;
|
|
16
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
17
|
+
}, z.core.$strip>;
|
|
16
18
|
export declare const ManageCriterionsOutputSchema: z.ZodObject<{
|
|
17
|
-
result: z.ZodRecord<z.ZodString, z.ZodAny
|
|
19
|
+
result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
18
20
|
operation: z.ZodString;
|
|
19
21
|
entityLevel: z.ZodString;
|
|
20
22
|
timestamp: z.ZodString;
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
entityLevel: string;
|
|
26
|
-
}, {
|
|
27
|
-
timestamp: string;
|
|
28
|
-
result: Record<string, any>;
|
|
29
|
-
operation: string;
|
|
30
|
-
entityLevel: string;
|
|
31
|
-
}>;
|
|
23
|
+
dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectDryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").EffectDryRunResult, unknown>>>;
|
|
24
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
|
|
25
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
|
|
26
|
+
}, z.core.$strip>;
|
|
32
27
|
type ManageCriterionsInput = z.infer<typeof ManageCriterionsInputSchema>;
|
|
33
28
|
type ManageCriterionsOutput = z.infer<typeof ManageCriterionsOutputSchema>;
|
|
34
29
|
export declare function manageCriterionsLogic(input: ManageCriterionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<ManageCriterionsOutput>;
|
|
@@ -38,39 +33,51 @@ export declare const manageCriterionsTool: {
|
|
|
38
33
|
title: string;
|
|
39
34
|
description: string;
|
|
40
35
|
inputSchema: z.ZodObject<{
|
|
41
|
-
operation: z.ZodEnum<
|
|
42
|
-
|
|
36
|
+
operation: z.ZodEnum<{
|
|
37
|
+
update: "update";
|
|
38
|
+
delete: "delete";
|
|
39
|
+
add: "add";
|
|
40
|
+
getByCampaign: "getByCampaign";
|
|
41
|
+
getByAdGroup: "getByAdGroup";
|
|
42
|
+
}>;
|
|
43
|
+
entityLevel: z.ZodEnum<{
|
|
44
|
+
campaign: "campaign";
|
|
45
|
+
adGroup: "adGroup";
|
|
46
|
+
}>;
|
|
43
47
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
operation: "update" | "add" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
47
|
-
entityLevel: "campaign" | "adGroup";
|
|
48
|
-
}, {
|
|
49
|
-
data: Record<string, unknown>;
|
|
50
|
-
operation: "update" | "add" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
51
|
-
entityLevel: "campaign" | "adGroup";
|
|
52
|
-
}>;
|
|
48
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
49
|
+
}, z.core.$strip>;
|
|
53
50
|
outputSchema: z.ZodObject<{
|
|
54
|
-
result: z.ZodRecord<z.ZodString, z.ZodAny
|
|
51
|
+
result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
55
52
|
operation: z.ZodString;
|
|
56
53
|
entityLevel: z.ZodString;
|
|
57
54
|
timestamp: z.ZodString;
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
entityLevel: string;
|
|
63
|
-
}, {
|
|
64
|
-
timestamp: string;
|
|
65
|
-
result: Record<string, any>;
|
|
66
|
-
operation: string;
|
|
67
|
-
entityLevel: string;
|
|
68
|
-
}>;
|
|
55
|
+
dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectDryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").EffectDryRunResult, unknown>>>;
|
|
56
|
+
effect: z.ZodOptional<z.ZodType<EffectResult, unknown, z.core.$ZodTypeInternals<EffectResult, unknown>>>;
|
|
57
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
|
|
58
|
+
}, z.core.$strip>;
|
|
69
59
|
annotations: {
|
|
70
60
|
readOnlyHint: boolean;
|
|
71
61
|
openWorldHint: boolean;
|
|
72
62
|
idempotentHint: boolean;
|
|
73
63
|
destructiveHint: boolean;
|
|
64
|
+
cesteral: {
|
|
65
|
+
kind: "write";
|
|
66
|
+
writeClass: "effect";
|
|
67
|
+
executableArgsExclude: string[];
|
|
68
|
+
platform: string;
|
|
69
|
+
contractPlatformSlug: string;
|
|
70
|
+
contractToolSlug: string;
|
|
71
|
+
operation: "manage"[];
|
|
72
|
+
entityKinds: never[];
|
|
73
|
+
entityIdArgs: never[];
|
|
74
|
+
schemaVersion: number;
|
|
75
|
+
contractId: string;
|
|
76
|
+
supportsDryRun: true;
|
|
77
|
+
supportsBeforeAfterSnapshot: false;
|
|
78
|
+
requiresValidation: true;
|
|
79
|
+
requiresSimulation: true;
|
|
80
|
+
};
|
|
74
81
|
};
|
|
75
82
|
inputExamples: {
|
|
76
83
|
label: string;
|
|
@@ -85,6 +92,10 @@ export declare const manageCriterionsTool: {
|
|
|
85
92
|
}[];
|
|
86
93
|
logic: typeof manageCriterionsLogic;
|
|
87
94
|
responseFormatter: typeof manageCriterionsResponseFormatter;
|
|
95
|
+
untrustedContent: {
|
|
96
|
+
structuredPaths: string[];
|
|
97
|
+
contentBlocks: number[];
|
|
98
|
+
};
|
|
88
99
|
};
|
|
89
100
|
export {};
|
|
90
101
|
//# sourceMappingURL=manage-criterions.tool.d.ts.map
|
|
@@ -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;AAWxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,oBAAoB,EAErB,MAAM,kBAAkB,CAAC;AAa1B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;iBAiBmB,CAAC;AAE5D,eAAO,MAAM,4BAA4B;;;;;;;;iBAgBC,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;AAiD3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAiFjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAgBlB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8ChC,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.
|
|
@@ -19,23 +19,49 @@ export const ManageCriterionsInputSchema = z
|
|
|
19
19
|
entityLevel: z
|
|
20
20
|
.enum(["campaign", "adGroup"])
|
|
21
21
|
.describe("Whether targeting is at campaign or ad group level"),
|
|
22
|
-
data: z.record(z.unknown()).describe("Operation data (varies by operation)"),
|
|
22
|
+
data: z.record(z.string(), 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.string(), 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) {
|
|
34
42
|
const level = entityLevel === "campaign" ? "Campaign" : "AdGroup";
|
|
43
|
+
const entityLabel = `${entityLevel === "campaign" ? "campaign" : "ad group"} criterions`;
|
|
35
44
|
const ops = {
|
|
36
|
-
add: {
|
|
37
|
-
|
|
38
|
-
|
|
45
|
+
add: {
|
|
46
|
+
path: `/${level}Criterions`,
|
|
47
|
+
method: "POST",
|
|
48
|
+
batch: {
|
|
49
|
+
operation: "add",
|
|
50
|
+
entityLabel,
|
|
51
|
+
itemsField: `${level}Criterions`,
|
|
52
|
+
idsField: `${level}CriterionIds`,
|
|
53
|
+
},
|
|
54
|
+
},
|
|
55
|
+
update: {
|
|
56
|
+
path: `/${level}Criterions`,
|
|
57
|
+
method: "PUT",
|
|
58
|
+
batch: { operation: "update", entityLabel, itemsField: `${level}Criterions` },
|
|
59
|
+
},
|
|
60
|
+
delete: {
|
|
61
|
+
path: `/${level}Criterions`,
|
|
62
|
+
method: "DELETE",
|
|
63
|
+
batch: { operation: "delete", entityLabel, itemsField: `${level}CriterionIds` },
|
|
64
|
+
},
|
|
39
65
|
getByCampaign: { path: "/CampaignCriterions/QueryByIds", method: "POST" },
|
|
40
66
|
getByAdGroup: { path: "/AdGroupCriterions/QueryByIds", method: "POST" },
|
|
41
67
|
};
|
|
@@ -46,17 +72,73 @@ function getOperation(operation, entityLevel) {
|
|
|
46
72
|
return op;
|
|
47
73
|
}
|
|
48
74
|
export async function manageCriterionsLogic(input, context, sdkContext) {
|
|
75
|
+
const dispatchedCapability = {
|
|
76
|
+
operation: "manage",
|
|
77
|
+
canonicalEntityKind: null,
|
|
78
|
+
};
|
|
79
|
+
if (input.dry_run === true) {
|
|
80
|
+
return {
|
|
81
|
+
operation: input.operation,
|
|
82
|
+
entityLevel: input.entityLevel,
|
|
83
|
+
timestamp: new Date().toISOString(),
|
|
84
|
+
dryRun: assertGovernedEffectDryRun({
|
|
85
|
+
wouldSucceed: true,
|
|
86
|
+
validationErrors: [],
|
|
87
|
+
validationSource: "symbolic",
|
|
88
|
+
expectedEffectSource: "symbolic",
|
|
89
|
+
expectedEffect: {
|
|
90
|
+
effectKind: "criterions_managed",
|
|
91
|
+
summary: { operation: input.operation, entity_level: input.entityLevel },
|
|
92
|
+
},
|
|
93
|
+
}, TOOL_NAME, { requiresValidation: true, requiresSimulation: true }),
|
|
94
|
+
dispatchedCapability,
|
|
95
|
+
};
|
|
96
|
+
}
|
|
49
97
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
50
98
|
const op = getOperation(input.operation, input.entityLevel);
|
|
51
|
-
|
|
99
|
+
let result;
|
|
100
|
+
let counts = {};
|
|
101
|
+
if (op.batch) {
|
|
102
|
+
const batch = await msadsService.executeOperation(op.path, input.data, context, op.method, op.batch);
|
|
103
|
+
result = {
|
|
104
|
+
...(batch.response && typeof batch.response === "object"
|
|
105
|
+
? batch.response
|
|
106
|
+
: {}),
|
|
107
|
+
itemFailures: batch.failures,
|
|
108
|
+
};
|
|
109
|
+
counts = {
|
|
110
|
+
requested: batch.requested,
|
|
111
|
+
succeeded: batch.succeeded,
|
|
112
|
+
failed: batch.failed,
|
|
113
|
+
partial_success: batch.failed > 0,
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
else {
|
|
117
|
+
result = (await msadsService.executeOperation(op.path, input.data, context, op.method));
|
|
118
|
+
}
|
|
119
|
+
const effect = {
|
|
120
|
+
effectKind: "criterions_managed",
|
|
121
|
+
summary: { operation: input.operation, entity_level: input.entityLevel, ...counts },
|
|
122
|
+
};
|
|
52
123
|
return {
|
|
53
124
|
result,
|
|
54
125
|
operation: input.operation,
|
|
55
126
|
entityLevel: input.entityLevel,
|
|
56
127
|
timestamp: new Date().toISOString(),
|
|
128
|
+
effect,
|
|
129
|
+
dispatchedCapability,
|
|
57
130
|
};
|
|
58
131
|
}
|
|
59
132
|
export function manageCriterionsResponseFormatter(result) {
|
|
133
|
+
if (result.dryRun) {
|
|
134
|
+
const { wouldSucceed, validationSource, expectedEffectSource } = result.dryRun;
|
|
135
|
+
return [
|
|
136
|
+
{
|
|
137
|
+
type: "text",
|
|
138
|
+
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}`,
|
|
139
|
+
},
|
|
140
|
+
];
|
|
141
|
+
}
|
|
60
142
|
return [
|
|
61
143
|
{
|
|
62
144
|
type: "text",
|
|
@@ -75,6 +157,23 @@ export const manageCriterionsTool = {
|
|
|
75
157
|
openWorldHint: false,
|
|
76
158
|
idempotentHint: false,
|
|
77
159
|
destructiveHint: true,
|
|
160
|
+
cesteral: {
|
|
161
|
+
kind: "write",
|
|
162
|
+
writeClass: "effect",
|
|
163
|
+
executableArgsExclude: ["dry_run"],
|
|
164
|
+
platform: "msads",
|
|
165
|
+
contractPlatformSlug: "msads",
|
|
166
|
+
contractToolSlug: "manage_criterions",
|
|
167
|
+
operation: ["manage"],
|
|
168
|
+
entityKinds: [],
|
|
169
|
+
entityIdArgs: [],
|
|
170
|
+
schemaVersion: 1,
|
|
171
|
+
contractId: "msads.manage_criterions.v1",
|
|
172
|
+
supportsDryRun: true,
|
|
173
|
+
supportsBeforeAfterSnapshot: false,
|
|
174
|
+
requiresValidation: true,
|
|
175
|
+
requiresSimulation: true,
|
|
176
|
+
},
|
|
78
177
|
},
|
|
79
178
|
inputExamples: [
|
|
80
179
|
{
|
|
@@ -82,11 +181,15 @@ export const manageCriterionsTool = {
|
|
|
82
181
|
input: {
|
|
83
182
|
operation: "getByCampaign",
|
|
84
183
|
entityLevel: "campaign",
|
|
85
|
-
data: { CampaignId: 123456, CriterionType: "
|
|
184
|
+
data: { CampaignId: 123456, CriterionType: "Location" },
|
|
86
185
|
},
|
|
87
186
|
},
|
|
88
187
|
],
|
|
89
188
|
logic: manageCriterionsLogic,
|
|
90
189
|
responseFormatter: manageCriterionsResponseFormatter,
|
|
190
|
+
untrustedContent: {
|
|
191
|
+
structuredPaths: ["$.result"],
|
|
192
|
+
contentBlocks: [0],
|
|
193
|
+
},
|
|
91
194
|
};
|
|
92
195
|
//# sourceMappingURL=manage-criterions.tool.js.map
|
|
@@ -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;
|
|
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,31 +1,19 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
3
|
export declare const SearchTargetingInputSchema: z.ZodObject<{
|
|
4
|
-
targetingType: z.ZodEnum<
|
|
4
|
+
targetingType: z.ZodEnum<{
|
|
5
|
+
age: "age";
|
|
6
|
+
gender: "gender";
|
|
7
|
+
device: "device";
|
|
8
|
+
}>;
|
|
5
9
|
maxResults: z.ZodDefault<z.ZodNumber>;
|
|
6
|
-
},
|
|
7
|
-
targetingType: "age" | "gender" | "device";
|
|
8
|
-
maxResults: number;
|
|
9
|
-
}, {
|
|
10
|
-
targetingType: "age" | "gender" | "device";
|
|
11
|
-
maxResults?: number | undefined;
|
|
12
|
-
}>;
|
|
10
|
+
}, z.core.$strip>;
|
|
13
11
|
export declare const SearchTargetingOutputSchema: z.ZodObject<{
|
|
14
12
|
targetingType: z.ZodString;
|
|
15
|
-
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny
|
|
13
|
+
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
16
14
|
totalResults: z.ZodNumber;
|
|
17
15
|
timestamp: z.ZodString;
|
|
18
|
-
},
|
|
19
|
-
results: Record<string, any>[];
|
|
20
|
-
timestamp: string;
|
|
21
|
-
targetingType: string;
|
|
22
|
-
totalResults: number;
|
|
23
|
-
}, {
|
|
24
|
-
results: Record<string, any>[];
|
|
25
|
-
timestamp: string;
|
|
26
|
-
targetingType: string;
|
|
27
|
-
totalResults: number;
|
|
28
|
-
}>;
|
|
16
|
+
}, z.core.$strip>;
|
|
29
17
|
type SearchTargetingInput = z.infer<typeof SearchTargetingInputSchema>;
|
|
30
18
|
type SearchTargetingOutput = z.infer<typeof SearchTargetingOutputSchema>;
|
|
31
19
|
export declare function searchTargetingLogic(input: SearchTargetingInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<SearchTargetingOutput>;
|
|
@@ -35,31 +23,19 @@ export declare const searchTargetingTool: {
|
|
|
35
23
|
title: string;
|
|
36
24
|
description: string;
|
|
37
25
|
inputSchema: z.ZodObject<{
|
|
38
|
-
targetingType: z.ZodEnum<
|
|
26
|
+
targetingType: z.ZodEnum<{
|
|
27
|
+
age: "age";
|
|
28
|
+
gender: "gender";
|
|
29
|
+
device: "device";
|
|
30
|
+
}>;
|
|
39
31
|
maxResults: z.ZodDefault<z.ZodNumber>;
|
|
40
|
-
},
|
|
41
|
-
targetingType: "age" | "gender" | "device";
|
|
42
|
-
maxResults: number;
|
|
43
|
-
}, {
|
|
44
|
-
targetingType: "age" | "gender" | "device";
|
|
45
|
-
maxResults?: number | undefined;
|
|
46
|
-
}>;
|
|
32
|
+
}, z.core.$strip>;
|
|
47
33
|
outputSchema: z.ZodObject<{
|
|
48
34
|
targetingType: z.ZodString;
|
|
49
|
-
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny
|
|
35
|
+
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
50
36
|
totalResults: z.ZodNumber;
|
|
51
37
|
timestamp: z.ZodString;
|
|
52
|
-
},
|
|
53
|
-
results: Record<string, any>[];
|
|
54
|
-
timestamp: string;
|
|
55
|
-
targetingType: string;
|
|
56
|
-
totalResults: number;
|
|
57
|
-
}, {
|
|
58
|
-
results: Record<string, any>[];
|
|
59
|
-
timestamp: string;
|
|
60
|
-
targetingType: string;
|
|
61
|
-
totalResults: number;
|
|
62
|
-
}>;
|
|
38
|
+
}, z.core.$strip>;
|
|
63
39
|
annotations: {
|
|
64
40
|
readOnlyHint: boolean;
|
|
65
41
|
openWorldHint: boolean;
|
|
@@ -74,6 +50,7 @@ export declare const searchTargetingTool: {
|
|
|
74
50
|
}[];
|
|
75
51
|
logic: typeof searchTargetingLogic;
|
|
76
52
|
responseFormatter: typeof searchTargetingResponseFormatter;
|
|
53
|
+
untrustedContent: Readonly<import("@cesteral/shared").ToolUntrustedDeclaration>;
|
|
77
54
|
};
|
|
78
55
|
export {};
|
|
79
56
|
//# sourceMappingURL=search-targeting.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-targeting.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"search-targeting.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnF,eAAO,MAAM,0BAA0B;;;;;;;iBAWgB,CAAC;AAExD,eAAO,MAAM,2BAA2B;;;;;iBAOD,CAAC;AAExC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAYzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAQhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B/B,CAAC"}
|
|
@@ -1,15 +1,16 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import {
|
|
2
|
+
import { MSADS_AGE_RANGES, MSADS_GENDERS } from "../utils/targeting-values.js";
|
|
3
|
+
import { McpError, JsonRpcErrorCode, NO_UNTRUSTED_CONTENT } from "@cesteral/shared";
|
|
3
4
|
const TOOL_NAME = "msads_search_targeting";
|
|
4
|
-
const TOOL_TITLE = "List Microsoft Ads Targeting Options";
|
|
5
|
-
const TOOL_DESCRIPTION = `
|
|
5
|
+
const TOOL_TITLE = "List Microsoft Ads Targeting Options (Static Reference)";
|
|
6
|
+
const TOOL_DESCRIPTION = `Static reference catalog of the demographic targeting enum values Microsoft Advertising accepts — this tool does NOT call the Microsoft Advertising API. These values are fixed enums in the Campaign Management API schema (not a queryable endpoint), so they are served locally.
|
|
6
7
|
|
|
7
8
|
Supported targeting types:
|
|
8
|
-
- age:
|
|
9
|
-
- gender:
|
|
10
|
-
- device:
|
|
9
|
+
- age: the fixed AgeRange enum values
|
|
10
|
+
- gender: the fixed Gender enum values
|
|
11
|
+
- device: the fixed DeviceType enum values
|
|
11
12
|
|
|
12
|
-
|
|
13
|
+
For the fuller criterion reference (adds dayparting days), use \`msads_get_targeting_options\`. Location targets are not enumerable via the REST API — use the Campaign Management \`GetGeoLocationsFileUrl\` operation to download the full geo-location reference file.`;
|
|
13
14
|
export const SearchTargetingInputSchema = z
|
|
14
15
|
.object({
|
|
15
16
|
targetingType: z.enum(["age", "gender", "device"]).describe("Type of targeting to list"),
|
|
@@ -25,22 +26,13 @@ export const SearchTargetingInputSchema = z
|
|
|
25
26
|
export const SearchTargetingOutputSchema = z
|
|
26
27
|
.object({
|
|
27
28
|
targetingType: z.string(),
|
|
28
|
-
results: z.array(z.record(z.any())),
|
|
29
|
+
results: z.array(z.record(z.string(), z.any())),
|
|
29
30
|
totalResults: z.number(),
|
|
30
31
|
timestamp: z.string().datetime(),
|
|
31
32
|
})
|
|
32
33
|
.describe("Targeting options result");
|
|
33
|
-
const AGE_RANGES =
|
|
34
|
-
|
|
35
|
-
{ Id: "TwentyFiveToThirtyFour", Name: "25-34" },
|
|
36
|
-
{ Id: "ThirtyFiveToFortyNine", Name: "35-49" },
|
|
37
|
-
{ Id: "FiftyToSixtyFour", Name: "50-64" },
|
|
38
|
-
{ Id: "SixtyFiveAndAbove", Name: "65+" },
|
|
39
|
-
];
|
|
40
|
-
const GENDERS = [
|
|
41
|
-
{ Id: "Male", Name: "Male" },
|
|
42
|
-
{ Id: "Female", Name: "Female" },
|
|
43
|
-
];
|
|
34
|
+
const AGE_RANGES = MSADS_AGE_RANGES.map((v) => ({ ...v }));
|
|
35
|
+
const GENDERS = MSADS_GENDERS.map((v) => ({ ...v }));
|
|
44
36
|
const DEVICE_TYPES = [
|
|
45
37
|
{ Id: "Computers", Name: "Computers" },
|
|
46
38
|
{ Id: "Smartphones", Name: "Smartphones" },
|
|
@@ -101,5 +93,6 @@ export const searchTargetingTool = {
|
|
|
101
93
|
],
|
|
102
94
|
logic: searchTargetingLogic,
|
|
103
95
|
responseFormatter: searchTargetingResponseFormatter,
|
|
96
|
+
untrustedContent: NO_UNTRUSTED_CONTENT,
|
|
104
97
|
};
|
|
105
98
|
//# sourceMappingURL=search-targeting.tool.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-targeting.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"search-targeting.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"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"}
|