@clipform/mcp-server 1.44.3 → 1.44.4

package/dist/{chunk-MIH452WS.js → chunk-MSXDS22S.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-VTRO7ZC3.js";
+} from "./chunk-6IRFVCIG.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -18295,6 +18295,27 @@ function pruneJobs() {
 }
 
 // src/tools/render-composition.ts
+var RenderItemSchema = external_exports.object({
+  compositionId: external_exports.string().describe("The composition ID (see clipform_list_compositions)"),
+  outputFormat: external_exports.enum(["mp4", "png"]).default("mp4").describe("Output format (default: mp4)"),
+  inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props matching the composition's schema - validated strictly")
+});
+function fireRender(item) {
+  const job = createJob("clipform_render_composition");
+  callApi("/internal/render", {
+    timeoutMs: 3e5,
+    // local renders pay a cold webpack bundle; Lambda is fast but bursty
+    body: {
+      compositionId: item.compositionId,
+      outputFormat: item.outputFormat,
+      inputProps: item.inputProps ?? {}
+    }
+  }).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 job;
+}
 function registerRenderCompositionTool(server) {
   server.registerTool(
     "clipform_render_composition",
@@ -18304,34 +18325,40 @@ function registerRenderCompositionTool(server) {
 
 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.`,
+For multi-render builds (e.g. one clip per quiz question), pass everything in ONE call via items (max 10): all renders fire in parallel and you get one job ID each - then collect the URLs in a single clipform_check_render call with job_ids. Single render: pass compositionId/inputProps at the top level (wait: true blocks and returns the URL; wait: false returns a job ID).`,
       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 (Map), wide shots (camera.zoom < 9) may round lat/lng to 1 decimal place to improve cache hit rates; close shots and pin drops should keep full precision \u2014 the pin lands exactly on `target`."),
-        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.")
+        compositionId: external_exports.string().optional().describe(`Single render: the composition ID. Call clipform_list_compositions to see available options (e.g. ${EXPOSED_COMPOSITIONS.map((id) => `'${id}'`).join(", ")}). Use items instead for multiple renders.`),
+        outputFormat: external_exports.enum(["mp4", "png"]).default("mp4").describe("Single render: output format (default: mp4)"),
+        inputProps: external_exports.record(external_exports.unknown()).optional().describe("Single render: 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 (Map), wide shots (camera.zoom < 9) may round lat/lng to 1 decimal place to improve cache hit rates; close shots and pin drops should keep full precision \u2014 the pin lands exactly on `target`."),
+        wait: external_exports.boolean().optional().default(true).describe("Single render only: true (default) blocks until the render is ready and returns its URL; false returns a job ID for clipform_check_render. Batch items always run fire-and-poll."),
+        items: external_exports.array(RenderItemSchema).min(1).max(10).optional().describe("Batch mode: multiple renders in one call. All fire in parallel; returns one job ID per item - collect with clipform_check_render (job_ids). Use this whenever rendering more than one clip.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
-    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.`);
+    async ({ compositionId, outputFormat, inputProps, wait, items }) => {
+      if (items?.length && compositionId) {
+        return errorResult("Pass EITHER items (batch) OR compositionId (single render), not both.");
+      }
+      if (!items?.length && !compositionId) {
+        return errorResult("Pass compositionId for a single render, or items for a batch.");
+      }
+      const unknown2 = (items ?? [{ compositionId, outputFormat, inputProps }]).map((i) => i.compositionId).filter((id) => !EXPOSED_COMPOSITIONS.includes(id));
+      if (unknown2.length) {
+        return errorResult(`Composition${unknown2.length > 1 ? "s" : ""} ${unknown2.map((id) => `"${id}"`).join(", ")} not available. Call clipform_list_compositions to see available options.`);
+      }
+      if (items?.length) {
+        const jobs2 = items.map((item) => ({ item, job: fireRender(item) }));
+        return textResult(
+          [
+            `${jobs2.length} renders started in parallel:`,
+            ...jobs2.map(({ item, job }) => `- ${item.compositionId} (${item.outputFormat}): job ${job.id}`),
+            ``,
+            `Collect with ONE clipform_check_render call (job_ids: [...]). Renders typically take ${RENDER_TIMING.expectedRange}.`
+          ].join("\n")
+        );
       }
-      const apiCall = () => callApi("/internal/render", {
-        timeoutMs: 3e5,
-        // local renders pay a cold webpack bundle; Lambda is fast but bursty
-        body: {
-          compositionId,
-          outputFormat,
-          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)));
+        const job = fireRender({ compositionId, outputFormat, inputProps });
         return textResult(
           [
             `Render started (${compositionId}).`,
@@ -18340,7 +18367,10 @@ For multi-render builds (e.g. composition quizzes with a clue + reveal clip per
           ].join("\n")
         );
       }
-      const result = await apiCall();
+      const result = await callApi("/internal/render", {
+        timeoutMs: 3e5,
+        body: { compositionId, outputFormat, inputProps: inputProps ?? {} }
+      });
       if (!result.ok) return errorResult(result.error);
       const data = result.data;
       return textResult(
@@ -18607,53 +18637,88 @@ For multi-question builds, pass wait: false on every render: each call returns a
 }
 
 // src/tools/check-render.ts
+var LOST_JOB_RECOVERY = [
+  `Jobs expire after 30 minutes and are lost if the server restarts - the render itself may still have completed.`,
+  `To recover, re-run the original render call with identical arguments:`,
+  `- clipform_render_composition results are content-cached: a finished render returns its URL immediately without re-rendering.`,
+  `- clipform_generate_video is not cached and will re-render.`
+].join("\n");
+function describeJob(id, job) {
+  if (!job) {
+    return { line: `- ${id}: NOT FOUND`, done: true, failed: true };
+  }
+  if (job.status === "rendering") {
+    const elapsed = Math.round((Date.now() - job.createdAt) / 1e3);
+    return { line: `- ${id}: rendering (${elapsed}s elapsed)`, done: false, failed: false };
+  }
+  if (job.status === "failed") {
+    return { line: `- ${id}: FAILED - ${job.error}`, done: true, failed: true };
+  }
+  const data = job.result;
+  const extras = [
+    ...data.public_url ? [data.public_url] : [],
+    ...data.duration_seconds ? [`${data.duration_seconds}s`] : []
+  ].join(" | ");
+  return { line: `- ${id}: complete${extras ? ` - ${extras}` : ""}`, done: true, failed: false };
+}
 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 or clipform_render_composition.
+      description: `Check the status of render jobs started by clipform_generate_video or clipform_render_composition.
 
-Returns the current status and, when complete, the output URL. Typical render time: 10-60 seconds.`,
+Pass job_ids to check a whole batch in ONE call - one line of status per job. Pass job_id for a single job. Returns the output URL for each completed render. Typical render time: 10-60 seconds.`,
       inputSchema: {
-        job_id: external_exports.string().uuid().describe("The job ID returned by the render tool")
+        job_id: external_exports.string().uuid().optional().describe("A single job ID returned by the render tool"),
+        job_ids: external_exports.array(external_exports.string().uuid()).min(1).max(20).optional().describe("Multiple job IDs - check the whole batch in one call instead of one call per job")
       },
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    async ({ job_id }) => {
+    async ({ job_id, job_ids }) => {
       pruneJobs();
-      const job = getJob(job_id);
-      if (!job) {
-        return errorResult(
-          [
-            `No render job found with ID ${job_id}. Jobs expire after 30 minutes and are lost if the server restarts - the render itself may still have completed.`,
-            `To recover, re-run the original render call with identical arguments:`,
-            `- clipform_render_composition results are content-cached: a finished render returns its URL immediately without re-rendering.`,
-            `- clipform_generate_video is not cached and will re-render.`
-          ].join("\n")
-        );
-      }
-      if (job.status === "rendering") {
-        const elapsed = Math.round((Date.now() - job.createdAt) / 1e3);
+      const ids = job_ids?.length ? job_ids : job_id ? [job_id] : [];
+      if (!ids.length) {
+        return errorResult("Pass job_id (single) or job_ids (batch).");
+      }
+      if (ids.length === 1) {
+        const job = getJob(ids[0]);
+        if (!job) {
+          return errorResult(`No render job found with ID ${ids[0]}. ${LOST_JOB_RECOVERY}`);
+        }
+        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: rendering (${elapsed}s elapsed)`,
-            `Tool: ${job.tool}`,
-            ``,
-            `Still in progress. Check again in ${RENDER_TIMING.pollDelay}.`
+            `Render complete.`,
+            ...data.public_url ? [`Public URL: ${data.public_url}`] : [],
+            ...data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : [],
+            `Attach via clipform_upload_node_media with fit_media: true (composed 9:16 frame - contain, never crop).`
           ].join("\n")
         );
       }
-      if (job.status === "failed") {
-        return errorResult(`Render failed: ${job.error}`);
-      }
-      const data = job.result;
+      const results = ids.map((id) => describeJob(id, getJob(id)));
+      const pending = results.filter((r) => !r.done).length;
+      const lost = results.some((r) => r.line.includes("NOT FOUND"));
       return textResult(
         [
-          `Render complete.`,
-          ...data.public_url ? [`Public URL: ${data.public_url}`] : [],
-          ...data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : [],
-          `Attach via clipform_upload_node_media with fit_media: true (composed 9:16 frame - contain, never crop).`
+          `Render batch: ${results.length - pending}/${results.length} finished${pending ? ` - check again in ${RENDER_TIMING.pollDelay}` : ""}.`,
+          ...results.map((r) => r.line),
+          ...pending === 0 ? [``, `Attach completed renders via clipform_upload_node_media with fit_media: true (composed 9:16 frames - contain, never crop).`] : [],
+          ...lost ? [``, LOST_JOB_RECOVERY] : []
         ].join("\n")
       );
     }
@@ -18970,4 +19035,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-MIH452WS.js.map
+//# sourceMappingURL=chunk-MSXDS22S.js.map