@mindstudio-ai/agent 0.1.36 → 0.1.38

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). */
@@ -732,6 +732,9 @@ declare class Query<T, TResult = T[]> implements PromiseLike<TResult> {
     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?: {
@@ -741,6 +744,8 @@ declare class Query<T, TResult = T[]> implements PromiseLike<TResult> {
         limit?: number;
         offset?: number;
         postProcess?: (rows: T[]) => TResult;
+        rawWhere?: string;
+        rawWhereParams?: unknown[];
     });
     private _clone;
     filter(predicate: Predicate<T>): Query<T>;
@@ -750,12 +755,12 @@ declare class Query<T, TResult = T[]> implements PromiseLike<TResult> {
     skip(n: number): Query<T>;
     first(): Query<T, T | null>;
     last(): Query<T, T | null>;
-    count(): Promise<number>;
-    some(): Promise<boolean>;
+    count(): Query<T, number>;
+    some(): Query<T, boolean>;
     every(): Promise<boolean>;
     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>): Promise<Map<K, T[]>>;
+    groupBy<K extends string | number>(accessor: Accessor<T, K>): Query<T, Map<K, T[]>>;
     /**
      * @internal Compile this query into a SqlQuery for batch execution.
      *
@@ -890,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
@@ -915,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
@@ -4452,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 */
@@ -7382,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.
@@ -7903,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[];