@magemetrics/core 0.11.6 → 0.12.0

package/dist/index.d.ts

@@ -152,7 +152,13 @@ declare interface components {
             [key: string]: unknown;
         }[];
         VisualizationWithData: {
+            /**
+             * @deprecated
+             * @description Deprecated: use uuid.
+             */
             id: number;
+            uuid: string;
+            report_uuid: string;
             flow_data_id: number;
             created_at: string;
             flow_data?: {
@@ -219,7 +225,13 @@ declare interface components {
                 sampledCount: number;
             };
         } | {
+            /**
+             * @deprecated
+             * @description Deprecated: use uuid.
+             */
             id: number;
+            uuid: string;
+            report_uuid: string;
             flow_data_id: number;
             created_at: string;
             flow_data?: {
@@ -297,7 +309,7 @@ declare interface components {
             /** Format: uuid */
             flow_id: string | null;
             /** @enum {string} */
-            status: "pending" | "running" | "completed" | "failed" | "cancelled";
+            status: "pending" | "running" | "post_processing" | "completed" | "failed" | "cancelled";
             created_at: string;
             started_at: string | null;
             completed_at: string | null;
@@ -419,6 +431,11 @@ declare interface components {
                 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";
@@ -426,8 +443,10 @@ declare interface components {
                 effort?: "low" | "medium" | "high";
             } | {
                 /** @enum {string} */
-                model: "claude-haiku-4-5";
+                model: "claude-haiku-4-5" | "claude-opus-4-5";
             } | null;
+            /** @enum {string} */
+            execution_platform: "native" | "sandbox" | "sandbox_public";
             master_prompt_name: string | null;
             master_prompt_version: number | null;
             created_at: string;
@@ -484,27 +503,12 @@ declare const CreateCanvasSchema: z.ZodObject<{
     flow_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-/**
- * A file attachment to include in the first message of a flow.
- *
- * Structurally compatible with the AI SDK's `FileUIPart`, so the output of
- * `useFileUpload().getFileParts()` can be passed directly — no mapping needed.
- */
-declare type CreateFlowFile = default_2.infer<typeof CreateFlowFileSchema>;
-
-declare const CreateFlowFileSchema: z.ZodObject<{
-    type: z.ZodLiteral<"file">;
-    mediaType: z.ZodString;
-    filename: z.ZodOptional<z.ZodString>;
-    url: z.ZodString;
-}, z.core.$strip>;
-
 /**
  * Parameters for starting a flow
  */
 export declare type CreateFlowParam = {
     query: string;
-    files?: CreateFlowFile[];
+    uploadedFileIds?: UploadedFileId[];
 } | {
     triggerId: string;
     variables: Record<string, string>;
@@ -621,6 +625,9 @@ 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 const getPublicApiClient: (apiUrl: string, apiKey: string) => Client<PublicPaths>;
@@ -631,11 +638,6 @@ declare const inputSchema: z.ZodObject<{
     rawRequest: z.ZodString;
     userRequest: z.ZodString;
     isNewAnalysisGoal: z.ZodBoolean;
-    responseType: z.ZodEnum<{
-        text: "text";
-        visualization: "visualization";
-        table: "table";
-    }>;
     difficultyLevel: z.ZodEnum<{
         simple: "simple";
         moderate: "moderate";
@@ -750,6 +752,8 @@ export declare class MageMetricsClient {
     api: {
         getFlowVisualizations: (flowId: string) => Promise<{
             id: number;
+            uuid: string;
+            report_uuid: string;
             flow_data_id: number;
             created_at: string;
             flow_data?: {
@@ -803,6 +807,7 @@ export declare class MageMetricsClient {
             created_at: string;
             flow_id: string;
             id: number;
+            uuid: string;
             title: string;
             request: string | null;
             data_summary: {
@@ -842,6 +847,9 @@ export declare class MageMetricsClient {
             title: string | null;
             user_id: string | null;
             application_id?: number | null | undefined;
+            context_tokens?: number | undefined;
+            acc_input_tokens?: number | undefined;
+            acc_output_tokens?: number | undefined;
         }>;
         getRecentFlows: (params?: {
             limit?: number;
@@ -849,6 +857,13 @@ export declare class MageMetricsClient {
         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;
@@ -863,6 +878,9 @@ export declare class MageMetricsClient {
                     title: string | null;
                     user_id: string | null;
                     application_id?: number | null | undefined;
+                    context_tokens?: number | undefined;
+                    acc_input_tokens?: number | undefined;
+                    acc_output_tokens?: number | undefined;
                 }[];
             }[]>;
             get: (canvasId: string) => Promise<{
@@ -1096,6 +1114,7 @@ declare interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
                 canvas_id: components["schemas"]["CanvasId"];
             };
@@ -1148,6 +1167,7 @@ declare interface operations {
             };
             header?: never;
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
                 canvas_id: components["schemas"]["CanvasId"];
             };
@@ -1193,6 +1213,7 @@ declare interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
                 canvas_id: components["schemas"]["CanvasId"];
             };
@@ -1369,6 +1390,9 @@ 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;
                     };
                 };
             };
@@ -1422,6 +1446,9 @@ 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;
                     }[];
                 };
             };
@@ -1460,7 +1487,12 @@ declare interface operations {
                     "application/json": {
                         created_at: string;
                         flow_id: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use uuid.
+                         */
                         id: number;
+                        uuid: string;
                         title: string;
                         request: string | null;
                         data_summary: {
@@ -1529,6 +1561,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -1543,6 +1576,8 @@ declare interface operations {
                 content: {
                     "application/json": {
                         created_at: string;
+                        /** Format: uuid */
+                        report_id: string;
                         flow_data_id: number;
                         /** @enum {string} */
                         helpfulness: "helpful" | "partially helpful" | "not helpful" | "incorrect";
@@ -1581,6 +1616,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -1622,6 +1658,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -1666,6 +1703,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -1715,6 +1753,12 @@ declare interface operations {
                         confidence_score_reason?: string;
                         assumptions_score?: number;
                         assumptions_score_reason?: string;
+                        /** Format: uuid */
+                        report_id: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use report_id.
+                         */
                         flow_data_id: number;
                         friendliness_score?: number;
                         friendliness_score_reason?: string;
@@ -1879,6 +1923,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -1925,6 +1970,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -1980,6 +2026,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -2026,6 +2073,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -2075,6 +2123,7 @@ declare interface operations {
                 "sp-access-token"?: string;
             };
             path: {
+                /** @description Numeric legacy ID or UUID */
                 report_id: string;
             };
             cookie?: never;
@@ -2090,7 +2139,12 @@ declare interface operations {
                     "application/json": {
                         created_at: string;
                         flow_id: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use uuid.
+                         */
                         id: number;
+                        uuid: string;
                         title: string;
                         request: string | null;
                         data_summary: {
@@ -2173,6 +2227,7 @@ declare interface operations {
                         filename?: string;
                         url: string;
                     }[];
+                    uploadedFileIds?: string[];
                 };
             };
         };
@@ -2226,8 +2281,8 @@ declare interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description List of flow_data IDs to refresh */
-                    flow_data_ids: number[];
+                    /** @description List of report IDs to refresh */
+                    flow_data_ids: (string | number)[];
                 };
             };
         };
@@ -2272,7 +2327,7 @@ declare interface operations {
     getMaterializationStatus: {
         parameters: {
             query: {
-                /** @description Comma-separated list of flow_data IDs */
+                /** @description Comma-separated list of reports IDs */
                 ids: string;
             };
             header?: {
@@ -2554,7 +2609,13 @@ declare interface operations {
                 };
                 content: {
                     "application/json": {
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use uuid.
+                         */
                         id: number;
+                        uuid: string;
+                        report_uuid: string;
                         flow_data_id: number;
                         created_at: string;
                         flow_data?: {
@@ -2966,6 +3027,9 @@ 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;
                         }[];
                     }[];
                 };
@@ -3039,7 +3103,7 @@ declare interface operations {
     listAgentRuns: {
         parameters: {
             query?: {
-                status?: "pending" | "running" | "completed" | "failed" | "cancelled";
+                status?: "pending" | "running" | "post_processing" | "completed" | "failed" | "cancelled";
                 agent_id?: string;
                 limit?: number;
             };
@@ -3270,6 +3334,11 @@ declare interface operations {
                         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";
@@ -3277,8 +3346,13 @@ declare interface operations {
                         effort?: "low" | "medium" | "high";
                     } | {
                         /** @enum {string} */
-                        model: "claude-haiku-4-5";
+                        model: "claude-haiku-4-5" | "claude-opus-4-5";
                     };
+                    /**
+                     * @default native
+                     * @enum {string}
+                     */
+                    execution_platform?: "native" | "sandbox" | "sandbox_public";
                     master_prompt_name?: string;
                     master_prompt_version?: number;
                 };
@@ -3424,6 +3498,11 @@ declare interface operations {
                         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";
@@ -3431,8 +3510,10 @@ declare interface operations {
                         effort?: "low" | "medium" | "high";
                     } | {
                         /** @enum {string} */
-                        model: "claude-haiku-4-5";
+                        model: "claude-haiku-4-5" | "claude-opus-4-5";
                     } | null;
+                    /** @enum {string} */
+                    execution_platform?: "native" | "sandbox" | "sandbox_public";
                     master_prompt_name?: string | null;
                     master_prompt_version?: number | null;
                 };
@@ -5138,6 +5219,119 @@ declare interface operations {
             };
         };
     };
+    generateDataReport: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description The natural language data request */
+                    request: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Data report generated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        status: "success";
+                        generation_id: string;
+                        sql: string;
+                        title: string | null;
+                        goal: string | null;
+                        view_name: string | null;
+                        view_schema: string | null;
+                        data_sample: {
+                            [key: string]: unknown;
+                        }[] | null;
+                        data_summary: {
+                            [key: string]: unknown;
+                        } | null;
+                        is_sample: boolean;
+                    };
+                };
+            };
+            /** @description Invalid request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description Service account authentication required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description SQL generation failed */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        status: "error";
+                        error: string;
+                        error_info?: {
+                            error_message: string;
+                            /** @enum {string} */
+                            category: "timeout" | "connection_error" | "auth_error" | "resource_exhausted" | "table_not_found" | "column_not_found" | "schema_not_found" | "view_not_found" | "function_not_found" | "syntax_error" | "ambiguous_column" | "type_mismatch" | "invalid_cast" | "invalid_argument" | "division_by_zero" | "constraint_violation" | "permission_denied" | "unknown";
+                            details?: string | null;
+                            hint?: string | null;
+                            line_num?: number | null;
+                            col_num?: number | null;
+                        } | null;
+                        failed_sql?: string | null;
+                    };
+                };
+            };
+            /** @description Rate limit exceeded for this API key */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        retry_after_ms: number;
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
 }
 
 declare type PatchParam<T, Config extends RemoveParamsConfig, P extends keyof Config> = Simplify<T extends {
@@ -5902,6 +6096,22 @@ declare interface paths {
         patch: operations["updateTableColumn"];
         trace?: never;
     };
+    "/api/v1/data-reports/generate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["generateDataReport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 
 declare type PublicApiClient = Simplify<Client<PublicPaths, `${string}/${string}`>>;
@@ -6151,4 +6361,9 @@ declare const UpdateCanvasSchema: z.ZodObject<{
     is_public: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 
+/** A previously uploaded file identifier to attach to the first message of a flow. */
+declare type UploadedFileId = default_2.infer<typeof UploadedFileIdSchema>;
+
+declare const UploadedFileIdSchema: z.ZodUUID;
+
 export { }