@querypanel/node-sdk 1.3.1 → 1.3.5

package/dist/index.d.cts

@@ -37,7 +37,7 @@ interface IntrospectOptions {
     tables?: string[];
 }
 
-type DatabaseDialect = "bigquery" | "clickhouse" | "postgres" | "mysql";
+type DatabaseDialect = "bigquery" | "clickhouse" | "postgres" | "redshift" | "mysql";
 interface DatabaseExecutionResult {
     fields: string[];
     rows: Array<Record<string, unknown>>;
@@ -192,13 +192,19 @@ interface PostgresQueryResult {
     }>;
 }
 type PostgresClientFn = (sql: string, params?: unknown[]) => Promise<PostgresQueryResult>;
+type PostgresWireDialect = "postgres" | "redshift";
 interface PostgresAdapterOptions {
     /** Logical database name used in introspection metadata. */
     database?: string;
     /** Schema to assume when a table is provided without qualification. */
     defaultSchema?: string;
-    /** Optional database kind label. Defaults to "postgres". */
+    /** Optional database kind label. Defaults to the dialect. */
     kind?: SchemaIntrospection["db"]["kind"];
+    /**
+     * Wire-compatible engine behind the client. "redshift" uses Redshift's
+     * svv_* catalog views for introspection. Defaults to "postgres".
+     */
+    dialect?: PostgresWireDialect;
     /**
      * Optional allow-list of table names (schema-qualified or bare).
      * When specified, introspection and queries are restricted to these tables only.
@@ -215,6 +221,7 @@ declare class PostgresAdapter implements DatabaseAdapter {
     private readonly databaseName;
     private readonly defaultSchema;
     private readonly kind;
+    private readonly dialect;
     private readonly allowedTables?;
     constructor(clientFn: PostgresClientFn, options?: PostgresAdapterOptions);
     execute(sql: string, params?: Record<string, string | number | boolean | string[] | number[]>): Promise<DatabaseExecutionResult>;
@@ -225,7 +232,7 @@ declare class PostgresAdapter implements DatabaseAdapter {
      */
     private convertNamedToPositionalParams;
     validate(sql: string, params?: Record<string, string | number | boolean | string[] | number[]>): Promise<void>;
-    getDialect(): "postgres";
+    getDialect(): PostgresWireDialect;
     /**
      * Simplified introspection: only collect table/column metadata for IngestRequest
      * No indexes, constraints, or statistics
@@ -990,6 +997,13 @@ interface ChartModifyOptions {
      * Omit this field; chart modifications always use v2.
      */
     pipeline?: "v2";
+    /**
+     * Fast path for structured controls (pinned charts): date-only changes
+     * substitute params or call `/v2/rewrite-datefilter` instead of `/v2/query`,
+     * and chart generation is skipped when the caller keeps its own encoding
+     * (`chart.vizSpec` / `vegaLiteSpec` are then omitted). Default: false.
+     */
+    lightweight?: boolean;
     /**
      * QueryPanel session ID for context-aware follow-ups.
      * Pass the querypanelSessionId from a previous ask() response
@@ -1248,6 +1262,18 @@ declare class QueryPanelSdkAPI {
         tenantFieldType?: string;
         enforceTenantIsolation?: boolean;
     }): void;
+    /**
+     * Attach an Amazon Redshift database. Redshift speaks the Postgres wire
+     * protocol, so `clientFn` can wrap a `pg` client; introspection uses
+     * Redshift's svv_* catalog views and SQL is generated for Redshift.
+     */
+    attachRedshift(name: string, clientFn: PostgresClientFn, options?: Omit<PostgresAdapterOptions, "dialect"> & {
+        description?: string;
+        tags?: string[];
+        tenantFieldName?: string;
+        tenantFieldType?: string;
+        enforceTenantIsolation?: boolean;
+    }): void;
     attachBigQuery(name: string, clientFn: BigQueryClientFn, options: BigQueryAdapterOptions & {
         description?: string;
         tags?: string[];
@@ -1986,4 +2012,4 @@ declare class QueryPanelSdkAPI {
     }, signal?: AbortSignal): Promise<SdkDashboard[]>;
 }
 
-export { ALL_VIZ_CHART_TYPES, type ActiveChartBulkGetResponse, type ActiveChartCreateInput, type ActiveChartListOptions, type ActiveChartUpdateInput, type AggregateOp, type AskOptions, type AskResponse, type AxisField, type AxisFieldInput, BigQueryAdapter, type BigQueryAdapterOptions, type BigQueryClientFn, type BigQueryQueryRequest, type BigQueryQueryResult, CallbackApiClient, type ChartBulkGetResponse, type ChartCreateInput, type ChartEncoding, type ChartEnvelope, type ChartListAllOptions, type ChartListOptions, type ChartModifyInput, type ChartModifyOptions, type ChartModifyResponse, type ChartSpec, type ChartType, type ChartUpdateInput, ClickHouseAdapter, type ClickHouseAdapterOptions, type ClickHouseClientFn, type ContextDocument, type DashboardCreateInput, type DashboardForkInput, type DashboardForkUpdateInput, type DashboardListOptions, type DashboardUpdateInput, type DatabaseAdapter, type DatabaseDialect, type DateRangeInput, type EncodingHints, type FieldRef, type FieldRefInput, type FieldType, type IQueryPanelApi, type IngestResponse, type IntentResult, type MetricEncoding, type MetricField, type MetricSpec, type PaginatedResponse$1 as PaginatedResponse, type PaginationInfo$1 as PaginationInfo, type PaginationQuery$1 as PaginationQuery, type ParamRecord, type ParamValue, type PipelineTrace, PostgresAdapter, type PostgresAdapterOptions, type PostgresClientFn, QueryErrorCode, QueryErrorCode as QueryErrorCodeType, QueryPanelSdkAPI, type QueryPanelSdkAPIOptions, QueryPipelineError, type RequestHandler, type RequestHandlerOptions, type RequestHandlerResult, type SchemaIntrospection, type SchemaSyncOptions, type SdkActiveChart, type SdkChart, type SdkDashboard, type SdkSession, type SdkSessionTurn, type SessionGetOptions, type SessionListOptions, type SessionUpdateInput, type SqlModifications, type StackingMode, type TableColumn, type TableEncoding, type TableSpec, type TimeUnit, type ValueFormat, type VizModifications, type VizSpec, type VizSpecGenerateInput, type VizSpecGenerateOptions, type VizSpecGeneratorInput, type VizSpecKind, type VizSpecResponse, type VizSpecResult, anonymizeResults, mapGeneratedParams, normalizeSqlParamsInput, resolveQueryPipeline };
+export { ALL_VIZ_CHART_TYPES, type ActiveChartBulkGetResponse, type ActiveChartCreateInput, type ActiveChartListOptions, type ActiveChartUpdateInput, type AggregateOp, type AskOptions, type AskResponse, type AxisField, type AxisFieldInput, BigQueryAdapter, type BigQueryAdapterOptions, type BigQueryClientFn, type BigQueryQueryRequest, type BigQueryQueryResult, CallbackApiClient, type ChartBulkGetResponse, type ChartCreateInput, type ChartEncoding, type ChartEnvelope, type ChartListAllOptions, type ChartListOptions, type ChartModifyInput, type ChartModifyOptions, type ChartModifyResponse, type ChartSpec, type ChartType, type ChartUpdateInput, ClickHouseAdapter, type ClickHouseAdapterOptions, type ClickHouseClientFn, type ContextDocument, type DashboardCreateInput, type DashboardForkInput, type DashboardForkUpdateInput, type DashboardListOptions, type DashboardUpdateInput, type DatabaseAdapter, type DatabaseDialect, type DateRangeInput, type EncodingHints, type FieldRef, type FieldRefInput, type FieldType, type IQueryPanelApi, type IngestResponse, type IntentResult, type MetricEncoding, type MetricField, type MetricSpec, type PaginatedResponse$1 as PaginatedResponse, type PaginationInfo$1 as PaginationInfo, type PaginationQuery$1 as PaginationQuery, type ParamRecord, type ParamValue, type PipelineTrace, PostgresAdapter, type PostgresAdapterOptions, type PostgresClientFn, type PostgresWireDialect, QueryErrorCode, QueryErrorCode as QueryErrorCodeType, QueryPanelSdkAPI, type QueryPanelSdkAPIOptions, QueryPipelineError, type RequestHandler, type RequestHandlerOptions, type RequestHandlerResult, type SchemaIntrospection, type SchemaSyncOptions, type SdkActiveChart, type SdkChart, type SdkDashboard, type SdkSession, type SdkSessionTurn, type SessionGetOptions, type SessionListOptions, type SessionUpdateInput, type SqlModifications, type StackingMode, type TableColumn, type TableEncoding, type TableSpec, type TimeUnit, type ValueFormat, type VizModifications, type VizSpec, type VizSpecGenerateInput, type VizSpecGenerateOptions, type VizSpecGeneratorInput, type VizSpecKind, type VizSpecResponse, type VizSpecResult, anonymizeResults, mapGeneratedParams, normalizeSqlParamsInput, resolveQueryPipeline };

package/dist/index.d.ts

@@ -37,7 +37,7 @@ interface IntrospectOptions {
     tables?: string[];
 }
 
-type DatabaseDialect = "bigquery" | "clickhouse" | "postgres" | "mysql";
+type DatabaseDialect = "bigquery" | "clickhouse" | "postgres" | "redshift" | "mysql";
 interface DatabaseExecutionResult {
     fields: string[];
     rows: Array<Record<string, unknown>>;
@@ -192,13 +192,19 @@ interface PostgresQueryResult {
     }>;
 }
 type PostgresClientFn = (sql: string, params?: unknown[]) => Promise<PostgresQueryResult>;
+type PostgresWireDialect = "postgres" | "redshift";
 interface PostgresAdapterOptions {
     /** Logical database name used in introspection metadata. */
     database?: string;
     /** Schema to assume when a table is provided without qualification. */
     defaultSchema?: string;
-    /** Optional database kind label. Defaults to "postgres". */
+    /** Optional database kind label. Defaults to the dialect. */
     kind?: SchemaIntrospection["db"]["kind"];
+    /**
+     * Wire-compatible engine behind the client. "redshift" uses Redshift's
+     * svv_* catalog views for introspection. Defaults to "postgres".
+     */
+    dialect?: PostgresWireDialect;
     /**
      * Optional allow-list of table names (schema-qualified or bare).
      * When specified, introspection and queries are restricted to these tables only.
@@ -215,6 +221,7 @@ declare class PostgresAdapter implements DatabaseAdapter {
     private readonly databaseName;
     private readonly defaultSchema;
     private readonly kind;
+    private readonly dialect;
     private readonly allowedTables?;
     constructor(clientFn: PostgresClientFn, options?: PostgresAdapterOptions);
     execute(sql: string, params?: Record<string, string | number | boolean | string[] | number[]>): Promise<DatabaseExecutionResult>;
@@ -225,7 +232,7 @@ declare class PostgresAdapter implements DatabaseAdapter {
      */
     private convertNamedToPositionalParams;
     validate(sql: string, params?: Record<string, string | number | boolean | string[] | number[]>): Promise<void>;
-    getDialect(): "postgres";
+    getDialect(): PostgresWireDialect;
     /**
      * Simplified introspection: only collect table/column metadata for IngestRequest
      * No indexes, constraints, or statistics
@@ -990,6 +997,13 @@ interface ChartModifyOptions {
      * Omit this field; chart modifications always use v2.
      */
     pipeline?: "v2";
+    /**
+     * Fast path for structured controls (pinned charts): date-only changes
+     * substitute params or call `/v2/rewrite-datefilter` instead of `/v2/query`,
+     * and chart generation is skipped when the caller keeps its own encoding
+     * (`chart.vizSpec` / `vegaLiteSpec` are then omitted). Default: false.
+     */
+    lightweight?: boolean;
     /**
      * QueryPanel session ID for context-aware follow-ups.
      * Pass the querypanelSessionId from a previous ask() response
@@ -1248,6 +1262,18 @@ declare class QueryPanelSdkAPI {
         tenantFieldType?: string;
         enforceTenantIsolation?: boolean;
     }): void;
+    /**
+     * Attach an Amazon Redshift database. Redshift speaks the Postgres wire
+     * protocol, so `clientFn` can wrap a `pg` client; introspection uses
+     * Redshift's svv_* catalog views and SQL is generated for Redshift.
+     */
+    attachRedshift(name: string, clientFn: PostgresClientFn, options?: Omit<PostgresAdapterOptions, "dialect"> & {
+        description?: string;
+        tags?: string[];
+        tenantFieldName?: string;
+        tenantFieldType?: string;
+        enforceTenantIsolation?: boolean;
+    }): void;
     attachBigQuery(name: string, clientFn: BigQueryClientFn, options: BigQueryAdapterOptions & {
         description?: string;
         tags?: string[];
@@ -1986,4 +2012,4 @@ declare class QueryPanelSdkAPI {
     }, signal?: AbortSignal): Promise<SdkDashboard[]>;
 }
 
-export { ALL_VIZ_CHART_TYPES, type ActiveChartBulkGetResponse, type ActiveChartCreateInput, type ActiveChartListOptions, type ActiveChartUpdateInput, type AggregateOp, type AskOptions, type AskResponse, type AxisField, type AxisFieldInput, BigQueryAdapter, type BigQueryAdapterOptions, type BigQueryClientFn, type BigQueryQueryRequest, type BigQueryQueryResult, CallbackApiClient, type ChartBulkGetResponse, type ChartCreateInput, type ChartEncoding, type ChartEnvelope, type ChartListAllOptions, type ChartListOptions, type ChartModifyInput, type ChartModifyOptions, type ChartModifyResponse, type ChartSpec, type ChartType, type ChartUpdateInput, ClickHouseAdapter, type ClickHouseAdapterOptions, type ClickHouseClientFn, type ContextDocument, type DashboardCreateInput, type DashboardForkInput, type DashboardForkUpdateInput, type DashboardListOptions, type DashboardUpdateInput, type DatabaseAdapter, type DatabaseDialect, type DateRangeInput, type EncodingHints, type FieldRef, type FieldRefInput, type FieldType, type IQueryPanelApi, type IngestResponse, type IntentResult, type MetricEncoding, type MetricField, type MetricSpec, type PaginatedResponse$1 as PaginatedResponse, type PaginationInfo$1 as PaginationInfo, type PaginationQuery$1 as PaginationQuery, type ParamRecord, type ParamValue, type PipelineTrace, PostgresAdapter, type PostgresAdapterOptions, type PostgresClientFn, QueryErrorCode, QueryErrorCode as QueryErrorCodeType, QueryPanelSdkAPI, type QueryPanelSdkAPIOptions, QueryPipelineError, type RequestHandler, type RequestHandlerOptions, type RequestHandlerResult, type SchemaIntrospection, type SchemaSyncOptions, type SdkActiveChart, type SdkChart, type SdkDashboard, type SdkSession, type SdkSessionTurn, type SessionGetOptions, type SessionListOptions, type SessionUpdateInput, type SqlModifications, type StackingMode, type TableColumn, type TableEncoding, type TableSpec, type TimeUnit, type ValueFormat, type VizModifications, type VizSpec, type VizSpecGenerateInput, type VizSpecGenerateOptions, type VizSpecGeneratorInput, type VizSpecKind, type VizSpecResponse, type VizSpecResult, anonymizeResults, mapGeneratedParams, normalizeSqlParamsInput, resolveQueryPipeline };
+export { ALL_VIZ_CHART_TYPES, type ActiveChartBulkGetResponse, type ActiveChartCreateInput, type ActiveChartListOptions, type ActiveChartUpdateInput, type AggregateOp, type AskOptions, type AskResponse, type AxisField, type AxisFieldInput, BigQueryAdapter, type BigQueryAdapterOptions, type BigQueryClientFn, type BigQueryQueryRequest, type BigQueryQueryResult, CallbackApiClient, type ChartBulkGetResponse, type ChartCreateInput, type ChartEncoding, type ChartEnvelope, type ChartListAllOptions, type ChartListOptions, type ChartModifyInput, type ChartModifyOptions, type ChartModifyResponse, type ChartSpec, type ChartType, type ChartUpdateInput, ClickHouseAdapter, type ClickHouseAdapterOptions, type ClickHouseClientFn, type ContextDocument, type DashboardCreateInput, type DashboardForkInput, type DashboardForkUpdateInput, type DashboardListOptions, type DashboardUpdateInput, type DatabaseAdapter, type DatabaseDialect, type DateRangeInput, type EncodingHints, type FieldRef, type FieldRefInput, type FieldType, type IQueryPanelApi, type IngestResponse, type IntentResult, type MetricEncoding, type MetricField, type MetricSpec, type PaginatedResponse$1 as PaginatedResponse, type PaginationInfo$1 as PaginationInfo, type PaginationQuery$1 as PaginationQuery, type ParamRecord, type ParamValue, type PipelineTrace, PostgresAdapter, type PostgresAdapterOptions, type PostgresClientFn, type PostgresWireDialect, QueryErrorCode, QueryErrorCode as QueryErrorCodeType, QueryPanelSdkAPI, type QueryPanelSdkAPIOptions, QueryPipelineError, type RequestHandler, type RequestHandlerOptions, type RequestHandlerResult, type SchemaIntrospection, type SchemaSyncOptions, type SdkActiveChart, type SdkChart, type SdkDashboard, type SdkSession, type SdkSessionTurn, type SessionGetOptions, type SessionListOptions, type SessionUpdateInput, type SqlModifications, type StackingMode, type TableColumn, type TableEncoding, type TableSpec, type TimeUnit, type ValueFormat, type VizModifications, type VizSpec, type VizSpecGenerateInput, type VizSpecGenerateOptions, type VizSpecGeneratorInput, type VizSpecKind, type VizSpecResponse, type VizSpecResult, anonymizeResults, mapGeneratedParams, normalizeSqlParamsInput, resolveQueryPipeline };

package/dist/index.js

@@ -501,7 +501,8 @@ var PostgresAdapter = class {
     this.clientFn = clientFn;
     this.databaseName = options.database ?? "postgres";
     this.defaultSchema = options.defaultSchema ?? "public";
-    this.kind = options.kind ?? "postgres";
+    this.dialect = options.dialect ?? "postgres";
+    this.kind = options.kind ?? this.dialect;
     if (options.allowedTables) {
       this.allowedTables = normalizeTableFilter3(
         options.allowedTables,
@@ -513,6 +514,7 @@ var PostgresAdapter = class {
   databaseName;
   defaultSchema;
   kind;
+  dialect;
   allowedTables;
   async execute(sql, params) {
     if (this.allowedTables) {
@@ -592,7 +594,7 @@ var PostgresAdapter = class {
     await this.clientFn(`EXPLAIN ${sql}`, paramArray);
   }
   getDialect() {
-    return "postgres";
+    return this.dialect;
   }
   /**
    * Simplified introspection: only collect table/column metadata for IngestRequest
@@ -601,12 +603,13 @@ var PostgresAdapter = class {
   async introspect(options) {
     const tablesToIntrospect = options?.tables ? normalizeTableFilter3(options.tables, this.defaultSchema) : this.allowedTables;
     const normalizedTables = tablesToIntrospect ?? [];
+    const isRedshift = this.dialect === "redshift";
     const tablesResult = await this.clientFn(
-      buildTablesQuery2(normalizedTables)
+      isRedshift ? buildRedshiftTablesQuery(normalizedTables) : buildTablesQuery2(normalizedTables)
     );
     const tableRows = tablesResult.rows;
     const columnsResult = await this.clientFn(
-      buildColumnsQuery2(normalizedTables)
+      isRedshift ? buildRedshiftColumnsQuery(normalizedTables) : buildColumnsQuery2(normalizedTables)
     );
     const columnRows = columnsResult.rows;
     const tablesByKey = /* @__PURE__ */ new Map();
@@ -720,10 +723,11 @@ function buildColumnsQuery2(tables) {
         AND kcu.column_name = cols.column_name
     ) AS is_primary_key
   FROM information_schema.columns cols
+  LEFT JOIN pg_catalog.pg_namespace n ON n.nspname = cols.table_schema
   LEFT JOIN pg_catalog.pg_class c
     ON c.relname = cols.table_name
+   AND c.relnamespace = n.oid
    AND c.relkind IN ('r', 'v', 'm')
-  LEFT JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
   LEFT JOIN pg_catalog.pg_attribute attr
     ON attr.attrelid = c.oid
    AND attr.attname = cols.column_name
@@ -733,6 +737,38 @@ function buildColumnsQuery2(tables) {
     ${filter}
   ORDER BY cols.table_schema, cols.table_name, cols.ordinal_position;`;
 }
+var REDSHIFT_EXCLUDED_SCHEMAS = "('pg_catalog', 'information_schema', 'pg_internal', 'pg_automv')";
+function buildRedshiftTablesQuery(tables) {
+  const filter = buildFilterClause(tables, "table_schema", "table_name");
+  return `SELECT
+    table_name,
+    table_schema AS schema_name,
+    table_type,
+    remarks AS comment
+  FROM svv_tables
+  WHERE table_catalog = current_database()
+    AND table_schema NOT IN ${REDSHIFT_EXCLUDED_SCHEMAS}
+    AND table_schema NOT LIKE 'pg_temp%'
+    ${filter}
+  ORDER BY table_schema, table_name;`;
+}
+function buildRedshiftColumnsQuery(tables) {
+  const filter = buildFilterClause(tables, "table_schema", "table_name");
+  return `SELECT
+    table_name,
+    table_schema,
+    column_name,
+    data_type,
+    NULL AS udt_name,
+    remarks AS description,
+    FALSE AS is_primary_key
+  FROM svv_columns
+  WHERE table_catalog = current_database()
+    AND table_schema NOT IN ${REDSHIFT_EXCLUDED_SCHEMAS}
+    AND table_schema NOT LIKE 'pg_temp%'
+    ${filter}
+  ORDER BY table_schema, table_name, ordinal_position;`;
+}
 function buildFilterClause(tables, schemaExpr, tableExpr) {
   if (!tables.length) return "";
   const clauses = tables.map(({ schema, table }) => {
@@ -2245,6 +2281,7 @@ function buildModifiedQuestion(originalQuestion, modifications, hasSessionContex
   }
   return `${originalQuestion} (${hints.join(", ")})`;
 }
+var REWRITE_DATEFILTER_ENDPOINT = "/v2/rewrite-datefilter";
 var START_PARAM_KEY_REGEX = /(^|_)(start|from)(_|$)/i;
 var END_PARAM_KEY_REGEX = /(^|_)(end|to)(_|$)/i;
 var ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z?$/;
@@ -2281,31 +2318,118 @@ function normalizeGeneratedParamKey(param, index) {
   const nameCandidate = typeof param.name === "string" && param.name.trim() || typeof param.placeholder === "string" && param.placeholder.trim() || typeof param.position === "number" && String(param.position) || String(index + 1);
   return nameCandidate.replace(/[{}]/g, "").replace(/(.+):.*$/, "$1").replace(/^[:$]/, "").trim();
 }
-function applyDateRangeOverrides(dateRange, params, paramMetadata) {
+function collectParamKeys(params, paramMetadata) {
+  const keys = new Set(Object.keys(params));
+  for (let i = 0; i < paramMetadata.length; i++) {
+    const param = paramMetadata[i];
+    if (!param) continue;
+    keys.add(normalizeGeneratedParamKey(param, i));
+  }
+  return [...keys];
+}
+function placeholderKey(token) {
+  if (token.startsWith("$") || token.startsWith("@")) return token.slice(1);
+  return token.slice(1, -1).replace(/:.+$/, "").trim();
+}
+function isDateLike(value) {
+  return typeof value === "string" && /^\d{4}-\d{2}-\d{2}/.test(value.trim());
+}
+function dateBoundKeysFromSql(sql) {
+  const start = /* @__PURE__ */ new Set();
+  const end = /* @__PURE__ */ new Set();
+  const comparison = /(>=|<=|>|<)\s*(\$\d+|\{[^}]+\}|@[A-Za-z_][\w]*)/g;
+  const between = /BETWEEN\s+(\$\d+|\{[^}]+\}|@[A-Za-z_][\w]*)\s+AND\s+(\$\d+|\{[^}]+\}|@[A-Za-z_][\w]*)/gi;
+  for (const match of sql.matchAll(comparison)) {
+    const key = placeholderKey(match[2] ?? "");
+    if (!key) continue;
+    if (match[1] === ">=" || match[1] === ">") start.add(key);
+    else end.add(key);
+  }
+  for (const match of sql.matchAll(between)) {
+    const startKey = placeholderKey(match[1] ?? "");
+    const endKey = placeholderKey(match[2] ?? "");
+    if (startKey) start.add(startKey);
+    if (endKey) end.add(endKey);
+  }
+  return { start, end };
+}
+function paramValueForKey(key, params, paramMetadata) {
+  if (key in params) return params[key];
+  for (let i = 0; i < paramMetadata.length; i++) {
+    const param = paramMetadata[i];
+    if (!param) continue;
+    if (normalizeGeneratedParamKey(param, i) === key) return param.value;
+  }
+  return void 0;
+}
+function dateBoundKeys(sql, params, paramMetadata, boundary) {
+  const fromSql = dateBoundKeysFromSql(sql)[boundary];
+  const keys = [];
+  for (const key of collectParamKeys(params, paramMetadata)) {
+    const named = keyLooksLikeDateBoundary(key, boundary);
+    if (!named && !fromSql.has(key)) continue;
+    if (!isDateLike(paramValueForKey(key, params, paramMetadata))) continue;
+    keys.push(key);
+  }
+  return keys;
+}
+function canSubstituteDateRangeParams(dateRange, sql, params, paramMetadata = []) {
+  if (!dateRange) return false;
+  const from = normalizeDateInput(dateRange.from);
+  const to = normalizeDateInput(dateRange.to);
+  if (!from && !to) return false;
+  if (from && dateBoundKeys(sql, params, paramMetadata, "start").length === 0) {
+    return false;
+  }
+  if (to && dateBoundKeys(sql, params, paramMetadata, "end").length === 0) {
+    return false;
+  }
+  return true;
+}
+function isDateRangeOnlySqlModification(modifications) {
+  if (!modifications?.dateRange) return false;
+  if (modifications.customSql) return false;
+  if (modifications.timeGranularity) return false;
+  if (typeof modifications.additionalInstructions === "string" && modifications.additionalInstructions.trim().length > 0) {
+    return false;
+  }
+  return true;
+}
+function applyDateRangeOverrides(dateRange, sql, params, paramMetadata) {
   if (!dateRange) return;
   const from = normalizeDateInput(dateRange.from);
   const to = normalizeDateInput(dateRange.to);
   if (!from && !to) return;
+  const startKeys = new Set(
+    from ? dateBoundKeys(sql, params, paramMetadata, "start") : []
+  );
+  const endKeys = new Set(
+    to ? dateBoundKeys(sql, params, paramMetadata, "end") : []
+  );
   for (const [key, value] of Object.entries(params)) {
-    if (from && keyLooksLikeDateBoundary(key, "start")) {
-      params[key] = formatDateOverride(from, "start", value);
+    if (startKeys.has(key)) {
+      params[key] = formatDateOverride(from ?? "", "start", value);
     }
-    if (to && keyLooksLikeDateBoundary(key, "end")) {
-      params[key] = formatDateOverride(to, "end", value);
+    if (endKeys.has(key)) {
+      params[key] = formatDateOverride(to ?? "", "end", value);
     }
   }
   for (let i = 0; i < paramMetadata.length; i++) {
     const param = paramMetadata[i];
     if (!param) continue;
     const key = normalizeGeneratedParamKey(param, i);
-    if (from && keyLooksLikeDateBoundary(key, "start")) {
-      param.value = formatDateOverride(from, "start", param.value);
+    if (startKeys.has(key)) {
+      param.value = formatDateOverride(from ?? "", "start", param.value);
     }
-    if (to && keyLooksLikeDateBoundary(key, "end")) {
-      param.value = formatDateOverride(to, "end", param.value);
+    if (endKeys.has(key)) {
+      param.value = formatDateOverride(to ?? "", "end", param.value);
     }
   }
 }
+function buildPreviousParams(params, paramMetadata) {
+  if (paramMetadata.length > 0) return paramMetadata;
+  return Object.entries(params).map(([name, value]) => ({ name, value }));
+}
 function buildVizHints(modifications) {
   const hints = {};
   if (modifications.kind) {
@@ -2356,6 +2480,9 @@ async function modifyChart(client, queryEngine, input, options, signal) {
   const hasSqlMods = !!input.sqlModifications;
   const hasVizMods = !!input.vizModifications;
   const hasCustomSql = !!input.sqlModifications?.customSql;
+  const lightweight = options?.lightweight === true;
+  const dateOnly = lightweight && isDateRangeOnlySqlModification(input.sqlModifications);
+  const skipChartLlm = lightweight && !hasCustomSql && (dateOnly || hasVizMods && !hasSqlMods);
   resolveQueryPipeline(options?.pipeline);
   const queryEndpoint = "/v2/query";
   let currentSql = input.sql;
@@ -2409,6 +2536,20 @@ async function modifyChart(client, queryEngine, input, options, signal) {
     paramMetadata = [];
     queryId = void 0;
     sqlChanged = true;
+  } else if (dateOnly && canSubstituteDateRangeParams(
+    input.sqlModifications?.dateRange,
+    finalSql,
+    finalParams,
+    paramMetadata
+  )) {
+    finalParams = { ...finalParams };
+    applyDateRangeOverrides(
+      input.sqlModifications?.dateRange,
+      finalSql,
+      finalParams,
+      paramMetadata
+    );
+    sqlChanged = false;
   } else if (hasSqlMods && !hasCustomSql) {
     const modifiedQuestion = buildModifiedQuestion(
       input.question,
@@ -2416,18 +2557,36 @@ async function modifyChart(client, queryEngine, input, options, signal) {
       hasQuerypanelSessionContext
     );
     finalQuestion = modifiedQuestion;
-    const queryResponse = await client.post(
+    const sharedBody = {
+      session_id: querypanelSessionId,
+      previous_sql: currentSql,
+      ...tenantSettings ? { tenant_settings: tenantSettings } : {},
+      ...databaseName ? { database: databaseName } : {},
+      ...metadata?.dialect ? { dialect: metadata.dialect } : {},
+      debug: options?.debug ?? false
+    };
+    const [endpoint, body] = dateOnly ? [
+      REWRITE_DATEFILTER_ENDPOINT,
+      {
+        ...sharedBody,
+        question: input.question,
+        previous_params: buildPreviousParams(finalParams, paramMetadata),
+        date_range: {
+          from: normalizeDateInput(input.sqlModifications?.dateRange?.from),
+          to: normalizeDateInput(input.sqlModifications?.dateRange?.to)
+        }
+      }
+    ] : [
       queryEndpoint,
       {
+        ...sharedBody,
         question: modifiedQuestion,
-        session_id: querypanelSessionId,
-        previous_sql: currentSql,
-        ...options?.maxRetry ? { max_retry: options.maxRetry } : {},
-        ...tenantSettings ? { tenant_settings: tenantSettings } : {},
-        ...databaseName ? { database: databaseName } : {},
-        ...metadata?.dialect ? { dialect: metadata.dialect } : {},
-        debug: options?.debug ?? false
-      },
+        ...options?.maxRetry ? { max_retry: options.maxRetry } : {}
+      }
+    ];
+    const queryResponse = await client.post(
+      endpoint,
+      body,
       tenantId,
       options?.userId,
       options?.scopes,
@@ -2439,6 +2598,7 @@ async function modifyChart(client, queryEngine, input, options, signal) {
     finalParams = queryEngine.mapGeneratedParams(paramMetadata);
     applyDateRangeOverrides(
       input.sqlModifications?.dateRange,
+      finalSql,
       finalParams,
       paramMetadata
     );
@@ -2459,7 +2619,7 @@ async function modifyChart(client, queryEngine, input, options, signal) {
   };
   const vizHints = hasVizMods ? buildVizHints(input.vizModifications) : {};
   const vizHintsForChart = chartType === "vizspec" ? vizHints : stripVizSpecOnlyHints(vizHints);
-  if (chartType === "vizspec") {
+  if (!skipChartLlm && chartType === "vizspec") {
     const vizspecResponse = await client.post(
       "/vizspec",
       {
@@ -2486,7 +2646,7 @@ async function modifyChart(client, queryEngine, input, options, signal) {
       specType: "vizspec",
       notes: rows.length === 0 ? vizspecResponse.notes ?? "Query returned no rows." : vizspecResponse.notes
     };
-  } else {
+  } else if (!skipChartLlm) {
     const chartResponse = await client.post(
       "/chart",
       {
@@ -2742,7 +2902,7 @@ var QueryPanelSdkAPI = class _QueryPanelSdkAPI {
     const adapter = new PostgresAdapter(clientFn, options);
     const metadata = {
       name,
-      dialect: "postgres",
+      dialect: adapter.getDialect(),
       description: options?.description,
       tags: options?.tags,
       tenantFieldName: options?.tenantFieldName,
@@ -2754,6 +2914,14 @@ var QueryPanelSdkAPI = class _QueryPanelSdkAPI {
     };
     this.queryEngine.attachDatabase(name, adapter, metadata);
   }
+  /**
+   * Attach an Amazon Redshift database. Redshift speaks the Postgres wire
+   * protocol, so `clientFn` can wrap a `pg` client; introspection uses
+   * Redshift's svv_* catalog views and SQL is generated for Redshift.
+   */
+  attachRedshift(name, clientFn, options) {
+    this.attachPostgres(name, clientFn, { ...options, dialect: "redshift" });
+  }
   attachBigQuery(name, clientFn, options) {
     const adapter = new BigQueryAdapter(clientFn, options);
     const metadata = {