@deepagents/text2sql 6.1.0 → 7.0.0

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

@@ -0,0 +1,40 @@
+import { Adapter, type ExecuteFunction, type GroundingFn, type ValidateFunction } from '../adapter.ts';
+export interface DuckDBAdapterOptions {
+    execute: ExecuteFunction;
+    validate?: ValidateFunction;
+    grounding?: GroundingFn[];
+    catalogs?: string[];
+    schemas?: string[];
+}
+export declare class DuckDB extends Adapter {
+    #private;
+    readonly grounding: GroundingFn[];
+    readonly defaultSchema = "main";
+    readonly systemSchemas: string[];
+    readonly formatterLanguage = "duckdb";
+    constructor(options: DuckDBAdapterOptions);
+    get catalogs(): readonly string[] | undefined;
+    get schemas(): readonly string[] | undefined;
+    executeImpl(sql: string): Promise<unknown[]>;
+    validateImpl(sql: string): Promise<string | void>;
+    runQuery<Row>(sql: string): Promise<Row[]>;
+    quoteIdentifier(name: string): string;
+    escape(value: string): string;
+    buildSampleRowsQuery(tableName: string, columns: string[] | undefined, limit: number): string;
+    currentNamespace(): Promise<{
+        catalog: string;
+        schema: string;
+    }>;
+    resolveRelationName(name: string): Promise<{
+        catalog: string;
+        schema: string;
+        table: string;
+    }>;
+    formatRelationName(catalog: string, schema: string, table: string): string;
+    quoteRelationName(name: string): string;
+    scopedNamespaces(): Promise<{
+        catalogs: string[];
+        schemas: string[];
+    }>;
+}
+//# sourceMappingURL=duckdb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/duckdb/duckdb.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAOvB,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,qBAAa,MAAO,SAAQ,OAAO;;IAIjC,SAAkB,SAAS,EAAE,WAAW,EAAE,CAAC;IAC3C,SAAkB,aAAa,UAAU;IACzC,SAAkB,aAAa,WAAwC;IACvE,SAAkB,iBAAiB,YAAY;gBAEnC,OAAO,EAAE,oBAAoB;IAWzC,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAE5C;IAED,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAE3C;IAEc,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgBjD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAIhD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI7B,oBAAoB,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,KAAK,EAAE,MAAM,GACZ,MAAM;IAWH,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhE,mBAAmB,CACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAU9D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASjC,gBAAgB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAwB7E"}

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

@@ -0,0 +1,58 @@
+import type { AdapterInfo, ColumnStats, Relationship, Table, TableConstraint, TableIndex } from '../adapter.ts';
+import { ColumnStatsGrounding, type ColumnStatsGroundingConfig } from '../groundings/column-stats.grounding.ts';
+import { type Column, ColumnValuesGrounding, type ColumnValuesGroundingConfig } from '../groundings/column-values.grounding.ts';
+import { ConstraintGrounding, type ConstraintGroundingConfig } from '../groundings/constraint.grounding.ts';
+import { IndexesGrounding, type IndexesGroundingConfig } from '../groundings/indexes.grounding.ts';
+import { InfoGrounding, type InfoGroundingConfig } from '../groundings/info.grounding.ts';
+import { RowCountGrounding, type RowCountGroundingConfig } from '../groundings/row-count.grounding.ts';
+import { TableGrounding, type TableGroundingConfig } from '../groundings/table.grounding.ts';
+import { type View, ViewGrounding, type ViewGroundingConfig } from '../groundings/view.grounding.ts';
+import type { DuckDB } from './duckdb.ts';
+export declare class DuckDBTableGrounding extends TableGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: TableGroundingConfig);
+    protected applyFilter(): Promise<string[]>;
+    protected getAllTableNames(): Promise<string[]>;
+    protected getTable(tableName: string): Promise<Table>;
+    protected findOutgoingRelations(tableName: string): Promise<Relationship[]>;
+    protected findIncomingRelations(tableName: string): Promise<Relationship[]>;
+}
+export declare class DuckDBInfoGrounding extends InfoGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: InfoGroundingConfig);
+    protected collectInfo(): Promise<AdapterInfo>;
+}
+export declare class DuckDBViewGrounding extends ViewGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: ViewGroundingConfig);
+    protected applyFilter(): Promise<string[]>;
+    protected getAllViewNames(): Promise<string[]>;
+    protected getView(viewName: string): Promise<View>;
+}
+export declare class DuckDBConstraintGrounding extends ConstraintGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: ConstraintGroundingConfig);
+    protected getConstraints(tableName: string): Promise<TableConstraint[]>;
+}
+export declare class DuckDBIndexesGrounding extends IndexesGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: IndexesGroundingConfig);
+    protected getIndexes(tableName: string): Promise<TableIndex[]>;
+}
+export declare class DuckDBRowCountGrounding extends RowCountGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: RowCountGroundingConfig);
+    protected getRowCount(tableName: string): Promise<number | undefined>;
+}
+export declare class DuckDBColumnStatsGrounding extends ColumnStatsGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: ColumnStatsGroundingConfig);
+    protected collectStats(tableName: string, column: Column): Promise<ColumnStats | undefined>;
+}
+export declare class DuckDBColumnValuesGrounding extends ColumnValuesGrounding {
+    #private;
+    constructor(adapter: DuckDB, config?: ColumnValuesGroundingConfig);
+    protected collectEnumValues(_tableName: string, column: Column): Promise<string[] | undefined>;
+    protected collectLowCardinality(tableName: string, column: Column): Promise<string[] | undefined>;
+}
+//# sourceMappingURL=duckdb.groundings.d.ts.map

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

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

package/dist/lib/adapters/duckdb/duckdb.sql-policy.d.ts

@@ -0,0 +1,8 @@
+import type { ExecuteFunction } from '../adapter.ts';
+import type { SqlPolicyAnalyzer, SqlPolicyContext, SqlPolicyViolation } from '../sql-policy.ts';
+export declare class DuckDBSqlPolicyAnalyzer implements SqlPolicyAnalyzer {
+    #private;
+    constructor(query: ExecuteFunction);
+    analyze(sql: string, context: SqlPolicyContext): Promise<SqlPolicyViolation | null>;
+}
+//# sourceMappingURL=duckdb.sql-policy.d.ts.map

package/dist/lib/adapters/duckdb/duckdb.sql-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.sql-policy.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/duckdb/duckdb.sql-policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAW1B,qBAAa,uBAAwB,YAAW,iBAAiB;;gBAInD,KAAK,EAAE,eAAe;IAI5B,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAgItC"}

package/dist/lib/adapters/duckdb/index.d.ts

@@ -0,0 +1,34 @@
+import type { Adapter } from '../adapter.ts';
+import type { ColumnStatsGroundingConfig } from '../groundings/column-stats.grounding.ts';
+import type { ColumnValuesGroundingConfig } from '../groundings/column-values.grounding.ts';
+import type { ConstraintGroundingConfig } from '../groundings/constraint.grounding.ts';
+import type { IndexesGroundingConfig } from '../groundings/indexes.grounding.ts';
+import type { InfoGroundingConfig } from '../groundings/info.grounding.ts';
+import type { RowCountGroundingConfig } from '../groundings/row-count.grounding.ts';
+import type { TableGroundingConfig } from '../groundings/table.grounding.ts';
+import type { ViewGroundingConfig } from '../groundings/view.grounding.ts';
+import { DuckDBColumnStatsGrounding, DuckDBColumnValuesGrounding, DuckDBConstraintGrounding, DuckDBIndexesGrounding, DuckDBInfoGrounding, DuckDBRowCountGrounding, DuckDBTableGrounding, DuckDBViewGrounding } from './duckdb.groundings.ts';
+import { DuckDB } from './duckdb.ts';
+export * from './duckdb.ts';
+export { DuckDBSqlPolicyAnalyzer } from './duckdb.sql-policy.ts';
+export declare function tables(config?: TableGroundingConfig): (adapter: Adapter) => DuckDBTableGrounding;
+export declare function info(config?: InfoGroundingConfig): (adapter: Adapter) => DuckDBInfoGrounding;
+export declare function views(config?: ViewGroundingConfig): (adapter: Adapter) => DuckDBViewGrounding;
+export declare function constraints(config?: ConstraintGroundingConfig): (adapter: Adapter) => DuckDBConstraintGrounding;
+export declare function indexes(config?: IndexesGroundingConfig): (adapter: Adapter) => DuckDBIndexesGrounding;
+export declare function rowCount(config?: RowCountGroundingConfig): (adapter: Adapter) => DuckDBRowCountGrounding;
+export declare function columnStats(config?: ColumnStatsGroundingConfig): (adapter: Adapter) => DuckDBColumnStatsGrounding;
+export declare function columnValues(config?: ColumnValuesGroundingConfig): (adapter: Adapter) => DuckDBColumnValuesGrounding;
+declare const _default: {
+    tables: typeof tables;
+    info: typeof info;
+    views: typeof views;
+    constraints: typeof constraints;
+    indexes: typeof indexes;
+    rowCount: typeof rowCount;
+    columnStats: typeof columnStats;
+    columnValues: typeof columnValues;
+    DuckDB: typeof DuckDB;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/adapters/duckdb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/duckdb/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,wBAAgB,MAAM,CAAC,MAAM,GAAE,oBAAyB,IAC9C,SAAS,OAAO,0BAEzB;AAED,wBAAgB,IAAI,CAAC,MAAM,GAAE,mBAAwB,IAC3C,SAAS,OAAO,yBAEzB;AAED,wBAAgB,KAAK,CAAC,MAAM,GAAE,mBAAwB,IAC5C,SAAS,OAAO,yBAEzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,yBAA8B,IACxD,SAAS,OAAO,+BAEzB;AAED,wBAAgB,OAAO,CAAC,MAAM,GAAE,sBAA2B,IACjD,SAAS,OAAO,4BAEzB;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAE,uBAA4B,IACnD,SAAS,OAAO,6BAEzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,0BAA+B,IACzD,SAAS,OAAO,gCAEzB;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAE,2BAAgC,IAC3D,SAAS,OAAO,iCAEzB;;;;;;;;;;;;AAED,wBAUE"}