@magemetrics/core 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -14,7 +14,7 @@ import { z } from 'zod';
 
 export declare const ASK_USER_QUESTION: "askUserQuestion";
 
-export declare type AskUserQuestionInput = z.infer<typeof inputSchema_9>;
+export declare type AskUserQuestionInput = z.infer<typeof inputSchema_5>;
 
 export declare type AskUserQuestionPart = Extract<MMChatUIMessagePart, {
     type: `tool-${typeof ASK_USER_QUESTION}`;
@@ -146,6 +146,7 @@ export declare type CanonicalDataType = z.infer<typeof CanonicalDataTypeSchema>;
 
 declare const CanonicalDataTypeSchema: z.ZodEnum<{
     boolean: "boolean";
+    date: "date";
     array: "array";
     text: "text";
     json: "json";
@@ -184,6 +185,8 @@ export declare interface ColumnSort {
 
 declare interface components {
     schemas: {
+        /** Format: uuid */
+        CanvasId: string;
         ReportColumns: {
             name: string;
             data_type: string;
@@ -191,14 +194,12 @@ declare interface components {
             renderType?: string;
             unit?: string;
             /** @enum {string} */
-            canonicalDataType?: "numeric" | "boolean" | "datetime" | "text" | "array" | "json" | "other";
+            canonicalDataType?: "numeric" | "boolean" | "datetime" | "date" | "text" | "array" | "json" | "other";
             formatHint?: {
                 isNumeric?: boolean;
                 isLikelyYear?: boolean;
             };
         }[];
-        /** Format: uuid */
-        CanvasId: string;
         ReportData: {
             [key: string]: unknown;
         }[];
@@ -366,9 +367,6 @@ declare interface components {
                 sampledCount: number;
             };
         };
-        VisualizationData: {
-            [key: string]: string | (number | null) | unknown | null;
-        }[];
         /** @description Prompt starter template */
         PromptStarter: {
             id: number;
@@ -445,36 +443,11 @@ declare interface components {
             };
             execution_context?: components["schemas"]["ExecutionContextInput"];
         };
-        ExecutionContextInput: components["schemas"]["ImpersonateContext"] | components["schemas"]["CustomMetadataContext"];
-        ImpersonateContext: {
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            mode: "impersonate";
-            /** @description The user ID in the customer's system */
-            external_user_id: string;
-        };
-        CustomMetadataContext: {
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            mode: "custom";
-            /** @description Raw metadata key-value pairs for data access rules */
-            metadata: {
-                [key: string]: unknown;
-            };
-        };
-        AgentRunCountsResponse: {
-            [key: string]: number;
-        };
         Agent: {
             /** Format: uuid */
             id: string;
             created_at: string;
             name: string;
-            objective: string | null;
             generated_objective_fragment: string | null;
             active_tools: string[] | null;
             input_schema: ({
@@ -536,13 +509,13 @@ declare interface components {
             /** @enum {string} */
             execution_platform: "native" | "sandbox" | "sandbox_public";
             updated_at: string;
+            version_count: number;
         };
         AgentVersion: {
             /** Format: uuid */
             id: string;
             version: number;
             name: string;
-            objective: string | null;
             generated_objective_fragment: string | null;
             active_tools: string[] | null;
             input_schema: ({
@@ -606,70 +579,36 @@ declare interface components {
             restored_from_version?: number | null;
             created_at: string;
         };
-        CreateGlobalKnowledgeItem: {
-            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";
-        };
-        CreateSchemaKnowledgeItem: {
-            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"];
-        };
-        SchemaPath: {
-            /** @description Schema or dataset name in the source database */
-            dataset: string;
-            /** @description Table name in the source database */
-            table_name: string;
-            /** @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"];
-        };
+        ExecutionContextInput: components["schemas"]["ImpersonateContext"] | components["schemas"]["CustomMetadataContext"];
         StatisticsResponse: {
             /** @description The time period in days for these statistics */
             period_days: number;
             user_generated: components["schemas"]["UserGeneratedStatistics"];
             agent_generated: components["schemas"]["AgentGeneratedStatistics"];
         };
+        VisualizationData: {
+            [key: string]: string | (number | null) | unknown | null;
+        }[];
+        ImpersonateContext: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            mode: "impersonate";
+            /** @description The user ID in the customer's system */
+            external_user_id: string;
+        };
+        CustomMetadataContext: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            mode: "custom";
+            /** @description Raw metadata key-value pairs for data access rules */
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
         /** @description Statistics for user-generated content (conversations, reports, visualizations) */
         UserGeneratedStatistics: {
             /** @description Number of user-created conversations */
@@ -770,6 +709,8 @@ export declare class DirectAuthProvider implements AuthProvider {
     private setState;
 }
 
+export declare const EXPLORE_SCHEMA: "exploreSchema";
+
 /**
  * External authentication provider that handles the full token exchange flow.
  *
@@ -867,6 +808,7 @@ declare const FrontendReportColumnsSchema: z.ZodArray<z.ZodObject<{
     unit: z.ZodOptional<z.ZodString>;
     canonicalDataType: z.ZodOptional<z.ZodEnum<{
         boolean: "boolean";
+        date: "date";
         array: "array";
         text: "text";
         json: "json";
@@ -1125,10 +1067,6 @@ 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>;
@@ -1164,10 +1102,6 @@ declare const inputSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 
-declare const inputSchema_10: z.ZodObject<{
-    question: z.ZodString;
-}, z.core.$strip>;
-
 declare const inputSchema_2: z.ZodObject<{
     reportId: z.ZodUnion<[z.ZodNumber, z.ZodUUID]>;
     chartType: z.ZodEnum<{
@@ -1184,30 +1118,12 @@ declare const inputSchema_3: z.ZodObject<{
 }, z.core.$strip>;
 
 declare const inputSchema_4: z.ZodObject<{
-    value: z.ZodString;
-}, z.core.$strip>;
-
-declare const inputSchema_5: z.ZodObject<{}, z.core.$strip>;
-
-declare const inputSchema_6: z.ZodObject<{
-    dataset: z.ZodString;
-    table_name: z.ZodString;
-}, z.core.$strip>;
-
-declare const inputSchema_7: z.ZodObject<{
-    reportId: z.ZodNumber;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    skipSampleRows: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, z.core.$strip>;
-
-declare const inputSchema_8: z.ZodObject<{
     query: z.ZodString;
     fromDate: z.ZodOptional<z.ZodISODate>;
     toDate: z.ZodOptional<z.ZodISODate>;
 }, z.core.$strip>;
 
-declare const inputSchema_9: z.ZodObject<{
+declare const inputSchema_5: z.ZodObject<{
     questions: z.ZodArray<z.ZodObject<{
         question: z.ZodString;
         header: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
@@ -1219,6 +1135,10 @@ declare const inputSchema_9: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
+declare const inputSchema_6: z.ZodObject<{
+    question: z.ZodString;
+}, z.core.$strip>;
+
 export declare const isAskUserQuestionPart: (part: MMChatUIMessagePart) => part is AskUserQuestionPart;
 
 export declare const isFrontendV1Visualization: (visualization: FrontendVisualization | V1FrontendVisualization) => visualization is V1FrontendVisualization;
@@ -1561,7 +1481,7 @@ export declare class MageMetricsClient {
                 dataType: string;
                 renderType?: string | undefined;
                 unit?: string | undefined;
-                canonicalDataType?: "numeric" | "boolean" | "datetime" | "text" | "array" | "json" | "other" | undefined;
+                canonicalDataType?: "numeric" | "boolean" | "datetime" | "date" | "text" | "array" | "json" | "other" | undefined;
                 formatHint?: {
                     isNumeric?: boolean | undefined;
                     isLikelyYear?: boolean | undefined;
@@ -1646,13 +1566,9 @@ export declare type MMUiTools = {
     generateDataReport: UiTool;
     generateVisualization: UiTool_2;
     think: UiTool_3;
-    valueBasedColumnSearch: UiTool_4;
-    getAvailableTables: UiTool_5;
-    getAvailableColumnsForTable: UiTool_6;
-    paginateDataReport: UiTool_7;
-    webSearch: UiTool_8;
-    askUserQuestion: UiTool_9;
-    exploreSchema: UiTool_10;
+    webSearch: UiTool_4;
+    askUserQuestion: UiTool_5;
+    exploreSchema: UiTool_6;
 };
 
 declare interface operations {
@@ -2796,13 +2712,6 @@ declare interface operations {
                 "application/json": {
                     userQuery: string;
                     applicationName?: string;
-                    files?: {
-                        /** @enum {string} */
-                        type: "file";
-                        mediaType: string;
-                        filename?: string;
-                        url: string;
-                    }[];
                     uploadedFileIds?: string[];
                 };
             };
@@ -3998,7 +3907,6 @@ declare interface operations {
             content: {
                 "application/json": {
                     name: string;
-                    objective?: string;
                     generated_objective_fragment?: string;
                     /** @default [] */
                     active_tools?: string[];
@@ -4161,7 +4069,6 @@ declare interface operations {
             content: {
                 "application/json": {
                     name?: string;
-                    objective?: string | null;
                     generated_objective_fragment?: string | null;
                     active_tools?: string[];
                     input_schema?: ({
@@ -6338,8 +6245,6 @@ 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>;
@@ -7233,6 +7138,19 @@ declare const RedactedAskUserQuestionResponse: z.ZodObject<{
 
 export declare type RedactedAskUserQuestionResponseType = z.output<typeof RedactedAskUserQuestionResponse>;
 
+declare const RedactedExploreSchemaResponse: z.ZodObject<{
+    tool: z.ZodDefault<z.ZodLiteral<"exploreSchema">>;
+    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 RedactedExploreSchemaResponseType = z.output<typeof RedactedExploreSchemaResponse>;
+
 declare const RedactedGenerateDataReportResponse: z.ZodObject<{
     tool: z.ZodDefault<z.ZodLiteral<"generateDataReport">>;
     result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -7290,32 +7208,6 @@ declare const RedactedGenerateVisualizationResponse: z.ZodObject<{
 
 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<{
@@ -7370,55 +7262,6 @@ declare const redactedOutputSchema_2: z.ZodObject<{
 }, z.core.$strip>;
 
 declare const redactedOutputSchema_3: z.ZodObject<{
-    tool: 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>;
-
-declare const redactedOutputSchema_4: z.ZodObject<{
-    tool: 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>;
-
-declare const redactedOutputSchema_5: z.ZodObject<{
-    tool: 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>;
-
-declare const redactedOutputSchema_6: z.ZodObject<{
-    tool: 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>;
-
-declare const redactedOutputSchema_7: z.ZodObject<{
     tool: z.ZodLiteral<"search">;
     result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         status: z.ZodLiteral<"success">;
@@ -7436,7 +7279,7 @@ declare const redactedOutputSchema_7: z.ZodObject<{
     }, z.core.$strip>], "status">>;
 }, z.core.$strip>;
 
-declare const redactedOutputSchema_8: z.ZodObject<{
+declare const redactedOutputSchema_4: z.ZodObject<{
     tool: z.ZodLiteral<"exploreSchema">;
     result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         status: z.ZodLiteral<"success">;
@@ -7447,24 +7290,6 @@ 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<{
@@ -7475,19 +7300,6 @@ declare const RedactedThinkResponse: z.ZodObject<{
 
 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<{
@@ -7639,23 +7451,15 @@ 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>>>;
-
 declare type UiTool_2 = InferUITool<Tool<z.infer<typeof inputSchema_2>, z.infer<typeof redactedOutputSchema_2>>>;
 
 declare type UiTool_3 = InferUITool<Tool<z.infer<typeof inputSchema_3>, z.infer<typeof RedactedThinkResponse>>>;
 
 declare type UiTool_4 = InferUITool<Tool<z.infer<typeof inputSchema_4>, z.infer<typeof redactedOutputSchema_3>>>;
 
-declare type UiTool_5 = InferUITool<Tool<z.infer<typeof inputSchema_5>, z.infer<typeof redactedOutputSchema_4>>>;
-
-declare type UiTool_6 = InferUITool<Tool<z.infer<typeof inputSchema_6>, z.infer<typeof redactedOutputSchema_5>>>;
-
-declare type UiTool_7 = InferUITool<Tool<z.infer<typeof inputSchema_7>, z.infer<typeof redactedOutputSchema_6>>>;
+declare type UiTool_5 = InferUITool<Tool<z.infer<typeof inputSchema_5>, z.infer<typeof RedactedAskUserQuestionResponse>>>;
 
-declare type UiTool_8 = InferUITool<Tool<z.infer<typeof inputSchema_8>, z.infer<typeof redactedOutputSchema_7>>>;
-
-declare type UiTool_9 = InferUITool<Tool<z.infer<typeof inputSchema_9>, z.infer<typeof RedactedAskUserQuestionResponse>>>;
+declare type UiTool_6 = InferUITool<Tool<z.infer<typeof inputSchema_6>, z.infer<typeof redactedOutputSchema_4>>>;
 
 declare const UpdateCanvasSchema: z.ZodObject<{
     id: z.ZodUUID;
@@ -7823,8 +7627,6 @@ 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 { }

package/dist/index.js

@@ -58,7 +58,7 @@ var addApiKeyHeader = (apiKey) => {
 
 // package.json
 var package_default = {
-  version: "0.14.0"};
+  version: "0.15.0"};
 
 // src/core/MageMetricsEventEmitter.ts
 var MageMetricsEventEmitter = class {
@@ -483,7 +483,7 @@ function getOpenApiConfiguration(refOrOpenapi, metadataOrOptions, options) {
   };
 }
 
-// ../../node_modules/.pnpm/hono@4.12.18/node_modules/hono/dist/router/reg-exp-router/node.js
+// ../../node_modules/.pnpm/hono@4.12.25/node_modules/hono/dist/router/reg-exp-router/node.js
 new Set(".\\+*[^]$()");
 var createRoute = (routeConfig) => {
   const route = {
@@ -1089,10 +1089,30 @@ var BusinessExplanationSchema = z.object({
     explanation: z.string()
   }))
 });
+var MONTH_ABBREVIATION_LOCALE = "en-month-abbreviation";
 dayjs.extend(relativeTime);
 dayjs.extend(customParseFormat);
 dayjs.extend(utc);
 dayjs.extend(timezone);
+dayjs.locale({
+  name: MONTH_ABBREVIATION_LOCALE,
+  monthsShort: [
+    "Jan.",
+    "Feb.",
+    "Mar.",
+    "Apr.",
+    "May",
+    "Jun.",
+    "Jul.",
+    "Aug.",
+    "Sep.",
+    "Oct.",
+    "Nov.",
+    "Dec."
+  ],
+  formats: {},
+  relativeTime: {}
+}, void 0, true);
 var daysjs_default = dayjs;
 
 // ../shared/dist/src/data/FormattedData.js
@@ -1392,6 +1412,7 @@ var CanonicalDataTypeSchema = z.enum([
   "numeric",
   "boolean",
   "datetime",
+  "date",
   "text",
   "array",
   "json",
@@ -1661,12 +1682,6 @@ var parseReportId = (val, ctx) => {
 var ReportId = z.string().transform((val, ctx) => parseReportId(val, ctx)).openapi({ type: "string", description: "Numeric legacy ID or UUID" });
 var ReportIdFromBody = z.union([z.string(), z.number()]).transform((val, ctx) => parseReportId(String(val), ctx));
 var ReportIdParam = z.object({ report_id: ReportId }).openapi("ReportId", { type: "integer" });
-var CreateFlowFileSchema = z.object({
-  type: z.literal("file"),
-  mediaType: z.string(),
-  filename: z.string().optional(),
-  url: z.string()
-});
 var RetrieveFlowDataReports = createRoute({
   method: "get",
   path: "/api/v1/flows/{flowId}/data-reports",
@@ -2390,7 +2405,6 @@ var CreateFlow = createRoute({
           schema: z.object({
             userQuery: z.string(),
             applicationName: z.string().optional(),
-            files: z.array(CreateFlowFileSchema).max(CHAT_MAX_FILE_COUNT).optional(),
             uploadedFileIds: z.array(UploadedFileIdSchema).max(CHAT_MAX_FILE_COUNT).optional()
           })
         }
@@ -3295,7 +3309,6 @@ var BaseAgentSchema = z.object({
 });
 var AgentBehaviorSchema = z.object({
   name: z.string(),
-  objective: z.string().nullable(),
   generated_objective_fragment: z.string().nullable(),
   active_tools: z.array(z.string()).nullable(),
   input_schema: AgentInputSchemaSchema.nullable(),
@@ -3308,11 +3321,11 @@ var AgentSchema = z.object({
   ...BaseAgentSchema.shape,
   ...AgentBehaviorSchema.shape,
   updated_at: z.string(),
-  current_version_id: z.uuid()
+  current_version_id: z.uuid(),
+  version_count: z.number().int().positive()
 });
 z.object({
   name: z.string().min(1, "Name is required"),
-  objective: z.string().optional(),
   generated_objective_fragment: z.string().optional(),
   active_tools: z.array(z.string()).default([]),
   input_schema: AgentInputSchemaSchema.optional(),
@@ -3323,7 +3336,6 @@ z.object({
 });
 var DbUpdateAgentSchema = z.object({
   name: z.string().min(1).optional(),
-  objective: z.string().nullable().optional(),
   generated_objective_fragment: z.string().nullable().optional(),
   active_tools: z.array(z.string()).optional(),
   input_schema: AgentInputSchemaSchema.nullable().optional(),
@@ -4713,6 +4725,40 @@ var getMessageTextContent = (message) => {
   }
   return content;
 };
+var EXPLORE_SCHEMA = "exploreSchema";
+var SuccessVersion2 = z.object({
+  status: z.literal("success"),
+  public: z.looseObject({}),
+  private: z.object({
+    answer: z.string()
+  })
+});
+var RedactedSuccessVersion = SuccessVersion2.omit({
+  private: true
+});
+var ErrorVersion2 = z.object({
+  status: z.literal("error"),
+  message: z.string()
+});
+var ExploreSchemaResponse = z.object({
+  tool: z.literal(EXPLORE_SCHEMA).default(EXPLORE_SCHEMA),
+  result: z.discriminatedUnion("status", [SuccessVersion2, ErrorVersion2]).optional()
+});
+ExploreSchemaResponse.extend({
+  result: z.discriminatedUnion("status", [RedactedSuccessVersion, ErrorVersion2]).optional()
+});
+z.object({
+  question: z.string().describe("A natural language question about the available data schema, tables, columns, data structure, or specific data values.")
+});
+var outputResultSchema = z.discriminatedUnion("status", [SuccessVersion2, ErrorVersion2]).optional();
+z.object({
+  tool: z.literal(EXPLORE_SCHEMA),
+  result: outputResultSchema
+});
+z.object({
+  tool: z.literal(EXPLORE_SCHEMA),
+  result: z.discriminatedUnion("status", [RedactedSuccessVersion, ErrorVersion2]).optional()
+});
 var GENERATE_DATA_REPORT = "generateDataReport";
 var SqlErrorCategory = z.enum([
   // Infrastructure errors (retriable - SQL might still be valid)
@@ -4749,7 +4795,7 @@ var SqlGenerationErrorInfo = z.object({
   line_num: z.number().nullish(),
   col_num: z.number().nullish()
 });
-var SuccessVersion2 = z.object({
+var SuccessVersion3 = z.object({
   status: z.literal("success"),
   public: z.object({
     flowDataId: z.number(),
@@ -4762,10 +4808,10 @@ var SuccessVersion2 = z.object({
     dataReportSummary: z.string()
   })
 });
-var RedactedSuccessVersion = SuccessVersion2.omit({
+var RedactedSuccessVersion2 = SuccessVersion3.omit({
   private: true
 });
-var ErrorVersion2 = z.object({
+var ErrorVersion3 = z.object({
   status: z.literal("error"),
   message: z.string(),
   errorInfo: SqlGenerationErrorInfo.optional(),
@@ -4777,11 +4823,11 @@ var RedactedErrorVersion = z.object({
 });
 var GenerateDataReportResponse = z.object({
   tool: z.literal(GENERATE_DATA_REPORT).default(GENERATE_DATA_REPORT),
-  result: z.discriminatedUnion("status", [SuccessVersion2, ErrorVersion2]).optional()
+  result: z.discriminatedUnion("status", [SuccessVersion3, ErrorVersion3]).optional()
 });
 GenerateDataReportResponse.extend({
   result: z.discriminatedUnion("status", [
-    SuccessVersion2.omit({ private: true }),
+    SuccessVersion3.omit({ private: true }),
     RedactedErrorVersion
   ]).optional()
 });
@@ -4791,20 +4837,20 @@ z.object({
   isNewAnalysisGoal: z.boolean().describe("Indicates whether this request represents a new analysis goal very different from the current conversation flow (true), or continues/modifies the existing analysis (false)."),
   difficultyLevel: z.enum(["simple", "moderate", "complex"]).describe("Complexity level of the SQL query based on the user request.")
 });
-var outputResultSchema = z.discriminatedUnion("status", [SuccessVersion2, ErrorVersion2]).optional();
+var outputResultSchema2 = z.discriminatedUnion("status", [SuccessVersion3, ErrorVersion3]).optional();
 z.object({
   tool: z.literal(GENERATE_DATA_REPORT),
-  result: outputResultSchema
+  result: outputResultSchema2
 });
 z.object({
   tool: z.literal(GENERATE_DATA_REPORT),
   result: z.discriminatedUnion("status", [
-    RedactedSuccessVersion,
+    RedactedSuccessVersion2,
     RedactedErrorVersion
   ]).optional()
 });
 var GENERATE_VISUALIZATION = "generateVisualization";
-var SuccessVersion3 = z.object({
+var SuccessVersion4 = z.object({
   status: z.literal("success"),
   public: z.object({
     flowDataId: z.number(),
@@ -4819,21 +4865,21 @@ var SuccessVersion3 = z.object({
     dataReportSummary: z.string().optional()
   })
 });
-var RedactedSuccessVersion2 = SuccessVersion3.omit({
+var RedactedSuccessVersion3 = SuccessVersion4.omit({
   private: true
 });
-var ErrorVersion3 = z.object({
+var ErrorVersion4 = z.object({
   status: z.literal("error"),
   message: z.string()
 });
 var GenerateVisualizationResponse = z.object({
   tool: z.literal(GENERATE_VISUALIZATION).default(GENERATE_VISUALIZATION),
-  result: z.discriminatedUnion("status", [SuccessVersion3, ErrorVersion3]).optional()
+  result: z.discriminatedUnion("status", [SuccessVersion4, ErrorVersion4]).optional()
 });
 GenerateVisualizationResponse.extend({
   result: z.discriminatedUnion("status", [
-    SuccessVersion3.omit({ private: true }),
-    ErrorVersion3
+    SuccessVersion4.omit({ private: true }),
+    ErrorVersion4
   ]).optional()
 });
 z.object({
@@ -4841,207 +4887,31 @@ z.object({
   chartType: z.enum(["bar", "line/area", "scatter", "pie"]).describe("Type of visualization to generate"),
   explanations: z.string().describe("Mandatory instructions for the visualization engine. This must include: 1) Aggregation logic (e.g., 'Sum revenue', 'Count IDs'), 2) Grouping details, 3) Limits for high-cardinality data (e.g., 'Sort descending and keep only the Top 10 results'), and 4) The specific columns to display on the plot (identifying metrics, axis, and dimensions).")
 });
-var outputResultSchema2 = z.discriminatedUnion("status", [SuccessVersion3, ErrorVersion3]).optional();
-z.object({
-  tool: z.literal(GENERATE_VISUALIZATION),
-  result: outputResultSchema2
-});
-z.object({
-  tool: z.literal(GENERATE_VISUALIZATION),
-  result: z.discriminatedUnion("status", [RedactedSuccessVersion2, ErrorVersion3]).optional()
-});
-var GET_AVAILABLE_COLUMNS_FOR_TABLE = "getAvailableColumnsForTable";
-var SuccessVersion4 = z.object({
-  status: z.literal("success"),
-  public: z.looseObject({}),
-  private: z.object({
-    message: z.string().optional(),
-    columns: z.object({
-      name: z.string(),
-      data_type: z.string().nullable(),
-      description: z.string().nullable(),
-      null_percentage: z.number().nullable(),
-      unique_values: z.number().nullable(),
-      sample_values: z.array(z.any()).nullable()
-    }).array()
-  })
-});
-var RedactedSuccessVersion3 = SuccessVersion4.omit({
-  private: true
-});
-var ErrorVersion4 = z.object({
-  status: z.literal("error"),
-  message: z.string()
-});
-var GetAvailableColumnsForTableResponse = z.object({
-  tool: z.literal(GET_AVAILABLE_COLUMNS_FOR_TABLE).default(GET_AVAILABLE_COLUMNS_FOR_TABLE),
-  result: z.discriminatedUnion("status", [SuccessVersion4, ErrorVersion4]).optional()
-});
-GetAvailableColumnsForTableResponse.extend({
-  result: z.discriminatedUnion("status", [
-    SuccessVersion4.omit({ private: true }),
-    ErrorVersion4
-  ]).optional()
-});
-z.object({
-  dataset: z.string().describe("The dataset (schema) the table belongs to."),
-  table_name: z.string().describe("A table name of the database for which to retrieve all column names and information.")
-});
 var outputResultSchema3 = z.discriminatedUnion("status", [SuccessVersion4, ErrorVersion4]).optional();
 z.object({
-  tool: z.literal(GET_AVAILABLE_COLUMNS_FOR_TABLE),
+  tool: z.literal(GENERATE_VISUALIZATION),
   result: outputResultSchema3
 });
 z.object({
-  tool: z.literal(GET_AVAILABLE_COLUMNS_FOR_TABLE),
+  tool: z.literal(GENERATE_VISUALIZATION),
   result: z.discriminatedUnion("status", [RedactedSuccessVersion3, ErrorVersion4]).optional()
 });
-var GET_AVAILABLE_TABLES = "getAvailableTables";
-var SuccessVersion5 = z.object({
-  status: z.literal("success"),
-  public: z.looseObject({}),
-  private: z.object({
-    tables: z.array(z.object({
-      dataset: z.string(),
-      table_name: z.string(),
-      description: z.string().nullable()
-    }))
-  })
-});
-var RedactedSuccessVersion4 = SuccessVersion5.omit({
-  private: true
-});
-var ErrorVersion5 = z.object({
-  status: z.literal("error"),
-  message: z.string()
-});
-var GetAvailableTablesResponse = z.object({
-  tool: z.literal(GET_AVAILABLE_TABLES).default(GET_AVAILABLE_TABLES),
-  result: z.discriminatedUnion("status", [SuccessVersion5, ErrorVersion5]).optional()
-});
-GetAvailableTablesResponse.extend({
-  result: z.discriminatedUnion("status", [
-    SuccessVersion5.omit({ private: true }),
-    ErrorVersion5
-  ]).optional()
-});
-z.object({}).describe("This tool requires no parameters and returns all table names available in the database.");
-var outputResultSchema4 = z.discriminatedUnion("status", [SuccessVersion5, ErrorVersion5]).optional();
-z.object({
-  tool: z.literal(GET_AVAILABLE_TABLES),
-  result: outputResultSchema4
-});
-z.object({
-  tool: z.literal(GET_AVAILABLE_TABLES),
-  result: z.discriminatedUnion("status", [RedactedSuccessVersion4, ErrorVersion5]).optional()
-});
-var PAGINATE_DATA_REPORT = "paginateDataReport";
-z.object({
-  reportId: z.number().describe("The ID of the report to fetch data from"),
-  limit: z.number().optional().default(50).describe("Number of rows to fetch (default 50)"),
-  offset: z.number().optional().default(0).describe("Row offset - skip this many rows from the start (default 0)"),
-  skipSampleRows: z.boolean().optional().default(true).describe("Skip rows already shown in the data_sample from generateDataReport (default true). Set to false only if you need to re-fetch from the beginning.")
-});
-var SuccessVersion6 = z.object({
-  status: z.literal("success"),
-  public: z.object({
-    totalRows: z.number(),
-    fetchedRows: z.number(),
-    offset: z.number(),
-    hasMore: z.boolean()
-  }),
-  /* the data is in the private field to avoid sending it to the frontend
-   * this is not a security feature as the user has access to the report anyway */
-  private: z.object({
-    data: z.array(z.record(z.string(), z.unknown()))
-  })
-});
-var RedactedSuccessVersion5 = SuccessVersion6.omit({
-  private: true
-});
-var ErrorVersion6 = z.object({
-  status: z.literal("error"),
-  message: z.string()
-});
-var PaginateDataReportResponse = z.object({
-  tool: z.literal(PAGINATE_DATA_REPORT).default(PAGINATE_DATA_REPORT),
-  result: z.discriminatedUnion("status", [SuccessVersion6, ErrorVersion6]).optional()
-});
-PaginateDataReportResponse.extend({
-  result: z.discriminatedUnion("status", [RedactedSuccessVersion5, ErrorVersion6]).optional()
-});
-var outputResultSchema5 = z.discriminatedUnion("status", [SuccessVersion6, ErrorVersion6]).optional();
-z.object({
-  tool: z.literal(PAGINATE_DATA_REPORT),
-  result: outputResultSchema5
-});
-z.object({
-  tool: z.literal(PAGINATE_DATA_REPORT),
-  result: z.discriminatedUnion("status", [RedactedSuccessVersion5, ErrorVersion6]).optional()
-});
 var THINK = "think";
-var outputResultSchema6 = z.object({
+var outputResultSchema4 = z.object({
   status: z.literal("success"),
   public: z.looseObject({}),
   private: z.looseObject({})
 });
 var ThinkResponse = z.object({
   tool: z.literal(THINK).default(THINK),
-  result: outputResultSchema6.optional()
+  result: outputResultSchema4.optional()
 });
 ThinkResponse.extend({
-  result: outputResultSchema6.omit({ private: true }).optional()
+  result: outputResultSchema4.omit({ private: true }).optional()
 });
 z.object({
   thought: z.string().describe("A thought to think about.")
 });
-var VALUE_BASED_COLUMN_SEARCH = "valueBasedColumnSearch";
-var SuccessVersion7 = z.object({
-  status: z.literal("success"),
-  public: z.looseObject({}),
-  private: z.object({
-    message: z.string().optional(),
-    columns: z.object({
-      name: z.string(),
-      data_type: z.string().nullable(),
-      description: z.string().nullable(),
-      table: z.object({
-        table_name: z.string(),
-        description: z.string().nullable()
-      }),
-      matched_values: z.string().array()
-    }).array()
-  })
-});
-var RedactedSuccessVersion6 = SuccessVersion7.omit({
-  private: true
-});
-var ErrorVersion7 = z.object({
-  status: z.literal("error"),
-  message: z.string()
-});
-var ValueBasedColumnSearchResponse = z.object({
-  tool: z.literal(VALUE_BASED_COLUMN_SEARCH).default(VALUE_BASED_COLUMN_SEARCH),
-  result: z.discriminatedUnion("status", [SuccessVersion7, ErrorVersion7]).optional()
-});
-ValueBasedColumnSearchResponse.extend({
-  result: z.discriminatedUnion("status", [
-    SuccessVersion7.omit({ private: true }),
-    ErrorVersion7
-  ]).optional()
-});
-z.object({
-  value: z.string().describe("A literal data value as it would appear in a cell (e.g. 'France', 'PRD-00123', 'Apple iPhone'). Must NOT be a column name or concept.")
-});
-var outputResultSchema7 = z.discriminatedUnion("status", [SuccessVersion7, ErrorVersion7]).optional();
-z.object({
-  tool: z.literal(VALUE_BASED_COLUMN_SEARCH),
-  result: outputResultSchema7
-});
-z.object({
-  tool: z.literal(VALUE_BASED_COLUMN_SEARCH),
-  result: z.discriminatedUnion("status", [RedactedSuccessVersion6, ErrorVersion7]).optional()
-});
 var WEB_SEARCH = "webSearch";
 var Source = z.object({
   sourceType: z.literal("url"),
@@ -5049,7 +4919,7 @@ var Source = z.object({
   url: z.string(),
   title: z.string()
 });
-var SuccessVersion8 = z.object({
+var SuccessVersion5 = z.object({
   status: z.literal("success"),
   public: z.object({
     sources: z.array(Source).optional().describe("Array of source objects.")
@@ -5058,21 +4928,21 @@ var SuccessVersion8 = z.object({
     answer: z.string().optional().describe("The answer from the search results, if successful.")
   })
 });
-var RedactedSuccessVersion7 = SuccessVersion8.omit({
+var RedactedSuccessVersion4 = SuccessVersion5.omit({
   private: true
 });
-var ErrorVersion8 = z.object({
+var ErrorVersion5 = z.object({
   status: z.literal("error"),
   message: z.string()
 });
 var WebSearchToolResponse = z.object({
   tool: z.literal("search").default("search"),
-  result: z.discriminatedUnion("status", [SuccessVersion8, ErrorVersion8]).optional()
+  result: z.discriminatedUnion("status", [SuccessVersion5, ErrorVersion5]).optional()
 });
 WebSearchToolResponse.extend({
   result: z.discriminatedUnion("status", [
-    SuccessVersion8.omit({ private: true }),
-    ErrorVersion8
+    SuccessVersion5.omit({ private: true }),
+    ErrorVersion5
   ]).optional()
 });
 z.object({
@@ -5080,13 +4950,13 @@ z.object({
   fromDate: z.iso.date().optional().describe("Only include content published after this date (YYYY-MM-DD). Useful for recent news or time-specific analysis."),
   toDate: z.iso.date().optional().describe("Only include content published before this date (YYYY-MM-DD). Combine with fromDate for a date range.")
 });
-var outputResultSchema8 = z.discriminatedUnion("status", [SuccessVersion8, ErrorVersion8]).optional();
+var outputResultSchema5 = z.discriminatedUnion("status", [SuccessVersion5, ErrorVersion5]).optional();
 z.object({
-  result: outputResultSchema8
+  result: outputResultSchema5
 });
 z.object({
   tool: z.literal("search"),
-  result: z.discriminatedUnion("status", [RedactedSuccessVersion7, ErrorVersion8]).optional()
+  result: z.discriminatedUnion("status", [RedactedSuccessVersion4, ErrorVersion5]).optional()
 });
 
-export { ASK_USER_QUESTION, BrowserStorageAdapter, CHAT_ALLOWED_FILE_MEDIA_TYPES, CHAT_FILE_ACCEPT, CHAT_MAX_COMBINED_FILE_SIZE, CHAT_MAX_FILE_COUNT, CHAT_MAX_FILE_SIZE, CHECK_KEY, DirectAuthProvider, ExternalAuthProvider, GENERATE_DATA_REPORT, GENERATE_VISUALIZATION, GET_AVAILABLE_COLUMNS_FOR_TABLE, GET_AVAILABLE_TABLES, MageMetricsChatTransport, MageMetricsClient, MageMetricsEventEmitter, MemoryStorageAdapter, PAGINATE_DATA_REPORT, THINK, TOKEN_STORAGE_KEY, UPLOADED_FILE_REF_PREFIX, VALUE_BASED_COLUMN_SEARCH, WEB_SEARCH, getMessageTextContent, getPublicApiClient, getUploadedFileIdFromUrl, hasOnlyInitialUserMessage, isAskUserQuestionPart, isFrontendV1Visualization, isFrontendV1VisualizationWithData, isFrontendV2Visualization, isFrontendV2VisualizationWithData, toSearchParams, toUploadedFileRefUrl, validateUploadedFiles };
+export { ASK_USER_QUESTION, BrowserStorageAdapter, CHAT_ALLOWED_FILE_MEDIA_TYPES, CHAT_FILE_ACCEPT, CHAT_MAX_COMBINED_FILE_SIZE, CHAT_MAX_FILE_COUNT, CHAT_MAX_FILE_SIZE, CHECK_KEY, DirectAuthProvider, EXPLORE_SCHEMA, ExternalAuthProvider, GENERATE_DATA_REPORT, GENERATE_VISUALIZATION, MageMetricsChatTransport, MageMetricsClient, MageMetricsEventEmitter, MemoryStorageAdapter, THINK, TOKEN_STORAGE_KEY, UPLOADED_FILE_REF_PREFIX, WEB_SEARCH, getMessageTextContent, getPublicApiClient, getUploadedFileIdFromUrl, hasOnlyInitialUserMessage, isAskUserQuestionPart, isFrontendV1Visualization, isFrontendV1VisualizationWithData, isFrontendV2Visualization, isFrontendV2VisualizationWithData, toSearchParams, toUploadedFileRefUrl, validateUploadedFiles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magemetrics/core",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "MageMetrics client library",
   "files": [
     "dist/"
@@ -34,12 +34,12 @@
   },
   "dependencies": {
     "@noble/hashes": "^2.2.0",
-    "@supabase/auth-js": "^2.105.4",
-    "@xyflow/system": "^0.0.76",
-    "ai": "6.0.175",
-    "dayjs": "^1.11.20",
+    "@supabase/auth-js": "^2.108.1",
+    "@xyflow/system": "^0.0.77",
+    "ai": "6.0.200",
+    "dayjs": "^1.11.21",
     "openapi-fetch": "^0.17.0",
-    "type-fest": "^5.6.0",
+    "type-fest": "^5.7.0",
     "zod": "^4.4.3"
   }
 }