@mindstudio-ai/agent 0.0.14 → 0.0.16

package/dist/cli.js

@@ -0,0 +1,2556 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/generated/metadata.ts
+var metadata_exports = {};
+__export(metadata_exports, {
+  stepMetadata: () => stepMetadata
+});
+var stepMetadata;
+var init_metadata = __esm({
+  "src/generated/metadata.ts"() {
+    "use strict";
+    stepMetadata = {
+      "activeCampaignAddNote": {
+        stepType: "activeCampaignAddNote",
+        description: "Add a note to an existing contact in ActiveCampaign.",
+        usageNotes: "- Requires an ActiveCampaign OAuth connection (connectionId).\n- The contact must already exist \u2014 use the contact ID from a previous create or search step.",
+        inputSchema: { "type": "object", "properties": { "contactId": { "type": "string", "description": "ActiveCampaign contact ID to add the note to" }, "note": { "type": "string", "description": "Note text content" }, "connectionId": { "type": "string", "description": "ActiveCampaign OAuth connection ID" } }, "required": ["contactId", "note"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "activeCampaignCreateContact": {
+        stepType: "activeCampaignCreateContact",
+        description: "Create or sync a contact in ActiveCampaign.",
+        usageNotes: "- Requires an ActiveCampaign OAuth connection (connectionId).\n- If a contact with the email already exists, it may be updated depending on ActiveCampaign settings.\n- Custom fields are passed as a key-value map where keys are field IDs.",
+        inputSchema: { "type": "object", "properties": { "email": { "type": "string", "description": "Contact email address" }, "firstName": { "type": "string", "description": "Contact first name" }, "lastName": { "type": "string", "description": "Contact last name" }, "phone": { "type": "string", "description": "Contact phone number" }, "accountId": { "type": "string", "description": "ActiveCampaign account ID to associate the contact with" }, "customFields": { "type": "object", "description": "Custom field values keyed by field ID" }, "connectionId": { "type": "string", "description": "ActiveCampaign OAuth connection ID" } }, "required": ["email", "firstName", "lastName", "phone", "accountId", "customFields"] },
+        outputSchema: { "type": "object", "properties": { "contactId": { "type": "string", "description": "ActiveCampaign contact ID of the created contact" } }, "required": ["contactId"] }
+      },
+      "addSubtitlesToVideo": {
+        stepType: "addSubtitlesToVideo",
+        description: "Automatically add subtitles to a video",
+        usageNotes: "- Can control style of text and animation",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video" }, "language": { "type": "string", "description": "ISO language code for subtitle transcription" }, "fontName": { "type": "string", "description": "Google Font name for subtitle text" }, "fontSize": { "type": "number", "description": "Font size in pixels. Default: 100." }, "fontWeight": { "enum": ["normal", "bold", "black"], "type": "string", "description": "Font weight for subtitle text" }, "fontColor": { "enum": ["white", "black", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"], "type": "string", "description": "Color of the subtitle text" }, "highlightColor": { "enum": ["white", "black", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"], "type": "string", "description": "Color used to highlight the currently spoken word" }, "strokeWidth": { "type": "number", "description": "Width of the text stroke outline in pixels" }, "strokeColor": { "enum": ["black", "white", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"], "type": "string", "description": "Color of the text stroke outline" }, "backgroundColor": { "enum": ["black", "white", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta", "none"], "type": "string", "description": "Background color behind subtitle text. Use 'none' for transparent." }, "backgroundOpacity": { "type": "number", "description": "Opacity of the subtitle background. 0.0 = fully transparent, 1.0 = fully opaque." }, "position": { "enum": ["top", "center", "bottom"], "type": "string", "description": "Vertical position of subtitle text on screen" }, "yOffset": { "type": "number", "description": "Vertical offset in pixels from the position. Positive moves down, negative moves up. Default: 75." }, "wordsPerSubtitle": { "type": "number", "description": "Maximum number of words per subtitle segment. Use 1 for single-word display, 2-3 for short phrases, or 8-12 for full sentences. Default: 3." }, "enableAnimation": { "type": "boolean", "description": "When true, enables bounce-style entrance animation for subtitles. Default: true." }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "language", "fontName", "fontSize", "fontWeight", "fontColor", "highlightColor", "strokeWidth", "strokeColor", "backgroundColor", "backgroundOpacity", "position", "yOffset", "wordsPerSubtitle", "enableAnimation"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the video with subtitles added" } }, "required": ["videoUrl"] }
+      },
+      "airtableCreateUpdateRecord": {
+        stepType: "airtableCreateUpdateRecord",
+        description: "Create a new record or update an existing record in an Airtable table.",
+        usageNotes: '- If recordId is provided, updates that record. Otherwise, creates a new one.\n- When updating with updateMode "onlySpecified", unspecified fields are left as-is. With "all", unspecified fields are cleared.\n- Array fields (e.g. multipleAttachments) accept arrays of values.',
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Airtable OAuth connection ID" }, "baseId": { "type": "string", "description": "Airtable base ID" }, "tableId": { "type": "string", "description": "Airtable table ID" }, "recordId": { "type": "string", "description": "Record ID to update. Omit to create a new record" }, "updateMode": { "enum": ["onlySpecified", "all"], "type": "string", "description": "How to handle unspecified fields on update. 'onlySpecified' leaves them as-is, 'all' clears them" }, "fields": { "description": "Field schema metadata used for type resolution" }, "recordData": { "type": "object", "description": "Field values to set, keyed by field ID" } }, "required": ["baseId", "tableId", "fields", "recordData"] },
+        outputSchema: { "type": "object", "properties": { "recordId": { "type": "string", "description": "The Airtable record ID of the created or updated record" } }, "required": ["recordId"] }
+      },
+      "airtableDeleteRecord": {
+        stepType: "airtableDeleteRecord",
+        description: "Delete a record from an Airtable table by its record ID.",
+        usageNotes: "- Requires an active Airtable OAuth connection (connectionId).\n- Silently succeeds if the record does not exist.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Airtable OAuth connection ID" }, "baseId": { "type": "string", "description": "Airtable base ID" }, "tableId": { "type": "string", "description": "Airtable table ID" }, "recordId": { "type": "string", "description": "Record ID to delete" } }, "required": ["baseId", "tableId", "recordId"] },
+        outputSchema: { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the record was successfully deleted" } }, "required": ["deleted"] }
+      },
+      "airtableGetRecord": {
+        stepType: "airtableGetRecord",
+        description: "Fetch a single record from an Airtable table by its record ID.",
+        usageNotes: "- Requires an active Airtable OAuth connection (connectionId).\n- If the record is not found, returns a string message instead of a record object.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Airtable OAuth connection ID" }, "baseId": { "type": "string", "description": 'Airtable base ID (e.g. "appXXXXXX")' }, "tableId": { "type": "string", "description": 'Airtable table ID (e.g. "tblXXXXXX")' }, "recordId": { "type": "string", "description": 'Record ID to fetch (e.g. "recXXXXXX")' } }, "required": ["baseId", "tableId", "recordId"] },
+        outputSchema: { "type": "object", "properties": { "record": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string", "description": "Airtable record ID" }, "createdTime": { "type": "string", "description": "ISO 8601 timestamp when the record was created" }, "fields": { "type": "object", "description": "Field values keyed by field name" } }, "required": ["id", "createdTime", "fields"] }, { "type": "null" }] } }, "required": ["record"] }
+      },
+      "airtableGetTableRecords": {
+        stepType: "airtableGetTableRecords",
+        description: "Fetch multiple records from an Airtable table with optional pagination.",
+        usageNotes: "- Requires an active Airtable OAuth connection (connectionId).\n- Default limit is 100 records. Maximum is 1000.\n- When outputFormat is 'csv', the variable receives CSV text. The direct execution output always returns parsed records.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Airtable OAuth connection ID" }, "baseId": { "type": "string", "description": 'Airtable base ID (e.g. "appXXXXXX")' }, "tableId": { "type": "string", "description": 'Airtable table ID (e.g. "tblXXXXXX")' }, "outputFormat": { "enum": ["json", "csv"], "type": "string", "description": "Output format for the result. Defaults to 'json'" }, "limit": { "type": "number", "description": "Maximum number of records to return. Defaults to 100, max 1000" } }, "required": ["baseId", "tableId"] },
+        outputSchema: { "type": "object", "properties": { "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Airtable record ID" }, "createdTime": { "type": "string", "description": "ISO 8601 timestamp when the record was created" }, "fields": { "type": "object", "description": "Field values keyed by field name" } }, "required": ["id", "createdTime", "fields"] }, "description": "The list of records retrieved from the Airtable table" } }, "required": ["records"] }
+      },
+      "analyzeImage": {
+        stepType: "analyzeImage",
+        description: "Analyze an image using a vision model based on a text prompt.",
+        usageNotes: "- Uses the configured vision model to generate a text analysis of the image.\n- The prompt should describe what to look for or extract from the image.",
+        inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Instructions describing what to look for or extract from the image" }, "imageUrl": { "type": "string", "description": "URL of the image to analyze" }, "visionModelOverride": { "anyOf": [{ "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object" } }, "required": ["model"] }, { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"] }] } }, "required": ["prompt", "imageUrl"] },
+        outputSchema: { "type": "object", "properties": { "analysis": { "type": "string", "description": "Text analysis of the image generated by the vision model" } }, "required": ["analysis"] }
+      },
+      "analyzeVideo": {
+        stepType: "analyzeVideo",
+        description: "Analyze a video using a video analysis model based on a text prompt.",
+        usageNotes: "- Uses the configured video analysis model to generate a text analysis of the video.\n- The prompt should describe what to look for or extract from the video.",
+        inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Instructions describing what to look for or extract from the video" }, "videoUrl": { "type": "string", "description": "URL of the video to analyze" }, "videoAnalysisModelOverride": { "anyOf": [{ "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object" } }, "required": ["model"] }, { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"] }] } }, "required": ["prompt", "videoUrl"] },
+        outputSchema: { "type": "object", "properties": { "analysis": { "type": "string", "description": "Text analysis of the video generated by the video analysis model" } }, "required": ["analysis"] }
+      },
+      "captureThumbnail": {
+        stepType: "captureThumbnail",
+        description: "Capture a thumbnail from a video at a specified timestamp",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to capture a frame from" }, "at": { "anyOf": [{ "type": "number" }, { "type": "string" }] } }, "required": ["videoUrl", "at"] },
+        outputSchema: { "type": "object", "properties": { "thumbnailUrl": { "type": "string", "description": "URL of the captured thumbnail image" } }, "required": ["thumbnailUrl"] }
+      },
+      "codaCreateUpdatePage": {
+        stepType: "codaCreateUpdatePage",
+        description: "Create a new page or update an existing page in a Coda document.",
+        usageNotes: "- Requires a Coda OAuth connection (connectionId).\n- If pageData.pageId is provided, updates that page. Otherwise, creates a new one.\n- Page content is provided as markdown and converted to Coda's canvas format.\n- When updating, insertionMode controls how content is applied (default: 'append').",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Coda OAuth connection ID" }, "pageData": { "type": "object", "properties": { "docId": { "type": "string", "description": "Coda document ID" }, "pageId": { "type": "string", "description": "Page ID to update. Omit to create a new page" }, "name": { "type": "string", "description": "Page title" }, "subtitle": { "type": "string", "description": "Page subtitle" }, "iconName": { "type": "string", "description": "Page icon name" }, "imageUrl": { "type": "string", "description": "Page cover image URL" }, "parentPageId": { "type": "string", "description": "Parent page ID for nesting under another page" }, "pageContent": { "anyOf": [{ "type": "string" }, {}] }, "contentUpdate": { "description": "Content update payload for partial updates" }, "insertionMode": { "type": "string", "description": 'How to insert content on update: "append" or "replace"' } }, "required": ["docId", "name", "subtitle", "iconName", "imageUrl", "pageContent"], "description": "Page configuration including document ID, title, content, and optional parent page" } }, "required": ["pageData"] },
+        outputSchema: { "type": "object", "properties": { "pageId": { "type": "string", "description": "The Coda page ID of the created or updated page" } }, "required": ["pageId"] }
+      },
+      "codaCreateUpdateRow": {
+        stepType: "codaCreateUpdateRow",
+        description: "Create a new row or update an existing row in a Coda table.",
+        usageNotes: "- Requires a Coda OAuth connection (connectionId).\n- If rowId is provided, updates that row. Otherwise, creates a new one.\n- Row data keys are column IDs. Empty values are excluded.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Coda OAuth connection ID" }, "docId": { "type": "string", "description": "Coda document ID" }, "tableId": { "type": "string", "description": "Table ID within the document" }, "rowId": { "type": "string", "description": "Row ID to update. Omit to create a new row" }, "rowData": { "type": "object", "description": "Column values to set, keyed by column ID" } }, "required": ["docId", "tableId", "rowData"] },
+        outputSchema: { "type": "object", "properties": { "rowId": { "type": "string", "description": "The Coda row ID of the created or updated row" } }, "required": ["rowId"] }
+      },
+      "codaFindRow": {
+        stepType: "codaFindRow",
+        description: "Search for a row in a Coda table by matching column values.",
+        usageNotes: "- Requires a Coda OAuth connection (connectionId).\n- Returns the first row matching all specified column values, or null if no match.\n- Search criteria in rowData are ANDed together.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Coda OAuth connection ID" }, "docId": { "type": "string", "description": "Coda document ID" }, "tableId": { "type": "string", "description": "Table ID to search within" }, "rowData": { "type": "object", "description": "Column values to match against, keyed by column ID. All criteria are ANDed together" } }, "required": ["docId", "tableId", "rowData"] },
+        outputSchema: { "type": "object", "properties": { "row": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string", "description": "Coda row ID" }, "values": { "type": "object", "description": "Column values keyed by column name" } }, "required": ["id", "values"] }, { "type": "null" }] } }, "required": ["row"] }
+      },
+      "codaGetPage": {
+        stepType: "codaGetPage",
+        description: "Export and read the contents of a page from a Coda document.",
+        usageNotes: "- Requires a Coda OAuth connection (connectionId).\n- Page export is asynchronous on Coda's side \u2014 there may be a brief delay while it processes.\n- If a page was just created in a prior step, there is an automatic 20-second retry if the first export attempt fails.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Coda OAuth connection ID" }, "docId": { "type": "string", "description": "Coda document ID" }, "pageId": { "type": "string", "description": "Page ID within the document" }, "outputFormat": { "enum": ["html", "markdown"], "type": "string", "description": "Export format for the page content. Defaults to 'html'" } }, "required": ["docId", "pageId"] },
+        outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "Page content in the requested format (HTML or Markdown)" } }, "required": ["content"] }
+      },
+      "codaGetTableRows": {
+        stepType: "codaGetTableRows",
+        description: "Fetch rows from a Coda table with optional pagination.",
+        usageNotes: "- Requires a Coda OAuth connection (connectionId).\n- Default limit is 10000 rows. Rows are fetched in pages of 500.\n- When outputFormat is 'csv', the variable receives CSV text. The direct execution output always returns parsed rows.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Coda OAuth connection ID" }, "docId": { "type": "string", "description": "Coda document ID" }, "tableId": { "type": "string", "description": "Table ID within the document" }, "limit": { "type": ["number", "string"] }, "outputFormat": { "enum": ["json", "csv"], "type": "string", "description": "Output format for the result. Defaults to 'json'" } }, "required": ["docId", "tableId"] },
+        outputSchema: { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Coda row ID" }, "values": { "type": "object", "description": "Column values keyed by column name" } }, "required": ["id", "values"] }, "description": "The list of rows retrieved from the Coda table" } }, "required": ["rows"] }
+      },
+      "convertPdfToImages": {
+        stepType: "convertPdfToImages",
+        description: "Convert each page of a PDF document into a PNG image.",
+        usageNotes: "- Each page is converted to a separate PNG and re-hosted on the CDN.\n- Returns an array of image URLs, one per page.",
+        inputSchema: { "type": "object", "properties": { "pdfUrl": { "type": "string", "description": "URL of the PDF document to convert" } }, "required": ["pdfUrl"] },
+        outputSchema: { "type": "object", "properties": { "imageUrls": { "type": "array", "items": { "type": "string" }, "description": "CDN URLs of the generated page images, one per page of the PDF" } }, "required": ["imageUrls"] }
+      },
+      "createDataSource": {
+        stepType: "createDataSource",
+        description: "Create a new empty vector data source for the current app.",
+        usageNotes: '- Creates a new data source (vector database) associated with the current app version.\n- The data source is created empty \u2014 use the "Upload Data Source Document" block to add documents.\n- Returns the new data source ID which can be used in subsequent blocks.',
+        inputSchema: { "type": "object", "properties": { "name": { "type": "string", "description": "Name for the new data source (supports variable interpolation)" } }, "required": ["name"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "createGoogleCalendarEvent": {
+        stepType: "createGoogleCalendarEvent",
+        description: "Create a new event on a Google Calendar.",
+        usageNotes: '- Requires a Google OAuth connection with Calendar events scope.\n- Date/time values must be ISO 8601 format (e.g. "2025-07-02T10:00:00-07:00").\n- Attendees are specified as one email address per line in a single string.\n- Set addMeetLink to true to automatically attach a Google Meet video call.',
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "summary": { "type": "string", "description": "Event title" }, "description": { "type": "string", "description": "Event description" }, "location": { "type": "string", "description": "Event location" }, "startDateTime": { "type": "string", "description": "Start time in ISO 8601 format" }, "endDateTime": { "type": "string", "description": "End time in ISO 8601 format" }, "attendees": { "type": "string", "description": "Attendee email addresses, one per line" }, "addMeetLink": { "type": "boolean", "description": "Whether to attach a Google Meet video call link" }, "calendarId": { "type": "string", "description": 'Calendar ID (defaults to "primary" if omitted)' } }, "required": ["summary", "startDateTime", "endDateTime"] },
+        outputSchema: { "type": "object", "properties": { "eventId": { "type": "string", "description": "Google Calendar event ID" }, "htmlLink": { "type": "string", "description": "URL to view the event in Google Calendar" } }, "required": ["eventId", "htmlLink"] }
+      },
+      "createGoogleDoc": {
+        stepType: "createGoogleDoc",
+        description: "Create a new Google Document and optionally populate it with content.",
+        usageNotes: '- textType determines how the text field is interpreted: "plain" for plain text, "html" for HTML markup, "markdown" for Markdown.',
+        inputSchema: { "type": "object", "properties": { "title": { "type": "string", "description": "Title for the new document" }, "text": { "type": "string", "description": "Document body content" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "textType": { "enum": ["plain", "html", "markdown"], "type": "string", "description": 'Format of the text field: "plain", "html", or "markdown"' } }, "required": ["title", "text", "textType"] },
+        outputSchema: { "type": "object", "properties": { "documentUrl": { "type": "string", "description": "URL of the newly created Google Document" } }, "required": ["documentUrl"] }
+      },
+      "createGoogleSheet": {
+        stepType: "createGoogleSheet",
+        description: "Create a new Google Spreadsheet and populate it with CSV data.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "title": { "type": "string", "description": "Title for the new spreadsheet" }, "text": { "type": "string", "description": "CSV data to populate the sheet with" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["title", "text"] },
+        outputSchema: { "type": "object", "properties": { "spreadsheetUrl": { "type": "string", "description": "URL of the newly created Google Spreadsheet" } }, "required": ["spreadsheetUrl"] }
+      },
+      "deleteDataSource": {
+        stepType: "deleteDataSource",
+        description: "Delete a vector data source from the current app.",
+        usageNotes: "- Soft-deletes a data source (vector database) by marking it as deleted.\n- The Milvus partition is cleaned up asynchronously by a background cron job.\n- The data source must belong to the current app version.",
+        inputSchema: { "type": "object", "properties": { "dataSourceId": { "type": "string", "description": "ID of the data source to delete (supports variable interpolation)" } }, "required": ["dataSourceId"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "deleteDataSourceDocument": {
+        stepType: "deleteDataSourceDocument",
+        description: "Delete a single document from a data source.",
+        usageNotes: "- Soft-deletes a document by marking it as deleted.\n- Requires both the data source ID and document ID.\n- After deletion, reloads vectors into Milvus so the data source reflects the change immediately.",
+        inputSchema: { "type": "object", "properties": { "dataSourceId": { "type": "string", "description": "ID of the data source containing the document (supports variable interpolation)" }, "documentId": { "type": "string", "description": "ID of the document to delete (supports variable interpolation)" } }, "required": ["dataSourceId", "documentId"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "deleteGmailEmail": {
+        stepType: "deleteGmailEmail",
+        description: "Move an email to trash in the connected Gmail account (recoverable delete).",
+        usageNotes: "- Requires a Google OAuth connection with Gmail modify scope.\n- Uses trash (recoverable) rather than permanent delete.",
+        inputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID to delete (move to trash)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["messageId"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "deleteGoogleCalendarEvent": {
+        stepType: "deleteGoogleCalendarEvent",
+        description: "Retrieve a specific event from a Google Calendar by event ID.",
+        usageNotes: "- Requires a Google OAuth connection with Calendar events scope.\n- The variable receives JSON or XML-like text depending on exportType. The direct execution output always returns the structured event.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "eventId": { "type": "string", "description": "Google Calendar event ID to delete" }, "calendarId": { "type": "string", "description": 'Calendar ID (defaults to "primary" if omitted)' } }, "required": ["eventId"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "deleteGoogleSheetRows": {
+        stepType: "deleteGoogleSheetRows",
+        description: "Delete a range of rows from a Google Spreadsheet.",
+        usageNotes: "- Requires a Google OAuth connection with Drive scope.\n- startRow and endRow are 1-based row numbers (inclusive).\n- If sheetName is omitted, operates on the first sheet.",
+        inputSchema: { "type": "object", "properties": { "documentId": { "type": "string", "description": "Google Spreadsheet ID or URL" }, "sheetName": { "type": "string", "description": "Sheet/tab name (defaults to first sheet)" }, "startRow": { "type": "string", "description": "First row to delete (1-based, inclusive)" }, "endRow": { "type": "string", "description": "Last row to delete (1-based, inclusive)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["documentId", "startRow", "endRow"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "detectPII": {
+        stepType: "detectPII",
+        description: "Scan text for personally identifiable information using Microsoft Presidio.",
+        usageNotes: "- In workflow mode, transitions to detectedStepId if PII is found, notDetectedStepId otherwise.\n- In direct execution, returns the detection results without transitioning.\n- If entities is empty, returns immediately with no detections.",
+        inputSchema: { "type": "object", "properties": { "input": { "type": "string", "description": "Text to scan for personally identifiable information" }, "language": { "type": "string", "description": 'Language code of the input text (e.g. "en")' }, "entities": { "type": "array", "items": { "type": "string" }, "description": 'PII entity types to scan for (e.g. ["PHONE_NUMBER", "EMAIL_ADDRESS"]). Empty array means nothing is scanned.' }, "detectedStepId": { "type": "string", "description": "Step to transition to if PII is detected (workflow mode)" }, "notDetectedStepId": { "type": "string", "description": "Step to transition to if no PII is detected (workflow mode)" }, "outputLogVariable": { "type": "string", "description": "Variable name to store the raw detection results" } }, "required": ["input", "language", "entities"] },
+        outputSchema: { "type": "object", "properties": { "detected": { "type": "boolean", "description": "Whether any PII was found in the input text" }, "detections": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "description": 'PII entity type (e.g. "PHONE_NUMBER", "EMAIL_ADDRESS", "PERSON")' }, "start": { "type": "number", "description": "Start character index in the input text" }, "end": { "type": "number", "description": "End character index in the input text" }, "score": { "type": "number", "description": "Confidence score between 0 and 1" } }, "required": ["entity_type", "start", "end", "score"] }, "description": "List of detected PII entities with type, location, and confidence" } }, "required": ["detected", "detections"] }
+      },
+      "downloadVideo": {
+        stepType: "downloadVideo",
+        description: "Download a video file",
+        usageNotes: "- Works with YouTube, TikTok, etc., by using ytdlp behind the scenes\n- Can save as mp4 or mp3",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the video to download (supports YouTube, TikTok, etc. via yt-dlp)" }, "format": { "enum": ["mp4", "mp3"], "type": "string", "description": "Output format for the downloaded file" } }, "required": ["videoUrl", "format"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the downloaded and re-hosted video file" } }, "required": ["videoUrl"] }
+      },
+      "enhanceImageGenerationPrompt": {
+        stepType: "enhanceImageGenerationPrompt",
+        description: "Generate or enhance an image generation prompt using a language model. Optionally generates a negative prompt.",
+        usageNotes: "- Rewrites the user's prompt with added detail about style, lighting, colors, and composition.\n- Also useful for initial generation, it doesn't always need to be enhancing an existing prompt\n- When includeNegativePrompt is true, a second model call generates a negative prompt.",
+        inputSchema: { "type": "object", "properties": { "initialPrompt": { "type": "string", "description": "The raw prompt to enhance" }, "includeNegativePrompt": { "type": "boolean", "description": "Whether to also generate a negative prompt" }, "negativePromptDestinationVariableName": { "type": "string", "description": "Variable name to save the negative prompt into" }, "systemPrompt": { "type": "string", "description": "Custom system prompt for the enhancement model. Uses a default prompt if not provided" }, "modelOverride": { "description": "Model override settings. Leave undefined to use the default model" } }, "required": ["initialPrompt", "includeNegativePrompt", "systemPrompt"] },
+        outputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "The enhanced image generation prompt" }, "negativePrompt": { "type": "string", "description": "The negative prompt, only present when includeNegativePrompt was true" } }, "required": ["prompt"] }
+      },
+      "enhanceVideoGenerationPrompt": {
+        stepType: "enhanceVideoGenerationPrompt",
+        description: "Generate or enhance a video generation prompt using a language model. Optionally generates a negative prompt.",
+        usageNotes: "- Rewrites the user's prompt with added detail about style, camera movement, lighting, and composition.\n- Also useful for initial generation, it doesn't always need to be enhancing an existing prompt\n- When includeNegativePrompt is true, a second model call generates a negative prompt.",
+        inputSchema: { "type": "object", "properties": { "initialPrompt": { "type": "string", "description": "The raw prompt to enhance" }, "includeNegativePrompt": { "type": "boolean", "description": "Whether to also generate a negative prompt" }, "negativePromptDestinationVariableName": { "type": "string", "description": "Variable name to save the negative prompt into" }, "systemPrompt": { "type": "string", "description": "Custom system prompt for the enhancement model. Uses a default prompt if not provided" }, "modelOverride": { "description": "Model override settings. Leave undefined to use the default model" } }, "required": ["initialPrompt", "includeNegativePrompt", "systemPrompt"] },
+        outputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "The enhanced video generation prompt" }, "negativePrompt": { "type": "string", "description": "The negative prompt, only present when includeNegativePrompt was true" } }, "required": ["prompt"] }
+      },
+      "enrichPerson": {
+        stepType: "enrichPerson",
+        description: "Look up professional information about a person using Apollo.io. Search by ID, name, LinkedIn URL, email, or domain.",
+        usageNotes: "- At least one search parameter must be provided.\n- Returns enriched data from Apollo including contact details, employment info, and social profiles.",
+        inputSchema: { "type": "object", "properties": { "params": { "type": "object", "properties": { "id": { "type": "string", "description": "Apollo person ID" }, "name": { "type": "string", "description": "Person's full name" }, "linkedinUrl": { "type": "string", "description": "LinkedIn profile URL" }, "email": { "type": "string", "description": "Email address" }, "domain": { "type": "string", "description": "Company domain" } }, "required": ["id", "name", "linkedinUrl", "email", "domain"], "description": "Search parameters to identify the person (ID, name, LinkedIn URL, email, or domain)" } }, "required": ["params"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "Apollo enrichment result with contact details, employment history, and social profiles" } }, "required": ["data"] }
+      },
+      "extractAudioFromVideo": {
+        stepType: "extractAudioFromVideo",
+        description: "Extract audio MP3 from a video file",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to extract audio from" } }, "required": ["videoUrl"] },
+        outputSchema: { "type": "object", "properties": { "audioUrl": { "type": "string", "description": "URL of the extracted audio MP3 file" } }, "required": ["audioUrl"] }
+      },
+      "extractText": {
+        stepType: "extractText",
+        description: "Download a file from a URL and extract its text content. Supports PDFs, plain text files, and other document formats.",
+        usageNotes: "- Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.\n- Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.\n- Files are rehosted on the MindStudio CDN before extraction.\n- Maximum file size is 50MB per URL.",
+        inputSchema: { "type": "object", "properties": { "url": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["url"] },
+        outputSchema: { "type": "object", "properties": { "text": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["text"] }
+      },
+      "fetchDataSourceDocument": {
+        stepType: "fetchDataSourceDocument",
+        description: "Fetch the full extracted text contents of a document in a data source.",
+        usageNotes: '- Loads a document by ID and returns its full extracted text content.\n- The document must have been successfully processed (status "done").\n- Also returns document metadata (name, summary, word count).',
+        inputSchema: { "type": "object", "properties": { "dataSourceId": { "type": "string", "description": "ID of the data source containing the document (supports variable interpolation)" }, "documentId": { "type": "string", "description": "ID of the document to fetch (supports variable interpolation)" } }, "required": ["dataSourceId", "documentId"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "fetchGoogleDoc": {
+        stepType: "fetchGoogleDoc",
+        description: "Fetch the contents of an existing Google Document.",
+        usageNotes: '- exportType controls the output format: "html" for HTML markup, "markdown" for Markdown, "json" for structured JSON, "plain" for plain text.',
+        inputSchema: { "type": "object", "properties": { "documentId": { "type": "string", "description": "Google Document ID (from the document URL)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["html", "markdown", "json", "plain"], "type": "string", "description": 'Output format: "html", "markdown", "json", or "plain"' } }, "required": ["documentId", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "Document contents in the requested export format" } }, "required": ["content"] }
+      },
+      "fetchGoogleSheet": {
+        stepType: "fetchGoogleSheet",
+        description: "Fetch contents of a Google Spreadsheet range.",
+        usageNotes: '- range uses A1 notation (e.g. "Sheet1!A1:C10"). Omit to fetch the entire first sheet.\n- exportType controls the output format: "csv" for comma-separated values, "json" for structured JSON.',
+        inputSchema: { "type": "object", "properties": { "spreadsheetId": { "type": "string", "description": "Google Spreadsheet ID (from the spreadsheet URL)" }, "range": { "type": "string", "description": 'Cell range in A1 notation (e.g. "Sheet1!A1:C10")' }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["csv", "json"], "type": "string", "description": 'Output format: "csv" or "json"' } }, "required": ["spreadsheetId", "range", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "Spreadsheet data in the requested export format" } }, "required": ["content"] }
+      },
+      "fetchSlackChannelHistory": {
+        stepType: "fetchSlackChannelHistory",
+        description: "Fetch recent message history from a Slack channel.",
+        usageNotes: "- The user is responsible for connecting their Slack workspace and selecting the channel",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Slack OAuth connection ID (leave empty to allow user to select)" }, "channelId": { "type": "string", "description": "Slack channel ID (leave empty to allow user to select a channel)" }, "limit": { "type": "number", "description": "Maximum number of messages to return (1-15)" }, "startDate": { "type": "string", "description": "Earliest date to include messages from" }, "endDate": { "type": "string", "description": "Latest date to include messages up to" }, "includeImages": { "type": "boolean", "description": "Whether to include images in the output" }, "includeRawMessage": { "type": "boolean", "description": "Whether to include the raw Slack message object (useful for bot messages with complex attachments)" } }, "required": ["channelId"] },
+        outputSchema: { "type": "object", "properties": { "messages": { "type": "array", "items": { "type": "object", "properties": { "from": { "type": "string" }, "content": { "type": "string" }, "timestamp": { "type": "string" }, "images": { "type": "array", "items": { "type": "string" } }, "rawMessage": { "type": "object", "properties": { "app_id": { "type": "string" }, "assistant_app_thread": { "type": "object", "properties": { "first_user_thread_reply": { "type": "string" }, "title": { "type": "string" }, "title_blocks": { "type": "array", "items": { "type": "string" } } } }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "actions": { "type": "array", "items": { "type": "string" } }, "app_id": { "type": "string" }, "app_unfurl_url": { "type": "string" }, "author_icon": { "type": "string" }, "author_id": { "type": "string" }, "author_link": { "type": "string" }, "author_name": { "type": "string" }, "author_subname": { "type": "string" }, "blocks": { "type": "array", "items": { "type": "string" } }, "bot_id": { "type": "string" }, "bot_team_id": { "type": "string" }, "callback_id": { "type": "string" }, "channel_id": { "type": "string" }, "channel_name": { "type": "string" }, "channel_team": { "type": "string" }, "color": { "type": "string" }, "fallback": { "type": "string" }, "fields": { "type": "array", "items": { "type": "string" } }, "file_id": { "type": "string" }, "filename": { "type": "string" }, "files": { "type": "array", "items": { "type": "string" } }, "footer": { "type": "string" }, "footer_icon": { "type": "string" }, "from_url": { "type": "string" }, "hide_border": { "type": "boolean" }, "hide_color": { "type": "boolean" }, "id": { "type": "number" }, "image_bytes": { "type": "number" }, "image_height": { "type": "number" }, "image_url": { "type": "string" }, "image_width": { "type": "number" }, "indent": { "type": "boolean" }, "is_app_unfurl": { "type": "boolean" }, "is_file_attachment": { "type": "boolean" }, "is_msg_unfurl": { "type": "boolean" }, "is_reply_unfurl": { "type": "boolean" }, "is_thread_root_unfurl": { "type": "boolean" }, "list": { "type": "string" }, "list_record": { "type": "string" }, "list_record_id": { "type": "string" }, "list_records": { "type": "array", "items": { "type": "string" } }, "list_schema": { "type": "array", "items": { "type": "string" } }, "list_view": { "type": "string" }, "list_view_id": { "type": "string" }, "message_blocks": { "type": "array", "items": { "type": "string" } }, "metadata": { "type": "string" }, "mimetype": { "type": "string" }, "mrkdwn_in": { "type": "array", "items": { "type": "string" } }, "msg_subtype": { "type": "string" }, "original_url": { "type": "string" }, "pretext": { "type": "string" }, "preview": { "type": "string" }, "service_icon": { "type": "string" }, "service_name": { "type": "string" }, "service_url": { "type": "string" }, "size": { "type": "number" }, "text": { "type": "string" }, "thumb_height": { "type": "number" }, "thumb_url": { "type": "string" }, "thumb_width": { "type": "number" }, "title": { "type": "string" }, "title_link": { "type": "string" }, "ts": { "type": "string" }, "url": { "type": "string" }, "video_html": { "type": "string" }, "video_html_height": { "type": "number" }, "video_html_width": { "type": "number" }, "video_url": { "type": "string" } } } }, "blocks": { "type": "array", "items": { "type": "object", "properties": { "accessory": { "type": "string" }, "alt_text": { "type": "string" }, "api_decoration_available": { "type": "boolean" }, "app_collaborators": { "type": "array", "items": { "type": "string" } }, "app_id": { "type": "string" }, "author_name": { "type": "string" }, "block_id": { "type": "string" }, "bot_user_id": { "type": "string" }, "button_label": { "type": "string" }, "call": { "type": "string" }, "call_id": { "type": "string" }, "description": { "type": "string" }, "developer_trace_id": { "type": "string" }, "dispatch_action": { "type": "boolean" }, "element": { "type": "string" }, "elements": { "type": "array", "items": { "type": "string" } }, "expand": { "type": "boolean" }, "external_id": { "type": "string" }, "fallback": { "type": "string" }, "fields": { "type": "array", "items": { "type": "string" } }, "file": { "type": "string" }, "file_id": { "type": "string" }, "function_trigger_id": { "type": "string" }, "hint": { "type": "string" }, "image_bytes": { "type": "number" }, "image_height": { "type": "number" }, "image_url": { "type": "string" }, "image_width": { "type": "number" }, "is_animated": { "type": "boolean" }, "is_workflow_app": { "type": "boolean" }, "label": { "type": "string" }, "optional": { "type": "boolean" }, "owning_team_id": { "type": "string" }, "provider_icon_url": { "type": "string" }, "provider_name": { "type": "string" }, "sales_home_workflow_app_type": { "type": "number" }, "share_url": { "type": "string" }, "slack_file": { "type": "string" }, "source": { "type": "string" }, "text": { "type": "string" }, "thumbnail_url": { "type": "string" }, "title": { "type": "string" }, "title_url": { "type": "string" }, "trigger_subtype": { "type": "string" }, "trigger_type": { "type": "string" }, "type": { "type": "string" }, "url": { "type": "string" }, "video_url": { "type": "string" }, "workflow_id": { "type": "string" } } } }, "bot_id": { "type": "string" }, "bot_profile": { "type": "object", "properties": { "app_id": { "type": "string" }, "deleted": { "type": "boolean" }, "icons": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "team_id": { "type": "string" }, "updated": { "type": "number" } } }, "client_msg_id": { "type": "string" }, "display_as_bot": { "type": "boolean" }, "edited": { "type": "object", "properties": { "ts": { "type": "string" }, "user": { "type": "string" } } }, "files": { "type": "array", "items": { "type": "object", "properties": { "access": { "type": "string" }, "alt_txt": { "type": "string" }, "app_id": { "type": "string" }, "app_name": { "type": "string" }, "attachments": { "type": "array", "items": {} }, "blocks": { "type": "array", "items": { "type": "string" } }, "bot_id": { "type": "string" }, "can_toggle_canvas_lock": { "type": "boolean" }, "canvas_printing_enabled": { "type": "boolean" }, "canvas_template_mode": { "type": "string" }, "cc": { "type": "array", "items": { "type": "string" } }, "channel_actions_count": { "type": "number" }, "channel_actions_ts": { "type": "string" }, "channels": { "type": "array", "items": { "type": "string" } }, "comments_count": { "type": "number" }, "converted_pdf": { "type": "string" }, "created": { "type": "number" }, "deanimate": { "type": "string" }, "deanimate_gif": { "type": "string" }, "display_as_bot": { "type": "boolean" }, "dm_mpdm_users_with_file_access": { "type": "array", "items": { "type": "string" } }, "duration_ms": { "type": "number" }, "edit_link": { "type": "string" }, "edit_timestamp": { "type": "number" }, "editable": { "type": "boolean" }, "editor": { "type": "string" }, "editors": { "type": "array", "items": { "type": "string" } }, "external_id": { "type": "string" }, "external_type": { "type": "string" }, "external_url": { "type": "string" }, "favorites": { "type": "array", "items": { "type": "string" } }, "file_access": { "type": "string" }, "filetype": { "type": "string" }, "from": { "type": "array", "items": { "type": "string" } }, "groups": { "type": "array", "items": { "type": "string" } }, "has_more": { "type": "boolean" }, "has_more_shares": { "type": "boolean" }, "has_rich_preview": { "type": "boolean" }, "headers": { "type": "string" }, "hls": { "type": "string" }, "hls_embed": { "type": "string" }, "id": { "type": "string" }, "image_exif_rotation": { "type": "number" }, "ims": { "type": "array", "items": { "type": "string" } }, "initial_comment": { "type": "string" }, "is_channel_space": { "type": "boolean" }, "is_external": { "type": "boolean" }, "is_public": { "type": "boolean" }, "is_restricted_sharing_enabled": { "type": "boolean" }, "is_starred": { "type": "boolean" }, "last_editor": { "type": "string" }, "last_read": { "type": "number" }, "lines": { "type": "number" }, "lines_more": { "type": "number" }, "linked_channel_id": { "type": "string" }, "list_csv_download_url": { "type": "string" }, "list_limits": { "type": "string" }, "list_metadata": { "type": "string" }, "media_display_type": { "type": "string" }, "media_progress": { "type": "string" }, "mimetype": { "type": "string" }, "mode": { "type": "string" }, "mp4": { "type": "string" }, "mp4_low": { "type": "string" }, "name": { "type": "string" }, "non_owner_editable": { "type": "boolean" }, "num_stars": { "type": "number" }, "org_or_workspace_access": { "type": "string" }, "original_attachment_count": { "type": "number" }, "original_h": { "type": "string" }, "original_w": { "type": "string" }, "permalink": { "type": "string" }, "permalink_public": { "type": "string" }, "pinned_to": { "type": "array", "items": { "type": "string" } }, "pjpeg": { "type": "string" }, "plain_text": { "type": "string" }, "pretty_type": { "type": "string" }, "preview": { "type": "string" }, "preview_highlight": { "type": "string" }, "preview_is_truncated": { "type": "boolean" }, "preview_plain_text": { "type": "string" }, "private_channels_with_file_access_count": { "type": "number" }, "private_file_with_access_count": { "type": "number" }, "public_url_shared": { "type": "boolean" }, "quip_thread_id": { "type": "string" }, "reactions": { "type": "array", "items": { "type": "string" } }, "saved": { "type": "string" }, "sent_to_self": { "type": "boolean" }, "shares": { "type": "string" }, "show_badge": { "type": "boolean" }, "simplified_html": { "type": "string" }, "size": { "type": "number" }, "source_team": { "type": "string" }, "subject": { "type": "string" }, "subtype": { "type": "string" }, "team_pref_version_history_enabled": { "type": "boolean" }, "teams_shared_with": { "type": "array", "items": {} }, "template_conversion_ts": { "type": "number" }, "template_description": { "type": "string" }, "template_icon": { "type": "string" }, "template_name": { "type": "string" }, "template_title": { "type": "string" }, "thumb_1024": { "type": "string" }, "thumb_1024_gif": { "type": "string" }, "thumb_1024_h": { "type": "string" }, "thumb_1024_w": { "type": "string" }, "thumb_160": { "type": "string" }, "thumb_160_gif": { "type": "string" }, "thumb_160_h": { "type": "string" }, "thumb_160_w": { "type": "string" }, "thumb_360": { "type": "string" }, "thumb_360_gif": { "type": "string" }, "thumb_360_h": { "type": "string" }, "thumb_360_w": { "type": "string" }, "thumb_480": { "type": "string" }, "thumb_480_gif": { "type": "string" }, "thumb_480_h": { "type": "string" }, "thumb_480_w": { "type": "string" }, "thumb_64": { "type": "string" }, "thumb_64_gif": { "type": "string" }, "thumb_64_h": { "type": "string" }, "thumb_64_w": { "type": "string" }, "thumb_720": { "type": "string" }, "thumb_720_gif": { "type": "string" }, "thumb_720_h": { "type": "string" }, "thumb_720_w": { "type": "string" }, "thumb_80": { "type": "string" }, "thumb_800": { "type": "string" }, "thumb_800_gif": { "type": "string" }, "thumb_800_h": { "type": "string" }, "thumb_800_w": { "type": "string" }, "thumb_80_gif": { "type": "string" }, "thumb_80_h": { "type": "string" }, "thumb_80_w": { "type": "string" }, "thumb_960": { "type": "string" }, "thumb_960_gif": { "type": "string" }, "thumb_960_h": { "type": "string" }, "thumb_960_w": { "type": "string" }, "thumb_gif": { "type": "string" }, "thumb_pdf": { "type": "string" }, "thumb_pdf_h": { "type": "string" }, "thumb_pdf_w": { "type": "string" }, "thumb_tiny": { "type": "string" }, "thumb_video": { "type": "string" }, "thumb_video_h": { "type": "number" }, "thumb_video_w": { "type": "number" }, "timestamp": { "type": "number" }, "title": { "type": "string" }, "title_blocks": { "type": "array", "items": { "type": "string" } }, "to": { "type": "array", "items": { "type": "string" } }, "transcription": { "type": "string" }, "update_notification": { "type": "number" }, "updated": { "type": "number" }, "url_private": { "type": "string" }, "url_private_download": { "type": "string" }, "url_static_preview": { "type": "string" }, "user": { "type": "string" }, "user_team": { "type": "string" }, "username": { "type": "string" }, "vtt": { "type": "string" } } } }, "icons": { "type": "object", "properties": { "emoji": { "type": "string" }, "image_36": { "type": "string" }, "image_48": { "type": "string" }, "image_64": { "type": "string" }, "image_72": { "type": "string" } } }, "inviter": { "type": "string" }, "is_locked": { "type": "boolean" }, "latest_reply": { "type": "string" }, "metadata": { "type": "object", "properties": { "event_payload": { "type": "string" }, "event_type": { "type": "string" } } }, "parent_user_id": { "type": "string" }, "purpose": { "type": "string" }, "reactions": { "type": "array", "items": { "type": "object", "properties": { "count": { "type": "number" }, "name": { "type": "string" }, "url": { "type": "string" }, "users": { "type": "array", "items": { "type": "string" } } } } }, "reply_count": { "type": "number" }, "reply_users": { "type": "array", "items": { "type": "string" } }, "reply_users_count": { "type": "number" }, "root": { "type": "object", "properties": { "bot_id": { "type": "string" }, "icons": { "type": "string" }, "latest_reply": { "type": "string" }, "parent_user_id": { "type": "string" }, "reply_count": { "type": "number" }, "reply_users": { "type": "array", "items": { "type": "string" } }, "reply_users_count": { "type": "number" }, "subscribed": { "type": "boolean" }, "subtype": { "type": "string" }, "text": { "type": "string" }, "thread_ts": { "type": "string" }, "ts": { "type": "string" }, "type": { "type": "string" }, "username": { "type": "string" } } }, "subscribed": { "type": "boolean" }, "subtype": { "type": "string" }, "team": { "type": "string" }, "text": { "type": "string" }, "thread_ts": { "type": "string" }, "topic": { "type": "string" }, "ts": { "type": "string" }, "type": { "type": "string" }, "upload": { "type": "boolean" }, "user": { "type": "string" }, "username": { "type": "string" }, "x_files": { "type": "array", "items": { "type": "string" } } } } }, "required": ["from", "content"] }, "description": "List of messages from the channel history" } }, "required": ["messages"] }
+      },
+      "fetchYoutubeCaptions": {
+        stepType: "fetchYoutubeCaptions",
+        description: "Retrieve the captions/transcript for a YouTube video.",
+        usageNotes: '- Supports multiple languages via the language parameter.\n- "text" export produces timestamped plain text; "json" export produces structured transcript data.',
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "YouTube video URL to fetch captions for" }, "exportType": { "enum": ["text", "json"], "type": "string", "description": 'Output format: "text" for timestamped plain text, "json" for structured transcript data' }, "language": { "type": "string", "description": 'Language code for the captions (e.g. "en")' } }, "required": ["videoUrl", "exportType", "language"] },
+        outputSchema: { "type": "object", "properties": { "transcripts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "Transcript text segment" }, "start": { "type": "number", "description": "Start time of the segment in seconds" } }, "required": ["text", "start"] }, "description": "Parsed transcript segments with text and start timestamps" } }, "required": ["transcripts"] }
+      },
+      "fetchYoutubeChannel": {
+        stepType: "fetchYoutubeChannel",
+        description: "Retrieve metadata and recent videos for a YouTube channel.",
+        usageNotes: "- Accepts a YouTube channel URL (e.g. https://www.youtube.com/@ChannelName or /channel/ID).\n- Returns channel info and video listings as a JSON object.",
+        inputSchema: { "type": "object", "properties": { "channelUrl": { "type": "string", "description": "YouTube channel URL (e.g. https://www.youtube.com/@ChannelName or /channel/ID)" } }, "required": ["channelUrl"] },
+        outputSchema: { "type": "object", "properties": { "channel": { "type": "object", "description": "Channel metadata and video listings" } }, "required": ["channel"] }
+      },
+      "fetchYoutubeComments": {
+        stepType: "fetchYoutubeComments",
+        description: "Retrieve comments for a YouTube video.",
+        usageNotes: '- Paginates through comments (up to 5 pages).\n- "text" export produces markdown-formatted text; "json" export produces structured comment data.',
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "YouTube video URL to fetch comments for" }, "exportType": { "enum": ["text", "json"], "type": "string", "description": 'Output format: "text" for markdown-formatted text, "json" for structured comment data' }, "limitPages": { "type": "string", "description": "Maximum number of comment pages to fetch (1-5)" } }, "required": ["videoUrl", "exportType", "limitPages"] },
+        outputSchema: { "type": "object", "properties": { "comments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique comment identifier" }, "link": { "type": "string", "description": "Direct URL to the comment" }, "publishedDate": { "type": "string", "description": "Date the comment was published" }, "text": { "type": "string", "description": "Text content of the comment" }, "likes": { "type": "number", "description": "Number of likes on the comment" }, "replies": { "type": "number", "description": "Number of replies to the comment" }, "author": { "type": "string", "description": "Display name of the comment author" }, "authorLink": { "type": "string", "description": "URL to the author's YouTube channel" }, "authorImg": { "type": "string", "description": "URL of the author's profile image" } }, "required": ["id", "link", "publishedDate", "text", "likes", "replies", "author", "authorLink", "authorImg"] }, "description": "List of comments retrieved from the video" } }, "required": ["comments"] }
+      },
+      "fetchYoutubeVideo": {
+        stepType: "fetchYoutubeVideo",
+        description: "Retrieve metadata for a YouTube video (title, description, stats, channel info).",
+        usageNotes: "- Returns video metadata, channel info, and engagement stats.\n- Video format data is excluded from the response.",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "YouTube video URL to fetch metadata for" } }, "required": ["videoUrl"] },
+        outputSchema: { "type": "object", "properties": { "video": { "type": "object", "description": "Video metadata including title, description, stats, and channel info" } }, "required": ["video"] }
+      },
+      "generateAsset": {
+        stepType: "generatePdf",
+        description: "Generate an HTML asset and export it as a webpage, PDF, or image",
+        usageNotes: '- 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.\n- The template for the HTML page is generated by a separate process, and it can only use variables that have already been defined in the workflow at the time of its execution. It has full access to handlebars to render the HTML template, including a handlebars helper to render a markdown variable string as HTML (which can be useful for creating templates that render long strings). The template can also create its own simple JavaScript to do things like format dates and strings.\n- 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.\n- 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\n- Can either display output directly to user (foreground mode) or save the URL of the asset to a variable (background mode)',
+        inputSchema: { "type": "object", "properties": { "source": { "type": "string", "description": "The HTML or Markdown source template for the asset" }, "sourceType": { "enum": ["html", "markdown", "spa", "raw", "dynamic", "customInterface"], "type": "string", "description": "Source type: html, markdown (auto-formatted), spa (single page app), raw (pre-generated HTML in a variable), dynamic (AI-generated from prompt), or customInterface" }, "outputFormat": { "enum": ["pdf", "png", "html", "mp4", "openGraph"], "type": "string", "description": "The output format for the generated asset" }, "pageSize": { "enum": ["full", "letter", "A4", "custom"], "type": "string", "description": "Page size for PDF, PNG, or MP4 output" }, "testData": { "type": "object", "description": "Test data used for previewing the template with sample variable values" }, "options": { "type": "object", "properties": { "pageWidthPx": { "type": "number", "description": "Custom page width in pixels (for custom pageSize)" }, "pageHeightPx": { "type": "number", "description": "Custom page height in pixels (for custom pageSize)" }, "pageOrientation": { "enum": ["portrait", "landscape"], "type": "string", "description": "Page orientation for the rendered output" }, "rehostMedia": { "type": "boolean", "description": "Whether to re-host third-party images on the MindStudio CDN" }, "videoDurationSeconds": { "type": "number", "description": "Duration in seconds for MP4 video output" } }, "description": "Additional rendering options" }, "spaSource": { "type": "object", "properties": { "source": { "type": "string", "description": "Source code of the SPA (legacy, use files instead)" }, "lastCompiledSource": { "type": "string", "description": "Last compiled source (cached)" }, "files": { "type": "object", "description": "Multi-file SPA source" }, "paths": { "type": "array", "items": { "type": "string" }, "description": "Available route paths in the SPA" }, "root": { "type": "string", "description": "Root URL of the SPA bundle" }, "zipUrl": { "type": "string", "description": "URL of the zipped SPA bundle" } }, "required": ["paths", "root", "zipUrl"], "description": "Single page app source configuration (advanced)" }, "rawSource": { "type": "string", "description": "Raw HTML source stored in a variable, using handlebars syntax (e.g. {{myHtmlVariable}})" }, "dynamicPrompt": { "type": "string", "description": 'Prompt to generate the HTML dynamically when sourceType is "dynamic"' }, "dynamicSourceModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model override for dynamic HTML generation. Leave undefined to use the default model" }, "transitionControl": { "enum": ["default", "native"], "type": "string", "description": "Controls how the step transitions after displaying in foreground mode" }, "shareControl": { "enum": ["default", "hidden"], "type": "string", "description": "Controls visibility of the share button on displayed assets" }, "shareImageUrl": { "type": "string", "description": "URL of a custom Open Graph share image" }, "skipAssetCreation": { "type": "boolean", "description": "If true, the asset will not appear in the user's asset history" } }, "required": ["source", "sourceType", "outputFormat", "pageSize", "testData"] },
+        outputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "CDN URL of the generated asset (PDF, PNG, HTML, or MP4 depending on outputFormat)" } }, "required": ["url"] }
+      },
+      "generateChart": {
+        stepType: "generateChart",
+        description: "Create a chart image using QuickChart (Chart.js) and return the URL.",
+        usageNotes: "- The data field must be a Chart.js-compatible JSON object serialized as a string.\n- Supported chart types: bar, line, pie.",
+        inputSchema: { "type": "object", "properties": { "chart": { "type": "object", "properties": { "chartType": { "enum": ["bar", "line", "pie"], "type": "string", "description": "The type of chart to generate" }, "data": { "type": "string", "description": "Chart.js-compatible JSON data serialized as a string" }, "options": { "type": "object", "properties": { "width": { "type": "string", "description": 'Image width in pixels (e.g. "500")' }, "height": { "type": "string", "description": 'Image height in pixels (e.g. "300")' } }, "required": ["width", "height"], "description": "Image rendering options" } }, "required": ["chartType", "data", "options"], "description": "Chart configuration including type, data, and rendering options" } }, "required": ["chart"] },
+        outputSchema: { "type": "object", "properties": { "chartUrl": { "type": "string", "description": "URL of the generated chart image" } }, "required": ["chartUrl"] }
+      },
+      "generateImage": {
+        stepType: "generateImage",
+        description: "Generate an image from a text prompt using an AI model.",
+        usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- Images are automatically hosted on a CDN.\n- In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1, multiple images are generated in parallel.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
+        inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the image to generate" }, "skipAssetCreation": { "type": "boolean", "description": "If true, the image will not appear in the user's asset history" }, "imageModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Image generation model identifier" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default image model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple image variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated image" } }, "required": ["prompt"] },
+        outputSchema: { "type": "object", "properties": { "imageUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["imageUrl"] }
+      },
+      "generateLipsync": {
+        stepType: "generateLipsync",
+        description: "Generate a lip sync video from provided audio and image.",
+        usageNotes: "- In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.",
+        inputSchema: { "type": "object", "properties": { "skipAssetCreation": { "type": "boolean", "description": "If true, the generated video will not appear in the user's asset history" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video" }, "lipsyncModelOverride": { "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default lipsync model if not specified" } } },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "generateMusic": {
+        stepType: "generateMusic",
+        description: "Generate an audio file from provided instructions (text) using a music model.",
+        usageNotes: "- The text field contains the instructions (prompt) for the music generation.\n- In foreground mode, the audio is displayed to the user. In background mode, the URL is saved to a variable.",
+        inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The instructions (prompt) for the music generation" }, "skipAssetCreation": { "type": "boolean", "description": "If true, the generated audio will not appear in the user's asset history" }, "musicModelOverride": { "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default music model if not specified" } }, "required": ["text"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "generatePdf": {
+        stepType: "generatePdf",
+        description: "Generate an HTML asset and export it as a webpage, PDF, or image",
+        usageNotes: '- 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.\n- The template for the HTML page is generated by a separate process, and it can only use variables that have already been defined in the workflow at the time of its execution. It has full access to handlebars to render the HTML template, including a handlebars helper to render a markdown variable string as HTML (which can be useful for creating templates that render long strings). The template can also create its own simple JavaScript to do things like format dates and strings.\n- 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.\n- 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\n- Can either display output directly to user (foreground mode) or save the URL of the asset to a variable (background mode)',
+        inputSchema: { "type": "object", "properties": { "source": { "type": "string", "description": "The HTML or Markdown source template for the asset" }, "sourceType": { "enum": ["html", "markdown", "spa", "raw", "dynamic", "customInterface"], "type": "string", "description": "Source type: html, markdown (auto-formatted), spa (single page app), raw (pre-generated HTML in a variable), dynamic (AI-generated from prompt), or customInterface" }, "outputFormat": { "enum": ["pdf", "png", "html", "mp4", "openGraph"], "type": "string", "description": "The output format for the generated asset" }, "pageSize": { "enum": ["full", "letter", "A4", "custom"], "type": "string", "description": "Page size for PDF, PNG, or MP4 output" }, "testData": { "type": "object", "description": "Test data used for previewing the template with sample variable values" }, "options": { "type": "object", "properties": { "pageWidthPx": { "type": "number", "description": "Custom page width in pixels (for custom pageSize)" }, "pageHeightPx": { "type": "number", "description": "Custom page height in pixels (for custom pageSize)" }, "pageOrientation": { "enum": ["portrait", "landscape"], "type": "string", "description": "Page orientation for the rendered output" }, "rehostMedia": { "type": "boolean", "description": "Whether to re-host third-party images on the MindStudio CDN" }, "videoDurationSeconds": { "type": "number", "description": "Duration in seconds for MP4 video output" } }, "description": "Additional rendering options" }, "spaSource": { "type": "object", "properties": { "source": { "type": "string", "description": "Source code of the SPA (legacy, use files instead)" }, "lastCompiledSource": { "type": "string", "description": "Last compiled source (cached)" }, "files": { "type": "object", "description": "Multi-file SPA source" }, "paths": { "type": "array", "items": { "type": "string" }, "description": "Available route paths in the SPA" }, "root": { "type": "string", "description": "Root URL of the SPA bundle" }, "zipUrl": { "type": "string", "description": "URL of the zipped SPA bundle" } }, "required": ["paths", "root", "zipUrl"], "description": "Single page app source configuration (advanced)" }, "rawSource": { "type": "string", "description": "Raw HTML source stored in a variable, using handlebars syntax (e.g. {{myHtmlVariable}})" }, "dynamicPrompt": { "type": "string", "description": 'Prompt to generate the HTML dynamically when sourceType is "dynamic"' }, "dynamicSourceModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model override for dynamic HTML generation. Leave undefined to use the default model" }, "transitionControl": { "enum": ["default", "native"], "type": "string", "description": "Controls how the step transitions after displaying in foreground mode" }, "shareControl": { "enum": ["default", "hidden"], "type": "string", "description": "Controls visibility of the share button on displayed assets" }, "shareImageUrl": { "type": "string", "description": "URL of a custom Open Graph share image" }, "skipAssetCreation": { "type": "boolean", "description": "If true, the asset will not appear in the user's asset history" } }, "required": ["source", "sourceType", "outputFormat", "pageSize", "testData"] },
+        outputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "CDN URL of the generated asset (PDF, PNG, HTML, or MP4 depending on outputFormat)" } }, "required": ["url"] }
+      },
+      "generateStaticVideoFromImage": {
+        stepType: "generateStaticVideoFromImage",
+        description: "Convert a static image to an MP4",
+        usageNotes: "- Can use to create slides/intertitles/slates for video composition",
+        inputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "URL of the source image to convert to video" }, "duration": { "type": "string", "description": "Duration of the output video in seconds" } }, "required": ["imageUrl", "duration"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the generated static video" } }, "required": ["videoUrl"] }
+      },
+      "generateText": {
+        stepType: "userMessage",
+        description: "Send a message to an AI model and return the response, or echo a system message.",
+        usageNotes: `- Source "user" sends the message to an LLM and returns the model's response.
+- Source "system" echoes the message content directly (no AI call).
+- Mode "background" saves the result to a variable. Mode "foreground" streams it to the user (not available in direct execution).
+- Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.`,
+        inputSchema: { "type": "object", "properties": { "message": { "type": "string", "description": "The message to send (prompt for AI, or text for system echo)" }, "source": { "enum": ["user", "system"], "type": "string", "description": 'Message source: "user" sends to AI model, "system" echoes message content directly. Defaults to "user"' }, "modelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model configuration override. Optional; uses the workflow's default model if not specified" }, "structuredOutputType": { "enum": ["text", "json", "csv"], "type": "string", "description": "Output format constraint for structured responses" }, "structuredOutputExample": { "type": "string", "description": "Sample showing the desired output shape (for JSON/CSV formats). A TypeScript interface is also useful here for more complex types." }, "chatHistoryMode": { "enum": ["include", "exclude"], "type": "string", "description": "Whether to include or exclude prior chat history in the AI context" } }, "required": ["message"], "description": "Configuration for the user message step" },
+        outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "The AI model's response or echoed system message content" } }, "required": ["content"] }
+      },
+      "generateVideo": {
+        stepType: "generateVideo",
+        description: "Generate a video from a text prompt using an AI model.",
+        usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- Videos are automatically hosted on a CDN.\n- In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1, multiple videos are generated in parallel.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
+        inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the video to generate" }, "skipAssetCreation": { "type": "boolean", "description": "If true, the video will not appear in the user's asset history" }, "videoModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Video generation model identifier" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default video model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple video variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video" } }, "required": ["prompt"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["videoUrl"] }
+      },
+      "getGmailDraft": {
+        stepType: "getGmailDraft",
+        description: "Retrieve a specific draft from Gmail by draft ID.",
+        usageNotes: "- Requires a Google OAuth connection with Gmail readonly scope.\n- Returns the draft content including subject, recipients, sender, and body.",
+        inputSchema: { "type": "object", "properties": { "draftId": { "type": "string", "description": "Gmail draft ID to retrieve" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["draftId"] },
+        outputSchema: { "type": "object", "properties": { "draftId": { "type": "string", "description": "Gmail draft ID" }, "messageId": { "type": "string", "description": "Gmail message ID" }, "subject": { "type": "string", "description": "Email subject" }, "to": { "type": "string", "description": "Recipient email" }, "from": { "type": "string", "description": "Sender email" }, "body": { "type": "string", "description": "Draft body content" } }, "required": ["draftId", "messageId", "subject", "to", "from", "body"] }
+      },
+      "getGmailEmail": {
+        stepType: "getGmailEmail",
+        description: "Retrieve a specific email from Gmail by message ID.",
+        usageNotes: "- Requires a Google OAuth connection with Gmail readonly scope.\n- Returns the email subject, sender, recipient, date, body (plain text preferred, falls back to HTML), and labels.",
+        inputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID to retrieve" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["messageId"] },
+        outputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID" }, "subject": { "type": "string", "description": "Email subject" }, "from": { "type": "string", "description": "Sender email" }, "to": { "type": "string", "description": "Recipient email" }, "date": { "type": "string", "description": "Email date" }, "body": { "type": "string", "description": "Email body content" }, "labels": { "type": "string", "description": "Comma-separated label IDs" } }, "required": ["messageId", "subject", "from", "to", "date", "body", "labels"] }
+      },
+      "getGoogleCalendarEvent": {
+        stepType: "getGoogleCalendarEvent",
+        description: "Retrieve a specific event from a Google Calendar by event ID.",
+        usageNotes: "- Requires a Google OAuth connection with Calendar events scope.\n- The variable receives JSON or XML-like text depending on exportType. The direct execution output always returns the structured event.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "eventId": { "type": "string", "description": "Google Calendar event ID to retrieve" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' }, "calendarId": { "type": "string", "description": 'Calendar ID (defaults to "primary" if omitted)' } }, "required": ["eventId", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "event": { "type": "object", "properties": { "id": { "type": "string", "description": "Google Calendar event ID" }, "status": { "type": "string", "description": 'Event status (e.g. "confirmed", "tentative", "cancelled")' }, "htmlLink": { "type": "string", "description": "URL to view the event in Google Calendar" }, "created": { "type": "string", "description": "Timestamp when the event was created" }, "updated": { "type": "string", "description": "Timestamp when the event was last updated" }, "summary": { "type": "string", "description": "Event title" }, "description": { "type": "string", "description": "Event description" }, "location": { "type": "string", "description": "Event location" }, "organizer": { "anyOf": [{ "type": "object", "properties": { "displayName": { "type": "string" }, "email": { "type": "string" } } }, { "type": "null" }] }, "start": { "anyOf": [{ "type": "object", "properties": { "dateTime": { "type": "string" }, "timeZone": { "type": "string" } } }, { "type": "null" }] }, "end": { "anyOf": [{ "type": "object", "properties": { "dateTime": { "type": "string" }, "timeZone": { "type": "string" } } }, { "type": "null" }] }, "attendees": { "anyOf": [{ "type": "array", "items": { "type": "object", "properties": { "displayName": { "type": "string" }, "email": { "type": "string" }, "responseStatus": { "type": "string" } } } }, { "type": "null" }] } }, "description": "The retrieved calendar event" } }, "required": ["event"] }
+      },
+      "getGoogleDriveFile": {
+        stepType: "getGoogleDriveFile",
+        description: "Download a file from Google Drive and rehost it on the CDN. Returns a public CDN URL.",
+        usageNotes: "- Requires a Google OAuth connection with Drive scope.\n- Google-native files (Docs, Sheets, Slides) cannot be downloaded \u2014 use dedicated steps instead.\n- Maximum file size: 200MB.\n- The file is downloaded and re-uploaded to the CDN; the returned URL is publicly accessible.",
+        inputSchema: { "type": "object", "properties": { "fileId": { "type": "string", "description": "Google Drive file ID" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["fileId"] },
+        outputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "CDN URL of the downloaded file" }, "name": { "type": "string", "description": "Original file name" }, "mimeType": { "type": "string", "description": "File MIME type" }, "size": { "type": "number", "description": "File size in bytes" } }, "required": ["url", "name", "mimeType", "size"] }
+      },
+      "getGoogleSheetInfo": {
+        stepType: "getGoogleSheetInfo",
+        description: "Get metadata about a Google Spreadsheet including sheet names, row counts, and column counts.",
+        usageNotes: "- Requires a Google OAuth connection with Drive scope.\n- Returns the spreadsheet title and a list of all sheets with their dimensions.",
+        inputSchema: { "type": "object", "properties": { "documentId": { "type": "string", "description": "Google Spreadsheet ID or URL" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["documentId"] },
+        outputSchema: { "type": "object", "properties": { "title": { "type": "string", "description": "Spreadsheet title" }, "sheets": { "type": "array", "items": { "type": "object", "properties": { "sheetId": { "type": "number" }, "title": { "type": "string" }, "rowCount": { "type": "number" }, "columnCount": { "type": "number" } }, "required": ["sheetId", "title", "rowCount", "columnCount"] }, "description": "List of sheets with their properties" } }, "required": ["title", "sheets"] }
+      },
+      "getMediaMetadata": {
+        stepType: "getMediaMetadata",
+        description: "Get info about a media file",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "mediaUrl": { "type": "string", "description": "URL of the audio or video file to analyze" } }, "required": ["mediaUrl"] },
+        outputSchema: { "type": "object", "properties": { "metadata": { "type": "string", "description": "JSON string containing the media file metadata" } }, "required": ["metadata"] }
+      },
+      "httpRequest": {
+        stepType: "httpRequest",
+        description: "Make an HTTP request to an external endpoint and return the response.",
+        usageNotes: "- Supports GET, POST, PATCH, DELETE, and PUT methods.\n- Body can be raw JSON/text, URL-encoded form data, or multipart form data.",
+        inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "The request URL" }, "method": { "type": "string", "description": "HTTP method (GET, POST, PATCH, DELETE, or PUT)" }, "headers": { "type": "object", "description": "Custom request headers as key-value pairs" }, "queryParams": { "type": "object", "description": "Query string parameters as key-value pairs" }, "body": { "type": "string", "description": "Raw request body (used for JSON or custom content types)" }, "bodyItems": { "type": "object", "description": "Key-value body items (used for form data or URL-encoded content types)" }, "contentType": { "enum": ["none", "application/json", "application/x-www-form-urlencoded", "multipart/form-data", "custom"], "type": "string", "description": "The content type for the request body" }, "customContentType": { "type": "string", "description": 'Custom Content-Type header value (used when contentType is "custom")' }, "testData": { "type": "object", "description": "Test data for debug/preview mode" } }, "required": ["url", "method", "headers", "queryParams", "body", "bodyItems", "contentType", "customContentType"], "description": "HTTP request configuration" },
+        outputSchema: { "type": "object", "properties": { "ok": { "type": "boolean", "description": "Whether the HTTP response status code is in the 2xx range" }, "status": { "type": "number", "description": "HTTP response status code" }, "statusText": { "type": "string", "description": "HTTP response status text" }, "response": { "type": "string", "description": "Response body as a string" } }, "required": ["ok", "status", "statusText", "response"] }
+      },
+      "hubspotCreateCompany": {
+        stepType: "hubspotCreateCompany",
+        description: "Create a new company or update an existing one in HubSpot. Matches by domain.",
+        usageNotes: "- Requires a HubSpot OAuth connection (connectionId).\n- If a company with the given domain already exists, it is updated. Otherwise, a new one is created.\n- Property values are type-checked against enabledProperties before being sent to HubSpot.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "HubSpot OAuth connection ID" }, "company": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, used for matching existing companies" }, "name": { "type": "string", "description": "Company name" } }, "required": ["domain", "name"], "description": "Company data including domain, name, and additional properties" }, "enabledProperties": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "Display label for the HubSpot property" }, "value": { "type": "string", "description": "HubSpot property internal name" }, "type": { "enum": ["string", "number", "bool"], "type": "string", "description": "Data type of the property value" } }, "required": ["label", "value", "type"] }, "description": "HubSpot properties enabled for this step, used for type validation" } }, "required": ["company", "enabledProperties"] },
+        outputSchema: { "type": "object", "properties": { "companyId": { "type": "string", "description": "HubSpot company ID of the created or updated company" } }, "required": ["companyId"] }
+      },
+      "hubspotCreateContact": {
+        stepType: "hubspotCreateContact",
+        description: "Create a new contact or update an existing one in HubSpot. Matches by email address.",
+        usageNotes: "- Requires a HubSpot OAuth connection (connectionId).\n- If a contact with the given email already exists, it is updated. Otherwise, a new one is created.\n- If companyDomain is provided, the contact is associated with that company (creating the company if needed).\n- Property values are type-checked against enabledProperties before being sent to HubSpot.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "HubSpot OAuth connection ID" }, "contact": { "type": "object", "properties": { "email": { "type": "string", "description": "Contact email address, used for matching existing contacts" }, "firstname": { "type": "string", "description": "Contact first name" }, "lastname": { "type": "string", "description": "Contact last name" } }, "required": ["email", "firstname", "lastname"], "description": "Contact data including email, first name, last name, and additional properties" }, "enabledProperties": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "Display label for the HubSpot property" }, "value": { "type": "string", "description": "HubSpot property internal name" }, "type": { "enum": ["string", "number", "bool"], "type": "string", "description": "Data type of the property value" } }, "required": ["label", "value", "type"] }, "description": "HubSpot properties enabled for this step, used for type validation" }, "companyDomain": { "type": "string", "description": "Company domain to associate the contact with. Creates the company if it does not exist" } }, "required": ["contact", "enabledProperties", "companyDomain"] },
+        outputSchema: { "type": "object", "properties": { "contactId": { "type": "string", "description": "HubSpot contact ID of the created or updated contact" } }, "required": ["contactId"] }
+      },
+      "hubspotGetCompany": {
+        stepType: "hubspotGetCompany",
+        description: "Look up a HubSpot company by domain name or company ID.",
+        usageNotes: "- Requires a HubSpot OAuth connection (connectionId).\n- Returns null if the company is not found.\n- When searching by domain, performs a search query then fetches the full company record.\n- Use additionalProperties to request specific HubSpot properties beyond the defaults.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "HubSpot OAuth connection ID" }, "searchBy": { "enum": ["domain", "id"], "type": "string", "description": "How to look up the company: by domain name or HubSpot company ID" }, "companyDomain": { "type": "string", "description": "Domain to search by (used when searchBy is 'domain')" }, "companyId": { "type": "string", "description": "HubSpot company ID (used when searchBy is 'id')" }, "additionalProperties": { "type": "array", "items": { "type": "string" }, "description": "Extra HubSpot property names to include in the response beyond the defaults" } }, "required": ["searchBy", "companyDomain", "companyId", "additionalProperties"] },
+        outputSchema: { "type": "object", "properties": { "company": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string" }, "properties": { "type": "object" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "archived": { "type": "boolean" } }, "required": ["id", "properties", "createdAt", "updatedAt", "archived"] }, { "type": "null" }] } }, "required": ["company"] }
+      },
+      "hubspotGetContact": {
+        stepType: "hubspotGetContact",
+        description: "Look up a HubSpot contact by email address or contact ID.",
+        usageNotes: "- Requires a HubSpot OAuth connection (connectionId).\n- Returns null if the contact is not found.\n- Use additionalProperties to request specific HubSpot properties beyond the defaults.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "HubSpot OAuth connection ID" }, "searchBy": { "enum": ["email", "id"], "type": "string", "description": "How to look up the contact: by email address or HubSpot contact ID" }, "contactEmail": { "type": "string", "description": "Email address to search by (used when searchBy is 'email')" }, "contactId": { "type": "string", "description": "HubSpot contact ID (used when searchBy is 'id')" }, "additionalProperties": { "type": "array", "items": { "type": "string" }, "description": "Extra HubSpot property names to include in the response beyond the defaults" } }, "required": ["searchBy", "contactEmail", "contactId", "additionalProperties"] },
+        outputSchema: { "type": "object", "properties": { "contact": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string" }, "properties": { "type": "object" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "archived": { "type": "boolean" } }, "required": ["id", "properties", "createdAt", "updatedAt", "archived"] }, { "type": "null" }] } }, "required": ["contact"] }
+      },
+      "hunterApiCompanyEnrichment": {
+        stepType: "hunterApiCompanyEnrichment",
+        description: "Look up company information by domain using Hunter.io.",
+        usageNotes: "- Returns company name, description, location, industry, size, technologies, and more.\n- If the domain input is a full URL, the hostname is automatically extracted.\n- Returns null if the company is not found.",
+        inputSchema: { "type": "object", "properties": { "domain": { "type": "string", "description": 'Domain or URL to look up (e.g. "example.com")' } }, "required": ["domain"] },
+        outputSchema: { "type": "object", "properties": { "data": { "anyOf": [{ "type": "object", "properties": { "name": { "type": "string" }, "domain": { "type": "string" }, "description": { "type": "string" }, "country": { "type": "string" }, "state": { "type": "string" }, "city": { "type": "string" }, "industry": { "type": "string" }, "employees_range": { "type": "string" }, "logo_url": { "type": "string" }, "technologies": { "type": "array", "items": { "type": "string" } } }, "required": ["name", "domain", "description", "country", "state", "city", "industry", "employees_range", "logo_url", "technologies"] }, { "type": "null" }] } }, "required": ["data"] }
+      },
+      "hunterApiDomainSearch": {
+        stepType: "hunterApiDomainSearch",
+        description: "Search for email addresses associated with a domain using Hunter.io.",
+        usageNotes: "- If the domain input is a full URL, the hostname is automatically extracted.\n- Returns a list of email addresses found for the domain along with organization info.",
+        inputSchema: { "type": "object", "properties": { "domain": { "type": "string", "description": 'Domain or URL to search for email addresses (e.g. "example.com")' } }, "required": ["domain"] },
+        outputSchema: { "type": "object", "properties": { "data": { "type": "object", "properties": { "domain": { "type": "string", "description": "The searched domain" }, "disposable": { "type": "boolean", "description": "Whether the domain uses disposable email addresses" }, "webmail": { "type": "boolean", "description": "Whether the domain is a webmail provider" }, "accept_all": { "type": "boolean", "description": "Whether the domain accepts all email addresses" }, "pattern": { "type": "string", "description": 'Common email pattern for the domain (e.g. "{first}.{last}")' }, "organization": { "type": "string", "description": "Organization name associated with the domain" }, "country": { "type": "string", "description": "Country of the organization" }, "state": { "type": "string", "description": "State or region of the organization" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "value": { "type": "string", "description": "Email address" }, "type": { "type": "string", "description": 'Email type (e.g. "personal", "generic")' }, "confidence": { "type": "number", "description": "Confidence score (0-100)" }, "first_name": { "type": "string", "description": "Contact first name" }, "last_name": { "type": "string", "description": "Contact last name" }, "position": { "type": "string", "description": "Job title or position" }, "seniority": { "type": "string", "description": "Seniority level" }, "department": { "type": "string", "description": "Department within the organization" }, "linkedin": { "type": "string", "description": "LinkedIn profile URL" }, "twitter": { "type": "string", "description": "Twitter handle" }, "phone_number": { "type": "string", "description": "Phone number" } }, "required": ["value", "type", "confidence", "first_name", "last_name", "position", "seniority", "department", "linkedin", "twitter", "phone_number"] }, "description": "List of email addresses found for the domain" }, "linked_domains": { "type": "array", "items": { "type": "string" }, "description": "Other domains linked to this organization" } }, "required": ["domain", "disposable", "webmail", "accept_all", "pattern", "organization", "country", "state", "emails", "linked_domains"], "description": "Domain search results including emails and organization info" } }, "required": ["data"] }
+      },
+      "hunterApiEmailFinder": {
+        stepType: "hunterApiEmailFinder",
+        description: "Find an email address for a specific person at a domain using Hunter.io.",
+        usageNotes: "- Requires a first name, last name, and domain.\n- If the domain input is a full URL, the hostname is automatically extracted.\n- Returns the most likely email address with a confidence score.",
+        inputSchema: { "type": "object", "properties": { "domain": { "type": "string", "description": 'Domain to search (e.g. "example.com"). Full URLs are also accepted' }, "firstName": { "type": "string", "description": "Person's first name" }, "lastName": { "type": "string", "description": "Person's last name" } }, "required": ["domain", "firstName", "lastName"] },
+        outputSchema: { "type": "object", "properties": { "data": { "type": "object", "properties": { "first_name": { "type": "string", "description": "Person's first name" }, "last_name": { "type": "string", "description": "Person's last name" }, "email": { "type": "string", "description": "The found email address" }, "score": { "type": "number", "description": "Confidence score (0-100)" }, "domain": { "type": "string", "description": "Domain searched" }, "accept_all": { "type": "boolean", "description": "Whether the domain accepts all email addresses" }, "position": { "type": "string", "description": "Job title or position" }, "twitter": { "type": "string", "description": "Twitter handle" }, "linkedin_url": { "type": "string", "description": "LinkedIn profile URL" }, "phone_number": { "type": "string", "description": "Phone number" }, "company": { "type": "string", "description": "Company name" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain where the email was found" }, "uri": { "type": "string", "description": "URI of the page where the email was found" }, "extracted_on": { "type": "string", "description": "Date when the email was extracted" } }, "required": ["domain", "uri", "extracted_on"] }, "description": "Sources where the email was found" } }, "required": ["first_name", "last_name", "email", "score", "domain", "accept_all", "position", "twitter", "linkedin_url", "phone_number", "company", "sources"], "description": "Email finder results including the found email and confidence score" } }, "required": ["data"] }
+      },
+      "hunterApiEmailVerification": {
+        stepType: "hunterApiEmailVerification",
+        description: "Verify whether an email address is valid and deliverable using Hunter.io.",
+        usageNotes: '- Checks email format, MX records, SMTP server, and mailbox deliverability.\n- Returns a status ("valid", "invalid", "accept_all", "webmail", "disposable", "unknown") and a score.',
+        inputSchema: { "type": "object", "properties": { "email": { "type": "string", "description": "Email address to verify" } }, "required": ["email"] },
+        outputSchema: { "type": "object", "properties": { "data": { "type": "object", "properties": { "status": { "type": "string", "description": 'Verification status (e.g. "valid", "invalid", "accept_all", "webmail", "disposable", "unknown")' }, "result": { "type": "string", "description": "Deliverability result" }, "score": { "type": "number", "description": "Confidence score (0-100)" }, "email": { "type": "string", "description": "The verified email address" }, "regexp": { "type": "boolean", "description": "Whether the email matches a valid format" }, "gibberish": { "type": "boolean", "description": "Whether the email appears to be gibberish" }, "disposable": { "type": "boolean", "description": "Whether the email uses a disposable email service" }, "webmail": { "type": "boolean", "description": "Whether the email is from a webmail provider" }, "mx_records": { "type": "boolean", "description": "Whether MX records exist for the domain" }, "smtp_server": { "type": "boolean", "description": "Whether the SMTP server is reachable" }, "smtp_check": { "type": "boolean", "description": "Whether the SMTP mailbox check passed" }, "accept_all": { "type": "boolean", "description": "Whether the domain accepts all email addresses" }, "block": { "type": "boolean", "description": "Whether the email is blocked" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain where the email was found" }, "uri": { "type": "string", "description": "URI of the page where the email was found" }, "extracted_on": { "type": "string", "description": "Date when the email was extracted" } }, "required": ["domain", "uri", "extracted_on"] }, "description": "Sources where the email was found" } }, "required": ["status", "result", "score", "email", "regexp", "gibberish", "disposable", "webmail", "mx_records", "smtp_server", "smtp_check", "accept_all", "block", "sources"], "description": "Email verification results including status, deliverability, and confidence score" } }, "required": ["data"] }
+      },
+      "hunterApiPersonEnrichment": {
+        stepType: "hunterApiPersonEnrichment",
+        description: "Look up professional information about a person by their email address using Hunter.io.",
+        usageNotes: "- Returns name, job title, social profiles, and company information.\n- If the person is not found, returns an object with an error message instead of throwing.",
+        inputSchema: { "type": "object", "properties": { "email": { "type": "string", "description": "Email address to look up" } }, "required": ["email"] },
+        outputSchema: { "type": "object", "properties": { "data": { "anyOf": [{ "type": "object", "properties": { "first_name": { "type": "string" }, "last_name": { "type": "string" }, "email": { "type": "string" }, "position": { "type": "string" }, "seniority": { "type": "string" }, "department": { "type": "string" }, "linkedin_url": { "type": "string" }, "twitter": { "type": "string" }, "phone_number": { "type": "string" }, "company": { "anyOf": [{ "type": "object", "properties": { "name": { "type": "string" }, "domain": { "type": "string" }, "industry": { "type": "string" } }, "required": ["name", "domain", "industry"] }, { "type": "null" }] } }, "required": ["first_name", "last_name", "email", "position", "seniority", "department", "linkedin_url", "twitter", "phone_number", "company"] }, { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] }] } }, "required": ["data"] }
+      },
+      "imageFaceSwap": {
+        stepType: "imageFaceSwap",
+        description: "Replace a face in an image with a face from another image using AI.",
+        usageNotes: "- Requires both a target image and a face source image.\n- Output is re-hosted on the CDN as a PNG.",
+        inputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "URL of the target image containing the face to replace" }, "faceImageUrl": { "type": "string", "description": "URL of the image containing the replacement face" }, "engine": { "type": "string", "description": "Face swap engine to use" } }, "required": ["imageUrl", "faceImageUrl", "engine"] },
+        outputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "CDN URL of the face-swapped image (PNG)" } }, "required": ["imageUrl"] }
+      },
+      "imageRemoveWatermark": {
+        stepType: "imageRemoveWatermark",
+        description: "Remove watermarks from an image using AI.",
+        usageNotes: "- Output is re-hosted on the CDN as a PNG.",
+        inputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "URL of the image to remove the watermark from" }, "engine": { "type": "string", "description": "Watermark removal engine to use" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history" } }, "required": ["imageUrl", "engine"] },
+        outputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "CDN URL of the processed image with watermark removed (PNG)" } }, "required": ["imageUrl"] }
+      },
+      "insertVideoClips": {
+        stepType: "insertVideoClips",
+        description: "Insert b-roll clips into a base video at a timecode, optionally with an xfade transition.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "baseVideoUrl": { "type": "string", "description": "URL of the base video to insert clips into" }, "overlayVideos": { "type": "array", "items": { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the overlay video clip" }, "startTimeSec": { "type": "number", "description": "Timecode in seconds at which to insert this clip" } }, "required": ["videoUrl", "startTimeSec"] }, "description": "Array of overlay clips to insert at specified timecodes" }, "transition": { "type": "string", "description": "Optional xfade transition effect name between clips" }, "transitionDuration": { "type": "number", "description": "Duration of the transition in seconds" }, "useOverlayAudio": { "type": "boolean", "description": "When true, uses audio from the overlay clips instead of the base video audio during inserts" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["baseVideoUrl", "overlayVideos"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the video with clips inserted" } }, "required": ["videoUrl"] }
+      },
+      "listDataSources": {
+        stepType: "listDataSources",
+        description: "List all data sources for the current app.",
+        usageNotes: "- Returns metadata for every data source associated with the current app version.\n- Each entry includes the data source ID, name, description, status, and document list.",
+        inputSchema: { "type": "object" },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "listGmailDrafts": {
+        stepType: "listGmailDrafts",
+        description: "List drafts in the connected Gmail account.",
+        usageNotes: "- Requires a Google OAuth connection with Gmail readonly scope.\n- Returns up to 50 drafts (default 10).\n- The variable receives text or JSON depending on exportType.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "limit": { "type": "string", "description": "Max drafts to return (default: 10, max: 50)" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' } }, "required": ["exportType"] },
+        outputSchema: { "type": "object", "properties": { "drafts": { "type": "array", "items": { "type": "object", "properties": { "draftId": { "type": "string", "description": "Gmail draft ID" }, "messageId": { "type": "string", "description": "Gmail message ID" }, "subject": { "type": "string", "description": "Email subject" }, "to": { "type": "string", "description": "Recipient email" }, "snippet": { "type": "string", "description": "Short preview text" } }, "required": ["draftId", "messageId", "subject", "to", "snippet"] }, "description": "List of draft summaries" } }, "required": ["drafts"] }
+      },
+      "listGoogleCalendarEvents": {
+        stepType: "listGoogleCalendarEvents",
+        description: "List upcoming events from a Google Calendar, ordered by start time.",
+        usageNotes: "- Requires a Google OAuth connection with Calendar events scope.\n- Only returns future events (timeMin = now).\n- The variable receives JSON or XML-like text depending on exportType. The direct execution output always returns structured events.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "limit": { "type": "number", "description": "Maximum number of events to return (default: 10)" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' }, "calendarId": { "type": "string", "description": 'Calendar ID (defaults to "primary" if omitted)' } }, "required": ["limit", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Google Calendar event ID" }, "status": { "type": "string", "description": 'Event status (e.g. "confirmed", "tentative", "cancelled")' }, "htmlLink": { "type": "string", "description": "URL to view the event in Google Calendar" }, "created": { "type": "string", "description": "Timestamp when the event was created" }, "updated": { "type": "string", "description": "Timestamp when the event was last updated" }, "summary": { "type": "string", "description": "Event title" }, "description": { "type": "string", "description": "Event description" }, "location": { "type": "string", "description": "Event location" }, "organizer": { "anyOf": [{ "type": "object", "properties": { "displayName": { "type": "string" }, "email": { "type": "string" } } }, { "type": "null" }] }, "start": { "anyOf": [{ "type": "object", "properties": { "dateTime": { "type": "string" }, "timeZone": { "type": "string" } } }, { "type": "null" }] }, "end": { "anyOf": [{ "type": "object", "properties": { "dateTime": { "type": "string" }, "timeZone": { "type": "string" } } }, { "type": "null" }] }, "attendees": { "anyOf": [{ "type": "array", "items": { "type": "object", "properties": { "displayName": { "type": "string" }, "email": { "type": "string" }, "responseStatus": { "type": "string" } } } }, { "type": "null" }] } } }, "description": "List of upcoming calendar events ordered by start time" } }, "required": ["events"] }
+      },
+      "listGoogleDriveFiles": {
+        stepType: "listGoogleDriveFiles",
+        description: "List files in a Google Drive folder.",
+        usageNotes: "- Requires a Google OAuth connection with Drive scope.\n- If folderId is omitted, lists files in the root folder.\n- Returns file metadata including name, type, size, and links.",
+        inputSchema: { "type": "object", "properties": { "folderId": { "type": "string", "description": "Google Drive folder ID (defaults to root)" }, "limit": { "type": "number", "description": "Max files to return (default: 20)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' } }, "required": ["exportType"] },
+        outputSchema: { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "mimeType": { "type": "string" }, "size": { "type": "string" }, "webViewLink": { "type": "string" }, "createdTime": { "type": "string" }, "modifiedTime": { "type": "string" } }, "required": ["id", "name", "mimeType", "size", "webViewLink", "createdTime", "modifiedTime"] }, "description": "List of files in the folder" } }, "required": ["files"] }
+      },
+      "logic": {
+        stepType: "logic",
+        description: "Use an AI model to evaluate which condition from a list is most true, given a context prompt.",
+        usageNotes: '- This is "fuzzy" logic evaluated by an AI model, not computational logic. The model picks the most accurate statement.\n- All possible cases must be specified \u2014 there is no default/fallback case.\n- Requires at least two cases.\n- In workflow mode, transitions to the destinationStepId of the winning case. In direct execution, returns the winning case ID and condition.',
+        inputSchema: { "type": "object", "properties": { "context": { "type": "string", "description": "Prompt text providing context for the AI evaluation" }, "cases": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string", "description": "Unique case identifier" }, "condition": { "type": "string", "description": 'The statement to evaluate (e.g., "User selected a dog")' }, "destinationStepId": { "type": "string", "description": "Step to transition to if this case wins (workflow mode only)" } }, "required": ["id", "condition"] }, { "type": "string" }] }, "description": "List of conditions to evaluate (objects for managed UIs, strings for code)" } }, "required": ["context", "cases"], "description": "Configuration for the logic evaluation step" },
+        outputSchema: { "type": "object", "properties": { "selectedCase": { "type": "number", "description": "The index of the winning case" } }, "required": ["selectedCase"] }
+      },
+      "makeDotComRunScenario": {
+        stepType: "makeDotComRunScenario",
+        description: "Trigger a Make.com (formerly Integromat) scenario via webhook and return the response.",
+        usageNotes: "- The webhook URL must be configured in your Make.com scenario.\n- Input key-value pairs are sent as JSON in the POST body.\n- Response format depends on the Make.com scenario configuration.",
+        inputSchema: { "type": "object", "properties": { "webhookUrl": { "type": "string", "description": "Make.com webhook URL for the scenario" }, "input": { "type": "object", "description": "Key-value pairs to send as the JSON POST body" } }, "required": ["webhookUrl", "input"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "Response from the Make.com scenario (JSON or string depending on scenario configuration)" } }, "required": ["data"] }
+      },
+      "mergeAudio": {
+        stepType: "mergeAudio",
+        description: "Merge one or more clips into a single audio file.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "mp3Urls": { "type": "array", "items": { "type": "string" }, "description": "URLs of the MP3 audio clips to merge in order" }, "fileMetadata": { "type": "object", "description": "FFmpeg MP3 metadata key-value pairs to embed in the output file" }, "albumArtUrl": { "type": "string", "description": "URL of an image to embed as album art in the output file" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["mp3Urls"] },
+        outputSchema: { "type": "object", "properties": { "audioUrl": { "type": "string", "description": "URL of the merged audio file" } }, "required": ["audioUrl"] }
+      },
+      "mergeVideos": {
+        stepType: "mergeVideos",
+        description: "Merge one or more clips into a single video.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrls": { "type": "array", "items": { "type": "string" }, "description": "URLs of the video clips to merge in order" }, "transition": { "type": "string", "description": "Optional xfade transition effect name" }, "transitionDuration": { "type": "number", "description": "Duration of the transition in seconds" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrls"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the merged video" } }, "required": ["videoUrl"] }
+      },
+      "mixAudioIntoVideo": {
+        stepType: "mixAudioIntoVideo",
+        description: "Mix an audio track into a video",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video" }, "audioUrl": { "type": "string", "description": "URL of the audio track to mix into the video" }, "options": { "type": "object", "properties": { "keepVideoAudio": { "type": "boolean", "description": "When true, preserves the original video audio alongside the new track. Defaults to false." }, "audioGainDb": { "type": "number", "description": "Volume adjustment for the new audio track in decibels. Defaults to 0." }, "videoGainDb": { "type": "number", "description": "Volume adjustment for the existing video audio in decibels. Defaults to 0." }, "loopAudio": { "type": "boolean", "description": "When true, loops the audio track to match the video duration. Defaults to false." } }, "description": "Audio mixing options" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "audioUrl", "options"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the video with the mixed audio track" } }, "required": ["videoUrl"] }
+      },
+      "muteVideo": {
+        stepType: "muteVideo",
+        description: "Mute a video file",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to mute" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the muted video" } }, "required": ["videoUrl"] }
+      },
+      "n8nRunNode": {
+        stepType: "n8nRunNode",
+        description: "Trigger an n8n workflow node via webhook and return the response.",
+        usageNotes: "- The webhook URL must be configured in your n8n workflow.\n- Supports GET and POST methods with optional Basic authentication.\n- For GET requests, input values are sent as query parameters. For POST, they are sent as JSON body.",
+        inputSchema: { "type": "object", "properties": { "method": { "type": "string", "description": "HTTP method to use (GET or POST)" }, "authentication": { "enum": ["none", "basic", "string"], "type": "string", "description": "Authentication type for the webhook request" }, "user": { "type": "string", "description": "Username for Basic authentication" }, "password": { "type": "string", "description": "Password for Basic authentication" }, "webhookUrl": { "type": "string", "description": "n8n webhook URL for the workflow node" }, "input": { "type": "object", "description": "Key-value pairs sent as query params (GET) or JSON body (POST)" } }, "required": ["method", "authentication", "user", "password", "webhookUrl", "input"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "Response from the n8n node (JSON or string depending on node configuration)" } }, "required": ["data"] }
+      },
+      "notionCreatePage": {
+        stepType: "notionCreatePage",
+        description: "Create a new page in Notion as a child of an existing page.",
+        usageNotes: "- Requires a Notion OAuth connection (connectionId).\n- Content is provided as markdown and converted to Notion blocks (headings, paragraphs, lists, code, quotes).\n- The page is created as a child of the specified parent page (pageId).",
+        inputSchema: { "type": "object", "properties": { "pageId": { "type": "string", "description": "Parent page ID to create the new page under" }, "content": { "type": "string", "description": "Page content in markdown format" }, "title": { "type": "string", "description": "Page title" }, "connectionId": { "type": "string", "description": "Notion OAuth connection ID" } }, "required": ["pageId", "content", "title"] },
+        outputSchema: { "type": "object", "properties": { "pageId": { "type": "string", "description": "Notion page ID of the created page" }, "pageUrl": { "type": "string", "description": "URL to view the page in Notion" } }, "required": ["pageId", "pageUrl"] }
+      },
+      "notionUpdatePage": {
+        stepType: "notionUpdatePage",
+        description: "Update the content of an existing Notion page.",
+        usageNotes: '- Requires a Notion OAuth connection (connectionId).\n- Content is provided as markdown and converted to Notion blocks.\n- "append" mode adds content to the end of the page. "overwrite" mode deletes all existing blocks first.',
+        inputSchema: { "type": "object", "properties": { "pageId": { "type": "string", "description": "Notion page ID to update" }, "content": { "type": "string", "description": "New content in markdown format" }, "mode": { "enum": ["append", "overwrite"], "type": "string", "description": "How to apply the content: 'append' adds to end, 'overwrite' replaces all existing content" }, "connectionId": { "type": "string", "description": "Notion OAuth connection ID" } }, "required": ["pageId", "content", "mode"] },
+        outputSchema: { "type": "object", "properties": { "pageId": { "type": "string", "description": "Notion page ID of the updated page" }, "pageUrl": { "type": "string", "description": "URL to view the page in Notion" } }, "required": ["pageId", "pageUrl"] }
+      },
+      "peopleSearch": {
+        stepType: "peopleSearch",
+        description: "Search for people matching specific criteria using Apollo.io. Supports natural language queries and advanced filters.",
+        usageNotes: '- Can use a natural language "smartQuery" which is converted to Apollo search parameters by an AI model.\n- Advanced params can override or supplement the smart query results.\n- Optionally enriches returned people and/or their organizations for additional detail.\n- Results are paginated. Use limit and page to control the result window.',
+        inputSchema: { "type": "object", "properties": { "smartQuery": { "type": "string", "description": 'Natural language search query (e.g. "marketing directors at SaaS companies in NYC")' }, "enrichPeople": { "type": "boolean", "description": "Whether to enrich each result with full contact details" }, "enrichOrganizations": { "type": "boolean", "description": "Whether to enrich each result with full company details" }, "limit": { "type": "string", "description": "Maximum number of results to return" }, "page": { "type": "string", "description": "Page number for pagination" }, "params": { "type": "object", "properties": { "personTitles": { "type": "string", "description": "Job titles to search for (comma-separated)" }, "includeSimilarTitles": { "type": "string", "description": "Whether to include similar/related job titles" }, "qKeywords": { "type": "string", "description": "Keywords to search for in person profiles" }, "personLocations": { "type": "string", "description": "Geographic locations of people (comma-separated)" }, "personSeniorities": { "type": "string", "description": "Seniority levels to filter by (comma-separated)" }, "organizationLocations": { "type": "string", "description": "Geographic locations of organizations (comma-separated)" }, "qOrganizationDomainsList": { "type": "string", "description": "Organization domains to filter by (comma-separated)" }, "contactEmailStatus": { "type": "string", "description": "Email verification status filter" }, "organizationNumEmployeesRanges": { "type": "string", "description": 'Employee count ranges as semicolon-separated pairs (e.g. "1,10; 250,500")' }, "revenueRangeMin": { "type": "string", "description": "Minimum annual revenue filter" }, "revenueRangeMax": { "type": "string", "description": "Maximum annual revenue filter" }, "currentlyUsingAllOfTechnologyUids": { "type": "string", "description": "Technology UIDs the organization must use (all required)" }, "currentlyUsingAnyOfTechnologyUids": { "type": "string", "description": "Technology UIDs the organization uses (any match)" }, "currentlyNotUsingAnyOfTechnologyUids": { "type": "string", "description": "Technology UIDs the organization must not use" } }, "required": ["personTitles", "includeSimilarTitles", "qKeywords", "personLocations", "personSeniorities", "organizationLocations", "qOrganizationDomainsList", "contactEmailStatus", "organizationNumEmployeesRanges", "revenueRangeMin", "revenueRangeMax", "currentlyUsingAllOfTechnologyUids", "currentlyUsingAnyOfTechnologyUids", "currentlyNotUsingAnyOfTechnologyUids"], "description": "Advanced search filter parameters" } }, "required": ["smartQuery", "enrichPeople", "enrichOrganizations", "limit", "page", "params"] },
+        outputSchema: { "type": "object", "properties": { "results": { "description": "Apollo search results with matched people and optionally enriched data" } }, "required": ["results"] }
+      },
+      "postToLinkedIn": {
+        stepType: "postToLinkedIn",
+        description: "Create a post on LinkedIn from the connected account.",
+        usageNotes: "- Requires a LinkedIn OAuth connection (connectionId).\n- Supports text posts, image posts, and video posts.\n- Visibility controls who can see the post.",
+        inputSchema: { "type": "object", "properties": { "message": { "type": "string", "description": "The text content of the LinkedIn post" }, "visibility": { "enum": ["PUBLIC", "CONNECTIONS"], "type": "string", "description": 'Who can see the post: "PUBLIC" or "CONNECTIONS"' }, "videoUrl": { "type": "string", "description": "URL of a video to attach to the post" }, "descriptionText": { "type": "string", "description": "Description text for link/media attachments" }, "titleText": { "type": "string", "description": "Title text for link/media attachments" }, "imageUrl": { "type": "string", "description": "URL of an image to attach to the post" }, "connectionId": { "type": "string", "description": "LinkedIn OAuth connection ID" } }, "required": ["message", "visibility"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "postToSlackChannel": {
+        stepType: "postToSlackChannel",
+        description: "Send a message to a Slack channel via a connected bot.",
+        usageNotes: "- The user is responsible for connecting their Slack workspace and selecting the channel\n- Supports both simple text messages and slack blocks messages\n- Text messages can use limited markdown (slack-only fomatting\u2014e.g., headers are just rendered as bold)",
+        inputSchema: { "type": "object", "properties": { "channelId": { "type": "string", "description": "Slack channel ID (leave empty to allow user to select a channel)" }, "messageType": { "enum": ["string", "blocks"], "type": "string", "description": 'Message format: "string" for plain text/markdown, "blocks" for Slack Block Kit JSON' }, "message": { "type": "string", "description": 'Message content (plain text/markdown for "string" type, or JSON for "blocks" type)' }, "connectionId": { "type": "string", "description": "Slack OAuth connection ID (leave empty to allow user to select)" } }, "required": ["channelId", "messageType", "message"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "postToX": {
+        stepType: "postToX",
+        description: "Create a post on X (Twitter) from the connected account.",
+        usageNotes: "- Requires an X OAuth connection (connectionId).\n- Posts are plain text. Maximum 280 characters.",
+        inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The text content of the post (max 280 characters)" }, "connectionId": { "type": "string", "description": "X (Twitter) OAuth connection ID" } }, "required": ["text"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "postToZapier": {
+        stepType: "postToZapier",
+        description: "Send data to a Zapier Zap via webhook and return the response.",
+        usageNotes: "- The webhook URL must be configured in the Zapier Zap settings\n- Input keys and values are sent as the JSON body of the POST request\n- The webhook response (JSON or plain text) is returned as the output",
+        inputSchema: { "type": "object", "properties": { "webhookUrl": { "type": "string", "description": "Zapier webhook URL to send data to" }, "input": { "type": "object", "description": "Key-value pairs to send as the JSON POST body" } }, "required": ["webhookUrl", "input"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "Parsed webhook response from Zapier (JSON object, array, or string)" } }, "required": ["data"] }
+      },
+      "queryDataSource": {
+        stepType: "queryDataSource",
+        description: "Search a vector data source (RAG) and return relevant document chunks.",
+        usageNotes: "- Queries a vectorized data source and returns the most relevant chunks.\n- Useful for retrieval-augmented generation (RAG) workflows.",
+        inputSchema: { "type": "object", "properties": { "dataSourceId": { "type": "string", "description": "ID of the vector data source to query" }, "query": { "type": "string", "description": "The search query to run against the data source" }, "maxResults": { "type": "number", "description": "Maximum number of chunks to return (recommended 1-3)" } }, "required": ["dataSourceId", "query", "maxResults"] },
+        outputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "All matching chunks joined with newlines" }, "chunks": { "type": "array", "items": { "type": "string" }, "description": "Individual matching text chunks from the data source" }, "query": { "type": "string", "description": "The resolved search query that was executed" }, "citations": { "type": "array", "items": {}, "description": "Source citations for the matched chunks" }, "latencyMs": { "type": "number", "description": "Query execution time in milliseconds" } }, "required": ["text", "chunks", "query", "citations", "latencyMs"] }
+      },
+      "queryExternalDatabase": {
+        stepType: "queryExternalDatabase",
+        description: "Execute a SQL query against an external database connected to the workspace.",
+        usageNotes: "- Requires a database connection configured in the workspace.\n- Supports PostgreSQL (including Supabase), MySQL, and MSSQL.\n- Results can be returned as JSON or CSV.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Database connection ID configured in the workspace" }, "query": { "type": "string", "description": "SQL query to execute (supports variable interpolation)" }, "outputFormat": { "enum": ["json", "csv"], "type": "string", "description": "Output format for the result variable" } }, "required": ["query", "outputFormat"], "description": "Configuration for the external database query step" },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "Query result rows (array of objects for JSON, CSV string for CSV format)" } }, "required": ["data"] }
+      },
+      "redactPII": {
+        stepType: "redactPII",
+        description: "Replace personally identifiable information in text with placeholders using Microsoft Presidio.",
+        usageNotes: '- PII is replaced with entity type placeholders (e.g. "Call me at <PHONE_NUMBER>").\n- If entities is empty, returns empty text immediately without processing.',
+        inputSchema: { "type": "object", "properties": { "input": { "type": "string", "description": "Text to redact PII from" }, "language": { "type": "string", "description": 'Language code of the input text (e.g. "en")' }, "entities": { "type": "array", "items": { "type": "string" }, "description": 'PII entity types to redact (e.g. ["PHONE_NUMBER", "EMAIL_ADDRESS"]). Empty array means nothing is redacted.' } }, "required": ["input", "language", "entities"] },
+        outputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": 'The input text with detected PII replaced by entity type placeholders (e.g. "<PHONE_NUMBER>")' } }, "required": ["text"] }
+      },
+      "removeBackgroundFromImage": {
+        stepType: "removeBackgroundFromImage",
+        description: "Remove the background from an image using AI, producing a transparent PNG.",
+        usageNotes: "- Uses the Bria background removal model via fal.ai.\n- Output is re-hosted on the CDN as a PNG with transparency.",
+        inputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "URL of the source image to remove the background from" } }, "required": ["imageUrl"] },
+        outputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "CDN URL of the image with background removed (transparent PNG)" } }, "required": ["imageUrl"] }
+      },
+      "replyToGmailEmail": {
+        stepType: "replyToGmailEmail",
+        description: "Reply to an existing email in Gmail. The reply is threaded under the original message.",
+        usageNotes: '- Requires a Google OAuth connection with Gmail compose and readonly scopes.\n- The reply is sent to the original sender and threaded under the original message.\n- messageType controls the body format: "plain", "html", or "markdown".',
+        inputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID to reply to" }, "message": { "type": "string", "description": "Reply body content" }, "messageType": { "enum": ["plain", "html", "markdown"], "type": "string", "description": 'Body format: "plain", "html", or "markdown"' }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["messageId", "message", "messageType"] },
+        outputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID of the sent reply" } }, "required": ["messageId"] }
+      },
+      "resizeVideo": {
+        stepType: "resizeVideo",
+        description: "Resize a video file",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to resize" }, "mode": { "enum": ["fit", "exact"], "type": "string", "description": "Resize mode: 'fit' scales within max dimensions, 'exact' forces exact dimensions" }, "maxWidth": { "type": "number", "description": "Maximum width in pixels (used with 'fit' mode)" }, "maxHeight": { "type": "number", "description": "Maximum height in pixels (used with 'fit' mode)" }, "width": { "type": "number", "description": "Exact width in pixels (used with 'exact' mode)" }, "height": { "type": "number", "description": "Exact height in pixels (used with 'exact' mode)" }, "strategy": { "enum": ["pad", "crop"], "type": "string", "description": "Strategy for handling aspect ratio mismatch in 'exact' mode" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "mode"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the resized video" } }, "required": ["videoUrl"] }
+      },
+      "runPackagedWorkflow": {
+        stepType: "runPackagedWorkflow",
+        description: 'Run a packaged workflow ("custom block")',
+        usageNotes: `- 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.`,
+        inputSchema: { "type": "object", "properties": { "appId": { "type": "string", "description": "The app ID of the packaged workflow source" }, "workflowId": { "type": "string", "description": "The source workflow ID to execute" }, "inputVariables": { "type": "object", "description": "Variables to pass as input to the packaged workflow" }, "outputVariables": { "type": "object", "description": "Variables to capture from the packaged workflow output" }, "name": { "type": "string", "description": "Display name of the packaged workflow" } }, "required": ["appId", "workflowId", "inputVariables", "outputVariables", "name"], "description": "Configuration for the packaged workflow step" },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the packaged workflow" } }, "required": ["data"] }
+      },
+      "scrapeFacebookPage": {
+        stepType: "scrapeFacebookPage",
+        description: "Scrape a Facebook page",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "pageUrl": { "type": "string", "description": "Full URL to the Facebook page to scrape" } }, "required": ["pageUrl"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeFacebookPosts": {
+        stepType: "scrapeFacebookPosts",
+        description: "Get all the posts for a Facebook page",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "pageUrl": { "type": "string", "description": "Full URL to the Facebook page to scrape posts from" } }, "required": ["pageUrl"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeInstagramComments": {
+        stepType: "scrapeInstagramComments",
+        description: "Get all the comments for an Instagram post",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "postUrl": { "type": "string", "description": "Full URL to the Instagram post to scrape comments from" }, "resultsLimit": { "type": "string", "description": "Maximum number of comments to return" } }, "required": ["postUrl", "resultsLimit"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeInstagramMentions": {
+        stepType: "scrapeInstagramMentions",
+        description: "Scrape an Instagram profile's mentions",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "profileUrl": { "type": "string", "description": "Instagram profile URL or username to scrape mentions for" }, "resultsLimit": { "type": "string", "description": "Maximum number of mentions to return" } }, "required": ["profileUrl", "resultsLimit"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeInstagramPosts": {
+        stepType: "scrapeInstagramPosts",
+        description: "Get all the posts for an Instagram profile",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "profileUrl": { "type": "string", "description": "Instagram profile URL or username to scrape posts from" }, "resultsLimit": { "type": "string", "description": "Maximum number of posts to return" }, "onlyPostsNewerThan": { "type": "string", "description": "Only return posts newer than this date (ISO 8601 format)" } }, "required": ["profileUrl", "resultsLimit", "onlyPostsNewerThan"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeInstagramProfile": {
+        stepType: "scrapeInstagramProfile",
+        description: "Scrape an Instagram profile",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "profileUrl": { "type": "string", "description": "Instagram profile URL or username to scrape" } }, "required": ["profileUrl"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeInstagramReels": {
+        stepType: "scrapeInstagramReels",
+        description: "Get all the reels for an Instagram profile",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "profileUrl": { "type": "string", "description": "Instagram profile URL or username to scrape reels from" }, "resultsLimit": { "type": "string", "description": "Maximum number of reels to return" } }, "required": ["profileUrl", "resultsLimit"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeLinkedInCompany": {
+        stepType: "scrapeLinkedInCompany",
+        description: "Scrape public company data from a LinkedIn company page.",
+        usageNotes: "- Requires a LinkedIn company URL (e.g. https://www.linkedin.com/company/mindstudioai).\n- Returns structured company data including description, employees, updates, and similar companies.",
+        inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "LinkedIn company page URL (e.g. https://www.linkedin.com/company/mindstudioai)" } }, "required": ["url"] },
+        outputSchema: { "type": "object", "properties": { "company": { "description": "Scraped LinkedIn company data" } }, "required": ["company"] }
+      },
+      "scrapeLinkedInProfile": {
+        stepType: "scrapeLinkedInProfile",
+        description: "Scrape public profile data from a LinkedIn profile page.",
+        usageNotes: "- Requires a LinkedIn profile URL (e.g. https://www.linkedin.com/in/username).\n- Returns structured profile data including experience, education, articles, and activities.",
+        inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "LinkedIn profile URL (e.g. https://www.linkedin.com/in/username)" } }, "required": ["url"] },
+        outputSchema: { "type": "object", "properties": { "profile": { "description": "Scraped LinkedIn profile data" } }, "required": ["profile"] }
+      },
+      "scrapeMetaThreadsProfile": {
+        stepType: "scrapeMetaThreadsProfile",
+        description: "Scrape a Meta Threads profile",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "profileUrl": { "type": "string", "description": "Meta Threads profile URL or username to scrape" } }, "required": ["profileUrl"] },
+        outputSchema: { "type": "object", "properties": { "data": { "description": "The result data returned from the Apify actor run" } }, "required": ["data"] }
+      },
+      "scrapeUrl": {
+        stepType: "scrapeUrl",
+        description: "Extract text, HTML, or structured content from one or more web pages.",
+        usageNotes: '- Accepts a single URL or multiple URLs (as a JSON array, comma-separated, or newline-separated).\n- Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data.\n- Can optionally capture a screenshot of each page.',
+        inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "URL(s) to scrape. Accepts a single URL, JSON array, or comma/newline-separated list" }, "service": { "enum": ["default", "firecrawl"], "type": "string", "description": "Scraping service to use" }, "autoEnhance": { "type": "boolean", "description": "Whether to enable enhanced scraping for social media URLs (e.g. Twitter, LinkedIn)" }, "pageOptions": { "type": "object", "properties": { "onlyMainContent": { "type": "boolean", "description": "Whether to extract only the main content of the page, excluding navigation, footers, etc." }, "screenshot": { "type": "boolean", "description": "Whether to capture a screenshot of the page" }, "waitFor": { "type": "number", "description": "Milliseconds to wait before scraping (0 for immediate)" }, "replaceAllPathsWithAbsolutePaths": { "type": "boolean", "description": "Whether to convert relative URLs to absolute URLs in the result" }, "headers": { "type": "object", "description": "Custom HTTP request headers as key-value pairs" }, "removeTags": { "type": "array", "items": { "type": "string" }, "description": "HTML tags to remove from the scraped result" }, "mobile": { "type": "boolean", "description": "Whether to scrape using a mobile user-agent" } }, "required": ["onlyMainContent", "screenshot", "waitFor", "replaceAllPathsWithAbsolutePaths", "headers", "removeTags", "mobile"], "description": "Page-level scraping options (content filtering, screenshots, headers, etc.)" } }, "required": ["url"] },
+        outputSchema: { "type": "object", "properties": { "content": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" } }, "required": ["text", "html"] }, { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" } }, "required": ["text", "html"] } }] }, "screenshot": { "type": "string", "description": "Screenshot URL, only present when screenshot was requested via pageOptions" } }, "required": ["content"] }
+      },
+      "scrapeXPost": {
+        stepType: "scrapeXPost",
+        description: "Scrape data from a single X (Twitter) post by URL.",
+        usageNotes: "- Returns structured post data (text, html, optional json/screenshot/metadata).\n- Optionally saves the text content to a variable.",
+        inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "Full URL to the X post (e.g. https://x.com/elonmusk/status/1655608985058267139)" } }, "required": ["url"] },
+        outputSchema: { "type": "object", "properties": { "post": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" } }, "required": ["text", "html"], "description": "Scraped post data including text, HTML, and optional structured JSON" } }, "required": ["post"] }
+      },
+      "scrapeXProfile": {
+        stepType: "scrapeXProfile",
+        description: "Scrape public profile data from an X (Twitter) account by URL.",
+        usageNotes: "- Returns structured profile data.\n- Optionally saves the result to a variable.",
+        inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "Full URL or username for the X profile (e.g. https://x.com/elonmusk)" } }, "required": ["url"] },
+        outputSchema: { "type": "object", "properties": { "profile": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" } }, "required": ["text", "html"], "description": "Scraped profile data including text, HTML, and optional structured JSON" } }, "required": ["profile"] }
+      },
+      "searchGoogle": {
+        stepType: "searchGoogle",
+        description: "Search the web using Google and return structured results.",
+        usageNotes: "- Defaults to us/english, but can optionally specify country and/or language.\n- Defaults to any time, but can optionally specify last hour, last day, week, month, or year.\n- Defaults to top 30 results, but can specify 1 to 100 results to return.",
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "The search query to send to Google" }, "exportType": { "enum": ["text", "json"], "type": "string", "description": 'Format for the variable value: "text" or "json"' }, "countryCode": { "type": "string", "description": "Google gl country code (defaults to US)" }, "languageCode": { "type": "string", "description": 'Google hl language code (defaults to "en")' }, "dateRange": { "enum": ["hour", "day", "week", "month", "year", "any"], "type": "string", "description": 'Time range filter: "hour", "day", "week", "month", "year", or "any"' }, "numResults": { "type": "number", "description": "Number of results to return (1-100, default: 30)" } }, "required": ["query", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "description": "Title of the search result" }, "description": { "type": "string", "description": "Snippet/description of the search result" }, "url": { "type": "string", "description": "URL of the search result page" } }, "required": ["title", "description", "url"] }, "description": "List of search result entries" } }, "required": ["results"] }
+      },
+      "searchGoogleCalendarEvents": {
+        stepType: "searchGoogleCalendarEvents",
+        description: "Search for events in a Google Calendar by keyword, date range, or both.",
+        usageNotes: '- Requires a Google OAuth connection with Calendar events scope.\n- Supports keyword search via "query" and date filtering via "timeMin"/"timeMax" (ISO 8601 format).\n- Unlike "List Events" which only shows future events, this allows searching past events too.',
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "Text search term" }, "timeMin": { "type": "string", "description": "Start of time range (ISO 8601)" }, "timeMax": { "type": "string", "description": "End of time range (ISO 8601)" }, "calendarId": { "type": "string", "description": 'Calendar ID (defaults to "primary")' }, "limit": { "type": "number", "description": "Maximum number of events to return (default: 10)" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["exportType"] },
+        outputSchema: { "type": "object", "properties": { "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Google Calendar event ID" }, "status": { "type": "string", "description": 'Event status (e.g. "confirmed", "tentative", "cancelled")' }, "htmlLink": { "type": "string", "description": "URL to view the event in Google Calendar" }, "created": { "type": "string", "description": "Timestamp when the event was created" }, "updated": { "type": "string", "description": "Timestamp when the event was last updated" }, "summary": { "type": "string", "description": "Event title" }, "description": { "type": "string", "description": "Event description" }, "location": { "type": "string", "description": "Event location" }, "organizer": { "anyOf": [{ "type": "object", "properties": { "displayName": { "type": "string" }, "email": { "type": "string" } } }, { "type": "null" }] }, "start": { "anyOf": [{ "type": "object", "properties": { "dateTime": { "type": "string" }, "timeZone": { "type": "string" } } }, { "type": "null" }] }, "end": { "anyOf": [{ "type": "object", "properties": { "dateTime": { "type": "string" }, "timeZone": { "type": "string" } } }, { "type": "null" }] }, "attendees": { "anyOf": [{ "type": "array", "items": { "type": "object", "properties": { "displayName": { "type": "string" }, "email": { "type": "string" }, "responseStatus": { "type": "string" } } } }, { "type": "null" }] } } }, "description": "List of matching calendar events" } }, "required": ["events"] }
+      },
+      "searchGoogleDrive": {
+        stepType: "searchGoogleDrive",
+        description: "Search for files in Google Drive by keyword.",
+        usageNotes: "- Requires a Google OAuth connection with Drive scope.\n- Searches file content and names using Google Drive's fullText search.",
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "Search keyword" }, "limit": { "type": "number", "description": "Max files to return (default: 20)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' } }, "required": ["query", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "mimeType": { "type": "string" }, "size": { "type": "string" }, "webViewLink": { "type": "string" }, "createdTime": { "type": "string" }, "modifiedTime": { "type": "string" } }, "required": ["id", "name", "mimeType", "size", "webViewLink", "createdTime", "modifiedTime"] }, "description": "List of matching files" } }, "required": ["files"] }
+      },
+      "searchGoogleImages": {
+        stepType: "searchGoogleImages",
+        description: "Search Google Images and return image results with URLs and metadata.",
+        usageNotes: "- Defaults to us/english, but can optionally specify country and/or language.\n- Defaults to any time, but can optionally specify last hour, last day, week, month, or year.\n- Defaults to top 30 results, but can specify 1 to 100 results to return.",
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "The image search query" }, "exportType": { "enum": ["text", "json"], "type": "string", "description": 'Format for the variable value: "text" or "json"' }, "countryCode": { "type": "string", "description": "Google gl country code (defaults to US)" }, "languageCode": { "type": "string", "description": 'Google hl language code (defaults to "en")' }, "dateRange": { "enum": ["hour", "day", "week", "month", "year", "any"], "type": "string", "description": 'Time range filter: "hour", "day", "week", "month", "year", or "any"' }, "numResults": { "type": "number", "description": "Number of results to return (1-100, default: 30)" } }, "required": ["query", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "images": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "description": "Title/alt text of the image" }, "imageUrl": { "type": "string", "description": "Direct URL of the full-size image" }, "imageWidth": { "type": "number", "description": "Width of the full-size image in pixels" }, "imageHeight": { "type": "number", "description": "Height of the full-size image in pixels" }, "thumbnailUrl": { "type": "string", "description": "URL of the thumbnail image" }, "thumbnailWidth": { "type": "number", "description": "Width of the thumbnail in pixels" }, "thumbnailHeight": { "type": "number", "description": "Height of the thumbnail in pixels" }, "source": { "type": "string", "description": "Source website name" }, "domain": { "type": "string", "description": "Domain of the source website" }, "link": { "type": "string", "description": "URL of the page containing the image" }, "googleUrl": { "type": "string", "description": "Google Images URL for this result" }, "position": { "type": "number", "description": "Position/rank of this result in the search results" } }, "required": ["title", "imageUrl", "imageWidth", "imageHeight", "thumbnailUrl", "thumbnailWidth", "thumbnailHeight", "source", "domain", "link", "googleUrl", "position"] }, "description": "List of image search results with URLs and metadata" } }, "required": ["images"] }
+      },
+      "searchGoogleNews": {
+        stepType: "searchGoogleNews",
+        description: "Search Google News for recent news articles matching a query.",
+        usageNotes: "- Defaults to top 30 results, but can specify 1 to 100 results to return.",
+        inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The news search query" }, "exportType": { "enum": ["text", "json"], "type": "string", "description": 'Format for the variable value: "text" or "json"' }, "numResults": { "type": "number", "description": "Number of results to return (1-100, default: 30)" } }, "required": ["text", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "articles": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "description": "Headline of the news article" }, "link": { "type": "string", "description": "URL to the full article" }, "date": { "type": "string", "description": "Publication date of the article" }, "source": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the news source" } }, "required": ["name"], "description": "Source publication" }, "snippet": { "type": "string", "description": "Brief excerpt or summary of the article" } }, "required": ["title", "link", "date", "source"] }, "description": "List of matching news articles" } }, "required": ["articles"] }
+      },
+      "searchGoogleTrends": {
+        stepType: "searchGoogleTrends",
+        description: "Fetch Google Trends data for a search term.",
+        usageNotes: '- date accepts shorthand ("now 1-H", "today 1-m", "today 5-y", etc.) or custom "yyyy-mm-dd yyyy-mm-dd" ranges.\n- data_type controls the shape of returned data: TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, or RELATED_QUERIES.',
+        inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The search term to look up on Google Trends" }, "hl": { "type": "string", "description": 'Language code (e.g. "en")' }, "geo": { "type": "string", "description": "Geographic region: empty string for worldwide, or a two-letter country code" }, "data_type": { "enum": ["TIMESERIES", "GEO_MAP", "GEO_MAP_0", "RELATED_TOPICS", "RELATED_QUERIES"], "type": "string", "description": "Type of trend data to return" }, "cat": { "type": "string", "description": 'Category filter ("0" for all categories)' }, "date": { "type": "string", "description": 'Date range for trend data. Available options:   - "now 1-H" - Past hour   - "now 4-H" - Past 4 hours   - "now 1-d" - Past day   - "now 7-d" - Past 7 days   - "today 1-m" - Past 30 days   - "today 3-m" - Past 90 days   - "today 12-m" - Past 12 months   - "today 5-y" - Past 5 years   - "all - 2004" - present   - You can also pass custom values: "yyyy-mm-dd yyyy-mm-dd"' }, "ts": { "type": "string", "description": "Timezone offset in minutes (-1439 to 1439, default: 420 for PDT)" } }, "required": ["text", "hl", "geo", "data_type", "cat", "date", "ts"] },
+        outputSchema: { "type": "object", "properties": { "trends": { "type": "object", "description": "Google Trends data for the searched term" } }, "required": ["trends"] }
+      },
+      "searchPerplexity": {
+        stepType: "searchPerplexity",
+        description: "Search the web using the Perplexity API and return structured results.",
+        usageNotes: "- Defaults to US results. Use countryCode (ISO code) to filter by country.\n- Returns 10 results by default, configurable from 1 to 20.\n- The variable receives text or JSON depending on exportType. The direct execution output always returns structured results.",
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "Search query to send to Perplexity" }, "exportType": { "enum": ["text", "json"], "type": "string", "description": "Output format for the variable: plain text or structured JSON" }, "countryCode": { "type": "string", "description": 'ISO country code to filter results by region (e.g. "us", "gb")' }, "numResults": { "type": "number", "description": "Number of results to return (1-20, default: 10)" } }, "required": ["query", "exportType"] },
+        outputSchema: { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title of the search result" }, "description": { "type": "string", "description": "Snippet or description of the search result" }, "url": { "type": "string", "description": "URL of the search result page" } }, "required": ["title", "description", "url"] }, "description": "List of structured search results" } }, "required": ["results"] }
+      },
+      "searchXPosts": {
+        stepType: "searchXPosts",
+        description: "Search recent X (Twitter) posts matching a query.",
+        usageNotes: "- Searches only the past 7 days of posts.\n- Query supports X API v2 search operators (up to 512 characters).\n\nAvailable search operators in query:\n\n| Operator         | Description                                      |\n| -----------------| -------------------------------------------------|\n| from:            | Posts from a specific user (e.g., from:elonmusk) |\n| to:              | Posts sent to a specific user (e.g., to:NASA)    |\n| @                | Mentions a user (e.g., @openai)                  |\n| #                | Hashtag search (e.g., #AI)                       |\n| is:retweet       | Filters retweets                                 |\n| is:reply         | Filters replies                                  |\n| has:media        | Posts containing media (images, videos, or GIFs) |\n| has:links        | Posts containing URLs                            |\n| lang:            | Filters by language (e.g., lang:en)              |\n| -                | Excludes specific terms (e.g., -spam)            |\n| ()               | Groups terms or operators (e.g., (AI OR ML))     |\n| AND, OR, NOT     | Boolean logic for combining or excluding terms   |\n\nConjunction-Required Operators (must be combined with a standalone operator):\n\n| Operator     | Description                                    |\n| ------------ | -----------------------------------------------|\n| has:media  | Posts containing media (images, videos, or GIFs) |\n| has:links  | Posts containing URLs                            |\n| is:retweet | Filters retweets                                 |\n| is:reply   | Filters replies                                  |\n\nFor example, has:media alone is invalid, but #AI has:media is valid.",
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "Search query (max 512 chars, supports X API v2 search operators)" }, "scope": { "enum": ["recent", "all"], "type": "string", "description": 'Search scope: "recent" for past 7 days or "all" for full archive' }, "options": { "type": "object", "properties": { "startTime": { "type": "string", "description": "ISO 8601 date; only return posts after this time" }, "endTime": { "type": "string", "description": "ISO 8601 date; only return posts before this time" }, "maxResults": { "type": "number", "description": "Number of results to return (default: 50, max: 100)" } }, "description": "Additional search options" } }, "required": ["query", "scope", "options"] },
+        outputSchema: { "type": "object", "properties": { "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique post identifier" }, "authorId": { "type": "string", "description": "Author's X user ID" }, "dateCreated": { "type": "string", "description": "ISO 8601 timestamp when the post was created" }, "text": { "type": "string", "description": "Text content of the post" }, "stats": { "type": "object", "properties": { "retweets": { "type": "number", "description": "Number of retweets/reposts" }, "replies": { "type": "number", "description": "Number of replies" }, "likes": { "type": "number", "description": "Number of likes" } }, "required": ["retweets", "replies", "likes"], "description": "Engagement statistics for the post" } }, "required": ["id", "authorId", "dateCreated", "text", "stats"] }, "description": "List of matching X posts" } }, "required": ["posts"] }
+      },
+      "searchYoutube": {
+        stepType: "searchYoutube",
+        description: "Search for YouTube videos by keyword.",
+        usageNotes: "- Supports pagination (up to 5 pages) and country/language filters.\n- Use the filter/filterType fields for YouTube search parameter (sp) filters.",
+        inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "Search query for YouTube videos" }, "limitPages": { "type": "string", "description": "Maximum number of pages to fetch (1-5)" }, "filter": { "type": "string", "description": "YouTube search parameter (sp) filter value" }, "filterType": { "type": "string", "description": "Filter type identifier" }, "countryCode": { "type": "string", "description": 'Google gl country code for regional results (default: "US")' }, "languageCode": { "type": "string", "description": 'Google hl language code for result language (default: "en")' } }, "required": ["query", "limitPages", "filter", "filterType"] },
+        outputSchema: { "type": "object", "properties": { "results": { "type": "object", "description": "YouTube search results including video_results, channel_results, etc." } }, "required": ["results"] }
+      },
+      "searchYoutubeTrends": {
+        stepType: "searchYoutubeTrends",
+        description: "Retrieve trending videos on YouTube by category and region.",
+        usageNotes: '- Categories: "now" (trending now), "music", "gaming", "films".\n- Supports country and language filtering.',
+        inputSchema: { "type": "object", "properties": { "bp": { "enum": ["now", "music", "gaming", "films"], "type": "string", "description": 'Trending category: "now" (trending now), "music", "gaming", or "films"' }, "hl": { "type": "string", "description": 'Language code (e.g. "en")' }, "gl": { "type": "string", "description": 'Country code (e.g. "US")' } }, "required": ["bp", "hl", "gl"] },
+        outputSchema: { "type": "object", "properties": { "trends": { "type": "object", "description": "Trending video data for the selected category and region" } }, "required": ["trends"] }
+      },
+      "sendEmail": {
+        stepType: "sendEmail",
+        description: "Send an email to one or more configured recipient addresses.",
+        usageNotes: '- Recipient email addresses are resolved from OAuth connections configured by the app creator. The user running the workflow does not specify the recipient directly.\n- If the body is a URL to a hosted HTML file on the CDN, the HTML is fetched and used as the email body.\n- When generateHtml is enabled, the body text is converted to a styled HTML email using an AI model.\n- connectionId can be a comma-separated list to send to multiple recipients.\n- The special connectionId "trigger_email" uses the email address that triggered the workflow.',
+        inputSchema: { "type": "object", "properties": { "subject": { "type": "string", "description": "Email subject line" }, "body": { "type": "string", "description": "Email body content (plain text, markdown, HTML, or a CDN URL to an HTML file)" }, "connectionId": { "type": "string", "description": "OAuth connection ID(s) for the recipient(s), comma-separated for multiple" }, "generateHtml": { "type": "boolean", "description": "When true, auto-convert the body text into a styled HTML email using AI" }, "generateHtmlInstructions": { "type": "string", "description": "Natural language instructions for the HTML generation style" }, "generateHtmlModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model settings override for HTML generation" }, "attachments": { "type": "array", "items": { "type": "string" }, "description": "URLs of files to attach to the email" } }, "required": ["subject", "body"] },
+        outputSchema: { "type": "object", "properties": { "recipients": { "type": "array", "items": { "type": "string" }, "description": "Email addresses the message was sent to" } }, "required": ["recipients"] }
+      },
+      "sendSMS": {
+        stepType: "sendSMS",
+        description: "Send an SMS text message to a phone number configured via OAuth connection.",
+        usageNotes: "- User is responsible for configuring the connection to the number (MindStudio requires double opt-in to prevent spam)",
+        inputSchema: { "type": "object", "properties": { "body": { "type": "string", "description": "SMS message body text" }, "connectionId": { "type": "string", "description": "OAuth connection ID for the recipient phone number" } }, "required": ["body"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "setRunTitle": {
+        stepType: "setRunTitle",
+        description: "Set the title of the agent run for the user's history",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "title": { "type": "string", "description": "The title to assign to the agent run (supports variable interpolation)" } }, "required": ["title"], "description": "Configuration for the set run title step" },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "setVariable": {
+        stepType: "setVariable",
+        description: "Explicitly set a variable to a given value.",
+        usageNotes: "- Useful for bootstrapping global variables or setting constants.\n- The variable name and value both support variable interpolation.\n- The type field is a UI hint only (controls input widget in the editor).",
+        inputSchema: { "type": "object", "properties": { "value": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["value"], "description": "Configuration for the set variable step" },
+        outputSchema: { "type": "object" }
+      },
+      "telegramSendAudio": {
+        stepType: "telegramSendAudio",
+        description: "Send an audio file to a Telegram chat as music or a voice note via a bot.",
+        usageNotes: '- "audio" mode sends as a standard audio file. "voice" mode sends as a voice message (re-uploads the file for large file support).',
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the audio to" }, "audioUrl": { "type": "string", "description": "URL of the audio file to send" }, "mode": { "enum": ["audio", "voice"], "type": "string", "description": 'Send as a standard audio track ("audio") or as a voice note ("voice")' }, "caption": { "type": "string", "description": "Optional caption text for the audio" } }, "required": ["botToken", "chatId", "audioUrl", "mode"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "telegramSendFile": {
+        stepType: "telegramSendFile",
+        description: "Send a document/file to a Telegram chat via a bot.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the file to" }, "fileUrl": { "type": "string", "description": "URL of the document/file to send" }, "caption": { "type": "string", "description": "Optional caption text for the file" } }, "required": ["botToken", "chatId", "fileUrl"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "telegramSendImage": {
+        stepType: "telegramSendImage",
+        description: "Send an image to a Telegram chat via a bot.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the image to" }, "imageUrl": { "type": "string", "description": "URL of the image to send" }, "caption": { "type": "string", "description": "Optional caption text for the image" } }, "required": ["botToken", "chatId", "imageUrl"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "telegramSendMessage": {
+        stepType: "telegramSendMessage",
+        description: "Send a text message to a Telegram chat via a bot.",
+        usageNotes: '- Messages are sent using MarkdownV2 formatting. Special characters are auto-escaped.\n- botToken format is "botId:token" \u2014 both parts are required.',
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the message to" }, "text": { "type": "string", "description": "Message text to send (MarkdownV2 formatting supported)" } }, "required": ["botToken", "chatId", "text"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "telegramSendVideo": {
+        stepType: "telegramSendVideo",
+        description: "Send a video to a Telegram chat via a bot.",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the video to" }, "videoUrl": { "type": "string", "description": "URL of the video to send" }, "caption": { "type": "string", "description": "Optional caption text for the video" } }, "required": ["botToken", "chatId", "videoUrl"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "telegramSetTyping": {
+        stepType: "telegramSetTyping",
+        description: 'Show the "typing..." indicator in a Telegram chat via a bot.',
+        usageNotes: "- The typing indicator automatically expires after a few seconds. Use this right before sending a message for a natural feel.",
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to show the typing indicator in" } }, "required": ["botToken", "chatId"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "textToSpeech": {
+        stepType: "textToSpeech",
+        description: "Generate an audio file from provided text using a speech model.",
+        usageNotes: "- The text field contains the exact words to be spoken (not instructions).\n- In foreground mode, the audio is displayed to the user. In background mode, the URL is saved to a variable.",
+        inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The text to convert to speech" }, "skipAssetCreation": { "type": "boolean" }, "speechModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Speech synthesis model identifier" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default speech model if not specified" } }, "required": ["text"] },
+        outputSchema: { "type": "object", "properties": { "audioUrl": { "type": "string", "description": "URL of the generated audio file" } }, "required": ["audioUrl"] }
+      },
+      "transcribeAudio": {
+        stepType: "transcribeAudio",
+        description: "Convert an audio file to text using a transcription model.",
+        usageNotes: "- The prompt field provides optional context to improve transcription accuracy (e.g. language, speaker names, domain).",
+        inputSchema: { "type": "object", "properties": { "audioUrl": { "type": "string", "description": "URL of the audio file to transcribe" }, "prompt": { "type": "string", "description": "Optional context to improve transcription accuracy (e.g. language, speaker names, domain terms)" }, "transcriptionModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Audio transcription model identifier" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default transcription model if not specified" } }, "required": ["audioUrl", "prompt"] },
+        outputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The transcribed text from the audio file" } }, "required": ["text"] }
+      },
+      "trimMedia": {
+        stepType: "trimMedia",
+        description: "Trim an audio or video clip",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "inputUrl": { "type": "string", "description": "URL of the source audio or video file to trim" }, "start": { "type": ["number", "string"] }, "duration": { "type": ["string", "number"] }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["inputUrl"] },
+        outputSchema: { "type": "object", "properties": { "mediaUrl": { "type": "string", "description": "URL of the trimmed media file" } }, "required": ["mediaUrl"] }
+      },
+      "updateGoogleCalendarEvent": {
+        stepType: "updateGoogleCalendarEvent",
+        description: "Update an existing event on a Google Calendar. Only specified fields are changed.",
+        usageNotes: "- Requires a Google OAuth connection with Calendar events scope.\n- Fetches the existing event first, then applies only the provided updates. Omitted fields are left unchanged.\n- Attendees are specified as one email address per line, and replace the entire attendee list.",
+        inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "eventId": { "type": "string", "description": "Google Calendar event ID to update" }, "summary": { "type": "string", "description": "Updated event title" }, "description": { "type": "string", "description": "Updated event description" }, "location": { "type": "string", "description": "Updated event location" }, "startDateTime": { "type": "string", "description": "Updated start time in ISO 8601 format" }, "endDateTime": { "type": "string", "description": "Updated end time in ISO 8601 format" }, "attendees": { "type": "string", "description": "Updated attendee email addresses (one per line, replaces all existing attendees)" }, "calendarId": { "type": "string", "description": 'Calendar ID (defaults to "primary" if omitted)' } }, "required": ["eventId"] },
+        outputSchema: { "type": "object", "properties": { "eventId": { "type": "string", "description": "Google Calendar event ID" }, "htmlLink": { "type": "string", "description": "URL to view the updated event in Google Calendar" } }, "required": ["eventId", "htmlLink"] }
+      },
+      "updateGoogleDoc": {
+        stepType: "updateGoogleDoc",
+        description: "Update the contents of an existing Google Document.",
+        usageNotes: '- operationType controls how content is applied: "addToTop" prepends, "addToBottom" appends, "overwrite" replaces all content.\n- textType determines how the text field is interpreted: "plain" for plain text, "html" for HTML markup, "markdown" for Markdown.',
+        inputSchema: { "type": "object", "properties": { "documentId": { "type": "string", "description": "Google Document ID to update" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "text": { "type": "string", "description": "New content to write to the document" }, "textType": { "enum": ["plain", "html", "markdown"], "type": "string", "description": 'Format of the text field: "plain", "html", or "markdown"' }, "operationType": { "enum": ["addToTop", "addToBottom", "overwrite"], "type": "string", "description": 'How to apply the content: "addToTop", "addToBottom", or "overwrite"' } }, "required": ["documentId", "text", "textType", "operationType"] },
+        outputSchema: { "type": "object", "properties": { "documentUrl": { "type": "string", "description": "URL of the updated Google Document" } }, "required": ["documentUrl"] }
+      },
+      "updateGoogleSheet": {
+        stepType: "updateGoogleSheet",
+        description: "Update a Google Spreadsheet with new data.",
+        usageNotes: '- operationType controls how data is written: "addToBottom" appends rows, "overwrite" replaces all data, "range" writes to a specific cell range.\n- Data should be provided as CSV in the text field.',
+        inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "CSV data to write to the spreadsheet" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "spreadsheetId": { "type": "string", "description": "Google Spreadsheet ID to update" }, "range": { "type": "string", "description": 'Target cell range in A1 notation (used with "range" operationType)' }, "operationType": { "enum": ["addToBottom", "overwrite", "range"], "type": "string", "description": 'How to apply the data: "addToBottom", "overwrite", or "range"' } }, "required": ["text", "spreadsheetId", "range", "operationType"] },
+        outputSchema: { "type": "object", "properties": { "spreadsheetUrl": { "type": "string", "description": "URL of the updated Google Spreadsheet" } }, "required": ["spreadsheetUrl"] }
+      },
+      "uploadDataSourceDocument": {
+        stepType: "uploadDataSourceDocument",
+        description: "Upload a file into an existing data source from a URL or raw text content.",
+        usageNotes: '- If "file" is a single URL, the file is downloaded from that URL and uploaded.\n- If "file" is any other string, a .txt document is created from that content and uploaded.\n- The block waits (polls) for processing to complete before transitioning, up to 5 minutes.\n- Once processing finishes, vectors are loaded into Milvus so the data source is immediately queryable.\n- Supported file types (when using a URL) are the same as the data source upload UI (PDF, DOCX, TXT, etc.).',
+        inputSchema: { "type": "object", "properties": { "dataSourceId": { "type": "string", "description": "ID of the target data source (supports variable interpolation)" }, "file": { "type": "string", "description": "A URL to download, or raw text content to create a .txt document from (supports variable interpolation)" }, "fileName": { "type": "string", "description": "Display name for the document (supports variable interpolation)" } }, "required": ["dataSourceId", "file", "fileName"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "upscaleImage": {
+        stepType: "upscaleImage",
+        description: "Increase the resolution of an image using AI upscaling.",
+        usageNotes: "- Output is re-hosted on the CDN as a PNG.",
+        inputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "URL of the image to upscale" }, "targetResolution": { "enum": ["2k", "4k", "8k"], "type": "string", "description": "Target output resolution" }, "engine": { "enum": ["standard", "pro"], "type": "string", "description": "Upscaling engine quality tier" } }, "required": ["imageUrl", "targetResolution", "engine"] },
+        outputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "CDN URL of the upscaled image (PNG)" } }, "required": ["imageUrl"] }
+      },
+      "upscaleVideo": {
+        stepType: "upscaleVideo",
+        description: "Upscale a video file",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to upscale" }, "targetResolution": { "enum": ["720p", "1080p", "2K", "4K"], "type": "string", "description": "Target output resolution for the upscaled video" }, "engine": { "enum": ["standard", "pro", "ultimate", "flashvsr", "seedance", "seedvr2", "runwayml/upscale-v1"], "type": "string", "description": "Upscaling engine to use. Higher tiers produce better quality at higher cost." }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "targetResolution", "engine"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the upscaled video" } }, "required": ["videoUrl"] }
+      },
+      "userMessage": {
+        stepType: "userMessage",
+        description: "Send a message to an AI model and return the response, or echo a system message.",
+        usageNotes: `- Source "user" sends the message to an LLM and returns the model's response.
+- Source "system" echoes the message content directly (no AI call).
+- Mode "background" saves the result to a variable. Mode "foreground" streams it to the user (not available in direct execution).
+- Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.`,
+        inputSchema: { "type": "object", "properties": { "message": { "type": "string", "description": "The message to send (prompt for AI, or text for system echo)" }, "source": { "enum": ["user", "system"], "type": "string", "description": 'Message source: "user" sends to AI model, "system" echoes message content directly. Defaults to "user"' }, "modelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model configuration override. Optional; uses the workflow's default model if not specified" }, "structuredOutputType": { "enum": ["text", "json", "csv"], "type": "string", "description": "Output format constraint for structured responses" }, "structuredOutputExample": { "type": "string", "description": "Sample showing the desired output shape (for JSON/CSV formats). A TypeScript interface is also useful here for more complex types." }, "chatHistoryMode": { "enum": ["include", "exclude"], "type": "string", "description": "Whether to include or exclude prior chat history in the AI context" } }, "required": ["message"], "description": "Configuration for the user message step" },
+        outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "The AI model's response or echoed system message content" } }, "required": ["content"] }
+      },
+      "videoFaceSwap": {
+        stepType: "videoFaceSwap",
+        description: "Swap faces in a video file",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video containing faces to swap" }, "faceImageUrl": { "type": "string", "description": "URL of the image containing the replacement face" }, "targetIndex": { "type": "number", "description": "Zero-based index of the face to replace in the video" }, "engine": { "type": "string", "description": "Face swap engine to use" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "faceImageUrl", "targetIndex", "engine"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the face-swapped video" } }, "required": ["videoUrl"] }
+      },
+      "videoRemoveBackground": {
+        stepType: "videoRemoveBackground",
+        description: "Remove or replace background from a video",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video" }, "newBackground": { "enum": ["transparent", "image"], "type": "string", "description": "Whether to make the background transparent or replace it with an image" }, "newBackgroundImageUrl": { "type": "string", "description": "URL of a replacement background image. Required when newBackground is 'image'." }, "engine": { "type": "string", "description": "Background removal engine to use" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "newBackground", "engine"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the video with background removed or replaced" } }, "required": ["videoUrl"] }
+      },
+      "videoRemoveWatermark": {
+        stepType: "videoRemoveWatermark",
+        description: "Remove a watermark from a video",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video containing a watermark" }, "engine": { "type": "string", "description": "Watermark removal engine to use" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "engine"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the video with watermark removed" } }, "required": ["videoUrl"] }
+      },
+      "watermarkImage": {
+        stepType: "watermarkImage",
+        description: "Overlay a watermark image onto another image.",
+        usageNotes: "- The watermark is placed at the specified corner with configurable padding and width.",
+        inputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "URL of the base image" }, "watermarkImageUrl": { "type": "string", "description": "URL of the watermark image to overlay" }, "corner": { "enum": ["top-left", "top-right", "bottom-left", "bottom-right"], "type": "string", "description": "Corner position for the watermark placement" }, "paddingPx": { "type": "number", "description": "Padding from the corner in pixels" }, "widthPx": { "type": "number", "description": "Width of the watermark overlay in pixels" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history" } }, "required": ["imageUrl", "watermarkImageUrl", "corner", "paddingPx", "widthPx"] },
+        outputSchema: { "type": "object", "properties": { "imageUrl": { "type": "string", "description": "CDN URL of the watermarked image" } }, "required": ["imageUrl"] }
+      },
+      "watermarkVideo": {
+        stepType: "watermarkVideo",
+        description: "Add an image watermark to a video",
+        usageNotes: "",
+        inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video" }, "imageUrl": { "type": "string", "description": "URL of the watermark image to overlay" }, "corner": { "enum": ["top-left", "top-right", "bottom-left", "bottom-right"], "type": "string", "description": "Corner position for the watermark placement" }, "paddingPx": { "type": "number", "description": "Padding from the corner in pixels" }, "widthPx": { "type": "number", "description": "Width of the watermark overlay in pixels" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "imageUrl", "corner", "paddingPx", "widthPx"] },
+        outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the watermarked video" } }, "required": ["videoUrl"] }
+      }
+    };
+  }
+});
+
+// src/errors.ts
+var MindStudioError;
+var init_errors = __esm({
+  "src/errors.ts"() {
+    "use strict";
+    MindStudioError = class extends Error {
+      constructor(message, code, status, details) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.details = details;
+      }
+      name = "MindStudioError";
+    };
+  }
+});
+
+// src/http.ts
+async function request(config, method, path, body) {
+  const url = `${config.baseUrl}/developer/v2${path}`;
+  await config.rateLimiter.acquire();
+  try {
+    return await requestWithRetry(config, method, url, body, 0);
+  } finally {
+    config.rateLimiter.release();
+  }
+}
+async function requestWithRetry(config, method, url, body, attempt) {
+  const res = await fetch(url, {
+    method,
+    headers: {
+      Authorization: `Bearer ${config.token}`,
+      "Content-Type": "application/json",
+      "User-Agent": "@mindstudio-ai/agent"
+    },
+    body: body != null ? JSON.stringify(body) : void 0
+  });
+  config.rateLimiter.updateFromHeaders(res.headers);
+  if (res.status === 429 && attempt < config.maxRetries) {
+    const retryAfter = res.headers.get("retry-after");
+    const waitMs = retryAfter ? parseFloat(retryAfter) * 1e3 : 1e3;
+    await sleep(waitMs);
+    return requestWithRetry(config, method, url, body, attempt + 1);
+  }
+  if (!res.ok) {
+    const errorBody = await res.json().catch(() => ({}));
+    throw new MindStudioError(
+      errorBody.message || `${res.status} ${res.statusText}`,
+      errorBody.code || "api_error",
+      res.status,
+      errorBody
+    );
+  }
+  const data = await res.json();
+  return { data, headers: res.headers };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var init_http = __esm({
+  "src/http.ts"() {
+    "use strict";
+    init_errors();
+  }
+});
+
+// src/rate-limit.ts
+var DEFAULTS, RateLimiter;
+var init_rate_limit = __esm({
+  "src/rate-limit.ts"() {
+    "use strict";
+    init_errors();
+    DEFAULTS = {
+      internal: { concurrency: 10, callCap: 500 },
+      apiKey: { concurrency: 20, callCap: Infinity }
+    };
+    RateLimiter = class {
+      constructor(authType) {
+        this.authType = authType;
+        this.concurrencyLimit = DEFAULTS[authType].concurrency;
+        this.callCap = DEFAULTS[authType].callCap;
+      }
+      inflight = 0;
+      concurrencyLimit;
+      callCount = 0;
+      callCap;
+      queue = [];
+      /** Acquire a slot. Resolves when a concurrent slot is available. */
+      async acquire() {
+        if (this.callCount >= this.callCap) {
+          throw new MindStudioError(
+            `Call cap reached (${this.callCap} calls). Internal tokens are limited to 500 calls per execution.`,
+            "call_cap_exceeded",
+            429
+          );
+        }
+        if (this.inflight < this.concurrencyLimit) {
+          this.inflight++;
+          this.callCount++;
+          return;
+        }
+        return new Promise((resolve) => {
+          this.queue.push(() => {
+            this.inflight++;
+            this.callCount++;
+            resolve();
+          });
+        });
+      }
+      /** Release a slot and let the next queued request proceed. */
+      release() {
+        this.inflight--;
+        const next = this.queue.shift();
+        if (next) next();
+      }
+      /** Update limits from response headers. */
+      updateFromHeaders(headers) {
+        const concurrency = headers.get("x-ratelimit-concurrency-limit");
+        if (concurrency) {
+          this.concurrencyLimit = parseInt(concurrency, 10);
+        }
+        const limit = headers.get("x-ratelimit-limit");
+        if (limit && this.authType === "internal") {
+          this.callCap = parseInt(limit, 10);
+        }
+      }
+      /** Read current rate limit state from response headers. */
+      static parseHeaders(headers) {
+        const remaining = headers.get("x-ratelimit-remaining");
+        const concurrencyRemaining = headers.get(
+          "x-ratelimit-concurrency-remaining"
+        );
+        return {
+          remaining: remaining != null ? parseInt(remaining, 10) : void 0,
+          concurrencyRemaining: concurrencyRemaining != null ? parseInt(concurrencyRemaining, 10) : void 0
+        };
+      }
+    };
+  }
+});
+
+// src/generated/steps.ts
+var steps_exports = {};
+__export(steps_exports, {
+  applyStepMethods: () => applyStepMethods
+});
+function applyStepMethods(AgentClass) {
+  const proto = AgentClass.prototype;
+  proto.activeCampaignAddNote = function(step, options) {
+    return this.executeStep("activeCampaignAddNote", step, options);
+  };
+  proto.activeCampaignCreateContact = function(step, options) {
+    return this.executeStep("activeCampaignCreateContact", step, options);
+  };
+  proto.addSubtitlesToVideo = function(step, options) {
+    return this.executeStep("addSubtitlesToVideo", step, options);
+  };
+  proto.airtableCreateUpdateRecord = function(step, options) {
+    return this.executeStep("airtableCreateUpdateRecord", step, options);
+  };
+  proto.airtableDeleteRecord = function(step, options) {
+    return this.executeStep("airtableDeleteRecord", step, options);
+  };
+  proto.airtableGetRecord = function(step, options) {
+    return this.executeStep("airtableGetRecord", step, options);
+  };
+  proto.airtableGetTableRecords = function(step, options) {
+    return this.executeStep("airtableGetTableRecords", step, options);
+  };
+  proto.analyzeImage = function(step, options) {
+    return this.executeStep("analyzeImage", step, options);
+  };
+  proto.analyzeVideo = function(step, options) {
+    return this.executeStep("analyzeVideo", step, options);
+  };
+  proto.captureThumbnail = function(step, options) {
+    return this.executeStep("captureThumbnail", step, options);
+  };
+  proto.codaCreateUpdatePage = function(step, options) {
+    return this.executeStep("codaCreateUpdatePage", step, options);
+  };
+  proto.codaCreateUpdateRow = function(step, options) {
+    return this.executeStep("codaCreateUpdateRow", step, options);
+  };
+  proto.codaFindRow = function(step, options) {
+    return this.executeStep("codaFindRow", step, options);
+  };
+  proto.codaGetPage = function(step, options) {
+    return this.executeStep("codaGetPage", step, options);
+  };
+  proto.codaGetTableRows = function(step, options) {
+    return this.executeStep("codaGetTableRows", step, options);
+  };
+  proto.convertPdfToImages = function(step, options) {
+    return this.executeStep("convertPdfToImages", step, options);
+  };
+  proto.createDataSource = function(step, options) {
+    return this.executeStep("createDataSource", step, options);
+  };
+  proto.createGoogleCalendarEvent = function(step, options) {
+    return this.executeStep("createGoogleCalendarEvent", step, options);
+  };
+  proto.createGoogleDoc = function(step, options) {
+    return this.executeStep("createGoogleDoc", step, options);
+  };
+  proto.createGoogleSheet = function(step, options) {
+    return this.executeStep("createGoogleSheet", step, options);
+  };
+  proto.deleteDataSource = function(step, options) {
+    return this.executeStep("deleteDataSource", step, options);
+  };
+  proto.deleteDataSourceDocument = function(step, options) {
+    return this.executeStep("deleteDataSourceDocument", step, options);
+  };
+  proto.deleteGmailEmail = function(step, options) {
+    return this.executeStep("deleteGmailEmail", step, options);
+  };
+  proto.deleteGoogleCalendarEvent = function(step, options) {
+    return this.executeStep("deleteGoogleCalendarEvent", step, options);
+  };
+  proto.deleteGoogleSheetRows = function(step, options) {
+    return this.executeStep("deleteGoogleSheetRows", step, options);
+  };
+  proto.detectPII = function(step, options) {
+    return this.executeStep("detectPII", step, options);
+  };
+  proto.downloadVideo = function(step, options) {
+    return this.executeStep("downloadVideo", step, options);
+  };
+  proto.enhanceImageGenerationPrompt = function(step, options) {
+    return this.executeStep("enhanceImageGenerationPrompt", step, options);
+  };
+  proto.enhanceVideoGenerationPrompt = function(step, options) {
+    return this.executeStep("enhanceVideoGenerationPrompt", step, options);
+  };
+  proto.enrichPerson = function(step, options) {
+    return this.executeStep("enrichPerson", step, options);
+  };
+  proto.extractAudioFromVideo = function(step, options) {
+    return this.executeStep("extractAudioFromVideo", step, options);
+  };
+  proto.extractText = function(step, options) {
+    return this.executeStep("extractText", step, options);
+  };
+  proto.fetchDataSourceDocument = function(step, options) {
+    return this.executeStep("fetchDataSourceDocument", step, options);
+  };
+  proto.fetchGoogleDoc = function(step, options) {
+    return this.executeStep("fetchGoogleDoc", step, options);
+  };
+  proto.fetchGoogleSheet = function(step, options) {
+    return this.executeStep("fetchGoogleSheet", step, options);
+  };
+  proto.fetchSlackChannelHistory = function(step, options) {
+    return this.executeStep("fetchSlackChannelHistory", step, options);
+  };
+  proto.fetchYoutubeCaptions = function(step, options) {
+    return this.executeStep("fetchYoutubeCaptions", step, options);
+  };
+  proto.fetchYoutubeChannel = function(step, options) {
+    return this.executeStep("fetchYoutubeChannel", step, options);
+  };
+  proto.fetchYoutubeComments = function(step, options) {
+    return this.executeStep("fetchYoutubeComments", step, options);
+  };
+  proto.fetchYoutubeVideo = function(step, options) {
+    return this.executeStep("fetchYoutubeVideo", step, options);
+  };
+  proto.generateChart = function(step, options) {
+    return this.executeStep("generateChart", step, options);
+  };
+  proto.generateImage = function(step, options) {
+    return this.executeStep("generateImage", step, options);
+  };
+  proto.generateLipsync = function(step, options) {
+    return this.executeStep("generateLipsync", step, options);
+  };
+  proto.generateMusic = function(step, options) {
+    return this.executeStep("generateMusic", step, options);
+  };
+  proto.generateAsset = function(step, options) {
+    return this.executeStep("generatePdf", step, options);
+  };
+  proto.generateStaticVideoFromImage = function(step, options) {
+    return this.executeStep("generateStaticVideoFromImage", step, options);
+  };
+  proto.generateVideo = function(step, options) {
+    return this.executeStep("generateVideo", step, options);
+  };
+  proto.getGmailDraft = function(step, options) {
+    return this.executeStep("getGmailDraft", step, options);
+  };
+  proto.getGmailEmail = function(step, options) {
+    return this.executeStep("getGmailEmail", step, options);
+  };
+  proto.getGoogleCalendarEvent = function(step, options) {
+    return this.executeStep("getGoogleCalendarEvent", step, options);
+  };
+  proto.getGoogleDriveFile = function(step, options) {
+    return this.executeStep("getGoogleDriveFile", step, options);
+  };
+  proto.getGoogleSheetInfo = function(step, options) {
+    return this.executeStep("getGoogleSheetInfo", step, options);
+  };
+  proto.getMediaMetadata = function(step, options) {
+    return this.executeStep("getMediaMetadata", step, options);
+  };
+  proto.httpRequest = function(step, options) {
+    return this.executeStep("httpRequest", step, options);
+  };
+  proto.hubspotCreateCompany = function(step, options) {
+    return this.executeStep("hubspotCreateCompany", step, options);
+  };
+  proto.hubspotCreateContact = function(step, options) {
+    return this.executeStep("hubspotCreateContact", step, options);
+  };
+  proto.hubspotGetCompany = function(step, options) {
+    return this.executeStep("hubspotGetCompany", step, options);
+  };
+  proto.hubspotGetContact = function(step, options) {
+    return this.executeStep("hubspotGetContact", step, options);
+  };
+  proto.hunterApiCompanyEnrichment = function(step, options) {
+    return this.executeStep("hunterApiCompanyEnrichment", step, options);
+  };
+  proto.hunterApiDomainSearch = function(step, options) {
+    return this.executeStep("hunterApiDomainSearch", step, options);
+  };
+  proto.hunterApiEmailFinder = function(step, options) {
+    return this.executeStep("hunterApiEmailFinder", step, options);
+  };
+  proto.hunterApiEmailVerification = function(step, options) {
+    return this.executeStep("hunterApiEmailVerification", step, options);
+  };
+  proto.hunterApiPersonEnrichment = function(step, options) {
+    return this.executeStep("hunterApiPersonEnrichment", step, options);
+  };
+  proto.imageFaceSwap = function(step, options) {
+    return this.executeStep("imageFaceSwap", step, options);
+  };
+  proto.imageRemoveWatermark = function(step, options) {
+    return this.executeStep("imageRemoveWatermark", step, options);
+  };
+  proto.insertVideoClips = function(step, options) {
+    return this.executeStep("insertVideoClips", step, options);
+  };
+  proto.listDataSources = function(step, options) {
+    return this.executeStep("listDataSources", step, options);
+  };
+  proto.listGmailDrafts = function(step, options) {
+    return this.executeStep("listGmailDrafts", step, options);
+  };
+  proto.listGoogleCalendarEvents = function(step, options) {
+    return this.executeStep("listGoogleCalendarEvents", step, options);
+  };
+  proto.listGoogleDriveFiles = function(step, options) {
+    return this.executeStep("listGoogleDriveFiles", step, options);
+  };
+  proto.logic = function(step, options) {
+    return this.executeStep("logic", step, options);
+  };
+  proto.makeDotComRunScenario = function(step, options) {
+    return this.executeStep("makeDotComRunScenario", step, options);
+  };
+  proto.mergeAudio = function(step, options) {
+    return this.executeStep("mergeAudio", step, options);
+  };
+  proto.mergeVideos = function(step, options) {
+    return this.executeStep("mergeVideos", step, options);
+  };
+  proto.mixAudioIntoVideo = function(step, options) {
+    return this.executeStep("mixAudioIntoVideo", step, options);
+  };
+  proto.muteVideo = function(step, options) {
+    return this.executeStep("muteVideo", step, options);
+  };
+  proto.n8nRunNode = function(step, options) {
+    return this.executeStep("n8nRunNode", step, options);
+  };
+  proto.notionCreatePage = function(step, options) {
+    return this.executeStep("notionCreatePage", step, options);
+  };
+  proto.notionUpdatePage = function(step, options) {
+    return this.executeStep("notionUpdatePage", step, options);
+  };
+  proto.peopleSearch = function(step, options) {
+    return this.executeStep("peopleSearch", step, options);
+  };
+  proto.postToLinkedIn = function(step, options) {
+    return this.executeStep("postToLinkedIn", step, options);
+  };
+  proto.postToSlackChannel = function(step, options) {
+    return this.executeStep("postToSlackChannel", step, options);
+  };
+  proto.postToX = function(step, options) {
+    return this.executeStep("postToX", step, options);
+  };
+  proto.postToZapier = function(step, options) {
+    return this.executeStep("postToZapier", step, options);
+  };
+  proto.queryDataSource = function(step, options) {
+    return this.executeStep("queryDataSource", step, options);
+  };
+  proto.queryExternalDatabase = function(step, options) {
+    return this.executeStep("queryExternalDatabase", step, options);
+  };
+  proto.redactPII = function(step, options) {
+    return this.executeStep("redactPII", step, options);
+  };
+  proto.removeBackgroundFromImage = function(step, options) {
+    return this.executeStep("removeBackgroundFromImage", step, options);
+  };
+  proto.replyToGmailEmail = function(step, options) {
+    return this.executeStep("replyToGmailEmail", step, options);
+  };
+  proto.resizeVideo = function(step, options) {
+    return this.executeStep("resizeVideo", step, options);
+  };
+  proto.runPackagedWorkflow = function(step, options) {
+    return this.executeStep("runPackagedWorkflow", step, options);
+  };
+  proto.scrapeFacebookPage = function(step, options) {
+    return this.executeStep("scrapeFacebookPage", step, options);
+  };
+  proto.scrapeFacebookPosts = function(step, options) {
+    return this.executeStep("scrapeFacebookPosts", step, options);
+  };
+  proto.scrapeInstagramComments = function(step, options) {
+    return this.executeStep("scrapeInstagramComments", step, options);
+  };
+  proto.scrapeInstagramMentions = function(step, options) {
+    return this.executeStep("scrapeInstagramMentions", step, options);
+  };
+  proto.scrapeInstagramPosts = function(step, options) {
+    return this.executeStep("scrapeInstagramPosts", step, options);
+  };
+  proto.scrapeInstagramProfile = function(step, options) {
+    return this.executeStep("scrapeInstagramProfile", step, options);
+  };
+  proto.scrapeInstagramReels = function(step, options) {
+    return this.executeStep("scrapeInstagramReels", step, options);
+  };
+  proto.scrapeLinkedInCompany = function(step, options) {
+    return this.executeStep("scrapeLinkedInCompany", step, options);
+  };
+  proto.scrapeLinkedInProfile = function(step, options) {
+    return this.executeStep("scrapeLinkedInProfile", step, options);
+  };
+  proto.scrapeMetaThreadsProfile = function(step, options) {
+    return this.executeStep("scrapeMetaThreadsProfile", step, options);
+  };
+  proto.scrapeUrl = function(step, options) {
+    return this.executeStep("scrapeUrl", step, options);
+  };
+  proto.scrapeXPost = function(step, options) {
+    return this.executeStep("scrapeXPost", step, options);
+  };
+  proto.scrapeXProfile = function(step, options) {
+    return this.executeStep("scrapeXProfile", step, options);
+  };
+  proto.searchGoogle = function(step, options) {
+    return this.executeStep("searchGoogle", step, options);
+  };
+  proto.searchGoogleCalendarEvents = function(step, options) {
+    return this.executeStep("searchGoogleCalendarEvents", step, options);
+  };
+  proto.searchGoogleDrive = function(step, options) {
+    return this.executeStep("searchGoogleDrive", step, options);
+  };
+  proto.searchGoogleImages = function(step, options) {
+    return this.executeStep("searchGoogleImages", step, options);
+  };
+  proto.searchGoogleNews = function(step, options) {
+    return this.executeStep("searchGoogleNews", step, options);
+  };
+  proto.searchGoogleTrends = function(step, options) {
+    return this.executeStep("searchGoogleTrends", step, options);
+  };
+  proto.searchPerplexity = function(step, options) {
+    return this.executeStep("searchPerplexity", step, options);
+  };
+  proto.searchXPosts = function(step, options) {
+    return this.executeStep("searchXPosts", step, options);
+  };
+  proto.searchYoutube = function(step, options) {
+    return this.executeStep("searchYoutube", step, options);
+  };
+  proto.searchYoutubeTrends = function(step, options) {
+    return this.executeStep("searchYoutubeTrends", step, options);
+  };
+  proto.sendEmail = function(step, options) {
+    return this.executeStep("sendEmail", step, options);
+  };
+  proto.sendSMS = function(step, options) {
+    return this.executeStep("sendSMS", step, options);
+  };
+  proto.setRunTitle = function(step, options) {
+    return this.executeStep("setRunTitle", step, options);
+  };
+  proto.setVariable = function(step, options) {
+    return this.executeStep("setVariable", step, options);
+  };
+  proto.telegramSendAudio = function(step, options) {
+    return this.executeStep("telegramSendAudio", step, options);
+  };
+  proto.telegramSendFile = function(step, options) {
+    return this.executeStep("telegramSendFile", step, options);
+  };
+  proto.telegramSendImage = function(step, options) {
+    return this.executeStep("telegramSendImage", step, options);
+  };
+  proto.telegramSendMessage = function(step, options) {
+    return this.executeStep("telegramSendMessage", step, options);
+  };
+  proto.telegramSendVideo = function(step, options) {
+    return this.executeStep("telegramSendVideo", step, options);
+  };
+  proto.telegramSetTyping = function(step, options) {
+    return this.executeStep("telegramSetTyping", step, options);
+  };
+  proto.textToSpeech = function(step, options) {
+    return this.executeStep("textToSpeech", step, options);
+  };
+  proto.transcribeAudio = function(step, options) {
+    return this.executeStep("transcribeAudio", step, options);
+  };
+  proto.trimMedia = function(step, options) {
+    return this.executeStep("trimMedia", step, options);
+  };
+  proto.updateGoogleCalendarEvent = function(step, options) {
+    return this.executeStep("updateGoogleCalendarEvent", step, options);
+  };
+  proto.updateGoogleDoc = function(step, options) {
+    return this.executeStep("updateGoogleDoc", step, options);
+  };
+  proto.updateGoogleSheet = function(step, options) {
+    return this.executeStep("updateGoogleSheet", step, options);
+  };
+  proto.uploadDataSourceDocument = function(step, options) {
+    return this.executeStep("uploadDataSourceDocument", step, options);
+  };
+  proto.upscaleImage = function(step, options) {
+    return this.executeStep("upscaleImage", step, options);
+  };
+  proto.upscaleVideo = function(step, options) {
+    return this.executeStep("upscaleVideo", step, options);
+  };
+  proto.generateText = function(step, options) {
+    return this.executeStep("userMessage", step, options);
+  };
+  proto.videoFaceSwap = function(step, options) {
+    return this.executeStep("videoFaceSwap", step, options);
+  };
+  proto.videoRemoveBackground = function(step, options) {
+    return this.executeStep("videoRemoveBackground", step, options);
+  };
+  proto.videoRemoveWatermark = function(step, options) {
+    return this.executeStep("videoRemoveWatermark", step, options);
+  };
+  proto.watermarkImage = function(step, options) {
+    return this.executeStep("watermarkImage", step, options);
+  };
+  proto.watermarkVideo = function(step, options) {
+    return this.executeStep("watermarkVideo", step, options);
+  };
+}
+var init_steps = __esm({
+  "src/generated/steps.ts"() {
+    "use strict";
+  }
+});
+
+// src/generated/helpers.ts
+var helpers_exports = {};
+__export(helpers_exports, {
+  applyHelperMethods: () => applyHelperMethods
+});
+function applyHelperMethods(AgentClass) {
+  const proto = AgentClass.prototype;
+  proto.listModels = function() {
+    return this._request("GET", "/helpers/models").then((r) => r.data);
+  };
+  proto.listModelsByType = function(modelType) {
+    return this._request("GET", `/helpers/models/${modelType}`).then((r) => r.data);
+  };
+  proto.listConnectors = function() {
+    return this._request("GET", "/helpers/connectors").then((r) => r.data);
+  };
+  proto.getConnector = function(serviceId) {
+    return this._request("GET", `/helpers/connectors/${serviceId}`).then((r) => r.data);
+  };
+}
+var init_helpers = __esm({
+  "src/generated/helpers.ts"() {
+    "use strict";
+  }
+});
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  MindStudioAgent: () => MindStudioAgent
+});
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function resolveToken(provided) {
+  if (provided) return { token: provided, authType: "apiKey" };
+  if (process.env.MINDSTUDIO_API_KEY)
+    return { token: process.env.MINDSTUDIO_API_KEY, authType: "apiKey" };
+  if (process.env.CALLBACK_TOKEN)
+    return { token: process.env.CALLBACK_TOKEN, authType: "internal" };
+  throw new MindStudioError(
+    "No API key provided. Pass `apiKey` to the MindStudioAgent constructor, or set the MINDSTUDIO_API_KEY environment variable.",
+    "missing_api_key",
+    401
+  );
+}
+var DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, MindStudioAgent;
+var init_client = __esm({
+  "src/client.ts"() {
+    "use strict";
+    init_http();
+    init_errors();
+    init_rate_limit();
+    init_steps();
+    init_helpers();
+    DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
+    DEFAULT_MAX_RETRIES = 3;
+    MindStudioAgent = class {
+      /** @internal */
+      _httpConfig;
+      /** @internal */
+      _reuseThreadId;
+      /** @internal */
+      _threadId;
+      constructor(options = {}) {
+        const { token, authType } = resolveToken(options.apiKey);
+        const baseUrl = options.baseUrl ?? process.env.MINDSTUDIO_BASE_URL ?? process.env.REMOTE_HOSTNAME ?? DEFAULT_BASE_URL;
+        this._reuseThreadId = options.reuseThreadId ?? /^(true|1)$/i.test(process.env.MINDSTUDIO_REUSE_THREAD_ID ?? "");
+        this._httpConfig = {
+          baseUrl,
+          token,
+          rateLimiter: new RateLimiter(authType),
+          maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES
+        };
+      }
+      /**
+       * Execute any step by its type name. This is the low-level method that all
+       * typed step methods delegate to. Use it as an escape hatch for step types
+       * not yet covered by the generated methods.
+       *
+       * ```ts
+       * const result = await agent.executeStep("generateImage", { prompt: "hello", mode: "background" });
+       * ```
+       */
+      async executeStep(stepType, step, options) {
+        const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
+        const { data, headers } = await request(this._httpConfig, "POST", `/steps/${stepType}/execute`, {
+          step,
+          ...options?.appId != null && { appId: options.appId },
+          ...threadId != null && { threadId }
+        });
+        let output;
+        if (data.output != null) {
+          output = data.output;
+        } else if (data.outputUrl) {
+          const res = await fetch(data.outputUrl);
+          if (!res.ok) {
+            throw new MindStudioError(
+              `Failed to fetch output from S3: ${res.status} ${res.statusText}`,
+              "output_fetch_error",
+              res.status
+            );
+          }
+          const envelope = await res.json();
+          output = envelope.value;
+        } else {
+          output = void 0;
+        }
+        const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
+        if (this._reuseThreadId && returnedThreadId) {
+          this._threadId = returnedThreadId;
+        }
+        const remaining = headers.get("x-ratelimit-remaining");
+        const billingCost = headers.get("x-mindstudio-billing-cost");
+        const billingEvents = headers.get("x-mindstudio-billing-events");
+        return {
+          ...output,
+          $appId: headers.get("x-mindstudio-app-id") ?? "",
+          $threadId: returnedThreadId,
+          $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
+          $billingCost: billingCost != null ? parseFloat(billingCost) : void 0,
+          $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
+        };
+      }
+      /**
+       * List all pre-built agents in the organization.
+       *
+       * ```ts
+       * const { apps } = await agent.listAgents();
+       * for (const app of apps) console.log(app.name, app.id);
+       * ```
+       */
+      async listAgents() {
+        const { data } = await request(
+          this._httpConfig,
+          "GET",
+          "/agents/load"
+        );
+        return data;
+      }
+      /**
+       * Run a pre-built agent and wait for the result.
+       *
+       * Uses async polling internally — the request returns immediately with a
+       * callback token, then polls until the run completes or fails.
+       *
+       * ```ts
+       * const result = await agent.runAgent({
+       *   appId: 'your-agent-id',
+       *   variables: { query: 'hello' },
+       * });
+       * console.log(result.result);
+       * ```
+       */
+      async runAgent(options) {
+        const pollInterval = options.pollIntervalMs ?? 1e3;
+        const { data } = await request(this._httpConfig, "POST", "/agents/run", {
+          appId: options.appId,
+          async: true,
+          ...options.variables != null && { variables: options.variables },
+          ...options.workflow != null && { workflow: options.workflow },
+          ...options.version != null && { version: options.version },
+          ...options.includeBillingCost != null && {
+            includeBillingCost: options.includeBillingCost
+          },
+          ...options.metadata != null && { metadata: options.metadata }
+        });
+        const token = data.callbackToken;
+        const pollUrl = `${this._httpConfig.baseUrl}/developer/v2/agents/run/poll/${token}`;
+        while (true) {
+          await sleep2(pollInterval);
+          const res = await fetch(pollUrl, {
+            headers: { "User-Agent": "@mindstudio-ai/agent" }
+          });
+          if (res.status === 404) {
+            throw new MindStudioError(
+              "Poll token not found or expired.",
+              "poll_token_expired",
+              404
+            );
+          }
+          if (!res.ok) {
+            throw new MindStudioError(
+              `Poll request failed: ${res.status} ${res.statusText}`,
+              "poll_error",
+              res.status
+            );
+          }
+          const poll = await res.json();
+          if (poll.status === "pending") continue;
+          if (poll.status === "error") {
+            throw new MindStudioError(
+              poll.error ?? "Agent run failed.",
+              "agent_run_error",
+              500
+            );
+          }
+          return poll.result;
+        }
+      }
+      /** @internal Used by generated helper methods. */
+      _request(method, path, body) {
+        return request(this._httpConfig, method, path, body);
+      }
+    };
+    applyStepMethods(MindStudioAgent);
+    applyHelperMethods(MindStudioAgent);
+  }
+});
+
+// src/mcp.ts
+var mcp_exports = {};
+__export(mcp_exports, {
+  startMcpServer: () => startMcpServer
+});
+import { createInterface } from "readline";
+function send(message) {
+  process.stdout.write(JSON.stringify(message) + "\n");
+}
+function sendResult(id, result) {
+  send({ jsonrpc: "2.0", id, result });
+}
+function sendError(id, code, message) {
+  send({ jsonrpc: "2.0", id: id ?? null, error: { code, message } });
+}
+async function startMcpServer(options) {
+  let agent = null;
+  let metadata = null;
+  let tools = null;
+  async function getMetadata() {
+    if (!metadata) {
+      const mod = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
+      metadata = mod.stepMetadata;
+    }
+    return metadata;
+  }
+  function getAgent() {
+    if (!agent) {
+      agent = new MindStudioAgent({
+        apiKey: options?.apiKey,
+        baseUrl: options?.baseUrl,
+        reuseThreadId: true
+      });
+    }
+    return agent;
+  }
+  async function buildTools() {
+    if (tools) return tools;
+    const meta = await getMetadata();
+    const stepTools = Object.entries(meta).map(
+      ([name, step]) => ({
+        name,
+        description: step.description + (step.usageNotes ? "\n\n" + step.usageNotes : ""),
+        inputSchema: step.inputSchema
+      })
+    );
+    tools = [...stepTools, ...HELPER_TOOLS];
+    return tools;
+  }
+  async function handleMessage(msg) {
+    const { id, method, params } = msg;
+    switch (method) {
+      case "initialize":
+        sendResult(id, {
+          protocolVersion: MCP_PROTOCOL_VERSION,
+          capabilities: { tools: {} },
+          serverInfo: {
+            name: "mindstudio-agent",
+            version: "0.0.16"
+          }
+        });
+        break;
+      case "notifications/initialized":
+        break;
+      case "tools/list":
+        sendResult(id, { tools: await buildTools() });
+        break;
+      case "tools/call": {
+        const toolName = params.name;
+        const args = params.arguments ?? {};
+        try {
+          let result;
+          if (toolName === "listModels") {
+            result = await getAgent().listModels();
+          } else if (toolName === "listModelsByType") {
+            result = await getAgent().listModelsByType(
+              args.modelType
+            );
+          } else if (toolName === "listConnectors") {
+            result = await getAgent().listConnectors();
+          } else if (toolName === "getConnector") {
+            result = await getAgent().getConnector(
+              args.serviceId
+            );
+          } else if (toolName === "listAgents") {
+            result = await getAgent().listAgents();
+          } else if (toolName === "runAgent") {
+            result = await getAgent().runAgent({
+              appId: args.appId,
+              variables: args.variables,
+              workflow: args.workflow,
+              version: args.version
+            });
+          } else {
+            const meta = await getMetadata();
+            const step = meta[toolName];
+            if (!step) {
+              sendError(id, -32602, `Unknown tool: ${toolName}`);
+              return;
+            }
+            result = await getAgent().executeStep(
+              step.stepType,
+              args
+            );
+          }
+          sendResult(id, {
+            content: [
+              { type: "text", text: JSON.stringify(result, null, 2) }
+            ]
+          });
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          sendResult(id, {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+          });
+        }
+        break;
+      }
+      default:
+        if (id !== void 0) {
+          sendError(id, -32601, `Method not found: ${method}`);
+        }
+        break;
+    }
+  }
+  console.log = console.warn;
+  const rl = createInterface({ input: process.stdin, terminal: false });
+  for await (const line of rl) {
+    if (!line.trim()) continue;
+    try {
+      const msg = JSON.parse(line);
+      await handleMessage(msg);
+    } catch {
+      sendError(void 0, -32700, "Parse error");
+    }
+  }
+}
+var MCP_PROTOCOL_VERSION, HELPER_TOOLS;
+var init_mcp = __esm({
+  "src/mcp.ts"() {
+    "use strict";
+    init_client();
+    MCP_PROTOCOL_VERSION = "2024-11-05";
+    HELPER_TOOLS = [
+      {
+        name: "listModels",
+        description: "List all available AI models across all categories.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "listModelsByType",
+        description: "List AI models filtered by type.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            modelType: {
+              type: "string",
+              enum: [
+                "llm_chat",
+                "image_generation",
+                "video_generation",
+                "video_analysis",
+                "text_to_speech",
+                "vision",
+                "transcription"
+              ]
+            }
+          },
+          required: ["modelType"]
+        }
+      },
+      {
+        name: "listConnectors",
+        description: "List available connector services (Slack, Google, HubSpot, etc.).",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "getConnector",
+        description: "Get details for a single connector service by ID.",
+        inputSchema: {
+          type: "object",
+          properties: { serviceId: { type: "string" } },
+          required: ["serviceId"]
+        }
+      },
+      {
+        name: "listAgents",
+        description: "List all pre-built agents in the organization along with org metadata.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "runAgent",
+        description: "Run a pre-built agent and wait for the result. Uses async polling internally.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            appId: {
+              type: "string",
+              description: "The agent/app ID to run."
+            },
+            variables: {
+              type: "object",
+              description: "Input variables as key-value pairs.",
+              additionalProperties: true
+            },
+            workflow: {
+              type: "string",
+              description: "Workflow name to execute. Omit for the app default."
+            },
+            version: {
+              type: "string",
+              description: 'App version override (e.g. "draft"). Defaults to "live".'
+            }
+          },
+          required: ["appId"]
+        }
+      }
+    ];
+  }
+});
+
+// src/cli.ts
+import { parseArgs } from "util";
+var HELP = `Usage: mindstudio <command | method> [options]
+
+Commands:
+  <method> [json | --flags]   Execute a step method (shorthand for exec)
+  exec <method> [json | --flags]   Execute a step method
+  list [--json]               List available methods
+  info <method>               Show method details (params, types, output)
+  agents [--json]             List pre-built agents in your organization
+  run <appId> [json | --flags]  Run a pre-built agent and wait for result
+  mcp                         Start MCP server (JSON-RPC over stdio)
+
+Options:
+  --api-key <key>          API key (or set MINDSTUDIO_API_KEY env)
+  --base-url <url>         API base URL
+  --app-id <id>            App ID for thread context
+  --thread-id <id>         Thread ID for state persistence
+  --output-key <key>       Extract a single field from the result
+  --no-meta                Strip $-prefixed metadata from output
+  --workflow <name>        Workflow to execute (run command)
+  --version <ver>          App version override, e.g. "draft" (run command)
+  --json                   Output as JSON (list/agents only)
+  --help                   Show this help
+
+Examples:
+  mindstudio generate-image --prompt "a sunset"
+  mindstudio generate-image --prompt "a sunset" --output-key imageUrl
+  mindstudio generate-text --message "hello" --no-meta
+  mindstudio generate-image '{"prompt":"a sunset"}'
+  echo '{"query":"test"}' | mindstudio search-google
+  mindstudio info generate-image
+  mindstudio list --json
+  mindstudio agents
+  mindstudio run <appId> --query "hello"
+  mindstudio mcp
+`;
+function camelToKebab(s) {
+  return s.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+}
+function kebabToCamel(s) {
+  return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function parseJson5(input) {
+  let s = input;
+  s = s.replace(/\/\/.*$/gm, "");
+  s = s.replace(/\/\*[\s\S]*?\*\//g, "");
+  s = s.replace(/([{,]\s*)([a-zA-Z_$][a-zA-Z0-9_$]*)\s*:/g, '$1"$2":');
+  s = s.replace(/'([^'\\]*(?:\\.[^'\\]*)*)'/g, '"$1"');
+  s = s.replace(/,(\s*[}\]])/g, "$1");
+  return JSON.parse(s);
+}
+function coerce(value) {
+  if (typeof value !== "string") return value;
+  if (value === "true") return true;
+  if (value === "false") return false;
+  if (value !== "" && !isNaN(Number(value))) return Number(value);
+  if (value.startsWith("{") && value.endsWith("}") || value.startsWith("[") && value.endsWith("]")) {
+    try {
+      return JSON.parse(value);
+    } catch {
+    }
+  }
+  return value;
+}
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from(
+    { length: m + 1 },
+    () => Array(n + 1).fill(0)
+  );
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function printHelp() {
+  process.stderr.write(HELP);
+}
+function fatal(message) {
+  process.stderr.write(JSON.stringify({ error: { message } }) + "\n");
+  process.exit(1);
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8").trim();
+}
+var HELPER_NAMES = /* @__PURE__ */ new Set([
+  "listModels",
+  "listModelsByType",
+  "listConnectors",
+  "getConnector"
+]);
+function resolveMethodOrFail(name, metadataKeys) {
+  if (metadataKeys.has(name)) return name;
+  const camel = kebabToCamel(name);
+  if (metadataKeys.has(camel)) return camel;
+  const kebab = name.includes("-") ? name : camelToKebab(name);
+  let bestDist = Infinity;
+  let bestMatch = "";
+  for (const key of metadataKeys) {
+    const d = levenshtein(kebab, camelToKebab(key));
+    if (d < bestDist) {
+      bestDist = d;
+      bestMatch = camelToKebab(key);
+    }
+  }
+  const suggestion = bestDist <= 3 ? ` Did you mean '${bestMatch}'?` : "";
+  fatal(
+    `Unknown method: ${name}.${suggestion} Run 'mindstudio list' to see available methods.`
+  );
+}
+async function getAllMethodKeys() {
+  const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
+  return /* @__PURE__ */ new Set([...Object.keys(stepMetadata2), ...HELPER_NAMES]);
+}
+async function cmdList(asJson) {
+  const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
+  if (asJson) {
+    const entries = Object.entries(stepMetadata2).map(([name, meta]) => ({
+      method: camelToKebab(name),
+      description: meta.description,
+      stepType: meta.stepType,
+      inputSchema: meta.inputSchema,
+      outputSchema: meta.outputSchema
+    }));
+    process.stdout.write(JSON.stringify(entries, null, 2) + "\n");
+  } else {
+    const entries = Object.entries(stepMetadata2);
+    const kebabEntries = entries.map(
+      ([name, meta]) => [camelToKebab(name), meta]
+    );
+    const maxLen = Math.min(
+      35,
+      kebabEntries.reduce((m, [k]) => Math.max(m, k.length), 0)
+    );
+    for (const [name, meta] of kebabEntries) {
+      const desc = meta.description || "(no description)";
+      process.stdout.write(`${name.padEnd(maxLen)}  ${desc}
+`);
+    }
+  }
+}
+async function cmdInfo(rawMethod) {
+  const allKeys = await getAllMethodKeys();
+  const method = resolveMethodOrFail(rawMethod, allKeys);
+  if (HELPER_NAMES.has(method)) {
+    const helpers = {
+      listModels: { desc: "List all available AI models.", input: "(none)", output: "{ models: MindStudioModel[] }" },
+      listModelsByType: { desc: "List AI models filtered by type.", input: "modelType: string (required)", output: "{ models: MindStudioModel[] }" },
+      listConnectors: { desc: "List available connector services.", input: "(none)", output: "{ services: Array }" },
+      getConnector: { desc: "Get details for a connector service.", input: "serviceId: string (required)", output: "{ service: object }" }
+    };
+    const h = helpers[method];
+    process.stderr.write(`
+  ${camelToKebab(method)}
+
+`);
+    process.stderr.write(`  ${h.desc}
+
+`);
+    process.stderr.write(`  Input:  ${h.input}
+`);
+    process.stderr.write(`  Output: ${h.output}
+
+`);
+    return;
+  }
+  const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
+  const meta = stepMetadata2[method];
+  const out = [];
+  out.push("");
+  out.push(`  ${camelToKebab(method)}`);
+  out.push("");
+  if (meta.description) out.push(`  ${meta.description}`);
+  if (meta.usageNotes) {
+    out.push("");
+    for (const line of meta.usageNotes.split("\n")) {
+      const trimmed = line.trim();
+      if (trimmed) out.push(`  ${trimmed}`);
+    }
+  }
+  const schema = meta.inputSchema;
+  const props = schema.properties ?? {};
+  const required = new Set(schema.required ?? []);
+  if (Object.keys(props).length > 0) {
+    out.push("");
+    out.push("  Parameters:");
+    for (const [key, prop] of Object.entries(props)) {
+      const req = required.has(key) ? " (required)" : "";
+      const type = formatPropType(prop);
+      const desc = prop.description ? `  ${prop.description}` : "";
+      out.push(`    --${camelToKebab(key)}  ${type}${req}${desc}`);
+    }
+  }
+  const outSchema = meta.outputSchema;
+  if (outSchema?.properties) {
+    out.push("");
+    out.push("  Output keys:");
+    const outRequired = new Set(outSchema.required ?? []);
+    for (const [key, prop] of Object.entries(outSchema.properties)) {
+      const type = formatPropType(prop);
+      const opt = outRequired.has(key) ? "" : " (optional)";
+      out.push(`    ${key}  ${type}${opt}`);
+    }
+  }
+  out.push("");
+  process.stderr.write(out.join("\n") + "\n");
+}
+function formatPropType(prop) {
+  if (prop.enum) return prop.enum.map((v) => JSON.stringify(v)).join(" | ");
+  if (prop.type === "array") return "array";
+  if (prop.type === "object") return "object";
+  if (typeof prop.type === "string") return prop.type === "integer" ? "number" : prop.type;
+  return "string";
+}
+async function cmdExec(method, input, options) {
+  const { MindStudioAgent: MindStudioAgent2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+  await Promise.resolve().then(() => (init_steps(), steps_exports)).then(
+    (m) => m.applyStepMethods(MindStudioAgent2)
+  );
+  await Promise.resolve().then(() => (init_helpers(), helpers_exports)).then(
+    (m) => m.applyHelperMethods(MindStudioAgent2)
+  );
+  const agent = new MindStudioAgent2({
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl
+  });
+  let result;
+  if (method === "listModels") {
+    result = await agent.listModels();
+  } else if (method === "listModelsByType") {
+    result = await agent.listModelsByType(input.modelType);
+  } else if (method === "listConnectors") {
+    result = await agent.listConnectors();
+  } else if (method === "getConnector") {
+    result = await agent.getConnector(input.serviceId);
+  } else {
+    const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
+    const meta = stepMetadata2[method];
+    if (!meta) {
+      fatal(
+        `Unknown method: ${method}. Run 'mindstudio list' to see available methods.`
+      );
+    }
+    result = await agent.executeStep(meta.stepType, input, {
+      appId: options.appId,
+      threadId: options.threadId
+    });
+  }
+  if (options.outputKey) {
+    const val = result[options.outputKey];
+    if (typeof val === "string") {
+      process.stdout.write(val + "\n");
+    } else {
+      process.stdout.write(JSON.stringify(val, null, 2) + "\n");
+    }
+  } else if (options.noMeta) {
+    const filtered = {};
+    for (const [k, v] of Object.entries(result)) {
+      if (!k.startsWith("$")) filtered[k] = v;
+    }
+    process.stdout.write(JSON.stringify(filtered, null, 2) + "\n");
+  } else {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+  }
+}
+async function cmdAgents(asJson, options) {
+  const { MindStudioAgent: MindStudioAgent2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+  const agent = new MindStudioAgent2({
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl
+  });
+  const result = await agent.listAgents();
+  if (asJson) {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+  } else {
+    process.stderr.write(`
+  ${result.orgName} (${result.orgId})
+
+`);
+    if (result.apps.length === 0) {
+      process.stderr.write("  No agents found.\n\n");
+      return;
+    }
+    const maxLen = Math.min(
+      35,
+      result.apps.reduce((m, a) => Math.max(m, a.name.length), 0)
+    );
+    for (const app of result.apps) {
+      const desc = app.description || "(no description)";
+      process.stdout.write(
+        `${app.name.padEnd(maxLen)}  ${app.id}  ${desc}
+`
+      );
+    }
+  }
+}
+async function cmdRun(appId, variables, options) {
+  const { MindStudioAgent: MindStudioAgent2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+  const agent = new MindStudioAgent2({
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl
+  });
+  const result = await agent.runAgent({
+    appId,
+    variables: Object.keys(variables).length > 0 ? variables : void 0,
+    workflow: options.workflow,
+    version: options.version
+  });
+  const obj = result;
+  if (options.outputKey) {
+    const val = obj[options.outputKey];
+    if (typeof val === "string") {
+      process.stdout.write(val + "\n");
+    } else {
+      process.stdout.write(JSON.stringify(val, null, 2) + "\n");
+    }
+  } else if (options.noMeta) {
+    const filtered = {};
+    for (const [k, v] of Object.entries(obj)) {
+      if (!k.startsWith("$")) filtered[k] = v;
+    }
+    process.stdout.write(JSON.stringify(filtered, null, 2) + "\n");
+  } else {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+  }
+}
+function parseStepFlags(argv) {
+  const result = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--") && i + 1 < argv.length) {
+      const key = arg.slice(2);
+      result[kebabToCamel(key)] = coerce(argv[++i]);
+    }
+  }
+  return result;
+}
+var GLOBAL_STRING_FLAGS = /* @__PURE__ */ new Set([
+  "--api-key",
+  "--base-url",
+  "--app-id",
+  "--thread-id",
+  "--output-key",
+  "--workflow",
+  "--version"
+]);
+function findMethodSplit(argv) {
+  let startIdx = 0;
+  let hasExec = false;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      if (GLOBAL_STRING_FLAGS.has(arg)) i++;
+      continue;
+    }
+    if (arg === "exec") {
+      hasExec = true;
+      startIdx = i + 1;
+    } else {
+      startIdx = i;
+    }
+    break;
+  }
+  for (let i = startIdx; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      if (GLOBAL_STRING_FLAGS.has(arg)) i++;
+      continue;
+    }
+    if (hasExec || i === startIdx) {
+      return { rawMethod: arg, stepArgv: argv.slice(i + 1) };
+    }
+    break;
+  }
+  return null;
+}
+async function main() {
+  const { values, positionals } = parseArgs({
+    args: process.argv.slice(2),
+    allowPositionals: true,
+    strict: false,
+    options: {
+      "api-key": { type: "string" },
+      "base-url": { type: "string" },
+      "app-id": { type: "string" },
+      "thread-id": { type: "string" },
+      "output-key": { type: "string" },
+      "no-meta": { type: "boolean", default: false },
+      workflow: { type: "string" },
+      version: { type: "string" },
+      json: { type: "boolean", default: false },
+      help: { type: "boolean", default: false }
+    }
+  });
+  if (values.help || positionals.length === 0) {
+    printHelp();
+    process.exit(positionals.length === 0 ? 1 : 0);
+  }
+  const command = positionals[0];
+  try {
+    if (command === "list") {
+      await cmdList(values.json);
+      return;
+    }
+    if (command === "agents") {
+      await cmdAgents(values.json, {
+        apiKey: values["api-key"],
+        baseUrl: values["base-url"]
+      });
+      return;
+    }
+    if (command === "run") {
+      const appId = positionals[1];
+      if (!appId)
+        fatal("Missing app ID. Usage: mindstudio run <appId> [json | --flags]");
+      const runArgv = process.argv.slice(
+        process.argv.indexOf("run") + 2
+      );
+      const stepArgs = [];
+      for (let i = 0; i < runArgv.length; i++) {
+        const arg = runArgv[i];
+        if (GLOBAL_STRING_FLAGS.has(arg) || arg === "--workflow" || arg === "--version") {
+          i++;
+        } else if (arg === "--no-meta" || arg === "--json" || arg === "--help") {
+        } else if (arg === appId) {
+        } else {
+          stepArgs.push(arg);
+        }
+      }
+      let variables;
+      const firstArg = stepArgs[0];
+      if (firstArg && firstArg.startsWith("{")) {
+        try {
+          variables = parseJson5(firstArg);
+        } catch {
+          fatal(`Invalid JSON input: ${firstArg}`);
+        }
+      } else {
+        const flagInput = parseStepFlags(stepArgs);
+        if (Object.keys(flagInput).length > 0) {
+          variables = flagInput;
+        } else if (!process.stdin.isTTY) {
+          const raw = await readStdin();
+          try {
+            variables = parseJson5(raw);
+          } catch {
+            fatal(`Invalid JSON on stdin: ${raw}`);
+          }
+        } else {
+          variables = {};
+        }
+      }
+      await cmdRun(appId, variables, {
+        apiKey: values["api-key"],
+        baseUrl: values["base-url"],
+        workflow: values.workflow,
+        version: values.version,
+        outputKey: values["output-key"],
+        noMeta: values["no-meta"]
+      });
+      return;
+    }
+    if (command === "mcp") {
+      const { startMcpServer: startMcpServer2 } = await Promise.resolve().then(() => (init_mcp(), mcp_exports));
+      await startMcpServer2({
+        apiKey: values["api-key"],
+        baseUrl: values["base-url"]
+      });
+      return;
+    }
+    if (command === "info") {
+      const rawMethod2 = positionals[1];
+      if (!rawMethod2)
+        fatal("Missing method name. Usage: mindstudio info <method>");
+      await cmdInfo(rawMethod2);
+      return;
+    }
+    const split = findMethodSplit(process.argv.slice(2));
+    if (!split)
+      fatal(
+        "Missing method name. Usage: mindstudio <method> [json | --flags]"
+      );
+    const { rawMethod, stepArgv } = split;
+    const allKeys = await getAllMethodKeys();
+    const method = resolveMethodOrFail(rawMethod, allKeys);
+    let input;
+    const firstStepArg = stepArgv[0];
+    if (firstStepArg && firstStepArg.startsWith("{")) {
+      try {
+        input = parseJson5(firstStepArg);
+      } catch {
+        fatal(`Invalid JSON input: ${firstStepArg}`);
+      }
+    } else {
+      const flagInput = parseStepFlags(stepArgv);
+      if (Object.keys(flagInput).length > 0) {
+        input = flagInput;
+      } else if (!process.stdin.isTTY) {
+        const raw = await readStdin();
+        try {
+          input = parseJson5(raw);
+        } catch {
+          fatal(`Invalid JSON on stdin: ${raw}`);
+        }
+      } else {
+        input = {};
+      }
+    }
+    await cmdExec(method, input, {
+      apiKey: values["api-key"],
+      baseUrl: values["base-url"],
+      appId: values["app-id"],
+      threadId: values["thread-id"],
+      outputKey: values["output-key"],
+      noMeta: values["no-meta"]
+    });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    fatal(message);
+  }
+}
+main();