@clipform/mcp-server 1.16.0 → 1.17.0

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

@@ -4,7 +4,7 @@ import {
   __toESM,
   getMcpAuth,
   runWithMcpTool
-} from "./chunk-VWGIVJMQ.js";
+} from "./chunk-HCZI2UJ5.js";
 
 // ../../node_modules/@modelcontextprotocol/sdk/node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21277,23 +21277,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 +22139,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 +22202,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 +22221,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 +22273,33 @@ 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);
+function getAuthHeaders() {
+  const authCtx = getMcpAuth();
+  const apiKey = authCtx?.api_key || process.env.CLIPFORM_API_KEY;
+  if (!apiKey) {
+    throw new Error("CLIPFORM_API_KEY must be set.");
   }
-  let response;
-  try {
-    response = await fetch(url, fetchOptions);
-  } catch (err) {
-    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)}`
-    };
-  }
-  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})`
-    };
-  }
-  return { ok: true, data };
+  return { "Authorization": `Bearer ${apiKey}` };
 }
-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 +22311,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 +22324,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 };
@@ -22422,7 +22392,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       const workspaceId = me.workspace?.id ?? null;
       if (!workspaceId) {
         return errorResult(
-          "No workspace available. Connect your Clipform account in claude.ai \u2192 Settings \u2192 Connectors, or ensure MCP_WORKSPACE_ID is configured for anonymous mode."
+          "No workspace available. This usually means authentication is misconfigured - check your API key or OAuth connection."
         );
       }
       planContext = {
@@ -22430,14 +22400,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.`;
+        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 sign in to your Clipform account 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 +22445,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 +22458,14 @@ 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}
+FORM URL: ${data.viewer_url}`);
+      }
       if (tags && tags.length > 0) {
         await callApi(`/forms/${formId}/tags`, {
           method: "PUT",
@@ -22494,11 +22486,13 @@ Example: A form that asks a question, collects contact info, then finishes:
       }
       lines.push(
         ``,
-        `IMPORTANT: Always show the user the exact URLs above \u2014 do not rewrite or modify them.`,
+        `CRITICAL: Copy the URLs above character-for-character into your response. Do NOT construct, guess, or invent any URLs. Only use the exact FORM URL and CLAIM URL provided here.`,
         `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(
             ``,
@@ -22507,7 +22501,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         } else {
           lines.push(
             ``,
-            `Plan: anonymous ${planContext.plan_name} (${limitNote}). Mention this once: the user can connect their Clipform account in claude.ai \u2192 Settings \u2192 Connectors \u2192 ${BUSINESS.urls.mcp} so future forms land directly in their workspace - do not repeat on follow-up calls.`
+            `Plan: anonymous ${planContext.plan_name} (${limitNote}). Mention this once: the user can sign in to their Clipform account so future forms land directly in their workspace - do not repeat on follow-up calls.`
           );
         }
       }
@@ -22779,11 +22773,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 +22922,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 +22951,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 +23140,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 +23166,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 +23199,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 +23258,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);
@@ -23354,10 +23307,10 @@ Returns audio URL and word-level captions per item.`,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
     async ({ items }) => {
-      const workspace_id = process.env.MCP_WORKSPACE_ID;
+      const workspace_id = getMcpAuth()?.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 +23348,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 +23364,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 +23387,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)
-
-- **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).
-
-## Effects
-
-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)
+      description: `Deprecated: prefer clipform_generate_video which supports both images and video clips.
 
-Pick one as a starting point via \`style.preset\` (per-image) or \`default_style.preset\` (global). Override individual knobs on top.
+Generate a Ken Burns slideshow video (9:16, 720x1280) from images + audio. Blocks until complete. Returns a public URL.
 
-- **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.
+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".
 
-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)"),
@@ -23610,9 +23416,8 @@ Per-image preset wins over default_style preset. Per-field overrides (zoom, pan,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
     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 workspace_id = getMcpAuth()?.workspace_id;
+      const result = await callApi("/internal/slideshow", {
         body: {
           images,
           audio_url,
@@ -23622,23 +23427,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 +23460,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 +23488,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 +23546,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 +23578,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 +23592,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 +23615,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 +23653,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 +23661,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 +23681,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)
-
-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.
-
-## Transitions
-
-fade (default), slide, wipe, none. Duration in seconds.
+      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.
 
-## Duration
+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".
 
-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 +23693,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)")
@@ -23952,9 +23712,8 @@ Matches audio when audio_url is provided. Use duration_seconds for videos withou
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
     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 workspace_id = getMcpAuth()?.workspace_id;
+      const result = await callApi("/internal/generate-video", {
         body: {
           items,
           audio_url,
@@ -23965,76 +23724,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,45 +23879,72 @@ 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");
   }
   if (me.auth_mode !== "oauth") {
     lines.push(`
-To unlock your full plan: connect your Clipform account in Settings > Connectors > ${BUSINESS.urls.mcp}`);
+To unlock your full plan: sign in to your Clipform account.`);
   }
   return lines.join("\n");
 }
 
 // src/prompts.ts
+var MEDIA_STYLE_ENUM = ["text", "images", "video"];
+function resourceLink(name, uri, title) {
+  return {
+    role: "assistant",
+    content: {
+      type: "resource_link",
+      uri,
+      name,
+      title,
+      mimeType: "text/markdown"
+    }
+  };
+}
 function registerPrompts(server) {
   server.registerPrompt(
     "create-quiz",
     {
       title: "Create a Quiz",
-      description: "Build a scored knowledge quiz with narrated video questions"
+      description: "Build a scored knowledge quiz with narrated video questions",
+      argsSchema: {
+        topic: external_exports.string().optional().describe("Quiz topic (e.g. 'Space exploration', 'Premier League')"),
+        question_count: external_exports.number().optional().default(8).describe("Number of questions (default: 8)"),
+        media_style: external_exports.enum(MEDIA_STYLE_ENUM).optional().default("video").describe("Media style: text only, still images, or slideshow video with narration (default: video)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const topic = args.topic ? ` about "${args.topic}"` : "";
+      const count = args.question_count ?? 8;
+      const media = args.media_style ?? "video";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to create a quiz. What's the best approach?"
+              text: `I want to create a quiz${topic}. ${count} questions, ${media} style.`
             }
           },
+          resourceLink("guide-quiz", "clipform://guides/quiz", "Quiz Writing Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a great quiz with Clipform. Read the quiz writing guide (clipform://guides/quiz) for detailed craft knowledge on question design, difficulty curves, and narration style.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a great ${count}-question ${media} quiz${topic} with Clipform. Read the attached quiz guide for craft knowledge on question design, difficulty curves, and narration style.
 
 ## Workflow
 
 1. **Research** the topic - find surprising facts, common misconceptions, myth-busters
-2. **Write questions** - follow the difficulty curve (easy start, hard middle, satisfying end). Target 5-8 questions.
+2. **Write questions** - follow the difficulty curve (easy start, hard middle, satisfying end). Target ${count} questions.
 3. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
@@ -24224,12 +23953,12 @@ function registerPrompts(server) {
    - randomise_options: true in config
    - score: 1 on correct option, score: 0 on wrong
    - 3-4 wrong answers per question
-5. **Generate narration** with clipform_generate_tts for each question. Tease the question - do NOT reveal the answer or read options aloud. Keep each narration 5-15 seconds.
+5. **Generate narration** with clipform_generate_tts for each question. Tease the question - do NOT reveal the answer or read options aloud. Keep each narration 5-15 seconds.${media !== "text" ? `
 6. **Build video** for each question:
    - clipform_search_media (kind: "image") - 3 images per question
    - clipform_generate_video - creates Ken Burns video synced to audio
-7. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.
-8. **Update end screen** with clipform_update_node - EVERY quiz must have:
+7. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.` : ""}
+${media !== "text" ? "8" : "6"}. **Update end screen** with clipform_update_node - EVERY quiz must have:
    - show_score: true, icon: "trophy"
    - show_share_button: true (drives virality)
    - cta_type: "restart", cta_text: a short challenge like "Beat your score?" or "Try again?"
@@ -24239,15 +23968,9 @@ function registerPrompts(server) {
      { "min": 3, "max": 5, "title": "Frequent Flyer", "message": "Not bad! You know your way around." },
      { "min": 6, "max": 8, "title": "World Explorer", "message": "Impressive - you really know your stuff." }
      \`\`\`
-9. **Publish** with clipform_update_form
-10. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
-11. **Log** with clipform_log_generation (sources, images, attributions)
-
-## Before building, ask
-
-1. How many questions?
-2. Media style: text only, still images, or slideshow video with narration?
-3. Any topic or style preferences?`
+${media !== "text" ? "9" : "7"}. **Publish** with clipform_update_form
+${media !== "text" ? "10" : "8"}. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+${media !== "text" ? "11" : "9"}. **Log** with clipform_log_generation (sources, images, attributions)`
             }
           }
         ]
@@ -24258,24 +23981,37 @@ function registerPrompts(server) {
     "create-personality-quiz",
     {
       title: "Create a Personality Quiz",
-      description: "Build a 'Which X are you?' personality quiz with category-based scoring and outcome screens"
+      description: "Build a 'Which X are you?' personality quiz with category-based scoring and outcome screens",
+      argsSchema: {
+        topic: external_exports.string().optional().describe("Quiz theme (e.g. 'Which city are you?', 'What's your work style?')"),
+        categories: external_exports.string().optional().describe("Comma-separated outcome categories (e.g. 'Creative, Analytical, Leader, Collaborator')"),
+        question_count: external_exports.number().optional().default(8).describe("Number of questions (default: 8)"),
+        media_style: external_exports.enum(MEDIA_STYLE_ENUM).optional().default("video").describe("Media style (default: video)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const topic = args.topic ? ` - "${args.topic}"` : "";
+      const count = args.question_count ?? 8;
+      const media = args.media_style ?? "video";
+      const categoriesNote = args.categories ? `
+
+Outcome categories: ${args.categories}` : "";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to create a personality quiz. What's the best approach?"
+              text: `I want to create a personality quiz${topic}. ${count} questions, ${media} style.${categoriesNote}`
             }
           },
+          resourceLink("guide-personality-quiz", "clipform://guides/personality-quiz", "Personality Quiz Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a personality quiz with Clipform. Read the personality quiz guide (clipform://guides/personality-quiz) for craft knowledge on category design, option weighting, and outcome writing.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a ${count}-question personality quiz${topic} with Clipform. Read the attached personality quiz guide for craft knowledge on category design, option weighting, and outcome writing.
 
 ## How it differs from a knowledge quiz
 
@@ -24284,7 +24020,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
 ## Workflow
 
 1. **Define 3-5 outcome categories** - these are the "personalities" (e.g. "Creative", "Analytical", "Leader", "Collaborator"). More than 5 gets muddy.
-2. **Write questions** - each question should feel revealing but fun. Target 5-8 questions.
+2. **Write questions** - each question should feel revealing but fun. Target ${count} questions.
 3. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
@@ -24315,13 +24051,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
    \`\`\`
 8. **Publish** with clipform_update_form
 9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
-10. **Log** with clipform_log_generation
-
-## Before building, ask
-
-1. What are the possible outcomes/personalities? (3-5 categories)
-2. What's the theme? ("Which city are you?", "What's your work style?", "Which character are you?")
-3. Media style: text only, still images, or slideshow video with narration?`
+10. **Log** with clipform_log_generation`
             }
           }
         ]
@@ -24332,45 +24062,49 @@ There are NO correct answers. Each option maps to one or more outcome categories
     "create-interview",
     {
       title: "Create an Interview",
-      description: "Build a form to collect testimonials, case studies, async video interviews, or journalist responses"
+      description: "Build a form to collect testimonials, case studies, async video interviews, or journalist responses",
+      argsSchema: {
+        purpose: external_exports.string().optional().describe("What you're collecting (e.g. 'testimonial', 'case study', 'job application')"),
+        response_format: external_exports.enum(["video", "audio", "text", "all"]).optional().default("all").describe("How respondents reply (default: all - video, audio, and text)"),
+        needs_consent: external_exports.boolean().optional().default(true).describe("Include a consent statement (default: true)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const purpose = args.purpose ?? "responses";
+      const format = args.response_format ?? "all";
+      const consent = args.needs_consent ?? true;
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to collect responses or testimonials from people. What's the best approach?"
+              text: `I want to collect ${purpose} from people. Responses via ${format}.${consent ? " Include consent." : ""}`
             }
           },
+          resourceLink("guide-interview", "clipform://guides/interview", "Interview & Testimonial Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build an interview or testimonial form with Clipform. Read the interview guide (clipform://guides/interview) for detailed craft knowledge on question design and pacing.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build an interview form for collecting ${purpose} with Clipform. Read the attached interview guide for craft knowledge on question design and pacing.
 
 ## Workflow
 
-1. **Identify the ask** - what do you need from respondents? Testimonial, case study, expert comment, job application?
+1. **Identify the ask** - what do you need from respondents? ${purpose}.
 2. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: false
 3. **Add a warm-up question** - something easy: "Tell us your name and role" (type: "open")
-4. **Add core questions** (type: "open") - 2-3 max, one topic per question. Enable text + audio + video responses.
-5. **Add contact collection** (type: "contact") - first name + email minimum
-6. **Add consent** if needed - "I agree that my response may be used in [context]"
+4. **Add core questions** (type: "open") - 2-3 max, one topic per question.${format === "all" ? " Enable text + audio + video responses." : ` Enable ${format} responses.`}
+5. **Add contact collection** (type: "contact") - first name + email minimum${consent ? `
+6. **Add consent** - "I agree that my response may be used in [context]"` : ""}
 7. **Update end screen** - set expectations: "Thanks! We'll be in touch."
 8. **Optional: add narration** - warm, inviting tone. "We'd love to hear your story..."
 9. **Publish** with clipform_update_form
 10. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
-
-## Before building, ask
-
-1. What are you collecting? (testimonial, case study, interview, application)
-2. Should respondents reply with video, audio, text, or all three?
-3. Do you need a consent statement?`
+11. **Log** with clipform_log_generation`
             }
           }
         ]
@@ -24381,24 +24115,31 @@ There are NO correct answers. Each option maps to one or more outcome categories
     "create-survey",
     {
       title: "Create a Survey",
-      description: "Build a feedback survey, NPS form, or research questionnaire"
+      description: "Build a feedback survey, NPS form, or research questionnaire",
+      argsSchema: {
+        topic: external_exports.string().optional().describe("What feedback you're collecting (e.g. 'NPS', 'event feedback', 'product satisfaction')"),
+        anonymous: external_exports.boolean().optional().default(true).describe("Whether the survey is anonymous (default: true)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const topic = args.topic ? ` for ${args.topic}` : "";
+      const anonymous = args.anonymous ?? true;
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to collect feedback or run a survey. What's the best approach?"
+              text: `I want to create a survey${topic}. ${anonymous ? "Anonymous" : "Identified"} respondents.`
             }
           },
+          resourceLink("guide-survey", "clipform://guides/survey", "Survey & Feedback Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a survey with Clipform. Read the survey guide (clipform://guides/survey) for craft knowledge on question design and reducing respondent fatigue.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a survey${topic} with Clipform. Read the attached survey guide for craft knowledge on question design and reducing respondent fatigue.
 
 ## Workflow
 
@@ -24408,19 +24149,14 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - disable_back_navigation: false
 3. **Add key metric question first** (type: "choice" or "rating") - put it first while attention is highest
 4. **Add one "why?" follow-up** (type: "open") - "What's the main reason for your score?"
-5. **Add 2-3 specific questions** (type: "choice") - only ask what you'll act on
-6. **Contact** (optional) - only if you need to follow up. Many surveys work better anonymous.
+5. **Add 2-3 specific questions** (type: "choice") - only ask what you'll act on${!anonymous ? `
+6. **Contact** - collect name + email for follow-up` : ""}
 7. **Update end screen** - "Thanks for your feedback!"
 8. **Publish** with clipform_update_form
 9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+10. **Log** with clipform_log_generation
 
-## Key rule: 5 questions max. Every extra question costs completions.
-
-## Before building, ask
-
-1. What feedback are you collecting? (NPS, satisfaction, event feedback, product research)
-2. Anonymous or identified?
-3. Any specific areas you want to ask about?`
+## Key rule: 5 questions max. Every extra question costs completions.`
             }
           }
         ]
@@ -24431,24 +24167,36 @@ There are NO correct answers. Each option maps to one or more outcome categories
     "create-comprehension-quiz",
     {
       title: "Create a YouTube Comprehension Quiz",
-      description: "Build a comprehension quiz from a YouTube video - tests whether the viewer actually watched and understood the content"
+      description: "Build a comprehension quiz from a YouTube video - tests whether the viewer actually watched and understood the content",
+      argsSchema: {
+        youtube_url: external_exports.string().optional().describe("YouTube video URL to create the quiz from"),
+        question_count: external_exports.number().optional().default(8).describe("Number of questions (default: 8)"),
+        audience: external_exports.string().optional().describe("Target audience (e.g. 'children aged 5-8', 'university students', 'general')"),
+        media_style: external_exports.enum(MEDIA_STYLE_ENUM).optional().default("video").describe("Media style (default: video)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const count = args.question_count ?? 8;
+      const media = args.media_style ?? "video";
+      const urlNote = args.youtube_url ? ` Start by extracting the transcript from: ${args.youtube_url}` : "";
+      const audienceNote = args.audience ? ` Target audience: ${args.audience}.` : "";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to create a comprehension quiz based on a YouTube video. What's the best approach?"
+              text: `I want to create a comprehension quiz based on a YouTube video. ${count} questions, ${media} style.${urlNote}${audienceNote}`
             }
           },
+          resourceLink("guide-quiz", "clipform://guides/quiz", "Quiz Writing Guide"),
+          resourceLink("guide-comprehension-quiz", "clipform://guides/comprehension-quiz", "Comprehension Quiz Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a comprehension quiz from a YouTube video. Read the quiz guide (clipform://guides/quiz) for general craft, and the comprehension guide (clipform://guides/comprehension-quiz) for video-specific techniques.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a ${count}-question comprehension quiz from a YouTube video. Read the attached quiz and comprehension guides for craft knowledge on question design and distractor techniques.
 
 ## Comprehension Quiz Workflow
 
@@ -24463,7 +24211,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - "What example does the video use to illustrate...?"
    - Include 1-2 inference questions: "Based on the video, why does the presenter believe...?"
    - Avoid questions answerable without watching (e.g., common knowledge about the topic)
-4. **Adapt to the audience** - if specified (e.g., "for a 5-year-old"), simplify language, reduce option count, focus on concrete/visual details rather than abstract arguments
+4. **Adapt to the audience**${args.audience ? ` (${args.audience})` : ""} - simplify language for younger audiences, focus on concrete/visual details rather than abstract arguments
 5. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
@@ -24472,12 +24220,12 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - randomise_options: true in config
    - score: 1 on correct option, score: 0 on wrong
    - 3-4 wrong answers per question - make distractors plausible (things someone might guess without watching)
-7. **Generate narration** with clipform_generate_tts - reference the video naturally: "If you watched closely, you'll know this one..." Keep each narration 5-10 seconds.
+7. **Generate narration** with clipform_generate_tts - reference the video naturally: "If you watched closely, you'll know this one..." Keep each narration 5-10 seconds.${media !== "text" ? `
 8. **Build video** for each question:
    - clipform_search_media (kind: "image") - 3 images per question
    - clipform_generate_video - Ken Burns video synced to audio
-9. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.
-10. **Update end screen** with clipform_update_node:
+9. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.` : ""}
+${media !== "text" ? "10" : "8"}. **Update end screen** with clipform_update_node:
     - show_score: true, icon: "trophy"
     - show_share_button: true
     - cta_type: "restart", cta_text: "Rewatch and try again?"
@@ -24487,9 +24235,9 @@ There are NO correct answers. Each option maps to one or more outcome categories
       { "min": 3, "max": 5, "title": "Casual Viewer", "message": "You caught the highlights but missed some details." },
       { "min": 6, "max": 8, "title": "Focused Student", "message": "You were paying attention - impressive." }
       \`\`\`
-11. **Publish** with clipform_update_form
-12. **Tag** - tags: ["quiz", "comprehension", "youtube"] + 2-3 topic words from the video
-13. **Log** with clipform_log_generation - include the YouTube URL, video title, and channel as sources
+${media !== "text" ? "11" : "9"}. **Publish** with clipform_update_form
+${media !== "text" ? "12" : "10"}. **Tag** - tags: ["quiz", "comprehension", "youtube"] + 2-3 topic words from the video
+${media !== "text" ? "13" : "11"}. **Log** with clipform_log_generation - include the YouTube URL, video title, and channel as sources
 
 ## Question Types for Comprehension
 
@@ -24501,14 +24249,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
 | Contrast | "The video compares X and Y. What was the key difference?" | Comprehension depth |
 | Conclusion | "What was the presenter's final point?" | Watched to the end |
 
-Wrong answers should sound right to someone who didn't watch but googled the topic. The quiz should be unfair to non-watchers and fair to watchers.
-
-## Before building, ask
-
-1. What's the YouTube URL?
-2. How many questions? (default: 8)
-3. Who's the audience? (age, knowledge level)
-4. Media style: text only, still images, or slideshow video with narration?`
+Wrong answers should sound right to someone who didn't watch but googled the topic. The quiz should be unfair to non-watchers and fair to watchers.`
             }
           }
         ]
@@ -24519,46 +24260,50 @@ Wrong answers should sound right to someone who didn't watch but googled the top
     "create-funnel",
     {
       title: "Create a Funnel",
-      description: "Build a lead qualification funnel or product recommendation quiz with branching logic"
+      description: "Build a lead qualification funnel or product recommendation quiz with branching logic",
+      argsSchema: {
+        outcomes: external_exports.string().optional().describe("What segments or recommendations exist (e.g. 'Basic/Pro/Enterprise', or product names)"),
+        criteria: external_exports.string().optional().describe("What criteria determine routing (e.g. 'budget, team size, use case')"),
+        needs_contact: external_exports.boolean().optional().default(true).describe("Include contact capture (default: true)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const outcomes = args.outcomes ?? "different outcomes";
+      const contact = args.needs_contact ?? true;
+      const criteriaNote = args.criteria ? ` Routing criteria: ${args.criteria}.` : "";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to qualify leads or recommend products based on answers. What's the best approach?"
+              text: `I want to qualify leads or recommend products based on answers. Outcomes: ${outcomes}.${criteriaNote}`
             }
           },
+          resourceLink("guide-funnel", "clipform://guides/funnel", "Lead Qualification & Funnel Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a qualification funnel with Clipform. Read the funnel guide (clipform://guides/funnel) for craft knowledge on branching logic and conversion.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a qualification funnel with Clipform. Read the attached funnel guide for craft knowledge on branching logic and conversion.
 
 ## Workflow
 
-1. **Define outcomes** - what segments or recommendations exist? (e.g., Basic/Pro/Enterprise, or product categories)
+1. **Define outcomes** - what segments or recommendations exist? (${outcomes})
 2. **Create the form** with clipform_create_form:
    - show_step_counter: false (funnels feel shorter without it)
    - disable_back_navigation: true (prevents answer shopping that breaks scoring)
 3. **Add hook question** (type: "choice") - "What best describes you?" or "What are you looking for?" This segments the user.
 4. **Add qualifying questions** (type: "choice") - 2-3 questions that narrow down the need. Assign scores to each option.
-5. **Set branching logic** with clipform_set_logic - route based on answers
-6. **Add contact capture** (type: "contact") - name, email, phone. Place AFTER qualifying questions.
+5. **Set branching logic** with clipform_set_logic - route based on answers${contact ? `
+6. **Add contact capture** (type: "contact") - name, email, phone. Place AFTER qualifying questions.` : ""}
 7. **Update end screen** with score_ranges for personalised outcomes: "Based on your answers, we recommend..."
 8. **Publish** with clipform_update_form
 9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+10. **Log** with clipform_log_generation
 
-## Key rule: 3-5 questions max. Every extra step loses leads.
-
-## Before building, ask
-
-1. What outcomes are you routing to? (products, plans, team members, messages)
-2. What criteria determine the routing?
-3. Do you need contact capture?`
+## Key rule: 3-5 questions max. Every extra step loses leads.`
             }
           }
         ]
@@ -24612,7 +24357,8 @@ function registerResources(server) {
     "clipform://guides/quiz",
     {
       description: "Craft knowledge for writing engaging quizzes - difficulty curves, question psychology, narration style, scoring",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24672,6 +24418,11 @@ Inspired by the Color Brain board game - every answer is identified by its colou
 - If two answer options would produce identical swatches, don't use that question.
 - Pair with a reveal composition (FlagReveal, image, or text) for the answer.
 
+## Settings
+
+- show_step_counter: true
+- disable_back_navigation: true (prevent going back to change answers after seeing feedback)
+
 ## Narration Style
 
 You're a quiz master, not a question reader. Each question's narration should:
@@ -24697,7 +24448,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/personality-quiz",
     {
       description: "Craft knowledge for building personality quizzes - category design, option weighting, outcome writing, no right/wrong answers",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24747,6 +24499,11 @@ Each category needs a \`scoring_results\` entry on the end screen:
 - **Message**: 2-3 sentences that feel like a personalised insight. Reference specific traits the quiz measured.
 - **Optional CTA**: link to relevant content, product, or next step
 
+## Settings
+
+- show_step_counter: true
+- disable_back_navigation: true (prevent re-answering which skews category scores)
+
 ## Narration Style
 
 Reflective and curious, not quizmaster-y:
@@ -24768,7 +24525,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/comprehension-quiz",
     {
       description: "Craft knowledge for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24819,6 +24577,11 @@ Make wrong answers plausible to someone who **didn't watch**:
 
 For young children: focus on "What did you SEE?" and "Who did what?" rather than abstract arguments.
 
+## Settings
+
+- show_step_counter: true
+- disable_back_navigation: true
+
 ## Narration style
 
 Reference the video naturally but don't spoil:
@@ -24839,7 +24602,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/interview",
     {
       description: "Craft knowledge for building interview and testimonial collection forms - warm-up pacing, open questions, consent, video responses",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24893,7 +24657,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/survey",
     {
       description: "Craft knowledge for feedback surveys, NPS, and research forms - brevity, rating scales, respondent fatigue",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24946,7 +24711,8 @@ ${WRITING_PRINCIPLES}`
     "clipform://guides/funnel",
     {
       description: "Craft knowledge for lead qualification funnels and product recommendation quizzes - branching logic, progressive profiling, conversion",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -25057,7 +24823,6 @@ function createServer() {
   registerGetNodeMediaTool(server);
   registerDeleteNodeMediaTool(server);
   registerSetNodeLogicTool(server);
-  registerAttachNodeAudioTool(server);
   registerLogGenerationTool(server);
   registerSearchNewsTool(server);
   registerYouTubeTranscriptTool(server);
@@ -25069,7 +24834,6 @@ function createServer() {
   registerSearchMusicTool(server);
   registerListCompositionsTool(server);
   registerListAssetsTool(server);
-  registerCheckRenderTool(server);
   registerFetchBoundaryTool(server);
   registerPrompts(server);
   registerResources(server);
@@ -25078,7 +24842,6 @@ function createServer() {
 
 export {
   JSONRPCMessageSchema,
-  setApiKey,
   createServer
 };
-//# sourceMappingURL=chunk-D64XBDOX.js.map
+//# sourceMappingURL=chunk-Y22DYUS3.js.map