@deepagents/text2sql 0.38.1 → 0.39.0

package/dist/lib/adapters/groundings/context.d.ts

@@ -33,8 +33,8 @@ export interface GroundingContext {
     info?: AdapterInfo;
     /** Shared cache for cross-grounding deduplication. Keyed by `type:key`. */
     cache: Map<string, unknown>;
-    /** Optional progress sink for long-running introspection work. */
-    onProgress?: OnProgress;
+    /** Progress sink for long-running introspection work. */
+    onProgress: OnProgress;
 }
 /**
  * Create a new empty grounding context.

package/dist/lib/adapters/groundings/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/groundings/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,wCAAwC;IACxC,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd,iDAAiD;IACjD,aAAa,EAAE,YAAY,EAAE,CAAC;IAE9B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB,2EAA2E;IAC3E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5B,kEAAkE;IAClE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAO,GACxC,gBAAgB,CASlB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/groundings/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,wCAAwC;IACxC,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd,iDAAiD;IACjD,aAAa,EAAE,YAAY,EAAE,CAAC;IAE9B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB,2EAA2E;IAC3E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5B,yDAAyD;IACzD,UAAU,EAAE,UAAU,CAAC;CACxB;AAcD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAO,GACxC,gBAAgB,CASlB"}

package/dist/lib/adapters/groundings/index.js

@@ -40,7 +40,7 @@ var ColumnStatsGrounding = class extends AbstractGrounding {
     const total = allContainers.length;
     for (let i = 0; i < allContainers.length; i++) {
       const container = allContainers[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "column_stats",
         table: container.name,
@@ -158,7 +158,7 @@ var ColumnValuesGrounding = class extends AbstractGrounding {
     const total = allContainers.length;
     for (let i = 0; i < allContainers.length; i++) {
       const container = allContainers[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "column_values",
         table: container.name,
@@ -229,7 +229,7 @@ var ConstraintGrounding = class extends AbstractGrounding {
     const total = ctx.tables.length;
     for (let i = 0; i < ctx.tables.length; i++) {
       const table = ctx.tables[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "constraints",
         table: table.name,
@@ -247,6 +247,17 @@ var ConstraintGrounding = class extends AbstractGrounding {
 };
 
 // packages/text2sql/src/lib/adapters/groundings/context.ts
+var noopProgress = () => {
+};
+function timestampProgress(onProgress) {
+  if (!onProgress) return noopProgress;
+  return (progress) => {
+    onProgress({
+      ...progress,
+      timestampMs: progress.timestampMs ?? Date.now()
+    });
+  };
+}
 function createGroundingContext(options = {}) {
   return {
     tables: [],
@@ -254,7 +265,7 @@ function createGroundingContext(options = {}) {
     relationships: [],
     info: void 0,
     cache: /* @__PURE__ */ new Map(),
-    onProgress: options.onProgress
+    onProgress: timestampProgress(options.onProgress)
   };
 }
 
@@ -285,7 +296,7 @@ var RowCountGrounding = class extends AbstractGrounding {
     const total = ctx.tables.length;
     for (let i = 0; i < ctx.tables.length; i++) {
       const table = ctx.tables[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "row_counts",
         table: table.name,
@@ -336,7 +347,7 @@ var TableGrounding = class extends AbstractGrounding {
     if (!forward && !backward) {
       const tables2 = await Promise.all(
         seedTables.map(async (name, index) => {
-          ctx.onProgress?.({
+          ctx.onProgress({
             type: "phase:progress",
             phase: "tables",
             table: name,
@@ -371,7 +382,7 @@ var TableGrounding = class extends AbstractGrounding {
       forwardVisited.add(name);
       if (!tables[name]) {
         loadedCount++;
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:progress",
           phase: "tables",
           table: name,
@@ -403,7 +414,7 @@ var TableGrounding = class extends AbstractGrounding {
       backwardVisited.add(name);
       if (!tables[name]) {
         loadedCount++;
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:progress",
           phase: "tables",
           table: name,
@@ -489,7 +500,7 @@ var ViewGrounding = class extends AbstractGrounding {
     const viewNames = await this.applyFilter();
     const views = await Promise.all(
       viewNames.map(async (name, index) => {
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:progress",
           phase: "views",
           table: name,

package/dist/lib/adapters/groundings/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/adapters/groundings/abstract.grounding.ts", "../../../../src/lib/adapters/groundings/column-stats.grounding.ts", "../../../../src/lib/adapters/groundings/column-values.grounding.ts", "../../../../src/lib/adapters/groundings/constraint.grounding.ts", "../../../../src/lib/adapters/groundings/context.ts", "../../../../src/lib/adapters/groundings/info.grounding.ts", "../../../../src/lib/adapters/groundings/row-count.grounding.ts", "../../../../src/lib/adapters/groundings/table.grounding.ts", "../../../../src/lib/adapters/groundings/view.grounding.ts"],
-  "sourcesContent": ["import type { FragmentObject } from '@deepagents/context';\n\nimport type { Adapter, IntrospectionPhase } from '../adapter.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Filter type for table names.\n * - string[]: explicit list of table names\n * - RegExp: pattern to match table names\n * - function: predicate to filter table names\n */\nexport type Filter = string[] | RegExp | ((tableName: string) => boolean);\n\n/**\n * Per-entity column filter.\n * Maps entity name (table or view) to a Filter that selects which columns to keep.\n * Entities not listed in the record keep all their columns.\n */\nexport type ColumnsFilter = Record<string, Filter>;\n\n/**\n * Filter a columns array using a Filter.\n * Keeps columns whose name matches the filter.\n */\nexport function filterColumns<T extends { name: string }>(\n  columns: T[],\n  filter: Filter,\n): T[] {\n  if (Array.isArray(filter)) {\n    return columns.filter((col) => filter.includes(col.name));\n  }\n  if (filter instanceof RegExp) {\n    return columns.filter((col) => filter.test(col.name));\n  }\n  return columns.filter((col) => filter(col.name));\n}\n\n/**\n * Apply per-entity column filtering.\n * Returns the entity unchanged if no filter matches its name.\n */\nexport function applyColumnFilter<\n  T extends { name: string; columns: { name: string }[] },\n>(entity: T, columnsConfig?: ColumnsFilter): T {\n  if (!columnsConfig) return entity;\n  const filter = columnsConfig[entity.name];\n  if (!filter) return entity;\n  return { ...entity, columns: filterColumns(entity.columns, filter) } as T;\n}\n\nexport interface AdapterInfo {\n  dialect: string;\n  version?: string;\n  database?: string;\n  details?: FragmentObject;\n}\nexport type AdapterInfoProvider =\n  | AdapterInfo\n  | (() => Promise<AdapterInfo> | AdapterInfo);\n\n/**\n * Abstract base class for database schema groundings.\n *\n * Groundings collect schema metadata into the shared GroundingContext.\n * Fragment generation is centralized in Adapter.introspect().\n */\nexport abstract class AbstractGrounding {\n  /**\n   * Grounding identifier for debugging/logging.\n   */\n  name: string;\n  phase?: IntrospectionPhase;\n\n  constructor(name: string, phase?: IntrospectionPhase) {\n    this.name = name;\n    this.phase = phase;\n  }\n\n  /**\n   * Execute grounding to populate the shared context.\n   * Groundings mutate ctx to add their collected data (tables, views, indexes, etc).\n   * Fragment generation happens centrally in Adapter after all groundings complete.\n   *\n   * @param ctx - Shared context for accumulating schema data\n   */\n  abstract execute(ctx: GroundingContext): Promise<void>;\n}\n\nclass SampleDataGrounding {\n  // this will fetch sample data for tables matching the filter\n}\n\nclass FunctionGrounding {\n  #filter: Filter;\n  #adapter: Adapter;\n  constructor(adapter: Adapter, filter: Filter) {\n    this.#filter = filter;\n    this.#adapter = adapter;\n  }\n}\n", "import type { ColumnStats } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { Column, ColumnContainer, GroundingContext } from './context.ts';\n\n/**\n * Configuration for ColumnStatsGrounding.\n */\nexport interface ColumnStatsGroundingConfig {\n  // Future: filter which tables/columns to collect stats for\n}\n\n/**\n * Abstract base class for column statistics grounding.\n *\n * Reads tables and views from the context and annotates their columns\n * with statistics (min, max, nullFraction).\n *\n * Subclasses implement database-specific hooks:\n * - `collectStats()` - collect min/max/nullFraction for a column\n */\nexport abstract class ColumnStatsGrounding extends AbstractGrounding {\n  constructor(config: ColumnStatsGroundingConfig = {}) {\n    super('columnStats', 'column_stats');\n  }\n\n  /**\n   * Collect min/max/nullFraction statistics for a column.\n   * Return undefined to skip this column.\n   */\n  protected abstract collectStats(\n    tableName: string,\n    column: Column,\n  ): Promise<ColumnStats | undefined>;\n\n  /**\n   * Execute the grounding process.\n   * Annotates columns in ctx.tables and ctx.views with statistics.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    // Process both tables and views\n    const allContainers: ColumnContainer[] = [...ctx.tables, ...ctx.views];\n    const total = allContainers.length;\n    for (let i = 0; i < allContainers.length; i++) {\n      const container = allContainers[i];\n      ctx.onProgress?.({\n        type: 'phase:progress',\n        phase: 'column_stats',\n        table: container.name,\n        message: `Collecting stats for ${container.name}...`,\n        current: i + 1,\n        total,\n      });\n      for (const column of container.columns) {\n        // Collect min/max/nullFraction\n        try {\n          const stats = await this.collectStats(container.name, column);\n          if (stats) {\n            column.stats = stats;\n          }\n        } catch (error) {\n          // Skip on error\n          console.warn(\n            'Error collecting stats for',\n            container.name,\n            column.name,\n            error,\n          );\n        }\n      }\n    }\n  }\n}\n", "import type { Table, TableConstraint } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { Column, ColumnContainer, GroundingContext } from './context.ts';\n\nexport type { Column, ColumnContainer };\n\n/**\n * Result of column value detection.\n */\nexport type ColumnValuesResult = {\n  kind: 'Enum' | 'LowCardinality';\n  values: string[];\n};\n\n/**\n * Configuration for ColumnValuesGrounding.\n */\nexport interface ColumnValuesGroundingConfig {\n  /** Maximum number of distinct values to consider low cardinality (default: 20) */\n  lowCardinalityLimit?: number;\n  /** Maximum character length for individual values. Columns with any value exceeding this are skipped entirely (default: 100) */\n  maxValueLength?: number;\n}\n\n/**\n * Abstract base class for column values grounding.\n *\n * Discovers possible values for columns from three sources (in priority order):\n * 1. Native ENUM types (PostgreSQL, MySQL) \u2192 kind: 'Enum'\n * 2. CHECK constraints with IN clauses \u2192 kind: 'Enum'\n * 3. Low cardinality data scan \u2192 kind: 'LowCardinality'\n *\n * Subclasses implement database-specific hooks:\n * - `collectEnumValues()` - get values for native ENUM columns\n * - `collectLowCardinality()` - collect distinct values via data scan\n */\nexport abstract class ColumnValuesGrounding extends AbstractGrounding {\n  protected lowCardinalityLimit: number;\n  protected maxValueLength: number;\n\n  constructor(config: ColumnValuesGroundingConfig = {}) {\n    super('columnValues', 'column_values');\n    this.lowCardinalityLimit = config.lowCardinalityLimit ?? 20;\n    this.maxValueLength = config.maxValueLength ?? 100;\n  }\n\n  /**\n   * Get values for native ENUM type columns.\n   * Return undefined if column is not an ENUM type.\n   * Default implementation returns undefined (no native ENUM support).\n   */\n  protected async collectEnumValues(\n    _tableName: string,\n    _column: Column,\n  ): Promise<string[] | undefined> {\n    return undefined;\n  }\n\n  /**\n   * Collect distinct values for low cardinality columns via data scan.\n   * Return undefined if column has too many distinct values.\n   */\n  protected abstract collectLowCardinality(\n    tableName: string,\n    column: Column,\n  ): Promise<string[] | undefined>;\n\n  /**\n   * Parse CHECK constraint for enum-like IN clause.\n   * Extracts values from patterns like:\n   * - CHECK (status IN ('active', 'inactive'))\n   * - CHECK ((status)::text = ANY (ARRAY['a'::text, 'b'::text]))\n   * - CHECK (status = 'active' OR status = 'inactive')\n   */\n  protected parseCheckConstraint(\n    constraint: TableConstraint,\n    columnName: string,\n  ): string[] | undefined {\n    if (constraint.type !== 'CHECK' || !constraint.definition) {\n      return undefined;\n    }\n\n    // Check if constraint applies to this column\n    if (constraint.columns && !constraint.columns.includes(columnName)) {\n      return undefined;\n    }\n\n    const def = constraint.definition;\n    const escapedCol = this.escapeRegex(columnName);\n\n    // Column pattern: matches column name with optional parens and type cast\n    // e.g., \"status\", \"(status)\", \"((status)::text)\"\n    const colPattern = `(?:\\\\(?\\\\(?${escapedCol}\\\\)?(?:::(?:text|varchar|character varying))?\\\\)?)`;\n\n    // Pattern 1: column IN ('val1', 'val2', ...)\n    const inMatch = def.match(\n      new RegExp(`${colPattern}\\\\s+IN\\\\s*\\\\(([^)]+)\\\\)`, 'i'),\n    );\n    if (inMatch) {\n      return this.extractStringValues(inMatch[1]);\n    }\n\n    // Pattern 2: PostgreSQL ANY(ARRAY[...])\n    const anyMatch = def.match(\n      new RegExp(\n        `${colPattern}\\\\s*=\\\\s*ANY\\\\s*\\\\(\\\\s*(?:ARRAY)?\\\\s*\\\\[([^\\\\]]+)\\\\]`,\n        'i',\n      ),\n    );\n    if (anyMatch) {\n      return this.extractStringValues(anyMatch[1]);\n    }\n\n    // Pattern 3: column = 'val1' OR column = 'val2' ...\n    const orPattern = new RegExp(\n      `\\\\b${this.escapeRegex(columnName)}\\\\b\\\\s*=\\\\s*'([^']*)'`,\n      'gi',\n    );\n    const orMatches = [...def.matchAll(orPattern)];\n    if (orMatches.length >= 2) {\n      return orMatches.map((m) => m[1]);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Extract string values from a comma-separated list.\n   */\n  private extractStringValues(input: string): string[] | undefined {\n    const values: string[] = [];\n    // Match quoted strings: 'value' or 'value'::type\n    const matches = input.matchAll(/'([^']*)'/g);\n    for (const match of matches) {\n      values.push(match[1]);\n    }\n    return values.length > 0 ? values : undefined;\n  }\n\n  /**\n   * Escape special regex characters in a string.\n   */\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n\n  /**\n   * Get the table from context by name.\n   */\n  private getTable(ctx: GroundingContext, name: string): Table | undefined {\n    return ctx.tables.find((t) => t.name === name);\n  }\n\n  /**\n   * Execute the grounding process.\n   * Annotates columns in ctx.tables and ctx.views with values.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    // Process both tables and views\n    const allContainers: ColumnContainer[] = [...ctx.tables, ...ctx.views];\n\n    const total = allContainers.length;\n    for (let i = 0; i < allContainers.length; i++) {\n      const container = allContainers[i];\n      ctx.onProgress?.({\n        type: 'phase:progress',\n        phase: 'column_values',\n        table: container.name,\n        message: `Collecting column values for ${container.name}...`,\n        current: i + 1,\n        total,\n      });\n      const table = this.getTable(ctx, container.name);\n\n      for (const column of container.columns) {\n        try {\n          const result = await this.resolveColumnValues(\n            container.name,\n            column,\n            table?.constraints,\n          );\n          if (result) {\n            column.kind = result.kind;\n            column.values = result.values;\n          }\n        } catch (error) {\n          console.warn(\n            'Error collecting column values for',\n            container.name,\n            column.name,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  private exceedsMaxValueLength(values: string[]): boolean {\n    return values.some((v) => v.length > this.maxValueLength);\n  }\n\n  /**\n   * Resolve column values from all sources in priority order.\n   */\n  private async resolveColumnValues(\n    tableName: string,\n    column: Column,\n    constraints?: TableConstraint[],\n  ): Promise<ColumnValuesResult | undefined> {\n    // Priority 1: Native ENUM type\n    const enumValues = await this.collectEnumValues(tableName, column);\n    if (enumValues?.length && !this.exceedsMaxValueLength(enumValues)) {\n      return { kind: 'Enum', values: enumValues };\n    }\n\n    // Priority 2: CHECK constraint with IN clause\n    if (constraints) {\n      for (const constraint of constraints) {\n        const checkValues = this.parseCheckConstraint(constraint, column.name);\n        if (checkValues?.length && !this.exceedsMaxValueLength(checkValues)) {\n          return { kind: 'Enum', values: checkValues };\n        }\n      }\n    }\n\n    // Priority 3: Low cardinality data scan\n    const lowCardValues = await this.collectLowCardinality(tableName, column);\n    if (lowCardValues?.length && !this.exceedsMaxValueLength(lowCardValues)) {\n      return { kind: 'LowCardinality', values: lowCardValues };\n    }\n\n    return undefined;\n  }\n}\n", "import type { TableConstraint } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for ConstraintGrounding.\n */\nexport interface ConstraintGroundingConfig {\n  // Future: filter which tables/constraint types to collect\n}\n\n/**\n * Abstract base class for constraint grounding.\n *\n * Reads tables from the context and annotates them with constraints\n * (CHECK, UNIQUE, NOT_NULL, DEFAULT).\n * This grounding must run AFTER TableGrounding since it reads from ctx.tables.\n *\n * Subclasses implement the database-specific hook:\n * - `getConstraints()` - fetch constraints for a table\n */\nexport abstract class ConstraintGrounding extends AbstractGrounding {\n  constructor(config: ConstraintGroundingConfig = {}) {\n    super('constraint', 'constraints');\n  }\n\n  /**\n   * Fetch constraints for a specific table.\n   */\n  protected abstract getConstraints(\n    tableName: string,\n  ): Promise<TableConstraint[]>;\n\n  /**\n   * Execute the grounding process.\n   * Annotates tables in ctx.tables with their constraints.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const total = ctx.tables.length;\n    for (let i = 0; i < ctx.tables.length; i++) {\n      const table = ctx.tables[i];\n      ctx.onProgress?.({\n        type: 'phase:progress',\n        phase: 'constraints',\n        table: table.name,\n        message: `Loading constraints for ${table.name}...`,\n        current: i + 1,\n        total,\n      });\n      try {\n        table.constraints = await this.getConstraints(table.name);\n      } catch (error) {\n        // Skip on error - table might not exist or be inaccessible\n        console.warn('Error collecting constraints for', table.name, error);\n      }\n    }\n  }\n}\n", "import type {\n  AdapterInfo,\n  ColumnStats,\n  OnProgress,\n  Relationship,\n  Table,\n} from '../adapter.ts';\nimport type { View } from './view.grounding.ts';\n\n/**\n * Column type for grounding operations.\n * Common interface between Table.columns and View.columns.\n */\nexport interface Column {\n  name: string;\n  type: string;\n  kind?: 'LowCardinality' | 'Enum';\n  values?: string[];\n  stats?: ColumnStats;\n}\n\n/**\n * Entity with columns (Table or View).\n */\nexport interface ColumnContainer {\n  name: string;\n  columns: Column[];\n}\n\n/**\n * Shared context object passed to all groundings.\n * Groundings read from and write to this context.\n */\nexport interface GroundingContext {\n  /** Tables discovered by TableGrounding */\n  tables: Table[];\n\n  /** Views discovered by ViewGrounding */\n  views: View[];\n\n  /** Relationships discovered by TableGrounding */\n  relationships: Relationship[];\n\n  /** Database info collected by InfoGrounding */\n  info?: AdapterInfo;\n\n  /** Shared cache for cross-grounding deduplication. Keyed by `type:key`. */\n  cache: Map<string, unknown>;\n\n  /** Optional progress sink for long-running introspection work. */\n  onProgress?: OnProgress;\n}\n\n/**\n * Create a new empty grounding context.\n */\nexport function createGroundingContext(\n  options: { onProgress?: OnProgress } = {},\n): GroundingContext {\n  return {\n    tables: [],\n    views: [],\n    relationships: [],\n    info: undefined,\n    cache: new Map(),\n    onProgress: options.onProgress,\n  };\n}\n", "import type { AdapterInfo } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for InfoGrounding.\n */\nexport interface InfoGroundingConfig {\n  // Future: options to control what info to collect\n}\n\n/**\n * Abstract base class for database info grounding.\n *\n * Collects database dialect, version, and connection info.\n *\n * Subclasses implement the database-specific hook:\n * - `collectInfo()` - collect database info\n */\nexport abstract class InfoGrounding extends AbstractGrounding {\n  constructor(config: InfoGroundingConfig = {}) {\n    super('dialectInfo', 'info');\n  }\n\n  /**\n   * Collect database dialect, version, and other info.\n   */\n  protected abstract collectInfo(): Promise<AdapterInfo>;\n\n  /**\n   * Execute the grounding process.\n   * Writes database info to ctx.info.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    ctx.info = await this.collectInfo();\n  }\n}\n", "import type { Table } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for RowCountGrounding.\n */\nexport interface RowCountGroundingConfig {\n  // Future: filter which tables to count\n}\n\n/**\n * Abstract base class for row count grounding.\n *\n * Reads tables from the context and annotates them with row counts and size hints.\n * This grounding must run AFTER TableGrounding since it reads from ctx.tables.\n *\n * Subclasses implement the database-specific hook:\n * - `getRowCount()` - get row count for a table\n */\nexport abstract class RowCountGrounding extends AbstractGrounding {\n  constructor(config: RowCountGroundingConfig = {}) {\n    super('rowCount', 'row_counts');\n  }\n\n  /**\n   * Get row count for a specific table.\n   */\n  protected abstract getRowCount(\n    tableName: string,\n  ): Promise<number | undefined>;\n\n  /**\n   * Execute the grounding process.\n   * Annotates tables in ctx.tables with row counts and size hints.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const total = ctx.tables.length;\n    for (let i = 0; i < ctx.tables.length; i++) {\n      const table = ctx.tables[i];\n      ctx.onProgress?.({\n        type: 'phase:progress',\n        phase: 'row_counts',\n        table: table.name,\n        message: `Counting rows in ${table.name}...`,\n        current: i + 1,\n        total,\n      });\n      const count = await this.getRowCount(table.name);\n      if (count != null) {\n        table.rowCount = count;\n        table.sizeHint = this.#classifyRowCount(count);\n      }\n    }\n  }\n\n  /**\n   * Classify row count into a size hint category.\n   */\n  #classifyRowCount(count: number): Table['sizeHint'] {\n    if (count < 100) return 'tiny';\n    if (count < 1000) return 'small';\n    if (count < 10000) return 'medium';\n    if (count < 100000) return 'large';\n    return 'huge';\n  }\n}\n", "import type { Filter, Relationship, Table } from '../adapter.ts';\nimport {\n  AbstractGrounding,\n  type ColumnsFilter,\n  applyColumnFilter,\n  filterColumns,\n} from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for TableGrounding.\n */\nexport interface TableGroundingConfig {\n  /** Filter to select seed tables */\n  filter?: Filter;\n  /**\n   * Per-table column filter.\n   * Maps table name to a Filter that selects which columns to keep.\n   * Tables not listed keep all their columns.\n   */\n  columns?: ColumnsFilter;\n  /**\n   * Traverse forward (child\u2192parent) following FK direction.\n   * - true: unlimited depth\n   * - number: maximum depth\n   * - false/undefined: no forward traversal\n   */\n  forward?: boolean | number;\n  /**\n   * Traverse backward (parent\u2192child) finding tables that reference us.\n   * - true: unlimited depth\n   * - number: maximum depth\n   * - false/undefined: no backward traversal\n   */\n  backward?: boolean | number;\n}\n\n/**\n * Abstract base class for table grounding.\n *\n * The `execute()` method implements a BFS traversal algorithm that discovers\n * tables and relationships. Subclasses implement the database-specific hooks:\n * - `getAllTableNames()` - list all tables\n * - `getTable()` - get table metadata\n * - `findOutgoingRelations()` - find FKs FROM a table\n * - `findIncomingRelations()` - find FKs TO a table\n */\nexport abstract class TableGrounding extends AbstractGrounding {\n  #filter?: Filter;\n  #columns?: ColumnsFilter;\n  #forward?: boolean | number;\n  #backward?: boolean | number;\n\n  constructor(config: TableGroundingConfig = {}) {\n    super('table', 'tables');\n    this.#filter = config.filter;\n    this.#columns = config.columns;\n    this.#forward = config.forward;\n    this.#backward = config.backward;\n  }\n\n  /** Get all table names in the database */\n  protected abstract getAllTableNames(): Promise<string[]>;\n\n  /** Get full table metadata for a single table */\n  protected abstract getTable(tableName: string): Promise<Table>;\n\n  /** Find FKs FROM this table (outgoing relationships) */\n  protected abstract findOutgoingRelations(\n    tableName: string,\n  ): Promise<Relationship[]>;\n\n  /** Find FKs TO this table (incoming relationships) */\n  protected abstract findIncomingRelations(\n    tableName: string,\n  ): Promise<Relationship[]>;\n\n  /**\n   * Execute the grounding process.\n   * Writes discovered tables and relationships to the context.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const seedTables = await this.applyFilter();\n    const forward = this.#forward;\n    const backward = this.#backward;\n\n    // No traversal at all - just add the seed tables\n    if (!forward && !backward) {\n      const tables = await Promise.all(\n        seedTables.map(async (name, index) => {\n          ctx.onProgress?.({\n            type: 'phase:progress',\n            phase: 'tables',\n            table: name,\n            message: `Loading table ${name}...`,\n            current: index + 1,\n            total: seedTables.length,\n          });\n          return applyColumnFilter(await this.getTable(name), this.#columns);\n        }),\n      );\n      ctx.tables.push(...tables);\n      return;\n    }\n\n    const tables: Record<string, Table> = {};\n    const allRelationships: Relationship[] = [];\n    const seenRelationships = new Set<string>();\n\n    // Track depth separately for forward/backward using BFS\n    const forwardQueue: Array<{ name: string; depth: number }> = [];\n    const backwardQueue: Array<{ name: string; depth: number }> = [];\n    const forwardVisited = new Set<string>();\n    const backwardVisited = new Set<string>();\n    let loadedCount = 0;\n\n    // Initialize queues with seed tables at depth 0\n    for (const name of seedTables) {\n      if (forward) forwardQueue.push({ name, depth: 0 });\n      if (backward) backwardQueue.push({ name, depth: 0 });\n    }\n\n    // Process forward (child\u2192parent)\n    const forwardLimit = forward === true ? Infinity : forward || 0;\n    while (forwardQueue.length > 0) {\n      const item = forwardQueue.shift();\n      if (!item) break;\n      const { name, depth } = item;\n\n      if (forwardVisited.has(name)) continue;\n      forwardVisited.add(name);\n\n      if (!tables[name]) {\n        loadedCount++;\n        ctx.onProgress?.({\n          type: 'phase:progress',\n          phase: 'tables',\n          table: name,\n          message: `Loading table ${name}...`,\n          current: loadedCount,\n        });\n        tables[name] = applyColumnFilter(\n          await this.getTable(name),\n          this.#columns,\n        );\n      }\n\n      if (depth < forwardLimit) {\n        const rels = await this.findOutgoingRelations(name);\n        for (const rel of rels) {\n          if (!this.isRelationshipVisible(rel)) continue;\n          this.addRelationship(rel, allRelationships, seenRelationships);\n          if (!forwardVisited.has(rel.referenced_table)) {\n            forwardQueue.push({ name: rel.referenced_table, depth: depth + 1 });\n          }\n        }\n      }\n    }\n\n    // Process backward (parent\u2192child)\n    const backwardLimit = backward === true ? Infinity : backward || 0;\n    while (backwardQueue.length > 0) {\n      const item = backwardQueue.shift();\n      if (!item) break;\n      const { name, depth } = item;\n\n      if (backwardVisited.has(name)) continue;\n      backwardVisited.add(name);\n\n      if (!tables[name]) {\n        loadedCount++;\n        ctx.onProgress?.({\n          type: 'phase:progress',\n          phase: 'tables',\n          table: name,\n          message: `Loading table ${name}...`,\n          current: loadedCount,\n        });\n        tables[name] = applyColumnFilter(\n          await this.getTable(name),\n          this.#columns,\n        );\n      }\n\n      if (depth < backwardLimit) {\n        const rels = await this.findIncomingRelations(name);\n        for (const rel of rels) {\n          if (!this.isRelationshipVisible(rel)) continue;\n          this.addRelationship(rel, allRelationships, seenRelationships);\n          if (!backwardVisited.has(rel.table)) {\n            backwardQueue.push({ name: rel.table, depth: depth + 1 });\n          }\n        }\n      }\n    }\n\n    // Write to context\n    const tablesList = Object.values(tables);\n    ctx.tables.push(...tablesList);\n    ctx.relationships.push(...allRelationships);\n  }\n\n  /**\n   * Apply the filter to get seed table names.\n   * If filter is an explicit array, skip querying all table names.\n   */\n  protected async applyFilter(): Promise<string[]> {\n    const filter = this.#filter;\n    if (Array.isArray(filter)) {\n      return filter;\n    }\n    const names = await this.getAllTableNames();\n    if (!filter) {\n      return names;\n    }\n    if (filter instanceof RegExp) {\n      return names.filter((name) => filter.test(name));\n    }\n    return names.filter(filter);\n  }\n\n  /**\n   * Add a relationship to the collection, deduplicating by key.\n   */\n  protected addRelationship(\n    rel: Relationship,\n    all: Relationship[],\n    seen: Set<string>,\n  ): void {\n    const key = `${rel.table}:${rel.from.join(',')}:${rel.referenced_table}:${rel.to.join(',')}`;\n    if (!seen.has(key)) {\n      seen.add(key);\n      all.push(rel);\n    }\n  }\n\n  protected isRelationshipVisible(rel: Relationship): boolean {\n    return (\n      this.areColumnsVisible(rel.from, this.#columns?.[rel.table]) &&\n      this.areColumnsVisible(rel.to, this.#columns?.[rel.referenced_table])\n    );\n  }\n\n  protected areColumnsVisible(names: string[], filter?: Filter): boolean {\n    if (!filter) return true;\n    return (\n      filterColumns(\n        names.map((name) => ({ name })),\n        filter,\n      ).length === names.length\n    );\n  }\n}\n", "import type { ColumnStats, Filter } from '../adapter.ts';\nimport {\n  AbstractGrounding,\n  type ColumnsFilter,\n  applyColumnFilter,\n} from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Represents a database view with its metadata.\n */\nexport interface View {\n  name: string;\n  schema?: string;\n  rawName?: string;\n  /** The SQL definition of the view (CREATE VIEW statement or query) */\n  definition?: string;\n  columns: {\n    name: string;\n    type: string;\n    /** Low cardinality marker */\n    kind?: 'LowCardinality';\n    /** Distinct values for low cardinality columns */\n    values?: string[];\n    /** Column statistics (min, max, nullFraction) */\n    stats?: ColumnStats;\n  }[];\n}\n\n/**\n * Configuration for ViewGrounding.\n */\nexport interface ViewGroundingConfig {\n  /** Filter to select views */\n  filter?: Filter;\n  /**\n   * Per-view column filter.\n   * Maps view name to a Filter that selects which columns to keep.\n   * Views not listed keep all their columns.\n   */\n  columns?: ColumnsFilter;\n  /** Whether to fetch the SQL definition of each view (default: true) */\n  includeDefinition?: boolean;\n}\n\n/**\n * Abstract base class for view grounding\n *\n * The `execute()` method implements the algorithm that discovers views.\n * Subclasses implement the database-specific hooks:\n * - `getAllViewNames()` - list all views\n * - `getView()` - get view metadata\n */\nexport abstract class ViewGrounding extends AbstractGrounding {\n  #filter?: Filter;\n  #columns?: ColumnsFilter;\n  protected includeDefinition: boolean;\n\n  constructor(config: ViewGroundingConfig = {}) {\n    super('view', 'views');\n    this.#filter = config.filter;\n    this.#columns = config.columns;\n    this.includeDefinition = config.includeDefinition ?? true;\n  }\n\n  /** Get all view names in the database */\n  protected abstract getAllViewNames(): Promise<string[]>;\n\n  /** Get full view metadata for a single view */\n  protected abstract getView(viewName: string): Promise<View>;\n\n  /**\n   * Execute the grounding process.\n   * Writes discovered views to the context.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const viewNames = await this.applyFilter();\n    const views = await Promise.all(\n      viewNames.map(async (name, index) => {\n        ctx.onProgress?.({\n          type: 'phase:progress',\n          phase: 'views',\n          table: name,\n          message: `Loading view ${name}...`,\n          current: index + 1,\n          total: viewNames.length,\n        });\n        return applyColumnFilter(await this.getView(name), this.#columns);\n      }),\n    );\n    ctx.views.push(...views);\n  }\n\n  /**\n   * Apply the filter to get view names.\n   * If filter is an explicit array, skip querying all view names.\n   */\n  protected async applyFilter(): Promise<string[]> {\n    const filter = this.#filter;\n    if (Array.isArray(filter)) {\n      return filter;\n    }\n    const names = await this.getAllViewNames();\n    if (!filter) {\n      return names;\n    }\n    if (filter instanceof RegExp) {\n      return names.filter((name) => filter.test(name));\n    }\n    return names.filter(filter);\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { FragmentObject } from '@deepagents/context';\n\nimport type { Adapter, IntrospectionPhase } from '../adapter.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Filter type for table names.\n * - string[]: explicit list of table names\n * - RegExp: pattern to match table names\n * - function: predicate to filter table names\n */\nexport type Filter = string[] | RegExp | ((tableName: string) => boolean);\n\n/**\n * Per-entity column filter.\n * Maps entity name (table or view) to a Filter that selects which columns to keep.\n * Entities not listed in the record keep all their columns.\n */\nexport type ColumnsFilter = Record<string, Filter>;\n\n/**\n * Filter a columns array using a Filter.\n * Keeps columns whose name matches the filter.\n */\nexport function filterColumns<T extends { name: string }>(\n  columns: T[],\n  filter: Filter,\n): T[] {\n  if (Array.isArray(filter)) {\n    return columns.filter((col) => filter.includes(col.name));\n  }\n  if (filter instanceof RegExp) {\n    return columns.filter((col) => filter.test(col.name));\n  }\n  return columns.filter((col) => filter(col.name));\n}\n\n/**\n * Apply per-entity column filtering.\n * Returns the entity unchanged if no filter matches its name.\n */\nexport function applyColumnFilter<\n  T extends { name: string; columns: { name: string }[] },\n>(entity: T, columnsConfig?: ColumnsFilter): T {\n  if (!columnsConfig) return entity;\n  const filter = columnsConfig[entity.name];\n  if (!filter) return entity;\n  return { ...entity, columns: filterColumns(entity.columns, filter) } as T;\n}\n\nexport interface AdapterInfo {\n  dialect: string;\n  version?: string;\n  database?: string;\n  details?: FragmentObject;\n}\nexport type AdapterInfoProvider =\n  | AdapterInfo\n  | (() => Promise<AdapterInfo> | AdapterInfo);\n\n/**\n * Abstract base class for database schema groundings.\n *\n * Groundings collect schema metadata into the shared GroundingContext.\n * Fragment generation is centralized in Adapter.introspect().\n */\nexport abstract class AbstractGrounding {\n  /**\n   * Grounding identifier for debugging/logging.\n   */\n  name: string;\n  phase?: IntrospectionPhase;\n\n  constructor(name: string, phase?: IntrospectionPhase) {\n    this.name = name;\n    this.phase = phase;\n  }\n\n  /**\n   * Execute grounding to populate the shared context.\n   * Groundings mutate ctx to add their collected data (tables, views, indexes, etc).\n   * Fragment generation happens centrally in Adapter after all groundings complete.\n   *\n   * @param ctx - Shared context for accumulating schema data\n   */\n  abstract execute(ctx: GroundingContext): Promise<void>;\n}\n\nclass SampleDataGrounding {\n  // this will fetch sample data for tables matching the filter\n}\n\nclass FunctionGrounding {\n  #filter: Filter;\n  #adapter: Adapter;\n  constructor(adapter: Adapter, filter: Filter) {\n    this.#filter = filter;\n    this.#adapter = adapter;\n  }\n}\n", "import type { ColumnStats } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { Column, ColumnContainer, GroundingContext } from './context.ts';\n\n/**\n * Configuration for ColumnStatsGrounding.\n */\nexport interface ColumnStatsGroundingConfig {\n  // Future: filter which tables/columns to collect stats for\n}\n\n/**\n * Abstract base class for column statistics grounding.\n *\n * Reads tables and views from the context and annotates their columns\n * with statistics (min, max, nullFraction).\n *\n * Subclasses implement database-specific hooks:\n * - `collectStats()` - collect min/max/nullFraction for a column\n */\nexport abstract class ColumnStatsGrounding extends AbstractGrounding {\n  constructor(config: ColumnStatsGroundingConfig = {}) {\n    super('columnStats', 'column_stats');\n  }\n\n  /**\n   * Collect min/max/nullFraction statistics for a column.\n   * Return undefined to skip this column.\n   */\n  protected abstract collectStats(\n    tableName: string,\n    column: Column,\n  ): Promise<ColumnStats | undefined>;\n\n  /**\n   * Execute the grounding process.\n   * Annotates columns in ctx.tables and ctx.views with statistics.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    // Process both tables and views\n    const allContainers: ColumnContainer[] = [...ctx.tables, ...ctx.views];\n    const total = allContainers.length;\n    for (let i = 0; i < allContainers.length; i++) {\n      const container = allContainers[i];\n      ctx.onProgress({\n        type: 'phase:progress',\n        phase: 'column_stats',\n        table: container.name,\n        message: `Collecting stats for ${container.name}...`,\n        current: i + 1,\n        total,\n      });\n      for (const column of container.columns) {\n        // Collect min/max/nullFraction\n        try {\n          const stats = await this.collectStats(container.name, column);\n          if (stats) {\n            column.stats = stats;\n          }\n        } catch (error) {\n          // Skip on error\n          console.warn(\n            'Error collecting stats for',\n            container.name,\n            column.name,\n            error,\n          );\n        }\n      }\n    }\n  }\n}\n", "import type { Table, TableConstraint } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { Column, ColumnContainer, GroundingContext } from './context.ts';\n\nexport type { Column, ColumnContainer };\n\n/**\n * Result of column value detection.\n */\nexport type ColumnValuesResult = {\n  kind: 'Enum' | 'LowCardinality';\n  values: string[];\n};\n\n/**\n * Configuration for ColumnValuesGrounding.\n */\nexport interface ColumnValuesGroundingConfig {\n  /** Maximum number of distinct values to consider low cardinality (default: 20) */\n  lowCardinalityLimit?: number;\n  /** Maximum character length for individual values. Columns with any value exceeding this are skipped entirely (default: 100) */\n  maxValueLength?: number;\n}\n\n/**\n * Abstract base class for column values grounding.\n *\n * Discovers possible values for columns from three sources (in priority order):\n * 1. Native ENUM types (PostgreSQL, MySQL) \u2192 kind: 'Enum'\n * 2. CHECK constraints with IN clauses \u2192 kind: 'Enum'\n * 3. Low cardinality data scan \u2192 kind: 'LowCardinality'\n *\n * Subclasses implement database-specific hooks:\n * - `collectEnumValues()` - get values for native ENUM columns\n * - `collectLowCardinality()` - collect distinct values via data scan\n */\nexport abstract class ColumnValuesGrounding extends AbstractGrounding {\n  protected lowCardinalityLimit: number;\n  protected maxValueLength: number;\n\n  constructor(config: ColumnValuesGroundingConfig = {}) {\n    super('columnValues', 'column_values');\n    this.lowCardinalityLimit = config.lowCardinalityLimit ?? 20;\n    this.maxValueLength = config.maxValueLength ?? 100;\n  }\n\n  /**\n   * Get values for native ENUM type columns.\n   * Return undefined if column is not an ENUM type.\n   * Default implementation returns undefined (no native ENUM support).\n   */\n  protected async collectEnumValues(\n    _tableName: string,\n    _column: Column,\n  ): Promise<string[] | undefined> {\n    return undefined;\n  }\n\n  /**\n   * Collect distinct values for low cardinality columns via data scan.\n   * Return undefined if column has too many distinct values.\n   */\n  protected abstract collectLowCardinality(\n    tableName: string,\n    column: Column,\n  ): Promise<string[] | undefined>;\n\n  /**\n   * Parse CHECK constraint for enum-like IN clause.\n   * Extracts values from patterns like:\n   * - CHECK (status IN ('active', 'inactive'))\n   * - CHECK ((status)::text = ANY (ARRAY['a'::text, 'b'::text]))\n   * - CHECK (status = 'active' OR status = 'inactive')\n   */\n  protected parseCheckConstraint(\n    constraint: TableConstraint,\n    columnName: string,\n  ): string[] | undefined {\n    if (constraint.type !== 'CHECK' || !constraint.definition) {\n      return undefined;\n    }\n\n    // Check if constraint applies to this column\n    if (constraint.columns && !constraint.columns.includes(columnName)) {\n      return undefined;\n    }\n\n    const def = constraint.definition;\n    const escapedCol = this.escapeRegex(columnName);\n\n    // Column pattern: matches column name with optional parens and type cast\n    // e.g., \"status\", \"(status)\", \"((status)::text)\"\n    const colPattern = `(?:\\\\(?\\\\(?${escapedCol}\\\\)?(?:::(?:text|varchar|character varying))?\\\\)?)`;\n\n    // Pattern 1: column IN ('val1', 'val2', ...)\n    const inMatch = def.match(\n      new RegExp(`${colPattern}\\\\s+IN\\\\s*\\\\(([^)]+)\\\\)`, 'i'),\n    );\n    if (inMatch) {\n      return this.extractStringValues(inMatch[1]);\n    }\n\n    // Pattern 2: PostgreSQL ANY(ARRAY[...])\n    const anyMatch = def.match(\n      new RegExp(\n        `${colPattern}\\\\s*=\\\\s*ANY\\\\s*\\\\(\\\\s*(?:ARRAY)?\\\\s*\\\\[([^\\\\]]+)\\\\]`,\n        'i',\n      ),\n    );\n    if (anyMatch) {\n      return this.extractStringValues(anyMatch[1]);\n    }\n\n    // Pattern 3: column = 'val1' OR column = 'val2' ...\n    const orPattern = new RegExp(\n      `\\\\b${this.escapeRegex(columnName)}\\\\b\\\\s*=\\\\s*'([^']*)'`,\n      'gi',\n    );\n    const orMatches = [...def.matchAll(orPattern)];\n    if (orMatches.length >= 2) {\n      return orMatches.map((m) => m[1]);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Extract string values from a comma-separated list.\n   */\n  private extractStringValues(input: string): string[] | undefined {\n    const values: string[] = [];\n    // Match quoted strings: 'value' or 'value'::type\n    const matches = input.matchAll(/'([^']*)'/g);\n    for (const match of matches) {\n      values.push(match[1]);\n    }\n    return values.length > 0 ? values : undefined;\n  }\n\n  /**\n   * Escape special regex characters in a string.\n   */\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n\n  /**\n   * Get the table from context by name.\n   */\n  private getTable(ctx: GroundingContext, name: string): Table | undefined {\n    return ctx.tables.find((t) => t.name === name);\n  }\n\n  /**\n   * Execute the grounding process.\n   * Annotates columns in ctx.tables and ctx.views with values.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    // Process both tables and views\n    const allContainers: ColumnContainer[] = [...ctx.tables, ...ctx.views];\n\n    const total = allContainers.length;\n    for (let i = 0; i < allContainers.length; i++) {\n      const container = allContainers[i];\n      ctx.onProgress({\n        type: 'phase:progress',\n        phase: 'column_values',\n        table: container.name,\n        message: `Collecting column values for ${container.name}...`,\n        current: i + 1,\n        total,\n      });\n      const table = this.getTable(ctx, container.name);\n\n      for (const column of container.columns) {\n        try {\n          const result = await this.resolveColumnValues(\n            container.name,\n            column,\n            table?.constraints,\n          );\n          if (result) {\n            column.kind = result.kind;\n            column.values = result.values;\n          }\n        } catch (error) {\n          console.warn(\n            'Error collecting column values for',\n            container.name,\n            column.name,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  private exceedsMaxValueLength(values: string[]): boolean {\n    return values.some((v) => v.length > this.maxValueLength);\n  }\n\n  /**\n   * Resolve column values from all sources in priority order.\n   */\n  private async resolveColumnValues(\n    tableName: string,\n    column: Column,\n    constraints?: TableConstraint[],\n  ): Promise<ColumnValuesResult | undefined> {\n    // Priority 1: Native ENUM type\n    const enumValues = await this.collectEnumValues(tableName, column);\n    if (enumValues?.length && !this.exceedsMaxValueLength(enumValues)) {\n      return { kind: 'Enum', values: enumValues };\n    }\n\n    // Priority 2: CHECK constraint with IN clause\n    if (constraints) {\n      for (const constraint of constraints) {\n        const checkValues = this.parseCheckConstraint(constraint, column.name);\n        if (checkValues?.length && !this.exceedsMaxValueLength(checkValues)) {\n          return { kind: 'Enum', values: checkValues };\n        }\n      }\n    }\n\n    // Priority 3: Low cardinality data scan\n    const lowCardValues = await this.collectLowCardinality(tableName, column);\n    if (lowCardValues?.length && !this.exceedsMaxValueLength(lowCardValues)) {\n      return { kind: 'LowCardinality', values: lowCardValues };\n    }\n\n    return undefined;\n  }\n}\n", "import type { TableConstraint } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for ConstraintGrounding.\n */\nexport interface ConstraintGroundingConfig {\n  // Future: filter which tables/constraint types to collect\n}\n\n/**\n * Abstract base class for constraint grounding.\n *\n * Reads tables from the context and annotates them with constraints\n * (CHECK, UNIQUE, NOT_NULL, DEFAULT).\n * This grounding must run AFTER TableGrounding since it reads from ctx.tables.\n *\n * Subclasses implement the database-specific hook:\n * - `getConstraints()` - fetch constraints for a table\n */\nexport abstract class ConstraintGrounding extends AbstractGrounding {\n  constructor(config: ConstraintGroundingConfig = {}) {\n    super('constraint', 'constraints');\n  }\n\n  /**\n   * Fetch constraints for a specific table.\n   */\n  protected abstract getConstraints(\n    tableName: string,\n  ): Promise<TableConstraint[]>;\n\n  /**\n   * Execute the grounding process.\n   * Annotates tables in ctx.tables with their constraints.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const total = ctx.tables.length;\n    for (let i = 0; i < ctx.tables.length; i++) {\n      const table = ctx.tables[i];\n      ctx.onProgress({\n        type: 'phase:progress',\n        phase: 'constraints',\n        table: table.name,\n        message: `Loading constraints for ${table.name}...`,\n        current: i + 1,\n        total,\n      });\n      try {\n        table.constraints = await this.getConstraints(table.name);\n      } catch (error) {\n        // Skip on error - table might not exist or be inaccessible\n        console.warn('Error collecting constraints for', table.name, error);\n      }\n    }\n  }\n}\n", "import type {\n  AdapterInfo,\n  ColumnStats,\n  OnProgress,\n  Relationship,\n  Table,\n} from '../adapter.ts';\nimport type { View } from './view.grounding.ts';\n\n/**\n * Column type for grounding operations.\n * Common interface between Table.columns and View.columns.\n */\nexport interface Column {\n  name: string;\n  type: string;\n  kind?: 'LowCardinality' | 'Enum';\n  values?: string[];\n  stats?: ColumnStats;\n}\n\n/**\n * Entity with columns (Table or View).\n */\nexport interface ColumnContainer {\n  name: string;\n  columns: Column[];\n}\n\n/**\n * Shared context object passed to all groundings.\n * Groundings read from and write to this context.\n */\nexport interface GroundingContext {\n  /** Tables discovered by TableGrounding */\n  tables: Table[];\n\n  /** Views discovered by ViewGrounding */\n  views: View[];\n\n  /** Relationships discovered by TableGrounding */\n  relationships: Relationship[];\n\n  /** Database info collected by InfoGrounding */\n  info?: AdapterInfo;\n\n  /** Shared cache for cross-grounding deduplication. Keyed by `type:key`. */\n  cache: Map<string, unknown>;\n\n  /** Progress sink for long-running introspection work. */\n  onProgress: OnProgress;\n}\n\nconst noopProgress: OnProgress = () => {};\n\nfunction timestampProgress(onProgress?: OnProgress): OnProgress {\n  if (!onProgress) return noopProgress;\n  return (progress) => {\n    onProgress({\n      ...progress,\n      timestampMs: progress.timestampMs ?? Date.now(),\n    });\n  };\n}\n\n/**\n * Create a new empty grounding context.\n */\nexport function createGroundingContext(\n  options: { onProgress?: OnProgress } = {},\n): GroundingContext {\n  return {\n    tables: [],\n    views: [],\n    relationships: [],\n    info: undefined,\n    cache: new Map(),\n    onProgress: timestampProgress(options.onProgress),\n  };\n}\n", "import type { AdapterInfo } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for InfoGrounding.\n */\nexport interface InfoGroundingConfig {\n  // Future: options to control what info to collect\n}\n\n/**\n * Abstract base class for database info grounding.\n *\n * Collects database dialect, version, and connection info.\n *\n * Subclasses implement the database-specific hook:\n * - `collectInfo()` - collect database info\n */\nexport abstract class InfoGrounding extends AbstractGrounding {\n  constructor(config: InfoGroundingConfig = {}) {\n    super('dialectInfo', 'info');\n  }\n\n  /**\n   * Collect database dialect, version, and other info.\n   */\n  protected abstract collectInfo(): Promise<AdapterInfo>;\n\n  /**\n   * Execute the grounding process.\n   * Writes database info to ctx.info.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    ctx.info = await this.collectInfo();\n  }\n}\n", "import type { Table } from '../adapter.ts';\nimport { AbstractGrounding } from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for RowCountGrounding.\n */\nexport interface RowCountGroundingConfig {\n  // Future: filter which tables to count\n}\n\n/**\n * Abstract base class for row count grounding.\n *\n * Reads tables from the context and annotates them with row counts and size hints.\n * This grounding must run AFTER TableGrounding since it reads from ctx.tables.\n *\n * Subclasses implement the database-specific hook:\n * - `getRowCount()` - get row count for a table\n */\nexport abstract class RowCountGrounding extends AbstractGrounding {\n  constructor(config: RowCountGroundingConfig = {}) {\n    super('rowCount', 'row_counts');\n  }\n\n  /**\n   * Get row count for a specific table.\n   */\n  protected abstract getRowCount(\n    tableName: string,\n  ): Promise<number | undefined>;\n\n  /**\n   * Execute the grounding process.\n   * Annotates tables in ctx.tables with row counts and size hints.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const total = ctx.tables.length;\n    for (let i = 0; i < ctx.tables.length; i++) {\n      const table = ctx.tables[i];\n      ctx.onProgress({\n        type: 'phase:progress',\n        phase: 'row_counts',\n        table: table.name,\n        message: `Counting rows in ${table.name}...`,\n        current: i + 1,\n        total,\n      });\n      const count = await this.getRowCount(table.name);\n      if (count != null) {\n        table.rowCount = count;\n        table.sizeHint = this.#classifyRowCount(count);\n      }\n    }\n  }\n\n  /**\n   * Classify row count into a size hint category.\n   */\n  #classifyRowCount(count: number): Table['sizeHint'] {\n    if (count < 100) return 'tiny';\n    if (count < 1000) return 'small';\n    if (count < 10000) return 'medium';\n    if (count < 100000) return 'large';\n    return 'huge';\n  }\n}\n", "import type { Filter, Relationship, Table } from '../adapter.ts';\nimport {\n  AbstractGrounding,\n  type ColumnsFilter,\n  applyColumnFilter,\n  filterColumns,\n} from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Configuration for TableGrounding.\n */\nexport interface TableGroundingConfig {\n  /** Filter to select seed tables */\n  filter?: Filter;\n  /**\n   * Per-table column filter.\n   * Maps table name to a Filter that selects which columns to keep.\n   * Tables not listed keep all their columns.\n   */\n  columns?: ColumnsFilter;\n  /**\n   * Traverse forward (child\u2192parent) following FK direction.\n   * - true: unlimited depth\n   * - number: maximum depth\n   * - false/undefined: no forward traversal\n   */\n  forward?: boolean | number;\n  /**\n   * Traverse backward (parent\u2192child) finding tables that reference us.\n   * - true: unlimited depth\n   * - number: maximum depth\n   * - false/undefined: no backward traversal\n   */\n  backward?: boolean | number;\n}\n\n/**\n * Abstract base class for table grounding.\n *\n * The `execute()` method implements a BFS traversal algorithm that discovers\n * tables and relationships. Subclasses implement the database-specific hooks:\n * - `getAllTableNames()` - list all tables\n * - `getTable()` - get table metadata\n * - `findOutgoingRelations()` - find FKs FROM a table\n * - `findIncomingRelations()` - find FKs TO a table\n */\nexport abstract class TableGrounding extends AbstractGrounding {\n  #filter?: Filter;\n  #columns?: ColumnsFilter;\n  #forward?: boolean | number;\n  #backward?: boolean | number;\n\n  constructor(config: TableGroundingConfig = {}) {\n    super('table', 'tables');\n    this.#filter = config.filter;\n    this.#columns = config.columns;\n    this.#forward = config.forward;\n    this.#backward = config.backward;\n  }\n\n  /** Get all table names in the database */\n  protected abstract getAllTableNames(): Promise<string[]>;\n\n  /** Get full table metadata for a single table */\n  protected abstract getTable(tableName: string): Promise<Table>;\n\n  /** Find FKs FROM this table (outgoing relationships) */\n  protected abstract findOutgoingRelations(\n    tableName: string,\n  ): Promise<Relationship[]>;\n\n  /** Find FKs TO this table (incoming relationships) */\n  protected abstract findIncomingRelations(\n    tableName: string,\n  ): Promise<Relationship[]>;\n\n  /**\n   * Execute the grounding process.\n   * Writes discovered tables and relationships to the context.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const seedTables = await this.applyFilter();\n    const forward = this.#forward;\n    const backward = this.#backward;\n\n    // No traversal at all - just add the seed tables\n    if (!forward && !backward) {\n      const tables = await Promise.all(\n        seedTables.map(async (name, index) => {\n          ctx.onProgress({\n            type: 'phase:progress',\n            phase: 'tables',\n            table: name,\n            message: `Loading table ${name}...`,\n            current: index + 1,\n            total: seedTables.length,\n          });\n          return applyColumnFilter(await this.getTable(name), this.#columns);\n        }),\n      );\n      ctx.tables.push(...tables);\n      return;\n    }\n\n    const tables: Record<string, Table> = {};\n    const allRelationships: Relationship[] = [];\n    const seenRelationships = new Set<string>();\n\n    // Track depth separately for forward/backward using BFS\n    const forwardQueue: Array<{ name: string; depth: number }> = [];\n    const backwardQueue: Array<{ name: string; depth: number }> = [];\n    const forwardVisited = new Set<string>();\n    const backwardVisited = new Set<string>();\n    let loadedCount = 0;\n\n    // Initialize queues with seed tables at depth 0\n    for (const name of seedTables) {\n      if (forward) forwardQueue.push({ name, depth: 0 });\n      if (backward) backwardQueue.push({ name, depth: 0 });\n    }\n\n    // Process forward (child\u2192parent)\n    const forwardLimit = forward === true ? Infinity : forward || 0;\n    while (forwardQueue.length > 0) {\n      const item = forwardQueue.shift();\n      if (!item) break;\n      const { name, depth } = item;\n\n      if (forwardVisited.has(name)) continue;\n      forwardVisited.add(name);\n\n      if (!tables[name]) {\n        loadedCount++;\n        ctx.onProgress({\n          type: 'phase:progress',\n          phase: 'tables',\n          table: name,\n          message: `Loading table ${name}...`,\n          current: loadedCount,\n        });\n        tables[name] = applyColumnFilter(\n          await this.getTable(name),\n          this.#columns,\n        );\n      }\n\n      if (depth < forwardLimit) {\n        const rels = await this.findOutgoingRelations(name);\n        for (const rel of rels) {\n          if (!this.isRelationshipVisible(rel)) continue;\n          this.addRelationship(rel, allRelationships, seenRelationships);\n          if (!forwardVisited.has(rel.referenced_table)) {\n            forwardQueue.push({ name: rel.referenced_table, depth: depth + 1 });\n          }\n        }\n      }\n    }\n\n    // Process backward (parent\u2192child)\n    const backwardLimit = backward === true ? Infinity : backward || 0;\n    while (backwardQueue.length > 0) {\n      const item = backwardQueue.shift();\n      if (!item) break;\n      const { name, depth } = item;\n\n      if (backwardVisited.has(name)) continue;\n      backwardVisited.add(name);\n\n      if (!tables[name]) {\n        loadedCount++;\n        ctx.onProgress({\n          type: 'phase:progress',\n          phase: 'tables',\n          table: name,\n          message: `Loading table ${name}...`,\n          current: loadedCount,\n        });\n        tables[name] = applyColumnFilter(\n          await this.getTable(name),\n          this.#columns,\n        );\n      }\n\n      if (depth < backwardLimit) {\n        const rels = await this.findIncomingRelations(name);\n        for (const rel of rels) {\n          if (!this.isRelationshipVisible(rel)) continue;\n          this.addRelationship(rel, allRelationships, seenRelationships);\n          if (!backwardVisited.has(rel.table)) {\n            backwardQueue.push({ name: rel.table, depth: depth + 1 });\n          }\n        }\n      }\n    }\n\n    // Write to context\n    const tablesList = Object.values(tables);\n    ctx.tables.push(...tablesList);\n    ctx.relationships.push(...allRelationships);\n  }\n\n  /**\n   * Apply the filter to get seed table names.\n   * If filter is an explicit array, skip querying all table names.\n   */\n  protected async applyFilter(): Promise<string[]> {\n    const filter = this.#filter;\n    if (Array.isArray(filter)) {\n      return filter;\n    }\n    const names = await this.getAllTableNames();\n    if (!filter) {\n      return names;\n    }\n    if (filter instanceof RegExp) {\n      return names.filter((name) => filter.test(name));\n    }\n    return names.filter(filter);\n  }\n\n  /**\n   * Add a relationship to the collection, deduplicating by key.\n   */\n  protected addRelationship(\n    rel: Relationship,\n    all: Relationship[],\n    seen: Set<string>,\n  ): void {\n    const key = `${rel.table}:${rel.from.join(',')}:${rel.referenced_table}:${rel.to.join(',')}`;\n    if (!seen.has(key)) {\n      seen.add(key);\n      all.push(rel);\n    }\n  }\n\n  protected isRelationshipVisible(rel: Relationship): boolean {\n    return (\n      this.areColumnsVisible(rel.from, this.#columns?.[rel.table]) &&\n      this.areColumnsVisible(rel.to, this.#columns?.[rel.referenced_table])\n    );\n  }\n\n  protected areColumnsVisible(names: string[], filter?: Filter): boolean {\n    if (!filter) return true;\n    return (\n      filterColumns(\n        names.map((name) => ({ name })),\n        filter,\n      ).length === names.length\n    );\n  }\n}\n", "import type { ColumnStats, Filter } from '../adapter.ts';\nimport {\n  AbstractGrounding,\n  type ColumnsFilter,\n  applyColumnFilter,\n} from './abstract.grounding.ts';\nimport type { GroundingContext } from './context.ts';\n\n/**\n * Represents a database view with its metadata.\n */\nexport interface View {\n  name: string;\n  schema?: string;\n  rawName?: string;\n  /** The SQL definition of the view (CREATE VIEW statement or query) */\n  definition?: string;\n  columns: {\n    name: string;\n    type: string;\n    /** Low cardinality marker */\n    kind?: 'LowCardinality';\n    /** Distinct values for low cardinality columns */\n    values?: string[];\n    /** Column statistics (min, max, nullFraction) */\n    stats?: ColumnStats;\n  }[];\n}\n\n/**\n * Configuration for ViewGrounding.\n */\nexport interface ViewGroundingConfig {\n  /** Filter to select views */\n  filter?: Filter;\n  /**\n   * Per-view column filter.\n   * Maps view name to a Filter that selects which columns to keep.\n   * Views not listed keep all their columns.\n   */\n  columns?: ColumnsFilter;\n  /** Whether to fetch the SQL definition of each view (default: true) */\n  includeDefinition?: boolean;\n}\n\n/**\n * Abstract base class for view grounding\n *\n * The `execute()` method implements the algorithm that discovers views.\n * Subclasses implement the database-specific hooks:\n * - `getAllViewNames()` - list all views\n * - `getView()` - get view metadata\n */\nexport abstract class ViewGrounding extends AbstractGrounding {\n  #filter?: Filter;\n  #columns?: ColumnsFilter;\n  protected includeDefinition: boolean;\n\n  constructor(config: ViewGroundingConfig = {}) {\n    super('view', 'views');\n    this.#filter = config.filter;\n    this.#columns = config.columns;\n    this.includeDefinition = config.includeDefinition ?? true;\n  }\n\n  /** Get all view names in the database */\n  protected abstract getAllViewNames(): Promise<string[]>;\n\n  /** Get full view metadata for a single view */\n  protected abstract getView(viewName: string): Promise<View>;\n\n  /**\n   * Execute the grounding process.\n   * Writes discovered views to the context.\n   */\n  async execute(ctx: GroundingContext): Promise<void> {\n    const viewNames = await this.applyFilter();\n    const views = await Promise.all(\n      viewNames.map(async (name, index) => {\n        ctx.onProgress({\n          type: 'phase:progress',\n          phase: 'views',\n          table: name,\n          message: `Loading view ${name}...`,\n          current: index + 1,\n          total: viewNames.length,\n        });\n        return applyColumnFilter(await this.getView(name), this.#columns);\n      }),\n    );\n    ctx.views.push(...views);\n  }\n\n  /**\n   * Apply the filter to get view names.\n   * If filter is an explicit array, skip querying all view names.\n   */\n  protected async applyFilter(): Promise<string[]> {\n    const filter = this.#filter;\n    if (Array.isArray(filter)) {\n      return filter;\n    }\n    const names = await this.getAllViewNames();\n    if (!filter) {\n      return names;\n    }\n    if (filter instanceof RegExp) {\n      return names.filter((name) => filter.test(name));\n    }\n    return names.filter(filter);\n  }\n}\n"],
+  "mappings": ";AAwBO,SAAS,cACd,SACA,QACK;AACL,MAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,WAAO,QAAQ,OAAO,CAAC,QAAQ,OAAO,SAAS,IAAI,IAAI,CAAC;AAAA,EAC1D;AACA,MAAI,kBAAkB,QAAQ;AAC5B,WAAO,QAAQ,OAAO,CAAC,QAAQ,OAAO,KAAK,IAAI,IAAI,CAAC;AAAA,EACtD;AACA,SAAO,QAAQ,OAAO,CAAC,QAAQ,OAAO,IAAI,IAAI,CAAC;AACjD;AAMO,SAAS,kBAEd,QAAW,eAAkC;AAC7C,MAAI,CAAC,cAAe,QAAO;AAC3B,QAAM,SAAS,cAAc,OAAO,IAAI;AACxC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,EAAE,GAAG,QAAQ,SAAS,cAAc,OAAO,SAAS,MAAM,EAAE;AACrE;AAkBO,IAAe,oBAAf,MAAiC;AAAA;AAAA;AAAA;AAAA,EAItC;AAAA,EACA;AAAA,EAEA,YAAY,MAAc,OAA4B;AACpD,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AAUF;;;AClEO,IAAe,uBAAf,cAA4C,kBAAkB;AAAA,EACnE,YAAY,SAAqC,CAAC,GAAG;AACnD,UAAM,eAAe,cAAc;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,QAAQ,KAAsC;AAElD,UAAM,gBAAmC,CAAC,GAAG,IAAI,QAAQ,GAAG,IAAI,KAAK;AACrE,UAAM,QAAQ,cAAc;AAC5B,aAAS,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK;AAC7C,YAAM,YAAY,cAAc,CAAC;AACjC,UAAI,WAAW;AAAA,QACb,MAAM;AAAA,QACN,OAAO;AAAA,QACP,OAAO,UAAU;AAAA,QACjB,SAAS,wBAAwB,UAAU,IAAI;AAAA,QAC/C,SAAS,IAAI;AAAA,QACb;AAAA,MACF,CAAC;AACD,iBAAW,UAAU,UAAU,SAAS;AAEtC,YAAI;AACF,gBAAM,QAAQ,MAAM,KAAK,aAAa,UAAU,MAAM,MAAM;AAC5D,cAAI,OAAO;AACT,mBAAO,QAAQ;AAAA,UACjB;AAAA,QACF,SAAS,OAAO;AAEd,kBAAQ;AAAA,YACN;AAAA,YACA,UAAU;AAAA,YACV,OAAO;AAAA,YACP;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;;;ACnCO,IAAe,wBAAf,cAA6C,kBAAkB;AAAA,EAC1D;AAAA,EACA;AAAA,EAEV,YAAY,SAAsC,CAAC,GAAG;AACpD,UAAM,gBAAgB,eAAe;AACrC,SAAK,sBAAsB,OAAO,uBAAuB;AACzD,SAAK,iBAAiB,OAAO,kBAAkB;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAgB,kBACd,YACA,SAC+B;AAC/B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBU,qBACR,YACA,YACsB;AACtB,QAAI,WAAW,SAAS,WAAW,CAAC,WAAW,YAAY;AACzD,aAAO;AAAA,IACT;AAGA,QAAI,WAAW,WAAW,CAAC,WAAW,QAAQ,SAAS,UAAU,GAAG;AAClE,aAAO;AAAA,IACT;AAEA,UAAM,MAAM,WAAW;AACvB,UAAM,aAAa,KAAK,YAAY,UAAU;AAI9C,UAAM,aAAa,cAAc,UAAU;AAG3C,UAAM,UAAU,IAAI;AAAA,MAClB,IAAI,OAAO,GAAG,UAAU,2BAA2B,GAAG;AAAA,IACxD;AACA,QAAI,SAAS;AACX,aAAO,KAAK,oBAAoB,QAAQ,CAAC,CAAC;AAAA,IAC5C;AAGA,UAAM,WAAW,IAAI;AAAA,MACnB,IAAI;AAAA,QACF,GAAG,UAAU;AAAA,QACb;AAAA,MACF;AAAA,IACF;AACA,QAAI,UAAU;AACZ,aAAO,KAAK,oBAAoB,SAAS,CAAC,CAAC;AAAA,IAC7C;AAGA,UAAM,YAAY,IAAI;AAAA,MACpB,MAAM,KAAK,YAAY,UAAU,CAAC;AAAA,MAClC;AAAA,IACF;AACA,UAAM,YAAY,CAAC,GAAG,IAAI,SAAS,SAAS,CAAC;AAC7C,QAAI,UAAU,UAAU,GAAG;AACzB,aAAO,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAAA,IAClC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAoB,OAAqC;AAC/D,UAAM,SAAmB,CAAC;AAE1B,UAAM,UAAU,MAAM,SAAS,YAAY;AAC3C,eAAW,SAAS,SAAS;AAC3B,aAAO,KAAK,MAAM,CAAC,CAAC;AAAA,IACtB;AACA,WAAO,OAAO,SAAS,IAAI,SAAS;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKQ,YAAY,KAAqB;AACvC,WAAO,IAAI,QAAQ,uBAAuB,MAAM;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKQ,SAAS,KAAuB,MAAiC;AACvE,WAAO,IAAI,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAQ,KAAsC;AAElD,UAAM,gBAAmC,CAAC,GAAG,IAAI,QAAQ,GAAG,IAAI,KAAK;AAErE,UAAM,QAAQ,cAAc;AAC5B,aAAS,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK;AAC7C,YAAM,YAAY,cAAc,CAAC;AACjC,UAAI,WAAW;AAAA,QACb,MAAM;AAAA,QACN,OAAO;AAAA,QACP,OAAO,UAAU;AAAA,QACjB,SAAS,gCAAgC,UAAU,IAAI;AAAA,QACvD,SAAS,IAAI;AAAA,QACb;AAAA,MACF,CAAC;AACD,YAAM,QAAQ,KAAK,SAAS,KAAK,UAAU,IAAI;AAE/C,iBAAW,UAAU,UAAU,SAAS;AACtC,YAAI;AACF,gBAAM,SAAS,MAAM,KAAK;AAAA,YACxB,UAAU;AAAA,YACV;AAAA,YACA,OAAO;AAAA,UACT;AACA,cAAI,QAAQ;AACV,mBAAO,OAAO,OAAO;AACrB,mBAAO,SAAS,OAAO;AAAA,UACzB;AAAA,QACF,SAAS,OAAO;AACd,kBAAQ;AAAA,YACN;AAAA,YACA,UAAU;AAAA,YACV,OAAO;AAAA,YACP;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,sBAAsB,QAA2B;AACvD,WAAO,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,cAAc;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,oBACZ,WACA,QACA,aACyC;AAEzC,UAAM,aAAa,MAAM,KAAK,kBAAkB,WAAW,MAAM;AACjE,QAAI,YAAY,UAAU,CAAC,KAAK,sBAAsB,UAAU,GAAG;AACjE,aAAO,EAAE,MAAM,QAAQ,QAAQ,WAAW;AAAA,IAC5C;AAGA,QAAI,aAAa;AACf,iBAAW,cAAc,aAAa;AACpC,cAAM,cAAc,KAAK,qBAAqB,YAAY,OAAO,IAAI;AACrE,YAAI,aAAa,UAAU,CAAC,KAAK,sBAAsB,WAAW,GAAG;AACnE,iBAAO,EAAE,MAAM,QAAQ,QAAQ,YAAY;AAAA,QAC7C;AAAA,MACF;AAAA,IACF;AAGA,UAAM,gBAAgB,MAAM,KAAK,sBAAsB,WAAW,MAAM;AACxE,QAAI,eAAe,UAAU,CAAC,KAAK,sBAAsB,aAAa,GAAG;AACvE,aAAO,EAAE,MAAM,kBAAkB,QAAQ,cAAc;AAAA,IACzD;AAEA,WAAO;AAAA,EACT;AACF;;;ACpNO,IAAe,sBAAf,cAA2C,kBAAkB;AAAA,EAClE,YAAY,SAAoC,CAAC,GAAG;AAClD,UAAM,cAAc,aAAa;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,QAAQ,KAAsC;AAClD,UAAM,QAAQ,IAAI,OAAO;AACzB,aAAS,IAAI,GAAG,IAAI,IAAI,OAAO,QAAQ,KAAK;AAC1C,YAAM,QAAQ,IAAI,OAAO,CAAC;AAC1B,UAAI,WAAW;AAAA,QACb,MAAM;AAAA,QACN,OAAO;AAAA,QACP,OAAO,MAAM;AAAA,QACb,SAAS,2BAA2B,MAAM,IAAI;AAAA,QAC9C,SAAS,IAAI;AAAA,QACb;AAAA,MACF,CAAC;AACD,UAAI;AACF,cAAM,cAAc,MAAM,KAAK,eAAe,MAAM,IAAI;AAAA,MAC1D,SAAS,OAAO;AAEd,gBAAQ,KAAK,oCAAoC,MAAM,MAAM,KAAK;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AACF;;;ACJA,IAAM,eAA2B,MAAM;AAAC;AAExC,SAAS,kBAAkB,YAAqC;AAC9D,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,CAAC,aAAa;AACnB,eAAW;AAAA,MACT,GAAG;AAAA,MACH,aAAa,SAAS,eAAe,KAAK,IAAI;AAAA,IAChD,CAAC;AAAA,EACH;AACF;AAKO,SAAS,uBACd,UAAuC,CAAC,GACtB;AAClB,SAAO;AAAA,IACL,QAAQ,CAAC;AAAA,IACT,OAAO,CAAC;AAAA,IACR,eAAe,CAAC;AAAA,IAChB,MAAM;AAAA,IACN,OAAO,oBAAI,IAAI;AAAA,IACf,YAAY,kBAAkB,QAAQ,UAAU;AAAA,EAClD;AACF;;;AC5DO,IAAe,gBAAf,cAAqC,kBAAkB;AAAA,EAC5D,YAAY,SAA8B,CAAC,GAAG;AAC5C,UAAM,eAAe,MAAM;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,QAAQ,KAAsC;AAClD,QAAI,OAAO,MAAM,KAAK,YAAY;AAAA,EACpC;AACF;;;AChBO,IAAe,oBAAf,cAAyC,kBAAkB;AAAA,EAChE,YAAY,SAAkC,CAAC,GAAG;AAChD,UAAM,YAAY,YAAY;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,QAAQ,KAAsC;AAClD,UAAM,QAAQ,IAAI,OAAO;AACzB,aAAS,IAAI,GAAG,IAAI,IAAI,OAAO,QAAQ,KAAK;AAC1C,YAAM,QAAQ,IAAI,OAAO,CAAC;AAC1B,UAAI,WAAW;AAAA,QACb,MAAM;AAAA,QACN,OAAO;AAAA,QACP,OAAO,MAAM;AAAA,QACb,SAAS,oBAAoB,MAAM,IAAI;AAAA,QACvC,SAAS,IAAI;AAAA,QACb;AAAA,MACF,CAAC;AACD,YAAM,QAAQ,MAAM,KAAK,YAAY,MAAM,IAAI;AAC/C,UAAI,SAAS,MAAM;AACjB,cAAM,WAAW;AACjB,cAAM,WAAW,KAAK,kBAAkB,KAAK;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAkB,OAAkC;AAClD,QAAI,QAAQ,IAAK,QAAO;AACxB,QAAI,QAAQ,IAAM,QAAO;AACzB,QAAI,QAAQ,IAAO,QAAO;AAC1B,QAAI,QAAQ,IAAQ,QAAO;AAC3B,WAAO;AAAA,EACT;AACF;;;ACnBO,IAAe,iBAAf,cAAsC,kBAAkB;AAAA,EAC7D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAA+B,CAAC,GAAG;AAC7C,UAAM,SAAS,QAAQ;AACvB,SAAK,UAAU,OAAO;AACtB,SAAK,WAAW,OAAO;AACvB,SAAK,WAAW,OAAO;AACvB,SAAK,YAAY,OAAO;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,MAAM,QAAQ,KAAsC;AAClD,UAAM,aAAa,MAAM,KAAK,YAAY;AAC1C,UAAM,UAAU,KAAK;AACrB,UAAM,WAAW,KAAK;AAGtB,QAAI,CAAC,WAAW,CAAC,UAAU;AACzB,YAAMA,UAAS,MAAM,QAAQ;AAAA,QAC3B,WAAW,IAAI,OAAO,MAAM,UAAU;AACpC,cAAI,WAAW;AAAA,YACb,MAAM;AAAA,YACN,OAAO;AAAA,YACP,OAAO;AAAA,YACP,SAAS,iBAAiB,IAAI;AAAA,YAC9B,SAAS,QAAQ;AAAA,YACjB,OAAO,WAAW;AAAA,UACpB,CAAC;AACD,iBAAO,kBAAkB,MAAM,KAAK,SAAS,IAAI,GAAG,KAAK,QAAQ;AAAA,QACnE,CAAC;AAAA,MACH;AACA,UAAI,OAAO,KAAK,GAAGA,OAAM;AACzB;AAAA,IACF;AAEA,UAAM,SAAgC,CAAC;AACvC,UAAM,mBAAmC,CAAC;AAC1C,UAAM,oBAAoB,oBAAI,IAAY;AAG1C,UAAM,eAAuD,CAAC;AAC9D,UAAM,gBAAwD,CAAC;AAC/D,UAAM,iBAAiB,oBAAI,IAAY;AACvC,UAAM,kBAAkB,oBAAI,IAAY;AACxC,QAAI,cAAc;AAGlB,eAAW,QAAQ,YAAY;AAC7B,UAAI,QAAS,cAAa,KAAK,EAAE,MAAM,OAAO,EAAE,CAAC;AACjD,UAAI,SAAU,eAAc,KAAK,EAAE,MAAM,OAAO,EAAE,CAAC;AAAA,IACrD;AAGA,UAAM,eAAe,YAAY,OAAO,WAAW,WAAW;AAC9D,WAAO,aAAa,SAAS,GAAG;AAC9B,YAAM,OAAO,aAAa,MAAM;AAChC,UAAI,CAAC,KAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI;AAExB,UAAI,eAAe,IAAI,IAAI,EAAG;AAC9B,qBAAe,IAAI,IAAI;AAEvB,UAAI,CAAC,OAAO,IAAI,GAAG;AACjB;AACA,YAAI,WAAW;AAAA,UACb,MAAM;AAAA,UACN,OAAO;AAAA,UACP,OAAO;AAAA,UACP,SAAS,iBAAiB,IAAI;AAAA,UAC9B,SAAS;AAAA,QACX,CAAC;AACD,eAAO,IAAI,IAAI;AAAA,UACb,MAAM,KAAK,SAAS,IAAI;AAAA,UACxB,KAAK;AAAA,QACP;AAAA,MACF;AAEA,UAAI,QAAQ,cAAc;AACxB,cAAM,OAAO,MAAM,KAAK,sBAAsB,IAAI;AAClD,mBAAW,OAAO,MAAM;AACtB,cAAI,CAAC,KAAK,sBAAsB,GAAG,EAAG;AACtC,eAAK,gBAAgB,KAAK,kBAAkB,iBAAiB;AAC7D,cAAI,CAAC,eAAe,IAAI,IAAI,gBAAgB,GAAG;AAC7C,yBAAa,KAAK,EAAE,MAAM,IAAI,kBAAkB,OAAO,QAAQ,EAAE,CAAC;AAAA,UACpE;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,gBAAgB,aAAa,OAAO,WAAW,YAAY;AACjE,WAAO,cAAc,SAAS,GAAG;AAC/B,YAAM,OAAO,cAAc,MAAM;AACjC,UAAI,CAAC,KAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI;AAExB,UAAI,gBAAgB,IAAI,IAAI,EAAG;AAC/B,sBAAgB,IAAI,IAAI;AAExB,UAAI,CAAC,OAAO,IAAI,GAAG;AACjB;AACA,YAAI,WAAW;AAAA,UACb,MAAM;AAAA,UACN,OAAO;AAAA,UACP,OAAO;AAAA,UACP,SAAS,iBAAiB,IAAI;AAAA,UAC9B,SAAS;AAAA,QACX,CAAC;AACD,eAAO,IAAI,IAAI;AAAA,UACb,MAAM,KAAK,SAAS,IAAI;AAAA,UACxB,KAAK;AAAA,QACP;AAAA,MACF;AAEA,UAAI,QAAQ,eAAe;AACzB,cAAM,OAAO,MAAM,KAAK,sBAAsB,IAAI;AAClD,mBAAW,OAAO,MAAM;AACtB,cAAI,CAAC,KAAK,sBAAsB,GAAG,EAAG;AACtC,eAAK,gBAAgB,KAAK,kBAAkB,iBAAiB;AAC7D,cAAI,CAAC,gBAAgB,IAAI,IAAI,KAAK,GAAG;AACnC,0BAAc,KAAK,EAAE,MAAM,IAAI,OAAO,OAAO,QAAQ,EAAE,CAAC;AAAA,UAC1D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,aAAa,OAAO,OAAO,MAAM;AACvC,QAAI,OAAO,KAAK,GAAG,UAAU;AAC7B,QAAI,cAAc,KAAK,GAAG,gBAAgB;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,cAAiC;AAC/C,UAAM,SAAS,KAAK;AACpB,QAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,aAAO;AAAA,IACT;AACA,UAAM,QAAQ,MAAM,KAAK,iBAAiB;AAC1C,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,QAAI,kBAAkB,QAAQ;AAC5B,aAAO,MAAM,OAAO,CAAC,SAAS,OAAO,KAAK,IAAI,CAAC;AAAA,IACjD;AACA,WAAO,MAAM,OAAO,MAAM;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKU,gBACR,KACA,KACA,MACM;AACN,UAAM,MAAM,GAAG,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,gBAAgB,IAAI,IAAI,GAAG,KAAK,GAAG,CAAC;AAC1F,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAClB,WAAK,IAAI,GAAG;AACZ,UAAI,KAAK,GAAG;AAAA,IACd;AAAA,EACF;AAAA,EAEU,sBAAsB,KAA4B;AAC1D,WACE,KAAK,kBAAkB,IAAI,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,KAC3D,KAAK,kBAAkB,IAAI,IAAI,KAAK,WAAW,IAAI,gBAAgB,CAAC;AAAA,EAExE;AAAA,EAEU,kBAAkB,OAAiB,QAA0B;AACrE,QAAI,CAAC,OAAQ,QAAO;AACpB,WACE;AAAA,MACE,MAAM,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE;AAAA,MAC9B;AAAA,IACF,EAAE,WAAW,MAAM;AAAA,EAEvB;AACF;;;ACvMO,IAAe,gBAAf,cAAqC,kBAAkB;AAAA,EAC5D;AAAA,EACA;AAAA,EACU;AAAA,EAEV,YAAY,SAA8B,CAAC,GAAG;AAC5C,UAAM,QAAQ,OAAO;AACrB,SAAK,UAAU,OAAO;AACtB,SAAK,WAAW,OAAO;AACvB,SAAK,oBAAoB,OAAO,qBAAqB;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,QAAQ,KAAsC;AAClD,UAAM,YAAY,MAAM,KAAK,YAAY;AACzC,UAAM,QAAQ,MAAM,QAAQ;AAAA,MAC1B,UAAU,IAAI,OAAO,MAAM,UAAU;AACnC,YAAI,WAAW;AAAA,UACb,MAAM;AAAA,UACN,OAAO;AAAA,UACP,OAAO;AAAA,UACP,SAAS,gBAAgB,IAAI;AAAA,UAC7B,SAAS,QAAQ;AAAA,UACjB,OAAO,UAAU;AAAA,QACnB,CAAC;AACD,eAAO,kBAAkB,MAAM,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ;AAAA,MAClE,CAAC;AAAA,IACH;AACA,QAAI,MAAM,KAAK,GAAG,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,cAAiC;AAC/C,UAAM,SAAS,KAAK;AACpB,QAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,aAAO;AAAA,IACT;AACA,UAAM,QAAQ,MAAM,KAAK,gBAAgB;AACzC,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,QAAI,kBAAkB,QAAQ;AAC5B,aAAO,MAAM,OAAO,CAAC,SAAS,OAAO,KAAK,IAAI,CAAC;AAAA,IACjD;AACA,WAAO,MAAM,OAAO,MAAM;AAAA,EAC5B;AACF;",
   "names": ["tables"]
 }

package/dist/lib/adapters/mysql/index.js

@@ -148,6 +148,17 @@ function relationship(input) {
 }
 
 // packages/text2sql/src/lib/adapters/groundings/context.ts
+var noopProgress = () => {
+};
+function timestampProgress(onProgress) {
+  if (!onProgress) return noopProgress;
+  return (progress) => {
+    onProgress({
+      ...progress,
+      timestampMs: progress.timestampMs ?? Date.now()
+    });
+  };
+}
 function createGroundingContext(options = {}) {
   return {
     tables: [],
@@ -155,7 +166,7 @@ function createGroundingContext(options = {}) {
     relationships: [],
     info: void 0,
     cache: /* @__PURE__ */ new Map(),
-    onProgress: options.onProgress
+    onProgress: timestampProgress(options.onProgress)
   };
 }
 
@@ -302,7 +313,7 @@ var Adapter = class {
     for (const fn of this.grounding) {
       const grounding = fn(this);
       if (grounding.phase) {
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:start",
           phase: grounding.phase,
           message: `Starting ${grounding.name} introspection...`
@@ -312,7 +323,7 @@ var Adapter = class {
         await grounding.execute(ctx);
       } finally {
         if (grounding.phase) {
-          ctx.onProgress?.({
+          ctx.onProgress({
             type: "phase:end",
             phase: grounding.phase,
             message: `Finished ${grounding.name} introspection.`
@@ -694,7 +705,7 @@ var ColumnStatsGrounding = class extends AbstractGrounding {
     const total = allContainers.length;
     for (let i = 0; i < allContainers.length; i++) {
       const container = allContainers[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "column_stats",
         table: container.name,
@@ -812,7 +823,7 @@ var ColumnValuesGrounding = class extends AbstractGrounding {
     const total = allContainers.length;
     for (let i = 0; i < allContainers.length; i++) {
       const container = allContainers[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "column_values",
         table: container.name,
@@ -883,7 +894,7 @@ var ConstraintGrounding = class extends AbstractGrounding {
     const total = ctx.tables.length;
     for (let i = 0; i < ctx.tables.length; i++) {
       const table2 = ctx.tables[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "constraints",
         table: table2.name,
@@ -913,7 +924,7 @@ var IndexesGrounding = class extends AbstractGrounding {
     const total = ctx.tables.length;
     for (let i = 0; i < ctx.tables.length; i++) {
       const table2 = ctx.tables[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "indexes",
         table: table2.name,
@@ -961,7 +972,7 @@ var RowCountGrounding = class extends AbstractGrounding {
     const total = ctx.tables.length;
     for (let i = 0; i < ctx.tables.length; i++) {
       const table2 = ctx.tables[i];
-      ctx.onProgress?.({
+      ctx.onProgress({
         type: "phase:progress",
         phase: "row_counts",
         table: table2.name,
@@ -1012,7 +1023,7 @@ var TableGrounding = class extends AbstractGrounding {
     if (!forward && !backward) {
       const tables3 = await Promise.all(
         seedTables.map(async (name, index2) => {
-          ctx.onProgress?.({
+          ctx.onProgress({
             type: "phase:progress",
             phase: "tables",
             table: name,
@@ -1047,7 +1058,7 @@ var TableGrounding = class extends AbstractGrounding {
       forwardVisited.add(name);
       if (!tables2[name]) {
         loadedCount++;
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:progress",
           phase: "tables",
           table: name,
@@ -1079,7 +1090,7 @@ var TableGrounding = class extends AbstractGrounding {
       backwardVisited.add(name);
       if (!tables2[name]) {
         loadedCount++;
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:progress",
           phase: "tables",
           table: name,
@@ -1837,7 +1848,7 @@ var ViewGrounding = class extends AbstractGrounding {
     const viewNames = await this.applyFilter();
     const views2 = await Promise.all(
       viewNames.map(async (name, index2) => {
-        ctx.onProgress?.({
+        ctx.onProgress({
           type: "phase:progress",
           phase: "views",
           table: name,