@mindstudio-ai/agent 0.1.125 → 0.1.126

package/llms.txt

@@ -297,7 +297,9 @@ Check whether the current user has a specific app role and branch accordingly.
 
 #### 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.
+- Each page is converted to a separate PNG.
+- The page images go to the public CDN by default, or into one of the app's own file stores when the call passes `store` — a private store keeps them private.
+- The source PDF is never published: one of the app's own files is read where it sits, and any other URL is staged privately for the renderer and discarded afterwards.
 - Returns an array of image URLs, one per page.
 - Input: `{ pdfUrl: string }`
 - Output: `{ imageUrls: string[] }`
@@ -352,37 +354,6 @@ Scan text for personally identifiable information using Microsoft Presidio.
 - Input: `{ input: string, language: string, entities: string[], detectedStepId?: string, notDetectedStepId?: string, outputLogVariable?: string | null }`
 - Output: `{ detected: boolean, detections: { entity_type: string, start: number, end: number, score: number }[] }`
 
-#### discordEditMessage
-Edit a previously sent Discord channel message. Use with the message ID returned by Send Discord Message.
-- Only messages sent by the bot can be edited.
-- The messageId is returned by the Send Discord Message step.
-- Optionally attach a file by providing a URL to attachmentUrl. The file is downloaded and uploaded to Discord.
-- When editing with an attachment, the new attachment replaces any previous attachments on the message.
-- URLs in the text are automatically embedded by Discord (link previews for images, videos, etc.).
-- Input: `{ botToken: string, channelId: string, messageId: string, text: string, attachmentUrl?: string }`
-- Output: `unknown`
-
-#### discordSendFollowUp
-Send a follow-up message to a Discord slash command interaction.
-- Requires the applicationId and interactionToken from the Discord trigger variables.
-- Follow-up messages appear as new messages in the channel after the initial response.
-- Returns the sent message ID.
-- Interaction tokens expire after 15 minutes.
-- Optionally attach a file by providing a URL to attachmentUrl. The file is downloaded and uploaded to Discord.
-- URLs in the text are automatically embedded by Discord (link previews for images, videos, etc.).
-- Input: `{ applicationId: string, interactionToken: string, text: string, attachmentUrl?: string }`
-- Output: `{ messageId: string }`
-
-#### discordSendMessage
-Send a message to Discord — either edit the loading message or send a new channel message.
-- mode "edit" replaces the loading message (interaction response) with the final result. Uses applicationId and interactionToken from trigger variables. No bot permissions required.
-- mode "send" sends a new message to a channel. Uses botToken and channelId from trigger variables. Returns a messageId that can be used with Edit Discord Message.
-- Optionally attach a file by providing a URL to attachmentUrl. The file is downloaded and uploaded to Discord.
-- URLs in the text are automatically embedded by Discord (link previews for images, videos, etc.).
-- Interaction tokens expire after 15 minutes.
-- Input: `{ mode: "edit" | "send", text: string, applicationId?: string, interactionToken?: string, botToken?: string, channelId?: string, attachmentUrl?: string }`
-- Output: `{ messageId?: string }`
-
 #### downloadVideo
 Download a video file
 - Works with YouTube, TikTok, etc., by using ytdlp behind the scenes
@@ -416,7 +387,7 @@ Download a file from a URL and extract its text content. Supports PDFs (includin
 - Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.
 - Handles both text-layer PDFs and image-based/scanned PDFs (e.g. Figma/Canva exports, scanned documents). Image-based PDFs are processed with OCR automatically — there is no need to convert PDF pages to images first.
 - Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.
-- Files are rehosted on the MindStudio CDN before extraction.
+- Nothing is published. One of the app's own files — including a private one, or a share link — is read where it sits; any other URL is downloaded and staged privately for the extraction model, then discarded when extraction finishes.
 - Optionally set `model` to a specific document-extraction model (`mistral-ocr-latest`, `llamaparse`, `google-document-ai`); omit to use the platform default.
 - Maximum file size is 50MB per URL.
 - Input: `{ url: string | string[], model?: string }`
@@ -454,17 +425,10 @@ Generate an HTML asset and export it as a webpage, PDF, or image
 - 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
-Create a chart image using QuickChart (Chart.js) and return the URL.
-- The data field must be a Chart.js-compatible JSON object serialized as a string.
-- Supported chart types: bar, line, pie.
-- Input: `{ chart: { chartType: "bar" | "line" | "pie", data: string, options: { width: string, height: string } } }`
-- Output: `{ chartUrl: string }`
-
 #### generateImage
 Generate an image from a text prompt using an AI model.
 - Prompts should be descriptive but concise (roughly 3–6 sentences).
-- Images are automatically hosted on a CDN.
+- Images are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` — a private store keeps the image private.
 - 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.
@@ -484,6 +448,13 @@ Generate an audio file from provided instructions (text) using a music model.
 - Input: `{ text: string, intermediateAsset?: boolean, musicModelOverride?: { model: string, config?: object } }`
 - Output: `unknown`
 
+#### generateSound
+Generate a sound effect from a text description using a sound model.
+- The text field contains the description of the sound effect to generate.
+- 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, soundModelOverride?: { model: string, config?: object } }`
+- Output: `{ audioUrl: string }`
+
 #### generateStaticVideoFromImage
 Convert a static image to an MP4
 - Can use to create slides/intertitles/slates for video composition
@@ -510,7 +481,7 @@ the server-side plumbing.
 #### generateVideo
 Generate a video from a text prompt using an AI model.
 - Prompts should be descriptive but concise (roughly 3–6 sentences).
-- Videos are automatically hosted on a CDN.
+- Videos are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` — a private store keeps the video private, with no public copy left behind.
 - 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.
@@ -518,9 +489,9 @@ Generate a video from a text prompt using an AI model.
 - Output: `{ videoUrl: string | string[] }`
 
 #### getGmailAttachments
-Download attachments from a Gmail email and re-host them on CDN.
+Download attachments from a Gmail email and store them on the app's own storage.
 - Requires a Google OAuth connection with Gmail readonly scope.
-- Attachments are uploaded to CDN and returned as URLs.
+- Attachments are stored and returned as URLs — on the public CDN by default, or in one of the app's own file stores when the call passes `store`. Use a private store for anything confidential; a public CDN URL is readable by anyone who has it.
 - 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 }`
@@ -542,13 +513,13 @@ Get info about a media file
 #### imageFaceSwap
 Replace a face in an image with a face from another image using AI.
 - Requires both a target image and a face source image.
-- Output is re-hosted on the CDN as a PNG.
+- Output is a PNG on the public CDN, or in one of the app's own file stores when the call passes `store` — a private store keeps it private.
 - Input: `{ imageUrl: string, faceImageUrl: string, engine: string }`
 - Output: `{ imageUrl: string }`
 
 #### imageRemoveWatermark
 Remove watermarks from an image using AI.
-- Output is re-hosted on the CDN as a PNG.
+- Output is a PNG on the public CDN, or in one of the app's own file stores when the call passes `store` — a private store keeps it private.
 - Input: `{ imageUrl: string, engine: string, intermediateAsset?: boolean }`
 - Output: `{ imageUrl: string }`
 
@@ -668,7 +639,7 @@ Replace personally identifiable information in text with placeholders using Micr
 Remove the background from an image using AI, producing a transparent PNG.
 - 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.
+- Output is a PNG with transparency on the public CDN, or in one of the app's own file stores when the call passes `store` — a private store keeps it private, `autoCrop` included.
 - Input: `{ type?: "standard" | "advanced", imageUrl: string, autoCrop?: boolean }`
 - Output: `{ imageUrl: string }`
 
@@ -687,14 +658,6 @@ Run a raw API connector to a third-party service
 - Input: `{ actionId: string, displayName: string, icon: string, configurationValues: object, __connectionId?: string }`
 - Output: `{ data: object }`
 
-#### runPackagedWorkflow
-Run a packaged workflow ("custom block")
-- From the user's perspective, packaged workflows are just ordinary blocks. Behind the scenes, they operate like packages/libraries in a programming language, letting the user execute custom functionality.
-- Some of these packaged workflows are available as part of MindStudio's "Standard Library" and available to every user.
-- Available packaged workflows are documented here as individual blocks, but the runPackagedWorkflow block is how they need to be wrapped in order to be executed correctly.
-- Input: `{ appId: string, workflowId: string, inputVariables: object, outputVariables: object, name: string }`
-- Output: `{ data: unknown }`
-
 #### scrapeLinkedInCompany
 Scrape public company data from a LinkedIn company page.
 - Requires a LinkedIn company URL (e.g. https://www.linkedin.com/company/mindstudioai).
@@ -713,7 +676,7 @@ Scrape public profile data from a LinkedIn profile page.
 Extract text, HTML, or structured content from one or more web pages.
 - Accepts a single URL or multiple URLs (as a JSON array, comma-separated, or newline-separated).
 - Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data, "summary" returns a model-written summary and requires the "firecrawl" service.
-- Can optionally capture a screenshot of each page.
+- Can optionally capture a screenshot of each page. Screenshots go to the public CDN by default, or into one of the app's own file stores when the call passes `store`.
 - Handles bot protection automatically; no proxy or rendering configuration is needed.
 - Input: `{ url: string, service?: "default" | "firecrawl", autoEnhance?: boolean, outputFormat?: "text" | "json" | "html" | "summary", pageOptions?: { onlyMainContent: boolean, screenshot: boolean, waitFor: number, replaceAllPathsWithAbsolutePaths: boolean, headers: object, removeTags: string[], mobile: boolean } }`
 - Output: `{ content: string | string[] | { text: string, html: string, json?: object, screenshotUrl?: string, metadata?: { title: string, description: string, url: string, image: string }, error?: { code: string, message: string }, costUnits?: number } | { text: string, html: string, json?: object, screenshotUrl?: string, metadata?: { title: string, description: string, url: string, image: string }, error?: { code: string, message: string }, costUnits?: number }[], screenshot?: string | string[] }`
@@ -735,7 +698,7 @@ Scrape public profile data from an X (Twitter) account by URL.
 #### screenshotUrl
 Capture a screenshot of a web page as a PNG image.
 - Takes a viewport or full-page screenshot of the given URL.
-- Returns a CDN-hosted PNG image URL.
+- Returns a PNG image URL: on the public CDN by default, or in one of the app's own file stores when the call passes `store` — a private store keeps the screenshot private.
 - Viewport mode captures only the visible area; fullPage captures the entire scrollable page, scrolling it first so lazy-loaded content is included.
 - Works on sites behind bot protection (Cloudflare and similar).
 - Cookie-consent banners and similar overlays are suppressed automatically.
@@ -874,57 +837,6 @@ Explicitly set a variable to a given value.
 - Input: `{ value: string | string[] }`
 - Output: `object`
 
-#### telegramEditMessage
-Edit a previously sent Telegram message. Use with the message ID returned by Send Telegram Message.
-- Only text messages sent by the bot can be edited.
-- The messageId is returned by the Send Telegram Message step.
-- Common pattern: send a "Processing..." message, do work, then edit it with the result.
-- Input: `{ botToken: string, chatId: string, messageId: string, text: string }`
-- Output: `unknown`
-
-#### telegramReplyToMessage
-Send a reply to a specific Telegram message. The reply will be visually threaded in the chat.
-- Use the rawMessage.message_id from the incoming trigger variables to reply to the user's message.
-- Especially useful in group chats where replies provide context.
-- Returns the sent message ID, which can be used with Edit Telegram Message.
-- Input: `{ botToken: string, chatId: string, replyToMessageId: string, text: string }`
-- Output: `{ messageId: number }`
-
-#### telegramSendAudio
-Send an audio file to a Telegram chat as music or a voice note via a bot.
-- "audio" mode sends as a standard audio file. "voice" mode sends as a voice message (re-uploads the file for large file support).
-- Input: `{ botToken: string, chatId: string, audioUrl: string, mode: "audio" | "voice", caption?: string }`
-- Output: `unknown`
-
-#### telegramSendFile
-Send a document/file to a Telegram chat via a bot.
-- Input: `{ botToken: string, chatId: string, fileUrl: string, caption?: string }`
-- Output: `unknown`
-
-#### telegramSendImage
-Send an image to a Telegram chat via a bot.
-- Input: `{ botToken: string, chatId: string, imageUrl: string, caption?: string }`
-- Output: `unknown`
-
-#### telegramSendMessage
-Send a text message to a Telegram chat via a bot.
-- Messages are sent using MarkdownV2 formatting. Special characters are auto-escaped.
-- botToken format is "botId:token" — both parts are required.
-- Returns the sent message ID, which can be used with Edit Telegram Message to update the message later.
-- Input: `{ botToken: string, chatId: string, text: string }`
-- Output: `{ messageId: number }`
-
-#### telegramSendVideo
-Send a video to a Telegram chat via a bot.
-- Input: `{ botToken: string, chatId: string, videoUrl: string, caption?: string }`
-- Output: `unknown`
-
-#### telegramSetTyping
-Show the "typing..." indicator in a Telegram chat via a bot.
-- The typing indicator automatically expires after a few seconds. Use this right before sending a message for a natural feel.
-- Input: `{ botToken: string, chatId: string }`
-- Output: `unknown`
-
 #### textToSpeech
 Generate an audio file from provided text using a speech model.
 - The text field contains the exact words to be spoken (not instructions).
@@ -969,7 +881,7 @@ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from
 
 #### upscaleImage
 Increase the resolution of an image using AI upscaling.
-- Output is re-hosted on the CDN as a PNG.
+- Output is a PNG on the public CDN, or in one of the app's own file stores when the call passes `store` — a private store keeps it private.
 - Input: `{ imageUrl: string, targetResolution: "2k" | "4k" | "8k", engine: "standard" | "pro" }`
 - Output: `{ imageUrl: string }`
 
@@ -1264,7 +1176,7 @@ Download a file from Google Drive and rehost it on the CDN. Returns a public CDN
 - Requires a Google OAuth connection with Drive scope.
 - Google-native files (Docs, Sheets, Slides) cannot be downloaded — use dedicated steps instead.
 - Maximum file size: 200MB.
-- The file is downloaded and re-uploaded to the CDN; the returned URL is publicly accessible.
+- The file is downloaded and stored on the public CDN, where the returned URL is publicly accessible — pass `store` to put it in one of the app's own file stores instead, which for a private store means the URL only loads for an authorized session.
 - Input: `{ fileId: string, connectionId?: string }`
 - Output: `{ url: string, name: string, mimeType: string, size: number }`
 
@@ -1444,61 +1356,16 @@ Update the content of an existing Notion page.
 - Input: `{ pageId: string, content: string, mode: "append" | "overwrite", connectionId?: string }`
 - Output: `{ pageId: string, pageUrl: string }`
 
-### Particle Podcasts
-
-#### particlePodcastsFindMentions
-Find every dialogue line mentioning a specific entity or company across all podcasts.
-- Provide `entityId` (for people, products, places) OR `companyId` (for organizations). At least one is required.
-- Use `contextLines` to include surrounding dialogue with each mention (default behavior is set by Particle).
-- Resolve a name to an `entityId` / `companyId` first via Search Companies (or by inspecting a Search Dialogue response).
-- Cursor-paginated; expect potentially large result sets for popular entities.
-- Input: `{ entityId?: string, companyId?: string, contextLines?: number, limit?: number, cursor?: string }`
-- Output: `unknown`
+### QuickBooks
 
-#### particlePodcastsGetEpisode
-Fetch full metadata for a single episode: details, speakers, entities, clips, and ads — merged into one response.
-- Pass an episode ID or slug as `id`.
-- Returns five sub-resources merged: `episode` (metadata), `speakers` (diarized speaker list), `entities` (knowledge-graph mentions), `clips` (AI-extracted highlights), `ads` (detected ad spots).
-- Use Get Episode Transcript separately when you need the full transcript text — it isn't bundled here because the payload is large and has its own format/range options.
-- Bills as 5 units against the get-episode event type (one per sub-call).
-- Input: `{ id: string }`
-- Output: `unknown`
-
-#### particlePodcastsGetEpisodeTranscript
-Fetch the diarized transcript for an episode in dialogue, plain text, or SRT subtitle format.
-- Pass an episode ID or slug as `id`.
-- Use `format` = "dialogue" (default, with speaker turns), "text" (plain), or "srt" (subtitle).
-- Filter to a single speaker with `speaker`, or to a time range with `start` / `end` (seconds).
-- Transcripts are large — prefer time-range filtering when you only need a snippet.
-- Input: `{ id: string, format?: "dialogue" | "text" | "srt", speaker?: string, start?: number, end?: number }`
-- Output: `unknown`
-
-#### particlePodcastsSearchCompanies
-Search the Particle knowledge graph for companies by name, ticker, domain, CIK, or QID.
-- Provide one or more identifiers: `q` (free-text name), `ticker` (e.g. "TSLA"), `domain` (e.g. "tesla.com"), `cik` (SEC), or `qid` (Wikidata).
-- Use this to resolve a company name to a canonical `companyId` for use with Find Mentions or Search Dialogue.
-- Returned company objects include slugs, domains, and IDs — any of these can be passed to downstream blocks.
-- Input: `{ q?: string, ticker?: string, domain?: string, cik?: string, qid?: string, entityId?: string, updatedAfter?: string, limit?: number, cursor?: string }`
-- Output: `unknown`
-
-#### particlePodcastsSearchDialogue
-Search across podcast dialogue using semantic or keyword search. Returns matched lines grouped by episode.
-- Provide `semanticSearch` for meaning-based discovery ("find moments where someone talks about market timing") or `keywordSearch` for exact phrase/proper-noun matching. At least one must be provided.
-- Filter to a specific entity or company by passing `entityId` / `companyId`.
-- Each returned dialogue line carries the source episode + speaker so you can chain to Get Episode or Get Episode Transcript for context.
-- Cursor-paginated.
-- Input: `{ semanticSearch?: string, keywordSearch?: string, entityId?: string, companyId?: string, limit?: number, cursor?: string }`
-- Output: `unknown`
-
-#### particlePodcastsSearchPodcasts
-Search and list podcasts in the Particle catalog by keyword, topic, or language.
-- Use `q` for free-text keyword search across podcast titles and descriptions.
-- Use `topic` to filter to a Particle taxonomy topic.
-- Use `language` (BCP 47, e.g. "en") to restrict to a language.
-- Returns podcast objects with canonical IDs and slugs. Pass either to other Particle Podcasts blocks.
-- Cursor-paginated; pass the returned `cursor` back to `cursor` for the next page.
-- Input: `{ q?: string, topic?: string, language?: string, suitabilityTier?: string, limit?: number, cursor?: string }`
-- Output: `unknown`
+#### quickbooksApiRequest
+Call any QuickBooks Online Accounting API route using a connected company.
+- Requires a QuickBooks OAuth connection (connectionId).
+- Route is relative to /v3/company/{realmId}/, e.g. "account", "account/93", "query", "invoice".
+- Use queryParams for query-string values such as query=select * from Account.
+- Body is JSON for POST, PUT, and PATCH.
+- Input: `{ connectionId?: string, method: string, route: string, queryParams: object, body: string }`
+- Output: `{ ok: boolean, status: number, body: unknown }`
 
 ### X
 

package/package.json

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