@clipform/mcp-server 4.2.8 → 4.3.2

package/dist/api-client.js

@@ -6,7 +6,7 @@ import {
   recoveryHint,
   structuredResult,
   textResult
-} from "./chunk-UMO47NOJ.js";
+} from "./chunk-NCL5EEMF.js";
 import "./chunk-BV3KA6HC.js";
 import "./chunk-PBQ5BQWD.js";
 import "./chunk-PZ5AY32C.js";

package/dist/{chunk-HIKPHBFH.js → chunk-CRLRAJOY.js}

@@ -29,7 +29,7 @@ import {
   union,
   unknown,
   url
-} from "./chunk-S7PD574X.js";
+} from "./chunk-UOLHW53C.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -38,7 +38,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-OVLNACRG.js";
+} from "./chunk-VOR3EFCP.js";
 import {
   ANON_PREVIEW_LINK_LABEL,
   ANON_PREVIEW_NOTICE,
@@ -50,7 +50,7 @@ import {
   capsFromToolsets,
   isPreviewViewerUrl,
   withAdoptedNotice
-} from "./chunk-75X4S4LA.js";
+} from "./chunk-ZAPU4K7I.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
@@ -68,11 +68,13 @@ import {
   defaultTarget,
   errorResult,
   exposedCompositionIds,
+  gatedConfigKeys,
   isAnonymousAccountRequired,
   resolveFormType,
+  stripGatedConfigKeys,
   structuredResult,
   textResult
-} from "./chunk-UMO47NOJ.js";
+} from "./chunk-NCL5EEMF.js";
 import {
   getMcpAuth,
   runWithMcpAuth,
@@ -16111,8 +16113,10 @@ var CONTACT_FIELD_IDS = CONTACT_FIELDS.map(
 function generateConfigSummary(configSchema, typeKey) {
   if (!configSchema?.properties) return "";
   const parts = [];
+  const gated = typeKey ? gatedConfigKeys(typeKey) : /* @__PURE__ */ new Set();
   for (const [key, prop] of Object.entries(configSchema.properties)) {
     if (key === "content_media_type") continue;
+    if (gated.has(key)) continue;
     if (!FEATURE_FLAGS.ENABLE_CUSTOM_SCORES && CUSTOM_SCORES_GATED_KEYS.has(key)) continue;
     if (prop.enum) {
       const vals = prop.enum.map((v) => `"${v}"`).join("|");
@@ -16247,6 +16251,24 @@ var NodeSchema = external_exports.object({
   config: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(CONFIG_FIELD_DESCRIPTION),
   options: external_exports.array(OptionSchema).optional().describe(OPTIONS_DESCRIPTION)
 }).superRefine((node, ctx) => refineNodeOptions(ctx, node.type, node.options, []));
+function stripGatedNodeConfig(node) {
+  const { config, dropped } = stripGatedConfigKeys(node.type, node.config);
+  if (dropped.length > 0) node.config = config;
+  return dropped;
+}
+function gatedConfigKeysOnEveryType() {
+  const gatedBy = /* @__PURE__ */ new Map();
+  for (const [type, def] of Object.entries(NODE_TYPES)) {
+    const gated = gatedConfigKeys(type);
+    for (const key of Object.keys(def.config_schema?.properties ?? {})) {
+      gatedBy.set(key, (gatedBy.get(key) ?? true) && gated.has(key));
+    }
+  }
+  return new Set([...gatedBy].filter(([, g]) => g).map(([k]) => k));
+}
+function ignoredConfigNote(keys) {
+  return `Ignored unsupported config key(s): ${keys.join(", ")}.`;
+}
 function applyNodeDefaults(node) {
   const def = NODE_TYPES[node.type];
   if (node.type === "button" && (!node.options || node.options.length === 0)) {
@@ -16431,8 +16453,11 @@ Example: A form that asks a question, collects contact info, then finishes:
           }
         }
       }
+      const ignoredNotes = [];
       for (const q of nodes) {
         applyNodeDefaults(q);
+        const dropped = stripGatedNodeConfig(q);
+        if (dropped.length > 0) ignoredNotes.push(`[${q.type}] ${ignoredConfigNote(dropped)}`);
       }
       const settings = {};
       if (show_step_counter !== void 0) settings.show_step_counter = show_step_counter;
@@ -16495,6 +16520,7 @@ Example: A form that asks a question, collects contact info, then finishes:
           isPreview ? `CLAIM URL (fallback - or open this one-time link to sign up in the browser): ${formUrl}` : `DASHBOARD URL (sign in to edit and manage): ${formUrl}`
         );
       }
+      if (ignoredNotes.length > 0) lines.push(``, ...ignoredNotes);
       const firstUrlLabel = isPreview ? "PREVIEW" : "FORM";
       const secondUrlLabel = isPreview ? "CLAIM" : "DASHBOARD";
       lines.push(
@@ -16871,7 +16897,10 @@ function registerListFormsTool(server, caps = FULL_CAPS) {
 function allowedConfigKeys(nodeType) {
   const schema = NODE_TYPES[nodeType]?.config_schema;
   const properties = schema?.properties;
-  if (properties) return new Set(Object.keys(properties));
+  if (properties) {
+    const gated = gatedConfigKeys(nodeType);
+    return new Set(Object.keys(properties).filter((k) => !gated.has(k)));
+  }
   const oneOf = schema?.oneOf;
   if (Array.isArray(oneOf)) {
     const keys = /* @__PURE__ */ new Set();
@@ -17097,6 +17126,7 @@ function registerUpdateFormTool(server) {
         logo_url: external_exports.string().nullable().optional().describe("AI-PROTECTED: Only set when the user explicitly provides a logo URL. Set null to clear."),
         show_branding: external_exports.boolean().optional().describe("Show Clipform branding. Set false to remove (Pro plan)."),
         brand_name: external_exports.string().nullable().optional().describe("AI-PROTECTED: Custom brand name shown in footer. Only set when user explicitly provides."),
+        cover_media_asset_id: external_exports.string().uuid().nullable().optional().describe("Cover image: the picture shown in emails, link previews and on the embed button, cropped to the form's 9:16 frame. A media_asset_id of a ready still image in this form's workspace. Set null to clear and fall back to the first step's media. Goes live on the next publish (is_live: true), which can be in the same call."),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace all tags on this form. Pass the full desired set (e.g. ['quiz', 'trivia', 'slug:elephants']). Omit to leave tags unchanged.")
       }),
       outputSchema: external_exports.object({
@@ -17115,7 +17145,7 @@ function registerUpdateFormTool(server) {
         openWorldHint: true
       }
     },
-    async ({ form_id, title, is_live, show_step_counter, disable_back_navigation, total_steps, primary_color, background_color, font_family, description, author, logo_url, show_branding, brand_name, tags }) => {
+    async ({ form_id, title, is_live, show_step_counter, disable_back_navigation, total_steps, primary_color, background_color, font_family, description, author, logo_url, show_branding, brand_name, cover_media_asset_id, tags }) => {
       const body = {};
       if (title !== void 0) body.title = title;
       if (is_live !== void 0) body.is_live = is_live;
@@ -17130,6 +17160,7 @@ function registerUpdateFormTool(server) {
       if (logo_url !== void 0) body.logo_url = logo_url;
       if (show_branding !== void 0) body.show_branding = show_branding;
       if (brand_name !== void 0) body.brand_name = brand_name;
+      if (cover_media_asset_id !== void 0) body.cover_media_asset_id = cover_media_asset_id;
       if (Object.keys(body).length > 0) {
         const result = await callApi(`/forms/${form_id}`, {
           method: "PATCH",
@@ -17208,6 +17239,10 @@ function registerUpdateFormTool(server) {
         updates.push(`Brand name \u2192 ${brand_name === null ? "cleared" : `"${brand_name}"`}`);
         updatedFields.push("brand_name");
       }
+      if (cover_media_asset_id !== void 0) {
+        updates.push(`Cover image \u2192 ${cover_media_asset_id === null ? "cleared" : `set (${cover_media_asset_id})`}`);
+        updatedFields.push("cover_media_asset_id");
+      }
       if (tags) {
         updates.push(`Tags \u2192 [${tags.join(", ")}]`);
         updatedFields.push("tags");
@@ -17744,6 +17779,7 @@ function registerAddNodeTool(server) {
     },
     async ({ form_id, node, after_node_id }) => {
       applyNodeDefaults(node);
+      const droppedKeys = stripGatedNodeConfig(node);
       const body = { node };
       if (after_node_id) body.after_node_id = after_node_id;
       const result = await callApi(`/forms/${form_id}/nodes`, {
@@ -17757,7 +17793,7 @@ function registerAddNodeTool(server) {
       const warnings = result.data.warnings ?? [];
       const relinkNote = warnings.length > 0 ? ` ${warnings.join(" ")}` : " The logic chain was automatically re-linked - no clipform_set_logic call is needed for this insert.";
       return structuredResult(
-        `Node added. ID: ${nodeId} | Type: ${node.type}.${relinkNote}`,
+        `Node added. ID: ${nodeId} | Type: ${node.type}.${relinkNote}${droppedKeys.length > 0 ? ` ${ignoredConfigNote(droppedKeys)}` : ""}`,
         { node_id: nodeId, type: node.type }
       );
     }
@@ -17815,7 +17851,18 @@ function registerUpdateNodeTool(server) {
     async ({ form_id, updates }) => {
       const allLines = [];
       const results = [];
-      for (const { node_id, prompt, label, type, required, config, options } of updates) {
+      for (const { node_id, prompt, label, type, required, config: rawConfig, options } of updates) {
+        let config = rawConfig;
+        let droppedKeys = [];
+        if (rawConfig !== void 0) {
+          if (type !== void 0) {
+            ({ config, dropped: droppedKeys } = stripGatedConfigKeys(type, rawConfig));
+          } else {
+            const gated = gatedConfigKeysOnEveryType();
+            droppedKeys = Object.keys(rawConfig).filter((k) => gated.has(k));
+            if (droppedKeys.length > 0) config = Object.fromEntries(Object.entries(rawConfig).filter(([k]) => !gated.has(k)));
+          }
+        }
         const body = {};
         if (prompt !== void 0) body.prompt = prompt;
         if (label !== void 0) body.label = label;
@@ -17841,11 +17888,14 @@ function registerUpdateNodeTool(server) {
         if (options !== void 0)
           changes.push(`Options \u2192 ${options.map((o) => o.content).join(", ")}`);
         allLines.push(`Node ${node_id} updated: ${changes.join(", ")}`);
-        const warnings = result.data.warnings;
-        if (warnings?.length) {
+        const warnings = [
+          ...result.data.warnings ?? [],
+          ...droppedKeys.length > 0 ? [ignoredConfigNote(droppedKeys)] : []
+        ];
+        if (warnings.length) {
           for (const w of warnings) allLines.push(`Node ${node_id} warning: ${w}`);
         }
-        results.push({ node_id, ok: true, ...warnings?.length ? { warnings } : {} });
+        results.push({ node_id, ok: true, ...warnings.length ? { warnings } : {} });
       }
       return structuredResult(allLines.join("\n"), { results });
     }
@@ -20213,4 +20263,4 @@ export {
   * MIT Licensed
   *)
 */
-//# sourceMappingURL=chunk-HIKPHBFH.js.map
+//# sourceMappingURL=chunk-CRLRAJOY.js.map