@mindstudio-ai/agent 0.1.6 → 0.1.9

package/llms.txt

@@ -243,7 +243,7 @@ Input shows the first argument object. Output shows the fields available on the
 #### addSubtitlesToVideo
 Automatically add subtitles to a video
 - Can control style of text and animation
-- 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, skipAssetCreation?: boolean }`
+- 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 }`
 
 #### analyzeImage
@@ -265,6 +265,16 @@ Capture a thumbnail from a video at a specified timestamp
 - Input: `{ videoUrl: string, at: number | string }`
 - Output: `{ thumbnailUrl: string }`
 
+#### checkAppRole
+Check whether the current user has a specific app role and branch accordingly.
+- Checks if the current user has been assigned a specific role in this app.
+- If the user has the role, transitions to the "has role" path.
+- If the user does not have the role, transitions to the "no role" path, or errors if no path is configured.
+- Role names are defined by the app creator and assigned to users via the app roles system.
+- The roleName field supports {{variables}} for dynamic role checks.
+- Input: `{ roleName: string, hasRoleStepId?: string, hasRoleWorkflowId?: string, noRoleStepId?: string, noRoleWorkflowId?: string }`
+- Output: `{ hasRole: boolean, userRoles: string[] }`
+
 #### convertPdfToImages
 Convert each page of a PDF document into a PNG image.
 - Each page is converted to a separate PNG and re-hosted on the CDN.
@@ -411,7 +421,7 @@ Generate an HTML asset and export it as a webpage, PDF, or image
 - If PDF or composited image generation are part of the workflow, assistant adds the block and leaves the "source" empty. In a separate step, assistant generates a detailed request for the developer who will write the HTML.
 - Can also auto-generate HTML from a prompt (like a generate text block to generate HTML). In these cases, create a prompt with variables in the dynamicPrompt variable describing, in detail, the document to generate
 - Can either display output directly to user (foreground mode) or save the URL of the asset to a variable (background mode)
-- Input: `{ source: string, sourceType: "html" | "markdown" | "spa" | "raw" | "dynamic" | "customInterface", outputFormat: "pdf" | "png" | "html" | "mp4" | "openGraph", pageSize: "full" | "letter" | "A4" | "custom", testData: object, options?: { pageWidthPx?: number, pageHeightPx?: number, pageOrientation?: "portrait" | "landscape", rehostMedia?: boolean, videoDurationSeconds?: number }, spaSource?: { source?: string, lastCompiledSource?: string, files?: object, paths: string[], root: string, zipUrl: string }, rawSource?: string, dynamicPrompt?: string, dynamicSourceModelOverride?: { model: string, temperature: number, maxResponseTokens: number, ignorePreamble?: boolean, userMessagePreprocessor?: { dataSource?: string, messageTemplate?: string, maxResults?: number, enabled?: boolean, shouldInherit?: boolean }, preamble?: string, multiModelEnabled?: boolean, editResponseEnabled?: boolean, config?: object }, transitionControl?: "default" | "native", shareControl?: "default" | "hidden", shareImageUrl?: string, skipAssetCreation?: boolean }`
+- Input: `{ source: string, sourceType: "html" | "markdown" | "spa" | "raw" | "dynamic" | "customInterface", outputFormat: "pdf" | "png" | "html" | "mp4" | "openGraph", pageSize: "full" | "letter" | "A4" | "custom", testData: object, options?: { pageWidthPx?: number, pageHeightPx?: number, pageOrientation?: "portrait" | "landscape", rehostMedia?: boolean, videoDurationSeconds?: number }, spaSource?: { source?: string, lastCompiledSource?: string, files?: object, paths: string[], root: string, zipUrl: string }, rawSource?: string, dynamicPrompt?: string, dynamicSourceModelOverride?: { model: string, temperature: number, maxResponseTokens: number, ignorePreamble?: boolean, userMessagePreprocessor?: { dataSource?: string, messageTemplate?: string, maxResults?: number, enabled?: boolean, shouldInherit?: boolean }, preamble?: string, multiModelEnabled?: boolean, editResponseEnabled?: boolean, config?: object }, transitionControl?: "default" | "native", shareControl?: "default" | "hidden", shareImageUrl?: string, intermediateAsset?: boolean }`
 - Output: `{ url: string }`
 
 #### generateChart
@@ -428,20 +438,20 @@ Generate an image from a text prompt using an AI model.
 - In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.
 - When generateVariants is true with numVariants > 1, multiple images are generated in parallel.
 - In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.
-- Input: `{ prompt: string, skipAssetCreation?: boolean, imageModelOverride?: { model: string, config?: object }, generateVariants?: boolean, numVariants?: number, addWatermark?: boolean }`
+- Input: `{ prompt: string, intermediateAsset?: boolean, imageModelOverride?: { model: string, config?: object }, generateVariants?: boolean, numVariants?: number, addWatermark?: boolean }`
 - Output: `{ imageUrl: string | string[] }`
 
 #### generateLipsync
 Generate a lip sync video from provided audio and image.
 - In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.
-- Input: `{ skipAssetCreation?: boolean, addWatermark?: boolean, lipsyncModelOverride?: { model: string, config?: object } }`
+- Input: `{ intermediateAsset?: boolean, addWatermark?: boolean, lipsyncModelOverride?: { model: string, config?: object } }`
 - Output: `unknown`
 
 #### generateMusic
 Generate an audio file from provided instructions (text) using a music model.
 - The text field contains the instructions (prompt) for the music generation.
 - In foreground mode, the audio is displayed to the user. In background mode, the URL is saved to a variable.
-- Input: `{ text: string, skipAssetCreation?: boolean, musicModelOverride?: { model: string, config?: object } }`
+- Input: `{ text: string, intermediateAsset?: boolean, musicModelOverride?: { model: string, config?: object } }`
 - Output: `unknown`
 
 #### generateStaticVideoFromImage
@@ -466,7 +476,7 @@ Generate a video from a text prompt using an AI model.
 - In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.
 - When generateVariants is true with numVariants > 1, multiple videos are generated in parallel.
 - In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.
-- Input: `{ prompt: string, skipAssetCreation?: boolean, videoModelOverride?: { model: string, config?: object }, generateVariants?: boolean, numVariants?: number, addWatermark?: boolean }`
+- Input: `{ prompt: string, intermediateAsset?: boolean, videoModelOverride?: { model: string, config?: object }, generateVariants?: boolean, numVariants?: number, addWatermark?: boolean }`
 - Output: `{ videoUrl: string | string[] }`
 
 #### getGmailAttachments
@@ -508,12 +518,12 @@ Replace a face in an image with a face from another image using AI.
 #### imageRemoveWatermark
 Remove watermarks from an image using AI.
 - Output is re-hosted on the CDN as a PNG.
-- Input: `{ imageUrl: string, engine: string, skipAssetCreation?: boolean }`
+- Input: `{ imageUrl: string, engine: string, intermediateAsset?: boolean }`
 - Output: `{ imageUrl: string }`
 
 #### insertVideoClips
 Insert b-roll clips into a base video at a timecode, optionally with an xfade transition.
-- Input: `{ baseVideoUrl: string, overlayVideos: { videoUrl: string, startTimeSec: number }[], transition?: string, transitionDuration?: number, useOverlayAudio?: boolean, skipAssetCreation?: boolean }`
+- Input: `{ baseVideoUrl: string, overlayVideos: { videoUrl: string, startTimeSec: number }[], transition?: string, transitionDuration?: number, useOverlayAudio?: boolean, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### listDataSources
@@ -559,22 +569,22 @@ Trigger a Make.com (formerly Integromat) scenario via webhook and return the res
 
 #### mergeAudio
 Merge one or more clips into a single audio file.
-- Input: `{ mp3Urls: string[], fileMetadata?: object, albumArtUrl?: string, skipAssetCreation?: boolean }`
+- Input: `{ mp3Urls: string[], fileMetadata?: object, albumArtUrl?: string, intermediateAsset?: boolean }`
 - Output: `{ audioUrl: string }`
 
 #### mergeVideos
 Merge one or more clips into a single video.
-- Input: `{ videoUrls: string[], transition?: string, transitionDuration?: number, skipAssetCreation?: boolean }`
+- Input: `{ videoUrls: string[], transition?: string, transitionDuration?: number, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### mixAudioIntoVideo
 Mix an audio track into a video
-- Input: `{ videoUrl: string, audioUrl: string, options: { keepVideoAudio?: boolean, audioGainDb?: number, videoGainDb?: number, loopAudio?: boolean }, skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, audioUrl: string, options: { keepVideoAudio?: boolean, audioGainDb?: number, videoGainDb?: number, loopAudio?: boolean }, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### muteVideo
 Mute a video file
-- Input: `{ videoUrl: string, skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### n8nRunNode
@@ -601,6 +611,23 @@ Send data to a Zapier Zap via webhook and return the response.
 - Input: `{ webhookUrl: string, input: object }`
 - Output: `{ data: unknown }`
 
+#### queryAppDatabase
+Execute a SQL query against the app managed database.
+- Executes raw SQL against a SQLite database managed by the app.
+- For SELECT queries, returns rows as JSON.
+- For INSERT/UPDATE/DELETE, returns the number of affected rows.
+- Use {{variables}} directly in your SQL. By default they are automatically extracted
+and passed as safe parameterized values (preventing SQL injection).
+Example: INSERT INTO contacts (name, comment) VALUES ({{name}}, {{comment}})
+- Full MindStudio handlebars syntax is supported, including helpers like {{json myVar}},
+{{get myVar "$.path"}}, {{global.orgName}}, etc.
+- Set parameterize to false for raw/dynamic SQL where variables are interpolated directly
+into the query string. Use this when another step generates full or partial SQL, e.g.
+a bulk INSERT with a precomputed VALUES list. The user is responsible for sanitization
+when parameterize is false.
+- Input: `{ databaseId: string, sql: string, parameterize?: boolean }`
+- Output: `{ rows: unknown[], changes: number }`
+
 #### queryDataSource
 Search a vector data source (RAG) and return relevant document chunks.
 - Queries a vectorized data source and returns the most relevant chunks.
@@ -632,7 +659,7 @@ Remove the background from an image using AI, producing a transparent PNG.
 
 #### resizeVideo
 Resize a video file
-- Input: `{ videoUrl: string, mode: "fit" | "exact", maxWidth?: number, maxHeight?: number, width?: number, height?: number, strategy?: "pad" | "crop", skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, mode: "fit" | "exact", maxWidth?: number, maxHeight?: number, width?: number, height?: number, strategy?: "pad" | "crop", intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### runFromConnectorRegistry
@@ -846,7 +873,7 @@ Show the "typing..." indicator in a Telegram chat via a bot.
 Generate an audio file from provided text using a speech model.
 - The text field contains the exact words to be spoken (not instructions).
 - In foreground mode, the audio is displayed to the user. In background mode, the URL is saved to a variable.
-- Input: `{ text: string, skipAssetCreation?: boolean, speechModelOverride?: { model: string, config?: object } }`
+- Input: `{ text: string, intermediateAsset?: boolean, speechModelOverride?: { model: string, config?: object } }`
 - Output: `{ audioUrl: string }`
 
 #### transcribeAudio
@@ -857,7 +884,7 @@ Convert an audio file to text using a transcription model.
 
 #### trimMedia
 Trim an audio or video clip
-- Input: `{ inputUrl: string, start?: number | string, duration?: string | number, skipAssetCreation?: boolean }`
+- Input: `{ inputUrl: string, start?: number | string, duration?: string | number, intermediateAsset?: boolean }`
 - Output: `{ mediaUrl: string }`
 
 #### updateGmailLabels
@@ -886,33 +913,33 @@ Increase the resolution of an image using AI upscaling.
 
 #### upscaleVideo
 Upscale a video file
-- Input: `{ videoUrl: string, targetResolution: "720p" | "1080p" | "2K" | "4K", engine: "standard" | "pro" | "ultimate" | "flashvsr" | "seedance" | "seedvr2" | "runwayml/upscale-v1", skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, targetResolution: "720p" | "1080p" | "2K" | "4K", engine: "standard" | "pro" | "ultimate" | "flashvsr" | "seedance" | "seedvr2" | "runwayml/upscale-v1", intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### videoFaceSwap
 Swap faces in a video file
-- Input: `{ videoUrl: string, faceImageUrl: string, targetIndex: number, engine: string, skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, faceImageUrl: string, targetIndex: number, engine: string, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### videoRemoveBackground
 Remove or replace background from a video
-- Input: `{ videoUrl: string, newBackground: "transparent" | "image", newBackgroundImageUrl?: string, engine: string, skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, newBackground: "transparent" | "image", newBackgroundImageUrl?: string, engine: string, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### videoRemoveWatermark
 Remove a watermark from a video
-- Input: `{ videoUrl: string, engine: string, skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, engine: string, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 #### watermarkImage
 Overlay a watermark image onto another image.
 - The watermark is placed at the specified corner with configurable padding and width.
-- Input: `{ imageUrl: string, watermarkImageUrl: string, corner: "top-left" | "top-right" | "bottom-left" | "bottom-right", paddingPx: number, widthPx: number, skipAssetCreation?: boolean }`
+- Input: `{ imageUrl: string, watermarkImageUrl: string, corner: "top-left" | "top-right" | "bottom-left" | "bottom-right", paddingPx: number, widthPx: number, intermediateAsset?: boolean }`
 - Output: `{ imageUrl: string }`
 
 #### watermarkVideo
 Add an image watermark to a video
-- Input: `{ videoUrl: string, imageUrl: string, corner: "top-left" | "top-right" | "bottom-left" | "bottom-right", paddingPx: number, widthPx: number, skipAssetCreation?: boolean }`
+- Input: `{ videoUrl: string, imageUrl: string, corner: "top-left" | "top-right" | "bottom-left" | "bottom-right", paddingPx: number, widthPx: number, intermediateAsset?: boolean }`
 - Output: `{ videoUrl: string }`
 
 ### ActiveCampaign
@@ -1313,9 +1340,12 @@ Get all the reels for an Instagram profile
 #### postToLinkedIn
 Create a post on LinkedIn from the connected account.
 - Requires a LinkedIn OAuth connection (connectionId).
-- Supports text posts, image posts, and video posts.
+- Supports text posts, image posts, video posts, document posts, and article posts.
+- Attach one media type per post: image, video, document, or article.
+- Documents support PDF, PPT, PPTX, DOC, DOCX (max 100MB, 300 pages). Displays as a slideshow carousel.
+- Articles create a link preview with optional custom title, description, and thumbnail.
 - Visibility controls who can see the post.
-- Input: `{ message: string, visibility: "PUBLIC" | "CONNECTIONS", videoUrl?: string, descriptionText?: string, titleText?: string, imageUrl?: string, connectionId?: string }`
+- Input: `{ message: string, visibility: "PUBLIC" | "CONNECTIONS", imageUrl?: string, videoUrl?: string, documentUrl?: string, articleUrl?: string, titleText?: string, descriptionText?: string, connectionId?: string }`
 - Output: `unknown`
 
 ### Meta Threads

package/package.json

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