@clipform/mcp-server 2.1.2 → 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-MU3YSUGG.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({
@@ -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-MU3YSUGG.js.map
+//# sourceMappingURL=chunk-PI3KAC3M.js.map