@deepagents/text2sql 0.3.1 → 0.6.0

package/dist/lib/synthesis/decorators/filtered-producer.d.ts

@@ -0,0 +1,26 @@
+import { type ExtractedPair, PairProducer } from '../types.ts';
+export interface FilteredProducerOptions {
+    successOnly?: boolean;
+    tables?: string[];
+    filter?: (pair: ExtractedPair) => boolean;
+}
+/**
+ * FilteredProducer - Filter pairs from another producer.
+ *
+ * Wraps another PairProducer and filters the output based on criteria.
+ */
+export declare class FilteredProducer extends PairProducer {
+    private producer;
+    private options;
+    /**
+     * @param producer - Source producer to filter
+     * @param options - Filter configuration
+     */
+    constructor(producer: PairProducer, options?: FilteredProducerOptions);
+    /**
+     * Produces pairs filtered by success status, table usage, and custom predicates.
+     * @returns Pairs matching all configured filter criteria
+     */
+    produce(): AsyncGenerator<ExtractedPair[]>;
+}
+//# sourceMappingURL=filtered-producer.d.ts.map

package/dist/lib/synthesis/decorators/filtered-producer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtered-producer.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/decorators/filtered-producer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;CAC3C;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAM9C,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IANjB;;;OAGG;gBAEO,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,uBAA4B;IAK/C;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;CA2BlD"}

package/dist/lib/synthesis/decorators/index.d.ts

@@ -0,0 +1,7 @@
+export { FilteredProducer } from './filtered-producer.ts';
+export type { FilteredProducerOptions } from './filtered-producer.ts';
+export { DeduplicatedProducer } from './deduplicated-producer.ts';
+export type { DeduplicatedProducerOptions } from './deduplicated-producer.ts';
+export { ValidatedProducer } from './validated-producer.ts';
+export type { ValidatedPair, ValidatedProducerOptions, } from './validated-producer.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/synthesis/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EACV,aAAa,EACb,wBAAwB,GACzB,MAAM,yBAAyB,CAAC"}

package/dist/lib/synthesis/decorators/validated-producer.d.ts

@@ -0,0 +1,33 @@
+import type { Adapter } from '../../adapters/adapter.ts';
+import { type ExtractedPair, PairProducer } from '../types.ts';
+export interface ValidatedProducerOptions {
+    execute?: boolean;
+    removeInvalid?: boolean;
+}
+export interface ValidatedPair extends ExtractedPair {
+    rowCount?: number;
+    error?: string;
+}
+/**
+ * ValidatedProducer - Validate SQL from another producer.
+ *
+ * Wraps another PairProducer and validates each SQL query,
+ * optionally executing to attach results.
+ */
+export declare class ValidatedProducer extends PairProducer<ValidatedPair> {
+    private producer;
+    private adapter;
+    private options;
+    /**
+     * @param producer - Source producer to validate
+     * @param adapter - Database adapter for SQL validation
+     * @param options - Validation configuration
+     */
+    constructor(producer: PairProducer, adapter: Adapter, options?: ValidatedProducerOptions);
+    /**
+     * Produces pairs with SQL validation applied, optionally executing queries.
+     * @returns Validated pairs with error/rowCount metadata attached
+     */
+    produce(): AsyncGenerator<ValidatedPair[]>;
+}
+//# sourceMappingURL=validated-producer.d.ts.map

package/dist/lib/synthesis/decorators/validated-producer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validated-producer.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/decorators/validated-producer.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,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,aAAa,CAAC;IAO9D,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IARjB;;;;OAIG;gBAEO,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,wBAA6B;IAKhD;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;CAwClD"}

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

@@ -0,0 +1,76 @@
+import { type UIMessage } from 'ai';
+import type { Adapter } from '../../adapters/adapter.ts';
+import { type ExtractedPair, PairProducer } from '../types.ts';
+export interface DbQueryInput {
+    sql: string;
+    reasoning?: string;
+}
+export interface SqlWithContext {
+    sql: string;
+    success: boolean;
+    conversationContext: string[];
+}
+export interface BaseContextualExtractorOptions {
+    includeFailures?: boolean;
+    toolName?: string;
+}
+export declare const contextResolverAgent: import("@deepagents/agent").Agent<{
+    question: string;
+}, {
+    conversation: string;
+    sql: string;
+    introspection?: string;
+}, {
+    conversation: string;
+    sql: string;
+    introspection?: string;
+}>;
+export declare function getMessageText(message: UIMessage): string;
+export declare function formatConversation(messages: string[]): string;
+/**
+ * Abstract base class for contextual extractors using Template Pattern.
+ *
+ * The `produce()` method defines the algorithm skeleton:
+ * 1. Iterate through messages
+ * 2. Call `onUserMessage()` hook for user messages
+ * 3. Extract SQL from assistant messages using `getContextSnapshot()` hook
+ * 4. Resolve questions using LLM
+ *
+ * Subclasses implement the hooks to customize context management.
+ */
+export declare abstract class BaseContextualExtractor extends PairProducer {
+    protected messages: UIMessage[];
+    protected adapter: Adapter;
+    protected options: BaseContextualExtractorOptions;
+    protected context: string[];
+    protected results: SqlWithContext[];
+    constructor(messages: UIMessage[], adapter: Adapter, options?: BaseContextualExtractorOptions);
+    /**
+     * Template method - defines the extraction algorithm skeleton.
+     * Subclasses customize behavior via hooks, not by overriding this method.
+     */
+    produce(): AsyncGenerator<ExtractedPair[]>;
+    /**
+     * Core extraction loop - iterates through messages and calls hooks.
+     */
+    private extractSqlsWithContext;
+    /**
+     * Extract SQL from assistant message parts.
+     */
+    private extractFromAssistant;
+    /**
+     * Resolve extracted SQL contexts into standalone questions using LLM.
+     */
+    protected resolveQuestions(introspection: string): AsyncGenerator<ExtractedPair[]>;
+    /**
+     * Hook called when a user message is encountered.
+     * Subclasses implement this to decide how to update context.
+     */
+    protected abstract onUserMessage(text: string): Promise<void>;
+    /**
+     * Hook called when extracting SQL to get the current context snapshot.
+     * Subclasses implement this to decide what context to include.
+     */
+    protected abstract getContextSnapshot(): string[];
+}
+//# sourceMappingURL=base-contextual-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-contextual-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/base-contextual-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,IAAI,CAAC;AAMZ,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;AACD,eAAO,MAAM,oBAAoB;cACnB,MAAM;;kBACF,MAAM;SAAO,MAAM;oBAAkB,MAAM;;kBAA3C,MAAM;SAAO,MAAM;oBAAkB,MAAM;EA8C3D,CAAC;AAEH,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;IAK9D,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE;IAC/B,SAAS,CAAC,OAAO,EAAE,OAAO;IAC1B,SAAS,CAAC,OAAO,EAAE,8BAA8B;IANnD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IACjC,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAM;gBAG7B,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,8BAAmC;IAKxD;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;IAsBjD;;OAEG;YACW,sBAAsB;IAmBpC;;OAEG;YACW,oBAAoB;IAsDlC;;OAEG;cACc,gBAAgB,CAC/B,aAAa,EAAE,MAAM,GACpB,cAAc,CAAC,aAAa,EAAE,CAAC;IA2BlC;;;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/full-context-extractor.d.ts

@@ -0,0 +1,25 @@
+import type { UIMessage } from 'ai';
+import type { Adapter } from '../../adapters/adapter.ts';
+import { BaseContextualExtractor, type BaseContextualExtractorOptions } from './base-contextual-extractor.ts';
+export type FullContextExtractorOptions = BaseContextualExtractorOptions;
+/**
+ * Extracts SQL pairs with full conversation context.
+ *
+ * @example
+ * ```typescript
+ * const extractor = new FullContextExtractor(messages, adapter);
+ * const pairs = await extractor.produce();
+ * ```
+ */
+export declare class FullContextExtractor extends BaseContextualExtractor {
+    constructor(messages: UIMessage[], adapter: Adapter, options?: FullContextExtractorOptions);
+    /**
+     * Add user message to context (keeps all messages).
+     */
+    protected onUserMessage(text: string): Promise<void>;
+    /**
+     * Return all context accumulated so far.
+     */
+    protected getContextSnapshot(): string[];
+}
+//# sourceMappingURL=full-context-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"full-context-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/full-context-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EACpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,CAAC;AAEzE;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,uBAAuB;gBAE7D,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,2BAAgC;IAK3C;;OAEG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;CAGzC"}

package/dist/lib/synthesis/extractors/index.d.ts

@@ -0,0 +1,8 @@
+export * from './message-extractor.ts';
+export * from './sql-extractor.ts';
+export * from './base-contextual-extractor.ts';
+export * from './full-context-extractor.ts';
+export * from './windowed-context-extractor.ts';
+export * from './segmented-context-extractor.ts';
+export * from './last-query-extractor.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/synthesis/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC"}

package/dist/lib/synthesis/extractors/last-query-extractor.d.ts

@@ -0,0 +1,30 @@
+import type { UIMessage } from 'ai';
+import type { Adapter } from '../../adapters/adapter.ts';
+import type { ExtractedPair } from '../types.ts';
+import { BaseContextualExtractor, type BaseContextualExtractorOptions } from './base-contextual-extractor.ts';
+export type LastQueryExtractorOptions = BaseContextualExtractorOptions;
+/**
+ * Extracts only the last SQL query with its resolved question.
+ *
+ * @example
+ * ```typescript
+ * const extractor = new LastQueryExtractor(messages, adapter);
+ * const pairs = await toPairs(extractor); // Returns array with at most 1 pair
+ * ```
+ */
+export declare class LastQueryExtractor extends BaseContextualExtractor {
+    constructor(messages: UIMessage[], adapter: Adapter, options?: LastQueryExtractorOptions);
+    /**
+     * Add user message to context (keeps all messages).
+     */
+    protected onUserMessage(text: string): Promise<void>;
+    /**
+     * Return all context accumulated so far.
+     */
+    protected getContextSnapshot(): string[];
+    /**
+     * Override to only resolve the LAST query instead of all queries.
+     */
+    protected resolveQuestions(introspection: string): AsyncGenerator<ExtractedPair[]>;
+}
+//# sourceMappingURL=last-query-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"last-query-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/last-query-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAIpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EAGpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,yBAAyB,GAAG,8BAA8B,CAAC;AAEvE;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,uBAAuB;gBAE3D,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,yBAA8B;IAKzC;;OAEG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIxC;;OAEG;cACuB,gBAAgB,CACxC,aAAa,EAAE,MAAM,GACpB,cAAc,CAAC,aAAa,EAAE,CAAC;CAyBnC"}

package/dist/lib/synthesis/extractors/message-extractor.d.ts

@@ -0,0 +1,27 @@
+import { type UIMessage } from 'ai';
+import { type ExtractedPair, PairProducer } from '../types.ts';
+export interface MessageExtractorOptions {
+    includeFailures?: boolean;
+    toolName?: string;
+}
+/**
+ * MessageExtractor - Extract pairs from chat history by parsing tool calls.
+ *
+ * Deterministic extraction: parses db_query tool calls and pairs them
+ * with the preceding user message.
+ */
+export declare class MessageExtractor extends PairProducer {
+    private messages;
+    private options;
+    /**
+     * @param messages - Chat history to extract pairs from
+     * @param options - Extraction configuration
+     */
+    constructor(messages: UIMessage[], options?: MessageExtractorOptions);
+    /**
+     * Extracts question-SQL pairs by parsing tool calls and pairing with user messages.
+     * @returns Pairs extracted from db_query tool invocations
+     */
+    produce(): AsyncGenerator<ExtractedPair[]>;
+}
+//# sourceMappingURL=message-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/message-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,IAAI,CAAC;AAEZ,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM/D,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAM9C,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IANjB;;;OAGG;gBAEO,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,GAAE,uBAA4B;IAK/C;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;CAwDlD"}

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

@@ -0,0 +1,48 @@
+import type { UIMessage } from 'ai';
+import type { Adapter } from '../../adapters/adapter.ts';
+import { BaseContextualExtractor, type BaseContextualExtractorOptions } from './base-contextual-extractor.ts';
+export type SegmentedContextExtractorOptions = BaseContextualExtractorOptions;
+/**
+ * Extracts SQL pairs with topic-aware context segmentation.
+ *
+ * When a topic change is detected:
+ * 1. The triggering message is resolved to standalone form using LLM
+ * 2. Context is reset
+ * 3. The resolved message becomes the start of the new context
+ *
+ * @example
+ * ```typescript
+ * const extractor = new SegmentedContextExtractor(messages, adapter);
+ * const pairs = await extractor.produce();
+ * ```
+ */
+export declare class SegmentedContextExtractor extends BaseContextualExtractor {
+    constructor(messages: UIMessage[], adapter: Adapter, options?: SegmentedContextExtractorOptions);
+    /**
+     * Handle user message with topic change detection.
+     * If topic changes, resolve the message to standalone form before resetting.
+     *
+     * Note: We capture context snapshot before async LLM calls to prevent race conditions
+     * where context might be modified during the async operation.
+     */
+    protected onUserMessage(text: string): Promise<void>;
+    /**
+     * Return all context in current topic segment.
+     */
+    protected getContextSnapshot(): string[];
+    /**
+     * Detect if a new message represents a topic change using LLM.
+     * @param newMessage - The new user message to check
+     * @param contextSnapshot - Snapshot of context captured before this async call
+     */
+    private detectTopicChange;
+    /**
+     * Resolve a context-dependent message into a standalone question.
+     * Called when topic change is detected to preserve the meaning of
+     * the triggering message before context is reset.
+     * @param text - The user message to resolve
+     * @param contextSnapshot - Snapshot of context captured before this async call
+     */
+    private resolveToStandalone;
+}
+//# sourceMappingURL=segmented-context-extractor.d.ts.map

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

@@ -0,0 +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;AAMpC,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;AAyD9E;;;;;;;;;;;;;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;IAiB1D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIxC;;;;OAIG;YACW,iBAAiB;IAgB/B;;;;;;OAMG;YACW,mBAAmB;CAelC"}

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

@@ -0,0 +1,27 @@
+import type { Adapter } from '../../adapters/adapter.ts';
+import { type ExtractedPair, PairProducer } from '../types.ts';
+export interface SqlExtractorOptions {
+    validateSql?: boolean;
+    skipInvalid?: boolean;
+}
+/**
+ * SqlExtractor - Generate questions for existing SQL queries.
+ *
+ * Given a list of SQL queries, uses an LLM to generate the natural
+ * language questions they answer.
+ */
+export declare class SqlExtractor extends PairProducer {
+    #private;
+    /**
+     * @param sql - SQL query or queries to generate questions for
+     * @param adapter - Database adapter for validation and schema introspection
+     * @param options - Extraction configuration
+     */
+    constructor(sql: string[] | string, adapter: Adapter, options?: SqlExtractorOptions);
+    /**
+     * Generates natural language questions for each SQL query using an LLM.
+     * @returns Pairs with generated questions and original SQL
+     */
+    produce(): AsyncGenerator<ExtractedPair[]>;
+}
+//# sourceMappingURL=sql-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/sql-extractor.ts"],"names":[],"mappings":"AAMA,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;AAgDD;;;;;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;CAiClD"}

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

@@ -0,0 +1,30 @@
+import type { UIMessage } from 'ai';
+import type { Adapter } from '../../adapters/adapter.ts';
+import { BaseContextualExtractor, type BaseContextualExtractorOptions } from './base-contextual-extractor.ts';
+export interface WindowedContextExtractorOptions extends BaseContextualExtractorOptions {
+    windowSize: number;
+}
+/**
+ * Extracts SQL pairs with a sliding window of conversation context.
+ *
+ * @example
+ * ```typescript
+ * const extractor = new WindowedContextExtractor(messages, adapter, {
+ *   windowSize: 5,
+ * });
+ * const pairs = await extractor.produce();
+ * ```
+ */
+export declare class WindowedContextExtractor extends BaseContextualExtractor {
+    private windowSize;
+    constructor(messages: UIMessage[], adapter: Adapter, options: WindowedContextExtractorOptions);
+    /**
+     * Add user message to context (keeps all, windowing happens on snapshot).
+     */
+    protected onUserMessage(text: string): Promise<void>;
+    /**
+     * Return only the last N messages based on window size.
+     */
+    protected getContextSnapshot(): string[];
+}
+//# sourceMappingURL=windowed-context-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"windowed-context-extractor.d.ts","sourceRoot":"","sources":["../../../../src/lib/synthesis/extractors/windowed-context-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EACpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,+BACf,SAAQ,8BAA8B;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,SAAQ,uBAAuB;IACnE,OAAO,CAAC,UAAU,CAAS;gBAGzB,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,+BAA+B;IAM1C;;OAEG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;CAMzC"}

package/dist/lib/synthesis/index.d.ts

@@ -0,0 +1,6 @@
+export * from './decorators/index.ts';
+export * from './extractors/index.ts';
+export * from './synthesizers/index.ts';
+export * from './types.ts';
+export { type QuestionComplexity } from '../agents/question.agent.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/synthesis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}