@deepagents/text2sql 4.2.1 → 5.0.0

package/README.md

@@ -184,9 +184,13 @@ model must pass to `sql validate <db>` and `sql run <db>`. Add or replace the
 instructions with your own domain fragments as needed.
 
 `sqlValidateReminder()` returns a context reminder fragment backed by
-`SQL_VALIDATE_REMINDER`. It adds a tool-output system reminder when the current
-assistant turn calls `sql run <db> "..."` without a prior `sql validate <db>
-"..."` for the same configured adapter name and exact SQL text.
+`SQL_VALIDATE_REMINDER`. After a successful `sql run <db> "..."`, it adds a
+model-only tool-output reminder before the next generation when no prior
+`sql validate <db> "..."` used the same configured adapter name and exact SQL
+text. The raw SQL command result remains unchanged. During streamed `chat()`
+turns, the reminder is persisted as a synthetic user message for replay and
+prompt caching; bare `createPrepareStep()` integrations and
+`agent.generate()` own persistence of their generated assistant history.
 
 ## Advanced: SQL CLI in Sandboxes
 

package/dist/index.js

@@ -4683,9 +4683,6 @@ Action: Ask user: "Top by what metric\u2014total revenue, number of orders, or m
   return baseTeachings;
 }
 
-// packages/text2sql/src/lib/sql-meta-hook.ts
-import { useBashMeta } from "@deepagents/context";
-
 // packages/text2sql/src/lib/sql-invocation.ts
 import { parse } from "just-bash";
 import { asStaticWordText } from "@deepagents/context";
@@ -4758,12 +4755,12 @@ function createSqlMetaHook({ adapters }) {
       const adapter = adapters[invocation.dbName];
       if (!adapter) return void 0;
       try {
-        useBashMeta()?.setHidden({
-          formattedSql: adapter.format(invocation.sql)
-        });
+        return {
+          meta: { formattedSql: adapter.format(invocation.sql) }
+        };
       } catch {
+        return void 0;
       }
-      return void 0;
     }
   };
 }
@@ -4810,7 +4807,10 @@ import { BashTransformPipeline } from "just-bash";
 import { parse as parse2, serialize } from "just-bash";
 import { createHash as createHash4 } from "node:crypto";
 import * as path6 from "node:path";
-import { BashException, asStaticWordText as asStaticWordText2 } from "@deepagents/context";
+import {
+  BashException,
+  asStaticWordText as asStaticWordText2
+} from "@deepagents/context";
 function isScriptNode(value) {
   if (typeof value !== "object" || value === null) {
     return false;
@@ -5925,8 +5925,10 @@ function alreadyValidated(messages, run) {
 }
 function sqlRunMissingValidate() {
   return (ctx) => {
-    const call = ctx.executingTool;
-    if (!call || call.name !== "bash") return false;
+    const call = ctx.toolOutcome;
+    if (!call || call.state !== "output-available" || call.name !== "bash") {
+      return false;
+    }
     const run = extractSqlInvocation(inputCommand(call.input));
     if (run?.subcommand !== "run") return false;
     return !alreadyValidated(ctx.lastAssistantMessages, run);