@lightdash/common 0.2104.7 → 0.2104.9

package/dist/types/ee/AiAgent/schemas/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/parser.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,kCAAkC,CAAC;AACjE,OAAO,EACH,kCAAkC,EAClC,oCAAoC,EACpC,mCAAmC,EACnC,yBAAyB,EACzB,uCAAuC,EACvC,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,0CAA0C,EAC1C,iCAAiC,EACjC,mCAAmC,EACnC,oCAAoC,GACvC,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAkB,EAAE,QAAiB,EAAE,EAAE;IACnE,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,cAAc;YACf,OAAO,qCAAqC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrE,KAAK,YAAY;YACb,OAAO,mCAAmC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnE,KAAK,aAAa;YACd,OAAO,yBAAyB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzD,KAAK,mBAAmB;YACpB,OAAO,0CAA0C,CAAC,SAAS,CACvD,QAAQ,CACX,CAAC;QACN,KAAK,sBAAsB;YACvB,OAAO,oCAAoC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpE,KAAK,wBAAwB;YACzB,OAAO,iCAAiC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjE,KAAK,6BAA6B;YAC9B,OAAO,mCAAmC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnE,KAAK,mBAAmB;YACpB,OAAO,kCAAkC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClE,KAAK,qBAAqB;YACtB,OAAO,oCAAoC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpE,KAAK,gBAAgB;YACjB,OAAO,uCAAuC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACvE,KAAK,YAAY;YACb,OAAO,mCAAmC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnE,KAAK,gBAAgB;YACjB,OAAO,4BAA4B,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5D,KAAK,eAAe;YAChB,OAAO,2BAA2B,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3D,KAAK,UAAU;YACX,OAAO,iCAAiC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjE;YACI,OAAO,iBAAiB,CACpB,QAAQ,EACR,sBAAsB,QAAQ,EAAE,CACnC,CAAC;IACV,CAAC;AACL,CAAC,CAAC"}

package/dist/types/ee/AiAgent/schemas/sortField.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from './fieldId';
+const sortFieldSchema = z.object({
+    fieldId: getFieldIdSchema({ additionalDescription: null }),
+    descending: z
+        .boolean()
+        .describe('If true sorts in descending order, if false sorts in ascending order'),
+    nullsFirst: z
+        .boolean()
+        .describe('If true sorts nulls first, if false sorts nulls last, otherwise sorts by warehouse default')
+        .nullable(),
+});
+export default sortFieldSchema;
+//# sourceMappingURL=sortField.js.map

package/dist/types/ee/AiAgent/schemas/sortField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortField.js","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/sortField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC1D,UAAU,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,CACL,sEAAsE,CACzE;IACL,UAAU,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,CACL,4FAA4F,CAC/F;SACA,QAAQ,EAAE;CAClB,CAAC,CAAC;AAIH,eAAe,eAAe,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcBaseSchemas.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from '../fieldId';
+export const orderBySchema = z.object({
+    fieldId: getFieldIdSchema({ additionalDescription: 'Field to order by' }),
+    order: z.enum(['asc', 'desc']).nullable(),
+});
+export const orderBySchemaDescription = [
+    'Specifies the order in which rows are processed by the table calculation.',
+    'For time-series: typically order by date/time ascending.',
+    'For rankings: order by the metric you want to rank, descending for highest-first.',
+].join('\n');
+export const partitionBySchema = getFieldIdSchema({
+    additionalDescription: null,
+});
+export const partitionBySchemaDescription = [
+    'Fields to PARTITION BY - divides result set into independent groups.',
+    'Each partition calculates independently (rankings restart, percentages sum to 100% per partition).',
+    'Empty array or null: single partition (calculations across all rows).',
+].join('\n');
+export const baseTableCalcSchema = z.object({
+    name: z
+        .string()
+        .describe('Unique name for the table calculation, e.g. "percent_change_from_previous"'),
+    displayName: z
+        .string()
+        .describe('Display name for the table calculation, e.g. "MoM revenue change"'),
+});
+//# sourceMappingURL=tableCalcBaseSchemas.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcBaseSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcBaseSchemas.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcBaseSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,CAAC;IACzE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,2EAA2E;IAC3E,0DAA0D;IAC1D,mFAAmF;CACtF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;IAC9C,qBAAqB,EAAE,IAAI;CAC9B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IACxC,sEAAsE;IACtE,oGAAoG;IACpG,uEAAuE;CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC;SACF,MAAM,EAAE;SACR,QAAQ,CACL,4EAA4E,CAC/E;IACL,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACL,mEAAmE,CACtE;CACR,CAAC,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcPercentChangeFromPrevious.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from '../fieldId';
+import { baseTableCalcSchema, orderBySchema, orderBySchemaDescription, } from './tableCalcBaseSchemas';
+export const tableCalcPercentChangeFromPreviousSchema = baseTableCalcSchema.extend({
+    type: z.literal('percent_change_from_previous'),
+    fieldId: getFieldIdSchema({
+        additionalDescription: 'Field whose values you want to compare',
+    }),
+    orderBy: z
+        .array(orderBySchema)
+        .min(1)
+        .describe(orderBySchemaDescription),
+});
+//# sourceMappingURL=tableCalcPercentChangeFromPrevious.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcPercentChangeFromPrevious.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcPercentChangeFromPrevious.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcPercentChangeFromPrevious.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,wCAAwC,GACjD,mBAAmB,CAAC,MAAM,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC;IAC/C,OAAO,EAAE,gBAAgB,CAAC;QACtB,qBAAqB,EAAE,wCAAwC;KAClE,CAAC;IACF,OAAO,EAAE,CAAC;SACL,KAAK,CAAC,aAAa,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,wBAAwB,CAAC;CAC1C,CAAC,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcPercentOfColumnTotal.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from '../fieldId';
+import { baseTableCalcSchema, partitionBySchema, partitionBySchemaDescription, } from './tableCalcBaseSchemas';
+export const tableCalcPercentOfColumnTotalSchema = baseTableCalcSchema.extend({
+    type: z.literal('percent_of_column_total'),
+    fieldId: getFieldIdSchema({
+        additionalDescription: 'Field to calculate percentage of column total',
+    }),
+    partitionBy: z
+        .array(partitionBySchema)
+        .nullable()
+        .describe(partitionBySchemaDescription),
+});
+//# sourceMappingURL=tableCalcPercentOfColumnTotal.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcPercentOfColumnTotal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcPercentOfColumnTotal.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcPercentOfColumnTotal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,mCAAmC,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC;IAC1C,OAAO,EAAE,gBAAgB,CAAC;QACtB,qBAAqB,EAAE,+CAA+C;KACzE,CAAC;IACF,WAAW,EAAE,CAAC;SACT,KAAK,CAAC,iBAAiB,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CAAC,4BAA4B,CAAC;CAC9C,CAAC,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcPercentOfPreviousValue.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from '../fieldId';
+import { baseTableCalcSchema, orderBySchema, orderBySchemaDescription, } from './tableCalcBaseSchemas';
+export const tableCalcPercentOfPreviousValueSchema = baseTableCalcSchema.extend({
+    type: z.literal('percent_of_previous_value'),
+    fieldId: getFieldIdSchema({
+        additionalDescription: 'Field whose values you want to compare',
+    }),
+    orderBy: z
+        .array(orderBySchema)
+        .min(1)
+        .describe(orderBySchemaDescription),
+});
+//# sourceMappingURL=tableCalcPercentOfPreviousValue.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcPercentOfPreviousValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcPercentOfPreviousValue.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcPercentOfPreviousValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,qCAAqC,GAAG,mBAAmB,CAAC,MAAM,CAC3E;IACI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAC5C,OAAO,EAAE,gBAAgB,CAAC;QACtB,qBAAqB,EAAE,wCAAwC;KAClE,CAAC;IACF,OAAO,EAAE,CAAC;SACL,KAAK,CAAC,aAAa,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,wBAAwB,CAAC;CAC1C,CACJ,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcRankInColumn.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from '../fieldId';
+import { baseTableCalcSchema } from './tableCalcBaseSchemas';
+export const tableCalcRankInColumnSchema = baseTableCalcSchema.extend({
+    type: z.literal('rank_in_column'),
+    fieldId: getFieldIdSchema({
+        additionalDescription: 'Field to rank by',
+    }),
+});
+//# sourceMappingURL=tableCalcRankInColumn.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcRankInColumn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcRankInColumn.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcRankInColumn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,OAAO,EAAE,gBAAgB,CAAC;QACtB,qBAAqB,EAAE,kBAAkB;KAC5C,CAAC;CACL,CAAC,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcRunningTotal.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { getFieldIdSchema } from '../fieldId';
+import { baseTableCalcSchema } from './tableCalcBaseSchemas';
+export const tableCalcRunningTotalSchema = baseTableCalcSchema.extend({
+    type: z.literal('running_total'),
+    fieldId: getFieldIdSchema({
+        additionalDescription: 'Field to calculate running total of',
+    }),
+});
+//# sourceMappingURL=tableCalcRunningTotal.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcRunningTotal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcRunningTotal.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcRunningTotal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC;QACtB,qBAAqB,EAAE,qCAAqC;KAC/D,CAAC;CACL,CAAC,CAAC"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcWindowFunction.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { WindowFunctionType } from '../../../../types/field';
+import { getFieldIdSchema } from '../fieldId';
+import { baseTableCalcSchema, orderBySchema, orderBySchemaDescription, partitionBySchema, partitionBySchemaDescription, } from './tableCalcBaseSchemas';
+const windowFunctionTypeSchema = z.enum([
+    WindowFunctionType.ROW_NUMBER,
+    WindowFunctionType.PERCENT_RANK,
+    WindowFunctionType.CUME_DIST,
+    WindowFunctionType.RANK,
+    WindowFunctionType.SUM,
+    WindowFunctionType.AVG,
+    WindowFunctionType.COUNT,
+    WindowFunctionType.MIN,
+    WindowFunctionType.MAX,
+]);
+export const tableCalcWindowFunctionSchema = baseTableCalcSchema.extend({
+    type: z.literal('window_function'),
+    windowFunction: windowFunctionTypeSchema.describe([
+        'Type of window function to apply.',
+        '',
+        '**Ranking functions** (fieldId optional, ignored if provided):',
+        '- row_number: Sequential numbering (1, 2, 3...)',
+        '- percent_rank: Relative rank as percentage (0.0-1.0)',
+        '- cume_dist: Cumulative distribution as percentage (0.0-1.0)',
+        '- rank: Positional rank (1, 2, 3...) with ties',
+        '',
+        '**Aggregate functions** (fieldId required):',
+        '- sum: Sum values within frame',
+        '- avg: Average values within frame',
+        '- count: Count values within frame',
+        '- min: Minimum value within frame',
+        '- max: Maximum value within frame',
+    ].join('\n')),
+    fieldId: getFieldIdSchema({
+        additionalDescription: 'Field to aggregate (required for sum/avg/count/min/max, not used for row_number/percent_rank/cume_dist/rank)',
+    }).nullable(),
+    orderBy: z
+        .array(orderBySchema)
+        .nullable()
+        .describe(orderBySchemaDescription),
+    partitionBy: z
+        .array(partitionBySchema)
+        .nullable()
+        .describe(partitionBySchemaDescription),
+    frame: z
+        .object({
+        frameType: z
+            .enum(['rows', 'range'])
+            .describe([
+            'Frame type:',
+            '- rows: Physical row count',
+            '- range: Logical value-based (includes peer rows with same ORDER BY value)',
+        ].join('\n')),
+        start: z
+            .object({
+            type: z.enum([
+                'unbounded_preceding',
+                'preceding',
+                'current_row',
+                'following',
+                'unbounded_following',
+            ]),
+            offset: z
+                .number()
+                .int()
+                .positive()
+                .nullable()
+                .describe('Number of rows for PRECEDING/FOLLOWING (e.g., 6 for "6 PRECEDING")'),
+        })
+            .nullable()
+            .describe('Start boundary. Null for single-boundary syntax.'),
+        end: z
+            .object({
+            type: z.enum([
+                'unbounded_preceding',
+                'preceding',
+                'current_row',
+                'following',
+                'unbounded_following',
+            ]),
+            offset: z
+                .number()
+                .int()
+                .positive()
+                .nullable()
+                .describe('Number of rows for PRECEDING/FOLLOWING'),
+        })
+            .describe('End boundary (required)'),
+    })
+        .nullable()
+        .describe([
+        'Defines which rows to include in calculation. Null uses database defaults.',
+        '',
+        '**Common patterns:**',
+        '- Moving average (N periods): {frameType: "rows", start: {type: "preceding", offset: N-1}, end: {type: "current_row"}}',
+        '- Running total: {frameType: "rows", start: {type: "unbounded_preceding"}, end: {type: "current_row"}}',
+        '- Centered window: {frameType: "rows", start: {type: "preceding", offset: 1}, end: {type: "following", offset: 1}}',
+        '',
+        '**Default when null:**',
+        '- Aggregates WITH ORDER BY: RANGE UNBOUNDED PRECEDING AND CURRENT ROW (cumulative)',
+        '- Aggregates WITHOUT ORDER BY: Entire partition (all rows)',
+        '- Ranking functions: Always use entire partition (frame clause has no effect)',
+    ].join('\n')),
+});
+//# sourceMappingURL=tableCalcWindowFunction.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcWindowFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcWindowFunction.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcWindowFunction.ts"],"names":[],"mappings":"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"}

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.js

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+import { CustomFormatType, FrameBoundaryType, FrameType, NumberSeparator, TableCalculationTemplateType, TableCalculationType, } from '../../../../types/field';
+import assertUnreachable from '../../../../utils/assertUnreachable';
+import { tableCalcPercentChangeFromPreviousSchema } from './tableCalcPercentChangeFromPrevious';
+import { tableCalcPercentOfColumnTotalSchema } from './tableCalcPercentOfColumnTotal';
+import { tableCalcPercentOfPreviousValueSchema } from './tableCalcPercentOfPreviousValue';
+import { tableCalcRankInColumnSchema } from './tableCalcRankInColumn';
+import { tableCalcRunningTotalSchema } from './tableCalcRunningTotal';
+import { tableCalcWindowFunctionSchema } from './tableCalcWindowFunction';
+const tableCalcSchema = z.discriminatedUnion('type', [
+    tableCalcPercentChangeFromPreviousSchema,
+    tableCalcPercentOfPreviousValueSchema,
+    tableCalcPercentOfColumnTotalSchema,
+    tableCalcRankInColumnSchema,
+    tableCalcRunningTotalSchema,
+    tableCalcWindowFunctionSchema,
+]);
+export const tableCalcsSchema = z.array(tableCalcSchema).nullable().describe(`
+Table calculations perform row-by-row calculations on query results without collapsing rows. Similar to SQL window functions.
+
+**Available Types:**
+- Simple calculations: percent_change_from_previous, percent_of_previous_value, percent_of_column_total, rank_in_column, running_total
+- Advanced window_function: Supports row_number, percent_rank, sum, avg, count, min, max with optional partitioning, ordering, and frame clauses
+
+**Technical Requirements:**
+- Appear as additional columns in query results
+- Can be used in sorts and filters alongside dimensions/metrics
+- Multiple calculations can be combined in a single query
+- All fields referenced must exist in the query (dimensions, metrics, or other table calculations)
+`);
+function frameBoundaryStringToEnum(boundaryType) {
+    switch (boundaryType) {
+        case 'unbounded_preceding':
+            return FrameBoundaryType.UNBOUNDED_PRECEDING;
+        case 'preceding':
+            return FrameBoundaryType.PRECEDING;
+        case 'current_row':
+            return FrameBoundaryType.CURRENT_ROW;
+        case 'following':
+            return FrameBoundaryType.FOLLOWING;
+        case 'unbounded_following':
+            return FrameBoundaryType.UNBOUNDED_FOLLOWING;
+        default:
+            return assertUnreachable(boundaryType, 'Unknown boundary type');
+    }
+}
+function convertTableCalcSchemaToTableCalc(tableCalc) {
+    const { type, name, displayName } = tableCalc;
+    // Build the template
+    const baseCalc = {
+        name,
+        displayName,
+        type: TableCalculationType.NUMBER,
+    };
+    switch (type) {
+        case 'percent_change_from_previous':
+            return {
+                ...baseCalc,
+                template: {
+                    type: TableCalculationTemplateType.PERCENT_CHANGE_FROM_PREVIOUS,
+                    fieldId: tableCalc.fieldId,
+                    orderBy: tableCalc.orderBy ?? [],
+                },
+                format: {
+                    type: CustomFormatType.PERCENT,
+                    separator: NumberSeparator.DEFAULT,
+                },
+            };
+        case 'percent_of_previous_value':
+            return {
+                ...baseCalc,
+                template: {
+                    type: TableCalculationTemplateType.PERCENT_OF_PREVIOUS_VALUE,
+                    fieldId: tableCalc.fieldId,
+                    orderBy: tableCalc.orderBy ?? [],
+                },
+                format: {
+                    type: CustomFormatType.PERCENT,
+                    separator: NumberSeparator.DEFAULT,
+                },
+            };
+        case 'percent_of_column_total':
+            return {
+                ...baseCalc,
+                template: {
+                    type: TableCalculationTemplateType.PERCENT_OF_COLUMN_TOTAL,
+                    fieldId: tableCalc.fieldId,
+                    partitionBy: tableCalc.partitionBy ?? [],
+                },
+                format: {
+                    type: CustomFormatType.PERCENT,
+                    separator: NumberSeparator.DEFAULT,
+                },
+            };
+        case 'rank_in_column':
+            return {
+                ...baseCalc,
+                template: {
+                    type: TableCalculationTemplateType.RANK_IN_COLUMN,
+                    fieldId: tableCalc.fieldId,
+                },
+                format: {
+                    type: CustomFormatType.NUMBER,
+                    separator: NumberSeparator.DEFAULT,
+                },
+            };
+        case 'running_total':
+            return {
+                ...baseCalc,
+                template: {
+                    type: TableCalculationTemplateType.RUNNING_TOTAL,
+                    fieldId: tableCalc.fieldId,
+                },
+                format: {
+                    type: CustomFormatType.NUMBER,
+                    separator: NumberSeparator.DEFAULT,
+                },
+            };
+        case 'window_function': {
+            const format = tableCalc.windowFunction === 'percent_rank' ||
+                tableCalc.windowFunction === 'cume_dist'
+                ? {
+                    type: CustomFormatType.PERCENT,
+                    separator: NumberSeparator.DEFAULT,
+                }
+                : {
+                    type: CustomFormatType.NUMBER,
+                    separator: NumberSeparator.DEFAULT,
+                };
+            // Convert frame clause string literals to enum types
+            const frame = tableCalc.frame
+                ? {
+                    frameType: tableCalc.frame.frameType === 'rows'
+                        ? FrameType.ROWS
+                        : FrameType.RANGE,
+                    start: tableCalc.frame.start
+                        ? {
+                            type: frameBoundaryStringToEnum(tableCalc.frame.start.type),
+                            offset: tableCalc.frame.start.offset ?? undefined,
+                        }
+                        : undefined,
+                    end: {
+                        type: frameBoundaryStringToEnum(tableCalc.frame.end.type),
+                        offset: tableCalc.frame.end.offset ?? undefined,
+                    },
+                }
+                : undefined;
+            return {
+                ...baseCalc,
+                template: {
+                    type: TableCalculationTemplateType.WINDOW_FUNCTION,
+                    windowFunction: tableCalc.windowFunction,
+                    fieldId: tableCalc.fieldId,
+                    orderBy: tableCalc.orderBy ?? [],
+                    partitionBy: tableCalc.partitionBy ?? [],
+                    frame,
+                },
+                format,
+            };
+        }
+        default:
+            return assertUnreachable(type, 'Unknown table calc type');
+    }
+}
+export function convertAiTableCalcsSchemaToTableCalcs(tableCalcs) {
+    return tableCalcs?.map((tc) => convertTableCalcSchemaToTableCalc(tc)) ?? [];
+}
+//# sourceMappingURL=tableCalcs.js.map

package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableCalcs.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.ts"],"names":[],"mappings":"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"}

package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+const toolSchemaBuilder = (schema) => ({
+    /**
+     * Extends the basic schema with the given fields
+     */
+    extend: (fields) => toolSchemaBuilder(schema.extend(fields)),
+    /**
+     * Adds a page number to the schema, this is useful for tools that rely on pagination
+     */
+    withPagination: () => toolSchemaBuilder(schema.extend({
+        // We need to coerce because LLMs were passing strings instead of numbers quite often (via MCP)
+        page: z.coerce
+            .number()
+            .positive()
+            .nullable()
+            .describe('Use this to paginate through the results'),
+    })),
+    /**
+     * Builds the schema
+     */
+    build: () => schema,
+    /**
+     * Returns the zod schema so far
+     */
+    schema,
+});
+function createToolSchema({ type, description, version, }) {
+    return toolSchemaBuilder(z
+        .object({
+        type: z.literal(version !== undefined
+            ? `${type}_v${version}`
+            : type),
+    })
+        .describe(description));
+}
+export { createToolSchema };
+//# sourceMappingURL=toolSchemaBuilder.js.map

package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSchemaBuilder.js","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/toolSchemaBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,MAAM,iBAAiB,GAAG,CACtB,MAA4B,EACF,EAAE,CAAC,CAAC;IAC9B;;OAEG;IACH,MAAM,EAAE,CAAgC,MAAe,EAAE,EAAE,CACvD,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAEtC;IAEL;;OAEG;IACH,cAAc,EAAE,GAAG,EAAE,CACjB,iBAAiB,CACb,MAAM,CAAC,MAAM,CAAC;QACV,+FAA+F;QAC/F,IAAI,EAAE,CAAC,CAAC,MAAM;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;KAC5D,CAAC,CACgE;IAE1E;;OAEG;IACH,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM;IAEnB;;OAEG;IACH,MAAM;CACT,CAAC,CAAC;AAoBH,SAAS,gBAAgB,CAIvB,EACE,IAAI,EACJ,WAAW,EACX,OAAO,GAKV;IACG,OAAO,iBAAiB,CACpB,CAAC;SACI,MAAM,CAAC;QACJ,IAAI,EAAE,CAAC,CAAC,OAAO,CACX,OAAO,KAAK,SAAS;YACjB,CAAC,CAAE,GAAG,IAAI,KAAK,OAAO,EAAY;YAClC,CAAC,CAAC,IAAI,CACb;KACJ,CAAC;SACD,QAAQ,CAAC,WAAW,CAAC,CAC7B,CAAC;AACN,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/types/ee/AiAgent/schemas/tools/index.js

@@ -0,0 +1,16 @@
+export * from './toolDashboardArgs';
+export * from './toolDashboardV2Args';
+export * from './toolFindChartsArgs';
+export * from './toolFindContentArgs';
+export * from './toolFindDashboardsArgs';
+export * from './toolFindExploresArgs';
+export * from './toolFindFieldsArgs';
+export * from './toolImproveContextArgs';
+export * from './toolProposeChangeArgs';
+export * from './toolRunMetricQueryArgs';
+export * from './toolRunQueryArgs';
+export * from './toolSearchFieldValuesArgs';
+export * from './toolTableVizArgs';
+export * from './toolTimeSeriesArgs';
+export * from './toolVerticalBarArgs';
+//# sourceMappingURL=index.js.map

package/dist/types/ee/AiAgent/schemas/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/types/ee/AiAgent/schemas/tools/toolDashboardArgs.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import assertUnreachable from '../../../../utils/assertUnreachable';
+import { AiResultType } from '../../types';
+import { customMetricsSchema } from '../customMetrics';
+import { filtersSchemaV2 } from '../filters';
+import { baseOutputMetadataSchema } from '../outputMetadata';
+import { tableCalcsSchema } from '../tableCalcs/tableCalcs';
+import { createToolSchema } from '../toolSchemaBuilder';
+import visualizationMetadataSchema from '../visualizationMetadata';
+import { tableVizConfigSchema, verticalBarMetricVizConfigSchema, } from '../visualizations';
+import { timeSeriesMetricVizConfigSchema } from '../visualizations/timeSeriesViz';
+import { toolTableVizArgsSchemaTransformed } from './toolTableVizArgs';
+import { toolTimeSeriesArgsSchemaTransformed } from './toolTimeSeriesArgs';
+import { toolVerticalBarArgsSchemaTransformed } from './toolVerticalBarArgs';
+export const TOOL_DASHBOARD_DESCRIPTION = `Use this tool to generate multiple visualizations for a dashboard based on a specific theme. Instead of making multiple parallel tool calls for individual visualizations, this tool takes an array of visualization configurations and generates them all at once, ensuring thematic consistency and better performance.
+
+Dashboard Design Philosophy:
+Create "summary" or "executive" level dashboards that provide high-level overviews of specific topics (e.g., Support Dashboard, Revenue Performance, Sales Operations). These dashboards should be designed to monitor trends and key metric performance at a glance.
+
+Recommended Dashboard Structure:
+1. **Summary Metrics at the Top**: Start with key performance indicators (KPIs) as tables showing overall summary metrics
+2. **Time-Series Analysis**: Include time-series charts with appropriate granularities to show how metrics trend over time:
+   - Use line charts for smaller granularities (daily, weekly)
+   - Use bar charts for more grouped data (monthly, quarterly)
+3. **Detailed Breakdowns**: Add tables with more detail and specific line items that have the biggest impact on metrics
+   - Show problematic areas that need attention (e.g., longest response times, highest churn segments)
+   - Highlight actionable insights and outliers
+
+Usage tips:
+- Use this when you need to create 2 or more related visualizations for a dashboard
+- Ensure all visualizations follow the same theme and tell a cohesive story
+- Each visualization in the array should have a clear title and description
+- Mix different visualization types strategically: tables for KPIs → time-series for trends → tables for detailed breakdowns
+- Make use of the breakdownByDimension to show more dense visualizations instead of having multiple different charts for the same metric:
+    - "metric A over time, broken down by dimension B"
+    - "dimension A broken down by dimension B, with Y axis of important metric"
+- If some of the visualizations fail to generate, you can still generate the dashboard with the successful visualizations and return a message about the failed visualizations.
+`;
+// Base visualization schema that all visualizations must have
+const baseVisualizationSchema = z.object({
+    ...visualizationMetadataSchema.shape,
+    customMetrics: customMetricsSchema,
+    tableCalculations: tableCalcsSchema,
+    filters: filtersSchemaV2
+        .nullable()
+        .describe('Filters to apply to the query. Filtered fields must exist in the selected explore or should be referenced from the custom metrics.'),
+});
+const dashboardTableVisualizationSchema = baseVisualizationSchema.extend({
+    type: z.literal(AiResultType.TABLE_RESULT),
+    vizConfig: tableVizConfigSchema,
+});
+const dashboardTimeSeriesVisualizationSchema = baseVisualizationSchema.extend({
+    type: z.literal(AiResultType.TIME_SERIES_RESULT),
+    vizConfig: timeSeriesMetricVizConfigSchema,
+});
+const dashboardBarVisualizationSchema = baseVisualizationSchema.extend({
+    type: z.literal(AiResultType.VERTICAL_BAR_RESULT),
+    vizConfig: verticalBarMetricVizConfigSchema,
+});
+const dashboardVisualizationSchema = z
+    .union([
+    dashboardTableVisualizationSchema,
+    dashboardTimeSeriesVisualizationSchema,
+    dashboardBarVisualizationSchema,
+])
+    // we don't need followUpTools for dashboard charts but for schema compat reasons we add it here
+    .transform((viz) => ({ ...viz, followUpTools: [] }));
+export const toolDashboardArgsSchema = createToolSchema({
+    type: AiResultType.DASHBOARD_RESULT,
+    description: TOOL_DASHBOARD_DESCRIPTION,
+})
+    .extend({
+    title: z.string().describe('A descriptive title for the dashboard'),
+    description: z
+        .string()
+        .describe('A descriptive summary or explanation for the dashboard.'),
+    visualizations: z
+        .array(dashboardVisualizationSchema)
+        .min(2)
+        .max(15)
+        .describe('Array of visualization configurations to generate for this dashboard. Each should contribute to the overall theme.'),
+})
+    .build();
+export const toolDashboardArgsSchemaTransformed = toolDashboardArgsSchema.transform((data) => ({
+    ...data,
+    visualizations: data.visualizations.map((vis) => {
+        switch (vis.type) {
+            case AiResultType.TABLE_RESULT:
+                return toolTableVizArgsSchemaTransformed.parse(vis);
+            case AiResultType.TIME_SERIES_RESULT:
+                return toolTimeSeriesArgsSchemaTransformed.parse(vis);
+            case AiResultType.VERTICAL_BAR_RESULT:
+                return toolVerticalBarArgsSchemaTransformed.parse(vis);
+            default:
+                return assertUnreachable(vis, 'Invalid visualization type');
+        }
+    }),
+}));
+export const toolDashboardOutputSchema = z.object({
+    result: z.string(),
+    metadata: baseOutputMetadataSchema,
+});
+//# sourceMappingURL=toolDashboardArgs.js.map

package/dist/types/ee/AiAgent/schemas/tools/toolDashboardArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDashboardArgs.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tools/toolDashboardArgs.ts"],"names":[],"mappings":"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"}