@deepagents/text2sql 4.1.0 → 4.2.1

package/dist/lib/sql-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-command.d.ts","sourceRoot":"","sources":["../../src/lib/sql-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,WAAW,CAAC;AAcrE,OAAO,EAAE,QAAQ,EAA2B,MAAM,UAAU,CAAC;AAyB7D,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAuBxB"}
+{"version":3,"file":"sql-command.d.ts","sourceRoot":"","sources":["../../src/lib/sql-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,WAAW,CAAC;AAYrE,OAAO,EAAE,QAAQ,EAA2B,MAAM,UAAU,CAAC;AAsB7D,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAuBxB"}

package/dist/lib/sql-invocation.d.ts

@@ -0,0 +1,15 @@
+export type SqlQuerySubcommand = 'run' | 'validate';
+export interface SqlQueryInvocation {
+    subcommand: SqlQuerySubcommand;
+    dbName: string;
+    sql: string;
+}
+/**
+ * Parse a single `sql run|validate <db> "<sql>"` command into its parts, or
+ * `null` for anything that is not exactly one such invocation (pipelines,
+ * redirections, other commands, unparseable input). Shared by the meta hook
+ * (which tracks invocations to attach formatted-SQL metadata) and the
+ * validate-before-run reminder predicate.
+ */
+export declare function parseSqlQueryInvocation(command: string): SqlQueryInvocation | null;
+//# sourceMappingURL=sql-invocation.d.ts.map

package/dist/lib/sql-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-invocation.d.ts","sourceRoot":"","sources":["../../src/lib/sql-invocation.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd,kBAAkB,GAAG,IAAI,CAgB3B"}

package/dist/lib/sql-meta-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-meta-hook.d.ts","sourceRoot":"","sources":["../../src/lib/sql-meta-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAS/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB;AAUD,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,wBAAwB;qCAInC,iBAAiB,GAAG,IAAI;iCAQ5B,qBAAqB;EAwBrD"}
+{"version":3,"file":"sql-meta-hook.d.ts","sourceRoot":"","sources":["../../src/lib/sql-meta-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAS/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,wBAAwB;qCAInC,iBAAiB,GAAG,IAAI;iCAQ5B,qBAAqB;EAoBrD"}

package/dist/lib/sql-validate-reminder.d.ts

@@ -0,0 +1,22 @@
+import { type WhenPredicate } from '@deepagents/context';
+export declare const SQL_VALIDATE_REMINDER = "Always run `sql validate <db> \"...\"` before `sql run <db> \"...\"` to catch syntax errors early.";
+/**
+ * Fires when the tool call being wrapped is a `sql run` that was NOT preceded
+ * by a `sql validate` of the same query. Reads the live call from
+ * `ctx.executingTool` (only populated at `target: 'tool-output'` time) and scans
+ * `ctx.lastAssistantMessages` for a matching prior validate.
+ */
+export declare function sqlRunMissingValidate(): WhenPredicate;
+/**
+ * A context fragment nudging the model to `sql validate` before `sql run`.
+ * Register it on the engine alongside schema fragments:
+ *
+ * ```ts
+ * context.set(...schemaFragments, sqlValidateReminder());
+ * ```
+ *
+ * Delivered as a tool-output `<system-reminder>` on the `sql run` result, and
+ * suppressed when the model already validated that exact query.
+ */
+export declare function sqlValidateReminder(): import("@deepagents/context").ContextFragment<import("@deepagents/context").FragmentData>;
+//# sourceMappingURL=sql-validate-reminder.d.ts.map

package/dist/lib/sql-validate-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-validate-reminder.d.ts","sourceRoot":"","sources":["../../src/lib/sql-validate-reminder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,qBAAqB,CAAC;AAQnE,eAAO,MAAM,qBAAqB,uGACgE,CAAC;AAuCnG;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAQrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,8FAKlC"}

package/dist/lib/sql.d.ts

@@ -33,11 +33,36 @@ export declare class Text2SqlUnknownAdapterError extends Error {
     constructor(adapter: string, available: readonly string[]);
     static isInstance(error: unknown): error is Text2SqlUnknownAdapterError;
 }
+declare const text2SqlUnknownDatabaseMarker: unique symbol;
+/**
+ * Thrown by {@link Text2Sql.resolveAdapterName} when a user-supplied `<db>`
+ * token cannot be routed to an adapter (unknown name, or none given when more
+ * than one is configured). Carries the requested token and the available names
+ * so each port (CLI, sandbox command, JSON-RPC, MCP) can render it its own way.
+ */
+export declare class Text2SqlUnknownDatabaseError extends Error {
+    [text2SqlUnknownDatabaseMarker]: true;
+    readonly requested: string | undefined;
+    readonly available: readonly string[];
+    constructor(requested: string | undefined, available: readonly string[]);
+    static isInstance(error: unknown): error is Text2SqlUnknownDatabaseError;
+}
 export declare class Text2Sql {
     #private;
     constructor(config: Text2SqlConfig);
     adapterNames(): string[];
     hasAdapter(name: string): boolean;
+    /**
+     * Resolve a user-supplied `<db>` token to a configured adapter name for the
+     * surfaces that accept one (CLI, sandbox `sql` command, JSON-RPC daemon, MCP):
+     * - exact match → that name
+     * - no match (or omitted) but exactly one adapter configured → route to it
+     * - otherwise → throw with the user-facing "unknown database" message
+     *
+     * Internal execution paths keep using the strict {@link Text2Sql.run}/
+     * {@link Text2Sql.validate}, which reject an unknown name outright.
+     */
+    resolveAdapterName(db: string): string;
     validate(name: string, sql: string): Promise<string>;
     run(name: string, sql: string): Promise<Text2SqlRunResult>;
     index(options?: Text2SqlIndexOptions): Promise<ContextFragment[]>;

package/dist/lib/sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/lib/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,QAAA,MAAM,wBAAwB,eAAoC,CAAC;AACnE,QAAA,MAAM,4BAA4B,eAAwC,CAAC;AAE3E,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,CAAC,wBAAwB,CAAC,EAAE,IAAI,CAAC;gBAErB,OAAO,EAAE,MAAM;IAM3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB;CAMpE;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,CAAC,4BAA4B,CAAC,EAAE,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE;IASzD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,2BAA2B;CAMxE;AAED,qBAAa,QAAQ;;gBAIP,MAAM,EAAE,cAAc;IA8BlC,YAAY,IAAI,MAAM,EAAE;IAIxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkB1D,KAAK,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOrE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa1D,OAAO,CAAC,CAAC,SAAS,YAAY,EAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,GAC/B,OAAO,CAAC,aAAa,EAAE,CAAC;CAK5B"}
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/lib/sql.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepagents/text2sql",
-  "version": "4.1.0",
+  "version": "4.2.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -84,35 +84,33 @@
     "access": "public"
   },
   "dependencies": {
-    "@ai-sdk/groq": "^3.0.36",
-    "@ai-sdk/openai": "^3.0.49",
-    "@deepagents/agent": "4.1.0",
-    "@deepagents/context": "4.1.0",
-    "@deepagents/evals": "4.1.0",
+    "@ai-sdk/groq": "^3.0.47",
+    "@deepagents/agent": "4.2.1",
+    "@deepagents/context": "4.2.1",
     "@google-cloud/bigquery": "8.3.0",
-    "ai": "^6.0.174",
-    "autoevals": "0.0.132",
+    "ai": "^6.0.218",
     "bash-tool": "^1.3.16",
     "cac": "7.0.0",
     "dedent": "1.7.0",
     "just-bash": "^3.0.1",
     "nano-spawn": "^1.0.3",
     "node-sql-parser": "^5.4.0",
-    "openai": "5.12.2",
     "p-limit": "^6.2.0",
     "p-retry": "^7.1.1",
     "proper-lockfile": "^4.1.2",
     "sql-formatter": "^15.7.3",
     "uuid": "^13.0.0",
     "xlsx": "^0.18.5",
-    "zod": "^3.25.76 || ^4.0.0",
-    "@ai-sdk/react": "3.0.176"
+    "zod": "^3.25.76 || ^4.0.0"
   },
   "devDependencies": {
-    "@ai-sdk/react": "^3.0.176",
+    "@ai-sdk/openai": "^3.0.80",
+    "@ai-sdk/react": "^3.0.220",
+    "@deepagents/evals": "4.2.1",
     "@google-cloud/bigquery": "^8.3.0",
     "@types/proper-lockfile": "^4.1.4",
-    "autoevals": "^0.0.132"
+    "autoevals": "^0.0.132",
+    "openai": "5.12.2"
   },
   "peerDependencies": {
     "mssql": "^12.5.2",

package/dist/lib/resolve-adapter.d.ts

@@ -1,14 +0,0 @@
-import { type Text2Sql } from './sql.ts';
-/**
- * Resolve a requested `<db>` token to a configured adapter name. Shared by the
- * virtual-sandbox `sql` command and the `sql` CLI so both surfaces behave
- * identically:
- * - exact match → that name
- * - no match but exactly one adapter configured → route to it (silently)
- * - otherwise → throw with the user-facing "unknown database" message
- *
- * `db` is assumed non-empty; callers handle the missing-argument case (their
- * usage strings differ).
- */
-export declare function resolveAdapter(text2Sql: Text2Sql, db: string): string;
-//# sourceMappingURL=resolve-adapter.d.ts.map

package/dist/lib/resolve-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrE"}