@mindstudio-ai/agent 0.1.147 → 0.1.149

package/llms.txt

@@ -320,7 +320,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 - The data source is created empty — use the "Upload Data Source Document" block to add documents.
 - Returns the new data source ID which can be used in subsequent blocks.
 - Input: `{ name: string }`
-- Output: `unknown`
+- Output: `{ dataSourceId: string, name: string }`
 
 #### createGmailDraft
 Create a draft email in the connected Gmail account.
@@ -344,7 +344,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 - The Milvus partition is cleaned up asynchronously by a background cron job.
 - The data source must belong to the current app version.
 - Input: `{ dataSourceId: string }`
-- Output: `unknown`
+- Output: `{ dataSourceId: string }`
 
 #### deleteDataSourceDocument
 Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Delete a single document from a data source.
@@ -352,7 +352,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 - Requires both the data source ID and document ID.
 - After deletion, reloads vectors into Milvus so the data source reflects the change immediately.
 - Input: `{ dataSourceId: string, documentId: string }`
-- Output: `unknown`
+- Output: `{ dataSourceId: string, documentId: string }`
 
 #### detectChanges
 Detect changes between runs by comparing current input against previously stored state. Routes execution based on whether a change occurred.
@@ -417,7 +417,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 - The document must have been successfully processed (status "done").
 - Also returns document metadata (name, summary, word count).
 - Input: `{ dataSourceId: string, documentId: string }`
-- Output: `unknown`
+- Output: `{ documentId: string, name: string, content: string, summary: string, numWords: number }`
 
 #### fetchSlackChannelHistory
 Fetch recent message history from a Slack channel.
@@ -454,17 +454,17 @@ Generate an image from a text prompt using an AI model.
 - Output: `{ imageUrl: string | string[] }`
 
 #### generateLipsync
-Generate a lip sync video from provided audio and image.
+Generate a lip sync video from audio and an image or video.
 - In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.
 - Input: `{ intermediateAsset?: boolean, addWatermark?: boolean, lipsyncModelOverride?: { model: string, config?: object } }`
-- Output: `unknown`
+- Output: `{ videoUrl: string }`
 
 #### 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, intermediateAsset?: boolean, musicModelOverride?: { model: string, config?: object } }`
-- Output: `unknown`
+- Output: `{ audioUrl: string }`
 
 #### generateSound
 Generate a sound effect from a text description using a sound model.
@@ -513,7 +513,7 @@ Download attachments from a Gmail email and store them on the app's own storage.
 - Attachments larger than 25MB are skipped.
 - Use the message ID from Search Gmail Emails, List Recent Gmail Emails, or Get Gmail Email steps.
 - Input: `{ messageId: string, connectionId?: string }`
-- Output: `unknown`
+- Output: `{ attachments: { filename: string, mimeType: string, size: number, url: string }[] }`
 
 #### getGmailUnreadCount
 Get the number of unread emails in the connected Gmail inbox.
@@ -521,7 +521,7 @@ Get the number of unread emails in the connected Gmail inbox.
 - Returns the unread message count for the inbox label.
 - This is a lightweight call that does not fetch any email content.
 - Input: `{ connectionId?: string }`
-- Output: `unknown`
+- Output: `{ unreadCount: number }`
 
 #### getMediaMetadata
 Get info about a media file
@@ -559,7 +559,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 - Returns metadata for every data source associated with the current app version.
 - Each entry includes the data source ID, name, description, status, and document list.
 - Input: `object`
-- Output: `unknown`
+- Output: `{ dataSources: ({ id: string, name: string, description: string, status: "loaded" | "hibernating", dateCreated: string, documents: ({ id: string, name: string, status: "processing" | "done" | "error", numWords?: number, dateUploaded: string })[] })[] }`
 
 #### listGmailLabels
 List all labels in the connected Gmail account. Use these label IDs or names with the Update Gmail Labels step.
@@ -567,7 +567,7 @@ List all labels in the connected Gmail account. Use these label IDs or names wit
 - Returns both system labels (INBOX, SENT, TRASH, etc.) and user-created labels.
 - Label type is "system" for built-in labels or "user" for custom labels.
 - Input: `{ connectionId?: string }`
-- Output: `unknown`
+- Output: `{ labels: { id: string, name: string, type: string }[] }`
 
 #### listRecentGmailEmails
 List recent emails from the connected Gmail inbox.
@@ -575,7 +575,7 @@ List recent emails from the connected Gmail inbox.
 - Returns up to 100 emails (default 5), ordered by most recent first.
 - Functionally equivalent to Search Gmail Emails with an "in:inbox" query.
 - Input: `{ connectionId?: string, exportType: "json" | "text", limit: string }`
-- Output: `unknown`
+- Output: `{ emails: { id: string, subject: string, from: string, to: string, date: string, plainBody: string, htmlBody: string, labels: string }[] }`
 
 #### logic
 Route execution to different branches based on AI evaluation, comparison operators, or workflow jumps.
@@ -676,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 }`
@@ -839,7 +839,7 @@ Send an existing draft from the connected Gmail account.
 - The draft is sent and removed from the Drafts folder.
 - Use the draft ID returned by the Create Gmail Draft or List Gmail Drafts steps.
 - Input: `{ draftId: string, connectionId?: string }`
-- Output: `unknown`
+- Output: `{ messageId: string }`
 
 #### sendGmailMessage
 Send an email from the connected Gmail account.
@@ -872,7 +872,7 @@ Mark one or more Gmail emails as read or unread.
 - Accepts one or more message IDs as a comma-separated string or array.
 - Set markAsRead to true to mark as read, false to mark as unread.
 - Input: `{ messageIds: string, markAsRead: boolean, connectionId?: string }`
-- Output: `unknown`
+- Output: `{ messageIds: string[] }`
 
 #### setRunTitle
 Set the title of the agent run for the user's history
@@ -927,7 +927,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 - Once processing finishes, vectors are loaded into Milvus so the data source is immediately queryable.
 - Supported file types (when using a URL) are the same as the data source upload UI (PDF, DOCX, TXT, etc.).
 - Input: `{ dataSourceId: string, file: string, fileName: string }`
-- Output: `unknown`
+- Output: `{ documentId: string, dataSourceId: string, fileName: string }`
 
 #### upscaleImage
 Increase the resolution of an image using AI upscaling.
@@ -1420,17 +1420,18 @@ Call any QuickBooks Online Accounting API route using a connected company.
 ### TypeSafe
 
 #### typesafeEvaluate
-Ask TypeSafe structured questions about text or JSON and get calibrated answers. The model returns a probability, a selected option, or a score. It does not write a reply. Each question is a noul (yes or no, as a probability from 0 to 1), a choice (one option from a set you define, with a probability for each), or a score (a rating against ordered levels). Put every question in the same call. The question id is yours: answers come back under the same ids. The model defaults to Jev (jev-latest).
-- state is the content to judge: a string, or a JSON object or array (a record, a chat log, application state). Text only. Turn images, audio, and video into text first.
+Ask structured questions about text, JSON, or images and get calibrated answers. The model returns a probability, a selected option, or a score. It does not write a reply. Each question is a noul (yes or no, as a probability from 0 to 1), a choice (one option from a set you define, with a probability for each), or a score (a rating against ordered levels). Put every question in the same call. The question id is yours: answers come back under the same ids. The model defaults to Jev (jev-latest). Pass clef or clef-flash to run Cloudflare Clef with the same questions and answers. Clef and Clef Flash can also read up to 4 images.
+- state is the content to judge: a string, or a JSON object or array (a record, a chat log, application state).
+- images is for Clef and Clef Flash. Pass up to 4 PNG, JPEG, or WebP images as URLs. Each file is at most 4 MiB, and 8 MiB together. A call on Jev that includes images is rejected.
 - questions is a map. The key is an id you choose. It is not shown to the model. The answer comes back under the same id.
 - A noul asks a yes/no question and returns noul, a probability from 0 (no) to 1 (yes). Optional criteria.true and criteria.false say what a yes and a no mean.
 - A choice picks one option. criteria is a map of option id to a short description (or null). At most 255 options. The answer includes the winning choice, a probability for every option, and confidence.
 - A score rates the state on an ordered rubric. criteria is 2 to 10 level descriptions, low to high. The answer's score can land between levels, and includes a probability per level plus confidence.
 - instructions may be a string, or an object that keeps the question in one field and reference data in the others. Refer to those fields by name in backticks.
 - Send every question you need in one call. The model reads the state once and answers them together.
-- model defaults to jev-latest, the current stable release. jev-preview tracks the newest release. Pin a version such as jev-1.13.0 when a threshold was tuned against that version. The response model field is the version that answered.
-- Billed per input token. Output tokens are free.
-- Input: `{ state: string | object | unknown[], questions: object, model?: string }`
+- model defaults to jev-latest, the current stable TypeSafe release. jev-preview tracks the newest TypeSafe release. Pin a version such as jev-1.13.0 when a threshold was tuned against that version. clef and clef-flash run Cloudflare Clef on the same questions and answers. clef is the larger model. clef-flash is the faster one. @cf/cloudflare/clef and @cf/cloudflare/clef-flash name the same two. Clef accepts at most 64 questions, and a question id may use only letters, digits, underscore, dot, and hyphen, up to 100 characters. The response model field is the version that answered.
+- Billed per input token. Output tokens are free. Clef and Clef-flash have their own rates.
+- Input: `{ state: string | object | unknown[], questions: object, model?: string, images?: string[] }`
 - Output: `{ model: string, answers: object, usage: { input_tokens: number, output_tokens: number } }`
 
 ### X

package/package.json

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