@cesteral/amazon-dsp-mcp 1.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/LICENSE.md +201 -0
- package/README.md +59 -0
- package/dist/auth/amazon-dsp-auth-adapter.d.ts +42 -0
- package/dist/auth/amazon-dsp-auth-adapter.d.ts.map +1 -0
- package/dist/auth/amazon-dsp-auth-adapter.js +126 -0
- package/dist/auth/amazon-dsp-auth-adapter.js.map +1 -0
- package/dist/auth/amazon-dsp-auth-strategy.d.ts +14 -0
- package/dist/auth/amazon-dsp-auth-strategy.d.ts.map +1 -0
- package/dist/auth/amazon-dsp-auth-strategy.js +58 -0
- package/dist/auth/amazon-dsp-auth-strategy.js.map +1 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/config/index.d.ts +116 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +49 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +65 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +127 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +120 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +116 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +200 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +183 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +126 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +198 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +96 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +111 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +97 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +121 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +58 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +51 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +53 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +50 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +137 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +215 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +147 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +152 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +111 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +193 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +127 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +153 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +136 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +112 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +87 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +111 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +96 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +152 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +142 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +297 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js +107 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- 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 +85 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +75 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +63 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts +85 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js +91 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +76 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +71 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +289 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +181 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +271 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js +174 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +75 -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 +75 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +21 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +63 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts +54 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.js +58 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +171 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +89 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +93 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +134 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +119 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +114 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +169 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +104 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +24 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +42 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +57 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +105 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-api-contract.d.ts +43 -0
- package/dist/services/amazon-dsp/amazon-dsp-api-contract.d.ts.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-api-contract.js +193 -0
- package/dist/services/amazon-dsp/amazon-dsp-api-contract.js.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-http-client.d.ts +15 -0
- package/dist/services/amazon-dsp/amazon-dsp-http-client.d.ts.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-http-client.js +138 -0
- package/dist/services/amazon-dsp/amazon-dsp-http-client.js.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-reporting-service.d.ts +63 -0
- package/dist/services/amazon-dsp/amazon-dsp-reporting-service.d.ts.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-reporting-service.js +134 -0
- package/dist/services/amazon-dsp/amazon-dsp-reporting-service.js.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-service.d.ts +85 -0
- package/dist/services/amazon-dsp/amazon-dsp-service.d.ts.map +1 -0
- package/dist/services/amazon-dsp/amazon-dsp-service.js +182 -0
- package/dist/services/amazon-dsp/amazon-dsp-service.js.map +1 -0
- package/dist/services/amazon-dsp/types.d.ts +142 -0
- package/dist/services/amazon-dsp/types.d.ts.map +1 -0
- package/dist/services/amazon-dsp/types.js +24 -0
- package/dist/services/amazon-dsp/types.js.map +1 -0
- package/dist/services/session-services.d.ts +20 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +23 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +55 -0
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const GetReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
5
|
+
datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
|
|
6
|
+
startDate: z.ZodOptional<z.ZodString>;
|
|
7
|
+
endDate: z.ZodOptional<z.ZodString>;
|
|
8
|
+
type: z.ZodEnum<["CAMPAIGN", "INVENTORY", "AUDIENCE", "PRODUCTS", "TECHNOLOGY", "GEOGRAPHY", "CONVERSION_SOURCE"]>;
|
|
9
|
+
dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
10
|
+
metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
11
|
+
timeUnit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["DAILY", "SUMMARY"]>>>;
|
|
12
|
+
includeComputedMetrics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
13
|
+
} & Omit<{
|
|
14
|
+
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
|
|
15
|
+
columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
16
|
+
offset: z.ZodOptional<z.ZodNumber>;
|
|
17
|
+
maxRows: z.ZodOptional<z.ZodNumber>;
|
|
18
|
+
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
19
|
+
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
|
|
20
|
+
}, "columns">, "strip", z.ZodTypeAny, {
|
|
21
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
22
|
+
timeUnit: "DAILY" | "SUMMARY";
|
|
23
|
+
includeComputedMetrics: boolean;
|
|
24
|
+
mode: "rows" | "summary";
|
|
25
|
+
startDate?: string | undefined;
|
|
26
|
+
endDate?: string | undefined;
|
|
27
|
+
dimensions?: string[] | undefined;
|
|
28
|
+
metrics?: string[] | undefined;
|
|
29
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
30
|
+
offset?: number | undefined;
|
|
31
|
+
maxRows?: number | undefined;
|
|
32
|
+
aggregateBy?: string[] | undefined;
|
|
33
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
34
|
+
}, {
|
|
35
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
36
|
+
startDate?: string | undefined;
|
|
37
|
+
endDate?: string | undefined;
|
|
38
|
+
timeUnit?: "DAILY" | "SUMMARY" | undefined;
|
|
39
|
+
dimensions?: string[] | undefined;
|
|
40
|
+
metrics?: string[] | undefined;
|
|
41
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
42
|
+
includeComputedMetrics?: boolean | undefined;
|
|
43
|
+
mode?: "rows" | "summary" | undefined;
|
|
44
|
+
offset?: number | undefined;
|
|
45
|
+
maxRows?: number | undefined;
|
|
46
|
+
aggregateBy?: string[] | undefined;
|
|
47
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
48
|
+
}>, {
|
|
49
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
50
|
+
timeUnit: "DAILY" | "SUMMARY";
|
|
51
|
+
includeComputedMetrics: boolean;
|
|
52
|
+
mode: "rows" | "summary";
|
|
53
|
+
startDate?: string | undefined;
|
|
54
|
+
endDate?: string | undefined;
|
|
55
|
+
dimensions?: string[] | undefined;
|
|
56
|
+
metrics?: string[] | undefined;
|
|
57
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
58
|
+
offset?: number | undefined;
|
|
59
|
+
maxRows?: number | undefined;
|
|
60
|
+
aggregateBy?: string[] | undefined;
|
|
61
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
62
|
+
}, {
|
|
63
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
64
|
+
startDate?: string | undefined;
|
|
65
|
+
endDate?: string | undefined;
|
|
66
|
+
timeUnit?: "DAILY" | "SUMMARY" | undefined;
|
|
67
|
+
dimensions?: string[] | undefined;
|
|
68
|
+
metrics?: string[] | undefined;
|
|
69
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
70
|
+
includeComputedMetrics?: boolean | undefined;
|
|
71
|
+
mode?: "rows" | "summary" | undefined;
|
|
72
|
+
offset?: number | undefined;
|
|
73
|
+
maxRows?: number | undefined;
|
|
74
|
+
aggregateBy?: string[] | undefined;
|
|
75
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
76
|
+
}>;
|
|
77
|
+
export declare const GetReportOutputSchema: z.ZodObject<{
|
|
78
|
+
timestamp: z.ZodString;
|
|
79
|
+
totalRows: z.ZodNumber;
|
|
80
|
+
returnedRows: z.ZodNumber;
|
|
81
|
+
truncated: z.ZodBoolean;
|
|
82
|
+
nextOffset: z.ZodNullable<z.ZodNumber>;
|
|
83
|
+
headers: z.ZodArray<z.ZodString, "many">;
|
|
84
|
+
selectedColumns: z.ZodArray<z.ZodString, "many">;
|
|
85
|
+
mode: z.ZodEnum<["summary", "rows"]>;
|
|
86
|
+
previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
87
|
+
rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
88
|
+
warnings: z.ZodArray<z.ZodString, "many">;
|
|
89
|
+
taskId: z.ZodString;
|
|
90
|
+
}, "strip", z.ZodTypeAny, {
|
|
91
|
+
headers: string[];
|
|
92
|
+
taskId: string;
|
|
93
|
+
totalRows: number;
|
|
94
|
+
timestamp: string;
|
|
95
|
+
mode: "rows" | "summary";
|
|
96
|
+
returnedRows: number;
|
|
97
|
+
truncated: boolean;
|
|
98
|
+
nextOffset: number | null;
|
|
99
|
+
selectedColumns: string[];
|
|
100
|
+
warnings: string[];
|
|
101
|
+
rows?: Record<string, any>[] | undefined;
|
|
102
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
103
|
+
}, {
|
|
104
|
+
headers: string[];
|
|
105
|
+
taskId: string;
|
|
106
|
+
totalRows: number;
|
|
107
|
+
timestamp: string;
|
|
108
|
+
mode: "rows" | "summary";
|
|
109
|
+
returnedRows: number;
|
|
110
|
+
truncated: boolean;
|
|
111
|
+
nextOffset: number | null;
|
|
112
|
+
selectedColumns: string[];
|
|
113
|
+
warnings: string[];
|
|
114
|
+
rows?: Record<string, any>[] | undefined;
|
|
115
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
116
|
+
}>;
|
|
117
|
+
type GetReportInput = z.infer<typeof GetReportInputSchema>;
|
|
118
|
+
type GetReportOutput = z.infer<typeof GetReportOutputSchema>;
|
|
119
|
+
export declare function getReportLogic(input: GetReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetReportOutput>;
|
|
120
|
+
export declare function getReportResponseFormatter(result: GetReportOutput): McpTextContent[];
|
|
121
|
+
export declare const getReportTool: {
|
|
122
|
+
name: string;
|
|
123
|
+
title: string;
|
|
124
|
+
description: string;
|
|
125
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
126
|
+
datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
|
|
127
|
+
startDate: z.ZodOptional<z.ZodString>;
|
|
128
|
+
endDate: z.ZodOptional<z.ZodString>;
|
|
129
|
+
type: z.ZodEnum<["CAMPAIGN", "INVENTORY", "AUDIENCE", "PRODUCTS", "TECHNOLOGY", "GEOGRAPHY", "CONVERSION_SOURCE"]>;
|
|
130
|
+
dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
131
|
+
metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
132
|
+
timeUnit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["DAILY", "SUMMARY"]>>>;
|
|
133
|
+
includeComputedMetrics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
134
|
+
} & Omit<{
|
|
135
|
+
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
|
|
136
|
+
columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
137
|
+
offset: z.ZodOptional<z.ZodNumber>;
|
|
138
|
+
maxRows: z.ZodOptional<z.ZodNumber>;
|
|
139
|
+
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
140
|
+
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
|
|
141
|
+
}, "columns">, "strip", z.ZodTypeAny, {
|
|
142
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
143
|
+
timeUnit: "DAILY" | "SUMMARY";
|
|
144
|
+
includeComputedMetrics: boolean;
|
|
145
|
+
mode: "rows" | "summary";
|
|
146
|
+
startDate?: string | undefined;
|
|
147
|
+
endDate?: string | undefined;
|
|
148
|
+
dimensions?: string[] | undefined;
|
|
149
|
+
metrics?: string[] | undefined;
|
|
150
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
151
|
+
offset?: number | undefined;
|
|
152
|
+
maxRows?: number | undefined;
|
|
153
|
+
aggregateBy?: string[] | undefined;
|
|
154
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
155
|
+
}, {
|
|
156
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
157
|
+
startDate?: string | undefined;
|
|
158
|
+
endDate?: string | undefined;
|
|
159
|
+
timeUnit?: "DAILY" | "SUMMARY" | undefined;
|
|
160
|
+
dimensions?: string[] | undefined;
|
|
161
|
+
metrics?: string[] | undefined;
|
|
162
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
163
|
+
includeComputedMetrics?: boolean | undefined;
|
|
164
|
+
mode?: "rows" | "summary" | undefined;
|
|
165
|
+
offset?: number | undefined;
|
|
166
|
+
maxRows?: number | undefined;
|
|
167
|
+
aggregateBy?: string[] | undefined;
|
|
168
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
169
|
+
}>, {
|
|
170
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
171
|
+
timeUnit: "DAILY" | "SUMMARY";
|
|
172
|
+
includeComputedMetrics: boolean;
|
|
173
|
+
mode: "rows" | "summary";
|
|
174
|
+
startDate?: string | undefined;
|
|
175
|
+
endDate?: string | undefined;
|
|
176
|
+
dimensions?: string[] | undefined;
|
|
177
|
+
metrics?: string[] | undefined;
|
|
178
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
179
|
+
offset?: number | undefined;
|
|
180
|
+
maxRows?: number | undefined;
|
|
181
|
+
aggregateBy?: string[] | undefined;
|
|
182
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
183
|
+
}, {
|
|
184
|
+
type: "CAMPAIGN" | "INVENTORY" | "AUDIENCE" | "PRODUCTS" | "TECHNOLOGY" | "GEOGRAPHY" | "CONVERSION_SOURCE";
|
|
185
|
+
startDate?: string | undefined;
|
|
186
|
+
endDate?: string | undefined;
|
|
187
|
+
timeUnit?: "DAILY" | "SUMMARY" | undefined;
|
|
188
|
+
dimensions?: string[] | undefined;
|
|
189
|
+
metrics?: string[] | undefined;
|
|
190
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
191
|
+
includeComputedMetrics?: boolean | undefined;
|
|
192
|
+
mode?: "rows" | "summary" | undefined;
|
|
193
|
+
offset?: number | undefined;
|
|
194
|
+
maxRows?: number | undefined;
|
|
195
|
+
aggregateBy?: string[] | undefined;
|
|
196
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
197
|
+
}>;
|
|
198
|
+
outputSchema: z.ZodObject<{
|
|
199
|
+
timestamp: z.ZodString;
|
|
200
|
+
totalRows: z.ZodNumber;
|
|
201
|
+
returnedRows: z.ZodNumber;
|
|
202
|
+
truncated: z.ZodBoolean;
|
|
203
|
+
nextOffset: z.ZodNullable<z.ZodNumber>;
|
|
204
|
+
headers: z.ZodArray<z.ZodString, "many">;
|
|
205
|
+
selectedColumns: z.ZodArray<z.ZodString, "many">;
|
|
206
|
+
mode: z.ZodEnum<["summary", "rows"]>;
|
|
207
|
+
previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
208
|
+
rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
209
|
+
warnings: z.ZodArray<z.ZodString, "many">;
|
|
210
|
+
taskId: z.ZodString;
|
|
211
|
+
}, "strip", z.ZodTypeAny, {
|
|
212
|
+
headers: string[];
|
|
213
|
+
taskId: string;
|
|
214
|
+
totalRows: number;
|
|
215
|
+
timestamp: string;
|
|
216
|
+
mode: "rows" | "summary";
|
|
217
|
+
returnedRows: number;
|
|
218
|
+
truncated: boolean;
|
|
219
|
+
nextOffset: number | null;
|
|
220
|
+
selectedColumns: string[];
|
|
221
|
+
warnings: string[];
|
|
222
|
+
rows?: Record<string, any>[] | undefined;
|
|
223
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
224
|
+
}, {
|
|
225
|
+
headers: string[];
|
|
226
|
+
taskId: string;
|
|
227
|
+
totalRows: number;
|
|
228
|
+
timestamp: string;
|
|
229
|
+
mode: "rows" | "summary";
|
|
230
|
+
returnedRows: number;
|
|
231
|
+
truncated: boolean;
|
|
232
|
+
nextOffset: number | null;
|
|
233
|
+
selectedColumns: string[];
|
|
234
|
+
warnings: string[];
|
|
235
|
+
rows?: Record<string, any>[] | undefined;
|
|
236
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
237
|
+
}>;
|
|
238
|
+
annotations: {
|
|
239
|
+
readOnlyHint: boolean;
|
|
240
|
+
openWorldHint: boolean;
|
|
241
|
+
idempotentHint: boolean;
|
|
242
|
+
destructiveHint: boolean;
|
|
243
|
+
};
|
|
244
|
+
inputExamples: ({
|
|
245
|
+
label: string;
|
|
246
|
+
input: {
|
|
247
|
+
datePreset: string;
|
|
248
|
+
type: string;
|
|
249
|
+
dimensions: string[];
|
|
250
|
+
metrics: string[];
|
|
251
|
+
timeUnit: string;
|
|
252
|
+
startDate?: undefined;
|
|
253
|
+
endDate?: undefined;
|
|
254
|
+
};
|
|
255
|
+
} | {
|
|
256
|
+
label: string;
|
|
257
|
+
input: {
|
|
258
|
+
startDate: string;
|
|
259
|
+
endDate: string;
|
|
260
|
+
type: string;
|
|
261
|
+
dimensions: string[];
|
|
262
|
+
metrics: string[];
|
|
263
|
+
timeUnit: string;
|
|
264
|
+
datePreset?: undefined;
|
|
265
|
+
};
|
|
266
|
+
})[];
|
|
267
|
+
logic: typeof getReportLogic;
|
|
268
|
+
responseFormatter: typeof getReportResponseFormatter;
|
|
269
|
+
};
|
|
270
|
+
export {};
|
|
271
|
+
//# sourceMappingURL=get-report.tool.d.ts.map
|
|
@@ -0,0 +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;AAcxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkD4B,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMN,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,CAyC1B;AAsCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCzB,CAAC"}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { arrayRowsToRecords, computeMetrics, createReportView, formatReportViewResponse, getReportViewFetchLimit, resolveDatePreset, DATE_PRESET_VALUES, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
|
|
4
|
+
import { AMAZON_DSP_REPORTING_CONTRACT } from "../../../services/amazon-dsp/amazon-dsp-api-contract.js";
|
|
5
|
+
const TOOL_NAME = "amazon_dsp_get_report";
|
|
6
|
+
const TOOL_TITLE = "Get Amazon DSP Report";
|
|
7
|
+
const TOOL_DESCRIPTION = `Submit and retrieve an async Amazon DSP performance report (legacy /dsp/reports API).
|
|
8
|
+
|
|
9
|
+
Follows the async polling pattern: submit task → poll until SUCCESS → download data. This may take 30s–5 minutes depending on the data volume.
|
|
10
|
+
|
|
11
|
+
**Allowed \`type\`:** CAMPAIGN, INVENTORY, AUDIENCE, PRODUCTS, TECHNOLOGY, GEOGRAPHY, CONVERSION_SOURCE.
|
|
12
|
+
**CAMPAIGN \`dimensions\`:** ORDER, LINE_ITEM, CREATIVE.
|
|
13
|
+
**Common metrics:** impressions, totalCost, viewableImpressions, viewabilityRate (Amazon returns an authoritative invalid-list for unknown names).
|
|
14
|
+
|
|
15
|
+
Note: Amazon DSP has a maximum 95-day lookback. LAST_90_DAYS is supported; avoid custom ranges beyond 95 days.`;
|
|
16
|
+
export const GetReportInputSchema = z
|
|
17
|
+
.object({
|
|
18
|
+
datePreset: z
|
|
19
|
+
.enum(DATE_PRESET_VALUES)
|
|
20
|
+
.optional()
|
|
21
|
+
.describe("Preset date range. Use this OR startDate+endDate (not both). Max 95-day lookback — LAST_90_DAYS is the longest supported preset"),
|
|
22
|
+
startDate: z
|
|
23
|
+
.string()
|
|
24
|
+
.regex(/^\d{4}-\d{2}-\d{2}$/)
|
|
25
|
+
.optional()
|
|
26
|
+
.describe("Start date (YYYY-MM-DD format). Max 95-day lookback. Required if datePreset not provided. Converted to YYYYMMDD upstream."),
|
|
27
|
+
endDate: z
|
|
28
|
+
.string()
|
|
29
|
+
.regex(/^\d{4}-\d{2}-\d{2}$/)
|
|
30
|
+
.optional()
|
|
31
|
+
.describe("End date (YYYY-MM-DD format). Required if datePreset not provided."),
|
|
32
|
+
type: z
|
|
33
|
+
.enum(AMAZON_DSP_REPORTING_CONTRACT.reportTypes)
|
|
34
|
+
.describe(`Report category. One of: ${AMAZON_DSP_REPORTING_CONTRACT.reportTypes.join(", ")}.`),
|
|
35
|
+
dimensions: z
|
|
36
|
+
.array(z.string())
|
|
37
|
+
.optional()
|
|
38
|
+
.describe("Grouping dimensions (CAMPAIGN: ORDER, LINE_ITEM, CREATIVE)."),
|
|
39
|
+
metrics: z
|
|
40
|
+
.array(z.string())
|
|
41
|
+
.optional()
|
|
42
|
+
.describe("Metric names. Joined to comma-string upstream."),
|
|
43
|
+
timeUnit: z
|
|
44
|
+
.enum(["DAILY", "SUMMARY"])
|
|
45
|
+
.optional()
|
|
46
|
+
.default("DAILY")
|
|
47
|
+
.describe("Time unit for the report (default: DAILY)"),
|
|
48
|
+
includeComputedMetrics: z
|
|
49
|
+
.boolean()
|
|
50
|
+
.optional()
|
|
51
|
+
.default(false)
|
|
52
|
+
.describe("Include computed CPA, ROAS, CPM, CTR, CPC"),
|
|
53
|
+
})
|
|
54
|
+
.merge(ReportViewInputSchema.omit({ columns: true }))
|
|
55
|
+
.refine((data) => data.datePreset !== undefined || (data.startDate !== undefined && data.endDate !== undefined), { message: "Provide either datePreset or both startDate and endDate" })
|
|
56
|
+
.describe("Parameters for generating an Amazon DSP report");
|
|
57
|
+
export const GetReportOutputSchema = z
|
|
58
|
+
.object({
|
|
59
|
+
taskId: z.string().describe("Report task ID"),
|
|
60
|
+
...ReportViewOutputSchema.shape,
|
|
61
|
+
timestamp: z.string().datetime(),
|
|
62
|
+
})
|
|
63
|
+
.describe("Report result");
|
|
64
|
+
export async function getReportLogic(input, context, sdkContext) {
|
|
65
|
+
const { amazonDspReportingService } = resolveSessionServices(sdkContext);
|
|
66
|
+
let resolvedStartDate = input.startDate;
|
|
67
|
+
let resolvedEndDate = input.endDate;
|
|
68
|
+
if (input.datePreset) {
|
|
69
|
+
const resolved = resolveDatePreset(input.datePreset);
|
|
70
|
+
resolvedStartDate = resolved.startDate;
|
|
71
|
+
resolvedEndDate = resolved.endDate;
|
|
72
|
+
}
|
|
73
|
+
const result = await amazonDspReportingService.getReport({
|
|
74
|
+
startDate: resolvedStartDate,
|
|
75
|
+
endDate: resolvedEndDate,
|
|
76
|
+
type: input.type,
|
|
77
|
+
dimensions: input.dimensions,
|
|
78
|
+
metrics: input.metrics,
|
|
79
|
+
timeUnit: input.timeUnit,
|
|
80
|
+
}, getReportViewFetchLimit(input), context);
|
|
81
|
+
let headers = result.headers;
|
|
82
|
+
let rows = result.rows;
|
|
83
|
+
if (input.includeComputedMetrics) {
|
|
84
|
+
({ headers, rows } = appendComputedMetricsToRows(headers, rows));
|
|
85
|
+
}
|
|
86
|
+
return {
|
|
87
|
+
taskId: result.taskId,
|
|
88
|
+
...createReportView({
|
|
89
|
+
headers,
|
|
90
|
+
rows: arrayRowsToRecords(headers, rows),
|
|
91
|
+
totalRows: result.totalRows,
|
|
92
|
+
input,
|
|
93
|
+
}),
|
|
94
|
+
timestamp: new Date().toISOString(),
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
function appendComputedMetricsToRows(headers, rows) {
|
|
98
|
+
const idx = (name) => headers.findIndex((h) => h.toLowerCase() === name.toLowerCase());
|
|
99
|
+
const costIdx = idx("totalCost");
|
|
100
|
+
const impIdx = idx("impressions");
|
|
101
|
+
const clickIdx = idx("clickThroughs");
|
|
102
|
+
const convIdx = idx("purchases14d");
|
|
103
|
+
const newHeaders = [
|
|
104
|
+
...headers,
|
|
105
|
+
"computed_cpa",
|
|
106
|
+
"computed_roas",
|
|
107
|
+
"computed_cpm",
|
|
108
|
+
"computed_ctr",
|
|
109
|
+
"computed_cpc",
|
|
110
|
+
];
|
|
111
|
+
const newRows = rows.map((row) => {
|
|
112
|
+
const cost = costIdx >= 0 ? Number(row[costIdx] || 0) : 0;
|
|
113
|
+
const impressions = impIdx >= 0 ? Number(row[impIdx] || 0) : 0;
|
|
114
|
+
const clicks = clickIdx >= 0 ? Number(row[clickIdx] || 0) : 0;
|
|
115
|
+
const conversions = convIdx >= 0 ? Number(row[convIdx] || 0) : 0;
|
|
116
|
+
const m = computeMetrics({ cost, impressions, clicks, conversions, conversionValue: 0 });
|
|
117
|
+
return [
|
|
118
|
+
...row,
|
|
119
|
+
m.cpa !== null ? String(m.cpa) : "",
|
|
120
|
+
m.roas !== null ? String(m.roas) : "",
|
|
121
|
+
m.cpm !== null ? String(m.cpm) : "",
|
|
122
|
+
m.ctr !== null ? String(m.ctr) : "",
|
|
123
|
+
m.cpc !== null ? String(m.cpc) : "",
|
|
124
|
+
];
|
|
125
|
+
});
|
|
126
|
+
return { headers: newHeaders, rows: newRows };
|
|
127
|
+
}
|
|
128
|
+
export function getReportResponseFormatter(result) {
|
|
129
|
+
return [
|
|
130
|
+
{
|
|
131
|
+
type: "text",
|
|
132
|
+
text: `Report task: ${result.taskId}\n\n${formatReportViewResponse(result, "Report data")}`,
|
|
133
|
+
},
|
|
134
|
+
];
|
|
135
|
+
}
|
|
136
|
+
export const getReportTool = {
|
|
137
|
+
name: TOOL_NAME,
|
|
138
|
+
title: TOOL_TITLE,
|
|
139
|
+
description: TOOL_DESCRIPTION,
|
|
140
|
+
inputSchema: GetReportInputSchema,
|
|
141
|
+
outputSchema: GetReportOutputSchema,
|
|
142
|
+
annotations: {
|
|
143
|
+
readOnlyHint: true,
|
|
144
|
+
openWorldHint: false,
|
|
145
|
+
idempotentHint: false,
|
|
146
|
+
destructiveHint: false,
|
|
147
|
+
},
|
|
148
|
+
inputExamples: [
|
|
149
|
+
{
|
|
150
|
+
label: "Daily line-item-level CAMPAIGN report for last 7 days",
|
|
151
|
+
input: {
|
|
152
|
+
datePreset: "LAST_7_DAYS",
|
|
153
|
+
type: "CAMPAIGN",
|
|
154
|
+
dimensions: ["ORDER", "LINE_ITEM"],
|
|
155
|
+
metrics: ["impressions", "totalCost"],
|
|
156
|
+
timeUnit: "DAILY",
|
|
157
|
+
},
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
label: "Order-level CAMPAIGN summary for a custom range",
|
|
161
|
+
input: {
|
|
162
|
+
startDate: "2026-03-01",
|
|
163
|
+
endDate: "2026-03-04",
|
|
164
|
+
type: "CAMPAIGN",
|
|
165
|
+
dimensions: ["ORDER"],
|
|
166
|
+
metrics: ["impressions", "totalCost", "viewableImpressions"],
|
|
167
|
+
timeUnit: "SUMMARY",
|
|
168
|
+
},
|
|
169
|
+
},
|
|
170
|
+
],
|
|
171
|
+
logic: getReportLogic,
|
|
172
|
+
responseFormatter: getReportResponseFormatter,
|
|
173
|
+
};
|
|
174
|
+
//# sourceMappingURL=get-report.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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,75 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const GetTargetingOptionsInputSchema: z.ZodObject<{
|
|
5
|
+
profileId: z.ZodString;
|
|
6
|
+
targetingType: z.ZodOptional<z.ZodString>;
|
|
7
|
+
}, "strip", z.ZodTypeAny, {
|
|
8
|
+
profileId: string;
|
|
9
|
+
targetingType?: string | undefined;
|
|
10
|
+
}, {
|
|
11
|
+
profileId: string;
|
|
12
|
+
targetingType?: string | undefined;
|
|
13
|
+
}>;
|
|
14
|
+
export declare const GetTargetingOptionsOutputSchema: z.ZodObject<{
|
|
15
|
+
options: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
16
|
+
timestamp: z.ZodString;
|
|
17
|
+
}, "strip", z.ZodTypeAny, {
|
|
18
|
+
options: Record<string, any>;
|
|
19
|
+
timestamp: string;
|
|
20
|
+
}, {
|
|
21
|
+
options: Record<string, any>;
|
|
22
|
+
timestamp: string;
|
|
23
|
+
}>;
|
|
24
|
+
type GetTargetingOptionsInput = z.infer<typeof GetTargetingOptionsInputSchema>;
|
|
25
|
+
type GetTargetingOptionsOutput = z.infer<typeof GetTargetingOptionsOutputSchema>;
|
|
26
|
+
export declare function getTargetingOptionsLogic(input: GetTargetingOptionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetTargetingOptionsOutput>;
|
|
27
|
+
export declare function getTargetingOptionsResponseFormatter(result: GetTargetingOptionsOutput): McpTextContent[];
|
|
28
|
+
export declare const getTargetingOptionsTool: {
|
|
29
|
+
name: string;
|
|
30
|
+
title: string;
|
|
31
|
+
description: string;
|
|
32
|
+
inputSchema: z.ZodObject<{
|
|
33
|
+
profileId: z.ZodString;
|
|
34
|
+
targetingType: z.ZodOptional<z.ZodString>;
|
|
35
|
+
}, "strip", z.ZodTypeAny, {
|
|
36
|
+
profileId: string;
|
|
37
|
+
targetingType?: string | undefined;
|
|
38
|
+
}, {
|
|
39
|
+
profileId: string;
|
|
40
|
+
targetingType?: string | undefined;
|
|
41
|
+
}>;
|
|
42
|
+
outputSchema: z.ZodObject<{
|
|
43
|
+
options: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
44
|
+
timestamp: z.ZodString;
|
|
45
|
+
}, "strip", z.ZodTypeAny, {
|
|
46
|
+
options: Record<string, any>;
|
|
47
|
+
timestamp: string;
|
|
48
|
+
}, {
|
|
49
|
+
options: Record<string, any>;
|
|
50
|
+
timestamp: string;
|
|
51
|
+
}>;
|
|
52
|
+
annotations: {
|
|
53
|
+
readOnlyHint: boolean;
|
|
54
|
+
openWorldHint: boolean;
|
|
55
|
+
idempotentHint: boolean;
|
|
56
|
+
destructiveHint: boolean;
|
|
57
|
+
};
|
|
58
|
+
inputExamples: ({
|
|
59
|
+
label: string;
|
|
60
|
+
input: {
|
|
61
|
+
profileId: string;
|
|
62
|
+
targetingType?: undefined;
|
|
63
|
+
};
|
|
64
|
+
} | {
|
|
65
|
+
label: string;
|
|
66
|
+
input: {
|
|
67
|
+
profileId: string;
|
|
68
|
+
targetingType: string;
|
|
69
|
+
};
|
|
70
|
+
})[];
|
|
71
|
+
logic: typeof getTargetingOptionsLogic;
|
|
72
|
+
responseFormatter: typeof getTargetingOptionsResponseFormatter;
|
|
73
|
+
};
|
|
74
|
+
export {};
|
|
75
|
+
//# 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;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWnD,eAAO,MAAM,8BAA8B;;;;;;;;;EAWuB,CAAC;AAEnE,eAAO,MAAM,+BAA+B;;;;;;;;;EAKL,CAAC;AAExC,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;AAEjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAYpC;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,EAAE,CAOxG;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnC,CAAC"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
const TOOL_NAME = "amazon_dsp_get_targeting_options";
|
|
4
|
+
const TOOL_TITLE = "Get AmazonDsp Targeting Options";
|
|
5
|
+
const TOOL_DESCRIPTION = `Browse available AmazonDsp ad targeting options and categories.
|
|
6
|
+
|
|
7
|
+
Returns a structured list of targeting options available for a given objective type.
|
|
8
|
+
Use this to discover valid targeting values before creating or updating ad groups.
|
|
9
|
+
|
|
10
|
+
**Common objective types:** TRAFFIC, APP_INSTALLS, CONVERSIONS, AWARENESS, VIDEO_VIEWS`;
|
|
11
|
+
export const GetTargetingOptionsInputSchema = z
|
|
12
|
+
.object({
|
|
13
|
+
profileId: z
|
|
14
|
+
.string()
|
|
15
|
+
.min(1)
|
|
16
|
+
.describe("AmazonDsp Advertiser ID"),
|
|
17
|
+
targetingType: z
|
|
18
|
+
.string()
|
|
19
|
+
.optional()
|
|
20
|
+
.describe("Optional objective type to filter targeting options (e.g., TRAFFIC, APP_INSTALLS)"),
|
|
21
|
+
})
|
|
22
|
+
.describe("Parameters for browsing AmazonDsp targeting options");
|
|
23
|
+
export const GetTargetingOptionsOutputSchema = z
|
|
24
|
+
.object({
|
|
25
|
+
options: z.record(z.any()).describe("Available targeting options"),
|
|
26
|
+
timestamp: z.string().datetime(),
|
|
27
|
+
})
|
|
28
|
+
.describe("Targeting options result");
|
|
29
|
+
export async function getTargetingOptionsLogic(input, context, sdkContext) {
|
|
30
|
+
const { amazonDspService } = resolveSessionServices(sdkContext);
|
|
31
|
+
const options = (await amazonDspService.getTargetingOptions(input.targetingType, context));
|
|
32
|
+
return {
|
|
33
|
+
options,
|
|
34
|
+
timestamp: new Date().toISOString(),
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
export function getTargetingOptionsResponseFormatter(result) {
|
|
38
|
+
return [
|
|
39
|
+
{
|
|
40
|
+
type: "text",
|
|
41
|
+
text: `AmazonDsp targeting options:\n${JSON.stringify(result.options, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
42
|
+
},
|
|
43
|
+
];
|
|
44
|
+
}
|
|
45
|
+
export const getTargetingOptionsTool = {
|
|
46
|
+
name: TOOL_NAME,
|
|
47
|
+
title: TOOL_TITLE,
|
|
48
|
+
description: TOOL_DESCRIPTION,
|
|
49
|
+
inputSchema: GetTargetingOptionsInputSchema,
|
|
50
|
+
outputSchema: GetTargetingOptionsOutputSchema,
|
|
51
|
+
annotations: {
|
|
52
|
+
readOnlyHint: true,
|
|
53
|
+
openWorldHint: false,
|
|
54
|
+
idempotentHint: true,
|
|
55
|
+
destructiveHint: false,
|
|
56
|
+
},
|
|
57
|
+
inputExamples: [
|
|
58
|
+
{
|
|
59
|
+
label: "Get all targeting options",
|
|
60
|
+
input: {
|
|
61
|
+
profileId: "1234567890",
|
|
62
|
+
},
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
label: "Get targeting options for traffic objective",
|
|
66
|
+
input: {
|
|
67
|
+
profileId: "1234567890",
|
|
68
|
+
targetingType: "TRAFFIC",
|
|
69
|
+
},
|
|
70
|
+
},
|
|
71
|
+
],
|
|
72
|
+
logic: getTargetingOptionsLogic,
|
|
73
|
+
responseFormatter: getTargetingOptionsResponseFormatter,
|
|
74
|
+
};
|
|
75
|
+
//# 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":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,kCAAkC,CAAC;AACrD,MAAM,UAAU,GAAG,iCAAiC,CAAC;AACrD,MAAM,gBAAgB,GAAG;;;;;uFAK8D,CAAC;AAExF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,yBAAyB,CAAC;IACtC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;CACjG,CAAC;KACD,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA+B,EAC/B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,OAAO,GAAG,CAAC,MAAM,gBAAgB,CAAC,mBAAmB,CACzD,KAAK,CAAC,aAAa,EACnB,OAAO,CACR,CAA4B,CAAC;IAE9B,OAAO;QACL,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,MAAiC;IACpF,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,iCAAiC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACnH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,8BAA8B;IAC3C,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE;gBACL,SAAS,EAAE,YAAY;aACxB;SACF;QACD;YACE,KAAK,EAAE,6CAA6C;YACpD,KAAK,EAAE;gBACL,SAAS,EAAE,YAAY;gBACvB,aAAa,EAAE,SAAS;aACzB;SACF;KACF;IACD,KAAK,EAAE,wBAAwB;IAC/B,iBAAiB,EAAE,oCAAoC;CACxD,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export { listEntitiesTool } from "./list-entities.tool.js";
|
|
2
|
+
export { getEntityTool } from "./get-entity.tool.js";
|
|
3
|
+
export { createEntityTool } from "./create-entity.tool.js";
|
|
4
|
+
export { updateEntityTool } from "./update-entity.tool.js";
|
|
5
|
+
export { deleteEntityTool } from "./delete-entity.tool.js";
|
|
6
|
+
export { listAdvertisersTool } from "./list-advertisers.tool.js";
|
|
7
|
+
export { getReportTool } from "./get-report.tool.js";
|
|
8
|
+
export { getReportBreakdownsTool } from "./get-report-breakdowns.tool.js";
|
|
9
|
+
export { submitReportTool } from "./submit-report.tool.js";
|
|
10
|
+
export { checkReportStatusTool } from "./check-report-status.tool.js";
|
|
11
|
+
export { downloadReportTool } from "./download-report.tool.js";
|
|
12
|
+
export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
|
|
13
|
+
export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
|
|
14
|
+
export { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
|
|
15
|
+
export { adjustBidsTool } from "./adjust-bids.tool.js";
|
|
16
|
+
export { getAdPreviewTool } from "./get-ad-preview.tool.js";
|
|
17
|
+
export { duplicateEntityTool } from "./duplicate-entity.tool.js";
|
|
18
|
+
export { validateEntityTool } from "./validate-entity.tool.js";
|
|
19
|
+
import { type ToolDefinitionForFactory } from "@cesteral/shared";
|
|
20
|
+
export declare const allTools: ToolDefinitionForFactory[];
|
|
21
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAoB/D,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AAoC1B,eAAO,MAAM,QAAQ,EAAE,wBAAwB,EAG9C,CAAC"}
|