@magemetrics/ai 0.0.58 → 0.1.0

package/dist/web-component/index.d.ts

@@ -0,0 +1,1423 @@
+import { AuthState } from '@magemetrics/core';
+import { CreateFlowParam } from '@magemetrics/core';
+import { default as default_2 } from 'react';
+import { FetchNextPageOptions } from '@tanstack/react-query';
+import { ForwardRefExoticComponent } from 'react';
+import { GenerateInsightParam } from '@magemetrics/core';
+import { InfiniteData } from '@tanstack/react-query';
+import { InfiniteQueryObserverResult } from '@tanstack/react-query';
+import { MageMetricsClient } from '@magemetrics/core';
+import { MageMetricsClientConfig } from '@magemetrics/core';
+import { PropsWithChildren } from 'react';
+import { RefAttributes } from 'react';
+import { SortingState } from '@tanstack/react-table';
+import { UseMutateAsyncFunction } from '@tanstack/react-query';
+import { UseMutateFunction } from '@tanstack/react-query';
+import { UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryResult } from '@tanstack/react-query';
+import { z } from 'zod';
+
+export { AuthState }
+
+export declare type CellContentProps = {
+    formattedValue: FormattedData | undefined;
+    unit?: string;
+    renderType?: string;
+};
+
+export declare const Chat: React.FC<ConversationContentProps>;
+
+export declare const ChatLayoutProvider: default_2.FC<{
+    children: default_2.ReactNode;
+}>;
+
+export declare interface Components {
+    dataTableCells?: {
+        empty?: (props: CellContentProps) => default_2.ReactNode;
+        units?: {
+            [key: string]: (props: CellContentProps) => default_2.ReactNode;
+        };
+        renderTypes?: {
+            [key: string]: (props: CellContentProps) => default_2.ReactNode;
+        };
+    };
+    dataReportTable?: (props: DataReportMessageProps) => default_2.ReactNode;
+    messageActions?: (props: {
+        type: "data-report";
+        report: FrontendReport;
+    } | {
+        type: "visualization";
+        visualization: FrontendVisualization | V1FrontendVisualization;
+    }) => default_2.ReactNode;
+    avatar?: default_2.ReactNode;
+}
+
+declare type ControlledModalProps = {
+    visible: boolean;
+    onClose: () => void;
+};
+
+export declare const ConversationContent: React.FC<ConversationContentProps>;
+
+declare interface ConversationContentProps {
+    flowId?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    topBar?: React.ReactNode;
+}
+
+export { CreateFlowParam }
+
+export declare const Dashboard: React.FC<React.ComponentProps<typeof Dashboard_2>>;
+
+declare const Dashboard_2: React.FC<{
+    dashboardId: string;
+}>;
+
+export declare const DataReport: React.FC<{
+    reportId: number;
+}>;
+
+export declare interface DataReportMessageProps {
+    report: FrontendReport;
+    explainability: FrontendReportExplainability | null | undefined;
+    infiniteData: {
+        data?: {
+            pages: Record<string, unknown>[][];
+        };
+        isPending: boolean;
+        fetchNextPage: () => Promise<unknown>;
+        isFetching: boolean;
+        isFetchingNextPage: boolean;
+        hasNextPage: boolean | undefined;
+    };
+    columns: FrontendReportColumns;
+    totalRows: number;
+}
+
+export declare const DataTable: React.FC<DataReportMessageProps>;
+
+declare type DisplayControlProps = {
+    showRecommendations?: boolean;
+    showRecentChats?: boolean;
+    showBackdrop?: boolean;
+};
+
+export declare const DomWrapper: React.FC<PropsWithChildren<DomWrapperProps>>;
+
+declare type DomWrapperProps = {
+    display?: string;
+};
+
+declare type ExportReportDataParams = {
+    reportId: number;
+    filename?: string;
+    format?: "text" | "blob";
+};
+
+declare type ExportReportDataResult = {
+    filename: string;
+    data: Blob | string;
+};
+
+declare type ExtractInsightResponse = z.infer<typeof ExtractInsightResponseSchema>;
+
+declare const ExtractInsightResponseSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    insight: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    insight: string;
+}, {
+    type: "text";
+    insight: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"missing">;
+}, "strip", z.ZodTypeAny, {
+    type: "missing";
+}, {
+    type: "missing";
+}>]>;
+
+/**
+ * This module handles the formatting and normalization of table cell values for display and sorting.
+ *
+ * Problem:
+ * When displaying data in tables, we often receive values in various formats (strings, dates,
+ * JSON objects, etc.). We need to:
+ * 1. Display these values in a consistent, human-readable format
+ * 2. Enable proper sorting of these values regardless of their original format
+ *
+ * Solution:
+ * The FormattedData type and formatCellValue function transform any input value into a
+ * standardized format with two properties:
+ * - display: A string representation suitable for rendering
+ * - sortValue: A normalized value (string/number/date) suitable for consistent sorting
+ *
+ * The module handles various special cases:
+ * - JSON strings (parsing them to extract actual values)
+ * - Date/time values (converting to consistent format)
+ * - BigQuery-style objects with 'value' property
+ * - Nested objects (pretty-printing them)
+ * - Null/undefined values
+ */
+declare type FormattedData = {
+    display: (string & {}) | "empty" | null;
+    sortValue: string | number | Date | null;
+};
+
+declare type FrontendReport = z.infer<typeof FrontendReportSchema>;
+
+declare type FrontendReportColumns = z.infer<typeof FrontendReportColumnsSchema>;
+
+declare const FrontendReportColumnsSchema: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    data_type: z.ZodString;
+} & {
+    dataType: z.ZodString;
+    renderType: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    data_type: string;
+    dataType: string;
+    unit?: string | undefined;
+    renderType?: string | undefined;
+}, {
+    name: string;
+    data_type: string;
+    dataType: string;
+    unit?: string | undefined;
+    renderType?: string | undefined;
+}>, "many">;
+
+declare type FrontendReportExplainability = z.infer<typeof FrontendReportExplainabilitySchema>;
+
+declare const FrontendReportExplainabilitySchema: z.ZodObject<Omit<{
+    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;
+        }, "strip", z.ZodTypeAny, {
+            explanation: string;
+            sql: string;
+        }, {
+            explanation: string;
+            sql: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        chunk_title: string;
+        chunk_explanation: string;
+        lines: {
+            explanation: string;
+            sql: string;
+        }[];
+    }, {
+        chunk_title: string;
+        chunk_explanation: string;
+        lines: {
+            explanation: string;
+            sql: string;
+        }[];
+    }>, "many">>>;
+    business_explanation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodString;
+        implementation: z.ZodArray<z.ZodString, "many">;
+        assumptions: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["grain", "completeness", "transformation", "relationship", "other"]>;
+            details: z.ZodString;
+            explanation: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            explanation: string;
+            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+            details: string;
+        }, {
+            explanation: string;
+            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+            details: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        implementation: string[];
+        summary: string;
+        assumptions: {
+            explanation: string;
+            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+            details: string;
+        }[];
+    }, {
+        implementation: string[];
+        summary: string;
+        assumptions: {
+            explanation: string;
+            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+            details: string;
+        }[];
+    }>>>;
+    columns_lineage: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<["entity", "attribute", "filter", "process", "combine", "result"]>;
+            explanation: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            explanation: string;
+            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
+            id: string;
+        }, {
+            explanation: string;
+            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
+            id: string;
+        }>, "many">;
+        edges: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            target: string;
+        }, {
+            source: string;
+            target: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        nodes: {
+            explanation: string;
+            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
+            id: string;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+        }[];
+    }, {
+        nodes: {
+            explanation: string;
+            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
+            id: string;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+        }[];
+    }>>>>;
+    confidence_score: z.ZodNumber;
+    confidence_score_reason: 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>;
+    id: z.ZodNumber;
+    flow_data_id: z.ZodNumber;
+    created_at: z.ZodString;
+}, "id" | "created_at">, "strip", z.ZodTypeAny, {
+    flow_data_id: number;
+    confidence_score: number;
+    confidence_score_reason: string;
+    sql_explanation?: {
+        chunk_title: string;
+        chunk_explanation: string;
+        lines: {
+            explanation: string;
+            sql: string;
+        }[];
+    }[] | null | undefined;
+    business_explanation?: {
+        implementation: string[];
+        summary: string;
+        assumptions: {
+            explanation: string;
+            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+            details: string;
+        }[];
+    } | null | undefined;
+    columns_lineage?: Record<string, {
+        nodes: {
+            explanation: string;
+            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
+            id: string;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+        }[];
+    }> | null | undefined;
+    assumptions_score?: number | undefined;
+    assumptions_score_reason?: string | undefined;
+    friendliness_score?: number | undefined;
+    friendliness_score_reason?: string | undefined;
+}, {
+    flow_data_id: number;
+    confidence_score: number;
+    confidence_score_reason: string;
+    sql_explanation?: {
+        chunk_title: string;
+        chunk_explanation: string;
+        lines: {
+            explanation: string;
+            sql: string;
+        }[];
+    }[] | null | undefined;
+    business_explanation?: {
+        implementation: string[];
+        summary: string;
+        assumptions: {
+            explanation: string;
+            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+            details: string;
+        }[];
+    } | null | undefined;
+    columns_lineage?: Record<string, {
+        nodes: {
+            explanation: string;
+            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
+            id: string;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+        }[];
+    }> | null | undefined;
+    assumptions_score?: number | undefined;
+    assumptions_score_reason?: string | undefined;
+    friendliness_score?: number | undefined;
+    friendliness_score_reason?: string | undefined;
+}>;
+
+declare const FrontendReportSchema: z.ZodObject<Omit<{
+    created_at: z.ZodString;
+    flow_id: z.ZodString;
+    id: z.ZodNumber;
+    is_sample: z.ZodBoolean;
+    schema: z.ZodString;
+    sql: z.ZodString;
+    table: z.ZodString;
+    title: z.ZodString;
+    request: z.ZodNullable<z.ZodString>;
+    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    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>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        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>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        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>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    bookmarked: z.ZodBoolean;
+    status: z.ZodNullable<z.ZodString>;
+}, "schema" | "sql" | "table" | "data_sample" | "is_sample">, "strip", z.ZodTypeAny, {
+    title: string;
+    status: string | null;
+    id: number;
+    request: string | null;
+    created_at: string;
+    bookmarked: boolean;
+    data_summary: {
+        columns: Record<string, z.objectOutputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">>;
+    } & {
+        [k: string]: unknown;
+    };
+    flow_id: string;
+}, {
+    title: string;
+    status: string | null;
+    id: number;
+    request: string | null;
+    created_at: string;
+    bookmarked: boolean;
+    data_summary: {
+        columns: Record<string, z.objectInputType<{
+            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>;
+        }, z.ZodTypeAny, "passthrough">>;
+    } & {
+        [k: string]: unknown;
+    };
+    flow_id: string;
+}>;
+
+declare type FrontendVisualization = z.output<typeof FrontendVisualizationSchema>;
+
+declare const FrontendVisualizationSchema: z.ZodObject<Omit<{
+    id: z.ZodNumber;
+    flow_data_id: z.ZodNumber;
+    created_at: z.ZodString;
+    sql: z.ZodString;
+    bookmarked: z.ZodBoolean;
+    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    is_sample: z.ZodBoolean;
+    data_summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+} & {
+    configuration: z.ZodDiscriminatedUnion<"type", [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">;
+    }, "strip", z.ZodTypeAny, {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        secondaryCategoryColumn?: string | undefined;
+    }, {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        secondaryCategoryColumn?: string | undefined;
+    }>, z.ZodObject<{
+        xAxisColumn: z.ZodString;
+        valueColumns: z.ZodArray<z.ZodString, "many">;
+        yAxisLabels: z.ZodArray<z.ZodString, "many">;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area">;
+        config_version: z.ZodLiteral<2>;
+    }, "strip", z.ZodTypeAny, {
+        type: "line/area";
+        title: string;
+        valueColumns: string[];
+        config_version: 2;
+        xAxisColumn: string;
+        yAxisLabels: string[];
+    }, {
+        type: "line/area";
+        title: string;
+        valueColumns: string[];
+        config_version: 2;
+        xAxisColumn: string;
+        yAxisLabels: string[];
+    }>, 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">;
+    }, "strip", z.ZodTypeAny, {
+        type: "line/area-categorical";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        xAxisColumn: string;
+    }, {
+        type: "line/area-categorical";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        xAxisColumn: string;
+    }>, 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">;
+    }, "strip", z.ZodTypeAny, {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        xAxisValueColumn: string;
+        yAxisValueColumn: string;
+    }, {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        xAxisValueColumn: string;
+        yAxisValueColumn: string;
+    }>, z.ZodObject<{
+        config_version: z.ZodLiteral<2>;
+        categoryColumn: z.ZodString;
+        valueColumn: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"pie">;
+    }, "strip", z.ZodTypeAny, {
+        type: "pie";
+        title: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+    }, {
+        type: "pie";
+        title: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+    }>]>;
+}, "sql" | "data_sample" | "is_sample" | "data_summary">, "strip", z.ZodTypeAny, {
+    id: number;
+    flow_data_id: number;
+    created_at: string;
+    bookmarked: boolean;
+    configuration: {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        secondaryCategoryColumn?: string | undefined;
+    } | {
+        type: "line/area";
+        title: string;
+        valueColumns: string[];
+        config_version: 2;
+        xAxisColumn: string;
+        yAxisLabels: string[];
+    } | {
+        type: "line/area-categorical";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        xAxisColumn: string;
+    } | {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        xAxisValueColumn: string;
+        yAxisValueColumn: string;
+    } | {
+        type: "pie";
+        title: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+    };
+}, {
+    id: number;
+    flow_data_id: number;
+    created_at: string;
+    bookmarked: boolean;
+    configuration: {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        secondaryCategoryColumn?: string | undefined;
+    } | {
+        type: "line/area";
+        title: string;
+        valueColumns: string[];
+        config_version: 2;
+        xAxisColumn: string;
+        yAxisLabels: string[];
+    } | {
+        type: "line/area-categorical";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+        xAxisColumn: string;
+    } | {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        config_version: 2;
+        xAxisValueColumn: string;
+        yAxisValueColumn: string;
+    } | {
+        type: "pie";
+        title: string;
+        config_version: 2;
+        categoryColumn: string;
+        valueColumn: string;
+    };
+}>;
+
+export { GenerateInsightParam }
+
+export declare const InfiniteDataTableUI: React.FC<InfiniteDataTableUIProps>;
+
+declare type InfiniteDataTableUIProps = {
+    flowDataId: number;
+    data: Record<string, unknown>[];
+    columns: FrontendReportColumns;
+    explainability: FrontendReportExplainability | null | undefined;
+    hasNextPage: boolean | undefined;
+    fetchNextPage: () => Promise<unknown>;
+    isFetchingNextPage: boolean;
+    isFetching: boolean;
+    totalRows: number;
+};
+
+export declare const logout: () => Promise<void>;
+
+export { MageMetricsClient }
+
+export { MageMetricsClientConfig }
+
+export declare const MageMetricsContextProvider: default_2.FC<MageMetricsContextProviderProps & MageMetricsPublicContextProviderProps>;
+
+export declare type MageMetricsContextProviderProps = PropsWithChildren<MageMetricsClientConfig>;
+
+export declare const MageMetricsPublicContextProvider: default_2.FC<MageMetricsPublicContextProviderProps>;
+
+declare type MageMetricsPublicContextProviderProps = PropsWithChildren<Pick<MageMetricsClientConfig, "apiUrl" | "apiKey"> & {
+    experimental_components?: Components;
+}>;
+
+export declare const ManagedModal: React.FC<ManagedModalProps>;
+
+declare interface ManagedModalProps extends ModalProps {
+    apiKey: string;
+    externalJwt: string;
+    apiUrl: string;
+    persist?: PersistenceOptions;
+    experimental_components?: Components;
+}
+
+declare interface ModalProps {
+    display?: string;
+    modal?: ControlledModalProps;
+    startOptions?: StartOptions;
+}
+
+declare type PersistenceOptions = "queryParam" | "none";
+
+export declare const PublicDashboard: React.FC<React.ComponentProps<typeof Dashboard_2>>;
+
+export declare const PublicDataReport: React.FC<{
+    dashboardId: string;
+    reportId: number;
+}>;
+
+declare type ReportDataFilters = {
+    columns?: string[];
+    limit: number;
+    sorting: SortingState;
+    filters: TableFilters;
+    cursor?: number;
+};
+
+export declare const StandaloneConversationModal: React.FC<StandaloneConversationModalProps>;
+
+declare type StandaloneConversationModalProps = {
+    opened: boolean;
+    flowId: string;
+    onOpenChange?: (open: boolean) => void;
+};
+
+declare type StartOptions = DisplayControlProps & {
+    label?: string;
+    recommendationsLabel?: string;
+    placeholders?: string[];
+};
+
+declare type TableFilters = Record<string, string | number>;
+
+export declare const useCreateFlow: (options?: UseMutationOptions<{
+    flowId: string;
+}, Error, CreateFlowParam>) => {
+    createFlow: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    createFlowAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    isCreatingFlow: boolean;
+    data: undefined;
+    variables: undefined;
+    error: null;
+    isError: false;
+    isIdle: true;
+    isPending: false;
+    isSuccess: false;
+    status: "idle";
+    mutate: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+} | {
+    createFlow: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    createFlowAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    isCreatingFlow: boolean;
+    data: undefined;
+    variables: CreateFlowParam;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isPending: true;
+    isSuccess: false;
+    status: "pending";
+    mutate: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+} | {
+    createFlow: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    createFlowAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    isCreatingFlow: boolean;
+    data: undefined;
+    error: Error;
+    variables: CreateFlowParam;
+    isError: true;
+    isIdle: false;
+    isPending: false;
+    isSuccess: false;
+    status: "error";
+    mutate: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+} | {
+    createFlow: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    createFlowAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    isCreatingFlow: boolean;
+    data: {
+        flowId: string;
+    };
+    error: null;
+    variables: CreateFlowParam;
+    isError: false;
+    isIdle: false;
+    isPending: false;
+    isSuccess: true;
+    status: "success";
+    mutate: UseMutateFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        flowId: string;
+    }, Error, CreateFlowParam, unknown>;
+};
+
+export declare const useDataReport: (flowDataId: FrontendReport["id"]) => {
+    dataColumns: {
+        name: string;
+        data_type: string;
+        dataType: string;
+        renderType?: string;
+        unit?: string;
+    }[] | undefined;
+    isPendingColumns: boolean;
+    isPendingData: boolean;
+    fetchNextPage: (options?: FetchNextPageOptions) => Promise<InfiniteQueryObserverResult<InfiniteData<Record<string, unknown>[], unknown>, Error>>;
+    isFetching: boolean;
+    isFetchingNextPage: boolean;
+    hasNextPage: boolean;
+    allData: Record<string, unknown>[];
+    explainability: {
+        sql_explanation?: {
+            chunk_title: string;
+            chunk_explanation: string;
+            lines: {
+                sql: string;
+                explanation: string;
+            }[];
+        }[] | null;
+        business_explanation?: {
+            summary: string;
+            implementation: string[];
+            assumptions: {
+                type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+                details: string;
+                explanation: string;
+            }[];
+        } | null;
+        columns_lineage?: {
+            [key: string]: {
+                nodes: {
+                    id: string;
+                    type: "entity" | "attribute" | "filter" | "process" | "combine" | "result";
+                    explanation: string;
+                }[];
+                edges: {
+                    source: string;
+                    target: string;
+                }[];
+            };
+        } | null;
+        confidence_score: number;
+        confidence_score_reason: string;
+        assumptions_score?: number;
+        assumptions_score_reason?: string;
+        friendliness_score?: number;
+        friendliness_score_reason?: string;
+        flow_data_id: number;
+    } | null | undefined;
+    totalRows: number;
+    infiniteData: InfiniteData<Record<string, unknown>[], unknown> | undefined;
+};
+
+export declare const useDataReportColumnValue: (reportId: number, filters: ReportDataFilters) => UseQueryResult<Record<string, unknown>[], Error>;
+
+export declare const useDownloadReportData: (options?: UseMutationOptions<ExportReportDataResult, Error, ExportReportDataParams>) => {
+    download: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    data: undefined;
+    variables: undefined;
+    error: null;
+    isError: false;
+    isIdle: true;
+    isPending: false;
+    isSuccess: false;
+    status: "idle";
+    mutate: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+} | {
+    download: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    data: undefined;
+    variables: ExportReportDataParams;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isPending: true;
+    isSuccess: false;
+    status: "pending";
+    mutate: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+} | {
+    download: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    data: undefined;
+    error: Error;
+    variables: ExportReportDataParams;
+    isError: true;
+    isIdle: false;
+    isPending: false;
+    isSuccess: false;
+    status: "error";
+    mutate: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+} | {
+    download: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    data: ExportReportDataResult;
+    error: null;
+    variables: ExportReportDataParams;
+    isError: false;
+    isIdle: false;
+    isPending: false;
+    isSuccess: true;
+    status: "success";
+    mutate: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
+};
+
+export declare const useGenerateContextualInsight: (options?: UseMutationOptions<ExtractInsightResponse, Error, GenerateInsightParam>) => {
+    generateInsight: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    generateInsightAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    data: undefined;
+    variables: undefined;
+    error: null;
+    isError: false;
+    isIdle: true;
+    isPending: false;
+    isSuccess: false;
+    status: "idle";
+    mutate: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+} | {
+    generateInsight: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    generateInsightAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    data: undefined;
+    variables: GenerateInsightParam;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isPending: true;
+    isSuccess: false;
+    status: "pending";
+    mutate: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+} | {
+    generateInsight: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    generateInsightAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    data: undefined;
+    error: Error;
+    variables: GenerateInsightParam;
+    isError: true;
+    isIdle: false;
+    isPending: false;
+    isSuccess: false;
+    status: "error";
+    mutate: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+} | {
+    generateInsight: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    generateInsightAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    data: {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    };
+    error: null;
+    variables: GenerateInsightParam;
+    isError: false;
+    isIdle: false;
+    isPending: false;
+    isSuccess: true;
+    status: "success";
+    mutate: UseMutateFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+    mutateAsync: UseMutateAsyncFunction<    {
+        type: "text";
+        insight: string;
+    } | {
+        type: "missing";
+    }, Error, GenerateInsightParam, unknown>;
+};
+
+export declare const useMageMetricsApiUrl: () => string;
+
+export declare const useMageMetricsClient: () => MageMetricsClient | undefined;
+
+export declare const useMageMetricsReady: () => false | MageMetricsClient | undefined;
+
+export declare const useRecentFlows: (limit?: number) => UseQueryResult<    {
+    id: string;
+    request: string;
+    created_at: string;
+    user_id: string | null;
+}[], Error>;
+
+declare type V1FrontendVisualization = z.output<typeof V1FrontendVisualizationSchema>;
+
+declare const V1FrontendVisualizationSchema: z.ZodObject<Omit<{
+    id: z.ZodNumber;
+    flow_data_id: z.ZodNumber;
+    created_at: z.ZodString;
+    sql: z.ZodString;
+    bookmarked: z.ZodBoolean;
+    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    is_sample: z.ZodBoolean;
+    data_summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+} & {
+    configuration: z.ZodDiscriminatedUnion<"type", [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, "many">>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"bar">;
+    }, "strip", z.ZodTypeAny, {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    }, {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    }>, 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, "many">>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"line/area">;
+    }, "strip", z.ZodTypeAny, {
+        type: "line/area";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    }, {
+        type: "line/area";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    }>, 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, "many">>;
+        title: z.ZodString;
+        type: z.ZodLiteral<"scatter">;
+    }, "strip", z.ZodTypeAny, {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    }, {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    }>, z.ZodObject<{
+        nameKey: z.ZodString;
+        dataKey: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"pie">;
+    }, "strip", z.ZodTypeAny, {
+        type: "pie";
+        title: string;
+        nameKey: string;
+        dataKey: string;
+    }, {
+        type: "pie";
+        title: string;
+        nameKey: string;
+        dataKey: string;
+    }>]>;
+}, "sql" | "data_sample" | "is_sample" | "data_summary">, "strip", z.ZodTypeAny, {
+    id: number;
+    flow_data_id: number;
+    created_at: string;
+    bookmarked: boolean;
+    configuration: {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    } | {
+        type: "line/area";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    } | {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    } | {
+        type: "pie";
+        title: string;
+        nameKey: string;
+        dataKey: string;
+    };
+}, {
+    id: number;
+    flow_data_id: number;
+    created_at: string;
+    bookmarked: boolean;
+    configuration: {
+        type: "bar";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    } | {
+        type: "line/area";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    } | {
+        type: "scatter";
+        title: string;
+        xAxisLabel: string;
+        yAxisLabel: string;
+        valueColumns?: string[] | undefined;
+        xAxisDataKey?: string | undefined;
+        yAxisDataKey?: string | undefined;
+        dimensionDataKey?: string | undefined;
+    } | {
+        type: "pie";
+        title: string;
+        nameKey: string;
+        dataKey: string;
+    };
+}>;
+
+export declare const Visualization: ForwardRefExoticComponent<    {
+    visualizationId: number;
+    withTitle: boolean;
+} & RefAttributes<HTMLDivElement>>;
+
+export { }