@lightdash/common 1.218.0 → 1.219.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/dist/cjs/.tsbuildinfo +1 -1
  2. package/dist/cjs/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +28 -0
  3. package/dist/cjs/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts.map +1 -1
  4. package/dist/cjs/ee/AiAgent/schemas/index.d.ts +1 -0
  5. package/dist/cjs/ee/AiAgent/schemas/index.d.ts.map +1 -1
  6. package/dist/cjs/ee/AiAgent/schemas/index.js +1 -0
  7. package/dist/cjs/ee/AiAgent/schemas/index.js.map +1 -1
  8. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.d.ts +33 -0
  9. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.d.ts.map +1 -0
  10. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.js +53 -0
  11. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.js.map +1 -0
  12. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.d.ts +68 -0
  13. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.d.ts.map +1 -1
  14. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.js +68 -4
  15. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.js.map +1 -1
  16. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.d.ts +2 -0
  17. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.d.ts.map +1 -0
  18. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.js +141 -0
  19. package/dist/cjs/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.js.map +1 -0
  20. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardArgs.d.ts +5013 -4563
  21. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardArgs.d.ts.map +1 -1
  22. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts +12218 -11042
  23. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts.map +1 -1
  24. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.js +23 -5
  25. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.js.map +1 -1
  26. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.d.ts +2 -0
  27. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.d.ts.map +1 -0
  28. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.js +60 -0
  29. package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.js.map +1 -0
  30. package/dist/cjs/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +427 -341
  31. package/dist/cjs/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts.map +1 -1
  32. package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts +20445 -4139
  33. package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts.map +1 -1
  34. package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.js +34 -4
  35. package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.js.map +1 -1
  36. package/dist/cjs/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.d.ts +410 -410
  37. package/dist/cjs/ee/AiAgent/schemas/tools/toolTableVizArgs.d.ts +1628 -1542
  38. package/dist/cjs/ee/AiAgent/schemas/tools/toolTableVizArgs.d.ts.map +1 -1
  39. package/dist/cjs/ee/AiAgent/schemas/tools/toolTimeSeriesArgs.d.ts +1113 -1027
  40. package/dist/cjs/ee/AiAgent/schemas/tools/toolTimeSeriesArgs.d.ts.map +1 -1
  41. package/dist/cjs/ee/AiAgent/schemas/tools/toolVerticalBarArgs.d.ts +595 -509
  42. package/dist/cjs/ee/AiAgent/schemas/tools/toolVerticalBarArgs.d.ts.map +1 -1
  43. package/dist/cjs/ee/AiAgent/utils.d.ts +28 -0
  44. package/dist/cjs/ee/AiAgent/utils.d.ts.map +1 -1
  45. package/dist/cjs/ee/AiAgent/utils.js +1 -1
  46. package/dist/cjs/ee/AiAgent/utils.js.map +1 -1
  47. package/dist/cjs/ee/AiAgent/utils.test.js +53 -0
  48. package/dist/cjs/ee/AiAgent/utils.test.js.map +1 -1
  49. package/dist/cjs/schemas/json/lightdash-project-config-1.0.json +4 -0
  50. package/dist/cjs/schemas/json/mcp-tools-1.0.json +48 -1
  51. package/dist/cjs/types/lightdashProjectConfig.d.ts +7 -0
  52. package/dist/cjs/types/lightdashProjectConfig.d.ts.map +1 -1
  53. package/dist/cjs/types/lightdashProjectConfig.js.map +1 -1
  54. package/dist/esm/.tsbuildinfo +1 -1
  55. package/dist/esm/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +28 -0
  56. package/dist/esm/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts.map +1 -1
  57. package/dist/esm/ee/AiAgent/schemas/index.d.ts +1 -0
  58. package/dist/esm/ee/AiAgent/schemas/index.d.ts.map +1 -1
  59. package/dist/esm/ee/AiAgent/schemas/index.js +1 -0
  60. package/dist/esm/ee/AiAgent/schemas/index.js.map +1 -1
  61. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.d.ts +33 -0
  62. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.d.ts.map +1 -0
  63. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.js +49 -0
  64. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.js.map +1 -0
  65. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.d.ts +68 -0
  66. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.d.ts.map +1 -1
  67. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.js +67 -3
  68. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.js.map +1 -1
  69. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.d.ts +2 -0
  70. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.d.ts.map +1 -0
  71. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.js +139 -0
  72. package/dist/esm/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.js.map +1 -0
  73. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardArgs.d.ts +5013 -4563
  74. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardArgs.d.ts.map +1 -1
  75. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts +12218 -11042
  76. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts.map +1 -1
  77. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.js +23 -5
  78. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.js.map +1 -1
  79. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.d.ts +2 -0
  80. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.d.ts.map +1 -0
  81. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.js +58 -0
  82. package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.js.map +1 -0
  83. package/dist/esm/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +427 -341
  84. package/dist/esm/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts.map +1 -1
  85. package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts +20445 -4139
  86. package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts.map +1 -1
  87. package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.js +34 -4
  88. package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.js.map +1 -1
  89. package/dist/esm/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.d.ts +410 -410
  90. package/dist/esm/ee/AiAgent/schemas/tools/toolTableVizArgs.d.ts +1628 -1542
  91. package/dist/esm/ee/AiAgent/schemas/tools/toolTableVizArgs.d.ts.map +1 -1
  92. package/dist/esm/ee/AiAgent/schemas/tools/toolTimeSeriesArgs.d.ts +1113 -1027
  93. package/dist/esm/ee/AiAgent/schemas/tools/toolTimeSeriesArgs.d.ts.map +1 -1
  94. package/dist/esm/ee/AiAgent/schemas/tools/toolVerticalBarArgs.d.ts +595 -509
  95. package/dist/esm/ee/AiAgent/schemas/tools/toolVerticalBarArgs.d.ts.map +1 -1
  96. package/dist/esm/ee/AiAgent/utils.d.ts +28 -0
  97. package/dist/esm/ee/AiAgent/utils.d.ts.map +1 -1
  98. package/dist/esm/ee/AiAgent/utils.js +2 -2
  99. package/dist/esm/ee/AiAgent/utils.js.map +1 -1
  100. package/dist/esm/ee/AiAgent/utils.test.js +53 -0
  101. package/dist/esm/ee/AiAgent/utils.test.js.map +1 -1
  102. package/dist/esm/schemas/json/lightdash-project-config-1.0.json +4 -0
  103. package/dist/esm/schemas/json/mcp-tools-1.0.json +48 -1
  104. package/dist/esm/types/lightdashProjectConfig.d.ts +7 -0
  105. package/dist/esm/types/lightdashProjectConfig.d.ts.map +1 -1
  106. package/dist/esm/types/lightdashProjectConfig.js.map +1 -1
  107. package/dist/types/.tsbuildinfo +1 -1
  108. package/dist/types/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +28 -0
  109. package/dist/types/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts.map +1 -1
  110. package/dist/types/ee/AiAgent/schemas/index.d.ts +1 -0
  111. package/dist/types/ee/AiAgent/schemas/index.d.ts.map +1 -1
  112. package/dist/types/ee/AiAgent/schemas/index.js +1 -0
  113. package/dist/types/ee/AiAgent/schemas/index.js.map +1 -1
  114. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.d.ts +33 -0
  115. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.d.ts.map +1 -0
  116. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.js +49 -0
  117. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.js.map +1 -0
  118. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.d.ts +68 -0
  119. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.d.ts.map +1 -1
  120. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.js +67 -3
  121. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.js.map +1 -1
  122. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.d.ts +2 -0
  123. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.d.ts.map +1 -0
  124. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.js +139 -0
  125. package/dist/types/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.js.map +1 -0
  126. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardArgs.d.ts +5013 -4563
  127. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardArgs.d.ts.map +1 -1
  128. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts +12218 -11042
  129. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts.map +1 -1
  130. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.js +23 -5
  131. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.js.map +1 -1
  132. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.d.ts +2 -0
  133. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.d.ts.map +1 -0
  134. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.js +58 -0
  135. package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.test.js.map +1 -0
  136. package/dist/types/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +427 -341
  137. package/dist/types/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts.map +1 -1
  138. package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts +20445 -4139
  139. package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts.map +1 -1
  140. package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.js +34 -4
  141. package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.js.map +1 -1
  142. package/dist/types/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.d.ts +410 -410
  143. package/dist/types/ee/AiAgent/schemas/tools/toolTableVizArgs.d.ts +1628 -1542
  144. package/dist/types/ee/AiAgent/schemas/tools/toolTableVizArgs.d.ts.map +1 -1
  145. package/dist/types/ee/AiAgent/schemas/tools/toolTimeSeriesArgs.d.ts +1113 -1027
  146. package/dist/types/ee/AiAgent/schemas/tools/toolTimeSeriesArgs.d.ts.map +1 -1
  147. package/dist/types/ee/AiAgent/schemas/tools/toolVerticalBarArgs.d.ts +595 -509
  148. package/dist/types/ee/AiAgent/schemas/tools/toolVerticalBarArgs.d.ts.map +1 -1
  149. package/dist/types/ee/AiAgent/utils.d.ts +28 -0
  150. package/dist/types/ee/AiAgent/utils.d.ts.map +1 -1
  151. package/dist/types/ee/AiAgent/utils.js +2 -2
  152. package/dist/types/ee/AiAgent/utils.js.map +1 -1
  153. package/dist/types/ee/AiAgent/utils.test.js +53 -0
  154. package/dist/types/ee/AiAgent/utils.test.js.map +1 -1
  155. package/dist/types/schemas/json/lightdash-project-config-1.0.json +4 -0
  156. package/dist/types/schemas/json/mcp-tools-1.0.json +48 -1
  157. package/dist/types/types/lightdashProjectConfig.d.ts +7 -0
  158. package/dist/types/types/lightdashProjectConfig.d.ts.map +1 -1
  159. package/dist/types/types/lightdashProjectConfig.js.map +1 -1
  160. package/package.json +1 -1
@@ -30,6 +30,13 @@ export declare const getWebAiChartConfig: ({ vizConfig, metricQuery, maxQueryLim
30
30
  yAxisLabel: string | null;
31
31
  };
32
32
  tableCalculations: ({
33
+ name: string;
34
+ displayName: string;
35
+ type: "formula";
36
+ formula: string;
37
+ format: "number" | "percent" | null;
38
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
39
+ } | {
33
40
  name: string;
34
41
  displayName: string;
35
42
  type: "percent_change_from_previous";
@@ -115,6 +122,13 @@ export declare const getWebAiChartConfig: ({ vizConfig, metricQuery, maxQueryLim
115
122
  yAxisLabel: string;
116
123
  };
117
124
  tableCalculations: ({
125
+ name: string;
126
+ displayName: string;
127
+ type: "formula";
128
+ formula: string;
129
+ format: "number" | "percent" | null;
130
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
131
+ } | {
118
132
  name: string;
119
133
  displayName: string;
120
134
  type: "percent_change_from_previous";
@@ -196,6 +210,13 @@ export declare const getWebAiChartConfig: ({ vizConfig, metricQuery, maxQueryLim
196
210
  limit: number | null;
197
211
  };
198
212
  tableCalculations: ({
213
+ name: string;
214
+ displayName: string;
215
+ type: "formula";
216
+ formula: string;
217
+ format: "number" | "percent" | null;
218
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
219
+ } | {
199
220
  name: string;
200
221
  displayName: string;
201
222
  type: "percent_change_from_previous";
@@ -278,6 +299,13 @@ export declare const getWebAiChartConfig: ({ vizConfig, metricQuery, maxQueryLim
278
299
  parameters: Record<string, string | number | string[] | number[]> | null;
279
300
  customMetrics: import("../..").TransformedCustomMetric[] | null;
280
301
  tableCalculations: ({
302
+ name: string;
303
+ displayName: string;
304
+ type: "formula";
305
+ formula: string;
306
+ format: "number" | "percent" | null;
307
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
308
+ } | {
281
309
  name: string;
282
310
  displayName: string;
283
311
  type: "percent_change_from_previous";
@@ -1 +1 @@
1
- {"version":3,"file":"getWebAiChartConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/chartConfig/web/getWebAiChartConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,eAAO,MAAM,mBAAmB,6EAM7B;IACC,SAAS,EACH,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,QAAQ,CAAC;IACpB,iBAAiB,CAAC,EACZ,OAAO,GACP,KAAK,GACL,YAAY,GACZ,MAAM,GACN,SAAS,GACT,KAAK,GACL,QAAQ,CAAC;CAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDA,CAAC"}
1
+ {"version":3,"file":"getWebAiChartConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/chartConfig/web/getWebAiChartConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,eAAO,MAAM,mBAAmB,6EAM7B;IACC,SAAS,EACH,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,QAAQ,CAAC;IACpB,iBAAiB,CAAC,EACZ,OAAO,GACP,KAAK,GACL,YAAY,GACZ,MAAM,GACN,SAAS,GACT,KAAK,GACL,QAAQ,CAAC;CAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDA,CAAC"}
@@ -5,6 +5,7 @@ export * from './filters';
5
5
  export * from './McpSchemaCompatLayer';
6
6
  export * from './outputMetadata';
7
7
  export * from './sortField';
8
+ export * from './tableCalcs/tableCalcFormula';
8
9
  export * from './tableCalcs/tableCalcs';
9
10
  export * from './tools';
10
11
  export * from './visualizations';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,qCAAqC,EAC1C,KAAK,gCAAgC,EACrC,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC7B,MAAM,SAAS,CAAC;AAEjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAEjC,MAAM,MAAM,eAAe,GACrB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,uBAAuB,GACvB,qCAAqC,GACrC,gCAAgC,GAChC,wBAAwB,GACxB,qBAAqB,GACrB,gCAAgC,GAChC,6BAA6B,GAC7B,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,qBAAqB,GACrB,kBAAkB,GAClB,uBAAuB,GACvB,gBAAgB,GAChB,2BAA2B,GAC3B,6BAA6B,GAC7B,4BAA4B,GAC5B,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,qCAAqC,EAC1C,KAAK,gCAAgC,EACrC,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC7B,MAAM,SAAS,CAAC;AAEjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAEjC,MAAM,MAAM,eAAe,GACrB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,uBAAuB,GACvB,qCAAqC,GACrC,gCAAgC,GAChC,wBAAwB,GACxB,qBAAqB,GACrB,gCAAgC,GAChC,6BAA6B,GAC7B,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,qBAAqB,GACrB,kBAAkB,GAClB,uBAAuB,GACvB,gBAAgB,GAChB,2BAA2B,GAC3B,6BAA6B,GAC7B,4BAA4B,GAC5B,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,CAAC"}
@@ -4,6 +4,7 @@ export * from './filters';
4
4
  export * from './McpSchemaCompatLayer';
5
5
  export * from './outputMetadata';
6
6
  export * from './sortField';
7
+ export * from './tableCalcs/tableCalcFormula';
7
8
  export * from './tableCalcs/tableCalcs';
8
9
  export * from './tools';
9
10
  export * from './visualizations';
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/index.ts"],"names":[],"mappings":"AA8BA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ee/AiAgent/schemas/index.ts"],"names":[],"mappings":"AA8BA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,33 @@
1
+ import { z } from 'zod';
2
+ export declare const FORMULA_SCHEMA_FUNCTION_NAMES: {
3
+ readonly general: readonly ['IF', 'COALESCE', 'ROUND', 'ABS', 'CONCAT'];
4
+ readonly date: readonly ['YEAR', 'DATE_TRUNC', 'DATE_DIFF', 'DATE_ADD'];
5
+ readonly aggregate: readonly ['SUM', 'AVG', 'MIN', 'MAX', 'COUNT', 'SUMIF'];
6
+ readonly window: readonly ['RUNNING_TOTAL', 'MOVING_SUM', 'MOVING_AVG', 'LAG', 'LEAD', 'RANK', 'DENSE_RANK', 'ROW_NUMBER', 'FIRST', 'LAST'];
7
+ };
8
+ export declare function withLeadingEquals(formula: string): string;
9
+ export declare const tableCalcFormulaSchema: z.ZodObject<{
10
+ name: z.ZodString;
11
+ displayName: z.ZodString;
12
+ } & {
13
+ type: z.ZodLiteral<"formula">;
14
+ formula: z.ZodString;
15
+ format: z.ZodNullable<z.ZodEnum<["number", "percent"]>>;
16
+ resultType: z.ZodNullable<z.ZodEnum<["number", "string", "date", "timestamp", "boolean"]>>;
17
+ }, "strip", z.ZodTypeAny, {
18
+ name: string;
19
+ displayName: string;
20
+ type: "formula";
21
+ formula: string;
22
+ format: "number" | "percent" | null;
23
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
24
+ }, {
25
+ name: string;
26
+ displayName: string;
27
+ type: "formula";
28
+ formula: string;
29
+ format: "number" | "percent" | null;
30
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
31
+ }>;
32
+ export type TableCalcFormulaSchema = z.infer<typeof tableCalcFormulaSchema>;
33
+ //# sourceMappingURL=tableCalcFormula.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tableCalcFormula.d.ts","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,6BAA6B;aACtC,OAAO,YAAG,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ;aACpD,IAAI,YAAG,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU;aACpD,SAAS,YAAG,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO;aACxD,MAAM,YACF,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,MAAM;CAEJ,CAAC;AAsBX,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;EAejC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
@@ -0,0 +1,49 @@
1
+ import { z } from 'zod';
2
+ import { baseTableCalcSchema } from './tableCalcBaseSchemas';
3
+ // Names must exist in @lightdash/formula's catalog; common cannot depend on
4
+ // that (private) package, so a backend test guards this list against drift.
5
+ export const FORMULA_SCHEMA_FUNCTION_NAMES = {
6
+ general: ['IF', 'COALESCE', 'ROUND', 'ABS', 'CONCAT'],
7
+ date: ['YEAR', 'DATE_TRUNC', 'DATE_DIFF', 'DATE_ADD'],
8
+ aggregate: ['SUM', 'AVG', 'MIN', 'MAX', 'COUNT', 'SUMIF'],
9
+ window: [
10
+ 'RUNNING_TOTAL',
11
+ 'MOVING_SUM',
12
+ 'MOVING_AVG',
13
+ 'LAG',
14
+ 'LEAD',
15
+ 'RANK',
16
+ 'DENSE_RANK',
17
+ 'ROW_NUMBER',
18
+ 'FIRST',
19
+ 'LAST',
20
+ ],
21
+ };
22
+ const formulaDescription = [
23
+ 'Spreadsheet-like formula evaluated row-by-row over the query results (after aggregation).',
24
+ 'Reference fields by their field id directly, e.g. `orders_total_revenue / orders_order_count`. No prefix, no braces, no leading `=`.',
25
+ 'Any selected dimension, metric, custom metric (`<table>_<name>`), or another table calculation name can be referenced.',
26
+ 'Operators: + - * / % ^, comparisons = < > <= >= <>, boolean AND/OR/NOT, string literals in double quotes, parentheses for grouping.',
27
+ `Functions include ${FORMULA_SCHEMA_FUNCTION_NAMES.general.join(', ')}, date functions (${FORMULA_SCHEMA_FUNCTION_NAMES.date.join(', ')}), aggregates over the whole result (${FORMULA_SCHEMA_FUNCTION_NAMES.aggregate.join(', ')}), and window functions (${FORMULA_SCHEMA_FUNCTION_NAMES.window.join(', ')}).`,
28
+ 'Window functions accept optional PARTITION BY / ORDER BY clauses as trailing arguments, e.g. `LAG(orders_total_revenue, PARTITION BY orders_status, ORDER BY orders_order_date)`.',
29
+ 'MOVING_SUM and MOVING_AVG take the count of preceding rows as second argument; the current row is always included, so a trailing 3-period average is `MOVING_AVG(orders_total_revenue, 2, ORDER BY orders_order_month)`.',
30
+ 'All branches of an IF must return the same type.',
31
+ ].join('\n');
32
+ // The formula grammar requires a leading '='; the agent writes formulas without it
33
+ export function withLeadingEquals(formula) {
34
+ const trimmed = formula.trim();
35
+ return trimmed.startsWith('=') ? trimmed : `=${trimmed}`;
36
+ }
37
+ export const tableCalcFormulaSchema = baseTableCalcSchema.extend({
38
+ type: z.literal('formula'),
39
+ formula: z.string().describe(formulaDescription),
40
+ format: z
41
+ .enum(['number', 'percent'])
42
+ .nullable()
43
+ .describe('Display format. Use "percent" for ratios/shares/percent changes (value 0.12 renders as 12%). null defaults to "number".'),
44
+ resultType: z
45
+ .enum(['number', 'string', 'date', 'timestamp', 'boolean'])
46
+ .nullable()
47
+ .describe('Data type the formula evaluates to. null defaults to "number".'),
48
+ });
49
+ //# sourceMappingURL=tableCalcFormula.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tableCalcFormula.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcFormula.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,4EAA4E;AAC5E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,6BAA6B,GAAG;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC;IACrD,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC;IACrD,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC;IACzD,MAAM,EAAE;QACJ,eAAe;QACf,YAAY;QACZ,YAAY;QACZ,KAAK;QACL,MAAM;QACN,MAAM;QACN,YAAY;QACZ,YAAY;QACZ,OAAO;QACP,MAAM;KACT;CACK,CAAC;AAEX,MAAM,kBAAkB,GAAG;IACvB,2FAA2F;IAC3F,sIAAsI;IACtI,wHAAwH;IACxH,qIAAqI;IACrI,qBAAqB,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAC3D,IAAI,CACP,qBAAqB,6BAA6B,CAAC,IAAI,CAAC,IAAI,CACzD,IAAI,CACP,wCAAwC,6BAA6B,CAAC,SAAS,CAAC,IAAI,CACjF,IAAI,CACP,4BAA4B,6BAA6B,CAAC,MAAM,CAAC,IAAI,CAClE,IAAI,CACP,IAAI;IACL,mLAAmL;IACnL,0NAA0N;IAC1N,kDAAkD;CACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAChD,MAAM,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CACL,yHAAyH,CAC5H;IACL,UAAU,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,CACL,gEAAgE,CACnE;CACR,CAAC,CAAC"}
@@ -3,6 +3,28 @@ import { type TableCalculation } from '../../../../types/field';
3
3
  declare const tableCalcSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4
4
  name: z.ZodString;
5
5
  displayName: z.ZodString;
6
+ } & {
7
+ type: z.ZodLiteral<"formula">;
8
+ formula: z.ZodString;
9
+ format: z.ZodNullable<z.ZodEnum<["number", "percent"]>>;
10
+ resultType: z.ZodNullable<z.ZodEnum<["number", "string", "date", "timestamp", "boolean"]>>;
11
+ }, "strip", z.ZodTypeAny, {
12
+ name: string;
13
+ displayName: string;
14
+ type: "formula";
15
+ formula: string;
16
+ format: "number" | "percent" | null;
17
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
18
+ }, {
19
+ name: string;
20
+ displayName: string;
21
+ type: "formula";
22
+ formula: string;
23
+ format: "number" | "percent" | null;
24
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
25
+ }>, z.ZodObject<{
26
+ name: z.ZodString;
27
+ displayName: z.ZodString;
6
28
  } & {
7
29
  type: z.ZodLiteral<"percent_change_from_previous">;
8
30
  fieldId: z.ZodString;
@@ -235,6 +257,28 @@ export type TableCalcSchema = z.infer<typeof tableCalcSchema>;
235
257
  export declare const tableCalcsSchema: z.ZodNullable<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
236
258
  name: z.ZodString;
237
259
  displayName: z.ZodString;
260
+ } & {
261
+ type: z.ZodLiteral<"formula">;
262
+ formula: z.ZodString;
263
+ format: z.ZodNullable<z.ZodEnum<["number", "percent"]>>;
264
+ resultType: z.ZodNullable<z.ZodEnum<["number", "string", "date", "timestamp", "boolean"]>>;
265
+ }, "strip", z.ZodTypeAny, {
266
+ name: string;
267
+ displayName: string;
268
+ type: "formula";
269
+ formula: string;
270
+ format: "number" | "percent" | null;
271
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
272
+ }, {
273
+ name: string;
274
+ displayName: string;
275
+ type: "formula";
276
+ formula: string;
277
+ format: "number" | "percent" | null;
278
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
279
+ }>, z.ZodObject<{
280
+ name: z.ZodString;
281
+ displayName: z.ZodString;
238
282
  } & {
239
283
  type: z.ZodLiteral<"percent_change_from_previous">;
240
284
  fieldId: z.ZodString;
@@ -464,6 +508,30 @@ export declare const tableCalcsSchema: z.ZodNullable<z.ZodArray<z.ZodDiscriminat
464
508
  } | null;
465
509
  }>]>, "many">>;
466
510
  export type TableCalcsSchema = z.infer<typeof tableCalcsSchema>;
511
+ export declare const formulaTableCalcsSchema: z.ZodNullable<z.ZodArray<z.ZodObject<{
512
+ name: z.ZodString;
513
+ displayName: z.ZodString;
514
+ } & {
515
+ type: z.ZodLiteral<"formula">;
516
+ formula: z.ZodString;
517
+ format: z.ZodNullable<z.ZodEnum<["number", "percent"]>>;
518
+ resultType: z.ZodNullable<z.ZodEnum<["number", "string", "date", "timestamp", "boolean"]>>;
519
+ }, "strip", z.ZodTypeAny, {
520
+ name: string;
521
+ displayName: string;
522
+ type: "formula";
523
+ formula: string;
524
+ format: "number" | "percent" | null;
525
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
526
+ }, {
527
+ name: string;
528
+ displayName: string;
529
+ type: "formula";
530
+ formula: string;
531
+ format: "number" | "percent" | null;
532
+ resultType: "boolean" | "date" | "number" | "string" | "timestamp" | null;
533
+ }>, "many">>;
534
+ export type FormulaTableCalcsSchema = z.infer<typeof formulaTableCalcsSchema>;
467
535
  export declare function convertAiTableCalcsSchemaToTableCalcs(tableCalcs: TableCalcsSchema): TableCalculation[];
468
536
  export {};
469
537
  //# sourceMappingURL=tableCalcs.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tableCalcs.d.ts","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAOH,KAAK,gBAAgB,EACxB,MAAM,yBAAyB,CAAC;AASjC,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOnB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAY3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAgKhE,wBAAgB,qCAAqC,CACjD,UAAU,EAAE,gBAAgB,GAC7B,gBAAgB,EAAE,CAEpB"}
1
+ {"version":3,"file":"tableCalcs.d.ts","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAOH,KAAK,gBAAgB,EACxB,MAAM,yBAAyB,CAAC;AAiBjC,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQnB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAU3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAIhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;YAYlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAwN9E,wBAAgB,qCAAqC,CACjD,UAAU,EAAE,gBAAgB,GAC7B,gBAAgB,EAAE,CAEpB"}
@@ -1,13 +1,18 @@
1
1
  import { z } from 'zod';
2
2
  import { CustomFormatType, FrameBoundaryType, FrameType, NumberSeparator, TableCalculationTemplateType, TableCalculationType, } from '../../../../types/field';
3
3
  import assertUnreachable from '../../../../utils/assertUnreachable';
4
+ import { tableCalcFormulaSchema, withLeadingEquals, } from './tableCalcFormula';
4
5
  import { tableCalcPercentChangeFromPreviousSchema } from './tableCalcPercentChangeFromPrevious';
5
6
  import { tableCalcPercentOfColumnTotalSchema } from './tableCalcPercentOfColumnTotal';
6
7
  import { tableCalcPercentOfPreviousValueSchema } from './tableCalcPercentOfPreviousValue';
7
8
  import { tableCalcRankInColumnSchema } from './tableCalcRankInColumn';
8
9
  import { tableCalcRunningTotalSchema } from './tableCalcRunningTotal';
9
10
  import { tableCalcWindowFunctionSchema } from './tableCalcWindowFunction';
11
+ // Wide union: `formula` plus the legacy template types. Kept for parsing
12
+ // persisted tool args from old threads; new agent contracts advertise
13
+ // formulaTableCalcsSchema only.
10
14
  const tableCalcSchema = z.discriminatedUnion('type', [
15
+ tableCalcFormulaSchema,
11
16
  tableCalcPercentChangeFromPreviousSchema,
12
17
  tableCalcPercentOfPreviousValueSchema,
13
18
  tableCalcPercentOfColumnTotalSchema,
@@ -18,9 +23,7 @@ const tableCalcSchema = z.discriminatedUnion('type', [
18
23
  export const tableCalcsSchema = z.array(tableCalcSchema).nullable().describe(`
19
24
  Table calculations perform row-by-row calculations on query results without collapsing rows. Similar to SQL window functions.
20
25
 
21
- **Available Types:**
22
- - Simple calculations: percent_change_from_previous, percent_of_previous_value, percent_of_column_total, rank_in_column, running_total
23
- - Advanced window_function: Supports row_number, percent_rank, sum, avg, count, min, max with optional partitioning, ordering, and frame clauses
26
+ **Prefer type "formula"** — it expresses arithmetic across fields, ratios, comparisons, conditionals, and partitioned window calculations. The other types are legacy single-field templates kept for backwards compatibility.
24
27
 
25
28
  **Technical Requirements:**
26
29
  - Appear as additional columns in query results
@@ -28,6 +31,21 @@ Table calculations perform row-by-row calculations on query results without coll
28
31
  - Multiple calculations can be combined in a single query
29
32
  - All fields referenced must exist in the query (dimensions, metrics, or other table calculations)
30
33
  `);
34
+ // Formula-only contract advertised to the agent. The wide tableCalcsSchema
35
+ // above still parses everything this produces.
36
+ export const formulaTableCalcsSchema = z
37
+ .array(tableCalcFormulaSchema)
38
+ .nullable().describe(`
39
+ Table calculations perform row-by-row calculations on query results without collapsing rows, using spreadsheet-like formulas.
40
+
41
+ Use them whenever the question needs math the metric query alone can't express: arithmetic across metrics (\`metric_a + metric_b\`), ratios, percent of total, period-over-period change, running totals, moving averages, ranking, row-level comparisons, or aggregating already-aggregated metrics.
42
+
43
+ **Technical Requirements:**
44
+ - Appear as additional columns in query results
45
+ - Can be used in sorts and filters alongside dimensions/metrics
46
+ - Multiple calculations can be combined in a single query; a formula can reference another table calculation by name
47
+ - All fields referenced must be selected in the query (dimensions, metrics, custom metrics, or other table calculations)
48
+ `);
31
49
  function frameBoundaryStringToEnum(boundaryType) {
32
50
  switch (boundaryType) {
33
51
  case 'unbounded_preceding':
@@ -44,6 +62,34 @@ function frameBoundaryStringToEnum(boundaryType) {
44
62
  return assertUnreachable(boundaryType, 'Unknown boundary type');
45
63
  }
46
64
  }
65
+ function formulaFormatToCustomFormatType(format) {
66
+ switch (format) {
67
+ case 'percent':
68
+ return CustomFormatType.PERCENT;
69
+ case 'number':
70
+ case null:
71
+ return CustomFormatType.NUMBER;
72
+ default:
73
+ return assertUnreachable(format, 'Unknown formula format');
74
+ }
75
+ }
76
+ function formulaResultTypeToTableCalculationType(resultType) {
77
+ switch (resultType) {
78
+ case 'string':
79
+ return TableCalculationType.STRING;
80
+ case 'date':
81
+ return TableCalculationType.DATE;
82
+ case 'timestamp':
83
+ return TableCalculationType.TIMESTAMP;
84
+ case 'boolean':
85
+ return TableCalculationType.BOOLEAN;
86
+ case 'number':
87
+ case null:
88
+ return TableCalculationType.NUMBER;
89
+ default:
90
+ return assertUnreachable(resultType, 'Unknown formula result type');
91
+ }
92
+ }
47
93
  function convertTableCalcSchemaToTableCalc(tableCalc) {
48
94
  const { type, name, displayName } = tableCalc;
49
95
  // Build the template
@@ -53,6 +99,24 @@ function convertTableCalcSchemaToTableCalc(tableCalc) {
53
99
  type: TableCalculationType.NUMBER,
54
100
  };
55
101
  switch (type) {
102
+ case 'formula': {
103
+ const resultType = formulaResultTypeToTableCalculationType(tableCalc.resultType);
104
+ return {
105
+ ...baseCalc,
106
+ type: resultType,
107
+ // Persisted formulas carry the leading '=' the grammar requires
108
+ formula: withLeadingEquals(tableCalc.formula),
109
+ // Numeric display formats don't apply to non-numeric results
110
+ ...(resultType === TableCalculationType.NUMBER
111
+ ? {
112
+ format: {
113
+ type: formulaFormatToCustomFormatType(tableCalc.format),
114
+ separator: NumberSeparator.DEFAULT,
115
+ },
116
+ }
117
+ : {}),
118
+ };
119
+ }
56
120
  case 'percent_change_from_previous':
57
121
  return {
58
122
  ...baseCalc,
@@ -1 +1 @@
1
- {"version":3,"file":"tableCalcs.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tableCalcs.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=tableCalcs.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tableCalcs.test.d.ts","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,139 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { CustomFormatType, TableCalculationType, } from '../../../../types/field';
3
+ import { convertAiTableCalcsSchemaToTableCalcs, formulaTableCalcsSchema, tableCalcsSchema, } from './tableCalcs';
4
+ describe('tableCalcsSchema (wide, persisted args)', () => {
5
+ it('parses legacy template entries', () => {
6
+ const result = tableCalcsSchema.safeParse([
7
+ {
8
+ type: 'running_total',
9
+ name: 'running_revenue',
10
+ displayName: 'Running Revenue',
11
+ fieldId: 'orders_revenue',
12
+ },
13
+ ]);
14
+ expect(result.success).toBe(true);
15
+ });
16
+ it('parses formula entries', () => {
17
+ const result = tableCalcsSchema.safeParse([
18
+ {
19
+ type: 'formula',
20
+ name: 'aov',
21
+ displayName: 'AOV',
22
+ formula: 'orders_revenue / orders_count',
23
+ format: null,
24
+ resultType: null,
25
+ },
26
+ ]);
27
+ expect(result.success).toBe(true);
28
+ });
29
+ });
30
+ describe('formulaTableCalcsSchema (advertised agent contract)', () => {
31
+ it('accepts formula entries', () => {
32
+ const result = formulaTableCalcsSchema.safeParse([
33
+ {
34
+ type: 'formula',
35
+ name: 'aov',
36
+ displayName: 'AOV',
37
+ formula: 'orders_revenue / orders_count',
38
+ format: 'number',
39
+ resultType: 'number',
40
+ },
41
+ ]);
42
+ expect(result.success).toBe(true);
43
+ });
44
+ it('rejects legacy template entries', () => {
45
+ const result = formulaTableCalcsSchema.safeParse([
46
+ {
47
+ type: 'running_total',
48
+ name: 'running_revenue',
49
+ displayName: 'Running Revenue',
50
+ fieldId: 'orders_revenue',
51
+ },
52
+ ]);
53
+ expect(result.success).toBe(false);
54
+ });
55
+ });
56
+ describe('convertAiTableCalcsSchemaToTableCalcs', () => {
57
+ it('converts a formula calc, adding the leading equals sign', () => {
58
+ const [calc] = convertAiTableCalcsSchemaToTableCalcs([
59
+ {
60
+ type: 'formula',
61
+ name: 'aov',
62
+ displayName: 'AOV',
63
+ formula: 'orders_revenue / orders_count',
64
+ format: null,
65
+ resultType: null,
66
+ },
67
+ ]);
68
+ expect(calc).toEqual({
69
+ name: 'aov',
70
+ displayName: 'AOV',
71
+ type: TableCalculationType.NUMBER,
72
+ formula: '=orders_revenue / orders_count',
73
+ format: {
74
+ type: CustomFormatType.NUMBER,
75
+ separator: 'default',
76
+ },
77
+ });
78
+ });
79
+ it('keeps an existing leading equals sign', () => {
80
+ const [calc] = convertAiTableCalcsSchemaToTableCalcs([
81
+ {
82
+ type: 'formula',
83
+ name: 'doubled',
84
+ displayName: 'Doubled',
85
+ formula: '=orders_revenue * 2',
86
+ format: null,
87
+ resultType: null,
88
+ },
89
+ ]);
90
+ expect(calc).toMatchObject({ formula: '=orders_revenue * 2' });
91
+ });
92
+ it('maps percent format and non-number result types', () => {
93
+ const [percentCalc, boolCalc] = convertAiTableCalcsSchemaToTableCalcs([
94
+ {
95
+ type: 'formula',
96
+ name: 'share',
97
+ displayName: 'Share',
98
+ formula: 'orders_revenue / SUM(orders_revenue)',
99
+ format: 'percent',
100
+ resultType: null,
101
+ },
102
+ {
103
+ type: 'formula',
104
+ name: 'is_late',
105
+ displayName: 'Is late',
106
+ formula: 'orders_shipped_date > orders_due_date',
107
+ format: null,
108
+ resultType: 'boolean',
109
+ },
110
+ ]);
111
+ expect(percentCalc).toMatchObject({
112
+ format: { type: CustomFormatType.PERCENT },
113
+ type: TableCalculationType.NUMBER,
114
+ });
115
+ expect(boolCalc).toMatchObject({
116
+ type: TableCalculationType.BOOLEAN,
117
+ });
118
+ expect(boolCalc).not.toHaveProperty('format');
119
+ });
120
+ it('still converts legacy template calcs to template table calculations', () => {
121
+ const [calc] = convertAiTableCalcsSchemaToTableCalcs([
122
+ {
123
+ type: 'running_total',
124
+ name: 'running_revenue',
125
+ displayName: 'Running Revenue',
126
+ fieldId: 'orders_revenue',
127
+ },
128
+ ]);
129
+ expect(calc).toMatchObject({
130
+ name: 'running_revenue',
131
+ template: {
132
+ type: 'running_total',
133
+ fieldId: 'orders_revenue',
134
+ },
135
+ });
136
+ expect(calc).not.toHaveProperty('formula');
137
+ });
138
+ });
139
+ //# sourceMappingURL=tableCalcs.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tableCalcs.test.js","sourceRoot":"","sources":["../../../../../../src/ee/AiAgent/schemas/tableCalcs/tableCalcs.test.ts"],"names":[],"mappings":"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"}