@clipform/mcp-server 2.16.1 → 2.17.0

package/dist/{chunk-TJFD7DVF.js → chunk-HBKYE4JQ.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-IXRZG3GB.js";
+} from "./chunk-2EPNC4AY.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -15,13 +15,14 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-25LEEQMI.js";
+} from "./chunk-5TQU2XJ7.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
   FEATURE_FLAGS,
   FORM_TYPE_ALIASES,
   FULL_CAPS,
+  HTTP_URL_MESSAGE,
   KEN_BURNS_EFFECTS,
   KEN_BURNS_FIT_MODES,
   KEN_BURNS_PRESETS,
@@ -30,6 +31,7 @@ import {
   NODE_TYPES,
   NON_COUNTABLE_TYPES,
   SLIDESHOW_COMPOSITION_TRANSITIONS,
+  SLIDESHOW_TRANSITION_DURATION,
   VIDEO_LOOK_NAMES,
   bfsOrder,
   callApi,
@@ -37,10 +39,11 @@ import {
   defaultTarget,
   errorResult,
   exposedCompositionIds,
+  isHttpUrl,
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-Z4ZGF6OV.js";
+} from "./chunk-FIUAXSVQ.js";
 import {
   getMcpAuth,
   runWithMcpTool
@@ -18604,6 +18607,37 @@ var MediaAssetItemSchema = external_exports.object({
   caption_ref: external_exports.string().optional().describe("caption_ref from clipform_generate_tts - an opaque handle that attaches that TTS run's word-level captions to this asset, resolved server-side. Preferred over captions."),
   ai_generated: external_exports.boolean().optional().describe("Whether this media was AI-generated. Drives the viewer's disclosure chip - set true for AI-rendered/synthesized media.")
 });
+var FileEntrySchema = external_exports.union([
+  external_exports.string(),
+  external_exports.object({
+    download_url: external_exports.string().describe("Short-lived URL the server downloads the file's bytes from"),
+    file_id: external_exports.string().optional().describe("Host-assigned identifier for the attached file"),
+    mime_type: external_exports.string().optional().describe("Declared MIME type - determines whether the file becomes a video or still asset"),
+    name: external_exports.string().optional(),
+    file_name: external_exports.string().optional(),
+    size: external_exports.number().optional()
+  }).passthrough()
+]);
+function mapFileEntryToItem(file) {
+  if (typeof file === "string") {
+    return {
+      ok: false,
+      error: "The attached file was not passed as a downloadable file. Attach it again or provide a direct URL."
+    };
+  }
+  const mimeType = file.mime_type ?? "";
+  const category = mimeType.split("/")[0];
+  if (category === "image") {
+    return { ok: true, item: { media_type: "still", media_source: "uploaded", url: file.download_url } };
+  }
+  if (category === "video") {
+    return { ok: true, item: { media_type: "video", media_source: "uploaded", url: file.download_url } };
+  }
+  return {
+    ok: false,
+    error: `Attached file type "${mimeType || "unknown"}" is not supported. Attach an image or video file, or provide a direct URL instead.`
+  };
+}
 function registerUploadMediaAssetTool(server) {
   server.registerTool(
     "clipform_upload_media_asset",
@@ -18611,9 +18645,12 @@ function registerUploadMediaAssetTool(server) {
       title: "Upload Media Asset",
       description: `Put one or more media files into your workspace media library (max 10, uploaded sequentially). This is step one of attaching media to a node - follow up with clipform_attach_node_media to place the returned media_asset_id on a node.
 
-When a public URL is provided, the media is fetched and stored automatically. For video: ingested via Mux. For image: stored in Supabase. Word-level captions from clipform_generate_tts enable per-word highlighting in the viewer once attached - pass the caption_ref it returned instead of hand-copying the captions array.`,
+When a public URL is provided, the media is fetched and stored automatically. For video: ingested via Mux. For image: stored in Supabase. Word-level captions from clipform_generate_tts enable per-word highlighting in the viewer once attached - pass the caption_ref it returned instead of hand-copying the captions array.
+
+Provide media via \`items\` (explicit type + URL), \`files\` (files attached by the host client), or both. At least one is required.`,
       inputSchema: {
-        items: external_exports.array(MediaAssetItemSchema).min(1).max(10).describe("One or more media items to create as workspace library assets")
+        items: external_exports.array(MediaAssetItemSchema).min(1).max(10).optional().describe("One or more media items to create as workspace library assets"),
+        files: external_exports.array(FileEntrySchema).min(1).max(10).optional().describe("Files attached by the host client. Each becomes a video or still library asset based on its declared mime_type.")
       },
       outputSchema: {
         results: external_exports.array(
@@ -18633,9 +18670,20 @@ When a public URL is provided, the media is fetched and stored automatically. Fo
         destructiveHint: false,
         idempotentHint: false,
         openWorldHint: false
-      }
+      },
+      // Apps SDK convention (openai-apps-sdk-examples#185): a host client only
+      // hydrates a file attachment into a TOP-LEVEL tool argument named here -
+      // same mechanism create-form.ts uses for anthropic/alwaysLoad.
+      _meta: { "openai/fileParams": ["files"] }
     },
-    async ({ items }) => {
+    async ({ items, files }) => {
+      if ((!items || items.length === 0) && (!files || files.length === 0)) {
+        return errorResult("Provide at least one media item via `items` or `files`.");
+      }
+      const totalEntryCount = (items?.length ?? 0) + (files?.length ?? 0);
+      if (totalEntryCount > 10) {
+        return errorResult(`Provide at most 10 media items total across \`items\` and \`files\` (got ${totalEntryCount}).`);
+      }
       const meResult = await callApi("/me", { method: "GET" });
       if (!meResult.ok) {
         return errorResult(`Unable to determine workspace: ${meResult.error}`);
@@ -18647,12 +18695,27 @@ When a public URL is provided, the media is fetched and stored automatically. Fo
           "No workspace available. This usually means authentication is misconfigured - check your API key or OAuth connection."
         );
       }
+      const entries = [
+        ...(items ?? []).map((item) => ({ ok: true, item })),
+        ...(files ?? []).map((file) => {
+          const mapped = mapFileEntryToItem(file);
+          return mapped.ok ? { ok: true, item: mapped.item } : { ok: false, media_type: "unknown", error: mapped.error };
+        })
+      ];
       const lines = [];
       const results = [];
       let successCount = 0;
-      for (let i = 0; i < items.length; i++) {
-        const item = items[i];
-        if (items.length > 1) lines.push(`--- Item ${i + 1} (${item.media_type}) ---`);
+      for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        const entryMediaType = entry.ok ? entry.item.media_type : entry.media_type;
+        if (entries.length > 1) lines.push(`--- Item ${i + 1} (${entryMediaType}) ---`);
+        if (!entry.ok) {
+          lines.push(`FAILED: ${entry.error}`);
+          lines.push("");
+          results.push({ media_type: entry.media_type, stored: false, ok: false, error: entry.error });
+          continue;
+        }
+        const item = entry.item;
         const createBody = {
           media_type: item.media_type,
           media_source: item.media_source
@@ -18705,8 +18768,8 @@ When a public URL is provided, the media is fetched and stored automatically. Fo
         lines.push(resultLines.join("\n"));
         lines.push("");
       }
-      if (items.length > 1) {
-        lines.unshift(`Media asset upload: ${successCount}/${items.length} succeeded
+      if (entries.length > 1) {
+        lines.unshift(`Media asset upload: ${successCount}/${entries.length} succeeded
 `);
       }
       lines.push(`Attach these to nodes with clipform_attach_node_media.`);
@@ -19760,12 +19823,12 @@ function registerSearchMusicTool(server) {
       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. Pass the returned URL as the audio track to clipform_generate_video, or as the audio for the slideshow video template via clipform_render_video_template. 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)"),
+        query: external_exports.string().min(1).describe("What to search for (e.g. 'upbeat quiz background', 'calm ambient', 'playful pizzicato')"),
+        count: external_exports.number().int().min(1).max(10).default(5).optional().describe("Max results (default: 5)"),
         instrumentalOnly: external_exports.boolean().optional().default(true).describe("Only instrumental tracks (default: true)"),
-        minDuration: external_exports.number().optional().describe("Minimum duration in seconds"),
-        maxDuration: external_exports.number().optional().describe("Maximum duration in seconds"),
-        tags: external_exports.array(external_exports.string()).optional().describe("Genre/mood tags to filter by")
+        minDuration: external_exports.number().positive().optional().describe("Minimum duration in seconds"),
+        maxDuration: external_exports.number().positive().optional().describe("Maximum duration in seconds"),
+        tags: external_exports.array(external_exports.string()).optional().describe("Genre/mood tags to filter by. Multiple tags are ANDed together (e.g. ['ambient', 'chill'] matches tracks tagged both).")
       },
       outputSchema: {
         query: external_exports.string(),
@@ -20144,9 +20207,7 @@ function registerListAssetsTool(server) {
 }
 
 // src/tools/generate-video.ts
-var httpUrl = () => external_exports.string().url().refine((v) => /^https?:\/\//i.test(v), {
-  message: "URL must start with http:// or https://"
-});
+var httpUrl = () => external_exports.string().url().refine(isHttpUrl, { message: HTTP_URL_MESSAGE });
 function registerGenerateVideoTool(server) {
   server.registerTool(
     "clipform_generate_video",
@@ -20181,7 +20242,7 @@ ${RENDER_ATTACH_RULE}`,
         random_effects: external_exports.boolean().optional().default(true).describe("Shuffle Ken Burns effects across image items (default: true)"),
         transition: external_exports.object({
           type: external_exports.enum(SLIDESHOW_COMPOSITION_TRANSITIONS).optional().describe(`Advanced override: ${SLIDESHOW_COMPOSITION_TRANSITIONS.join(", ")} - overrides the preset look's own transition`),
-          duration: external_exports.number().optional().describe("Advanced override: transition duration in seconds")
+          duration: external_exports.number().min(SLIDESHOW_TRANSITION_DURATION.min).max(SLIDESHOW_TRANSITION_DURATION.max).optional().describe(`Advanced override: transition duration in seconds (${SLIDESHOW_TRANSITION_DURATION.min}-${SLIDESHOW_TRANSITION_DURATION.max}). For a hard cut use type: 'none' instead - duration is ignored then.`)
         }).optional().describe("Advanced: overrides the preset look's transition"),
         style_preset: STYLE_PRESET_ENUM.optional().describe(`Advanced override: a raw Ken Burns motion preset, overriding the preset look's own motion.`),
         texture: external_exports.object({
@@ -20803,4 +20864,4 @@ export {
   buildInstructions,
   createServer
 };
-//# sourceMappingURL=chunk-TJFD7DVF.js.map
+//# sourceMappingURL=chunk-HBKYE4JQ.js.map