@deepagents/text2sql 1.0.0 → 2.2.0

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

@@ -0,0 +1,32 @@
+import type { Command } from 'just-bash';
+import { Text2Sql } from './sql.ts';
+export interface CreateSqlCommandOptions {
+    /**
+     * Default directory for `sql run` / `sql index` artifacts when no `--out-dir`
+     * is passed and `$TEXT2SQL_OUT_DIR` is unset. Defaults to `/sql`.
+     */
+    outputDir?: string;
+}
+export interface CreateSqlCommandResult {
+    command: Command;
+    repair: (raw: string) => string;
+}
+/**
+ * Wrap a {@link Text2Sql} instance as a just-bash custom command, exposing
+ * `sql run`, `sql validate`, and `sql index` inside any sandbox that accepts
+ * `customCommands` (e.g. `createVirtualSandbox`). Argv matches the standalone
+ * `sql` CLI exactly, so prompts written against one work against the other.
+ *
+ * @example
+ * ```ts
+ * const text2Sql = new Text2Sql({ adapters: { pagila } });
+ * const { command } = createSqlCommand(text2Sql);
+ * const sandbox = await createVirtualSandbox({
+ *   fs: new InMemoryFs(),
+ *   customCommands: [command],
+ * });
+ * await sandbox.executeCommand('sql run pagila "SELECT 1"');
+ * ```
+ */
+export declare function createSqlCommand(text2Sql: Text2Sql, options?: CreateSqlCommandOptions): CreateSqlCommandResult;
+//# sourceMappingURL=sql-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-command.d.ts","sourceRoot":"","sources":["../../src/lib/sql-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,WAAW,CAAC;AAYrE,OAAO,EACL,QAAQ,EAGT,MAAM,UAAU,CAAC;AAclB,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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA6BxB"}

package/dist/lib/sql.d.ts

@@ -1,21 +1,45 @@
 import { type AgentModel } from '@deepagents/agent';
+import type { ContextFragment } from '@deepagents/context';
+import { type Text2SqlIndexProgressHandler } from './adapter-index.ts';
 import { type Adapter } from './adapters/adapter.ts';
 import { type ExtractedPair, type PairProducer } from './synthesis/types.ts';
 export interface Text2SqlConfig {
     adapters: Record<string, Adapter>;
-    version: string;
-    model: AgentModel;
+    version?: string;
+    model?: AgentModel;
+}
+export interface Text2SqlRunResult {
+    rows: unknown[];
+    columns: string[];
+}
+export interface Text2SqlIndexOptions {
+    names?: readonly string[];
+    onProgress?: Text2SqlIndexProgressHandler;
+}
+declare const text2SqlValidationMarker: unique symbol;
+declare const text2SqlUnknownAdapterMarker: unique symbol;
+export declare class Text2SqlValidationError extends Error {
+    [text2SqlValidationMarker]: true;
+    constructor(message: string);
+    static isInstance(error: unknown): error is Text2SqlValidationError;
+}
+export declare class Text2SqlUnknownAdapterError extends Error {
+    [text2SqlUnknownAdapterMarker]: true;
+    readonly adapter: string;
+    readonly available: readonly string[];
+    constructor(adapter: string, available: readonly string[]);
+    static isInstance(error: unknown): error is Text2SqlUnknownAdapterError;
 }
-/**
- * Stateless `toSql` for one or more configured adapters.
- * Build the streaming chat agent yourself with `agent` + `chat` from
- * `@deepagents/context`, passing `instructions()` and fragments from
- * `AdapterIndexer` into the engine.
- */
 export declare class Text2Sql {
     #private;
     constructor(config: Text2SqlConfig);
+    adapterNames(): string[];
+    hasAdapter(name: string): boolean;
+    validate(name: string, sql: string): Promise<string>;
+    run(name: string, sql: string): Promise<Text2SqlRunResult>;
+    index(options?: Text2SqlIndexOptions): Promise<ContextFragment[]>;
     toSql(input: string, adapterName: string): Promise<string>;
     toPairs<T extends PairProducer>(adapterName: string, factory: (adapter: Adapter) => T): Promise<ExtractedPair[]>;
 }
+export {};
 //# sourceMappingURL=sql.d.ts.map

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;AAIpD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,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,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,QAAQ;;gBAIP,MAAM,EAAE,cAAc;IAsBrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D,OAAO,CAAC,CAAC,SAAS,YAAY,EACzC,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":"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,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;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;IA6BlC,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"}