@deepagents/text2sql 0.37.0 → 0.37.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +10 -1
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -100,6 +100,11 @@ The adapter-map key (`main` here) is the adapter name. Reuse that same key in
100
100
  `text2sql.toSql(..., 'main')` and in any `sql validate <db> "..."` /
101
101
  `sql run <db> "..."` sandbox calls.
102
102
 
103
+ Adapter names must match `/^[A-Za-z_][A-Za-z0-9_]*$/`. If you build adapter
104
+ maps dynamically, use `isValidAdapterName(name)` to check one key or
105
+ `validateAdapterNames(names)` to fail fast before constructing `Text2Sql` or
106
+ `sqlSandboxExtension`.
107
+
103
108
  ## AI Model Providers
104
109
 
105
110
  Text2SQL works with any model provider supported by the [Vercel AI SDK](https://sdk.vercel.ai/docs), including OpenAI, Anthropic, Google, Groq, and more.
@@ -111,7 +116,8 @@ returns a `SandboxExtension` that bundles the `sql` subcommand, transform
111
116
  plugins, and arg-repair hook. In the simplest case, that map is
112
117
  `{ main: adapter }`. Compose it (alongside any of your own extensions) via
113
118
  `createBashTool` + `createRoutingSandbox` + `createVirtualSandbox`.
114
- See [sqlv3.md](./sqlv3.md) for composition patterns.
119
+ See [Caller-Owned Sandbox](https://januarylabs.github.io/deepagents/docs/text2sql/sqlv3)
120
+ for composition patterns.
115
121
 
116
122
  ## Fragments
117
123
 
@@ -203,6 +209,9 @@ write messages, titles, or usage into your context store.
203
209
 
204
210
  ## Direct SQL Generation with Extra Fragments
205
211
 
212
+ This lower-level helper still takes a single `adapter` because it bypasses the
213
+ multi-adapter `Text2Sql` wrapper entirely.
214
+
206
215
  ```typescript
207
216
  import { term } from '@deepagents/context';
208
217
  import { toSql } from '@deepagents/text2sql';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepagents/text2sql",
3
- "version": "0.37.0",
3
+ "version": "0.37.1",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -84,9 +84,9 @@
84
84
  "@ai-sdk/groq": "^3.0.36",
85
85
  "@ai-sdk/openai": "^3.0.49",
86
86
  "ai": "^6.0.169",
87
- "@deepagents/agent": "0.37.0",
88
- "@deepagents/context": "0.37.0",
89
- "@deepagents/evals": "0.37.0",
87
+ "@deepagents/agent": "0.37.1",
88
+ "@deepagents/context": "0.37.1",
89
+ "@deepagents/evals": "0.37.1",
90
90
  "@google-cloud/bigquery": "8.1.1",
91
91
  "autoevals": "0.0.132",
92
92
  "bash-tool": "^1.3.16",