@deepagents/text2sql 0.3.1 → 0.7.0

package/dist/lib/agents/bi.agent.d.ts

@@ -0,0 +1,14 @@
+import type { Adapter } from '../adapters/adapter.ts';
+/**
+ * State passed to the BI agent
+ */
+export type BiAgentState = {
+    /** Database adapter for query execution and validation */
+    adapter: Adapter;
+    /** Schema introspection XML */
+    introspection: string;
+    /** Combined teachings/instructions string */
+    teachings: string;
+};
+export declare const biAgent: import("@deepagents/agent").Agent<never, BiAgentState, BiAgentState>;
+//# sourceMappingURL=bi.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bi.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/bi.agent.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAoSF,eAAO,MAAM,OAAO,sEAqClB,CAAC"}

package/dist/lib/agents/chat1.agent.d.ts

@@ -0,0 +1,50 @@
+import type { Adapter } from '../adapters/adapter.ts';
+import type { TeachablesStore } from '../memory/store.ts';
+import type { Teachables } from '../teach/teachables.ts';
+export type Chat1State = {
+    /** Database adapter for query execution */
+    adapter: Adapter;
+    /** Schema introspection XML */
+    introspection: string;
+    /** Teachings/instructions for SQL generation */
+    instructions: Teachables[];
+    /** Combined teachings string for the agent prompt */
+    teachings: string;
+    /** Optional memory store for user teachables */
+    memory?: TeachablesStore;
+    /** User ID for memory operations */
+    userId?: string;
+};
+/**
+ * Result returned by the query_database tool
+ */
+export interface QueryDatabaseResult {
+    success: boolean;
+    /** The generated SQL query */
+    sql?: string;
+    /** Query results as array of rows */
+    data?: unknown[];
+    /** Error message if generation or execution failed */
+    error?: string;
+    /** Number of attempts made during SQL generation */
+    attempts?: number;
+}
+declare const tools: {
+    query_database: import("ai").Tool<{
+        question: string;
+        reasoning?: string | undefined;
+    }, QueryDatabaseResult>;
+    scratchpad: import("ai").Tool<{
+        reflection: string;
+    }, string>;
+};
+/**
+ * Chat1 Agent - Table Augmented Generation with combined query tool.
+ *
+ * This agent receives user questions and uses the query_database tool
+ * to fetch data. The SQL generation is delegated to the specialized
+ * sqlQueryAgent via the toSql() function.
+ */
+export declare const chat1Agent: import("@deepagents/agent").Agent<never, Chat1State, Chat1State>;
+export { tools as chat1Tools };
+//# sourceMappingURL=chat1.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat1.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/chat1.agent.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,KAAK;;;;;;;;CA8DV,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,kEAUrB,CAAC;AAEH,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,CAAC"}

package/dist/lib/agents/chat2.agent.d.ts

@@ -0,0 +1,68 @@
+import type { Adapter } from '../adapters/adapter.ts';
+import type { TeachablesStore } from '../memory/store.ts';
+import type { Teachables } from '../teach/teachables.ts';
+export type Chat2State = {
+    /** Database adapter for query execution */
+    adapter: Adapter;
+    /** Schema introspection XML */
+    introspection: string;
+    /** Teachings/instructions for SQL generation */
+    instructions: Teachables[];
+    /** Combined teachings string for the agent prompt */
+    teachings: string;
+    /** Optional memory store for user teachables */
+    memory?: TeachablesStore;
+    /** User ID for memory operations */
+    userId?: string;
+};
+/**
+ * Result returned by the generate_sql tool
+ */
+export interface GenerateSqlToolResult {
+    success: boolean;
+    /** The generated and validated SQL query */
+    sql?: string;
+    /** Error message if generation failed */
+    error?: string;
+    /** Number of attempts made during SQL generation */
+    attempts?: number;
+    /** Validation errors encountered during generation */
+    validationErrors?: string[];
+}
+/**
+ * Result returned by the execute_sql tool
+ */
+export interface ExecuteSqlToolResult {
+    success: boolean;
+    /** Query results as array of rows */
+    data?: unknown[];
+    /** Error message if execution failed */
+    error?: string;
+    /** Row count of results */
+    rowCount?: number;
+}
+declare const tools: {
+    generate_sql: import("ai").Tool<{
+        question: string;
+        reasoning?: string | undefined;
+    }, GenerateSqlToolResult>;
+    execute_sql: import("ai").Tool<{
+        sql: string;
+        reasoning?: string | undefined;
+    }, ExecuteSqlToolResult>;
+    scratchpad: import("ai").Tool<{
+        reflection: string;
+    }, string>;
+};
+/**
+ * Chat2 Agent - Table Augmented Generation with peek support.
+ *
+ * This agent uses separate generate_sql and execute_sql tools,
+ * allowing it to review the SQL before execution. This enables:
+ * - Transparency: Agent knows what SQL will be run
+ * - Control: Agent can refine before executing
+ * - Explanation: Agent can describe its approach to the user
+ */
+export declare const chat2Agent: import("@deepagents/agent").Agent<never, Chat2State, Chat2State>;
+export { tools as chat2Tools };
+//# sourceMappingURL=chat2.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat2.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/chat2.agent.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,KAAK;;;;;;;;;;;;CAsGV,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,kEAkBrB,CAAC;AAEH,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,CAAC"}

package/dist/lib/agents/chat3.agent.d.ts

@@ -0,0 +1,80 @@
+import type { Adapter } from '../adapters/adapter.ts';
+import type { TeachablesStore } from '../memory/store.ts';
+import { type Teachables } from '../teach/teachables.ts';
+export type Chat3State = {
+    /** Database adapter for query execution */
+    adapter: Adapter;
+    /** Schema introspection XML */
+    introspection: string;
+    /** Teachings/instructions for SQL generation */
+    instructions: Teachables[];
+    /** Combined teachings string for the agent prompt */
+    teachings: string;
+    /** Optional memory store for user teachables */
+    memory?: TeachablesStore;
+    /** User ID for memory operations */
+    userId?: string;
+};
+/**
+ * Result from the collaborative query tool
+ */
+export interface CollaborativeQueryResult {
+    /** Whether a final SQL was produced */
+    success: boolean;
+    /** The generated SQL (if success) */
+    sql?: string;
+    /** Query results (if executed) */
+    data?: unknown[];
+    /** Confidence level of the SQL */
+    confidence?: 'high' | 'medium' | 'low';
+    /** Assumptions made during generation */
+    assumptions?: string[];
+    /** Clarification question (if needed) */
+    clarificationNeeded?: string;
+    /** Context for clarification */
+    clarificationContext?: string;
+    /** Options for clarification */
+    clarificationOptions?: string[];
+    /** Reason if unanswerable */
+    unanswerableReason?: string;
+    /** Suggested alternatives if unanswerable */
+    suggestions?: string[];
+    /** Error message if something failed */
+    error?: string;
+}
+declare const tools: {
+    consult_sql_agent: import("ai").Tool<{
+        question: string;
+        context?: string | undefined;
+        previousClarification?: string | undefined;
+    }, CollaborativeQueryResult>;
+    execute_sql: import("ai").Tool<{
+        sql: string;
+    }, {
+        success: boolean;
+        error: string;
+        data?: undefined;
+        rowCount?: undefined;
+    } | {
+        success: boolean;
+        data: any[];
+        rowCount: number | undefined;
+        error?: undefined;
+    }>;
+    scratchpad: import("ai").Tool<{
+        reflection: string;
+    }, string>;
+};
+/**
+ * Chat3 Agent - Table Augmented Generation with agent collaboration.
+ *
+ * This agent collaborates with a specialized SQL agent that can:
+ * - Express confidence levels
+ * - Surface assumptions
+ * - Request clarification
+ *
+ * This enables higher quality SQL generation through dialogue.
+ */
+export declare const chat3Agent: import("@deepagents/agent").Agent<never, Chat3State, Chat3State>;
+export { tools as chat3Tools };
+//# sourceMappingURL=chat3.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat3.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/chat3.agent.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAmFF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;CA8JV,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,kEAoBrB,CAAC;AAEH,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,CAAC"}

package/dist/lib/agents/chat4.agent.d.ts

@@ -0,0 +1,88 @@
+import z from 'zod';
+import type { Adapter } from '../adapters/adapter.ts';
+import type { TeachablesStore } from '../memory/store.ts';
+import { type Teachables } from '../teach/teachables.ts';
+export type Chat4State = {
+    /** Database adapter for query execution */
+    adapter: Adapter;
+    /** Schema introspection XML */
+    introspection: string;
+    /** Teachings/instructions for SQL generation */
+    instructions: Teachables[];
+    /** Combined teachings string for the agent prompt */
+    teachings: string;
+    /** Optional memory store for user teachables */
+    memory?: TeachablesStore;
+    /** User ID for memory operations */
+    userId?: string;
+};
+/**
+ * Schema for question decomposition
+ */
+declare const questionDecompositionSchema: z.ZodObject<{
+    originalQuestion: z.ZodString;
+    breakdown: z.ZodArray<z.ZodString>;
+    entities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    filters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    aggregation: z.ZodOptional<z.ZodString>;
+    ambiguities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type QuestionDecomposition = z.infer<typeof questionDecompositionSchema>;
+/**
+ * Result from the decomposed query tool
+ */
+export interface DecomposedQueryResult {
+    success: boolean;
+    /** The original question */
+    question?: string;
+    /** How the question was decomposed */
+    decomposition?: QuestionDecomposition;
+    /** The generated SQL */
+    sql?: string;
+    /** Query results */
+    data?: unknown[];
+    /** How breakdown components were addressed */
+    reasoning?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Number of generation attempts */
+    attempts?: number;
+}
+declare const tools: {
+    query_with_decomposition: import("ai").Tool<{
+        question: string;
+        breakdown: string[];
+        entities?: string[] | undefined;
+        filters?: string[] | undefined;
+        aggregation?: string | undefined;
+        ambiguities?: string[] | undefined;
+    }, DecomposedQueryResult>;
+    execute_sql: import("ai").Tool<{
+        sql: string;
+    }, {
+        success: boolean;
+        error: string;
+        data?: undefined;
+        rowCount?: undefined;
+    } | {
+        success: boolean;
+        data: any[];
+        rowCount: number | undefined;
+        error?: undefined;
+    }>;
+    scratchpad: import("ai").Tool<{
+        reflection: string;
+    }, string>;
+};
+/**
+ * Chat4 Agent - Table Augmented Generation with question decomposition.
+ *
+ * This agent breaks down questions into semantic components before
+ * generating SQL. This approach:
+ * - Ensures all aspects of the question are addressed
+ * - Makes the reasoning explicit
+ * - Helps with complex multi-part questions
+ */
+export declare const chat4Agent: import("@deepagents/agent").Agent<never, Chat4State, Chat4State>;
+export { tools as chat4Tools };
+//# sourceMappingURL=chat4.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat4.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/chat4.agent.ts"],"names":[],"mappings":"AAkBA,OAAO,CAAC,MAAM,KAAK,CAAC;AAKpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,2BAA2B;;;;;;;iBAgC/B,CAAC;AAEH,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAwDzE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;CAiLV,CAAC;AAyCF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,kEA2BrB,CAAC;AAEH,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,CAAC"}

package/dist/lib/agents/developer.agent.d.ts

@@ -0,0 +1,31 @@
+import type { Adapter } from '../adapters/adapter.ts';
+import type { Teachables } from '../teach/teachables.ts';
+/**
+ * State passed to the developer agent
+ */
+export type DeveloperAgentState = {
+    /** Database adapter for validation */
+    adapter: Adapter;
+    /** Schema introspection XML */
+    introspection: string;
+    /** Combined teachings/instructions */
+    teachings: string;
+    /** Instructions for SQL generation */
+    instructions: Teachables[];
+};
+/**
+ * Developer Agent - Power-user conversational interface for SQL generation
+ *
+ * This agent provides tools for SQL generation, validation, and explanation
+ * without execution. Designed for developers/DBAs who want full control
+ * over query building and refinement.
+ *
+ * Tools:
+ * - generate_sql: Convert natural language to validated SQL
+ * - validate_sql: Check SQL syntax without execution
+ * - explain_sql: Get plain-English explanation of SQL
+ * - show_schema: Display schema introspection on demand
+ * - scratchpad: Developer notes/reasoning
+ */
+export declare const developerAgent: import("@deepagents/agent").Agent<never, DeveloperAgentState, DeveloperAgentState>;
+//# sourceMappingURL=developer.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"developer.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/developer.agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B,CAAC;AAsJF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,oFAuCzB,CAAC"}

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

@@ -0,0 +1,23 @@
+import { type AgentModel } from '@deepagents/agent';
+export type QuestionComplexity = 'simple' | 'moderate' | 'complex' | 'high complex';
+export interface GenerateQuestionsParams {
+    /** Database schema introspection */
+    introspection: string;
+    /** Complexity level for generated questions */
+    complexity: QuestionComplexity;
+    /** Number of questions to generate */
+    count: number;
+    /** Optional prompt to prepend (e.g., persona context) */
+    prompt?: string;
+    /** Optional model override */
+    model?: AgentModel;
+}
+export interface GenerateQuestionsResult {
+    questions: string[];
+}
+/**
+ * Generate natural language questions from database schema.
+ * Used for creating synthetic training data for text-to-SQL models.
+ */
+export declare function generateQuestions(params: GenerateQuestionsParams): Promise<GenerateQuestionsResult>;
+//# sourceMappingURL=question.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"question.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/question.agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAE3E,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,SAAS,GACT,cAAc,CAAC;AA8GnB,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,CAsBlC"}

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

@@ -0,0 +1,44 @@
+import { type AgentModel } from '@deepagents/agent';
+import type { Adapter } from '../adapters/adapter.ts';
+import { type Teachables } from '../teach/teachables.ts';
+export interface ToSqlOptions {
+    /** The natural language input to convert to SQL */
+    input: string;
+    /** Database adapter for validation */
+    adapter: Adapter;
+    /** Introspection/schema context */
+    introspection: string;
+    /** Instructions/teachings to include */
+    instructions: Teachables[];
+    /** Optional model override */
+    model?: AgentModel;
+    /** Maximum retry attempts on validation failure (default: 3) */
+    maxRetries?: number;
+}
+export interface ToSqlResult {
+    /** The generated SQL query */
+    sql: string;
+    /** Number of attempts made */
+    attempts: number;
+    /** Validation errors encountered (if any retries occurred) */
+    errors?: string[];
+}
+declare const marker: unique symbol;
+/**
+ * Error thrown when SQL validation fails.
+ */
+export declare class SQLValidationError extends Error {
+    [marker]: true;
+    constructor(message: string);
+    static isInstance(error: unknown): error is SQLValidationError;
+}
+/**
+ * Error thrown when the question cannot be answered with the given schema.
+ */
+export declare class UnanswerableSQLError extends Error {
+    constructor(message: string);
+    static isInstance(error: unknown): error is UnanswerableSQLError;
+}
+export declare function toSql(options: ToSqlOptions): Promise<ToSqlResult>;
+export {};
+//# sourceMappingURL=sql.agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql.agent.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,UAAU,EAKhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,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;AA2DD,QAAA,MAAM,MAAM,eAA+B,CAAC;AAC5C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;gBACH,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;IAI3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB;CAGjE;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6DvE"}

package/dist/lib/agents/teachables.agent.d.ts

@@ -1,11 +1,10 @@
-import { type GeneratedTeachable } from '../teach/teachables.ts';
-export declare const teachablesAuthorAgent: import("@deepagents/agent").Agent<{
-    teachables: GeneratedTeachable[];
-}, {
+import { type AgentModel } from '@deepagents/agent';
+import { type Teachables } from '../teach/teachables.ts';
+export interface GenerateToTeachingsOptions {
+    model?: AgentModel;
+}
+export declare function toTeachings(input: {
+    schema: string;
     context?: string;
-    adapterInfo?: string;
-}, {
-    context?: string;
-    adapterInfo?: string;
-}>;
+}, options?: GenerateToTeachingsOptions): Promise<Teachables[]>;
 //# sourceMappingURL=teachables.agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"teachables.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/teachables.agent.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAgEjE,eAAO,MAAM,qBAAqB;gBAClB,kBAAkB,EAAE;;cAEtB,MAAM;kBACF,MAAM;;cADV,MAAM;kBACF,MAAM;EA4CtB,CAAC"}
+{"version":3,"file":"teachables.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/teachables.agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,wBAAwB,CAAC;AAwIhC,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,UAAU,EAAE,CAAC,CAoCvB"}

package/dist/lib/agents/text2sql.agent.d.ts

@@ -58,7 +58,6 @@ export declare const memoryTools: {
         id: string;
     }, string>;
 };
-export declare const sqlQueryAgent: import("@deepagents/agent").Agent<unknown, import("@deepagents/agent").ContextVariables, import("@deepagents/agent").ContextVariables>;
 /**
  * An agent that does Table Augmented Generation for Text-to-SQL tasks.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"text2sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/text2sql.agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,IAAI,CAAC;AAarC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAmHlE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEvB,CAAC;AAgCF,eAAO,MAAM,aAAa,wIAqBxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;SACT,MAAM;;mBAGI,MAAM;eACV,MAAM;aACR,eAAe;aACf,MAAM;;mBAHA,MAAM;eACV,MAAM;aACR,eAAe;aACf,MAAM;EAiBjB,CAAC"}
+{"version":3,"file":"text2sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/text2sql.agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,IAAI,CAAC;AAQrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAmHlE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEvB,CAAC;AAuGF;;GAEG;AACH,eAAO,MAAM,KAAK;SACT,MAAM;;mBAGI,MAAM;eACV,MAAM;aACR,eAAe;aACf,MAAM;;mBAHA,MAAM;eACV,MAAM;aACR,eAAe;aACf,MAAM;EAoBjB,CAAC"}

package/dist/lib/checkpoint.d.ts

@@ -0,0 +1,99 @@
+export interface CheckpointOptions {
+    /** Path to the checkpoint file */
+    path: string;
+    /** Hash to detect config changes - if changed, checkpoint is invalidated */
+    configHash?: string;
+}
+/**
+ * Codec for encoding/decoding values during checkpoint operations.
+ * Use this when storing objects with methods (like Teachables) that need
+ * to be serialized to plain JSON and restored with their methods.
+ */
+export interface Codec<T, TSerialized = unknown> {
+    /** Convert runtime value to JSON-serializable format */
+    encode: (value: T) => TSerialized;
+    /** Convert stored JSON back to runtime value */
+    decode: (serialized: TSerialized) => T;
+}
+interface PointEntry {
+    inputHash: string;
+    output: unknown;
+}
+interface PointData {
+    committed: boolean;
+    entries: PointEntry[];
+}
+export declare class Checkpoint {
+    private path;
+    private configHash;
+    private points;
+    private constructor();
+    /**
+     * Load checkpoint from file, or return empty checkpoint if none exists.
+     * Handles corrupted files and config changes gracefully.
+     */
+    static load(options: CheckpointOptions): Promise<Checkpoint>;
+    /**
+     * Run a single computation with checkpointing.
+     * If already completed, returns cached value.
+     *
+     * @param key - Unique identifier for this computation
+     * @param computation - Async function that produces the value
+     * @param codec - Optional codec for encoding/decoding non-primitive values
+     */
+    run<T>(key: string, computation: () => Promise<T>, codec?: Codec<T>): Promise<T>;
+    /**
+     * Create a resumable checkpoint point for iterative operations.
+     *
+     * @param step - Unique identifier for this checkpoint point
+     */
+    point<T>(step: string): Point<T>;
+    /**
+     * Process each input with automatic checkpointing and concurrency.
+     *
+     * @param step - Unique identifier for this checkpoint
+     * @param inputs - Items to process
+     * @param process - Function to process each input
+     * @param options - Optional settings like concurrency
+     * @returns All outputs (use `.flat()` if outputs are arrays)
+     */
+    each<I, O>(step: string, inputs: Iterable<I>, process: (input: I) => Promise<O>, options?: {
+        concurrency?: number;
+    }): Promise<O[]>;
+    /**
+     * Get clean output from all completed points.
+     * Single-entry points return the value directly, multi-entry return arrays.
+     */
+    getOutput(): Record<string, unknown>;
+    /** Get the file path where checkpoint is stored */
+    getPath(): string;
+    private save;
+}
+/**
+ * A checkpoint point for tracking iterative operations.
+ * Uses input hashing to determine if an operation was already processed.
+ */
+export declare class Point<T> {
+    #private;
+    private data;
+    private persist;
+    constructor(data: PointData, persist: () => Promise<void>);
+    /**
+     * Execute computation if input wasn't processed before.
+     * Returns cached output if input hash exists, otherwise executes, saves, and returns.
+     */
+    through<I, O>(input: I, compute: () => Promise<O>, codec?: Codec<O>): Promise<O>;
+    /** Mark this point as complete. */
+    commit(): Promise<void>;
+    /** Check if this point has been committed. */
+    isCommitted(): boolean;
+    /** Get all outputs from this point. */
+    values(): T[];
+}
+/**
+ * Generate a hash from a config object for checkpoint invalidation.
+ * If config changes, the checkpoint will be invalidated and pipeline restarts.
+ */
+export declare function hashConfig(config: Record<string, unknown>): string;
+export {};
+//# sourceMappingURL=checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/lib/checkpoint.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO;IAC7C,wDAAwD;IACxD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,WAAW,CAAC;IAClC,gDAAgD;IAChD,MAAM,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,CAAC,CAAC;CACxC;AAED,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,SAAS;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAOD,qBAAa,UAAU;IAInB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,MAAM,CAA4B;IAE1C,OAAO;IAQP;;;OAGG;WACU,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IA+BlE;;;;;;;OAOG;IACG,GAAG,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAcb;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;IAKhC;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,EAAE,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,CAAC,EAAE,CAAC;IAef;;;OAGG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYpC,mDAAmD;IACnD,OAAO,IAAI,MAAM;YAIH,IAAI;CAYnB;AAMD;;;GAGG;AACH,qBAAa,KAAK,CAAC,CAAC;;IAIhB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;gBADP,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAOtC;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,CAAC,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAeb,mCAAmC;IAC7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,8CAA8C;IAC9C,WAAW,IAAI,OAAO;IAItB,uCAAuC;IACvC,MAAM,IAAI,CAAC,EAAE;CAGd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAElE"}