@magemetrics/core 0.14.0 → 0.14.1

package/dist/index.d.ts

@@ -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 */
@@ -867,6 +806,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";
@@ -1192,6 +1132,11 @@ declare const inputSchema_5: z.ZodObject<{}, z.core.$strip>;
 declare const inputSchema_6: z.ZodObject<{
     dataset: z.ZodString;
     table_name: z.ZodString;
+    includeDescriptions: z.ZodDefault<z.ZodBoolean>;
+    includeDataTypes: z.ZodDefault<z.ZodBoolean>;
+    includeSampleValues: z.ZodDefault<z.ZodBoolean>;
+    includeStatistics: z.ZodDefault<z.ZodBoolean>;
+    includeFreshness: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 
 declare const inputSchema_7: z.ZodObject<{
@@ -1561,7 +1506,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;
@@ -2796,13 +2741,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 +3936,6 @@ declare interface operations {
             content: {
                 "application/json": {
                     name: string;
-                    objective?: string;
                     generated_objective_fragment?: string;
                     /** @default [] */
                     active_tools?: string[];
@@ -4161,7 +4098,6 @@ declare interface operations {
             content: {
                 "application/json": {
                     name?: string;
-                    objective?: string | null;
                     generated_objective_fragment?: string | null;
                     active_tools?: string[];
                     input_schema?: ({

package/dist/index.js

@@ -58,7 +58,7 @@ var addApiKeyHeader = (apiKey) => {
 
 // package.json
 var package_default = {
-  version: "0.14.0"};
+  version: "0.14.1"};
 
 // 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.23/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(),
@@ -4851,19 +4863,33 @@ z.object({
   result: z.discriminatedUnion("status", [RedactedSuccessVersion2, ErrorVersion3]).optional()
 });
 var GET_AVAILABLE_COLUMNS_FOR_TABLE = "getAvailableColumnsForTable";
+var ColumnMetadataSchema2 = z.object({
+  // Always returned (not gated by any flag)
+  name: z.string(),
+  // includeDescriptions flag
+  description: z.string().nullable().optional(),
+  // includeDataTypes flag
+  data_type: z.string().nullable().optional(),
+  canonical_data_type: z.string().nullable().optional(),
+  // includeSampleValues flag
+  sample_values: z.array(z.unknown()).nullable().optional(),
+  // includeStatistics flag
+  null_percentage: z.number().nullable().optional(),
+  unique_values: z.number().nullable().optional(),
+  min_value: z.number().nullable().optional(),
+  max_value: z.number().nullable().optional(),
+  min_date: z.string().nullable().optional(),
+  max_date: z.string().nullable().optional(),
+  has_null: z.boolean().nullable().optional(),
+  // includeFreshness flag
+  updated_at: z.string().nullable().optional()
+});
 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()
+    columns: ColumnMetadataSchema2.array()
   })
 });
 var RedactedSuccessVersion3 = SuccessVersion4.omit({
@@ -4885,7 +4911,12 @@ GetAvailableColumnsForTableResponse.extend({
 });
 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.")
+  table_name: z.string().describe("A table name of the database for which to retrieve all column names and information."),
+  includeDescriptions: z.boolean().default(true).describe("Include semantic column descriptions in metadata. Default: true."),
+  includeDataTypes: z.boolean().default(true).describe("Include canonical and raw data types in metadata. Default: true."),
+  includeSampleValues: z.boolean().default(false).describe("Include indexing-time snapshot example values in metadata. Use only for illustrative examples, NOT for min/max questions. Default: false."),
+  includeStatistics: z.boolean().default(false).describe("Include min/max, cardinality, and null statistics in metadata. Set to true when answering questions about extremes or data distribution shape (but not full distributions, which require querying the data directly). Default: false."),
+  includeFreshness: z.boolean().default(false).describe("Include last synced timestamp for columns. Set to true when answering questions about data freshness or when the data was last updated. Default: false.")
 });
 var outputResultSchema3 = z.discriminatedUnion("status", [SuccessVersion4, ErrorVersion4]).optional();
 z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magemetrics/core",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "MageMetrics client library",
   "files": [
     "dist/"
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@noble/hashes": "^2.2.0",
-    "@supabase/auth-js": "^2.105.4",
+    "@supabase/auth-js": "^2.107.0",
     "@xyflow/system": "^0.0.76",
     "ai": "6.0.175",
     "dayjs": "^1.11.20",