@deepagents/text2sql 0.10.2 → 0.12.0

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

@@ -1,31 +1,41 @@
+import { type ContextFragment } from '@deepagents/context';
 import type { Adapter } from '../adapters/adapter.ts';
-import type { Teachables } from '../teach/teachables.ts';
 /**
- * State passed to the developer agent
+ * Context variables passed to the developer agent tools via stream().
  */
-export type DeveloperAgentState = {
-    /** Database adapter for validation */
+export type DeveloperContextVariables = {
+    /** Database adapter for validation and execution */
     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
+ * Developer agent exports - tools and context fragments.
+ * The agent is constructed dynamically in sql.ts developer() method.
  */
-export declare const developerAgent: import("@deepagents/agent").Agent<never, DeveloperAgentState, DeveloperAgentState>;
+declare const _default: {
+    tools: {
+        /**
+         * Validate SQL query syntax before execution.
+         */
+        validate_query: import("ai").Tool<{
+            sql: string;
+        }, string>;
+        /**
+         * Execute SQL query against the database.
+         */
+        db_query: import("ai").Tool<{
+            reasoning: string;
+            sql: string;
+        }, any[]>;
+        /**
+         * Get plain-English explanation of a SQL query.
+         */
+        explain_sql: import("ai").Tool<{
+            sql: string;
+        }, {
+            explanation: string;
+        }>;
+    };
+    fragments: ContextFragment<import("@deepagents/context").FragmentData>[];
+};
+export default _default;
 //# sourceMappingURL=developer.agent.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"developer.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/developer.agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AA2FF;;;GAGG;;;QAvFD;;WAEG;;;;QAgBH;;WAEG;;;;;QA4BH;;WAEG;;;;;;;;;AAsCL,wBAAoC"}

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

@@ -1,8 +1,7 @@
-export declare const explainerAgent: import("@deepagents/agent").Agent<{
+/**
+ * Generates a plain English explanation for a SQL query.
+ */
+export declare function explainSql(sql: string): Promise<{
     explanation: string;
-}, {
-    sql: string;
-}, {
-    sql: string;
 }>;
 //# sourceMappingURL=explainer.agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"explainer.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/explainer.agent.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc;iBAAwB,MAAM;;SAAW,MAAM;;SAAN,MAAM;EAexE,CAAC"}
+{"version":3,"file":"explainer.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/explainer.agent.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BlC"}

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":"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"}
+{"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"}

package/dist/lib/agents/result-tools.d.ts

@@ -0,0 +1,34 @@
+import type { Adapter } from '../adapters/adapter.ts';
+/**
+ * Options for creating result tools.
+ */
+export interface ResultToolsOptions {
+    /** Database adapter for executing SQL queries */
+    adapter: Adapter;
+    /** Chat ID for artifact organization (session-level) */
+    chatId: string;
+    /** Message ID for turn-level artifact isolation */
+    messageId: string;
+}
+/**
+ * Creates bash tool with integrated sql command.
+ *
+ * The agent sees only one tool: `bash`
+ * SQL is executed via: sql run "SELECT ..."
+ *
+ * Dual-level artifact storage:
+ * - `/results/` → `./artifacts/{chatId}/{messageId}/results/` (current turn, write)
+ * - `/artifacts/` → `./artifacts/{chatId}/` (all turns, browse previous)
+ *
+ * @param options - Configuration options
+ * @param options.adapter - Database adapter for SQL execution
+ * @param options.chatId - Chat ID for session-level organization
+ * @param options.messageId - Message ID for turn-level isolation
+ */
+export declare function createResultTools(options: ResultToolsOptions): Promise<{
+    bash: import("ai").Tool<{
+        command: string;
+    }, import("bash-tool").CommandResult>;
+    sandbox: import("bash-tool").Sandbox;
+}>;
+//# sourceMappingURL=result-tools.d.ts.map

package/dist/lib/agents/result-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-tools.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/result-tools.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AA4KtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB;;;;;GAkDlE"}

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

@@ -1,15 +1,15 @@
 import { type AgentModel } from '@deepagents/agent';
+import { type ContextFragment } from '@deepagents/context';
 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;
+    /** Schema fragments from adapter introspection */
+    schemaFragments: ContextFragment[];
     /** Instructions/teachings to include */
-    instructions: Teachables[];
+    instructions: ContextFragment[];
     /** Optional model override */
     model?: AgentModel;
     /** Maximum retry attempts on validation failure (default: 3) */

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":"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"}
+{"version":3,"file":"sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql.agent.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,KAAK,eAAe,EAMrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,wCAAwC;IACxC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,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;AAiBD,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,CAgFvE"}

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

@@ -1,10 +1,10 @@
 import { type AgentModel } from '@deepagents/agent';
-import { type Teachables } from '../teach/teachables.ts';
+import { type ContextFragment } from '@deepagents/context';
 export interface GenerateToTeachingsOptions {
     model?: AgentModel;
 }
 export declare function toTeachings(input: {
     schema: string;
     context?: string;
-}, options?: GenerateToTeachingsOptions): Promise<Teachables[]>;
+}, options?: GenerateToTeachingsOptions): Promise<ContextFragment[]>;
 //# 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":"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"}
+{"version":3,"file":"teachables.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/teachables.agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,KAAK,eAAe,EAgBrB,MAAM,qBAAqB,CAAC;AAsF7B,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,eAAe,EAAE,CAAC,CAqH5B"}

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

@@ -1,77 +1,3 @@
 import { type Tool } from 'ai';
-import type { TeachablesStore } from '../memory/store.ts';
-import type { GeneratedTeachable } from '../teach/teachables.ts';
 export type RenderingTools = Record<string, Tool<unknown, never>>;
-export declare const memoryTools: {
-    remember_memory: Tool<{
-        memory: {
-            type: "identity";
-            description: string;
-        } | {
-            type: "alias";
-            term: string;
-            meaning: string;
-        } | {
-            type: "preference";
-            aspect: string;
-            value: string;
-        } | {
-            type: "context";
-            description: string;
-        } | {
-            type: "correction";
-            subject: string;
-            clarification: string;
-        };
-    }, string>;
-    forget_memory: Tool<{
-        id: string;
-    }, string>;
-    recall_memory: Tool<{
-        type?: "identity" | "alias" | "preference" | "context" | "correction" | undefined;
-    }, string | {
-        id: string;
-        type: "term" | "hint" | "guardrail" | "explain" | "example" | "clarification" | "workflow" | "quirk" | "styleGuide" | "analogy" | "glossary" | "identity" | "persona" | "alias" | "preference" | "context" | "correction";
-        data: GeneratedTeachable;
-        createdAt: string;
-    }[]>;
-    update_memory: Tool<{
-        memory: {
-            type: "identity";
-            description: string;
-        } | {
-            type: "alias";
-            term: string;
-            meaning: string;
-        } | {
-            type: "preference";
-            aspect: string;
-            value: string;
-        } | {
-            type: "context";
-            description: string;
-        } | {
-            type: "correction";
-            subject: string;
-            clarification: string;
-        };
-        id: string;
-    }, string>;
-};
-/**
- * An agent that does Table Augmented Generation for Text-to-SQL tasks.
- */
-export declare const t_a_g: import("@deepagents/agent").Agent<{
-    sql: string;
-}, {
-    introspection: string;
-    teachings: string;
-    memory?: TeachablesStore;
-    userId?: string;
-}, {
-    introspection: string;
-    teachings: string;
-    memory?: TeachablesStore;
-    userId?: string;
-}>;
 //# sourceMappingURL=text2sql.agent.d.ts.map

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;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"}
+{"version":3,"file":"text2sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/text2sql.agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,IAAI,CAAC;AAQrC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC"}

package/dist/lib/checkpoint.d.ts

@@ -24,9 +24,9 @@ interface PointData {
     entries: PointEntry[];
 }
 export declare class Checkpoint {
+    private points;
     private path;
     private configHash;
-    private points;
     private constructor();
     /**
      * Load checkpoint from file, or return empty checkpoint if none exists.

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

@@ -1 +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"}
+{"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;IACrB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAqB;IAEvC,OAAO;IAUP;;;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;;IAElB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,OAAO,CAAsB;gBAEzB,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAQzD;;;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"}

package/dist/lib/fragments/schema.d.ts

@@ -0,0 +1,214 @@
+import type { ContextFragment } from '@deepagents/context';
+/**
+ * Schema fragment builders.
+ *
+ * These fragments represent database schema metadata that can be injected
+ * into AI prompts. Use with renderers (XML, Markdown, TOML, TOON) to format.
+ *
+ * @example
+ * ```ts
+ * import { dialectInfo, table, column, relationship } from '@deepagents/text2sql';
+ *
+ * const schemaFragments = [
+ *   dialectInfo({ dialect: 'PostgreSQL', version: '14.5' }),
+ *   table({
+ *     name: 'users',
+ *     columns: [
+ *       column({ name: 'id', type: 'integer', pk: true }),
+ *       column({ name: 'email', type: 'varchar', unique: true }),
+ *     ],
+ *   }),
+ * ];
+ * ```
+ */
+/**
+ * Database dialect and version information.
+ *
+ * @param input.dialect - Database type (PostgreSQL, SQLite, SQL Server, etc.)
+ * @param input.version - Database version string
+ * @param input.database - Database name
+ *
+ * @example
+ * dialectInfo({ dialect: 'PostgreSQL', version: '14.5', database: 'myapp' })
+ */
+export declare function dialectInfo(input: {
+    dialect: string;
+    version?: string;
+    database?: string;
+}): ContextFragment;
+/**
+ * Database table with columns and optional metadata.
+ *
+ * @param input.name - Table name
+ * @param input.schema - Schema name (e.g., 'public' for PostgreSQL)
+ * @param input.rowCount - Approximate row count
+ * @param input.sizeHint - Size category for query optimization hints
+ * @param input.columns - Array of column() fragments
+ * @param input.indexes - Array of index() fragments
+ * @param input.constraints - Array of constraint() fragments
+ *
+ * @example
+ * table({
+ *   name: 'users',
+ *   rowCount: 1500,
+ *   sizeHint: 'medium',
+ *   columns: [
+ *     column({ name: 'id', type: 'integer', pk: true }),
+ *     column({ name: 'email', type: 'varchar', unique: true, indexed: true }),
+ *   ],
+ *   indexes: [
+ *     index({ name: 'idx_email', columns: ['email'], unique: true }),
+ *   ],
+ * })
+ */
+export declare function table(input: {
+    name: string;
+    schema?: string;
+    rowCount?: number;
+    sizeHint?: 'tiny' | 'small' | 'medium' | 'large' | 'huge';
+    columns: ContextFragment[];
+    indexes?: ContextFragment[];
+    constraints?: ContextFragment[];
+}): ContextFragment;
+/**
+ * Table column with type and annotations.
+ *
+ * @param input.name - Column name
+ * @param input.type - Column data type (e.g., 'integer', 'varchar(255)')
+ * @param input.pk - Is primary key
+ * @param input.fk - Foreign key reference in "table.column" format
+ * @param input.unique - Has unique constraint
+ * @param input.notNull - Has NOT NULL constraint
+ * @param input.default - Default value expression
+ * @param input.indexed - Has index on this column
+ * @param input.values - Enum or low cardinality values
+ * @param input.stats - Column statistics (min, max, null fraction)
+ *
+ * @example
+ * column({
+ *   name: 'status',
+ *   type: 'varchar',
+ *   notNull: true,
+ *   indexed: true,
+ *   values: ['active', 'inactive', 'suspended'],
+ * })
+ */
+export declare function column(input: {
+    name: string;
+    type: string;
+    pk?: boolean;
+    fk?: string;
+    unique?: boolean;
+    notNull?: boolean;
+    default?: string;
+    indexed?: boolean;
+    values?: string[];
+    stats?: {
+        min?: string;
+        max?: string;
+        nullFraction?: number;
+    };
+}): ContextFragment;
+/**
+ * Table index.
+ *
+ * @param input.name - Index name
+ * @param input.columns - Columns included in the index
+ * @param input.unique - Is unique index
+ * @param input.type - Index type (BTREE, HASH, GIN, etc.)
+ *
+ * @example
+ * index({ name: 'idx_user_email', columns: ['email'], unique: true, type: 'BTREE' })
+ */
+export declare function index(input: {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    type?: string;
+}): ContextFragment;
+/**
+ * Table constraint (CHECK, UNIQUE, PRIMARY_KEY, FOREIGN_KEY, etc).
+ *
+ * @param input.name - Constraint name
+ * @param input.type - Constraint type
+ * @param input.columns - Columns involved in the constraint
+ * @param input.definition - CHECK constraint SQL definition
+ * @param input.defaultValue - DEFAULT constraint value
+ * @param input.referencedTable - For FK: referenced table name
+ * @param input.referencedColumns - For FK: referenced column names
+ *
+ * @example
+ * constraint({
+ *   name: 'chk_amount_positive',
+ *   type: 'CHECK',
+ *   definition: 'amount > 0',
+ * })
+ *
+ * @example
+ * constraint({
+ *   name: 'fk_order_user',
+ *   type: 'FOREIGN_KEY',
+ *   columns: ['user_id'],
+ *   referencedTable: 'users',
+ *   referencedColumns: ['id'],
+ * })
+ */
+export declare function constraint(input: {
+    name: string;
+    type: 'CHECK' | 'UNIQUE' | 'NOT_NULL' | 'DEFAULT' | 'PRIMARY_KEY' | 'FOREIGN_KEY';
+    columns?: string[];
+    definition?: string;
+    defaultValue?: string;
+    referencedTable?: string;
+    referencedColumns?: string[];
+}): ContextFragment;
+/**
+ * Database view.
+ *
+ * @param input.name - View name
+ * @param input.schema - Schema name
+ * @param input.columns - Array of column() fragments
+ * @param input.definition - View SQL definition
+ *
+ * @example
+ * view({
+ *   name: 'active_users',
+ *   columns: [
+ *     column({ name: 'id', type: 'integer' }),
+ *     column({ name: 'email', type: 'varchar' }),
+ *   ],
+ *   definition: "SELECT id, email FROM users WHERE status = 'active'",
+ * })
+ */
+export declare function view(input: {
+    name: string;
+    schema?: string;
+    columns: ContextFragment[];
+    definition?: string;
+}): ContextFragment;
+/**
+ * Relationship between tables (foreign key connection).
+ *
+ * @param input.from - Source table and columns
+ * @param input.to - Referenced table and columns
+ * @param input.cardinality - Relationship cardinality
+ *
+ * @example
+ * relationship({
+ *   from: { table: 'orders', columns: ['user_id'] },
+ *   to: { table: 'users', columns: ['id'] },
+ *   cardinality: 'many-to-one',
+ * })
+ */
+export declare function relationship(input: {
+    from: {
+        table: string;
+        columns: string[];
+    };
+    to: {
+        table: string;
+        columns: string[];
+    };
+    cardinality?: 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+}): ContextFragment;
+//# sourceMappingURL=schema.d.ts.map

package/dist/lib/fragments/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/schema.ts"],"names":[],"mappings":"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"}

package/dist/lib/instructions.d.ts

@@ -1,3 +1,11 @@
-export * from './teach/teachables.ts';
-export { default } from './teach/teachables.ts';
+import { type ContextFragment } from '@deepagents/context';
+export interface TeachingsOptions {
+    /**
+     * Controls date/time clarification behavior:
+     * - 'strict': Ask for clarification when date range is missing (production default)
+     * - false: Skip date clarifications, assume all matching data (useful for evals/benchmarks)
+     */
+    date?: 'strict' | false;
+}
+export declare function guidelines(options?: TeachingsOptions): 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,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAarB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CACzB;AA0ID,wBAAgB,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,EAAE,CAuQ5E"}