@mindstudio-ai/agent 0.1.33 → 0.1.35

package/dist/index.js

@@ -37,13 +37,23 @@ async function requestWithRetry(config, method, url, body, attempt) {
     return requestWithRetry(config, method, url, body, attempt + 1);
   }
   if (!res.ok) {
-    const errorBody = await res.json().catch(() => ({}));
-    throw new MindStudioError(
-      errorBody.message || `${res.status} ${res.statusText}`,
-      errorBody.code || "api_error",
-      res.status,
-      errorBody
-    );
+    let message = `${res.status} ${res.statusText}`;
+    let code = "api_error";
+    let details;
+    try {
+      const text = await res.text();
+      try {
+        const body2 = JSON.parse(text);
+        details = body2;
+        const errMsg = body2.error ?? body2.message ?? body2.details;
+        if (errMsg) message = errMsg;
+        if (body2.code) code = body2.code;
+      } catch {
+        if (text && text.length < 500) message = text;
+      }
+    } catch {
+    }
+    throw new MindStudioError(message, code, res.status, details);
   }
   const data = await res.json();
   return { data, headers: res.headers };
@@ -1248,6 +1258,9 @@ var Table = class {
     const items = (isArray ? data : [data]).map(
       (item) => this._config.defaults ? { ...this._config.defaults, ...item } : item
     );
+    for (const item of items) {
+      this._checkManagedColumns(item);
+    }
     const queries = items.map(
       (item) => buildInsert(
         this._config.tableName,
@@ -1265,7 +1278,13 @@ var Table = class {
         }
         return void 0;
       });
-      return isArray ? rows : rows[0];
+      const result = isArray ? rows : rows[0];
+      this._syncRolesIfNeeded(
+        items,
+        result,
+        isArray
+      );
+      return result;
     });
   }
   /**
@@ -1273,20 +1292,25 @@ var Table = class {
    * Returns the updated row via `UPDATE ... RETURNING *`.
    */
   update(id, data) {
+    this._checkManagedColumns(data);
     const query = buildUpdate(
       this._config.tableName,
       id,
       data,
       this._config.columns
     );
-    return new Mutation(
-      this._config,
-      [query],
-      (results) => deserializeRow(
+    return new Mutation(this._config, [query], (results) => {
+      const result = deserializeRow(
         results[0].rows[0],
         this._config.columns
-      )
-    );
+      );
+      this._syncRolesIfNeeded(
+        [data],
+        result,
+        false
+      );
+      return result;
+    });
   }
   remove(id) {
     const query = buildDelete(this._config.tableName, `id = ?`, [id]);
@@ -1341,24 +1365,65 @@ var Table = class {
     const conflictColumns = Array.isArray(conflictKey) ? conflictKey : [conflictKey];
     this._validateUniqueConstraint(conflictColumns);
     const withDefaults = this._config.defaults ? { ...this._config.defaults, ...data } : data;
+    this._checkManagedColumns(withDefaults);
     const query = buildUpsert(
       this._config.tableName,
       withDefaults,
       conflictColumns,
       this._config.columns
     );
-    return new Mutation(
-      this._config,
-      [query],
-      (results) => deserializeRow(
+    return new Mutation(this._config, [query], (results) => {
+      const result = deserializeRow(
         results[0].rows[0],
         this._config.columns
-      )
-    );
+      );
+      this._syncRolesIfNeeded([withDefaults], result, false);
+      return result;
+    });
   }
   // -------------------------------------------------------------------------
   // Internal helpers
   // -------------------------------------------------------------------------
+  /** @internal Throw if data includes a platform-managed email/phone column. */
+  _checkManagedColumns(data) {
+    const mc = this._config.managedColumns;
+    if (!mc) return;
+    const keys = Object.keys(data);
+    for (const key of keys) {
+      if (mc.email && key === mc.email || mc.phone && key === mc.phone) {
+        throw new MindStudioError(
+          `Cannot write to "${key}" \u2014 this column is managed by auth. Use the auth API to change a user's ${key === mc.email ? "email" : "phone"}.`,
+          "managed_column_write",
+          400
+        );
+      }
+    }
+  }
+  /**
+   * @internal Fire role sync for rows that wrote to the roles column.
+   * Called inside processResult (runs after SQL execution in both
+   * standalone and batch paths). Fire-and-forget.
+   */
+  _syncRolesIfNeeded(inputItems, result, isArray) {
+    const rolesCol = this._config.managedColumns?.roles;
+    const syncRoles = this._config.syncRoles;
+    if (!rolesCol || !syncRoles) return;
+    if (!inputItems.some((item) => rolesCol in item)) return;
+    if (isArray) {
+      for (const row of result) {
+        if (row?.id) {
+          syncRoles(row.id, row[rolesCol]).catch(() => {
+          });
+        }
+      }
+    } else {
+      const row = result;
+      if (row?.id) {
+        syncRoles(row.id, row[rolesCol]).catch(() => {
+        });
+      }
+    }
+  }
   /** @internal Validate that the given columns match a declared unique constraint. */
   _validateUniqueConstraint(columns) {
     if (!this._config.unique?.length) {
@@ -1383,7 +1448,7 @@ var Table = class {
 };
 
 // src/db/index.ts
-function createDb(databases, executeBatch) {
+function createDb(databases, executeBatch, authConfig, syncRoles) {
   return {
     defineTable(name, options) {
       const resolved = resolveTable(databases, name, options?.database);
@@ -1393,6 +1458,8 @@ function createDb(databases, executeBatch) {
         columns: resolved.columns,
         unique: options?.unique,
         defaults: options?.defaults,
+        managedColumns: authConfig?.table === name ? authConfig.columns : void 0,
+        syncRoles: authConfig?.table === name && authConfig.columns.roles ? syncRoles : void 0,
         executeBatch: (queries) => executeBatch(resolved.databaseId, queries)
       };
       return new Table(config);
@@ -1999,1135 +2066,6 @@ function applyStepMethods(AgentClass) {
   };
 }
 
-// src/client.ts
-var DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
-var DEFAULT_MAX_RETRIES = 3;
-var MindStudioAgent = class {
-  /** @internal */
-  _httpConfig;
-  /** @internal */
-  _reuseThreadId;
-  /** @internal */
-  _threadId;
-  /** @internal Stream ID for SSE token streaming. Set by sandbox via STREAM_ID env var. */
-  _streamId;
-  // ---- App context (db + auth) ----
-  /**
-   * @internal App ID for context resolution. Resolved from:
-   * constructor appId → MINDSTUDIO_APP_ID env → sandbox globals →
-   * auto-detected from first executeStep response header.
-   */
-  _appId;
-  /**
-   * @internal Cached app context (auth + databases). Populated by
-   * ensureContext() and cached for the lifetime of the instance.
-   */
-  _context;
-  /**
-   * @internal Deduplication promise for ensureContext(). Ensures only one
-   * context fetch is in-flight at a time, even if multiple db/auth
-   * operations trigger it concurrently.
-   */
-  _contextPromise;
-  /** @internal Cached AuthContext instance, created during context hydration. */
-  _auth;
-  /** @internal Cached Db namespace instance, created during context hydration. */
-  _db;
-  /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
-  _authType;
-  /**
-   * @internal Resolve the current auth token. For internal (CALLBACK_TOKEN)
-   * auth, re-reads the env var each time so that long-lived singleton
-   * instances pick up token rotations from the host process.
-   */
-  get _token() {
-    if (this._authType === "internal" && process.env.CALLBACK_TOKEN) {
-      return process.env.CALLBACK_TOKEN;
-    }
-    return this._httpConfig.token;
-  }
-  constructor(options = {}) {
-    const config = loadConfig();
-    const { token, authType } = resolveToken(options.apiKey, config);
-    const baseUrl = options.baseUrl ?? process.env.MINDSTUDIO_BASE_URL ?? process.env.REMOTE_HOSTNAME ?? config.baseUrl ?? DEFAULT_BASE_URL;
-    this._reuseThreadId = options.reuseThreadId ?? /^(true|1)$/i.test(process.env.MINDSTUDIO_REUSE_THREAD_ID ?? "");
-    this._appId = options.appId ?? process.env.MINDSTUDIO_APP_ID ?? void 0;
-    this._authType = authType;
-    this._httpConfig = {
-      baseUrl,
-      token,
-      rateLimiter: new RateLimiter(authType),
-      maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES
-    };
-    if (authType === "internal") {
-      this._trySandboxHydration();
-    }
-    this._streamId = process.env.STREAM_ID ?? void 0;
-  }
-  /**
-   * Execute any step by its type name. This is the low-level method that all
-   * typed step methods delegate to. Use it as an escape hatch for step types
-   * not yet covered by the generated methods.
-   *
-   * ```ts
-   * const result = await agent.executeStep("generateImage", { prompt: "hello", mode: "background" });
-   * ```
-   */
-  async executeStep(stepType, step, options) {
-    if (options?.onLog) {
-      return this._executeStepStreaming(
-        stepType,
-        step,
-        options
-      );
-    }
-    const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
-    const { data, headers } = await request(this._httpConfig, "POST", `/steps/${stepType}/execute`, {
-      step,
-      ...options?.appId != null && { appId: options.appId },
-      ...threadId != null && { threadId },
-      ...this._streamId != null && { streamId: this._streamId }
-    });
-    let output;
-    if (data.output != null) {
-      output = data.output;
-    } else if (data.outputUrl) {
-      const res = await fetch(data.outputUrl);
-      if (!res.ok) {
-        throw new MindStudioError(
-          `Failed to fetch output from S3: ${res.status} ${res.statusText}`,
-          "output_fetch_error",
-          res.status
-        );
-      }
-      const envelope = await res.json();
-      output = envelope.value;
-    } else {
-      output = void 0;
-    }
-    const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
-    if (this._reuseThreadId && returnedThreadId) {
-      this._threadId = returnedThreadId;
-    }
-    const returnedAppId = headers.get("x-mindstudio-app-id");
-    if (!this._appId && returnedAppId) {
-      this._appId = returnedAppId;
-    }
-    const remaining = headers.get("x-ratelimit-remaining");
-    const billingCost = headers.get("x-mindstudio-billing-cost");
-    const billingEvents = headers.get("x-mindstudio-billing-events");
-    return {
-      ...output,
-      $appId: headers.get("x-mindstudio-app-id") ?? "",
-      $threadId: returnedThreadId,
-      $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
-      $billingCost: billingCost != null ? parseFloat(billingCost) : void 0,
-      $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
-    };
-  }
-  /**
-   * @internal Streaming step execution — sends `Accept: text/event-stream`
-   * and parses SSE events for real-time debug logs.
-   */
-  async _executeStepStreaming(stepType, step, options) {
-    const threadId = options.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
-    const url = `${this._httpConfig.baseUrl}/developer/v2/steps/${stepType}/execute`;
-    const body = {
-      step,
-      ...options.appId != null && { appId: options.appId },
-      ...threadId != null && { threadId },
-      ...this._streamId != null && { streamId: this._streamId }
-    };
-    await this._httpConfig.rateLimiter.acquire();
-    let res;
-    try {
-      res = await fetch(url, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${this._token}`,
-          "Content-Type": "application/json",
-          "User-Agent": "@mindstudio-ai/agent",
-          Accept: "text/event-stream"
-        },
-        body: JSON.stringify(body)
-      });
-    } catch (err) {
-      this._httpConfig.rateLimiter.release();
-      throw err;
-    }
-    this._httpConfig.rateLimiter.updateFromHeaders(res.headers);
-    if (!res.ok) {
-      this._httpConfig.rateLimiter.release();
-      const errorBody = await res.json().catch(() => ({}));
-      throw new MindStudioError(
-        errorBody.message || `${res.status} ${res.statusText}`,
-        errorBody.code || "api_error",
-        res.status,
-        errorBody
-      );
-    }
-    const headers = res.headers;
-    try {
-      const reader = res.body.getReader();
-      const decoder = new TextDecoder();
-      let buffer = "";
-      let doneEvent = null;
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split("\n");
-        buffer = lines.pop() ?? "";
-        for (const line of lines) {
-          if (!line.startsWith("data: ")) continue;
-          try {
-            const event = JSON.parse(line.slice(6));
-            if (event.type === "log") {
-              options.onLog({
-                value: event.value,
-                tag: event.tag,
-                ts: event.ts
-              });
-            } else if (event.type === "done") {
-              doneEvent = {
-                output: event.output,
-                outputUrl: event.outputUrl,
-                billingCost: event.billingCost,
-                billingEvents: event.billingEvents
-              };
-            } else if (event.type === "error") {
-              throw new MindStudioError(
-                event.error || "Step execution failed",
-                "step_error",
-                500
-              );
-            }
-          } catch (err) {
-            if (err instanceof MindStudioError) throw err;
-          }
-        }
-      }
-      if (buffer.startsWith("data: ")) {
-        try {
-          const event = JSON.parse(buffer.slice(6));
-          if (event.type === "done") {
-            doneEvent = {
-              output: event.output,
-              outputUrl: event.outputUrl,
-              billingCost: event.billingCost,
-              billingEvents: event.billingEvents
-            };
-          } else if (event.type === "error") {
-            throw new MindStudioError(
-              event.error || "Step execution failed",
-              "step_error",
-              500
-            );
-          } else if (event.type === "log") {
-            options.onLog({
-              value: event.value,
-              tag: event.tag,
-              ts: event.ts
-            });
-          }
-        } catch (err) {
-          if (err instanceof MindStudioError) throw err;
-        }
-      }
-      if (!doneEvent) {
-        throw new MindStudioError(
-          "Stream ended without a done event",
-          "stream_error",
-          500
-        );
-      }
-      let output;
-      if (doneEvent.output != null) {
-        output = doneEvent.output;
-      } else if (doneEvent.outputUrl) {
-        const s3Res = await fetch(doneEvent.outputUrl);
-        if (!s3Res.ok) {
-          throw new MindStudioError(
-            `Failed to fetch output from S3: ${s3Res.status} ${s3Res.statusText}`,
-            "output_fetch_error",
-            s3Res.status
-          );
-        }
-        const envelope = await s3Res.json();
-        output = envelope.value;
-      } else {
-        output = void 0;
-      }
-      const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
-      if (this._reuseThreadId && returnedThreadId) {
-        this._threadId = returnedThreadId;
-      }
-      const returnedAppId = headers.get("x-mindstudio-app-id");
-      if (!this._appId && returnedAppId) {
-        this._appId = returnedAppId;
-      }
-      const remaining = headers.get("x-ratelimit-remaining");
-      return {
-        ...output,
-        $appId: headers.get("x-mindstudio-app-id") ?? "",
-        $threadId: returnedThreadId,
-        $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
-        $billingCost: doneEvent.billingCost,
-        $billingEvents: doneEvent.billingEvents
-      };
-    } finally {
-      this._httpConfig.rateLimiter.release();
-    }
-  }
-  /**
-   * Execute multiple steps in parallel in a single request.
-   *
-   * All steps run in parallel on the server. Results are returned in the same
-   * order as the input. Individual step failures do not affect other steps —
-   * partial success is possible.
-   *
-   * ```ts
-   * const { results } = await agent.executeStepBatch([
-   *   { stepType: 'generateImage', step: { prompt: 'a sunset' } },
-   *   { stepType: 'textToSpeech', step: { text: 'Hello world' } },
-   * ]);
-   * ```
-   */
-  async executeStepBatch(steps, options) {
-    const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
-    const { data } = await request(this._httpConfig, "POST", "/steps/execute-batch", {
-      steps,
-      ...options?.appId != null && { appId: options.appId },
-      ...threadId != null && { threadId }
-    });
-    const results = await Promise.all(
-      data.results.map(async (r) => {
-        if (r.output != null) {
-          return {
-            stepType: r.stepType,
-            output: r.output,
-            billingCost: r.billingCost,
-            error: r.error
-          };
-        }
-        if (r.outputUrl) {
-          const res = await fetch(r.outputUrl);
-          if (!res.ok) {
-            return {
-              stepType: r.stepType,
-              error: `Failed to fetch output from S3: ${res.status} ${res.statusText}`
-            };
-          }
-          const envelope = await res.json();
-          return {
-            stepType: r.stepType,
-            output: envelope.value,
-            billingCost: r.billingCost
-          };
-        }
-        return {
-          stepType: r.stepType,
-          billingCost: r.billingCost,
-          error: r.error
-        };
-      })
-    );
-    if (this._reuseThreadId && data.threadId) {
-      this._threadId = data.threadId;
-    }
-    return {
-      results,
-      totalBillingCost: data.totalBillingCost,
-      appId: data.appId,
-      threadId: data.threadId
-    };
-  }
-  /**
-   * Get the authenticated user's identity and organization info.
-   *
-   * ```ts
-   * const info = await agent.getUserInfo();
-   * console.log(info.displayName, info.organizationName);
-   * ```
-   */
-  async getUserInfo() {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      "/account/userinfo"
-    );
-    return data;
-  }
-  /**
-   * List all pre-built agents in the organization.
-   *
-   * ```ts
-   * const { apps } = await agent.listAgents();
-   * for (const app of apps) console.log(app.name, app.id);
-   * ```
-   */
-  async listAgents() {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      "/agents/load"
-    );
-    return data;
-  }
-  /**
-   * Run a pre-built agent and wait for the result.
-   *
-   * Uses async polling internally — the request returns immediately with a
-   * callback token, then polls until the run completes or fails.
-   *
-   * ```ts
-   * const result = await agent.runAgent({
-   *   appId: 'your-agent-id',
-   *   variables: { query: 'hello' },
-   * });
-   * console.log(result.result);
-   * ```
-   */
-  async runAgent(options) {
-    const pollInterval = options.pollIntervalMs ?? 1e3;
-    const { data } = await request(this._httpConfig, "POST", "/agents/run", {
-      appId: options.appId,
-      async: true,
-      ...options.variables != null && { variables: options.variables },
-      ...options.workflow != null && { workflow: options.workflow },
-      ...options.version != null && { version: options.version },
-      ...options.includeBillingCost != null && {
-        includeBillingCost: options.includeBillingCost
-      },
-      ...options.metadata != null && { metadata: options.metadata }
-    });
-    const token = data.callbackToken;
-    const pollUrl = `${this._httpConfig.baseUrl}/developer/v2/agents/run/poll/${token}`;
-    while (true) {
-      await sleep2(pollInterval);
-      const res = await fetch(pollUrl, {
-        headers: { "User-Agent": "@mindstudio-ai/agent" }
-      });
-      if (res.status === 404) {
-        throw new MindStudioError(
-          "Poll token not found or expired.",
-          "poll_token_expired",
-          404
-        );
-      }
-      if (!res.ok) {
-        const errorBody = await res.json().catch(() => ({}));
-        throw new MindStudioError(
-          errorBody.message ?? errorBody.error ?? `Poll request failed: ${res.status} ${res.statusText}`,
-          errorBody.code ?? "poll_error",
-          res.status,
-          errorBody
-        );
-      }
-      const poll = await res.json();
-      if (poll.status === "pending") continue;
-      if (poll.status === "error") {
-        throw new MindStudioError(
-          poll.error ?? "Agent run failed.",
-          "agent_run_error",
-          500
-        );
-      }
-      return poll.result;
-    }
-  }
-  /** @internal Used by generated action methods. */
-  _request(method, path, body) {
-    return request(this._httpConfig, method, path, body);
-  }
-  // -------------------------------------------------------------------------
-  // Helper methods — models
-  // -------------------------------------------------------------------------
-  /** List all available AI models. */
-  async listModels() {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      "/helpers/models"
-    );
-    return data;
-  }
-  /** List AI models filtered by type. */
-  async listModelsByType(modelType) {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      `/helpers/models/${modelType}`
-    );
-    return data;
-  }
-  /** List all available AI models (summary). Returns only id, name, type, and tags. */
-  async listModelsSummary() {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      "/helpers/models-summary"
-    );
-    return data;
-  }
-  /** List AI models (summary) filtered by type. */
-  async listModelsSummaryByType(modelType) {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      `/helpers/models-summary/${modelType}`
-    );
-    return data;
-  }
-  // -------------------------------------------------------------------------
-  // Helper methods — OAuth connectors & connections
-  // -------------------------------------------------------------------------
-  /**
-   * List available OAuth connector services (Slack, Google, HubSpot, etc.).
-   *
-   * These are third-party integrations from the MindStudio Connector Registry.
-   * For most tasks, use actions directly instead.
-   */
-  async listConnectors() {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      "/helpers/connectors"
-    );
-    return data;
-  }
-  /** Get details for a single OAuth connector service. */
-  async getConnector(serviceId) {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      `/helpers/connectors/${serviceId}`
-    );
-    return data;
-  }
-  /** Get the full configuration for an OAuth connector action, including input fields. */
-  async getConnectorAction(serviceId, actionId) {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      `/helpers/connectors/${serviceId}/${actionId}`
-    );
-    return data;
-  }
-  /** List OAuth connections for the organization. These are authenticated third-party service links. */
-  async listConnections() {
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      "/helpers/connections"
-    );
-    return data;
-  }
-  // -------------------------------------------------------------------------
-  // Helper methods — cost estimation
-  // -------------------------------------------------------------------------
-  /** Estimate the cost of executing an action before running it. */
-  async estimateStepCost(stepType, step, options) {
-    const { data } = await request(this._httpConfig, "POST", "/helpers/step-cost-estimate", {
-      step: { type: stepType, ...step },
-      ...options
-    });
-    return data;
-  }
-  // -------------------------------------------------------------------------
-  // Streaming
-  // -------------------------------------------------------------------------
-  /**
-   * Send a stream chunk to the caller via SSE.
-   *
-   * When invoked from a method that was called with `stream: true`, chunks
-   * are delivered in real-time as Server-Sent Events. When there is no active
-   * stream (no `STREAM_ID`), calls are silently ignored — so it's safe to
-   * call unconditionally.
-   *
-   * Accepts strings (sent as `type: 'token'`) or structured data (sent as
-   * `type: 'data'`). The caller receives each chunk as an SSE event.
-   *
-   * @example
-   * ```ts
-   * // Stream text tokens
-   * await agent.stream('Processing item 1...');
-   *
-   * // Stream structured data
-   * await agent.stream({ progress: 50, currentItem: 'abc' });
-   * ```
-   */
-  stream = async (data) => {
-    if (!this._streamId) return;
-    const url = `${this._httpConfig.baseUrl}/_internal/v2/stream-chunk`;
-    const body = typeof data === "string" ? { streamId: this._streamId, type: "token", text: data } : { streamId: this._streamId, type: "data", data };
-    const res = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: this._token
-      },
-      body: JSON.stringify(body)
-    });
-    if (!res.ok) {
-      const text = await res.text().catch(() => "");
-      console.warn(`[mindstudio] stream chunk failed: ${res.status} ${text}`);
-    }
-  };
-  // -------------------------------------------------------------------------
-  // db + auth namespaces
-  // -------------------------------------------------------------------------
-  /**
-   * The `auth` namespace — synchronous role-based access control.
-   *
-   * Provides the current user's identity and roles. All methods are
-   * synchronous since the role map is preloaded during context hydration.
-   *
-   * **Important**: Context must be hydrated before accessing `auth`.
-   * - Inside the MindStudio sandbox: automatic (populated from globals)
-   * - Outside the sandbox: call `await agent.ensureContext()` first,
-   *   or access `auth` after any `db` operation (which auto-hydrates)
-   *
-   * @throws {MindStudioError} if context has not been hydrated yet
-   *
-   * @example
-   * ```ts
-   * await agent.ensureContext();
-   * agent.auth.requireRole(Roles.admin);
-   * const admins = agent.auth.getUsersByRole(Roles.admin);
-   * ```
-   */
-  get auth() {
-    if (!this._auth) {
-      this._trySandboxHydration();
-    }
-    if (!this._auth) {
-      throw new MindStudioError(
-        "Auth context not yet loaded. Call `await agent.ensureContext()` or perform any db operation first (which auto-hydrates context). Inside the MindStudio sandbox, context is loaded automatically.",
-        "context_not_loaded",
-        400
-      );
-    }
-    return this._auth;
-  }
-  /**
-   * The `db` namespace — chainable collection API over managed databases.
-   *
-   * Use `db.defineTable<T>(name)` to get a typed Table<T>, then call
-   * collection methods (filter, sortBy, push, update, etc.) on it.
-   *
-   * Context is auto-hydrated on first query execution — you can safely
-   * call `defineTable()` at module scope without triggering any HTTP.
-   *
-   * @example
-   * ```ts
-   * const Orders = agent.db.defineTable<Order>('orders');
-   * const active = await Orders.filter(o => o.status === 'active').take(10);
-   * ```
-   */
-  get db() {
-    if (!this._db) {
-      this._trySandboxHydration();
-    }
-    if (this._db) return this._db;
-    return this._createLazyDb();
-  }
-  /**
-   * Hydrate the app context (auth + database metadata). This must be
-   * called before using `auth` synchronously. For `db`, hydration happens
-   * automatically on first query.
-   *
-   * Context is fetched once and cached for the instance's lifetime.
-   * Calling `ensureContext()` multiple times is safe (no-op after first).
-   *
-   * Context sources (checked in order):
-   * 1. Sandbox globals (`globalThis.ai.auth`, `globalThis.ai.databases`)
-   * 2. HTTP: `GET /developer/v2/helpers/app-context?appId={appId}`
-   *
-   * @throws {MindStudioError} if no `appId` is available
-   *
-   * @example
-   * ```ts
-   * await agent.ensureContext();
-   * // auth is now available synchronously
-   * agent.auth.requireRole(Roles.admin);
-   * ```
-   */
-  async ensureContext() {
-    if (this._context) return;
-    if (!this._contextPromise) {
-      this._contextPromise = this._hydrateContext();
-    }
-    await this._contextPromise;
-  }
-  /**
-   * @internal Fetch and cache app context, then create auth + db instances.
-   *
-   * In managed mode (CALLBACK_TOKEN), the platform resolves the app from
-   * the token — no appId needed. With an API key, appId is required.
-   */
-  async _hydrateContext() {
-    if (!this._appId && this._authType !== "internal") {
-      throw new MindStudioError(
-        "No app ID available for context resolution. Pass `appId` to the constructor, set the MINDSTUDIO_APP_ID environment variable, or make a step execution call first (which auto-detects the app ID).",
-        "missing_app_id",
-        400
-      );
-    }
-    const context = await this.getAppContext(this._appId);
-    this._applyContext(context);
-  }
-  /**
-   * @internal Apply a resolved context object — creates AuthContext and Db.
-   * Used by both the HTTP path and sandbox hydration.
-   */
-  _applyContext(context) {
-    this._context = context;
-    this._auth = new AuthContext(context.auth);
-    this._db = createDb(
-      context.databases,
-      this._executeDbBatch.bind(this)
-    );
-  }
-  /**
-   * @internal Try to hydrate context synchronously from sandbox globals.
-   * Called in the constructor when CALLBACK_TOKEN auth is detected.
-   *
-   * The MindStudio sandbox pre-populates `globalThis.ai` with:
-   * - `ai.auth`: { userId, roleAssignments[] }
-   * - `ai.databases`: [{ id, name, tables[] }]
-   */
-  _trySandboxHydration() {
-    const ai = globalThis.ai;
-    if (ai?.auth && ai?.databases) {
-      this._applyContext({
-        auth: ai.auth,
-        databases: ai.databases
-      });
-    }
-  }
-  /**
-   * @internal Execute a batch of SQL queries against a managed database.
-   * Used as the `executeBatch` callback for Table/Query instances.
-   *
-   * Calls `POST /_internal/v2/db/query` directly with the hook token
-   * (raw, no Bearer prefix). All queries run on a single SQLite connection,
-   * enabling RETURNING clauses and multi-statement batches.
-   */
-  async _executeDbBatch(databaseId, queries) {
-    const url = `${this._httpConfig.baseUrl}/_internal/v2/db/query`;
-    const res = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: this._token
-      },
-      body: JSON.stringify({ databaseId, queries })
-    });
-    if (!res.ok) {
-      let message = `Database query failed: ${res.status} ${res.statusText}`;
-      let code = "db_query_error";
-      try {
-        const text = await res.text();
-        try {
-          const body = JSON.parse(text);
-          const errMsg = body.error ?? body.message ?? body.details;
-          if (errMsg) message = errMsg;
-          if (body.code) code = body.code;
-        } catch {
-          if (text && text.length < 500) message = text;
-        }
-      } catch {
-      }
-      throw new MindStudioError(
-        `[db] ${message}`,
-        code,
-        res.status
-      );
-    }
-    const data = await res.json();
-    return data.results;
-  }
-  /**
-   * @internal Create a lazy Db proxy that auto-hydrates context.
-   *
-   * defineTable() returns Table instances immediately (no async needed).
-   * But the Table's executeBatch callback is wrapped to call ensureContext()
-   * before the first query, so context is fetched lazily.
-   */
-  _createLazyDb() {
-    const agent = this;
-    return {
-      defineTable(name, options) {
-        const databaseHint = options?.database;
-        return new Table({
-          databaseId: "",
-          tableName: name,
-          columns: [],
-          unique: options?.unique,
-          defaults: options?.defaults,
-          executeBatch: async (queries) => {
-            await agent.ensureContext();
-            const databases = agent._context.databases;
-            let targetDb;
-            if (databaseHint) {
-              targetDb = databases.find(
-                (d) => d.id === databaseHint || d.name === databaseHint
-              );
-            } else {
-              targetDb = databases.find(
-                (d) => d.tables.some((t) => t.name === name)
-              );
-            }
-            const databaseId = targetDb?.id ?? databases[0]?.id ?? "";
-            return agent._executeDbBatch(databaseId, queries);
-          }
-        });
-      },
-      // Time helpers work without context
-      now: () => Date.now(),
-      days: (n) => n * 864e5,
-      hours: (n) => n * 36e5,
-      minutes: (n) => n * 6e4,
-      ago: (ms) => Date.now() - ms,
-      fromNow: (ms) => Date.now() + ms,
-      // Batch needs context — hydrate first, then delegate to real db
-      batch: ((...queries) => {
-        return (async () => {
-          await agent.ensureContext();
-          return agent._db.batch(...queries);
-        })();
-      })
-    };
-  }
-  // -------------------------------------------------------------------------
-  // Helper methods — user resolution
-  // -------------------------------------------------------------------------
-  /**
-   * Resolve a single user ID to display info (name, email, profile picture).
-   *
-   * Use this when you have a `User`-typed field value and need the person's
-   * display name, email, or avatar. Returns null if the user ID is not found.
-   *
-   * Also available as a top-level import:
-   * ```ts
-   * import { resolveUser } from '@mindstudio-ai/agent';
-   * ```
-   *
-   * @param userId - The user ID to resolve (a `User` branded string or plain UUID)
-   * @returns Resolved user info, or null if not found
-   *
-   * @example
-   * ```ts
-   * const user = await agent.resolveUser(order.requestedBy);
-   * if (user) {
-   *   console.log(user.name);              // "Jane Smith"
-   *   console.log(user.email);             // "jane@example.com"
-   *   console.log(user.profilePictureUrl); // "https://..." or null
-   * }
-   * ```
-   */
-  async resolveUser(userId) {
-    const { users } = await this.resolveUsers([userId]);
-    return users[0] ?? null;
-  }
-  /**
-   * Resolve multiple user IDs to display info in a single request.
-   * Maximum 100 user IDs per request.
-   *
-   * Use this for batch resolution when you have multiple user references
-   * to display (e.g. all approvers on a purchase order, all team members).
-   *
-   * @param userIds - Array of user IDs to resolve (max 100)
-   * @returns Object with `users` array of resolved user info
-   *
-   * @example
-   * ```ts
-   * // Resolve all approvers at once
-   * const approverIds = approvals.map(a => a.assignedTo);
-   * const { users } = await agent.resolveUsers(approverIds);
-   *
-   * for (const u of users) {
-   *   console.log(`${u.name} (${u.email})`);
-   * }
-   * ```
-   */
-  async resolveUsers(userIds) {
-    const { data } = await request(
-      this._httpConfig,
-      "POST",
-      "/helpers/resolve-users",
-      { userIds }
-    );
-    return data;
-  }
-  // -------------------------------------------------------------------------
-  // App context
-  // -------------------------------------------------------------------------
-  /**
-   * Get auth and database context for an app.
-   *
-   * Returns role assignments and managed database schemas. Useful for
-   * hydrating `auth` and `db` namespaces when running outside the sandbox.
-   *
-   * When called with a CALLBACK_TOKEN (managed mode), `appId` is optional —
-   * the platform resolves the app from the token. With an API key, `appId`
-   * is required.
-   *
-   * ```ts
-   * const ctx = await agent.getAppContext('your-app-id');
-   * console.log(ctx.auth.roleAssignments, ctx.databases);
-   * ```
-   */
-  async getAppContext(appId) {
-    const query = appId ? `?appId=${encodeURIComponent(appId)}` : "";
-    const { data } = await request(
-      this._httpConfig,
-      "GET",
-      `/helpers/app-context${query}`
-    );
-    return data;
-  }
-  // -------------------------------------------------------------------------
-  // Account methods
-  // -------------------------------------------------------------------------
-  /** Update the display name of the authenticated user/agent. */
-  async changeName(displayName) {
-    await request(this._httpConfig, "POST", "/account/change-name", {
-      name: displayName
-    });
-  }
-  /** Update the profile picture of the authenticated user/agent. */
-  async changeProfilePicture(url) {
-    await request(this._httpConfig, "POST", "/account/change-profile-picture", {
-      url
-    });
-  }
-  /**
-   * Upload a file to the MindStudio CDN.
-   *
-   * Gets a signed upload URL, PUTs the file content, and returns the
-   * permanent public URL.
-   */
-  async uploadFile(content, options) {
-    const { data } = await request(
-      this._httpConfig,
-      "POST",
-      "/account/upload",
-      {
-        extension: options.extension,
-        ...options.type != null && { type: options.type }
-      }
-    );
-    const buf = content.buffer.slice(
-      content.byteOffset,
-      content.byteOffset + content.byteLength
-    );
-    const res = await fetch(data.uploadUrl, {
-      method: "PUT",
-      body: buf,
-      headers: options.type ? { "Content-Type": options.type } : {}
-    });
-    if (!res.ok) {
-      const errorBody = await res.json().catch(() => ({}));
-      throw new MindStudioError(
-        errorBody.message ?? errorBody.error ?? `Upload failed: ${res.status} ${res.statusText}`,
-        errorBody.code ?? "upload_error",
-        res.status,
-        errorBody
-      );
-    }
-    return { url: data.url };
-  }
-};
-function sleep2(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-applyStepMethods(MindStudioAgent);
-function resolveToken(provided, config) {
-  if (process.env.CALLBACK_TOKEN)
-    return { token: process.env.CALLBACK_TOKEN, authType: "internal" };
-  if (provided) return { token: provided, authType: "apiKey" };
-  if (process.env.MINDSTUDIO_API_KEY)
-    return { token: process.env.MINDSTUDIO_API_KEY, authType: "apiKey" };
-  if (config?.apiKey)
-    return { token: config.apiKey, authType: "apiKey" };
-  throw new MindStudioError(
-    "No API key provided. Run `mindstudio login`, pass `apiKey` to the constructor, or set the MINDSTUDIO_API_KEY environment variable.",
-    "missing_api_key",
-    401
-  );
-}
-
-// src/generated/snippets.ts
-var monacoSnippets = {
-  "activeCampaignAddNote": { fields: [["contactId", "string"], ["note", "string"]], outputKeys: [] },
-  "activeCampaignCreateContact": { fields: [["email", "string"], ["firstName", "string"], ["lastName", "string"], ["phone", "string"], ["accountId", "string"], ["customFields", "object"]], outputKeys: ["contactId"] },
-  "addSubtitlesToVideo": { fields: [["videoUrl", "string"], ["language", "string"], ["fontName", "string"], ["fontSize", "number"], ["fontWeight", ["normal", "bold", "black"]], ["fontColor", ["white", "black", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"]], ["highlightColor", ["white", "black", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"]], ["strokeWidth", "number"], ["strokeColor", ["black", "white", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"]], ["backgroundColor", ["black", "white", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta", "none"]], ["backgroundOpacity", "number"], ["position", ["top", "center", "bottom"]], ["yOffset", "number"], ["wordsPerSubtitle", "number"], ["enableAnimation", "boolean"]], outputKeys: ["videoUrl"] },
-  "airtableCreateUpdateRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["fields", "string"], ["recordData", "object"]], outputKeys: ["recordId"] },
-  "airtableDeleteRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["recordId", "string"]], outputKeys: ["deleted"] },
-  "airtableGetRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["recordId", "string"]], outputKeys: ["record"] },
-  "airtableGetTableRecords": { fields: [["baseId", "string"], ["tableId", "string"]], outputKeys: ["records"] },
-  "analyzeImage": { fields: [["prompt", "string"], ["imageUrl", "string"]], outputKeys: ["analysis"] },
-  "analyzeVideo": { fields: [["prompt", "string"], ["videoUrl", "string"]], outputKeys: ["analysis"] },
-  "captureThumbnail": { fields: [["videoUrl", "string"], ["at", "string"]], outputKeys: ["thumbnailUrl"] },
-  "checkAppRole": { fields: [["roleName", "string"]], outputKeys: ["hasRole", "userRoles"] },
-  "codaCreateUpdatePage": { fields: [["pageData", "object"]], outputKeys: ["pageId"] },
-  "codaCreateUpdateRow": { fields: [["docId", "string"], ["tableId", "string"], ["rowData", "object"]], outputKeys: ["rowId"] },
-  "codaFindRow": { fields: [["docId", "string"], ["tableId", "string"], ["rowData", "object"]], outputKeys: ["row"] },
-  "codaGetPage": { fields: [["docId", "string"], ["pageId", "string"]], outputKeys: ["content"] },
-  "codaGetTableRows": { fields: [["docId", "string"], ["tableId", "string"]], outputKeys: ["rows"] },
-  "convertPdfToImages": { fields: [["pdfUrl", "string"]], outputKeys: ["imageUrls"] },
-  "createDataSource": { fields: [["name", "string"]], outputKeys: [] },
-  "createGmailDraft": { fields: [["to", "string"], ["subject", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["draftId"] },
-  "createGoogleCalendarEvent": { fields: [["summary", "string"], ["startDateTime", "string"], ["endDateTime", "string"]], outputKeys: ["eventId", "htmlLink"] },
-  "createGoogleDoc": { fields: [["title", "string"], ["text", "string"], ["textType", ["plain", "html", "markdown"]]], outputKeys: ["documentUrl"] },
-  "createGoogleSheet": { fields: [["title", "string"], ["text", "string"]], outputKeys: ["spreadsheetUrl"] },
-  "deleteDataSource": { fields: [["dataSourceId", "string"]], outputKeys: [] },
-  "deleteDataSourceDocument": { fields: [["dataSourceId", "string"], ["documentId", "string"]], outputKeys: [] },
-  "deleteGmailEmail": { fields: [["messageId", "string"]], outputKeys: [] },
-  "deleteGoogleCalendarEvent": { fields: [["eventId", "string"]], outputKeys: [] },
-  "deleteGoogleSheetRows": { fields: [["documentId", "string"], ["startRow", "string"], ["endRow", "string"]], outputKeys: [] },
-  "detectChanges": { fields: [["mode", ["ai", "comparison"]], ["input", "string"]], outputKeys: ["hasChanged", "currentValue", "previousValue", "isFirstRun"] },
-  "detectPII": { fields: [["input", "string"], ["language", "string"], ["entities", "array"]], outputKeys: ["detected", "detections"] },
-  "discordEditMessage": { fields: [["botToken", "string"], ["channelId", "string"], ["messageId", "string"], ["text", "string"]], outputKeys: [] },
-  "discordSendFollowUp": { fields: [["applicationId", "string"], ["interactionToken", "string"], ["text", "string"]], outputKeys: ["messageId"] },
-  "discordSendMessage": { fields: [["mode", ["edit", "send"]], ["text", "string"]], outputKeys: [] },
-  "downloadVideo": { fields: [["videoUrl", "string"], ["format", ["mp4", "mp3"]]], outputKeys: ["videoUrl"] },
-  "enhanceImageGenerationPrompt": { fields: [["initialPrompt", "string"], ["includeNegativePrompt", "boolean"], ["systemPrompt", "string"]], outputKeys: ["prompt"] },
-  "enhanceVideoGenerationPrompt": { fields: [["initialPrompt", "string"], ["includeNegativePrompt", "boolean"], ["systemPrompt", "string"]], outputKeys: ["prompt"] },
-  "enrichPerson": { fields: [["params", "object"]], outputKeys: ["data"] },
-  "extractAudioFromVideo": { fields: [["videoUrl", "string"]], outputKeys: ["audioUrl"] },
-  "extractText": { fields: [["url", "string"]], outputKeys: ["text"] },
-  "fetchDataSourceDocument": { fields: [["dataSourceId", "string"], ["documentId", "string"]], outputKeys: [] },
-  "fetchGoogleDoc": { fields: [["documentId", "string"], ["exportType", ["html", "markdown", "json", "plain"]]], outputKeys: ["content"] },
-  "fetchGoogleSheet": { fields: [["spreadsheetId", "string"], ["range", "string"], ["exportType", ["csv", "json"]]], outputKeys: ["content"] },
-  "fetchSlackChannelHistory": { fields: [["channelId", "string"]], outputKeys: ["messages"] },
-  "fetchYoutubeCaptions": { fields: [["videoUrl", "string"], ["exportType", ["text", "json"]], ["language", "string"]], outputKeys: ["transcripts"] },
-  "fetchYoutubeChannel": { fields: [["channelUrl", "string"]], outputKeys: [] },
-  "fetchYoutubeComments": { fields: [["videoUrl", "string"], ["exportType", ["text", "json"]], ["limitPages", "string"]], outputKeys: ["comments"] },
-  "fetchYoutubeVideo": { fields: [["videoUrl", "string"]], outputKeys: [] },
-  "generateAsset": { fields: [["source", "string"], ["sourceType", ["html", "markdown", "spa", "raw", "dynamic", "customInterface"]], ["outputFormat", ["pdf", "png", "html", "mp4", "openGraph"]], ["pageSize", ["full", "letter", "A4", "custom"]], ["testData", "object"]], outputKeys: ["url"] },
-  "generateChart": { fields: [["chart", "object"]], outputKeys: ["chartUrl"] },
-  "generateImage": { fields: [["prompt", "string"]], outputKeys: ["imageUrl"] },
-  "generateLipsync": { fields: [], outputKeys: [] },
-  "generateMusic": { fields: [["text", "string"]], outputKeys: [] },
-  "generatePdf": { fields: [["source", "string"], ["sourceType", ["html", "markdown", "spa", "raw", "dynamic", "customInterface"]], ["outputFormat", ["pdf", "png", "html", "mp4", "openGraph"]], ["pageSize", ["full", "letter", "A4", "custom"]], ["testData", "object"]], outputKeys: ["url"] },
-  "generateStaticVideoFromImage": { fields: [["imageUrl", "string"], ["duration", "string"]], outputKeys: ["videoUrl"] },
-  "generateText": { fields: [["message", "string"]], outputKeys: ["content"] },
-  "generateVideo": { fields: [["prompt", "string"]], outputKeys: ["videoUrl"] },
-  "getGmailAttachments": { fields: [["messageId", "string"]], outputKeys: [] },
-  "getGmailDraft": { fields: [["draftId", "string"]], outputKeys: ["draftId", "messageId", "subject", "to", "from", "body"] },
-  "getGmailEmail": { fields: [["messageId", "string"]], outputKeys: ["messageId", "subject", "from", "to", "date", "body", "labels"] },
-  "getGmailUnreadCount": { fields: [], outputKeys: [] },
-  "getGoogleCalendarEvent": { fields: [["eventId", "string"], ["exportType", ["json", "text"]]], outputKeys: ["event"] },
-  "getGoogleDriveFile": { fields: [["fileId", "string"]], outputKeys: ["url", "name", "mimeType", "size"] },
-  "getGoogleSheetInfo": { fields: [["documentId", "string"]], outputKeys: ["title", "sheets"] },
-  "getMediaMetadata": { fields: [["mediaUrl", "string"]], outputKeys: ["metadata"] },
-  "httpRequest": { fields: [["url", "string"], ["method", "string"], ["headers", "object"], ["queryParams", "object"], ["body", "string"], ["bodyItems", "object"], ["contentType", ["none", "application/json", "application/x-www-form-urlencoded", "multipart/form-data", "custom"]], ["customContentType", "string"]], outputKeys: ["ok", "status", "statusText", "response"] },
-  "hubspotCreateCompany": { fields: [["company", "object"], ["enabledProperties", "array"]], outputKeys: ["companyId"] },
-  "hubspotCreateContact": { fields: [["contact", "object"], ["enabledProperties", "array"], ["companyDomain", "string"]], outputKeys: ["contactId"] },
-  "hubspotGetCompany": { fields: [["searchBy", ["domain", "id"]], ["companyDomain", "string"], ["companyId", "string"], ["additionalProperties", "array"]], outputKeys: ["company"] },
-  "hubspotGetContact": { fields: [["searchBy", ["email", "id"]], ["contactEmail", "string"], ["contactId", "string"], ["additionalProperties", "array"]], outputKeys: ["contact"] },
-  "hunterApiCompanyEnrichment": { fields: [["domain", "string"]], outputKeys: ["data"] },
-  "hunterApiDomainSearch": { fields: [["domain", "string"]], outputKeys: ["data"] },
-  "hunterApiEmailFinder": { fields: [["domain", "string"], ["firstName", "string"], ["lastName", "string"]], outputKeys: ["data"] },
-  "hunterApiEmailVerification": { fields: [["email", "string"]], outputKeys: ["data"] },
-  "hunterApiPersonEnrichment": { fields: [["email", "string"]], outputKeys: ["data"] },
-  "imageFaceSwap": { fields: [["imageUrl", "string"], ["faceImageUrl", "string"], ["engine", "string"]], outputKeys: ["imageUrl"] },
-  "imageRemoveWatermark": { fields: [["imageUrl", "string"], ["engine", "string"]], outputKeys: ["imageUrl"] },
-  "insertVideoClips": { fields: [["baseVideoUrl", "string"], ["overlayVideos", "array"]], outputKeys: ["videoUrl"] },
-  "listDataSources": { fields: [], outputKeys: [] },
-  "listGmailDrafts": { fields: [["exportType", ["json", "text"]]], outputKeys: ["drafts"] },
-  "listGmailLabels": { fields: [], outputKeys: [] },
-  "listGoogleCalendarEvents": { fields: [["limit", "number"], ["exportType", ["json", "text"]]], outputKeys: ["events"] },
-  "listGoogleDriveFiles": { fields: [["exportType", ["json", "text"]]], outputKeys: ["files"] },
-  "listRecentGmailEmails": { fields: [["exportType", ["json", "text"]], ["limit", "string"]], outputKeys: [] },
-  "logic": { fields: [["context", "string"], ["cases", "array"]], outputKeys: ["selectedCase"] },
-  "makeDotComRunScenario": { fields: [["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
-  "mergeAudio": { fields: [["mp3Urls", "array"]], outputKeys: ["audioUrl"] },
-  "mergeVideos": { fields: [["videoUrls", "array"]], outputKeys: ["videoUrl"] },
-  "mixAudioIntoVideo": { fields: [["videoUrl", "string"], ["audioUrl", "string"], ["options", "object"]], outputKeys: ["videoUrl"] },
-  "muteVideo": { fields: [["videoUrl", "string"]], outputKeys: ["videoUrl"] },
-  "n8nRunNode": { fields: [["method", "string"], ["authentication", ["none", "basic", "string"]], ["user", "string"], ["password", "string"], ["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
-  "notionCreatePage": { fields: [["pageId", "string"], ["content", "string"], ["title", "string"]], outputKeys: ["pageId", "pageUrl"] },
-  "notionUpdatePage": { fields: [["pageId", "string"], ["content", "string"], ["mode", ["append", "overwrite"]]], outputKeys: ["pageId", "pageUrl"] },
-  "peopleSearch": { fields: [["smartQuery", "string"], ["enrichPeople", "boolean"], ["enrichOrganizations", "boolean"], ["limit", "string"], ["page", "string"], ["params", "object"]], outputKeys: ["results"] },
-  "postToLinkedIn": { fields: [["message", "string"], ["visibility", ["PUBLIC", "CONNECTIONS"]]], outputKeys: [] },
-  "postToSlackChannel": { fields: [["channelId", "string"], ["messageType", ["string", "blocks"]], ["message", "string"]], outputKeys: [] },
-  "postToX": { fields: [["text", "string"]], outputKeys: [] },
-  "postToZapier": { fields: [["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
-  "queryAppDatabase": { fields: [["databaseId", "string"], ["sql", "string"]], outputKeys: ["rows", "changes"] },
-  "queryDataSource": { fields: [["dataSourceId", "string"], ["query", "string"], ["maxResults", "number"]], outputKeys: ["text", "chunks", "query", "citations", "latencyMs"] },
-  "queryExternalDatabase": { fields: [["query", "string"], ["outputFormat", ["json", "csv"]]], outputKeys: ["data"] },
-  "redactPII": { fields: [["input", "string"], ["language", "string"], ["entities", "array"]], outputKeys: ["text"] },
-  "removeBackgroundFromImage": { fields: [["imageUrl", "string"]], outputKeys: ["imageUrl"] },
-  "replyToGmailEmail": { fields: [["messageId", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["messageId"] },
-  "resizeVideo": { fields: [["videoUrl", "string"], ["mode", ["fit", "exact"]]], outputKeys: ["videoUrl"] },
-  "runFromConnectorRegistry": { fields: [["actionId", "string"], ["displayName", "string"], ["icon", "string"], ["configurationValues", "object"]], outputKeys: ["data"] },
-  "runPackagedWorkflow": { fields: [["appId", "string"], ["workflowId", "string"], ["inputVariables", "object"], ["outputVariables", "object"], ["name", "string"]], outputKeys: ["data"] },
-  "scrapeFacebookPage": { fields: [["pageUrl", "string"]], outputKeys: ["data"] },
-  "scrapeFacebookPosts": { fields: [["pageUrl", "string"]], outputKeys: ["data"] },
-  "scrapeInstagramComments": { fields: [["postUrl", "string"], ["resultsLimit", "string"]], outputKeys: ["data"] },
-  "scrapeInstagramMentions": { fields: [["profileUrl", "string"], ["resultsLimit", "string"]], outputKeys: ["data"] },
-  "scrapeInstagramPosts": { fields: [["profileUrl", "string"], ["resultsLimit", "string"], ["onlyPostsNewerThan", "string"]], outputKeys: ["data"] },
-  "scrapeInstagramProfile": { fields: [["profileUrl", "string"]], outputKeys: ["data"] },
-  "scrapeInstagramReels": { fields: [["profileUrl", "string"], ["resultsLimit", "string"]], outputKeys: ["data"] },
-  "scrapeLinkedInCompany": { fields: [["url", "string"]], outputKeys: ["company"] },
-  "scrapeLinkedInProfile": { fields: [["url", "string"]], outputKeys: ["profile"] },
-  "scrapeMetaThreadsProfile": { fields: [["profileUrl", "string"]], outputKeys: ["data"] },
-  "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"] },
-  "searchGoogleDrive": { fields: [["query", "string"], ["exportType", ["json", "text"]]], outputKeys: ["files"] },
-  "searchGoogleImages": { fields: [["query", "string"], ["exportType", ["text", "json"]]], outputKeys: ["images"] },
-  "searchGoogleNews": { fields: [["text", "string"], ["exportType", ["text", "json"]]], outputKeys: ["articles"] },
-  "searchGoogleTrends": { fields: [["text", "string"], ["hl", "string"], ["geo", "string"], ["data_type", ["TIMESERIES", "GEO_MAP", "GEO_MAP_0", "RELATED_TOPICS", "RELATED_QUERIES"]], ["cat", "string"], ["date", "string"], ["ts", "string"]], outputKeys: ["trends"] },
-  "searchPerplexity": { fields: [["query", "string"], ["exportType", ["text", "json"]]], outputKeys: ["results"] },
-  "searchXPosts": { fields: [["query", "string"], ["scope", ["recent", "all"]], ["options", "object"]], outputKeys: ["posts"] },
-  "searchYoutube": { fields: [["query", "string"], ["limitPages", "string"], ["filter", "string"], ["filterType", "string"]], outputKeys: ["results"] },
-  "searchYoutubeTrends": { fields: [["bp", ["now", "music", "gaming", "films"]], ["hl", "string"], ["gl", "string"]], outputKeys: [] },
-  "sendEmail": { fields: [["subject", "string"], ["body", "string"]], outputKeys: ["recipients"] },
-  "sendGmailDraft": { fields: [["draftId", "string"]], outputKeys: [] },
-  "sendGmailMessage": { fields: [["to", "string"], ["subject", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["messageId"] },
-  "sendSMS": { fields: [["body", "string"]], outputKeys: [] },
-  "setGmailReadStatus": { fields: [["messageIds", "string"], ["markAsRead", "boolean"]], outputKeys: [] },
-  "setRunTitle": { fields: [["title", "string"]], outputKeys: [] },
-  "setVariable": { fields: [["value", "string"]], outputKeys: [] },
-  "telegramEditMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["messageId", "string"], ["text", "string"]], outputKeys: [] },
-  "telegramReplyToMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["replyToMessageId", "string"], ["text", "string"]], outputKeys: ["messageId"] },
-  "telegramSendAudio": { fields: [["botToken", "string"], ["chatId", "string"], ["audioUrl", "string"], ["mode", ["audio", "voice"]]], outputKeys: [] },
-  "telegramSendFile": { fields: [["botToken", "string"], ["chatId", "string"], ["fileUrl", "string"]], outputKeys: [] },
-  "telegramSendImage": { fields: [["botToken", "string"], ["chatId", "string"], ["imageUrl", "string"]], outputKeys: [] },
-  "telegramSendMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["text", "string"]], outputKeys: ["messageId"] },
-  "telegramSendVideo": { fields: [["botToken", "string"], ["chatId", "string"], ["videoUrl", "string"]], outputKeys: [] },
-  "telegramSetTyping": { fields: [["botToken", "string"], ["chatId", "string"]], outputKeys: [] },
-  "textToSpeech": { fields: [["text", "string"]], outputKeys: ["audioUrl"] },
-  "transcribeAudio": { fields: [["audioUrl", "string"], ["prompt", "string"]], outputKeys: ["text"] },
-  "trimMedia": { fields: [["inputUrl", "string"]], outputKeys: ["mediaUrl"] },
-  "updateGmailLabels": { fields: [["query", "string"], ["messageIds", "string"], ["addLabelIds", "string"], ["removeLabelIds", "string"]], outputKeys: ["updatedMessageIds"] },
-  "updateGoogleCalendarEvent": { fields: [["eventId", "string"]], outputKeys: ["eventId", "htmlLink"] },
-  "updateGoogleDoc": { fields: [["documentId", "string"], ["text", "string"], ["textType", ["plain", "html", "markdown"]], ["operationType", ["addToTop", "addToBottom", "overwrite"]]], outputKeys: ["documentUrl"] },
-  "updateGoogleSheet": { fields: [["text", "string"], ["spreadsheetId", "string"], ["range", "string"], ["operationType", ["addToBottom", "overwrite", "range"]]], outputKeys: ["spreadsheetUrl"] },
-  "uploadDataSourceDocument": { fields: [["dataSourceId", "string"], ["file", "string"], ["fileName", "string"]], outputKeys: [] },
-  "upscaleImage": { fields: [["imageUrl", "string"], ["targetResolution", ["2k", "4k", "8k"]], ["engine", ["standard", "pro"]]], outputKeys: ["imageUrl"] },
-  "upscaleVideo": { fields: [["videoUrl", "string"], ["targetResolution", ["720p", "1080p", "2K", "4K"]], ["engine", ["standard", "pro", "ultimate", "flashvsr", "seedance", "seedvr2", "runwayml/upscale-v1"]]], outputKeys: ["videoUrl"] },
-  "userMessage": { fields: [["message", "string"]], outputKeys: ["content"] },
-  "videoFaceSwap": { fields: [["videoUrl", "string"], ["faceImageUrl", "string"], ["targetIndex", "number"], ["engine", "string"]], outputKeys: ["videoUrl"] },
-  "videoRemoveBackground": { fields: [["videoUrl", "string"], ["newBackground", ["transparent", "image"]], ["engine", "string"]], outputKeys: ["videoUrl"] },
-  "videoRemoveWatermark": { fields: [["videoUrl", "string"], ["engine", "string"]], outputKeys: ["videoUrl"] },
-  "watermarkImage": { fields: [["imageUrl", "string"], ["watermarkImageUrl", "string"], ["corner", ["top-left", "top-right", "bottom-left", "bottom-right"]], ["paddingPx", "number"], ["widthPx", "number"]], outputKeys: ["imageUrl"] },
-  "watermarkVideo": { fields: [["videoUrl", "string"], ["imageUrl", "string"], ["corner", ["top-left", "top-right", "bottom-left", "bottom-right"]], ["paddingPx", "number"], ["widthPx", "number"]], outputKeys: ["videoUrl"] }
-};
-var blockTypeAliases = {
-  "userMessage": "generateText",
-  "generatePdf": "generateAsset"
-};
-
 // src/generated/metadata.ts
 var stepMetadata = {
   "activeCampaignAddNote": {
@@ -4289,6 +3227,1183 @@ var stepMetadata = {
   }
 };
 
+// src/client.ts
+var DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
+var DEFAULT_MAX_RETRIES = 3;
+var MindStudioAgent = class {
+  /** @internal */
+  _httpConfig;
+  /** @internal */
+  _reuseThreadId;
+  /** @internal */
+  _threadId;
+  /** @internal Stream ID for SSE token streaming. Set by sandbox via STREAM_ID env var. */
+  _streamId;
+  // ---- App context (db + auth) ----
+  /**
+   * @internal App ID for context resolution. Resolved from:
+   * constructor appId → MINDSTUDIO_APP_ID env → sandbox globals →
+   * auto-detected from first executeStep response header.
+   */
+  _appId;
+  /**
+   * @internal Cached app context (auth + databases). Populated by
+   * ensureContext() and cached for the lifetime of the instance.
+   */
+  _context;
+  /**
+   * @internal Deduplication promise for ensureContext(). Ensures only one
+   * context fetch is in-flight at a time, even if multiple db/auth
+   * operations trigger it concurrently.
+   */
+  _contextPromise;
+  /** @internal Cached AuthContext instance, created during context hydration. */
+  _auth;
+  /** @internal Cached Db namespace instance, created during context hydration. */
+  _db;
+  /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
+  _authType;
+  /**
+   * @internal Resolve the current auth token. For internal (CALLBACK_TOKEN)
+   * auth, re-reads the env var each time so that long-lived singleton
+   * instances pick up token rotations from the host process.
+   */
+  get _token() {
+    if (this._authType === "internal" && process.env.CALLBACK_TOKEN) {
+      return process.env.CALLBACK_TOKEN;
+    }
+    return this._httpConfig.token;
+  }
+  constructor(options = {}) {
+    const config = loadConfig();
+    const { token, authType } = resolveToken(options.apiKey, config);
+    const baseUrl = options.baseUrl ?? process.env.MINDSTUDIO_BASE_URL ?? process.env.REMOTE_HOSTNAME ?? config.baseUrl ?? DEFAULT_BASE_URL;
+    this._reuseThreadId = options.reuseThreadId ?? /^(true|1)$/i.test(process.env.MINDSTUDIO_REUSE_THREAD_ID ?? "");
+    this._appId = options.appId ?? process.env.MINDSTUDIO_APP_ID ?? void 0;
+    this._authType = authType;
+    this._httpConfig = {
+      baseUrl,
+      token,
+      rateLimiter: new RateLimiter(authType),
+      maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES
+    };
+    if (authType === "internal") {
+      this._trySandboxHydration();
+    }
+    this._streamId = process.env.STREAM_ID ?? void 0;
+  }
+  /**
+   * Execute any step by its type name. This is the low-level method that all
+   * typed step methods delegate to. Use it as an escape hatch for step types
+   * not yet covered by the generated methods.
+   *
+   * ```ts
+   * const result = await agent.executeStep("generateImage", { prompt: "hello", mode: "background" });
+   * ```
+   */
+  async executeStep(stepType, step, options) {
+    if (options?.onLog) {
+      return this._executeStepStreaming(
+        stepType,
+        step,
+        options
+      );
+    }
+    const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
+    const { data, headers } = await request(this._httpConfig, "POST", `/steps/${stepType}/execute`, {
+      step,
+      ...options?.appId != null && { appId: options.appId },
+      ...threadId != null && { threadId },
+      ...this._streamId != null && { streamId: this._streamId }
+    });
+    let output;
+    if (data.output != null) {
+      output = data.output;
+    } else if (data.outputUrl) {
+      const res = await fetch(data.outputUrl);
+      if (!res.ok) {
+        throw new MindStudioError(
+          `Failed to fetch output from S3: ${res.status} ${res.statusText}`,
+          "output_fetch_error",
+          res.status
+        );
+      }
+      const envelope = await res.json();
+      output = envelope.value;
+    } else {
+      output = void 0;
+    }
+    const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
+    if (this._reuseThreadId && returnedThreadId) {
+      this._threadId = returnedThreadId;
+    }
+    const returnedAppId = headers.get("x-mindstudio-app-id");
+    if (!this._appId && returnedAppId) {
+      this._appId = returnedAppId;
+    }
+    const remaining = headers.get("x-ratelimit-remaining");
+    const billingCost = headers.get("x-mindstudio-billing-cost");
+    const billingEvents = headers.get("x-mindstudio-billing-events");
+    return {
+      ...output,
+      $appId: headers.get("x-mindstudio-app-id") ?? "",
+      $threadId: returnedThreadId,
+      $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
+      $billingCost: billingCost != null ? parseFloat(billingCost) : void 0,
+      $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
+    };
+  }
+  /**
+   * @internal Streaming step execution — sends `Accept: text/event-stream`
+   * and parses SSE events for real-time debug logs.
+   */
+  async _executeStepStreaming(stepType, step, options) {
+    const threadId = options.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
+    const url = `${this._httpConfig.baseUrl}/developer/v2/steps/${stepType}/execute`;
+    const body = {
+      step,
+      ...options.appId != null && { appId: options.appId },
+      ...threadId != null && { threadId },
+      ...this._streamId != null && { streamId: this._streamId }
+    };
+    await this._httpConfig.rateLimiter.acquire();
+    let res;
+    try {
+      res = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this._token}`,
+          "Content-Type": "application/json",
+          "User-Agent": "@mindstudio-ai/agent",
+          Accept: "text/event-stream"
+        },
+        body: JSON.stringify(body)
+      });
+    } catch (err) {
+      this._httpConfig.rateLimiter.release();
+      throw err;
+    }
+    this._httpConfig.rateLimiter.updateFromHeaders(res.headers);
+    if (!res.ok) {
+      this._httpConfig.rateLimiter.release();
+      const errorBody = await res.json().catch(() => ({}));
+      throw new MindStudioError(
+        errorBody.message || `${res.status} ${res.statusText}`,
+        errorBody.code || "api_error",
+        res.status,
+        errorBody
+      );
+    }
+    const headers = res.headers;
+    try {
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let doneEvent = null;
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          try {
+            const event = JSON.parse(line.slice(6));
+            if (event.type === "log") {
+              options.onLog({
+                value: event.value,
+                tag: event.tag,
+                ts: event.ts
+              });
+            } else if (event.type === "done") {
+              doneEvent = {
+                output: event.output,
+                outputUrl: event.outputUrl,
+                billingCost: event.billingCost,
+                billingEvents: event.billingEvents
+              };
+            } else if (event.type === "error") {
+              throw new MindStudioError(
+                event.error || "Step execution failed",
+                "step_error",
+                500
+              );
+            }
+          } catch (err) {
+            if (err instanceof MindStudioError) throw err;
+          }
+        }
+      }
+      if (buffer.startsWith("data: ")) {
+        try {
+          const event = JSON.parse(buffer.slice(6));
+          if (event.type === "done") {
+            doneEvent = {
+              output: event.output,
+              outputUrl: event.outputUrl,
+              billingCost: event.billingCost,
+              billingEvents: event.billingEvents
+            };
+          } else if (event.type === "error") {
+            throw new MindStudioError(
+              event.error || "Step execution failed",
+              "step_error",
+              500
+            );
+          } else if (event.type === "log") {
+            options.onLog({
+              value: event.value,
+              tag: event.tag,
+              ts: event.ts
+            });
+          }
+        } catch (err) {
+          if (err instanceof MindStudioError) throw err;
+        }
+      }
+      if (!doneEvent) {
+        throw new MindStudioError(
+          "Stream ended without a done event",
+          "stream_error",
+          500
+        );
+      }
+      let output;
+      if (doneEvent.output != null) {
+        output = doneEvent.output;
+      } else if (doneEvent.outputUrl) {
+        const s3Res = await fetch(doneEvent.outputUrl);
+        if (!s3Res.ok) {
+          throw new MindStudioError(
+            `Failed to fetch output from S3: ${s3Res.status} ${s3Res.statusText}`,
+            "output_fetch_error",
+            s3Res.status
+          );
+        }
+        const envelope = await s3Res.json();
+        output = envelope.value;
+      } else {
+        output = void 0;
+      }
+      const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
+      if (this._reuseThreadId && returnedThreadId) {
+        this._threadId = returnedThreadId;
+      }
+      const returnedAppId = headers.get("x-mindstudio-app-id");
+      if (!this._appId && returnedAppId) {
+        this._appId = returnedAppId;
+      }
+      const remaining = headers.get("x-ratelimit-remaining");
+      return {
+        ...output,
+        $appId: headers.get("x-mindstudio-app-id") ?? "",
+        $threadId: returnedThreadId,
+        $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
+        $billingCost: doneEvent.billingCost,
+        $billingEvents: doneEvent.billingEvents
+      };
+    } finally {
+      this._httpConfig.rateLimiter.release();
+    }
+  }
+  /**
+   * Execute multiple steps in parallel in a single request.
+   *
+   * All steps run in parallel on the server. Results are returned in the same
+   * order as the input. Individual step failures do not affect other steps —
+   * partial success is possible.
+   *
+   * ```ts
+   * const { results } = await agent.executeStepBatch([
+   *   { stepType: 'generateImage', step: { prompt: 'a sunset' } },
+   *   { stepType: 'textToSpeech', step: { text: 'Hello world' } },
+   * ]);
+   * ```
+   */
+  async executeStepBatch(steps, options) {
+    const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
+    const { data } = await request(this._httpConfig, "POST", "/steps/execute-batch", {
+      steps: steps.map((s) => ({ ...s, stepType: resolveStepType(s.stepType) })),
+      ...options?.appId != null && { appId: options.appId },
+      ...threadId != null && { threadId }
+    });
+    const results = await Promise.all(
+      data.results.map(async (r) => {
+        if (r.output != null) {
+          return {
+            stepType: r.stepType,
+            output: r.output,
+            billingCost: r.billingCost,
+            error: r.error
+          };
+        }
+        if (r.outputUrl) {
+          const res = await fetch(r.outputUrl);
+          if (!res.ok) {
+            return {
+              stepType: r.stepType,
+              error: `Failed to fetch output from S3: ${res.status} ${res.statusText}`
+            };
+          }
+          const envelope = await res.json();
+          return {
+            stepType: r.stepType,
+            output: envelope.value,
+            billingCost: r.billingCost
+          };
+        }
+        return {
+          stepType: r.stepType,
+          billingCost: r.billingCost,
+          error: r.error
+        };
+      })
+    );
+    if (this._reuseThreadId && data.threadId) {
+      this._threadId = data.threadId;
+    }
+    return {
+      results,
+      totalBillingCost: data.totalBillingCost,
+      appId: data.appId,
+      threadId: data.threadId
+    };
+  }
+  /**
+   * Get the authenticated user's identity and organization info.
+   *
+   * ```ts
+   * const info = await agent.getUserInfo();
+   * console.log(info.displayName, info.organizationName);
+   * ```
+   */
+  async getUserInfo() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/account/userinfo"
+    );
+    return data;
+  }
+  /**
+   * List all pre-built agents in the organization.
+   *
+   * ```ts
+   * const { apps } = await agent.listAgents();
+   * for (const app of apps) console.log(app.name, app.id);
+   * ```
+   */
+  async listAgents() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/agents/load"
+    );
+    return data;
+  }
+  /**
+   * Run a pre-built agent and wait for the result.
+   *
+   * Uses async polling internally — the request returns immediately with a
+   * callback token, then polls until the run completes or fails.
+   *
+   * ```ts
+   * const result = await agent.runAgent({
+   *   appId: 'your-agent-id',
+   *   variables: { query: 'hello' },
+   * });
+   * console.log(result.result);
+   * ```
+   */
+  async runAgent(options) {
+    const pollInterval = options.pollIntervalMs ?? 1e3;
+    const { data } = await request(this._httpConfig, "POST", "/agents/run", {
+      appId: options.appId,
+      async: true,
+      ...options.variables != null && { variables: options.variables },
+      ...options.workflow != null && { workflow: options.workflow },
+      ...options.version != null && { version: options.version },
+      ...options.includeBillingCost != null && {
+        includeBillingCost: options.includeBillingCost
+      },
+      ...options.metadata != null && { metadata: options.metadata }
+    });
+    const token = data.callbackToken;
+    const pollUrl = `${this._httpConfig.baseUrl}/developer/v2/agents/run/poll/${token}`;
+    while (true) {
+      await sleep2(pollInterval);
+      const res = await fetch(pollUrl, {
+        headers: { "User-Agent": "@mindstudio-ai/agent" }
+      });
+      if (res.status === 404) {
+        throw new MindStudioError(
+          "Poll token not found or expired.",
+          "poll_token_expired",
+          404
+        );
+      }
+      if (!res.ok) {
+        const errorBody = await res.json().catch(() => ({}));
+        throw new MindStudioError(
+          errorBody.message ?? errorBody.error ?? `Poll request failed: ${res.status} ${res.statusText}`,
+          errorBody.code ?? "poll_error",
+          res.status,
+          errorBody
+        );
+      }
+      const poll = await res.json();
+      if (poll.status === "pending") continue;
+      if (poll.status === "error") {
+        throw new MindStudioError(
+          poll.error ?? "Agent run failed.",
+          "agent_run_error",
+          500
+        );
+      }
+      return poll.result;
+    }
+  }
+  /** @internal Used by generated action methods. */
+  _request(method, path, body) {
+    return request(this._httpConfig, method, path, body);
+  }
+  // -------------------------------------------------------------------------
+  // Helper methods — models
+  // -------------------------------------------------------------------------
+  /** List all available AI models. */
+  async listModels() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/models"
+    );
+    return data;
+  }
+  /** List AI models filtered by type. */
+  async listModelsByType(modelType) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/models/${modelType}`
+    );
+    return data;
+  }
+  /** List all available AI models (summary). Returns only id, name, type, and tags. */
+  async listModelsSummary() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/models-summary"
+    );
+    return data;
+  }
+  /** List AI models (summary) filtered by type. */
+  async listModelsSummaryByType(modelType) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/models-summary/${modelType}`
+    );
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Helper methods — OAuth connectors & connections
+  // -------------------------------------------------------------------------
+  /**
+   * List available OAuth connector services (Slack, Google, HubSpot, etc.).
+   *
+   * These are third-party integrations from the MindStudio Connector Registry.
+   * For most tasks, use actions directly instead.
+   */
+  async listConnectors() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/connectors"
+    );
+    return data;
+  }
+  /** Get details for a single OAuth connector service. */
+  async getConnector(serviceId) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/connectors/${serviceId}`
+    );
+    return data;
+  }
+  /** Get the full configuration for an OAuth connector action, including input fields. */
+  async getConnectorAction(serviceId, actionId) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/connectors/${serviceId}/${actionId}`
+    );
+    return data;
+  }
+  /** List OAuth connections for the organization. These are authenticated third-party service links. */
+  async listConnections() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/connections"
+    );
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Helper methods — cost estimation
+  // -------------------------------------------------------------------------
+  /** Estimate the cost of executing an action before running it. */
+  async estimateStepCost(stepType, step, options) {
+    const { data } = await request(this._httpConfig, "POST", "/helpers/step-cost-estimate", {
+      step: { type: resolveStepType(stepType), ...step },
+      ...options
+    });
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Streaming
+  // -------------------------------------------------------------------------
+  /**
+   * Send a stream chunk to the caller via SSE.
+   *
+   * When invoked from a method that was called with `stream: true`, chunks
+   * are delivered in real-time as Server-Sent Events. When there is no active
+   * stream (no `STREAM_ID`), calls are silently ignored — so it's safe to
+   * call unconditionally.
+   *
+   * Accepts strings (sent as `type: 'token'`) or structured data (sent as
+   * `type: 'data'`). The caller receives each chunk as an SSE event.
+   *
+   * @example
+   * ```ts
+   * // Stream text tokens
+   * await agent.stream('Processing item 1...');
+   *
+   * // Stream structured data
+   * await agent.stream({ progress: 50, currentItem: 'abc' });
+   * ```
+   */
+  stream = async (data) => {
+    if (!this._streamId) return;
+    const url = `${this._httpConfig.baseUrl}/_internal/v2/stream-chunk`;
+    const body = typeof data === "string" ? { streamId: this._streamId, type: "token", text: data } : { streamId: this._streamId, type: "data", data };
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: this._token
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      console.warn(`[mindstudio] stream chunk failed: ${res.status} ${text}`);
+    }
+  };
+  // -------------------------------------------------------------------------
+  // db + auth namespaces
+  // -------------------------------------------------------------------------
+  /**
+   * The `auth` namespace — synchronous role-based access control.
+   *
+   * Provides the current user's identity and roles. All methods are
+   * synchronous since the role map is preloaded during context hydration.
+   *
+   * **Important**: Context must be hydrated before accessing `auth`.
+   * - Inside the MindStudio sandbox: automatic (populated from globals)
+   * - Outside the sandbox: call `await agent.ensureContext()` first,
+   *   or access `auth` after any `db` operation (which auto-hydrates)
+   *
+   * @throws {MindStudioError} if context has not been hydrated yet
+   *
+   * @example
+   * ```ts
+   * await agent.ensureContext();
+   * agent.auth.requireRole(Roles.admin);
+   * const admins = agent.auth.getUsersByRole(Roles.admin);
+   * ```
+   */
+  get auth() {
+    if (!this._auth) {
+      this._trySandboxHydration();
+    }
+    if (!this._auth) {
+      throw new MindStudioError(
+        "Auth context not yet loaded. Call `await agent.ensureContext()` or perform any db operation first (which auto-hydrates context). Inside the MindStudio sandbox, context is loaded automatically.",
+        "context_not_loaded",
+        400
+      );
+    }
+    return this._auth;
+  }
+  /**
+   * The `db` namespace — chainable collection API over managed databases.
+   *
+   * Use `db.defineTable<T>(name)` to get a typed Table<T>, then call
+   * collection methods (filter, sortBy, push, update, etc.) on it.
+   *
+   * Context is auto-hydrated on first query execution — you can safely
+   * call `defineTable()` at module scope without triggering any HTTP.
+   *
+   * @example
+   * ```ts
+   * const Orders = agent.db.defineTable<Order>('orders');
+   * const active = await Orders.filter(o => o.status === 'active').take(10);
+   * ```
+   */
+  get db() {
+    if (!this._db) {
+      this._trySandboxHydration();
+    }
+    if (this._db) return this._db;
+    return this._createLazyDb();
+  }
+  /**
+   * Hydrate the app context (auth + database metadata). This must be
+   * called before using `auth` synchronously. For `db`, hydration happens
+   * automatically on first query.
+   *
+   * Context is fetched once and cached for the instance's lifetime.
+   * Calling `ensureContext()` multiple times is safe (no-op after first).
+   *
+   * Context sources (checked in order):
+   * 1. Sandbox globals (`globalThis.ai.auth`, `globalThis.ai.databases`)
+   * 2. HTTP: `GET /developer/v2/helpers/app-context?appId={appId}`
+   *
+   * @throws {MindStudioError} if no `appId` is available
+   *
+   * @example
+   * ```ts
+   * await agent.ensureContext();
+   * // auth is now available synchronously
+   * agent.auth.requireRole(Roles.admin);
+   * ```
+   */
+  async ensureContext() {
+    if (this._context) return;
+    if (!this._contextPromise) {
+      this._contextPromise = this._hydrateContext();
+    }
+    await this._contextPromise;
+  }
+  /**
+   * @internal Fetch and cache app context, then create auth + db instances.
+   *
+   * In managed mode (CALLBACK_TOKEN), the platform resolves the app from
+   * the token — no appId needed. With an API key, appId is required.
+   */
+  async _hydrateContext() {
+    if (!this._appId && this._authType !== "internal") {
+      throw new MindStudioError(
+        "No app ID available for context resolution. Pass `appId` to the constructor, set the MINDSTUDIO_APP_ID environment variable, or make a step execution call first (which auto-detects the app ID).",
+        "missing_app_id",
+        400
+      );
+    }
+    const context = await this.getAppContext(this._appId);
+    this._applyContext(context);
+  }
+  /**
+   * @internal Apply a resolved context object — creates AuthContext and Db.
+   * Used by both the HTTP path and sandbox hydration.
+   */
+  _applyContext(context) {
+    this._context = context;
+    this._auth = new AuthContext(context.auth);
+    this._db = createDb(
+      context.databases,
+      this._executeDbBatch.bind(this),
+      context.authConfig,
+      this._syncRoles.bind(this)
+    );
+  }
+  /**
+   * @internal Try to hydrate context synchronously from sandbox globals.
+   * Called in the constructor when CALLBACK_TOKEN auth is detected.
+   *
+   * The MindStudio sandbox pre-populates `globalThis.ai` with:
+   * - `ai.auth`: { userId, roleAssignments[] }
+   * - `ai.databases`: [{ id, name, tables[] }]
+   */
+  _trySandboxHydration() {
+    const ai = globalThis.ai;
+    if (ai?.auth && ai?.databases) {
+      this._applyContext({
+        auth: ai.auth,
+        databases: ai.databases,
+        authConfig: ai.authConfig
+      });
+    }
+  }
+  /**
+   * @internal Execute a batch of SQL queries against a managed database.
+   * Used as the `executeBatch` callback for Table/Query instances.
+   *
+   * Calls `POST /_internal/v2/db/query` directly with the hook token
+   * (raw, no Bearer prefix). All queries run on a single SQLite connection,
+   * enabling RETURNING clauses and multi-statement batches.
+   */
+  async _executeDbBatch(databaseId, queries) {
+    const url = `${this._httpConfig.baseUrl}/_internal/v2/db/query`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: this._token
+      },
+      body: JSON.stringify({ databaseId, queries })
+    });
+    if (!res.ok) {
+      let message = `Database query failed: ${res.status} ${res.statusText}`;
+      let code = "db_query_error";
+      try {
+        const text = await res.text();
+        try {
+          const body = JSON.parse(text);
+          const errMsg = body.error ?? body.message ?? body.details;
+          if (errMsg) message = errMsg;
+          if (body.code) code = body.code;
+        } catch {
+          if (text && text.length < 500) message = text;
+        }
+      } catch {
+      }
+      throw new MindStudioError(
+        `[db] ${message}`,
+        code,
+        res.status
+      );
+    }
+    const data = await res.json();
+    return data.results;
+  }
+  /**
+   * @internal Sync a user's roles to the platform after a successful
+   * auth table write. Calls POST /_internal/v2/auth/sync-user.
+   * Fire-and-forget: errors are caught and logged, never propagated.
+   */
+  async _syncRoles(userId, roles) {
+    try {
+      const url = `${this._httpConfig.baseUrl}/_internal/v2/auth/sync-user`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: this._token
+        },
+        body: JSON.stringify({
+          appId: this._appId,
+          userId,
+          roles
+        })
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        console.warn(
+          `[mindstudio] Failed to sync roles for user ${userId}: ${res.status} ${text}`
+        );
+      }
+    } catch (err) {
+      console.warn(
+        `[mindstudio] Failed to sync roles for user ${userId}:`,
+        err
+      );
+    }
+  }
+  /**
+   * @internal Create a lazy Db proxy that auto-hydrates context.
+   *
+   * defineTable() returns Table instances immediately (no async needed).
+   * But the Table's executeBatch callback is wrapped to call ensureContext()
+   * before the first query, so context is fetched lazily.
+   */
+  _createLazyDb() {
+    const agent = this;
+    return {
+      defineTable(name, options) {
+        const databaseHint = options?.database;
+        const tableConfig = {
+          databaseId: "",
+          tableName: name,
+          columns: [],
+          unique: options?.unique,
+          defaults: options?.defaults,
+          executeBatch: async (queries) => {
+            await agent.ensureContext();
+            const ac = agent._context.authConfig;
+            if (ac && ac.table === name && !tableConfig.managedColumns) {
+              tableConfig.managedColumns = ac.columns;
+              if (ac.columns.roles) {
+                tableConfig.syncRoles = agent._syncRoles.bind(agent);
+              }
+            }
+            const databases = agent._context.databases;
+            let targetDb;
+            if (databaseHint) {
+              targetDb = databases.find(
+                (d) => d.id === databaseHint || d.name === databaseHint
+              );
+            } else {
+              targetDb = databases.find(
+                (d) => d.tables.some((t) => t.name === name)
+              );
+            }
+            const databaseId = targetDb?.id ?? databases[0]?.id ?? "";
+            return agent._executeDbBatch(databaseId, queries);
+          }
+        };
+        return new Table(tableConfig);
+      },
+      // Time helpers work without context
+      now: () => Date.now(),
+      days: (n) => n * 864e5,
+      hours: (n) => n * 36e5,
+      minutes: (n) => n * 6e4,
+      ago: (ms) => Date.now() - ms,
+      fromNow: (ms) => Date.now() + ms,
+      // Batch needs context — hydrate first, then delegate to real db
+      batch: ((...queries) => {
+        return (async () => {
+          await agent.ensureContext();
+          return agent._db.batch(...queries);
+        })();
+      })
+    };
+  }
+  // -------------------------------------------------------------------------
+  // Helper methods — user resolution
+  // -------------------------------------------------------------------------
+  /**
+   * Resolve a single user ID to display info (name, email, profile picture).
+   *
+   * Use this when you have a `User`-typed field value and need the person's
+   * display name, email, or avatar. Returns null if the user ID is not found.
+   *
+   * Also available as a top-level import:
+   * ```ts
+   * import { resolveUser } from '@mindstudio-ai/agent';
+   * ```
+   *
+   * @param userId - The user ID to resolve (a `User` branded string or plain UUID)
+   * @returns Resolved user info, or null if not found
+   *
+   * @example
+   * ```ts
+   * const user = await agent.resolveUser(order.requestedBy);
+   * if (user) {
+   *   console.log(user.name);              // "Jane Smith"
+   *   console.log(user.email);             // "jane@example.com"
+   *   console.log(user.profilePictureUrl); // "https://..." or null
+   * }
+   * ```
+   */
+  async resolveUser(userId) {
+    const { users } = await this.resolveUsers([userId]);
+    return users[0] ?? null;
+  }
+  /**
+   * Resolve multiple user IDs to display info in a single request.
+   * Maximum 100 user IDs per request.
+   *
+   * Use this for batch resolution when you have multiple user references
+   * to display (e.g. all approvers on a purchase order, all team members).
+   *
+   * @param userIds - Array of user IDs to resolve (max 100)
+   * @returns Object with `users` array of resolved user info
+   *
+   * @example
+   * ```ts
+   * // Resolve all approvers at once
+   * const approverIds = approvals.map(a => a.assignedTo);
+   * const { users } = await agent.resolveUsers(approverIds);
+   *
+   * for (const u of users) {
+   *   console.log(`${u.name} (${u.email})`);
+   * }
+   * ```
+   */
+  async resolveUsers(userIds) {
+    const { data } = await request(
+      this._httpConfig,
+      "POST",
+      "/helpers/resolve-users",
+      { userIds }
+    );
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // App context
+  // -------------------------------------------------------------------------
+  /**
+   * Get auth and database context for an app.
+   *
+   * Returns role assignments and managed database schemas. Useful for
+   * hydrating `auth` and `db` namespaces when running outside the sandbox.
+   *
+   * When called with a CALLBACK_TOKEN (managed mode), `appId` is optional —
+   * the platform resolves the app from the token. With an API key, `appId`
+   * is required.
+   *
+   * ```ts
+   * const ctx = await agent.getAppContext('your-app-id');
+   * console.log(ctx.auth.roleAssignments, ctx.databases);
+   * ```
+   */
+  async getAppContext(appId) {
+    const query = appId ? `?appId=${encodeURIComponent(appId)}` : "";
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/app-context${query}`
+    );
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Account methods
+  // -------------------------------------------------------------------------
+  /** Update the display name of the authenticated user/agent. */
+  async changeName(displayName) {
+    await request(this._httpConfig, "POST", "/account/change-name", {
+      name: displayName
+    });
+  }
+  /** Update the profile picture of the authenticated user/agent. */
+  async changeProfilePicture(url) {
+    await request(this._httpConfig, "POST", "/account/change-profile-picture", {
+      url
+    });
+  }
+  /**
+   * Upload a file to the MindStudio CDN.
+   *
+   * Gets a signed upload URL, PUTs the file content, and returns the
+   * permanent public URL.
+   */
+  async uploadFile(content, options) {
+    const { data } = await request(
+      this._httpConfig,
+      "POST",
+      "/account/upload",
+      {
+        extension: options.extension,
+        ...options.type != null && { type: options.type }
+      }
+    );
+    const buf = content.buffer.slice(
+      content.byteOffset,
+      content.byteOffset + content.byteLength
+    );
+    const res = await fetch(data.uploadUrl, {
+      method: "PUT",
+      body: buf,
+      headers: options.type ? { "Content-Type": options.type } : {}
+    });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({}));
+      throw new MindStudioError(
+        errorBody.message ?? errorBody.error ?? `Upload failed: ${res.status} ${res.statusText}`,
+        errorBody.code ?? "upload_error",
+        res.status,
+        errorBody
+      );
+    }
+    return { url: data.url };
+  }
+};
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+applyStepMethods(MindStudioAgent);
+function resolveStepType(name) {
+  const meta = stepMetadata[name];
+  return meta ? meta.stepType : name;
+}
+function resolveToken(provided, config) {
+  if (process.env.CALLBACK_TOKEN)
+    return { token: process.env.CALLBACK_TOKEN, authType: "internal" };
+  if (provided) return { token: provided, authType: "apiKey" };
+  if (process.env.MINDSTUDIO_API_KEY)
+    return { token: process.env.MINDSTUDIO_API_KEY, authType: "apiKey" };
+  if (config?.apiKey)
+    return { token: config.apiKey, authType: "apiKey" };
+  throw new MindStudioError(
+    "No API key provided. Run `mindstudio login`, pass `apiKey` to the constructor, or set the MINDSTUDIO_API_KEY environment variable.",
+    "missing_api_key",
+    401
+  );
+}
+
+// src/generated/snippets.ts
+var monacoSnippets = {
+  "activeCampaignAddNote": { fields: [["contactId", "string"], ["note", "string"]], outputKeys: [] },
+  "activeCampaignCreateContact": { fields: [["email", "string"], ["firstName", "string"], ["lastName", "string"], ["phone", "string"], ["accountId", "string"], ["customFields", "object"]], outputKeys: ["contactId"] },
+  "addSubtitlesToVideo": { fields: [["videoUrl", "string"], ["language", "string"], ["fontName", "string"], ["fontSize", "number"], ["fontWeight", ["normal", "bold", "black"]], ["fontColor", ["white", "black", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"]], ["highlightColor", ["white", "black", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"]], ["strokeWidth", "number"], ["strokeColor", ["black", "white", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta"]], ["backgroundColor", ["black", "white", "red", "green", "blue", "yellow", "orange", "purple", "pink", "brown", "gray", "cyan", "magenta", "none"]], ["backgroundOpacity", "number"], ["position", ["top", "center", "bottom"]], ["yOffset", "number"], ["wordsPerSubtitle", "number"], ["enableAnimation", "boolean"]], outputKeys: ["videoUrl"] },
+  "airtableCreateUpdateRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["fields", "string"], ["recordData", "object"]], outputKeys: ["recordId"] },
+  "airtableDeleteRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["recordId", "string"]], outputKeys: ["deleted"] },
+  "airtableGetRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["recordId", "string"]], outputKeys: ["record"] },
+  "airtableGetTableRecords": { fields: [["baseId", "string"], ["tableId", "string"]], outputKeys: ["records"] },
+  "analyzeImage": { fields: [["prompt", "string"], ["imageUrl", "string"]], outputKeys: ["analysis"] },
+  "analyzeVideo": { fields: [["prompt", "string"], ["videoUrl", "string"]], outputKeys: ["analysis"] },
+  "captureThumbnail": { fields: [["videoUrl", "string"], ["at", "string"]], outputKeys: ["thumbnailUrl"] },
+  "checkAppRole": { fields: [["roleName", "string"]], outputKeys: ["hasRole", "userRoles"] },
+  "codaCreateUpdatePage": { fields: [["pageData", "object"]], outputKeys: ["pageId"] },
+  "codaCreateUpdateRow": { fields: [["docId", "string"], ["tableId", "string"], ["rowData", "object"]], outputKeys: ["rowId"] },
+  "codaFindRow": { fields: [["docId", "string"], ["tableId", "string"], ["rowData", "object"]], outputKeys: ["row"] },
+  "codaGetPage": { fields: [["docId", "string"], ["pageId", "string"]], outputKeys: ["content"] },
+  "codaGetTableRows": { fields: [["docId", "string"], ["tableId", "string"]], outputKeys: ["rows"] },
+  "convertPdfToImages": { fields: [["pdfUrl", "string"]], outputKeys: ["imageUrls"] },
+  "createDataSource": { fields: [["name", "string"]], outputKeys: [] },
+  "createGmailDraft": { fields: [["to", "string"], ["subject", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["draftId"] },
+  "createGoogleCalendarEvent": { fields: [["summary", "string"], ["startDateTime", "string"], ["endDateTime", "string"]], outputKeys: ["eventId", "htmlLink"] },
+  "createGoogleDoc": { fields: [["title", "string"], ["text", "string"], ["textType", ["plain", "html", "markdown"]]], outputKeys: ["documentUrl"] },
+  "createGoogleSheet": { fields: [["title", "string"], ["text", "string"]], outputKeys: ["spreadsheetUrl"] },
+  "deleteDataSource": { fields: [["dataSourceId", "string"]], outputKeys: [] },
+  "deleteDataSourceDocument": { fields: [["dataSourceId", "string"], ["documentId", "string"]], outputKeys: [] },
+  "deleteGmailEmail": { fields: [["messageId", "string"]], outputKeys: [] },
+  "deleteGoogleCalendarEvent": { fields: [["eventId", "string"]], outputKeys: [] },
+  "deleteGoogleSheetRows": { fields: [["documentId", "string"], ["startRow", "string"], ["endRow", "string"]], outputKeys: [] },
+  "detectChanges": { fields: [["mode", ["ai", "comparison"]], ["input", "string"]], outputKeys: ["hasChanged", "currentValue", "previousValue", "isFirstRun"] },
+  "detectPII": { fields: [["input", "string"], ["language", "string"], ["entities", "array"]], outputKeys: ["detected", "detections"] },
+  "discordEditMessage": { fields: [["botToken", "string"], ["channelId", "string"], ["messageId", "string"], ["text", "string"]], outputKeys: [] },
+  "discordSendFollowUp": { fields: [["applicationId", "string"], ["interactionToken", "string"], ["text", "string"]], outputKeys: ["messageId"] },
+  "discordSendMessage": { fields: [["mode", ["edit", "send"]], ["text", "string"]], outputKeys: [] },
+  "downloadVideo": { fields: [["videoUrl", "string"], ["format", ["mp4", "mp3"]]], outputKeys: ["videoUrl"] },
+  "enhanceImageGenerationPrompt": { fields: [["initialPrompt", "string"], ["includeNegativePrompt", "boolean"], ["systemPrompt", "string"]], outputKeys: ["prompt"] },
+  "enhanceVideoGenerationPrompt": { fields: [["initialPrompt", "string"], ["includeNegativePrompt", "boolean"], ["systemPrompt", "string"]], outputKeys: ["prompt"] },
+  "enrichPerson": { fields: [["params", "object"]], outputKeys: ["data"] },
+  "extractAudioFromVideo": { fields: [["videoUrl", "string"]], outputKeys: ["audioUrl"] },
+  "extractText": { fields: [["url", "string"]], outputKeys: ["text"] },
+  "fetchDataSourceDocument": { fields: [["dataSourceId", "string"], ["documentId", "string"]], outputKeys: [] },
+  "fetchGoogleDoc": { fields: [["documentId", "string"], ["exportType", ["html", "markdown", "json", "plain"]]], outputKeys: ["content"] },
+  "fetchGoogleSheet": { fields: [["spreadsheetId", "string"], ["range", "string"], ["exportType", ["csv", "json"]]], outputKeys: ["content"] },
+  "fetchSlackChannelHistory": { fields: [["channelId", "string"]], outputKeys: ["messages"] },
+  "fetchYoutubeCaptions": { fields: [["videoUrl", "string"], ["exportType", ["text", "json"]], ["language", "string"]], outputKeys: ["transcripts"] },
+  "fetchYoutubeChannel": { fields: [["channelUrl", "string"]], outputKeys: [] },
+  "fetchYoutubeComments": { fields: [["videoUrl", "string"], ["exportType", ["text", "json"]], ["limitPages", "string"]], outputKeys: ["comments"] },
+  "fetchYoutubeVideo": { fields: [["videoUrl", "string"]], outputKeys: [] },
+  "generateAsset": { fields: [["source", "string"], ["sourceType", ["html", "markdown", "spa", "raw", "dynamic", "customInterface"]], ["outputFormat", ["pdf", "png", "html", "mp4", "openGraph"]], ["pageSize", ["full", "letter", "A4", "custom"]], ["testData", "object"]], outputKeys: ["url"] },
+  "generateChart": { fields: [["chart", "object"]], outputKeys: ["chartUrl"] },
+  "generateImage": { fields: [["prompt", "string"]], outputKeys: ["imageUrl"] },
+  "generateLipsync": { fields: [], outputKeys: [] },
+  "generateMusic": { fields: [["text", "string"]], outputKeys: [] },
+  "generatePdf": { fields: [["source", "string"], ["sourceType", ["html", "markdown", "spa", "raw", "dynamic", "customInterface"]], ["outputFormat", ["pdf", "png", "html", "mp4", "openGraph"]], ["pageSize", ["full", "letter", "A4", "custom"]], ["testData", "object"]], outputKeys: ["url"] },
+  "generateStaticVideoFromImage": { fields: [["imageUrl", "string"], ["duration", "string"]], outputKeys: ["videoUrl"] },
+  "generateText": { fields: [["message", "string"]], outputKeys: ["content"] },
+  "generateVideo": { fields: [["prompt", "string"]], outputKeys: ["videoUrl"] },
+  "getGmailAttachments": { fields: [["messageId", "string"]], outputKeys: [] },
+  "getGmailDraft": { fields: [["draftId", "string"]], outputKeys: ["draftId", "messageId", "subject", "to", "from", "body"] },
+  "getGmailEmail": { fields: [["messageId", "string"]], outputKeys: ["messageId", "subject", "from", "to", "date", "body", "labels"] },
+  "getGmailUnreadCount": { fields: [], outputKeys: [] },
+  "getGoogleCalendarEvent": { fields: [["eventId", "string"], ["exportType", ["json", "text"]]], outputKeys: ["event"] },
+  "getGoogleDriveFile": { fields: [["fileId", "string"]], outputKeys: ["url", "name", "mimeType", "size"] },
+  "getGoogleSheetInfo": { fields: [["documentId", "string"]], outputKeys: ["title", "sheets"] },
+  "getMediaMetadata": { fields: [["mediaUrl", "string"]], outputKeys: ["metadata"] },
+  "httpRequest": { fields: [["url", "string"], ["method", "string"], ["headers", "object"], ["queryParams", "object"], ["body", "string"], ["bodyItems", "object"], ["contentType", ["none", "application/json", "application/x-www-form-urlencoded", "multipart/form-data", "custom"]], ["customContentType", "string"]], outputKeys: ["ok", "status", "statusText", "response"] },
+  "hubspotCreateCompany": { fields: [["company", "object"], ["enabledProperties", "array"]], outputKeys: ["companyId"] },
+  "hubspotCreateContact": { fields: [["contact", "object"], ["enabledProperties", "array"], ["companyDomain", "string"]], outputKeys: ["contactId"] },
+  "hubspotGetCompany": { fields: [["searchBy", ["domain", "id"]], ["companyDomain", "string"], ["companyId", "string"], ["additionalProperties", "array"]], outputKeys: ["company"] },
+  "hubspotGetContact": { fields: [["searchBy", ["email", "id"]], ["contactEmail", "string"], ["contactId", "string"], ["additionalProperties", "array"]], outputKeys: ["contact"] },
+  "hunterApiCompanyEnrichment": { fields: [["domain", "string"]], outputKeys: ["data"] },
+  "hunterApiDomainSearch": { fields: [["domain", "string"]], outputKeys: ["data"] },
+  "hunterApiEmailFinder": { fields: [["domain", "string"], ["firstName", "string"], ["lastName", "string"]], outputKeys: ["data"] },
+  "hunterApiEmailVerification": { fields: [["email", "string"]], outputKeys: ["data"] },
+  "hunterApiPersonEnrichment": { fields: [["email", "string"]], outputKeys: ["data"] },
+  "imageFaceSwap": { fields: [["imageUrl", "string"], ["faceImageUrl", "string"], ["engine", "string"]], outputKeys: ["imageUrl"] },
+  "imageRemoveWatermark": { fields: [["imageUrl", "string"], ["engine", "string"]], outputKeys: ["imageUrl"] },
+  "insertVideoClips": { fields: [["baseVideoUrl", "string"], ["overlayVideos", "array"]], outputKeys: ["videoUrl"] },
+  "listDataSources": { fields: [], outputKeys: [] },
+  "listGmailDrafts": { fields: [["exportType", ["json", "text"]]], outputKeys: ["drafts"] },
+  "listGmailLabels": { fields: [], outputKeys: [] },
+  "listGoogleCalendarEvents": { fields: [["limit", "number"], ["exportType", ["json", "text"]]], outputKeys: ["events"] },
+  "listGoogleDriveFiles": { fields: [["exportType", ["json", "text"]]], outputKeys: ["files"] },
+  "listRecentGmailEmails": { fields: [["exportType", ["json", "text"]], ["limit", "string"]], outputKeys: [] },
+  "logic": { fields: [["context", "string"], ["cases", "array"]], outputKeys: ["selectedCase"] },
+  "makeDotComRunScenario": { fields: [["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
+  "mergeAudio": { fields: [["mp3Urls", "array"]], outputKeys: ["audioUrl"] },
+  "mergeVideos": { fields: [["videoUrls", "array"]], outputKeys: ["videoUrl"] },
+  "mixAudioIntoVideo": { fields: [["videoUrl", "string"], ["audioUrl", "string"], ["options", "object"]], outputKeys: ["videoUrl"] },
+  "muteVideo": { fields: [["videoUrl", "string"]], outputKeys: ["videoUrl"] },
+  "n8nRunNode": { fields: [["method", "string"], ["authentication", ["none", "basic", "string"]], ["user", "string"], ["password", "string"], ["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
+  "notionCreatePage": { fields: [["pageId", "string"], ["content", "string"], ["title", "string"]], outputKeys: ["pageId", "pageUrl"] },
+  "notionUpdatePage": { fields: [["pageId", "string"], ["content", "string"], ["mode", ["append", "overwrite"]]], outputKeys: ["pageId", "pageUrl"] },
+  "peopleSearch": { fields: [["smartQuery", "string"], ["enrichPeople", "boolean"], ["enrichOrganizations", "boolean"], ["limit", "string"], ["page", "string"], ["params", "object"]], outputKeys: ["results"] },
+  "postToLinkedIn": { fields: [["message", "string"], ["visibility", ["PUBLIC", "CONNECTIONS"]]], outputKeys: [] },
+  "postToSlackChannel": { fields: [["channelId", "string"], ["messageType", ["string", "blocks"]], ["message", "string"]], outputKeys: [] },
+  "postToX": { fields: [["text", "string"]], outputKeys: [] },
+  "postToZapier": { fields: [["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
+  "queryAppDatabase": { fields: [["databaseId", "string"], ["sql", "string"]], outputKeys: ["rows", "changes"] },
+  "queryDataSource": { fields: [["dataSourceId", "string"], ["query", "string"], ["maxResults", "number"]], outputKeys: ["text", "chunks", "query", "citations", "latencyMs"] },
+  "queryExternalDatabase": { fields: [["query", "string"], ["outputFormat", ["json", "csv"]]], outputKeys: ["data"] },
+  "redactPII": { fields: [["input", "string"], ["language", "string"], ["entities", "array"]], outputKeys: ["text"] },
+  "removeBackgroundFromImage": { fields: [["imageUrl", "string"]], outputKeys: ["imageUrl"] },
+  "replyToGmailEmail": { fields: [["messageId", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["messageId"] },
+  "resizeVideo": { fields: [["videoUrl", "string"], ["mode", ["fit", "exact"]]], outputKeys: ["videoUrl"] },
+  "runFromConnectorRegistry": { fields: [["actionId", "string"], ["displayName", "string"], ["icon", "string"], ["configurationValues", "object"]], outputKeys: ["data"] },
+  "runPackagedWorkflow": { fields: [["appId", "string"], ["workflowId", "string"], ["inputVariables", "object"], ["outputVariables", "object"], ["name", "string"]], outputKeys: ["data"] },
+  "scrapeFacebookPage": { fields: [["pageUrl", "string"]], outputKeys: ["data"] },
+  "scrapeFacebookPosts": { fields: [["pageUrl", "string"]], outputKeys: ["data"] },
+  "scrapeInstagramComments": { fields: [["postUrl", "string"], ["resultsLimit", "string"]], outputKeys: ["data"] },
+  "scrapeInstagramMentions": { fields: [["profileUrl", "string"], ["resultsLimit", "string"]], outputKeys: ["data"] },
+  "scrapeInstagramPosts": { fields: [["profileUrl", "string"], ["resultsLimit", "string"], ["onlyPostsNewerThan", "string"]], outputKeys: ["data"] },
+  "scrapeInstagramProfile": { fields: [["profileUrl", "string"]], outputKeys: ["data"] },
+  "scrapeInstagramReels": { fields: [["profileUrl", "string"], ["resultsLimit", "string"]], outputKeys: ["data"] },
+  "scrapeLinkedInCompany": { fields: [["url", "string"]], outputKeys: ["company"] },
+  "scrapeLinkedInProfile": { fields: [["url", "string"]], outputKeys: ["profile"] },
+  "scrapeMetaThreadsProfile": { fields: [["profileUrl", "string"]], outputKeys: ["data"] },
+  "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"] },
+  "searchGoogleDrive": { fields: [["query", "string"], ["exportType", ["json", "text"]]], outputKeys: ["files"] },
+  "searchGoogleImages": { fields: [["query", "string"], ["exportType", ["text", "json"]]], outputKeys: ["images"] },
+  "searchGoogleNews": { fields: [["text", "string"], ["exportType", ["text", "json"]]], outputKeys: ["articles"] },
+  "searchGoogleTrends": { fields: [["text", "string"], ["hl", "string"], ["geo", "string"], ["data_type", ["TIMESERIES", "GEO_MAP", "GEO_MAP_0", "RELATED_TOPICS", "RELATED_QUERIES"]], ["cat", "string"], ["date", "string"], ["ts", "string"]], outputKeys: ["trends"] },
+  "searchPerplexity": { fields: [["query", "string"], ["exportType", ["text", "json"]]], outputKeys: ["results"] },
+  "searchXPosts": { fields: [["query", "string"], ["scope", ["recent", "all"]], ["options", "object"]], outputKeys: ["posts"] },
+  "searchYoutube": { fields: [["query", "string"], ["limitPages", "string"], ["filter", "string"], ["filterType", "string"]], outputKeys: ["results"] },
+  "searchYoutubeTrends": { fields: [["bp", ["now", "music", "gaming", "films"]], ["hl", "string"], ["gl", "string"]], outputKeys: [] },
+  "sendEmail": { fields: [["subject", "string"], ["body", "string"]], outputKeys: ["recipients"] },
+  "sendGmailDraft": { fields: [["draftId", "string"]], outputKeys: [] },
+  "sendGmailMessage": { fields: [["to", "string"], ["subject", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["messageId"] },
+  "sendSMS": { fields: [["body", "string"]], outputKeys: [] },
+  "setGmailReadStatus": { fields: [["messageIds", "string"], ["markAsRead", "boolean"]], outputKeys: [] },
+  "setRunTitle": { fields: [["title", "string"]], outputKeys: [] },
+  "setVariable": { fields: [["value", "string"]], outputKeys: [] },
+  "telegramEditMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["messageId", "string"], ["text", "string"]], outputKeys: [] },
+  "telegramReplyToMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["replyToMessageId", "string"], ["text", "string"]], outputKeys: ["messageId"] },
+  "telegramSendAudio": { fields: [["botToken", "string"], ["chatId", "string"], ["audioUrl", "string"], ["mode", ["audio", "voice"]]], outputKeys: [] },
+  "telegramSendFile": { fields: [["botToken", "string"], ["chatId", "string"], ["fileUrl", "string"]], outputKeys: [] },
+  "telegramSendImage": { fields: [["botToken", "string"], ["chatId", "string"], ["imageUrl", "string"]], outputKeys: [] },
+  "telegramSendMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["text", "string"]], outputKeys: ["messageId"] },
+  "telegramSendVideo": { fields: [["botToken", "string"], ["chatId", "string"], ["videoUrl", "string"]], outputKeys: [] },
+  "telegramSetTyping": { fields: [["botToken", "string"], ["chatId", "string"]], outputKeys: [] },
+  "textToSpeech": { fields: [["text", "string"]], outputKeys: ["audioUrl"] },
+  "transcribeAudio": { fields: [["audioUrl", "string"], ["prompt", "string"]], outputKeys: ["text"] },
+  "trimMedia": { fields: [["inputUrl", "string"]], outputKeys: ["mediaUrl"] },
+  "updateGmailLabels": { fields: [["query", "string"], ["messageIds", "string"], ["addLabelIds", "string"], ["removeLabelIds", "string"]], outputKeys: ["updatedMessageIds"] },
+  "updateGoogleCalendarEvent": { fields: [["eventId", "string"]], outputKeys: ["eventId", "htmlLink"] },
+  "updateGoogleDoc": { fields: [["documentId", "string"], ["text", "string"], ["textType", ["plain", "html", "markdown"]], ["operationType", ["addToTop", "addToBottom", "overwrite"]]], outputKeys: ["documentUrl"] },
+  "updateGoogleSheet": { fields: [["text", "string"], ["spreadsheetId", "string"], ["range", "string"], ["operationType", ["addToBottom", "overwrite", "range"]]], outputKeys: ["spreadsheetUrl"] },
+  "uploadDataSourceDocument": { fields: [["dataSourceId", "string"], ["file", "string"], ["fileName", "string"]], outputKeys: [] },
+  "upscaleImage": { fields: [["imageUrl", "string"], ["targetResolution", ["2k", "4k", "8k"]], ["engine", ["standard", "pro"]]], outputKeys: ["imageUrl"] },
+  "upscaleVideo": { fields: [["videoUrl", "string"], ["targetResolution", ["720p", "1080p", "2K", "4K"]], ["engine", ["standard", "pro", "ultimate", "flashvsr", "seedance", "seedvr2", "runwayml/upscale-v1"]]], outputKeys: ["videoUrl"] },
+  "userMessage": { fields: [["message", "string"]], outputKeys: ["content"] },
+  "videoFaceSwap": { fields: [["videoUrl", "string"], ["faceImageUrl", "string"], ["targetIndex", "number"], ["engine", "string"]], outputKeys: ["videoUrl"] },
+  "videoRemoveBackground": { fields: [["videoUrl", "string"], ["newBackground", ["transparent", "image"]], ["engine", "string"]], outputKeys: ["videoUrl"] },
+  "videoRemoveWatermark": { fields: [["videoUrl", "string"], ["engine", "string"]], outputKeys: ["videoUrl"] },
+  "watermarkImage": { fields: [["imageUrl", "string"], ["watermarkImageUrl", "string"], ["corner", ["top-left", "top-right", "bottom-left", "bottom-right"]], ["paddingPx", "number"], ["widthPx", "number"]], outputKeys: ["imageUrl"] },
+  "watermarkVideo": { fields: [["videoUrl", "string"], ["imageUrl", "string"], ["corner", ["top-left", "top-right", "bottom-left", "bottom-right"]], ["paddingPx", "number"], ["widthPx", "number"]], outputKeys: ["videoUrl"] }
+};
+var blockTypeAliases = {
+  "userMessage": "generateText",
+  "generatePdf": "generateAsset"
+};
+
 // src/index.ts
 var MindStudioAgent2 = MindStudioAgent;
 var _default;