@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,113 +1,67 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
|
-
export declare const GetReportInputSchema: z.
|
|
3
|
+
export declare const GetReportInputSchema: z.ZodObject<{
|
|
4
4
|
reportType: z.ZodString;
|
|
5
5
|
accountId: z.ZodString;
|
|
6
|
-
columns: z.ZodArray<z.ZodString
|
|
7
|
-
datePreset: z.ZodOptional<z.ZodEnum<
|
|
6
|
+
columns: z.ZodArray<z.ZodString>;
|
|
7
|
+
datePreset: z.ZodOptional<z.ZodEnum<{
|
|
8
|
+
TODAY: "TODAY";
|
|
9
|
+
YESTERDAY: "YESTERDAY";
|
|
10
|
+
LAST_7_DAYS: "LAST_7_DAYS";
|
|
11
|
+
LAST_14_DAYS: "LAST_14_DAYS";
|
|
12
|
+
LAST_30_DAYS: "LAST_30_DAYS";
|
|
13
|
+
THIS_MONTH: "THIS_MONTH";
|
|
14
|
+
LAST_MONTH: "LAST_MONTH";
|
|
15
|
+
LAST_90_DAYS: "LAST_90_DAYS";
|
|
16
|
+
}>>;
|
|
8
17
|
startDate: z.ZodOptional<z.ZodString>;
|
|
9
18
|
endDate: z.ZodOptional<z.ZodString>;
|
|
10
19
|
aggregation: z.ZodOptional<z.ZodString>;
|
|
11
|
-
} & Omit<{
|
|
12
|
-
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
|
|
13
|
-
columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
14
20
|
offset: z.ZodOptional<z.ZodNumber>;
|
|
21
|
+
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
22
|
+
summary: "summary";
|
|
23
|
+
rows: "rows";
|
|
24
|
+
}>>>;
|
|
15
25
|
maxRows: z.ZodOptional<z.ZodNumber>;
|
|
16
|
-
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString
|
|
17
|
-
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
endDate?: string | undefined;
|
|
26
|
-
aggregation?: string | undefined;
|
|
27
|
-
offset?: number | undefined;
|
|
28
|
-
maxRows?: number | undefined;
|
|
29
|
-
aggregateBy?: string[] | undefined;
|
|
30
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
31
|
-
}, {
|
|
32
|
-
accountId: string;
|
|
33
|
-
reportType: string;
|
|
34
|
-
columns: string[];
|
|
35
|
-
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
36
|
-
startDate?: string | undefined;
|
|
37
|
-
endDate?: string | undefined;
|
|
38
|
-
aggregation?: string | undefined;
|
|
39
|
-
mode?: "rows" | "summary" | undefined;
|
|
40
|
-
offset?: number | undefined;
|
|
41
|
-
maxRows?: number | undefined;
|
|
42
|
-
aggregateBy?: string[] | undefined;
|
|
43
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
44
|
-
}>, {
|
|
45
|
-
accountId: string;
|
|
46
|
-
reportType: string;
|
|
47
|
-
columns: string[];
|
|
48
|
-
mode: "rows" | "summary";
|
|
49
|
-
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
50
|
-
startDate?: string | undefined;
|
|
51
|
-
endDate?: string | undefined;
|
|
52
|
-
aggregation?: string | undefined;
|
|
53
|
-
offset?: number | undefined;
|
|
54
|
-
maxRows?: number | undefined;
|
|
55
|
-
aggregateBy?: string[] | undefined;
|
|
56
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
57
|
-
}, {
|
|
58
|
-
accountId: string;
|
|
59
|
-
reportType: string;
|
|
60
|
-
columns: string[];
|
|
61
|
-
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
62
|
-
startDate?: string | undefined;
|
|
63
|
-
endDate?: string | undefined;
|
|
64
|
-
aggregation?: string | undefined;
|
|
65
|
-
mode?: "rows" | "summary" | undefined;
|
|
66
|
-
offset?: number | undefined;
|
|
67
|
-
maxRows?: number | undefined;
|
|
68
|
-
aggregateBy?: string[] | undefined;
|
|
69
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
70
|
-
}>;
|
|
26
|
+
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
27
|
+
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
|
|
28
|
+
sum: "sum";
|
|
29
|
+
avg: "avg";
|
|
30
|
+
count: "count";
|
|
31
|
+
min: "min";
|
|
32
|
+
max: "max";
|
|
33
|
+
}>>>;
|
|
34
|
+
}, z.core.$strip>;
|
|
71
35
|
export declare const GetReportOutputSchema: z.ZodObject<{
|
|
72
36
|
timestamp: z.ZodString;
|
|
73
37
|
totalRows: z.ZodNumber;
|
|
74
38
|
returnedRows: z.ZodNumber;
|
|
75
39
|
truncated: z.ZodBoolean;
|
|
76
40
|
nextOffset: z.ZodNullable<z.ZodNumber>;
|
|
77
|
-
headers: z.ZodArray<z.ZodString
|
|
78
|
-
selectedColumns: z.ZodArray<z.ZodString
|
|
79
|
-
mode: z.ZodEnum<
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
41
|
+
headers: z.ZodArray<z.ZodString>;
|
|
42
|
+
selectedColumns: z.ZodArray<z.ZodString>;
|
|
43
|
+
mode: z.ZodEnum<{
|
|
44
|
+
summary: "summary";
|
|
45
|
+
rows: "rows";
|
|
46
|
+
}>;
|
|
47
|
+
previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
|
|
48
|
+
rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
|
|
49
|
+
warnings: z.ZodArray<z.ZodString>;
|
|
50
|
+
metricContext: z.ZodOptional<z.ZodObject<{
|
|
51
|
+
source: z.ZodString;
|
|
52
|
+
currency: z.ZodOptional<z.ZodString>;
|
|
53
|
+
timezone: z.ZodOptional<z.ZodString>;
|
|
54
|
+
dateRange: z.ZodOptional<z.ZodObject<{
|
|
55
|
+
start: z.ZodString;
|
|
56
|
+
end: z.ZodString;
|
|
57
|
+
}, z.core.$strip>>;
|
|
58
|
+
conversionBasis: z.ZodOptional<z.ZodObject<{
|
|
59
|
+
attributionWindow: z.ZodString;
|
|
60
|
+
appliesTo: z.ZodArray<z.ZodString>;
|
|
61
|
+
}, z.core.$strip>>;
|
|
62
|
+
}, z.core.$strip>>;
|
|
83
63
|
reportRequestId: z.ZodString;
|
|
84
|
-
},
|
|
85
|
-
reportRequestId: string;
|
|
86
|
-
headers: string[];
|
|
87
|
-
totalRows: number;
|
|
88
|
-
timestamp: string;
|
|
89
|
-
mode: "rows" | "summary";
|
|
90
|
-
returnedRows: number;
|
|
91
|
-
truncated: boolean;
|
|
92
|
-
nextOffset: number | null;
|
|
93
|
-
selectedColumns: string[];
|
|
94
|
-
warnings: string[];
|
|
95
|
-
rows?: Record<string, any>[] | undefined;
|
|
96
|
-
previewRows?: Record<string, any>[] | undefined;
|
|
97
|
-
}, {
|
|
98
|
-
reportRequestId: string;
|
|
99
|
-
headers: string[];
|
|
100
|
-
totalRows: number;
|
|
101
|
-
timestamp: string;
|
|
102
|
-
mode: "rows" | "summary";
|
|
103
|
-
returnedRows: number;
|
|
104
|
-
truncated: boolean;
|
|
105
|
-
nextOffset: number | null;
|
|
106
|
-
selectedColumns: string[];
|
|
107
|
-
warnings: string[];
|
|
108
|
-
rows?: Record<string, any>[] | undefined;
|
|
109
|
-
previewRows?: Record<string, any>[] | undefined;
|
|
110
|
-
}>;
|
|
64
|
+
}, z.core.$strip>;
|
|
111
65
|
type GetReportInput = z.infer<typeof GetReportInputSchema>;
|
|
112
66
|
type GetReportOutput = z.infer<typeof GetReportOutputSchema>;
|
|
113
67
|
export declare function getReportLogic(input: GetReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetReportOutput>;
|
|
@@ -116,114 +70,68 @@ export declare const getReportTool: {
|
|
|
116
70
|
name: string;
|
|
117
71
|
title: string;
|
|
118
72
|
description: string;
|
|
119
|
-
inputSchema: z.
|
|
73
|
+
inputSchema: z.ZodObject<{
|
|
120
74
|
reportType: z.ZodString;
|
|
121
75
|
accountId: z.ZodString;
|
|
122
|
-
columns: z.ZodArray<z.ZodString
|
|
123
|
-
datePreset: z.ZodOptional<z.ZodEnum<
|
|
76
|
+
columns: z.ZodArray<z.ZodString>;
|
|
77
|
+
datePreset: z.ZodOptional<z.ZodEnum<{
|
|
78
|
+
TODAY: "TODAY";
|
|
79
|
+
YESTERDAY: "YESTERDAY";
|
|
80
|
+
LAST_7_DAYS: "LAST_7_DAYS";
|
|
81
|
+
LAST_14_DAYS: "LAST_14_DAYS";
|
|
82
|
+
LAST_30_DAYS: "LAST_30_DAYS";
|
|
83
|
+
THIS_MONTH: "THIS_MONTH";
|
|
84
|
+
LAST_MONTH: "LAST_MONTH";
|
|
85
|
+
LAST_90_DAYS: "LAST_90_DAYS";
|
|
86
|
+
}>>;
|
|
124
87
|
startDate: z.ZodOptional<z.ZodString>;
|
|
125
88
|
endDate: z.ZodOptional<z.ZodString>;
|
|
126
89
|
aggregation: z.ZodOptional<z.ZodString>;
|
|
127
|
-
} & Omit<{
|
|
128
|
-
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
|
|
129
|
-
columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
130
90
|
offset: z.ZodOptional<z.ZodNumber>;
|
|
91
|
+
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
92
|
+
summary: "summary";
|
|
93
|
+
rows: "rows";
|
|
94
|
+
}>>>;
|
|
131
95
|
maxRows: z.ZodOptional<z.ZodNumber>;
|
|
132
|
-
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString
|
|
133
|
-
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
endDate?: string | undefined;
|
|
142
|
-
aggregation?: string | undefined;
|
|
143
|
-
offset?: number | undefined;
|
|
144
|
-
maxRows?: number | undefined;
|
|
145
|
-
aggregateBy?: string[] | undefined;
|
|
146
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
147
|
-
}, {
|
|
148
|
-
accountId: string;
|
|
149
|
-
reportType: string;
|
|
150
|
-
columns: string[];
|
|
151
|
-
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
152
|
-
startDate?: string | undefined;
|
|
153
|
-
endDate?: string | undefined;
|
|
154
|
-
aggregation?: string | undefined;
|
|
155
|
-
mode?: "rows" | "summary" | undefined;
|
|
156
|
-
offset?: number | undefined;
|
|
157
|
-
maxRows?: number | undefined;
|
|
158
|
-
aggregateBy?: string[] | undefined;
|
|
159
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
160
|
-
}>, {
|
|
161
|
-
accountId: string;
|
|
162
|
-
reportType: string;
|
|
163
|
-
columns: string[];
|
|
164
|
-
mode: "rows" | "summary";
|
|
165
|
-
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
166
|
-
startDate?: string | undefined;
|
|
167
|
-
endDate?: string | undefined;
|
|
168
|
-
aggregation?: string | undefined;
|
|
169
|
-
offset?: number | undefined;
|
|
170
|
-
maxRows?: number | undefined;
|
|
171
|
-
aggregateBy?: string[] | undefined;
|
|
172
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
173
|
-
}, {
|
|
174
|
-
accountId: string;
|
|
175
|
-
reportType: string;
|
|
176
|
-
columns: string[];
|
|
177
|
-
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
178
|
-
startDate?: string | undefined;
|
|
179
|
-
endDate?: string | undefined;
|
|
180
|
-
aggregation?: string | undefined;
|
|
181
|
-
mode?: "rows" | "summary" | undefined;
|
|
182
|
-
offset?: number | undefined;
|
|
183
|
-
maxRows?: number | undefined;
|
|
184
|
-
aggregateBy?: string[] | undefined;
|
|
185
|
-
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
186
|
-
}>;
|
|
96
|
+
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
97
|
+
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
|
|
98
|
+
sum: "sum";
|
|
99
|
+
avg: "avg";
|
|
100
|
+
count: "count";
|
|
101
|
+
min: "min";
|
|
102
|
+
max: "max";
|
|
103
|
+
}>>>;
|
|
104
|
+
}, z.core.$strip>;
|
|
187
105
|
outputSchema: z.ZodObject<{
|
|
188
106
|
timestamp: z.ZodString;
|
|
189
107
|
totalRows: z.ZodNumber;
|
|
190
108
|
returnedRows: z.ZodNumber;
|
|
191
109
|
truncated: z.ZodBoolean;
|
|
192
110
|
nextOffset: z.ZodNullable<z.ZodNumber>;
|
|
193
|
-
headers: z.ZodArray<z.ZodString
|
|
194
|
-
selectedColumns: z.ZodArray<z.ZodString
|
|
195
|
-
mode: z.ZodEnum<
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
111
|
+
headers: z.ZodArray<z.ZodString>;
|
|
112
|
+
selectedColumns: z.ZodArray<z.ZodString>;
|
|
113
|
+
mode: z.ZodEnum<{
|
|
114
|
+
summary: "summary";
|
|
115
|
+
rows: "rows";
|
|
116
|
+
}>;
|
|
117
|
+
previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
|
|
118
|
+
rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
|
|
119
|
+
warnings: z.ZodArray<z.ZodString>;
|
|
120
|
+
metricContext: z.ZodOptional<z.ZodObject<{
|
|
121
|
+
source: z.ZodString;
|
|
122
|
+
currency: z.ZodOptional<z.ZodString>;
|
|
123
|
+
timezone: z.ZodOptional<z.ZodString>;
|
|
124
|
+
dateRange: z.ZodOptional<z.ZodObject<{
|
|
125
|
+
start: z.ZodString;
|
|
126
|
+
end: z.ZodString;
|
|
127
|
+
}, z.core.$strip>>;
|
|
128
|
+
conversionBasis: z.ZodOptional<z.ZodObject<{
|
|
129
|
+
attributionWindow: z.ZodString;
|
|
130
|
+
appliesTo: z.ZodArray<z.ZodString>;
|
|
131
|
+
}, z.core.$strip>>;
|
|
132
|
+
}, z.core.$strip>>;
|
|
199
133
|
reportRequestId: z.ZodString;
|
|
200
|
-
},
|
|
201
|
-
reportRequestId: string;
|
|
202
|
-
headers: string[];
|
|
203
|
-
totalRows: number;
|
|
204
|
-
timestamp: string;
|
|
205
|
-
mode: "rows" | "summary";
|
|
206
|
-
returnedRows: number;
|
|
207
|
-
truncated: boolean;
|
|
208
|
-
nextOffset: number | null;
|
|
209
|
-
selectedColumns: string[];
|
|
210
|
-
warnings: string[];
|
|
211
|
-
rows?: Record<string, any>[] | undefined;
|
|
212
|
-
previewRows?: Record<string, any>[] | undefined;
|
|
213
|
-
}, {
|
|
214
|
-
reportRequestId: string;
|
|
215
|
-
headers: string[];
|
|
216
|
-
totalRows: number;
|
|
217
|
-
timestamp: string;
|
|
218
|
-
mode: "rows" | "summary";
|
|
219
|
-
returnedRows: number;
|
|
220
|
-
truncated: boolean;
|
|
221
|
-
nextOffset: number | null;
|
|
222
|
-
selectedColumns: string[];
|
|
223
|
-
warnings: string[];
|
|
224
|
-
rows?: Record<string, any>[] | undefined;
|
|
225
|
-
previewRows?: Record<string, any>[] | undefined;
|
|
226
|
-
}>;
|
|
134
|
+
}, z.core.$strip>;
|
|
227
135
|
annotations: {
|
|
228
136
|
readOnlyHint: boolean;
|
|
229
137
|
openWorldHint: boolean;
|
|
@@ -255,6 +163,10 @@ export declare const getReportTool: {
|
|
|
255
163
|
})[];
|
|
256
164
|
logic: typeof getReportLogic;
|
|
257
165
|
responseFormatter: typeof getReportResponseFormatter;
|
|
166
|
+
untrustedContent: {
|
|
167
|
+
structuredPaths: string[];
|
|
168
|
+
contentBlocks: number[];
|
|
169
|
+
};
|
|
258
170
|
};
|
|
259
171
|
export {};
|
|
260
172
|
//# sourceMappingURL=get-report.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"get-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+B2B,CAAC;AAE7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMN,CAAC;AAE7B,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCzB,CAAC"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
-
import { arrayRowsToRecords, createReportView, formatReportViewResponse, getReportViewFetchLimit, resolveDatePreset, DATE_PRESET_VALUES, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
|
|
3
|
+
import { arrayRowsToRecords, createReportView, formatReportViewResponse, getReportViewFetchLimit, resolveDatePreset, DATE_PRESET_VALUES, ReportViewInputSchema, ReportViewOutputSchema, buildMetricContext, } from "@cesteral/shared";
|
|
4
4
|
const TOOL_NAME = "msads_get_report";
|
|
5
5
|
const TOOL_TITLE = "Get Microsoft Ads Report";
|
|
6
6
|
const TOOL_DESCRIPTION = `Submit a Microsoft Advertising report request, poll until complete, and download results (blocking).
|
|
@@ -66,6 +66,10 @@ export async function getReportLogic(input, context, sdkContext) {
|
|
|
66
66
|
rows: arrayRowsToRecords(result.headers, result.rows),
|
|
67
67
|
totalRows: result.totalRows,
|
|
68
68
|
input,
|
|
69
|
+
metricContext: buildMetricContext({
|
|
70
|
+
source: "microsoft_ads",
|
|
71
|
+
dateRange: { start: resolvedStartDate, end: resolvedEndDate },
|
|
72
|
+
}),
|
|
69
73
|
}),
|
|
70
74
|
timestamp: new Date().toISOString(),
|
|
71
75
|
};
|
|
@@ -114,5 +118,9 @@ export const getReportTool = {
|
|
|
114
118
|
],
|
|
115
119
|
logic: getReportLogic,
|
|
116
120
|
responseFormatter: getReportResponseFormatter,
|
|
121
|
+
untrustedContent: {
|
|
122
|
+
structuredPaths: ["$.headers", "$.selectedColumns", "$.rows", "$.previewRows", "$.warnings"],
|
|
123
|
+
contentBlocks: [0],
|
|
124
|
+
},
|
|
117
125
|
};
|
|
118
126
|
//# sourceMappingURL=get-report.tool.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,
|
|
1
|
+
{"version":3,"file":"get-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
|
+
export declare const GetTargetingOptionsInputSchema: z.ZodObject<{
|
|
4
|
+
targetingType: z.ZodOptional<z.ZodEnum<{
|
|
5
|
+
age: "age";
|
|
6
|
+
day: "day";
|
|
7
|
+
gender: "gender";
|
|
8
|
+
device: "device";
|
|
9
|
+
}>>;
|
|
10
|
+
}, z.core.$strip>;
|
|
11
|
+
export declare const GetTargetingOptionsOutputSchema: z.ZodObject<{
|
|
12
|
+
options: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
|
|
13
|
+
timestamp: z.ZodString;
|
|
14
|
+
}, z.core.$strip>;
|
|
15
|
+
type GetTargetingOptionsInput = z.infer<typeof GetTargetingOptionsInputSchema>;
|
|
16
|
+
type GetTargetingOptionsOutput = z.infer<typeof GetTargetingOptionsOutputSchema>;
|
|
17
|
+
export declare function getTargetingOptionsLogic(input: GetTargetingOptionsInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<GetTargetingOptionsOutput>;
|
|
18
|
+
export declare function getTargetingOptionsResponseFormatter(result: GetTargetingOptionsOutput): McpTextContent[];
|
|
19
|
+
export declare const getTargetingOptionsTool: {
|
|
20
|
+
name: string;
|
|
21
|
+
title: string;
|
|
22
|
+
description: string;
|
|
23
|
+
inputSchema: z.ZodObject<{
|
|
24
|
+
targetingType: z.ZodOptional<z.ZodEnum<{
|
|
25
|
+
age: "age";
|
|
26
|
+
day: "day";
|
|
27
|
+
gender: "gender";
|
|
28
|
+
device: "device";
|
|
29
|
+
}>>;
|
|
30
|
+
}, z.core.$strip>;
|
|
31
|
+
outputSchema: z.ZodObject<{
|
|
32
|
+
options: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
|
|
33
|
+
timestamp: z.ZodString;
|
|
34
|
+
}, z.core.$strip>;
|
|
35
|
+
annotations: {
|
|
36
|
+
readOnlyHint: boolean;
|
|
37
|
+
openWorldHint: boolean;
|
|
38
|
+
idempotentHint: boolean;
|
|
39
|
+
destructiveHint: boolean;
|
|
40
|
+
};
|
|
41
|
+
inputExamples: ({
|
|
42
|
+
label: string;
|
|
43
|
+
input: {
|
|
44
|
+
targetingType?: undefined;
|
|
45
|
+
};
|
|
46
|
+
} | {
|
|
47
|
+
label: string;
|
|
48
|
+
input: {
|
|
49
|
+
targetingType: string;
|
|
50
|
+
};
|
|
51
|
+
})[];
|
|
52
|
+
logic: typeof getTargetingOptionsLogic;
|
|
53
|
+
responseFormatter: typeof getTargetingOptionsResponseFormatter;
|
|
54
|
+
untrustedContent: Readonly<import("@cesteral/shared").ToolUntrustedDeclaration>;
|
|
55
|
+
};
|
|
56
|
+
export {};
|
|
57
|
+
//# sourceMappingURL=get-targeting-options.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-targeting-options.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-targeting-options.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgBnF,eAAO,MAAM,8BAA8B;;;;;;;iBAOoC,CAAC;AAEhF,eAAO,MAAM,+BAA+B;;;iBAOF,CAAC;AAE3C,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAyBjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,yBAAyB,CAAC,CASpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAUlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BnC,CAAC"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { MSADS_AGE_RANGES, MSADS_GENDERS } from "../utils/targeting-values.js";
|
|
3
|
+
import { NO_UNTRUSTED_CONTENT } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "msads_get_targeting_options";
|
|
5
|
+
const TOOL_TITLE = "Get Microsoft Ads Targeting Options (Static Reference)";
|
|
6
|
+
const TOOL_DESCRIPTION = `Discover the valid criterion targeting values to pass to \`msads_manage_criterions\`. This is the read-side counterpart to the criterion writes.
|
|
7
|
+
|
|
8
|
+
This tool does NOT call the Microsoft Advertising API — the values are fixed enums in the Campaign Management API schema (not a queryable endpoint), so they are served locally.
|
|
9
|
+
|
|
10
|
+
Supported targeting types:
|
|
11
|
+
- age: AgeRange criterion values
|
|
12
|
+
- gender: Gender criterion values
|
|
13
|
+
- device: DeviceType criterion values
|
|
14
|
+
- day: DayTime criterion day-of-week values (combine with FromHour/ToHour for dayparting)
|
|
15
|
+
|
|
16
|
+
Location targets are NOT enumerable via the REST API — use the Campaign Management \`GetGeoLocationsFileUrl\` operation to download the full geo-location reference file. Radius/proximity targets take caller-supplied coordinates, so they have no fixed enum to list.`;
|
|
17
|
+
export const GetTargetingOptionsInputSchema = z
|
|
18
|
+
.object({
|
|
19
|
+
targetingType: z
|
|
20
|
+
.enum(["age", "gender", "device", "day"])
|
|
21
|
+
.optional()
|
|
22
|
+
.describe("Criterion targeting type to enumerate; omit to return all types"),
|
|
23
|
+
})
|
|
24
|
+
.describe("Parameters for listing Microsoft Ads criterion targeting options");
|
|
25
|
+
export const GetTargetingOptionsOutputSchema = z
|
|
26
|
+
.object({
|
|
27
|
+
options: z
|
|
28
|
+
.record(z.string(), z.array(z.record(z.string(), z.any())))
|
|
29
|
+
.describe("Targeting option values keyed by targeting type"),
|
|
30
|
+
timestamp: z.string().datetime(),
|
|
31
|
+
})
|
|
32
|
+
.describe("Targeting options reference");
|
|
33
|
+
const TARGETING_OPTIONS = {
|
|
34
|
+
age: MSADS_AGE_RANGES.map((v) => ({ ...v })),
|
|
35
|
+
gender: MSADS_GENDERS.map((v) => ({ ...v })),
|
|
36
|
+
device: [
|
|
37
|
+
{ Id: "Computers", Name: "Computers" },
|
|
38
|
+
{ Id: "Smartphones", Name: "Smartphones" },
|
|
39
|
+
{ Id: "Tablets", Name: "Tablets" },
|
|
40
|
+
],
|
|
41
|
+
day: [
|
|
42
|
+
{ Id: "Monday", Name: "Monday" },
|
|
43
|
+
{ Id: "Tuesday", Name: "Tuesday" },
|
|
44
|
+
{ Id: "Wednesday", Name: "Wednesday" },
|
|
45
|
+
{ Id: "Thursday", Name: "Thursday" },
|
|
46
|
+
{ Id: "Friday", Name: "Friday" },
|
|
47
|
+
{ Id: "Saturday", Name: "Saturday" },
|
|
48
|
+
{ Id: "Sunday", Name: "Sunday" },
|
|
49
|
+
],
|
|
50
|
+
};
|
|
51
|
+
export async function getTargetingOptionsLogic(input, _context, _sdkContext) {
|
|
52
|
+
const options = input.targetingType
|
|
53
|
+
? { [input.targetingType]: TARGETING_OPTIONS[input.targetingType] ?? [] }
|
|
54
|
+
: TARGETING_OPTIONS;
|
|
55
|
+
return {
|
|
56
|
+
options,
|
|
57
|
+
timestamp: new Date().toISOString(),
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
export function getTargetingOptionsResponseFormatter(result) {
|
|
61
|
+
const lines = Object.entries(result.options)
|
|
62
|
+
.map(([type, values]) => `${type} (${values.length}): ${values.map((v) => v.Id).join(", ")}`)
|
|
63
|
+
.join("\n");
|
|
64
|
+
return [
|
|
65
|
+
{
|
|
66
|
+
type: "text",
|
|
67
|
+
text: `Microsoft Ads criterion targeting options (static reference)\n\n${lines}\n\nFull detail:\n${JSON.stringify(result.options, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
68
|
+
},
|
|
69
|
+
];
|
|
70
|
+
}
|
|
71
|
+
export const getTargetingOptionsTool = {
|
|
72
|
+
name: TOOL_NAME,
|
|
73
|
+
title: TOOL_TITLE,
|
|
74
|
+
description: TOOL_DESCRIPTION,
|
|
75
|
+
inputSchema: GetTargetingOptionsInputSchema,
|
|
76
|
+
outputSchema: GetTargetingOptionsOutputSchema,
|
|
77
|
+
annotations: {
|
|
78
|
+
readOnlyHint: true,
|
|
79
|
+
openWorldHint: false,
|
|
80
|
+
idempotentHint: true,
|
|
81
|
+
destructiveHint: false,
|
|
82
|
+
},
|
|
83
|
+
inputExamples: [
|
|
84
|
+
{
|
|
85
|
+
label: "List every criterion targeting type",
|
|
86
|
+
input: {},
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
label: "List the day-of-week values for dayparting",
|
|
90
|
+
input: { targetingType: "day" },
|
|
91
|
+
},
|
|
92
|
+
],
|
|
93
|
+
logic: getTargetingOptionsLogic,
|
|
94
|
+
responseFormatter: getTargetingOptionsResponseFormatter,
|
|
95
|
+
untrustedContent: NO_UNTRUSTED_CONTENT,
|
|
96
|
+
};
|
|
97
|
+
//# sourceMappingURL=get-targeting-options.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-targeting-options.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-targeting-options.tool.ts"],"names":[],"mappings":"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"}
|