@deepagents/text2sql 5.0.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/CLICKHOUSE-DEPLOYMENT.md +181 -0
  2. package/README.md +26 -4
  3. package/dist/bin/sql.js +33 -51
  4. package/dist/index.js +56 -289
  5. package/dist/index.js.map +4 -4
  6. package/dist/lib/adapters/adapter.d.ts +8 -1
  7. package/dist/lib/adapters/adapter.d.ts.map +1 -1
  8. package/dist/lib/adapters/bigquery/bigquery.d.ts.map +1 -1
  9. package/dist/lib/adapters/bigquery/bigquery.sql-policy.d.ts +9 -0
  10. package/dist/lib/adapters/bigquery/bigquery.sql-policy.d.ts.map +1 -0
  11. package/dist/lib/adapters/bigquery/index.d.ts +1 -0
  12. package/dist/lib/adapters/bigquery/index.d.ts.map +1 -1
  13. package/dist/lib/adapters/bigquery/index.js +303 -259
  14. package/dist/lib/adapters/bigquery/index.js.map +4 -4
  15. package/dist/lib/adapters/clickhouse/clickhouse.d.ts +22 -0
  16. package/dist/lib/adapters/clickhouse/clickhouse.d.ts.map +1 -0
  17. package/dist/lib/adapters/clickhouse/clickhouse.sql-policy.d.ts +8 -0
  18. package/dist/lib/adapters/clickhouse/clickhouse.sql-policy.d.ts.map +1 -0
  19. package/dist/lib/adapters/clickhouse/constraint.clickhouse.grounding.d.ts +8 -0
  20. package/dist/lib/adapters/clickhouse/constraint.clickhouse.grounding.d.ts.map +1 -0
  21. package/dist/lib/adapters/clickhouse/index.d.ts +33 -0
  22. package/dist/lib/adapters/clickhouse/index.d.ts.map +1 -0
  23. package/dist/lib/adapters/clickhouse/index.js +1544 -0
  24. package/dist/lib/adapters/clickhouse/index.js.map +7 -0
  25. package/dist/lib/adapters/clickhouse/indexes.clickhouse.grounding.d.ts +8 -0
  26. package/dist/lib/adapters/clickhouse/indexes.clickhouse.grounding.d.ts.map +1 -0
  27. package/dist/lib/adapters/clickhouse/info.clickhouse.grounding.d.ts +8 -0
  28. package/dist/lib/adapters/clickhouse/info.clickhouse.grounding.d.ts.map +1 -0
  29. package/dist/lib/adapters/clickhouse/row-count.clickhouse.grounding.d.ts +8 -0
  30. package/dist/lib/adapters/clickhouse/row-count.clickhouse.grounding.d.ts.map +1 -0
  31. package/dist/lib/adapters/clickhouse/table.clickhouse.grounding.d.ts +11 -0
  32. package/dist/lib/adapters/clickhouse/table.clickhouse.grounding.d.ts.map +1 -0
  33. package/dist/lib/adapters/clickhouse/view.clickhouse.grounding.d.ts +9 -0
  34. package/dist/lib/adapters/clickhouse/view.clickhouse.grounding.d.ts.map +1 -0
  35. package/dist/lib/adapters/groundings/abstract.grounding.d.ts +11 -16
  36. package/dist/lib/adapters/groundings/abstract.grounding.d.ts.map +1 -1
  37. package/dist/lib/adapters/groundings/index.js +16 -0
  38. package/dist/lib/adapters/groundings/index.js.map +2 -2
  39. package/dist/lib/adapters/groundings/table.grounding.d.ts +1 -0
  40. package/dist/lib/adapters/groundings/table.grounding.d.ts.map +1 -1
  41. package/dist/lib/adapters/groundings/view.grounding.d.ts +1 -0
  42. package/dist/lib/adapters/groundings/view.grounding.d.ts.map +1 -1
  43. package/dist/lib/adapters/mysql/index.d.ts +1 -0
  44. package/dist/lib/adapters/mysql/index.d.ts.map +1 -1
  45. package/dist/lib/adapters/mysql/index.js +317 -259
  46. package/dist/lib/adapters/mysql/index.js.map +4 -4
  47. package/dist/lib/adapters/mysql/mysql.d.ts.map +1 -1
  48. package/dist/lib/adapters/mysql/mysql.sql-policy.d.ts +11 -0
  49. package/dist/lib/adapters/mysql/mysql.sql-policy.d.ts.map +1 -0
  50. package/dist/lib/adapters/parser-sql-policy.d.ts +23 -0
  51. package/dist/lib/adapters/parser-sql-policy.d.ts.map +1 -0
  52. package/dist/lib/adapters/postgres/index.d.ts +1 -0
  53. package/dist/lib/adapters/postgres/index.d.ts.map +1 -1
  54. package/dist/lib/adapters/postgres/index.js +323 -259
  55. package/dist/lib/adapters/postgres/index.js.map +4 -4
  56. package/dist/lib/adapters/postgres/postgres.d.ts.map +1 -1
  57. package/dist/lib/adapters/postgres/postgres.sql-policy.d.ts +10 -0
  58. package/dist/lib/adapters/postgres/postgres.sql-policy.d.ts.map +1 -0
  59. package/dist/lib/adapters/spreadsheet/index.js +301 -259
  60. package/dist/lib/adapters/spreadsheet/index.js.map +4 -4
  61. package/dist/lib/adapters/spreadsheet/parser.d.ts.map +1 -1
  62. package/dist/lib/adapters/sql-policy.d.ts +19 -0
  63. package/dist/lib/adapters/sql-policy.d.ts.map +1 -0
  64. package/dist/lib/adapters/sqlite/index.d.ts +1 -0
  65. package/dist/lib/adapters/sqlite/index.d.ts.map +1 -1
  66. package/dist/lib/adapters/sqlite/index.js +303 -259
  67. package/dist/lib/adapters/sqlite/index.js.map +4 -4
  68. package/dist/lib/adapters/sqlite/sqlite.d.ts.map +1 -1
  69. package/dist/lib/adapters/sqlite/sqlite.sql-policy.d.ts +8 -0
  70. package/dist/lib/adapters/sqlite/sqlite.sql-policy.d.ts.map +1 -0
  71. package/dist/lib/adapters/sqlserver/index.d.ts +1 -0
  72. package/dist/lib/adapters/sqlserver/index.d.ts.map +1 -1
  73. package/dist/lib/adapters/sqlserver/index.js +310 -259
  74. package/dist/lib/adapters/sqlserver/index.js.map +4 -4
  75. package/dist/lib/adapters/sqlserver/sqlserver.d.ts.map +1 -1
  76. package/dist/lib/adapters/sqlserver/sqlserver.sql-policy.d.ts +11 -0
  77. package/dist/lib/adapters/sqlserver/sqlserver.sql-policy.d.ts.map +1 -0
  78. package/dist/lib/agents/exceptions.d.ts +1 -1
  79. package/dist/lib/agents/sql.agent.d.ts.map +1 -1
  80. package/dist/lib/sql-scope-error.d.ts +3 -0
  81. package/dist/lib/sql-scope-error.d.ts.map +1 -0
  82. package/dist/lib/synthesis/index.js +32 -38
  83. package/dist/lib/synthesis/index.js.map +4 -4
  84. package/package.json +29 -23
  85. package/dist/lib/adapters/runtime-scope.d.ts +0 -16
  86. package/dist/lib/adapters/runtime-scope.d.ts.map +0 -1
@@ -0,0 +1,22 @@
1
+ import { Adapter, type ExecuteFunction, type GroundingFn, type ValidateFunction } from '../adapter.ts';
2
+ export interface ClickHouseAdapterOptions {
3
+ execute: ExecuteFunction;
4
+ validate: ValidateFunction;
5
+ grounding?: GroundingFn[];
6
+ defaultDatabase?: string;
7
+ }
8
+ export declare class ClickHouse extends Adapter {
9
+ #private;
10
+ readonly grounding: GroundingFn[];
11
+ readonly defaultSchema: string | undefined;
12
+ readonly systemSchemas: string[];
13
+ readonly formatterLanguage = "clickhouse";
14
+ constructor(options: ClickHouseAdapterOptions);
15
+ executeImpl(sql: string): Promise<unknown[]>;
16
+ validateImpl(sql: string): Promise<string | void>;
17
+ runQuery<Row>(sql: string): Promise<Row[]>;
18
+ quoteIdentifier(name: string): string;
19
+ escape(value: string): string;
20
+ buildSampleRowsQuery(tableName: string, columns: string[] | undefined, limit: number): string;
21
+ }
22
+ //# sourceMappingURL=clickhouse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/clickhouse/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,qBAAa,UAAW,SAAQ,OAAO;;IAGrC,SAAkB,SAAS,EAAE,WAAW,EAAE,CAAC;IAC3C,SAAkB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IACpD,SAAkB,aAAa,WAI7B;IACF,SAAkB,iBAAiB,gBAAgB;gBAEvC,OAAO,EAAE,wBAAwB;IAc9B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAejD,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;CAUV"}
@@ -0,0 +1,8 @@
1
+ import type { ExecuteFunction } from '../adapter.ts';
2
+ import type { SqlPolicyAnalyzer, SqlPolicyContext, SqlPolicyViolation } from '../sql-policy.ts';
3
+ export declare class ClickHouseSqlPolicyAnalyzer implements SqlPolicyAnalyzer {
4
+ #private;
5
+ constructor(query: ExecuteFunction);
6
+ analyze(sql: string, context: SqlPolicyContext): Promise<SqlPolicyViolation | null>;
7
+ }
8
+ //# sourceMappingURL=clickhouse.sql-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clickhouse.sql-policy.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/clickhouse/clickhouse.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;AAS1B,qBAAa,2BAA4B,YAAW,iBAAiB;;gBAKvD,KAAK,EAAE,eAAe;IAI5B,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CA8HtC"}
@@ -0,0 +1,8 @@
1
+ import type { Adapter, TableConstraint } from '../adapter.ts';
2
+ import { ConstraintGrounding, type ConstraintGroundingConfig } from '../groundings/constraint.grounding.ts';
3
+ export declare class ClickHouseConstraintGrounding extends ConstraintGrounding {
4
+ #private;
5
+ constructor(adapter: Adapter, config?: ConstraintGroundingConfig);
6
+ protected getConstraints(tableName: string): Promise<TableConstraint[]>;
7
+ }
8
+ //# sourceMappingURL=constraint.clickhouse.grounding.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"constraint.clickhouse.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/clickhouse/constraint.clickhouse.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC/B,MAAM,uCAAuC,CAAC;AAU/C,qBAAa,6BAA8B,SAAQ,mBAAmB;;gBAGxD,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,yBAA8B;cAK3C,cAAc,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC;CA4C9B"}
@@ -0,0 +1,33 @@
1
+ import type { Adapter } from '../adapter.ts';
2
+ import type { ConstraintGroundingConfig } from '../groundings/constraint.grounding.ts';
3
+ import type { IndexesGroundingConfig } from '../groundings/indexes.grounding.ts';
4
+ import type { InfoGroundingConfig } from '../groundings/info.grounding.ts';
5
+ import type { RowCountGroundingConfig } from '../groundings/row-count.grounding.ts';
6
+ import type { TableGroundingConfig } from '../groundings/table.grounding.ts';
7
+ import type { ViewGroundingConfig } from '../groundings/view.grounding.ts';
8
+ import { ClickHouse } from './clickhouse.ts';
9
+ import { ClickHouseConstraintGrounding } from './constraint.clickhouse.grounding.ts';
10
+ import { ClickHouseIndexesGrounding } from './indexes.clickhouse.grounding.ts';
11
+ import { ClickHouseInfoGrounding } from './info.clickhouse.grounding.ts';
12
+ import { ClickHouseRowCountGrounding } from './row-count.clickhouse.grounding.ts';
13
+ import { ClickHouseTableGrounding } from './table.clickhouse.grounding.ts';
14
+ import { ClickHouseViewGrounding } from './view.clickhouse.grounding.ts';
15
+ export * from './clickhouse.ts';
16
+ export { ClickHouseSqlPolicyAnalyzer } from './clickhouse.sql-policy.ts';
17
+ export declare function tables(config?: TableGroundingConfig): (adapter: Adapter) => ClickHouseTableGrounding;
18
+ export declare function views(config?: ViewGroundingConfig): (adapter: Adapter) => ClickHouseViewGrounding;
19
+ export declare function info(config?: InfoGroundingConfig): (adapter: Adapter) => ClickHouseInfoGrounding;
20
+ export declare function indexes(config?: IndexesGroundingConfig): (adapter: Adapter) => ClickHouseIndexesGrounding;
21
+ export declare function rowCount(config?: RowCountGroundingConfig): (adapter: Adapter) => ClickHouseRowCountGrounding;
22
+ export declare function constraints(config?: ConstraintGroundingConfig): (adapter: Adapter) => ClickHouseConstraintGrounding;
23
+ declare const _default: {
24
+ ClickHouse: typeof ClickHouse;
25
+ constraints: typeof constraints;
26
+ indexes: typeof indexes;
27
+ info: typeof info;
28
+ rowCount: typeof rowCount;
29
+ tables: typeof tables;
30
+ views: typeof views;
31
+ };
32
+ export default _default;
33
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/clickhouse/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,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,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,wBAAgB,MAAM,CAAC,MAAM,GAAE,oBAAyB,IAC9C,SAAS,OAAO,8BACzB;AAED,wBAAgB,KAAK,CAAC,MAAM,GAAE,mBAAwB,IAC5C,SAAS,OAAO,6BACzB;AAED,wBAAgB,IAAI,CAAC,MAAM,GAAE,mBAAwB,IAC3C,SAAS,OAAO,6BACzB;AAED,wBAAgB,OAAO,CAAC,MAAM,GAAE,sBAA2B,IACjD,SAAS,OAAO,gCACzB;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAE,uBAA4B,IACnD,SAAS,OAAO,iCACzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,yBAA8B,IACxD,SAAS,OAAO,mCAEzB;;;;;;;;;;AAED,wBAQE"}