@deepagents/text2sql 0.8.1 → 0.10.0

package/dist/lib/adapters/postgres/info.postgres.grounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info.postgres.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/postgres/info.postgres.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;;gBAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,mBAAwB;cAKrC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAc7D"}
+{"version":3,"file":"info.postgres.grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/postgres/info.postgres.grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;;gBAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,mBAAwB;cAKrC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAiB7D"}

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

@@ -0,0 +1,4 @@
+export { columnStats, columnValues, info, rowCount, tables, } from '../sqlite/index.ts';
+export { Spreadsheet, type SpreadsheetOptions } from './spreadsheet.ts';
+export { parseFile, sanitizeIdentifier, sanitizeTableName, type Column, type ColumnType, type ParsedSheet, } from './parser.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/spreadsheet/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,MAAM,GACP,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC"}

package/dist/lib/adapters/spreadsheet/parser.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Column type for SQLite.
+ */
+export type ColumnType = 'TEXT' | 'INTEGER' | 'REAL';
+/**
+ * Column definition with name and inferred type.
+ */
+export interface Column {
+    /** Sanitized column name for SQL */
+    name: string;
+    /** Original column name from spreadsheet (for data access) */
+    originalKey: string;
+    /** Inferred SQLite type */
+    type: ColumnType;
+}
+/**
+ * Parsed sheet with table name, columns, and row data.
+ */
+export interface ParsedSheet {
+    name: string;
+    columns: Column[];
+    rows: Record<string, unknown>[];
+}
+/**
+ * Parse an Excel or CSV/TSV file into sheets.
+ *
+ * - Excel files: each sheet becomes a ParsedSheet
+ * - CSV/TSV files: single ParsedSheet with filename as table name
+ */
+export declare function parseFile(filePath: string): ParsedSheet[];
+/**
+ * Sanitize a name to be a valid SQL table/column identifier.
+ * - Lowercase for consistency
+ * - Replace invalid chars with underscores
+ * - Ensure it doesn't start with a number
+ * - Trim and collapse multiple underscores
+ * - Truncate to 64 characters
+ */
+export declare function sanitizeIdentifier(name: string): string;
+export declare const sanitizeTableName: typeof sanitizeIdentifier;
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/adapters/spreadsheet/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/spreadsheet/parser.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAmDzD;AAWD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBvD;AAGD,eAAO,MAAM,iBAAiB,2BAAqB,CAAC"}

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

@@ -0,0 +1,52 @@
+import type { GroundingFn } from '../adapter.ts';
+import { Sqlite } from '../sqlite/sqlite.ts';
+/**
+ * Options for creating a Spreadsheet adapter.
+ */
+export interface SpreadsheetOptions {
+    /**
+     * Path to the spreadsheet file (Excel .xlsx/.xls or CSV/TSV).
+     */
+    file: string;
+    /**
+     * Optional path to persist the SQLite database.
+     * If not provided, uses in-memory database (':memory:').
+     */
+    database?: string;
+    /**
+     * Grounding functions to use for schema introspection.
+     */
+    grounding: GroundingFn[];
+}
+/**
+ * Spreadsheet adapter that loads Excel/CSV files into SQLite.
+ *
+ * This adapter:
+ * 1. Parses the spreadsheet file (Excel or CSV/TSV)
+ * 2. Creates a SQLite database (in-memory or file-based)
+ * 3. Creates tables from sheets and loads data
+ * 4. Delegates all SQL operations to the SQLite adapter
+ *
+ * @example
+ * ```typescript
+ * import { Spreadsheet, tables, info } from '@deepagents/text2sql/spreadsheet';
+ *
+ * const adapter = new Spreadsheet({
+ *   file: './sales.xlsx',
+ *   grounding: [tables(), info()]
+ * });
+ *
+ * const schema = await adapter.introspect();
+ * const results = await adapter.execute('SELECT * FROM Customers');
+ * ```
+ */
+export declare class Spreadsheet extends Sqlite {
+    #private;
+    constructor(options: SpreadsheetOptions);
+    /**
+     * Close the underlying SQLite database.
+     * Call this when done to release resources.
+     */
+    close(): void;
+}
+//# sourceMappingURL=spreadsheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheet.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/spreadsheet/spreadsheet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,SAAQ,MAAM;;gBAGzB,OAAO,EAAE,kBAAkB;IAwBvC;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd"}

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

@@ -344,6 +344,47 @@ import {
   toState,
   user
 } from "@deepagents/agent";
+var reportAgent = agent({
+  name: "db-report-agent",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: () => dedent`
+        <identity>
+          You are a database analyst expert. Your job is to understand what
+          a database represents and provide business context about it.
+          You have READ-ONLY access to the database.
+        </identity>
+
+        <instructions>
+          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.
+        </instructions>
+      `,
+  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 }, options) => {
+        const state = toState(options);
+        return state.adapter.execute(sql);
+      }
+    })
+  }
+});
 var ReportGrounding = class extends AbstractGrounding {
   #adapter;
   #model;
@@ -372,51 +413,8 @@ var ReportGrounding = class extends AbstractGrounding {
     return () => report2;
   }
   async #generateReport() {
-    const reportAgent = agent({
-      name: "db-report-agent",
-      model: this.#model,
-      prompt: () => dedent`
-        <identity>
-          You are a database analyst expert. Your job is to understand what
-          a database represents and provide business context about it.
-          You have READ-ONLY access to the database.
-        </identity>
-
-        <instructions>
-          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.
-        </instructions>
-      `,
-      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 }, options) => {
-            const state = toState(options);
-            return state.adapter.execute(sql);
-          }
-        })
-      }
-    });
     const { text } = await generate(
-      reportAgent,
+      reportAgent.clone({ model: this.#model }),
       [
         user(
           "Please analyze the database and write a contextual report about what this database represents."
@@ -961,7 +959,10 @@ var SqliteInfoGrounding = class extends InfoGrounding {
     );
     return {
       dialect: "sqlite",
-      version: rows[0]?.version
+      version: rows[0]?.version,
+      details: {
+        parameterPlaceholder: "?"
+      }
     };
   }
 };