@cesteral/msads-mcp 1.2.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -30
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
- package/dist/auth/msads-auth-adapter.js +1 -1
- package/dist/auth/msads-auth-adapter.js.map +1 -1
- package/dist/cesteral-manifest.json +140 -4
- package/dist/config/index.d.ts +36 -67
- package/dist/config/index.d.ts.map +1 -1
- package/dist/index.js +13 -23
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.d.ts +1 -1
- package/dist/mcp-server/prompts/index.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.js +15 -0
- package/dist/mcp-server/prompts/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/index.js +10 -9
- package/dist/mcp-server/resources/definitions/index.js.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.js +11 -11
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
- package/dist/mcp-server/server.d.ts +2 -1
- package/dist/mcp-server/server.d.ts.map +1 -1
- package/dist/mcp-server/server.js +29 -99
- package/dist/mcp-server/server.js.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +46 -111
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +158 -15
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +51 -44
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +125 -9
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +51 -51
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +132 -7
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +65 -97
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +128 -7
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +47 -35
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +99 -3
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +51 -100
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +113 -33
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +47 -53
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +129 -8
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +34 -40
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +79 -25
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +49 -38
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +101 -10
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/index.js +6 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +46 -37
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +106 -6
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +58 -47
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +111 -8
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +57 -89
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +97 -2
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +39 -1907
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +74 -85
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/index.d.ts +4 -1
- package/dist/mcp-server/tools/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/index.js +7 -1
- package/dist/mcp-server/tools/index.js.map +1 -1
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.d.ts +17 -2
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.js +71 -6
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
- package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
- package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
- package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
- package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.js +16 -51
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
- package/dist/services/msads/msads-http-client.d.ts +5 -1
- package/dist/services/msads/msads-http-client.d.ts.map +1 -1
- package/dist/services/msads/msads-http-client.js +49 -2
- package/dist/services/msads/msads-http-client.js.map +1 -1
- package/dist/services/msads/msads-reporting-service.d.ts +3 -9
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
- package/dist/services/msads/msads-reporting-service.js +62 -27
- package/dist/services/msads/msads-reporting-service.js.map +1 -1
- package/dist/services/msads/msads-service.d.ts +53 -5
- package/dist/services/msads/msads-service.d.ts.map +1 -1
- package/dist/services/msads/msads-service.js +235 -35
- package/dist/services/msads/msads-service.js.map +1 -1
- package/dist/services/msads/partial-errors.d.ts +34 -0
- package/dist/services/msads/partial-errors.d.ts.map +1 -0
- package/dist/services/msads/partial-errors.js +149 -0
- package/dist/services/msads/partial-errors.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +8 -2
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
- package/dist/services/msads/rate-limit-keys.js +16 -2
- package/dist/services/msads/rate-limit-keys.js.map +1 -1
- package/dist/services/msads/types.d.ts +1 -2
- package/dist/services/msads/types.d.ts.map +1 -1
- package/dist/services/msads/types.js.map +1 -1
- package/dist/services/session-services.d.ts +2 -2
- package/dist/services/session-services.d.ts.map +1 -1
- package/dist/services/session-services.js +10 -10
- package/dist/services/session-services.js.map +1 -1
- package/dist/services/session-wiring.d.ts +7 -0
- package/dist/services/session-wiring.d.ts.map +1 -0
- package/dist/services/session-wiring.js +20 -0
- package/dist/services/session-wiring.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts +4 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -1
- package/dist/testkit/fixtures/index.js +105 -3
- package/dist/testkit/fixtures/index.js.map +1 -1
- package/dist/testkit/types.d.ts +2 -2
- package/dist/testkit/types.d.ts.map +1 -1
- package/package.json +8 -8
|
@@ -1,28 +1,20 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext, NormalizedEntitySnapshot } from "@cesteral/shared";
|
|
3
3
|
export declare const CreateEntityInputSchema: z.ZodObject<{
|
|
4
|
-
entityType: z.ZodEnum<
|
|
4
|
+
entityType: z.ZodEnum<{
|
|
5
|
+
[x: string]: string;
|
|
6
|
+
}>;
|
|
5
7
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
data: Record<string, unknown>;
|
|
9
|
-
}, {
|
|
10
|
-
entityType: string;
|
|
11
|
-
data: Record<string, unknown>;
|
|
12
|
-
}>;
|
|
8
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
9
|
+
}, z.core.$strip>;
|
|
13
10
|
export declare const CreateEntityOutputSchema: z.ZodObject<{
|
|
14
11
|
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
15
12
|
entityType: z.ZodString;
|
|
16
13
|
timestamp: z.ZodString;
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
}, {
|
|
22
|
-
entityType: string;
|
|
23
|
-
timestamp: string;
|
|
24
|
-
result: Record<string, any>;
|
|
25
|
-
}>;
|
|
14
|
+
dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DryRunResult, unknown>>>;
|
|
15
|
+
after: z.ZodOptional<z.ZodType<NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<NormalizedEntitySnapshot, unknown>>>;
|
|
16
|
+
dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DispatchedCapability, unknown>>;
|
|
17
|
+
}, z.core.$strip>;
|
|
26
18
|
type CreateEntityInput = z.infer<typeof CreateEntityInputSchema>;
|
|
27
19
|
type CreateEntityOutput = z.infer<typeof CreateEntityOutputSchema>;
|
|
28
20
|
export declare function createEntityLogic(input: CreateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateEntityOutput>;
|
|
@@ -32,39 +24,55 @@ export declare const createEntityTool: {
|
|
|
32
24
|
title: string;
|
|
33
25
|
description: string;
|
|
34
26
|
inputSchema: z.ZodObject<{
|
|
35
|
-
entityType: z.ZodEnum<
|
|
27
|
+
entityType: z.ZodEnum<{
|
|
28
|
+
[x: string]: string;
|
|
29
|
+
}>;
|
|
36
30
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
data: Record<string, unknown>;
|
|
40
|
-
}, {
|
|
41
|
-
entityType: string;
|
|
42
|
-
data: Record<string, unknown>;
|
|
43
|
-
}>;
|
|
31
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
32
|
+
}, z.core.$strip>;
|
|
44
33
|
outputSchema: z.ZodObject<{
|
|
45
34
|
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
46
35
|
entityType: z.ZodString;
|
|
47
36
|
timestamp: z.ZodString;
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
}, {
|
|
53
|
-
entityType: string;
|
|
54
|
-
timestamp: string;
|
|
55
|
-
result: Record<string, any>;
|
|
56
|
-
}>;
|
|
37
|
+
dryRun: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").DryRunResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DryRunResult, unknown>>>;
|
|
38
|
+
after: z.ZodOptional<z.ZodType<NormalizedEntitySnapshot, unknown, z.core.$ZodTypeInternals<NormalizedEntitySnapshot, unknown>>>;
|
|
39
|
+
dispatchedCapability: z.ZodType<import("@cesteral/contract-schema").DispatchedCapability, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").DispatchedCapability, unknown>>;
|
|
40
|
+
}, z.core.$strip>;
|
|
57
41
|
annotations: {
|
|
58
42
|
readOnlyHint: boolean;
|
|
59
43
|
openWorldHint: boolean;
|
|
60
44
|
idempotentHint: boolean;
|
|
61
45
|
destructiveHint: boolean;
|
|
46
|
+
cesteral: {
|
|
47
|
+
kind: "write";
|
|
48
|
+
writeClass: "entity";
|
|
49
|
+
executableArgsExclude: string[];
|
|
50
|
+
platform: string;
|
|
51
|
+
contractPlatformSlug: string;
|
|
52
|
+
contractToolSlug: string;
|
|
53
|
+
operation: "create"[];
|
|
54
|
+
entityKinds: ("campaign" | "ad" | "ad_group" | "campaign_budget")[];
|
|
55
|
+
entityIdArgs: never[];
|
|
56
|
+
readPartner: {
|
|
57
|
+
toolName: string;
|
|
58
|
+
argMap: {
|
|
59
|
+
entityType: string;
|
|
60
|
+
};
|
|
61
|
+
};
|
|
62
|
+
schemaVersion: number;
|
|
63
|
+
contractId: string;
|
|
64
|
+
supportsDryRun: true;
|
|
65
|
+
supportsBeforeAfterSnapshot: true;
|
|
66
|
+
requiresValidation: true;
|
|
67
|
+
requiresSimulation: true;
|
|
68
|
+
};
|
|
62
69
|
};
|
|
63
70
|
inputExamples: {
|
|
64
71
|
label: string;
|
|
65
72
|
input: {
|
|
66
73
|
entityType: string;
|
|
67
74
|
data: {
|
|
75
|
+
AccountId: number;
|
|
68
76
|
Campaigns: {
|
|
69
77
|
Name: string;
|
|
70
78
|
BudgetType: string;
|
|
@@ -76,6 +84,10 @@ export declare const createEntityTool: {
|
|
|
76
84
|
}[];
|
|
77
85
|
logic: typeof createEntityLogic;
|
|
78
86
|
responseFormatter: typeof createEntityResponseFormatter;
|
|
87
|
+
untrustedContent: {
|
|
88
|
+
structuredPaths: string[];
|
|
89
|
+
contentBlocks: number[];
|
|
90
|
+
};
|
|
79
91
|
};
|
|
80
92
|
export {};
|
|
81
93
|
//# sourceMappingURL=create-entity.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,wBAAwB,EAEzB,MAAM,kBAAkB,CAAC;AAwC1B,eAAO,MAAM,uBAAuB;;;;;;iBAcyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;iBAeA,CAAC;AAEtC,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,CA6D7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAoB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqE5B,CAAC"}
|
|
@@ -1,36 +1,106 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
-
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
3
|
+
import { getEntityConfig, getEntityTypeEnum, } from "../utils/entity-mapping.js";
|
|
4
|
+
import { runMsAdsCreateDryRun, resolveMsAdsCreateCapability, symbolicValidate, } from "../utils/dry-run.js";
|
|
5
|
+
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
6
|
+
import { resolveMsAdsCurrency, snapshotFromMsAdsEntity } from "../utils/capture-snapshot.js";
|
|
7
|
+
import { DryRunResultSchema, NormalizedEntitySnapshotSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
|
|
4
8
|
const TOOL_NAME = "msads_create_entity";
|
|
5
9
|
const TOOL_TITLE = "Create Microsoft Ads Entity";
|
|
6
10
|
const TOOL_DESCRIPTION = `Create a new Microsoft Advertising entity.
|
|
7
11
|
|
|
12
|
+
**Supported entity types:** ${getEntityTypeEnum().join(", ")}
|
|
13
|
+
|
|
8
14
|
The data object should follow Microsoft Ads API v13 format. Wrap entities in their plural key (e.g., { "Campaigns": [{ "Name": "..." }] }).
|
|
9
15
|
|
|
10
16
|
Use the entity-schema and entity-examples MCP resources to discover required fields.`;
|
|
17
|
+
function unwrapEntityItem(entityType, data) {
|
|
18
|
+
const config = getEntityConfig(entityType);
|
|
19
|
+
const collection = data[config.pluralName];
|
|
20
|
+
if (Array.isArray(collection) && collection.length > 0 && typeof collection[0] === "object") {
|
|
21
|
+
return (collection[0] ?? {});
|
|
22
|
+
}
|
|
23
|
+
return {};
|
|
24
|
+
}
|
|
25
|
+
function extractCreatedId(result) {
|
|
26
|
+
for (const [key, value] of Object.entries(result)) {
|
|
27
|
+
if (key.endsWith("Ids") && Array.isArray(value)) {
|
|
28
|
+
const first = value.find((v) => v != null);
|
|
29
|
+
if (first != null)
|
|
30
|
+
return String(first);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
return "";
|
|
34
|
+
}
|
|
11
35
|
export const CreateEntityInputSchema = z
|
|
12
36
|
.object({
|
|
13
37
|
entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
|
|
14
|
-
data: z
|
|
38
|
+
data: z
|
|
39
|
+
.record(z.string(), z.unknown())
|
|
40
|
+
.describe("Entity data payload following Microsoft Ads API format"),
|
|
41
|
+
dry_run: z
|
|
42
|
+
.boolean()
|
|
43
|
+
.optional()
|
|
44
|
+
.default(false)
|
|
45
|
+
.describe("When true, validates the creation and returns a DryRunResult under `dryRun` (expected post-state = the would-be-created entity) without calling the Microsoft Ads API. No entity is created."),
|
|
15
46
|
})
|
|
16
47
|
.describe("Parameters for creating a Microsoft Ads entity");
|
|
17
48
|
export const CreateEntityOutputSchema = z
|
|
18
49
|
.object({
|
|
19
|
-
result: z.record(z.any()).describe("API response with created entity IDs"),
|
|
50
|
+
result: z.record(z.string(), z.any()).describe("API response with created entity IDs"),
|
|
20
51
|
entityType: z.string(),
|
|
21
52
|
timestamp: z.string().datetime(),
|
|
53
|
+
dryRun: DryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No entity was created."),
|
|
54
|
+
after: NormalizedEntitySnapshotSchema.optional().describe("Post-create canonical snapshot, normalized from the submitted entity payload (in-scope kinds: campaign, ad_group, ad, campaign_budget). Create has no `before`."),
|
|
55
|
+
dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to. Present on every response."),
|
|
22
56
|
})
|
|
23
57
|
.describe("Entity creation result");
|
|
24
58
|
export async function createEntityLogic(input, context, sdkContext) {
|
|
25
59
|
const { msadsService } = resolveSessionServices(sdkContext);
|
|
60
|
+
const dispatchedCapability = resolveMsAdsCreateCapability(input.entityType);
|
|
61
|
+
const entityItem = unwrapEntityItem(input.entityType, input.data);
|
|
62
|
+
if (input.dry_run === true) {
|
|
63
|
+
const dryRun = await runMsAdsCreateDryRun({ entityType: input.entityType, data: entityItem }, msadsService, context);
|
|
64
|
+
return {
|
|
65
|
+
result: {},
|
|
66
|
+
entityType: input.entityType,
|
|
67
|
+
timestamp: new Date().toISOString(),
|
|
68
|
+
dryRun,
|
|
69
|
+
dispatchedCapability,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
if (Object.keys(entityItem).length === 0) {
|
|
73
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, "`data` must contain at least one field to create a Microsoft Ads entity.");
|
|
74
|
+
}
|
|
75
|
+
const createValidationErrors = symbolicValidate(entityItem);
|
|
76
|
+
if (createValidationErrors.length > 0) {
|
|
77
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid create payload: ${createValidationErrors.map((e) => e.message).join("; ")}`);
|
|
78
|
+
}
|
|
26
79
|
const result = (await msadsService.createEntity(input.entityType, input.data, context));
|
|
80
|
+
const createdId = extractCreatedId(result);
|
|
81
|
+
const after = snapshotFromMsAdsEntity(input.entityType, createdId, entityItem, await resolveMsAdsCurrency(msadsService, context));
|
|
27
82
|
return {
|
|
28
83
|
result,
|
|
29
84
|
entityType: input.entityType,
|
|
30
85
|
timestamp: new Date().toISOString(),
|
|
86
|
+
...(after ? { after } : {}),
|
|
87
|
+
dispatchedCapability,
|
|
31
88
|
};
|
|
32
89
|
}
|
|
33
90
|
export function createEntityResponseFormatter(result) {
|
|
91
|
+
if (result.dryRun) {
|
|
92
|
+
const { wouldSucceed, validationErrors, validationSource, expectedStateSource } = result.dryRun;
|
|
93
|
+
const verdict = wouldSucceed ? "would succeed" : "would FAIL";
|
|
94
|
+
const errorLines = validationErrors.length
|
|
95
|
+
? "\n" + validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n")
|
|
96
|
+
: "";
|
|
97
|
+
return [
|
|
98
|
+
{
|
|
99
|
+
type: "text",
|
|
100
|
+
text: `Dry run: creating ${result.entityType} ${verdict} (validation: ${validationSource}, expected-state: ${expectedStateSource}). No entity was created.${errorLines}\n\nTimestamp: ${result.timestamp}`,
|
|
101
|
+
},
|
|
102
|
+
];
|
|
103
|
+
}
|
|
34
104
|
return [
|
|
35
105
|
{
|
|
36
106
|
type: "text",
|
|
@@ -49,6 +119,27 @@ export const createEntityTool = {
|
|
|
49
119
|
openWorldHint: false,
|
|
50
120
|
idempotentHint: false,
|
|
51
121
|
destructiveHint: false,
|
|
122
|
+
cesteral: {
|
|
123
|
+
kind: "write",
|
|
124
|
+
writeClass: "entity",
|
|
125
|
+
executableArgsExclude: ["dry_run"],
|
|
126
|
+
platform: "msads",
|
|
127
|
+
contractPlatformSlug: "msads",
|
|
128
|
+
contractToolSlug: "create_entity",
|
|
129
|
+
operation: ["create"],
|
|
130
|
+
entityKinds: ["campaign", "ad_group", "ad", "campaign_budget"],
|
|
131
|
+
entityIdArgs: [],
|
|
132
|
+
readPartner: {
|
|
133
|
+
toolName: "msads_get_entity",
|
|
134
|
+
argMap: { entityType: "entityType" },
|
|
135
|
+
},
|
|
136
|
+
schemaVersion: 1,
|
|
137
|
+
contractId: "msads.create_entity.v1",
|
|
138
|
+
supportsDryRun: true,
|
|
139
|
+
supportsBeforeAfterSnapshot: true,
|
|
140
|
+
requiresValidation: true,
|
|
141
|
+
requiresSimulation: true,
|
|
142
|
+
},
|
|
52
143
|
},
|
|
53
144
|
inputExamples: [
|
|
54
145
|
{
|
|
@@ -56,6 +147,7 @@ export const createEntityTool = {
|
|
|
56
147
|
input: {
|
|
57
148
|
entityType: "campaign",
|
|
58
149
|
data: {
|
|
150
|
+
AccountId: 123456789,
|
|
59
151
|
Campaigns: [
|
|
60
152
|
{
|
|
61
153
|
Name: "My Campaign",
|
|
@@ -70,5 +162,9 @@ export const createEntityTool = {
|
|
|
70
162
|
],
|
|
71
163
|
logic: createEntityLogic,
|
|
72
164
|
responseFormatter: createEntityResponseFormatter,
|
|
165
|
+
untrustedContent: {
|
|
166
|
+
structuredPaths: ["$.result", "$.after"],
|
|
167
|
+
contentBlocks: [0],
|
|
168
|
+
},
|
|
73
169
|
};
|
|
74
170
|
//# sourceMappingURL=create-entity.tool.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,
|
|
1
|
+
{"version":3,"file":"create-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,69 +1,36 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
|
|
3
|
+
export declare const MSADS_NO_REPORT_SCHEDULES_MESSAGE = "Microsoft Advertising Reporting API v13 has no report schedules \u2014 it exposes only GenerateReport/Submit and GenerateReport/Poll, and ReportRequest has no Schedule element. Nothing was scheduled. Run a one-off report with msads_submit_report / msads_get_report instead.";
|
|
3
4
|
export declare const CreateReportScheduleInputSchema: z.ZodObject<{
|
|
4
5
|
accountId: z.ZodString;
|
|
5
6
|
scheduleName: z.ZodString;
|
|
6
7
|
reportType: z.ZodString;
|
|
7
|
-
columns: z.ZodArray<z.ZodString
|
|
8
|
+
columns: z.ZodArray<z.ZodString>;
|
|
8
9
|
startDate: z.ZodString;
|
|
9
10
|
endDate: z.ZodString;
|
|
10
11
|
aggregation: z.ZodOptional<z.ZodString>;
|
|
11
12
|
schedule: z.ZodObject<{
|
|
12
13
|
StartDate: z.ZodString;
|
|
13
14
|
EndDate: z.ZodOptional<z.ZodString>;
|
|
14
|
-
Frequency: z.ZodEnum<
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
},
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
EndDate?: string | undefined;
|
|
23
|
-
}>;
|
|
24
|
-
}, "strip", z.ZodTypeAny, {
|
|
25
|
-
accountId: string;
|
|
26
|
-
reportType: string;
|
|
27
|
-
scheduleName: string;
|
|
28
|
-
columns: string[];
|
|
29
|
-
startDate: string;
|
|
30
|
-
endDate: string;
|
|
31
|
-
schedule: {
|
|
32
|
-
StartDate: string;
|
|
33
|
-
Frequency: "Daily" | "Weekly" | "Monthly";
|
|
34
|
-
EndDate?: string | undefined;
|
|
35
|
-
};
|
|
36
|
-
aggregation?: string | undefined;
|
|
37
|
-
}, {
|
|
38
|
-
accountId: string;
|
|
39
|
-
reportType: string;
|
|
40
|
-
scheduleName: string;
|
|
41
|
-
columns: string[];
|
|
42
|
-
startDate: string;
|
|
43
|
-
endDate: string;
|
|
44
|
-
schedule: {
|
|
45
|
-
StartDate: string;
|
|
46
|
-
Frequency: "Daily" | "Weekly" | "Monthly";
|
|
47
|
-
EndDate?: string | undefined;
|
|
48
|
-
};
|
|
49
|
-
aggregation?: string | undefined;
|
|
50
|
-
}>;
|
|
15
|
+
Frequency: z.ZodEnum<{
|
|
16
|
+
Daily: "Daily";
|
|
17
|
+
Weekly: "Weekly";
|
|
18
|
+
Monthly: "Monthly";
|
|
19
|
+
}>;
|
|
20
|
+
}, z.core.$strip>;
|
|
21
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
22
|
+
}, z.core.$strip>;
|
|
51
23
|
export declare const CreateReportScheduleOutputSchema: z.ZodObject<{
|
|
52
|
-
scheduleId: z.ZodString
|
|
53
|
-
scheduleName: z.ZodString
|
|
24
|
+
scheduleId: z.ZodOptional<z.ZodString>;
|
|
25
|
+
scheduleName: z.ZodOptional<z.ZodString>;
|
|
54
26
|
timestamp: z.ZodString;
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
}, {
|
|
60
|
-
scheduleName: string;
|
|
61
|
-
scheduleId: string;
|
|
62
|
-
timestamp: string;
|
|
63
|
-
}>;
|
|
27
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
|
|
28
|
+
effect: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").EffectResult, unknown>>>;
|
|
29
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
|
|
30
|
+
}, z.core.$strip>;
|
|
64
31
|
type CreateReportScheduleInput = z.infer<typeof CreateReportScheduleInputSchema>;
|
|
65
32
|
type CreateReportScheduleOutput = z.infer<typeof CreateReportScheduleOutputSchema>;
|
|
66
|
-
export declare function createReportScheduleLogic(input: CreateReportScheduleInput,
|
|
33
|
+
export declare function createReportScheduleLogic(input: CreateReportScheduleInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<CreateReportScheduleOutput>;
|
|
67
34
|
export declare function createReportScheduleResponseFormatter(result: CreateReportScheduleOutput): McpTextContent[];
|
|
68
35
|
export declare const createReportScheduleTool: {
|
|
69
36
|
name: string;
|
|
@@ -73,68 +40,51 @@ export declare const createReportScheduleTool: {
|
|
|
73
40
|
accountId: z.ZodString;
|
|
74
41
|
scheduleName: z.ZodString;
|
|
75
42
|
reportType: z.ZodString;
|
|
76
|
-
columns: z.ZodArray<z.ZodString
|
|
43
|
+
columns: z.ZodArray<z.ZodString>;
|
|
77
44
|
startDate: z.ZodString;
|
|
78
45
|
endDate: z.ZodString;
|
|
79
46
|
aggregation: z.ZodOptional<z.ZodString>;
|
|
80
47
|
schedule: z.ZodObject<{
|
|
81
48
|
StartDate: z.ZodString;
|
|
82
49
|
EndDate: z.ZodOptional<z.ZodString>;
|
|
83
|
-
Frequency: z.ZodEnum<
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
},
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
EndDate?: string | undefined;
|
|
92
|
-
}>;
|
|
93
|
-
}, "strip", z.ZodTypeAny, {
|
|
94
|
-
accountId: string;
|
|
95
|
-
reportType: string;
|
|
96
|
-
scheduleName: string;
|
|
97
|
-
columns: string[];
|
|
98
|
-
startDate: string;
|
|
99
|
-
endDate: string;
|
|
100
|
-
schedule: {
|
|
101
|
-
StartDate: string;
|
|
102
|
-
Frequency: "Daily" | "Weekly" | "Monthly";
|
|
103
|
-
EndDate?: string | undefined;
|
|
104
|
-
};
|
|
105
|
-
aggregation?: string | undefined;
|
|
106
|
-
}, {
|
|
107
|
-
accountId: string;
|
|
108
|
-
reportType: string;
|
|
109
|
-
scheduleName: string;
|
|
110
|
-
columns: string[];
|
|
111
|
-
startDate: string;
|
|
112
|
-
endDate: string;
|
|
113
|
-
schedule: {
|
|
114
|
-
StartDate: string;
|
|
115
|
-
Frequency: "Daily" | "Weekly" | "Monthly";
|
|
116
|
-
EndDate?: string | undefined;
|
|
117
|
-
};
|
|
118
|
-
aggregation?: string | undefined;
|
|
119
|
-
}>;
|
|
50
|
+
Frequency: z.ZodEnum<{
|
|
51
|
+
Daily: "Daily";
|
|
52
|
+
Weekly: "Weekly";
|
|
53
|
+
Monthly: "Monthly";
|
|
54
|
+
}>;
|
|
55
|
+
}, z.core.$strip>;
|
|
56
|
+
dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
57
|
+
}, z.core.$strip>;
|
|
120
58
|
outputSchema: z.ZodObject<{
|
|
121
|
-
scheduleId: z.ZodString
|
|
122
|
-
scheduleName: z.ZodString
|
|
59
|
+
scheduleId: z.ZodOptional<z.ZodString>;
|
|
60
|
+
scheduleName: z.ZodOptional<z.ZodString>;
|
|
123
61
|
timestamp: z.ZodString;
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
}, {
|
|
129
|
-
scheduleName: string;
|
|
130
|
-
scheduleId: string;
|
|
131
|
-
timestamp: string;
|
|
132
|
-
}>;
|
|
62
|
+
dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, unknown, z.core.$ZodTypeInternals<EffectDryRunResult, unknown>>>;
|
|
63
|
+
effect: z.ZodOptional<z.ZodType<import("@cesteral/contract-schema").EffectResult, unknown, z.core.$ZodTypeInternals<import("@cesteral/contract-schema").EffectResult, unknown>>>;
|
|
64
|
+
dispatchedCapability: z.ZodType<DispatchedCapability, unknown, z.core.$ZodTypeInternals<DispatchedCapability, unknown>>;
|
|
65
|
+
}, z.core.$strip>;
|
|
133
66
|
annotations: {
|
|
134
67
|
readOnlyHint: boolean;
|
|
135
68
|
openWorldHint: boolean;
|
|
136
69
|
destructiveHint: boolean;
|
|
137
70
|
idempotentHint: boolean;
|
|
71
|
+
cesteral: {
|
|
72
|
+
kind: "write";
|
|
73
|
+
writeClass: "effect";
|
|
74
|
+
executableArgsExclude: string[];
|
|
75
|
+
platform: string;
|
|
76
|
+
contractPlatformSlug: string;
|
|
77
|
+
contractToolSlug: string;
|
|
78
|
+
operation: "create_schedule"[];
|
|
79
|
+
entityKinds: never[];
|
|
80
|
+
entityIdArgs: never[];
|
|
81
|
+
schemaVersion: number;
|
|
82
|
+
contractId: string;
|
|
83
|
+
supportsDryRun: true;
|
|
84
|
+
supportsBeforeAfterSnapshot: false;
|
|
85
|
+
requiresValidation: true;
|
|
86
|
+
requiresSimulation: false;
|
|
87
|
+
};
|
|
138
88
|
};
|
|
139
89
|
inputExamples: {
|
|
140
90
|
label: string;
|
|
@@ -155,6 +105,7 @@ export declare const createReportScheduleTool: {
|
|
|
155
105
|
}[];
|
|
156
106
|
logic: typeof createReportScheduleLogic;
|
|
157
107
|
responseFormatter: typeof createReportScheduleResponseFormatter;
|
|
108
|
+
untrustedContent: Readonly<import("@cesteral/shared").ToolUntrustedDeclaration>;
|
|
158
109
|
};
|
|
159
110
|
export {};
|
|
160
111
|
//# sourceMappingURL=create-report-schedule.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"create-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAoB1B,eAAO,MAAM,iCAAiC,sRACkO,CAAC;AAEjR,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;iBA2B2B,CAAC;AAExE,eAAO,MAAM,gCAAgC;;;;;;;iBAoBP,CAAC;AAEvC,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,0BAA0B,CAAC,CAyBrC;AA6DD,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAsBlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDpC,CAAC"}
|