@mindstudio-ai/agent 0.1.7 → 0.1.10

package/dist/index.d.ts

@@ -1,32 +1,3 @@
-type AuthType = 'internal' | 'apiKey';
-declare class RateLimiter {
-    readonly authType: AuthType;
-    private inflight;
-    private concurrencyLimit;
-    private callCount;
-    private callCap;
-    private queue;
-    constructor(authType: AuthType);
-    /** Acquire a slot. Resolves when a concurrent slot is available. */
-    acquire(): Promise<void>;
-    /** Release a slot and let the next queued request proceed. */
-    release(): void;
-    /** Update limits from response headers. */
-    updateFromHeaders(headers: Headers): void;
-    /** Read current rate limit state from response headers. */
-    static parseHeaders(headers: Headers): {
-        remaining: number | undefined;
-        concurrencyRemaining: number | undefined;
-    };
-}
-
-interface HttpClientConfig {
-    baseUrl: string;
-    token: string;
-    rateLimiter: RateLimiter;
-    maxRetries: number;
-}
-
 /** Configuration options for creating a {@link MindStudioAgent}. */
 interface AgentOptions {
     /**
@@ -53,6 +24,18 @@ interface AgentOptions {
      * @default 3
      */
     maxRetries?: number;
+    /**
+     * App ID for auth and database context. Required when using `auth` or
+     * `db` namespaces outside the MindStudio sandbox.
+     *
+     * If omitted, the SDK checks:
+     * 1. `MINDSTUDIO_APP_ID` environment variable
+     * 2. Sandbox globals (when running inside MindStudio)
+     * 3. Auto-detected from the first `executeStep` response header
+     *
+     * Not needed for plain step execution — only for `db` and `auth`.
+     */
+    appId?: string;
     /**
      * When true, the thread ID from the first API response is automatically
      * reused for all subsequent calls (unless an explicit `threadId` is passed).
@@ -152,6 +135,44 @@ interface UserInfoResult {
         isAgent: boolean;
     }[];
 }
+/**
+ * A reference to a MindStudio platform user. Stored as a UUID string.
+ *
+ * In the database, user values are stored with a `@@user@@` prefix
+ * (e.g. `@@user@@550e8400-...`). The SDK handles this automatically —
+ * values are clean UUIDs in application code, prefixed/stripped
+ * transparently during read/write operations.
+ *
+ * Use `resolveUser(userId)` when you need display info (name, email, etc.).
+ *
+ * @example
+ * ```ts
+ * interface Order {
+ *   id: string;
+ *   createdAt: number;
+ *   updatedAt: number;
+ *   lastUpdatedBy: string;
+ *   requestedBy: User;
+ * }
+ * ```
+ */
+type User = string & {
+    readonly __brand: 'User';
+};
+/**
+ * Resolved display info for a platform user. Returned by `resolveUser()`
+ * and `resolveUsers()`.
+ */
+interface ResolvedUser {
+    /** User ID. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Email address, if available. */
+    email?: string | null;
+    /** Profile picture URL, if set. */
+    profilePictureUrl?: string | null;
+}
 /** An AI model available on MindStudio. */
 interface MindStudioModel {
     id?: string;
@@ -176,6 +197,40 @@ interface MindStudioModelSummary {
 }
 /** Supported model type categories for filtering. */
 type ModelType = 'llm_chat' | 'image_generation' | 'video_generation' | 'video_analysis' | 'text_to_speech' | 'vision' | 'transcription';
+/** Role assignment for a user within an app. */
+interface AppRoleAssignment {
+    userId: string;
+    roleName: string;
+}
+/** Auth context for an app. */
+interface AppAuthContext {
+    /** The authenticated user ID. */
+    userId: string;
+    /** All role assignments for this app (all users, all roles). */
+    roleAssignments: AppRoleAssignment[];
+}
+/** Column schema for a managed database table. */
+interface AppDatabaseColumnSchema {
+    name: string;
+    type: 'text' | 'number' | 'boolean' | 'json' | 'user';
+    required: boolean;
+}
+/** Table schema within a managed database. */
+interface AppDatabaseTable {
+    name: string;
+    schema: AppDatabaseColumnSchema[];
+}
+/** A managed SQLite database for an app. */
+interface AppDatabase {
+    id: string;
+    name: string;
+    tables: AppDatabaseTable[];
+}
+/** Result of {@link MindStudioAgent.getAppContext}. */
+interface AppContextResult {
+    auth: AppAuthContext;
+    databases: AppDatabase[];
+}
 /** An OAuth connector service with its available actions. Third-party integration from the MindStudio Connector Registry. */
 interface ConnectorService {
     id?: string;
@@ -317,6 +372,484 @@ interface RunAgentResult {
     billingCost?: number;
 }
 
+type AuthType = 'internal' | 'apiKey';
+declare class RateLimiter {
+    readonly authType: AuthType;
+    private inflight;
+    private concurrencyLimit;
+    private callCount;
+    private callCap;
+    private queue;
+    constructor(authType: AuthType);
+    /** Acquire a slot. Resolves when a concurrent slot is available. */
+    acquire(): Promise<void>;
+    /** Release a slot and let the next queued request proceed. */
+    release(): void;
+    /** Update limits from response headers. */
+    updateFromHeaders(headers: Headers): void;
+    /** Read current rate limit state from response headers. */
+    static parseHeaders(headers: Headers): {
+        remaining: number | undefined;
+        concurrencyRemaining: number | undefined;
+    };
+}
+
+interface HttpClientConfig {
+    baseUrl: string;
+    token: string;
+    rateLimiter: RateLimiter;
+    maxRetries: number;
+}
+
+/**
+ * Auth namespace — role-based access control for MindStudio apps.
+ *
+ * Provides synchronous access to the current user's identity and roles
+ * within an app. Hydrated once from app context (either sandbox globals
+ * or the `GET /helpers/app-context` endpoint), then all access is sync.
+ *
+ * ## How it works
+ *
+ * 1. The platform stores role assignments per app: `{ userId, roleName }[]`
+ * 2. On context hydration, the full role map is loaded into memory
+ * 3. `auth.hasRole()` / `auth.requireRole()` are simple array lookups
+ * 4. `auth.getUsersByRole()` scans the preloaded assignments
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { auth, Roles } from '@mindstudio-ai/agent';
+ *
+ * // Check permissions
+ * if (auth.hasRole(Roles.admin, Roles.approver)) {
+ *   // user has at least one of these roles
+ * }
+ *
+ * // Gate a route — throws 403 if user lacks the role
+ * auth.requireRole(Roles.admin);
+ *
+ * // Look up who has a role
+ * const admins = auth.getUsersByRole(Roles.admin);
+ * ```
+ *
+ * ## Roles proxy
+ *
+ * `Roles` is a convenience proxy: `Roles.admin` === `"admin"`. It provides
+ * discoverability and typo prevention. In the future, the compilation
+ * pipeline will generate a typed `Roles` object from `app.json`, giving
+ * compile-time safety. For now, any string property access works.
+ */
+
+/**
+ * Auth context for the current execution. Created from the app's role
+ * assignments and the current user's identity.
+ *
+ * All methods are synchronous — the full role map is preloaded at
+ * context hydration time.
+ */
+declare class AuthContext {
+    /** The current user's ID. */
+    readonly userId: string;
+    /** The current user's roles in this app. */
+    readonly roles: readonly string[];
+    /** All role assignments for this app (all users, all roles). */
+    private readonly _roleAssignments;
+    constructor(ctx: AppAuthContext);
+    /**
+     * Check if the current user has **any** of the given roles.
+     * Returns true if at least one matches.
+     *
+     * @example
+     * ```ts
+     * if (auth.hasRole(Roles.admin, Roles.approver)) {
+     *   // user is an admin OR an approver
+     * }
+     * ```
+     */
+    hasRole(...roles: string[]): boolean;
+    /**
+     * Require the current user to have at least one of the given roles.
+     * Throws a `MindStudioError` with code `'forbidden'` and status 403
+     * if the user lacks all of the specified roles.
+     *
+     * Use this at the top of route handlers to gate access.
+     *
+     * @example
+     * ```ts
+     * auth.requireRole(Roles.admin);
+     * // code below only runs if user is an admin
+     * ```
+     */
+    requireRole(...roles: string[]): void;
+    /**
+     * Get all user IDs that have the given role in this app.
+     * Synchronous — scans the preloaded role assignments.
+     *
+     * @example
+     * ```ts
+     * const reviewers = auth.getUsersByRole(Roles.reviewer);
+     * // ['user-id-1', 'user-id-2', ...]
+     * ```
+     */
+    getUsersByRole(role: string): string[];
+}
+/**
+ * Convenience proxy for referencing role names. Any property access
+ * returns the property name as a string: `Roles.admin === "admin"`.
+ *
+ * This provides:
+ * - Discoverability via autocomplete (in typed environments)
+ * - Typo prevention (vs raw string literals)
+ * - Forward compatibility with the future typed Roles generation
+ *
+ * In the future, the compilation pipeline will generate a typed `Roles`
+ * object from `app.json` roles, replacing this proxy with compile-time
+ * checked constants.
+ *
+ * @example
+ * ```ts
+ * Roles.admin      // "admin"
+ * Roles.approver   // "approver"
+ * Roles.anything   // "anything" (no runtime error, any string works)
+ * ```
+ */
+declare const Roles: Record<string, string>;
+
+/**
+ * Internal type definitions for the `db` namespace.
+ *
+ * These types power the chainable collection API over MindStudio's managed
+ * SQLite databases. They're used internally by Table, Query, and the
+ * predicate compiler — most are also re-exported from the package for
+ * consumers who need them in type annotations.
+ *
+ * Key concepts:
+ * - **SystemFields**: columns managed by the platform (id, timestamps, audit).
+ *   Stripped from write inputs automatically.
+ * - **Predicate / Accessor**: callback shapes used in filter(), sortBy(), etc.
+ *   Predicates are compiled to SQL WHERE clauses when possible, with a JS
+ *   fallback for complex expressions.
+ * - **TableConfig**: runtime binding between a Table instance and the
+ *   underlying queryAppDatabase step execution.
+ */
+
+/**
+ * Names of columns that the platform manages automatically.
+ *
+ * - `id`: UUID primary key, generated on INSERT
+ * - `createdAt`: unix timestamp (ms), set on INSERT
+ * - `updatedAt`: unix timestamp (ms), set on INSERT and every UPDATE
+ * - `lastUpdatedBy`: reference to the run ID that last wrote this row
+ */
+type SystemFields = 'id' | 'createdAt' | 'updatedAt' | 'lastUpdatedBy';
+/**
+ * Input type for `Table.push()`. Excludes system-managed fields.
+ * Optional fields in T remain optional.
+ *
+ * @example
+ * ```ts
+ * // If Order has { id, createdAt, updatedAt, lastUpdatedBy, item, amount }
+ * // then PushInput<Order> is { item: string; amount: number }
+ * ```
+ */
+type PushInput<T> = Omit<T, SystemFields>;
+/**
+ * Input type for `Table.update()`. Excludes system-managed fields,
+ * and all remaining fields are optional (partial update).
+ */
+type UpdateInput<T> = Partial<Omit<T, SystemFields>>;
+/**
+ * A predicate function for filtering rows. Receives a typed row and
+ * returns a boolean.
+ *
+ * The SDK attempts to compile the predicate to a SQL WHERE clause for
+ * performance. Simple expressions (field comparisons, &&/||, .includes())
+ * compile to efficient SQL. If the predicate can't be compiled (function
+ * calls, regex, computed expressions), the SDK falls back to fetching all
+ * rows and evaluating in JS. Both paths produce identical results.
+ */
+type Predicate<T> = (row: T) => boolean;
+/**
+ * A field accessor function used by sortBy(), min(), max(), groupBy().
+ * Receives a typed row and returns the value to sort/aggregate by.
+ *
+ * @example
+ * ```ts
+ * .sortBy(o => o.createdAt)      // sort by createdAt
+ * .min(o => o.amount)            // row with smallest amount
+ * .groupBy(o => o.status)        // group rows by status
+ * ```
+ */
+type Accessor<T, R = unknown> = (row: T) => R;
+/**
+ * Runtime configuration for a Table instance. Created by `createDb()` when
+ * `defineTable()` is called. Contains everything the Table needs to execute
+ * queries against the correct database.
+ */
+interface TableConfig {
+    /** The managed database ID (from app context metadata). */
+    databaseId: string;
+    /** The SQL table name (as declared in defineTable). */
+    tableName: string;
+    /**
+     * Column schema from app context. Used to identify user-type columns
+     * (which need @@user@@ prefix handling) and for validation.
+     */
+    columns: AppDatabaseColumnSchema[];
+    /**
+     * Execute one or more SQL queries against the managed database in a
+     * single round trip. All queries run on the same SQLite connection,
+     * enabling RETURNING clauses and multi-statement batches.
+     *
+     * Bound to the `POST /_internal/v2/db/query` endpoint at creation time.
+     *
+     * @param queries - Array of SQL queries with optional bind params
+     * @returns Array of results in the same order as the input queries
+     */
+    executeBatch: (queries: SqlQuery[]) => Promise<SqlResult[]>;
+}
+/** A single SQL query with optional positional bind params. */
+interface SqlQuery {
+    sql: string;
+    params?: unknown[];
+}
+/** Result of a single SQL query execution. */
+interface SqlResult {
+    rows: unknown[];
+    changes: number;
+}
+
+/**
+ * Query chain builder — lazy, immutable query construction for database reads.
+ *
+ * A Query<T> represents a pending database query. It accumulates operations
+ * (filter, sort, limit, skip) without executing anything. Execution happens
+ * only when the query is awaited (via PromiseLike) or a terminal method
+ * is called (first, last, count, some, every, min, max, groupBy).
+ *
+ * ## Immutability
+ *
+ * Every chain method returns a NEW Query instance. This means chains can
+ * safely fork:
+ *
+ * ```ts
+ * const base = Orders.filter(o => o.status === 'active');
+ * const recent = base.sortBy(o => o.createdAt).reverse().take(10);
+ * const count = await base.count();  // doesn't affect `recent`
+ * ```
+ *
+ * ## Execution strategy (SQL fast path vs JS fallback)
+ *
+ * When a Query is executed, it attempts to compile all predicates to SQL:
+ *
+ * - **Fast path**: All predicates compile → single SQL query with WHERE,
+ *   ORDER BY, LIMIT, OFFSET. Efficient, minimal data transfer.
+ *
+ * - **Fallback path**: Any predicate fails to compile → fetch ALL rows
+ *   from the table (SELECT *), then apply the entire chain as native JS
+ *   array operations (Array.filter, Array.sort, Array.slice, etc.).
+ *   A warning is logged so developers can optimize if needed.
+ *
+ * Both paths produce identical results. The SQL path is a transparent
+ * performance optimization.
+ */
+
+declare class Query<T> implements PromiseLike<T[]> {
+    private readonly _predicates;
+    private readonly _sortAccessor;
+    private readonly _reversed;
+    private readonly _limit;
+    private readonly _offset;
+    private readonly _config;
+    constructor(config: TableConfig, options?: {
+        predicates?: Predicate<T>[];
+        sortAccessor?: Accessor<T>;
+        reversed?: boolean;
+        limit?: number;
+        offset?: number;
+    });
+    private _clone;
+    filter(predicate: Predicate<T>): Query<T>;
+    sortBy(accessor: Accessor<T>): Query<T>;
+    reverse(): Query<T>;
+    take(n: number): Query<T>;
+    skip(n: number): Query<T>;
+    first(): Promise<T | null>;
+    last(): Promise<T | null>;
+    count(): Promise<number>;
+    some(): Promise<boolean>;
+    every(): Promise<boolean>;
+    min(accessor: Accessor<T, number>): Promise<T | null>;
+    max(accessor: Accessor<T, number>): Promise<T | null>;
+    groupBy<K extends string | number>(accessor: Accessor<T, K>): Promise<Map<K, T[]>>;
+    then<TResult1 = T[], TResult2 = never>(onfulfilled?: ((value: T[]) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    private _execute;
+    private _compilePredicates;
+    private _fetchAndFilterInJs;
+    private _fetchAllRows;
+}
+
+/**
+ * Table<T> — a typed persistent collection backed by SQLite.
+ *
+ * Created via `db.defineTable<T>(name)`. Every method either returns a
+ * chainable Query<T> (for lazy reads) or a Promise (for terminal reads
+ * and writes).
+ *
+ * ## Write operations use RETURNING
+ *
+ * INSERT and UPDATE use `RETURNING *` to get the created/updated row
+ * back in a single round trip — no separate SELECT needed. This is
+ * executed via the batch endpoint which runs all queries on a single
+ * SQLite connection.
+ */
+
+declare class Table<T> {
+    /** @internal */
+    private readonly _config;
+    constructor(config: TableConfig);
+    get(id: string): Promise<T | null>;
+    findOne(predicate: Predicate<T>): Promise<T | null>;
+    count(predicate?: Predicate<T>): Promise<number>;
+    some(predicate: Predicate<T>): Promise<boolean>;
+    every(predicate: Predicate<T>): Promise<boolean>;
+    isEmpty(): Promise<boolean>;
+    min(accessor: Accessor<T, number>): Promise<T | null>;
+    max(accessor: Accessor<T, number>): Promise<T | null>;
+    groupBy<K extends string | number>(accessor: Accessor<T, K>): Promise<Map<K, T[]>>;
+    filter(predicate: Predicate<T>): Query<T>;
+    sortBy(accessor: Accessor<T>): Query<T>;
+    /**
+     * Insert one or more rows. Returns the created row(s) with system fields
+     * populated (id, createdAt, updatedAt, lastUpdatedBy).
+     *
+     * Uses `INSERT ... RETURNING *` so the created row comes back in a
+     * single round trip — no separate SELECT needed.
+     */
+    push(data: PushInput<T>): Promise<T>;
+    push(data: PushInput<T>[]): Promise<T[]>;
+    /**
+     * Update a row by ID. Only the provided fields are changed.
+     * Returns the updated row via `UPDATE ... RETURNING *`.
+     */
+    update(id: string, data: UpdateInput<T>): Promise<T>;
+    remove(id: string): Promise<void>;
+    /**
+     * Remove all rows matching a predicate. Returns the count removed.
+     */
+    removeAll(predicate: Predicate<T>): Promise<number>;
+    clear(): Promise<void>;
+}
+
+/**
+ * The `db` namespace — factory and time helpers for MindStudio managed databases.
+ *
+ * This module provides `createDb()`, which builds the `Db` object that users
+ * interact with. The Db object has:
+ *
+ * - `defineTable<T>(name)` — creates a typed Table<T> for a given table name
+ * - Time helpers: `now()`, `days()`, `hours()`, `minutes()`, `ago()`, `fromNow()`
+ *
+ * ## How defineTable works
+ *
+ * `defineTable` is a factory that binds a table name to the correct database
+ * and execution context. It:
+ *
+ * 1. Looks up the table name in the app context database metadata
+ * 2. Resolves the databaseId (implicit if only one database exists)
+ * 3. Gets the column schema (for user-type handling and JSON parsing)
+ * 4. Returns a Table<T> instance bound to the executeQuery function
+ *
+ * Tables are typically defined at module scope and imported into route handlers:
+ *
+ * ```ts
+ * // tables/orders.ts
+ * import { db } from '@mindstudio-ai/agent';
+ * export const Orders = db.defineTable<Order>('orders');
+ *
+ * // routes/getOrders.ts
+ * import { Orders } from '../tables/orders';
+ * const active = await Orders.filter(o => o.status === 'active').take(10);
+ * ```
+ *
+ * Since `defineTable()` is lazy (no queries execute until you await something
+ * on the Table), it's safe to call at module scope. The actual database
+ * context resolution happens on first query execution.
+ *
+ * ## Time helpers
+ *
+ * All timestamps in MindStudio databases are unix timestamps (milliseconds
+ * since epoch). The time helpers make it easy to work with relative times
+ * without writing `Date.now() - 48 * 60 * 60 * 1000` everywhere:
+ *
+ * ```ts
+ * const cutoff = db.ago(db.days(2));           // 2 days ago (unix ms)
+ * const deadline = db.fromNow(db.hours(48));   // 48 hours from now
+ * const window = db.days(7) + db.hours(12);    // composable durations
+ * ```
+ */
+
+/**
+ * Options for `db.defineTable()`.
+ */
+interface DefineTableOptions {
+    /**
+     * Database name or ID to target. Required when the app has multiple
+     * databases and the table name alone is ambiguous.
+     *
+     * Accepts either the database's display name or its ID. The SDK
+     * matches against both.
+     *
+     * If omitted, the SDK resolves the database automatically:
+     * - Single database → used implicitly
+     * - Multiple databases → searched by table name
+     */
+    database?: string;
+}
+
+/**
+ * The `db` namespace object. Contains `defineTable()` for creating typed
+ * collections and time helpers for working with unix timestamps.
+ */
+interface Db {
+    /**
+     * Define a typed table. Returns a Table<T> bound to the app's managed
+     * database. The table name must match a table in the app's database schema.
+     *
+     * Tables are lazy — nothing executes until you call a method on the Table
+     * and await the result. This makes it safe to call `defineTable()` at
+     * module scope.
+     *
+     * Database resolution:
+     * - If the app has a single database (common case), it's used automatically.
+     * - If the app has multiple databases, pass `{ database }` with the
+     *   database name or ID to target the right one. If omitted, the SDK
+     *   searches all databases by table name.
+     *
+     * @example
+     * ```ts
+     * // Single database (common) — no need to specify
+     * const Orders = db.defineTable<Order>('orders');
+     *
+     * // Multiple databases — specify which one
+     * const Orders = db.defineTable<Order>('orders', { database: 'main' });
+     * ```
+     */
+    defineTable<T>(name: string, options?: DefineTableOptions): Table<T>;
+    /** Returns the current time as a unix timestamp (ms). Equivalent to `Date.now()`. */
+    now(): number;
+    /** Returns milliseconds for n days. Composable with `+`. */
+    days(n: number): number;
+    /** Returns milliseconds for n hours. Composable with `+`. */
+    hours(n: number): number;
+    /** Returns milliseconds for n minutes. Composable with `+`. */
+    minutes(n: number): number;
+    /** Returns a unix timestamp for (now - duration). Use with days/hours/minutes. */
+    ago(ms: number): number;
+    /** Returns a unix timestamp for (now + duration). Use with days/hours/minutes. */
+    fromNow(ms: number): number;
+}
+
 /**
  * Client for the MindStudio direct step execution API.
  *
@@ -353,6 +886,29 @@ declare class MindStudioAgent$1 {
     private _reuseThreadId;
     /** @internal */
     private _threadId;
+    /**
+     * @internal App ID for context resolution. Resolved from:
+     * constructor appId → MINDSTUDIO_APP_ID env → sandbox globals →
+     * auto-detected from first executeStep response header.
+     */
+    private _appId;
+    /**
+     * @internal Cached app context (auth + databases). Populated by
+     * ensureContext() and cached for the lifetime of the instance.
+     */
+    private _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.
+     */
+    private _contextPromise;
+    /** @internal Cached AuthContext instance, created during context hydration. */
+    private _auth;
+    /** @internal Cached Db namespace instance, created during context hydration. */
+    private _db;
+    /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
+    private _authType;
     constructor(options?: AgentOptions);
     /**
      * Execute any step by its type name. This is the low-level method that all
@@ -462,6 +1018,168 @@ declare class MindStudioAgent$1 {
         costType?: string;
         estimates?: StepCostEstimateEntry[];
     }>;
+    /**
+     * 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(): AuthContext;
+    /**
+     * 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(): Db;
+    /**
+     * 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);
+     * ```
+     */
+    ensureContext(): Promise<void>;
+    /**
+     * @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.
+     */
+    private _hydrateContext;
+    /**
+     * @internal Apply a resolved context object — creates AuthContext and Db.
+     * Used by both the HTTP path and sandbox hydration.
+     */
+    private _applyContext;
+    /**
+     * @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[] }]
+     */
+    private _trySandboxHydration;
+    /**
+     * @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.
+     */
+    private _executeDbBatch;
+    /**
+     * @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.
+     */
+    private _createLazyDb;
+    /**
+     * 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
+     * }
+     * ```
+     */
+    resolveUser(userId: string): Promise<ResolvedUser | 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})`);
+     * }
+     * ```
+     */
+    resolveUsers(userIds: string[]): Promise<{
+        users: ResolvedUser[];
+    }>;
+    /**
+     * 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);
+     * ```
+     */
+    getAppContext(appId?: string): Promise<AppContextResult>;
     /** Update the display name of the authenticated user/agent. */
     changeName(displayName: string): Promise<void>;
     /** Update the profile picture of the authenticated user/agent. */
@@ -538,8 +1256,8 @@ interface AddSubtitlesToVideoStepInput {
     wordsPerSubtitle: number;
     /** When true, enables bounce-style entrance animation for subtitles. Default: true. */
     enableAnimation: boolean;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface AddSubtitlesToVideoStepOutput {
     /** URL of the video with subtitles added */
@@ -723,6 +1441,24 @@ interface CaptureThumbnailStepOutput {
     /** URL of the captured thumbnail image */
     thumbnailUrl: string;
 }
+interface CheckAppRoleStepInput {
+    /** The role name to check (supports {{variables}}) */
+    roleName: string;
+    /** Step to transition to if the user has the role (same workflow) */
+    hasRoleStepId?: string;
+    /** Workflow to jump to if the user has the role (cross workflow) */
+    hasRoleWorkflowId?: string;
+    /** Step to transition to if the user does not have the role (same workflow) */
+    noRoleStepId?: string;
+    /** Workflow to jump to if the user does not have the role (cross workflow) */
+    noRoleWorkflowId?: string;
+}
+interface CheckAppRoleStepOutput {
+    /** Whether the current user has the checked role */
+    hasRole: boolean;
+    /** All roles assigned to the current user for this app */
+    userRoles: string[];
+}
 interface CodaCreateUpdatePageStepInput {
     /** Coda OAuth connection ID */
     connectionId?: string;
@@ -1668,8 +2404,8 @@ interface GenerateChartStepOutput {
 interface GenerateImageStepInput {
     /** Text prompt describing the image to generate */
     prompt: string;
-    /** If true, the image will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
     /** Optional model configuration override. Uses the workflow's default image model if not specified */
     imageModelOverride?: {
         /** Image generation model identifier */
@@ -1689,8 +2425,8 @@ interface GenerateImageStepOutput {
     imageUrl: string | string[];
 }
 interface GenerateLipsyncStepInput {
-    /** If true, the generated video will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
     /** Whether to add a MindStudio watermark to the generated video */
     addWatermark?: boolean;
     /** Optional model configuration override. Uses the workflow's default lipsync model if not specified */
@@ -1703,8 +2439,8 @@ type GenerateLipsyncStepOutput = unknown;
 interface GenerateMusicStepInput {
     /** The instructions (prompt) for the music generation */
     text: string;
-    /** If true, the generated audio will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
     /** Optional model configuration override. Uses the workflow's default music model if not specified */
     musicModelOverride?: {
         model: string;
@@ -1793,8 +2529,8 @@ interface GeneratePdfStepInput {
     shareControl?: "default" | "hidden";
     /** URL of a custom Open Graph share image */
     shareImageUrl?: string;
-    /** If true, the asset will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface GeneratePdfStepOutput {
     /** CDN URL of the generated asset (PDF, PNG, HTML, or MP4 depending on outputFormat) */
@@ -1813,8 +2549,8 @@ interface GenerateStaticVideoFromImageStepOutput {
 interface GenerateVideoStepInput {
     /** Text prompt describing the video to generate */
     prompt: string;
-    /** If true, the video will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
     /** Optional model configuration override. Uses the workflow's default video model if not specified */
     videoModelOverride?: {
         /** Video generation model identifier */
@@ -2307,8 +3043,8 @@ interface ImageRemoveWatermarkStepInput {
     imageUrl: string;
     /** Watermark removal engine to use */
     engine: string;
-    /** When true, the result will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface ImageRemoveWatermarkStepOutput {
     /** CDN URL of the processed image with watermark removed (PNG) */
@@ -2330,8 +3066,8 @@ interface InsertVideoClipsStepInput {
     transitionDuration?: number;
     /** When true, uses audio from the overlay clips instead of the base video audio during inserts */
     useOverlayAudio?: boolean;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface InsertVideoClipsStepOutput {
     /** URL of the video with clips inserted */
@@ -2522,8 +3258,8 @@ interface MergeAudioStepInput {
     fileMetadata?: Record<string, unknown>;
     /** URL of an image to embed as album art in the output file */
     albumArtUrl?: string;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface MergeAudioStepOutput {
     /** URL of the merged audio file */
@@ -2536,8 +3272,8 @@ interface MergeVideosStepInput {
     transition?: string;
     /** Duration of the transition in seconds */
     transitionDuration?: number;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface MergeVideosStepOutput {
     /** URL of the merged video */
@@ -2559,8 +3295,8 @@ interface MixAudioIntoVideoStepInput {
         /** When true, loops the audio track to match the video duration. Defaults to false. */
         loopAudio?: boolean;
     };
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface MixAudioIntoVideoStepOutput {
     /** URL of the video with the mixed audio track */
@@ -2569,8 +3305,8 @@ interface MixAudioIntoVideoStepOutput {
 interface MuteVideoStepInput {
     /** URL of the source video to mute */
     videoUrl: string;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface MuteVideoStepOutput {
     /** URL of the muted video */
@@ -2678,14 +3414,18 @@ interface PostToLinkedInStepInput {
     message: string;
     /** Who can see the post: "PUBLIC" or "CONNECTIONS" */
     visibility: "PUBLIC" | "CONNECTIONS";
+    /** URL of an image to attach to the post */
+    imageUrl?: string;
     /** URL of a video to attach to the post */
     videoUrl?: string;
-    /** Description text for link/media attachments */
-    descriptionText?: string;
-    /** Title text for link/media attachments */
+    /** URL of a document (PDF, PPT, DOC) to attach to the post */
+    documentUrl?: string;
+    /** URL to share as an article link preview */
+    articleUrl?: string;
+    /** Title text for media or article attachments */
     titleText?: string;
-    /** URL of an image to attach to the post */
-    imageUrl?: string;
+    /** Description text for article attachments */
+    descriptionText?: string;
     /** LinkedIn OAuth connection ID */
     connectionId?: string;
 }
@@ -2720,6 +3460,33 @@ interface PostToZapierStepOutput {
     /** Parsed webhook response from Zapier (JSON object, array, or string) */
     data: unknown;
 }
+interface QueryAppDatabaseStepInput {
+    /** Name or ID of the app data database to query */
+    databaseId: string;
+    /**
+   * SQL query to execute. Use {{variables}} directly in the SQL — they are handled according to the `parameterize` setting.
+   *
+   * When parameterize is true (default):   {{variables}} are extracted from the SQL, replaced with ? placeholders,   resolved via the full MindStudio handlebars pipeline, and passed as safe   parameterized values to SQLite. This prevents SQL injection.   Example: INSERT INTO contacts (name, email) VALUES ({{name}}, {{email}})
+   *
+   * When parameterize is false:   The entire SQL string is resolved via compileString (standard handlebars   interpolation) and executed as-is. Use this for dynamic/generated SQL   where another step builds the query. The user is responsible for safety.   Example: {{generatedInsertQuery}}
+   *
+   * Ask the user for the database schema if they have not already provided it.
+   */
+    sql: string;
+    /**
+   * Whether to treat {{variables}} as parameterized query values (default: true).
+   *
+   * - true:  {{vars}} are extracted, replaced with ?, and passed as bind params.          Safe from SQL injection. Use for standard CRUD operations.
+   * - false: {{vars}} are interpolated directly into the SQL string via handlebars.          Use when another step generates full or partial SQL (e.g. bulk inserts          with precomputed VALUES). The user is responsible for sanitization.
+   */
+    parameterize?: boolean;
+}
+interface QueryAppDatabaseStepOutput {
+    /** Result rows for SELECT queries (empty array for write queries) */
+    rows: unknown[];
+    /** Number of rows affected by INSERT, UPDATE, or DELETE queries (0 for SELECT) */
+    changes: number;
+}
 interface QueryDataSourceStepInput {
     /** ID of the vector data source to query */
     dataSourceId: string;
@@ -2801,8 +3568,8 @@ interface ResizeVideoStepInput {
     height?: number;
     /** Strategy for handling aspect ratio mismatch in 'exact' mode */
     strategy?: "pad" | "crop";
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface ResizeVideoStepOutput {
     /** URL of the resized video */
@@ -3564,7 +4331,7 @@ type TelegramSetTypingStepOutput = unknown;
 interface TextToSpeechStepInput {
     /** The text to convert to speech */
     text: string;
-    skipAssetCreation?: boolean;
+    intermediateAsset?: boolean;
     /** Optional model configuration override. Uses the workflow's default speech model if not specified */
     speechModelOverride?: {
         /** Speech synthesis model identifier */
@@ -3601,8 +4368,8 @@ interface TrimMediaStepInput {
     start?: number | string;
     /** Duration of the trimmed segment in seconds. Omit to trim to the end of the clip. */
     duration?: string | number;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface TrimMediaStepOutput {
     /** URL of the trimmed media file */
@@ -3710,8 +4477,8 @@ interface UpscaleVideoStepInput {
     targetResolution: "720p" | "1080p" | "2K" | "4K";
     /** Upscaling engine to use. Higher tiers produce better quality at higher cost. */
     engine: "standard" | "pro" | "ultimate" | "flashvsr" | "seedance" | "seedvr2" | "runwayml/upscale-v1";
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface UpscaleVideoStepOutput {
     /** URL of the upscaled video */
@@ -3774,8 +4541,8 @@ interface VideoFaceSwapStepInput {
     targetIndex: number;
     /** Face swap engine to use */
     engine: string;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface VideoFaceSwapStepOutput {
     /** URL of the face-swapped video */
@@ -3790,8 +4557,8 @@ interface VideoRemoveBackgroundStepInput {
     newBackgroundImageUrl?: string;
     /** Background removal engine to use */
     engine: string;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface VideoRemoveBackgroundStepOutput {
     /** URL of the video with background removed or replaced */
@@ -3802,8 +4569,8 @@ interface VideoRemoveWatermarkStepInput {
     videoUrl: string;
     /** Watermark removal engine to use */
     engine: string;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface VideoRemoveWatermarkStepOutput {
     /** URL of the video with watermark removed */
@@ -3820,8 +4587,8 @@ interface WatermarkImageStepInput {
     paddingPx: number;
     /** Width of the watermark overlay in pixels */
     widthPx: number;
-    /** When true, the result will not appear in the user's asset history */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface WatermarkImageStepOutput {
     /** CDN URL of the watermarked image */
@@ -3838,8 +4605,8 @@ interface WatermarkVideoStepInput {
     paddingPx: number;
     /** Width of the watermark overlay in pixels */
     widthPx: number;
-    /** When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps. */
-    skipAssetCreation?: boolean;
+    /** When true, the asset is created but hidden from the user's gallery (tagged as intermediate) */
+    intermediateAsset?: boolean;
 }
 interface WatermarkVideoStepOutput {
     /** URL of the watermarked video */
@@ -3850,7 +4617,7 @@ type GenerateAssetStepOutput = GeneratePdfStepOutput;
 type GenerateTextStepInput = UserMessageStepInput;
 type GenerateTextStepOutput = UserMessageStepOutput;
 /** Union of all available step type names. */
-type StepName = "activeCampaignAddNote" | "activeCampaignCreateContact" | "addSubtitlesToVideo" | "airtableCreateUpdateRecord" | "airtableDeleteRecord" | "airtableGetRecord" | "airtableGetTableRecords" | "analyzeImage" | "analyzeVideo" | "captureThumbnail" | "codaCreateUpdatePage" | "codaCreateUpdateRow" | "codaFindRow" | "codaGetPage" | "codaGetTableRows" | "convertPdfToImages" | "createDataSource" | "createGmailDraft" | "createGoogleCalendarEvent" | "createGoogleDoc" | "createGoogleSheet" | "deleteDataSource" | "deleteDataSourceDocument" | "deleteGmailEmail" | "deleteGoogleCalendarEvent" | "deleteGoogleSheetRows" | "detectChanges" | "detectPII" | "discordEditMessage" | "discordSendFollowUp" | "discordSendMessage" | "downloadVideo" | "enhanceImageGenerationPrompt" | "enhanceVideoGenerationPrompt" | "enrichPerson" | "extractAudioFromVideo" | "extractText" | "fetchDataSourceDocument" | "fetchGoogleDoc" | "fetchGoogleSheet" | "fetchSlackChannelHistory" | "fetchYoutubeCaptions" | "fetchYoutubeChannel" | "fetchYoutubeComments" | "fetchYoutubeVideo" | "generateChart" | "generateImage" | "generateLipsync" | "generateMusic" | "generatePdf" | "generateStaticVideoFromImage" | "generateVideo" | "getGmailAttachments" | "getGmailDraft" | "getGmailEmail" | "getGmailUnreadCount" | "getGoogleCalendarEvent" | "getGoogleDriveFile" | "getGoogleSheetInfo" | "getMediaMetadata" | "httpRequest" | "hubspotCreateCompany" | "hubspotCreateContact" | "hubspotGetCompany" | "hubspotGetContact" | "hunterApiCompanyEnrichment" | "hunterApiDomainSearch" | "hunterApiEmailFinder" | "hunterApiEmailVerification" | "hunterApiPersonEnrichment" | "imageFaceSwap" | "imageRemoveWatermark" | "insertVideoClips" | "listDataSources" | "listGmailDrafts" | "listGmailLabels" | "listGoogleCalendarEvents" | "listGoogleDriveFiles" | "listRecentGmailEmails" | "logic" | "makeDotComRunScenario" | "mergeAudio" | "mergeVideos" | "mixAudioIntoVideo" | "muteVideo" | "n8nRunNode" | "notionCreatePage" | "notionUpdatePage" | "peopleSearch" | "postToLinkedIn" | "postToSlackChannel" | "postToX" | "postToZapier" | "queryDataSource" | "queryExternalDatabase" | "redactPII" | "removeBackgroundFromImage" | "replyToGmailEmail" | "resizeVideo" | "runFromConnectorRegistry" | "runPackagedWorkflow" | "scrapeFacebookPage" | "scrapeFacebookPosts" | "scrapeInstagramComments" | "scrapeInstagramMentions" | "scrapeInstagramPosts" | "scrapeInstagramProfile" | "scrapeInstagramReels" | "scrapeLinkedInCompany" | "scrapeLinkedInProfile" | "scrapeMetaThreadsProfile" | "scrapeUrl" | "scrapeXPost" | "scrapeXProfile" | "searchGmailEmails" | "searchGoogle" | "searchGoogleCalendarEvents" | "searchGoogleDrive" | "searchGoogleImages" | "searchGoogleNews" | "searchGoogleTrends" | "searchPerplexity" | "searchXPosts" | "searchYoutube" | "searchYoutubeTrends" | "sendEmail" | "sendGmailDraft" | "sendGmailMessage" | "sendSMS" | "setGmailReadStatus" | "setRunTitle" | "setVariable" | "telegramEditMessage" | "telegramReplyToMessage" | "telegramSendAudio" | "telegramSendFile" | "telegramSendImage" | "telegramSendMessage" | "telegramSendVideo" | "telegramSetTyping" | "textToSpeech" | "transcribeAudio" | "trimMedia" | "updateGmailLabels" | "updateGoogleCalendarEvent" | "updateGoogleDoc" | "updateGoogleSheet" | "uploadDataSourceDocument" | "upscaleImage" | "upscaleVideo" | "userMessage" | "videoFaceSwap" | "videoRemoveBackground" | "videoRemoveWatermark" | "watermarkImage" | "watermarkVideo";
+type StepName = "activeCampaignAddNote" | "activeCampaignCreateContact" | "addSubtitlesToVideo" | "airtableCreateUpdateRecord" | "airtableDeleteRecord" | "airtableGetRecord" | "airtableGetTableRecords" | "analyzeImage" | "analyzeVideo" | "captureThumbnail" | "checkAppRole" | "codaCreateUpdatePage" | "codaCreateUpdateRow" | "codaFindRow" | "codaGetPage" | "codaGetTableRows" | "convertPdfToImages" | "createDataSource" | "createGmailDraft" | "createGoogleCalendarEvent" | "createGoogleDoc" | "createGoogleSheet" | "deleteDataSource" | "deleteDataSourceDocument" | "deleteGmailEmail" | "deleteGoogleCalendarEvent" | "deleteGoogleSheetRows" | "detectChanges" | "detectPII" | "discordEditMessage" | "discordSendFollowUp" | "discordSendMessage" | "downloadVideo" | "enhanceImageGenerationPrompt" | "enhanceVideoGenerationPrompt" | "enrichPerson" | "extractAudioFromVideo" | "extractText" | "fetchDataSourceDocument" | "fetchGoogleDoc" | "fetchGoogleSheet" | "fetchSlackChannelHistory" | "fetchYoutubeCaptions" | "fetchYoutubeChannel" | "fetchYoutubeComments" | "fetchYoutubeVideo" | "generateChart" | "generateImage" | "generateLipsync" | "generateMusic" | "generatePdf" | "generateStaticVideoFromImage" | "generateVideo" | "getGmailAttachments" | "getGmailDraft" | "getGmailEmail" | "getGmailUnreadCount" | "getGoogleCalendarEvent" | "getGoogleDriveFile" | "getGoogleSheetInfo" | "getMediaMetadata" | "httpRequest" | "hubspotCreateCompany" | "hubspotCreateContact" | "hubspotGetCompany" | "hubspotGetContact" | "hunterApiCompanyEnrichment" | "hunterApiDomainSearch" | "hunterApiEmailFinder" | "hunterApiEmailVerification" | "hunterApiPersonEnrichment" | "imageFaceSwap" | "imageRemoveWatermark" | "insertVideoClips" | "listDataSources" | "listGmailDrafts" | "listGmailLabels" | "listGoogleCalendarEvents" | "listGoogleDriveFiles" | "listRecentGmailEmails" | "logic" | "makeDotComRunScenario" | "mergeAudio" | "mergeVideos" | "mixAudioIntoVideo" | "muteVideo" | "n8nRunNode" | "notionCreatePage" | "notionUpdatePage" | "peopleSearch" | "postToLinkedIn" | "postToSlackChannel" | "postToX" | "postToZapier" | "queryAppDatabase" | "queryDataSource" | "queryExternalDatabase" | "redactPII" | "removeBackgroundFromImage" | "replyToGmailEmail" | "resizeVideo" | "runFromConnectorRegistry" | "runPackagedWorkflow" | "scrapeFacebookPage" | "scrapeFacebookPosts" | "scrapeInstagramComments" | "scrapeInstagramMentions" | "scrapeInstagramPosts" | "scrapeInstagramProfile" | "scrapeInstagramReels" | "scrapeLinkedInCompany" | "scrapeLinkedInProfile" | "scrapeMetaThreadsProfile" | "scrapeUrl" | "scrapeXPost" | "scrapeXProfile" | "searchGmailEmails" | "searchGoogle" | "searchGoogleCalendarEvents" | "searchGoogleDrive" | "searchGoogleImages" | "searchGoogleNews" | "searchGoogleTrends" | "searchPerplexity" | "searchXPosts" | "searchYoutube" | "searchYoutubeTrends" | "sendEmail" | "sendGmailDraft" | "sendGmailMessage" | "sendSMS" | "setGmailReadStatus" | "setRunTitle" | "setVariable" | "telegramEditMessage" | "telegramReplyToMessage" | "telegramSendAudio" | "telegramSendFile" | "telegramSendImage" | "telegramSendMessage" | "telegramSendVideo" | "telegramSetTyping" | "textToSpeech" | "transcribeAudio" | "trimMedia" | "updateGmailLabels" | "updateGoogleCalendarEvent" | "updateGoogleDoc" | "updateGoogleSheet" | "uploadDataSourceDocument" | "upscaleImage" | "upscaleVideo" | "userMessage" | "videoFaceSwap" | "videoRemoveBackground" | "videoRemoveWatermark" | "watermarkImage" | "watermarkVideo";
 /** Maps step names to their input types. */
 interface StepInputMap {
     activeCampaignAddNote: ActiveCampaignAddNoteStepInput;
@@ -3863,6 +4630,7 @@ interface StepInputMap {
     analyzeImage: AnalyzeImageStepInput;
     analyzeVideo: AnalyzeVideoStepInput;
     captureThumbnail: CaptureThumbnailStepInput;
+    checkAppRole: CheckAppRoleStepInput;
     codaCreateUpdatePage: CodaCreateUpdatePageStepInput;
     codaCreateUpdateRow: CodaCreateUpdateRowStepInput;
     codaFindRow: CodaFindRowStepInput;
@@ -3946,6 +4714,7 @@ interface StepInputMap {
     postToSlackChannel: PostToSlackChannelStepInput;
     postToX: PostToXStepInput;
     postToZapier: PostToZapierStepInput;
+    queryAppDatabase: QueryAppDatabaseStepInput;
     queryDataSource: QueryDataSourceStepInput;
     queryExternalDatabase: QueryExternalDatabaseStepInput;
     redactPII: RedactPIIStepInput;
@@ -4022,6 +4791,7 @@ interface StepOutputMap {
     analyzeImage: AnalyzeImageStepOutput;
     analyzeVideo: AnalyzeVideoStepOutput;
     captureThumbnail: CaptureThumbnailStepOutput;
+    checkAppRole: CheckAppRoleStepOutput;
     codaCreateUpdatePage: CodaCreateUpdatePageStepOutput;
     codaCreateUpdateRow: CodaCreateUpdateRowStepOutput;
     codaFindRow: CodaFindRowStepOutput;
@@ -4105,6 +4875,7 @@ interface StepOutputMap {
     postToSlackChannel: PostToSlackChannelStepOutput;
     postToX: PostToXStepOutput;
     postToZapier: PostToZapierStepOutput;
+    queryAppDatabase: QueryAppDatabaseStepOutput;
     queryDataSource: QueryDataSourceStepOutput;
     queryExternalDatabase: QueryExternalDatabaseStepOutput;
     redactPII: RedactPIIStepOutput;
@@ -4350,6 +5121,24 @@ interface StepMethods {
      * ```
      */
     captureThumbnail(step: CaptureThumbnailStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CaptureThumbnailStepOutput>>;
+    /**
+     * Check whether the current user has a specific app role and branch accordingly.
+     *
+     * @remarks
+     * - Checks if the current user has been assigned a specific role in this app.
+     * - If the user has the role, transitions to the "has role" path.
+     * - If the user does not have the role, transitions to the "no role" path, or errors if no path is configured.
+     * - Role names are defined by the app creator and assigned to users via the app roles system.
+     * - The roleName field supports {{variables}} for dynamic role checks.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.checkAppRole({
+     *   roleName: ``,
+     * });
+     * ```
+     */
+    checkAppRole(step: CheckAppRoleStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<CheckAppRoleStepOutput>>;
     /**
      * Create a new page or update an existing page in a Coda document.
      *
@@ -5649,7 +6438,10 @@ interface StepMethods {
      *
      * @remarks
      * - Requires a LinkedIn OAuth connection (connectionId).
-     * - Supports text posts, image posts, and video posts.
+     * - Supports text posts, image posts, video posts, document posts, and article posts.
+     * - Attach one media type per post: image, video, document, or article.
+     * - Documents support PDF, PPT, PPTX, DOC, DOCX (max 100MB, 300 pages). Displays as a slideshow carousel.
+     * - Articles create a link preview with optional custom title, description, and thumbnail.
      * - Visibility controls who can see the post.
      *
      * @example
@@ -5714,6 +6506,32 @@ interface StepMethods {
      * ```
      */
     postToZapier(step: PostToZapierStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<PostToZapierStepOutput>>;
+    /**
+     * Execute a SQL query against the app managed database.
+     *
+     * @remarks
+     * - Executes raw SQL against a SQLite database managed by the app.
+     * - For SELECT queries, returns rows as JSON.
+     * - For INSERT/UPDATE/DELETE, returns the number of affected rows.
+     * - Use {{variables}} directly in your SQL. By default they are automatically extracted
+     * and passed as safe parameterized values (preventing SQL injection).
+     * Example: INSERT INTO contacts (name, comment) VALUES ({{name}}, {{comment}})
+     * - Full MindStudio handlebars syntax is supported, including helpers like {{json myVar}},
+     * {{get myVar "$.path"}}, {{global.orgName}}, etc.
+     * - Set parameterize to false for raw/dynamic SQL where variables are interpolated directly
+     * into the query string. Use this when another step generates full or partial SQL, e.g.
+     * a bulk INSERT with a precomputed VALUES list. The user is responsible for sanitization
+     * when parameterize is false.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.queryAppDatabase({
+     *   databaseId: ``,
+     *   sql: ``,
+     * });
+     * ```
+     */
+    queryAppDatabase(step: QueryAppDatabaseStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<QueryAppDatabaseStepOutput>>;
     /**
      * Search a vector data source (RAG) and return relevant document chunks.
      *
@@ -6775,4 +7593,52 @@ declare const MindStudioAgent: {
     new (options?: AgentOptions): MindStudioAgent;
 };
 
-export { type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type BatchStepInput, type BatchStepResult, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HttpRequestStepInput, type HttpRequestStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ResizeVideoStepInput, type ResizeVideoStepOutput, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type ScrapeFacebookPageStepInput, type ScrapeFacebookPageStepOutput, type ScrapeFacebookPostsStepInput, type ScrapeFacebookPostsStepOutput, type ScrapeInstagramCommentsStepInput, type ScrapeInstagramCommentsStepOutput, type ScrapeInstagramMentionsStepInput, type ScrapeInstagramMentionsStepOutput, type ScrapeInstagramPostsStepInput, type ScrapeInstagramPostsStepOutput, type ScrapeInstagramProfileStepInput, type ScrapeInstagramProfileStepOutput, type ScrapeInstagramReelsStepInput, type ScrapeInstagramReelsStepOutput, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeMetaThreadsProfileStepInput, type ScrapeMetaThreadsProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, type TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, blockTypeAliases, monacoSnippets, stepMetadata };
+declare const mindstudio: MindStudioAgent;
+
+/**
+ * Top-level `auth` namespace bound to the default singleton.
+ *
+ * Provides the current user's identity and roles. Requires context
+ * hydration before use — call `await mindstudio.ensureContext()` or
+ * perform any `db` operation first.
+ *
+ * @example
+ * ```ts
+ * import { auth, Roles } from '@mindstudio-ai/agent';
+ *
+ * auth.requireRole(Roles.admin);
+ * const admins = auth.getUsersByRole(Roles.admin);
+ * ```
+ */
+declare const auth: AuthContext;
+/**
+ * Top-level `db` namespace bound to the default singleton.
+ *
+ * Use `db.defineTable<T>(name)` to create typed collections. Table
+ * definitions are lazy — no HTTP until you await a query. Context is
+ * auto-hydrated on first query execution.
+ *
+ * @example
+ * ```ts
+ * import { db } from '@mindstudio-ai/agent';
+ *
+ * const Orders = db.defineTable<Order>('orders');
+ * const active = await Orders.filter(o => o.status === 'active').take(10);
+ * ```
+ */
+declare const db: Db;
+/**
+ * Resolve a user ID to display info (name, email, profile picture).
+ * Bound to the default singleton.
+ *
+ * @example
+ * ```ts
+ * import { resolveUser } from '@mindstudio-ai/agent';
+ *
+ * const user = await resolveUser(order.requestedBy);
+ * if (user) console.log(user.name, user.email);
+ * ```
+ */
+declare const resolveUser: (userId: string) => Promise<ResolvedUser | null>;
+
+export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type BatchStepInput, type BatchStepResult, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HttpRequestStepInput, type HttpRequestStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, Query, type QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type ScrapeFacebookPageStepInput, type ScrapeFacebookPageStepOutput, type ScrapeFacebookPostsStepInput, type ScrapeFacebookPostsStepOutput, type ScrapeInstagramCommentsStepInput, type ScrapeInstagramCommentsStepOutput, type ScrapeInstagramMentionsStepInput, type ScrapeInstagramMentionsStepOutput, type ScrapeInstagramPostsStepInput, type ScrapeInstagramPostsStepOutput, type ScrapeInstagramProfileStepInput, type ScrapeInstagramProfileStepOutput, type ScrapeInstagramReelsStepInput, type ScrapeInstagramReelsStepOutput, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeMetaThreadsProfileStepInput, type ScrapeMetaThreadsProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, type SystemFields, Table, type TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, auth, blockTypeAliases, db, mindstudio as default, mindstudio, monacoSnippets, resolveUser, stepMetadata };