@clipform/mcp-server 1.31.0 → 1.33.0

package/dist/{chunk-46RSQK6L.js → chunk-LSANXDSD.js}

@@ -6,14 +6,14 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-ELO7KCMZ.js";
+} from "./chunk-SY7YZPSC.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
   getGuideContent,
   getGuideUri,
   registerResources
-} from "./chunk-J4KJN4C4.js";
+} from "./chunk-JID43EDM.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -29,7 +29,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-NHFRYNJ3.js";
+} from "./chunk-KWEBCAPF.js";
 import {
   __commonJS,
   __export,
@@ -17196,7 +17196,8 @@ Example: A form that asks a question, collects contact info, then finishes:
         );
       }
       planContext = {
-        auth_mode: me.auth_mode,
+        auth_mode: me.auth_mode ?? "anonymous",
+        is_authenticated: me.auth_mode != null && me.auth_mode !== "anonymous",
         workspace_id: workspaceId,
         workspace_name: me.workspace?.name ?? null,
         plan_name: me.plan?.name ?? "Free",
@@ -17206,7 +17207,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       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 sign in to your Clipform account so forms land in your workspace with your real plan limits.`;
+        const message = planContext.is_authenticated ? `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) {
@@ -17216,14 +17217,14 @@ Example: A form that asks a question, collects contact info, then finishes:
           if (forms.length >= planContext.form_limit) {
             const upgradeUrl = `${BUSINESS.urls.dashboard}/billing`;
             const formList = forms.map((f, i) => `  ${i + 1}. "${f.title || "Untitled"}" (id: ${f.id})`).join("\n");
-            const options = planContext.auth_mode === "oauth" ? `  - Upgrade for unlimited forms: ${upgradeUrl}
+            const options = planContext.is_authenticated ? `  - Upgrade for unlimited forms: ${upgradeUrl}
   - Or delete one of the forms below to free a slot.` : `  - Delete one of the forms below to free a slot.
   - Or sign in to a Clipform account to keep these forms and get higher limits.`;
             return errorResult(
               [
                 `LIMIT REACHED - the form was NOT created. The plan's form limit is full.`,
                 ``,
-                `This ${planContext.auth_mode === "oauth" ? `workspace ('${planContext.workspace_name}')` : "anonymous session"} is on the ${planContext.plan_name} plan, which allows ${planContext.form_limit} forms, and it's already full. To make a new one:`,
+                `This ${planContext.is_authenticated ? `workspace ('${planContext.workspace_name}')` : "anonymous session"} is on the ${planContext.plan_name} plan, which allows ${planContext.form_limit} forms, and it's already full. To make a new one:`,
                 options,
                 ``,
                 `Current forms:`,
@@ -17304,7 +17305,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         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") {
+        if (planContext.is_authenticated) {
           lines.push(
             ``,
             `Plan: ${planContext.plan_name} (${limitNote}) in workspace '${planContext.workspace_name}'.`
@@ -18211,13 +18212,16 @@ function registerSearchMediaTool(server) {
     "clipform_search_media",
     {
       title: "Search Media",
-      description: `Search images or stock video clips. Pass one query or many (max 10) - multiple queries run in one call instead of separate tool calls. Use results to feed into clipform_generate_video for narrated slideshow videos, or upload directly as still images via clipform_upload_node_media. All results are pre-cleared for commercial use.`,
+      description: `Search images or stock video clips. Pass one query or many (max 10) - multiple queries run in one call instead of separate tool calls. Use results to feed into clipform_generate_video for narrated slideshow videos, or upload directly as still images via clipform_upload_node_media. All results are pre-cleared for commercial use. Results include a description (alt text where the provider has it) - use it to pick visually distinct images.
+
+Example: { queries: [{ query: "saturn rings" }, { query: "mars surface", count: 3 }] } returns portrait images for both.`,
       inputSchema: {
         queries: external_exports.array(
           external_exports.object({
             query: external_exports.string().describe("What to search for (e.g. 'african lion', 'saturn rings')"),
-            kind: external_exports.enum(["image", "video"]).describe("image = stock photos, video = stock clips"),
-            count: external_exports.number().min(1).max(20).default(6).optional().describe("Max results per provider (default 6 for image, 3 for video)")
+            kind: external_exports.enum(["image", "video"]).default("image").optional().describe("image = stock photos (default), video = stock clips"),
+            count: external_exports.number().min(1).max(20).default(6).optional().describe("Max results per provider (default 6 for image, 3 for video)"),
+            orientation: external_exports.enum(["portrait", "landscape", "any"]).default("portrait").optional().describe("portrait (default) fills the 9:16 frame; landscape gets auto blur-pad framing in Ken Burns videos")
           })
         ).min(1).max(10).describe("One or more search queries to run")
       },
@@ -18225,9 +18229,11 @@ function registerSearchMediaTool(server) {
     },
     async ({ queries }) => {
       const allLines = [];
-      for (const { query, kind, count } of queries) {
+      for (const q of queries) {
+        const { query, count, orientation } = q;
+        const kind = q.kind ?? "image";
         const result = await callApi("/internal/search-media", {
-          body: { query, kind, count }
+          body: { query, kind, count, orientation }
         });
         if (queries.length > 1) allLines.push(`--- "${query}" (${kind}) ---`);
         if (!result.ok) {
@@ -18244,8 +18250,15 @@ function registerSearchMediaTool(server) {
         for (const item of results.slice(0, 10)) {
           allLines.push(`- ${item.title}`);
           allLines.push(`  URL: ${item.url}`);
-          if (item.width && item.height) allLines.push(`  Size: ${item.width}x${item.height}`);
-          if (kind === "video" && item.duration) allLines.push(`  Duration: ${item.duration}s`);
+          const meta = [];
+          if (item.width && item.height) {
+            const ar = item.width / item.height;
+            meta.push(`${item.width}x${item.height} (${ar > 1.1 ? "landscape" : "portrait"})`);
+          }
+          if (kind === "video" && item.duration) meta.push(`${item.duration}s`);
+          if (item.source) meta.push(item.source);
+          if (meta.length) allLines.push(`  ${meta.join(" | ")}`);
+          if (item.attribution) allLines.push(`  Attribution: ${item.attribution}`);
           allLines.push("");
         }
       }
@@ -18436,6 +18449,98 @@ function registerListAssetsTool(server) {
   );
 }
 
+// ../../node_modules/.pnpm/uuid@11.1.1/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/.pnpm/uuid@11.1.1/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/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm/native.js
+import { randomUUID } from "crypto";
+var native_default = { randomUUID };
+
+// ../../node_modules/.pnpm/uuid@11.1.1/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-video.ts
 function registerGenerateVideoTool(server) {
   server.registerTool(
@@ -18444,7 +18549,9 @@ function registerGenerateVideoTool(server) {
       title: "Generate Video",
       description: `Generate a video from images, video clips, or both, synced to an audio track. Use this for narrated question backgrounds, topic visualisations, or any form node that benefits from video. Combine with clipform_generate_tts for narrated audio and clipform_search_media for royalty-free images. Creates 9:16 (720x1280) with Ken Burns pan/zoom effects and transitions. Returns a public URL when complete.
 
-Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by default). Duration matches audio_url or set duration_seconds explicitly.`,
+Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by default). Duration matches audio_url or set duration_seconds explicitly.
+
+For multi-question builds, pass wait: false on every render: each call returns a job ID immediately, so all renders run in parallel - then collect URLs with clipform_check_render. Sequential waiting renders take ${RENDER_TIMING.expectedRange} EACH.`,
       inputSchema: {
         items: external_exports.array(
           external_exports.object({
@@ -18465,13 +18572,14 @@ Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by defau
           duration: external_exports.number().optional().default(1).describe("Transition duration in seconds (default: 1)")
         }).optional(),
         style_preset: STYLE_PRESET_ENUM.optional(),
-        background_color: external_exports.string().optional().describe("Background color (default '#000')")
+        background_color: external_exports.string().optional().describe("Background color (default '#000')"),
+        wait: external_exports.boolean().optional().default(true).describe("true (default) blocks until the video is ready and returns its URL. false returns a job ID immediately - fire all renders first, then poll clipform_check_render. Use false whenever rendering more than one video.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
-    async ({ items, audio_url, duration_seconds, random_effects, transition, style_preset, background_color }) => {
+    async ({ items, audio_url, duration_seconds, random_effects, transition, style_preset, background_color, wait }) => {
       const workspace_id = getMcpAuth()?.workspace_id;
-      const result = await callApi("/internal/generate-video", {
+      const apiCall = () => callApi("/internal/generate-video", {
         timeoutMs: 3e5,
         // local renders pay a cold webpack bundle; Lambda is fast but bursty
         body: {
@@ -18485,6 +18593,21 @@ Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by defau
           workspace_id
         }
       });
+      if (wait === false) {
+        const job = createJob("clipform_generate_video");
+        apiCall().then((r) => {
+          if (r.ok) completeJob(job.id, r.data);
+          else failJob(job.id, r.error);
+        }).catch((err) => failJob(job.id, err instanceof Error ? err.message : String(err)));
+        return textResult(
+          [
+            `Render started (${items.length} item${items.length > 1 ? "s" : ""}).`,
+            `Job ID: ${job.id}`,
+            `Fire any remaining renders now, then poll clipform_check_render. Renders typically take ${RENDER_TIMING.expectedRange}.`
+          ].join("\n")
+        );
+      }
+      const result = await apiCall();
       if (!result.ok) return errorResult(result.error);
       const data = result.data;
       return textResult(
@@ -18498,23 +18621,6 @@ Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by defau
   );
 }
 
-// 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 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/check-render.ts
 function registerCheckRenderTool(server) {
   server.registerTool(
@@ -18867,4 +18973,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-46RSQK6L.js.map
+//# sourceMappingURL=chunk-LSANXDSD.js.map