@clipform/mcp-server 1.28.0 → 1.29.0

package/dist/{chunk-GA2W3F3Y.js → chunk-5FG2V7B7.js}

@@ -16986,6 +16986,20 @@ var PUBLIC_COMPOSITIONS = [
   "GlobeToCity",
   "CityToGlobe"
 ];
+var LABS_COMPOSITIONS = [
+  "CountrySilhouetteClip",
+  "FlagRevealGB",
+  "FlagRevealJP",
+  "FlagRevealBR",
+  "ColorCards",
+  "TextReveal",
+  "EmojiPuzzle",
+  "StatCounter",
+  "ListReveal",
+  "BeforeAfter",
+  "MediaSlideshow"
+];
+var EXPOSED_COMPOSITIONS = process.env.CLIPFORM_LABS === "1" ? [...PUBLIC_COMPOSITIONS, ...LABS_COMPOSITIONS] : PUBLIC_COMPOSITIONS;
 
 // src/lib/schemas.ts
 var ACTIVE_NODE_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.is_active && !def.is_system).map(([type]) => type);
@@ -18212,14 +18226,14 @@ 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.`,
       inputSchema: {
-        compositionId: external_exports.string().describe(`The composition ID. Call clipform_list_compositions to see available options (e.g. ${PUBLIC_COMPOSITIONS.map((id) => `'${id}'`).join(", ")})`),
+        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 expected schema. 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.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
     async ({ compositionId, outputFormat, inputProps }) => {
-      if (!PUBLIC_COMPOSITIONS.includes(compositionId)) {
+      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", {
@@ -18280,6 +18294,25 @@ function registerSearchMusicTool(server) {
 }
 
 // src/tools/list-compositions.ts
+function summarizeSchema(schema) {
+  if (!schema || typeof schema !== "object" || !schema.properties) {
+    return "none (renders built-in defaults only - omit inputProps)";
+  }
+  const required2 = new Set(schema.required ?? []);
+  const typeOf = (prop) => {
+    if (prop.enum) {
+      return prop.enum.length <= 8 ? prop.enum.map((v) => JSON.stringify(v)).join("|") : `enum(${prop.enum.length} values, e.g. ${JSON.stringify(prop.enum[0])})`;
+    }
+    if (prop.anyOf) return prop.anyOf.map(typeOf).join(" | ");
+    if (Array.isArray(prop.type)) return prop.type.join("|");
+    if (prop.type === "array") return `${typeOf(prop.items ?? {})}[]`;
+    return prop.type ?? "object";
+  };
+  const parts = Object.entries(schema.properties).map(
+    ([name, prop]) => `${name}${required2.has(name) ? "*" : "?"}: ${typeOf(prop)}`
+  );
+  return parts.join(", ");
+}
 function registerListCompositionsTool(server) {
   server.registerTool(
     "clipform_list_compositions",
@@ -18300,16 +18333,17 @@ function registerListCompositionsTool(server) {
         return errorResult(result.error);
       }
       const all = result.data.compositions;
-      const compositions = all.filter((c) => PUBLIC_COMPOSITIONS.includes(c.id));
+      const compositions = all.filter((c) => EXPOSED_COMPOSITIONS.includes(c.id));
       if (!compositions.length) return textResult("No compositions found.");
       const lines = [`Available compositions (${compositions.length}):
 `];
       for (const comp of compositions) {
         const duration3 = (comp.durationInFrames / comp.fps).toFixed(0);
         lines.push(`- **${comp.id}** \u2014 ${comp.width}x${comp.height}, ${duration3}s`);
+        lines.push(`  props: ${summarizeSchema(comp.propsSchema)}`);
       }
       lines.push("");
-      lines.push("Use clipform_render_composition with a compositionId to render. Pass inputProps matching the composition's schema.");
+      lines.push("Use clipform_render_composition with a compositionId to render. inputProps are validated strictly against the schema - unknown or missing props fail.");
       return textResult(lines.join("\n"));
     }
   );
@@ -18795,4 +18829,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-GA2W3F3Y.js.map
+//# sourceMappingURL=chunk-5FG2V7B7.js.map