@mastra/libsql 1.2.0-alpha.0 → 1.3.0-alpha.0

package/dist/index.js

@@ -1,10 +1,11 @@
 import { createClient } from '@libsql/client';
 import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
-import { createVectorErrorId, AgentsStorage, AGENTS_SCHEMA, TABLE_AGENTS, AGENT_VERSIONS_SCHEMA, TABLE_AGENT_VERSIONS, createStorageErrorId, normalizePerPage, calculatePagination, MemoryStorage, TABLE_SCHEMAS, TABLE_THREADS, TABLE_MESSAGES, TABLE_RESOURCES, ObservabilityStorage, SPAN_SCHEMA, TABLE_SPANS, listTracesArgsSchema, toTraceSpans, ScoresStorage, SCORERS_SCHEMA, TABLE_SCORERS, transformScoreRow, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, MastraCompositeStore, TraceStatus, getSqlType, safelyParseJSON } from '@mastra/core/storage';
+import { createVectorErrorId, AgentsStorage, AGENTS_SCHEMA, TABLE_AGENTS, AGENT_VERSIONS_SCHEMA, TABLE_AGENT_VERSIONS, createStorageErrorId, normalizePerPage, calculatePagination, MemoryStorage, TABLE_SCHEMAS, TABLE_THREADS, TABLE_MESSAGES, TABLE_RESOURCES, ObservabilityStorage, SPAN_SCHEMA, TABLE_SPANS, listTracesArgsSchema, toTraceSpans, PromptBlocksStorage, PROMPT_BLOCKS_SCHEMA, TABLE_PROMPT_BLOCKS, PROMPT_BLOCK_VERSIONS_SCHEMA, TABLE_PROMPT_BLOCK_VERSIONS, ScorerDefinitionsStorage, SCORER_DEFINITIONS_SCHEMA, TABLE_SCORER_DEFINITIONS, SCORER_DEFINITION_VERSIONS_SCHEMA, TABLE_SCORER_DEFINITION_VERSIONS, ScoresStorage, SCORERS_SCHEMA, TABLE_SCORERS, transformScoreRow, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, MastraCompositeStore, TraceStatus, getSqlType, safelyParseJSON } from '@mastra/core/storage';
 import { parseSqlIdentifier, parseFieldKey } from '@mastra/core/utils';
 import { MastraVector, validateTopK, validateUpsertInput } from '@mastra/core/vector';
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import { MastraBase } from '@mastra/core/base';
+import { randomUUID } from 'crypto';
 import { MessageList } from '@mastra/core/agent';
 import { saveScorePayloadSchema } from '@mastra/core/evals';
 
@@ -1991,7 +1992,7 @@ Note: This migration may take some time for large tables.
         if (!existingColumns.has(columnName.toLowerCase()) && schema[columnName]) {
           const columnDef = schema[columnName];
           const sqlType = this.getSqlType(columnDef.type);
-          const defaultValue = this.getDefaultValue(columnDef.type);
+          const defaultValue = columnDef.nullable ? "DEFAULT NULL" : this.getDefaultValue(columnDef.type);
           const alterSql = `ALTER TABLE ${parsedTableName} ADD COLUMN "${columnName}" ${sqlType} ${defaultValue}`;
           await this.client.execute(alterSql);
           this.logger.debug(`LibSQLDB: Added column ${columnName} to table ${tableName}`);
@@ -2073,6 +2074,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       schema: AGENTS_SCHEMA,
       ifNotExists: ["status", "authorId"]
     });
+    await this.#migrateToolsToJsonbFormat();
     await this.#cleanupStaleDrafts();
   }
   /**
@@ -2124,7 +2126,7 @@ var AgentsLibSQL = class extends AgentsStorage {
           versionNumber: 1,
           name: row.name ?? agentId,
           description: row.description ?? null,
-          instructions: row.instructions ?? "",
+          instructions: this.serializeInstructions(row.instructions ?? ""),
           model: row.model ?? "{}",
           tools: row.tools ?? null,
           defaultOptions: row.defaultOptions ?? null,
@@ -2173,6 +2175,52 @@ var AgentsLibSQL = class extends AgentsStorage {
     } catch {
     }
   }
+  /**
+   * Migrates the tools field from string[] format to JSONB format { "tool-key": { "description": "..." } }.
+   * This handles the transition from the old format where tools were stored as an array of string keys
+   * to the new format where tools can have per-agent description overrides.
+   */
+  async #migrateToolsToJsonbFormat() {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT id, tools FROM "${TABLE_AGENT_VERSIONS}" WHERE tools IS NOT NULL`
+      });
+      if (!result.rows || result.rows.length === 0) {
+        return;
+      }
+      for (const row of result.rows) {
+        const toolsValue = row.tools;
+        let parsedTools;
+        try {
+          if (typeof toolsValue === "string") {
+            parsedTools = JSON.parse(toolsValue);
+          } else if (toolsValue instanceof ArrayBuffer) {
+            const decoder = new TextDecoder();
+            parsedTools = JSON.parse(decoder.decode(toolsValue));
+          } else {
+            parsedTools = toolsValue;
+          }
+        } catch {
+          continue;
+        }
+        if (Array.isArray(parsedTools)) {
+          const toolsObject = {};
+          for (const toolKey of parsedTools) {
+            if (typeof toolKey === "string") {
+              toolsObject[toolKey] = {};
+            }
+          }
+          await this.#client.execute({
+            sql: `UPDATE "${TABLE_AGENT_VERSIONS}" SET tools = ? WHERE id = ?`,
+            args: [JSON.stringify(toolsObject), row.id]
+          });
+        }
+      }
+      this.logger?.info?.(`Migrated agent version tools from array to object format`);
+    } catch (error) {
+      this.logger?.warn?.("Failed to migrate tools to JSONB format:", error);
+    }
+  }
   async dangerouslyClearAll() {
     await this.#db.deleteData({ tableName: TABLE_AGENT_VERSIONS });
     await this.#db.deleteData({ tableName: TABLE_AGENTS });
@@ -2222,7 +2270,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       updatedAt: new Date(row.updatedAt)
     };
   }
-  async getAgentById({ id }) {
+  async getById(id) {
     try {
       const result = await this.#db.select({
         tableName: TABLE_AGENTS,
@@ -2230,6 +2278,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       });
       return result ? this.parseRow(result) : null;
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "GET_AGENT_BY_ID", "FAILED"),
@@ -2241,7 +2290,8 @@ var AgentsLibSQL = class extends AgentsStorage {
       );
     }
   }
-  async createAgent({ agent }) {
+  async create(input) {
+    const { agent } = input;
     try {
       const now = /* @__PURE__ */ new Date();
       await this.#db.insert({
@@ -2266,7 +2316,7 @@ var AgentsLibSQL = class extends AgentsStorage {
         changedFields: Object.keys(snapshotConfig),
         changeMessage: "Initial version"
       });
-      const created = await this.getAgentById({ id: agent.id });
+      const created = await this.getById(agent.id);
       if (!created) {
         throw new MastraError({
           id: createStorageErrorId("LIBSQL", "CREATE_AGENT", "NOT_FOUND_AFTER_CREATE"),
@@ -2292,9 +2342,10 @@ var AgentsLibSQL = class extends AgentsStorage {
       );
     }
   }
-  async updateAgent({ id, ...updates }) {
+  async update(input) {
+    const { id, ...updates } = input;
     try {
-      const existingAgent = await this.getAgentById({ id });
+      const existingAgent = await this.getById(id);
       if (!existingAgent) {
         throw new MastraError({
           id: createStorageErrorId("LIBSQL", "UPDATE_AGENT", "NOT_FOUND"),
@@ -2333,14 +2384,17 @@ var AgentsLibSQL = class extends AgentsStorage {
             latestSnapshot[field] = latestVersion[field];
           }
         }
+        const sanitizedConfigFields = Object.fromEntries(
+          Object.entries(configFields).map(([key, value]) => [key, value === null ? void 0 : value])
+        );
         const versionInput = {
           id: crypto.randomUUID(),
           agentId: id,
           versionNumber: nextVersionNumber,
           ...latestSnapshot,
           // Start from latest version
-          ...configFields,
-          // Apply updates
+          ...sanitizedConfigFields,
+          // Apply updates (null values converted to undefined)
           changedFields: Object.keys(configFields),
           changeMessage: `Updated: ${Object.keys(configFields).join(", ")}`
         };
@@ -2363,7 +2417,7 @@ var AgentsLibSQL = class extends AgentsStorage {
           data
         });
       }
-      const updatedAgent = await this.getAgentById({ id });
+      const updatedAgent = await this.getById(id);
       if (!updatedAgent) {
         throw new MastraError({
           id: createStorageErrorId("LIBSQL", "UPDATE_AGENT", "NOT_FOUND_AFTER_UPDATE"),
@@ -2389,14 +2443,15 @@ var AgentsLibSQL = class extends AgentsStorage {
       );
     }
   }
-  async deleteAgent({ id }) {
+  async delete(id) {
     try {
-      await this.deleteVersionsByAgentId(id);
+      await this.deleteVersionsByParentId(id);
       await this.#db.delete({
         tableName: TABLE_AGENTS,
         keys: { id }
       });
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "DELETE_AGENT", "FAILED"),
@@ -2408,7 +2463,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       );
     }
   }
-  async listAgents(args) {
+  async list(args) {
     const { page = 0, perPage: perPageInput, orderBy } = args || {};
     const { field, direction } = this.parseOrderBy(orderBy);
     if (page < 0) {
@@ -2451,6 +2506,7 @@ var AgentsLibSQL = class extends AgentsStorage {
         hasMore: perPageInput === false ? false : offset + perPage < total
       };
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "LIST_AGENTS", "FAILED"),
@@ -2461,88 +2517,6 @@ var AgentsLibSQL = class extends AgentsStorage {
       );
     }
   }
-  async listAgentsResolved(args) {
-    const { page = 0, perPage: perPageInput, orderBy } = args || {};
-    const { field, direction } = this.parseOrderBy(orderBy);
-    if (page < 0) {
-      throw new MastraError(
-        {
-          id: createStorageErrorId("LIBSQL", "LIST_AGENTS_RESOLVED", "INVALID_PAGE"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          details: { page }
-        },
-        new Error("page must be >= 0")
-      );
-    }
-    const perPage = normalizePerPage(perPageInput, 100);
-    const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
-    try {
-      const total = await this.#db.selectTotalCount({ tableName: TABLE_AGENTS });
-      if (total === 0) {
-        return {
-          agents: [],
-          total: 0,
-          page,
-          perPage: perPageForResponse,
-          hasMore: false
-        };
-      }
-      const limitValue = perPageInput === false ? total : perPage;
-      const agents = await this.#db.selectMany({
-        tableName: TABLE_AGENTS,
-        orderBy: `"${field}" ${direction}`,
-        limit: limitValue,
-        offset
-      });
-      const resolvedAgents = await Promise.all(
-        agents.map(async (agent) => {
-          let version = null;
-          if (agent.activeVersionId) {
-            version = await this.getVersion(agent.activeVersionId);
-          }
-          if (!version) {
-            version = await this.getLatestVersion(agent.id);
-          }
-          if (!version) {
-            return agent;
-          }
-          return {
-            ...agent,
-            name: version.name,
-            description: version.description,
-            instructions: version.instructions,
-            model: version.model,
-            tools: version.tools,
-            defaultOptions: version.defaultOptions,
-            workflows: version.workflows,
-            agents: version.agents,
-            integrationTools: version.integrationTools,
-            inputProcessors: version.inputProcessors,
-            outputProcessors: version.outputProcessors,
-            memory: version.memory,
-            scorers: version.scorers
-          };
-        })
-      );
-      return {
-        agents: resolvedAgents,
-        total,
-        page,
-        perPage: perPageForResponse,
-        hasMore: perPageInput === false ? false : offset + perPage < total
-      };
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createStorageErrorId("LIBSQL", "LIST_AGENTS_RESOLVED", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
-        },
-        error
-      );
-    }
-  }
   // ==========================================================================
   // Agent Version Methods
   // ==========================================================================
@@ -2557,7 +2531,7 @@ var AgentsLibSQL = class extends AgentsStorage {
           versionNumber: input.versionNumber,
           name: input.name ?? null,
           description: input.description ?? null,
-          instructions: input.instructions,
+          instructions: this.serializeInstructions(input.instructions),
           model: input.model,
           tools: input.tools ?? null,
           defaultOptions: input.defaultOptions ?? null,
@@ -2578,6 +2552,7 @@ var AgentsLibSQL = class extends AgentsStorage {
         createdAt: now
       };
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "CREATE_VERSION", "FAILED"),
@@ -2600,6 +2575,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       }
       return this.parseVersionRow(result);
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "GET_VERSION", "FAILED"),
@@ -2626,6 +2602,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       }
       return this.parseVersionRow(rows[0]);
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "GET_VERSION_BY_NUMBER", "FAILED"),
@@ -2653,6 +2630,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       }
       return this.parseVersionRow(rows[0]);
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "GET_LATEST_VERSION", "FAILED"),
@@ -2717,6 +2695,7 @@ var AgentsLibSQL = class extends AgentsStorage {
         hasMore: perPageInput === false ? false : offset + perPage < total
       };
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "LIST_VERSIONS", "FAILED"),
@@ -2735,6 +2714,7 @@ var AgentsLibSQL = class extends AgentsStorage {
         keys: { id }
       });
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "DELETE_VERSION", "FAILED"),
@@ -2746,13 +2726,13 @@ var AgentsLibSQL = class extends AgentsStorage {
       );
     }
   }
-  async deleteVersionsByAgentId(agentId) {
+  async deleteVersionsByParentId(entityId) {
     try {
       const versions = await this.#db.selectMany({
         tableName: TABLE_AGENT_VERSIONS,
         whereClause: {
           sql: "WHERE agentId = ?",
-          args: [agentId]
+          args: [entityId]
         }
       });
       for (const version of versions) {
@@ -2762,12 +2742,13 @@ var AgentsLibSQL = class extends AgentsStorage {
         });
       }
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "DELETE_VERSIONS_BY_AGENT_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { agentId }
+          details: { agentId: entityId }
         },
         error
       );
@@ -2784,6 +2765,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       });
       return count;
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: createStorageErrorId("LIBSQL", "COUNT_VERSIONS", "FAILED"),
@@ -2798,6 +2780,18 @@ var AgentsLibSQL = class extends AgentsStorage {
   // ==========================================================================
   // Private Helper Methods
   // ==========================================================================
+  serializeInstructions(instructions) {
+    return Array.isArray(instructions) ? JSON.stringify(instructions) : instructions;
+  }
+  deserializeInstructions(raw) {
+    if (!raw) return raw;
+    try {
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) return parsed;
+    } catch {
+    }
+    return raw;
+  }
   parseVersionRow(row) {
     return {
       id: row.id,
@@ -2805,7 +2799,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       versionNumber: row.versionNumber,
       name: row.name,
       description: row.description,
-      instructions: row.instructions,
+      instructions: this.deserializeInstructions(row.instructions),
       model: this.parseJson(row.model, "model"),
       tools: this.parseJson(row.tools, "tools"),
       defaultOptions: this.parseJson(row.defaultOptions, "defaultOptions"),
@@ -2851,7 +2845,22 @@ var MemoryLibSQL = class extends MemoryStorage {
       await this.#db.alterTable({
         tableName: OM_TABLE,
         schema: omSchema,
-        ifNotExists: ["observedMessageIds", "observedTimezone"]
+        ifNotExists: [
+          "observedMessageIds",
+          "observedTimezone",
+          "bufferedObservations",
+          "bufferedObservationTokens",
+          "bufferedMessageIds",
+          "bufferedReflection",
+          "bufferedReflectionTokens",
+          "bufferedReflectionInputTokens",
+          "reflectedObservationLineCount",
+          "bufferedObservationChunks",
+          "isBufferingObservation",
+          "isBufferingReflection",
+          "lastBufferedAtTokens",
+          "lastBufferedAtTime"
+        ]
       });
     }
     await this.#db.alterTable({
@@ -3895,12 +3904,26 @@ var MemoryLibSQL = class extends MemoryStorage {
       originType: row.originType || "initial",
       generationCount: Number(row.generationCount || 0),
       activeObservations: row.activeObservations || "",
+      // Handle new chunk-based structure
+      bufferedObservationChunks: row.bufferedObservationChunks ? typeof row.bufferedObservationChunks === "string" ? JSON.parse(row.bufferedObservationChunks) : row.bufferedObservationChunks : void 0,
+      // Deprecated fields (for backward compatibility)
       bufferedObservations: row.activeObservationsPendingUpdate || void 0,
+      bufferedObservationTokens: row.bufferedObservationTokens ? Number(row.bufferedObservationTokens) : void 0,
+      bufferedMessageIds: void 0,
+      // Use bufferedObservationChunks instead
+      bufferedReflection: row.bufferedReflection || void 0,
+      bufferedReflectionTokens: row.bufferedReflectionTokens ? Number(row.bufferedReflectionTokens) : void 0,
+      bufferedReflectionInputTokens: row.bufferedReflectionInputTokens ? Number(row.bufferedReflectionInputTokens) : void 0,
+      reflectedObservationLineCount: row.reflectedObservationLineCount ? Number(row.reflectedObservationLineCount) : void 0,
       totalTokensObserved: Number(row.totalTokensObserved || 0),
       observationTokenCount: Number(row.observationTokenCount || 0),
       pendingMessageTokens: Number(row.pendingMessageTokens || 0),
       isReflecting: Boolean(row.isReflecting),
       isObserving: Boolean(row.isObserving),
+      isBufferingObservation: row.isBufferingObservation === true || row.isBufferingObservation === "true" || row.isBufferingObservation === 1,
+      isBufferingReflection: row.isBufferingReflection === true || row.isBufferingReflection === "true" || row.isBufferingReflection === 1,
+      lastBufferedAtTokens: typeof row.lastBufferedAtTokens === "number" ? row.lastBufferedAtTokens : parseInt(String(row.lastBufferedAtTokens ?? "0"), 10) || 0,
+      lastBufferedAtTime: row.lastBufferedAtTime ? new Date(String(row.lastBufferedAtTime)) : null,
       config: row.config ? JSON.parse(row.config) : {},
       metadata: row.metadata ? JSON.parse(row.metadata) : void 0,
       observedMessageIds: row.observedMessageIds ? JSON.parse(row.observedMessageIds) : void 0,
@@ -3972,6 +3995,10 @@ var MemoryLibSQL = class extends MemoryStorage {
         pendingMessageTokens: 0,
         isReflecting: false,
         isObserving: false,
+        isBufferingObservation: false,
+        isBufferingReflection: false,
+        lastBufferedAtTokens: 0,
+        lastBufferedAtTime: null,
         config: input.config,
         observedTimezone: input.observedTimezone
       };
@@ -3981,8 +4008,9 @@ var MemoryLibSQL = class extends MemoryStorage {
           "activeObservations", "activeObservationsPendingUpdate",
           "originType", config, "generationCount", "lastObservedAt", "lastReflectionAt",
           "pendingMessageTokens", "totalTokensObserved", "observationTokenCount",
-          "isObserving", "isReflecting", "observedTimezone", "createdAt", "updatedAt"
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          "isObserving", "isReflecting", "isBufferingObservation", "isBufferingReflection", "lastBufferedAtTokens", "lastBufferedAtTime",
+          "observedTimezone", "createdAt", "updatedAt"
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
         args: [
           id,
           lookupKey,
@@ -4001,6 +4029,14 @@ var MemoryLibSQL = class extends MemoryStorage {
           0,
           false,
           false,
+          false,
+          // isBufferingObservation
+          false,
+          // isBufferingReflection
+          0,
+          // lastBufferedAtTokens
+          null,
+          // lastBufferedAtTime
           input.observedTimezone || null,
           now.toISOString(),
           now.toISOString()
@@ -4088,6 +4124,10 @@ var MemoryLibSQL = class extends MemoryStorage {
         pendingMessageTokens: 0,
         isReflecting: false,
         isObserving: false,
+        isBufferingObservation: false,
+        isBufferingReflection: false,
+        lastBufferedAtTokens: 0,
+        lastBufferedAtTime: null,
         config: input.currentRecord.config,
         metadata: input.currentRecord.metadata,
         observedTimezone: input.currentRecord.observedTimezone
@@ -4098,8 +4138,9 @@ var MemoryLibSQL = class extends MemoryStorage {
           "activeObservations", "activeObservationsPendingUpdate",
           "originType", config, "generationCount", "lastObservedAt", "lastReflectionAt",
           "pendingMessageTokens", "totalTokensObserved", "observationTokenCount",
-          "isObserving", "isReflecting", "observedTimezone", "createdAt", "updatedAt"
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          "isObserving", "isReflecting", "isBufferingObservation", "isBufferingReflection", "lastBufferedAtTokens", "lastBufferedAtTime",
+          "observedTimezone", "createdAt", "updatedAt"
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
         args: [
           id,
           lookupKey,
@@ -4117,7 +4158,17 @@ var MemoryLibSQL = class extends MemoryStorage {
           record.totalTokensObserved,
           record.observationTokenCount,
           false,
+          // isObserving
+          false,
+          // isReflecting
           false,
+          // isBufferingObservation
+          false,
+          // isBufferingReflection
+          0,
+          // lastBufferedAtTokens
+          null,
+          // lastBufferedAtTime
           record.observedTimezone || null,
           now.toISOString(),
           now.toISOString()
@@ -4196,6 +4247,73 @@ var MemoryLibSQL = class extends MemoryStorage {
       );
     }
   }
+  async setBufferingObservationFlag(id, isBuffering, lastBufferedAtTokens) {
+    try {
+      const nowStr = (/* @__PURE__ */ new Date()).toISOString();
+      let sql;
+      let args;
+      if (lastBufferedAtTokens !== void 0) {
+        sql = `UPDATE "${OM_TABLE}" SET "isBufferingObservation" = ?, "lastBufferedAtTokens" = ?, "updatedAt" = ? WHERE id = ?`;
+        args = [isBuffering, lastBufferedAtTokens, nowStr, id];
+      } else {
+        sql = `UPDATE "${OM_TABLE}" SET "isBufferingObservation" = ?, "updatedAt" = ? WHERE id = ?`;
+        args = [isBuffering, nowStr, id];
+      }
+      const result = await this.#client.execute({ sql, args });
+      if (result.rowsAffected === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "SET_BUFFERING_OBSERVATION_FLAG", "NOT_FOUND"),
+          text: `Observational memory record not found: ${id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id, isBuffering, lastBufferedAtTokens: lastBufferedAtTokens ?? null }
+        });
+      }
+    } catch (error) {
+      if (error instanceof MastraError) {
+        throw error;
+      }
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "SET_BUFFERING_OBSERVATION_FLAG", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id, isBuffering, lastBufferedAtTokens: lastBufferedAtTokens ?? null }
+        },
+        error
+      );
+    }
+  }
+  async setBufferingReflectionFlag(id, isBuffering) {
+    try {
+      const result = await this.#client.execute({
+        sql: `UPDATE "${OM_TABLE}" SET "isBufferingReflection" = ?, "updatedAt" = ? WHERE id = ?`,
+        args: [isBuffering, (/* @__PURE__ */ new Date()).toISOString(), id]
+      });
+      if (result.rowsAffected === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "SET_BUFFERING_REFLECTION_FLAG", "NOT_FOUND"),
+          text: `Observational memory record not found: ${id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id, isBuffering }
+        });
+      }
+    } catch (error) {
+      if (error instanceof MastraError) {
+        throw error;
+      }
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "SET_BUFFERING_REFLECTION_FLAG", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id, isBuffering }
+        },
+        error
+      );
+    }
+  }
   async clearObservationalMemory(threadId, resourceId) {
     try {
       const lookupKey = this.getOMKey(threadId, resourceId);
@@ -4248,109 +4366,433 @@ var MemoryLibSQL = class extends MemoryStorage {
       );
     }
   }
-};
-var ObservabilityLibSQL = class extends ObservabilityStorage {
-  #db;
-  constructor(config) {
-    super();
-    const client = resolveClient(config);
-    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
-  }
-  async init() {
-    await this.#db.createTable({ tableName: TABLE_SPANS, schema: SPAN_SCHEMA });
-  }
-  async dangerouslyClearAll() {
-    await this.#db.deleteData({ tableName: TABLE_SPANS });
-  }
-  /**
-   * Manually run the spans migration to deduplicate and add the unique constraint.
-   * This is intended to be called from the CLI when duplicates are detected.
-   *
-   * @returns Migration result with status and details
-   */
-  async migrateSpans() {
-    return this.#db.migrateSpans();
-  }
-  /**
-   * Check migration status for the spans table.
-   * Returns information about whether migration is needed.
-   */
-  async checkSpansMigrationStatus() {
-    return this.#db.checkSpansMigrationStatus();
-  }
-  get tracingStrategy() {
-    return {
-      preferred: "batch-with-updates",
-      supported: ["batch-with-updates", "insert-only"]
-    };
-  }
-  async createSpan(args) {
-    const { span } = args;
-    try {
-      const startedAt = span.startedAt instanceof Date ? span.startedAt.toISOString() : span.startedAt;
-      const endedAt = span.endedAt instanceof Date ? span.endedAt.toISOString() : span.endedAt;
-      const now = (/* @__PURE__ */ new Date()).toISOString();
-      const record = {
-        ...span,
-        startedAt,
-        endedAt,
-        createdAt: now,
-        updatedAt: now
-      };
-      return this.#db.insert({ tableName: TABLE_SPANS, record });
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createStorageErrorId("LIBSQL", "CREATE_SPAN", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          details: {
-            spanId: span.spanId,
-            traceId: span.traceId,
-            spanType: span.spanType,
-            name: span.name
-          }
-        },
-        error
-      );
-    }
-  }
-  async getSpan(args) {
-    const { traceId, spanId } = args;
+  // ============================================
+  // Async Buffering Methods
+  // ============================================
+  async updateBufferedObservations(input) {
     try {
-      const rows = await this.#db.selectMany({
-        tableName: TABLE_SPANS,
-        whereClause: { sql: " WHERE traceId = ? AND spanId = ?", args: [traceId, spanId] },
-        limit: 1
+      const nowStr = (/* @__PURE__ */ new Date()).toISOString();
+      const current = await this.#client.execute({
+        sql: `SELECT "bufferedObservationChunks" FROM "${OM_TABLE}" WHERE id = ?`,
+        args: [input.id]
       });
-      if (!rows || rows.length === 0) {
-        return null;
+      if (!current.rows || current.rows.length === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_BUFFERED_OBSERVATIONS", "NOT_FOUND"),
+          text: `Observational memory record not found: ${input.id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
+        });
       }
-      return {
-        span: transformFromSqlRow({ tableName: TABLE_SPANS, sqlRow: rows[0] })
+      const row = current.rows[0];
+      let existingChunks = [];
+      if (row.bufferedObservationChunks) {
+        try {
+          const parsed = typeof row.bufferedObservationChunks === "string" ? JSON.parse(row.bufferedObservationChunks) : row.bufferedObservationChunks;
+          existingChunks = Array.isArray(parsed) ? parsed : [];
+        } catch {
+          existingChunks = [];
+        }
+      }
+      const newChunk = {
+        id: `ombuf-${randomUUID()}`,
+        cycleId: input.chunk.cycleId,
+        observations: input.chunk.observations,
+        tokenCount: input.chunk.tokenCount,
+        messageIds: input.chunk.messageIds,
+        messageTokens: input.chunk.messageTokens,
+        lastObservedAt: input.chunk.lastObservedAt,
+        createdAt: /* @__PURE__ */ new Date(),
+        suggestedContinuation: input.chunk.suggestedContinuation,
+        currentTask: input.chunk.currentTask
       };
+      const newChunks = [...existingChunks, newChunk];
+      const lastBufferedAtTime = input.lastBufferedAtTime ? input.lastBufferedAtTime.toISOString() : null;
+      const result = await this.#client.execute({
+        sql: `UPDATE "${OM_TABLE}" SET
+          "bufferedObservationChunks" = ?,
+          "lastBufferedAtTime" = COALESCE(?, "lastBufferedAtTime"),
+          "updatedAt" = ?
+        WHERE id = ?`,
+        args: [JSON.stringify(newChunks), lastBufferedAtTime, nowStr, input.id]
+      });
+      if (result.rowsAffected === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_BUFFERED_OBSERVATIONS", "NOT_FOUND"),
+          text: `Observational memory record not found: ${input.id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
+        });
+      }
     } catch (error) {
+      if (error instanceof MastraError) {
+        throw error;
+      }
       throw new MastraError(
         {
-          id: createStorageErrorId("LIBSQL", "GET_SPAN", "FAILED"),
+          id: createStorageErrorId("LIBSQL", "UPDATE_BUFFERED_OBSERVATIONS", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          details: { traceId, spanId }
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
         },
         error
       );
     }
   }
-  async getRootSpan(args) {
-    const { traceId } = args;
+  async swapBufferedToActive(input) {
     try {
-      const rows = await this.#db.selectMany({
-        tableName: TABLE_SPANS,
-        whereClause: { sql: " WHERE traceId = ? AND parentSpanId IS NULL", args: [traceId] },
-        limit: 1
+      const nowStr = (/* @__PURE__ */ new Date()).toISOString();
+      const current = await this.#client.execute({
+        sql: `SELECT * FROM "${OM_TABLE}" WHERE id = ?`,
+        args: [input.id]
       });
-      if (!rows || rows.length === 0) {
-        return null;
+      if (!current.rows || current.rows.length === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "SWAP_BUFFERED_TO_ACTIVE", "NOT_FOUND"),
+          text: `Observational memory record not found: ${input.id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
+        });
+      }
+      const row = current.rows[0];
+      let chunks = [];
+      if (row.bufferedObservationChunks) {
+        try {
+          const parsed = typeof row.bufferedObservationChunks === "string" ? JSON.parse(row.bufferedObservationChunks) : row.bufferedObservationChunks;
+          chunks = Array.isArray(parsed) ? parsed : [];
+        } catch {
+          chunks = [];
+        }
+      }
+      if (chunks.length === 0) {
+        return {
+          chunksActivated: 0,
+          messageTokensActivated: 0,
+          observationTokensActivated: 0,
+          messagesActivated: 0,
+          activatedCycleIds: [],
+          activatedMessageIds: []
+        };
+      }
+      const retentionFloor = input.messageTokensThreshold * (1 - input.activationRatio);
+      const targetMessageTokens = Math.max(0, input.currentPendingTokens - retentionFloor);
+      let cumulativeMessageTokens = 0;
+      let bestBoundary = 0;
+      let bestBoundaryMessageTokens = 0;
+      for (let i = 0; i < chunks.length; i++) {
+        cumulativeMessageTokens += chunks[i].messageTokens ?? 0;
+        const boundary = i + 1;
+        const isUnder = cumulativeMessageTokens <= targetMessageTokens;
+        const bestIsUnder = bestBoundaryMessageTokens <= targetMessageTokens;
+        if (bestBoundary === 0) {
+          bestBoundary = boundary;
+          bestBoundaryMessageTokens = cumulativeMessageTokens;
+        } else if (isUnder && !bestIsUnder) {
+          bestBoundary = boundary;
+          bestBoundaryMessageTokens = cumulativeMessageTokens;
+        } else if (isUnder && bestIsUnder) {
+          if (cumulativeMessageTokens > bestBoundaryMessageTokens) {
+            bestBoundary = boundary;
+            bestBoundaryMessageTokens = cumulativeMessageTokens;
+          }
+        } else if (!isUnder && !bestIsUnder) {
+          if (cumulativeMessageTokens < bestBoundaryMessageTokens) {
+            bestBoundary = boundary;
+            bestBoundaryMessageTokens = cumulativeMessageTokens;
+          }
+        }
+      }
+      const chunksToActivate = bestBoundary === 0 ? 1 : bestBoundary;
+      const activatedChunks = chunks.slice(0, chunksToActivate);
+      const remainingChunks = chunks.slice(chunksToActivate);
+      const activatedContent = activatedChunks.map((c) => c.observations).join("\n\n");
+      const activatedTokens = activatedChunks.reduce((sum, c) => sum + c.tokenCount, 0);
+      const activatedMessageTokens = activatedChunks.reduce((sum, c) => sum + (c.messageTokens ?? 0), 0);
+      const activatedMessageCount = activatedChunks.reduce((sum, c) => sum + c.messageIds.length, 0);
+      const activatedCycleIds = activatedChunks.map((c) => c.cycleId).filter((id) => !!id);
+      const activatedMessageIds = activatedChunks.flatMap((c) => c.messageIds ?? []);
+      const latestChunk = activatedChunks[activatedChunks.length - 1];
+      const lastObservedAt = input.lastObservedAt ?? (latestChunk?.lastObservedAt ? new Date(latestChunk.lastObservedAt) : /* @__PURE__ */ new Date());
+      const lastObservedAtStr = lastObservedAt.toISOString();
+      const existingActive = row.activeObservations || "";
+      const existingTokenCount = Number(row.observationTokenCount || 0);
+      const newActive = existingActive ? `${existingActive}
+
+${activatedContent}` : activatedContent;
+      const newTokenCount = existingTokenCount + activatedTokens;
+      const existingPending = Number(row.pendingMessageTokens || 0);
+      const newPending = Math.max(0, existingPending - activatedMessageTokens);
+      await this.#client.execute({
+        sql: `UPDATE "${OM_TABLE}" SET
+          "activeObservations" = ?,
+          "observationTokenCount" = ?,
+          "pendingMessageTokens" = ?,
+          "bufferedObservationChunks" = ?,
+          "lastObservedAt" = ?,
+          "updatedAt" = ?
+        WHERE id = ?`,
+        args: [
+          newActive,
+          newTokenCount,
+          newPending,
+          remainingChunks.length > 0 ? JSON.stringify(remainingChunks) : null,
+          lastObservedAtStr,
+          nowStr,
+          input.id
+        ]
+      });
+      return {
+        chunksActivated: activatedChunks.length,
+        messageTokensActivated: activatedMessageTokens,
+        observationTokensActivated: activatedTokens,
+        messagesActivated: activatedMessageCount,
+        activatedCycleIds,
+        activatedMessageIds,
+        observations: activatedContent,
+        perChunk: activatedChunks.map((c) => ({
+          cycleId: c.cycleId ?? "",
+          messageTokens: c.messageTokens ?? 0,
+          observationTokens: c.tokenCount,
+          messageCount: c.messageIds.length,
+          observations: c.observations
+        }))
+      };
+    } catch (error) {
+      if (error instanceof MastraError) {
+        throw error;
+      }
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "SWAP_BUFFERED_TO_ACTIVE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
+        },
+        error
+      );
+    }
+  }
+  async updateBufferedReflection(input) {
+    try {
+      const nowStr = (/* @__PURE__ */ new Date()).toISOString();
+      const result = await this.#client.execute({
+        sql: `UPDATE "${OM_TABLE}" SET
+          "bufferedReflection" = CASE
+            WHEN "bufferedReflection" IS NOT NULL AND "bufferedReflection" != ''
+            THEN "bufferedReflection" || char(10) || char(10) || ?
+            ELSE ?
+          END,
+          "bufferedReflectionTokens" = COALESCE("bufferedReflectionTokens", 0) + ?,
+          "bufferedReflectionInputTokens" = COALESCE("bufferedReflectionInputTokens", 0) + ?,
+          "reflectedObservationLineCount" = ?,
+          "updatedAt" = ?
+        WHERE id = ?`,
+        args: [
+          input.reflection,
+          input.reflection,
+          input.tokenCount,
+          input.inputTokenCount,
+          input.reflectedObservationLineCount,
+          nowStr,
+          input.id
+        ]
+      });
+      if (result.rowsAffected === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_BUFFERED_REFLECTION", "NOT_FOUND"),
+          text: `Observational memory record not found: ${input.id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
+        });
+      }
+    } catch (error) {
+      if (error instanceof MastraError) {
+        throw error;
+      }
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "UPDATE_BUFFERED_REFLECTION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.id }
+        },
+        error
+      );
+    }
+  }
+  async swapBufferedReflectionToActive(input) {
+    try {
+      const current = await this.#client.execute({
+        sql: `SELECT * FROM "${OM_TABLE}" WHERE id = ?`,
+        args: [input.currentRecord.id]
+      });
+      if (!current.rows || current.rows.length === 0) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "SWAP_BUFFERED_REFLECTION_TO_ACTIVE", "NOT_FOUND"),
+          text: `Observational memory record not found: ${input.currentRecord.id}`,
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.currentRecord.id }
+        });
+      }
+      const row = current.rows[0];
+      const bufferedReflection = row.bufferedReflection || "";
+      const reflectedLineCount = Number(row.reflectedObservationLineCount || 0);
+      if (!bufferedReflection) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "SWAP_BUFFERED_REFLECTION_TO_ACTIVE", "NO_CONTENT"),
+          text: "No buffered reflection to swap",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { id: input.currentRecord.id }
+        });
+      }
+      const currentObservations = row.activeObservations || "";
+      const allLines = currentObservations.split("\n");
+      const unreflectedLines = allLines.slice(reflectedLineCount);
+      const unreflectedContent = unreflectedLines.join("\n").trim();
+      const newObservations = unreflectedContent ? `${bufferedReflection}
+
+${unreflectedContent}` : bufferedReflection;
+      const newRecord = await this.createReflectionGeneration({
+        currentRecord: input.currentRecord,
+        reflection: newObservations,
+        tokenCount: input.tokenCount
+      });
+      const nowStr = (/* @__PURE__ */ new Date()).toISOString();
+      await this.#client.execute({
+        sql: `UPDATE "${OM_TABLE}" SET
+          "bufferedReflection" = NULL,
+          "bufferedReflectionTokens" = NULL,
+          "bufferedReflectionInputTokens" = NULL,
+          "reflectedObservationLineCount" = NULL,
+          "updatedAt" = ?
+        WHERE id = ?`,
+        args: [nowStr, input.currentRecord.id]
+      });
+      return newRecord;
+    } catch (error) {
+      if (error instanceof MastraError) {
+        throw error;
+      }
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "SWAP_BUFFERED_REFLECTION_TO_ACTIVE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { id: input.currentRecord.id }
+        },
+        error
+      );
+    }
+  }
+};
+var ObservabilityLibSQL = class extends ObservabilityStorage {
+  #db;
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({ tableName: TABLE_SPANS, schema: SPAN_SCHEMA });
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_SPANS });
+  }
+  /**
+   * Manually run the spans migration to deduplicate and add the unique constraint.
+   * This is intended to be called from the CLI when duplicates are detected.
+   *
+   * @returns Migration result with status and details
+   */
+  async migrateSpans() {
+    return this.#db.migrateSpans();
+  }
+  /**
+   * Check migration status for the spans table.
+   * Returns information about whether migration is needed.
+   */
+  async checkSpansMigrationStatus() {
+    return this.#db.checkSpansMigrationStatus();
+  }
+  get tracingStrategy() {
+    return {
+      preferred: "batch-with-updates",
+      supported: ["batch-with-updates", "insert-only"]
+    };
+  }
+  async createSpan(args) {
+    const { span } = args;
+    try {
+      const startedAt = span.startedAt instanceof Date ? span.startedAt.toISOString() : span.startedAt;
+      const endedAt = span.endedAt instanceof Date ? span.endedAt.toISOString() : span.endedAt;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const record = {
+        ...span,
+        startedAt,
+        endedAt,
+        createdAt: now,
+        updatedAt: now
+      };
+      return this.#db.insert({ tableName: TABLE_SPANS, record });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_SPAN", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: {
+            spanId: span.spanId,
+            traceId: span.traceId,
+            spanType: span.spanType,
+            name: span.name
+          }
+        },
+        error
+      );
+    }
+  }
+  async getSpan(args) {
+    const { traceId, spanId } = args;
+    try {
+      const rows = await this.#db.selectMany({
+        tableName: TABLE_SPANS,
+        whereClause: { sql: " WHERE traceId = ? AND spanId = ?", args: [traceId, spanId] },
+        limit: 1
+      });
+      if (!rows || rows.length === 0) {
+        return null;
+      }
+      return {
+        span: transformFromSqlRow({ tableName: TABLE_SPANS, sqlRow: rows[0] })
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SPAN", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { traceId, spanId }
+        },
+        error
+      );
+    }
+  }
+  async getRootSpan(args) {
+    const { traceId } = args;
+    try {
+      const rows = await this.#db.selectMany({
+        tableName: TABLE_SPANS,
+        whereClause: { sql: " WHERE traceId = ? AND parentSpanId IS NULL", args: [traceId] },
+        limit: 1
+      });
+      if (!rows || rows.length === 0) {
+        return null;
       }
       return {
         span: transformFromSqlRow({ tableName: TABLE_SPANS, sqlRow: rows[0] })
@@ -4700,6 +5142,1040 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     }
   }
 };
+var SNAPSHOT_FIELDS2 = ["name", "description", "content", "rules"];
+var PromptBlocksLibSQL = class extends PromptBlocksStorage {
+  #db;
+  #client;
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    this.#client = client;
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({ tableName: TABLE_PROMPT_BLOCKS, schema: PROMPT_BLOCKS_SCHEMA });
+    await this.#db.createTable({ tableName: TABLE_PROMPT_BLOCK_VERSIONS, schema: PROMPT_BLOCK_VERSIONS_SCHEMA });
+    await this.#client.execute(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_prompt_block_versions_block_version ON "${TABLE_PROMPT_BLOCK_VERSIONS}" ("blockId", "versionNumber")`
+    );
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_PROMPT_BLOCKS });
+    await this.#db.deleteData({ tableName: TABLE_PROMPT_BLOCK_VERSIONS });
+  }
+  // ==========================================================================
+  // Prompt Block CRUD
+  // ==========================================================================
+  async getById(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_PROMPT_BLOCKS)} FROM "${TABLE_PROMPT_BLOCKS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseBlockRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_PROMPT_BLOCK", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async create(input) {
+    const { promptBlock } = input;
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: TABLE_PROMPT_BLOCKS,
+        record: {
+          id: promptBlock.id,
+          status: "draft",
+          activeVersionId: null,
+          authorId: promptBlock.authorId ?? null,
+          metadata: promptBlock.metadata ?? null,
+          createdAt: now.toISOString(),
+          updatedAt: now.toISOString()
+        }
+      });
+      const { id: _id, authorId: _authorId, metadata: _metadata, ...snapshotConfig } = promptBlock;
+      const versionId = crypto.randomUUID();
+      await this.createVersion({
+        id: versionId,
+        blockId: promptBlock.id,
+        versionNumber: 1,
+        ...snapshotConfig,
+        changedFields: Object.keys(snapshotConfig),
+        changeMessage: "Initial version"
+      });
+      return {
+        id: promptBlock.id,
+        status: "draft",
+        activeVersionId: void 0,
+        authorId: promptBlock.authorId,
+        metadata: promptBlock.metadata,
+        createdAt: now,
+        updatedAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_PROMPT_BLOCK", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async update(input) {
+    const { id, ...updates } = input;
+    try {
+      const existing = await this.getById(id);
+      if (!existing) {
+        throw new Error(`Prompt block with id ${id} not found`);
+      }
+      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
+      const configFieldNames = SNAPSHOT_FIELDS2;
+      const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
+      const updateData = {
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      if (authorId !== void 0) updateData.authorId = authorId;
+      if (activeVersionId !== void 0) {
+        updateData.activeVersionId = activeVersionId;
+        if (status === void 0) {
+          updateData.status = "published";
+        }
+      }
+      if (status !== void 0) updateData.status = status;
+      if (metadata !== void 0) {
+        updateData.metadata = { ...existing.metadata, ...metadata };
+      }
+      await this.#db.update({
+        tableName: TABLE_PROMPT_BLOCKS,
+        keys: { id },
+        data: updateData
+      });
+      if (hasConfigUpdate) {
+        const latestVersion = await this.getLatestVersion(id);
+        if (!latestVersion) {
+          throw new Error(`No versions found for prompt block ${id}`);
+        }
+        const {
+          id: _versionId,
+          blockId: _blockId,
+          versionNumber: _versionNumber,
+          changedFields: _changedFields,
+          changeMessage: _changeMessage,
+          createdAt: _createdAt,
+          ...latestConfig
+        } = latestVersion;
+        const newConfig = { ...latestConfig, ...configFields };
+        const changedFields = configFieldNames.filter(
+          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
+        );
+        const newVersionId = crypto.randomUUID();
+        await this.createVersion({
+          id: newVersionId,
+          blockId: id,
+          versionNumber: latestVersion.versionNumber + 1,
+          ...newConfig,
+          changedFields,
+          changeMessage: `Updated ${changedFields.join(", ")}`
+        });
+      }
+      const updated = await this.getById(id);
+      if (!updated) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_PROMPT_BLOCK", "NOT_FOUND_AFTER_UPDATE"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.SYSTEM,
+          text: `Prompt block ${id} not found after update`,
+          details: { id }
+        });
+      }
+      return updated;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "UPDATE_PROMPT_BLOCK", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async delete(id) {
+    try {
+      await this.deleteVersionsByParentId(id);
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_PROMPT_BLOCKS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_PROMPT_BLOCK", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async list(args) {
+    try {
+      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata } = args || {};
+      const { field, direction } = this.parseOrderBy(orderBy);
+      const conditions = [];
+      const queryParams = [];
+      if (authorId !== void 0) {
+        conditions.push("authorId = ?");
+        queryParams.push(authorId);
+      }
+      if (metadata && Object.keys(metadata).length > 0) {
+        for (const [key, value] of Object.entries(metadata)) {
+          if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(key)) {
+            throw new MastraError({
+              id: createStorageErrorId("LIBSQL", "LIST_PROMPT_BLOCKS", "INVALID_METADATA_KEY"),
+              domain: ErrorDomain.STORAGE,
+              category: ErrorCategory.USER,
+              text: `Invalid metadata key: ${key}. Keys must be alphanumeric with underscores.`,
+              details: { key }
+            });
+          }
+          conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+          queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
+        }
+      }
+      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_PROMPT_BLOCKS}" ${whereClause}`,
+        args: queryParams
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          promptBlocks: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 100,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_PROMPT_BLOCKS)} FROM "${TABLE_PROMPT_BLOCKS}" ${whereClause} ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [...queryParams, limitValue, start]
+      });
+      const promptBlocks = result.rows?.map((row) => this.#parseBlockRow(row)) ?? [];
+      return {
+        promptBlocks,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_PROMPT_BLOCKS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Prompt Block Version Methods
+  // ==========================================================================
+  async createVersion(input) {
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: TABLE_PROMPT_BLOCK_VERSIONS,
+        record: {
+          id: input.id,
+          blockId: input.blockId,
+          versionNumber: input.versionNumber,
+          name: input.name,
+          description: input.description ?? null,
+          content: input.content,
+          rules: input.rules ?? null,
+          changedFields: input.changedFields ?? null,
+          changeMessage: input.changeMessage ?? null,
+          createdAt: now.toISOString()
+        }
+      });
+      return {
+        ...input,
+        createdAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_PROMPT_BLOCK_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getVersion(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_PROMPT_BLOCK_VERSIONS)} FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_PROMPT_BLOCK_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getVersionByNumber(blockId, versionNumber) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_PROMPT_BLOCK_VERSIONS)} FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE blockId = ? AND versionNumber = ?`,
+        args: [blockId, versionNumber]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_PROMPT_BLOCK_VERSION_BY_NUMBER", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getLatestVersion(blockId) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_PROMPT_BLOCK_VERSIONS)} FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE blockId = ? ORDER BY versionNumber DESC LIMIT 1`,
+        args: [blockId]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_LATEST_PROMPT_BLOCK_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async listVersions(input) {
+    try {
+      const { blockId, page = 0, perPage: perPageInput, orderBy } = input;
+      const { field, direction } = this.parseVersionOrderBy(orderBy);
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE blockId = ?`,
+        args: [blockId]
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          versions: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 20,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 20);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_PROMPT_BLOCK_VERSIONS)} FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE blockId = ? ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [blockId, limitValue, start]
+      });
+      const versions = result.rows?.map((row) => this.#parseVersionRow(row)) ?? [];
+      return {
+        versions,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_PROMPT_BLOCK_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersion(id) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_PROMPT_BLOCK_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersionsByParentId(entityId) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE "blockId" = ?`,
+        args: [entityId]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_PROMPT_BLOCK_VERSIONS_BY_BLOCK", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async countVersions(blockId) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_PROMPT_BLOCK_VERSIONS}" WHERE blockId = ?`,
+        args: [blockId]
+      });
+      return Number(result.rows?.[0]?.count ?? 0);
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "COUNT_PROMPT_BLOCK_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Private Helpers
+  // ==========================================================================
+  #parseBlockRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      status: row.status ?? "draft",
+      activeVersionId: row.activeVersionId ?? void 0,
+      authorId: row.authorId ?? void 0,
+      metadata: safeParseJSON(row.metadata),
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  #parseVersionRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      blockId: row.blockId,
+      versionNumber: Number(row.versionNumber),
+      name: row.name,
+      description: row.description ?? void 0,
+      content: row.content,
+      rules: safeParseJSON(row.rules),
+      changedFields: safeParseJSON(row.changedFields),
+      changeMessage: row.changeMessage ?? void 0,
+      createdAt: new Date(row.createdAt)
+    };
+  }
+};
+var SNAPSHOT_FIELDS3 = [
+  "name",
+  "description",
+  "type",
+  "model",
+  "instructions",
+  "scoreRange",
+  "presetConfig",
+  "defaultSampling"
+];
+var ScorerDefinitionsLibSQL = class extends ScorerDefinitionsStorage {
+  #db;
+  #client;
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    this.#client = client;
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({ tableName: TABLE_SCORER_DEFINITIONS, schema: SCORER_DEFINITIONS_SCHEMA });
+    await this.#db.createTable({
+      tableName: TABLE_SCORER_DEFINITION_VERSIONS,
+      schema: SCORER_DEFINITION_VERSIONS_SCHEMA
+    });
+    await this.#client.execute(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_scorer_definition_versions_scorer_version ON "${TABLE_SCORER_DEFINITION_VERSIONS}" ("scorerDefinitionId", "versionNumber")`
+    );
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_SCORER_DEFINITIONS });
+    await this.#db.deleteData({ tableName: TABLE_SCORER_DEFINITION_VERSIONS });
+  }
+  // ==========================================================================
+  // Scorer Definition CRUD
+  // ==========================================================================
+  async getById(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SCORER_DEFINITIONS)} FROM "${TABLE_SCORER_DEFINITIONS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseScorerRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SCORER_DEFINITION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async create(input) {
+    const { scorerDefinition } = input;
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: TABLE_SCORER_DEFINITIONS,
+        record: {
+          id: scorerDefinition.id,
+          status: "draft",
+          activeVersionId: null,
+          authorId: scorerDefinition.authorId ?? null,
+          metadata: scorerDefinition.metadata ?? null,
+          createdAt: now.toISOString(),
+          updatedAt: now.toISOString()
+        }
+      });
+      const { id: _id, authorId: _authorId, metadata: _metadata, ...snapshotConfig } = scorerDefinition;
+      const versionId = crypto.randomUUID();
+      await this.createVersion({
+        id: versionId,
+        scorerDefinitionId: scorerDefinition.id,
+        versionNumber: 1,
+        ...snapshotConfig,
+        changedFields: Object.keys(snapshotConfig),
+        changeMessage: "Initial version"
+      });
+      return {
+        id: scorerDefinition.id,
+        status: "draft",
+        activeVersionId: void 0,
+        authorId: scorerDefinition.authorId,
+        metadata: scorerDefinition.metadata,
+        createdAt: now,
+        updatedAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_SCORER_DEFINITION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async update(input) {
+    const { id, ...updates } = input;
+    try {
+      const existing = await this.getById(id);
+      if (!existing) {
+        throw new Error(`Scorer definition with id ${id} not found`);
+      }
+      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
+      const configFieldNames = SNAPSHOT_FIELDS3;
+      const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
+      const updateData = {
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      if (authorId !== void 0) updateData.authorId = authorId;
+      if (activeVersionId !== void 0) {
+        updateData.activeVersionId = activeVersionId;
+        if (status === void 0) {
+          updateData.status = "published";
+        }
+      }
+      if (status !== void 0) updateData.status = status;
+      if (metadata !== void 0) {
+        updateData.metadata = { ...existing.metadata, ...metadata };
+      }
+      await this.#db.update({
+        tableName: TABLE_SCORER_DEFINITIONS,
+        keys: { id },
+        data: updateData
+      });
+      if (hasConfigUpdate) {
+        const latestVersion = await this.getLatestVersion(id);
+        if (!latestVersion) {
+          throw new Error(`No versions found for scorer definition ${id}`);
+        }
+        const {
+          id: _versionId,
+          scorerDefinitionId: _scorerDefinitionId,
+          versionNumber: _versionNumber,
+          changedFields: _changedFields,
+          changeMessage: _changeMessage,
+          createdAt: _createdAt,
+          ...latestConfig
+        } = latestVersion;
+        const newConfig = { ...latestConfig, ...configFields };
+        const changedFields = configFieldNames.filter(
+          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
+        );
+        const newVersionId = crypto.randomUUID();
+        await this.createVersion({
+          id: newVersionId,
+          scorerDefinitionId: id,
+          versionNumber: latestVersion.versionNumber + 1,
+          ...newConfig,
+          changedFields,
+          changeMessage: `Updated ${changedFields.join(", ")}`
+        });
+      }
+      const updated = await this.getById(id);
+      if (!updated) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_SCORER_DEFINITION", "NOT_FOUND_AFTER_UPDATE"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.SYSTEM,
+          text: `Scorer definition ${id} not found after update`,
+          details: { id }
+        });
+      }
+      return updated;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "UPDATE_SCORER_DEFINITION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async delete(id) {
+    try {
+      await this.deleteVersionsByParentId(id);
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_SCORER_DEFINITIONS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_SCORER_DEFINITION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async list(args) {
+    try {
+      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata } = args || {};
+      const { field, direction } = this.parseOrderBy(orderBy);
+      const conditions = [];
+      const queryParams = [];
+      if (authorId !== void 0) {
+        conditions.push("authorId = ?");
+        queryParams.push(authorId);
+      }
+      if (metadata && Object.keys(metadata).length > 0) {
+        for (const [key, value] of Object.entries(metadata)) {
+          if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(key)) {
+            throw new MastraError({
+              id: createStorageErrorId("LIBSQL", "LIST_SCORER_DEFINITIONS", "INVALID_METADATA_KEY"),
+              domain: ErrorDomain.STORAGE,
+              category: ErrorCategory.USER,
+              text: `Invalid metadata key: ${key}. Keys must be alphanumeric with underscores.`,
+              details: { key }
+            });
+          }
+          conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+          queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
+        }
+      }
+      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_SCORER_DEFINITIONS}" ${whereClause}`,
+        args: queryParams
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          scorerDefinitions: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 100,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SCORER_DEFINITIONS)} FROM "${TABLE_SCORER_DEFINITIONS}" ${whereClause} ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [...queryParams, limitValue, start]
+      });
+      const scorerDefinitions = result.rows?.map((row) => this.#parseScorerRow(row)) ?? [];
+      return {
+        scorerDefinitions,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_SCORER_DEFINITIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Scorer Definition Version Methods
+  // ==========================================================================
+  async createVersion(input) {
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: TABLE_SCORER_DEFINITION_VERSIONS,
+        record: {
+          id: input.id,
+          scorerDefinitionId: input.scorerDefinitionId,
+          versionNumber: input.versionNumber,
+          name: input.name,
+          description: input.description ?? null,
+          type: input.type,
+          model: input.model ?? null,
+          instructions: input.instructions ?? null,
+          scoreRange: input.scoreRange ?? null,
+          presetConfig: input.presetConfig ?? null,
+          defaultSampling: input.defaultSampling ?? null,
+          changedFields: input.changedFields ?? null,
+          changeMessage: input.changeMessage ?? null,
+          createdAt: now.toISOString()
+        }
+      });
+      return {
+        ...input,
+        createdAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_SCORER_DEFINITION_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getVersion(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SCORER_DEFINITION_VERSIONS)} FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SCORER_DEFINITION_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getVersionByNumber(scorerDefinitionId, versionNumber) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SCORER_DEFINITION_VERSIONS)} FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE scorerDefinitionId = ? AND versionNumber = ?`,
+        args: [scorerDefinitionId, versionNumber]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SCORER_DEFINITION_VERSION_BY_NUMBER", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getLatestVersion(scorerDefinitionId) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SCORER_DEFINITION_VERSIONS)} FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE scorerDefinitionId = ? ORDER BY versionNumber DESC LIMIT 1`,
+        args: [scorerDefinitionId]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_LATEST_SCORER_DEFINITION_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async listVersions(input) {
+    try {
+      const { scorerDefinitionId, page = 0, perPage: perPageInput, orderBy } = input;
+      const { field, direction } = this.parseVersionOrderBy(orderBy);
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE scorerDefinitionId = ?`,
+        args: [scorerDefinitionId]
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          versions: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 20,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 20);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SCORER_DEFINITION_VERSIONS)} FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE scorerDefinitionId = ? ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [scorerDefinitionId, limitValue, start]
+      });
+      const versions = result.rows?.map((row) => this.#parseVersionRow(row)) ?? [];
+      return {
+        versions,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_SCORER_DEFINITION_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersion(id) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_SCORER_DEFINITION_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersionsByParentId(entityId) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE "scorerDefinitionId" = ?`,
+        args: [entityId]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_SCORER_DEFINITION_VERSIONS_BY_SCORER", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async countVersions(scorerDefinitionId) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_SCORER_DEFINITION_VERSIONS}" WHERE scorerDefinitionId = ?`,
+        args: [scorerDefinitionId]
+      });
+      return Number(result.rows?.[0]?.count ?? 0);
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "COUNT_SCORER_DEFINITION_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Private Helpers
+  // ==========================================================================
+  #parseScorerRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      status: row.status ?? "draft",
+      activeVersionId: row.activeVersionId ?? void 0,
+      authorId: row.authorId ?? void 0,
+      metadata: safeParseJSON(row.metadata),
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  #parseVersionRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      scorerDefinitionId: row.scorerDefinitionId,
+      versionNumber: Number(row.versionNumber),
+      name: row.name,
+      description: row.description ?? void 0,
+      type: row.type,
+      model: safeParseJSON(row.model),
+      instructions: row.instructions ?? void 0,
+      scoreRange: safeParseJSON(row.scoreRange),
+      presetConfig: safeParseJSON(row.presetConfig),
+      defaultSampling: safeParseJSON(row.defaultSampling),
+      changedFields: safeParseJSON(row.changedFields),
+      changeMessage: row.changeMessage ?? void 0,
+      createdAt: new Date(row.createdAt)
+    };
+  }
+};
 var ScoresLibSQL = class extends ScoresStorage {
   #db;
   #client;
@@ -5352,12 +6828,16 @@ var LibSQLStore = class extends MastraCompositeStore {
     const memory = new MemoryLibSQL(domainConfig);
     const observability = new ObservabilityLibSQL(domainConfig);
     const agents = new AgentsLibSQL(domainConfig);
+    const promptBlocks = new PromptBlocksLibSQL(domainConfig);
+    const scorerDefinitions = new ScorerDefinitionsLibSQL(domainConfig);
     this.stores = {
       scores,
       workflows,
       memory,
       observability,
-      agents
+      agents,
+      promptBlocks,
+      scorerDefinitions
     };
   }
 };
@@ -5461,6 +6941,6 @@ Example Complex Query:
   ]
 }`;
 
-export { AgentsLibSQL, LibSQLStore as DefaultStorage, LIBSQL_PROMPT, LibSQLStore, LibSQLVector, MemoryLibSQL, ObservabilityLibSQL, ScoresLibSQL, WorkflowsLibSQL };
+export { AgentsLibSQL, LibSQLStore as DefaultStorage, LIBSQL_PROMPT, LibSQLStore, LibSQLVector, MemoryLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, WorkflowsLibSQL };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map