@revfleet/hscli 0.8.7 → 0.8.11

package/dist/core/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/core/plugins.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/core/plugins.ts"],"names":[],"mappings":"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"}

package/dist/core/scopes.d.ts

@@ -0,0 +1,29 @@
+export type HubSpotScopeAccess = "read" | "write" | "read_write" | "other";
+export type HubSpotScopeSensitivity = "standard" | "sensitive" | "highly_sensitive";
+export interface HubSpotScopeDefinition {
+    scope: string;
+    category: string;
+    access: HubSpotScopeAccess;
+    sensitivity: HubSpotScopeSensitivity;
+    deprecated: boolean;
+    notes?: string;
+}
+export interface ScopeDiff {
+    required: string[];
+    granted: string[];
+    missing: string[];
+    present: string[];
+    unknownGranted: string[];
+    extraKnown: string[];
+}
+export declare const HUBSPOT_SCOPE_NAMES: string[];
+export declare const HUBSPOT_SCOPE_CATALOG: HubSpotScopeDefinition[];
+export declare const HUBSPOT_SCOPE_PRESETS: Record<string, string[]>;
+export declare function listScopePresetNames(): string[];
+export declare function getScopeDefinition(scope: string): HubSpotScopeDefinition | undefined;
+export declare function parseScopeList(raw: string | string[] | undefined): string[];
+export declare function resolveScopeSet(raw: string | undefined): {
+    name: string;
+    scopes: string[];
+};
+export declare function diffScopes(required: string[], granted: string[]): ScopeDiff;

package/dist/core/scopes.js

@@ -0,0 +1,415 @@
+const SUPPLIED_UI_SCOPE_NAMES = [
+    "crm.dealsplits.read_write",
+    "crm.export",
+    "crm.extensions_calling_transcripts.read",
+    "crm.extensions_calling_transcripts.write",
+    "crm.import",
+    "crm.lists.read",
+    "crm.lists.write",
+    "crm.objects.appointments.read",
+    "crm.objects.appointments.sensitive.read",
+    "crm.objects.appointments.sensitive.write",
+    "crm.objects.appointments.write",
+    "crm.objects.carts.read",
+    "crm.objects.carts.write",
+    "crm.objects.commercepayments.read",
+    "crm.objects.commercepayments.write",
+    "crm.objects.companies.highly_sensitive.read",
+    "crm.objects.companies.highly_sensitive.write",
+    "crm.objects.companies.read",
+    "crm.objects.companies.sensitive.read",
+    "crm.objects.companies.sensitive.write",
+    "crm.objects.companies.write",
+    "crm.objects.contacts.highly_sensitive.read",
+    "crm.objects.contacts.highly_sensitive.write",
+    "crm.objects.contacts.read",
+    "crm.objects.contacts.sensitive.read",
+    "crm.objects.contacts.sensitive.write",
+    "crm.objects.contacts.write",
+    "crm.objects.courses.read",
+    "crm.objects.courses.write",
+    "crm.objects.custom.highly_sensitive.read",
+    "crm.objects.custom.highly_sensitive.write",
+    "crm.objects.custom.read",
+    "crm.objects.custom.sensitive.read",
+    "crm.objects.custom.sensitive.write",
+    "crm.objects.custom.write",
+    "crm.objects.deals.highly_sensitive.read",
+    "crm.objects.deals.highly_sensitive.write",
+    "crm.objects.deals.read",
+    "crm.objects.deals.sensitive.read",
+    "crm.objects.deals.sensitive.write",
+    "crm.objects.deals.write",
+    "crm.objects.feedback_submissions.read",
+    "crm.objects.forecasts.read",
+    "crm.objects.goals.read",
+    "crm.objects.goals.write",
+    "crm.objects.invoices.read",
+    "crm.objects.invoices.write",
+    "crm.objects.leads.read",
+    "crm.objects.leads.write",
+    "crm.objects.line_items.read",
+    "crm.objects.line_items.write",
+    "crm.objects.listings.read",
+    "crm.objects.listings.write",
+    "crm.objects.marketing_events.read",
+    "crm.objects.marketing_events.write",
+    "crm.objects.orders.read",
+    "crm.objects.orders.write",
+    "crm.objects.owners.read",
+    "crm.objects.partner-clients.read",
+    "crm.objects.partner-clients.write",
+    "crm.objects.partner-services.read",
+    "crm.objects.partner-services.write",
+    "crm.objects.products.read",
+    "crm.objects.products.write",
+    "crm.objects.projects.read",
+    "crm.objects.projects.write",
+    "crm.objects.quotes.read",
+    "crm.objects.quotes.write",
+    "crm.objects.services.read",
+    "crm.objects.services.write",
+    "crm.objects.subscriptions.read",
+    "crm.objects.subscriptions.write",
+    "crm.objects.users.read",
+    "crm.objects.users.write",
+    "crm.pipelines.orders.read",
+    "crm.pipelines.orders.write",
+    "crm.schemas.appointments.read",
+    "crm.schemas.appointments.write",
+    "crm.schemas.carts.read",
+    "crm.schemas.carts.write",
+    "crm.schemas.commercepayments.read",
+    "crm.schemas.commercepayments.write",
+    "crm.schemas.companies.read",
+    "crm.schemas.companies.write",
+    "crm.schemas.contacts.read",
+    "crm.schemas.contacts.write",
+    "crm.schemas.courses.read",
+    "crm.schemas.courses.write",
+    "crm.schemas.custom.read",
+    "crm.schemas.custom.write",
+    "crm.schemas.deals.read",
+    "crm.schemas.deals.write",
+    "crm.schemas.forecasts.read",
+    "crm.schemas.invoices.read",
+    "crm.schemas.invoices.write",
+    "crm.schemas.line_items.read",
+    "crm.schemas.listings.read",
+    "crm.schemas.listings.write",
+    "crm.schemas.orders.read",
+    "crm.schemas.orders.write",
+    "crm.schemas.projects.read",
+    "crm.schemas.projects.write",
+    "crm.schemas.quotes.read",
+    "crm.schemas.quotes.write",
+    "crm.schemas.services.read",
+    "crm.schemas.services.write",
+    "crm.schemas.subscriptions.read",
+    "crm.schemas.subscriptions.write",
+    "cms.domains.read",
+    "cms.domains.write",
+    "cms.functions.read",
+    "cms.functions.write",
+    "cms.knowledge_base.articles.publish",
+    "cms.knowledge_base.articles.read",
+    "cms.knowledge_base.articles.write",
+    "cms.knowledge_base.settings.read",
+    "cms.knowledge_base.settings.write",
+    "cms.membership.access_groups.read",
+    "cms.membership.access_groups.write",
+    "cms.performance.read",
+    "automation",
+    "automation.sequences.enrollments.write",
+    "automation.sequences.read",
+    "communication_preferences.read",
+    "communication_preferences.read_write",
+    "communication_preferences.statuses.batch.read",
+    "communication_preferences.statuses.batch.write",
+    "communication_preferences.write",
+    "conversations.custom_channels.read",
+    "conversations.custom_channels.write",
+    "conversations.read",
+    "conversations.visitor_identification.tokens.create",
+    "conversations.write",
+    "marketing.campaigns.read",
+    "marketing.campaigns.revenue.read",
+    "marketing.campaigns.write",
+    "settings.billing.write",
+    "settings.currencies.read",
+    "settings.currencies.write",
+    "settings.security.security_health.read",
+    "settings.users.read",
+    "settings.users.teams.read",
+    "settings.users.teams.write",
+    "settings.users.write",
+    "tickets",
+    "tickets.highly_sensitive",
+    "tickets.sensitive",
+    "account-info.security.read",
+    "accounting",
+    "actions",
+    "analytics.behavioral_events.send",
+    "behavioral_events.event_definitions.read_write",
+    "business-intelligence",
+    "business_units_view.read",
+    "collector.graphql_query.execute",
+    "collector.graphql_schema.read",
+    "content",
+    "ctas.read",
+    "data_integration.data_source.file.read",
+    "data_integration.data_source.file.write",
+    "e-commerce",
+    "external_integrations.forms.access",
+    "files",
+    "files.ui_hidden.read",
+    "forms",
+    "forms-uploaded-files",
+    "hubdb",
+    "integration-sync",
+    "integrations.zoom-app.playbooks.read",
+    "marketing-email",
+    "mcp.users.read",
+    "media_bridge.read",
+    "media_bridge.write",
+    "oauth",
+    "origins.ip_ranges.webhook.read",
+    "origins.ip_ranges.webhook.write",
+    "record_images.signed_urls.read",
+    "sales-email-read",
+    "scheduler.meetings.meeting-link.read",
+    "social",
+    "tax_rates.read",
+    "timeline",
+    "transactional-email",
+];
+const ENGAGEMENT_SCOPE_NAMES = [
+    "crm.objects.calls.read",
+    "crm.objects.calls.write",
+    "crm.objects.emails.read",
+    "crm.objects.emails.write",
+    "crm.objects.meetings.read",
+    "crm.objects.meetings.write",
+    "crm.objects.notes.read",
+    "crm.objects.notes.write",
+    "crm.objects.tasks.read",
+    "crm.objects.tasks.write",
+];
+const SUPPLEMENTAL_SCOPE_NAMES = [
+    "crm.schemas.products.read",
+    "crm.schemas.products.write",
+];
+export const HUBSPOT_SCOPE_NAMES = uniqueSorted([
+    ...SUPPLIED_UI_SCOPE_NAMES,
+    ...ENGAGEMENT_SCOPE_NAMES,
+    ...SUPPLEMENTAL_SCOPE_NAMES,
+]);
+const DEPRECATED_SCOPES = new Set([
+    "accounting",
+    "actions",
+    "e-commerce",
+    "integration-sync",
+]);
+const SCOPE_NOTES = {
+    "automation": "Required for Workflows v4 (/automation/v4/flows).",
+    "forms": "Required for Marketing Forms v3.",
+    "forms-uploaded-files": "Required to download files submitted through forms.",
+    "sales-email-read": "Required to read one-to-one sales email engagement content.",
+    "settings.users.teams.write": "Team writes may still depend on endpoint availability and account permissions.",
+    "tickets": "Legacy broad tickets scope; granular ticket scopes may not appear in every private-app UI.",
+};
+export const HUBSPOT_SCOPE_CATALOG = HUBSPOT_SCOPE_NAMES.map((scope) => ({
+    scope,
+    category: inferCategory(scope),
+    access: inferAccess(scope),
+    sensitivity: inferSensitivity(scope),
+    deprecated: DEPRECATED_SCOPES.has(scope),
+    ...(SCOPE_NOTES[scope] ? { notes: SCOPE_NOTES[scope] } : {}),
+}));
+export const HUBSPOT_SCOPE_PRESETS = {
+    "track4": [
+        "crm.lists.read",
+        "crm.objects.companies.read",
+        "crm.objects.contacts.read",
+        "crm.objects.custom.read",
+        "crm.objects.deals.read",
+        "crm.objects.line_items.read",
+        "crm.objects.owners.read",
+        "crm.objects.products.read",
+        "crm.objects.quotes.read",
+        "crm.objects.subscriptions.read",
+        "crm.schemas.companies.read",
+        "crm.schemas.contacts.read",
+        "crm.schemas.custom.read",
+        "crm.schemas.deals.read",
+        "crm.schemas.line_items.read",
+        "crm.schemas.products.read",
+        "crm.schemas.quotes.read",
+        "crm.schemas.subscriptions.read",
+        "content",
+        "files",
+        "settings.users.read",
+        "settings.users.teams.read",
+        "tickets",
+    ],
+    "real-mirror-read": [
+        "automation",
+        "crm.export",
+        "crm.lists.read",
+        "crm.objects.calls.read",
+        "crm.objects.companies.read",
+        "crm.objects.contacts.read",
+        "crm.objects.custom.read",
+        "crm.objects.deals.read",
+        "crm.objects.emails.read",
+        "crm.objects.feedback_submissions.read",
+        "crm.objects.goals.read",
+        "crm.objects.invoices.read",
+        "crm.objects.leads.read",
+        "crm.objects.line_items.read",
+        "crm.objects.marketing_events.read",
+        "crm.objects.meetings.read",
+        "crm.objects.notes.read",
+        "crm.objects.orders.read",
+        "crm.objects.owners.read",
+        "crm.objects.products.read",
+        "crm.objects.quotes.read",
+        "crm.objects.subscriptions.read",
+        "crm.objects.tasks.read",
+        "crm.schemas.companies.read",
+        "crm.schemas.contacts.read",
+        "crm.schemas.custom.read",
+        "crm.schemas.deals.read",
+        "crm.schemas.invoices.read",
+        "crm.schemas.line_items.read",
+        "crm.schemas.orders.read",
+        "crm.schemas.products.read",
+        "crm.schemas.quotes.read",
+        "crm.schemas.subscriptions.read",
+        "content",
+        "files",
+        "files.ui_hidden.read",
+        "forms",
+        "forms-uploaded-files",
+        "sales-email-read",
+        "settings.currencies.read",
+        "settings.users.read",
+        "settings.users.teams.read",
+        "tickets",
+    ],
+    "real-mirror-write": [
+        "automation",
+        "crm.import",
+        "crm.lists.write",
+        "crm.objects.calls.write",
+        "crm.objects.companies.write",
+        "crm.objects.contacts.write",
+        "crm.objects.custom.write",
+        "crm.objects.deals.write",
+        "crm.objects.emails.write",
+        "crm.objects.goals.write",
+        "crm.objects.invoices.write",
+        "crm.objects.leads.write",
+        "crm.objects.line_items.write",
+        "crm.objects.marketing_events.write",
+        "crm.objects.meetings.write",
+        "crm.objects.notes.write",
+        "crm.objects.orders.write",
+        "crm.objects.products.write",
+        "crm.objects.quotes.write",
+        "crm.objects.subscriptions.write",
+        "crm.objects.tasks.write",
+        "crm.schemas.companies.write",
+        "crm.schemas.contacts.write",
+        "crm.schemas.custom.write",
+        "crm.schemas.deals.write",
+        "crm.schemas.invoices.write",
+        "crm.schemas.orders.write",
+        "crm.schemas.quotes.write",
+        "crm.schemas.subscriptions.write",
+        "content",
+        "files",
+        "forms",
+        "settings.currencies.write",
+        "settings.users.teams.write",
+        "settings.users.write",
+        "tickets",
+    ],
+};
+export function listScopePresetNames() {
+    return Object.keys(HUBSPOT_SCOPE_PRESETS).sort();
+}
+export function getScopeDefinition(scope) {
+    const wanted = scope.trim().toLowerCase();
+    return HUBSPOT_SCOPE_CATALOG.find((definition) => definition.scope.toLowerCase() === wanted);
+}
+export function parseScopeList(raw) {
+    if (Array.isArray(raw))
+        return uniqueSorted(raw);
+    if (!raw)
+        return [];
+    return uniqueSorted(raw.split(/[\s,]+/));
+}
+export function resolveScopeSet(raw) {
+    const name = raw?.trim() || "real-mirror-read";
+    const preset = HUBSPOT_SCOPE_PRESETS[name];
+    if (preset)
+        return { name, scopes: uniqueSorted(preset) };
+    return { name: "custom", scopes: parseScopeList(name) };
+}
+export function diffScopes(required, granted) {
+    const requiredSet = new Set(uniqueSorted(required));
+    const grantedSet = new Set(uniqueSorted(granted));
+    const catalogSet = new Set(HUBSPOT_SCOPE_NAMES.map((scope) => scope.toLowerCase()));
+    return {
+        required: [...requiredSet],
+        granted: [...grantedSet],
+        missing: [...requiredSet].filter((scope) => !grantedSet.has(scope)),
+        present: [...requiredSet].filter((scope) => grantedSet.has(scope)),
+        unknownGranted: [...grantedSet].filter((scope) => !catalogSet.has(scope)),
+        extraKnown: [...grantedSet].filter((scope) => catalogSet.has(scope) && !requiredSet.has(scope)),
+    };
+}
+function inferCategory(scope) {
+    if (scope.startsWith("crm.objects."))
+        return "crm.objects";
+    if (scope.startsWith("crm.schemas."))
+        return "crm.schemas";
+    if (scope.startsWith("crm.pipelines."))
+        return "crm.pipelines";
+    if (scope.startsWith("cms."))
+        return "cms";
+    if (scope.startsWith("automation."))
+        return "automation";
+    if (scope.startsWith("communication_preferences."))
+        return "communication_preferences";
+    if (scope.startsWith("conversations."))
+        return "conversations";
+    if (scope.startsWith("marketing."))
+        return "marketing";
+    if (scope.startsWith("settings."))
+        return "settings";
+    if (scope.includes("."))
+        return scope.split(".")[0];
+    return "platform";
+}
+function inferAccess(scope) {
+    if (scope.endsWith(".read_write") || scope.endsWith("_read_write"))
+        return "read_write";
+    if (scope.endsWith(".read") || scope.endsWith("_view.read") || scope.includes(".read."))
+        return "read";
+    if (scope.endsWith(".write") || scope.endsWith(".publish") || scope.endsWith(".create") || scope.includes(".write."))
+        return "write";
+    return "other";
+}
+function inferSensitivity(scope) {
+    if (scope.includes("highly_sensitive"))
+        return "highly_sensitive";
+    if (scope.includes("sensitive"))
+        return "sensitive";
+    return "standard";
+}
+function uniqueSorted(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean))).sort();
+}
+//# sourceMappingURL=scopes.js.map

package/dist/core/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../src/core/scopes.ts"],"names":[],"mappings":"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"}

package/dist/core/telemetry-context.d.ts

@@ -0,0 +1,13 @@
+export interface TelemetryContext {
+    toolName?: string;
+    changeTicket?: string;
+}
+export declare function runWithTelemetryContext<T>(ctx: TelemetryContext, fn: () => T): T;
+/**
+ * Extend the active telemetry context with additional fields (e.g. a
+ * changeTicket parsed from args after the outer toolName scope was set).
+ * Fields already present on the outer context are preserved unless
+ * overridden in `extra`.
+ */
+export declare function withTelemetryContext<T>(extra: TelemetryContext, fn: () => T): T;
+export declare function getTelemetryContext(): TelemetryContext | undefined;

package/dist/core/telemetry-context.js

@@ -0,0 +1,30 @@
+/**
+ * Per-invocation telemetry context.
+ *
+ * The MCP wrapper sets `toolName` at handler entry so trace/audit events can be
+ * attributed to the specific MCP tool that triggered the HTTP call.
+ * `changeTicket` is populated once the CLI/MCP layer has parsed it from args
+ * or env, so every subsequent request in the same async chain is tagged with
+ * the ops ticket for audit queries. Using AsyncLocalStorage (not process.env)
+ * because concurrent MCP invocations would otherwise race on a process-global
+ * env var and mis-attribute telemetry.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+const store = new AsyncLocalStorage();
+export function runWithTelemetryContext(ctx, fn) {
+    return store.run(ctx, fn);
+}
+/**
+ * Extend the active telemetry context with additional fields (e.g. a
+ * changeTicket parsed from args after the outer toolName scope was set).
+ * Fields already present on the outer context are preserved unless
+ * overridden in `extra`.
+ */
+export function withTelemetryContext(extra, fn) {
+    const current = store.getStore() ?? {};
+    return store.run({ ...current, ...extra }, fn);
+}
+export function getTelemetryContext() {
+    return store.getStore();
+}
+//# sourceMappingURL=telemetry-context.js.map

package/dist/core/telemetry-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-context.js","sourceRoot":"","sources":["../../src/core/telemetry-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAExD,MAAM,UAAU,uBAAuB,CAAI,GAAqB,EAAE,EAAW;IAC3E,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAI,KAAuB,EAAE,EAAW;IAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/mcp/ext-tools.d.ts

@@ -9,7 +9,7 @@
  *   ── Files ──
  *   - files_list, files_get, files_delete, files_signed_url
  *   ── Forms ──
- *   - forms_list, forms_get, forms_submissions, forms_submit
+ *   - forms_list, forms_get, forms_create, forms_update, forms_submissions, forms_submit
  *   ── Webhooks ──
  *   - webhooks_list_subscriptions, webhooks_create_subscription, webhooks_delete_subscription
  *   ── Marketing emails ──

package/dist/mcp/ext-tools.js

@@ -9,7 +9,7 @@
  *   ── Files ──
  *   - files_list, files_get, files_delete, files_signed_url
  *   ── Forms ──
- *   - forms_list, forms_get, forms_submissions, forms_submit
+ *   - forms_list, forms_get, forms_create, forms_update, forms_submissions, forms_submit
  *   ── Webhooks ──
  *   - webhooks_list_subscriptions, webhooks_create_subscription, webhooks_delete_subscription
  *   ── Marketing emails ──
@@ -22,7 +22,29 @@
  */
 import { z } from "zod";
 import { appendOptional, encodePathSegment, maybeWrite, parseNumberFlag } from "../commands/crm/shared.js";
+import { normalizeFormPayloadForV3 } from "../commands/forms/legacy-v2.js";
+import { loadTargetFormPropertyNames, preflightLegacyFormProperties, shouldRunFormPropertyPreflight, } from "../commands/forms/property-preflight.js";
 import { baseArgsSchema, executeTool, registerMcpTool } from "./server.js";
+async function prepareMcpFormBody(ctx, client, args) {
+    let payload = args.data;
+    const sourceFormat = args.sourceFormat ?? "auto";
+    const preflightMode = args.strict ? "strict" : (args.propertyPreflight ?? "auto");
+    let skippedFields = [];
+    if (sourceFormat !== "v3" && shouldRunFormPropertyPreflight(payload, preflightMode, ctx.dryRun)) {
+        const preflight = await preflightLegacyFormProperties(payload, (objectType) => loadTargetFormPropertyNames(client, objectType), preflightMode === "strict");
+        payload = preflight.payload;
+        skippedFields = preflight.skippedFields;
+    }
+    return {
+        body: normalizeFormPayloadForV3(payload, sourceFormat),
+        skippedFields,
+    };
+}
+function attachSkippedFields(result, skippedFields) {
+    if (skippedFields.length === 0)
+        return result;
+    return { result, skippedFields };
+}
 export function registerExtensionTools(server) {
     // ═══════════════════════════════════════════════════════════════════════
     // Workflows (v4 + legacy v3)
@@ -120,6 +142,35 @@ export function registerExtensionTools(server) {
         description: "Get one form by ID. Not available via HubSpot Remote MCP.",
         inputSchema: { ...baseArgsSchema, formId: z.string().min(1) },
     }, (args) => executeTool(args, (_ctx, client) => client.request(`/marketing/v3/forms/${encodePathSegment(args.formId, "formId")}`)));
+    registerMcpTool(server, "forms_create", {
+        description: "Create a marketing form. Legacy forms/v2 payloads are translated to v3 automatically. Dry-run by default unless force=true.",
+        inputSchema: {
+            ...baseArgsSchema,
+            data: z.record(z.string(), z.unknown()),
+            sourceFormat: z.enum(["auto", "v2", "v3"]).default("auto").optional(),
+            propertyPreflight: z.enum(["auto", "skip", "strict"]).default("auto").optional(),
+            strict: z.boolean().optional().describe("Fail when target-property preflight finds missing legacy form fields"),
+        },
+    }, (args) => executeTool(args, async (ctx, client) => {
+        const { body, skippedFields } = await prepareMcpFormBody(ctx, client, args);
+        const result = await maybeWrite(ctx, client, "POST", "/marketing/v3/forms", body);
+        return attachSkippedFields(result, skippedFields);
+    }));
+    registerMcpTool(server, "forms_update", {
+        description: "Update a marketing form. Legacy forms/v2 payloads are translated to v3 automatically. Dry-run by default unless force=true.",
+        inputSchema: {
+            ...baseArgsSchema,
+            formId: z.string().min(1),
+            data: z.record(z.string(), z.unknown()),
+            sourceFormat: z.enum(["auto", "v2", "v3"]).default("auto").optional(),
+            propertyPreflight: z.enum(["auto", "skip", "strict"]).default("auto").optional(),
+            strict: z.boolean().optional().describe("Fail when target-property preflight finds missing legacy form fields"),
+        },
+    }, (args) => executeTool(args, async (ctx, client) => {
+        const { body, skippedFields } = await prepareMcpFormBody(ctx, client, args);
+        const result = await maybeWrite(ctx, client, "PATCH", `/marketing/v3/forms/${encodePathSegment(args.formId, "formId")}`, body);
+        return attachSkippedFields(result, skippedFields);
+    }));
     registerMcpTool(server, "forms_submissions", {
         description: "List submissions for a form. Not available via HubSpot Remote MCP.",
         inputSchema: {