@deepagents/text2sql 0.39.0 → 1.0.0

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

@@ -0,0 +1,35 @@
+import { type ContextFragment } from '@deepagents/context';
+import { type Adapter, type IntrospectionPhase } from './adapters/adapter.ts';
+export declare const TEXT2SQL_INDEX_PROGRESS_CHUNK = "data-text2sql-index-progress";
+export type Text2SqlIndexProgressEventType = 'index:start' | 'index:end' | 'adapter:start' | 'adapter:end' | 'adapter:cache-hit' | 'adapter:cache-miss' | 'phase:start' | 'phase:progress' | 'phase:end' | 'adapter:error' | 'index:error';
+export interface Text2SqlIndexProgressEvent {
+    type: Text2SqlIndexProgressEventType;
+    adapter?: string;
+    phase?: IntrospectionPhase;
+    table?: string;
+    message: string;
+    current?: number;
+    total?: number;
+    cached?: boolean;
+    timestampMs?: number;
+}
+export type Text2SqlIndexProgressHandler = (event: Text2SqlIndexProgressEvent) => void;
+export interface AdapterIndexerOptions {
+    adapters: Record<string, Adapter>;
+    version?: string;
+    cacheKey?: (adapterName: string) => string | undefined;
+}
+export interface AdapterIndexerIndexOptions {
+    adapterNames?: readonly string[];
+    onProgress?: Text2SqlIndexProgressHandler;
+}
+export interface AdapterIndexerAdapterOptions {
+    onProgress?: Text2SqlIndexProgressHandler;
+}
+export declare class AdapterIndexer {
+    #private;
+    constructor(options: AdapterIndexerOptions);
+    index(options?: AdapterIndexerIndexOptions): Promise<ContextFragment[]>;
+    indexAdapter(name: string, options?: AdapterIndexerAdapterOptions): Promise<ContextFragment[]>;
+}
+//# sourceMappingURL=adapter-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-index.d.ts","sourceRoot":"","sources":["../../src/lib/adapter-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,6BAA6B,iCAAiC,CAAC;AAE5E,MAAM,MAAM,8BAA8B,GACtC,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,4BAA4B,GAAG,CACzC,KAAK,EAAE,0BAA0B,KAC9B,IAAI,CAAC;AAEV,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAgBD,qBAAa,cAAc;;gBAKb,OAAO,EAAE,qBAAqB;IAYpC,KAAK,CACT,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,eAAe,EAAE,CAAC;IA+CvB,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,eAAe,EAAE,CAAC;CAiH9B"}

package/dist/lib/agents/question.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"question.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/question.agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,SAAS,GACT,cAAc,CAAC;AAgDnB,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CA6DlC"}
+{"version":3,"file":"question.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/question.agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYpD,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,SAAS,GACT,cAAc,CAAC;AAgDnB,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CA6DlC"}

package/dist/lib/agents/sql-transform-plugins.d.ts

@@ -12,11 +12,11 @@ export declare class SqlProxyEnforcementPlugin implements TransformPlugin<SqlPro
     name: string;
     transform(context: TransformContext): TransformResult<SqlProxyEnforcementMetadata>;
 }
-export interface SqlBacktickRewriteMetadata {
+export interface SqlCommandRewriteMetadata {
     rewritten: boolean;
 }
-export declare class SqlBacktickRewritePlugin implements TransformPlugin<SqlBacktickRewriteMetadata> {
+export declare class SqlCommandRewritePlugin implements TransformPlugin<SqlCommandRewriteMetadata> {
     name: string;
-    transform(context: TransformContext): TransformResult<SqlBacktickRewriteMetadata>;
+    transform(context: TransformContext): TransformResult<SqlCommandRewriteMetadata>;
 }
 //# sourceMappingURL=sql-transform-plugins.d.ts.map

package/dist/lib/agents/sql-transform-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-transform-plugins.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql-transform-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAGV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEhB,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAC;AAwCtE,qBAAa,sBAAuB,SAAQ,aAAa;;IAMvD,MAAM,IAAI,aAAa;CAGxB;AAoyBD,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,yBAA0B,YAAW,eAAe,CAAC,2BAA2B,CAAC;IAC5F,IAAI,SAA2B;IAE/B,SAAS,CACP,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAAC,2BAA2B,CAAC;CAehD;AA+BD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,OAAO,CAAC;CACpB;AAiID,qBAAa,wBAAyB,YAAW,eAAe,CAAC,0BAA0B,CAAC;IAC1F,IAAI,SAA0B;IAE9B,SAAS,CACP,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAAC,0BAA0B,CAAC;CAK/C"}
+{"version":3,"file":"sql-transform-plugins.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql-transform-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAGV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEhB,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAC;AAwCtE,qBAAa,sBAAuB,SAAQ,aAAa;;IAMvD,MAAM,IAAI,aAAa;CAGxB;AAoyBD,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,yBAA0B,YAAW,eAAe,CAAC,2BAA2B,CAAC;IAC5F,IAAI,SAA2B;IAE/B,SAAS,CACP,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAAC,2BAA2B,CAAC;CAehD;AA8BD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;CACpB;AA8JD,qBAAa,uBAAwB,YAAW,eAAe,CAAC,yBAAyB,CAAC;IACxF,IAAI,SAAyB;IAE7B,SAAS,CACP,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAAC,yBAAyB,CAAC;CAK9C"}

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

@@ -1 +1 @@
-{"version":3,"file":"sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql.agent.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,KAAK,eAAe,EAWrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA+ND,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAmJvE"}
+{"version":3,"file":"sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql.agent.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,KAAK,eAAe,EAWrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAOtD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA+PD,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsKvE"}

package/dist/lib/instructions.d.ts

@@ -1,3 +1,3 @@
 import { type ContextFragment } from '@deepagents/context';
-export declare function guidelines(): ContextFragment[];
+export declare function instructions(): ContextFragment[];
 //# sourceMappingURL=instructions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAYrB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,UAAU,IAAI,eAAe,EAAE,CA8T9C"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAYrB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAmUhD"}

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

@@ -0,0 +1,15 @@
+import { type CreateSqlMetaHookOptions } from './sql-meta-hook.ts';
+export { createSqlMetaHook } from './sql-meta-hook.ts';
+export type { CreateSqlMetaHookOptions, SqlCommandFormatter, } from './sql-meta-hook.ts';
+export { repairSqlCommand } from './sql-repair.ts';
+export { transformSqlCommand } from './sql-transform.ts';
+export type CreateSqlCommandHooksOptions = CreateSqlMetaHookOptions;
+export declare function createSqlCommandHooks({ adapters, }: CreateSqlCommandHooksOptions): {
+    onBeforeBashCall: ({ command }: {
+        command: string;
+    }) => {
+        command: string;
+    };
+    onAfterBashCall: ({ command }: import("./sql-meta-hook.ts").SqlMetaAfterHookInput) => undefined;
+};
+//# sourceMappingURL=sql-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/sql-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAEpE,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,GACT,EAAE,4BAA4B;oCAIK;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;EAQtD"}

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

@@ -0,0 +1,20 @@
+import type { CommandResult } from 'bash-tool';
+export interface SqlCommandFormatter {
+    format(sql: string): string;
+}
+export interface CreateSqlMetaHookOptions {
+    adapters: Record<string, SqlCommandFormatter>;
+}
+export interface SqlMetaTrackInput {
+    repaired: string;
+    transformed: string;
+}
+export interface SqlMetaAfterHookInput {
+    command: string;
+    result: CommandResult;
+}
+export declare function createSqlMetaHook({ adapters }: CreateSqlMetaHookOptions): {
+    track({ repaired, transformed }: SqlMetaTrackInput): void;
+    onAfterBashCall({ command }: SqlMetaAfterHookInput): undefined;
+};
+//# sourceMappingURL=sql-meta-hook.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,2 @@
+export declare function repairSqlCommand(command: string): string;
+//# sourceMappingURL=sql-repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-repair.d.ts","sourceRoot":"","sources":["../../src/lib/sql-repair.ts"],"names":[],"mappings":"AAsCA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

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

@@ -0,0 +1,2 @@
+export declare function transformSqlCommand(command: string): string;
+//# sourceMappingURL=sql-transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-transform.d.ts","sourceRoot":"","sources":["../../src/lib/sql-transform.ts"],"names":[],"mappings":"AAYA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS3D"}

package/dist/lib/sql.d.ts

@@ -1,54 +1,21 @@
-import { type StreamTextTransform, type Tool, type ToolSet } from 'ai';
 import { type AgentModel } from '@deepagents/agent';
-import { type AgentSandbox, ContextEngine, type ContextFragment } from '@deepagents/context';
-import { type Adapter, type IntrospectionPhase } from './adapters/adapter.ts';
+import { type Adapter } from './adapters/adapter.ts';
 import { type ExtractedPair, type PairProducer } from './synthesis/types.ts';
-export type RenderingTools = Record<string, Tool<unknown, never>>;
-export declare const TEXT2SQL_INDEX_PROGRESS_CHUNK: "data-text2sql-index-progress";
-export type Text2SqlIndexProgressEventType = 'index:start' | 'index:end' | 'adapter:start' | 'adapter:end' | 'adapter:cache-hit' | 'adapter:cache-miss' | 'phase:start' | 'phase:progress' | 'phase:end' | 'adapter:error' | 'index:error';
-export interface Text2SqlIndexProgressEvent {
-    type: Text2SqlIndexProgressEventType;
-    adapter?: string;
-    phase?: IntrospectionPhase;
-    table?: string;
-    message: string;
-    current?: number;
-    total?: number;
-    cached?: boolean;
-    timestampMs?: number;
-}
 export interface Text2SqlConfig {
     adapters: Record<string, Adapter>;
-    sandbox: AgentSandbox;
-    /**
-     * Context engine driving the conversation. Text2Sql appends its
-     * guidelines and index fragments to this engine before each chat turn.
-     * The same engine instance must be used for `continue()` calls upstream.
-     */
-    context: ContextEngine;
     version: string;
-    tools?: RenderingTools;
     model: AgentModel;
-    transform?: StreamTextTransform<ToolSet> | StreamTextTransform<ToolSet>[];
 }
 /**
- * Text2Sql — the caller owns the sandbox. Build one by passing
- * `hostExtensions: [sqlSandboxExtension({ main: adapter }), ...yourOwnExtensions]`
- * to `createRoutingSandbox`, layered over whichever backend you want
- * (virtual, Docker, Agent OS), then wrap with `createBashTool`. For file
- * event tracking, wrap the fs in `ObservedFs` before passing to the
- * backend and attach `drainFileEvents: () => observed.drain()` to the
- * resulting sandbox.
+ * 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);
     toSql(input: string, adapterName: string): Promise<string>;
-    index(): Promise<ContextFragment[]>;
     toPairs<T extends PairProducer>(adapterName: string, factory: (adapter: Adapter) => T): Promise<ExtractedPair[]>;
-    chat(options?: {
-        abortSignal?: AbortSignal;
-        generateTitle?: boolean;
-    }): Promise<ReadableStream<import("ai").InferUIMessageChunk<import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>>>>;
 }
 //# 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,EACL,KAAK,mBAAmB,EACxB,KAAK,IAAI,EACT,KAAK,OAAO,EAEb,MAAM,IAAI,CAAC;AAEZ,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,eAAe,EAKrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAElE,eAAO,MAAM,6BAA6B,EACxC,8BAAuC,CAAC;AAE1C,MAAM,MAAM,8BAA8B,GACtC,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkBD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,qBAAa,QAAQ;;gBAMP,MAAM,EAAE,cAAc;IA6BrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D,KAAK,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAgInC,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;IAMd,IAAI,CAAC,OAAO,CAAC,EAAE;QAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB;CAyCF"}
+{"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"}

package/dist/lib/synthesis/extractors/base-contextual-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-contextual-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/base-contextual-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA2C,MAAM,IAAI,CAAC;AAa7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDhC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAGzD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;GAUG;AACH,8BAAsB,uBAAwB,SAAQ,YAAY;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IACjC,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAM;IACzC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAChC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,OAAO,EAAE,8BAA8B,CAAC;gBAGhD,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,8BAAmC;IAQ9C;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;IAyBjD;;OAEG;YACW,sBAAsB;IAmBpC;;OAEG;YACW,oBAAoB;IAsDlC;;OAEG;cACc,gBAAgB,CAC/B,aAAa,EAAE,MAAM,GACpB,cAAc,CAAC,aAAa,EAAE,CAAC;IAmBlC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7D;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,MAAM,EAAE;CAClD"}
+{"version":3,"file":"base-contextual-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/base-contextual-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA2C,MAAM,IAAI,CAAC;AAc7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDhC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAGzD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;GAUG;AACH,8BAAsB,uBAAwB,SAAQ,YAAY;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IACjC,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAM;IACzC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAChC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,OAAO,EAAE,8BAA8B,CAAC;gBAGhD,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,8BAAmC;IAQ9C;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;IAyBjD;;OAEG;YACW,sBAAsB;IAmBpC;;OAEG;YACW,oBAAoB;IAsDlC;;OAEG;cACc,gBAAgB,CAC/B,aAAa,EAAE,MAAM,GACpB,cAAc,CAAC,aAAa,EAAE,CAAC;IAmBlC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7D;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,MAAM,EAAE;CAClD"}

package/dist/lib/synthesis/extractors/segmented-context-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segmented-context-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/segmented-context-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAapC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EAGpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAyE9E;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,SAAQ,uBAAuB;gBAElE,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,gCAAqC;IAKhD;;;;;;OAMG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIxC;;;;;;OAMG;YACW,mBAAmB;CAWlC"}
+{"version":3,"file":"segmented-context-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/segmented-context-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAcpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EAGpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAyE9E;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,SAAQ,uBAAuB;gBAElE,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,gCAAqC;IAKhD;;;;;;OAMG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIxC;;;;;;OAMG;YACW,mBAAmB;CAWlC"}

package/dist/lib/synthesis/extractors/sql-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/sql-extractor.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAOD;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY;;IAK5C;;;;OAIG;gBAED,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB;IAQnC;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;CA6ElD"}
+{"version":3,"file":"sql-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/sql-extractor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAOD;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY;;IAK5C;;;;OAIG;gBAED,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB;IAQnC;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;CA6ElD"}

package/dist/lib/synthesis/index.js

@@ -999,9 +999,34 @@ import {
   user as user5,
   workflow
 } from "@deepagents/context";
+
+// packages/text2sql/src/lib/adapters/runtime-scope.ts
+import nodeSqlParser3 from "node-sql-parser";
+var { Parser: Parser3 } = nodeSqlParser3;
+var parser3 = new Parser3();
+function buildScopeParseErrorPayload(sql, dialect, error) {
+  const parserError = error instanceof Error ? error.message : String(error ?? "Unknown error");
+  return {
+    error: `SQL scope analysis failed before validation/execution: ${parserError}`,
+    error_type: "SQL_SCOPE_PARSE_ERROR",
+    suggestion: "Rewrite the query into simpler SQL that can be analyzed safely, or extend parser coverage for this dialect feature.",
+    sql_attempted: sql,
+    parser_dialect: dialect,
+    parser_error: parserError
+  };
+}
+
+// packages/text2sql/src/lib/agents/sql.agent.ts
 var RETRY_TEMPERATURES = [0, 0.2, 0.3];
 var SQL_AGENT_ROLE = "Expert SQL query generator.";
 var SQL_AGENT_OBJECTIVE = "Generate precise SQL grounded in provided schema.";
+var FORMATTER_SCOPE_DIALECTS = /* @__PURE__ */ new Map([
+  ["sqlite", "sqlite"],
+  ["postgresql", "postgresql"],
+  ["bigquery", "bigquery"],
+  ["transactsql", "transactsql"],
+  ["mysql", "mysql"]
+]);
 var SQL_AGENT_POLICIES = [
   fragment5(
     "schema_mapping",
@@ -1207,6 +1232,26 @@ function extractSql(output) {
   const match = output.match(/```sql\n?([\s\S]*?)```/);
   return match ? match[1].trim() : output.trim();
 }
+function scopeDialectFor(adapter) {
+  const dialect = FORMATTER_SCOPE_DIALECTS.get(adapter.formatterLanguage);
+  if (!dialect) {
+    throw new TypeError(
+      `No scope dialect mapping for formatter language "${adapter.formatterLanguage}".`
+    );
+  }
+  return dialect;
+}
+function fencedMarkdownParseError(sql, adapter) {
+  return new SQLValidationError(
+    JSON.stringify(
+      buildScopeParseErrorPayload(
+        sql,
+        scopeDialectFor(adapter),
+        new Error("SQL response was fenced markdown, not executable SQL.")
+      )
+    )
+  );
+}
 async function toSql(options) {
   const { maxRetries = 3 } = options;
   return withRetry(
@@ -1277,7 +1322,19 @@ Question: ${options.input}
       });
       const { result: output } = await sqlOutput.generate();
       const finalizeSql = async (rawSql) => {
-        const sql = options.adapter.format(extractSql(rawSql));
+        const extractedSql = extractSql(rawSql);
+        const errorsOrUndefined = errors.length ? errors.map(formatErrorMessage) : void 0;
+        if (extractedSql === "") {
+          return {
+            attempts,
+            sql: "",
+            errors: errorsOrUndefined
+          };
+        }
+        const sql = options.adapter.format(extractedSql);
+        if (rawSql.trimStart().startsWith("```") && extractedSql === rawSql.trim()) {
+          throw fencedMarkdownParseError(sql, options.adapter);
+        }
         const validationError = await options.adapter.validate(sql);
         if (validationError) {
           throw new SQLValidationError(validationError);
@@ -1285,7 +1342,7 @@ Question: ${options.input}
         return {
           attempts,
           sql,
-          errors: errors.length ? errors.map(formatErrorMessage) : void 0
+          errors: errorsOrUndefined
         };
       };
       if ("error" in output) {