@katerai/sdk 0.10.0 → 0.11.0

package/resources/v1/compiler/compiler.d.mts

@@ -1,11 +1,17 @@
 import { APIResource } from "../../../core/resource.mjs";
 import * as CompilerAPI from "./compiler.mjs";
 import * as CacheAPI from "./cache.mjs";
-import { Cache, CacheInvalidateParams, CacheInvalidateResponse } from "./cache.mjs";
+import { Cache } from "./cache.mjs";
+import * as CombinationAPI from "./combination.mjs";
+import { Combination as CombinationAPICombination, CombinationPreviewParams, CombinationPreviewResponse } from "./combination.mjs";
+import * as ManifestAPI from "./manifest.mjs";
+import { ManifestRegenerateAndCreatePrParams, ManifestRegenerateAndCreatePrResponse } from "./manifest.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Compiler extends APIResource {
     cache: CacheAPI.Cache;
+    combination: CombinationAPI.Combination;
+    manifest: ManifestAPI.Manifest;
     /**
      * Compile a resolved query to SQL.
      *
@@ -15,6 +21,15 @@ export declare class Compiler extends APIResource {
      * RLS: Filtered to current client (ClientRLSDB).
      */
     compile(params: CompilerCompileParams, options?: RequestOptions): APIPromise<CompilerCompileResponse>;
+    /**
+     * Compile a dashboard YAML file into fully resolved widget data.
+     *
+     * Reads a dashboard YAML from the client repo, resolves all data slots, executes
+     * queries, applies filters, and returns renderable widget data.
+     *
+     * RLS: Filtered to current client (ClientRLSDB).
+     */
+    compileDashboard(params: CompilerCompileDashboardParams, options?: RequestOptions): APIPromise<CompilerCompileDashboardResponse>;
     /**
      * Enumerate every valid query configuration for a connection.
      *
@@ -215,6 +230,10 @@ export interface CompilerCompileResponse {
      * Compilation metadata from the compiler.
      */
     metadata?: CompilerCompileResponse.Metadata | null;
+    /**
+     * Write-back request ID. Non-null when files were dispatched to CLI via WebSocket.
+     */
+    request_id?: string | null;
     /**
      * Generated SQL statement
      */
@@ -277,6 +296,244 @@ export declare namespace CompilerCompileResponse {
         views_used?: Array<string>;
     }
 }
+/**
+ * Response from dashboard compilation — fully resolved dashboard.
+ */
+export interface CompilerCompileDashboardResponse {
+    /**
+     * Dashboard context for widgets
+     */
+    context: CompilerCompileDashboardResponse.Context;
+    /**
+     * Dashboard metadata
+     */
+    dashboard: CompilerCompileDashboardResponse.Dashboard;
+    /**
+     * Dashboard-level compilation errors
+     */
+    errors?: Array<CompilerErrorItem>;
+    /**
+     * Resolved filter definitions with current values
+     */
+    filters?: Array<CompilerCompileDashboardResponse.Filter>;
+    /**
+     * Fully resolved widgets with data + config
+     */
+    widgets?: Array<CompilerCompileDashboardResponse.Widget>;
+}
+export declare namespace CompilerCompileDashboardResponse {
+    /**
+     * Dashboard context for widgets
+     */
+    interface Context {
+        /**
+         * Active filter values: {name: {value, label}}
+         */
+        filters?: {
+            [key: string]: {
+                [key: string]: unknown;
+            };
+        } | null;
+        /**
+         * Active timeframe: {label, start, end}
+         */
+        timeframe?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Dashboard topic: {label, time_dimension}
+         */
+        topic?: {
+            [key: string]: string;
+        } | null;
+    }
+    /**
+     * Dashboard metadata
+     */
+    interface Dashboard {
+        /**
+         * Dashboard name
+         */
+        name: string;
+        /**
+         * Dashboard description
+         */
+        description?: string | null;
+        /**
+         * Dashboard kater_id
+         */
+        kater_id?: string | null;
+        /**
+         * Dashboard display label
+         */
+        label?: string | null;
+        /**
+         * Dashboard topic reference
+         */
+        topic?: string | null;
+    }
+    /**
+     * A resolved dashboard filter with current value and presets.
+     */
+    interface Filter {
+        /**
+         * Filter type: date_range, multi_select, select
+         */
+        filter_type: string;
+        /**
+         * Filter name
+         */
+        name: string;
+        /**
+         * Whether null (All) is allowed
+         */
+        allow_null?: boolean;
+        /**
+         * Whether filter auto-applies to queries
+         */
+        auto_apply?: boolean;
+        /**
+         * Current filter value
+         */
+        current_value?: string | Array<string> | null;
+        /**
+         * Default value specification
+         */
+        default?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Field reference for data-driven filters
+         */
+        field?: string | null;
+        /**
+         * Label for null/All option
+         */
+        null_label?: string | null;
+        /**
+         * Available presets
+         */
+        presets?: Array<{
+            [key: string]: string;
+        }> | null;
+    }
+    /**
+     * A fully resolved widget ready for rendering.
+     */
+    interface Widget {
+        /**
+         * Column metadata (single or multi-query)
+         */
+        column_map: Array<Widget.UnionMember0> | Array<Array<Widget.UnionMember1>>;
+        /**
+         * Fully resolved WidgetConfig
+         */
+        config: {
+            [key: string]: unknown;
+        };
+        /**
+         * Query result data (single or multi-query)
+         */
+        data: Array<{
+            [key: string]: unknown;
+        }> | Array<Array<{
+            [key: string]: unknown;
+        }>>;
+        /**
+         * Grid position
+         */
+        grid: Widget.Grid;
+        /**
+         * Widget unique identifier
+         */
+        kater_id: string;
+        /**
+         * Widget name
+         */
+        name: string;
+        /**
+         * Display mode for multi-query: 'tabs' or 'grid'
+         */
+        display_mode?: string | null;
+        /**
+         * Per-widget compilation errors
+         */
+        errors?: Array<CompilerAPI.CompilerErrorItem>;
+        /**
+         * Per-slot configs for multi-query containers
+         */
+        slot_configs?: Array<{
+            [key: string]: unknown;
+        }> | null;
+        /**
+         * Resolved widget type
+         */
+        widget_type?: string | null;
+    }
+    namespace Widget {
+        /**
+         * Maps a UUID column alias to its human-readable name and type.
+         */
+        interface UnionMember0 {
+            /**
+             * Field type: dimension, measure, or calculation
+             */
+            field_type: string;
+            /**
+             * UUID string used as SQL column alias
+             */
+            kater_id: string;
+            /**
+             * Human-readable column name
+             */
+            name: string;
+            /**
+             * Aggregation type for measures: sum, count, min, max, avg, unknown. None for
+             * non-measures.
+             */
+            aggregation?: string | null;
+            /**
+             * Display label
+             */
+            label?: string | null;
+        }
+        /**
+         * Maps a UUID column alias to its human-readable name and type.
+         */
+        interface UnionMember1 {
+            /**
+             * Field type: dimension, measure, or calculation
+             */
+            field_type: string;
+            /**
+             * UUID string used as SQL column alias
+             */
+            kater_id: string;
+            /**
+             * Human-readable column name
+             */
+            name: string;
+            /**
+             * Aggregation type for measures: sum, count, min, max, avg, unknown. None for
+             * non-measures.
+             */
+            aggregation?: string | null;
+            /**
+             * Display label
+             */
+            label?: string | null;
+        }
+        /**
+         * Grid position
+         */
+        interface Grid {
+            h?: number;
+            w?: number;
+            x?: number;
+            y?: number;
+        }
+    }
+}
 /**
  * Response model for query combination enumeration.
  */
@@ -303,10 +560,20 @@ export declare namespace CompilerEnumerateResponse {
          * Widget category (e.g. 'axis', 'table')
          */
         widget_category: string;
+        /**
+         * Deterministic UUID v5 for this combination
+         */
+        combination_id?: string | null;
         /**
          * Human-readable label for the query
          */
         query_label?: string | null;
+        /**
+         * Field-to-role mapping (e.g. {'due_month': 'x_axis'})
+         */
+        roles?: {
+            [key: string]: string;
+        };
         /**
          * Selected optional calculation names
          */
@@ -329,6 +596,10 @@ export declare namespace CompilerEnumerateResponse {
         variable_assignments?: {
             [key: string]: unknown;
         };
+        /**
+         * Resolved widget type (e.g. 'axis_metric_by_dimensiondate')
+         */
+        widget_type?: string | null;
     }
 }
 /**
@@ -451,6 +722,15 @@ export interface CompilerResolveResponse {
      * Compilation manifest with all named objects.
      */
     manifest?: Manifest | null;
+    /**
+     * Files auto-fixed due to renamed refs. None when no renames detected.
+     */
+    ref_fixes?: Array<CompilerResolveResponse.RefFix> | null;
+    /**
+     * Write-back request ID. Non-null when ref-fix files were dispatched to CLI via
+     * WebSocket.
+     */
+    request_id?: string | null;
 }
 export declare namespace CompilerResolveResponse {
     /**
@@ -477,7 +757,7 @@ export declare namespace CompilerResolveResponse {
         /**
          * Widget category that determines data shape constraints
          */
-        widget_category: 'axis' | 'pie' | 'single_value' | 'heatmap' | 'table' | 'static';
+        widget_category: 'axis' | 'funnel' | 'heatmap' | 'image' | 'kpi_card' | 'pie' | 'table' | 'text';
         /**
          * Usage guidance for AI processing
          */
@@ -507,11 +787,11 @@ export declare namespace CompilerResolveResponse {
         /**
          * Widget types within the declared widget_category that must NOT render this query
          */
-        disallowed_widget_types?: Array<'kpi_card' | 'line_chart' | 'bar_chart' | 'pie_chart' | 'donut_chart' | 'area_chart' | 'scatter_chart' | 'data_table' | 'card_grid' | 'heatmap' | 'gauge' | 'text' | 'image' | 'styled_table' | 'stat_cards' | 'key_value_list'> | null;
+        disallowed_widget_types?: Array<'axis_metric_by_dimension' | 'axis_metric_by_dimensiondate' | 'axis_metric_by_dimensiondate_sliced_by_dimension' | 'axis_scatter_plot' | 'funnel_funnel_chart' | 'heatmap_heatmap' | 'image_image_grid' | 'image_single_image' | 'kpi_measure_with_dimension_expression' | 'kpi_measure_with_secondary_metric' | 'kpi_single_measure_compared_to_prev_period_sparkline' | 'kpi_single_value' | 'pie_pie_chart' | 'table_data_table' | 'table_fancy_subtotal_table' | 'table_key_value_list' | 'table_styled_table' | 'text_data_readout_with_sparkline' | 'text_narrative_text'> | null;
         /**
          * Merged required + selected optional filters
          */
-        filters?: Array<ResolvedQuery.InlineFieldFilter | string | ResolvedQuery.InlineExistsFilter1 | ResolvedQuery.InlineExistsFilter2> | null;
+        filters?: Array<ResolvedQuery.InlineFormulaFilter | string | ResolvedQuery.InlineExistsFilter1 | ResolvedQuery.InlineExistsFilter2> | null;
         /**
          * Ordered list of query refs that were merged during inheritance resolution
          */
@@ -533,10 +813,6 @@ export declare namespace CompilerResolveResponse {
          * (highest/newest first) and asc for ascending (lowest/oldest first).
          */
         order_by?: ResolvedQuery.OrderBy | null;
-        /**
-         * Access grants required to use this query
-         */
-        required_access_grants?: Array<string> | null;
         /**
          * The matched chart recommendation after evaluating chart hints
          */
@@ -590,29 +866,17 @@ export declare namespace CompilerResolveResponse {
             }
         }
         /**
-         * An inline filter using field + operator + values
+         * An inline filter using a SQL/expression formula
          */
-        interface InlineFieldFilter {
-            /**
-             * Reference to the field to filter on
-             */
-            field: string;
+        interface InlineFormulaFilter {
             /**
              * Name of the inline filter
              */
             name: string;
             /**
-             * Filter operator to apply
-             */
-            operator: 'equals' | 'not_equals' | 'in' | 'not_in' | 'greater_than' | 'less_than' | 'greater_than_or_equals' | 'less_than_or_equals' | 'between' | 'in_the_last' | 'in_the_next' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'is_null' | 'is_not_null';
-            /**
-             * SQL expression for the filter value
+             * SQL expression for the filter condition
              */
-            sql_value?: string | null;
-            /**
-             * Fixed values for the filter
-             */
-            static_values?: Array<string | number | boolean> | null;
+            sql: string;
         }
         /**
          * An inline filter using EXISTS or NOT EXISTS with a subquery
@@ -698,11 +962,15 @@ export declare namespace CompilerResolveResponse {
             /**
              * The concrete value bound for this resolution
              */
-            bound_value: string | number | boolean;
+            bound_value: string | number | boolean | Array<string | number | boolean>;
             /**
              * Default value for this variable
              */
-            default: string | number | boolean;
+            default: string | number | boolean | Array<string | number | boolean>;
+            /**
+             * Unique identifier for this variable
+             */
+            kater_id: string;
             /**
              * Variable name identifier
              */
@@ -710,7 +978,7 @@ export declare namespace CompilerResolveResponse {
             /**
              * Data type of the variable
              */
-            type: 'STRING' | 'INT' | 'FLOAT' | 'DATE' | 'TIMESTAMP' | 'BOOL' | 'DIMENSION' | 'MEASURE' | 'CALCULATION' | 'FILTER';
+            type: 'STRING' | 'INT' | 'FLOAT' | 'DATE' | 'TIMESTAMP' | 'BOOL' | 'STRING[]' | 'INT[]' | 'FLOAT[]' | 'DATE[]' | 'DIMENSION' | 'MEASURE' | 'CALCULATION' | 'FILTER';
             /**
              * Allowed values configuration
              */
@@ -727,6 +995,12 @@ export declare namespace CompilerResolveResponse {
              * True if bound_value equals the default value
              */
             is_default?: boolean | null;
+            /**
+             * True if this is a runtime variable (not resolved at compile time). Runtime
+             * variables have var() placeholders left in compiled SQL for literal substitution
+             * at execution time.
+             */
+            is_runtime?: boolean | null;
             /**
              * Human-readable label for the variable
              */
@@ -839,7 +1113,7 @@ export declare namespace CompilerResolveResponse {
                 /**
                  * Original type of the field in the source query
                  */
-                source_type: 'dimension' | 'measure' | 'calculation';
+                source_type: 'dimension' | 'dimension_date' | 'measure' | 'calculation';
             }
         }
     }
@@ -893,6 +1167,46 @@ export declare namespace CompilerResolveResponse {
             column?: number;
         }
     }
+    /**
+     * A file that was modified by auto-fix with its replacements.
+     */
+    interface RefFix {
+        /**
+         * Path to the modified file
+         */
+        file_path: string;
+        /**
+         * Full updated file content after fixes
+         */
+        new_content: string;
+        /**
+         * Individual ref replacements made in this file
+         */
+        replacements: Array<RefFix.Replacement>;
+    }
+    namespace RefFix {
+        /**
+         * A single ref replacement within a file.
+         */
+        interface Replacement {
+            /**
+             * Path to the file containing the replaced ref
+             */
+            file_path: string;
+            /**
+             * Line number where the replacement occurred
+             */
+            line_number: number;
+            /**
+             * Updated reference string
+             */
+            new_ref: string;
+            /**
+             * Original reference string
+             */
+            old_ref: string;
+        }
+    }
 }
 /**
  * Response model for schema validation.
@@ -910,6 +1224,10 @@ export interface CompilerValidateResponse {
      * Validation errors
      */
     errors?: Array<CompilerErrorItem>;
+    /**
+     * Write-back request ID. Non-null when files were dispatched to CLI via WebSocket.
+     */
+    request_id?: string | null;
     /**
      * Validation warnings
      */
@@ -940,6 +1258,14 @@ export declare namespace CompilerValidateResponse {
          * Validation errors for this connection
          */
         errors?: Array<CompilerAPI.CompilerErrorItem>;
+        /**
+         * Compilation manifest with all named objects.
+         */
+        manifest?: CompilerAPI.Manifest | null;
+        /**
+         * Files auto-fixed due to renamed refs. None when no renames detected.
+         */
+        ref_fixes?: Array<ConnectionResult.RefFix> | null;
         /**
          * Validation warnings for this connection
          */
@@ -996,6 +1322,46 @@ export declare namespace CompilerValidateResponse {
                 column?: number;
             }
         }
+        /**
+         * A file that was modified by auto-fix with its replacements.
+         */
+        interface RefFix {
+            /**
+             * Path to the modified file
+             */
+            file_path: string;
+            /**
+             * Full updated file content after fixes
+             */
+            new_content: string;
+            /**
+             * Individual ref replacements made in this file
+             */
+            replacements: Array<RefFix.Replacement>;
+        }
+        namespace RefFix {
+            /**
+             * A single ref replacement within a file.
+             */
+            interface Replacement {
+                /**
+                 * Path to the file containing the replaced ref
+                 */
+                file_path: string;
+                /**
+                 * Line number where the replacement occurred
+                 */
+                line_number: number;
+                /**
+                 * Updated reference string
+                 */
+                new_ref: string;
+                /**
+                 * Original reference string
+                 */
+                old_ref: string;
+            }
+        }
     }
 }
 export interface CompilerCompileParams {
@@ -1046,7 +1412,7 @@ export declare namespace CompilerCompileParams {
         /**
          * Widget category that determines data shape constraints
          */
-        widget_category: 'axis' | 'pie' | 'single_value' | 'heatmap' | 'table' | 'static';
+        widget_category: 'axis' | 'funnel' | 'heatmap' | 'image' | 'kpi_card' | 'pie' | 'table' | 'text';
         /**
          * Usage guidance for AI processing
          */
@@ -1076,11 +1442,11 @@ export declare namespace CompilerCompileParams {
         /**
          * Widget types within the declared widget_category that must NOT render this query
          */
-        disallowed_widget_types?: Array<'kpi_card' | 'line_chart' | 'bar_chart' | 'pie_chart' | 'donut_chart' | 'area_chart' | 'scatter_chart' | 'data_table' | 'card_grid' | 'heatmap' | 'gauge' | 'text' | 'image' | 'styled_table' | 'stat_cards' | 'key_value_list'> | null;
+        disallowed_widget_types?: Array<'axis_metric_by_dimension' | 'axis_metric_by_dimensiondate' | 'axis_metric_by_dimensiondate_sliced_by_dimension' | 'axis_scatter_plot' | 'funnel_funnel_chart' | 'heatmap_heatmap' | 'image_image_grid' | 'image_single_image' | 'kpi_measure_with_dimension_expression' | 'kpi_measure_with_secondary_metric' | 'kpi_single_measure_compared_to_prev_period_sparkline' | 'kpi_single_value' | 'pie_pie_chart' | 'table_data_table' | 'table_fancy_subtotal_table' | 'table_key_value_list' | 'table_styled_table' | 'text_data_readout_with_sparkline' | 'text_narrative_text'> | null;
         /**
          * Merged required + selected optional filters
          */
-        filters?: Array<ResolvedQuery.InlineFieldFilter | string | ResolvedQuery.InlineExistsFilter1 | ResolvedQuery.InlineExistsFilter2> | null;
+        filters?: Array<ResolvedQuery.InlineFormulaFilter | string | ResolvedQuery.InlineExistsFilter1 | ResolvedQuery.InlineExistsFilter2> | null;
         /**
          * Ordered list of query refs that were merged during inheritance resolution
          */
@@ -1102,10 +1468,6 @@ export declare namespace CompilerCompileParams {
          * (highest/newest first) and asc for ascending (lowest/oldest first).
          */
         order_by?: ResolvedQuery.OrderBy | null;
-        /**
-         * Access grants required to use this query
-         */
-        required_access_grants?: Array<string> | null;
         /**
          * The matched chart recommendation after evaluating chart hints
          */
@@ -1159,29 +1521,17 @@ export declare namespace CompilerCompileParams {
             }
         }
         /**
-         * An inline filter using field + operator + values
+         * An inline filter using a SQL/expression formula
          */
-        interface InlineFieldFilter {
-            /**
-             * Reference to the field to filter on
-             */
-            field: string;
+        interface InlineFormulaFilter {
             /**
              * Name of the inline filter
              */
             name: string;
             /**
-             * Filter operator to apply
+             * SQL expression for the filter condition
              */
-            operator: 'equals' | 'not_equals' | 'in' | 'not_in' | 'greater_than' | 'less_than' | 'greater_than_or_equals' | 'less_than_or_equals' | 'between' | 'in_the_last' | 'in_the_next' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'is_null' | 'is_not_null';
-            /**
-             * SQL expression for the filter value
-             */
-            sql_value?: string | null;
-            /**
-             * Fixed values for the filter
-             */
-            static_values?: Array<string | number | boolean> | null;
+            sql: string;
         }
         /**
          * An inline filter using EXISTS or NOT EXISTS with a subquery
@@ -1267,11 +1617,15 @@ export declare namespace CompilerCompileParams {
             /**
              * The concrete value bound for this resolution
              */
-            bound_value: string | number | boolean;
+            bound_value: string | number | boolean | Array<string | number | boolean>;
             /**
              * Default value for this variable
              */
-            default: string | number | boolean;
+            default: string | number | boolean | Array<string | number | boolean>;
+            /**
+             * Unique identifier for this variable
+             */
+            kater_id: string;
             /**
              * Variable name identifier
              */
@@ -1279,7 +1633,7 @@ export declare namespace CompilerCompileParams {
             /**
              * Data type of the variable
              */
-            type: 'STRING' | 'INT' | 'FLOAT' | 'DATE' | 'TIMESTAMP' | 'BOOL' | 'DIMENSION' | 'MEASURE' | 'CALCULATION' | 'FILTER';
+            type: 'STRING' | 'INT' | 'FLOAT' | 'DATE' | 'TIMESTAMP' | 'BOOL' | 'STRING[]' | 'INT[]' | 'FLOAT[]' | 'DATE[]' | 'DIMENSION' | 'MEASURE' | 'CALCULATION' | 'FILTER';
             /**
              * Allowed values configuration
              */
@@ -1296,6 +1650,12 @@ export declare namespace CompilerCompileParams {
              * True if bound_value equals the default value
              */
             is_default?: boolean | null;
+            /**
+             * True if this is a runtime variable (not resolved at compile time). Runtime
+             * variables have var() placeholders left in compiled SQL for literal substitution
+             * at execution time.
+             */
+            is_runtime?: boolean | null;
             /**
              * Human-readable label for the variable
              */
@@ -1408,11 +1768,40 @@ export declare namespace CompilerCompileParams {
                 /**
                  * Original type of the field in the source query
                  */
-                source_type: 'dimension' | 'measure' | 'calculation';
+                source_type: 'dimension' | 'dimension_date' | 'measure' | 'calculation';
             }
         }
     }
 }
+export interface CompilerCompileDashboardParams {
+    /**
+     * Body param: Connection to compile against
+     */
+    connection_id: string;
+    /**
+     * Body param: Relative path within the connection (e.g.
+     * 'dashboards/compliance_overview')
+     */
+    dashboard_path: string;
+    /**
+     * Query param
+     */
+    source?: string | null;
+    /**
+     * Body param: Optional filter overrides from UI
+     */
+    filters?: {
+        [key: string]: string | Array<string> | null;
+    } | null;
+    /**
+     * Body param: Optional tenant key for multi-tenant execution
+     */
+    tenant_key?: string | null;
+    /**
+     * Header param
+     */
+    'X-Kater-CLI-ID'?: string;
+}
 export interface CompilerEnumerateParams {
     /**
      * Body param: Connection to enumerate against
@@ -1427,6 +1816,11 @@ export interface CompilerEnumerateParams {
      * queries.
      */
     query_refs?: Array<string> | null;
+    /**
+     * Body param: Tenant key for multi-tenant clients. Required when the client uses
+     * row or database tenancy.
+     */
+    tenant_key?: string | null;
     /**
      * Header param
      */
@@ -1479,7 +1873,7 @@ export declare namespace CompilerExecuteParams {
         /**
          * Widget category that determines data shape constraints
          */
-        widget_category: 'axis' | 'pie' | 'single_value' | 'heatmap' | 'table' | 'static';
+        widget_category: 'axis' | 'funnel' | 'heatmap' | 'image' | 'kpi_card' | 'pie' | 'table' | 'text';
         /**
          * Usage guidance for AI processing
          */
@@ -1509,11 +1903,11 @@ export declare namespace CompilerExecuteParams {
         /**
          * Widget types within the declared widget_category that must NOT render this query
          */
-        disallowed_widget_types?: Array<'kpi_card' | 'line_chart' | 'bar_chart' | 'pie_chart' | 'donut_chart' | 'area_chart' | 'scatter_chart' | 'data_table' | 'card_grid' | 'heatmap' | 'gauge' | 'text' | 'image' | 'styled_table' | 'stat_cards' | 'key_value_list'> | null;
+        disallowed_widget_types?: Array<'axis_metric_by_dimension' | 'axis_metric_by_dimensiondate' | 'axis_metric_by_dimensiondate_sliced_by_dimension' | 'axis_scatter_plot' | 'funnel_funnel_chart' | 'heatmap_heatmap' | 'image_image_grid' | 'image_single_image' | 'kpi_measure_with_dimension_expression' | 'kpi_measure_with_secondary_metric' | 'kpi_single_measure_compared_to_prev_period_sparkline' | 'kpi_single_value' | 'pie_pie_chart' | 'table_data_table' | 'table_fancy_subtotal_table' | 'table_key_value_list' | 'table_styled_table' | 'text_data_readout_with_sparkline' | 'text_narrative_text'> | null;
         /**
          * Merged required + selected optional filters
          */
-        filters?: Array<ResolvedQuery.InlineFieldFilter | string | ResolvedQuery.InlineExistsFilter1 | ResolvedQuery.InlineExistsFilter2> | null;
+        filters?: Array<ResolvedQuery.InlineFormulaFilter | string | ResolvedQuery.InlineExistsFilter1 | ResolvedQuery.InlineExistsFilter2> | null;
         /**
          * Ordered list of query refs that were merged during inheritance resolution
          */
@@ -1535,10 +1929,6 @@ export declare namespace CompilerExecuteParams {
          * (highest/newest first) and asc for ascending (lowest/oldest first).
          */
         order_by?: ResolvedQuery.OrderBy | null;
-        /**
-         * Access grants required to use this query
-         */
-        required_access_grants?: Array<string> | null;
         /**
          * The matched chart recommendation after evaluating chart hints
          */
@@ -1592,29 +1982,17 @@ export declare namespace CompilerExecuteParams {
             }
         }
         /**
-         * An inline filter using field + operator + values
+         * An inline filter using a SQL/expression formula
          */
-        interface InlineFieldFilter {
-            /**
-             * Reference to the field to filter on
-             */
-            field: string;
+        interface InlineFormulaFilter {
             /**
              * Name of the inline filter
              */
             name: string;
             /**
-             * Filter operator to apply
-             */
-            operator: 'equals' | 'not_equals' | 'in' | 'not_in' | 'greater_than' | 'less_than' | 'greater_than_or_equals' | 'less_than_or_equals' | 'between' | 'in_the_last' | 'in_the_next' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'is_null' | 'is_not_null';
-            /**
-             * SQL expression for the filter value
-             */
-            sql_value?: string | null;
-            /**
-             * Fixed values for the filter
+             * SQL expression for the filter condition
              */
-            static_values?: Array<string | number | boolean> | null;
+            sql: string;
         }
         /**
          * An inline filter using EXISTS or NOT EXISTS with a subquery
@@ -1700,11 +2078,15 @@ export declare namespace CompilerExecuteParams {
             /**
              * The concrete value bound for this resolution
              */
-            bound_value: string | number | boolean;
+            bound_value: string | number | boolean | Array<string | number | boolean>;
             /**
              * Default value for this variable
              */
-            default: string | number | boolean;
+            default: string | number | boolean | Array<string | number | boolean>;
+            /**
+             * Unique identifier for this variable
+             */
+            kater_id: string;
             /**
              * Variable name identifier
              */
@@ -1712,7 +2094,7 @@ export declare namespace CompilerExecuteParams {
             /**
              * Data type of the variable
              */
-            type: 'STRING' | 'INT' | 'FLOAT' | 'DATE' | 'TIMESTAMP' | 'BOOL' | 'DIMENSION' | 'MEASURE' | 'CALCULATION' | 'FILTER';
+            type: 'STRING' | 'INT' | 'FLOAT' | 'DATE' | 'TIMESTAMP' | 'BOOL' | 'STRING[]' | 'INT[]' | 'FLOAT[]' | 'DATE[]' | 'DIMENSION' | 'MEASURE' | 'CALCULATION' | 'FILTER';
             /**
              * Allowed values configuration
              */
@@ -1729,6 +2111,12 @@ export declare namespace CompilerExecuteParams {
              * True if bound_value equals the default value
              */
             is_default?: boolean | null;
+            /**
+             * True if this is a runtime variable (not resolved at compile time). Runtime
+             * variables have var() placeholders left in compiled SQL for literal substitution
+             * at execution time.
+             */
+            is_runtime?: boolean | null;
             /**
              * Human-readable label for the variable
              */
@@ -1841,7 +2229,7 @@ export declare namespace CompilerExecuteParams {
                 /**
                  * Original type of the field in the source query
                  */
-                source_type: 'dimension' | 'measure' | 'calculation';
+                source_type: 'dimension' | 'dimension_date' | 'measure' | 'calculation';
             }
         }
     }
@@ -1859,6 +2247,10 @@ export interface CompilerResolveParams {
      * Query param
      */
     source?: string | null;
+    /**
+     * Body param: Automatically fix broken refs caused by renames. Defaults to True.
+     */
+    auto_fix?: boolean;
     /**
      * Body param: Comma-separated slot selections and variable assignments. Reserved
      * keys: measure, dimension, filter, calculation. All other keys are variable
@@ -1876,6 +2268,10 @@ export interface CompilerValidateParams {
      * Query param
      */
     source?: string | null;
+    /**
+     * Body param: Automatically fix broken refs caused by renames. Defaults to True.
+     */
+    auto_fix?: boolean;
     /**
      * Body param: Optional connection IDs to validate. If omitted, validates all
      * connections.
@@ -1887,7 +2283,9 @@ export interface CompilerValidateParams {
     'X-Kater-CLI-ID'?: string;
 }
 export declare namespace Compiler {
-    export { type ChartConfig as ChartConfig, type CompilerErrorItem as CompilerErrorItem, type InlineField as InlineField, type Manifest as Manifest, type ManifestEntry as ManifestEntry, type RefWithLabel as RefWithLabel, type SubqueryCondition as SubqueryCondition, type CompilerCompileResponse as CompilerCompileResponse, type CompilerEnumerateResponse as CompilerEnumerateResponse, type CompilerExecuteResponse as CompilerExecuteResponse, type CompilerResolveResponse as CompilerResolveResponse, type CompilerValidateResponse as CompilerValidateResponse, type CompilerCompileParams as CompilerCompileParams, type CompilerEnumerateParams as CompilerEnumerateParams, type CompilerExecuteParams as CompilerExecuteParams, type CompilerResolveParams as CompilerResolveParams, type CompilerValidateParams as CompilerValidateParams, };
-    export { Cache as Cache, type CacheInvalidateResponse as CacheInvalidateResponse, type CacheInvalidateParams as CacheInvalidateParams, };
+    export { type ChartConfig as ChartConfig, type CompilerErrorItem as CompilerErrorItem, type InlineField as InlineField, type Manifest as Manifest, type ManifestEntry as ManifestEntry, type RefWithLabel as RefWithLabel, type SubqueryCondition as SubqueryCondition, type CompilerCompileResponse as CompilerCompileResponse, type CompilerCompileDashboardResponse as CompilerCompileDashboardResponse, type CompilerEnumerateResponse as CompilerEnumerateResponse, type CompilerExecuteResponse as CompilerExecuteResponse, type CompilerResolveResponse as CompilerResolveResponse, type CompilerValidateResponse as CompilerValidateResponse, type CompilerCompileParams as CompilerCompileParams, type CompilerCompileDashboardParams as CompilerCompileDashboardParams, type CompilerEnumerateParams as CompilerEnumerateParams, type CompilerExecuteParams as CompilerExecuteParams, type CompilerResolveParams as CompilerResolveParams, type CompilerValidateParams as CompilerValidateParams, };
+    export { Cache as Cache };
+    export { CombinationAPICombination as Combination, type CombinationPreviewResponse as CombinationPreviewResponse, type CombinationPreviewParams as CombinationPreviewParams, };
+    export { type ManifestRegenerateAndCreatePrResponse as ManifestRegenerateAndCreatePrResponse, type ManifestRegenerateAndCreatePrParams as ManifestRegenerateAndCreatePrParams, };
 }
 //# sourceMappingURL=compiler.d.mts.map