@deepagents/text2sql 0.32.0 → 0.33.0

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

@@ -1,18 +1,17 @@
 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 ColumnValuesGroundingConfig } from '../groundings/column-values.grounding.ts';
-import { ReportGrounding, type ReportGroundingConfig } from '../groundings/report.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 { SqliteColumnStatsGrounding } from './column-stats.sqlite.grounding.ts';
+import { SqliteColumnValuesGrounding } from './column-values.sqlite.grounding.ts';
 import { SqliteConstraintGrounding } from './constraint.sqlite.grounding.ts';
 import { SqliteIndexesGrounding } from './indexes.sqlite.grounding.ts';
 import { SqliteInfoGrounding } from './info.sqlite.grounding.ts';
-import { SqliteColumnValuesGrounding } from './column-values.sqlite.grounding.ts';
 import { SqliteRowCountGrounding } from './row-count.sqlite.grounding.ts';
 import { Sqlite } from './sqlite.ts';
 import { SqliteTableGrounding } from './table.sqlite.grounding.ts';
@@ -26,7 +25,6 @@ export declare function columnValues(config?: ColumnValuesGroundingConfig): (ada
 export declare function indexes(config?: IndexesGroundingConfig): (adapter: Adapter) => SqliteIndexesGrounding;
 export declare function rowCount(config?: RowCountGroundingConfig): (adapter: Adapter) => SqliteRowCountGrounding;
 export declare function constraints(config?: ConstraintGroundingConfig): (adapter: Adapter) => SqliteConstraintGrounding;
-export declare function report(config?: ReportGroundingConfig): (adapter: Adapter) => ReportGrounding;
 declare const _default: {
     tables: typeof tables;
     info: typeof info;
@@ -36,7 +34,6 @@ declare const _default: {
     indexes: typeof indexes;
     rowCount: typeof rowCount;
     constraints: typeof constraints;
-    report: typeof report;
     Sqlite: typeof Sqlite;
 };
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,cAAc,aAAa,CAAC;AAE5B,wBAAgB,MAAM,CAAC,MAAM,GAAE,oBAAyB,IAC9C,SAAS,OAAO,0BACzB;AAED,wBAAgB,IAAI,CAAC,MAAM,GAAE,mBAAwB,IAC3C,SAAS,OAAO,yBACzB;AAED,wBAAgB,KAAK,CAAC,MAAM,GAAE,mBAAwB,IAC5C,SAAS,OAAO,yBAGzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,0BAA+B,IACzD,SAAS,OAAO,gCAGzB;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAE,2BAAgC,IAC3D,SAAS,OAAO,iCAGzB;AAED,wBAAgB,OAAO,CAAC,MAAM,GAAE,sBAA2B,IACjD,SAAS,OAAO,4BAGzB;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAE,uBAA4B,IACnD,SAAS,OAAO,6BAGzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,yBAA8B,IACxD,SAAS,OAAO,+BAGzB;AAED,wBAAgB,MAAM,CAAC,MAAM,GAAE,qBAA0B,IAC/C,SAAS,OAAO,qBACzB;;;;;;;;;;;;;AAED,wBAWE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,cAAc,aAAa,CAAC;AAE5B,wBAAgB,MAAM,CAAC,MAAM,GAAE,oBAAyB,IAC9C,SAAS,OAAO,0BACzB;AAED,wBAAgB,IAAI,CAAC,MAAM,GAAE,mBAAwB,IAC3C,SAAS,OAAO,yBACzB;AAED,wBAAgB,KAAK,CAAC,MAAM,GAAE,mBAAwB,IAC5C,SAAS,OAAO,yBAGzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,0BAA+B,IACzD,SAAS,OAAO,gCAGzB;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAE,2BAAgC,IAC3D,SAAS,OAAO,iCAGzB;AAED,wBAAgB,OAAO,CAAC,MAAM,GAAE,sBAA2B,IACjD,SAAS,OAAO,4BAGzB;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAE,uBAA4B,IACnD,SAAS,OAAO,6BAGzB;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,yBAA8B,IACxD,SAAS,OAAO,+BAGzB;;;;;;;;;;;;AAED,wBAUE"}

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

@@ -346,9 +346,6 @@ var Adapter = class {
         this.#relationshipToFragment(rel, sourceTable, targetTable)
       );
     }
-    if (ctx.report) {
-      fragments.push({ name: "businessContext", data: ctx.report });
-    }
     return fragments;
   }
   /**
@@ -658,64 +655,6 @@ var ColumnStatsGrounding = class extends AbstractGrounding {
   }
 };
 
-// packages/text2sql/src/lib/adapters/groundings/constraint.grounding.ts
-var ConstraintGrounding = class extends AbstractGrounding {
-  constructor(config = {}) {
-    super("constraint");
-  }
-  /**
-   * Execute the grounding process.
-   * Annotates tables in ctx.tables with their constraints.
-   */
-  async execute(ctx) {
-    for (const table2 of ctx.tables) {
-      try {
-        table2.constraints = await this.getConstraints(table2.name);
-      } catch (error) {
-        console.warn("Error collecting constraints for", table2.name, error);
-      }
-    }
-  }
-};
-
-// packages/text2sql/src/lib/adapters/groundings/indexes.grounding.ts
-var IndexesGrounding = class extends AbstractGrounding {
-  constructor(config = {}) {
-    super("index");
-  }
-  /**
-   * Execute the grounding process.
-   * Annotates tables in ctx.tables with their indexes and marks indexed columns.
-   */
-  async execute(ctx) {
-    for (const table2 of ctx.tables) {
-      table2.indexes = await this.getIndexes(table2.name);
-      for (const index2 of table2.indexes ?? []) {
-        for (const colName of index2.columns) {
-          const column2 = table2.columns.find((c) => c.name === colName);
-          if (column2) {
-            column2.isIndexed = true;
-          }
-        }
-      }
-    }
-  }
-};
-
-// packages/text2sql/src/lib/adapters/groundings/info.grounding.ts
-var InfoGrounding = class extends AbstractGrounding {
-  constructor(config = {}) {
-    super("dialectInfo");
-  }
-  /**
-   * Execute the grounding process.
-   * Writes database info to ctx.info.
-   */
-  async execute(ctx) {
-    ctx.info = await this.collectInfo();
-  }
-};
-
 // packages/text2sql/src/lib/adapters/groundings/column-values.grounding.ts
 var ColumnValuesGrounding = class extends AbstractGrounding {
   lowCardinalityLimit;
@@ -855,103 +794,61 @@ var ColumnValuesGrounding = class extends AbstractGrounding {
   }
 };
 
-// packages/text2sql/src/lib/adapters/groundings/report.grounding.ts
-import { groq } from "@ai-sdk/groq";
-import { tool } from "ai";
-import dedent from "dedent";
-import z from "zod";
-import "@deepagents/agent";
-import {
-  ContextEngine,
-  InMemoryContextStore,
-  agent,
-  fragment,
-  persona,
-  user
-} from "@deepagents/context";
-var ReportGrounding = class extends AbstractGrounding {
-  #adapter;
-  #model;
-  #cache;
-  #forceRefresh;
-  constructor(adapter, config = {}) {
-    super("business_context");
-    this.#adapter = adapter;
-    this.#model = config.model ?? groq("openai/gpt-oss-20b");
-    this.#cache = config.cache;
-    this.#forceRefresh = config.forceRefresh ?? false;
+// packages/text2sql/src/lib/adapters/groundings/constraint.grounding.ts
+var ConstraintGrounding = class extends AbstractGrounding {
+  constructor(config = {}) {
+    super("constraint");
   }
+  /**
+   * Execute the grounding process.
+   * Annotates tables in ctx.tables with their constraints.
+   */
   async execute(ctx) {
-    if (!this.#forceRefresh && this.#cache) {
-      const cached = await this.#cache.get();
-      if (cached) {
-        ctx.report = cached;
-        return;
+    for (const table2 of ctx.tables) {
+      try {
+        table2.constraints = await this.getConstraints(table2.name);
+      } catch (error) {
+        console.warn("Error collecting constraints for", table2.name, error);
       }
     }
-    const report2 = await this.#generateReport();
-    ctx.report = report2;
-    if (this.#cache) {
-      await this.#cache.set(report2);
-    }
   }
-  async #generateReport() {
-    const context = new ContextEngine({
-      store: new InMemoryContextStore(),
-      chatId: `report-gen-${crypto.randomUUID()}`,
-      userId: "system"
-    });
-    context.set(
-      persona({
-        name: "db-report-agent",
-        role: "Database analyst",
-        objective: "Analyze the database and write a contextual report about what it represents"
-      }),
-      fragment(
-        "instructions",
-        dedent`
-          Write a business context that helps another agent answer questions accurately.
-
-          For EACH table, do queries ONE AT A TIME:
-          1. SELECT COUNT(*) to get row count
-          2. SELECT * LIMIT 3 to see sample data
-
-          Then write a report with:
-          - What business this database is for
-          - For each table: purpose, row count, and example of what the data looks like
-
-          Include concrete examples like "Track prices are $0.99",
-          "Customer names like 'Luís Gonçalves'", etc.
+};
 
-          Keep it 400-600 words, conversational style.
-        `
-      ),
-      user(
-        "Please analyze the database and write a contextual report about what this database represents."
-      )
-    );
-    const adapter = this.#adapter;
-    const reportAgent = agent({
-      name: "db-report-agent",
-      model: this.#model,
-      context,
-      tools: {
-        query_database: tool({
-          description: "Execute a SELECT query to explore the database and gather insights.",
-          inputSchema: z.object({
-            sql: z.string().describe("The SELECT query to execute"),
-            purpose: z.string().describe(
-              "What insight you are trying to gather with this query"
-            )
-          }),
-          execute: ({ sql }) => {
-            return adapter.execute(sql);
+// packages/text2sql/src/lib/adapters/groundings/indexes.grounding.ts
+var IndexesGrounding = class extends AbstractGrounding {
+  constructor(config = {}) {
+    super("index");
+  }
+  /**
+   * Execute the grounding process.
+   * Annotates tables in ctx.tables with their indexes and marks indexed columns.
+   */
+  async execute(ctx) {
+    for (const table2 of ctx.tables) {
+      table2.indexes = await this.getIndexes(table2.name);
+      for (const index2 of table2.indexes ?? []) {
+        for (const colName of index2.columns) {
+          const column2 = table2.columns.find((c) => c.name === colName);
+          if (column2) {
+            column2.isIndexed = true;
           }
-        })
+        }
       }
-    });
-    const result = await reportAgent.generate({});
-    return result.text;
+    }
+  }
+};
+
+// packages/text2sql/src/lib/adapters/groundings/info.grounding.ts
+var InfoGrounding = class extends AbstractGrounding {
+  constructor(config = {}) {
+    super("dialectInfo");
+  }
+  /**
+   * Execute the grounding process.
+   * Writes database info to ctx.info.
+   */
+  async execute(ctx) {
+    ctx.info = await this.collectInfo();
   }
 };
 
@@ -1186,6 +1083,60 @@ var SqliteColumnStatsGrounding = class extends ColumnStatsGrounding {
   }
 };
 
+// packages/text2sql/src/lib/adapters/sqlite/column-values.sqlite.grounding.ts
+var SqliteColumnValuesGrounding = class extends ColumnValuesGrounding {
+  #adapter;
+  constructor(adapter, config = {}) {
+    super(config);
+    this.#adapter = adapter;
+  }
+  async collectLowCardinality(tableName, column2) {
+    const tableIdentifier = this.#adapter.quoteIdentifier(tableName);
+    const columnIdentifier = this.#adapter.quoteIdentifier(column2.name);
+    const limit = this.lowCardinalityLimit + 1;
+    const sql = `
+      SELECT DISTINCT ${columnIdentifier} AS value
+      FROM ${tableIdentifier}
+      WHERE ${columnIdentifier} IS NOT NULL
+      LIMIT ${limit}
+    `;
+    const rows = await this.#adapter.runQuery(sql);
+    if (!rows.length || rows.length > this.lowCardinalityLimit) {
+      return void 0;
+    }
+    const values = [];
+    for (const row of rows) {
+      const formatted = this.#normalizeValue(row.value);
+      if (formatted == null) {
+        return void 0;
+      }
+      values.push(formatted);
+    }
+    return values.length ? values : void 0;
+  }
+  #normalizeValue(value) {
+    if (value === null || value === void 0) {
+      return null;
+    }
+    if (typeof value === "string") {
+      return value;
+    }
+    if (typeof value === "number" || typeof value === "bigint") {
+      return String(value);
+    }
+    if (typeof value === "boolean") {
+      return value ? "true" : "false";
+    }
+    if (value instanceof Date) {
+      return value.toISOString();
+    }
+    if (typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
+      return value.toString("utf-8");
+    }
+    return null;
+  }
+};
+
 // packages/text2sql/src/lib/adapters/sqlite/constraint.sqlite.grounding.ts
 var SqliteConstraintGrounding = class extends ConstraintGrounding {
   #adapter;
@@ -1365,60 +1316,6 @@ var SqliteInfoGrounding = class extends InfoGrounding {
   }
 };
 
-// packages/text2sql/src/lib/adapters/sqlite/column-values.sqlite.grounding.ts
-var SqliteColumnValuesGrounding = class extends ColumnValuesGrounding {
-  #adapter;
-  constructor(adapter, config = {}) {
-    super(config);
-    this.#adapter = adapter;
-  }
-  async collectLowCardinality(tableName, column2) {
-    const tableIdentifier = this.#adapter.quoteIdentifier(tableName);
-    const columnIdentifier = this.#adapter.quoteIdentifier(column2.name);
-    const limit = this.lowCardinalityLimit + 1;
-    const sql = `
-      SELECT DISTINCT ${columnIdentifier} AS value
-      FROM ${tableIdentifier}
-      WHERE ${columnIdentifier} IS NOT NULL
-      LIMIT ${limit}
-    `;
-    const rows = await this.#adapter.runQuery(sql);
-    if (!rows.length || rows.length > this.lowCardinalityLimit) {
-      return void 0;
-    }
-    const values = [];
-    for (const row of rows) {
-      const formatted = this.#normalizeValue(row.value);
-      if (formatted == null) {
-        return void 0;
-      }
-      values.push(formatted);
-    }
-    return values.length ? values : void 0;
-  }
-  #normalizeValue(value) {
-    if (value === null || value === void 0) {
-      return null;
-    }
-    if (typeof value === "string") {
-      return value;
-    }
-    if (typeof value === "number" || typeof value === "bigint") {
-      return String(value);
-    }
-    if (typeof value === "boolean") {
-      return value ? "true" : "false";
-    }
-    if (value instanceof Date) {
-      return value.toISOString();
-    }
-    if (typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
-      return value.toString("utf-8");
-    }
-    return null;
-  }
-};
-
 // packages/text2sql/src/lib/adapters/sqlite/row-count.sqlite.grounding.ts
 var SqliteRowCountGrounding = class extends RowCountGrounding {
   #adapter;
@@ -1729,9 +1626,6 @@ function constraints(config = {}) {
     return new SqliteConstraintGrounding(adapter, config);
   };
 }
-function report(config = {}) {
-  return (adapter) => new ReportGrounding(adapter, config);
-}
 var sqlite_default = {
   tables,
   info,
@@ -1741,7 +1635,6 @@ var sqlite_default = {
   indexes,
   rowCount,
   constraints,
-  report,
   Sqlite
 };
 export {
@@ -1753,7 +1646,6 @@ export {
   formatError,
   indexes,
   info,
-  report,
   rowCount,
   tables,
   views