@deepagents/text2sql 0.13.1 → 0.14.0

package/dist/lib/synthesis/index.js

@@ -171,7 +171,7 @@ import {
   isTextUIPart,
   isToolOrDynamicToolUIPart
 } from "ai";
-import dedent from "dedent";
+import dedent2 from "dedent";
 import z from "zod";
 
 // packages/context/dist/index.js
@@ -188,6 +188,7 @@ import spawn2 from "nano-spawn";
 import {
   createBashTool
 } from "bash-tool";
+import dedent from "dedent";
 import YAML from "yaml";
 import { DatabaseSync } from "node:sqlite";
 import { groq } from "@ai-sdk/groq";
@@ -409,7 +410,7 @@ function assistantText(content, options) {
     parts: [{ type: "text", text: content }]
   });
 }
-var LAZY_ID = Symbol("lazy-id");
+var LAZY_ID = Symbol.for("@deepagents/context:lazy-id");
 function isLazyFragment(fragment2) {
   return LAZY_ID in fragment2;
 }
@@ -784,7 +785,7 @@ var ContextEngine = class {
   async #createBranchFrom(messageId, switchTo) {
     const branches = await this.#store.listBranches(this.#chatId);
     const samePrefix = branches.filter(
-      (b) => b.name === this.#branchName || b.name.startsWith(`${this.#branchName}-v`)
+      (it) => it.name === this.#branchName || it.name.startsWith(`${this.#branchName}-v`)
     );
     const newBranchName = `${this.#branchName}-v${samePrefix.length + 1}`;
     const newBranch = {
@@ -812,6 +813,15 @@ var ContextEngine = class {
       createdAt: newBranch.createdAt
     };
   }
+  /**
+   * Rewind to a message without clearing pending messages.
+   * Used internally when saving an update to an existing message.
+   */
+  async #rewindForUpdate(messageId) {
+    const pendingBackup = [...this.#pendingMessages];
+    await this.rewind(messageId);
+    this.#pendingMessages = pendingBackup;
+  }
   /**
    * Get the current chat ID.
    */
@@ -896,7 +906,18 @@ var ContextEngine = class {
         messages.push(message(msg.data).codec?.decode());
       }
     }
+    for (let i = 0; i < this.#pendingMessages.length; i++) {
+      const fragment2 = this.#pendingMessages[i];
+      if (isLazyFragment(fragment2)) {
+        this.#pendingMessages[i] = await this.#resolveLazyFragment(fragment2);
+      }
+    }
     for (const fragment2 of this.#pendingMessages) {
+      if (!fragment2.codec) {
+        throw new Error(
+          `Fragment "${fragment2.name}" is missing codec. Lazy fragments must be resolved before decode.`
+        );
+      }
       const decoded = fragment2.codec.decode();
       messages.push(decoded);
     }
@@ -927,9 +948,24 @@ var ContextEngine = class {
         this.#pendingMessages[i] = await this.#resolveLazyFragment(fragment2);
       }
     }
+    for (const fragment2 of this.#pendingMessages) {
+      if (fragment2.id) {
+        const existing = await this.#store.getMessage(fragment2.id);
+        if (existing && existing.parentId) {
+          await this.#rewindForUpdate(existing.parentId);
+          fragment2.id = crypto.randomUUID();
+          break;
+        }
+      }
+    }
     let parentId = this.#branch.headMessageId;
     const now = Date.now();
     for (const fragment2 of this.#pendingMessages) {
+      if (!fragment2.codec) {
+        throw new Error(
+          `Fragment "${fragment2.name}" is missing codec. Lazy fragments must be resolved before encode.`
+        );
+      }
       const messageData = {
         id: fragment2.id ?? crypto.randomUUID(),
         chatId: this.#chatId,
@@ -1289,33 +1325,28 @@ var ContextEngine = class {
     return void 0;
   }
   /**
-   * Extract skill path mappings from available_skills fragments.
-   * Returns array of { host, sandbox } for mounting in sandbox filesystem.
-   *
-   * Reads the original `paths` configuration stored in fragment metadata
-   * by the skills() fragment helper.
+   * Extract skill mounts from available_skills fragments.
+   * Returns unified mount array where entries with `name` are individual skills.
    *
    * @example
    * ```ts
    * const context = new ContextEngine({ store, chatId, userId })
    *   .set(skills({ paths: [{ host: './skills', sandbox: '/skills' }] }));
    *
-   * const mounts = context.getSkillMounts();
-   * // [{ host: './skills', sandbox: '/skills' }]
+   * const { mounts } = context.getSkillMounts();
+   * // mounts: [{ name: 'bi-dashboards', host: './skills/bi-dashboards/SKILL.md', sandbox: '/skills/bi-dashboards/SKILL.md' }]
+   *
+   * // Extract skills only (entries with name)
+   * const skills = mounts.filter(m => m.name);
    * ```
    */
   getSkillMounts() {
-    const mounts = [];
     for (const fragment2 of this.#fragments) {
-      if (fragment2.name === "available_skills" && fragment2.metadata && Array.isArray(fragment2.metadata.paths)) {
-        for (const mapping of fragment2.metadata.paths) {
-          if (typeof mapping === "object" && mapping !== null && typeof mapping.host === "string" && typeof mapping.sandbox === "string") {
-            mounts.push({ host: mapping.host, sandbox: mapping.sandbox });
-          }
-        }
+      if (fragment2.name === "available_skills" && fragment2.metadata?.mounts) {
+        return { mounts: fragment2.metadata.mounts };
       }
     }
-    return mounts;
+    return { mounts: [] };
   }
   /**
    * Inspect the full context state for debugging.
@@ -1471,84 +1502,46 @@ function persona(input) {
     }
   };
 }
-var STORE_DDL = `
--- Chats table
--- createdAt/updatedAt: DEFAULT for insert, inline SET for updates
-CREATE TABLE IF NOT EXISTS chats (
-  id TEXT PRIMARY KEY,
-  userId TEXT NOT NULL,
-  title TEXT,
-  metadata TEXT,
-  createdAt INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
-  updatedAt INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000)
-);
-
-CREATE INDEX IF NOT EXISTS idx_chats_updatedAt ON chats(updatedAt);
-CREATE INDEX IF NOT EXISTS idx_chats_userId ON chats(userId);
+var SKILLS_INSTRUCTIONS = dedent`A skill is a set of local instructions to follow that is stored in a \`SKILL.md\` file. Below is the list of skills that can be used. Each entry includes a name, description, and file path so you can open the source for full instructions when using a specific skill.
 
--- Messages table (nodes in the DAG)
-CREATE TABLE IF NOT EXISTS messages (
-  id TEXT PRIMARY KEY,
-  chatId TEXT NOT NULL,
-  parentId TEXT,
-  name TEXT NOT NULL,
-  type TEXT,
-  data TEXT NOT NULL,
-  createdAt INTEGER NOT NULL,
-  FOREIGN KEY (chatId) REFERENCES chats(id) ON DELETE CASCADE,
-  FOREIGN KEY (parentId) REFERENCES messages(id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_messages_chatId ON messages(chatId);
-CREATE INDEX IF NOT EXISTS idx_messages_parentId ON messages(parentId);
-
--- Branches table (pointers to head messages)
-CREATE TABLE IF NOT EXISTS branches (
-  id TEXT PRIMARY KEY,
-  chatId TEXT NOT NULL,
-  name TEXT NOT NULL,
-  headMessageId TEXT,
-  isActive INTEGER NOT NULL DEFAULT 0,
-  createdAt INTEGER NOT NULL,
-  FOREIGN KEY (chatId) REFERENCES chats(id) ON DELETE CASCADE,
-  FOREIGN KEY (headMessageId) REFERENCES messages(id),
-  UNIQUE(chatId, name)
-);
-
-CREATE INDEX IF NOT EXISTS idx_branches_chatId ON branches(chatId);
-
--- Checkpoints table (pointers to message nodes)
-CREATE TABLE IF NOT EXISTS checkpoints (
-  id TEXT PRIMARY KEY,
-  chatId TEXT NOT NULL,
-  name TEXT NOT NULL,
-  messageId TEXT NOT NULL,
-  createdAt INTEGER NOT NULL,
-  FOREIGN KEY (chatId) REFERENCES chats(id) ON DELETE CASCADE,
-  FOREIGN KEY (messageId) REFERENCES messages(id),
-  UNIQUE(chatId, name)
-);
-
-CREATE INDEX IF NOT EXISTS idx_checkpoints_chatId ON checkpoints(chatId);
-
--- FTS5 virtual table for full-text search
--- messageId/chatId/name are UNINDEXED (stored but not searchable, used for filtering/joining)
--- Only 'content' is indexed for full-text search
-CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
-  messageId UNINDEXED,
-  chatId UNINDEXED,
-  name UNINDEXED,
-  content,
-  tokenize='porter unicode61'
-);
-`;
+### How to use skills
+- Discovery: The list below shows the skills available in this session (name + description + file path). Skill bodies live on disk at the listed paths.
+- Trigger rules: If the user names a skill (with \`$SkillName\` or plain text) OR the task clearly matches a skill's description shown below, you must use that skill for that turn before doing anything else. Multiple mentions mean use them all. Do not carry skills across turns unless re-mentioned.
+- Missing/blocked: If a named skill isn't in the list or the path can't be read, say so briefly and continue with the best fallback.
+- How to use a skill (progressive disclosure):
+  1) After deciding to use a skill, open its \`SKILL.md\`. Read only enough to follow the workflow.
+  2) If \`SKILL.md\` points to extra folders such as \`references/\`, load only the specific files needed for the request; don't bulk-load everything.
+  3) If \`scripts/\` exist, prefer running or patching them instead of retyping large code blocks.
+  4) If \`assets/\` or templates exist, reuse them instead of recreating from scratch.
+- Coordination and sequencing:
+  - If multiple skills apply, choose the minimal set that covers the request and state the order you'll use them.
+  - Announce which skill(s) you're using and why (one short line). If you skip an obvious skill, say why.
+- Context hygiene:
+  - Keep context small: summarize long sections instead of pasting them; only load extra files when needed.
+  - Avoid deep reference-chasing: prefer opening only files directly linked from \`SKILL.md\` unless you're blocked.
+  - When variants exist (frameworks, providers, domains), pick only the relevant reference file(s) and note that choice.
+- Safety and fallback: If a skill can't be applied cleanly (missing files, unclear instructions), state the issue, pick the next-best approach, and continue.`;
+var ddl_sqlite_default = "-- Context Store DDL for SQLite\n-- This schema implements a DAG-based message history with branching and checkpoints.\n\n-- Performance PRAGMAs (session-level, run on each connection)\nPRAGMA journal_mode = WAL;\nPRAGMA synchronous = NORMAL;\nPRAGMA cache_size = -64000;\nPRAGMA temp_store = MEMORY;\nPRAGMA mmap_size = 268435456;\n\n-- Integrity\nPRAGMA foreign_keys = ON;\n\n-- Chats table\n-- createdAt/updatedAt: DEFAULT for insert, inline SET for updates\nCREATE TABLE IF NOT EXISTS chats (\n  id TEXT PRIMARY KEY,\n  userId TEXT NOT NULL,\n  title TEXT,\n  metadata TEXT,\n  createdAt INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  updatedAt INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000)\n);\n\nCREATE INDEX IF NOT EXISTS idx_chats_updatedAt ON chats(updatedAt);\nCREATE INDEX IF NOT EXISTS idx_chats_userId ON chats(userId);\n-- Composite index for listChats(): WHERE userId = ? ORDER BY updatedAt DESC\nCREATE INDEX IF NOT EXISTS idx_chats_userId_updatedAt ON chats(userId, updatedAt DESC);\n\n-- Messages table (nodes in the DAG)\nCREATE TABLE IF NOT EXISTS messages (\n  id TEXT PRIMARY KEY,\n  chatId TEXT NOT NULL,\n  parentId TEXT,\n  name TEXT NOT NULL,\n  type TEXT,\n  data TEXT NOT NULL,\n  createdAt INTEGER NOT NULL,\n  FOREIGN KEY (chatId) REFERENCES chats(id) ON DELETE CASCADE,\n  FOREIGN KEY (parentId) REFERENCES messages(id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_messages_chatId ON messages(chatId);\nCREATE INDEX IF NOT EXISTS idx_messages_parentId ON messages(parentId);\n-- Composite index for recursive CTE parent traversal in getMessageChain()\nCREATE INDEX IF NOT EXISTS idx_messages_chatId_parentId ON messages(chatId, parentId);\n\n-- Branches table (pointers to head messages)\nCREATE TABLE IF NOT EXISTS branches (\n  id TEXT PRIMARY KEY,\n  chatId TEXT NOT NULL,\n  name TEXT NOT NULL,\n  headMessageId TEXT,\n  isActive INTEGER NOT NULL DEFAULT 0,\n  createdAt INTEGER NOT NULL,\n  FOREIGN KEY (chatId) REFERENCES chats(id) ON DELETE CASCADE,\n  FOREIGN KEY (headMessageId) REFERENCES messages(id),\n  UNIQUE(chatId, name)\n);\n\nCREATE INDEX IF NOT EXISTS idx_branches_chatId ON branches(chatId);\n-- Composite index for getActiveBranch(): WHERE chatId = ? AND isActive = 1\nCREATE INDEX IF NOT EXISTS idx_branches_chatId_isActive ON branches(chatId, isActive);\n\n-- Checkpoints table (pointers to message nodes)\nCREATE TABLE IF NOT EXISTS checkpoints (\n  id TEXT PRIMARY KEY,\n  chatId TEXT NOT NULL,\n  name TEXT NOT NULL,\n  messageId TEXT NOT NULL,\n  createdAt INTEGER NOT NULL,\n  FOREIGN KEY (chatId) REFERENCES chats(id) ON DELETE CASCADE,\n  FOREIGN KEY (messageId) REFERENCES messages(id),\n  UNIQUE(chatId, name)\n);\n\nCREATE INDEX IF NOT EXISTS idx_checkpoints_chatId ON checkpoints(chatId);\n\n-- FTS5 virtual table for full-text search\n-- messageId/chatId/name are UNINDEXED (stored but not searchable, used for filtering/joining)\n-- Only 'content' is indexed for full-text search\nCREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(\n  messageId UNINDEXED,\n  chatId UNINDEXED,\n  name UNINDEXED,\n  content,\n  tokenize='porter unicode61'\n);\n";
 var SqliteContextStore = class extends ContextStore {
   #db;
+  #statements = /* @__PURE__ */ new Map();
+  /**
+   * Get or create a prepared statement.
+   * Statements are cached for the lifetime of the store to avoid
+   * repeated SQL parsing and compilation overhead.
+   */
+  #stmt(sql) {
+    let stmt = this.#statements.get(sql);
+    if (!stmt) {
+      stmt = this.#db.prepare(sql);
+      this.#statements.set(sql, stmt);
+    }
+    return stmt;
+  }
   constructor(path3) {
     super();
     this.#db = new DatabaseSync(path3);
-    this.#db.exec("PRAGMA foreign_keys = ON");
-    this.#db.exec(STORE_DDL);
+    this.#db.exec(ddl_sqlite_default);
   }
   /**
    * Execute a function within a transaction.
@@ -1569,11 +1562,12 @@ var SqliteContextStore = class extends ContextStore {
   // Chat Operations
   // ==========================================================================
   async createChat(chat) {
-    this.#useTransaction(() => {
-      this.#db.prepare(
+    return this.#useTransaction(() => {
+      const row = this.#db.prepare(
         `INSERT INTO chats (id, userId, title, metadata)
-           VALUES (?, ?, ?, ?)`
-      ).run(
+           VALUES (?, ?, ?, ?)
+           RETURNING *`
+      ).get(
         chat.id,
         chat.userId,
         chat.title ?? null,
@@ -1583,6 +1577,14 @@ var SqliteContextStore = class extends ContextStore {
         `INSERT INTO branches (id, chatId, name, headMessageId, isActive, createdAt)
            VALUES (?, ?, 'main', NULL, 1, ?)`
       ).run(crypto.randomUUID(), chat.id, Date.now());
+      return {
+        id: row.id,
+        userId: row.userId,
+        title: row.title ?? void 0,
+        metadata: row.metadata ? JSON.parse(row.metadata) : void 0,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt
+      };
     });
   }
   async upsertChat(chat) {
@@ -1725,21 +1727,16 @@ var SqliteContextStore = class extends ContextStore {
   // Message Operations (Graph Nodes)
   // ==========================================================================
   async addMessage(message2) {
-    this.#db.prepare(
+    if (message2.parentId === message2.id) {
+      throw new Error(`Message ${message2.id} cannot be its own parent`);
+    }
+    this.#stmt(
       `INSERT INTO messages (id, chatId, parentId, name, type, data, createdAt)
-         VALUES (
-           ?1,
-           ?2,
-           CASE WHEN ?3 = ?1 THEN (SELECT parentId FROM messages WHERE id = ?1) ELSE ?3 END,
-           ?4,
-           ?5,
-           ?6,
-           ?7
-         )
-         ON CONFLICT(id) DO UPDATE SET
-           name = excluded.name,
-           type = excluded.type,
-           data = excluded.data`
+       VALUES (?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         name = excluded.name,
+         type = excluded.type,
+         data = excluded.data`
     ).run(
       message2.id,
       message2.chatId,
@@ -1750,14 +1747,16 @@ var SqliteContextStore = class extends ContextStore {
       message2.createdAt
     );
     const content = typeof message2.data === "string" ? message2.data : JSON.stringify(message2.data);
-    this.#db.prepare(`DELETE FROM messages_fts WHERE messageId = ?`).run(message2.id);
-    this.#db.prepare(
+    this.#stmt(`DELETE FROM messages_fts WHERE messageId = ?`).run(message2.id);
+    this.#stmt(
       `INSERT INTO messages_fts(messageId, chatId, name, content)
-         VALUES (?, ?, ?, ?)`
+       VALUES (?, ?, ?, ?)`
     ).run(message2.id, message2.chatId, message2.name, content);
   }
   async getMessage(messageId) {
-    const row = this.#db.prepare("SELECT * FROM messages WHERE id = ?").get(messageId);
+    const row = this.#stmt("SELECT * FROM messages WHERE id = ?").get(
+      messageId
+    );
     if (!row) {
       return void 0;
     }
@@ -1772,15 +1771,16 @@ var SqliteContextStore = class extends ContextStore {
     };
   }
   async getMessageChain(headId) {
-    const rows = this.#db.prepare(
+    const rows = this.#stmt(
       `WITH RECURSIVE chain AS (
-          SELECT *, 0 as depth FROM messages WHERE id = ?
-          UNION ALL
-          SELECT m.*, c.depth + 1 FROM messages m
-          INNER JOIN chain c ON m.id = c.parentId
-        )
-        SELECT * FROM chain
-        ORDER BY depth DESC`
+        SELECT *, 0 as depth FROM messages WHERE id = ?
+        UNION ALL
+        SELECT m.*, c.depth + 1 FROM messages m
+        INNER JOIN chain c ON m.id = c.parentId
+        WHERE c.depth < 100000
+      )
+      SELECT * FROM chain
+      ORDER BY depth DESC`
     ).all(headId);
     return rows.map((row) => ({
       id: row.id,
@@ -1793,7 +1793,7 @@ var SqliteContextStore = class extends ContextStore {
     }));
   }
   async hasChildren(messageId) {
-    const row = this.#db.prepare(
+    const row = this.#stmt(
       "SELECT EXISTS(SELECT 1 FROM messages WHERE parentId = ?) as hasChildren"
     ).get(messageId);
     return row.hasChildren === 1;
@@ -1840,7 +1840,9 @@ var SqliteContextStore = class extends ContextStore {
     };
   }
   async getActiveBranch(chatId) {
-    const row = this.#db.prepare("SELECT * FROM branches WHERE chatId = ? AND isActive = 1").get(chatId);
+    const row = this.#stmt(
+      "SELECT * FROM branches WHERE chatId = ? AND isActive = 1"
+    ).get(chatId);
     if (!row) {
       return void 0;
     }
@@ -1858,45 +1860,43 @@ var SqliteContextStore = class extends ContextStore {
     this.#db.prepare("UPDATE branches SET isActive = 1 WHERE id = ?").run(branchId);
   }
   async updateBranchHead(branchId, messageId) {
-    this.#db.prepare("UPDATE branches SET headMessageId = ? WHERE id = ?").run(messageId, branchId);
+    this.#stmt("UPDATE branches SET headMessageId = ? WHERE id = ?").run(
+      messageId,
+      branchId
+    );
   }
   async listBranches(chatId) {
-    const branches = this.#db.prepare(
+    const rows = this.#db.prepare(
       `SELECT
           b.id,
           b.name,
           b.headMessageId,
           b.isActive,
-          b.createdAt
+          b.createdAt,
+          COALESCE(
+            (
+              WITH RECURSIVE chain AS (
+                SELECT id, parentId FROM messages WHERE id = b.headMessageId
+                UNION ALL
+                SELECT m.id, m.parentId FROM messages m
+                INNER JOIN chain c ON m.id = c.parentId
+              )
+              SELECT COUNT(*) FROM chain
+            ),
+            0
+          ) as messageCount
         FROM branches b
         WHERE b.chatId = ?
         ORDER BY b.createdAt ASC`
     ).all(chatId);
-    const result = [];
-    for (const branch of branches) {
-      let messageCount = 0;
-      if (branch.headMessageId) {
-        const countRow = this.#db.prepare(
-          `WITH RECURSIVE chain AS (
-              SELECT id, parentId FROM messages WHERE id = ?
-              UNION ALL
-              SELECT m.id, m.parentId FROM messages m
-              INNER JOIN chain c ON m.id = c.parentId
-            )
-            SELECT COUNT(*) as count FROM chain`
-        ).get(branch.headMessageId);
-        messageCount = countRow.count;
-      }
-      result.push({
-        id: branch.id,
-        name: branch.name,
-        headMessageId: branch.headMessageId,
-        isActive: branch.isActive === 1,
-        messageCount,
-        createdAt: branch.createdAt
-      });
-    }
-    return result;
+    return rows.map((row) => ({
+      id: row.id,
+      name: row.name,
+      headMessageId: row.headMessageId,
+      isActive: row.isActive === 1,
+      messageCount: row.messageCount,
+      createdAt: row.createdAt
+    }));
   }
   // ==========================================================================
   // Checkpoint Operations
@@ -2149,7 +2149,7 @@ async function resolveContext(params) {
     fragment("sql", params.sql),
     fragment(
       "task",
-      dedent`
+      dedent2`
         Given the conversation above and the SQL query that was executed,
         generate a single, standalone natural language question that:
         1. Fully captures the user's intent without needing prior context
@@ -2160,7 +2160,7 @@ async function resolveContext(params) {
     ),
     fragment(
       "examples",
-      dedent`
+      dedent2`
         Conversation: "Show me customers" → "Filter to NY" → "Sort by revenue"
         SQL: SELECT * FROM customers WHERE region = 'NY' ORDER BY revenue DESC
         Question: "Show me customers in the NY region sorted by revenue"
@@ -2354,7 +2354,7 @@ var MessageExtractor = class extends PairProducer {
 
 // packages/text2sql/src/lib/synthesis/extractors/sql-extractor.ts
 import { groq as groq3 } from "@ai-sdk/groq";
-import dedent2 from "dedent";
+import dedent3 from "dedent";
 import z2 from "zod";
 var outputSchema = z2.object({
   question: z2.string().describe("A natural language question that the SQL query answers")
@@ -2405,7 +2405,7 @@ var SqlExtractor = class extends PairProducer {
         fragment("sql", sql),
         fragment(
           "task",
-          dedent2`
+          dedent3`
             Given the database schema and the SQL query above, generate a single
             natural language question that:
             1. Accurately describes what information the query retrieves
@@ -2416,7 +2416,7 @@ var SqlExtractor = class extends PairProducer {
         ),
         fragment(
           "examples",
-          dedent2`
+          dedent3`
             SQL: SELECT COUNT(*) FROM customers WHERE region = 'NY'
             Question: "How many customers do we have in New York?"
 
@@ -2491,7 +2491,7 @@ var WindowedContextExtractor = class extends BaseContextualExtractor {
 
 // packages/text2sql/src/lib/synthesis/extractors/segmented-context-extractor.ts
 import { groq as groq4 } from "@ai-sdk/groq";
-import dedent3 from "dedent";
+import dedent4 from "dedent";
 import z3 from "zod";
 var topicChangeSchema = z3.object({
   isTopicChange: z3.boolean().describe("Whether the new message represents a topic change"),
@@ -2513,7 +2513,7 @@ async function detectTopicChange(params) {
     fragment("new_message", params.newMessage),
     fragment(
       "task",
-      dedent3`
+      dedent4`
         Determine if the new message represents a significant topic change from the
         prior conversation context. A topic change occurs when:
         1. The user asks about a completely different entity/table/domain
@@ -2528,7 +2528,7 @@ async function detectTopicChange(params) {
     ),
     fragment(
       "examples",
-      dedent3`
+      dedent4`
         Context: "Show me customers in NY" → "Sort by revenue"
         New: "Filter to those with orders over $1000"
         Decision: NOT a topic change (still refining customer query)
@@ -2646,11 +2646,11 @@ import pLimit from "p-limit";
 
 // packages/text2sql/src/lib/agents/question.agent.ts
 import { groq as groq5 } from "@ai-sdk/groq";
-import dedent4 from "dedent";
+import dedent5 from "dedent";
 import z4 from "zod";
 import "@deepagents/agent";
 var complexityInstructions = {
-  simple: dedent4`
+  simple: dedent5`
     Generate simple questions that require:
     - Basic SELECT with single table
     - Simple WHERE clauses with one condition
@@ -2658,7 +2658,7 @@ var complexityInstructions = {
     - No joins required
     Examples: "How many customers do we have?", "List all products", "What is the total revenue?"
   `,
-  moderate: dedent4`
+  moderate: dedent5`
     Generate moderate questions that require:
     - JOINs between 2-3 tables
     - Multiple WHERE conditions (AND/OR)
@@ -2667,7 +2667,7 @@ var complexityInstructions = {
     - Basic subqueries
     Examples: "What are the top 5 customers by total orders?", "Which products have never been ordered?"
   `,
-  complex: dedent4`
+  complex: dedent5`
     Generate complex questions that require:
     - Multiple JOINs (3+ tables)
     - Nested subqueries or CTEs
@@ -2676,7 +2676,7 @@ var complexityInstructions = {
     - Date/time calculations
     Examples: "What is the month-over-month growth rate?", "Which customers have increased spending compared to last year?"
   `,
-  "high complex": dedent4`
+  "high complex": dedent5`
     Generate highly complex questions that require advanced SQL features:
     - Window functions (ROW_NUMBER, RANK, DENSE_RANK)
     - LAG, LEAD for comparisons
@@ -2711,7 +2711,7 @@ async function generateQuestions(params) {
     ),
     fragment(
       "task",
-      dedent4`
+      dedent5`
         Generate exactly ${count} natural language questions at the "${complexity}" complexity level.
         The questions should:
         1. Match the complexity requirements above
@@ -3014,7 +3014,7 @@ Generate ${this.options.count} questions at ${complexity} complexity.` : void 0;
 
 // packages/text2sql/src/lib/synthesis/synthesizers/breadth-evolver.ts
 import { groq as groq7 } from "@ai-sdk/groq";
-import dedent5 from "dedent";
+import dedent6 from "dedent";
 import pLimit2 from "p-limit";
 import z6 from "zod";
 import "@deepagents/agent";
@@ -3064,7 +3064,7 @@ async function paraphraseQuestion(params) {
     chatId: `paraphraser-${crypto.randomUUID()}`,
     userId: "system"
   });
-  const personaInstruction = params.persona ? dedent5`
+  const personaInstruction = params.persona ? dedent6`
         <persona role="${params.persona.role}">
           ${params.persona.perspective}
 
@@ -3072,7 +3072,7 @@ async function paraphraseQuestion(params) {
           Use their vocabulary, priorities, and framing style.
         </persona>
       ` : "";
-  const styleInstruction = params.persona?.styles && params.persona.styles.length > 0 ? dedent5`
+  const styleInstruction = params.persona?.styles && params.persona.styles.length > 0 ? dedent6`
         <communication_styles>
           Generate paraphrases using these communication styles: ${params.persona.styles.join(", ")}
 
@@ -3098,7 +3098,7 @@ async function paraphraseQuestion(params) {
     ...styleInstruction ? [fragment("communication_styles", styleInstruction)] : [],
     fragment(
       "task",
-      dedent5`
+      dedent6`
         Generate exactly ${params.count} paraphrased versions of the original question.
 
         Requirements:
@@ -3175,13 +3175,13 @@ var BreadthEvolver = class extends PairProducer {
 // packages/text2sql/src/lib/synthesis/synthesizers/depth-evolver.ts
 import { groq as groq8 } from "@ai-sdk/groq";
 import { NoObjectGeneratedError as NoObjectGeneratedError2, NoOutputGeneratedError as NoOutputGeneratedError2 } from "ai";
-import dedent6 from "dedent";
+import dedent7 from "dedent";
 import pLimit3 from "p-limit";
 import pRetry2 from "p-retry";
 import z7 from "zod";
 import "@deepagents/agent";
 var techniqueInstructions = {
-  "add-aggregation": dedent6`
+  "add-aggregation": dedent7`
     Add aggregation requirements to the question.
     Transform it to require GROUP BY, COUNT, SUM, AVG, MIN, MAX, or similar operations.
     Examples:
@@ -3189,7 +3189,7 @@ var techniqueInstructions = {
     - "List products" → "What is the average price per category?"
     - "Get employees" → "How many employees are in each department?"
   `,
-  "add-filter": dedent6`
+  "add-filter": dedent7`
     Add filtering conditions to the question.
     Transform it to require WHERE clauses with specific conditions.
     Examples:
@@ -3197,7 +3197,7 @@ var techniqueInstructions = {
     - "List customers" → "List customers who have made more than 5 purchases"
     - "Get products" → "Get products with price above $100"
   `,
-  "add-join": dedent6`
+  "add-join": dedent7`
     Add requirements that need data from related tables.
     Transform it to require JOIN operations between multiple tables.
     Examples:
@@ -3205,7 +3205,7 @@ var techniqueInstructions = {
     - "List products" → "List products with their supplier information"
     - "Get employees" → "Get employees with their department and manager names"
   `,
-  "add-reasoning": dedent6`
+  "add-reasoning": dedent7`
     Add multi-step reasoning requirements.
     Transform it to require logical deduction, comparisons, or derived calculations.
     Examples:
@@ -3213,7 +3213,7 @@ var techniqueInstructions = {
     - "List products" → "Which products are underperforming compared to their category average?"
     - "Get revenue" → "Which month had the highest growth compared to the previous month?"
   `,
-  hypothetical: dedent6`
+  hypothetical: dedent7`
     Add a hypothetical or speculative scenario.
     Transform it to require applying calculations or projections.
     Examples:
@@ -3251,7 +3251,7 @@ async function evolveQuestion(params) {
     ),
     fragment(
       "task",
-      dedent6`
+      dedent7`
         Evolve the original question using the "${params.technique}" technique.
 
         Requirements:
@@ -3396,7 +3396,7 @@ async function withRetry2(computation) {
 
 // packages/text2sql/src/lib/synthesis/synthesizers/persona-generator.ts
 import { groq as groq9 } from "@ai-sdk/groq";
-import dedent7 from "dedent";
+import dedent8 from "dedent";
 import z8 from "zod";
 import "@deepagents/agent";
 var outputSchema3 = z8.object({
@@ -3429,7 +3429,7 @@ async function generatePersonas(schemaFragments, options) {
     fragment("database_schema", schema),
     fragment(
       "task",
-      dedent7`
+      dedent8`
         Analyze the database schema and generate realistic personas representing
         the different types of users who would query this database.
 
@@ -3462,7 +3462,7 @@ async function generatePersonas(schemaFragments, options) {
     ),
     fragment(
       "example",
-      dedent7`
+      dedent8`
         For an e-commerce schema with orders, customers, products tables:
 
         {
@@ -3502,7 +3502,7 @@ async function generatePersonas(schemaFragments, options) {
 
 // packages/text2sql/src/lib/agents/teachables.agent.ts
 import { groq as groq10 } from "@ai-sdk/groq";
-import dedent8 from "dedent";
+import dedent9 from "dedent";
 import z9 from "zod";
 import "@deepagents/agent";
 var outputSchema4 = z9.object({
@@ -3572,7 +3572,7 @@ async function toTeachings(input, options) {
     ...input.context ? [fragment("additional_context", input.context)] : [],
     fragment(
       "output_structure",
-      dedent8`
+      dedent9`
         Output a JSON object with these optional arrays (include only relevant ones):
         - terms: [{ name: string, definition: string }] - Domain terminology
         - hints: [{ text: string }] - Helpful SQL generation hints
@@ -3588,7 +3588,7 @@ async function toTeachings(input, options) {
     ),
     fragment(
       "task",
-      dedent8`
+      dedent9`
         1. Analyze the schema to infer domain, relationships, and sensitive columns.
         2. Generate 3-10 fragments total across all categories, prioritizing:
            - guardrails for PII columns (email, ssn, phone, etc)