@mindstudio-ai/agent 0.1.88 → 0.1.90

package/dist/index.d.ts

@@ -1,3 +1,159 @@
+/**
+ * Access level of a file store. `private` (the default) → reads are signed /
+ * session-authorized; `public` → world-readable, CDN-served on the app's own
+ * domain (and resizable via image query params).
+ */
+type FileAccess = 'public' | 'private';
+/** Options for {@link Store.put}. */
+interface PutOptions {
+    /**
+     * Object key within the store (nested paths allowed, e.g. `reports/q1.pdf`).
+     * Omit to auto-generate a UUID key (with `filename`'s extension, if given).
+     */
+    key?: string;
+    /** MIME type stored on the object and returned on read. */
+    contentType?: string;
+    /** Original filename — used only to derive an extension when `key` is omitted. */
+    filename?: string;
+    /**
+     * When true (and no explicit `key`), derive the key from a content hash
+     * (`<sha256>.<ext>`) instead of a random UUID — immutable + idempotent, so
+     * re-uploading identical bytes yields the same key/URL. Ideal for public
+     * assets baked into source.
+     */
+    contentAddressed?: boolean;
+}
+/** Options for {@link Store.list}. */
+interface ListOptions {
+    /** Restrict to keys under this prefix (relative to the store). */
+    prefix?: string;
+    /** Pagination cursor from a previous page. */
+    cursor?: string;
+    /** Max objects per page. */
+    limit?: number;
+}
+/** A stored object plus a ready-to-use URL. */
+interface StoredFile {
+    store: string;
+    key: string;
+    access: FileAccess;
+    size?: number;
+    contentType?: string;
+    updatedAt?: string;
+    /**
+     * Stable, on-domain URL for the app's own frontend — drop straight into
+     * `<img src>`, `fetch`, or `<a download>`. Relative (resolves against the
+     * app's origin); a same-origin logged-in request authorizes automatically
+     * via the app session, so there's nothing to await.
+     */
+    url: string;
+    /**
+     * Mint an ABSOLUTE, signed share URL that works with **no** active session —
+     * email it, or embed it on another site. Expires (default 24h). Private
+     * stores only.
+     */
+    shareUrl(options?: {
+        expiresIn?: number;
+    }): Promise<string>;
+}
+/**
+ * A token for a client-direct upload, from {@link Store.createUploadToken}.
+ * Return it from a backend method and pass it straight to the frontend's
+ * `platform.upload(token, file)` — the browser then POSTs the file directly to
+ * storage (no bytes through the platform).
+ */
+interface UploadToken {
+    /** The object key the upload will land at (within the store). */
+    key: string;
+    /** The stable on-domain URL the file will be readable at once uploaded. */
+    url: string;
+    /** @internal The scoped presigned POST the frontend submits to. */
+    upload: {
+        url: string;
+        fields: Record<string, string>;
+    };
+}
+/** @internal Per-store upload policy carried from `defineStore`. */
+interface StorePolicy {
+    maxSize?: number;
+    contentTypes?: string[];
+}
+/** @internal Transport: `POST /_internal/v2/files/<op>` with the hook token. */
+type FilesTransport = (op: string, body: unknown) => Promise<any>;
+/**
+ * A typed handle to one named file store. Lazy — nothing executes until a
+ * method is awaited, so it's safe to `defineStore()` at module scope and import
+ * the handle into route handlers (same ergonomics as `db.defineTable`).
+ */
+declare class Store {
+    private readonly _store;
+    private readonly _access;
+    private readonly _call;
+    private readonly _policy;
+    constructor(_store: string, _access: FileAccess, _call: FilesTransport, _policy?: StorePolicy);
+    /** The store's name. */
+    get name(): string;
+    /** The store's access level. */
+    get access(): FileAccess;
+    /** Store bytes. Returns a {@link StoredFile} with a ready-to-use `url`. */
+    put(content: Buffer | Uint8Array | string, options?: PutOptions): Promise<StoredFile>;
+    /** Read an object's bytes (backend / trusted context). */
+    get(key: string): Promise<Buffer>;
+    /** Metadata without downloading. Rejects if the object doesn't exist. */
+    head(key: string): Promise<StoredFile>;
+    /** Whether an object exists. */
+    exists(key: string): Promise<boolean>;
+    /** List objects in the store (optionally under `prefix`), one page at a time. */
+    list(options?: ListOptions): Promise<{
+        files: StoredFile[];
+        cursor?: string;
+    }>;
+    /** Delete an object. No-op if it doesn't exist. */
+    delete(key: string): Promise<void>;
+    /**
+     * Mint an ABSOLUTE, signed share URL for a key — works with **no** active
+     * session (email it, or embed it on another site). Expires (default 24h).
+     * Private stores only.
+     *
+     * The same link is available as `file.shareUrl()` on a {@link StoredFile};
+     * this convenience skips the `head()` when you already hold just the key.
+     */
+    shareUrl(key: string, options?: {
+        expiresIn?: number;
+    }): Promise<string>;
+    /**
+     * Mint an {@link UploadToken} for a **client-direct** upload — the browser
+     * POSTs the file straight to storage, so the bytes never pass through the
+     * platform. Return the token from a backend method and hand it to the
+     * frontend's `platform.upload(token, file)`. Works for private + public stores.
+     *
+     * Enforced at upload time by the presigned POST: a max size (this call's
+     * `maxSize`, else the store's, else the platform default) and — when
+     * `contentType` is set — an exact content-type match. When the store declares
+     * `contentTypes`, `contentType` must be one of them.
+     *
+     * Note: a presigned POST can pin exactly ONE content-type per token, so the
+     * *allowlist* is declared on `defineStore({ contentTypes })` and each token
+     * pins one type from it. This is by design, not a per-token limitation.
+     *
+     * @example
+     * ```ts
+     * // backend method
+     * export async function getUploadSlot(input: { contentType: string }) {
+     *   return Uploads.createUploadToken({ contentType: input.contentType, maxSize: 50 * 1024 * 1024 });
+     * }
+     * ```
+     */
+    createUploadToken(options?: {
+        key?: string;
+        contentType?: string;
+        filename?: string;
+        maxSize?: number;
+        expiresIn?: number;
+    }): Promise<UploadToken>;
+    private _toFile;
+}
+
 /** Configuration options for creating a {@link MindStudioAgent}. */
 interface AgentOptions {
     /**
@@ -83,6 +239,33 @@ interface StepExecutionOptions {
      * selection and token info.
      */
     onLog?: (event: StepLogEvent) => void;
+    /**
+     * Send any asset this step generates to one of the app's own file stores
+     * instead of the shared public MindStudio CDN.
+     *
+     * **Optional — the default is fine for most cases.** Omit it and generated
+     * assets keep going to the public CDN, exactly as before. Reach for it when
+     * the asset is user-specific, should be private, or belongs alongside the
+     * app's other files (where it shows up in the app's Files dashboard).
+     *
+     * The store's `access` comes from its `defineStore()`, so a private store
+     * yields a private asset — the returned URL is an on-domain
+     * `/_/files/private/...` link that only an authorized session can load,
+     * rather than a permanent public one.
+     *
+     * v2 apps only.
+     *
+     * @example
+     * ```ts
+     * const Photos = files.defineStore('product-photos', { access: 'public' });
+     *
+     * const { imageUrl } = await agent.generateImage(
+     *   { prompt: 'a red sneaker on concrete' },
+     *   { store: Photos },
+     * );
+     * ```
+     */
+    store?: Store;
 }
 /** Execution metadata returned alongside every step result. */
 interface StepExecutionMeta {
@@ -232,7 +415,7 @@ interface MindStudioModel {
     id?: string;
     /** Display name of the model. */
     name?: string;
-    /** One of: `llm_chat`, `image_generation`, `video_generation`, `video_analysis`, `text_to_speech`, `vision`, `transcription`. */
+    /** See `ModelType` for the full set. */
     type?: ModelType;
     maxTemperature?: number;
     maxResponseSize?: number;
@@ -244,13 +427,20 @@ interface MindStudioModelSummary {
     id?: string;
     /** Display name of the model. */
     name?: string;
-    /** One of: `llm_chat`, `image_generation`, `video_generation`, `video_analysis`, `text_to_speech`, `vision`, `transcription`. */
+    /** See `ModelType` for the full set. */
     type?: ModelType;
     /** Comma-separated tags for the model. */
     tags?: string;
 }
-/** Supported model type categories for filtering. */
-type ModelType = 'llm_chat' | 'image_generation' | 'video_generation' | 'video_analysis' | 'text_to_speech' | 'vision' | 'transcription';
+/**
+ * Supported model type categories for filtering.
+ *
+ * `embedding`, `reranking` and `document_extraction` have no SDK step — the
+ * data-source pipeline chooses those platform-side and reports the result on
+ * `pipeline.embeddingModelId`. They are listed so the catalog can be queried
+ * and described, not so they can be passed to a generate call.
+ */
+type ModelType = 'llm_chat' | 'image_generation' | '3d_generation' | 'video_generation' | 'video_analysis' | 'text_to_speech' | 'music_generation' | 'lipsync' | 'vision' | 'transcription' | 'embedding' | 'reranking' | 'document_extraction';
 /** Role assignment for a user within an app. */
 interface AppRoleAssignment {
     userId: string;
@@ -478,6 +668,12 @@ interface ExecuteStepBatchOptions {
     threadId?: string;
     /** Progress callback, called on each poll while the batch is running. */
     onProgress?: (completedSteps: number, totalSteps: number) => void;
+    /**
+     * Send assets generated by any step in this batch to one of the app's own
+     * file stores instead of the shared public MindStudio CDN. Optional; applies
+     * to every step in the batch. See {@link StepExecutionOptions.store}.
+     */
+    store?: Store;
 }
 /** Result of {@link MindStudioAgent.executeStepBatch}. */
 interface ExecuteStepBatchResult {
@@ -1292,160 +1488,6 @@ interface Db {
     batch(...queries: PromiseLike<unknown>[]): Promise<unknown[]>;
 }
 
-/**
- * Access level of a file store. `private` (the default) → reads are signed /
- * session-authorized; `public` → world-readable, CDN-served on the app's own
- * domain (and resizable via image query params).
- */
-type FileAccess = 'public' | 'private';
-/** Options for {@link Store.put}. */
-interface PutOptions {
-    /**
-     * Object key within the store (nested paths allowed, e.g. `reports/q1.pdf`).
-     * Omit to auto-generate a UUID key (with `filename`'s extension, if given).
-     */
-    key?: string;
-    /** MIME type stored on the object and returned on read. */
-    contentType?: string;
-    /** Original filename — used only to derive an extension when `key` is omitted. */
-    filename?: string;
-    /**
-     * When true (and no explicit `key`), derive the key from a content hash
-     * (`<sha256>.<ext>`) instead of a random UUID — immutable + idempotent, so
-     * re-uploading identical bytes yields the same key/URL. Ideal for public
-     * assets baked into source.
-     */
-    contentAddressed?: boolean;
-}
-/** Options for {@link Store.list}. */
-interface ListOptions {
-    /** Restrict to keys under this prefix (relative to the store). */
-    prefix?: string;
-    /** Pagination cursor from a previous page. */
-    cursor?: string;
-    /** Max objects per page. */
-    limit?: number;
-}
-/** A stored object plus a ready-to-use URL. */
-interface StoredFile {
-    store: string;
-    key: string;
-    access: FileAccess;
-    size?: number;
-    contentType?: string;
-    updatedAt?: string;
-    /**
-     * Stable, on-domain URL for the app's own frontend — drop straight into
-     * `<img src>`, `fetch`, or `<a download>`. Relative (resolves against the
-     * app's origin); a same-origin logged-in request authorizes automatically
-     * via the app session, so there's nothing to await.
-     */
-    url: string;
-    /**
-     * Mint an ABSOLUTE, signed share URL that works with **no** active session —
-     * email it, or embed it on another site. Expires (default 24h). Private
-     * stores only.
-     */
-    shareUrl(options?: {
-        expiresIn?: number;
-    }): Promise<string>;
-}
-/**
- * A token for a client-direct upload, from {@link Store.createUploadToken}.
- * Return it from a backend method and pass it straight to the frontend's
- * `platform.upload(token, file)` — the browser then POSTs the file directly to
- * storage (no bytes through the platform).
- */
-interface UploadToken {
-    /** The object key the upload will land at (within the store). */
-    key: string;
-    /** The stable on-domain URL the file will be readable at once uploaded. */
-    url: string;
-    /** @internal The scoped presigned POST the frontend submits to. */
-    upload: {
-        url: string;
-        fields: Record<string, string>;
-    };
-}
-/** @internal Per-store upload policy carried from `defineStore`. */
-interface StorePolicy {
-    maxSize?: number;
-    contentTypes?: string[];
-}
-/** @internal Transport: `POST /_internal/v2/files/<op>` with the hook token. */
-type FilesTransport = (op: string, body: unknown) => Promise<any>;
-/**
- * A typed handle to one named file store. Lazy — nothing executes until a
- * method is awaited, so it's safe to `defineStore()` at module scope and import
- * the handle into route handlers (same ergonomics as `db.defineTable`).
- */
-declare class Store {
-    private readonly _store;
-    private readonly _access;
-    private readonly _call;
-    private readonly _policy;
-    constructor(_store: string, _access: FileAccess, _call: FilesTransport, _policy?: StorePolicy);
-    /** The store's access level. */
-    get access(): FileAccess;
-    /** Store bytes. Returns a {@link StoredFile} with a ready-to-use `url`. */
-    put(content: Buffer | Uint8Array | string, options?: PutOptions): Promise<StoredFile>;
-    /** Read an object's bytes (backend / trusted context). */
-    get(key: string): Promise<Buffer>;
-    /** Metadata without downloading. Rejects if the object doesn't exist. */
-    head(key: string): Promise<StoredFile>;
-    /** Whether an object exists. */
-    exists(key: string): Promise<boolean>;
-    /** List objects in the store (optionally under `prefix`), one page at a time. */
-    list(options?: ListOptions): Promise<{
-        files: StoredFile[];
-        cursor?: string;
-    }>;
-    /** Delete an object. No-op if it doesn't exist. */
-    delete(key: string): Promise<void>;
-    /**
-     * Mint an ABSOLUTE, signed share URL for a key — works with **no** active
-     * session (email it, or embed it on another site). Expires (default 24h).
-     * Private stores only.
-     *
-     * The same link is available as `file.shareUrl()` on a {@link StoredFile};
-     * this convenience skips the `head()` when you already hold just the key.
-     */
-    shareUrl(key: string, options?: {
-        expiresIn?: number;
-    }): Promise<string>;
-    /**
-     * Mint an {@link UploadToken} for a **client-direct** upload — the browser
-     * POSTs the file straight to storage, so the bytes never pass through the
-     * platform. Return the token from a backend method and hand it to the
-     * frontend's `platform.upload(token, file)`. Works for private + public stores.
-     *
-     * Enforced at upload time by the presigned POST: a max size (this call's
-     * `maxSize`, else the store's, else the platform default) and — when
-     * `contentType` is set — an exact content-type match. When the store declares
-     * `contentTypes`, `contentType` must be one of them.
-     *
-     * Note: a presigned POST can pin exactly ONE content-type per token, so the
-     * *allowlist* is declared on `defineStore({ contentTypes })` and each token
-     * pins one type from it. This is by design, not a per-token limitation.
-     *
-     * @example
-     * ```ts
-     * // backend method
-     * export async function getUploadSlot(input: { contentType: string }) {
-     *   return Uploads.createUploadToken({ contentType: input.contentType, maxSize: 50 * 1024 * 1024 });
-     * }
-     * ```
-     */
-    createUploadToken(options?: {
-        key?: string;
-        contentType?: string;
-        filename?: string;
-        maxSize?: number;
-        expiresIn?: number;
-    }): Promise<UploadToken>;
-    private _toFile;
-}
-
 /**
  * The `files` namespace — typed, private-by-default file storage for MindStudio
  * apps. Think of a store as a CDN-backed bucket the app talks to, not app-defined
@@ -3169,6 +3211,8 @@ interface ExtractAudioFromVideoStepOutput {
 interface ExtractTextStepInput {
     /** URL or array of URLs to extract text from. Accepts a single URL, comma-separated list, or JSON array */
     url: string | string[];
+    /** Optional extraction model id (a `document_extraction` model, e.g. `mistral-ocr-latest`, `llamaparse`, `google-document-ai`). Defaults to the platform default when omitted. */
+    model?: string;
 }
 interface ExtractTextStepOutput {
     /** Extracted text content. A single string for one URL, or an array for multiple URLs */
@@ -3710,7 +3754,11 @@ interface GenerateImageStepInput {
     generateVariants?: boolean;
     /** Number of variants to generate (max 10) */
     numVariants?: number;
-    /** Whether to add a MindStudio watermark to the generated image */
+    /**
+   * Whether to add a MindStudio watermark to the generated image.
+   *
+   * The watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there.
+   */
     addWatermark?: boolean;
 }
 interface GenerateImageStepOutput {
@@ -3720,7 +3768,11 @@ interface GenerateImageStepOutput {
 interface GenerateLipsyncStepInput {
     /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
     intermediateAsset?: boolean;
-    /** Whether to add a MindStudio watermark to the generated video */
+    /**
+   * Whether to add a MindStudio watermark to the generated video.
+   *
+   * The watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there.
+   */
     addWatermark?: boolean;
     /** Optional model configuration override. Uses the workflow's default lipsync model if not specified */
     lipsyncModelOverride?: {
@@ -3855,7 +3907,11 @@ interface GenerateVideoStepInput {
     generateVariants?: boolean;
     /** Number of variants to generate (max 10) */
     numVariants?: number;
-    /** Whether to add a MindStudio watermark to the generated video */
+    /**
+   * Whether to add a MindStudio watermark to the generated video.
+   *
+   * The watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there.
+   */
     addWatermark?: boolean;
 }
 interface GenerateVideoStepOutput {
@@ -7215,6 +7271,7 @@ interface StepMethods {
      * - Handles both text-layer PDFs and image-based/scanned PDFs (e.g. Figma/Canva exports, scanned documents). Image-based PDFs are processed with OCR automatically — there is no need to convert PDF pages to images first.
      * - Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.
      * - Files are rehosted on the MindStudio CDN before extraction.
+     * - Optionally set `model` to a specific document-extraction model (`mistral-ocr-latest`, `llamaparse`, `google-document-ai`); omit to use the platform default.
      * - Maximum file size is 50MB per URL.
      *
      * @example

package/dist/index.js

@@ -107,8 +107,16 @@ var WS_OPEN_TIMEOUT_MS = 5e3;
 var WS_OPEN = 1;
 var WS_MAX_FRAME_CHARS = 9e5;
 var DbWsTransportError = class extends Error {
+  constructor(message, sent = false) {
+    super(message);
+    this.sent = sent;
+  }
   name = "DbWsTransportError";
 };
+function isReadOnlySql(sql) {
+  const head = sql.trimStart().slice(0, 8).toUpperCase();
+  return head.startsWith("SELECT") || head.startsWith("PRAGMA") || head.startsWith("EXPLAIN");
+}
 var socket = null;
 var opening = null;
 var idCounter = 0;
@@ -136,7 +144,7 @@ function getOrOpen(url) {
       opening = null;
       for (const [, p] of pending) {
         clearTimeout(p.timer);
-        p.reject(err);
+        p.reject(new DbWsTransportError(err.message, true));
       }
       pending.clear();
       reject(err);
@@ -206,7 +214,7 @@ async function executeDbBatchOverWs(url, token, databaseId, queries) {
   return await new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
       pending.delete(id);
-      reject(new DbWsTransportError("ws execute timed out"));
+      reject(new DbWsTransportError("ws execute timed out", true));
     }, WS_REQUEST_TIMEOUT_MS);
     pending.set(id, { resolve, reject, timer });
     try {
@@ -215,7 +223,10 @@ async function executeDbBatchOverWs(url, token, databaseId, queries) {
       clearTimeout(timer);
       pending.delete(id);
       reject(
-        new DbWsTransportError(`ws send failed: ${err?.message || "unknown"}`)
+        new DbWsTransportError(
+          `ws send failed: ${err?.message || "unknown"}`,
+          false
+        )
       );
     }
   });
@@ -1945,6 +1956,10 @@ var Store = class {
     this._call = _call;
     this._policy = _policy;
   }
+  /** The store's name. */
+  get name() {
+    return this._store;
+  }
   /** The store's access level. */
   get access() {
     return this._access;
@@ -2505,8 +2520,8 @@ var stepMetadata = {
   "extractText": {
     stepType: "extractText",
     description: "Download a file from a URL and extract its text content. Supports PDFs (including scanned/image-based PDFs via OCR), plain text files, and other document formats.",
-    usageNotes: "- Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.\n- Handles both text-layer PDFs and image-based/scanned PDFs (e.g. Figma/Canva exports, scanned documents). Image-based PDFs are processed with OCR automatically \u2014 there is no need to convert PDF pages to images first.\n- Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.\n- Files are rehosted on the MindStudio CDN before extraction.\n- Maximum file size is 50MB per URL.",
-    inputSchema: { "type": "object", "properties": { "url": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["url"] },
+    usageNotes: "- Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.\n- Handles both text-layer PDFs and image-based/scanned PDFs (e.g. Figma/Canva exports, scanned documents). Image-based PDFs are processed with OCR automatically \u2014 there is no need to convert PDF pages to images first.\n- Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.\n- Files are rehosted on the MindStudio CDN before extraction.\n- Optionally set `model` to a specific document-extraction model (`mistral-ocr-latest`, `llamaparse`, `google-document-ai`); omit to use the platform default.\n- Maximum file size is 50MB per URL.",
+    inputSchema: { "type": "object", "properties": { "url": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] }, "model": { "type": "string", "description": "Optional extraction model id (a `document_extraction` model, e.g. `mistral-ocr-latest`, `llamaparse`, `google-document-ai`). Defaults to the platform default when omitted." } }, "required": ["url"] },
     outputSchema: { "type": "object", "properties": { "text": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["text"] }
   },
   "fetchDataSourceDocument": {
@@ -2590,14 +2605,14 @@ var stepMetadata = {
     stepType: "generateImage",
     description: "Generate an image from a text prompt using an AI model.",
     usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- Images are automatically hosted on a CDN.\n- In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1, multiple images are generated in parallel.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
-    inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the image to generate" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "imageModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Image generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default image model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple image variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated image" } }, "required": ["prompt"] },
+    inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the image to generate" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "imageModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Image generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default image model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple image variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated image.\n\nThe watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there." } }, "required": ["prompt"] },
     outputSchema: { "type": "object", "properties": { "imageUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["imageUrl"] }
   },
   "generateLipsync": {
     stepType: "generateLipsync",
     description: "Generate a lip sync video from provided audio and image.",
     usageNotes: "- In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.",
-    inputSchema: { "type": "object", "properties": { "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video" }, "lipsyncModelOverride": { "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object", "properties": {}, "required": [] } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default lipsync model if not specified" } } },
+    inputSchema: { "type": "object", "properties": { "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video.\n\nThe watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there." }, "lipsyncModelOverride": { "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object", "properties": {}, "required": [] } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default lipsync model if not specified" } } },
     outputSchema: { "description": "This step does not produce output data." }
   },
   "generateMusic": {
@@ -2643,7 +2658,7 @@ var stepMetadata = {
     stepType: "generateVideo",
     description: "Generate a video from a text prompt using an AI model.",
     usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- Videos are automatically hosted on a CDN.\n- In foreground mode, the video is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1, multiple videos are generated in parallel.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
-    inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the video to generate" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "videoModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Video generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default video model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple video variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video" } }, "required": ["prompt"] },
+    inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the video to generate" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "videoModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Video generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default video model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple video variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video.\n\nThe watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there." } }, "required": ["prompt"] },
     outputSchema: { "type": "object", "properties": { "videoUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["videoUrl"] }
   },
   "getGmailAttachments": {
@@ -4349,7 +4364,10 @@ var MindStudioAgent = class {
       ...options?.appId != null && { appId: options.appId },
       ...threadId != null && { threadId },
       ...this._currentStreamId != null && { streamId: this._currentStreamId },
-      ...this._requestSource != null && { requestSource: this._requestSource }
+      ...this._requestSource != null && {
+        requestSource: this._requestSource
+      },
+      ...assetStoreBody(options?.store)
     });
     const remaining = headers.get("x-ratelimit-remaining");
     const returnedThreadId = asyncData.threadId ?? "";
@@ -4433,7 +4451,10 @@ var MindStudioAgent = class {
       ...options.appId != null && { appId: options.appId },
       ...threadId != null && { threadId },
       ...this._currentStreamId != null && { streamId: this._currentStreamId },
-      ...this._requestSource != null && { requestSource: this._requestSource }
+      ...this._requestSource != null && {
+        requestSource: this._requestSource
+      },
+      ...assetStoreBody(options.store)
     };
     await this._httpConfig.rateLimiter.acquire();
     let res;
@@ -4620,7 +4641,10 @@ var MindStudioAgent = class {
       })),
       ...options?.appId != null && { appId: options.appId },
       ...threadId != null && { threadId },
-      ...this._requestSource != null && { requestSource: this._requestSource }
+      ...this._requestSource != null && {
+        requestSource: this._requestSource
+      },
+      ...assetStoreBody(options?.store)
     });
     const pollUrl = `${this._currentHttpConfig.baseUrl}/developer/v2/steps/execute-batch-async/poll/${asyncData.batchToken}`;
     let pollDelay = 300;
@@ -5235,6 +5259,13 @@ var MindStudioAgent = class {
         if (!(err instanceof DbWsTransportError)) {
           throw err;
         }
+        if (err.sent && queries.some((q) => !isReadOnlySql(q.sql))) {
+          throw new MindStudioError(
+            "[db] Connection was interrupted after this query was sent; because it contains a write, it was not automatically retried (the write may or may not have been applied). Verify the current state before re-running it.",
+            "db_transport_interrupted",
+            503
+          );
+        }
         console.warn(
           `[mindstudio] db: WebSocket transport unavailable (${err.message}); using HTTP for this query.`
         );
@@ -5625,7 +5656,10 @@ var MindStudioAgent = class {
       content.byteOffset,
       content.byteOffset + content.byteLength
     );
-    const fileBlob = new Blob([buf], options.type ? { type: options.type } : void 0);
+    const fileBlob = new Blob(
+      [buf],
+      options.type ? { type: options.type } : void 0
+    );
     form.append("file", fileBlob, filename);
     const res = await fetch(data.url, { method: "POST", body: form });
     if (!res.ok) {
@@ -5651,6 +5685,9 @@ function sleep3(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 applyStepMethods(MindStudioAgent);
+function assetStoreBody(store) {
+  return store ? { assetStore: { store: store.name, access: store.access } } : {};
+}
 function resolveStepType2(name) {
   const meta = stepMetadata[name];
   return meta ? meta.stepType : name;