@deepagents/text2sql 7.0.2 → 7.1.1

package/dist/lib/adapters/bigquery/indexes.bigquery.grounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexes.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/indexes.bigquery.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAS9C,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;CAAG;AAEjF,qBAAa,wBAAyB,SAAQ,gBAAgB;;gBAGhD,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,8BAAmC;IAK3D,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cA6GnC,UAAU,CACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC;CAGzB"}
+{"version":3,"file":"indexes.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/indexes.bigquery.grounding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC5B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAU9C,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;CAAG;AAEjF,qBAAa,wBAAyB,SAAQ,gBAAgB;;gBAGhD,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,8BAAmC;IAK3D,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cAgHnC,UAAU,CACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC;CAGzB"}

package/dist/lib/adapters/bigquery/row-count.bigquery.grounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"row-count.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/row-count.bigquery.grounding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAY9C,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB;CAAG;AAEnF,qBAAa,yBAA0B,SAAQ,iBAAiB;;gBAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,+BAAoC;IAK5D,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cA+GnC,WAAW,CAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAG/B"}
+{"version":3,"file":"row-count.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/row-count.bigquery.grounding.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC7B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAc9C,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB;CAAG;AAEnF,qBAAa,yBAA0B,SAAQ,iBAAiB;;gBAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,+BAAoC;IAK5D,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cAqHnC,WAAW,CAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAG/B"}

package/dist/lib/adapters/bigquery/table.bigquery.grounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/table.bigquery.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAmB9C,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;CAAG;AAE7E,qBAAa,sBAAuB,SAAQ,cAAc;;gBAI5C,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,4BAAiC;IAKzD,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cAWnC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAKhC,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAoBrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;cAuC3C,qBAAqB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC;cAqDD,qBAAqB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC;CA+F3B"}
+{"version":3,"file":"table.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/table.bigquery.grounding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAQ1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAc9C,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;CAAG;AAE7E,qBAAa,sBAAuB,SAAQ,cAAc;;gBAI5C,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,4BAAiC;IAKzD,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cAWnC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAKhC,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAuBrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;cA0C3C,qBAAqB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC;cAwDD,qBAAqB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC;CAiG3B"}

package/dist/lib/adapters/bigquery/view.bigquery.grounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/view.bigquery.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,EACT,aAAa,EACb,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAe9C,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;CAAG;AAE3E,qBAAa,qBAAsB,SAAQ,aAAa;;gBAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,2BAAgC;cAK9C,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAKhC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAoBpC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsClE"}
+{"version":3,"file":"view.bigquery.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/bigquery/view.bigquery.grounding.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,IAAI,EACT,aAAa,EACb,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAU9C,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;CAAG;AAE3E,qBAAa,qBAAsB,SAAQ,aAAa;;gBAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,2BAAgC;cAK9C,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAKhC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;cAuBpC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA4ClE"}

package/dist/lib/adapters/clickhouse/clickhouse-rows.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+/** `SELECT name, type FROM system.columns`. */
+export declare const columnRow: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=clickhouse-rows.d.ts.map

package/dist/lib/adapters/clickhouse/clickhouse-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-rows.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/clickhouse/clickhouse-rows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,+CAA+C;AAC/C,eAAO,MAAM,SAAS;;;iBAAmD,CAAC"}

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

@@ -14,7 +14,7 @@ export declare class ClickHouse extends Adapter {
     constructor(options: ClickHouseAdapterOptions);
     executeImpl(sql: string): Promise<unknown[]>;
     validateImpl(sql: string): Promise<string | void>;
-    runQuery<Row>(sql: string): Promise<Row[]>;
+    protected queryRows(sql: string): Promise<unknown[]>;
     quoteIdentifier(name: string): string;
     escape(value: string): string;
     buildSampleRowsQuery(tableName: string, columns: string[] | undefined, limit: number): string;

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

@@ -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"}
+{"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;AAED,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;cAevC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI1D,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"}

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

@@ -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"}
+{"version":3,"file":"constraint.clickhouse.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/clickhouse/constraint.clickhouse.grounding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC/B,MAAM,uCAAuC,CAAC;AAc/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;CA+C9B"}

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

@@ -1,5 +1,6 @@
 // packages/text2sql/src/lib/adapters/adapter.ts
 import { format as formatSql } from "sql-formatter";
+import { z } from "zod";
 
 // packages/text2sql/src/lib/agents/exceptions.ts
 var sqlValidationMarker = /* @__PURE__ */ Symbol("SQLValidationError");
@@ -432,6 +433,40 @@ var Adapter = class {
     }
     return decoded;
   }
+  /**
+   * Run an introspection query and check every row against `row`, the shape
+   * the driver returns for that query. A row of any other shape throws.
+   */
+  async runQuery(sql, row) {
+    const rows = z.array(row).safeParse(await this.queryRows(sql));
+    if (!rows.success) {
+      throw new Error(
+        `${this.constructor.name} introspection query returned rows of an unexpected shape:
+${z.prettifyError(rows.error)}
+SQL: ${sql.trim()}`,
+        { cause: rows.error }
+      );
+    }
+    return rows.data;
+  }
+  /**
+   * The rows in a driver's execute() result: the result itself when it is an
+   * array, otherwise the first array found at one of `paths` (dot-separated,
+   * so `recordsets.0` reads `result.recordsets[0]`).
+   */
+  rowsFrom(result, paths) {
+    if (Array.isArray(result)) return result;
+    for (const path of paths) {
+      const rows = path.split(".").reduce(
+        (value, key) => typeof value === "object" && value !== null ? Reflect.get(value, key) : void 0,
+        result
+      );
+      if (Array.isArray(rows)) return rows;
+    }
+    throw new Error(
+      `${this.constructor.name} execute() must return an array of rows or an object holding one at ${paths.map((path) => `result.${path}`).join(", ")}.`
+    );
+  }
   /**
    * Convert unknown database value to number.
    * Handles number, bigint, and string types.
@@ -618,8 +653,8 @@ function isScopeBypassingFunction(name) {
   return normalized.startsWith("dict") || normalized.startsWith("joinget");
 }
 function readRows(result) {
-  const rows = Array.isArray(result) ? result : result && typeof result === "object" && "data" in result ? result.data : result && typeof result === "object" && "rows" in result ? result.rows : void 0;
-  if (!Array.isArray(rows) || rows.some((row) => !isRecord(row))) {
+  const rows = Array.isArray(result) ? result : typeof result === "object" && result !== null && "data" in result ? result.data : typeof result === "object" && result !== null && "rows" in result ? result.rows : void 0;
+  if (!Array.isArray(rows) || !rows.every(isRecord)) {
     throw new Error(
       "ClickHouse query callback must return row objects as an array, { data }, or { rows }."
     );
@@ -827,7 +862,7 @@ var ClickHouse = class extends Adapter {
     this.defaultSchema = options.defaultDatabase;
   }
   async executeImpl(sql) {
-    return rowsFromResult(await this.#options.execute(sql));
+    return this.rowsFrom(await this.#options.execute(sql), ["data", "rows"]);
   }
   async validateImpl(sql) {
     try {
@@ -842,8 +877,8 @@ var ClickHouse = class extends Adapter {
       });
     }
   }
-  async runQuery(sql) {
-    return rowsFromResult(await this.#options.execute(sql));
+  async queryRows(sql) {
+    return this.rowsFrom(await this.#options.execute(sql), ["data", "rows"]);
   }
   quoteIdentifier(name) {
     return `\`${name.replace(/`/g, "``")}\``;
@@ -858,17 +893,9 @@ var ClickHouse = class extends Adapter {
     return `SELECT ${projection} FROM ${relation} LIMIT ${limit}`;
   }
 };
-function rowsFromResult(result) {
-  if (Array.isArray(result)) return result;
-  if (result && typeof result === "object") {
-    const candidate = result;
-    if (Array.isArray(candidate.data)) return candidate.data;
-    if (Array.isArray(candidate.rows)) return candidate.rows;
-  }
-  throw new Error(
-    "ClickHouse execute() must return an array of rows, { data: rows }, or { rows }."
-  );
-}
+
+// packages/text2sql/src/lib/adapters/clickhouse/constraint.clickhouse.grounding.ts
+import { z as z2 } from "zod";
 
 // packages/text2sql/src/lib/adapters/groundings/abstract.grounding.ts
 function filterColumns(columns, filter) {
@@ -939,6 +966,13 @@ var ConstraintGrounding = class extends AbstractGrounding {
 };
 
 // packages/text2sql/src/lib/adapters/clickhouse/constraint.clickhouse.grounding.ts
+var columnMetadataRow = z2.object({
+  name: z2.string(),
+  type: z2.string(),
+  default_kind: z2.string(),
+  default_expression: z2.string(),
+  is_in_primary_key: z2.union([z2.number(), z2.string()])
+});
 var ClickHouseConstraintGrounding = class extends ConstraintGrounding {
   #adapter;
   constructor(adapter, config = {}) {
@@ -948,13 +982,16 @@ var ClickHouseConstraintGrounding = class extends ConstraintGrounding {
   async getConstraints(tableName) {
     const { schema, table: table2 } = this.#adapter.parseTableName(tableName);
     if (!schema) return [];
-    const rows = await this.#adapter.runQuery(`
+    const rows = await this.#adapter.runQuery(
+      `
       SELECT name, type, default_kind, default_expression, is_in_primary_key
       FROM system.columns
       WHERE database = '${this.#adapter.escapeString(schema)}'
         AND table = '${this.#adapter.escapeString(table2)}'
       ORDER BY position
-    `);
+    `,
+      columnMetadataRow
+    );
     const constraints2 = [];
     const primaryKey = rows.filter((row) => Number(row.is_in_primary_key) === 1).map((row) => row.name);
     if (primaryKey.length > 0) {
@@ -988,6 +1025,9 @@ function hasNullableType(type) {
   return /(?:^|\()Nullable\(/.test(type);
 }
 
+// packages/text2sql/src/lib/adapters/clickhouse/indexes.clickhouse.grounding.ts
+import { z as z4 } from "zod";
+
 // packages/text2sql/src/lib/adapters/groundings/indexes.grounding.ts
 var IndexesGrounding = class extends AbstractGrounding {
   constructor(config = {}) {
@@ -1022,7 +1062,24 @@ var IndexesGrounding = class extends AbstractGrounding {
   }
 };
 
+// packages/text2sql/src/lib/adapters/groundings/rows.ts
+import { z as z3 } from "zod";
+var nameRow = z3.object({ name: z3.string() });
+var versionRow = z3.object({ version: z3.string() });
+var databaseRow = z3.object({ db: z3.string() });
+var viewDefinitionRow = z3.object({
+  definition: z3.string().nullable()
+});
+var distinctValueRow = z3.object({ value: z3.unknown() });
+var textValueRow = z3.object({ value: z3.string() });
+var numericValue = z3.union([z3.number(), z3.bigint(), z3.string()]);
+
 // packages/text2sql/src/lib/adapters/clickhouse/indexes.clickhouse.grounding.ts
+var dataSkippingIndexRow = z4.object({
+  name: z4.string(),
+  type: z4.string(),
+  expression: z4.string()
+});
 var ClickHouseIndexesGrounding = class extends IndexesGrounding {
   #adapter;
   constructor(adapter, config = {}) {
@@ -1033,21 +1090,27 @@ var ClickHouseIndexesGrounding = class extends IndexesGrounding {
     const { schema, table: table2 } = this.#adapter.parseTableName(tableName);
     if (!schema) return [];
     const [primaryKeyRows, indexRows] = await Promise.all([
-      this.#adapter.runQuery(`
+      this.#adapter.runQuery(
+        `
         SELECT name
         FROM system.columns
         WHERE database = '${this.#adapter.escapeString(schema)}'
           AND table = '${this.#adapter.escapeString(table2)}'
           AND is_in_primary_key = 1
         ORDER BY position
-      `),
-      this.#adapter.runQuery(`
+      `,
+        nameRow
+      ),
+      this.#adapter.runQuery(
+        `
         SELECT name, type_full AS type, expr AS expression
         FROM system.data_skipping_indices
         WHERE database = '${this.#adapter.escapeString(schema)}'
           AND table = '${this.#adapter.escapeString(table2)}'
         ORDER BY name
-      `)
+      `,
+        dataSkippingIndexRow
+      )
     ]);
     const indexes2 = [];
     if (primaryKeyRows.length > 0) {
@@ -1084,6 +1147,9 @@ function splitTopLevelExpressions(expression) {
   return parts.filter(Boolean);
 }
 
+// packages/text2sql/src/lib/adapters/clickhouse/info.clickhouse.grounding.ts
+import { z as z5 } from "zod";
+
 // packages/text2sql/src/lib/adapters/groundings/info.grounding.ts
 var InfoGrounding = class extends AbstractGrounding {
   constructor(config = {}) {
@@ -1099,6 +1165,7 @@ var InfoGrounding = class extends AbstractGrounding {
 };
 
 // packages/text2sql/src/lib/adapters/clickhouse/info.clickhouse.grounding.ts
+var infoRow = z5.object({ version: z5.string(), database: z5.string() });
 var ClickHouseInfoGrounding = class extends InfoGrounding {
   #adapter;
   constructor(adapter, config = {}) {
@@ -1107,7 +1174,8 @@ var ClickHouseInfoGrounding = class extends InfoGrounding {
   }
   async collectInfo() {
     const rows = await this.#adapter.runQuery(
-      "SELECT version() AS version, currentDatabase() AS database"
+      "SELECT version() AS version, currentDatabase() AS database",
+      infoRow
     );
     const row = rows[0];
     return {
@@ -1122,6 +1190,9 @@ var ClickHouseInfoGrounding = class extends InfoGrounding {
   }
 };
 
+// packages/text2sql/src/lib/adapters/clickhouse/row-count.clickhouse.grounding.ts
+import { z as z6 } from "zod";
+
 // packages/text2sql/src/lib/adapters/groundings/row-count.grounding.ts
 var RowCountGrounding = class extends AbstractGrounding {
   constructor(config = {}) {
@@ -1163,6 +1234,7 @@ var RowCountGrounding = class extends AbstractGrounding {
 };
 
 // packages/text2sql/src/lib/adapters/clickhouse/row-count.clickhouse.grounding.ts
+var countRow = z6.object({ count: numericValue.nullable() });
 var ClickHouseRowCountGrounding = class extends RowCountGrounding {
   #adapter;
   constructor(adapter, config = {}) {
@@ -1173,22 +1245,16 @@ var ClickHouseRowCountGrounding = class extends RowCountGrounding {
     const { schema, table: table2 } = this.#adapter.parseTableName(tableName);
     const relation = schema ? `${this.#adapter.quoteIdentifier(schema)}.${this.#adapter.quoteIdentifier(table2)}` : this.#adapter.quoteIdentifier(table2);
     try {
-      const rows = await this.#adapter.runQuery(`SELECT count() AS count FROM ${relation}`);
-      return toNumber(rows[0]?.count);
+      const rows = await this.#adapter.runQuery(
+        `SELECT count() AS count FROM ${relation}`,
+        countRow
+      );
+      return this.#adapter.toNumber(rows[0]?.count);
     } catch {
       return void 0;
     }
   }
 };
-function toNumber(value) {
-  if (typeof value === "number" && Number.isFinite(value)) return value;
-  if (typeof value === "bigint") return Number(value);
-  if (typeof value === "string" && value.trim()) {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed)) return parsed;
-  }
-  return void 0;
-}
 
 // packages/text2sql/src/lib/adapters/groundings/table.grounding.ts
 var TableGrounding = class extends AbstractGrounding {
@@ -1351,6 +1417,10 @@ var TableGrounding = class extends AbstractGrounding {
   }
 };
 
+// packages/text2sql/src/lib/adapters/clickhouse/clickhouse-rows.ts
+import { z as z7 } from "zod";
+var columnRow = z7.object({ name: z7.string(), type: z7.string() });
+
 // packages/text2sql/src/lib/adapters/clickhouse/table.clickhouse.grounding.ts
 var ClickHouseTableGrounding = class extends TableGrounding {
   #adapter;
@@ -1359,14 +1429,17 @@ var ClickHouseTableGrounding = class extends TableGrounding {
     this.#adapter = adapter;
   }
   async getAllTableNames() {
-    const rows = await this.#adapter.runQuery(`
+    const rows = await this.#adapter.runQuery(
+      `
       SELECT concat(database, '.', name) AS name
       FROM system.tables
       WHERE database NOT IN ('system', 'information_schema', 'INFORMATION_SCHEMA')
         AND is_temporary = 0
         AND engine != 'View'
       ORDER BY database, name
-    `);
+    `,
+      nameRow
+    );
     return rows.map((row) => row.name);
   }
   async getTable(tableName) {
@@ -1376,13 +1449,16 @@ var ClickHouseTableGrounding = class extends TableGrounding {
         `ClickHouse table grounding requires a qualified table name: ${tableName}`
       );
     }
-    const rows = await this.#adapter.runQuery(`
+    const rows = await this.#adapter.runQuery(
+      `
       SELECT name, type
       FROM system.columns
       WHERE database = '${this.#adapter.escapeString(schema)}'
         AND table = '${this.#adapter.escapeString(table2)}'
       ORDER BY position
-    `);
+    `,
+      columnRow
+    );
     return {
       name: tableName,
       schema,
@@ -1398,6 +1474,9 @@ var ClickHouseTableGrounding = class extends TableGrounding {
   }
 };
 
+// packages/text2sql/src/lib/adapters/clickhouse/view.clickhouse.grounding.ts
+import { z as z8 } from "zod";
+
 // packages/text2sql/src/lib/adapters/groundings/view.grounding.ts
 var ViewGrounding = class extends AbstractGrounding {
   #filter;
@@ -1454,6 +1533,7 @@ var ViewGrounding = class extends AbstractGrounding {
 };
 
 // packages/text2sql/src/lib/adapters/clickhouse/view.clickhouse.grounding.ts
+var definitionRow = z8.object({ definition: z8.string() });
 var ClickHouseViewGrounding = class extends ViewGrounding {
   #adapter;
   constructor(adapter, config = {}) {
@@ -1461,14 +1541,17 @@ var ClickHouseViewGrounding = class extends ViewGrounding {
     this.#adapter = adapter;
   }
   async getAllViewNames() {
-    const rows = await this.#adapter.runQuery(`
+    const rows = await this.#adapter.runQuery(
+      `
       SELECT concat(database, '.', name) AS name
       FROM system.tables
       WHERE database NOT IN ('system', 'information_schema', 'INFORMATION_SCHEMA')
         AND is_temporary = 0
         AND endsWith(engine, 'View')
       ORDER BY database, name
-    `);
+    `,
+      nameRow
+    );
     return rows.map((row) => row.name);
   }
   async getView(viewName) {
@@ -1479,20 +1562,26 @@ var ClickHouseViewGrounding = class extends ViewGrounding {
       );
     }
     const [columns, definitionRows] = await Promise.all([
-      this.#adapter.runQuery(`
+      this.#adapter.runQuery(
+        `
         SELECT name, type
         FROM system.columns
         WHERE database = '${this.#adapter.escapeString(schema)}'
           AND table = '${this.#adapter.escapeString(table2)}'
         ORDER BY position
-      `),
-      this.includeDefinition ? this.#adapter.runQuery(`
+      `,
+        columnRow
+      ),
+      this.includeDefinition ? this.#adapter.runQuery(
+        `
             SELECT create_table_query AS definition
             FROM system.tables
             WHERE database = '${this.#adapter.escapeString(schema)}'
               AND name = '${this.#adapter.escapeString(table2)}'
               AND endsWith(engine, 'View')
-          `) : Promise.resolve([])
+          `,
+        definitionRow
+      ) : Promise.resolve([])
     ]);
     return {
       name: viewName,