@clipform/mcp-server 1.42.0 → 1.44.1

package/dist/{chunk-GP5MEBVL.js → chunk-VW2HF4TZ.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-UGVXQM5S.js";
+} from "./chunk-T6B4O3O7.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -14,11 +14,10 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-EZHJR3UM.js";
+} from "./chunk-GAAMMQM3.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
-  FEATURES,
   FORM_TYPE_ALIASES,
   KEN_BURNS_EFFECTS,
   KEN_BURNS_FIT_MODES,
@@ -34,7 +33,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-WCC65GB5.js";
+} from "./chunk-PCCTN3T7.js";
 import {
   __commonJS,
   __export,
@@ -17070,22 +17069,7 @@ var NODE_TYPES_DESCRIPTION = (() => {
   }
   return lines.join("\n");
 })();
-var CONFIG_DESCRIPTION = (() => {
-  const lines = ["Type-specific configuration. Omit to use defaults. Per-type keys:"];
-  for (const type of ACTIVE_NODE_TYPES) {
-    const def = NODE_TYPES[type];
-    const summary = generateConfigSummary(def.config_schema, type);
-    if (summary) {
-      let line = `  ${type}: ${summary}`;
-      const defaultStr = formatDefaultConfig(def.default_config);
-      if (defaultStr) {
-        line += `. Defaults: ${defaultStr}`;
-      }
-      lines.push(line);
-    }
-  }
-  return lines.join("\n");
-})();
+var CONFIG_FIELD_DESCRIPTION = "Type-specific configuration keyed by node type. Omit to use defaults. Per-type keys, shapes, and defaults are listed in the clipform_create_form description; craft guidance via clipform_get_guide.";
 var STYLE_PRESET_ENUM = external_exports.enum(KEN_BURNS_PRESETS).describe(`Ken Burns style preset: ${KEN_BURNS_PRESETS.join(", ")}`);
 var OptionSchema = external_exports.object({
   content: external_exports.string().describe("Option text"),
@@ -17110,7 +17094,7 @@ var NodeSchema = external_exports.object({
   prompt: external_exports.string().describe("The text shown to the respondent"),
   label: external_exports.string().optional().describe("Short label for the node (used in logic builder). Defaults to the prompt text."),
   required: external_exports.boolean().optional().default(true),
-  config: external_exports.record(external_exports.unknown()).optional().describe(CONFIG_DESCRIPTION),
+  config: external_exports.record(external_exports.unknown()).optional().describe(CONFIG_FIELD_DESCRIPTION),
   options: external_exports.array(OptionSchema).optional().describe(OPTIONS_DESCRIPTION)
 });
 function applyNodeDefaults(node) {
@@ -17640,7 +17624,7 @@ var NodeUpdateSchema = external_exports.object({
   label: external_exports.string().optional().describe("Short label for the node (used in logic builder)"),
   type: external_exports.enum(ACTIVE_NODE_TYPES).optional().describe("Change the node type"),
   required: external_exports.boolean().optional().describe("Whether an answer is required"),
-  config: external_exports.record(external_exports.unknown()).optional().describe(CONFIG_DESCRIPTION),
+  config: external_exports.record(external_exports.unknown()).optional().describe(CONFIG_FIELD_DESCRIPTION),
   options: external_exports.array(OptionSchema).optional().describe(
     "Replace all options (for choice nodes). Omit to keep existing options."
   )
@@ -17912,42 +17896,6 @@ function registerDeleteNodeMediaTool(server) {
   );
 }
 
-// src/tools/attach-node-audio.ts
-function registerAttachNodeAudioTool(server) {
-  if (!FEATURES.audio_attachments.enabled) return;
-  server.registerTool(
-    "clipform_attach_audio",
-    {
-      title: "Attach Audio to Node",
-      description: `Attach an audio file to a form node - takes a URL from clipform_search_music or any public audio file. Use this for quiz answer sound effects, ambient audio on welcome screens, or background music on any node. The audio auto-plays once when a respondent reaches the node (replays if they return). Accepts WAV, MP3, or OGG. The node must already have an image or video attached via clipform_upload_node_media.`,
-      inputSchema: {
-        form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
-        node_id: external_exports.string().describe("The node ID (must already have media attached)"),
-        url: external_exports.string().url().describe("Public URL to the audio file (WAV, MP3, or OGG)")
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: true
-      }
-    },
-    async ({ form_id, node_id, url }) => {
-      const result = await callApi(
-        `/forms/${form_id}/nodes/${node_id}/audio`,
-        {
-          method: "PUT",
-          body: { url }
-        }
-      );
-      if (!result.ok) {
-        return errorResult(result.error);
-      }
-      return textResult(`Audio attached to node ${node_id}.`);
-    }
-  );
-}
-
 // src/tools/set-node-logic.ts
 var LogicRuleSchema = external_exports.object({
   option_content: external_exports.string().optional().describe(
@@ -18411,7 +18359,7 @@ function registerSearchMusicTool(server) {
     "clipform_search_music",
     {
       title: "Search Music",
-      description: `Search for royalty-free music tracks and ambient sounds. Quiz forms especially benefit from background music - it keeps energy up between questions. Also consider it for multi-step surveys and longer forms. Use with clipform_attach_audio to add a track to a form node. Returns download URLs, duration, artist, and license info.`,
+      description: `Search for royalty-free music tracks and ambient sounds. Quiz forms especially benefit from background music - it keeps energy up between questions. Also consider it for multi-step surveys and longer forms. Pass the returned URL as the audio track to clipform_generate_video or clipform_generate_slideshow. Returns download URLs, duration, artist, and license info.`,
       inputSchema: {
         query: external_exports.string().describe("What to search for (e.g. 'upbeat quiz background', 'calm ambient', 'playful pizzicato')"),
         count: external_exports.number().min(1).max(10).default(5).optional().describe("Max results (default: 5)"),
@@ -18450,6 +18398,14 @@ function summarizeSchema(schema) {
     return "none (renders built-in defaults only - omit inputProps)";
   }
   const required2 = new Set(schema.required ?? []);
+  const keysOf = (prop) => {
+    const props = prop.properties;
+    if (!props) return "object";
+    const req = new Set(prop.required ?? []);
+    const keys = Object.keys(props).map((k) => `${k}${req.has(k) ? "" : "?"}`);
+    const shown = keys.length > 10 ? [...keys.slice(0, 10), `+${keys.length - 10} more`] : keys;
+    return `{${shown.join(", ")}}`;
+  };
   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])})`;
@@ -18457,6 +18413,7 @@ function summarizeSchema(schema) {
     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 ?? {})}[]`;
+    if (prop.type === "object" || prop.properties) return keysOf(prop);
     return prop.type ?? "object";
   };
   const parts = Object.entries(schema.properties).map(
@@ -18667,7 +18624,14 @@ Returns the current status and, when complete, the output URL. Typical render ti
       pruneJobs();
       const job = getJob(job_id);
       if (!job) {
-        return errorResult(`No render job found with ID ${job_id}. Jobs expire after 30 minutes.`);
+        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);
@@ -18944,6 +18908,7 @@ function createServer(options) {
       instructions: [
         "Clipform builds interactive video-style forms. When the brief is clear, build the form directly; when it's vague, ask one or two short questions first.",
         "Prefer rich media: video over images over plain text.",
+        "Before building, derive a register from the topic and audience (e.g. hype, playful, warm, considered, elegant, sombre); if the user states a mood explicitly, that wins. State the register once, then apply it to every rendering choice - narration tone, motion preset, music, pacing. Never mix registers in one form.",
         "At the start of a build, call clipform_get_workflow to load the recipe for the form type, and clipform_get_guide for craft detail.",
         "Every *_id argument is a UUID returned by the tools - not the short share_id from a form URL.",
         "Deleting a form, node, or its media is permanent; those tools ask the user to confirm before running."
@@ -18981,7 +18946,6 @@ function createServer(options) {
   registerUploadNodeMediaTool(server);
   registerGetNodeMediaTool(server);
   registerDeleteNodeMediaTool(server);
-  registerAttachNodeAudioTool(server);
   registerSetNodeLogicTool(server);
   registerLogGenerationTool(server);
   registerSearchNewsTool(server);
@@ -19006,4 +18970,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-GP5MEBVL.js.map
+//# sourceMappingURL=chunk-VW2HF4TZ.js.map