@clipform/mcp-server 1.44.4 → 1.46.0

package/README.md

@@ -59,7 +59,7 @@ You can also pass the key as a CLI flag: `npx -y @clipform/mcp-server --api-key=
 
 ## Tools
 
-Your MCP client lists these automatically on connect (via `tools/list`). Full reference - arguments, schemas, and examples - is in the [docs](https://clipform.io/docs/guides/mcp).
+Your MCP client lists these automatically on connect (via `tools/list`). Full reference - arguments, schemas, and examples - is in the [docs](https://clipform.io/docs/api/mcp).
 
 | Tool | Description |
 |------|-------------|
@@ -107,6 +107,6 @@ Forms are created with a start node and end screen automatically - you just add
 ## Links
 
 - [Clipform](https://clipform.io) - Create interactive video forms
-- [Documentation](https://clipform.io/docs/guides/mcp) - Full guide with node types and more
+- [Documentation](https://clipform.io/docs/api/mcp) - Full guide with node types and more
 
 > Craft guides (`clipform://guides/*`, `clipform_get_guide`) are fetched from the Clipform API at runtime, so the server needs a reachable `API_URL` and valid `CLIPFORM_API_KEY` to serve them.

package/dist/{chunk-PCCTN3T7.js → chunk-AHWMH66L.js}

@@ -36,6 +36,14 @@ var FEATURES = {
   branching: {
     name: "Conditional branching",
     description: "Choice nodes route to different destinations based on which option is picked",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-25",
+    category: "builder"
+  },
+  funnel: {
+    name: "Lead qualification funnels",
+    description: "Multi-step funnels with conditional routing built on branching",
     enabled: false,
     status: "planned",
     category: "builder"
@@ -54,6 +62,13 @@ var FEATURES = {
     status: "planned",
     category: "builder"
   },
+  multi_select: {
+    name: "Multi-select choices",
+    description: "Pick-all-that-apply choice questions (checkbox-style selection)",
+    enabled: false,
+    status: "planned",
+    category: "builder"
+  },
   custom_fonts: {
     name: "Custom fonts",
     description: "Upload and use custom fonts in forms",
@@ -85,7 +100,7 @@ var FEATURES = {
   },
   node_choice: {
     name: "Multiple choice",
-    description: "Single or multi-select questions with configurable options",
+    description: "Single-select questions with configurable options (multi-select is gated by the multi_select feature)",
     enabled: true,
     status: "live",
     category: "node-types"
@@ -146,6 +161,16 @@ var FEATURES = {
     status: "planned",
     category: "node-types"
   },
+  node_draw: {
+    name: "Drawing",
+    description: "Drawing canvas; respondents draw and it is saved as a PNG image",
+    // Live (#1012): builder picker shows it, the API accepts it, the viewer renders
+    // the canvas, and dashboard results render the saved PNG (#1012 results pass).
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-27",
+    category: "node-types"
+  },
   node_payment: {
     name: "Payment",
     description: "Collect payments via Stripe or Paddle inline",
@@ -237,6 +262,7 @@ var FEATURES = {
     description: "Export response data to CSV, including transcriptions and media links",
     enabled: true,
     status: "live",
+    wentLiveAt: "2026-06-07",
     category: "analytics"
   },
   tracked_links: {
@@ -266,6 +292,7 @@ var FEATURES = {
     description: "Embed forms on external websites via script tag or JavaScript API",
     enabled: true,
     status: "live",
+    wentLiveAt: "2026-05-27",
     category: "sharing"
   },
   embed_widget: {
@@ -315,16 +342,18 @@ var FEATURES = {
   api_keys: {
     name: "API key management",
     description: "Self-service API key creation in the dashboard",
-    enabled: false,
-    status: "planned",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-22",
     category: "api"
   },
   // -- Integrations --
   webhooks: {
     name: "Webhooks",
     description: "Send response data to external URLs on form completion",
-    enabled: false,
-    status: "planned",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-24",
     category: "integrations"
   },
   // Per-integration lifecycle (split from the old coarse `integrations` flag so
@@ -375,15 +404,25 @@ var FEATURES = {
   integration_zapier: {
     name: "Zapier",
     description: "Connect to 5,000+ apps and automate workflows",
-    enabled: false,
-    status: "planned",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-21",
     category: "integrations"
   },
   integration_make: {
     name: "Make",
     description: "Advanced automation and integrations",
-    enabled: false,
-    status: "planned",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-22",
+    category: "integrations"
+  },
+  integration_n8n: {
+    name: "n8n",
+    description: "Open-source workflow automation - trigger flows on form responses",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-06-26",
     category: "integrations"
   },
   integration_hubspot: {
@@ -414,6 +453,13 @@ var FEATURES = {
     status: "planned",
     category: "integrations"
   },
+  integration_google_sheets: {
+    name: "Google Sheets",
+    description: "Sync form responses to a Google Sheet, one row per submission",
+    enabled: false,
+    status: "planned",
+    category: "integrations"
+  },
   notifications: {
     name: "Response notifications",
     description: "Email or webhook alerts when new responses arrive",
@@ -436,6 +482,22 @@ var FEATURES = {
     category: "integrations"
   }
 };
+for (const [key, f] of Object.entries(FEATURES)) {
+  if (f.status === "live" && !f.enabled) {
+    throw new Error(`FEATURES.${key}: status 'live' requires enabled:true (shipped features must be exposed)`);
+  }
+  if (f.status === "planned" && f.enabled) {
+    throw new Error(`FEATURES.${key}: status 'planned' requires enabled:false (planned features must not be exposed)`);
+  }
+  if (f.wentLiveAt !== void 0) {
+    if (f.status === "planned") {
+      throw new Error(`FEATURES.${key}: wentLiveAt set but status is 'planned' (only shipped features have a go-live date)`);
+    }
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(f.wentLiveAt)) {
+      throw new Error(`FEATURES.${key}: wentLiveAt must be 'YYYY-MM-DD' (got ${JSON.stringify(f.wentLiveAt)})`);
+    }
+  }
+}
 
 // ../config/node-types.js
 var RESPONSE_FORMATS = ["text", "audio", "video"];
@@ -483,9 +545,10 @@ var NODE_TYPES = {
     show_in_results: true,
     default_config: {
       selection_mode: "single",
-      choice: { enable_branching: true, record_scores: false },
+      choice: { enable_branching: false, record_scores: false },
       randomise_options: false,
       show_option_count: false,
+      option_display: "list",
       options: [
         { content: "Option 1" },
         { content: "Option 2" }
@@ -522,13 +585,13 @@ var NODE_TYPES = {
           type: "string",
           label: "Selection mode",
           default: "single",
-          description: "Allow single or multiple selections"
+          description: 'Allow single or multiple selections. "multiple" is gated by the multi_select feature - while it is off, the API coerces it to "single" (the viewer renders single-select only).'
         },
         allow_text_response: {
           type: "boolean",
           label: "Allow text response",
           default: false,
-          description: "Allow free-text response in addition to options (single choice only)"
+          description: "Allow free-text response in addition to options (single choice only). Gated by the text_response feature - while it is off, the API coerces it to false (the viewer renders no free-text field yet)."
         },
         randomise_options: {
           type: "boolean",
@@ -542,6 +605,13 @@ var NODE_TYPES = {
           default: false,
           description: "Display number of options"
         },
+        option_display: {
+          enum: ["list", "letters"],
+          type: "string",
+          label: "Option display",
+          default: "list",
+          description: "How options render: full text rows (list), or compact A/B/C/D chips (letters) when the media already shows the labelled options - e.g. a Grid background"
+        },
         content_media_type: {
           enum: ["upload", "recorded"],
           type: "string",
@@ -556,9 +626,9 @@ var NODE_TYPES = {
     },
     output_schema: {
       type: "object",
-      required: ["type", "label", "option_id"],
+      required: ["node_type", "label", "option_id"],
       properties: {
-        type: { type: "string", const: "choice" },
+        node_type: { type: "string", const: "choice" },
         label: { type: "string", description: "Human-readable option label" },
         option_id: { type: "string", format: "uuid", description: "Selected option UUID" }
       }
@@ -654,32 +724,36 @@ var NODE_TYPES = {
     },
     output_schema: {
       type: "object",
-      required: ["type"],
+      required: ["node_type"],
       properties: {
-        type: { type: "string", const: "text" },
+        node_type: { type: "string", const: "open" },
         text: { type: "string", description: "Text response or transcription" },
         media: {
           type: "object",
           properties: {
             type: { enum: ["audio", "video"], type: "string" },
-            storage_path: { type: "string" },
-            facing_mode: { enum: ["user", "environment"], type: "string" },
-            preview_crop: {
-              type: "object",
-              properties: {
-                stream_width: { type: "number" },
-                stream_height: { type: "number" },
-                preview_width: { type: "number" },
-                preview_height: { type: "number" }
-              }
-            }
+            // Direct, time-limited signed URL to the recording (~48h, supports
+            // HTTP range); minted per delivery, never the internal storage path.
+            url: { type: "string", format: "uri" }
           }
         },
         transcription: {
           type: "object",
           properties: {
             text: { type: "string" },
-            language: { type: "string" }
+            language: { type: "string" },
+            segments: {
+              type: "array",
+              description: "Timestamped segments (seconds) for captions/seeking.",
+              items: {
+                type: "object",
+                properties: {
+                  start: { type: "number" },
+                  end: { type: "number" },
+                  text: { type: "string" }
+                }
+              }
+            }
           }
         }
       }
@@ -809,6 +883,10 @@ var NODE_TYPES = {
     supports_media: false,
     is_system: false,
     show_in_results: false,
+    // Excluded from the aggregate Results charts (a list of emails can't be
+    // charted) but DOES show in the per-response Responses table, where each
+    // lead's contact fields are actionable (#746).
+    show_in_responses: true,
     default_config: {
       fields: [
         { id: "first_name", type: "first_name", label: "First Name", enabled: true, required: true },
@@ -892,9 +970,9 @@ var NODE_TYPES = {
     },
     output_schema: {
       type: "object",
-      required: ["type", "fields"],
+      required: ["node_type", "fields"],
       properties: {
-        type: { type: "string", const: "contact" },
+        node_type: { type: "string", const: "contact" },
         fields: {
           type: "array",
           items: {
@@ -972,6 +1050,74 @@ var NODE_TYPES = {
     },
     output_schema: null
   },
+  draw: {
+    label: "Drawing",
+    shorthand: "Draw",
+    icon: "Pencil",
+    color: "#FEF3C7",
+    description: "Drawing canvas; respondents draw and it is saved as a PNG image",
+    category: "input",
+    sort_order: 6.5,
+    has_options: false,
+    is_terminal: false,
+    show_nav_bar: true,
+    loading: "lazy",
+    supports_prompt: false,
+    supports_media: false,
+    is_system: false,
+    show_in_results: true,
+    default_config: {
+      paper_color: "#FAF9F6",
+      stroke_colors: ["#1F2937", "#EF4444", "#3B82F6", "#22C55E", "#FACC15"],
+      stroke_widths: [3, 6, 12]
+    },
+    config_schema: {
+      type: "object",
+      properties: {
+        paper_color: { type: "string", label: "Paper colour", default: "#FAF9F6", description: "Canvas background colour (off-white paper by default)" },
+        stroke_colors: {
+          type: "array",
+          items: { type: "string" },
+          minItems: 1,
+          maxItems: 8,
+          label: "Pen colours",
+          default: ["#1F2937", "#EF4444", "#3B82F6", "#22C55E", "#FACC15"],
+          description: "Colour swatches the respondent can draw with"
+        },
+        stroke_widths: {
+          type: "array",
+          items: { type: "number", minimum: 1, maximum: 60 },
+          minItems: 1,
+          maxItems: 5,
+          label: "Pen thicknesses",
+          default: [3, 6, 12],
+          description: "Stroke widths (px) the respondent can choose"
+        }
+      }
+    },
+    response_schema: {
+      // Mirrors the live `open` node's media response shape (the only complete
+      // media path): the sketch image is uploaded to the `media-responses`
+      // bucket via the same upload-client pipeline and referenced by
+      // storage_path. Exported as PNG (crisp line art); the off-white paper
+      // background is composited in before export so it is baked into the file.
+      type: "object",
+      required: ["media"],
+      properties: {
+        media: {
+          type: "object",
+          required: ["storage_path", "type"],
+          properties: {
+            type: { enum: ["image"], type: "string", description: 'Always "image" for a sketch' },
+            storage_path: { type: "string", description: "Path in the media-responses bucket: bucket/workspace_id/.../uuid.png" },
+            mime_type: { type: "string", description: "Image MIME type (image/png)" }
+          },
+          description: "The exported sketch, stored as a single image in media-responses"
+        }
+      }
+    },
+    output_schema: null
+  },
   payment: {
     label: "Payment",
     shorthand: "Payment",
@@ -1073,7 +1219,7 @@ var NODE_TYPES = {
     is_system: false,
     show_in_results: true,
     default_config: {
-      choice: { enable_branching: true },
+      choice: { enable_branching: false },
       options: [
         { content: "Yes" },
         { content: "No" }
@@ -1107,9 +1253,9 @@ var NODE_TYPES = {
     },
     output_schema: {
       type: "object",
-      required: ["type", "label", "option_id"],
+      required: ["node_type", "label", "option_id"],
       properties: {
-        type: { type: "string", const: "binary" },
+        node_type: { type: "string", const: "binary" },
         label: { type: "string", description: "Human-readable option label" },
         option_id: { type: "string", format: "uuid", description: "Selected option UUID" }
       }
@@ -1148,9 +1294,9 @@ var NODE_TYPES = {
     },
     output_schema: {
       type: "object",
-      required: ["type", "label", "option_id"],
+      required: ["node_type", "label", "option_id"],
       properties: {
-        type: { type: "string", const: "button" },
+        node_type: { type: "string", const: "button" },
         label: { type: "string", description: "Human-readable option label" },
         option_id: { type: "string", format: "uuid", description: "Selected option UUID" }
       }
@@ -1430,6 +1576,7 @@ for (const [type, def] of Object.entries(NODE_TYPES)) {
   def.is_active = feature.enabled;
 }
 var NODE_TYPES_LIST = Object.entries(NODE_TYPES).map(([type, def]) => ({ type, ...def })).sort((a, b) => a.sort_order - b.sort_order);
+var ACTIVE_NODE_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.is_active && !def.is_system).map(([type]) => type);
 var NODE_TYPE_KEYS = Object.keys(NODE_TYPES);
 var RESPONSE_SCHEMAS = Object.fromEntries(
   Object.entries(NODE_TYPES).map(([k, v]) => [k, v.response_schema])
@@ -1454,6 +1601,9 @@ var TERMINAL_TYPES = Object.entries(NODE_TYPES).filter(([, v]) => v.is_terminal)
 var NON_COUNTABLE_TYPES = Object.entries(NODE_TYPES).filter(([, v]) => v.is_system || v.is_terminal).map(([k]) => k);
 var NON_COUNTABLE_FILTER = `(${NON_COUNTABLE_TYPES.map((t) => `"${t}"`).join(",")})`;
 var RESULTS_EXCLUDED_TYPES = Object.entries(NODE_TYPES).filter(([, v]) => !v.show_in_results).map(([k]) => k);
+var NON_STEP_TYPES = /* @__PURE__ */ new Set(["button"]);
+var STEP_COUNTED_TYPES = Object.entries(NODE_TYPES).filter(([k, v]) => v.show_nav_bar && !NON_STEP_TYPES.has(k)).map(([k]) => k);
+var RESPONSES_EXCLUDED_TYPES = Object.entries(NODE_TYPES).filter(([, v]) => !(v.show_in_responses ?? v.show_in_results)).map(([k]) => k);
 
 // ../config/form-types.js
 var FORM_TYPES = {
@@ -1552,7 +1702,7 @@ var FORM_TYPES = {
     category: "qualification",
     aliases: ["lead-gen", "qualification", "lead-magnet"],
     variants: [],
-    required_features: ["branching"],
+    required_features: ["branching", "funnel"],
     required_node_types: ["choice", "contact", "end_screen"],
     default_media_style: "text",
     guide_uri: "clipform://guides/funnel",
@@ -1666,11 +1816,11 @@ function getDiscoveryParams(formType, variant, mode = "full") {
 
 // ../config/help-links.js
 var HELP_TOPICS = {
-  goLive: { path: "/guides/sharing", anchor: "go-live" },
-  cantGoLive: { path: "/guides/sharing", anchor: "cant-go-live" },
-  liveAndDraft: { path: "/guides/managing-forms", anchor: "live-and-draft" },
-  publishingChanges: { path: "/guides/managing-forms", anchor: "publishing-changes" },
-  embedding: { path: "/guides/embed", anchor: null }
+  goLive: { path: "/help/sharing", anchor: "go-live" },
+  cantGoLive: { path: "/help/sharing", anchor: "cant-go-live" },
+  liveAndDraft: { path: "/help/managing-forms", anchor: "live-and-draft" },
+  publishingChanges: { path: "/help/managing-forms", anchor: "publishing-changes" },
+  embedding: { path: "/help/embed", anchor: null }
 };
 function buildHelpLinks(docsBaseUrl) {
   const links = {};
@@ -1693,10 +1843,27 @@ var ENV = {
 };
 var COOKIE_DOMAIN = ENV.isDevelopment ? void 0 : ".clipform.io";
 var isTunnelBrowser = isBrowser && window.location.hostname.endsWith(".smith-forge.com");
+var PROD_URLS = {
+  marketing: "https://www.clipform.io",
+  // Dedicated CDN host for the embed SDK, decoupled from the marketing deploy
+  // (ships in seconds via packages/embed-sdk `deploy:cf`). www.clipform.io/embed.js
+  // stays as the legacy bridge until all installs migrate here.
+  embed: "https://js.clipform.io",
+  dashboard: "https://app.clipform.io",
+  viewer: "https://clipform.io",
+  api: "https://api.clipform.io",
+  // Dedicated subdomain for the remote MCP server. Same Render service
+  // as `api`, just routed by Host header. Token audience is bound here.
+  mcp: "https://mcp.clipform.io",
+  docs: "https://clipform.io/docs"
+};
 function getUrls() {
   if (isTunnelBrowser) {
     return {
       marketing: "https://marketing-dev.smith-forge.com",
+      // Dev/tunnel: the marketing dev server 308-redirects /embed.js to js.clipform.io
+      // (public/embed.js was retired in #1288), so embeds load the live SDK.
+      embed: "https://marketing-dev.smith-forge.com",
       dashboard: "https://dashboard-dev.smith-forge.com",
       viewer: "https://viewer-dev.smith-forge.com",
       api: "https://api-dev.smith-forge.com",
@@ -1708,6 +1875,9 @@ function getUrls() {
     const api = process.env.NEXT_PUBLIC_API_URL || "http://localhost:3003";
     return {
       marketing: process.env.NEXT_PUBLIC_MARKETING_URL || "http://localhost:3002",
+      // Local: the marketing dev server redirects /embed.js to js.clipform.io
+      // (public/embed.js was retired in #1288), so embeds load the live SDK.
+      embed: process.env.NEXT_PUBLIC_MARKETING_URL || "http://localhost:3002",
       dashboard: process.env.NEXT_PUBLIC_DASHBOARD_URL || "http://localhost:3000",
       viewer: process.env.NEXT_PUBLIC_VIEWER_URL || "http://localhost:3001",
       api,
@@ -1718,16 +1888,7 @@ function getUrls() {
       docs: process.env.NEXT_PUBLIC_DOCS_URL || "http://localhost:3004/docs"
     };
   }
-  return {
-    marketing: "https://www.clipform.io",
-    dashboard: "https://app.clipform.io",
-    viewer: "https://clipform.io",
-    api: "https://api.clipform.io",
-    // Dedicated subdomain for the remote MCP server. Same Render service
-    // as `api`, just routed by Host header. Token audience is bound here.
-    mcp: "https://mcp.clipform.io",
-    docs: "https://clipform.io/docs"
-  };
+  return { ...PROD_URLS };
 }
 var BUSINESS = {
   name: "Clipform",
@@ -1742,6 +1903,7 @@ var BUSINESS = {
   },
   urls: getUrls()
 };
+var MEDIA_DIRECT_MAX_BYTES = 10 * 1024 * 1024;
 var HELP_LINKS = buildHelpLinks(BUSINESS.urls.docs);
 var CONTACT_FIELDS = [
   { id: "first_name", label: "First Name", type: "text", placeholder: "Enter first name", order: 1 },
@@ -1804,11 +1966,7 @@ var COMPOSITION_REGISTRY = [
   { id: "NumberLine", tier: "public", kind: "bed" },
   { id: "CountdownRing", tier: "public", kind: "bed" },
   { id: "CountrySilhouetteClip", tier: "public", kind: "bed", scene_layer: true },
-  // TODO(consolidation): collapse to one FlagReveal { country } - these three
-  // are the same component with hardcoded flag paths (a recipe, not a tool).
-  { id: "FlagRevealGB", tier: "public", kind: "bed" },
-  { id: "FlagRevealJP", tier: "public", kind: "bed" },
-  { id: "FlagRevealBR", tier: "public", kind: "bed" },
+  { id: "FlagReveal", tier: "public", kind: "bed" },
   { id: "ColorCards", tier: "public", kind: "bed", scene_layer: true },
   { id: "TitleCard", tier: "public", kind: "bed" },
   { id: "ParallaxImage", tier: "public", kind: "bed" },
@@ -2036,6 +2194,7 @@ async function getSessionContext() {
 
 export {
   NODE_TYPES,
+  ACTIVE_NODE_TYPES,
   NON_COUNTABLE_TYPES,
   FORM_TYPE_KEYS,
   WORKFLOW_TYPES,
@@ -2060,4 +2219,4 @@ export {
   getSessionContextWithAuth,
   getSessionContext
 };
-//# sourceMappingURL=chunk-PCCTN3T7.js.map
+//# sourceMappingURL=chunk-AHWMH66L.js.map