drizzle-cube 0.4.47 → 0.4.49

package/dist/server/index.d.ts

@@ -3725,6 +3725,9 @@ export declare interface PropagatingFilter {
 /**
  * Generic query schemas for AI agents
  * Teaches AI how to construct analysis queries
+ *
+ * These schemas are returned by the `discover` tool to help LLMs
+ * understand the correct query shape for each analysis mode.
  */
 declare const QUERY_SCHEMAS: {
     readonly funnel: {
@@ -3735,34 +3738,29 @@ declare const QUERY_SCHEMAS: {
                 readonly timeDimension: "Cube.dimension - time field for ordering events";
                 readonly steps: readonly [{
                     readonly name: "string - human readable step name";
-                    readonly filter: {
-                        readonly member: "Cube.dimension";
-                        readonly operator: "equals | notEquals | contains | ...";
-                        readonly values: readonly ["array of filter values"];
-                    };
-                    readonly timeToConvert: "optional - max time window e.g. \"7 days\"";
+                    readonly filter: "{ member, operator, values } or array of filters. Put inDateRange ONLY on step 0.";
+                    readonly timeToConvert: "optional - ISO 8601 duration e.g. \"P7D\" for 7 days, \"PT1H\" for 1 hour";
                 }];
-                readonly dateRange: "[start, end] array OR string like \"last 7 days\", \"last 3 months\", \"this quarter\"";
+                readonly includeTimeMetrics: "optional boolean - include avg/median/p90 time-to-convert";
+                readonly globalTimeWindow: "optional - ISO 8601 duration, all steps must complete within this window";
             };
         };
     };
     readonly flow: {
-        readonly description: "Analyze paths users take before/after a specific event. Shows event sequences.";
+        readonly description: "Analyze paths users take before/after a specific event. Shows event sequences as Sankey/sunburst.";
         readonly structure: {
             readonly flow: {
                 readonly bindingKey: "Cube.dimension - identifies entities";
                 readonly timeDimension: "Cube.dimension - time field for ordering";
-                readonly eventDimension: "Cube.dimension - the event type field";
+                readonly eventDimension: "Cube.dimension - the event type field (values become node labels)";
                 readonly startingStep: {
-                    readonly filter: {
-                        readonly member: "Cube.dimension";
-                        readonly operator: "equals";
-                        readonly values: readonly ["event value"];
-                    };
+                    readonly name: "string - display name for the starting step";
+                    readonly filter: "{ member, operator, values } - filter identifying the starting event";
                 };
-                readonly stepsBefore: "number - how many steps to show before starting step";
-                readonly stepsAfter: "number - how many steps to show after starting step";
-                readonly dateRange: "[start, end] array OR string like \"last 7 days\", \"last 3 months\", \"this quarter\"";
+                readonly stepsBefore: "number (0-5) - how many steps to show before starting step";
+                readonly stepsAfter: "number (0-5) - how many steps to show after starting step";
+                readonly entityLimit: "optional number - max entities to process (performance)";
+                readonly outputMode: "optional \"sankey\" | \"sunburst\" (default: sankey)";
             };
         };
     };
@@ -3770,11 +3768,18 @@ declare const QUERY_SCHEMAS: {
         readonly description: "Measure how many users return over time periods after initial activity.";
         readonly structure: {
             readonly retention: {
-                readonly bindingKey: "Cube.dimension - identifies entities";
                 readonly timeDimension: "Cube.dimension - time field for cohort assignment";
+                readonly bindingKey: "Cube.dimension - identifies entities";
+                readonly dateRange: {
+                    readonly start: "YYYY-MM-DD - cohort start date";
+                    readonly end: "YYYY-MM-DD - cohort end date";
+                };
                 readonly granularity: "day | week | month - period size";
                 readonly periods: "number - how many periods to analyze";
-                readonly dateRange: "[start, end] array OR string like \"last 7 days\", \"last 3 months\", \"this quarter\"";
+                readonly retentionType: "\"classic\" (returned in period N) | \"rolling\" (returned in N or later)";
+                readonly cohortFilters: "optional - filters on cohort entry events";
+                readonly activityFilters: "optional - filters on return activity events";
+                readonly breakdownDimensions: "optional string[] - segment by these dimensions";
             };
         };
     };