@cesteral/msads-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 +179 -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/auth/msads-auth-adapter.d.ts +27 -0
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
- package/dist/auth/msads-auth-adapter.js +79 -0
- package/dist/auth/msads-auth-adapter.js.map +1 -0
- package/dist/auth/msads-auth-strategy.d.ts +8 -0
- package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
- package/dist/auth/msads-auth-strategy.js +36 -0
- package/dist/auth/msads-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +112 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +56 -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 +47 -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 +54 -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 +147 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
- package/dist/mcp-server/prompts/definitions/google-import-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 +55 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.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 +47 -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 +49 -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 +84 -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 +54 -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 +54 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
- package/dist/mcp-server/resources/definitions/field-rules.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 +79 -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 +64 -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/resources/utils/field-rules.d.ts +9 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.js +106 -0
- package/dist/mcp-server/resources/utils/field-rules.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 +142 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -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 +124 -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 +83 -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 +68 -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 +95 -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 +102 -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 +151 -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 +112 -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 +111 -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 +73 -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 +81 -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 +74 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -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 +94 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -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 +85 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +68 -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 +90 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +285 -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 +120 -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 +280 -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 +138 -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 +260 -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 +118 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +53 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -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 +100 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -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 +105 -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 +132 -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 +94 -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 +79 -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 +64 -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 +174 -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 +142 -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 +20 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +118 -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 +55 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/msads/msads-http-client.d.ts +16 -0
- package/dist/services/msads/msads-http-client.d.ts.map +1 -0
- package/dist/services/msads/msads-http-client.js +89 -0
- package/dist/services/msads/msads-http-client.js.map +1 -0
- package/dist/services/msads/msads-reporting-service.d.ts +58 -0
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
- package/dist/services/msads/msads-reporting-service.js +153 -0
- package/dist/services/msads/msads-reporting-service.js.map +1 -0
- package/dist/services/msads/msads-service.d.ts +54 -0
- package/dist/services/msads/msads-service.d.ts.map +1 -0
- package/dist/services/msads/msads-service.js +179 -0
- package/dist/services/msads/msads-service.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +3 -0
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
- package/dist/services/msads/rate-limit-keys.js +3 -0
- package/dist/services/msads/rate-limit-keys.js.map +1 -0
- package/dist/services/msads/types.d.ts +196 -0
- package/dist/services/msads/types.d.ts.map +1 -0
- package/dist/services/msads/types.js +47 -0
- package/dist/services/msads/types.js.map +1 -0
- package/dist/services/session-services.d.ts +22 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +22 -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 +56 -0
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { resolveDatePreset, DATE_PRESET_VALUES } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "msads_submit_report";
|
|
5
|
+
const TOOL_TITLE = "Submit Microsoft Ads Report";
|
|
6
|
+
const TOOL_DESCRIPTION = `Submit a Microsoft Advertising report request without waiting for completion (non-blocking).
|
|
7
|
+
|
|
8
|
+
Returns a ReportRequestId that can be used with msads_check_report_status to poll for results.`;
|
|
9
|
+
export const SubmitReportInputSchema = z
|
|
10
|
+
.object({
|
|
11
|
+
reportType: z.string().describe("Report type (e.g., CampaignPerformanceReportRequest)"),
|
|
12
|
+
accountId: z.string().describe("Microsoft Ads Account ID"),
|
|
13
|
+
columns: z.array(z.string()).min(1).describe("Report columns to include"),
|
|
14
|
+
datePreset: z
|
|
15
|
+
.enum(DATE_PRESET_VALUES)
|
|
16
|
+
.optional()
|
|
17
|
+
.describe("Preset date range. Use this OR startDate+endDate (not both)"),
|
|
18
|
+
startDate: z
|
|
19
|
+
.string()
|
|
20
|
+
.optional()
|
|
21
|
+
.describe("Start date (YYYY-MM-DD, required if datePreset not provided)"),
|
|
22
|
+
endDate: z
|
|
23
|
+
.string()
|
|
24
|
+
.optional()
|
|
25
|
+
.describe("End date (YYYY-MM-DD, required if datePreset not provided)"),
|
|
26
|
+
aggregation: z
|
|
27
|
+
.string()
|
|
28
|
+
.optional()
|
|
29
|
+
.describe("Time aggregation (Daily, Weekly, Monthly, Hourly). Default: Daily"),
|
|
30
|
+
})
|
|
31
|
+
.refine((data) => data.datePreset !== undefined || (data.startDate !== undefined && data.endDate !== undefined), { message: "Provide either datePreset or both startDate and endDate" })
|
|
32
|
+
.describe("Parameters for submitting a Microsoft Ads report");
|
|
33
|
+
export const SubmitReportOutputSchema = z
|
|
34
|
+
.object({
|
|
35
|
+
reportRequestId: z.string(),
|
|
36
|
+
timestamp: z.string().datetime(),
|
|
37
|
+
})
|
|
38
|
+
.describe("Report submission result");
|
|
39
|
+
export async function submitReportLogic(input, context, sdkContext) {
|
|
40
|
+
const { msadsReportingService } = resolveSessionServices(sdkContext);
|
|
41
|
+
let resolvedStartDate = input.startDate;
|
|
42
|
+
let resolvedEndDate = input.endDate;
|
|
43
|
+
if (input.datePreset) {
|
|
44
|
+
const resolved = resolveDatePreset(input.datePreset);
|
|
45
|
+
resolvedStartDate = resolved.startDate;
|
|
46
|
+
resolvedEndDate = resolved.endDate;
|
|
47
|
+
}
|
|
48
|
+
const reportRequestId = await msadsReportingService.submitReport({
|
|
49
|
+
reportType: input.reportType,
|
|
50
|
+
accountId: input.accountId,
|
|
51
|
+
columns: input.columns,
|
|
52
|
+
dateRange: { startDate: resolvedStartDate, endDate: resolvedEndDate },
|
|
53
|
+
aggregation: input.aggregation,
|
|
54
|
+
}, context);
|
|
55
|
+
return {
|
|
56
|
+
reportRequestId,
|
|
57
|
+
timestamp: new Date().toISOString(),
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
export function submitReportResponseFormatter(result) {
|
|
61
|
+
return [
|
|
62
|
+
{
|
|
63
|
+
type: "text",
|
|
64
|
+
text: `Report submitted successfully.\n\nReportRequestId: ${result.reportRequestId}\n\nUse msads_check_report_status to poll for completion.\n\nTimestamp: ${result.timestamp}`,
|
|
65
|
+
},
|
|
66
|
+
];
|
|
67
|
+
}
|
|
68
|
+
export const submitReportTool = {
|
|
69
|
+
name: TOOL_NAME,
|
|
70
|
+
title: TOOL_TITLE,
|
|
71
|
+
description: TOOL_DESCRIPTION,
|
|
72
|
+
inputSchema: SubmitReportInputSchema,
|
|
73
|
+
outputSchema: SubmitReportOutputSchema,
|
|
74
|
+
annotations: {
|
|
75
|
+
readOnlyHint: false,
|
|
76
|
+
openWorldHint: false,
|
|
77
|
+
idempotentHint: false,
|
|
78
|
+
destructiveHint: false,
|
|
79
|
+
},
|
|
80
|
+
inputExamples: [
|
|
81
|
+
{
|
|
82
|
+
label: "Submit keyword performance report",
|
|
83
|
+
input: {
|
|
84
|
+
reportType: "KeywordPerformanceReportRequest",
|
|
85
|
+
accountId: "123456789",
|
|
86
|
+
columns: ["Keyword", "Impressions", "Clicks", "AverageCpc"],
|
|
87
|
+
datePreset: "LAST_30_DAYS",
|
|
88
|
+
},
|
|
89
|
+
},
|
|
90
|
+
],
|
|
91
|
+
logic: submitReportLogic,
|
|
92
|
+
responseFormatter: submitReportResponseFormatter,
|
|
93
|
+
};
|
|
94
|
+
//# sourceMappingURL=submit-report.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"submit-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
|
+
export declare const UpdateEntityInputSchema: z.ZodObject<{
|
|
4
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
5
|
+
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
6
|
+
}, "strip", z.ZodTypeAny, {
|
|
7
|
+
entityType: string;
|
|
8
|
+
data: Record<string, unknown>;
|
|
9
|
+
}, {
|
|
10
|
+
entityType: string;
|
|
11
|
+
data: Record<string, unknown>;
|
|
12
|
+
}>;
|
|
13
|
+
export declare const UpdateEntityOutputSchema: z.ZodObject<{
|
|
14
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
15
|
+
entityType: z.ZodString;
|
|
16
|
+
timestamp: z.ZodString;
|
|
17
|
+
}, "strip", z.ZodTypeAny, {
|
|
18
|
+
entityType: string;
|
|
19
|
+
timestamp: string;
|
|
20
|
+
result: Record<string, any>;
|
|
21
|
+
}, {
|
|
22
|
+
entityType: string;
|
|
23
|
+
timestamp: string;
|
|
24
|
+
result: Record<string, any>;
|
|
25
|
+
}>;
|
|
26
|
+
type UpdateEntityInput = z.infer<typeof UpdateEntityInputSchema>;
|
|
27
|
+
type UpdateEntityOutput = z.infer<typeof UpdateEntityOutputSchema>;
|
|
28
|
+
export declare function updateEntityLogic(input: UpdateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateEntityOutput>;
|
|
29
|
+
export declare function updateEntityResponseFormatter(result: UpdateEntityOutput): McpTextContent[];
|
|
30
|
+
export declare const updateEntityTool: {
|
|
31
|
+
name: string;
|
|
32
|
+
title: string;
|
|
33
|
+
description: string;
|
|
34
|
+
inputSchema: z.ZodObject<{
|
|
35
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
36
|
+
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
37
|
+
}, "strip", z.ZodTypeAny, {
|
|
38
|
+
entityType: string;
|
|
39
|
+
data: Record<string, unknown>;
|
|
40
|
+
}, {
|
|
41
|
+
entityType: string;
|
|
42
|
+
data: Record<string, unknown>;
|
|
43
|
+
}>;
|
|
44
|
+
outputSchema: z.ZodObject<{
|
|
45
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
46
|
+
entityType: z.ZodString;
|
|
47
|
+
timestamp: z.ZodString;
|
|
48
|
+
}, "strip", z.ZodTypeAny, {
|
|
49
|
+
entityType: string;
|
|
50
|
+
timestamp: string;
|
|
51
|
+
result: Record<string, any>;
|
|
52
|
+
}, {
|
|
53
|
+
entityType: string;
|
|
54
|
+
timestamp: string;
|
|
55
|
+
result: Record<string, any>;
|
|
56
|
+
}>;
|
|
57
|
+
annotations: {
|
|
58
|
+
readOnlyHint: boolean;
|
|
59
|
+
openWorldHint: boolean;
|
|
60
|
+
idempotentHint: boolean;
|
|
61
|
+
destructiveHint: boolean;
|
|
62
|
+
};
|
|
63
|
+
inputExamples: {
|
|
64
|
+
label: string;
|
|
65
|
+
input: {
|
|
66
|
+
entityType: string;
|
|
67
|
+
data: {
|
|
68
|
+
Campaigns: {
|
|
69
|
+
Id: number;
|
|
70
|
+
Name: string;
|
|
71
|
+
}[];
|
|
72
|
+
};
|
|
73
|
+
};
|
|
74
|
+
}[];
|
|
75
|
+
logic: typeof updateEntityLogic;
|
|
76
|
+
responseFormatter: typeof updateEntityResponseFormatter;
|
|
77
|
+
};
|
|
78
|
+
export {};
|
|
79
|
+
//# sourceMappingURL=update-entity.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnF,eAAO,MAAM,uBAAuB;;;;;;;;;EAKyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMF,CAAC;AAEpC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB5B,CAAC"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
+
const TOOL_NAME = "msads_update_entity";
|
|
5
|
+
const TOOL_TITLE = "Update Microsoft Ads Entity";
|
|
6
|
+
const TOOL_DESCRIPTION = `Update an existing Microsoft Advertising entity.
|
|
7
|
+
|
|
8
|
+
Wrap entities in their plural key with the Id field included (e.g., { "Campaigns": [{ "Id": 123, "Name": "Updated" }] }).
|
|
9
|
+
Only include fields you want to change — Microsoft Ads supports partial updates.`;
|
|
10
|
+
export const UpdateEntityInputSchema = z
|
|
11
|
+
.object({
|
|
12
|
+
entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to update"),
|
|
13
|
+
data: z.record(z.unknown()).describe("Entity data payload with Id and fields to update"),
|
|
14
|
+
})
|
|
15
|
+
.describe("Parameters for updating a Microsoft Ads entity");
|
|
16
|
+
export const UpdateEntityOutputSchema = z
|
|
17
|
+
.object({
|
|
18
|
+
result: z.record(z.any()),
|
|
19
|
+
entityType: z.string(),
|
|
20
|
+
timestamp: z.string().datetime(),
|
|
21
|
+
})
|
|
22
|
+
.describe("Entity update result");
|
|
23
|
+
export async function updateEntityLogic(input, context, sdkContext) {
|
|
24
|
+
const { msadsService } = resolveSessionServices(sdkContext);
|
|
25
|
+
const result = (await msadsService.updateEntity(input.entityType, input.data, context));
|
|
26
|
+
return {
|
|
27
|
+
result,
|
|
28
|
+
entityType: input.entityType,
|
|
29
|
+
timestamp: new Date().toISOString(),
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
export function updateEntityResponseFormatter(result) {
|
|
33
|
+
return [
|
|
34
|
+
{
|
|
35
|
+
type: "text",
|
|
36
|
+
text: `Updated ${result.entityType} entity\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
37
|
+
},
|
|
38
|
+
];
|
|
39
|
+
}
|
|
40
|
+
export const updateEntityTool = {
|
|
41
|
+
name: TOOL_NAME,
|
|
42
|
+
title: TOOL_TITLE,
|
|
43
|
+
description: TOOL_DESCRIPTION,
|
|
44
|
+
inputSchema: UpdateEntityInputSchema,
|
|
45
|
+
outputSchema: UpdateEntityOutputSchema,
|
|
46
|
+
annotations: {
|
|
47
|
+
readOnlyHint: false,
|
|
48
|
+
openWorldHint: false,
|
|
49
|
+
idempotentHint: true,
|
|
50
|
+
destructiveHint: false,
|
|
51
|
+
},
|
|
52
|
+
inputExamples: [
|
|
53
|
+
{
|
|
54
|
+
label: "Update campaign name",
|
|
55
|
+
input: {
|
|
56
|
+
entityType: "campaign",
|
|
57
|
+
data: { Campaigns: [{ Id: 123456, Name: "Updated Campaign Name" }] },
|
|
58
|
+
},
|
|
59
|
+
},
|
|
60
|
+
],
|
|
61
|
+
logic: updateEntityLogic,
|
|
62
|
+
responseFormatter: updateEntityResponseFormatter,
|
|
63
|
+
};
|
|
64
|
+
//# sourceMappingURL=update-entity.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAwB,MAAM,4BAA4B,CAAC;AAGrF,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;;iFAGwD,CAAC;AAElF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC;KACD,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAKpC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAC7C,KAAK,CAAC,UAA6B,EACnC,KAAK,CAAC,IAAI,EACV,OAAO,CACR,CAA4B,CAAC;IAE9B,OAAO;QACL,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,WAAW,MAAM,CAAC,UAAU,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACpI;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,sBAAsB;YAC7B,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,EAAE;aACrE;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, SdkContext } from "@cesteral/shared";
|
|
3
|
+
import { validateEntityResponseFormatter } from "@cesteral/shared";
|
|
4
|
+
export declare const ValidateEntityInputSchema: z.ZodObject<{
|
|
5
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
6
|
+
mode: z.ZodEnum<["create", "update"]>;
|
|
7
|
+
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
8
|
+
}, "strip", z.ZodTypeAny, {
|
|
9
|
+
entityType: string;
|
|
10
|
+
data: Record<string, unknown>;
|
|
11
|
+
mode: "update" | "create";
|
|
12
|
+
}, {
|
|
13
|
+
entityType: string;
|
|
14
|
+
data: Record<string, unknown>;
|
|
15
|
+
mode: "update" | "create";
|
|
16
|
+
}>;
|
|
17
|
+
export declare const ValidateEntityOutputSchema: z.ZodObject<{
|
|
18
|
+
valid: z.ZodBoolean;
|
|
19
|
+
entityType: z.ZodString;
|
|
20
|
+
mode: z.ZodString;
|
|
21
|
+
issues: z.ZodArray<z.ZodObject<{
|
|
22
|
+
field: z.ZodString;
|
|
23
|
+
code: z.ZodEnum<["missing", "wrongType", "invalidValue", "readOnly", "custom"]>;
|
|
24
|
+
message: z.ZodString;
|
|
25
|
+
hint: z.ZodOptional<z.ZodString>;
|
|
26
|
+
suggestedValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
27
|
+
severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
|
|
28
|
+
}, "strip", z.ZodTypeAny, {
|
|
29
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
30
|
+
message: string;
|
|
31
|
+
field: string;
|
|
32
|
+
hint?: string | undefined;
|
|
33
|
+
suggestedValues?: string[] | undefined;
|
|
34
|
+
severity?: "warning" | "error" | undefined;
|
|
35
|
+
}, {
|
|
36
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
37
|
+
message: string;
|
|
38
|
+
field: string;
|
|
39
|
+
hint?: string | undefined;
|
|
40
|
+
suggestedValues?: string[] | undefined;
|
|
41
|
+
severity?: "warning" | "error" | undefined;
|
|
42
|
+
}>, "many">;
|
|
43
|
+
nextAction: z.ZodOptional<z.ZodString>;
|
|
44
|
+
timestamp: z.ZodString;
|
|
45
|
+
}, "strip", z.ZodTypeAny, {
|
|
46
|
+
issues: {
|
|
47
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
48
|
+
message: string;
|
|
49
|
+
field: string;
|
|
50
|
+
hint?: string | undefined;
|
|
51
|
+
suggestedValues?: string[] | undefined;
|
|
52
|
+
severity?: "warning" | "error" | undefined;
|
|
53
|
+
}[];
|
|
54
|
+
valid: boolean;
|
|
55
|
+
entityType: string;
|
|
56
|
+
timestamp: string;
|
|
57
|
+
mode: string;
|
|
58
|
+
nextAction?: string | undefined;
|
|
59
|
+
}, {
|
|
60
|
+
issues: {
|
|
61
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
62
|
+
message: string;
|
|
63
|
+
field: string;
|
|
64
|
+
hint?: string | undefined;
|
|
65
|
+
suggestedValues?: string[] | undefined;
|
|
66
|
+
severity?: "warning" | "error" | undefined;
|
|
67
|
+
}[];
|
|
68
|
+
valid: boolean;
|
|
69
|
+
entityType: string;
|
|
70
|
+
timestamp: string;
|
|
71
|
+
mode: string;
|
|
72
|
+
nextAction?: string | undefined;
|
|
73
|
+
}>;
|
|
74
|
+
type ValidateEntityInput = z.infer<typeof ValidateEntityInputSchema>;
|
|
75
|
+
type ValidateEntityOutput = z.infer<typeof ValidateEntityOutputSchema>;
|
|
76
|
+
export declare function validateEntityLogic(input: ValidateEntityInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<ValidateEntityOutput>;
|
|
77
|
+
export declare const validateEntityTool: {
|
|
78
|
+
name: string;
|
|
79
|
+
title: string;
|
|
80
|
+
description: string;
|
|
81
|
+
inputSchema: z.ZodObject<{
|
|
82
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
83
|
+
mode: z.ZodEnum<["create", "update"]>;
|
|
84
|
+
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
85
|
+
}, "strip", z.ZodTypeAny, {
|
|
86
|
+
entityType: string;
|
|
87
|
+
data: Record<string, unknown>;
|
|
88
|
+
mode: "update" | "create";
|
|
89
|
+
}, {
|
|
90
|
+
entityType: string;
|
|
91
|
+
data: Record<string, unknown>;
|
|
92
|
+
mode: "update" | "create";
|
|
93
|
+
}>;
|
|
94
|
+
outputSchema: z.ZodObject<{
|
|
95
|
+
valid: z.ZodBoolean;
|
|
96
|
+
entityType: z.ZodString;
|
|
97
|
+
mode: z.ZodString;
|
|
98
|
+
issues: z.ZodArray<z.ZodObject<{
|
|
99
|
+
field: z.ZodString;
|
|
100
|
+
code: z.ZodEnum<["missing", "wrongType", "invalidValue", "readOnly", "custom"]>;
|
|
101
|
+
message: z.ZodString;
|
|
102
|
+
hint: z.ZodOptional<z.ZodString>;
|
|
103
|
+
suggestedValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
104
|
+
severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
|
|
105
|
+
}, "strip", z.ZodTypeAny, {
|
|
106
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
107
|
+
message: string;
|
|
108
|
+
field: string;
|
|
109
|
+
hint?: string | undefined;
|
|
110
|
+
suggestedValues?: string[] | undefined;
|
|
111
|
+
severity?: "warning" | "error" | undefined;
|
|
112
|
+
}, {
|
|
113
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
114
|
+
message: string;
|
|
115
|
+
field: string;
|
|
116
|
+
hint?: string | undefined;
|
|
117
|
+
suggestedValues?: string[] | undefined;
|
|
118
|
+
severity?: "warning" | "error" | undefined;
|
|
119
|
+
}>, "many">;
|
|
120
|
+
nextAction: z.ZodOptional<z.ZodString>;
|
|
121
|
+
timestamp: z.ZodString;
|
|
122
|
+
}, "strip", z.ZodTypeAny, {
|
|
123
|
+
issues: {
|
|
124
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
125
|
+
message: string;
|
|
126
|
+
field: string;
|
|
127
|
+
hint?: string | undefined;
|
|
128
|
+
suggestedValues?: string[] | undefined;
|
|
129
|
+
severity?: "warning" | "error" | undefined;
|
|
130
|
+
}[];
|
|
131
|
+
valid: boolean;
|
|
132
|
+
entityType: string;
|
|
133
|
+
timestamp: string;
|
|
134
|
+
mode: string;
|
|
135
|
+
nextAction?: string | undefined;
|
|
136
|
+
}, {
|
|
137
|
+
issues: {
|
|
138
|
+
code: "custom" | "missing" | "wrongType" | "invalidValue" | "readOnly";
|
|
139
|
+
message: string;
|
|
140
|
+
field: string;
|
|
141
|
+
hint?: string | undefined;
|
|
142
|
+
suggestedValues?: string[] | undefined;
|
|
143
|
+
severity?: "warning" | "error" | undefined;
|
|
144
|
+
}[];
|
|
145
|
+
valid: boolean;
|
|
146
|
+
entityType: string;
|
|
147
|
+
timestamp: string;
|
|
148
|
+
mode: string;
|
|
149
|
+
nextAction?: string | undefined;
|
|
150
|
+
}>;
|
|
151
|
+
annotations: {
|
|
152
|
+
readOnlyHint: boolean;
|
|
153
|
+
openWorldHint: boolean;
|
|
154
|
+
idempotentHint: boolean;
|
|
155
|
+
destructiveHint: boolean;
|
|
156
|
+
};
|
|
157
|
+
inputExamples: {
|
|
158
|
+
label: string;
|
|
159
|
+
input: {
|
|
160
|
+
entityType: string;
|
|
161
|
+
mode: string;
|
|
162
|
+
data: {
|
|
163
|
+
Campaigns: {
|
|
164
|
+
Name: string;
|
|
165
|
+
BudgetType: string;
|
|
166
|
+
}[];
|
|
167
|
+
};
|
|
168
|
+
};
|
|
169
|
+
}[];
|
|
170
|
+
logic: typeof validateEntityLogic;
|
|
171
|
+
responseFormatter: typeof validateEntityResponseFormatter;
|
|
172
|
+
};
|
|
173
|
+
export {};
|
|
174
|
+
//# sourceMappingURL=validate-entity.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validate-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/validate-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EACL,+BAA+B,EAGhC,MAAM,kBAAkB,CAAC;AAW1B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAQyB,CAAC;AAWhE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASP,CAAC;AAEjC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAoF/B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B9B,CAAC"}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { getEntityTypeEnum, getEntityConfig, } from "../utils/entity-mapping.js";
|
|
3
|
+
import { validateEntityResponseFormatter, validateEnumFieldsStructured, } from "@cesteral/shared";
|
|
4
|
+
import { MSADS_ENUMS_BY_ENTITY } from "../../resources/utils/field-rules.js";
|
|
5
|
+
const TOOL_NAME = "msads_validate_entity";
|
|
6
|
+
const TOOL_TITLE = "Validate Microsoft Ads Entity";
|
|
7
|
+
const TOOL_DESCRIPTION = `Dry-run validate a Microsoft Advertising entity payload without making any API calls.
|
|
8
|
+
|
|
9
|
+
Checks that the entity type is valid and required fields are present. Does NOT call the Microsoft Ads API.
|
|
10
|
+
|
|
11
|
+
Per-entity enum field rules are also exposed as MCP resources. Valid values: see resource \`msads-field-rules://{entityType}\`.`;
|
|
12
|
+
export const ValidateEntityInputSchema = z
|
|
13
|
+
.object({
|
|
14
|
+
entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to validate"),
|
|
15
|
+
mode: z
|
|
16
|
+
.enum(["create", "update"])
|
|
17
|
+
.describe("Validation mode — create requires more fields than update"),
|
|
18
|
+
data: z.record(z.unknown()).describe("Entity data payload to validate"),
|
|
19
|
+
})
|
|
20
|
+
.describe("Parameters for validating a Microsoft Ads entity");
|
|
21
|
+
const ValidationIssueSchema = z.object({
|
|
22
|
+
field: z.string(),
|
|
23
|
+
code: z.enum(["missing", "wrongType", "invalidValue", "readOnly", "custom"]),
|
|
24
|
+
message: z.string(),
|
|
25
|
+
hint: z.string().optional(),
|
|
26
|
+
suggestedValues: z.array(z.string()).optional(),
|
|
27
|
+
severity: z.enum(["error", "warning"]).optional(),
|
|
28
|
+
});
|
|
29
|
+
export const ValidateEntityOutputSchema = z
|
|
30
|
+
.object({
|
|
31
|
+
valid: z.boolean(),
|
|
32
|
+
entityType: z.string(),
|
|
33
|
+
mode: z.string(),
|
|
34
|
+
issues: z.array(ValidationIssueSchema),
|
|
35
|
+
nextAction: z.string().optional(),
|
|
36
|
+
timestamp: z.string().datetime(),
|
|
37
|
+
})
|
|
38
|
+
.describe("Validation result");
|
|
39
|
+
export async function validateEntityLogic(input, _context, _sdkContext) {
|
|
40
|
+
const issues = [];
|
|
41
|
+
try {
|
|
42
|
+
getEntityConfig(input.entityType);
|
|
43
|
+
}
|
|
44
|
+
catch {
|
|
45
|
+
issues.push({
|
|
46
|
+
field: "entityType",
|
|
47
|
+
code: "invalidValue",
|
|
48
|
+
message: `Unknown entity type: ${input.entityType}`,
|
|
49
|
+
severity: "error",
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
if (!input.data || Object.keys(input.data).length === 0) {
|
|
53
|
+
issues.push({
|
|
54
|
+
field: "data",
|
|
55
|
+
code: "missing",
|
|
56
|
+
message: "Data payload is empty",
|
|
57
|
+
severity: "error",
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
if (input.mode === "update") {
|
|
61
|
+
const config = getEntityConfig(input.entityType);
|
|
62
|
+
const entities = input.data[config.pluralName];
|
|
63
|
+
if (entities && Array.isArray(entities)) {
|
|
64
|
+
for (let i = 0; i < entities.length; i++) {
|
|
65
|
+
if (!entities[i][config.idField]) {
|
|
66
|
+
issues.push({
|
|
67
|
+
field: `${config.pluralName}[${i}].${config.idField}`,
|
|
68
|
+
code: "missing",
|
|
69
|
+
message: `Item ${i}: missing required field '${config.idField}' for update`,
|
|
70
|
+
severity: "error",
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
else {
|
|
76
|
+
issues.push({
|
|
77
|
+
field: config.pluralName,
|
|
78
|
+
code: "wrongType",
|
|
79
|
+
message: `Expected data to contain '${config.pluralName}' array`,
|
|
80
|
+
severity: "warning",
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
const enumRules = MSADS_ENUMS_BY_ENTITY[input.entityType] ?? [];
|
|
85
|
+
if (enumRules.length > 0) {
|
|
86
|
+
try {
|
|
87
|
+
const config = getEntityConfig(input.entityType);
|
|
88
|
+
const entities = input.data[config.pluralName];
|
|
89
|
+
if (Array.isArray(entities)) {
|
|
90
|
+
entities.forEach((entity, i) => {
|
|
91
|
+
for (const issue of validateEnumFieldsStructured(entity, enumRules)) {
|
|
92
|
+
issues.push({
|
|
93
|
+
...issue,
|
|
94
|
+
field: `${config.pluralName}[${i}].${issue.field}`,
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
else {
|
|
100
|
+
issues.push(...validateEnumFieldsStructured(input.data, enumRules));
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
catch {
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
const errorIssues = issues.filter((i) => i.severity !== "warning");
|
|
107
|
+
return {
|
|
108
|
+
valid: errorIssues.length === 0,
|
|
109
|
+
entityType: input.entityType,
|
|
110
|
+
mode: input.mode,
|
|
111
|
+
issues,
|
|
112
|
+
timestamp: new Date().toISOString(),
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
export const validateEntityTool = {
|
|
116
|
+
name: TOOL_NAME,
|
|
117
|
+
title: TOOL_TITLE,
|
|
118
|
+
description: TOOL_DESCRIPTION,
|
|
119
|
+
inputSchema: ValidateEntityInputSchema,
|
|
120
|
+
outputSchema: ValidateEntityOutputSchema,
|
|
121
|
+
annotations: {
|
|
122
|
+
readOnlyHint: true,
|
|
123
|
+
openWorldHint: false,
|
|
124
|
+
idempotentHint: true,
|
|
125
|
+
destructiveHint: false,
|
|
126
|
+
},
|
|
127
|
+
inputExamples: [
|
|
128
|
+
{
|
|
129
|
+
label: "Validate a campaign for creation",
|
|
130
|
+
input: {
|
|
131
|
+
entityType: "campaign",
|
|
132
|
+
mode: "create",
|
|
133
|
+
data: {
|
|
134
|
+
Campaigns: [{ Name: "Test", BudgetType: "DailyBudgetStandard" }],
|
|
135
|
+
},
|
|
136
|
+
},
|
|
137
|
+
},
|
|
138
|
+
],
|
|
139
|
+
logic: validateEntityLogic,
|
|
140
|
+
responseFormatter: validateEntityResponseFormatter,
|
|
141
|
+
};
|
|
142
|
+
//# sourceMappingURL=validate-entity.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validate-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/validate-entity.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export type MsAdsEntityType = "campaign" | "adGroup" | "ad" | "keyword" | "budget" | "adExtension" | "audience" | "label";
|
|
2
|
+
export interface MsAdsEntityConfig {
|
|
3
|
+
addOperation: string;
|
|
4
|
+
getByAccountOperation?: string;
|
|
5
|
+
getByParentOperation?: string;
|
|
6
|
+
getByIdsOperation: string;
|
|
7
|
+
updateOperation: string;
|
|
8
|
+
deleteOperation: string;
|
|
9
|
+
idField: string;
|
|
10
|
+
parentIdField?: string;
|
|
11
|
+
pluralName: string;
|
|
12
|
+
displayName: string;
|
|
13
|
+
idsField: string;
|
|
14
|
+
batchLimit: number;
|
|
15
|
+
requiredGetByIdsFields?: string[];
|
|
16
|
+
}
|
|
17
|
+
export declare function getEntityConfig(entityType: MsAdsEntityType): MsAdsEntityConfig;
|
|
18
|
+
export declare function getSupportedEntityTypes(): MsAdsEntityType[];
|
|
19
|
+
export declare function getEntityTypeEnum(): [string, ...string[]];
|
|
20
|
+
//# sourceMappingURL=entity-mapping.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,SAAS,GACT,IAAI,GACJ,SAAS,GACT,QAAQ,GACR,aAAa,GACb,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAEhC,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,eAAe,EAAE,MAAM,CAAC;IAExB,eAAe,EAAE,MAAM,CAAC;IAExB,OAAO,EAAE,MAAM,CAAC;IAEhB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAyGD,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,iBAAiB,CAS9E;AAED,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGzD"}
|