@deepagents/text2sql 0.2.2 → 0.3.0

package/dist/lib/adapters/adapter.d.ts

@@ -1,3 +1,11 @@
+import type { AbstractGrounding } from './grounding.ticket.ts';
+/**
+ * Filter type for view/table names.
+ * - string[]: explicit list of view names
+ * - RegExp: pattern to match view names
+ * - function: predicate to filter view names
+ */
+export type Filter = string[] | RegExp | ((viewName: string) => boolean);
 export interface Table {
     name: string;
     schema?: string;
@@ -7,21 +15,29 @@ export interface Table {
         type: string;
         kind?: 'LowCardinality';
         values?: string[];
-        isPrimaryKey?: boolean;
         isIndexed?: boolean;
         stats?: ColumnStats;
     }[];
     rowCount?: number;
     sizeHint?: 'tiny' | 'small' | 'medium' | 'large' | 'huge';
     indexes?: TableIndex[];
+    constraints?: TableConstraint[];
 }
 export interface TableIndex {
     name: string;
     columns: string[];
     unique?: boolean;
-    primary?: boolean;
     type?: string;
 }
+export interface TableConstraint {
+    name: string;
+    type: 'CHECK' | 'UNIQUE' | 'NOT_NULL' | 'DEFAULT' | 'PRIMARY_KEY' | 'FOREIGN_KEY';
+    columns?: string[];
+    definition?: string;
+    defaultValue?: string;
+    referencedTable?: string;
+    referencedColumns?: string[];
+}
 export interface ColumnStats {
     min?: string;
     max?: string;
@@ -42,9 +58,9 @@ export interface AdapterInfo {
     dialect: string;
     version?: string;
     database?: string;
-    host?: string;
     details?: Record<string, unknown>;
 }
+export type AdapterInfoProvider = AdapterInfo | (() => Promise<AdapterInfo> | AdapterInfo);
 export type IntrospectionPhase = 'tables' | 'row_counts' | 'primary_keys' | 'indexes' | 'column_stats' | 'low_cardinality' | 'relationships';
 export interface IntrospectionProgress {
     phase: IntrospectionPhase;
@@ -53,19 +69,60 @@ export interface IntrospectionProgress {
     total?: number;
 }
 export type OnProgress = (progress: IntrospectionProgress) => void;
-export type AdapterInfoProvider = AdapterInfo | (() => Promise<AdapterInfo> | AdapterInfo);
 export interface IntrospectOptions {
     onProgress?: OnProgress;
 }
+export type GroundingFn = (adapter: Adapter) => AbstractGrounding;
+export type ExecuteFunction = (sql: string) => Promise<any> | any;
+export type ValidateFunction = (sql: string) => Promise<string | void> | string | void;
 export declare abstract class Adapter {
-    abstract introspect(options?: IntrospectOptions): Promise<Introspection> | Introspection;
+    abstract grounding: GroundingFn[];
+    /**
+     * Default schema name for this database.
+     * PostgreSQL: 'public', SQL Server: 'dbo', SQLite: undefined
+     */
+    abstract readonly defaultSchema: string | undefined;
+    /**
+     * System schemas to exclude from introspection by default.
+     */
+    abstract readonly systemSchemas: string[];
+    introspect(): Promise<string>;
     abstract execute(sql: string): Promise<any[]> | any[];
     abstract validate(sql: string): Promise<string | void> | string | void;
-    abstract info(): Promise<AdapterInfo> | AdapterInfo;
-    abstract formatInfo(info: AdapterInfo): string;
-    abstract getTables(): Promise<Table[]> | Table[];
-    abstract getRelationships(): Promise<Relationship[]> | Relationship[];
-    resolveTables(filter: TablesFilter): Promise<string[]>;
+    abstract runQuery<Row>(sql: string): Promise<Row[]> | Row[];
+    /**
+     * Quote an identifier (table/column name) for safe use in SQL.
+     * Each database uses different quoting styles.
+     */
+    abstract quoteIdentifier(name: string): string;
+    /**
+     * Escape a string value for safe use in SQL.
+     * Each database escapes different characters.
+     */
+    abstract escape(value: string): string;
+    /**
+     * Convert unknown database value to number.
+     * Handles number, bigint, and string types.
+     */
+    toNumber(value: unknown): number | undefined;
+    /**
+     * Parse a potentially qualified table name into schema and table parts.
+     */
+    parseTableName(name: string): {
+        schema: string;
+        table: string;
+    };
+    /**
+     * Escape a string value for use in SQL string literals (single quotes).
+     * Used in WHERE clauses like: WHERE name = '${escapeString(value)}'
+     */
+    escapeString(value: string): string;
+    /**
+     * Build a SQL filter clause to include/exclude schemas.
+     * @param columnName - The schema column name (e.g., 'TABLE_SCHEMA')
+     * @param allowedSchemas - If provided, filter to these schemas only
+     */
+    buildSchemaFilter(columnName: string, allowedSchemas?: string[]): string;
 }
 export declare function filterTablesByName<T extends {
     name: string;

package/dist/lib/adapters/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/adapter.ts"],"names":[],"mappings":"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"}

package/dist/lib/adapters/grounding.ticket.d.ts

@@ -0,0 +1,21 @@
+import type { GroundingContext } from './groundings/context.ts';
+/**
+ * Filter type for table names.
+ * - string[]: explicit list of table names
+ * - RegExp: pattern to match table names
+ * - function: predicate to filter table names
+ */
+export type Filter = string[] | RegExp | ((tableName: string) => boolean);
+export interface AdapterInfo {
+    dialect: string;
+    version?: string;
+    database?: string;
+    details?: Record<string, unknown>;
+}
+export type AdapterInfoProvider = AdapterInfo | (() => Promise<AdapterInfo> | AdapterInfo);
+export declare abstract class AbstractGrounding {
+    tag: string;
+    constructor(tag: string);
+    abstract execute(ctx: GroundingContext): Promise<() => string | null>;
+}
+//# sourceMappingURL=grounding.ticket.d.ts.map

package/dist/lib/adapters/grounding.ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding.ticket.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/grounding.ticket.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AACD,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,CAAC;AAE/C,8BAAsB,iBAAiB;IACrC,GAAG,EAAE,MAAM,CAAC;gBACA,GAAG,EAAE,MAAM;IAIvB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;CACtE"}

package/dist/lib/adapters/groundings/column-stats.grounding.d.ts

@@ -0,0 +1,32 @@
+import type { ColumnStats } from '../adapter.ts';
+import { AbstractGrounding } from '../grounding.ticket.ts';
+import type { Column, GroundingContext } from './context.ts';
+/**
+ * Configuration for ColumnStatsGrounding.
+ */
+export interface ColumnStatsGroundingConfig {
+}
+/**
+ * Abstract base class for column statistics grounding.
+ *
+ * Reads tables and views from the context and annotates their columns
+ * with statistics (min, max, nullFraction).
+ *
+ * Subclasses implement database-specific hooks:
+ * - `collectStats()` - collect min/max/nullFraction for a column
+ */
+export declare abstract class ColumnStatsGrounding extends AbstractGrounding {
+    #private;
+    constructor(config?: ColumnStatsGroundingConfig);
+    /**
+     * Collect min/max/nullFraction statistics for a column.
+     * Return undefined to skip this column.
+     */
+    protected abstract collectStats(tableName: string, column: Column): Promise<ColumnStats | undefined>;
+    /**
+     * Execute the grounding process.
+     * Annotates columns in ctx.tables and ctx.views with statistics.
+     */
+    execute(ctx: GroundingContext): Promise<() => null>;
+}
+//# sourceMappingURL=column-stats.grounding.d.ts.map

package/dist/lib/adapters/groundings/column-stats.grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-stats.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/groundings/column-stats.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAmB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,0BAA0B;CAE1C;AAED;;;;;;;;GAQG;AACH,8BAAsB,oBAAqB,SAAQ,iBAAiB;;gBACtD,MAAM,GAAE,0BAA+B;IAInD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAEnC;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,gBAAgB;CA4BpC"}

package/dist/lib/adapters/groundings/constraint.grounding.d.ts

@@ -0,0 +1,31 @@
+import type { TableConstraint } from '../adapter.ts';
+import { AbstractGrounding } from '../grounding.ticket.ts';
+import type { GroundingContext } from './context.ts';
+/**
+ * Configuration for ConstraintGrounding.
+ */
+export interface ConstraintGroundingConfig {
+}
+/**
+ * Abstract base class for constraint grounding.
+ *
+ * Reads tables from the context and annotates them with constraints
+ * (CHECK, UNIQUE, NOT_NULL, DEFAULT).
+ * This grounding must run AFTER TableGrounding since it reads from ctx.tables.
+ *
+ * Subclasses implement the database-specific hook:
+ * - `getConstraints()` - fetch constraints for a table
+ */
+export declare abstract class ConstraintGrounding extends AbstractGrounding {
+    constructor(config?: ConstraintGroundingConfig);
+    /**
+     * Fetch constraints for a specific table.
+     */
+    protected abstract getConstraints(tableName: string): Promise<TableConstraint[]>;
+    /**
+     * Execute the grounding process.
+     * Annotates tables in ctx.tables with their constraints.
+     */
+    execute(ctx: GroundingContext): Promise<() => null>;
+}
+//# sourceMappingURL=constraint.grounding.d.ts.map

package/dist/lib/adapters/groundings/constraint.grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/groundings/constraint.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,yBAAyB;CAEzC;AAED;;;;;;;;;GASG;AACH,8BAAsB,mBAAoB,SAAQ,iBAAiB;gBACrD,MAAM,GAAE,yBAA8B;IAIlD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAEhF;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,gBAAgB;CAYpC"}

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

@@ -0,0 +1,41 @@
+import type { AdapterInfo, ColumnStats, Relationship, Table } from '../adapter.ts';
+import type { View } from './view.grounding.ts';
+/**
+ * Column type for grounding operations.
+ * Common interface between Table.columns and View.columns.
+ */
+export interface Column {
+    name: string;
+    type: string;
+    kind?: 'LowCardinality';
+    values?: string[];
+    stats?: ColumnStats;
+}
+/**
+ * Entity with columns (Table or View).
+ */
+export interface ColumnContainer {
+    name: string;
+    columns: Column[];
+}
+/**
+ * Shared context object passed to all groundings.
+ * Groundings read from and write to this context.
+ */
+export interface GroundingContext {
+    /** Tables discovered by TableGrounding */
+    tables: Table[];
+    /** Views discovered by ViewGrounding */
+    views: View[];
+    /** Relationships discovered by TableGrounding */
+    relationships: Relationship[];
+    /** Database info collected by InfoGrounding */
+    info?: AdapterInfo;
+    /** Business context report generated by ReportGrounding */
+    report?: string;
+}
+/**
+ * Create a new empty grounding context.
+ */
+export declare function createGroundingContext(): GroundingContext;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/groundings/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACnF,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,CAAC;IACxB,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,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAOzD"}

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

@@ -0,0 +1,8 @@
+export * from './context.ts';
+export * from './table.grounding.ts';
+export * from './column-stats.grounding.ts';
+export * from './low-cardinality.grounding.ts';
+export * from './info.grounding.ts';
+export * from './view.grounding.ts';
+export * from './report.grounding.ts';
+//# sourceMappingURL=grounding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/groundings/grounding.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}