@mindstudio-ai/agent 0.1.35 → 0.1.37

package/dist/index.d.ts

@@ -223,8 +223,8 @@ interface AppRoleAssignment {
 }
 /** Auth context for an app. */
 interface AppAuthContext {
-    /** The authenticated user ID. */
-    userId: string;
+    /** The authenticated user ID, or null for unauthenticated users. */
+    userId: string | null;
     /** All role assignments for this app (all users, all roles). */
     roleAssignments: AppRoleAssignment[];
 }
@@ -477,8 +477,8 @@ interface HttpClientConfig {
  * context hydration time.
  */
 declare class AuthContext {
-    /** The current user's ID. */
-    readonly userId: string;
+    /** The current user's ID, or null for unauthenticated users. */
+    readonly userId: string | null;
     /** The current user's roles in this app. */
     readonly roles: readonly string[];
     /** All role assignments for this app (all users, all roles). */
@@ -725,19 +725,27 @@ interface SqlResult {
  * performance optimization.
  */
 
-declare class Query<T> implements PromiseLike<T[]> {
+declare class Query<T, TResult = T[]> implements PromiseLike<TResult> {
     private readonly _predicates;
     private readonly _sortAccessor;
     private readonly _reversed;
     private readonly _limit;
     private readonly _offset;
     private readonly _config;
+    /** @internal Pre-compiled WHERE clause (bypasses predicate compiler). Used by Table.get(). */
+    private readonly _rawWhere;
+    private readonly _rawWhereParams;
+    /** @internal Post-process transform applied after row deserialization. */
+    readonly _postProcess: ((rows: T[]) => TResult) | undefined;
     constructor(config: TableConfig, options?: {
         predicates?: Predicate<T>[];
         sortAccessor?: Accessor<T>;
         reversed?: boolean;
         limit?: number;
         offset?: number;
+        postProcess?: (rows: T[]) => TResult;
+        rawWhere?: string;
+        rawWhereParams?: unknown[];
     });
     private _clone;
     filter(predicate: Predicate<T>): Query<T>;
@@ -745,14 +753,14 @@ declare class Query<T> implements PromiseLike<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>;
+    first(): Query<T, T | null>;
+    last(): Query<T, T | null>;
+    count(): Query<T, number>;
+    some(): Query<T, 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[]>>;
+    min(accessor: Accessor<T, number>): Query<T, T | null>;
+    max(accessor: Accessor<T, number>): Query<T, T | null>;
+    groupBy<K extends string | number>(accessor: Accessor<T, K>): Query<T, Map<K, T[]>>;
     /**
      * @internal Compile this query into a SqlQuery for batch execution.
      *
@@ -761,7 +769,7 @@ declare class Query<T> implements PromiseLike<T[]> {
      * `SELECT *` is returned as `fallbackQuery` so the batch can fetch
      * all rows and this query can filter them in JS post-fetch.
      */
-    _compile(): CompiledQuery<T>;
+    _compile(): CompiledQuery<T, TResult>;
     /**
      * @internal Process raw SQL results into typed rows. Used by db.batch()
      * after executing the compiled query.
@@ -769,9 +777,9 @@ declare class Query<T> implements PromiseLike<T[]> {
      * For SQL-compiled queries: just deserialize the rows.
      * For JS-fallback queries: filter, sort, and slice in JS.
      */
-    static _processResults<T>(result: SqlResult, compiled: CompiledQuery<T>): T[];
-    then<TResult1 = T[], TResult2 = never>(onfulfilled?: ((value: T[]) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
-    catch<TResult2 = never>(onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<T[] | TResult2>;
+    static _processResults<T, R = T[]>(result: SqlResult, compiled: CompiledQuery<T, R>): R;
+    then<TResult1 = TResult, TResult2 = never>(onfulfilled?: ((value: TResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult2 = never>(onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult | TResult2>;
     private _execute;
     private _compilePredicates;
     private _fetchAndFilterInJs;
@@ -781,7 +789,7 @@ declare class Query<T> implements PromiseLike<T[]> {
  * Result of Query._compile(). Contains either a compiled SQL query
  * (fast path) or a fallback SELECT * with JS processing metadata.
  */
-interface CompiledQuery<T> {
+interface CompiledQuery<T, TResult = T[]> {
     type: 'query';
     /** Compiled SQL query, or null if JS fallback needed. */
     query: SqlQuery | null;
@@ -799,6 +807,8 @@ interface CompiledQuery<T> {
     limit?: number;
     /** Offset (only for fallback). */
     offset?: number;
+    /** Post-process transform (e.g. first() extracts [0] ?? null). */
+    postProcess?: (rows: T[]) => TResult;
 }
 
 /**
@@ -885,16 +895,30 @@ 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>;
+    /** Get a single row by ID. Returns null if not found. */
+    get(id: string): Query<T, T | null>;
+    /** Find the first row matching a predicate. Returns null if none match. */
+    findOne(predicate: Predicate<T>): Query<T, T | null>;
+    /** Count all rows, or rows matching a predicate. */
+    count(): Query<T, number>;
+    count(predicate: Predicate<T>): Query<T, number>;
+    /** True if any row matches the predicate. */
+    some(predicate: Predicate<T>): Query<T, boolean>;
+    /** True if all rows match the predicate. */
     every(predicate: Predicate<T>): Promise<boolean>;
+    /** True if the table has zero rows. */
     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[]>>;
+    /** Row with the minimum value for a field, or null if table is empty. */
+    min(accessor: Accessor<T, number>): Query<T, T | null>;
+    /** Row with the maximum value for a field, or null if table is empty. */
+    max(accessor: Accessor<T, number>): Query<T, T | null>;
+    /** Group rows by a field. Returns a Map. */
+    groupBy<K extends string | number>(accessor: Accessor<T, K>): Query<T, Map<K, T[]>>;
+    /** Get all rows as an array. */
+    toArray(): Query<T>;
+    /** Filter rows by a predicate. Returns a chainable Query. */
     filter(predicate: Predicate<T>): Query<T>;
+    /** Sort rows by a field. Returns a chainable Query. */
     sortBy(accessor: Accessor<T>): Query<T>;
     /**
      * Insert one or more rows. Returns the created row(s) with system fields
@@ -910,12 +934,14 @@ declare class Table<T> {
      * Returns the updated row via `UPDATE ... RETURNING *`.
      */
     update(id: string, data: UpdateInput<T>): Mutation<T>;
-    remove(id: string): Mutation<void>;
+    remove(id: string): Mutation<{
+        deleted: boolean;
+    }>;
     /**
      * Remove all rows matching a predicate. Returns the count removed.
      */
     removeAll(predicate: Predicate<T>): Mutation<number>;
-    clear(): Mutation<void>;
+    clear(): Mutation<number>;
     /**
      * Insert a row, or update it if a row with the same unique key already
      * exists. The conflict key must match a `unique` constraint declared in
@@ -4447,6 +4473,8 @@ interface SendEmailStepInput {
     subject: string;
     /** Email body content (plain text, markdown, HTML, or a CDN URL to an HTML file) */
     body: string;
+    /** Direct recipient email address(es). For v2 apps, must be verified app users. */
+    to?: string | string[];
     /** OAuth connection ID(s) for the recipient(s), comma-separated for multiple */
     connectionId?: string;
     /** When true, auto-convert the body text into a styled HTML email using AI */
@@ -7377,10 +7405,11 @@ interface StepMethods {
      */
     searchYoutubeTrends(step: SearchYoutubeTrendsStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<SearchYoutubeTrendsStepOutput>>;
     /**
-     * Send an email to one or more configured recipient addresses.
+     * Send an email to one or more recipient addresses.
      *
      * @remarks
-     * - Recipient email addresses are resolved from OAuth connections configured by the app creator. The user running the workflow does not specify the recipient directly.
+     * - Use the "to" field to send to specific email addresses directly. For v2 apps, recipients must be verified users in the app's user table.
+     * - Alternatively, recipient email addresses can be resolved from OAuth connections configured by the app creator via connectionId. The user running the workflow does not specify the recipient directly.
      * - If the body is a URL to a hosted HTML file on the CDN, the HTML is fetched and used as the email body.
      * - When generateHtml is enabled, the body text is converted to a styled HTML email using an AI model.
      * - connectionId can be a comma-separated list to send to multiple recipients.
@@ -7898,6 +7927,8 @@ declare class MindStudioError extends Error {
     status: number, 
     /** Raw error body from the API, if available. */
     details?: unknown | undefined);
+    toString(): string;
+    toJSON(): Record<string, unknown>;
 }
 
 type MonacoSnippetFieldType = 'string' | 'number' | 'boolean' | 'array' | 'object' | string[];