@mindstudio-ai/agent 0.1.61 → 0.1.63

package/llms.txt

@@ -433,6 +433,14 @@ Fetch recent message history from a Slack channel.
 - Input: `{ connectionId?: string, channelId: string, limit?: number, startDate?: string, endDate?: string, includeImages?: boolean, includeRawMessage?: boolean }`
 - Output: `{ messages: { from: string, content: string, timestamp?: string, images?: string[], rawMessage?: { app_id?: string, assistant_app_thread?: { first_user_thread_reply?: string, title?: string, title_blocks?: unknown[] }, attachments?: { actions?: unknown[], app_id?: string, app_unfurl_url?: string, author_icon?: string, author_id?: string, author_link?: string, author_name?: string, author_subname?: string, blocks?: unknown[], bot_id?: string, bot_team_id?: string, callback_id?: string, channel_id?: string, channel_name?: string, channel_team?: string, color?: string, fallback?: string, fields?: unknown[], file_id?: string, filename?: string, files?: unknown[], footer?: string, footer_icon?: string, from_url?: string, hide_border?: boolean, hide_color?: boolean, id?: number, image_bytes?: number, image_height?: number, image_url?: string, image_width?: number, indent?: boolean, is_app_unfurl?: boolean, is_file_attachment?: boolean, is_msg_unfurl?: boolean, is_reply_unfurl?: boolean, is_thread_root_unfurl?: boolean, list?: unknown, list_record?: unknown, list_record_id?: string, list_records?: unknown[], list_schema?: unknown[], list_view?: unknown, list_view_id?: string, message_blocks?: unknown[], metadata?: unknown, mimetype?: string, mrkdwn_in?: string[], msg_subtype?: string, original_url?: string, pretext?: string, preview?: unknown, service_icon?: string, service_name?: string, service_url?: string, size?: number, text?: string, thumb_height?: number, thumb_url?: string, thumb_width?: number, title?: string, title_link?: string, ts?: string, url?: string, video_html?: string, video_html_height?: number, video_html_width?: number, video_url?: string }[], blocks?: { accessory?: unknown, alt_text?: string, api_decoration_available?: boolean, app_collaborators?: string[], app_id?: string, author_name?: string, block_id?: string, bot_user_id?: string, button_label?: string, call?: unknown, call_id?: string, description?: unknown, developer_trace_id?: string, dispatch_action?: boolean, element?: unknown, elements?: unknown[], expand?: boolean, external_id?: string, fallback?: string, fields?: unknown[], file?: unknown, file_id?: string, function_trigger_id?: string, hint?: unknown, image_bytes?: number, image_height?: number, image_url?: string, image_width?: number, is_animated?: boolean, is_workflow_app?: boolean, label?: unknown, optional?: boolean, owning_team_id?: string, provider_icon_url?: string, provider_name?: string, sales_home_workflow_app_type?: number, share_url?: string, slack_file?: unknown, source?: string, text?: unknown, thumbnail_url?: string, title?: unknown, title_url?: string, trigger_subtype?: string, trigger_type?: string, type?: unknown, url?: string, video_url?: string, workflow_id?: string }[], bot_id?: string, bot_profile?: { app_id?: string, deleted?: boolean, icons?: unknown, id?: string, name?: string, team_id?: string, updated?: number }, client_msg_id?: string, display_as_bot?: boolean, edited?: { ts?: string, user?: string }, files?: { access?: string, alt_txt?: string, app_id?: string, app_name?: string, attachments?: unknown[], blocks?: unknown[], bot_id?: string, can_toggle_canvas_lock?: boolean, canvas_printing_enabled?: boolean, canvas_template_mode?: string, cc?: unknown[], channel_actions_count?: number, channel_actions_ts?: string, channels?: string[], comments_count?: number, converted_pdf?: string, created?: number, deanimate?: string, deanimate_gif?: string, display_as_bot?: boolean, dm_mpdm_users_with_file_access?: unknown[], duration_ms?: number, edit_link?: string, edit_timestamp?: number, editable?: boolean, editor?: string, editors?: string[], external_id?: string, external_type?: string, external_url?: string, favorites?: unknown[], file_access?: string, filetype?: string, from?: unknown[], groups?: string[], has_more?: boolean, has_more_shares?: boolean, has_rich_preview?: boolean, headers?: unknown, hls?: string, hls_embed?: string, id?: string, image_exif_rotation?: number, ims?: string[], initial_comment?: unknown, is_channel_space?: boolean, is_external?: boolean, is_public?: boolean, is_restricted_sharing_enabled?: boolean, is_starred?: boolean, last_editor?: string, last_read?: number, lines?: number, lines_more?: number, linked_channel_id?: string, list_csv_download_url?: string, list_limits?: unknown, list_metadata?: unknown, media_display_type?: string, media_progress?: unknown, mimetype?: string, mode?: string, mp4?: string, mp4_low?: string, name?: string, non_owner_editable?: boolean, num_stars?: number, org_or_workspace_access?: string, original_attachment_count?: number, original_h?: string, original_w?: string, permalink?: string, permalink_public?: string, pinned_to?: string[], pjpeg?: string, plain_text?: string, pretty_type?: string, preview?: string, preview_highlight?: string, preview_is_truncated?: boolean, preview_plain_text?: string, private_channels_with_file_access_count?: number, private_file_with_access_count?: number, public_url_shared?: boolean, quip_thread_id?: string, reactions?: unknown[], saved?: unknown, sent_to_self?: boolean, shares?: unknown, show_badge?: boolean, simplified_html?: string, size?: number, source_team?: string, subject?: string, subtype?: string, team_pref_version_history_enabled?: boolean, teams_shared_with?: unknown[], template_conversion_ts?: number, template_description?: string, template_icon?: string, template_name?: string, template_title?: string, thumb_1024?: string, thumb_1024_gif?: string, thumb_1024_h?: string, thumb_1024_w?: string, thumb_160?: string, thumb_160_gif?: string, thumb_160_h?: string, thumb_160_w?: string, thumb_360?: string, thumb_360_gif?: string, thumb_360_h?: string, thumb_360_w?: string, thumb_480?: string, thumb_480_gif?: string, thumb_480_h?: string, thumb_480_w?: string, thumb_64?: string, thumb_64_gif?: string, thumb_64_h?: string, thumb_64_w?: string, thumb_720?: string, thumb_720_gif?: string, thumb_720_h?: string, thumb_720_w?: string, thumb_80?: string, thumb_800?: string, thumb_800_gif?: string, thumb_800_h?: string, thumb_800_w?: string, thumb_80_gif?: string, thumb_80_h?: string, thumb_80_w?: string, thumb_960?: string, thumb_960_gif?: string, thumb_960_h?: string, thumb_960_w?: string, thumb_gif?: string, thumb_pdf?: string, thumb_pdf_h?: string, thumb_pdf_w?: string, thumb_tiny?: string, thumb_video?: string, thumb_video_h?: number, thumb_video_w?: number, timestamp?: number, title?: string, title_blocks?: unknown[], to?: unknown[], transcription?: unknown, update_notification?: number, updated?: number, url_private?: string, url_private_download?: string, url_static_preview?: string, user?: string, user_team?: string, username?: string, vtt?: string }[], icons?: { emoji?: string, image_36?: string, image_48?: string, image_64?: string, image_72?: string }, inviter?: string, is_locked?: boolean, latest_reply?: string, metadata?: { event_payload?: unknown, event_type?: string }, parent_user_id?: string, purpose?: string, reactions?: { count?: number, name?: string, url?: string, users?: string[] }[], reply_count?: number, reply_users?: string[], reply_users_count?: number, root?: { bot_id?: string, icons?: unknown, latest_reply?: string, parent_user_id?: string, reply_count?: number, reply_users?: string[], reply_users_count?: number, subscribed?: boolean, subtype?: string, text?: string, thread_ts?: string, ts?: string, type?: string, username?: string }, subscribed?: boolean, subtype?: string, team?: string, text?: string, thread_ts?: string, topic?: string, ts?: string, type?: string, upload?: boolean, user?: string, username?: string, x_files?: string[] } }[] }`
 
+#### generate3dModel
+Generate a 3D model using a 3D generation model.
+- Text-to-3D models use the prompt field.
+- Image-to-3D and multi-view models take image URLs through the selected model's configuration inputs.
+- The output is standardized as a GLB URL plus optional FBX/OBJ/USDZ, thumbnail, texture maps, and provider task ID.
+- Input: `{ prompt?: string, intermediateAsset?: boolean, threeDModelOverride?: { model: string, config?: object } }`
+- Output: `{ prompt?: string, glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], providerTaskId?: string, resolvedConfig?: object }`
+
 #### generateAsset
 Generate an HTML asset and export it as a webpage, PDF, or image
 - Agents can generate HTML documents and export as webpage, PDFs, images, or videos. They do this by using the "generatePdf" block, which defines an HTML page with variables, and then the generation process renders the page to create the output and save its URL at the specified variable.
@@ -672,9 +680,10 @@ Replace personally identifiable information in text with placeholders using Micr
 
 #### removeBackgroundFromImage
 Remove the background from an image using AI, producing a transparent PNG.
-- Uses the Bria background removal model via fal.ai.
+- Uses the Bria background removal model via fal.ai by default.
+- Uses WaveSpeed's Ideogram background removal model when type is "advanced".
 - Output is re-hosted on the CDN as a PNG with transparency.
-- Input: `{ imageUrl: string }`
+- Input: `{ type?: "standard" | "advanced", imageUrl: string }`
 - Output: `{ imageUrl: string }`
 
 #### resizeVideo
@@ -1387,6 +1396,61 @@ Create a post on LinkedIn from the connected account.
 - Input: `{ message: string, visibility: "PUBLIC" | "CONNECTIONS", imageUrl?: string, videoUrl?: string, documentUrl?: string, articleUrl?: string, titleText?: string, descriptionText?: string, connectionId?: string }`
 - Output: `unknown`
 
+### Meshy
+
+#### meshyAnimate
+Apply a preset animation to a rigged 3D character model using Meshy.
+- Requires a rig_task_id from a previously completed Meshy rigging step.
+- Select an animation from Meshy's library of 600+ preset animations.
+- Only works with humanoid (bipedal) rigged characters.
+- Supports post-processing: FPS change (24/25/30/60), FBX-to-USDZ conversion, or armature extraction.
+- Animation categories: DailyActions, WalkAndRun, Fighting, Dancing, BodyMovements.
+- Input: `{ rigTaskId: string, actionId: number }`
+- Output: `{ glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], animations?: { name: string, glbUrl?: string, fbxUrl?: string }[], providerTaskId?: string }`
+
+#### meshyImageTo3d
+Generate a 3D model from one or more images using Meshy. Uses the multi-image-to-3D endpoint.
+- Accepts 1-4 image URLs. All images should depict the same object from different angles for best results.
+- By default generates with textures. Set shouldTexture to false for mesh-only output.
+- Uses should_remesh: false to preserve UV mapping integrity.
+- Input: `{ imageUrls: string[], shouldTexture?: boolean, topology?: string, targetPolycount?: number, symmetryMode?: string, poseMode?: string, textureImageUrl?: string }`
+- Output: `{ glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], animations?: { name: string, glbUrl?: string, fbxUrl?: string }[], providerTaskId?: string }`
+
+#### meshyRemesh
+Remesh an existing 3D model to adjust topology, polygon count, or convert formats using Meshy.
+- Provide either an input task ID (from a previous Meshy step) or a model URL.
+- Defaults to triangle topology with 30,000 target polys.
+- Useful for reducing face count before rigging (max 300k faces for rigging).
+- Input: `{ inputTaskId?: string, modelUrl?: string, topology?: string, targetPolycount?: number, resizeHeight?: number }`
+- Output: `{ glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], animations?: { name: string, glbUrl?: string, fbxUrl?: string }[], providerTaskId?: string }`
+
+#### meshyRig
+Auto-rig a humanoid 3D model and generate basic walking/running animations using Meshy.
+- Only works well with standard humanoid (bipedal) models with clearly defined limbs.
+- Prefers model_url over input_task_id for cleaner rigging input.
+- Models with more than 300,000 faces should be remeshed first.
+- Returns rigged model files and optional basic animations.
+- Input: `{ inputTaskId?: string, modelUrl?: string, heightMeters?: number }`
+- Output: `{ glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], animations?: { name: string, glbUrl?: string, fbxUrl?: string }[], providerTaskId?: string }`
+
+#### meshyTextTo3d
+Generate a 3D model preview from a text prompt using Meshy. Produces an untextured mesh (preview stage).
+- Creates a text-to-3D preview task (mesh generation only, no texture).
+- Use the Meshy Texture step to apply textures to the preview.
+- Maximum prompt length is 600 characters.
+- Input: `{ prompt: string, modelType?: string, topology?: string, targetPolycount?: number, symmetryMode?: string, poseMode?: string }`
+- Output: `{ glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], animations?: { name: string, glbUrl?: string, fbxUrl?: string }[], providerTaskId?: string }`
+
+#### meshyTexture
+Apply or replace textures on a 3D model using a text prompt or reference image via Meshy.
+- Provide either an input task ID (from a previous Meshy step) or a model URL.
+- Provide either a text style prompt or an image style URL to guide texturing.
+- Supports .glb, .gltf, .obj, .fbx, .stl model formats when using modelUrl.
+- By default preserves original UVs (enableOriginalUv = true).
+- Works with any model source: text-to-3D previews, image-to-3D, remeshed models, or external files.
+- Input: `{ inputTaskId?: string, modelUrl?: string, textStylePrompt?: string, imageStyleUrl?: string, enableOriginalUv?: boolean, enablePbr?: boolean }`
+- Output: `{ glbUrl: string, fbxUrl?: string, objUrl?: string, usdzUrl?: string, thumbnailUrl?: string, textureUrls?: object[], animations?: { name: string, glbUrl?: string, fbxUrl?: string }[], providerTaskId?: string }`
+
 ### Meta Threads
 
 #### scrapeMetaThreadsProfile
@@ -1454,6 +1518,66 @@ For example, has:media alone is invalid, but #AI has:media is valid.
 - Input: `{ query: string, scope: "recent" | "all", options: { startTime?: string, endTime?: string, maxResults?: number } }`
 - Output: `{ posts: { id: string, authorId: string, dateCreated: string, text: string, stats: { retweets: number, replies: number, likes: number } }[] }`
 
+### You.com
+
+#### youDotComFinanceResearch
+Ask a financial research question using You.com Finance Research and return the sourced response.
+- Use this for financial questions such as company analysis, earnings, market research, filings, macroeconomics, and due diligence.
+- researchEffort supports deep (default) or exhaustive.
+- Finance Research returns the same response shape as Web Research, but searches a finance-optimized index.
+- Use it for cited synthesis, not raw price feeds or structured time-series exports.
+- Input: `{ input: string, researchEffort?: "deep" | "exhaustive" }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComGetPageContent
+Fetch clean Markdown, HTML, or metadata for known URLs using the You.com Contents API.
+- Use this step when you already know the URLs. Use Web Search with livecrawl when You.com should discover pages from a query.
+- A single request supports up to 10 URLs.
+- Request only the formats you need. Markdown is recommended for LLM consumption.
+- Increase crawlTimeout for JavaScript-heavy pages, up to 60 seconds.
+- Individual pages can partially fail; check each returned item before processing.
+- Input: `{ urls: string[], formats?: ("markdown" | "html" | "metadata")[], crawlTimeout?: number }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComLiveNews
+Fetch live news articles through the You.com Search API and return the full structured response.
+- Defaults freshness to day for breaking or recent news.
+- Use country and language together to monitor regional or non-English news.
+- Use livecrawl: 'news' with livecrawlFormats: ['markdown'] when you need full article text.
+- Use a custom freshness range like YYYY-MM-DDtoYYYY-MM-DD for historical news windows.
+- Input: `{ query: string, freshness?: string, count?: number, country?: string, language?: string, safesearch?: "off" | "moderate" | "strict", livecrawl?: "news" | "all", livecrawlFormats?: ("markdown" | "html")[] }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComWebResearch
+Ask a research question and return a grounded You.com Research API answer with sources.
+- Use Web Search when you need raw URLs and snippets. Use Web Research when you want a synthesized answer with citations.
+- researchEffort controls depth and latency: lite, standard, deep, or exhaustive. standard is a good default.
+- sourceControl can restrict, exclude, or boost domains, and can apply freshness or country filters.
+- includeDomains cannot be combined with excludeDomains or boostDomains.
+- outputSchema returns structured output.content and is supported by standard, deep, and exhaustive, not lite.
+- Input: `{ input: string, researchEffort?: "lite" | "standard" | "deep" | "exhaustive", sourceControl?: { includeDomains?: string[], excludeDomains?: string[], boostDomains?: string[], freshness?: string, country?: string } | string, outputSchema?: object | string }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComWebSearch
+Search the web and news using the You.com Search API and return the full structured response.
+- Query supports You.com search operators:
+| Operator | Description | Example |
+| -------- | ----------- | ------- |
+| site: | Search within a domain and its subdomains | site:uscourts.gov |
+| filetype: | Search for a specific file type | filetype:pdf |
+| + | Require the exact term after the operator | +GAAP |
+| - | Exclude the exact term after the operator | -prs |
+| AND | Require both expressions | guitar AND Fender |
+| OR | Match either expression | guitar OR drum |
+| NOT | Negate an expression | NOT site:uscourts.gov |
+- Use livecrawl with livecrawlFormats: ['markdown'] when you need full page content instead of snippets.
+- Use the Get Page Content step when you already know the URLs to fetch.
+- Use freshness for recency: day, week, month, year, or YYYY-MM-DDtoYYYY-MM-DD.
+- Use country (ISO 3166-1 alpha-2) and language (BCP 47) to focus results geographically or linguistically.
+- includeDomains cannot be combined with excludeDomains or boostDomains.
+- Input: `{ query: string, count?: number, freshness?: string, country?: string, language?: string, offset?: number, safesearch?: "off" | "moderate" | "strict", livecrawl?: "web" | "news" | "all", livecrawlFormats?: ("markdown" | "html")[], crawlTimeout?: number, includeDomains?: string[], excludeDomains?: string[], boostDomains?: string[] }`
+- Output: `{ data: object | unknown[] }`
+
 ### YouTube
 
 #### fetchYoutubeCaptions

package/package.json

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