@clipform/mcp-server 1.34.0 → 1.35.0

package/dist/{chunk-ZVHI2V7B.js → chunk-G6JFAKX3.js}

@@ -6,14 +6,14 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-JOJJ2XFL.js";
+} from "./chunk-6MLZZSNM.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
   getGuideContent,
   getGuideUri,
   registerResources
-} from "./chunk-JID43EDM.js";
+} from "./chunk-TMNXECJI.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -29,7 +29,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-KWEBCAPF.js";
+} from "./chunk-BYJMRIB6.js";
 import {
   __commonJS,
   __export,
@@ -16984,22 +16984,29 @@ var END_SCREEN_ICONS = _endScreen.icon.enum;
 var END_SCREEN_CTA_TYPES = _endScreen.cta_type.enum;
 var PUBLIC_COMPOSITIONS = [
   "GlobeToCity",
-  "CityToGlobe"
-];
-var LABS_COMPOSITIONS = [
+  "CityToGlobe",
+  "MapPin",
+  "Grid",
+  "GridList",
+  "ObscuredReveal",
+  "Timeline",
+  "NumberLine",
+  "CountdownRing",
   "CountrySilhouetteClip",
-  "FourImageGrid",
-  "OddOneOutReveal",
   "FlagRevealGB",
   "FlagRevealJP",
   "FlagRevealBR",
   "ColorCards",
   "TextReveal",
   "EmojiPuzzle",
-  "StatCounter",
-  "ListReveal",
   "BeforeAfter",
-  "MediaSlideshow"
+  "MediaSlideshow",
+  "TitleCard",
+  "ParallaxImage"
+];
+var LABS_COMPOSITIONS = [
+  "StatCounter",
+  "ListReveal"
 ];
 var EXPOSED_COMPOSITIONS = process.env.CLIPFORM_LABS === "1" ? [...PUBLIC_COMPOSITIONS, ...LABS_COMPOSITIONS] : PUBLIC_COMPOSITIONS;
 
@@ -18267,6 +18274,98 @@ Example: { queries: [{ query: "saturn rings" }, { query: "mars surface", count:
   );
 }
 
+// ../../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/render-composition.ts
 function registerRenderCompositionTool(server) {
   server.registerTool(
@@ -18275,19 +18374,22 @@ function registerRenderCompositionTool(server) {
       title: "Render Composition",
       description: `Render a specialised video composition to MP4 or PNG - custom animated visuals that clipform_generate_video can't provide, such as geography animations or designed motion graphics. Available composition names and their required input props schemas come from clipform_list_compositions.
 
-For narrated Ken Burns slideshows from images, use clipform_generate_video instead. Output formats: mp4 (H.264, best for social media) or png (single frame). Returns a public URL when complete.`,
+For narrated Ken Burns slideshows from images, use clipform_generate_video instead. Output formats: mp4 (H.264, best for social media) or png (single frame). Returns a public URL when complete.
+
+For multi-render builds (e.g. composition quizzes with a clue + reveal clip per question), pass wait: false on every call: each returns a job ID immediately so renders run in parallel - then collect URLs with clipform_check_render.`,
       inputSchema: {
         compositionId: external_exports.string().describe(`The composition ID. Call clipform_list_compositions to see available options (e.g. ${EXPOSED_COMPOSITIONS.map((id) => `'${id}'`).join(", ")})`),
         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 schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (GlobeToCity, CityToGlobe), round lat/lng to 1 decimal place (e.g. 48.9 instead of 48.8566) \u2014 this improves cache hit rates.")
+        inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props object matching the composition's schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (GlobeToCity, CityToGlobe), round lat/lng to 1 decimal place (e.g. 48.9 instead of 48.8566) \u2014 this improves cache hit rates."),
+        wait: external_exports.boolean().optional().default(true).describe("true (default) blocks until the render 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 clip.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
-    async ({ compositionId, outputFormat, inputProps }) => {
+    async ({ compositionId, outputFormat, inputProps, wait }) => {
       if (!EXPOSED_COMPOSITIONS.includes(compositionId)) {
         return errorResult(`Composition "${compositionId}" is not available. Call clipform_list_compositions to see available options.`);
       }
-      const result = await callApi("/internal/render", {
+      const apiCall = () => callApi("/internal/render", {
         timeoutMs: 3e5,
         // local renders pay a cold webpack bundle; Lambda is fast but bursty
         body: {
@@ -18296,6 +18398,21 @@ For narrated Ken Burns slideshows from images, use clipform_generate_video inste
           inputProps: inputProps ?? {}
         }
       });
+      if (wait === false) {
+        const job = createJob("clipform_render_composition");
+        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 (${compositionId}).`,
+            `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(
@@ -18449,98 +18566,6 @@ 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(
@@ -18973,4 +18998,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-ZVHI2V7B.js.map
+//# sourceMappingURL=chunk-G6JFAKX3.js.map