@clipform/mcp-server 1.16.0 → 1.16.1

package/dist/{chunk-D64XBDOX.js → chunk-MB6BZ2JN.js}

@@ -2,7 +2,6 @@ import {
   __commonJS,
   __export,
   __toESM,
-  getMcpAuth,
   runWithMcpTool
 } from "./chunk-VWGIVJMQ.js";
 
@@ -21277,23 +21276,22 @@ var NODE_TYPES = {
     is_active: true,
     show_in_results: false,
     default_config: {
-      contact: {
-        fields: [
-          { id: "first_name", type: "first_name", label: "First Name", enabled: true, required: true },
-          { id: "email", type: "email", label: "Email", enabled: true, required: true }
-        ],
-        prompt: ""
-      },
+      fields: [
+        { id: "first_name", type: "first_name", label: "First Name", enabled: true, required: true },
+        { id: "email", type: "email", label: "Email", enabled: true, required: true }
+      ],
       consent_items: [
         { id: "default-consent", name: "Privacy policy", label: "I agree to the privacy policy and terms of service", order: 0, type: "consent" }
       ]
     },
     config_schema: {
       type: "object",
+      required: ["fields"],
       properties: {
         title: { type: "string" },
         fields: {
           type: "array",
+          minItems: 1,
           items: {
             type: "object",
             required: ["id", "required"],
@@ -22140,16 +22138,21 @@ var CONTACT_FIELDS = [
   { id: "first_name", label: "First Name", type: "text", placeholder: "Enter first name", order: 1 },
   { id: "last_name", label: "Last Name", type: "text", placeholder: "Enter last name", order: 2 },
   { id: "email", label: "Email Address", type: "email", placeholder: "you@example.com", order: 3 },
-  { id: "phone", label: "Phone Number", type: "tel", placeholder: "(555) 123-4567", order: 4 },
-  { id: "company", label: "Company", type: "text", placeholder: "Company name", order: 5 },
-  { id: "job_title", label: "Job Title", type: "text", placeholder: "Your role", order: 6 },
-  { id: "website", label: "Website", type: "url", placeholder: "https://example.com", order: 7 },
-  { id: "linkedin", label: "LinkedIn Profile", type: "url", placeholder: "https://linkedin.com/in/username", order: 8 },
-  { id: "message", label: "Message", type: "textarea", placeholder: "Your message...", order: 9 }
+  { id: "phone", label: "Phone Number", type: "tel", placeholder: "(555) 123-4567", order: 4 }
 ];
 var CONTACT_FIELDS_MAP = Object.fromEntries(
   CONTACT_FIELDS.map((f) => [f.id, f])
 );
+var KEN_BURNS_PRESETS = [
+  "cinematic",
+  "dramatic",
+  "calm",
+  "documentary",
+  "dreamy",
+  "moody"
+];
+var KEN_BURNS_EASINGS = ["ease-in-out", "ease-in", "ease-out", "linear"];
+var KEN_BURNS_FIT_MODES = ["cover", "blur-pad", "auto"];
 
 // src/lib/schemas.ts
 var ACTIVE_NODE_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.is_active && !def.is_system).map(([type]) => type);
@@ -22198,8 +22201,15 @@ function generateConfigSummary(configSchema, typeKey) {
   }
   return parts.length > 0 ? `Config: ${parts.join(", ")}` : "";
 }
+function formatDefaultConfig(defaultConfig) {
+  if (!defaultConfig) return "";
+  const filtered = { ...defaultConfig };
+  delete filtered.options;
+  if (Object.keys(filtered).length === 0) return "";
+  return JSON.stringify(filtered);
+}
 var NODE_TYPES_DESCRIPTION = (() => {
-  const lines = ["Node types:"];
+  const lines = ["Node types (omit config to use defaults where shown):"];
   for (const type of ACTIVE_NODE_TYPES) {
     const def = NODE_TYPES[type];
     let line = `- ${type}: ${def.description || def.label}`;
@@ -22210,17 +22220,26 @@ var NODE_TYPES_DESCRIPTION = (() => {
     if (configHint) {
       line += `. ${configHint}`;
     }
+    const defaultStr = formatDefaultConfig(def.default_config);
+    if (defaultStr) {
+      line += `. Defaults: ${defaultStr}`;
+    }
     lines.push(line);
   }
   return lines.join("\n");
 })();
 var CONFIG_DESCRIPTION = (() => {
-  const lines = ["Type-specific configuration. Per-type keys:"];
+  const lines = ["Type-specific configuration. Omit to use defaults. Per-type keys:"];
   for (const type of ACTIVE_NODE_TYPES) {
     const def = NODE_TYPES[type];
     const summary = generateConfigSummary(def.config_schema, type);
     if (summary) {
-      lines.push(`  ${type}: ${summary}`);
+      let line = `  ${type}: ${summary}`;
+      const defaultStr = formatDefaultConfig(def.default_config);
+      if (defaultStr) {
+        line += `. Defaults: ${defaultStr}`;
+      }
+      lines.push(line);
     }
   }
   return lines.join("\n");
@@ -22253,83 +22272,44 @@ var NodeSchema = external_exports.object({
 });
 
 // src/lib/api-client.ts
-var DASHBOARD_URL = process.env.SERVER_URL || process.env.DASHBOARD_URL || "https://api.clipform.io";
-var API_VERSION = "v1";
-var INTERNAL_API_URL = process.env.INTERNAL_API_URL || DASHBOARD_URL;
-var INTERNAL_SECRET = process.env.INTERNAL_SERVICE_SECRET || "";
-var _apiKey;
-function setApiKey(key) {
-  _apiKey = key;
+var API_BASE_URL = process.env.API_URL;
+if (!API_BASE_URL) {
+  throw new Error(
+    "API_URL must be set (e.g. http://localhost:3003 or https://api.clipform.io)"
+  );
 }
-async function callApi(path, options = {}) {
-  const { method = "GET", body, params } = options;
-  let url = `${DASHBOARD_URL}/${API_VERSION}${path}`;
-  if (params) {
-    const searchParams = new URLSearchParams(params);
-    url += `?${searchParams.toString()}`;
-  }
-  const headers = {
-    "Content-Type": "application/json"
-  };
-  const mcpAuth = getMcpAuth();
-  if (mcpAuth && INTERNAL_SECRET) {
-    headers["Authorization"] = `Bearer ${INTERNAL_SECRET}`;
-    headers["X-Mcp-User"] = mcpAuth.user_id;
-    headers["X-Mcp-Workspace"] = mcpAuth.workspace_id;
-    if (mcpAuth.tool_name) headers["X-Mcp-Tool"] = mcpAuth.tool_name;
-  } else if (_apiKey) {
-    headers["Authorization"] = `Bearer ${_apiKey}`;
-  }
-  const fetchOptions = { method, headers };
-  if (body && method !== "GET") {
-    fetchOptions.body = JSON.stringify(body);
-  }
-  let response;
-  try {
-    response = await fetch(url, fetchOptions);
-  } catch (err) {
+var MCP_SERVICE_USER_ID = "00000000-0000-4000-8000-000000000001";
+function getAuthHeaders() {
+  const serviceSecret = process.env.INTERNAL_SERVICE_SECRET || process.env.CLIPFORM_INTERNAL_SERVICE_SECRET;
+  const workspaceId = process.env.MCP_WORKSPACE_ID;
+  if (serviceSecret && workspaceId) {
     return {
-      ok: false,
-      status: 0,
-      error: `Failed to connect to dashboard API at ${url}. Make sure the dashboard is running.
-
-Error: ${err instanceof Error ? err.message : String(err)}`
+      "Authorization": `Bearer ${serviceSecret}`,
+      "X-Mcp-Workspace": workspaceId,
+      "X-Mcp-User": MCP_SERVICE_USER_ID
     };
   }
-  if (response.status === 204) {
-    return { ok: true, data: {} };
-  }
-  const data = await response.json();
-  if (!response.ok) {
-    return {
-      ok: false,
-      status: response.status,
-      error: data.error || `API error (${response.status})`
-    };
+  const apiKey = process.env.CLIPFORM_API_KEY;
+  if (apiKey) {
+    return { "Authorization": `Bearer ${apiKey}` };
   }
-  return { ok: true, data };
+  throw new Error(
+    "No API authentication configured. Set INTERNAL_SERVICE_SECRET + MCP_WORKSPACE_ID, or CLIPFORM_API_KEY."
+  );
 }
-async function callInternalApi(path, options = {}) {
-  const { method = "POST", body, params } = options;
-  let url = `${INTERNAL_API_URL}${path}`;
+async function callApi(path, options = {}) {
+  const { body, params } = options;
+  const method = options.method || (body ? "POST" : "GET");
+  const prefix = path.startsWith("/internal/") ? "" : "/v1";
+  let url = `${API_BASE_URL}${prefix}${path}`;
   if (params) {
     const searchParams = new URLSearchParams(params);
     url += `?${searchParams.toString()}`;
   }
   const headers = {
-    "Content-Type": "application/json"
+    "Content-Type": "application/json",
+    ...getAuthHeaders()
   };
-  const mcpAuth = getMcpAuth();
-  if (mcpAuth && INTERNAL_SECRET) {
-    headers["Authorization"] = `Bearer ${INTERNAL_SECRET}`;
-    headers["X-Mcp-User"] = mcpAuth.user_id;
-    headers["X-Mcp-Workspace"] = mcpAuth.workspace_id;
-    if (mcpAuth.tool_name) headers["X-Mcp-Tool"] = mcpAuth.tool_name;
-  } else if (_apiKey) {
-    headers["Authorization"] = `Bearer ${_apiKey}`;
-  } else if (INTERNAL_SECRET) {
-    headers["Authorization"] = `Bearer ${INTERNAL_SECRET}`;
-  }
   const fetchOptions = { method, headers };
   if (body && method !== "GET") {
     fetchOptions.body = JSON.stringify(body);
@@ -22341,7 +22321,7 @@ async function callInternalApi(path, options = {}) {
     return {
       ok: false,
       status: 0,
-      error: `Failed to connect to internal API at ${url}.
+      error: `Failed to connect to API at ${url}.
 
 Error: ${err instanceof Error ? err.message : String(err)}`
     };
@@ -22354,7 +22334,7 @@ Error: ${err instanceof Error ? err.message : String(err)}`
     return {
       ok: false,
       status: response.status,
-      error: data.error || `Internal API error (${response.status})`
+      error: data.error || `API error (${response.status})`
     };
   }
   return { ok: true, data };
@@ -22430,14 +22410,27 @@ Example: A form that asks a question, collects contact info, then finishes:
         workspace_id: workspaceId,
         workspace_name: me.workspace?.name ?? null,
         plan_name: me.plan?.name ?? "Free",
-        node_limit: me.plan?.node_limit ?? null
+        node_limit: me.plan?.node_limit ?? null,
+        form_limit: me.plan?.form_limit ?? null
       };
-      const contentCount = nodes.filter((q) => q.type !== "end_screen").length;
+      const contentCount = nodes.filter((q) => !NON_COUNTABLE_TYPES.includes(q.type)).length;
       if (planContext.node_limit !== null && contentCount > planContext.node_limit) {
         const upgradeUrl = `${BUSINESS.urls.dashboard}/billing`;
         const message = planContext.auth_mode === "oauth" ? `Your '${planContext.workspace_name}' workspace is on the ${planContext.plan_name} plan, capped at ${planContext.node_limit} nodes per form. You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes or upgrade at ${upgradeUrl}.` : `Anonymous sessions are capped at ${planContext.node_limit} nodes per form (${planContext.plan_name} plan). You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes, or connect your Clipform account in claude.ai \u2192 Settings \u2192 Connectors so forms land in your workspace with your real plan limits.`;
         return errorResult(message);
       }
+      if (planContext.form_limit !== null) {
+        const formsResult = await callApi("/forms", { method: "GET" });
+        if (formsResult.ok) {
+          const formCount = Array.isArray(formsResult.data) ? formsResult.data.length : 0;
+          if (formCount >= planContext.form_limit) {
+            const upgradeUrl = `${BUSINESS.urls.dashboard}/billing`;
+            return errorResult(
+              `Your workspace has reached the ${planContext.plan_name} plan limit of ${planContext.form_limit} forms. Upgrade at ${upgradeUrl} for unlimited forms.`
+            );
+          }
+        }
+      }
       const createResult = await callApi("/forms", {
         method: "POST",
         body: { title, workspace_id: workspaceId }
@@ -22462,6 +22455,11 @@ Example: A form that asks a question, collects contact info, then finishes:
         });
       }
       for (const q of nodes) {
+        if (q.type === "button" && (!q.options || q.options.length === 0)) {
+          const buttonDefault = NODE_TYPES.button?.config_schema?.properties?.button_text?.default || "Continue";
+          const label = q.config?.button_text || buttonDefault;
+          q.options = [{ content: label }];
+        }
         const addResult = await callApi(`/forms/${formId}/nodes`, {
           method: "POST",
           body: { node: q }
@@ -22470,10 +22468,13 @@ Example: A form that asks a question, collects contact info, then finishes:
           return errorResult(`Failed to add node "${q.prompt}": ${addResult.error}`);
         }
       }
-      await callApi(`/forms/${formId}`, {
+      const publishResult = await callApi(`/forms/${formId}`, {
         method: "PATCH",
         body: { is_live: true }
       });
+      if (!publishResult.ok) {
+        return errorResult(`Form created but failed to publish: ${publishResult.error}. Form ID: ${formId}`);
+      }
       if (tags && tags.length > 0) {
         await callApi(`/forms/${formId}/tags`, {
           method: "PUT",
@@ -22498,7 +22499,9 @@ Example: A form that asks a question, collects contact info, then finishes:
         `Pass form_id on follow-up tools (get_form, add_node, upload_node_media, etc.).`
       );
       if (planContext) {
-        const limitNote = planContext.node_limit === null ? "unlimited nodes" : `up to ${planContext.node_limit} nodes per form`;
+        const nodePart = planContext.node_limit === null ? "unlimited nodes" : `up to ${planContext.node_limit} nodes per form`;
+        const formPart = planContext.form_limit === null ? "unlimited forms" : `up to ${planContext.form_limit} forms`;
+        const limitNote = `${formPart}, ${nodePart}`;
         if (planContext.auth_mode === "oauth") {
           lines.push(
             ``,
@@ -22779,11 +22782,7 @@ function registerAddNodeTool(server) {
     "clipform_add_node",
     {
       title: "Add Node",
-      description: `Add a new node to an existing form. By default, the node is inserted before the end screen (appended to the end of the flow). Use after_node_id to insert at a specific position.
-
-${NODE_TYPES_DESCRIPTION}
-
-All type definitions and config schemas are derived from @vid-master/config (answer-types).`,
+      description: `Add a new node to an existing form. Inserted before the end screen by default. Use after_node_id to insert at a specific position. Node types and config schemas match clipform_create_form.`,
       inputSchema: {
         form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
         node: NodeSchema.describe("The node to add"),
@@ -22932,6 +22931,7 @@ ${formState}` : confirmMsg);
 }
 
 // src/tools/upload-node-media.ts
+var MEDIA_SUPPORTED_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.supports_media).map(([type]) => type);
 var MediaItemSchema = external_exports.object({
   node_id: external_exports.string().describe("The node ID"),
   media_type: external_exports.enum(["video", "still"]).describe("Type of media"),
@@ -22960,7 +22960,7 @@ function registerUploadNodeMediaTool(server) {
       title: "Upload Node Media",
       description: `Upload media for one or more nodes. Pass one item or many (max 10). Multiple items upload sequentially.
 
-When a public URL is provided, the media is fetched and stored automatically. Only works on node types that support media (choice, open, scale, button). For video: ingested via Mux. For image: stored in Supabase. When attaching TTS narration video, always include captions from clipform_generate_tts.`,
+When a public URL is provided, the media is fetched and stored automatically. Only works on node types that support media (${MEDIA_SUPPORTED_TYPES.join(", ")}). For video: ingested via Mux. For image: stored in Supabase. When attaching TTS narration video, always include captions from clipform_generate_tts.`,
       inputSchema: {
         form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
         items: external_exports.array(MediaItemSchema).min(1).max(10).describe("One or more media items to upload")
@@ -23149,44 +23149,6 @@ ${formState}` : confirmMsg);
   );
 }
 
-// src/tools/attach-node-audio.ts
-function registerAttachNodeAudioTool(server) {
-  server.registerTool(
-    "clipform_attach_audio",
-    {
-      title: "Attach Audio to Node",
-      description: `Attach a sound effect or audio file to a node with existing media (stills only). The audio auto-plays once when a respondent reaches this node. Provide a public URL to the audio file (WAV, MP3, or OGG). The node must already have media uploaded (use clipform_upload_node_media first).`,
-      inputSchema: {
-        form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
-        node_id: external_exports.string().describe("The node ID (must already have media attached)"),
-        url: external_exports.string().url().describe("Public URL to the audio file (WAV, MP3, or OGG)")
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: true
-      }
-    },
-    async ({ form_id, node_id, url }) => {
-      const result = await callApi(
-        `/forms/${form_id}/nodes/${node_id}/audio`,
-        {
-          method: "PUT",
-          body: { url }
-        }
-      );
-      if (!result.ok) {
-        return errorResult(result.error);
-      }
-      return textResult(
-        `Audio attached to node ${node_id}.
-Audio path: ${result.data.audio_storage_path}`
-      );
-    }
-  );
-}
-
 // src/tools/log-generation.ts
 function registerLogGenerationTool(server) {
   server.registerTool(
@@ -23213,7 +23175,7 @@ function registerLogGenerationTool(server) {
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
     async ({ form_id, summary, details }) => {
-      const result = await callInternalApi("/internal/log-generation", {
+      const result = await callApi("/internal/log-generation", {
         body: { form_id, summary, details }
       });
       if (!result.ok) return errorResult(result.error);
@@ -23246,7 +23208,7 @@ If neither native web search nor this tool is available and the topic is post-cu
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
     },
     async ({ query, count }) => {
-      const result = await callInternalApi("/internal/search-news", {
+      const result = await callApi("/internal/search-news", {
         body: { query, count }
       });
       if (!result.ok) return errorResult(result.error);
@@ -23305,7 +23267,7 @@ DOES NOT WORK FOR:
       }
     },
     async ({ url, lang, max_chars }) => {
-      const result = await callInternalApi("/internal/youtube-transcript", {
+      const result = await callApi("/internal/youtube-transcript", {
         body: { url, lang, max_chars }
       });
       if (!result.ok) return errorResult(result.error);
@@ -23357,7 +23319,7 @@ Returns audio URL and word-level captions per item.`,
       const workspace_id = process.env.MCP_WORKSPACE_ID;
       const results = await Promise.allSettled(
         items.map(
-          (item) => callInternalApi("/internal/tts", {
+          (item) => callApi("/internal/tts", {
             body: { text: item.text, voice: item.voice, workspace_id }
           })
         )
@@ -23395,101 +23357,9 @@ Returns audio URL and word-level captions per item.`,
   );
 }
 
-// ../../node_modules/uuid/dist/esm/stringify.js
-var byteToHex = [];
-for (let i = 0; i < 256; ++i) {
-  byteToHex.push((i + 256).toString(16).slice(1));
-}
-function unsafeStringify(arr, offset = 0) {
-  return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
-}
-
-// ../../node_modules/uuid/dist/esm/rng.js
-import { randomFillSync } from "crypto";
-var rnds8Pool = new Uint8Array(256);
-var poolPtr = rnds8Pool.length;
-function rng() {
-  if (poolPtr > rnds8Pool.length - 16) {
-    randomFillSync(rnds8Pool);
-    poolPtr = 0;
-  }
-  return rnds8Pool.slice(poolPtr, poolPtr += 16);
-}
-
-// ../../node_modules/uuid/dist/esm/native.js
-import { randomUUID } from "crypto";
-var native_default = { randomUUID };
-
-// ../../node_modules/uuid/dist/esm/v4.js
-function v4(options, buf, offset) {
-  if (native_default.randomUUID && !buf && !options) {
-    return native_default.randomUUID();
-  }
-  options = options || {};
-  const rnds = options.random ?? options.rng?.() ?? rng();
-  if (rnds.length < 16) {
-    throw new Error("Random bytes length must be >= 16");
-  }
-  rnds[6] = rnds[6] & 15 | 64;
-  rnds[8] = rnds[8] & 63 | 128;
-  if (buf) {
-    offset = offset || 0;
-    if (offset < 0 || offset + 16 > buf.length) {
-      throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);
-    }
-    for (let i = 0; i < 16; ++i) {
-      buf[offset + i] = rnds[i];
-    }
-    return buf;
-  }
-  return unsafeStringify(rnds);
-}
-var v4_default = v4;
-
-// src/lib/render-jobs.ts
-var jobs = /* @__PURE__ */ new Map();
-var MAX_AGE_MS = 30 * 60 * 1e3;
-var RENDER_TIMING = {
-  expectedRange: "15-120 seconds",
-  pollDelay: "~15 seconds"
-};
-function createJob(tool) {
-  const job = {
-    id: v4_default(),
-    status: "rendering",
-    tool,
-    createdAt: Date.now()
-  };
-  jobs.set(job.id, job);
-  return job;
-}
-function completeJob(id, result) {
-  const job = jobs.get(id);
-  if (job) {
-    job.status = "complete";
-    job.result = result;
-  }
-}
-function failJob(id, error2) {
-  const job = jobs.get(id);
-  if (job) {
-    job.status = "failed";
-    job.error = error2;
-  }
-}
-function getJob(id) {
-  return jobs.get(id);
-}
-function pruneJobs() {
-  const cutoff = Date.now() - MAX_AGE_MS;
-  for (const [id, job] of jobs) {
-    if (job.createdAt < cutoff) jobs.delete(id);
-  }
-}
-
 // src/tools/generate-slideshow.ts
 var slideshowStyleSchema = external_exports.object({
-  preset: external_exports.enum(["cinematic", "dramatic", "calm", "documentary", "dreamy", "moody"]).optional().describe("Named shortcut applied before per-field overrides. cinematic = defaults; dramatic = big zoom, wider pan, ease-out, stronger vignette; calm = minimal motion, linear, no vignette; documentary = near-static, no pan; dreamy = bright heavy blur-pad, soft vignette, gentle zoom; moody = desaturated low-key blur-pad, strong vignette. Set any other field to override individual knobs on top of the preset."),
+  preset: external_exports.enum(KEN_BURNS_PRESETS).optional().describe("Style preset: cinematic (default), dramatic, calm, documentary, dreamy, moody."),
   zoom: external_exports.object({
     from: external_exports.number().optional().describe("Starting scale for zoom-in / ending scale for zoom-out. Default 1.0."),
     to: external_exports.number().optional().describe("Ending scale for zoom-in / starting scale for zoom-out. Default 1.3 (cover) / 1.15 (blur-pad).")
@@ -23503,7 +23373,7 @@ var slideshowStyleSchema = external_exports.object({
     to: external_exports.number().optional(),
     rangeFraction: external_exports.number().optional().describe("Multiplier on pan.range for zoom-in-pan-* effects. Default 0.5.")
   }).optional(),
-  easing: external_exports.enum(["ease-in-out", "ease-in", "ease-out", "linear"]).optional().describe("Motion curve. 'ease-in-out' = cinematic default. 'linear' = mechanical/deliberate. 'ease-out' = fast-start slow-finish, good for reveals."),
+  easing: external_exports.enum(KEN_BURNS_EASINGS).optional().describe("Motion curve. 'ease-in-out' = cinematic default. 'linear' = mechanical/deliberate. 'ease-out' = fast-start slow-finish, good for reveals."),
   blurPad: external_exports.object({
     blurPx: external_exports.number().optional().describe("Blur strength on the background layer. Default 40. 60+ for heavy dreamy effect, 20 for just-barely."),
     brightness: external_exports.number().optional().describe("Background brightness multiplier. Default 0.55 (dimmed). Raise to 0.8+ for a brighter bed; lower for moodier."),
@@ -23526,75 +23396,20 @@ function registerGenerateSlideshowTool(server) {
     "clipform_generate_slideshow",
     {
       title: "Generate Slideshow",
-      description: `**Deprecated: prefer clipform_generate_video** which supports both images and video clips.
-
-Generate a slideshow video from images and audio. Creates a 9:16 (720x1280) video with smooth pan/zoom effects (Ken Burns style), eased motion, and crossfade transitions, synced to the audio duration. Uploaded to storage; returns a public URL.
-
-You are the director. Every stylistic choice below is yours - defaults exist for convenience but override anything that fits your creative vision.
-
-## Workflow
-
-1. Source images (use clipform_search_media with kind: "image"). Prefer portrait sources for 9:16 output; landscape works too via blur-pad fallback.
-2. Produce narration audio (clipform_generate_tts).
-3. Call this tool with images + audio_url + your creative direction.
-4. Attach the returned public URL to a node via clipform_upload_media with media_type "video".
-
-## Image framing (per-image)
+      description: `Deprecated: prefer clipform_generate_video which supports both images and video clips.
 
-- **aspect_ratio** (width/height): pass through from the image source so the composition can auto-pick framing. Landscape images with no aspect_ratio will cover-crop and may pixelate.
-- **fit**: 'cover' (fill frame, crop), 'blur-pad' (sharp contained foreground + blurred cover background for landscape sources), 'auto' (default: cover for portrait, blur-pad for landscape > 1.1:1).
-- **style**: per-image creative overrides (see Style Knobs below).
+Generate a Ken Burns slideshow video (9:16, 720x1280) from images + audio. Blocks until complete. Returns a public URL.
 
-## Effects
+Workflow: 1) clipform_search_media (kind: "image") 2) clipform_generate_tts for narration 3) this tool 4) clipform_upload_node_media with media_type "video".
 
-zoom-in, zoom-out, pan-left, pan-right, pan-up, pan-down, zoom-in-pan-left, zoom-in-pan-right, random, static. Set 'random' or pass random_effects: true to shuffle per image.
-
-## Transitions
-
-fade (default), slide, wipe. Legacy names (fadeblack, slideleft, etc.) also work. duration is in seconds.
-
-## Style presets (fastest path)
-
-Pick one as a starting point via \`style.preset\` (per-image) or \`default_style.preset\` (global). Override individual knobs on top.
-
-- **cinematic** - the default feel. Smooth ease-in-out, zoom 1.0\u21921.3, subtle pan, subtle vignette.
-- **dramatic** - zoom 1.0\u21921.4, ease-out, wider pan (0.07), strong vignette. Good for big-reveal content, competitions, climactic moments.
-- **calm** - zoom 1.0\u21921.08, linear easing, no vignette. Reflective topics, wellness, educational explainers.
-- **documentary** - near-static (zoom 1.0\u21921.05, tiny pan, no vignette). Talking-heads-style context shots, historical photos.
-- **dreamy** - heavy blur-pad (blurPx 60, brightness 0.75), soft vignette. Aspirational, romantic, nostalgic.
-- **moody** - desaturated blur-pad (brightness 0.35, saturate 0.7), strong vignette, dark wrapper color. Crime, mystery, somber topics.
-
-Per-image preset wins over default_style preset. Per-field overrides (zoom, pan, etc.) merge on top of whichever preset is active.
-
-## Style Knobs (per-image via images[i].style, or global via default_style)
-
-- **zoom**: { from, to } - push-in/pull-out range. Cinematic default 1.0\u21921.3. Drop to 1.0\u21921.05 for near-static; push to 1.0\u21921.4 for dramatic.
-- **pan**: { range, scale } - drift magnitude. 0.03 subtle, 0.05 default, 0.08+ sweeping.
-- **easing**: 'ease-in-out' (default, cinematic) | 'ease-in' (accelerate) | 'ease-out' (decelerate, good for reveals) | 'linear' (mechanical).
-- **blurPad**: { blurPx, brightness, saturate, overscale, foregroundScale } - only applies when blur-pad fit is active. Heavier blurPx (60) + lower brightness (0.35) for moody; foregroundScale: 1.2 to reduce letterbox at the cost of mild crop.
-- **vignette**: false to disable, or { opacity, innerRadiusPercent }. Stronger vignette (opacity 0.6) for dramatic focus; disable for bright, flat looks.
-- **backgroundColor**: hex color shown behind the image frame (default '#000').
-- **autoBlurPadThreshold**: when fit='auto', images wider than this ratio get blur-pad. Default 1.1.
-
-## Global options
-
-- **default_style**: style applied to every image unless the image overrides per-field. Per-image style merges over default_style at the field level.
-- **background_color**: viewport wrapper color, visible during cross-fades.
-- **random_effects**: shuffles effects across images when true.
-
-## Creative guidance
-
-- For the same 5-image quiz slideshow, vary the effects (one zoom-in on the opener, pan-left on a cityscape, zoom-out on the closer) rather than random_effects: true, unless you want the dice-roll.
-- Quiet/reflective topics: slow easing ('linear'), tight zoom (1.0\u21921.08), no vignette.
-- Energetic topics: punchy zoom (1.0\u21921.35), ease-out, wider pan.
-- Mixed orientation sets: rely on fit: 'auto' + pass aspect_ratio per image. The composition will cover-crop portraits and blur-pad landscapes without more work.`,
+Style presets via default_style.preset: cinematic (default), dramatic, calm, documentary, dreamy, moody. Per-image overrides merge on top. See parameter descriptions for details.`,
       inputSchema: {
         images: external_exports.array(
           external_exports.object({
             url: external_exports.string().url().describe("Image URL"),
             effect: external_exports.string().optional().describe("Ken Burns effect name (see description). Pass 'random' to shuffle this image only."),
             aspect_ratio: external_exports.number().positive().optional().describe("Source image width / height. Enables auto blur-pad for landscape images in the 9:16 viewport."),
-            fit: external_exports.enum(["cover", "blur-pad", "auto"]).optional().describe("Framing mode. 'auto' (default) picks cover for portrait, blur-pad for landscape."),
+            fit: external_exports.enum(KEN_BURNS_FIT_MODES).optional().describe("Framing mode. 'auto' (default) picks cover for portrait, blur-pad for landscape."),
             style: slideshowStyleSchema.optional()
           })
         ).min(1).max(20).describe("Images for the slideshow (1-20)"),
@@ -23611,8 +23426,7 @@ Per-image preset wins over default_style preset. Per-field overrides (zoom, pan,
     },
     async ({ images, audio_url, random_effects, transition, default_style, background_color }) => {
       const workspace_id = process.env.MCP_WORKSPACE_ID;
-      const job = createJob("clipform_generate_slideshow");
-      callInternalApi("/internal/slideshow", {
+      const result = await callApi("/internal/slideshow", {
         body: {
           images,
           audio_url,
@@ -23622,23 +23436,19 @@ Per-image preset wins over default_style preset. Per-field overrides (zoom, pan,
           background_color,
           workspace_id
         }
-      }).then((result) => {
-        if (!result.ok) {
-          failJob(job.id, result.error);
-        } else {
-          completeJob(job.id, result.data);
-        }
-      }).catch((err) => {
-        failJob(job.id, err instanceof Error ? err.message : String(err));
       });
+      if (!result.ok) return errorResult(result.error);
+      const data = result.data;
       return textResult(
         [
-          `Slideshow render started (${images.length} image${images.length > 1 ? "s" : ""}).`,
+          `Slideshow rendered (${images.length} image${images.length > 1 ? "s" : ""}).`,
           ``,
-          `Job ID: ${job.id}`,
+          `Public URL: ${data.public_url}`,
+          `Storage path: ${data.storage_path}`,
+          data.duration_seconds ? `Duration: ${data.duration_seconds}s` : "",
           ``,
-          `Renders typically take ${RENDER_TIMING.expectedRange}. Use clipform_check_render with this job ID to check status.`
-        ].join("\n")
+          `Use clipform_upload_node_media with the public URL to attach to a node.`
+        ].filter(Boolean).join("\n")
       );
     }
   );
@@ -23659,7 +23469,7 @@ function registerSearchMediaTool(server) {
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
     },
     async ({ query, kind, count }) => {
-      const result = await callInternalApi("/internal/search-media", {
+      const result = await callApi("/internal/search-media", {
         body: { query, kind, count }
       });
       if (!result.ok) return errorResult(result.error);
@@ -23687,46 +23497,40 @@ function registerRenderCompositionTool(server) {
     "clipform_render_composition",
     {
       title: "Render Composition",
-      description: `Render a video composition to MP4 or PNG.
+      description: `Render a video composition to MP4 or PNG. Blocks until complete and returns the public URL.
 
 Output formats:
 - mp4: Video file (H.264 codec, correct BT.709 colors, best for social media)
 - png: Still image (single frame)
 
-For narrated quiz slideshows, prefer clipform_generate_slideshow which handles the full workflow (focal point detection, audio sync, storage upload). Use this tool for custom compositions like ScorecardQuiz, ShortFormQuiz, or PresenterDirected.`,
+For narrated quiz slideshows, prefer clipform_generate_video which handles Ken Burns effects, audio sync, and storage upload. Use this tool for custom compositions like GlobeToCity, ScorecardQuiz, ShortFormQuiz, or PresenterDirected.`,
       inputSchema: {
-        compositionId: external_exports.string().describe("The composition ID (e.g. 'ScorecardQuiz', 'ShortFormQuiz', 'PresenterDirected')"),
+        compositionId: external_exports.string().describe("The composition ID (e.g. 'GlobeToCity', 'ScorecardQuiz', 'ShortFormQuiz')"),
         outputFormat: external_exports.enum(["mp4", "png"]).default("mp4").describe("Output format (default: mp4)"),
         inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props object matching the composition's expected schema")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
     async ({ compositionId, outputFormat, inputProps }) => {
-      const job = createJob("clipform_render_composition");
-      callInternalApi("/internal/render", {
+      const result = await callApi("/internal/render", {
         body: {
           compositionId,
           outputFormat,
           inputProps: inputProps ?? {}
         }
-      }).then((result) => {
-        if (!result.ok) {
-          failJob(job.id, result.error);
-        } else {
-          completeJob(job.id, result.data);
-        }
-      }).catch((err) => {
-        failJob(job.id, err instanceof Error ? err.message : String(err));
       });
+      if (!result.ok) return errorResult(result.error);
+      const data = result.data;
       return textResult(
         [
-          `Render started.`,
+          `Render complete.`,
           ``,
           `Composition: ${compositionId}`,
-          `Format: ${outputFormat}`,
-          `Job ID: ${job.id}`,
+          `Format: ${data.format || outputFormat}`,
+          `Public URL: ${data.public_url}`,
+          `Storage path: ${data.storage_path}`,
           ``,
-          `Renders typically take ${RENDER_TIMING.expectedRange}. Use clipform_check_render with this job ID to check status.`
+          `Use clipform_upload_node_media with the public URL to attach to a node.`
         ].join("\n")
       );
     }
@@ -23751,7 +23555,7 @@ function registerSearchMusicTool(server) {
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
     },
     async ({ query, count, instrumentalOnly, minDuration, maxDuration, tags }) => {
-      const result = await callInternalApi("/internal/search-music", {
+      const result = await callApi("/internal/search-music", {
         body: { query, count, instrumentalOnly, minDuration, maxDuration, tags }
       });
       if (!result.ok) return errorResult(result.error);
@@ -23783,7 +23587,7 @@ function registerListCompositionsTool(server) {
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
     async () => {
-      const result = await callInternalApi("/internal/compositions", {
+      const result = await callApi("/internal/compositions", {
         method: "GET"
       });
       if (!result.ok) {
@@ -23797,14 +23601,11 @@ function registerListCompositionsTool(server) {
       const lines = [`Available compositions (${compositions.length}):
 `];
       for (const comp of compositions) {
-        lines.push(`## ${comp.id}`);
-        lines.push(`  Duration: ${comp.durationInFrames} frames @ ${comp.fps}fps (${(comp.durationInFrames / comp.fps).toFixed(1)}s)`);
-        lines.push(`  Size: ${comp.width}x${comp.height}`);
-        if (comp.defaultProps) {
-          lines.push(`  Default props: ${JSON.stringify(comp.defaultProps, null, 2)}`);
-        }
-        lines.push("");
+        const duration3 = (comp.durationInFrames / comp.fps).toFixed(0);
+        lines.push(`- **${comp.id}** \u2014 ${comp.width}x${comp.height}, ${duration3}s`);
       }
+      lines.push("");
+      lines.push("Use clipform_render_composition with a compositionId to render. Pass inputProps matching the composition's schema.");
       return textResult(lines.join("\n"));
     }
   );
@@ -23823,7 +23624,7 @@ function registerListAssetsTool(server) {
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
     async ({ type }) => {
-      const result = await callInternalApi("/internal/assets", {
+      const result = await callApi("/internal/assets", {
         method: "GET",
         params: { type: type ?? "all" }
       });
@@ -23861,7 +23662,7 @@ function registerListAssetsTool(server) {
 
 // src/tools/generate-video.ts
 var slideshowStyleSchema2 = external_exports.object({
-  preset: external_exports.enum(["cinematic", "dramatic", "calm", "documentary", "dreamy", "moody"]).optional(),
+  preset: external_exports.enum(KEN_BURNS_PRESETS).optional(),
   zoom: external_exports.object({ from: external_exports.number().optional(), to: external_exports.number().optional() }).optional(),
   pan: external_exports.object({ range: external_exports.number().optional(), scale: external_exports.number().optional() }).optional(),
   zoomPan: external_exports.object({
@@ -23869,7 +23670,7 @@ var slideshowStyleSchema2 = external_exports.object({
     to: external_exports.number().optional(),
     rangeFraction: external_exports.number().optional()
   }).optional(),
-  easing: external_exports.enum(["ease-in-out", "ease-in", "ease-out", "linear"]).optional(),
+  easing: external_exports.enum(KEN_BURNS_EASINGS).optional(),
   blurPad: external_exports.object({
     blurPx: external_exports.number().optional(),
     brightness: external_exports.number().optional(),
@@ -23889,43 +23690,11 @@ function registerGenerateVideoTool(server) {
     "clipform_generate_video",
     {
       title: "Generate Video",
-      description: `Generate a video from images, video clips, or a mix of both, synced to audio. Creates a 9:16 (720x1280) video with transitions, uploaded to storage. Returns a public URL.
-
-## Workflow
-
-1. Source media with clipform_search_media (kind: "image" or "video")
-2. Source audio with clipform_generate_tts (narration) or clipform_search_music (background)
-3. Call this tool with items + audio_url
-4. Attach the returned URL to a node via clipform_upload_node_media with media_type "video"
-
-## Items
-
-Each item is an image or video clip:
-- **type: "image"** - still image with Ken Burns motion (pan/zoom). Supports effect, fit, and style overrides.
-- **type: "video"** - video clip, cover-cropped to fill 9:16 frame. Audio muted by default (set volume: 1 to mix in). Use start_from to trim.
-
-## Style presets (image items)
-
-Pick one via default_style.preset (all images) or per-image style.preset:
-- **cinematic** (default) - smooth ease-in-out, subtle zoom/pan, subtle vignette
-- **dramatic** - big zoom, wide pan, ease-out, strong vignette. Reveals, climactic moments.
-- **calm** - minimal motion, linear easing, no vignette. Educational, reflective.
-- **documentary** - near-static, tiny pan, no vignette. Historical photos, talking-heads context.
-- **dreamy** - heavy blur-pad, soft vignette. Aspirational, nostalgic.
-- **moody** - desaturated, dark, strong vignette. Mystery, somber.
-
-## Effects (image items)
+      description: `Generate a video from images, video clips, or both, synced to audio. Creates 9:16 (720x1280) with Ken Burns effects and transitions. Blocks until complete. Returns a public URL.
 
-zoom-in, zoom-out, pan-left, pan-right, pan-up, pan-down, zoom-in-pan-left, zoom-in-pan-right, random, static.
-Set per-image or use random_effects: true to shuffle.
+Workflow: 1) clipform_search_media (kind: "image" or "video") 2) clipform_generate_tts or clipform_search_music for audio 3) this tool 4) clipform_upload_node_media with media_type "video".
 
-## Transitions
-
-fade (default), slide, wipe, none. Duration in seconds.
-
-## Duration
-
-Matches audio when audio_url is provided. Use duration_seconds for videos without audio.`,
+Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by default). Style presets via default_style.preset: cinematic, dramatic, calm, documentary, dreamy, moody. Duration matches audio_url or set duration_seconds explicitly.`,
       inputSchema: {
         items: external_exports.array(
           external_exports.object({
@@ -23933,7 +23702,7 @@ Matches audio when audio_url is provided. Use duration_seconds for videos withou
             url: external_exports.string().url().describe("Media URL"),
             effect: external_exports.string().optional().describe("Ken Burns effect (image only): zoom-in, zoom-out, pan-left, pan-right, pan-up, pan-down, zoom-in-pan-left, zoom-in-pan-right, random, static"),
             aspect_ratio: external_exports.number().positive().optional().describe("Image width/height ratio (image only). Enables auto blur-pad for landscape images."),
-            fit: external_exports.enum(["cover", "blur-pad", "auto"]).optional().describe("Framing mode (image only). auto = cover for portrait, blur-pad for landscape."),
+            fit: external_exports.enum(KEN_BURNS_FIT_MODES).optional().describe("Framing mode (image only). auto = cover for portrait, blur-pad for landscape."),
             style: slideshowStyleSchema2.optional().describe("Creative style overrides (image only)"),
             start_from: external_exports.number().min(0).optional().describe("Start time in seconds (video only). Trims the clip."),
             volume: external_exports.number().min(0).max(1).optional().describe("Clip audio volume 0-1 (video only, default 0 = muted)")
@@ -23953,8 +23722,7 @@ Matches audio when audio_url is provided. Use duration_seconds for videos withou
     },
     async ({ items, audio_url, duration_seconds, random_effects, transition, default_style, background_color }) => {
       const workspace_id = process.env.MCP_WORKSPACE_ID;
-      const job = createJob("clipform_generate_video");
-      callInternalApi("/internal/generate-video", {
+      const result = await callApi("/internal/generate-video", {
         body: {
           items,
           audio_url,
@@ -23965,76 +23733,19 @@ Matches audio when audio_url is provided. Use duration_seconds for videos withou
           background_color,
           workspace_id
         }
-      }).then((result) => {
-        if (!result.ok) {
-          failJob(job.id, result.error);
-        } else {
-          completeJob(job.id, result.data);
-        }
-      }).catch((err) => {
-        failJob(job.id, err instanceof Error ? err.message : String(err));
       });
+      if (!result.ok) return errorResult(result.error);
+      const data = result.data;
       return textResult(
         [
-          `Render started (${items.length} item${items.length > 1 ? "s" : ""}).`,
-          ``,
-          `Job ID: ${job.id}`,
-          ``,
-          `Renders typically take ${RENDER_TIMING.expectedRange}. Use clipform_check_render with this job ID to check status.`
-        ].join("\n")
-      );
-    }
-  );
-}
-
-// src/tools/check-render.ts
-function registerCheckRenderTool(server) {
-  server.registerTool(
-    "clipform_check_render",
-    {
-      title: "Check Render Status",
-      description: `Check the status of a render job started by clipform_generate_video, clipform_generate_slideshow, or clipform_render_composition.
-
-Returns the current status and, when complete, the output URL. If still rendering, wait ${RENDER_TIMING.pollDelay} before checking again.`,
-      inputSchema: {
-        job_id: external_exports.string().uuid().describe("The job ID returned by the render tool")
-      },
-      annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
-    },
-    async ({ job_id }) => {
-      pruneJobs();
-      const job = getJob(job_id);
-      if (!job) {
-        return errorResult(`No render job found with ID ${job_id}. Jobs expire after 30 minutes.`);
-      }
-      if (job.status === "rendering") {
-        const elapsed = Math.round((Date.now() - job.createdAt) / 1e3);
-        return textResult(
-          [
-            `Status: rendering (${elapsed}s elapsed)`,
-            `Tool: ${job.tool}`,
-            ``,
-            `Still in progress. Check again in ${RENDER_TIMING.pollDelay}.`
-          ].join("\n")
-        );
-      }
-      if (job.status === "failed") {
-        return errorResult(`Render failed: ${job.error}`);
-      }
-      const data = job.result;
-      return textResult(
-        [
-          `Status: complete`,
-          `Tool: ${job.tool}`,
+          `Video rendered (${items.length} item${items.length > 1 ? "s" : ""}).`,
           ``,
-          ...data.public_url ? [`Public URL: ${data.public_url}`] : [],
-          ...data.storage_path ? [`Storage path: ${data.storage_path}`] : [],
-          ...data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : [],
-          ...data.outputPath ? [`Output: ${data.outputPath}`] : [],
-          ...data.format ? [`Format: ${data.format}`] : [],
+          `Public URL: ${data.public_url}`,
+          `Storage path: ${data.storage_path}`,
+          data.duration_seconds ? `Duration: ${data.duration_seconds}s` : "",
           ``,
-          `Use clipform_upload_node_media with the public URL to attach this video to a node.`
-        ].join("\n")
+          `Use clipform_upload_node_media with the public URL to attach to a node.`
+        ].filter(Boolean).join("\n")
       );
     }
   );
@@ -24177,6 +23888,11 @@ async function getSessionContext() {
   } else {
     lines.push("Questions: unlimited");
   }
+  if (plan.form_limit !== null) {
+    lines.push(`Form limit: ${plan.form_limit} forms`);
+  } else {
+    lines.push("Forms: unlimited");
+  }
   if (plan.custom_theme === false) {
     lines.push("Custom themes: not available on this plan");
   }
@@ -25057,7 +24773,6 @@ function createServer() {
   registerGetNodeMediaTool(server);
   registerDeleteNodeMediaTool(server);
   registerSetNodeLogicTool(server);
-  registerAttachNodeAudioTool(server);
   registerLogGenerationTool(server);
   registerSearchNewsTool(server);
   registerYouTubeTranscriptTool(server);
@@ -25069,7 +24784,6 @@ function createServer() {
   registerSearchMusicTool(server);
   registerListCompositionsTool(server);
   registerListAssetsTool(server);
-  registerCheckRenderTool(server);
   registerFetchBoundaryTool(server);
   registerPrompts(server);
   registerResources(server);
@@ -25078,7 +24792,6 @@ function createServer() {
 
 export {
   JSONRPCMessageSchema,
-  setApiKey,
   createServer
 };
-//# sourceMappingURL=chunk-D64XBDOX.js.map
+//# sourceMappingURL=chunk-MB6BZ2JN.js.map