@cesteral/gads-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 +262 -0
- package/dist/auth/gads-auth-adapter.d.ts +31 -0
- package/dist/auth/gads-auth-adapter.d.ts.map +1 -0
- package/dist/auth/gads-auth-adapter.js +70 -0
- package/dist/auth/gads-auth-adapter.js.map +1 -0
- package/dist/auth/gads-auth-strategy.d.ts +9 -0
- package/dist/auth/gads-auth-strategy.d.ts.map +1 -0
- package/dist/auth/gads-auth-strategy.js +27 -0
- package/dist/auth/gads-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +100 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +37 -0
- package/dist/config/index.js.map +1 -0
- package/dist/container/index.d.ts +5 -0
- package/dist/container/index.d.ts.map +1 -0
- package/dist/container/index.js +14 -0
- package/dist/container/index.js.map +1 -0
- package/dist/container/registrations/core.d.ts +3 -0
- package/dist/container/registrations/core.d.ts.map +1 -0
- package/dist/container/registrations/core.js +14 -0
- package/dist/container/registrations/core.js.map +1 -0
- package/dist/container/registrations/mcp.d.ts +2 -0
- package/dist/container/registrations/mcp.d.ts.map +1 -0
- package/dist/container/registrations/mcp.js +3 -0
- package/dist/container/registrations/mcp.js.map +1 -0
- package/dist/container/tokens.d.ts +6 -0
- package/dist/container/tokens.d.ts.map +1 -0
- package/dist/container/tokens.js +6 -0
- package/dist/container/tokens.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +50 -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 +230 -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 +237 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.js +154 -0
- package/dist/mcp-server/prompts/definitions/creative-setup-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 +221 -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 +207 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/gaql-reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/gaql-reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/gaql-reporting-workflow.prompt.js +182 -0
- package/dist/mcp-server/prompts/definitions/gaql-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 +223 -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 +125 -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 +177 -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 +574 -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 +124 -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 +264 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/gaql-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/gaql-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/gaql-reference.resource.js +157 -0
- package/dist/mcp-server/resources/definitions/gaql-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +42 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js +78 -0
- package/dist/mcp-server/resources/definitions/insights-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 +124 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +270 -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 +189 -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 +148 -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 +141 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-mutate.tool.d.ts +136 -0
- package/dist/mcp-server/tools/definitions/bulk-mutate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-mutate.tool.js +127 -0
- package/dist/mcp-server/tools/definitions/bulk-mutate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +185 -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 +149 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +123 -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 +98 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/gaql-search.tool.d.ts +197 -0
- package/dist/mcp-server/tools/definitions/gaql-search.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/gaql-search.tool.js +110 -0
- package/dist/mcp-server/tools/definitions/gaql-search.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +87 -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 +91 -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 +92 -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 +87 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts +382 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js +246 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +141 -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 +163 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +18 -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 +54 -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 +61 -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 +220 -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/remove-entity.tool.d.ts +116 -0
- package/dist/mcp-server/tools/definitions/remove-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/remove-entity.tool.js +120 -0
- package/dist/mcp-server/tools/definitions/remove-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +129 -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 +91 -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 +239 -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 +151 -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/computed-metrics.d.ts +8 -0
- package/dist/mcp-server/tools/utils/computed-metrics.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/computed-metrics.js +19 -0
- package/dist/mcp-server/tools/utils/computed-metrics.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +22 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +99 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/gaql-helpers.d.ts +4 -0
- package/dist/mcp-server/tools/utils/gaql-helpers.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/gaql-helpers.js +82 -0
- package/dist/mcp-server/tools/utils/gaql-helpers.js.map +1 -0
- package/dist/mcp-server/tools/utils/parent-id-validation.d.ts +10 -0
- package/dist/mcp-server/tools/utils/parent-id-validation.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/parent-id-validation.js +58 -0
- package/dist/mcp-server/tools/utils/parent-id-validation.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 +49 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +84 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/gads/gads-http-client.d.ts +13 -0
- package/dist/services/gads/gads-http-client.d.ts.map +1 -0
- package/dist/services/gads/gads-http-client.js +113 -0
- package/dist/services/gads/gads-http-client.js.map +1 -0
- package/dist/services/gads/gads-service.d.ts +60 -0
- package/dist/services/gads/gads-service.d.ts.map +1 -0
- package/dist/services/gads/gads-service.js +363 -0
- package/dist/services/gads/gads-service.js.map +1 -0
- package/dist/services/gads/types.d.ts +211 -0
- package/dist/services/gads/types.d.ts.map +1 -0
- package/dist/services/gads/types.js +16 -0
- package/dist/services/gads/types.js.map +1 -0
- package/dist/services/session-services.d.ts +17 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +14 -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,189 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { elicitBidChangeConfirmation } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "gads_adjust_bids";
|
|
5
|
+
const TOOL_TITLE = "Google Ads Bid Adjustment";
|
|
6
|
+
const TOOL_DESCRIPTION = `Batch adjust ad group bids with safe read-modify-write pattern.
|
|
7
|
+
|
|
8
|
+
For each ad group, the tool:
|
|
9
|
+
1. Reads the current ad group to capture previous bid values
|
|
10
|
+
2. Applies the new CPC and/or CPM bid amounts
|
|
11
|
+
3. Writes the update via the :mutate endpoint with a targeted updateMask
|
|
12
|
+
|
|
13
|
+
Returns both previous and new values for audit trail.
|
|
14
|
+
|
|
15
|
+
**Bid amounts are in micros** (1,000,000 = $1.00 USD). For example:
|
|
16
|
+
- $1.50 CPC = "1500000"
|
|
17
|
+
- $5.00 CPM = "5000000"
|
|
18
|
+
|
|
19
|
+
Up to 50 ad groups can be adjusted in a single call.
|
|
20
|
+
|
|
21
|
+
**Note:** Uses a read-modify-write pattern. Concurrent bid adjustments to the same ad group may cause one update to overwrite the other. Avoid adjusting the same ad group in parallel.`;
|
|
22
|
+
export const AdjustBidsInputSchema = z
|
|
23
|
+
.object({
|
|
24
|
+
customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
|
|
25
|
+
adjustments: z
|
|
26
|
+
.array(z
|
|
27
|
+
.object({
|
|
28
|
+
adGroupId: z.string().min(1).describe("Ad group ID"),
|
|
29
|
+
cpcBidMicros: z
|
|
30
|
+
.string()
|
|
31
|
+
.optional()
|
|
32
|
+
.describe("New CPC bid in micros (1,000,000 = $1.00)"),
|
|
33
|
+
cpmBidMicros: z
|
|
34
|
+
.string()
|
|
35
|
+
.optional()
|
|
36
|
+
.describe("New CPM bid in micros (1,000,000 = $1.00)"),
|
|
37
|
+
})
|
|
38
|
+
.superRefine((adj, ctx) => {
|
|
39
|
+
if (adj.cpcBidMicros === undefined && adj.cpmBidMicros === undefined) {
|
|
40
|
+
ctx.addIssue({
|
|
41
|
+
code: z.ZodIssueCode.custom,
|
|
42
|
+
message: "At least one of cpcBidMicros or cpmBidMicros must be provided",
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
}))
|
|
46
|
+
.min(1)
|
|
47
|
+
.max(50)
|
|
48
|
+
.describe("Array of bid adjustments (max 50)"),
|
|
49
|
+
reason: z
|
|
50
|
+
.string()
|
|
51
|
+
.optional()
|
|
52
|
+
.describe("Optional reason for the bid adjustment (for audit trail)"),
|
|
53
|
+
})
|
|
54
|
+
.describe("Parameters for batch Google Ads bid adjustment");
|
|
55
|
+
export const AdjustBidsOutputSchema = z
|
|
56
|
+
.object({
|
|
57
|
+
confirmed: z.boolean(),
|
|
58
|
+
declineReason: z.string().optional(),
|
|
59
|
+
totalRequested: z.number(),
|
|
60
|
+
totalSucceeded: z.number(),
|
|
61
|
+
totalFailed: z.number(),
|
|
62
|
+
results: z.array(z.object({
|
|
63
|
+
adGroupId: z.string(),
|
|
64
|
+
adGroupName: z.string().optional(),
|
|
65
|
+
success: z.boolean(),
|
|
66
|
+
previousCpcBidMicros: z.string().optional(),
|
|
67
|
+
previousCpmBidMicros: z.string().optional(),
|
|
68
|
+
newCpcBidMicros: z.string().optional(),
|
|
69
|
+
newCpmBidMicros: z.string().optional(),
|
|
70
|
+
error: z.string().optional(),
|
|
71
|
+
})),
|
|
72
|
+
timestamp: z.string().datetime(),
|
|
73
|
+
})
|
|
74
|
+
.describe("Bid adjustment results");
|
|
75
|
+
export async function adjustBidsLogic(input, context, sdkContext) {
|
|
76
|
+
const confirmed = await elicitBidChangeConfirmation({
|
|
77
|
+
count: input.adjustments.length,
|
|
78
|
+
entityLabel: "ad group",
|
|
79
|
+
summary: input.reason ?? "Applying CPC/CPM bid changes.",
|
|
80
|
+
impactPreview: input.adjustments.map((a) => a.adGroupId),
|
|
81
|
+
sdkContext,
|
|
82
|
+
});
|
|
83
|
+
if (!confirmed) {
|
|
84
|
+
return {
|
|
85
|
+
confirmed: false,
|
|
86
|
+
declineReason: "user_declined",
|
|
87
|
+
totalRequested: input.adjustments.length,
|
|
88
|
+
totalSucceeded: 0,
|
|
89
|
+
totalFailed: 0,
|
|
90
|
+
results: [],
|
|
91
|
+
timestamp: new Date().toISOString(),
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
const { gadsService } = resolveSessionServices(sdkContext);
|
|
95
|
+
const { results } = await gadsService.adjustBids(input.customerId, input.adjustments, context);
|
|
96
|
+
const succeeded = results.filter((r) => r.success).length;
|
|
97
|
+
return {
|
|
98
|
+
confirmed: true,
|
|
99
|
+
totalRequested: input.adjustments.length,
|
|
100
|
+
totalSucceeded: succeeded,
|
|
101
|
+
totalFailed: input.adjustments.length - succeeded,
|
|
102
|
+
results: results.map((r) => ({
|
|
103
|
+
adGroupId: r.adGroupId,
|
|
104
|
+
adGroupName: r.adGroupName,
|
|
105
|
+
success: r.success,
|
|
106
|
+
previousCpcBidMicros: r.previousCpcBidMicros,
|
|
107
|
+
previousCpmBidMicros: r.previousCpmBidMicros,
|
|
108
|
+
newCpcBidMicros: r.newCpcBidMicros,
|
|
109
|
+
newCpmBidMicros: r.newCpmBidMicros,
|
|
110
|
+
error: r.error,
|
|
111
|
+
})),
|
|
112
|
+
timestamp: new Date().toISOString(),
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
function formatMicrosAsDollars(micros) {
|
|
116
|
+
if (!micros)
|
|
117
|
+
return "n/a";
|
|
118
|
+
const num = Number(micros);
|
|
119
|
+
if (isNaN(num))
|
|
120
|
+
return micros;
|
|
121
|
+
return `$${(num / 1_000_000).toFixed(2)}`;
|
|
122
|
+
}
|
|
123
|
+
export function adjustBidsResponseFormatter(result) {
|
|
124
|
+
if (!result.confirmed) {
|
|
125
|
+
return [
|
|
126
|
+
{
|
|
127
|
+
type: "text",
|
|
128
|
+
text: `Bid adjustments cancelled by user.\n\nTimestamp: ${result.timestamp}`,
|
|
129
|
+
},
|
|
130
|
+
];
|
|
131
|
+
}
|
|
132
|
+
const lines = result.results.map((r) => {
|
|
133
|
+
if (r.success) {
|
|
134
|
+
const parts = [];
|
|
135
|
+
const name = r.adGroupName ? ` (${r.adGroupName})` : "";
|
|
136
|
+
if (r.newCpcBidMicros !== undefined) {
|
|
137
|
+
parts.push(`CPC ${formatMicrosAsDollars(r.previousCpcBidMicros)} -> ${formatMicrosAsDollars(r.newCpcBidMicros)}`);
|
|
138
|
+
}
|
|
139
|
+
if (r.newCpmBidMicros !== undefined) {
|
|
140
|
+
parts.push(`CPM ${formatMicrosAsDollars(r.previousCpmBidMicros)} -> ${formatMicrosAsDollars(r.newCpmBidMicros)}`);
|
|
141
|
+
}
|
|
142
|
+
return ` + ${r.adGroupId}${name}: ${parts.join(", ")}`;
|
|
143
|
+
}
|
|
144
|
+
return ` x ${r.adGroupId}: ${r.error}`;
|
|
145
|
+
});
|
|
146
|
+
const summary = `Bid adjustments: ${result.totalSucceeded}/${result.totalRequested} succeeded, ${result.totalFailed} failed`;
|
|
147
|
+
return [
|
|
148
|
+
{
|
|
149
|
+
type: "text",
|
|
150
|
+
text: `${summary}\n\n${lines.join("\n")}\n\nNote: Amounts in micros (1,000,000 = $1.00 USD)\nTimestamp: ${result.timestamp}`,
|
|
151
|
+
},
|
|
152
|
+
];
|
|
153
|
+
}
|
|
154
|
+
export const adjustBidsTool = {
|
|
155
|
+
name: TOOL_NAME,
|
|
156
|
+
title: TOOL_TITLE,
|
|
157
|
+
description: TOOL_DESCRIPTION,
|
|
158
|
+
inputSchema: AdjustBidsInputSchema,
|
|
159
|
+
outputSchema: AdjustBidsOutputSchema,
|
|
160
|
+
annotations: {
|
|
161
|
+
readOnlyHint: false,
|
|
162
|
+
destructiveHint: true,
|
|
163
|
+
idempotentHint: true,
|
|
164
|
+
openWorldHint: false,
|
|
165
|
+
},
|
|
166
|
+
inputExamples: [
|
|
167
|
+
{
|
|
168
|
+
label: "Single CPC adjustment",
|
|
169
|
+
input: {
|
|
170
|
+
customerId: "1234567890",
|
|
171
|
+
adjustments: [{ adGroupId: "111222333", cpcBidMicros: "1500000" }],
|
|
172
|
+
},
|
|
173
|
+
},
|
|
174
|
+
{
|
|
175
|
+
label: "Multiple adjustments with mixed bid types",
|
|
176
|
+
input: {
|
|
177
|
+
customerId: "1234567890",
|
|
178
|
+
adjustments: [
|
|
179
|
+
{ adGroupId: "111", cpcBidMicros: "2000000" },
|
|
180
|
+
{ adGroupId: "222", cpmBidMicros: "5000000" },
|
|
181
|
+
],
|
|
182
|
+
reason: "Increase bids to improve delivery pacing",
|
|
183
|
+
},
|
|
184
|
+
},
|
|
185
|
+
],
|
|
186
|
+
logic: adjustBidsLogic,
|
|
187
|
+
responseFormatter: adjustBidsResponseFormatter,
|
|
188
|
+
};
|
|
189
|
+
//# sourceMappingURL=adjust-bids.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adjust-bids.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const BulkCreateEntitiesInputSchema: z.ZodEffects<z.ZodObject<{
|
|
5
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
6
|
+
customerId: z.ZodString;
|
|
7
|
+
items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
8
|
+
}, "strip", z.ZodTypeAny, {
|
|
9
|
+
customerId: string;
|
|
10
|
+
entityType: string;
|
|
11
|
+
items: Record<string, any>[];
|
|
12
|
+
}, {
|
|
13
|
+
customerId: string;
|
|
14
|
+
entityType: string;
|
|
15
|
+
items: Record<string, any>[];
|
|
16
|
+
}>, {
|
|
17
|
+
customerId: string;
|
|
18
|
+
entityType: string;
|
|
19
|
+
items: Record<string, any>[];
|
|
20
|
+
}, {
|
|
21
|
+
customerId: string;
|
|
22
|
+
entityType: string;
|
|
23
|
+
items: Record<string, any>[];
|
|
24
|
+
}>;
|
|
25
|
+
export declare const BulkCreateEntitiesOutputSchema: z.ZodObject<{
|
|
26
|
+
results: z.ZodArray<z.ZodObject<{
|
|
27
|
+
success: z.ZodBoolean;
|
|
28
|
+
entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
29
|
+
error: z.ZodOptional<z.ZodString>;
|
|
30
|
+
}, "strip", z.ZodTypeAny, {
|
|
31
|
+
success: boolean;
|
|
32
|
+
error?: string | undefined;
|
|
33
|
+
entity?: Record<string, any> | undefined;
|
|
34
|
+
}, {
|
|
35
|
+
success: boolean;
|
|
36
|
+
error?: string | undefined;
|
|
37
|
+
entity?: Record<string, any> | undefined;
|
|
38
|
+
}>, "many">;
|
|
39
|
+
successCount: z.ZodNumber;
|
|
40
|
+
failureCount: z.ZodNumber;
|
|
41
|
+
timestamp: z.ZodString;
|
|
42
|
+
}, "strip", z.ZodTypeAny, {
|
|
43
|
+
results: {
|
|
44
|
+
success: boolean;
|
|
45
|
+
error?: string | undefined;
|
|
46
|
+
entity?: Record<string, any> | undefined;
|
|
47
|
+
}[];
|
|
48
|
+
timestamp: string;
|
|
49
|
+
successCount: number;
|
|
50
|
+
failureCount: number;
|
|
51
|
+
}, {
|
|
52
|
+
results: {
|
|
53
|
+
success: boolean;
|
|
54
|
+
error?: string | undefined;
|
|
55
|
+
entity?: Record<string, any> | undefined;
|
|
56
|
+
}[];
|
|
57
|
+
timestamp: string;
|
|
58
|
+
successCount: number;
|
|
59
|
+
failureCount: number;
|
|
60
|
+
}>;
|
|
61
|
+
type BulkCreateEntitiesInput = z.infer<typeof BulkCreateEntitiesInputSchema>;
|
|
62
|
+
type BulkCreateEntitiesOutput = z.infer<typeof BulkCreateEntitiesOutputSchema>;
|
|
63
|
+
export declare function bulkCreateEntitiesLogic(input: BulkCreateEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkCreateEntitiesOutput>;
|
|
64
|
+
export declare function bulkCreateEntitiesResponseFormatter(result: BulkCreateEntitiesOutput): McpTextContent[];
|
|
65
|
+
export declare const bulkCreateEntitiesTool: {
|
|
66
|
+
name: string;
|
|
67
|
+
title: string;
|
|
68
|
+
description: string;
|
|
69
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
70
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
71
|
+
customerId: z.ZodString;
|
|
72
|
+
items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
73
|
+
}, "strip", z.ZodTypeAny, {
|
|
74
|
+
customerId: string;
|
|
75
|
+
entityType: string;
|
|
76
|
+
items: Record<string, any>[];
|
|
77
|
+
}, {
|
|
78
|
+
customerId: string;
|
|
79
|
+
entityType: string;
|
|
80
|
+
items: Record<string, any>[];
|
|
81
|
+
}>, {
|
|
82
|
+
customerId: string;
|
|
83
|
+
entityType: string;
|
|
84
|
+
items: Record<string, any>[];
|
|
85
|
+
}, {
|
|
86
|
+
customerId: string;
|
|
87
|
+
entityType: string;
|
|
88
|
+
items: Record<string, any>[];
|
|
89
|
+
}>;
|
|
90
|
+
outputSchema: z.ZodObject<{
|
|
91
|
+
results: z.ZodArray<z.ZodObject<{
|
|
92
|
+
success: z.ZodBoolean;
|
|
93
|
+
entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
94
|
+
error: z.ZodOptional<z.ZodString>;
|
|
95
|
+
}, "strip", z.ZodTypeAny, {
|
|
96
|
+
success: boolean;
|
|
97
|
+
error?: string | undefined;
|
|
98
|
+
entity?: Record<string, any> | undefined;
|
|
99
|
+
}, {
|
|
100
|
+
success: boolean;
|
|
101
|
+
error?: string | undefined;
|
|
102
|
+
entity?: Record<string, any> | undefined;
|
|
103
|
+
}>, "many">;
|
|
104
|
+
successCount: z.ZodNumber;
|
|
105
|
+
failureCount: z.ZodNumber;
|
|
106
|
+
timestamp: z.ZodString;
|
|
107
|
+
}, "strip", z.ZodTypeAny, {
|
|
108
|
+
results: {
|
|
109
|
+
success: boolean;
|
|
110
|
+
error?: string | undefined;
|
|
111
|
+
entity?: Record<string, any> | undefined;
|
|
112
|
+
}[];
|
|
113
|
+
timestamp: string;
|
|
114
|
+
successCount: number;
|
|
115
|
+
failureCount: number;
|
|
116
|
+
}, {
|
|
117
|
+
results: {
|
|
118
|
+
success: boolean;
|
|
119
|
+
error?: string | undefined;
|
|
120
|
+
entity?: Record<string, any> | undefined;
|
|
121
|
+
}[];
|
|
122
|
+
timestamp: string;
|
|
123
|
+
successCount: number;
|
|
124
|
+
failureCount: number;
|
|
125
|
+
}>;
|
|
126
|
+
annotations: {
|
|
127
|
+
readOnlyHint: boolean;
|
|
128
|
+
openWorldHint: boolean;
|
|
129
|
+
idempotentHint: boolean;
|
|
130
|
+
destructiveHint: boolean;
|
|
131
|
+
};
|
|
132
|
+
inputExamples: {
|
|
133
|
+
label: string;
|
|
134
|
+
input: {
|
|
135
|
+
entityType: string;
|
|
136
|
+
customerId: string;
|
|
137
|
+
items: {
|
|
138
|
+
name: string;
|
|
139
|
+
amountMicros: string;
|
|
140
|
+
deliveryMethod: string;
|
|
141
|
+
}[];
|
|
142
|
+
};
|
|
143
|
+
}[];
|
|
144
|
+
logic: typeof bulkCreateEntitiesLogic;
|
|
145
|
+
responseFormatter: typeof bulkCreateEntitiesResponseFormatter;
|
|
146
|
+
};
|
|
147
|
+
export {};
|
|
148
|
+
//# sourceMappingURL=bulk-create-entities.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bulk-create-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;EAmBQ,CAAC;AAEnD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOR,CAAC;AAEpC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAoEnC;AAoBD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmClC,CAAC"}
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
+
import { addParentValidationIssue } from "../utils/parent-id-validation.js";
|
|
5
|
+
import { BulkOperationResultSchema } from "@cesteral/shared";
|
|
6
|
+
const TOOL_NAME = "gads_bulk_create_entities";
|
|
7
|
+
const TOOL_TITLE = "Bulk Create Google Ads Entities";
|
|
8
|
+
const TOOL_DESCRIPTION = `Batch create multiple entities of the same type in a single API call.
|
|
9
|
+
|
|
10
|
+
**Supported entity types:** ${getEntityTypeEnum().join(", ")}
|
|
11
|
+
|
|
12
|
+
Simpler alternative to \`gads_bulk_mutate\` when you only need to create entities.
|
|
13
|
+
Each item in \`items\` is the entity data object (same format as \`gads_create_entity\`).
|
|
14
|
+
|
|
15
|
+
- Max 50 items per call.
|
|
16
|
+
- Uses \`partialFailure: true\` so individual items can fail without aborting the batch.
|
|
17
|
+
- Returns per-item success/failure results.
|
|
18
|
+
|
|
19
|
+
**Important**: For campaigns, create campaignBudgets first and reference them via the \`campaignBudget\` field.`;
|
|
20
|
+
export const BulkCreateEntitiesInputSchema = z
|
|
21
|
+
.object({
|
|
22
|
+
entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to create"),
|
|
23
|
+
customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
|
|
24
|
+
items: z
|
|
25
|
+
.array(z.record(z.any()))
|
|
26
|
+
.min(1)
|
|
27
|
+
.max(50)
|
|
28
|
+
.describe("Array of entity data objects to create (max 50). Each object has the same shape as gads_create_entity data."),
|
|
29
|
+
})
|
|
30
|
+
.superRefine((input, ctx) => {
|
|
31
|
+
addParentValidationIssue(ctx, input.entityType, input);
|
|
32
|
+
})
|
|
33
|
+
.describe("Parameters for bulk entity creation");
|
|
34
|
+
export const BulkCreateEntitiesOutputSchema = z
|
|
35
|
+
.object({
|
|
36
|
+
results: z.array(BulkOperationResultSchema),
|
|
37
|
+
successCount: z.number(),
|
|
38
|
+
failureCount: z.number(),
|
|
39
|
+
timestamp: z.string().datetime(),
|
|
40
|
+
})
|
|
41
|
+
.describe("Bulk creation result");
|
|
42
|
+
export async function bulkCreateEntitiesLogic(input, context, sdkContext) {
|
|
43
|
+
const { gadsService } = resolveSessionServices(sdkContext);
|
|
44
|
+
const operations = input.items.map((item) => ({ create: item }));
|
|
45
|
+
const apiResult = (await gadsService.bulkMutate(input.entityType, input.customerId, operations, true, context));
|
|
46
|
+
const mutateResults = (apiResult?.results ?? []);
|
|
47
|
+
const partialErrors = apiResult?.partialFailureError ?? null;
|
|
48
|
+
const errorDetails = (partialErrors?.details ?? []);
|
|
49
|
+
const errorsByIndex = new Map();
|
|
50
|
+
for (const detail of errorDetails) {
|
|
51
|
+
const errors = (detail?.errors ?? []);
|
|
52
|
+
for (const err of errors) {
|
|
53
|
+
const location = err?.location;
|
|
54
|
+
const fieldPathElements = (location?.fieldPathElements ?? []);
|
|
55
|
+
const opElement = fieldPathElements.find((el) => el.fieldName === "operations" && el.index != null);
|
|
56
|
+
const opIndex = opElement ? Number(opElement.index) : -1;
|
|
57
|
+
const message = err?.message ??
|
|
58
|
+
(err?.errorCode ? JSON.stringify(err.errorCode) : "Unknown error");
|
|
59
|
+
if (opIndex >= 0) {
|
|
60
|
+
errorsByIndex.set(opIndex, message);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
const results = input.items.map((_item, index) => {
|
|
65
|
+
const error = errorsByIndex.get(index);
|
|
66
|
+
if (error) {
|
|
67
|
+
return { success: false, error };
|
|
68
|
+
}
|
|
69
|
+
const mutateResult = mutateResults[index];
|
|
70
|
+
const resourceName = mutateResult?.resourceName ??
|
|
71
|
+
extractResourceName(mutateResult);
|
|
72
|
+
return {
|
|
73
|
+
success: true,
|
|
74
|
+
entity: resourceName ? { resourceName } : (mutateResult ?? {}),
|
|
75
|
+
};
|
|
76
|
+
});
|
|
77
|
+
const successCount = results.filter((r) => r.success).length;
|
|
78
|
+
return {
|
|
79
|
+
results,
|
|
80
|
+
successCount,
|
|
81
|
+
failureCount: results.length - successCount,
|
|
82
|
+
timestamp: new Date().toISOString(),
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
function extractResourceName(result) {
|
|
86
|
+
if (!result)
|
|
87
|
+
return undefined;
|
|
88
|
+
for (const value of Object.values(result)) {
|
|
89
|
+
if (value &&
|
|
90
|
+
typeof value === "object" &&
|
|
91
|
+
"resourceName" in value) {
|
|
92
|
+
return value.resourceName;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
export function bulkCreateEntitiesResponseFormatter(result) {
|
|
98
|
+
return [
|
|
99
|
+
{
|
|
100
|
+
type: "text",
|
|
101
|
+
text: `Bulk create: ${result.successCount} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
102
|
+
},
|
|
103
|
+
];
|
|
104
|
+
}
|
|
105
|
+
export const bulkCreateEntitiesTool = {
|
|
106
|
+
name: TOOL_NAME,
|
|
107
|
+
title: TOOL_TITLE,
|
|
108
|
+
description: TOOL_DESCRIPTION,
|
|
109
|
+
inputSchema: BulkCreateEntitiesInputSchema,
|
|
110
|
+
outputSchema: BulkCreateEntitiesOutputSchema,
|
|
111
|
+
annotations: {
|
|
112
|
+
readOnlyHint: false,
|
|
113
|
+
openWorldHint: false,
|
|
114
|
+
idempotentHint: false,
|
|
115
|
+
destructiveHint: true,
|
|
116
|
+
},
|
|
117
|
+
inputExamples: [
|
|
118
|
+
{
|
|
119
|
+
label: "Create 2 campaign budgets",
|
|
120
|
+
input: {
|
|
121
|
+
entityType: "campaignBudget",
|
|
122
|
+
customerId: "1234567890",
|
|
123
|
+
items: [
|
|
124
|
+
{
|
|
125
|
+
name: "Q1 2025 Brand Budget",
|
|
126
|
+
amountMicros: "50000000000",
|
|
127
|
+
deliveryMethod: "STANDARD",
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
name: "Q1 2025 Generic Budget",
|
|
131
|
+
amountMicros: "30000000000",
|
|
132
|
+
deliveryMethod: "STANDARD",
|
|
133
|
+
},
|
|
134
|
+
],
|
|
135
|
+
},
|
|
136
|
+
},
|
|
137
|
+
],
|
|
138
|
+
logic: bulkCreateEntitiesLogic,
|
|
139
|
+
responseFormatter: bulkCreateEntitiesResponseFormatter,
|
|
140
|
+
};
|
|
141
|
+
//# sourceMappingURL=bulk-create-entities.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bulk-create-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const BulkMutateInputSchema: z.ZodEffects<z.ZodObject<{
|
|
5
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
6
|
+
customerId: z.ZodString;
|
|
7
|
+
operations: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
8
|
+
partialFailure: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
9
|
+
}, "strip", z.ZodTypeAny, {
|
|
10
|
+
customerId: string;
|
|
11
|
+
entityType: string;
|
|
12
|
+
operations: Record<string, any>[];
|
|
13
|
+
partialFailure: boolean;
|
|
14
|
+
}, {
|
|
15
|
+
customerId: string;
|
|
16
|
+
entityType: string;
|
|
17
|
+
operations: Record<string, any>[];
|
|
18
|
+
partialFailure?: boolean | undefined;
|
|
19
|
+
}>, {
|
|
20
|
+
customerId: string;
|
|
21
|
+
entityType: string;
|
|
22
|
+
operations: Record<string, any>[];
|
|
23
|
+
partialFailure: boolean;
|
|
24
|
+
}, {
|
|
25
|
+
customerId: string;
|
|
26
|
+
entityType: string;
|
|
27
|
+
operations: Record<string, any>[];
|
|
28
|
+
partialFailure?: boolean | undefined;
|
|
29
|
+
}>;
|
|
30
|
+
export declare const BulkMutateOutputSchema: z.ZodObject<{
|
|
31
|
+
mutateResult: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
32
|
+
operationCount: z.ZodNumber;
|
|
33
|
+
timestamp: z.ZodString;
|
|
34
|
+
}, "strip", z.ZodTypeAny, {
|
|
35
|
+
operationCount: number;
|
|
36
|
+
timestamp: string;
|
|
37
|
+
mutateResult: Record<string, any>;
|
|
38
|
+
}, {
|
|
39
|
+
operationCount: number;
|
|
40
|
+
timestamp: string;
|
|
41
|
+
mutateResult: Record<string, any>;
|
|
42
|
+
}>;
|
|
43
|
+
type BulkMutateInput = z.infer<typeof BulkMutateInputSchema>;
|
|
44
|
+
type BulkMutateOutput = z.infer<typeof BulkMutateOutputSchema>;
|
|
45
|
+
export declare function bulkMutateLogic(input: BulkMutateInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkMutateOutput>;
|
|
46
|
+
export declare function bulkMutateResponseFormatter(result: BulkMutateOutput): McpTextContent[];
|
|
47
|
+
export declare const bulkMutateTool: {
|
|
48
|
+
name: string;
|
|
49
|
+
title: string;
|
|
50
|
+
description: string;
|
|
51
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
52
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
53
|
+
customerId: z.ZodString;
|
|
54
|
+
operations: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
55
|
+
partialFailure: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
56
|
+
}, "strip", z.ZodTypeAny, {
|
|
57
|
+
customerId: string;
|
|
58
|
+
entityType: string;
|
|
59
|
+
operations: Record<string, any>[];
|
|
60
|
+
partialFailure: boolean;
|
|
61
|
+
}, {
|
|
62
|
+
customerId: string;
|
|
63
|
+
entityType: string;
|
|
64
|
+
operations: Record<string, any>[];
|
|
65
|
+
partialFailure?: boolean | undefined;
|
|
66
|
+
}>, {
|
|
67
|
+
customerId: string;
|
|
68
|
+
entityType: string;
|
|
69
|
+
operations: Record<string, any>[];
|
|
70
|
+
partialFailure: boolean;
|
|
71
|
+
}, {
|
|
72
|
+
customerId: string;
|
|
73
|
+
entityType: string;
|
|
74
|
+
operations: Record<string, any>[];
|
|
75
|
+
partialFailure?: boolean | undefined;
|
|
76
|
+
}>;
|
|
77
|
+
outputSchema: z.ZodObject<{
|
|
78
|
+
mutateResult: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
79
|
+
operationCount: z.ZodNumber;
|
|
80
|
+
timestamp: z.ZodString;
|
|
81
|
+
}, "strip", z.ZodTypeAny, {
|
|
82
|
+
operationCount: number;
|
|
83
|
+
timestamp: string;
|
|
84
|
+
mutateResult: Record<string, any>;
|
|
85
|
+
}, {
|
|
86
|
+
operationCount: number;
|
|
87
|
+
timestamp: string;
|
|
88
|
+
mutateResult: Record<string, any>;
|
|
89
|
+
}>;
|
|
90
|
+
annotations: {
|
|
91
|
+
readOnlyHint: boolean;
|
|
92
|
+
openWorldHint: boolean;
|
|
93
|
+
destructiveHint: boolean;
|
|
94
|
+
idempotentHint: boolean;
|
|
95
|
+
};
|
|
96
|
+
inputExamples: ({
|
|
97
|
+
label: string;
|
|
98
|
+
input: {
|
|
99
|
+
entityType: string;
|
|
100
|
+
customerId: string;
|
|
101
|
+
operations: {
|
|
102
|
+
create: {
|
|
103
|
+
name: string;
|
|
104
|
+
campaign: string;
|
|
105
|
+
type: string;
|
|
106
|
+
status: string;
|
|
107
|
+
cpcBidMicros: string;
|
|
108
|
+
};
|
|
109
|
+
}[];
|
|
110
|
+
partialFailure?: undefined;
|
|
111
|
+
};
|
|
112
|
+
} | {
|
|
113
|
+
label: string;
|
|
114
|
+
input: {
|
|
115
|
+
entityType: string;
|
|
116
|
+
customerId: string;
|
|
117
|
+
operations: ({
|
|
118
|
+
update: {
|
|
119
|
+
resourceName: string;
|
|
120
|
+
name: string;
|
|
121
|
+
};
|
|
122
|
+
updateMask: string;
|
|
123
|
+
remove?: undefined;
|
|
124
|
+
} | {
|
|
125
|
+
remove: string;
|
|
126
|
+
update?: undefined;
|
|
127
|
+
updateMask?: undefined;
|
|
128
|
+
})[];
|
|
129
|
+
partialFailure: boolean;
|
|
130
|
+
};
|
|
131
|
+
})[];
|
|
132
|
+
logic: typeof bulkMutateLogic;
|
|
133
|
+
responseFormatter: typeof bulkMutateResponseFormatter;
|
|
134
|
+
};
|
|
135
|
+
export {};
|
|
136
|
+
//# sourceMappingURL=bulk-mutate.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bulk-mutate.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-mutate.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoBnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;EAsBkB,CAAC;AAErD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMF,CAAC;AAElC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAOtF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D1B,CAAC"}
|