@clipform/mcp-server 1.41.0 → 1.44.0

package/dist/{chunk-EZHJR3UM.js → chunk-BRHXMMZH.js}

@@ -3,7 +3,7 @@ import {
   FORM_TYPE_KEYS,
   callApi,
   getSessionContext
-} from "./chunk-WCC65GB5.js";
+} from "./chunk-5GITXD5V.js";
 
 // src/lib/guides.ts
 var guidesPromise = null;
@@ -136,4 +136,4 @@ export {
   getGuideUri,
   registerResources
 };
-//# sourceMappingURL=chunk-EZHJR3UM.js.map
+//# sourceMappingURL=chunk-BRHXMMZH.js.map

package/dist/{chunk-UGVXQM5S.js → chunk-YAJTUAON.js}

@@ -2,7 +2,7 @@ import {
   WORKFLOW_TYPES,
   getDiscoveryParams,
   getSessionContextWithAuth
-} from "./chunk-WCC65GB5.js";
+} from "./chunk-5GITXD5V.js";
 import {
   __export
 } from "./chunk-HCZI2UJ5.js";
@@ -4705,4 +4705,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-UGVXQM5S.js.map
+//# sourceMappingURL=chunk-YAJTUAON.js.map

package/dist/{chunk-CILPQ5ZL.js → chunk-YZMZME25.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-UGVXQM5S.js";
+} from "./chunk-YAJTUAON.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -14,7 +14,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-EZHJR3UM.js";
+} from "./chunk-BRHXMMZH.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -34,7 +34,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-WCC65GB5.js";
+} from "./chunk-5GITXD5V.js";
 import {
   __commonJS,
   __export,
@@ -17070,22 +17070,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 +17095,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) {
@@ -17229,42 +17214,34 @@ Example: A form that asks a question, collects contact info, then finishes:
           }
         }
       }
+      for (const q of nodes) {
+        applyNodeDefaults(q);
+      }
+      const settings = {};
+      if (show_step_counter !== void 0) settings.show_step_counter = show_step_counter;
+      if (disable_back_navigation !== void 0) settings.disable_back_navigation = disable_back_navigation;
+      if (primary_color !== void 0) settings.primary_color = primary_color;
+      if (background_color !== void 0) settings.background_color = background_color;
       const createResult = await callApi("/forms", {
         method: "POST",
-        body: { title, workspace_id: workspaceId }
+        body: {
+          title,
+          workspace_id: workspaceId,
+          nodes,
+          ...Object.keys(settings).length > 0 ? { settings } : {}
+        }
       });
       if (!createResult.ok) {
-        return errorResult(createResult.error);
+        return errorResult(`Form NOT created (nothing was saved): ${createResult.error}`);
       }
       const { data } = createResult;
       const formId = data.form_id;
       const formUrl = data.form_url ?? void 0;
-      const settingsBody = {};
-      if (show_step_counter !== void 0) settingsBody.show_step_counter = show_step_counter;
-      if (disable_back_navigation !== void 0) settingsBody.disable_back_navigation = disable_back_navigation;
-      if (primary_color !== void 0) settingsBody.primary_color = primary_color;
-      if (background_color !== void 0) settingsBody.background_color = background_color;
-      if (font_family !== void 0) settingsBody.font_family = font_family;
-      if (Object.keys(settingsBody).length > 0) {
+      const createdNodes = data.nodes ?? [];
+      if (font_family !== void 0) {
         await callApi(`/forms/${formId}`, {
           method: "PATCH",
-          body: settingsBody
-        });
-      }
-      const createdNodes = [];
-      for (const q of nodes) {
-        applyNodeDefaults(q);
-        const addResult = await callApi(`/forms/${formId}/nodes`, {
-          method: "POST",
-          body: { node: q }
-        });
-        if (!addResult.ok) {
-          return errorResult(`Failed to add node "${q.prompt}": ${addResult.error}`);
-        }
-        createdNodes.push({
-          id: addResult.data.node_id,
-          type: q.type,
-          prompt: q.prompt
+          body: { font_family }
         });
       }
       if (tags && tags.length > 0) {
@@ -17648,7 +17625,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."
   )
@@ -18458,6 +18435,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])})`;
@@ -18465,6 +18450,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(
@@ -18675,7 +18661,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);
@@ -18952,6 +18945,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."
@@ -19014,4 +19008,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-CILPQ5ZL.js.map
+//# sourceMappingURL=chunk-YZMZME25.js.map