@clipform/mcp-server 2.1.1 → 2.2.0

package/README.md

@@ -72,6 +72,7 @@ Your MCP client lists these automatically on connect (via `tools/list`). Full re
 | `clipform_update_node` | Update one or more existing nodes' text, type, config, or options. |
 | `clipform_delete_node` | Delete a node from a form. |
 | `clipform_upload_media_asset` | Put one or more media files into your workspace media library (max 10, uploaded sequentially). |
+| `clipform_complete_media_upload` | Confirm a signed-PUT still image upload finished, after PUTting the bytes to the upload_url returned by clipform_upload_media_asset. |
 | `clipform_attach_node_media` | Attach an existing workspace media asset (from clipform_upload_media_asset) to one or more nodes (max 10). |
 | `clipform_get_node_media` | Get the media attached to a node, including processing status. |
 | `clipform_delete_node_media` | Remove media from a node. |

package/dist/{chunk-HG3FYVTR.js → chunk-AHJXNS4R.js}

@@ -3,7 +3,7 @@ import {
   FORM_TYPE_KEYS,
   callApi,
   getSessionContext
-} from "./chunk-CNEUXDNC.js";
+} from "./chunk-VY52B6DR.js";
 
 // src/lib/guides.ts
 var guidesPromise = null;
@@ -136,4 +136,4 @@ export {
   getGuideUri,
   registerResources
 };
-//# sourceMappingURL=chunk-HG3FYVTR.js.map
+//# sourceMappingURL=chunk-AHJXNS4R.js.map

package/dist/{chunk-TTSO4ZPG.js → chunk-HWGDTUKS.js}

@@ -2,7 +2,7 @@ import {
   WORKFLOW_TYPES,
   getDiscoveryParams,
   getSessionContextWithAuth
-} from "./chunk-CNEUXDNC.js";
+} from "./chunk-VY52B6DR.js";
 import {
   __export
 } from "./chunk-HCZI2UJ5.js";
@@ -4708,4 +4708,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-TTSO4ZPG.js.map
+//# sourceMappingURL=chunk-HWGDTUKS.js.map

package/dist/{chunk-RQKRLXRN.js → chunk-PI3KAC3M.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-TTSO4ZPG.js";
+} from "./chunk-HWGDTUKS.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -14,7 +14,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-HG3FYVTR.js";
+} from "./chunk-AHJXNS4R.js";
 import {
   ACTIVE_NODE_TYPES,
   BUSINESS,
@@ -33,7 +33,7 @@ import {
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-CNEUXDNC.js";
+} from "./chunk-VY52B6DR.js";
 import {
   __commonJS,
   __export,
@@ -17923,7 +17923,7 @@ When a public URL is provided, the media is fetched and stored automatically. Fo
           resultLines.push(
             `Upload URL: ${uploadUrl}`,
             `Upload method: ${uploadMethod}`,
-            `Upload the file directly to the upload URL using ${uploadMethod === "tus" ? "TUS resumable upload" : "HTTP PUT"}.`
+            uploadMethod === "put" ? `PUT the file's bytes directly to the upload URL, then call clipform_complete_media_upload with media_asset_id ${mediaAssetId} to confirm the upload and mark it ready - it stays invisible in the library until you do.` : `Upload the file directly to the upload URL using TUS resumable upload.`
           );
         } else {
           resultLines.push(`Media stored in the workspace library.`);
@@ -17945,6 +17945,54 @@ When a public URL is provided, the media is fetched and stored automatically. Fo
   );
 }
 
+// src/tools/complete-media-upload.ts
+function registerCompleteMediaUploadTool(server) {
+  server.registerTool(
+    "clipform_complete_media_upload",
+    {
+      title: "Complete Media Upload",
+      description: `Confirm a signed-PUT still image upload finished, after PUTting the bytes to the upload_url returned by clipform_upload_media_asset. The API verifies the object actually landed in storage before flipping the asset from processing to ready - call this right after the PUT succeeds, or the asset stays invisible in the library. Not needed for video uploads (TUS/Mux settle automatically).`,
+      inputSchema: {
+        media_asset_id: external_exports.string().uuid().describe("The media_asset_id returned by clipform_upload_media_asset for the still image")
+      },
+      outputSchema: {
+        media_asset_id: external_exports.string(),
+        status: external_exports.string().describe("The asset's status after this call - ready on success, or its already-settled status when called again (noop)")
+      },
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ media_asset_id }) => {
+      const meResult = await callApi("/me", { method: "GET" });
+      if (!meResult.ok) {
+        return errorResult(`Unable to determine workspace: ${meResult.error}`);
+      }
+      const me = meResult.data;
+      const workspaceId = me.workspace?.id ?? null;
+      if (!workspaceId) {
+        return errorResult(
+          "No workspace available. This usually means authentication is misconfigured - check your API key or OAuth connection."
+        );
+      }
+      const result = await callApi(`/workspaces/${workspaceId}/media/${media_asset_id}/complete`, {
+        method: "POST",
+        body: { uploaded: true }
+      });
+      if (!result.ok) {
+        return errorResult(result.error);
+      }
+      const status = result.data.status ?? "ready";
+      const noop = Boolean(result.data.noop);
+      const text = noop ? `Media asset ${media_asset_id} was already ${status} - no change made.` : `Media asset ${media_asset_id} is now ${status}.`;
+      return structuredResult(text, { media_asset_id, status });
+    }
+  );
+}
+
 // src/tools/attach-node-media.ts
 var MEDIA_SUPPORTED_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.supports_media).map(([type]) => type);
 var AttachMediaItemSchema = external_exports.object({
@@ -18338,7 +18386,7 @@ var CaptionSchema2 = external_exports.object({
 });
 var TtsItemSchema = external_exports.object({
   text: external_exports.string().min(1).max(5e3).describe("Narration text"),
-  voice: external_exports.enum(["ryan", "sonia", "andrew", "ava", "guy"]).optional().default("ryan").describe("Voice: ryan (British male, clear/articulate), sonia (British female, warm/bright), andrew (American male, smooth/neutral), ava (American female, vibrant/friendly), guy (American male, deep/authoritative). Pick based on the form's topic and audience."),
+  voice: external_exports.enum(["ryan", "sonia", "andrew", "ava", "guy"]).optional().default("ryan").describe("Voice: ryan (British male, clear/articulate), sonia (British female, warm/bright), andrew (American male, smooth/neutral), ava (American female, vibrant/friendly), guy (American male, deep/authoritative). Pick ONE voice for the whole form based on its topic and audience, then reuse that same voice on every item and every call - never mix voices within a form unless the user explicitly asks for more than one."),
   tone: external_exports.string().max(500).optional().describe("Style instructions for how the voice should sound. E.g. 'Speak like an energetic quiz show host, playful and teasing' or 'Warm and conversational, like chatting with a friend'. Infer from context if not specified by the user.")
 });
 function registerGenerateTtsTool(server) {
@@ -18348,7 +18396,7 @@ function registerGenerateTtsTool(server) {
       title: "Generate Text-to-Speech",
       description: `Generate narration audio from text with word-level captions. Use this for quiz question narration, survey introductions, form instructions, or any node that benefits from a human voice. Proactively suggest narration for quizzes and content-rich forms - it significantly improves engagement.
 
-Available voices: ryan (British male, clear), sonia (British female, warm), andrew (American male, smooth), ava (American female, vibrant), guy (American male, deep). Pick the voice that fits the topic - e.g. a London quiz gets ryan or sonia, a US sports quiz gets andrew or guy.
+Available voices: ryan (British male, clear), sonia (British female, warm), andrew (American male, smooth), ava (American female, vibrant), guy (American male, deep). Pick ONE voice that fits the topic - e.g. a London quiz gets ryan or sonia, a US sports quiz gets andrew or guy - and reuse that SAME voice for every item and every call across the whole form. Never mix voices within one form unless the user explicitly asks for multiple voices.
 
 Use the tone parameter to direct HOW the voice speaks. Always set a tone that matches the form's mood - e.g. quizzes: "Energetic and playful, like a quiz show host teasing the audience", surveys: "Professional but warm, encouraging honest answers", personality quizzes: "Curious and reflective". This dramatically improves the narration quality.
 
@@ -19889,6 +19937,7 @@ function createServer(options) {
   registerUpdateNodeTool(server);
   registerDeleteNodeTool(server);
   registerUploadMediaAssetTool(server);
+  registerCompleteMediaUploadTool(server);
   registerAttachNodeMediaTool(server);
   registerGetNodeMediaTool(server);
   registerDeleteNodeMediaTool(server);
@@ -19919,4 +19968,4 @@ export {
   RENDER_TIMING,
   createServer
 };
-//# sourceMappingURL=chunk-RQKRLXRN.js.map
+//# sourceMappingURL=chunk-PI3KAC3M.js.map