@magemetrics/core 0.12.2 → 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;
@@ -336,8 +387,6 @@ declare interface components {
             id: string;
             /** Format: uuid */
             agent_id: string | null;
-            /** Format: uuid */
-            flow_id: string | null;
             /** @enum {string} */
             status: "pending" | "running" | "post_processing" | "completed" | "failed" | "cancelled";
             created_at: string;
@@ -377,7 +426,15 @@ declare interface components {
                     [key: string]: unknown;
                 };
             } | null;
+            /** 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 */
@@ -415,6 +472,7 @@ declare interface components {
         Agent: {
             /** Format: uuid */
             id: string;
+            created_at: string;
             name: string;
             objective: string | null;
             generated_objective_fragment: string | null;
@@ -449,7 +507,75 @@ declare interface components {
             })[] | null;
             output_schema: {
                 [key: string]: unknown;
+            };
+            task_plan: {
+                id: string;
+                title: string;
+                /** @description Detailed steps or description of what the task will do */
+                description?: string;
+            }[] | null;
+            model_config: {
+                /** @enum {string} */
+                model: "gemini-3.1-pro-preview";
+                /** @enum {string} */
+                thinking?: "low" | "high";
+            } | {
+                /** @enum {string} */
+                model: "gemini-2.5-pro";
+                /** @enum {string} */
+                thinking?: "low" | "high";
+            } | {
+                /** @enum {string} */
+                model: "claude-sonnet-4-6" | "claude-opus-4-6";
+                /** @enum {string} */
+                effort?: "low" | "medium" | "high";
+            } | {
+                /** @enum {string} */
+                model: "claude-haiku-4-5" | "claude-opus-4-5";
             } | null;
+            /** @enum {string} */
+            execution_platform: "native" | "sandbox" | "sandbox_public";
+            updated_at: string;
+        };
+        AgentVersion: {
+            /** Format: uuid */
+            id: string;
+            version: number;
+            name: string;
+            objective: string | null;
+            generated_objective_fragment: string | null;
+            active_tools: string[] | null;
+            input_schema: ({
+                id: string;
+                name: string;
+                description?: string;
+                /** @enum {string} */
+                type: "enum";
+                options: {
+                    value: string;
+                    fragment?: string;
+                }[];
+                /** @default false */
+                useFragmentMapping: boolean;
+                /** @default false */
+                required: boolean;
+            } | {
+                id: string;
+                name: string;
+                description?: string;
+                /** @enum {string} */
+                type: "text";
+                /**
+                 * @default false
+                 * @enum {boolean}
+                 */
+                useFragmentMapping: false;
+                /** @default false */
+                required: boolean;
+            })[] | null;
+            output_schema: {
+                [key: string]: unknown;
+            };
             task_plan: {
                 id: string;
                 title: string;
@@ -477,15 +603,13 @@ declare interface components {
             } | null;
             /** @enum {string} */
             execution_platform: "native" | "sandbox" | "sandbox_public";
-            master_prompt_name: string | null;
-            master_prompt_version: number | null;
+            restored_from_version?: number | null;
             created_at: string;
-            updated_at: string;
         };
         CreateGlobalKnowledgeItem: {
             content: string;
-            /** @description Optional identifier from your system, used for lookup and batch operations */
-            external_id?: string;
+            /** @description Stable, client-defined identifier from your system.Use it to look up, update, or upsert the item without tracking Magemetrics internal IDs. */
+            client_reference_id?: string;
             /** @default true */
             is_active: boolean;
             tags?: string[];
@@ -496,8 +620,8 @@ declare interface components {
         };
         CreateSchemaKnowledgeItem: {
             content: string;
-            /** @description Optional identifier from your system, used for lookup and batch operations */
-            external_id?: string;
+            /** @description Stable, client-defined identifier from your system.Use it to look up, update, or upsert the item without tracking Magemetrics internal IDs. */
+            client_reference_id?: string;
             /** @default true */
             is_active: boolean;
             tags?: string[];
@@ -515,6 +639,31 @@ declare interface components {
             /** @description Column name (optional). Omit for table-level items, include for column-level items. */
             column_name?: string;
         };
+        UpsertGlobalKnowledgeItem: {
+            content: string;
+            /** @description Stable, client-defined identifier from your system.Use it to look up, update, or upsert the item without tracking Magemetrics internal IDs. */
+            client_reference_id: string;
+            /** @default true */
+            is_active: boolean;
+            tags?: string[];
+            /** @description IDs of applications this item is scoped to. Empty or omitted means all applications. */
+            application_ids?: number[];
+            /** @enum {string} */
+            type: "global";
+        };
+        UpsertSchemaKnowledgeItem: {
+            content: string;
+            /** @description Stable, client-defined identifier from your system.Use it to look up, update, or upsert the item without tracking Magemetrics internal IDs. */
+            client_reference_id: string;
+            /** @default true */
+            is_active: boolean;
+            tags?: string[];
+            /** @description IDs of applications this item is scoped to. Empty or omitted means all applications. */
+            application_ids?: number[];
+            /** @enum {string} */
+            type: "schema";
+            path: components["schemas"]["SchemaPath"];
+        };
         StatisticsResponse: {
             /** @description The time period in days for these statistics */
             period_days: number;
@@ -533,7 +682,7 @@ declare interface components {
         /** @description Statistics for agent-generated content (custom agent runs only) */
         AgentGeneratedStatistics: {
             /** @description Number of custom agent runs */
-            agent_runs: number;
+            agent_runs: number | null;
         };
     };
     responses: never;
@@ -572,11 +721,15 @@ declare type CustomDataParts = {
     };
     "report-status": {
         status: string | null;
+        report_id?: string;
+        tool_call_id?: string;
     };
     "report-narration": {
         step_name: string;
         step_order: number;
         narration: string;
+        report_id?: string;
+        tool_call_id?: string;
     };
 };
 
@@ -613,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;
 }
 
@@ -636,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>>;
@@ -649,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;
@@ -671,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>;
@@ -680,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<{
@@ -705,7 +1169,7 @@ declare const inputSchema_10: z.ZodObject<{
 }, z.core.$strip>;
 
 declare const inputSchema_2: z.ZodObject<{
-    reportId: z.ZodNumber;
+    reportId: z.ZodUnion<[z.ZodNumber, z.ZodUUID]>;
     chartType: z.ZodEnum<{
         bar: "bar";
         "line/area": "line/area";
@@ -755,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
@@ -802,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;
@@ -871,7 +1353,6 @@ export declare class MageMetricsClient {
         }[]>;
         getFlowDataReports: (flowId: string) => Promise<{
             created_at: string;
-            flow_id: string;
             id: number;
             uuid: string;
             title: string;
@@ -906,97 +1387,190 @@ export declare class MageMetricsClient {
             materialized_error_message: string | null;
             materialized_status: "completed" | "running" | "failed" | null;
         }[]>;
-        getFlow: (flowId: string) => Promise<{
+        getAgentRunReports: (agentRunId: string) => Promise<{
             created_at: string;
-            id: string;
-            request: string;
-            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;
-        }) => Promise<FrontendRecentFlows[]>;
-        createFlow: (request: CreateFlowParam) => Promise<{
-            flowId: string;
-        }>;
-        uploadFile: (file: File, flowId?: string) => Promise<{
-            uploadedFileId: string;
-            filename: string;
-            mediaType: string;
-            sizeBytes: number;
-        }>;
-        deleteUploadedFile: (uploadedFileId: string) => Promise<void>;
-        canvas: {
-            list: (query?: string) => Promise<{
-                id: string;
-                title: string | null;
-                is_public: boolean;
-                nodes: unknown[];
-                edges: unknown[];
-                flows: {
-                    created_at: string;
-                    id: string;
-                    request: string;
-                    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<{
-                id: string;
-                title: string | null;
-                is_public: boolean;
-                nodes: unknown[];
-                edges: unknown[];
-            }>;
-            create: (body: CreateCanvas) => Promise<{
-                id: string;
-            }>;
-            update: (body: z.infer<typeof UpdateCanvasSchema>) => Promise<{
-                success: true;
-            }>;
-            delete: (canvasId: string) => Promise<void>;
-            getForFlow: (flowId: string) => Promise<{
-                title: string | null;
-                id: string;
-                nodes: any[];
-                edges: any[];
-                is_public: boolean;
-            }>;
-        };
-        exportReportData: (reportId: number, format?: "text" | "blob") => Promise<{
-            filename: string;
-            data: Blob | string;
-        }>;
-        getChatTransport: (flowId: string, options?: MageMetricsChatTransportOptions) => MageMetricsChatTransport;
-        getChatMessages: (flowId: string) => Promise<MMChatUIMessage[]>;
-        fetchReportData: (reportId: number, { columns, limit, sorting, filters, cursor }: ReportDataFilters, signal?: AbortSignal) => Promise<{
-            [x: string]: unknown;
-        }[]>;
-        createSpeechToken: () => Promise<{
-            token: string;
-            expiresAt: string;
-        }>;
-        getReport: (reportId: number) => Promise<{
-            columns: {
-                name: string;
-                data_type: string;
+            id: number;
+            uuid: string;
+            title: string;
+            request: string | null;
+            data_summary: {
+                [x: string]: unknown;
+                columns: {
+                    [x: string]: {
+                        [x: string]: unknown;
+                        position?: number | undefined;
+                        data_type: string;
+                        null_count: number | null;
+                        unique_count: number | null;
+                        unique_percentage: number | null;
+                        min_value?: number | null | undefined;
+                        max_value?: number | null | undefined;
+                        avg_value?: number | null | undefined;
+                        median_value?: number | null | undefined;
+                        std_value?: number | null | undefined;
+                        min_date?: string | null | undefined;
+                        max_date?: string | null | undefined;
+                        min_length?: number | null | undefined;
+                        max_length?: number | null | undefined;
+                        avg_length?: number | null | undefined;
+                    };
+                };
+            };
+            status: string | null;
+            is_removed: boolean;
+            is_materialized: boolean | null;
+            last_materialized_at: string | null;
+            materialized_error_message: string | null;
+            materialized_status: "completed" | "running" | "failed" | null;
+        }[]>;
+        getAgentRunVisualizations: (agentRunId: string) => Promise<{
+            id: number;
+            uuid: string;
+            report_uuid: string;
+            flow_data_id: number;
+            created_at: string;
+            flow_data?: {
+                is_materialized: boolean | null;
+                last_materialized_at: string | null;
+                materialized_error_message: string | null;
+                materialized_status: "completed" | "running" | "failed" | null;
+            } | undefined;
+            materialization?: {
+                is_materialized: boolean | null;
+                last_materialized_at: string | null;
+                materialized_error_message: string | null;
+                materialized_status: "completed" | "running" | "failed" | null;
+            } | undefined;
+            configuration: {
+                type: "bar";
+                title: string;
+                config_version: 2;
+                xAxisLabel: string;
+                yAxisLabel: string;
+                categoryColumn: string;
+                secondaryCategoryColumn?: string | undefined;
+                valueColumn: string;
+            } | {
+                type: "line/area";
+                config_version: 2;
+                title: string;
+                xAxisColumn: string;
+                valueColumns: string[];
+                yAxisLabels: string[];
+            } | {
+                type: "line/area-categorical";
+                title: string;
+                config_version: 2;
+                valueColumn: string;
+                xAxisColumn: string;
+                xAxisLabel: string;
+                yAxisLabel: string;
+                categoryColumn: string;
+            } | {
+                type: "scatter";
+                title: string;
+                config_version: 2;
+                xAxisLabel: string;
+                yAxisLabel: string;
+                xAxisValueColumn: string;
+                yAxisValueColumn: string;
+            } | {
+                type: "pie";
+                title: string;
+                config_version: 2;
+                categoryColumn: string;
+                valueColumn: string;
+            };
+        }[]>;
+        getFlow: (flowId: string) => Promise<{
+            created_at: string;
+            id: string;
+            request: string;
+            title: string | null;
+            user_id: string | null;
+            application_id?: number | null | undefined;
+        }>;
+        getRecentFlows: (params?: {
+            limit?: number;
+        }) => Promise<FrontendRecentFlows[]>;
+        createFlow: (request: CreateFlowParam) => Promise<{
+            flowId: string;
+        }>;
+        uploadFile: (file: File, flowId?: string) => Promise<{
+            uploadedFileId: string;
+            filename: string;
+            mediaType: string;
+            sizeBytes: number;
+        }>;
+        deleteUploadedFile: (uploadedFileId: string) => Promise<void>;
+        canvas: {
+            list: (query?: string) => Promise<{
+                id: string;
+                title: string | null;
+                is_public: boolean;
+                nodes: unknown[];
+                edges: unknown[];
+                flows: {
+                    created_at: string;
+                    id: string;
+                    request: string;
+                    title: string | null;
+                    user_id: string | null;
+                    application_id?: number | null | undefined;
+                }[];
+            }[]>;
+            get: (canvasId: string) => Promise<{
+                id: string;
+                title: string | null;
+                is_public: boolean;
+                nodes: unknown[];
+                edges: unknown[];
+            }>;
+            create: (body: CreateCanvas) => Promise<{
+                id: string;
+            }>;
+            update: (body: z.infer<typeof UpdateCanvasSchema>) => Promise<{
+                success: true;
+            }>;
+            delete: (canvasId: string) => Promise<void>;
+            getForFlow: (flowId: string) => Promise<{
+                title: string | null;
+                id: string;
+                nodes: any[];
+                edges: any[];
+                is_public: boolean;
+            }>;
+        };
+        exportReportData: (reportId: string, format?: "text" | "blob") => Promise<{
+            filename: string;
+            data: Blob | string;
+        }>;
+        getChatTransport: (flowId: string, options?: MageMetricsChatTransportOptions) => MageMetricsChatTransport;
+        getChatMessages: (flowId: string) => Promise<MMChatUIMessage[]>;
+        fetchReportData: (reportId: string, { columns, limit, sorting, filters, cursor }: ReportDataFilters, signal?: AbortSignal) => Promise<{
+            [x: string]: unknown;
+        }[]>;
+        createSpeechToken: () => Promise<{
+            token: string;
+            expiresAt: string;
+        }>;
+        getReport: (reportId: string) => Promise<{
+            columns: {
+                name: string;
+                data_type: string;
                 dataType: string;
                 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;
             };
-            data: (reportId: number, { columns, limit, sorting, filters, cursor }: ReportDataFilters, signal?: AbortSignal) => Promise<{
+            data: (reportId: string, { columns, limit, sorting, filters, cursor }: ReportDataFilters, signal?: AbortSignal) => Promise<{
                 [x: string]: unknown;
             }[]>;
         }>;
@@ -1005,6 +1579,7 @@ export declare class MageMetricsClient {
             explanation: string;
             type: string;
         }[]>;
+        getPromptStarters: (input?: string) => Promise<PromptStarter[]>;
     };
     client(): PublicApiClient;
     private createSupabaseHeaderMiddleware;
@@ -1065,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;
@@ -1251,6 +1828,17 @@ declare interface operations {
                     "application/json": components["schemas"]["ReportData"];
                 };
             };
+            /** @description Invalid canvas, report or flow */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
             /** @description Unable to retrieve report with this id */
             404: {
                 headers: {
@@ -1270,6 +1858,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -1300,6 +1890,17 @@ declare interface operations {
                     };
                 };
             };
+            /** @description Invalid canvas, report or flow */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
             /** @description Unable to retrieve report with this id */
             404: {
                 headers: {
@@ -1319,6 +1920,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -1380,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"];
             };
@@ -1457,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;
                     };
                 };
             };
@@ -1513,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;
                     }[];
                 };
             };
@@ -1553,7 +2151,6 @@ declare interface operations {
                 content: {
                     "application/json": {
                         created_at: string;
-                        flow_id: string;
                         /**
                          * @deprecated
                          * @description Deprecated: use uuid.
@@ -1771,6 +2368,7 @@ declare interface operations {
             query?: never;
             header?: {
                 "sp-access-token"?: string;
+                "X-Application-Name"?: string;
             };
             path?: never;
             cookie?: never;
@@ -2036,6 +2634,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -2086,6 +2686,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         error: string;
+                        /** @enum {string} */
+                        code: "QUERY_LIMIT_EXCEEDED" | "QUERY_TIMEOUT" | "QUERY_EXECUTION_FAILED";
                     };
                 };
             };
@@ -2113,7 +2715,6 @@ declare interface operations {
                 content: {
                     "application/json": {
                         created_at: string;
-                        flow_id: string;
                         /**
                          * @deprecated
                          * @description Deprecated: use uuid.
@@ -2416,6 +3017,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 visualization_id: string;
             };
             cookie?: never;
@@ -2921,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;
                         }[];
                     }[];
                 };
@@ -3036,6 +3635,7 @@ declare interface operations {
             query?: never;
             header?: {
                 "sp-access-token"?: string;
+                "X-Application-Name"?: string;
             };
             path?: never;
             cookie?: never;
@@ -3136,24 +3736,79 @@ declare interface operations {
             };
         };
     };
-    listAgents: {
+    getAgentRunReports: {
         parameters: {
             query?: never;
             header?: {
                 "sp-access-token"?: string;
             };
-            path?: never;
+            path: {
+                id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description List of agents for the company */
+            /** @description Reports generated by this agent run */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Agent"][];
+                    "application/json": {
+                        created_at: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use uuid.
+                         */
+                        id: number;
+                        uuid: string;
+                        title: string;
+                        request: string | null;
+                        data_summary: {
+                            columns: {
+                                [key: string]: {
+                                    position?: number;
+                                    data_type: string;
+                                    null_count: number | null;
+                                    unique_count: number | null;
+                                    unique_percentage: number | null;
+                                    min_value?: number | null;
+                                    max_value?: number | null;
+                                    avg_value?: number | null;
+                                    median_value?: number | null;
+                                    std_value?: number | null;
+                                    min_date?: string | null;
+                                    max_date?: string | null;
+                                    min_length?: number | null;
+                                    max_length?: number | null;
+                                    avg_length?: number | null;
+                                } & {
+                                    [key: string]: unknown;
+                                };
+                            };
+                        } & {
+                            [key: string]: unknown;
+                        };
+                        status: string | null;
+                        is_removed: boolean;
+                        is_materialized: boolean | null;
+                        last_materialized_at: string | null;
+                        materialized_error_message: string | null;
+                        /** @enum {string|null} */
+                        materialized_status: "completed" | "running" | "failed" | null;
+                    }[];
+                };
+            };
+            /** @description Agent run not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
                 };
             };
             /** @description Internal server error */
@@ -3169,14 +3824,175 @@ declare interface operations {
             };
         };
     };
-    createAgent: {
+    getAgentRunVisualizations: {
         parameters: {
             query?: never;
             header?: {
                 "sp-access-token"?: string;
             };
-            path?: never;
-            cookie?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Visualizations generated by this agent run */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use uuid.
+                         */
+                        id: number;
+                        uuid: string;
+                        report_uuid: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use report_uuid.
+                         */
+                        flow_data_id: number;
+                        created_at: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use materialization.
+                         */
+                        flow_data?: {
+                            is_materialized: boolean | null;
+                            last_materialized_at: string | null;
+                            materialized_error_message: string | null;
+                            /** @enum {string|null} */
+                            materialized_status: "completed" | "running" | "failed" | null;
+                        };
+                        materialization?: {
+                            is_materialized: boolean | null;
+                            last_materialized_at: string | null;
+                            materialized_error_message: string | null;
+                            /** @enum {string|null} */
+                            materialized_status: "completed" | "running" | "failed" | null;
+                        };
+                        configuration: {
+                            /** @enum {string} */
+                            type: "bar";
+                            title: string;
+                            /** @enum {number} */
+                            config_version: 2;
+                            xAxisLabel: string;
+                            yAxisLabel: string;
+                            categoryColumn: string;
+                            secondaryCategoryColumn?: string;
+                            valueColumn: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "line/area";
+                            /** @enum {number} */
+                            config_version: 2;
+                            title: string;
+                            xAxisColumn: string;
+                            valueColumns: string[];
+                            yAxisLabels: string[];
+                        } | {
+                            /** @enum {string} */
+                            type: "line/area-categorical";
+                            title: string;
+                            /** @enum {number} */
+                            config_version: 2;
+                            valueColumn: string;
+                            xAxisColumn: string;
+                            xAxisLabel: string;
+                            yAxisLabel: string;
+                            categoryColumn: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "scatter";
+                            title: string;
+                            /** @enum {number} */
+                            config_version: 2;
+                            xAxisLabel: string;
+                            yAxisLabel: string;
+                            xAxisValueColumn: string;
+                            yAxisValueColumn: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "pie";
+                            title: string;
+                            /** @enum {number} */
+                            config_version: 2;
+                            categoryColumn: string;
+                            valueColumn: string;
+                        };
+                    }[];
+                };
+            };
+            /** @description Agent run not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
+    listAgents: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of agents for the company */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Agent"][];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
+    createAgent: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path?: never;
+            cookie?: never;
         };
         requestBody: {
             content: {
@@ -3247,8 +4063,6 @@ declare interface operations {
                      * @enum {string}
                      */
                     execution_platform?: "native" | "sandbox" | "sandbox_public";
-                    master_prompt_name?: string;
-                    master_prompt_version?: number;
                 };
             };
         };
@@ -3380,7 +4194,7 @@ declare interface operations {
                     })[] | null;
                     output_schema?: {
                         [key: string]: unknown;
-                    } | null;
+                    };
                     task_plan?: {
                         id: string;
                         title: string;
@@ -3408,8 +4222,6 @@ declare interface operations {
                     } | null;
                     /** @enum {string} */
                     execution_platform?: "native" | "sandbox" | "sandbox_public";
-                    master_prompt_name?: string | null;
-                    master_prompt_version?: number | null;
                 };
             };
         };
@@ -3507,6 +4319,99 @@ declare interface operations {
             };
         };
     };
+    listAgentVersions: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of versions for the agent (newest first) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgentVersion"][];
+                };
+            };
+            /** @description Agent not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
+    restoreAgentVersion: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path: {
+                id: string;
+                version: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The agent after restoring the version (new version created) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Agent"];
+                };
+            };
+            /** @description Agent or version not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
     listApplications: {
         parameters: {
             query?: never;
@@ -3807,8 +4712,12 @@ declare interface operations {
                         /** @description Schema or dataset name in the source database */
                         dataset: string;
                         table_name: string;
+                        /** @description Catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric). NULL otherwise. */
+                        database: string | null;
                         description: string | null;
                         is_visible: boolean;
+                        /** @description IDs of applications this table is linked to. Empty means no links. */
+                        application_ids: number[];
                         created_at: string;
                         updated_at: string;
                     }[];
@@ -3842,11 +4751,13 @@ declare interface operations {
                     /** @description Schema or dataset name in the source database */
                     dataset: string;
                     table_name: string;
+                    /** @description Optional catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric: [lakehouse].[schema].[table]). Leave unset for backends where the connection default catalog suffices. */
+                    database?: string | null;
                     /** @default true */
                     is_visible?: boolean;
                     /** @description Optional RLS policy to create alongside the table */
                     rls_policy?: {
-                        /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
+                        /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:dataset.name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
                         condition: string;
                         /** @default true */
                         is_active?: boolean;
@@ -3865,6 +4776,8 @@ declare interface operations {
                         /** @default true */
                         is_active?: boolean;
                     }[];
+                    /** @description IDs of applications to link this table to. Omitting or passing [] creates no links. */
+                    application_ids?: number[];
                 };
             };
         };
@@ -3880,8 +4793,12 @@ declare interface operations {
                         /** @description Schema or dataset name in the source database */
                         dataset: string;
                         table_name: string;
+                        /** @description Catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric). NULL otherwise. */
+                        database: string | null;
                         description: string | null;
                         is_visible: boolean;
+                        /** @description IDs of applications this table is linked to. Empty means no links. */
+                        application_ids: number[];
                         created_at: string;
                         updated_at: string;
                         columns: {
@@ -3955,12 +4872,157 @@ declare interface operations {
                 };
                 content: {
                     "application/json": {
-                        error: string;
+                        error: string;
+                    };
+                };
+            };
+            /** @description Table with this dataset and table_name already exists */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
+    createTablesBatch: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Schema or dataset name in the source database */
+                    dataset: string;
+                    table_name: string;
+                    /** @description Optional catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric: [lakehouse].[schema].[table]). Leave unset for backends where the connection default catalog suffices. */
+                    database?: string | null;
+                    /** @default true */
+                    is_visible?: boolean;
+                    /** @description Optional RLS policy to create alongside the table */
+                    rls_policy?: {
+                        /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:dataset.name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
+                        condition: string;
+                        /** @default true */
+                        is_active?: boolean;
+                    };
+                    /** @description Optional access rules to create alongside the table */
+                    access?: {
+                        /** @description Top-level field name in the user metadata (e.g., company_id, department_name) */
+                        context_variable: string;
+                        /**
+                         * @description Comparison operator. Must be "=" or "!=".
+                         * @enum {string}
+                         */
+                        operator: "=" | "!=";
+                        /** @description Static value to compare against, e.g. `user_123`. */
+                        value: string;
+                        /** @default true */
+                        is_active?: boolean;
+                    }[];
+                    /** @description IDs of applications to link this table to. Omitting or passing [] creates no links. */
+                    application_ids?: number[];
+                }[];
+            };
+        };
+        responses: {
+            /** @description Batch creation results. Each item indicates whether the table was created or failed, with per-table error details. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        results: ({
+                            /** @enum {string} */
+                            status: "created";
+                            dataset: string;
+                            table_name: string;
+                            table: {
+                                id: number;
+                                /** @description Schema or dataset name in the source database */
+                                dataset: string;
+                                table_name: string;
+                                /** @description Catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric). NULL otherwise. */
+                                database: string | null;
+                                description: string | null;
+                                is_visible: boolean;
+                                /** @description IDs of applications this table is linked to. Empty means no links. */
+                                application_ids: number[];
+                                created_at: string;
+                                updated_at: string;
+                                columns: {
+                                    id: number;
+                                    table_id: number;
+                                    name: string;
+                                    data_type: string | null;
+                                    description: string | null;
+                                    /** @description Whether this column is visible to end users */
+                                    is_visible: boolean;
+                                    /** @description Whether this column is indexed for search and filtering */
+                                    is_indexed: boolean;
+                                    created_at: string;
+                                    updated_at: string;
+                                }[];
+                                rls_policy: {
+                                    id: number;
+                                    table_id: number;
+                                    /** @description SQL condition appended to queries on this table to restrict row access */
+                                    condition: string;
+                                    /** @description Variables referenced in the condition, resolved from user context at query time */
+                                    context_variables: string[];
+                                    /** @description Other tables referenced by this policy's condition (for query planning) */
+                                    depends_on_tables: string[];
+                                    is_active: boolean;
+                                    created_at: string;
+                                    updated_at: string;
+                                } | null;
+                                access: {
+                                    id: number;
+                                    table_id: number;
+                                    /** @description Top-level field name in the user metadata (e.g., company_id, department_name) */
+                                    context_variable: string;
+                                    /** @description Comparison operator. Must be "=" or "!=". */
+                                    operator: string;
+                                    /** @description Static value to compare against, e.g. `user_123`. */
+                                    value: string;
+                                    is_active: boolean;
+                                    created_at: string;
+                                    updated_at: string;
+                                }[];
+                            };
+                        } | {
+                            /** @enum {string} */
+                            status: "failed";
+                            dataset: string;
+                            table_name: string;
+                            error: string;
+                        })[];
                     };
                 };
             };
-            /** @description Table with this dataset and table_name already exists */
-            409: {
+            /** @description Invalid request (e.g. empty array or exceeds 50 items) */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -4007,8 +5069,12 @@ declare interface operations {
                         /** @description Schema or dataset name in the source database */
                         dataset: string;
                         table_name: string;
+                        /** @description Catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric). NULL otherwise. */
+                        database: string | null;
                         description: string | null;
                         is_visible: boolean;
+                        /** @description IDs of applications this table is linked to. Empty means no links. */
+                        application_ids: number[];
                         created_at: string;
                         updated_at: string;
                         columns: {
@@ -4144,7 +5210,7 @@ declare interface operations {
                     is_visible?: boolean;
                     /** @description Upsert the RLS policy: updates existing if found, creates if not (condition required for create) */
                     rls_policy?: {
-                        /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
+                        /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:dataset.name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
                         condition?: string;
                         /** @default true */
                         is_active?: boolean;
@@ -4163,6 +5229,8 @@ declare interface operations {
                         /** @default true */
                         is_active?: boolean;
                     }[];
+                    /** @description Replace table-to-application links. Empty array clears all links. */
+                    application_ids?: number[];
                 };
             };
         };
@@ -4178,8 +5246,12 @@ declare interface operations {
                         /** @description Schema or dataset name in the source database */
                         dataset: string;
                         table_name: string;
+                        /** @description Catalog/lakehouse name for backends with a 3-level namespace (e.g. Microsoft Fabric). NULL otherwise. */
+                        database: string | null;
                         description: string | null;
                         is_visible: boolean;
+                        /** @description IDs of applications this table is linked to. Empty means no links. */
+                        application_ids: number[];
                         created_at: string;
                         updated_at: string;
                         columns: {
@@ -4331,7 +5403,7 @@ declare interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
+                    /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:dataset.name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
                     condition: string;
                     /** @default true */
                     is_active?: boolean;
@@ -4518,7 +5590,7 @@ declare interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
+                    /** @description SQL condition appended to queries on this table to restrict row access. Use [var:name] for context variables and [table:dataset.name] for table references — these are auto-detected and stored as context_variables and depends_on_tables. */
                     condition?: string;
                     is_active?: boolean;
                 };
@@ -5118,6 +6190,7 @@ declare interface operations {
             query?: never;
             header?: {
                 "sp-access-token"?: string;
+                "X-Application-Name"?: string;
             };
             path?: never;
             cookie?: never;
@@ -5265,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>;
@@ -5803,6 +6878,38 @@ declare interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/agent-runs/{id}/reports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getAgentRunReports"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/agent-runs/{id}/visualizations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getAgentRunVisualizations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/agents": {
         parameters: {
             query?: never;
@@ -5835,6 +6942,38 @@ declare interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/agents/{id}/versions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["listAgentVersions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/agents/{id}/versions/{version}/restore": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["restoreAgentVersion"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/applications": {
         parameters: {
             query?: never;
@@ -5883,6 +7022,22 @@ declare interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/tables/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["createTablesBatch"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/tables/{id}": {
         parameters: {
             query?: never;
@@ -6029,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;
@@ -6053,12 +7231,98 @@ 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<{
         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>;
@@ -6093,7 +7357,9 @@ declare const redactedOutputSchema_2: 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>;
@@ -6181,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<{
@@ -6189,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>;
 }>;
@@ -6211,6 +7530,8 @@ declare type RemoveParamsConfig = Simplify<{
     cookie?: string;
 }>;
 
+export declare type ReportData = z.infer<typeof ReportDataSchema>;
+
 declare type ReportDataFilters = {
     columns?: string[];
     limit: number;
@@ -6219,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;
@@ -6229,11 +7561,34 @@ declare const SignalWithReportIdSchema: z.ZodObject<{
     reportId: z.ZodNumber;
 }, z.core.$strip>;
 
-declare type SortingState = ColumnSort[];
+export declare type SortingState = ColumnSort[];
+
+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 TableFilters = Record<string, TableFilterValue>;
+export declare type TableFilters = Record<string, TableFilterValue>;
 
-declare type TableFilterValue = z.infer<typeof TableFilterValueSchema>;
+export declare type TableFilterValue = z.infer<typeof TableFilterValueSchema>;
 
 declare const TableFilterValueSchema: z.ZodObject<{
     operator: z.ZodEnum<{
@@ -6252,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
  */
@@ -6261,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>>>;
@@ -6289,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 { }