@clipform/mcp-server 4.2.2 → 4.2.4

package/dist/{chunk-XOV5ILOJ.js → chunk-XW3FEMD4.js}

@@ -29,7 +29,7 @@ import {
   union,
   unknown,
   url
-} from "./chunk-APCG2RRD.js";
+} from "./chunk-LBNRRZTC.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -38,7 +38,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-5AAKB4S5.js";
+} from "./chunk-FFOQNI3B.js";
 import {
   ANON_PREVIEW_LINK_LABEL,
   ANON_PREVIEW_NOTICE,
@@ -49,7 +49,7 @@ import {
   anonPreviewNotice,
   capsFromToolsets,
   isPreviewViewerUrl
-} from "./chunk-FGTU764J.js";
+} from "./chunk-NN77UKUQ.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
@@ -71,7 +71,7 @@ import {
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-KZNBYHHR.js";
+} from "./chunk-NZCRZDRQ.js";
 import {
   getMcpAuth,
   runWithMcpAuth,
@@ -16769,7 +16769,7 @@ function registerImportFormTool(server) {
 }
 
 // src/tools/list-forms.ts
-function registerListFormsTool(server) {
+function registerListFormsTool(server, caps = FULL_CAPS) {
   server.registerTool(
     "clipform_list_forms",
     {
@@ -16841,7 +16841,12 @@ function registerListFormsTool(server) {
         next_cursor: data.next_cursor
       };
       if (data.forms.length === 0) {
-        return structuredResult("No forms found matching the criteria.", structured);
+        const unfiltered = !search && !tag && !published && !cursor;
+        if (!unfiltered) {
+          return structuredResult("No forms found matching the criteria.", structured);
+        }
+        const text = caps.forms ? `No forms in this workspace yet. ${ONBOARDING_OFFER_TOOL_CUE} Then build it with clipform_create_form.` : "No forms in this workspace yet.";
+        return structuredResult(text, structured);
       }
       const lines = [`Found ${data.forms.length} form(s):
 `];
@@ -18873,6 +18878,37 @@ function resolveCaptionRef(explicit, audioUrl) {
   if (explicit) return explicit;
   return typeof audioUrl === "string" && audioUrl ? audioUrl : void 0;
 }
+function soundNarration(inputProps) {
+  const sound = inputProps?.sound;
+  const narration = sound && typeof sound === "object" && sound.enabled !== false ? sound.narration : void 0;
+  if (typeof narration === "string" && narration) return narration;
+  const audioUrl = inputProps?.audioUrl;
+  return typeof audioUrl === "string" && audioUrl ? audioUrl : void 0;
+}
+var VOICEOVER_PROP_NAMES = [
+  "narration",
+  "audioUrl",
+  "narrationSrc",
+  "answerNarration",
+  "introNarration",
+  "outroNarration"
+];
+var VOICEOVER_CONTROL_NAMES = ["audio_url"];
+function nonEmpty(v) {
+  if (typeof v === "string") return v.length > 0;
+  if (Array.isArray(v)) return v.length > 0;
+  return typeof v === "object" && v !== null;
+}
+function renderHasNarration(input) {
+  if (input.captions && input.captions.length > 0) return true;
+  if (input.captionRef) return true;
+  const sound = input.inputProps?.sound;
+  const soundBlock = sound && typeof sound === "object" && sound.enabled !== false ? sound : void 0;
+  for (const name of VOICEOVER_PROP_NAMES) {
+    if (nonEmpty(input.inputProps?.[name]) || nonEmpty(soundBlock?.[name])) return true;
+  }
+  return VOICEOVER_CONTROL_NAMES.some((name) => nonEmpty(input.controls?.[name]));
+}
 async function createRenderPlaceholder(input) {
   try {
     const me = await callApi("/me", { method: "GET" });
@@ -18893,7 +18929,7 @@ async function createRenderPlaceholder(input) {
     if (!attached.ok) return void 0;
     await callApi(`/forms/${input.formId}/nodes/${input.nodeId}/media`, {
       method: "PATCH",
-      body: { fit_media: true, show_captions: true }
+      body: { fit_media: true, show_captions: input.narrated !== false }
     }).catch(() => void 0);
     return { workspaceId, assetId };
   } catch {
@@ -18921,6 +18957,7 @@ async function completeViaPlaceholder(placeholder, input) {
     const body = { url: input.publicUrl };
     if (input.captions?.length) body.captions = input.captions;
     if (input.captionRef) body.caption_ref = input.captionRef;
+    if (input.narrated === false) body.transcribe = false;
     const completed = await callApi(`/workspaces/${placeholder.workspaceId}/media/${placeholder.assetId}/complete`, {
       method: "POST",
       body
@@ -18950,6 +18987,7 @@ async function legacyAutoAttach(input) {
     };
     if (input.captions?.length) createBody.captions = input.captions;
     if (input.captionRef) createBody.caption_ref = input.captionRef;
+    if (input.narrated === false) createBody.transcribe = false;
     const created = await callApi(`/workspaces/${workspaceId}/media`, { method: "POST", body: createBody });
     if (!created.ok) return { attached: false, error: `Failed to create media asset: ${created.error}` };
     const mediaAssetId = created.data?.media_asset_id;
@@ -18963,7 +19001,7 @@ async function legacyAutoAttach(input) {
     }
     await callApi(`/forms/${input.formId}/nodes/${input.nodeId}/media`, {
       method: "PATCH",
-      body: { fit_media: true, show_captions: true }
+      body: { fit_media: true, show_captions: input.narrated !== false }
     }).catch(() => void 0);
     let republished = false;
     const form = await callApi(`/forms/${input.formId}`, { method: "GET" });
@@ -19001,7 +19039,9 @@ var RenderItemSchema = external_exports.object({
 function fireRender(item, formId) {
   const job = createJob("clipform_render_composition");
   const mediaType = item.outputFormat === "png" ? "still" : "video";
-  const placeholderPromise = item.node_id && formId ? createRenderPlaceholder({ formId, nodeId: item.node_id, mediaType }) : Promise.resolve(void 0);
+  const captionRef = resolveCaptionRef(item.caption_ref, soundNarration(item.inputProps));
+  const narrated = renderHasNarration({ captions: item.captions, captionRef, inputProps: item.inputProps });
+  const placeholderPromise = item.node_id && formId ? createRenderPlaceholder({ formId, nodeId: item.node_id, mediaType, narrated }) : Promise.resolve(void 0);
   callApi("/internal/render", {
     timeoutMs: 3e5,
     // local renders pay a cold webpack bundle; Lambda is fast but bursty
@@ -19028,8 +19068,9 @@ function fireRender(item, formId) {
           publicUrl,
           mediaType,
           captions: item.captions,
-          captionRef: item.caption_ref,
-          placeholder
+          captionRef,
+          placeholder,
+          narrated
         });
       } else {
         const message = "Render completed without a public_url; nothing to attach.";
@@ -19141,7 +19182,9 @@ ${RENDER_ATTACH_RULE} In batch mode, set node_id per item (see items) and form_i
         );
       }
       const mediaTypeSingle = outputFormat === "png" ? "still" : "video";
-      const placeholderPromise = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType: mediaTypeSingle }) : Promise.resolve(void 0);
+      const captionRefSingle = resolveCaptionRef(caption_ref, soundNarration(inputProps));
+      const narrated = renderHasNarration({ captions, captionRef: captionRefSingle, inputProps });
+      const placeholderPromise = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType: mediaTypeSingle, narrated }) : Promise.resolve(void 0);
       const result = await callApi("/internal/render", {
         timeoutMs: 3e5,
         body: { compositionId, outputFormat, inputProps: inputProps ?? {} }
@@ -19162,8 +19205,9 @@ ${RENDER_ATTACH_RULE} In batch mode, set node_id per item (see items) and form_i
             publicUrl: data.public_url,
             mediaType: mediaTypeSingle,
             captions,
-            captionRef: caption_ref,
-            placeholder
+            captionRef: captionRefSingle,
+            placeholder,
+            narrated
           });
         } else if (placeholder) {
           await failPlaceholder(placeholder, "Render completed without a public_url; nothing to attach.");
@@ -19444,11 +19488,12 @@ ${RENDER_ATTACH_RULE}`,
         return errorResult("form_id is required when node_id is set.");
       }
       const captionRef = resolveCaptionRef(caption_ref, controls?.audio_url);
+      const narrated = renderHasNarration({ captions, captionRef, controls });
       const renderBody = { template, controls: controls ?? {}, outputFormat };
       const mediaType = outputFormat === "png" ? "still" : "video";
       if (wait === false) {
         const job = createJob("clipform_render_video_template");
-        const placeholderPromise2 = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType }) : Promise.resolve(void 0);
+        const placeholderPromise2 = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType, narrated }) : Promise.resolve(void 0);
         callApi("/internal/render-template", {
           timeoutMs: 3e5,
           body: renderBody
@@ -19464,7 +19509,7 @@ ${RENDER_ATTACH_RULE}`,
             const publicUrl = r.data.public_url;
             const placeholder = await placeholderPromise2;
             if (publicUrl) {
-              attach2 = await autoAttachRender({ formId: form_id, nodeId: node_id, publicUrl, mediaType, captions, captionRef, placeholder });
+              attach2 = await autoAttachRender({ formId: form_id, nodeId: node_id, publicUrl, mediaType, captions, captionRef, placeholder, narrated });
             } else {
               const message = "Render completed without a public_url; nothing to attach.";
               attach2 = { attached: false, error: message };
@@ -19487,7 +19532,7 @@ ${RENDER_ATTACH_RULE}`,
           { status: "rendering", job_id: job.id, template, output_format: outputFormat }
         );
       }
-      const placeholderPromise = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType }) : Promise.resolve(void 0);
+      const placeholderPromise = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType, narrated }) : Promise.resolve(void 0);
       const result = await callApi("/internal/render-template", {
         timeoutMs: 3e5,
         body: renderBody
@@ -19502,7 +19547,7 @@ ${RENDER_ATTACH_RULE}`,
       if (node_id && form_id) {
         const placeholder = await placeholderPromise;
         if (data.public_url) {
-          attach = await autoAttachRender({ formId: form_id, nodeId: node_id, publicUrl: data.public_url, mediaType, captions, captionRef, placeholder });
+          attach = await autoAttachRender({ formId: form_id, nodeId: node_id, publicUrl: data.public_url, mediaType, captions, captionRef, placeholder, narrated });
         } else if (placeholder) {
           await failPlaceholder(placeholder, "Render completed without a public_url; nothing to attach.");
         }
@@ -20068,7 +20113,7 @@ function createServer(options) {
   };
   registerCreateFormTool(server);
   registerImportFormTool(server);
-  registerListFormsTool(server);
+  registerListFormsTool(server, caps);
   registerWhoamiTool(server);
   registerGetFormTool(server);
   registerUpdateFormTool(server);
@@ -20167,4 +20212,4 @@ export {
   * MIT Licensed
   *)
 */
-//# sourceMappingURL=chunk-XOV5ILOJ.js.map
+//# sourceMappingURL=chunk-XW3FEMD4.js.map