@deepagents/text2sql 0.38.0 → 0.38.1

package/README.md

@@ -17,6 +17,15 @@ AI-powered natural language to SQL. Ask questions in plain English, get executab
 npm install @deepagents/text2sql
 ```
 
+Install the database driver or client library that matches your adapter:
+
+```bash
+npm install pg                       # PostgreSQL
+npm install mssql                    # SQL Server
+npm install mysql2                   # MySQL / MariaDB
+npm install @google-cloud/bigquery   # BigQuery
+```
+
 Requires Node.js LTS (20+).
 
 ## Quick Start
@@ -187,7 +196,7 @@ Control what schema metadata the AI receives:
 
 ## Conversations
 
-`chat()` persists history through the `ContextEngine` returned by your `context` factory. Reuse the same store, `chatId`, and `userId` to continue the same thread:
+`chat()` persists history through the `ContextEngine` returned by your `context` factory. Reuse the same store, `chatId`, and `userId` to continue the same thread. Pass only the new incoming message(s) for the current turn; do not replay earlier turns that are already stored in the context store:
 
 ```typescript
 const stream = await text2sql.chat([

package/dist/index.js

@@ -5392,22 +5392,24 @@ var Text2Sql = class {
     const producer = factory(adapter);
     return producer.toPairs();
   }
-  async chat(messages, options) {
-    if (messages.length === 0) {
-      throw new Error("messages must not be empty");
-    }
+  async chat(options) {
     return createUIMessageStream({
       execute: async ({ writer }) => {
+        const context = this.#config.context;
+        const head = await context.headMessage();
+        if (!head || head.name !== "assistant") {
+          throw new Error(
+            "text2sql.chat: expected head to be an assistant message \u2014 call context.continue() before chat()"
+          );
+        }
+        writer.write({ type: "start", messageId: head.id });
         const progress = (event) => {
           writer.write({
             type: TEXT2SQL_INDEX_PROGRESS_CHUNK,
             data: event
           });
         };
-        const context = this.#config.context(
-          ...guidelines(),
-          ...await this.#index(progress)
-        );
+        context.set(...guidelines(), ...await this.#index(progress));
         const chatAgent = agent2({
           name: "text2sql",
           sandbox: this.#config.sandbox,
@@ -5417,7 +5419,7 @@ var Text2Sql = class {
           guardrails: [errorRecoveryGuardrail],
           maxGuardrailRetries: 3
         });
-        const chatStream = await chat(chatAgent, messages, {
+        const chatStream = await chat(chatAgent, {
           abortSignal: options?.abortSignal,
           generateTitle: options?.generateTitle,
           transform: this.#config.transform