@mindstudio-ai/agent 0.0.10 → 0.0.11

package/dist/index.d.ts

@@ -3235,1016 +3235,1647 @@ interface StepOutputMap {
 
 interface StepMethods {
     /**
-     * [ActiveCampaign] Add Note
-     *
      * Add a note to an existing contact in ActiveCampaign.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires an ActiveCampaign OAuth connection (connectionId).
      * - The contact must already exist — use the contact ID from a previous create or search step.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.activeCampaignAddNote({
+     *   contactId: ``,
+     *   note: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     activeCampaignAddNote(step: ActiveCampaignAddNoteStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ActiveCampaignAddNoteStepOutput>>;
     /**
-     * [ActiveCampaign] Create Contact
-     *
      * Create or sync a contact in ActiveCampaign.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires an ActiveCampaign OAuth connection (connectionId).
      * - If a contact with the email already exists, it may be updated depending on ActiveCampaign settings.
      * - Custom fields are passed as a key-value map where keys are field IDs.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.activeCampaignCreateContact({
+     *   email: ``,
+     *   firstName: ``,
+     *   lastName: ``,
+     *   phone: ``,
+     *   accountId: ``,
+     *   customFields: {},
+     *   connectionId: ``,
+     * });
+     * ```
      */
     activeCampaignCreateContact(step: ActiveCampaignCreateContactStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ActiveCampaignCreateContactStepOutput>>;
     /**
-     * Add Subtitles To Video
-     *
      * Automatically add subtitles to a video
      *
-     * ## Usage Notes
+     * @remarks
      * - Can control style of text and animation
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.addSubtitlesToVideo({
+     *   videoUrl: ``,
+     *   language: ``,
+     *   fontName: ``,
+     *   fontSize: 0,
+     *   fontWeight: "normal",
+     *   fontColor: "white",
+     *   highlightColor: "white",
+     *   strokeWidth: 0,
+     *   strokeColor: "black",
+     *   backgroundColor: "black",
+     *   backgroundOpacity: 0,
+     *   position: "top",
+     *   yOffset: 0,
+     *   wordsPerSubtitle: 0,
+     *   enableAnimation: false,
+     * });
+     * ```
      */
     addSubtitlesToVideo(step: AddSubtitlesToVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AddSubtitlesToVideoStepOutput>>;
     /**
-     * [Airtable] Create/Update record
-     *
      * Create a new record or update an existing record in an Airtable table.
      *
-     * ## Usage Notes
+     * @remarks
      * - If recordId is provided, updates that record. Otherwise, creates a new one.
      * - When updating with updateMode "onlySpecified", unspecified fields are left as-is. With "all", unspecified fields are cleared.
      * - Array fields (e.g. multipleAttachments) accept arrays of values.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.airtableCreateUpdateRecord({
+     *   connectionId: ``,
+     *   baseId: ``,
+     *   tableId: ``,
+     *   fields: ``,
+     *   recordData: {},
+     * });
+     * ```
      */
     airtableCreateUpdateRecord(step: AirtableCreateUpdateRecordStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AirtableCreateUpdateRecordStepOutput>>;
     /**
-     * [Airtable] Delete record
-     *
      * Delete a record from an Airtable table by its record ID.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires an active Airtable OAuth connection (connectionId).
      * - Silently succeeds if the record does not exist.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.airtableDeleteRecord({
+     *   connectionId: ``,
+     *   baseId: ``,
+     *   tableId: ``,
+     *   recordId: ``,
+     * });
+     * ```
      */
     airtableDeleteRecord(step: AirtableDeleteRecordStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AirtableDeleteRecordStepOutput>>;
     /**
-     * [Airtable] Get record
-     *
      * Fetch a single record from an Airtable table by its record ID.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires an active Airtable OAuth connection (connectionId).
      * - If the record is not found, returns a string message instead of a record object.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.airtableGetRecord({
+     *   connectionId: ``,
+     *   baseId: ``,
+     *   tableId: ``,
+     *   recordId: ``,
+     * });
+     * ```
      */
     airtableGetRecord(step: AirtableGetRecordStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AirtableGetRecordStepOutput>>;
     /**
-     * [Airtable] Get table records
-     *
      * Fetch multiple records from an Airtable table with optional pagination.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires an active Airtable OAuth connection (connectionId).
      * - Default limit is 100 records. Maximum is 1000.
      * - When outputFormat is 'csv', the variable receives CSV text. The direct execution output always returns parsed records.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.airtableGetTableRecords({
+     *   connectionId: ``,
+     *   baseId: ``,
+     *   tableId: ``,
+     * });
+     * ```
      */
     airtableGetTableRecords(step: AirtableGetTableRecordsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AirtableGetTableRecordsStepOutput>>;
     /**
-     * Analyze Image
-     *
      * Analyze an image using a vision model based on a text prompt.
      *
-     * ## Usage Notes
+     * @remarks
      * - Uses the configured vision model to generate a text analysis of the image.
      * - The prompt should describe what to look for or extract from the image.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.analyzeImage({
+     *   prompt: ``,
+     *   imageUrl: ``,
+     * });
+     * ```
      */
     analyzeImage(step: AnalyzeImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AnalyzeImageStepOutput>>;
     /**
-     * Analyze Video
-     *
      * Analyze a video using a video analysis model based on a text prompt.
      *
-     * ## Usage Notes
+     * @remarks
      * - Uses the configured video analysis model to generate a text analysis of the video.
      * - The prompt should describe what to look for or extract from the video.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.analyzeVideo({
+     *   prompt: ``,
+     *   videoUrl: ``,
+     * });
+     * ```
      */
     analyzeVideo(step: AnalyzeVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<AnalyzeVideoStepOutput>>;
     /**
-     * Get Image from Video Frame
-     *
      * Capture a thumbnail from a video at a specified timestamp
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.captureThumbnail({
+     *   videoUrl: ``,
+     *   at: ``,
+     * });
+     * ```
      */
     captureThumbnail(step: CaptureThumbnailStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CaptureThumbnailStepOutput>>;
     /**
-     * [Coda] Create/Update page
-     *
      * Create a new page or update an existing page in a Coda document.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Coda OAuth connection (connectionId).
      * - If pageData.pageId is provided, updates that page. Otherwise, creates a new one.
      * - Page content is provided as markdown and converted to Coda's canvas format.
      * - When updating, insertionMode controls how content is applied (default: 'append').
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.codaCreateUpdatePage({
+     *   connectionId: ``,
+     *   pageData: {},
+     * });
+     * ```
      */
     codaCreateUpdatePage(step: CodaCreateUpdatePageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CodaCreateUpdatePageStepOutput>>;
     /**
-     * [Coda] Create/Update row
-     *
      * Create a new row or update an existing row in a Coda table.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Coda OAuth connection (connectionId).
      * - If rowId is provided, updates that row. Otherwise, creates a new one.
      * - Row data keys are column IDs. Empty values are excluded.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.codaCreateUpdateRow({
+     *   connectionId: ``,
+     *   docId: ``,
+     *   tableId: ``,
+     *   rowData: {},
+     * });
+     * ```
      */
     codaCreateUpdateRow(step: CodaCreateUpdateRowStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CodaCreateUpdateRowStepOutput>>;
     /**
-     * [Coda] Find row
-     *
      * Search for a row in a Coda table by matching column values.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Coda OAuth connection (connectionId).
      * - Returns the first row matching all specified column values, or null if no match.
      * - Search criteria in rowData are ANDed together.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.codaFindRow({
+     *   connectionId: ``,
+     *   docId: ``,
+     *   tableId: ``,
+     *   rowData: {},
+     * });
+     * ```
      */
     codaFindRow(step: CodaFindRowStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CodaFindRowStepOutput>>;
     /**
-     * [Coda] Get page
-     *
      * Export and read the contents of a page from a Coda document.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Coda OAuth connection (connectionId).
      * - Page export is asynchronous on Coda's side — there may be a brief delay while it processes.
      * - If a page was just created in a prior step, there is an automatic 20-second retry if the first export attempt fails.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.codaGetPage({
+     *   connectionId: ``,
+     *   docId: ``,
+     *   pageId: ``,
+     * });
+     * ```
      */
     codaGetPage(step: CodaGetPageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CodaGetPageStepOutput>>;
     /**
-     * [Coda] Get table rows
-     *
      * Fetch rows from a Coda table with optional pagination.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Coda OAuth connection (connectionId).
      * - Default limit is 10000 rows. Rows are fetched in pages of 500.
      * - When outputFormat is 'csv', the variable receives CSV text. The direct execution output always returns parsed rows.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.codaGetTableRows({
+     *   connectionId: ``,
+     *   docId: ``,
+     *   tableId: ``,
+     * });
+     * ```
      */
     codaGetTableRows(step: CodaGetTableRowsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CodaGetTableRowsStepOutput>>;
     /**
-     * Convert PDF to Images
-     *
      * Convert each page of a PDF document into a PNG image.
      *
-     * ## Usage Notes
+     * @remarks
      * - Each page is converted to a separate PNG and re-hosted on the CDN.
      * - Returns an array of image URLs, one per page.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.convertPdfToImages({
+     *   pdfUrl: ``,
+     * });
+     * ```
      */
     convertPdfToImages(step: ConvertPdfToImagesStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ConvertPdfToImagesStepOutput>>;
     /**
-     * Create Data Source
-     *
      * Create a new empty vector data source for the current app.
      *
-     * ## Usage Notes
+     * @remarks
      * - Creates a new data source (vector database) associated with the current app version.
      * - The data source is created empty — use the "Upload Data Source Document" block to add documents.
      * - Returns the new data source ID which can be used in subsequent blocks.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.createDataSource({
+     *   name: ``,
+     * });
+     * ```
      */
     createDataSource(step: CreateDataSourceStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CreateDataSourceStepOutput>>;
     /**
-     * [Google Calendar] Create Event
-     *
      * Create a new event on a Google Calendar.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Google OAuth connection with Calendar events scope.
      * - Date/time values must be ISO 8601 format (e.g. "2025-07-02T10:00:00-07:00").
      * - Attendees are specified as one email address per line in a single string.
      * - Set addMeetLink to true to automatically attach a Google Meet video call.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.createGoogleCalendarEvent({
+     *   connectionId: ``,
+     *   summary: ``,
+     *   startDateTime: ``,
+     *   endDateTime: ``,
+     * });
+     * ```
      */
     createGoogleCalendarEvent(step: CreateGoogleCalendarEventStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CreateGoogleCalendarEventStepOutput>>;
     /**
-     * [Google] Create Google Doc
-     *
      * Create a new Google Document and optionally populate it with content.
      *
-     * ## Usage Notes
+     * @remarks
      * - textType determines how the text field is interpreted: "plain" for plain text, "html" for HTML markup, "markdown" for Markdown.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.createGoogleDoc({
+     *   title: ``,
+     *   text: ``,
+     *   connectionId: ``,
+     *   textType: "plain",
+     * });
+     * ```
      */
     createGoogleDoc(step: CreateGoogleDocStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CreateGoogleDocStepOutput>>;
     /**
-     * [Google] Create Google Sheet
-     *
      * Create a new Google Spreadsheet and populate it with CSV data.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.createGoogleSheet({
+     *   title: ``,
+     *   text: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     createGoogleSheet(step: CreateGoogleSheetStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CreateGoogleSheetStepOutput>>;
     /**
-     * Delete Data Source
-     *
      * Delete a vector data source from the current app.
      *
-     * ## Usage Notes
+     * @remarks
      * - Soft-deletes a data source (vector database) by marking it as deleted.
      * - The Milvus partition is cleaned up asynchronously by a background cron job.
      * - The data source must belong to the current app version.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.deleteDataSource({
+     *   dataSourceId: ``,
+     * });
+     * ```
      */
     deleteDataSource(step: DeleteDataSourceStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<DeleteDataSourceStepOutput>>;
     /**
-     * Delete Data Source Document
-     *
      * Delete a single document from a data source.
      *
-     * ## Usage Notes
+     * @remarks
      * - Soft-deletes a document by marking it as deleted.
      * - Requires both the data source ID and document ID.
      * - After deletion, reloads vectors into Milvus so the data source reflects the change immediately.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.deleteDataSourceDocument({
+     *   dataSourceId: ``,
+     *   documentId: ``,
+     * });
+     * ```
      */
     deleteDataSourceDocument(step: DeleteDataSourceDocumentStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<DeleteDataSourceDocumentStepOutput>>;
     /**
-     * [Google Calendar] Get Event
-     *
      * Retrieve a specific event from a Google Calendar by event ID.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Google OAuth connection with Calendar events scope.
      * - The variable receives JSON or XML-like text depending on exportType. The direct execution output always returns the structured event.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.deleteGoogleCalendarEvent({
+     *   connectionId: ``,
+     *   eventId: ``,
+     * });
+     * ```
      */
     deleteGoogleCalendarEvent(step: DeleteGoogleCalendarEventStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<DeleteGoogleCalendarEventStepOutput>>;
     /**
-     * Detect PII
-     *
      * Scan text for personally identifiable information using Microsoft Presidio.
      *
-     * ## Usage Notes
+     * @remarks
      * - In workflow mode, transitions to detectedStepId if PII is found, notDetectedStepId otherwise.
      * - In direct execution, returns the detection results without transitioning.
      * - If entities is empty, returns immediately with no detections.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.detectPII({
+     *   input: ``,
+     *   language: ``,
+     *   entities: [],
+     * });
+     * ```
      */
     detectPII(step: DetectPIIStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<DetectPIIStepOutput>>;
     /**
-     * Download Video
-     *
      * Download a video file
      *
-     * ## Usage Notes
+     * @remarks
      * - Works with YouTube, TikTok, etc., by using ytdlp behind the scenes
      * - Can save as mp4 or mp3
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.downloadVideo({
+     *   videoUrl: ``,
+     *   format: "mp4",
+     * });
+     * ```
      */
     downloadVideo(step: DownloadVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<DownloadVideoStepOutput>>;
     /**
-     * Enhance Image Prompt
-     *
-     * Auto-enhance an image generation prompt using a language model. Optionally generates a negative prompt.
+     * Generate or enhance an image generation prompt using a language model. Optionally generates a negative prompt.
      *
-     * ## Usage Notes
+     * @remarks
      * - Rewrites the user's prompt with added detail about style, lighting, colors, and composition.
+     * - Also useful for initial generation, it doesn't always need to be enhancing an existing prompt
      * - When includeNegativePrompt is true, a second model call generates a negative prompt.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.enhanceImageGenerationPrompt({
+     *   initialPrompt: ``,
+     *   includeNegativePrompt: false,
+     *   systemPrompt: ``,
+     * });
+     * ```
      */
     enhanceImageGenerationPrompt(step: EnhanceImageGenerationPromptStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<EnhanceImageGenerationPromptStepOutput>>;
     /**
-     * Enhance Video Prompt
-     *
-     * Auto-enhance a video generation prompt using a language model. Optionally generates a negative prompt.
+     * Generate or enhance a video generation prompt using a language model. Optionally generates a negative prompt.
      *
-     * ## Usage Notes
+     * @remarks
      * - Rewrites the user's prompt with added detail about style, camera movement, lighting, and composition.
+     * - Also useful for initial generation, it doesn't always need to be enhancing an existing prompt
      * - When includeNegativePrompt is true, a second model call generates a negative prompt.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.enhanceVideoGenerationPrompt({
+     *   initialPrompt: ``,
+     *   includeNegativePrompt: false,
+     *   systemPrompt: ``,
+     * });
+     * ```
      */
     enhanceVideoGenerationPrompt(step: EnhanceVideoGenerationPromptStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<EnhanceVideoGenerationPromptStepOutput>>;
     /**
-     * [Apollo] Enrich Person
-     *
      * Look up professional information about a person using Apollo.io. Search by ID, name, LinkedIn URL, email, or domain.
      *
-     * ## Usage Notes
+     * @remarks
      * - At least one search parameter must be provided.
      * - Returns enriched data from Apollo including contact details, employment info, and social profiles.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.enrichPerson({
+     *   params: {},
+     * });
+     * ```
      */
     enrichPerson(step: EnrichPersonStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<EnrichPersonStepOutput>>;
     /**
-     * Extract Audio from Video
-     *
      * Extract audio MP3 from a video file
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.extractAudioFromVideo({
+     *   videoUrl: ``,
+     * });
+     * ```
      */
     extractAudioFromVideo(step: ExtractAudioFromVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ExtractAudioFromVideoStepOutput>>;
     /**
-     * Extract Text from URL
-     *
      * Download a file from a URL and extract its text content. Supports PDFs, plain text files, and other document formats.
      *
-     * ## Usage Notes
+     * @remarks
      * - Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.
      * - Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.
      * - Files are rehosted on the MindStudio CDN before extraction.
      * - Maximum file size is 50MB per URL.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.extractText({
+     *   url: ``,
+     * });
+     * ```
      */
     extractText(step: ExtractTextStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ExtractTextStepOutput>>;
     /**
-     * Fetch Data Source Document
-     *
      * Fetch the full extracted text contents of a document in a data source.
      *
-     * ## Usage Notes
+     * @remarks
      * - Loads a document by ID and returns its full extracted text content.
      * - The document must have been successfully processed (status "done").
      * - Also returns document metadata (name, summary, word count).
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchDataSourceDocument({
+     *   dataSourceId: ``,
+     *   documentId: ``,
+     * });
+     * ```
      */
     fetchDataSourceDocument(step: FetchDataSourceDocumentStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchDataSourceDocumentStepOutput>>;
     /**
-     * [Google] Fetch Google Doc
-     *
      * Fetch the contents of an existing Google Document.
      *
-     * ## Usage Notes
+     * @remarks
      * - exportType controls the output format: "html" for HTML markup, "markdown" for Markdown, "json" for structured JSON, "plain" for plain text.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchGoogleDoc({
+     *   documentId: ``,
+     *   connectionId: ``,
+     *   exportType: "html",
+     * });
+     * ```
      */
     fetchGoogleDoc(step: FetchGoogleDocStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchGoogleDocStepOutput>>;
     /**
-     * [Google] Fetch Google Sheet
-     *
      * Fetch contents of a Google Spreadsheet range.
      *
-     * ## Usage Notes
+     * @remarks
      * - range uses A1 notation (e.g. "Sheet1!A1:C10"). Omit to fetch the entire first sheet.
      * - exportType controls the output format: "csv" for comma-separated values, "json" for structured JSON.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchGoogleSheet({
+     *   spreadsheetId: ``,
+     *   range: ``,
+     *   connectionId: ``,
+     *   exportType: "csv",
+     * });
+     * ```
      */
     fetchGoogleSheet(step: FetchGoogleSheetStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchGoogleSheetStepOutput>>;
     /**
-     * Fetch Slack Channel History
-     *
      * Fetch recent message history from a Slack channel.
      *
-     * ## Usage Notes
+     * @remarks
      * - The user is responsible for connecting their Slack workspace and selecting the channel
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchSlackChannelHistory({
+     *   connectionId: ``,
+     *   channelId: ``,
+     * });
+     * ```
      */
     fetchSlackChannelHistory(step: FetchSlackChannelHistoryStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchSlackChannelHistoryStepOutput>>;
     /**
-     * [YouTube] Fetch Captions
-     *
      * Retrieve the captions/transcript for a YouTube video.
      *
-     * ## Usage Notes
+     * @remarks
      * - Supports multiple languages via the language parameter.
      * - "text" export produces timestamped plain text; "json" export produces structured transcript data.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchYoutubeCaptions({
+     *   videoUrl: ``,
+     *   exportType: "text",
+     *   language: ``,
+     * });
+     * ```
      */
     fetchYoutubeCaptions(step: FetchYoutubeCaptionsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchYoutubeCaptionsStepOutput>>;
     /**
-     * [YouTube] Fetch Channel
-     *
      * Retrieve metadata and recent videos for a YouTube channel.
      *
-     * ## Usage Notes
+     * @remarks
      * - Accepts a YouTube channel URL (e.g. https://www.youtube.com/@ChannelName or /channel/ID).
      * - Returns channel info and video listings as a JSON object.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchYoutubeChannel({
+     *   channelUrl: ``,
+     * });
+     * ```
      */
     fetchYoutubeChannel(step: FetchYoutubeChannelStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchYoutubeChannelStepOutput>>;
     /**
-     * [YouTube] Fetch Comments
-     *
      * Retrieve comments for a YouTube video.
      *
-     * ## Usage Notes
+     * @remarks
      * - Paginates through comments (up to 5 pages).
      * - "text" export produces markdown-formatted text; "json" export produces structured comment data.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchYoutubeComments({
+     *   videoUrl: ``,
+     *   exportType: "text",
+     *   limitPages: ``,
+     * });
+     * ```
      */
     fetchYoutubeComments(step: FetchYoutubeCommentsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchYoutubeCommentsStepOutput>>;
     /**
-     * [YouTube] Fetch Video
-     *
      * Retrieve metadata for a YouTube video (title, description, stats, channel info).
      *
-     * ## Usage Notes
+     * @remarks
      * - Returns video metadata, channel info, and engagement stats.
      * - Video format data is excluded from the response.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.fetchYoutubeVideo({
+     *   videoUrl: ``,
+     * });
+     * ```
      */
     fetchYoutubeVideo(step: FetchYoutubeVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<FetchYoutubeVideoStepOutput>>;
     /**
-     * Generate Chart
-     *
      * Create a chart image using QuickChart (Chart.js) and return the URL.
      *
-     * ## Usage Notes
+     * @remarks
      * - The data field must be a Chart.js-compatible JSON object serialized as a string.
      * - Supported chart types: bar, line, pie.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateChart({
+     *   chart: {},
+     * });
+     * ```
      */
     generateChart(step: GenerateChartStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GenerateChartStepOutput>>;
     /**
-     * Generate Image
-     *
      * Generate an image from a text prompt using an AI model.
      *
-     * ## Usage Notes
+     * @remarks
      * - Prompts should be descriptive but concise (roughly 3–6 sentences).
      * - Images are automatically hosted on a CDN.
      * - In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.
      * - When generateVariants is true with numVariants > 1, multiple images are generated in parallel.
      * - In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateImage({
+     *   prompt: ``,
+     * });
+     * ```
      */
     generateImage(step: GenerateImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GenerateImageStepOutput>>;
     /**
-     * Generate Lipsync
-     *
      * Generate a lip sync video from provided audio and image.
      *
-     * ## Usage Notes
+     * @remarks
      * - In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateLipsync({});
+     * ```
      */
     generateLipsync(step: GenerateLipsyncStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GenerateLipsyncStepOutput>>;
     /**
-     * Generate Music
-     *
      * Generate an audio file from provided instructions (text) using a music model.
      *
-     * ## Usage Notes
+     * @remarks
      * - The text field contains the instructions (prompt) for the music generation.
      * - In foreground mode, the audio is displayed to the user. In background mode, the URL is saved to a variable.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateMusic({
+     *   text: ``,
+     * });
+     * ```
      */
     generateMusic(step: GenerateMusicStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GenerateMusicStepOutput>>;
     /**
-     * Generate HTML Asset
-     *
      * Generate an HTML asset and export it as a webpage, PDF, or image
      *
-     * ## Usage Notes
+     * @remarks
      * - 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.
      * - 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.
      * - If PDF or composited image generation are part of the workflow, assistant adds the block and leaves the "source" empty. In a separate step, assistant generates a detailed request for the developer who will write the HTML.
      * - Can also auto-generate HTML from a prompt (like a generate text block to generate HTML). In these cases, create a prompt with variables in the dynamicPrompt variable describing, in detail, the document to generate
      * - Can either display output directly to user (foreground mode) or save the URL of the asset to a variable (background mode)
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateAsset({
+     *   source: ``,
+     *   sourceType: "html",
+     *   outputFormat: "pdf",
+     *   pageSize: "full",
+     *   testData: {},
+     * });
+     * ```
      */
     generateAsset(step: GeneratePdfStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GeneratePdfStepOutput>>;
     /**
-     * Generate Static Video from Image
-     *
      * Convert a static image to an MP4
      *
-     * ## Usage Notes
+     * @remarks
      * - Can use to create slides/intertitles/slates for video composition
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateStaticVideoFromImage({
+     *   imageUrl: ``,
+     *   duration: ``,
+     * });
+     * ```
      */
     generateStaticVideoFromImage(step: GenerateStaticVideoFromImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GenerateStaticVideoFromImageStepOutput>>;
     /**
-     * Generate Video
-     *
      * Generate a video from a text prompt using an AI model.
      *
-     * ## Usage Notes
+     * @remarks
      * - Prompts should be descriptive but concise (roughly 3–6 sentences).
      * - Videos are automatically hosted on a CDN.
      * - In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.
      * - When generateVariants is true with numVariants > 1, multiple videos are generated in parallel.
      * - In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateVideo({
+     *   prompt: ``,
+     * });
+     * ```
      */
     generateVideo(step: GenerateVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GenerateVideoStepOutput>>;
     /**
-     * [Google Calendar] Get Event
-     *
      * Retrieve a specific event from a Google Calendar by event ID.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Google OAuth connection with Calendar events scope.
      * - The variable receives JSON or XML-like text depending on exportType. The direct execution output always returns the structured event.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.getGoogleCalendarEvent({
+     *   connectionId: ``,
+     *   eventId: ``,
+     *   exportType: "json",
+     * });
+     * ```
      */
     getGoogleCalendarEvent(step: GetGoogleCalendarEventStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GetGoogleCalendarEventStepOutput>>;
     /**
-     * Get Media Metadata
-     *
      * Get info about a media file
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.getMediaMetadata({
+     *   mediaUrl: ``,
+     * });
+     * ```
      */
     getMediaMetadata(step: GetMediaMetadataStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<GetMediaMetadataStepOutput>>;
     /**
-     * HTTP Request
-     *
      * Make an HTTP request to an external endpoint and return the response.
      *
-     * ## Usage Notes
+     * @remarks
      * - Supports GET, POST, PATCH, DELETE, and PUT methods.
      * - Body can be raw JSON/text, URL-encoded form data, or multipart form data.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.httpRequest({
+     *   url: ``,
+     *   method: ``,
+     *   headers: {},
+     *   queryParams: {},
+     *   body: ``,
+     *   bodyItems: {},
+     *   contentType: "none",
+     *   customContentType: ``,
+     * });
+     * ```
      */
     httpRequest(step: HttpRequestStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HttpRequestStepOutput>>;
     /**
-     * [HubSpot] Create/Update Company
-     *
      * Create a new company or update an existing one in HubSpot. Matches by domain.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a HubSpot OAuth connection (connectionId).
      * - If a company with the given domain already exists, it is updated. Otherwise, a new one is created.
      * - Property values are type-checked against enabledProperties before being sent to HubSpot.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hubspotCreateCompany({
+     *   connectionId: ``,
+     *   company: {},
+     *   enabledProperties: [],
+     * });
+     * ```
      */
     hubspotCreateCompany(step: HubspotCreateCompanyStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HubspotCreateCompanyStepOutput>>;
     /**
-     * [HubSpot] Create/Update Contact
-     *
      * Create a new contact or update an existing one in HubSpot. Matches by email address.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a HubSpot OAuth connection (connectionId).
      * - If a contact with the given email already exists, it is updated. Otherwise, a new one is created.
      * - If companyDomain is provided, the contact is associated with that company (creating the company if needed).
      * - Property values are type-checked against enabledProperties before being sent to HubSpot.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hubspotCreateContact({
+     *   connectionId: ``,
+     *   contact: {},
+     *   enabledProperties: [],
+     *   companyDomain: ``,
+     * });
+     * ```
      */
     hubspotCreateContact(step: HubspotCreateContactStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HubspotCreateContactStepOutput>>;
     /**
-     * [HubSpot] Get Company
-     *
      * Look up a HubSpot company by domain name or company ID.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a HubSpot OAuth connection (connectionId).
      * - Returns null if the company is not found.
      * - When searching by domain, performs a search query then fetches the full company record.
      * - Use additionalProperties to request specific HubSpot properties beyond the defaults.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hubspotGetCompany({
+     *   connectionId: ``,
+     *   searchBy: "domain",
+     *   companyDomain: ``,
+     *   companyId: ``,
+     *   additionalProperties: [],
+     * });
+     * ```
      */
     hubspotGetCompany(step: HubspotGetCompanyStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HubspotGetCompanyStepOutput>>;
     /**
-     * [HubSpot] Get Contact
-     *
      * Look up a HubSpot contact by email address or contact ID.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a HubSpot OAuth connection (connectionId).
      * - Returns null if the contact is not found.
      * - Use additionalProperties to request specific HubSpot properties beyond the defaults.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hubspotGetContact({
+     *   connectionId: ``,
+     *   searchBy: "email",
+     *   contactEmail: ``,
+     *   contactId: ``,
+     *   additionalProperties: [],
+     * });
+     * ```
      */
     hubspotGetContact(step: HubspotGetContactStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HubspotGetContactStepOutput>>;
     /**
-     * [Hunter.io] Enrich Company
-     *
      * Look up company information by domain using Hunter.io.
      *
-     * ## Usage Notes
+     * @remarks
      * - Returns company name, description, location, industry, size, technologies, and more.
      * - If the domain input is a full URL, the hostname is automatically extracted.
      * - Returns null if the company is not found.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hunterApiCompanyEnrichment({
+     *   domain: ``,
+     * });
+     * ```
      */
     hunterApiCompanyEnrichment(step: HunterApiCompanyEnrichmentStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HunterApiCompanyEnrichmentStepOutput>>;
     /**
-     * [Hunter.io] Domain Search
-     *
      * Search for email addresses associated with a domain using Hunter.io.
      *
-     * ## Usage Notes
+     * @remarks
      * - If the domain input is a full URL, the hostname is automatically extracted.
      * - Returns a list of email addresses found for the domain along with organization info.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hunterApiDomainSearch({
+     *   domain: ``,
+     * });
+     * ```
      */
     hunterApiDomainSearch(step: HunterApiDomainSearchStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HunterApiDomainSearchStepOutput>>;
     /**
-     * [Hunter.io] Find Email
-     *
      * Find an email address for a specific person at a domain using Hunter.io.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a first name, last name, and domain.
      * - If the domain input is a full URL, the hostname is automatically extracted.
      * - Returns the most likely email address with a confidence score.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hunterApiEmailFinder({
+     *   domain: ``,
+     *   firstName: ``,
+     *   lastName: ``,
+     * });
+     * ```
      */
     hunterApiEmailFinder(step: HunterApiEmailFinderStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HunterApiEmailFinderStepOutput>>;
     /**
-     * [Hunter.io] Verify Email
-     *
      * Verify whether an email address is valid and deliverable using Hunter.io.
      *
-     * ## Usage Notes
+     * @remarks
      * - Checks email format, MX records, SMTP server, and mailbox deliverability.
      * - Returns a status ("valid", "invalid", "accept_all", "webmail", "disposable", "unknown") and a score.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hunterApiEmailVerification({
+     *   email: ``,
+     * });
+     * ```
      */
     hunterApiEmailVerification(step: HunterApiEmailVerificationStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HunterApiEmailVerificationStepOutput>>;
     /**
-     * [Hunter.io] Enrich Person
-     *
      * Look up professional information about a person by their email address using Hunter.io.
      *
-     * ## Usage Notes
+     * @remarks
      * - Returns name, job title, social profiles, and company information.
      * - If the person is not found, returns an object with an error message instead of throwing.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.hunterApiPersonEnrichment({
+     *   email: ``,
+     * });
+     * ```
      */
     hunterApiPersonEnrichment(step: HunterApiPersonEnrichmentStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<HunterApiPersonEnrichmentStepOutput>>;
     /**
-     * Image Face Swap
-     *
      * Replace a face in an image with a face from another image using AI.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires both a target image and a face source image.
      * - Output is re-hosted on the CDN as a PNG.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.imageFaceSwap({
+     *   imageUrl: ``,
+     *   faceImageUrl: ``,
+     *   engine: ``,
+     * });
+     * ```
      */
     imageFaceSwap(step: ImageFaceSwapStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ImageFaceSwapStepOutput>>;
     /**
-     * Remove Image Watermark
-     *
      * Remove watermarks from an image using AI.
      *
-     * ## Usage Notes
+     * @remarks
      * - Output is re-hosted on the CDN as a PNG.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.imageRemoveWatermark({
+     *   imageUrl: ``,
+     *   engine: ``,
+     * });
+     * ```
      */
     imageRemoveWatermark(step: ImageRemoveWatermarkStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ImageRemoveWatermarkStepOutput>>;
     /**
-     * Insert Video Clips
-     *
      * Insert b-roll clips into a base video at a timecode, optionally with an xfade transition.
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.insertVideoClips({
+     *   baseVideoUrl: ``,
+     *   overlayVideos: [],
+     * });
+     * ```
      */
     insertVideoClips(step: InsertVideoClipsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<InsertVideoClipsStepOutput>>;
     /**
-     * List Data Sources
-     *
      * List all data sources for the current app.
      *
-     * ## Usage Notes
+     * @remarks
      * - Returns metadata for every data source associated with the current app version.
      * - Each entry includes the data source ID, name, description, status, and document list.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.listDataSources({});
+     * ```
      */
     listDataSources(step: ListDataSourcesStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ListDataSourcesStepOutput>>;
     /**
-     * [Google Calendar] List Events
-     *
      * List upcoming events from a Google Calendar, ordered by start time.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Google OAuth connection with Calendar events scope.
      * - Only returns future events (timeMin = now).
      * - The variable receives JSON or XML-like text depending on exportType. The direct execution output always returns structured events.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.listGoogleCalendarEvents({
+     *   connectionId: ``,
+     *   limit: 0,
+     *   exportType: "json",
+     * });
+     * ```
      */
     listGoogleCalendarEvents(step: ListGoogleCalendarEventsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ListGoogleCalendarEventsStepOutput>>;
     /**
-     * Evaluate Logic
-     *
      * Use an AI model to evaluate which condition from a list is most true, given a context prompt.
      *
-     * ## Usage Notes
+     * @remarks
      * - This is "fuzzy" logic evaluated by an AI model, not computational logic. The model picks the most accurate statement.
      * - All possible cases must be specified — there is no default/fallback case.
      * - Requires at least two cases.
      * - In workflow mode, transitions to the destinationStepId of the winning case. In direct execution, returns the winning case ID and condition.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.logic({
+     *   context: ``,
+     *   cases: [],
+     * });
+     * ```
      */
     logic(step: LogicStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<LogicStepOutput>>;
     /**
-     * Make.com Run Scenario
-     *
      * Trigger a Make.com (formerly Integromat) scenario via webhook and return the response.
      *
-     * ## Usage Notes
+     * @remarks
      * - The webhook URL must be configured in your Make.com scenario.
      * - Input key-value pairs are sent as JSON in the POST body.
      * - Response format depends on the Make.com scenario configuration.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.makeDotComRunScenario({
+     *   webhookUrl: ``,
+     *   input: {},
+     * });
+     * ```
      */
     makeDotComRunScenario(step: MakeDotComRunScenarioStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<MakeDotComRunScenarioStepOutput>>;
     /**
-     * Merge Audio
-     *
      * Merge one or more clips into a single audio file.
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.mergeAudio({
+     *   mp3Urls: [],
+     * });
+     * ```
      */
     mergeAudio(step: MergeAudioStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<MergeAudioStepOutput>>;
     /**
-     * Merge Videos
-     *
      * Merge one or more clips into a single video.
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.mergeVideos({
+     *   videoUrls: [],
+     * });
+     * ```
      */
     mergeVideos(step: MergeVideosStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<MergeVideosStepOutput>>;
     /**
-     * Mix Audio into Video
-     *
      * Mix an audio track into a video
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.mixAudioIntoVideo({
+     *   videoUrl: ``,
+     *   audioUrl: ``,
+     *   options: {},
+     * });
+     * ```
      */
     mixAudioIntoVideo(step: MixAudioIntoVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<MixAudioIntoVideoStepOutput>>;
     /**
-     * Mute Video
-     *
      * Mute a video file
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.muteVideo({
+     *   videoUrl: ``,
+     * });
+     * ```
      */
     muteVideo(step: MuteVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<MuteVideoStepOutput>>;
     /**
-     * N8N Run Node
-     *
      * Trigger an n8n workflow node via webhook and return the response.
      *
-     * ## Usage Notes
+     * @remarks
      * - The webhook URL must be configured in your n8n workflow.
      * - Supports GET and POST methods with optional Basic authentication.
      * - For GET requests, input values are sent as query parameters. For POST, they are sent as JSON body.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.n8nRunNode({
+     *   method: ``,
+     *   authentication: "none",
+     *   user: ``,
+     *   password: ``,
+     *   webhookUrl: ``,
+     *   input: {},
+     * });
+     * ```
      */
     n8nRunNode(step: N8nRunNodeStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<N8nRunNodeStepOutput>>;
     /**
-     * [Notion] Create Page
-     *
      * Create a new page in Notion as a child of an existing page.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Notion OAuth connection (connectionId).
      * - Content is provided as markdown and converted to Notion blocks (headings, paragraphs, lists, code, quotes).
      * - The page is created as a child of the specified parent page (pageId).
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.notionCreatePage({
+     *   pageId: ``,
+     *   content: ``,
+     *   title: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     notionCreatePage(step: NotionCreatePageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<NotionCreatePageStepOutput>>;
     /**
-     * [Notion] Update Page
-     *
      * Update the content of an existing Notion page.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Notion OAuth connection (connectionId).
      * - Content is provided as markdown and converted to Notion blocks.
      * - "append" mode adds content to the end of the page. "overwrite" mode deletes all existing blocks first.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.notionUpdatePage({
+     *   pageId: ``,
+     *   content: ``,
+     *   mode: "append",
+     *   connectionId: ``,
+     * });
+     * ```
      */
     notionUpdatePage(step: NotionUpdatePageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<NotionUpdatePageStepOutput>>;
     /**
-     * [Apollo] People Search
-     *
      * Search for people matching specific criteria using Apollo.io. Supports natural language queries and advanced filters.
      *
-     * ## Usage Notes
+     * @remarks
      * - Can use a natural language "smartQuery" which is converted to Apollo search parameters by an AI model.
      * - Advanced params can override or supplement the smart query results.
      * - Optionally enriches returned people and/or their organizations for additional detail.
      * - Results are paginated. Use limit and page to control the result window.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.peopleSearch({
+     *   smartQuery: ``,
+     *   enrichPeople: false,
+     *   enrichOrganizations: false,
+     *   limit: ``,
+     *   page: ``,
+     *   params: {},
+     * });
+     * ```
      */
     peopleSearch(step: PeopleSearchStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<PeopleSearchStepOutput>>;
     /**
-     * [LinkedIn] Create post
-     *
      * Create a post on LinkedIn from the connected account.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a LinkedIn OAuth connection (connectionId).
      * - Supports text posts, image posts, and video posts.
      * - Visibility controls who can see the post.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.postToLinkedIn({
+     *   message: ``,
+     *   visibility: "PUBLIC",
+     *   connectionId: ``,
+     * });
+     * ```
      */
     postToLinkedIn(step: PostToLinkedInStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<PostToLinkedInStepOutput>>;
     /**
-     * Post to Slack Channel
-     *
      * Send a message to a Slack channel via a connected bot.
      *
-     * ## Usage Notes
+     * @remarks
      * - The user is responsible for connecting their Slack workspace and selecting the channel
      * - Supports both simple text messages and slack blocks messages
      * - Text messages can use limited markdown (slack-only fomatting—e.g., headers are just rendered as bold)
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.postToSlackChannel({
+     *   channelId: ``,
+     *   messageType: "string",
+     *   message: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     postToSlackChannel(step: PostToSlackChannelStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<PostToSlackChannelStepOutput>>;
     /**
-     * [X] Create post
-     *
      * Create a post on X (Twitter) from the connected account.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires an X OAuth connection (connectionId).
      * - Posts are plain text. Maximum 280 characters.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.postToX({
+     *   text: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     postToX(step: PostToXStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<PostToXStepOutput>>;
     /**
-     * Post to Zapier
-     *
      * Send data to a Zapier Zap via webhook and return the response.
      *
-     * ## Usage Notes
+     * @remarks
      * - The webhook URL must be configured in the Zapier Zap settings
      * - Input keys and values are sent as the JSON body of the POST request
      * - The webhook response (JSON or plain text) is returned as the output
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.postToZapier({
+     *   webhookUrl: ``,
+     *   input: {},
+     * });
+     * ```
      */
     postToZapier(step: PostToZapierStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<PostToZapierStepOutput>>;
     /**
-     * Query Data Source
-     *
      * Search a vector data source (RAG) and return relevant document chunks.
      *
-     * ## Usage Notes
+     * @remarks
      * - Queries a vectorized data source and returns the most relevant chunks.
      * - Useful for retrieval-augmented generation (RAG) workflows.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.queryDataSource({
+     *   dataSourceId: ``,
+     *   query: ``,
+     *   maxResults: 0,
+     * });
+     * ```
      */
     queryDataSource(step: QueryDataSourceStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<QueryDataSourceStepOutput>>;
     /**
-     * Query External SQL Database
-     *
      * Execute a SQL query against an external database connected to the workspace.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a database connection configured in the workspace.
      * - Supports PostgreSQL (including Supabase), MySQL, and MSSQL.
      * - Results can be returned as JSON or CSV.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.queryExternalDatabase({
+     *   connectionId: ``,
+     *   query: ``,
+     *   outputFormat: "json",
+     * });
+     * ```
      */
     queryExternalDatabase(step: QueryExternalDatabaseStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<QueryExternalDatabaseStepOutput>>;
     /**
-     * Redact PII
-     *
      * Replace personally identifiable information in text with placeholders using Microsoft Presidio.
      *
-     * ## Usage Notes
+     * @remarks
      * - PII is replaced with entity type placeholders (e.g. "Call me at <PHONE_NUMBER>").
      * - If entities is empty, returns empty text immediately without processing.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.redactPII({
+     *   input: ``,
+     *   language: ``,
+     *   entities: [],
+     * });
+     * ```
      */
     redactPII(step: RedactPIIStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<RedactPIIStepOutput>>;
     /**
-     * Remove Background From Image
-     *
      * Remove the background from an image using AI, producing a transparent PNG.
      *
-     * ## Usage Notes
+     * @remarks
      * - Uses the Bria background removal model via fal.ai.
      * - Output is re-hosted on the CDN as a PNG with transparency.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.removeBackgroundFromImage({
+     *   imageUrl: ``,
+     * });
+     * ```
      */
     removeBackgroundFromImage(step: RemoveBackgroundFromImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<RemoveBackgroundFromImageStepOutput>>;
     /**
-     * Resize Video
-     *
      * Resize a video file
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.resizeVideo({
+     *   videoUrl: ``,
+     *   mode: "fit",
+     * });
+     * ```
      */
     resizeVideo(step: ResizeVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ResizeVideoStepOutput>>;
     /**
-     * Run Packaged Workflow
-     *
      * Run a packaged workflow ("custom block")
      *
-     * ## Usage Notes
+     * @remarks
      * - 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.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.runPackagedWorkflow({
+     *   appId: ``,
+     *   workflowId: ``,
+     *   inputVariables: {},
+     *   outputVariables: {},
+     *   name: ``,
+     * });
+     * ```
      */
     runPackagedWorkflow(step: RunPackagedWorkflowStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<RunPackagedWorkflowStepOutput>>;
     /**
-     * [Facebook] Scrape Page
-     *
      * Scrape a Facebook page
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeFacebookPage({
+     *   pageUrl: ``,
+     * });
+     * ```
      */
     scrapeFacebookPage(step: ScrapeFacebookPageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeFacebookPageStepOutput>>;
     /**
-     * [Facebook] Scrape Posts for Page
-     *
      * Get all the posts for a Facebook page
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeFacebookPosts({
+     *   pageUrl: ``,
+     * });
+     * ```
      */
     scrapeFacebookPosts(step: ScrapeFacebookPostsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeFacebookPostsStepOutput>>;
     /**
-     * [Instagram] Scrape Comments
-     *
      * Get all the comments for an Instagram post
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeInstagramComments({
+     *   postUrl: ``,
+     *   resultsLimit: ``,
+     * });
+     * ```
      */
     scrapeInstagramComments(step: ScrapeInstagramCommentsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeInstagramCommentsStepOutput>>;
     /**
-     * [Instagram] Scrape Mentions
-     *
      * Scrape an Instagram profile's mentions
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeInstagramMentions({
+     *   profileUrl: ``,
+     *   resultsLimit: ``,
+     * });
+     * ```
      */
     scrapeInstagramMentions(step: ScrapeInstagramMentionsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeInstagramMentionsStepOutput>>;
     /**
-     * [Instagram] Scrape Posts
-     *
      * Get all the posts for an Instagram profile
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeInstagramPosts({
+     *   profileUrl: ``,
+     *   resultsLimit: ``,
+     *   onlyPostsNewerThan: ``,
+     * });
+     * ```
      */
     scrapeInstagramPosts(step: ScrapeInstagramPostsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeInstagramPostsStepOutput>>;
     /**
-     * [Instagram] Scrape Profile
-     *
      * Scrape an Instagram profile
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeInstagramProfile({
+     *   profileUrl: ``,
+     * });
+     * ```
      */
     scrapeInstagramProfile(step: ScrapeInstagramProfileStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeInstagramProfileStepOutput>>;
     /**
-     * [Instagram] Scrape Reels
-     *
      * Get all the reels for an Instagram profile
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeInstagramReels({
+     *   profileUrl: ``,
+     *   resultsLimit: ``,
+     * });
+     * ```
      */
     scrapeInstagramReels(step: ScrapeInstagramReelsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeInstagramReelsStepOutput>>;
     /**
-     * Scrape LinkedIn Company
-     *
      * Scrape public company data from a LinkedIn company page.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a LinkedIn company URL (e.g. https://www.linkedin.com/company/mindstudioai).
      * - Returns structured company data including description, employees, updates, and similar companies.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeLinkedInCompany({
+     *   url: ``,
+     * });
+     * ```
      */
     scrapeLinkedInCompany(step: ScrapeLinkedInCompanyStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeLinkedInCompanyStepOutput>>;
     /**
-     * Scrape LinkedIn Profile
-     *
      * Scrape public profile data from a LinkedIn profile page.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a LinkedIn profile URL (e.g. https://www.linkedin.com/in/username).
      * - Returns structured profile data including experience, education, articles, and activities.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeLinkedInProfile({
+     *   url: ``,
+     * });
+     * ```
      */
     scrapeLinkedInProfile(step: ScrapeLinkedInProfileStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeLinkedInProfileStepOutput>>;
     /**
-     * [Meta Threads] Scrape Profile
-     *
      * Scrape a Meta Threads profile
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeMetaThreadsProfile({
+     *   profileUrl: ``,
+     * });
+     * ```
      */
     scrapeMetaThreadsProfile(step: ScrapeMetaThreadsProfileStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeMetaThreadsProfileStepOutput>>;
     /**
-     * Scrape URL
-     *
      * Extract text, HTML, or structured content from one or more web pages.
      *
-     * ## Usage Notes
+     * @remarks
      * - Accepts a single URL or multiple URLs (as a JSON array, comma-separated, or newline-separated).
      * - Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data.
      * - Can optionally capture a screenshot of each page.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeUrl({
+     *   url: ``,
+     * });
+     * ```
      */
     scrapeUrl(step: ScrapeUrlStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeUrlStepOutput>>;
     /**
-     * Scrape X Post
-     *
      * Scrape data from a single X (Twitter) post by URL.
      *
-     * ## Usage Notes
+     * @remarks
      * - Returns structured post data (text, html, optional json/screenshot/metadata).
      * - Optionally saves the text content to a variable.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeXPost({
+     *   url: ``,
+     * });
+     * ```
      */
     scrapeXPost(step: ScrapeXPostStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeXPostStepOutput>>;
     /**
-     * Scrape X Profile
-     *
      * Scrape public profile data from an X (Twitter) account by URL.
      *
-     * ## Usage Notes
+     * @remarks
      * - Returns structured profile data.
      * - Optionally saves the result to a variable.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.scrapeXProfile({
+     *   url: ``,
+     * });
+     * ```
      */
     scrapeXProfile(step: ScrapeXProfileStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeXProfileStepOutput>>;
     /**
-     * Search Google
-     *
      * Search the web using Google and return structured results.
      *
-     * ## Usage Notes
+     * @remarks
      * - Defaults to us/english, but can optionally specify country and/or language.
      * - Defaults to any time, but can optionally specify last hour, last day, week, month, or year.
      * - Defaults to top 30 results, but can specify 1 to 100 results to return.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchGoogle({
+     *   query: ``,
+     *   exportType: "text",
+     * });
+     * ```
      */
     searchGoogle(step: SearchGoogleStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchGoogleStepOutput>>;
     /**
-     * Search Google Images
-     *
      * Search Google Images and return image results with URLs and metadata.
      *
-     * ## Usage Notes
+     * @remarks
      * - Defaults to us/english, but can optionally specify country and/or language.
      * - Defaults to any time, but can optionally specify last hour, last day, week, month, or year.
      * - Defaults to top 30 results, but can specify 1 to 100 results to return.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchGoogleImages({
+     *   query: ``,
+     *   exportType: "text",
+     * });
+     * ```
      */
     searchGoogleImages(step: SearchGoogleImagesStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchGoogleImagesStepOutput>>;
     /**
-     * Search Google News
-     *
      * Search Google News for recent news articles matching a query.
      *
-     * ## Usage Notes
+     * @remarks
      * - Defaults to top 30 results, but can specify 1 to 100 results to return.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchGoogleNews({
+     *   text: ``,
+     *   exportType: "text",
+     * });
+     * ```
      */
     searchGoogleNews(step: SearchGoogleNewsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchGoogleNewsStepOutput>>;
     /**
-     * Search Google Trends
-     *
      * Fetch Google Trends data for a search term.
      *
-     * ## Usage Notes
+     * @remarks
      * - date accepts shorthand ("now 1-H", "today 1-m", "today 5-y", etc.) or custom "yyyy-mm-dd yyyy-mm-dd" ranges.
      * - data_type controls the shape of returned data: TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, or RELATED_QUERIES.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchGoogleTrends({
+     *   text: ``,
+     *   hl: ``,
+     *   geo: ``,
+     *   data_type: "TIMESERIES",
+     *   cat: ``,
+     *   date: ``,
+     *   ts: ``,
+     * });
+     * ```
      */
     searchGoogleTrends(step: SearchGoogleTrendsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchGoogleTrendsStepOutput>>;
     /**
-     * Search Perplexity
-     *
      * Search the web using the Perplexity API and return structured results.
      *
-     * ## Usage Notes
+     * @remarks
      * - Defaults to US results. Use countryCode (ISO code) to filter by country.
      * - Returns 10 results by default, configurable from 1 to 20.
      * - The variable receives text or JSON depending on exportType. The direct execution output always returns structured results.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchPerplexity({
+     *   query: ``,
+     *   exportType: "text",
+     * });
+     * ```
      */
     searchPerplexity(step: SearchPerplexityStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchPerplexityStepOutput>>;
     /**
-     * [X] Search Posts
-     *
      * Search recent X (Twitter) posts matching a query.
      *
-     * ## Usage Notes
+     * @remarks
      * - Searches only the past 7 days of posts.
      * - Query supports X API v2 search operators (up to 512 characters).
-     *
      * Available search operators in query:
-     *
      * | Operator         | Description                                      |
      * | -----------------| -------------------------------------------------|
      * | from:            | Posts from a specific user (e.g., from:elonmusk) |
@@ -4259,269 +4890,443 @@ interface StepMethods {
      * | -                | Excludes specific terms (e.g., -spam)            |
      * | ()               | Groups terms or operators (e.g., (AI OR ML))     |
      * | AND, OR, NOT     | Boolean logic for combining or excluding terms   |
-     *
      * Conjunction-Required Operators (must be combined with a standalone operator):
-     *
      * | Operator     | Description                                    |
      * | ------------ | -----------------------------------------------|
      * | has:media  | Posts containing media (images, videos, or GIFs) |
      * | has:links  | Posts containing URLs                            |
      * | is:retweet | Filters retweets                                 |
      * | is:reply   | Filters replies                                  |
-     *
      * For example, has:media alone is invalid, but #AI has:media is valid.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchXPosts({
+     *   query: ``,
+     *   scope: "recent",
+     *   options: {},
+     * });
+     * ```
      */
     searchXPosts(step: SearchXPostsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchXPostsStepOutput>>;
     /**
-     * [YouTube] Search Videos
-     *
      * Search for YouTube videos by keyword.
      *
-     * ## Usage Notes
+     * @remarks
      * - Supports pagination (up to 5 pages) and country/language filters.
      * - Use the filter/filterType fields for YouTube search parameter (sp) filters.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchYoutube({
+     *   query: ``,
+     *   limitPages: ``,
+     *   filter: ``,
+     *   filterType: ``,
+     * });
+     * ```
      */
     searchYoutube(step: SearchYoutubeStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchYoutubeStepOutput>>;
     /**
-     * [YouTube] Search Trends
-     *
      * Retrieve trending videos on YouTube by category and region.
      *
-     * ## Usage Notes
+     * @remarks
      * - Categories: "now" (trending now), "music", "gaming", "films".
      * - Supports country and language filtering.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.searchYoutubeTrends({
+     *   bp: "now",
+     *   hl: ``,
+     *   gl: ``,
+     * });
+     * ```
      */
     searchYoutubeTrends(step: SearchYoutubeTrendsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchYoutubeTrendsStepOutput>>;
     /**
-     * Send Email
-     *
      * Send an email to one or more configured recipient addresses.
      *
-     * ## Usage Notes
+     * @remarks
      * - Recipient email addresses are resolved from OAuth connections configured by the app creator. The user running the workflow does not specify the recipient directly.
      * - If the body is a URL to a hosted HTML file on the CDN, the HTML is fetched and used as the email body.
      * - When generateHtml is enabled, the body text is converted to a styled HTML email using an AI model.
      * - connectionId can be a comma-separated list to send to multiple recipients.
      * - The special connectionId "trigger_email" uses the email address that triggered the workflow.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.sendEmail({
+     *   subject: ``,
+     *   body: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     sendEmail(step: SendEmailStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SendEmailStepOutput>>;
     /**
-     * Send SMS
-     *
      * Send an SMS text message to a phone number configured via OAuth connection.
      *
-     * ## Usage Notes
+     * @remarks
      * - User is responsible for configuring the connection to the number (MindStudio requires double opt-in to prevent spam)
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.sendSMS({
+     *   body: ``,
+     *   connectionId: ``,
+     * });
+     * ```
      */
     sendSMS(step: SendSMSStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SendSMSStepOutput>>;
     /**
-     * Set Run Title
-     *
      * Set the title of the agent run for the user's history
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.setRunTitle({
+     *   title: ``,
+     * });
+     * ```
      */
     setRunTitle(step: SetRunTitleStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SetRunTitleStepOutput>>;
     /**
-     * Set Variable
-     *
      * Explicitly set a variable to a given value.
      *
-     * ## Usage Notes
+     * @remarks
      * - Useful for bootstrapping global variables or setting constants.
      * - The variable name and value both support variable interpolation.
      * - The type field is a UI hint only (controls input widget in the editor).
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.setVariable({
+     *   value: ``,
+     *   type: "imageUrl",
+     * });
+     * ```
      */
     setVariable(step: SetVariableStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SetVariableStepOutput>>;
     /**
-     * Send Telegram Audio
-     *
      * Send an audio file to a Telegram chat as music or a voice note via a bot.
      *
-     * ## Usage Notes
+     * @remarks
      * - "audio" mode sends as a standard audio file. "voice" mode sends as a voice message (re-uploads the file for large file support).
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.telegramSendAudio({
+     *   botToken: ``,
+     *   chatId: ``,
+     *   audioUrl: ``,
+     *   mode: "audio",
+     * });
+     * ```
      */
     telegramSendAudio(step: TelegramSendAudioStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TelegramSendAudioStepOutput>>;
     /**
-     * Send Telegram File
-     *
      * Send a document/file to a Telegram chat via a bot.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.telegramSendFile({
+     *   botToken: ``,
+     *   chatId: ``,
+     *   fileUrl: ``,
+     * });
+     * ```
      */
     telegramSendFile(step: TelegramSendFileStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TelegramSendFileStepOutput>>;
     /**
-     * Send Telegram Image
-     *
      * Send an image to a Telegram chat via a bot.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.telegramSendImage({
+     *   botToken: ``,
+     *   chatId: ``,
+     *   imageUrl: ``,
+     * });
+     * ```
      */
     telegramSendImage(step: TelegramSendImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TelegramSendImageStepOutput>>;
     /**
-     * Send Telegram Message
-     *
      * Send a text message to a Telegram chat via a bot.
      *
-     * ## Usage Notes
+     * @remarks
      * - Messages are sent using MarkdownV2 formatting. Special characters are auto-escaped.
      * - botToken format is "botId:token" — both parts are required.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.telegramSendMessage({
+     *   botToken: ``,
+     *   chatId: ``,
+     *   text: ``,
+     * });
+     * ```
      */
     telegramSendMessage(step: TelegramSendMessageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TelegramSendMessageStepOutput>>;
     /**
-     * Send Telegram Video
-     *
      * Send a video to a Telegram chat via a bot.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.telegramSendVideo({
+     *   botToken: ``,
+     *   chatId: ``,
+     *   videoUrl: ``,
+     * });
+     * ```
      */
     telegramSendVideo(step: TelegramSendVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TelegramSendVideoStepOutput>>;
     /**
-     * Telegram Set Typing
-     *
      * Show the "typing..." indicator in a Telegram chat via a bot.
      *
-     * ## Usage Notes
+     * @remarks
      * - The typing indicator automatically expires after a few seconds. Use this right before sending a message for a natural feel.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.telegramSetTyping({
+     *   botToken: ``,
+     *   chatId: ``,
+     * });
+     * ```
      */
     telegramSetTyping(step: TelegramSetTypingStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TelegramSetTypingStepOutput>>;
     /**
-     * Text to Speech
-     *
      * Generate an audio file from provided text using a speech model.
      *
-     * ## Usage Notes
+     * @remarks
      * - The text field contains the exact words to be spoken (not instructions).
      * - In foreground mode, the audio is displayed to the user. In background mode, the URL is saved to a variable.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.textToSpeech({
+     *   text: ``,
+     * });
+     * ```
      */
     textToSpeech(step: TextToSpeechStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TextToSpeechStepOutput>>;
     /**
-     * Transcribe Audio
-     *
      * Convert an audio file to text using a transcription model.
      *
-     * ## Usage Notes
+     * @remarks
      * - The prompt field provides optional context to improve transcription accuracy (e.g. language, speaker names, domain).
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.transcribeAudio({
+     *   audioUrl: ``,
+     *   prompt: ``,
+     * });
+     * ```
      */
     transcribeAudio(step: TranscribeAudioStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TranscribeAudioStepOutput>>;
     /**
-     * Trim Media
-     *
      * Trim an audio or video clip
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.trimMedia({
+     *   inputUrl: ``,
+     * });
+     * ```
      */
     trimMedia(step: TrimMediaStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<TrimMediaStepOutput>>;
     /**
-     * [Google Calendar] Update Event
-     *
      * Update an existing event on a Google Calendar. Only specified fields are changed.
      *
-     * ## Usage Notes
+     * @remarks
      * - Requires a Google OAuth connection with Calendar events scope.
      * - Fetches the existing event first, then applies only the provided updates. Omitted fields are left unchanged.
      * - Attendees are specified as one email address per line, and replace the entire attendee list.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.updateGoogleCalendarEvent({
+     *   connectionId: ``,
+     *   eventId: ``,
+     * });
+     * ```
      */
     updateGoogleCalendarEvent(step: UpdateGoogleCalendarEventStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UpdateGoogleCalendarEventStepOutput>>;
     /**
-     * [Google] Update Google Doc
-     *
      * Update the contents of an existing Google Document.
      *
-     * ## Usage Notes
+     * @remarks
      * - operationType controls how content is applied: "addToTop" prepends, "addToBottom" appends, "overwrite" replaces all content.
      * - textType determines how the text field is interpreted: "plain" for plain text, "html" for HTML markup, "markdown" for Markdown.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.updateGoogleDoc({
+     *   documentId: ``,
+     *   connectionId: ``,
+     *   text: ``,
+     *   textType: "plain",
+     *   operationType: "addToTop",
+     * });
+     * ```
      */
     updateGoogleDoc(step: UpdateGoogleDocStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UpdateGoogleDocStepOutput>>;
     /**
-     * [Google] Update Google Sheet
-     *
      * Update a Google Spreadsheet with new data.
      *
-     * ## Usage Notes
+     * @remarks
      * - operationType controls how data is written: "addToBottom" appends rows, "overwrite" replaces all data, "range" writes to a specific cell range.
      * - Data should be provided as CSV in the text field.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.updateGoogleSheet({
+     *   text: ``,
+     *   connectionId: ``,
+     *   spreadsheetId: ``,
+     *   range: ``,
+     *   operationType: "addToBottom",
+     * });
+     * ```
      */
     updateGoogleSheet(step: UpdateGoogleSheetStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UpdateGoogleSheetStepOutput>>;
     /**
-     * Upload Data Source Document
-     *
      * Upload a file into an existing data source from a URL or raw text content.
      *
-     * ## Usage Notes
+     * @remarks
      * - If "file" is a single URL, the file is downloaded from that URL and uploaded.
      * - If "file" is any other string, a .txt document is created from that content and uploaded.
      * - The block waits (polls) for processing to complete before transitioning, up to 5 minutes.
      * - Once processing finishes, vectors are loaded into Milvus so the data source is immediately queryable.
      * - Supported file types (when using a URL) are the same as the data source upload UI (PDF, DOCX, TXT, etc.).
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.uploadDataSourceDocument({
+     *   dataSourceId: ``,
+     *   file: ``,
+     *   fileName: ``,
+     * });
+     * ```
      */
     uploadDataSourceDocument(step: UploadDataSourceDocumentStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UploadDataSourceDocumentStepOutput>>;
     /**
-     * Upscale Image
-     *
      * Increase the resolution of an image using AI upscaling.
      *
-     * ## Usage Notes
+     * @remarks
      * - Output is re-hosted on the CDN as a PNG.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.upscaleImage({
+     *   imageUrl: ``,
+     *   targetResolution: "2k",
+     *   engine: "standard",
+     * });
+     * ```
      */
     upscaleImage(step: UpscaleImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UpscaleImageStepOutput>>;
     /**
-     * Upscale Video
-     *
      * Upscale a video file
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.upscaleVideo({
+     *   videoUrl: ``,
+     *   targetResolution: "720p",
+     *   engine: "standard",
+     * });
+     * ```
      */
     upscaleVideo(step: UpscaleVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UpscaleVideoStepOutput>>;
     /**
-     * User Message
-     *
      * Send a message to an AI model and return the response, or echo a system message.
      *
-     * ## Usage Notes
+     * @remarks
      * - 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.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.generateText({
+     *   message: ``,
+     * });
+     * ```
      */
     generateText(step: UserMessageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<UserMessageStepOutput>>;
     /**
-     * Video Face Swap
-     *
      * Swap faces in a video file
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.videoFaceSwap({
+     *   videoUrl: ``,
+     *   faceImageUrl: ``,
+     *   targetIndex: 0,
+     *   engine: ``,
+     * });
+     * ```
      */
     videoFaceSwap(step: VideoFaceSwapStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<VideoFaceSwapStepOutput>>;
     /**
-     * Remove Video Background
-     *
      * Remove or replace background from a video
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.videoRemoveBackground({
+     *   videoUrl: ``,
+     *   newBackground: "transparent",
+     *   engine: ``,
+     * });
+     * ```
      */
     videoRemoveBackground(step: VideoRemoveBackgroundStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<VideoRemoveBackgroundStepOutput>>;
     /**
-     * Remove Video Watermark
-     *
      * Remove a watermark from a video
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.videoRemoveWatermark({
+     *   videoUrl: ``,
+     *   engine: ``,
+     * });
+     * ```
      */
     videoRemoveWatermark(step: VideoRemoveWatermarkStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<VideoRemoveWatermarkStepOutput>>;
     /**
-     * Watermark Image
-     *
      * Overlay a watermark image onto another image.
      *
-     * ## Usage Notes
+     * @remarks
      * - The watermark is placed at the specified corner with configurable padding and width.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.watermarkImage({
+     *   imageUrl: ``,
+     *   watermarkImageUrl: ``,
+     *   corner: "top-left",
+     *   paddingPx: 0,
+     *   widthPx: 0,
+     * });
+     * ```
      */
     watermarkImage(step: WatermarkImageStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<WatermarkImageStepOutput>>;
     /**
-     * Watermark Video
-     *
      * Add an image watermark to a video
      *
-     * ## Usage Notes
-     *
+     * @example
+     * ```typescript
+     * const result = await agent.watermarkVideo({
+     *   videoUrl: ``,
+     *   imageUrl: ``,
+     *   corner: "top-left",
+     *   paddingPx: 0,
+     *   widthPx: 0,
+     * });
+     * ```
      */
     watermarkVideo(step: WatermarkVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<WatermarkVideoStepOutput>>;
 }