@magemetrics/core 0.13.0 → 0.14.0

package/dist/index.d.ts

@@ -9,8 +9,17 @@ import type { NodeBase } from '@xyflow/system';
 import type { Simplify } from 'type-fest';
 import type { Tool } from 'ai';
 import type { UIMessage } from 'ai';
+import type { UIMessagePart } from 'ai';
 import { z } from 'zod';
 
+export declare const ASK_USER_QUESTION: "askUserQuestion";
+
+export declare type AskUserQuestionInput = z.infer<typeof inputSchema_9>;
+
+export declare type AskUserQuestionPart = Extract<MMChatUIMessagePart, {
+    type: `tool-${typeof ASK_USER_QUESTION}`;
+}>;
+
 /**
  * Universal storage adapter interface for cross-platform compatibility.
  * All operations are async to accommodate different storage mechanisms.
@@ -111,6 +120,11 @@ export declare interface AuthProvider {
      * @param listener the listener to remove
      */
     removeEventListener<T extends MageMetricsEvent>(type: T["type"], listener: MageMetricsEventListener<T>): void;
+    /**
+     * Clean up resources held by the auth provider.
+     * Called when the provider is no longer needed (e.g., client is being replaced).
+     */
+    destroy(): void;
 }
 
 /**
@@ -128,6 +142,39 @@ export declare class BrowserStorageAdapter implements AsyncStorage {
     removeItem(key: string): Promise<void>;
 }
 
+export declare type CanonicalDataType = z.infer<typeof CanonicalDataTypeSchema>;
+
+declare const CanonicalDataTypeSchema: z.ZodEnum<{
+    boolean: "boolean";
+    array: "array";
+    text: "text";
+    json: "json";
+    other: "other";
+    datetime: "datetime";
+    numeric: "numeric";
+}>;
+
+/** Allowed media types for chat file attachments. */
+export declare const CHAT_ALLOWED_FILE_MEDIA_TYPES: Set<string>;
+
+/**
+ * Value for the HTML `<input accept>` attribute, derived from
+ * {@link CHAT_ALLOWED_FILE_MEDIA_TYPES} so it stays in sync automatically.
+ */
+export declare const CHAT_FILE_ACCEPT: string;
+
+/**
+ * Maximum combined size of all chat file attachments in a single message.
+ * Intentional semantic alias of the conversation-level budget.
+ */
+export declare const CHAT_MAX_COMBINED_FILE_SIZE: number;
+
+/** Maximum number of file attachments per message. */
+export declare const CHAT_MAX_FILE_COUNT = 10;
+
+/** Maximum size of a single chat file attachment in bytes (10 MB). */
+export declare const CHAT_MAX_FILE_SIZE: number;
+
 export declare const CHECK_KEY = "mm-ai-check-key";
 
 export declare interface ColumnSort {
@@ -145,6 +192,10 @@ declare interface components {
             unit?: string;
             /** @enum {string} */
             canonicalDataType?: "numeric" | "boolean" | "datetime" | "text" | "array" | "json" | "other";
+            formatHint?: {
+                isNumeric?: boolean;
+                isLikelyYear?: boolean;
+            };
         }[];
         /** Format: uuid */
         CanvasId: string;
@@ -378,6 +429,12 @@ declare interface components {
             /** Format: uuid */
             agent_version_id?: string | null;
             cached?: boolean;
+            /** Format: uuid */
+            cached_from?: string | null;
+            /** @default 0 */
+            report_count: number;
+            /** @default 0 */
+            visualization_count: number;
         };
         StartAgentRunRequest: {
             /** Format: uuid */
@@ -709,6 +766,7 @@ export declare class DirectAuthProvider implements AuthProvider {
         signal?: AbortSignal;
     }): void;
     removeEventListener<T extends MageMetricsEvent>(type: T["type"], listener: MageMetricsEventListener<T>): void;
+    destroy(): void;
     private setState;
 }
 
@@ -732,6 +790,7 @@ export declare class ExternalAuthProvider implements AuthProvider {
     private processedJwt;
     private userId;
     private events;
+    private authSubscription;
     constructor(config: ExternalAuthProviderConfig);
     initialize(): Promise<void>;
     getHeaders(): Promise<Record<string, string>>;
@@ -745,6 +804,7 @@ export declare class ExternalAuthProvider implements AuthProvider {
     removeEventListener<T extends MageMetricsEvent>(type: T["type"], listener: MageMetricsEventListener<T>): void;
     startAutoRefresh(): Promise<void> | undefined;
     stopAutoRefresh(): Promise<void> | undefined;
+    destroy(): void;
     private getApiInformation;
     private initializeSupabaseClient;
     private handleAuthentication;
@@ -767,7 +827,18 @@ export declare interface ExternalAuthProviderConfig {
     authOptions?: Pick<GoTrueClientOptions, "fetch">;
 }
 
-declare type FrontendRecentFlows = z.infer<typeof FrontendRecentFlowsSchema>;
+export declare type FrontendFlow = z.infer<typeof FrontendFlowSchema>;
+
+declare const FrontendFlowSchema: z.ZodObject<{
+    title: z.ZodNullable<z.ZodString>;
+    id: z.ZodString;
+    request: z.ZodString;
+    created_at: z.ZodString;
+    application_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    user_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+
+export declare type FrontendRecentFlows = z.infer<typeof FrontendRecentFlowsSchema>;
 
 declare const FrontendRecentFlowsSchema: z.ZodObject<{
     title: z.ZodNullable<z.ZodString>;
@@ -776,13 +847,310 @@ declare const FrontendRecentFlowsSchema: z.ZodObject<{
     created_at: z.ZodString;
     application_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     user_id: z.ZodNullable<z.ZodString>;
-    context_tokens: z.ZodOptional<z.ZodNumber>;
-    acc_input_tokens: z.ZodOptional<z.ZodNumber>;
-    acc_output_tokens: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 
+export declare type FrontendRecommendations = z.infer<typeof FrontendRecommendationsSchema>;
+
+declare const FrontendRecommendationsSchema: z.ZodObject<{
+    starter: z.ZodString;
+    explanation: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strip>;
+
+export declare type FrontendReport = z.infer<typeof FrontendReportSchema>;
+
+export declare type FrontendReportColumns = z.infer<typeof FrontendReportColumnsSchema>;
+
+declare const FrontendReportColumnsSchema: z.ZodArray<z.ZodObject<{
+    dataType: z.ZodString;
+    renderType: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodString>;
+    canonicalDataType: z.ZodOptional<z.ZodEnum<{
+        boolean: "boolean";
+        array: "array";
+        text: "text";
+        json: "json";
+        other: "other";
+        datetime: "datetime";
+        numeric: "numeric";
+    }>>;
+    formatHint: z.ZodOptional<z.ZodObject<{
+        isNumeric: z.ZodOptional<z.ZodBoolean>;
+        isLikelyYear: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    name: z.ZodString;
+    data_type: z.ZodString;
+}, z.core.$strip>>;
+
+export declare type FrontendReportExplainability = z.infer<typeof FrontendReportExplainabilitySchema>;
+
+declare const FrontendReportExplainabilitySchema: z.ZodObject<{
+    columns_lineage: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<{
+                result: "result";
+                filter: "filter";
+                entity: "entity";
+                attribute: "attribute";
+                process: "process";
+                combine: "combine";
+            }>;
+            explanation: z.ZodString;
+        }, z.core.$strip>>;
+        edges: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            target: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
+    report_id: z.ZodUUID;
+    sql_explanation: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        chunk_title: z.ZodString;
+        chunk_explanation: z.ZodString;
+        lines: z.ZodArray<z.ZodObject<{
+            sql: z.ZodString;
+            explanation: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
+    business_explanation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodString;
+        implementation: z.ZodArray<z.ZodString>;
+        assumptions: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                grain: "grain";
+                completeness: "completeness";
+                transformation: "transformation";
+                relationship: "relationship";
+                other: "other";
+            }>;
+            details: z.ZodString;
+            explanation: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    flow_data_id: z.ZodNumber;
+    confidence_score: z.ZodOptional<z.ZodNumber>;
+    confidence_score_reason: z.ZodOptional<z.ZodString>;
+    assumptions_score: z.ZodOptional<z.ZodNumber>;
+    assumptions_score_reason: z.ZodOptional<z.ZodString>;
+    friendliness_score: z.ZodOptional<z.ZodNumber>;
+    friendliness_score_reason: z.ZodOptional<z.ZodString>;
+    output_dataset: z.ZodOptional<z.ZodString>;
+    sql: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+declare const FrontendReportSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    id: z.ZodNumber;
+    uuid: z.ZodString;
+    request: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    data_summary: z.ZodObject<{
+        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+            min_value: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            max_value: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            avg_value: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            median_value: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            std_value: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            min_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            max_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            min_length: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            max_length: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            avg_length: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    is_removed: z.ZodBoolean;
+    is_materialized: z.ZodNullable<z.ZodBoolean>;
+    last_materialized_at: z.ZodNullable<z.ZodString>;
+    materialized_error_message: z.ZodNullable<z.ZodString>;
+    materialized_status: z.ZodNullable<z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        running: "running";
+    }>>;
+}, z.core.$strip>;
+
+export declare type FrontendVisualization = z.output<typeof FrontendVisualizationSchema>;
+
+declare const FrontendVisualizationSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    uuid: z.ZodString;
+    configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        categoryColumn: z.ZodString;
+        secondaryCategoryColumn: z.ZodOptional<z.ZodString>;
+        valueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"bar">;
+    }, z.core.$strip>, z.ZodObject<{
+        xAxisColumn: z.ZodString;
+        valueColumns: z.ZodArray<z.ZodString>;
+        yAxisLabels: z.ZodArray<z.ZodString>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area">;
+        config_version: z.ZodLiteral<2>;
+    }, z.core.$strip>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        valueColumn: z.ZodString;
+        xAxisColumn: z.ZodString;
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        categoryColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area-categorical">;
+    }, z.core.$strip>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisValueColumn: z.ZodString;
+        yAxisValueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"scatter">;
+    }, z.core.$strip>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        categoryColumn: z.ZodString;
+        valueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"pie">;
+    }, z.core.$strip>], "type">;
+    created_at: z.ZodString;
+    flow_data_id: z.ZodNumber;
+    report_uuid: z.ZodString;
+    flow_data: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+    materialization: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export declare type FrontendVisualizationWithData = z.output<typeof FrontendVisualizationWithDataSchema>;
+
+declare const FrontendVisualizationWithDataSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    uuid: z.ZodString;
+    configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        categoryColumn: z.ZodString;
+        secondaryCategoryColumn: z.ZodOptional<z.ZodString>;
+        valueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"bar">;
+    }, z.core.$strip>, z.ZodObject<{
+        xAxisColumn: z.ZodString;
+        valueColumns: z.ZodArray<z.ZodString>;
+        yAxisLabels: z.ZodArray<z.ZodString>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area">;
+        config_version: z.ZodLiteral<2>;
+    }, z.core.$strip>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        valueColumn: z.ZodString;
+        xAxisColumn: z.ZodString;
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        categoryColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area-categorical">;
+    }, z.core.$strip>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisValueColumn: z.ZodString;
+        yAxisValueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"scatter">;
+    }, z.core.$strip>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        categoryColumn: z.ZodString;
+        valueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"pie">;
+    }, z.core.$strip>], "type">;
+    created_at: z.ZodString;
+    flow_data_id: z.ZodNumber;
+    report_uuid: z.ZodString;
+    flow_data: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+    materialization: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+    data: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodDate, z.ZodCoercedNumber<unknown>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<"empty" | (string & {}) | null, unknown>>]>>>;
+    _metadata: z.ZodOptional<z.ZodObject<{
+        wasSampled: z.ZodBoolean;
+        originalCount: z.ZodNumber;
+        sampledCount: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export declare const GENERATE_DATA_REPORT: "generateDataReport";
+
+export declare const GENERATE_VISUALIZATION: "generateVisualization";
+
+export declare const GET_AVAILABLE_COLUMNS_FOR_TABLE: "getAvailableColumnsForTable";
+
+export declare const GET_AVAILABLE_TABLES: "getAvailableTables";
+
+export declare const getMessageTextContent: (message: MMChatUIMessage) => string | undefined;
+
 export declare const getPublicApiClient: (apiUrl: string, apiKey: string) => Client<PublicPaths>;
 
+/**
+ * Extracts an uploaded file id from a `uploaded-file:{id}` reference.
+ * @param url the url of the file
+ * @returns file id
+ */
+export declare const getUploadedFileIdFromUrl: (url: string) => string | null;
+
+/**
+ * Returns true when a flow contains only the initial user message created via
+ * `createFlow(...)` and no assistant response yet.
+ *
+ * In headless AI SDK integrations, this is the state where the frontend should
+ * trigger a one-time `regenerate()` to start the first assistant turn.
+ * @param messages - Chat messages for the flow.
+ * @returns Whether the flow still has only its initial user message.
+ */
+export declare const hasOnlyInitialUserMessage: (messages: MMChatUIMessage[]) => boolean;
+
 declare const HEADER_SP_TOKEN: "sp-access-token";
 
 declare const inputSchema: z.ZodObject<{
@@ -851,11 +1219,21 @@ declare const inputSchema_9: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
+export declare const isAskUserQuestionPart: (part: MMChatUIMessagePart) => part is AskUserQuestionPart;
+
+export declare const isFrontendV1Visualization: (visualization: FrontendVisualization | V1FrontendVisualization) => visualization is V1FrontendVisualization;
+
+export declare const isFrontendV1VisualizationWithData: (visualization: FrontendVisualizationWithData | V1FrontendVisualizationWithData) => visualization is V1FrontendVisualizationWithData;
+
+export declare const isFrontendV2Visualization: (visualization: FrontendVisualization | V1FrontendVisualization) => visualization is FrontendVisualization;
+
+export declare const isFrontendV2VisualizationWithData: (visualization: FrontendVisualizationWithData | V1FrontendVisualizationWithData) => visualization is FrontendVisualizationWithData;
+
 export declare class MageMetricsChatTransport extends DefaultChatTransport<MMChatUIMessage> {
     constructor(apiUrl: string, flowId: string, options: MageMetricsChatTransportOptions);
 }
 
-declare type MageMetricsChatTransportOptions = Omit<HttpChatTransportInitOptions<MMChatUIMessage>, "api" | "prepareSendMessagesRequest">;
+export declare type MageMetricsChatTransportOptions = Omit<HttpChatTransportInitOptions<MMChatUIMessage>, "api" | "prepareSendMessagesRequest">;
 
 /**
  * Core MageMetrics client that handles authentication lifecycle and provides
@@ -898,6 +1276,14 @@ export declare class MageMetricsClient {
     get state(): AuthState;
     getHeaders(): Promise<Record<string, string>>;
     logout(): Promise<void>;
+    /**
+     * Clean up all resources held by this client.
+     * Unsubscribes auth state listeners, stops auto-refresh timers,
+     * and removes global event listeners (e.g. visibilitychange).
+     *
+     * Call this before discarding a client instance to prevent leaks.
+     */
+    destroy(): void;
     auth: {
         startAutoRefresh: () => Promise<void> | undefined;
         stopAuthRefresh: () => Promise<void> | undefined;
@@ -1103,9 +1489,6 @@ export declare class MageMetricsClient {
             title: string | null;
             user_id: string | null;
             application_id?: number | null | undefined;
-            context_tokens?: number | undefined;
-            acc_input_tokens?: number | undefined;
-            acc_output_tokens?: number | undefined;
         }>;
         getRecentFlows: (params?: {
             limit?: number;
@@ -1134,9 +1517,6 @@ export declare class MageMetricsClient {
                     title: string | null;
                     user_id: string | null;
                     application_id?: number | null | undefined;
-                    context_tokens?: number | undefined;
-                    acc_input_tokens?: number | undefined;
-                    acc_output_tokens?: number | undefined;
                 }[];
             }[]>;
             get: (canvasId: string) => Promise<{
@@ -1182,6 +1562,10 @@ export declare class MageMetricsClient {
                 renderType?: string | undefined;
                 unit?: string | undefined;
                 canonicalDataType?: "numeric" | "boolean" | "datetime" | "text" | "array" | "json" | "other" | undefined;
+                formatHint?: {
+                    isNumeric?: boolean | undefined;
+                    isLikelyYear?: boolean | undefined;
+                } | undefined;
             }[];
             rowCount: {
                 count: number;
@@ -1195,6 +1579,7 @@ export declare class MageMetricsClient {
             explanation: string;
             type: string;
         }[]>;
+        getPromptStarters: (input?: string) => Promise<PromptStarter[]>;
     };
     client(): PublicApiClient;
     private createSupabaseHeaderMiddleware;
@@ -1255,7 +1640,9 @@ export declare class MemoryStorageAdapter implements AsyncStorage {
 
 export declare type MMChatUIMessage = UIMessage<unknown, CustomDataParts, MMUiTools>;
 
-declare type MMUiTools = {
+export declare type MMChatUIMessagePart = UIMessagePart<CustomDataParts, MMUiTools>;
+
+export declare type MMUiTools = {
     generateDataReport: UiTool;
     generateVisualization: UiTool_2;
     think: UiTool_3;
@@ -1471,6 +1858,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -1531,6 +1920,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -1592,6 +1983,7 @@ declare interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Numeric legacy ID or UUID */
                 visualization_id: string;
                 canvas_id: components["schemas"]["CanvasId"];
             };
@@ -1669,9 +2061,6 @@ declare interface operations {
                         title: string | null;
                         user_id: string | null;
                         application_id?: number | null;
-                        context_tokens?: number;
-                        acc_input_tokens?: number;
-                        acc_output_tokens?: number;
                     };
                 };
             };
@@ -1725,9 +2114,6 @@ declare interface operations {
                         title: string | null;
                         user_id: string | null;
                         application_id?: number | null;
-                        context_tokens?: number;
-                        acc_input_tokens?: number;
-                        acc_output_tokens?: number;
                     }[];
                 };
             };
@@ -1982,6 +2368,7 @@ declare interface operations {
             query?: never;
             header?: {
                 "sp-access-token"?: string;
+                "X-Application-Name"?: string;
             };
             path?: never;
             cookie?: never;
@@ -2247,6 +2634,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -2297,6 +2686,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -2626,6 +3017,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 visualization_id: string;
             };
             cookie?: never;
@@ -3131,9 +3523,6 @@ declare interface operations {
                             title: string | null;
                             user_id: string | null;
                             application_id?: number | null;
-                            context_tokens?: number;
-                            acc_input_tokens?: number;
-                            acc_output_tokens?: number;
                         }[];
                     }[];
                 };
@@ -5949,6 +6338,8 @@ declare interface operations {
     };
 }
 
+export declare const PAGINATE_DATA_REPORT: "paginateDataReport";
+
 declare type PatchParam<T, Config extends RemoveParamsConfig, P extends keyof Config> = Simplify<T extends {
     [key in P]: infer H;
 } ? H extends Partial<Record<string, unknown>> ? Config[P] extends string ? Omit<H, Config[P]> : H : never : never>;
@@ -6793,13 +7184,36 @@ declare interface paths {
     };
 }
 
-declare type PublicApiClient = Simplify<Client<PublicPaths, `${string}/${string}`>>;
+export declare type PromptStarter = z.infer<typeof PromptStarterSchema>;
+
+declare const PromptStarterSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    template: z.ZodString;
+    is_default: z.ZodBoolean;
+}, z.core.$strip>;
+
+export declare type PublicApiClient = Simplify<Client<PublicPaths, `${string}/${string}`>>;
 
 declare type PublicPaths = Simplify<{
     [Path in keyof paths]: RemoveAuthHeader<paths[Path]>;
 }>;
 
-declare type QuickActions = z.infer<typeof QuickActionsSchema>;
+export declare type QuestionInput = z.infer<typeof questionSchema>;
+
+declare const questionSchema: z.ZodObject<{
+    question: z.ZodString;
+    header: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    multiSelect: z.ZodBoolean;
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export declare type QuickAction = QuickActions[number];
+
+export declare type QuickActions = z.infer<typeof QuickActionsSchema>;
 
 declare const QuickActionsSchema: z.ZodArray<z.ZodObject<{
     label: z.ZodString;
@@ -6817,6 +7231,91 @@ declare const RedactedAskUserQuestionResponse: z.ZodObject<{
     }, z.core.$strip>], "status">;
 }, z.core.$strip>;
 
+export declare type RedactedAskUserQuestionResponseType = z.output<typeof RedactedAskUserQuestionResponse>;
+
+declare const RedactedGenerateDataReportResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"generateDataReport">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{
+            flowDataId: z.ZodNumber;
+            reportId: z.ZodString;
+            answer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        category: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            timeout: "timeout";
+            connection_error: "connection_error";
+            auth_error: "auth_error";
+            resource_exhausted: "resource_exhausted";
+            table_not_found: "table_not_found";
+            column_not_found: "column_not_found";
+            schema_not_found: "schema_not_found";
+            view_not_found: "view_not_found";
+            function_not_found: "function_not_found";
+            syntax_error: "syntax_error";
+            ambiguous_column: "ambiguous_column";
+            type_mismatch: "type_mismatch";
+            invalid_cast: "invalid_cast";
+            invalid_argument: "invalid_argument";
+            division_by_zero: "division_by_zero";
+            constraint_violation: "constraint_violation";
+            permission_denied: "permission_denied";
+        }>>;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedGenerateDataReportResponseType = z.infer<typeof RedactedGenerateDataReportResponse>;
+
+declare const RedactedGenerateVisualizationResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"generateVisualization">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{
+            flowDataId: z.ZodNumber;
+            reportId: z.ZodString;
+            flowDataVisualizationId: z.ZodNumber;
+            visualizationId: z.ZodString;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedGenerateVisualizationResponseType = z.infer<typeof RedactedGenerateVisualizationResponse>;
+
+declare const RedactedGetAvailableColumnsForTableResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"getAvailableColumnsForTable">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{}, z.core.$loose>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedGetAvailableColumnsForTableResponseType = z.infer<typeof RedactedGetAvailableColumnsForTableResponse>;
+
+declare const RedactedGetAvailableTablesResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"getAvailableTables">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{}, z.core.$loose>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedGetAvailableTablesResponseType = z.output<typeof RedactedGetAvailableTablesResponse>;
+
 declare const redactedOutputSchema: z.ZodObject<{
     tool: z.ZodLiteral<"generateDataReport">;
     result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6948,6 +7447,24 @@ declare const redactedOutputSchema_8: z.ZodObject<{
     }, z.core.$strip>], "status">>;
 }, z.core.$strip>;
 
+declare const RedactedPaginateDataReportResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"paginateDataReport">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{
+            totalRows: z.ZodNumber;
+            fetchedRows: z.ZodNumber;
+            offset: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedPaginateDataReportResponseType = z.output<typeof RedactedPaginateDataReportResponse>;
+
 declare const RedactedThinkResponse: z.ZodObject<{
     tool: z.ZodDefault<z.ZodLiteral<"think">>;
     result: z.ZodOptional<z.ZodObject<{
@@ -6956,6 +7473,41 @@ declare const RedactedThinkResponse: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
+export declare type RedactedThinkResponseType = z.output<typeof RedactedThinkResponse>;
+
+declare const RedactedValueBasedColumnSearchResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"valueBasedColumnSearch">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{}, z.core.$loose>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedValueBasedColumnSearchResponseType = z.infer<typeof RedactedValueBasedColumnSearchResponse>;
+
+declare const RedactedWebSearchToolResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"search">>;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{
+            sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                sourceType: z.ZodLiteral<"url">;
+                id: z.ZodString;
+                url: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
+export declare type RedactedWebSearchToolResponseType = z.infer<typeof RedactedWebSearchToolResponse>;
+
 declare type RemoveAuthHeader<PathSchema> = Simplify<{
     [Method in keyof PathSchema]: RemoveParams<PathSchema[Method], ToRemove>;
 }>;
@@ -6978,6 +7530,8 @@ declare type RemoveParamsConfig = Simplify<{
     cookie?: string;
 }>;
 
+export declare type ReportData = z.infer<typeof ReportDataSchema>;
+
 declare type ReportDataFilters = {
     columns?: string[];
     limit: number;
@@ -6986,7 +7540,18 @@ declare type ReportDataFilters = {
     cursor?: number;
 };
 
-declare type SignalWithReportId = z.infer<typeof SignalWithReportIdSchema>;
+declare const ReportDataSchema: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
+
+export declare type Signal = z.infer<typeof SignalSchema>;
+
+declare const SignalSchema: z.ZodObject<{
+    rule: z.ZodString;
+    metric: z.ZodString;
+    trigger: z.ZodString;
+    implementation: z.ZodString;
+}, z.core.$strip>;
+
+export declare type SignalWithReportId = z.infer<typeof SignalWithReportIdSchema>;
 
 declare const SignalWithReportIdSchema: z.ZodObject<{
     rule: z.ZodString;
@@ -6996,11 +7561,34 @@ declare const SignalWithReportIdSchema: z.ZodObject<{
     reportId: z.ZodNumber;
 }, z.core.$strip>;
 
-declare type SortingState = ColumnSort[];
+export declare type SortingState = ColumnSort[];
 
-declare type TableFilters = Record<string, TableFilterValue>;
+export declare const SqlErrorCategory: z.ZodEnum<{
+    unknown: "unknown";
+    timeout: "timeout";
+    connection_error: "connection_error";
+    auth_error: "auth_error";
+    resource_exhausted: "resource_exhausted";
+    table_not_found: "table_not_found";
+    column_not_found: "column_not_found";
+    schema_not_found: "schema_not_found";
+    view_not_found: "view_not_found";
+    function_not_found: "function_not_found";
+    syntax_error: "syntax_error";
+    ambiguous_column: "ambiguous_column";
+    type_mismatch: "type_mismatch";
+    invalid_cast: "invalid_cast";
+    invalid_argument: "invalid_argument";
+    division_by_zero: "division_by_zero";
+    constraint_violation: "constraint_violation";
+    permission_denied: "permission_denied";
+}>;
+
+export declare type SqlErrorCategory = z.infer<typeof SqlErrorCategory>;
 
-declare type TableFilterValue = z.infer<typeof TableFilterValueSchema>;
+export declare type TableFilters = Record<string, TableFilterValue>;
+
+export declare type TableFilterValue = z.infer<typeof TableFilterValueSchema>;
 
 declare const TableFilterValueSchema: z.ZodObject<{
     operator: z.ZodEnum<{
@@ -7019,6 +7607,8 @@ declare const TableFilterValueSchema: z.ZodObject<{
     value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>;
 }, z.core.$strip>;
 
+export declare const THINK: "think";
+
 /**
  * Token storage keys
  */
@@ -7028,6 +7618,25 @@ declare type ToRemove = {
     header: typeof HEADER_SP_TOKEN;
 };
 
+export declare const toSearchParams: ({ cursor, filters, sorting, limit, }: {
+    cursor?: number;
+    filters?: TableFilters;
+    sorting?: SortingState;
+    limit?: number;
+}) => {
+    limit?: number;
+    cursor?: number;
+    order?: string;
+    filter?: string;
+};
+
+/**
+ * Builds a `uploaded-file:{id}` reference string.
+ * @param uploadedFileId the id of the file
+ * @returns a prefixed handler
+ */
+export declare const toUploadedFileRefUrl: (uploadedFileId: string) => string;
+
 declare type UiTool = InferUITool<Tool<z.infer<typeof inputSchema>, z.infer<typeof redactedOutputSchema>>>;
 
 declare type UiTool_10 = InferUITool<Tool<z.infer<typeof inputSchema_10>, z.infer<typeof redactedOutputSchema_8>>>;
@@ -7056,9 +7665,166 @@ declare const UpdateCanvasSchema: z.ZodObject<{
     is_public: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 
+/** Prefix used by new clients to reference a file uploaded separately from chat JSON. */
+export declare const UPLOADED_FILE_REF_PREFIX = "uploaded-file:";
+
+/** Response payload returned when a file is uploaded successfully. */
+export declare type UploadedFile = {
+    uploadedFileId: string;
+    filename: string;
+    mediaType: string;
+    sizeBytes: number;
+};
+
 /** A previously uploaded file identifier to attach to the first message of a flow. */
-declare type UploadedFileId = default_2.infer<typeof UploadedFileIdSchema>;
+export declare type UploadedFileId = default_2.infer<typeof UploadedFileIdSchema>;
 
 declare const UploadedFileIdSchema: z.ZodUUID;
 
+export declare type V1FrontendVisualization = z.output<typeof V1FrontendVisualizationSchema>;
+
+declare const V1FrontendVisualizationSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    uuid: z.ZodString;
+    configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisDataKey: z.ZodOptional<z.ZodString>;
+        yAxisDataKey: z.ZodOptional<z.ZodString>;
+        dimensionDataKey: z.ZodOptional<z.ZodString>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"bar">;
+    }, z.core.$strip>, z.ZodObject<{
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisDataKey: z.ZodOptional<z.ZodString>;
+        yAxisDataKey: z.ZodOptional<z.ZodString>;
+        dimensionDataKey: z.ZodOptional<z.ZodString>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area">;
+    }, z.core.$strip>, z.ZodObject<{
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisDataKey: z.ZodOptional<z.ZodString>;
+        yAxisDataKey: z.ZodOptional<z.ZodString>;
+        dimensionDataKey: z.ZodOptional<z.ZodString>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"scatter">;
+    }, z.core.$strip>, z.ZodObject<{
+        nameKey: z.ZodString;
+        dataKey: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"pie">;
+    }, z.core.$strip>], "type">;
+    created_at: z.ZodString;
+    flow_data_id: z.ZodNumber;
+    report_uuid: z.ZodString;
+    flow_data: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+    materialization: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export declare type V1FrontendVisualizationWithData = z.output<typeof V1FrontendVisualizationWithDataSchema>;
+
+declare const V1FrontendVisualizationWithDataSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    uuid: z.ZodString;
+    configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisDataKey: z.ZodOptional<z.ZodString>;
+        yAxisDataKey: z.ZodOptional<z.ZodString>;
+        dimensionDataKey: z.ZodOptional<z.ZodString>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"bar">;
+    }, z.core.$strip>, z.ZodObject<{
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisDataKey: z.ZodOptional<z.ZodString>;
+        yAxisDataKey: z.ZodOptional<z.ZodString>;
+        dimensionDataKey: z.ZodOptional<z.ZodString>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area">;
+    }, z.core.$strip>, z.ZodObject<{
+        xAxisLabel: z.ZodString;
+        yAxisLabel: z.ZodString;
+        xAxisDataKey: z.ZodOptional<z.ZodString>;
+        yAxisDataKey: z.ZodOptional<z.ZodString>;
+        dimensionDataKey: z.ZodOptional<z.ZodString>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"scatter">;
+    }, z.core.$strip>, z.ZodObject<{
+        nameKey: z.ZodString;
+        dataKey: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"pie">;
+    }, z.core.$strip>], "type">;
+    created_at: z.ZodString;
+    flow_data_id: z.ZodNumber;
+    report_uuid: z.ZodString;
+    flow_data: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+    materialization: z.ZodOptional<z.ZodObject<{
+        is_materialized: z.ZodNullable<z.ZodBoolean>;
+        last_materialized_at: z.ZodNullable<z.ZodString>;
+        materialized_error_message: z.ZodNullable<z.ZodString>;
+        materialized_status: z.ZodNullable<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+        }>>;
+    }, z.core.$strip>>;
+    data: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodDate, z.ZodCoercedNumber<unknown>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<"empty" | (string & {}) | null, unknown>>]>>>;
+    _metadata: z.ZodOptional<z.ZodObject<{
+        wasSampled: z.ZodBoolean;
+        originalCount: z.ZodNumber;
+        sampledCount: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+/**
+ * Validates that an array of uploaded files does not exceed the count or
+ * combined-size limits.  The function accepts any object with `size_bytes` so
+ * callers don't need to import Supabase-specific row types.
+ * @param uploadedFiles - The files to validate.
+ */
+export declare const validateUploadedFiles: (uploadedFiles: ReadonlyArray<{
+    size_bytes: number;
+}>) => void;
+
+export declare const VALUE_BASED_COLUMN_SEARCH: "valueBasedColumnSearch";
+
+export declare const WEB_SEARCH: "webSearch";
+
 export { }