@mindstudio-ai/agent 0.1.146 → 0.1.148

package/llms.txt

@@ -264,6 +264,16 @@ Automatically add subtitles to a video
 - Input: `{ videoUrl: string, language: string, fontName: string, fontSize: number, fontWeight: "normal" | "bold" | "black", fontColor: "white" | "black" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta", highlightColor: "white" | "black" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta", strokeWidth: number, strokeColor: "black" | "white" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta", backgroundColor: "black" | "white" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta" | "none", backgroundOpacity: number, position: "top" | "center" | "bottom", yOffset: number, wordsPerSubtitle: number, enableAnimation: boolean, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
+#### addThumbnailToVideo
+Set a video's thumbnail: embedded as its cover art, and optionally as its opening frames
+- Almost everything that shows a video without a poster shows its first frame (a web page's video, link previews, the platform's own), so a video that fades in from black has a black thumbnail
+- Pass the thumbnail as `imageUrl` (a designed cover) or as `at`, a moment of the video in seconds
+- The thumbnail is always embedded as the video's cover art, its streams copied as they are; desktop players and file browsers show it, browsers and social platforms don't
+- `asFirstFrame` also shows it for the video's first 0.2 seconds, fitted to the frame over black, so first-frame thumbnails are it too; that re-encodes the video, keeping its length and audio
+- Returns the video as an mp4, and the thumbnail as `thumbnailUrl` (a png) for a web page's poster or a platform that takes a cover image
+- Input: `{ videoUrl: string, imageUrl?: string, at?: number, asFirstFrame?: boolean, intermediateAsset?: boolean }`
+- Output: `{ videoUrl: string, thumbnailUrl: string }`
+
 #### analyzeImage
 Analyze an image using a vision model based on a text prompt.
 - Uses the configured vision model to generate a text analysis of the image.
@@ -666,7 +676,7 @@ Render an HTML composition (HTML, CSS, media and seekable animation on a timelin
 - `variables` overrides the composition's `data-composition-variables` defaults, which it reads with `window.__hyperframes.getVariables()`
 - Whatever the composition loads itself (fonts, scripts, images, video) is fetched as it renders, so each is in the project or at a public URL; a private app file needs a signed URL
 - fps 24, 30 or 60 (default 30); quality draft, standard or high (default standard); format mp4 (default), webm or mov (both keep transparency), or gif
-- One render per call, finishing within 15 minutes
+- An mp4, webm or mov renders in chunks of about 10 seconds side by side, so a long video takes little longer than a short one; a call finishes within about 30 minutes, and reports its progress as it goes. A gif renders whole, within 15 minutes
 - A composition HyperFrames can't render fails with HyperFrames' own reason
 - Input: `{ html?: string, project?: string, entryFile?: string, variables?: object, fps?: 24 | 30 | 60, quality?: "draft" | "standard" | "high", format?: "mp4" | "webm" | "mov" | "gif", intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string, durationSec: number, frames: number }`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/agent",
-  "version": "0.1.146",
+  "version": "0.1.148",
   "description": "TypeScript SDK for MindStudio direct step execution",
   "type": "module",
   "main": "./dist/index.js",