@mindstudio-ai/agent 0.1.18 → 0.1.20

package/dist/index.d.ts

@@ -726,6 +726,7 @@ declare class Query<T> implements PromiseLike<T[]> {
  * (fast path) or a fallback SELECT * with JS processing metadata.
  */
 interface CompiledQuery<T> {
+    type: 'query';
     /** Compiled SQL query, or null if JS fallback needed. */
     query: SqlQuery | null;
     /** SELECT * fallback query, or null if SQL compiled. */
@@ -744,12 +745,76 @@ interface CompiledQuery<T> {
     offset?: number;
 }
 
+/**
+ * Mutation<T> — a lazy write operation backed by SQLite.
+ *
+ * Created by Table write methods (push, update, remove, removeAll, clear).
+ * Like Query, implements PromiseLike so `await` triggers execution. Unlike
+ * Query, there's no chaining — a Mutation is a fixed set of SQL statements
+ * with a result processor.
+ *
+ * ## Batch support
+ *
+ * `db.batch()` calls `_compile()` to extract the SQL without executing,
+ * then bundles it with other operations into a single round trip. After
+ * execution, `_processResults()` deserializes the raw SQL results.
+ *
+ * ## Non-batchable mutations
+ *
+ * Some mutations (e.g. `removeAll` with a JS-fallback predicate) require
+ * multi-step execution that can't be expressed as a fixed SQL batch.
+ * These are created via `Mutation.fromExecutor()` and work fine when
+ * awaited standalone, but throw if passed to `db.batch()`.
+ */
+
+interface CompiledMutation<TResult> {
+    type: 'mutation';
+    queries: SqlQuery[];
+    config: TableConfig;
+    processResult: (results: SqlResult[]) => TResult;
+}
+declare class Mutation<TResult> implements PromiseLike<TResult> {
+    /** @internal */
+    private readonly _config;
+    /** @internal */
+    private readonly _queries;
+    /** @internal */
+    private readonly _processResult;
+    /** @internal Non-batchable executor for complex mutations (e.g. removeAll JS fallback). */
+    private readonly _executor;
+    constructor(config: TableConfig, queries: SqlQuery[], processResult: (results: SqlResult[]) => TResult);
+    /**
+     * Create a non-batchable mutation that wraps an async executor.
+     * Used for operations that require multi-step execution (e.g. removeAll
+     * with a JS-fallback predicate: fetch all rows → filter → delete).
+     *
+     * Works fine when awaited standalone. Throws if passed to db.batch().
+     *
+     * @internal
+     */
+    static fromExecutor<T>(config: TableConfig, executor: () => Promise<T>): Mutation<T>;
+    then<T1 = TResult, T2 = never>(onfulfilled?: ((value: TResult) => T1 | PromiseLike<T1>) | null, onrejected?: ((reason: unknown) => T2 | PromiseLike<T2>) | null): Promise<T1 | T2>;
+    /**
+     * @internal Compile this mutation into SQL for batch execution.
+     * Returns the queries and a result processor.
+     *
+     * Throws if this is a non-batchable mutation (created via fromExecutor).
+     */
+    _compile(): CompiledMutation<TResult>;
+    /**
+     * @internal Process raw SQL results into the typed result.
+     * Used by db.batch() after executing the compiled queries.
+     */
+    static _processResults<T>(results: SqlResult[], compiled: CompiledMutation<T>): T;
+    private _execute;
+}
+
 /**
  * Table<T> — a typed persistent collection backed by SQLite.
  *
  * Created via `db.defineTable<T>(name)`. Every method either returns a
- * chainable Query<T> (for lazy reads) or a Promise (for terminal reads
- * and writes).
+ * chainable Query<T> (for lazy reads), a Mutation<T> (for lazy writes),
+ * or a Promise (for terminal reads).
  *
  * ## Write operations use RETURNING
  *
@@ -781,19 +846,19 @@ declare class Table<T> {
      * Uses `INSERT ... RETURNING *` so the created row comes back in a
      * single round trip — no separate SELECT needed.
      */
-    push(data: PushInput<T>): Promise<T>;
-    push(data: PushInput<T>[]): Promise<T[]>;
+    push(data: PushInput<T>): Mutation<T>;
+    push(data: PushInput<T>[]): Mutation<T[]>;
     /**
      * Update a row by ID. Only the provided fields are changed.
      * Returns the updated row via `UPDATE ... RETURNING *`.
      */
-    update(id: string, data: UpdateInput<T>): Promise<T>;
-    remove(id: string): Promise<void>;
+    update(id: string, data: UpdateInput<T>): Mutation<T>;
+    remove(id: string): Mutation<void>;
     /**
      * Remove all rows matching a predicate. Returns the count removed.
      */
-    removeAll(predicate: Predicate<T>): Promise<number>;
-    clear(): Promise<void>;
+    removeAll(predicate: Predicate<T>): Mutation<number>;
+    clear(): Mutation<void>;
 }
 
 /**
@@ -904,18 +969,21 @@ interface Db {
     /** Returns a unix timestamp for (now + duration). Use with days/hours/minutes. */
     fromNow(ms: number): number;
     /**
-     * Execute multiple queries in a single round trip. All queries run on
-     * the same database connection, eliminating per-query HTTP overhead.
+     * Execute multiple reads and writes in a single round trip. All
+     * operations run on the same database connection, eliminating
+     * per-operation HTTP overhead. Writes execute in argument order.
      *
-     * Accepts Query objects (lazy, not yet executed). Compiles them to SQL,
+     * Accepts Query objects (reads) and Mutation objects (writes from
+     * push, update, remove, removeAll, clear). Compiles them to SQL,
      * sends all in one batch request, and returns typed results.
      *
      * @example
      * ```ts
-     * const [orders, approvals, vendors] = await db.batch(
-     *   Orders.filter(o => o.status === 'active').take(10),
-     *   Approvals.filter(a => a.status === 'pending').take(25),
-     *   Vendors.sortBy(v => v.createdAt).reverse().take(5),
+     * // Mixed reads and writes in one round trip
+     * const [, newCard, cards] = await db.batch(
+     *   Cards.update(card1.id, { position: 1 }),
+     *   Cards.push({ title: 'New', columnId, position: 0 }),
+     *   Cards.filter(c => c.columnId === columnId),
      * );
      * ```
      */
@@ -3924,6 +3992,23 @@ interface ScrapeXProfileStepOutput {
         };
     };
 }
+interface ScreenshotUrlStepInput {
+    /** URL to screenshot */
+    url: string;
+    /** Screenshot mode: viewport captures visible area, fullPage captures entire page */
+    mode?: "viewport" | "fullPage";
+    /** Viewport width in pixels (default: 1280) */
+    width?: number;
+    /** Viewport height in pixels (default: 800, ignored for fullPage mode) */
+    height?: number;
+    /** Milliseconds to wait before capturing (default: 0) */
+    delay?: number;
+    /** CSS selector to wait for before capturing */
+    waitFor?: string;
+}
+interface ScreenshotUrlStepOutput {
+    screenshotUrl: string;
+}
 interface SearchGmailEmailsStepInput {
     /** Gmail search query (e.g. "from:user@example.com", "subject:invoice", "is:unread") */
     query: string;
@@ -4717,7 +4802,7 @@ type GenerateAssetStepOutput = GeneratePdfStepOutput;
 type GenerateTextStepInput = UserMessageStepInput;
 type GenerateTextStepOutput = UserMessageStepOutput;
 /** Union of all available step type names. */
-type StepName = "activeCampaignAddNote" | "activeCampaignCreateContact" | "addSubtitlesToVideo" | "airtableCreateUpdateRecord" | "airtableDeleteRecord" | "airtableGetRecord" | "airtableGetTableRecords" | "analyzeImage" | "analyzeVideo" | "captureThumbnail" | "checkAppRole" | "codaCreateUpdatePage" | "codaCreateUpdateRow" | "codaFindRow" | "codaGetPage" | "codaGetTableRows" | "convertPdfToImages" | "createDataSource" | "createGmailDraft" | "createGoogleCalendarEvent" | "createGoogleDoc" | "createGoogleSheet" | "deleteDataSource" | "deleteDataSourceDocument" | "deleteGmailEmail" | "deleteGoogleCalendarEvent" | "deleteGoogleSheetRows" | "detectChanges" | "detectPII" | "discordEditMessage" | "discordSendFollowUp" | "discordSendMessage" | "downloadVideo" | "enhanceImageGenerationPrompt" | "enhanceVideoGenerationPrompt" | "enrichPerson" | "extractAudioFromVideo" | "extractText" | "fetchDataSourceDocument" | "fetchGoogleDoc" | "fetchGoogleSheet" | "fetchSlackChannelHistory" | "fetchYoutubeCaptions" | "fetchYoutubeChannel" | "fetchYoutubeComments" | "fetchYoutubeVideo" | "generateChart" | "generateImage" | "generateLipsync" | "generateMusic" | "generatePdf" | "generateStaticVideoFromImage" | "generateVideo" | "getGmailAttachments" | "getGmailDraft" | "getGmailEmail" | "getGmailUnreadCount" | "getGoogleCalendarEvent" | "getGoogleDriveFile" | "getGoogleSheetInfo" | "getMediaMetadata" | "httpRequest" | "hubspotCreateCompany" | "hubspotCreateContact" | "hubspotGetCompany" | "hubspotGetContact" | "hunterApiCompanyEnrichment" | "hunterApiDomainSearch" | "hunterApiEmailFinder" | "hunterApiEmailVerification" | "hunterApiPersonEnrichment" | "imageFaceSwap" | "imageRemoveWatermark" | "insertVideoClips" | "listDataSources" | "listGmailDrafts" | "listGmailLabels" | "listGoogleCalendarEvents" | "listGoogleDriveFiles" | "listRecentGmailEmails" | "logic" | "makeDotComRunScenario" | "mergeAudio" | "mergeVideos" | "mixAudioIntoVideo" | "muteVideo" | "n8nRunNode" | "notionCreatePage" | "notionUpdatePage" | "peopleSearch" | "postToLinkedIn" | "postToSlackChannel" | "postToX" | "postToZapier" | "queryAppDatabase" | "queryDataSource" | "queryExternalDatabase" | "redactPII" | "removeBackgroundFromImage" | "replyToGmailEmail" | "resizeVideo" | "runFromConnectorRegistry" | "runPackagedWorkflow" | "scrapeFacebookPage" | "scrapeFacebookPosts" | "scrapeInstagramComments" | "scrapeInstagramMentions" | "scrapeInstagramPosts" | "scrapeInstagramProfile" | "scrapeInstagramReels" | "scrapeLinkedInCompany" | "scrapeLinkedInProfile" | "scrapeMetaThreadsProfile" | "scrapeUrl" | "scrapeXPost" | "scrapeXProfile" | "searchGmailEmails" | "searchGoogle" | "searchGoogleCalendarEvents" | "searchGoogleDrive" | "searchGoogleImages" | "searchGoogleNews" | "searchGoogleTrends" | "searchPerplexity" | "searchXPosts" | "searchYoutube" | "searchYoutubeTrends" | "sendEmail" | "sendGmailDraft" | "sendGmailMessage" | "sendSMS" | "setGmailReadStatus" | "setRunTitle" | "setVariable" | "telegramEditMessage" | "telegramReplyToMessage" | "telegramSendAudio" | "telegramSendFile" | "telegramSendImage" | "telegramSendMessage" | "telegramSendVideo" | "telegramSetTyping" | "textToSpeech" | "transcribeAudio" | "trimMedia" | "updateGmailLabels" | "updateGoogleCalendarEvent" | "updateGoogleDoc" | "updateGoogleSheet" | "uploadDataSourceDocument" | "upscaleImage" | "upscaleVideo" | "userMessage" | "videoFaceSwap" | "videoRemoveBackground" | "videoRemoveWatermark" | "watermarkImage" | "watermarkVideo";
+type StepName = "activeCampaignAddNote" | "activeCampaignCreateContact" | "addSubtitlesToVideo" | "airtableCreateUpdateRecord" | "airtableDeleteRecord" | "airtableGetRecord" | "airtableGetTableRecords" | "analyzeImage" | "analyzeVideo" | "captureThumbnail" | "checkAppRole" | "codaCreateUpdatePage" | "codaCreateUpdateRow" | "codaFindRow" | "codaGetPage" | "codaGetTableRows" | "convertPdfToImages" | "createDataSource" | "createGmailDraft" | "createGoogleCalendarEvent" | "createGoogleDoc" | "createGoogleSheet" | "deleteDataSource" | "deleteDataSourceDocument" | "deleteGmailEmail" | "deleteGoogleCalendarEvent" | "deleteGoogleSheetRows" | "detectChanges" | "detectPII" | "discordEditMessage" | "discordSendFollowUp" | "discordSendMessage" | "downloadVideo" | "enhanceImageGenerationPrompt" | "enhanceVideoGenerationPrompt" | "enrichPerson" | "extractAudioFromVideo" | "extractText" | "fetchDataSourceDocument" | "fetchGoogleDoc" | "fetchGoogleSheet" | "fetchSlackChannelHistory" | "fetchYoutubeCaptions" | "fetchYoutubeChannel" | "fetchYoutubeComments" | "fetchYoutubeVideo" | "generateChart" | "generateImage" | "generateLipsync" | "generateMusic" | "generatePdf" | "generateStaticVideoFromImage" | "generateVideo" | "getGmailAttachments" | "getGmailDraft" | "getGmailEmail" | "getGmailUnreadCount" | "getGoogleCalendarEvent" | "getGoogleDriveFile" | "getGoogleSheetInfo" | "getMediaMetadata" | "httpRequest" | "hubspotCreateCompany" | "hubspotCreateContact" | "hubspotGetCompany" | "hubspotGetContact" | "hunterApiCompanyEnrichment" | "hunterApiDomainSearch" | "hunterApiEmailFinder" | "hunterApiEmailVerification" | "hunterApiPersonEnrichment" | "imageFaceSwap" | "imageRemoveWatermark" | "insertVideoClips" | "listDataSources" | "listGmailDrafts" | "listGmailLabels" | "listGoogleCalendarEvents" | "listGoogleDriveFiles" | "listRecentGmailEmails" | "logic" | "makeDotComRunScenario" | "mergeAudio" | "mergeVideos" | "mixAudioIntoVideo" | "muteVideo" | "n8nRunNode" | "notionCreatePage" | "notionUpdatePage" | "peopleSearch" | "postToLinkedIn" | "postToSlackChannel" | "postToX" | "postToZapier" | "queryAppDatabase" | "queryDataSource" | "queryExternalDatabase" | "redactPII" | "removeBackgroundFromImage" | "replyToGmailEmail" | "resizeVideo" | "runFromConnectorRegistry" | "runPackagedWorkflow" | "scrapeFacebookPage" | "scrapeFacebookPosts" | "scrapeInstagramComments" | "scrapeInstagramMentions" | "scrapeInstagramPosts" | "scrapeInstagramProfile" | "scrapeInstagramReels" | "scrapeLinkedInCompany" | "scrapeLinkedInProfile" | "scrapeMetaThreadsProfile" | "scrapeUrl" | "scrapeXPost" | "scrapeXProfile" | "screenshotUrl" | "searchGmailEmails" | "searchGoogle" | "searchGoogleCalendarEvents" | "searchGoogleDrive" | "searchGoogleImages" | "searchGoogleNews" | "searchGoogleTrends" | "searchPerplexity" | "searchXPosts" | "searchYoutube" | "searchYoutubeTrends" | "sendEmail" | "sendGmailDraft" | "sendGmailMessage" | "sendSMS" | "setGmailReadStatus" | "setRunTitle" | "setVariable" | "telegramEditMessage" | "telegramReplyToMessage" | "telegramSendAudio" | "telegramSendFile" | "telegramSendImage" | "telegramSendMessage" | "telegramSendVideo" | "telegramSetTyping" | "textToSpeech" | "transcribeAudio" | "trimMedia" | "updateGmailLabels" | "updateGoogleCalendarEvent" | "updateGoogleDoc" | "updateGoogleSheet" | "uploadDataSourceDocument" | "upscaleImage" | "upscaleVideo" | "userMessage" | "videoFaceSwap" | "videoRemoveBackground" | "videoRemoveWatermark" | "watermarkImage" | "watermarkVideo";
 /** Maps step names to their input types. */
 interface StepInputMap {
     activeCampaignAddNote: ActiveCampaignAddNoteStepInput;
@@ -4836,6 +4921,7 @@ interface StepInputMap {
     scrapeUrl: ScrapeUrlStepInput;
     scrapeXPost: ScrapeXPostStepInput;
     scrapeXProfile: ScrapeXProfileStepInput;
+    screenshotUrl: ScreenshotUrlStepInput;
     searchGmailEmails: SearchGmailEmailsStepInput;
     searchGoogle: SearchGoogleStepInput;
     searchGoogleCalendarEvents: SearchGoogleCalendarEventsStepInput;
@@ -4997,6 +5083,7 @@ interface StepOutputMap {
     scrapeUrl: ScrapeUrlStepOutput;
     scrapeXPost: ScrapeXPostStepOutput;
     scrapeXProfile: ScrapeXProfileStepOutput;
+    screenshotUrl: ScreenshotUrlStepOutput;
     searchGmailEmails: SearchGmailEmailsStepOutput;
     searchGoogle: SearchGoogleStepOutput;
     searchGoogleCalendarEvents: SearchGoogleCalendarEventsStepOutput;
@@ -6938,6 +7025,23 @@ interface StepMethods {
      * ```
      */
     scrapeXProfile(step: ScrapeXProfileStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScrapeXProfileStepOutput>>;
+    /**
+     * Capture a screenshot of a web page as a PNG image.
+     *
+     * @remarks
+     * - Takes a viewport or full-page screenshot of the given URL.
+     * - Returns a CDN-hosted PNG image URL.
+     * - Viewport mode captures only the visible area; fullPage captures the entire scrollable page.
+     * - You can customize viewport width/height, add a delay, or wait for a CSS selector before capturing.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.screenshotUrl({
+     *   url: ``,
+     * });
+     * ```
+     */
+    screenshotUrl(step: ScreenshotUrlStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ScreenshotUrlStepOutput>>;
     /**
      * Search for emails in the connected Gmail account using a Gmail search query. To list recent inbox emails, pass an empty query string.
      *
@@ -7765,4 +7869,4 @@ declare const stream: (data: string | Record<string, unknown>) => Promise<void>;
  */
 declare const resolveUser: (userId: string) => Promise<ResolvedUser | null>;
 
-export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type BatchStepInput, type BatchStepResult, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HttpRequestStepInput, type HttpRequestStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, Query, type QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type ScrapeFacebookPageStepInput, type ScrapeFacebookPageStepOutput, type ScrapeFacebookPostsStepInput, type ScrapeFacebookPostsStepOutput, type ScrapeInstagramCommentsStepInput, type ScrapeInstagramCommentsStepOutput, type ScrapeInstagramMentionsStepInput, type ScrapeInstagramMentionsStepOutput, type ScrapeInstagramPostsStepInput, type ScrapeInstagramPostsStepOutput, type ScrapeInstagramProfileStepInput, type ScrapeInstagramProfileStepOutput, type ScrapeInstagramReelsStepInput, type ScrapeInstagramReelsStepOutput, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeMetaThreadsProfileStepInput, type ScrapeMetaThreadsProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, type SystemFields, Table, type TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, auth, blockTypeAliases, db, mindstudio as default, mindstudio, monacoSnippets, resolveUser, stepMetadata, stream };
+export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type BatchStepInput, type BatchStepResult, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HttpRequestStepInput, type HttpRequestStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, Query, type QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type ScrapeFacebookPageStepInput, type ScrapeFacebookPageStepOutput, type ScrapeFacebookPostsStepInput, type ScrapeFacebookPostsStepOutput, type ScrapeInstagramCommentsStepInput, type ScrapeInstagramCommentsStepOutput, type ScrapeInstagramMentionsStepInput, type ScrapeInstagramMentionsStepOutput, type ScrapeInstagramPostsStepInput, type ScrapeInstagramPostsStepOutput, type ScrapeInstagramProfileStepInput, type ScrapeInstagramProfileStepOutput, type ScrapeInstagramReelsStepInput, type ScrapeInstagramReelsStepOutput, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeMetaThreadsProfileStepInput, type ScrapeMetaThreadsProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type ScreenshotUrlStepInput, type ScreenshotUrlStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, type SystemFields, Table, type TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, auth, blockTypeAliases, db, mindstudio as default, mindstudio, monacoSnippets, resolveUser, stepMetadata, stream };

package/dist/index.js

@@ -951,10 +951,11 @@ var Query = class _Query {
         limit: this._limit,
         offset: this._offset
       });
-      return { query, fallbackQuery: null, config: this._config };
+      return { type: "query", query, fallbackQuery: null, config: this._config };
     }
     const fallbackQuery = buildSelect(this._config.tableName);
     return {
+      type: "query",
       query: null,
       fallbackQuery,
       config: this._config,
@@ -1084,6 +1085,83 @@ function extractFieldName(accessor) {
   return match?.[2] ?? null;
 }
 
+// src/db/mutation.ts
+var Mutation = class _Mutation {
+  /** @internal */
+  _config;
+  /** @internal */
+  _queries;
+  /** @internal */
+  _processResult;
+  /** @internal Non-batchable executor for complex mutations (e.g. removeAll JS fallback). */
+  _executor;
+  constructor(config, queries, processResult) {
+    this._config = config;
+    this._queries = queries;
+    this._processResult = processResult;
+    this._executor = void 0;
+  }
+  /**
+   * Create a non-batchable mutation that wraps an async executor.
+   * Used for operations that require multi-step execution (e.g. removeAll
+   * with a JS-fallback predicate: fetch all rows → filter → delete).
+   *
+   * Works fine when awaited standalone. Throws if passed to db.batch().
+   *
+   * @internal
+   */
+  static fromExecutor(config, executor) {
+    const m = new _Mutation(config, [], () => void 0);
+    Object.defineProperty(m, "_executor", { value: executor });
+    return m;
+  }
+  // -------------------------------------------------------------------------
+  // PromiseLike — executes on await
+  // -------------------------------------------------------------------------
+  then(onfulfilled, onrejected) {
+    return this._execute().then(onfulfilled, onrejected);
+  }
+  // -------------------------------------------------------------------------
+  // Batch compilation — used by db.batch()
+  // -------------------------------------------------------------------------
+  /**
+   * @internal Compile this mutation into SQL for batch execution.
+   * Returns the queries and a result processor.
+   *
+   * Throws if this is a non-batchable mutation (created via fromExecutor).
+   */
+  _compile() {
+    if (this._executor) {
+      throw new Error(
+        "This operation cannot be batched (e.g. removeAll with a predicate that cannot compile to SQL). Await it separately."
+      );
+    }
+    return {
+      type: "mutation",
+      queries: this._queries,
+      config: this._config,
+      processResult: this._processResult
+    };
+  }
+  /**
+   * @internal Process raw SQL results into the typed result.
+   * Used by db.batch() after executing the compiled queries.
+   */
+  static _processResults(results, compiled) {
+    return compiled.processResult(results);
+  }
+  // -------------------------------------------------------------------------
+  // Execution
+  // -------------------------------------------------------------------------
+  async _execute() {
+    if (this._executor) {
+      return this._executor();
+    }
+    const results = await this._config.executeBatch(this._queries);
+    return this._processResult(results);
+  }
+};
+
 // src/db/table.ts
 var Table = class {
   /** @internal */
@@ -1147,7 +1225,7 @@ var Table = class {
   sortBy(accessor) {
     return new Query(this._config).sortBy(accessor);
   }
-  async push(data) {
+  push(data) {
     const isArray = Array.isArray(data);
     const items = isArray ? data : [data];
     const queries = items.map(
@@ -1157,71 +1235,76 @@ var Table = class {
         this._config.columns
       )
     );
-    const results = await this._config.executeBatch(queries);
-    const rows = results.map((r) => {
-      if (r.rows.length > 0) {
-        return deserializeRow(
-          r.rows[0],
-          this._config.columns
-        );
-      }
-      return void 0;
+    return new Mutation(this._config, queries, (results) => {
+      const rows = results.map((r) => {
+        if (r.rows.length > 0) {
+          return deserializeRow(
+            r.rows[0],
+            this._config.columns
+          );
+        }
+        return void 0;
+      });
+      return isArray ? rows : rows[0];
     });
-    return isArray ? rows : rows[0];
   }
   /**
    * Update a row by ID. Only the provided fields are changed.
    * Returns the updated row via `UPDATE ... RETURNING *`.
    */
-  async update(id, data) {
+  update(id, data) {
     const query = buildUpdate(
       this._config.tableName,
       id,
       data,
       this._config.columns
     );
-    const results = await this._config.executeBatch([query]);
-    return deserializeRow(
-      results[0].rows[0],
-      this._config.columns
+    return new Mutation(
+      this._config,
+      [query],
+      (results) => deserializeRow(
+        results[0].rows[0],
+        this._config.columns
+      )
     );
   }
-  async remove(id) {
+  remove(id) {
     const query = buildDelete(this._config.tableName, `id = ?`, [id]);
-    await this._config.executeBatch([query]);
+    return new Mutation(this._config, [query], () => void 0);
   }
   /**
    * Remove all rows matching a predicate. Returns the count removed.
    */
-  async removeAll(predicate) {
+  removeAll(predicate) {
     const compiled = compilePredicate(predicate);
     if (compiled.type === "sql") {
       const query = buildDelete(this._config.tableName, compiled.where);
-      const results = await this._config.executeBatch([query]);
-      return results[0].changes;
+      return new Mutation(this._config, [query], (results) => results[0].changes);
     }
-    console.warn(
-      `[mindstudio] removeAll predicate on ${this._config.tableName} could not be compiled to SQL \u2014 fetching all rows first`
-    );
-    const allQuery = buildSelect(this._config.tableName);
-    const allResults = await this._config.executeBatch([allQuery]);
-    const allRows = allResults[0].rows.map(
-      (r) => deserializeRow(
-        r,
-        this._config.columns
-      )
-    );
-    const matching = allRows.filter((row) => predicate(row));
-    if (matching.length === 0) return 0;
-    const deleteQueries = matching.filter((row) => row.id).map((row) => buildDelete(this._config.tableName, `id = ?`, [row.id]));
-    if (deleteQueries.length > 0) {
-      await this._config.executeBatch(deleteQueries);
-    }
-    return matching.length;
+    return Mutation.fromExecutor(this._config, async () => {
+      console.warn(
+        `[mindstudio] removeAll predicate on ${this._config.tableName} could not be compiled to SQL \u2014 fetching all rows first`
+      );
+      const allQuery = buildSelect(this._config.tableName);
+      const allResults = await this._config.executeBatch([allQuery]);
+      const allRows = allResults[0].rows.map(
+        (r) => deserializeRow(
+          r,
+          this._config.columns
+        )
+      );
+      const matching = allRows.filter((row) => predicate(row));
+      if (matching.length === 0) return 0;
+      const deleteQueries = matching.filter((row) => row.id).map((row) => buildDelete(this._config.tableName, `id = ?`, [row.id]));
+      if (deleteQueries.length > 0) {
+        await this._config.executeBatch(deleteQueries);
+      }
+      return matching.length;
+    });
   }
-  async clear() {
+  clear() {
     const query = buildDelete(this._config.tableName);
-    await this._config.executeBatch([query]);
+    return new Mutation(this._config, [query], () => void 0);
   }
 };
 
@@ -1247,44 +1330,64 @@ function createDb(databases, executeBatch) {
     ago: (ms) => Date.now() - ms,
     fromNow: (ms) => Date.now() + ms,
     // --- Batch execution ---
-    batch: ((...queries) => {
+    batch: ((...operations) => {
       return (async () => {
-        const compiled = queries.map((q) => {
-          if (!(q instanceof Query)) {
-            throw new MindStudioError(
-              "db.batch() only accepts Query objects (from .filter(), .sortBy(), etc.)",
-              "invalid_batch_query",
-              400
-            );
+        const compiled = operations.map((op) => {
+          if (op instanceof Query) {
+            return op._compile();
+          }
+          if (op instanceof Mutation) {
+            return op._compile();
           }
-          return q._compile();
+          throw new MindStudioError(
+            "db.batch() only accepts Query and Mutation objects (from .filter(), .update(), .push(), etc.)",
+            "invalid_batch_operation",
+            400
+          );
         });
         const groups = /* @__PURE__ */ new Map();
         for (let i = 0; i < compiled.length; i++) {
           const c = compiled[i];
           const dbId = c.config.databaseId;
-          const sqlQuery = c.query ?? c.fallbackQuery;
           if (!groups.has(dbId)) groups.set(dbId, []);
-          groups.get(dbId).push({ index: i, sqlQuery });
+          if (c.type === "query") {
+            const sqlQuery = c.query ?? c.fallbackQuery;
+            groups.get(dbId).push({ opIndex: i, sqlQueries: [sqlQuery] });
+          } else {
+            groups.get(dbId).push({ opIndex: i, sqlQueries: c.queries });
+          }
         }
-        const allResults = new Array(compiled.length);
+        const opResults = /* @__PURE__ */ new Map();
         await Promise.all(
           Array.from(groups.entries()).map(async ([dbId, entries]) => {
-            const sqlQueries = entries.map((e) => e.sqlQuery);
-            const results = await executeBatch(dbId, sqlQueries);
-            for (let i = 0; i < entries.length; i++) {
-              allResults[entries[i].index] = results[i];
+            const flatQueries = [];
+            const slices = [];
+            for (const entry of entries) {
+              slices.push({
+                opIndex: entry.opIndex,
+                start: flatQueries.length,
+                count: entry.sqlQueries.length
+              });
+              flatQueries.push(...entry.sqlQueries);
+            }
+            const results = await executeBatch(dbId, flatQueries);
+            for (const { opIndex, start, count } of slices) {
+              opResults.set(opIndex, results.slice(start, start + count));
             }
           })
         );
         return compiled.map((c, i) => {
-          const result = allResults[i];
-          if (!c.query && c.predicates?.length) {
-            console.warn(
-              `[mindstudio] db.batch(): filter on ${c.config.tableName} could not be compiled to SQL \u2014 processing in JS`
-            );
+          const results = opResults.get(i);
+          if (c.type === "query") {
+            if (!c.query && c.predicates?.length) {
+              console.warn(
+                `[mindstudio] db.batch(): filter on ${c.config.tableName} could not be compiled to SQL \u2014 processing in JS`
+              );
+            }
+            return Query._processResults(results[0], c);
+          } else {
+            return Mutation._processResults(results, c);
           }
-          return Query._processResults(result, c);
         });
       })();
     })
@@ -1689,6 +1792,9 @@ function applyStepMethods(AgentClass) {
   proto.scrapeXProfile = function(step, options) {
     return this.executeStep("scrapeXProfile", step, options);
   };
+  proto.screenshotUrl = function(step, options) {
+    return this.executeStep("screenshotUrl", step, options);
+  };
   proto.searchGmailEmails = function(step, options) {
     return this.executeStep("searchGmailEmails", step, options);
   };
@@ -2723,6 +2829,7 @@ var monacoSnippets = {
   "scrapeUrl": { fields: [["url", "string"]], outputKeys: ["content"] },
   "scrapeXPost": { fields: [["url", "string"]], outputKeys: ["post"] },
   "scrapeXProfile": { fields: [["url", "string"]], outputKeys: ["profile"] },
+  "screenshotUrl": { fields: [["url", "string"]], outputKeys: ["screenshotUrl"] },
   "searchGmailEmails": { fields: [["query", "string"], ["exportType", ["json", "text"]], ["limit", "string"]], outputKeys: ["emails"] },
   "searchGoogle": { fields: [["query", "string"], ["exportType", ["text", "json"]]], outputKeys: ["results"] },
   "searchGoogleCalendarEvents": { fields: [["exportType", ["json", "text"]]], outputKeys: ["events"] },
@@ -3618,6 +3725,13 @@ var stepMetadata = {
     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"] }
   },
+  "screenshotUrl": {
+    stepType: "screenshotUrl",
+    description: "Capture a screenshot of a web page as a PNG image.",
+    usageNotes: "- Takes a viewport or full-page screenshot of the given URL.\n- Returns a CDN-hosted PNG image URL.\n- Viewport mode captures only the visible area; fullPage captures the entire scrollable page.\n- You can customize viewport width/height, add a delay, or wait for a CSS selector before capturing.",
+    inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "URL to screenshot" }, "mode": { "enum": ["viewport", "fullPage"], "type": "string", "description": "Screenshot mode: viewport captures visible area, fullPage captures entire page" }, "width": { "type": "number", "description": "Viewport width in pixels (default: 1280)" }, "height": { "type": "number", "description": "Viewport height in pixels (default: 800, ignored for fullPage mode)" }, "delay": { "type": "number", "description": "Milliseconds to wait before capturing (default: 0)" }, "waitFor": { "type": "string", "description": "CSS selector to wait for before capturing" } }, "required": ["url"] },
+    outputSchema: { "type": "object", "properties": { "screenshotUrl": { "type": "string" } }, "required": ["screenshotUrl"] }
+  },
   "searchGmailEmails": {
     stepType: "searchGmailEmails",
     description: "Search for emails in the connected Gmail account using a Gmail search query. To list recent inbox emails, pass an empty query string.",