@mastra/libsql 0.0.0-bundle-studio-cloud-20251222034739 → 0.0.0-bundle-version-20260121132824

package/dist/index.cjs

@@ -244,10 +244,10 @@ var FILTER_OPERATORS = {
     };
   },
   // Element Operators
-  $exists: (key) => {
+  $exists: (key, value) => {
     const jsonPath = getJsonPath(key);
     return {
-      sql: `json_extract(metadata, ${jsonPath}) IS NOT NULL`,
+      sql: value === false ? `json_extract(metadata, ${jsonPath}) IS NULL` : `json_extract(metadata, ${jsonPath}) IS NOT NULL`,
       needsValue: false
     };
   },
@@ -511,7 +511,7 @@ var LibSQLVector = class extends vector.MastraVector {
   maxRetries;
   initialBackoffMs;
   constructor({
-    connectionUrl,
+    url,
     authToken,
     syncUrl,
     syncInterval,
@@ -521,14 +521,14 @@ var LibSQLVector = class extends vector.MastraVector {
   }) {
     super({ id });
     this.turso = client.createClient({
-      url: connectionUrl,
+      url,
       syncUrl,
       authToken,
       syncInterval
     });
     this.maxRetries = maxRetries;
     this.initialBackoffMs = initialBackoffMs;
-    if (connectionUrl.includes(`file:`) || connectionUrl.includes(`:memory:`)) {
+    if (url.includes(`file:`) || url.includes(`:memory:`)) {
       this.turso.execute("PRAGMA journal_mode=WAL;").then(() => this.logger.debug("LibSQLStore: PRAGMA journal_mode=WAL set.")).catch((err) => this.logger.warn("LibSQLStore: Failed to set PRAGMA journal_mode=WAL.", err));
       this.turso.execute("PRAGMA busy_timeout = 5000;").then(() => this.logger.debug("LibSQLStore: PRAGMA busy_timeout=5000 set.")).catch((err) => this.logger.warn("LibSQLStore: Failed to set PRAGMA busy_timeout=5000.", err));
     }
@@ -540,7 +540,7 @@ var LibSQLVector = class extends vector.MastraVector {
       try {
         return await operation();
       } catch (error) {
-        if (error.code === "SQLITE_BUSY" || error.message && error.message.toLowerCase().includes("database is locked")) {
+        if (error.code === "SQLITE_BUSY" || error.code === "SQLITE_LOCKED" || error.code === "SQLITE_LOCKED_SHAREDCACHE" || error.message && error.message.toLowerCase().includes("database is locked") || error.message && error.message.toLowerCase().includes("database table is locked")) {
           attempts++;
           if (attempts >= this.maxRetries) {
             this.logger.error(
@@ -574,22 +574,14 @@ var LibSQLVector = class extends vector.MastraVector {
     minScore = -1
     // Default to -1 to include all results (cosine similarity ranges from -1 to 1)
   }) {
-    try {
-      if (!Number.isInteger(topK) || topK <= 0) {
-        throw new Error("topK must be a positive integer");
-      }
-      if (!Array.isArray(queryVector) || !queryVector.every((x) => typeof x === "number" && Number.isFinite(x))) {
-        throw new Error("queryVector must be an array of finite numbers");
-      }
-    } catch (error$1) {
-      throw new error.MastraError(
-        {
-          id: storage.createVectorErrorId("LIBSQL", "QUERY", "INVALID_ARGS"),
-          domain: error.ErrorDomain.STORAGE,
-          category: error.ErrorCategory.USER
-        },
-        error$1
-      );
+    vector.validateTopK("LIBSQL", topK);
+    if (!Array.isArray(queryVector) || !queryVector.every((x) => typeof x === "number" && Number.isFinite(x))) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("LIBSQL", "QUERY", "INVALID_ARGS"),
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { message: "queryVector must be an array of finite numbers" }
+      });
     }
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
@@ -649,6 +641,7 @@ var LibSQLVector = class extends vector.MastraVector {
     }
   }
   async doUpsert({ indexName, vectors, metadata, ids }) {
+    vector.validateUpsertInput("LIBSQL", vectors, metadata, ids);
     const tx = await this.turso.transaction("write");
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
@@ -1095,6 +1088,14 @@ var LibSQLVector = class extends vector.MastraVector {
     });
   }
 };
+function buildSelectColumns(tableName) {
+  const schema = storage.TABLE_SCHEMAS[tableName];
+  return Object.keys(schema).map((col) => {
+    const colDef = schema[col];
+    const parsedCol = utils.parseSqlIdentifier(col, "column name");
+    return colDef?.type === "jsonb" ? `json(${parsedCol}) as ${parsedCol}` : parsedCol;
+  }).join(", ");
+}
 function isLockError(error) {
   return error.code === "SQLITE_BUSY" || error.code === "SQLITE_LOCKED" || error.message?.toLowerCase().includes("database is locked") || error.message?.toLowerCase().includes("database table is locked") || error.message?.toLowerCase().includes("table is locked") || error.constructor.name === "SqliteError" && error.message?.toLowerCase().includes("locked");
 }
@@ -1143,17 +1144,27 @@ function createExecuteWriteOperationWithRetry({
 }
 function prepareStatement({ tableName, record }) {
   const parsedTableName = utils.parseSqlIdentifier(tableName, "table name");
-  const columns = Object.keys(record).map((col) => utils.parseSqlIdentifier(col, "column name"));
-  const values = Object.values(record).map((v) => {
+  const schema = storage.TABLE_SCHEMAS[tableName];
+  const columnNames = Object.keys(record);
+  const columns = columnNames.map((col) => utils.parseSqlIdentifier(col, "column name"));
+  const values = columnNames.map((col) => {
+    const v = record[col];
     if (typeof v === `undefined` || v === null) {
       return null;
     }
+    const colDef = schema[col];
+    if (colDef?.type === "jsonb") {
+      return JSON.stringify(v);
+    }
     if (v instanceof Date) {
       return v.toISOString();
     }
     return typeof v === "object" ? JSON.stringify(v) : v;
   });
-  const placeholders = values.map(() => "?").join(", ");
+  const placeholders = columnNames.map((col) => {
+    const colDef = schema[col];
+    return colDef?.type === "jsonb" ? "jsonb(?)" : "?";
+  }).join(", ");
   return {
     sql: `INSERT OR REPLACE INTO ${parsedTableName} (${columns.join(", ")}) VALUES (${placeholders})`,
     args: values
@@ -1166,19 +1177,33 @@ function prepareUpdateStatement({
 }) {
   const parsedTableName = utils.parseSqlIdentifier(tableName, "table name");
   const schema = storage.TABLE_SCHEMAS[tableName];
-  const updateColumns = Object.keys(updates).map((col) => utils.parseSqlIdentifier(col, "column name"));
-  const updateValues = Object.values(updates).map(transformToSqlValue);
-  const setClause = updateColumns.map((col) => `${col} = ?`).join(", ");
+  const updateColumnNames = Object.keys(updates);
+  const updateColumns = updateColumnNames.map((col) => utils.parseSqlIdentifier(col, "column name"));
+  const updateValues = updateColumnNames.map((col) => {
+    const colDef = schema[col];
+    const v = updates[col];
+    if (colDef?.type === "jsonb") {
+      return transformToSqlValue(v, true);
+    }
+    return transformToSqlValue(v, false);
+  });
+  const setClause = updateColumns.map((col, i) => {
+    const colDef = schema[updateColumnNames[i]];
+    return colDef?.type === "jsonb" ? `${col} = jsonb(?)` : `${col} = ?`;
+  }).join(", ");
   const whereClause = prepareWhereClause(keys, schema);
   return {
     sql: `UPDATE ${parsedTableName} SET ${setClause}${whereClause.sql}`,
     args: [...updateValues, ...whereClause.args]
   };
 }
-function transformToSqlValue(value) {
+function transformToSqlValue(value, forceJsonStringify = false) {
   if (typeof value === "undefined" || value === null) {
     return null;
   }
+  if (forceJsonStringify) {
+    return JSON.stringify(value);
+  }
   if (value instanceof Date) {
     return value.toISOString();
   }
@@ -1241,19 +1266,6 @@ function buildDateRangeCondition(columnName, range) {
     args
   };
 }
-function buildDateRangeFilter(dateRange, columnName = "createdAt") {
-  if (!dateRange?.start && !dateRange?.end) {
-    return {};
-  }
-  const filter = {};
-  if (dateRange.start) {
-    filter.startAt = new Date(dateRange.start).toISOString();
-  }
-  if (dateRange.end) {
-    filter.endAt = new Date(dateRange.end).toISOString();
-  }
-  return { [columnName]: filter };
-}
 function transformFromSqlRow({
   tableName,
   sqlRow
@@ -1548,11 +1560,12 @@ var LibSQLDB = class extends base.MastraBase {
    */
   async select({ tableName, keys }) {
     const parsedTableName = utils.parseSqlIdentifier(tableName, "table name");
+    const columns = buildSelectColumns(tableName);
     const parsedKeys = Object.keys(keys).map((key) => utils.parseSqlIdentifier(key, "column name"));
     const conditions = parsedKeys.map((key) => `${key} = ?`).join(" AND ");
     const values = Object.values(keys);
     const result = await this.client.execute({
-      sql: `SELECT * FROM ${parsedTableName} WHERE ${conditions} ORDER BY createdAt DESC LIMIT 1`,
+      sql: `SELECT ${columns} FROM ${parsedTableName} WHERE ${conditions} ORDER BY createdAt DESC LIMIT 1`,
       args: values
     });
     if (!result.rows || result.rows.length === 0) {
@@ -1592,9 +1605,10 @@ var LibSQLDB = class extends base.MastraBase {
     args
   }) {
     const parsedTableName = utils.parseSqlIdentifier(tableName, "table name");
-    let statement = `SELECT * FROM ${parsedTableName}`;
+    const columns = buildSelectColumns(tableName);
+    let statement = `SELECT ${columns} FROM ${parsedTableName}`;
     if (whereClause?.sql) {
-      statement += `${whereClause.sql}`;
+      statement += ` ${whereClause.sql}`;
     }
     if (orderBy) {
       statement += ` ORDER BY ${orderBy}`;
@@ -1609,7 +1623,17 @@ var LibSQLDB = class extends base.MastraBase {
       sql: statement,
       args: [...whereClause?.args ?? [], ...args ?? []]
     });
-    return result.rows;
+    return (result.rows ?? []).map((row) => {
+      return Object.fromEntries(
+        Object.entries(row || {}).map(([k, v]) => {
+          try {
+            return [k, typeof v === "string" ? v.startsWith("{") || v.startsWith("[") ? JSON.parse(v) : v : v];
+          } catch {
+            return [k, v];
+          }
+        })
+      );
+    });
   }
   /**
    * Returns the total count of records matching the optional WHERE clause.
@@ -1653,7 +1677,7 @@ var LibSQLDB = class extends base.MastraBase {
       // SQLite uses 0/1 for booleans
       case "jsonb":
         return "TEXT";
-      // Store JSON as TEXT in SQLite
+      // SQLite: column stores TEXT, we use jsonb()/json() functions for binary optimization
       default:
         return storage.getSqlType(type);
     }
@@ -1681,13 +1705,22 @@ var LibSQLDB = class extends base.MastraBase {
       if (tableName === storage.TABLE_WORKFLOW_SNAPSHOT) {
         tableConstraints.push("UNIQUE (workflow_name, run_id)");
       }
+      if (tableName === storage.TABLE_SPANS) {
+        tableConstraints.push("UNIQUE (spanId, traceId)");
+      }
       const allDefinitions = [...columnDefinitions, ...tableConstraints].join(",\n  ");
       const sql = `CREATE TABLE IF NOT EXISTS ${parsedTableName} (
   ${allDefinitions}
 )`;
       await this.client.execute(sql);
       this.logger.debug(`LibSQLDB: Created table ${tableName}`);
+      if (tableName === storage.TABLE_SPANS) {
+        await this.migrateSpansTable();
+      }
     } catch (error$1) {
+      if (error$1 instanceof error.MastraError) {
+        throw error$1;
+      }
       throw new error.MastraError(
         {
           id: storage.createStorageErrorId("LIBSQL", "CREATE_TABLE", "FAILED"),
@@ -1699,6 +1732,221 @@ var LibSQLDB = class extends base.MastraBase {
       );
     }
   }
+  /**
+   * Migrates the spans table schema from OLD_SPAN_SCHEMA to current SPAN_SCHEMA.
+   * This adds new columns that don't exist in old schema and ensures required indexes exist.
+   */
+  async migrateSpansTable() {
+    const schema = storage.TABLE_SCHEMAS[storage.TABLE_SPANS];
+    try {
+      for (const [columnName, columnDef] of Object.entries(schema)) {
+        const columnExists = await this.hasColumn(storage.TABLE_SPANS, columnName);
+        if (!columnExists) {
+          const sqlType = this.getSqlType(columnDef.type);
+          const alterSql = `ALTER TABLE "${storage.TABLE_SPANS}" ADD COLUMN "${columnName}" ${sqlType}`;
+          await this.client.execute(alterSql);
+          this.logger.debug(`LibSQLDB: Added column '${columnName}' to ${storage.TABLE_SPANS}`);
+        }
+      }
+      const indexExists = await this.spansUniqueIndexExists();
+      if (!indexExists) {
+        const duplicateInfo = await this.checkForDuplicateSpans();
+        if (duplicateInfo.hasDuplicates) {
+          const errorMessage = `
+===========================================================================
+MIGRATION REQUIRED: Duplicate spans detected in ${storage.TABLE_SPANS}
+===========================================================================
+
+Found ${duplicateInfo.duplicateCount} duplicate (traceId, spanId) combinations.
+
+The spans table requires a unique constraint on (traceId, spanId), but your
+database contains duplicate entries that must be resolved first.
+
+To fix this, run the manual migration command:
+
+  npx mastra migrate
+
+This command will:
+  1. Remove duplicate spans (keeping the most complete/recent version)
+  2. Add the required unique constraint
+
+Note: This migration may take some time for large tables.
+===========================================================================
+`;
+          throw new error.MastraError({
+            id: storage.createStorageErrorId("LIBSQL", "MIGRATION_REQUIRED", "DUPLICATE_SPANS"),
+            domain: error.ErrorDomain.STORAGE,
+            category: error.ErrorCategory.USER,
+            text: errorMessage
+          });
+        } else {
+          await this.client.execute(
+            `CREATE UNIQUE INDEX IF NOT EXISTS "mastra_ai_spans_spanid_traceid_idx" ON "${storage.TABLE_SPANS}" ("spanId", "traceId")`
+          );
+          this.logger.debug(`LibSQLDB: Created unique index on (spanId, traceId) for ${storage.TABLE_SPANS}`);
+        }
+      }
+      this.logger.info(`LibSQLDB: Migration completed for ${storage.TABLE_SPANS}`);
+    } catch (error$1) {
+      if (error$1 instanceof error.MastraError) {
+        throw error$1;
+      }
+      this.logger.warn(`LibSQLDB: Failed to migrate spans table ${storage.TABLE_SPANS}:`, error$1);
+    }
+  }
+  /**
+   * Checks if the unique index on (spanId, traceId) already exists on the spans table.
+   * Used to skip deduplication when the index already exists (migration already complete).
+   */
+  async spansUniqueIndexExists() {
+    try {
+      const result = await this.client.execute(
+        `SELECT 1 FROM sqlite_master WHERE type = 'index' AND name = 'mastra_ai_spans_spanid_traceid_idx'`
+      );
+      return (result.rows?.length ?? 0) > 0;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Checks for duplicate (traceId, spanId) combinations in the spans table.
+   * Returns information about duplicates for logging/CLI purposes.
+   */
+  async checkForDuplicateSpans() {
+    try {
+      const result = await this.client.execute(`
+        SELECT COUNT(*) as duplicate_count FROM (
+          SELECT "spanId", "traceId"
+          FROM "${storage.TABLE_SPANS}"
+          GROUP BY "spanId", "traceId"
+          HAVING COUNT(*) > 1
+        )
+      `);
+      const duplicateCount = Number(result.rows?.[0]?.duplicate_count ?? 0);
+      return {
+        hasDuplicates: duplicateCount > 0,
+        duplicateCount
+      };
+    } catch (error) {
+      this.logger.debug(`LibSQLDB: Could not check for duplicates: ${error}`);
+      return { hasDuplicates: false, duplicateCount: 0 };
+    }
+  }
+  /**
+   * 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() {
+    const indexExists = await this.spansUniqueIndexExists();
+    if (indexExists) {
+      return {
+        success: true,
+        alreadyMigrated: true,
+        duplicatesRemoved: 0,
+        message: `Migration already complete. Unique index exists on ${storage.TABLE_SPANS}.`
+      };
+    }
+    const duplicateInfo = await this.checkForDuplicateSpans();
+    if (duplicateInfo.hasDuplicates) {
+      this.logger.info(
+        `Found ${duplicateInfo.duplicateCount} duplicate (traceId, spanId) combinations. Starting deduplication...`
+      );
+      await this.deduplicateSpans();
+    } else {
+      this.logger.info(`No duplicate spans found.`);
+    }
+    await this.client.execute(
+      `CREATE UNIQUE INDEX IF NOT EXISTS "mastra_ai_spans_spanid_traceid_idx" ON "${storage.TABLE_SPANS}" ("spanId", "traceId")`
+    );
+    return {
+      success: true,
+      alreadyMigrated: false,
+      duplicatesRemoved: duplicateInfo.duplicateCount,
+      message: duplicateInfo.hasDuplicates ? `Migration complete. Removed duplicates and added unique index to ${storage.TABLE_SPANS}.` : `Migration complete. Added unique index to ${storage.TABLE_SPANS}.`
+    };
+  }
+  /**
+   * Check migration status for the spans table.
+   * Returns information about whether migration is needed.
+   */
+  async checkSpansMigrationStatus() {
+    const indexExists = await this.spansUniqueIndexExists();
+    if (indexExists) {
+      return {
+        needsMigration: false,
+        hasDuplicates: false,
+        duplicateCount: 0,
+        constraintExists: true,
+        tableName: storage.TABLE_SPANS
+      };
+    }
+    const duplicateInfo = await this.checkForDuplicateSpans();
+    return {
+      needsMigration: true,
+      hasDuplicates: duplicateInfo.hasDuplicates,
+      duplicateCount: duplicateInfo.duplicateCount,
+      constraintExists: false,
+      tableName: storage.TABLE_SPANS
+    };
+  }
+  /**
+   * Deduplicates spans table by removing duplicate (spanId, traceId) combinations.
+   * Keeps the "best" record for each duplicate group based on:
+   * 1. Completed spans (endedAt IS NOT NULL) over incomplete ones
+   * 2. Most recently updated (updatedAt DESC)
+   * 3. Most recently created (createdAt DESC) as tiebreaker
+   */
+  async deduplicateSpans() {
+    try {
+      const duplicateCheck = await this.client.execute(`
+        SELECT COUNT(*) as duplicate_count FROM (
+          SELECT "spanId", "traceId"
+          FROM "${storage.TABLE_SPANS}"
+          GROUP BY "spanId", "traceId"
+          HAVING COUNT(*) > 1
+        )
+      `);
+      const duplicateCount = Number(duplicateCheck.rows?.[0]?.duplicate_count ?? 0);
+      if (duplicateCount === 0) {
+        this.logger.debug(`LibSQLDB: No duplicate spans found, skipping deduplication`);
+        return;
+      }
+      this.logger.warn(`LibSQLDB: Found ${duplicateCount} duplicate (spanId, traceId) combinations, deduplicating...`);
+      const deleteResult = await this.client.execute(`
+        DELETE FROM "${storage.TABLE_SPANS}"
+        WHERE rowid NOT IN (
+          SELECT MIN(best_rowid) FROM (
+            SELECT
+              rowid as best_rowid,
+              "spanId",
+              "traceId",
+              ROW_NUMBER() OVER (
+                PARTITION BY "spanId", "traceId"
+                ORDER BY
+                  CASE WHEN "endedAt" IS NOT NULL THEN 0 ELSE 1 END,
+                  "updatedAt" DESC,
+                  "createdAt" DESC
+              ) as rn
+            FROM "${storage.TABLE_SPANS}"
+          ) ranked
+          WHERE rn = 1
+          GROUP BY "spanId", "traceId"
+        )
+        AND ("spanId", "traceId") IN (
+          SELECT "spanId", "traceId"
+          FROM "${storage.TABLE_SPANS}"
+          GROUP BY "spanId", "traceId"
+          HAVING COUNT(*) > 1
+        )
+      `);
+      const deletedCount = deleteResult.rowsAffected ?? 0;
+      this.logger.warn(`LibSQLDB: Deleted ${deletedCount} duplicate span records`);
+    } catch (error) {
+      this.logger.warn(`LibSQLDB: Failed to deduplicate spans:`, error);
+    }
+  }
   /**
    * Gets a default value for a column type (used when adding NOT NULL columns).
    */
@@ -2201,13 +2449,15 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
         queryParams.push(resourceId);
       }
       if (filter?.dateRange?.start) {
-        conditions.push(`"createdAt" >= ?`);
+        const startOp = filter.dateRange.startExclusive ? ">" : ">=";
+        conditions.push(`"createdAt" ${startOp} ?`);
         queryParams.push(
           filter.dateRange.start instanceof Date ? filter.dateRange.start.toISOString() : filter.dateRange.start
         );
       }
       if (filter?.dateRange?.end) {
-        conditions.push(`"createdAt" <= ?`);
+        const endOp = filter.dateRange.endExclusive ? "<" : "<=";
+        conditions.push(`"createdAt" ${endOp} ?`);
         queryParams.push(
           filter.dateRange.end instanceof Date ? filter.dateRange.end.toISOString() : filter.dateRange.end
         );
@@ -2513,8 +2763,8 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
     await this.#db.insert({
       tableName: storage.TABLE_RESOURCES,
       record: {
-        ...resource,
-        metadata: JSON.stringify(resource.metadata)
+        ...resource
+        // metadata is handled by prepareStatement which stringifies jsonb columns
       }
     });
     return resource;
@@ -2551,7 +2801,7 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
       values.push(workingMemory);
     }
     if (metadata) {
-      updates.push("metadata = ?");
+      updates.push("metadata = jsonb(?)");
       values.push(JSON.stringify(updatedResource.metadata));
     }
     updates.push("updatedAt = ?");
@@ -2590,33 +2840,76 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
       );
     }
   }
-  async listThreadsByResourceId(args) {
-    const { resourceId, page = 0, perPage: perPageInput, orderBy } = args;
-    if (page < 0) {
+  async listThreads(args) {
+    const { page = 0, perPage: perPageInput, orderBy, filter } = args;
+    try {
+      this.validatePaginationInput(page, perPageInput ?? 100);
+    } catch (error$1) {
       throw new error.MastraError(
         {
-          id: storage.createStorageErrorId("LIBSQL", "LIST_THREADS_BY_RESOURCE_ID", "INVALID_PAGE"),
+          id: storage.createStorageErrorId("LIBSQL", "LIST_THREADS", "INVALID_PAGE"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.USER,
-          details: { page }
+          details: { page, ...perPageInput !== void 0 && { perPage: perPageInput } }
         },
-        new Error("page must be >= 0")
+        error$1 instanceof Error ? error$1 : new Error("Invalid pagination parameters")
       );
     }
     const perPage = storage.normalizePerPage(perPageInput, 100);
+    try {
+      this.validateMetadataKeys(filter?.metadata);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: storage.createStorageErrorId("LIBSQL", "LIST_THREADS", "INVALID_METADATA_KEY"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { metadataKeys: filter?.metadata ? Object.keys(filter.metadata).join(", ") : "" }
+        },
+        error$1 instanceof Error ? error$1 : new Error("Invalid metadata key")
+      );
+    }
     const { offset, perPage: perPageForResponse } = storage.calculatePagination(page, perPageInput, perPage);
     const { field, direction } = this.parseOrderBy(orderBy);
     try {
-      const baseQuery = `FROM ${storage.TABLE_THREADS} WHERE resourceId = ?`;
-      const queryParams = [resourceId];
+      const whereClauses = [];
+      const queryParams = [];
+      if (filter?.resourceId) {
+        whereClauses.push("resourceId = ?");
+        queryParams.push(filter.resourceId);
+      }
+      if (filter?.metadata && Object.keys(filter.metadata).length > 0) {
+        for (const [key, value] of Object.entries(filter.metadata)) {
+          if (value === null) {
+            whereClauses.push(`json_extract(metadata, '$.${key}') IS NULL`);
+          } else if (typeof value === "boolean") {
+            whereClauses.push(`json_extract(metadata, '$.${key}') = ?`);
+            queryParams.push(value ? 1 : 0);
+          } else if (typeof value === "number") {
+            whereClauses.push(`json_extract(metadata, '$.${key}') = ?`);
+            queryParams.push(value);
+          } else if (typeof value === "string") {
+            whereClauses.push(`json_extract(metadata, '$.${key}') = ?`);
+            queryParams.push(value);
+          } else {
+            throw new error.MastraError({
+              id: storage.createStorageErrorId("LIBSQL", "LIST_THREADS", "INVALID_METADATA_VALUE"),
+              domain: error.ErrorDomain.STORAGE,
+              category: error.ErrorCategory.USER,
+              text: `Metadata filter value for key "${key}" must be a scalar type (string, number, boolean, or null), got ${typeof value}`,
+              details: { key, valueType: typeof value }
+            });
+          }
+        }
+      }
+      const whereClause = whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : "";
+      const baseQuery = `FROM ${storage.TABLE_THREADS} ${whereClause}`;
       const mapRowToStorageThreadType = (row) => ({
         id: row.id,
         resourceId: row.resourceId,
         title: row.title,
         createdAt: new Date(row.createdAt),
-        // Convert string to Date
         updatedAt: new Date(row.updatedAt),
-        // Convert string to Date
         metadata: typeof row.metadata === "string" ? JSON.parse(row.metadata) : row.metadata
       });
       const countResult = await this.#client.execute({
@@ -2635,7 +2928,7 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
       }
       const limitValue = perPageInput === false ? total : perPage;
       const dataResult = await this.#client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY "${field}" ${direction} LIMIT ? OFFSET ?`,
+        sql: `SELECT ${buildSelectColumns(storage.TABLE_THREADS)} ${baseQuery} ORDER BY "${field}" ${direction} LIMIT ? OFFSET ?`,
         args: [...queryParams, limitValue, offset]
       });
       const threads = (dataResult.rows || []).map(mapRowToStorageThreadType);
@@ -2647,12 +2940,18 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
         hasMore: perPageInput === false ? false : offset + perPage < total
       };
     } catch (error$1) {
+      if (error$1 instanceof error.MastraError && error$1.category === error.ErrorCategory.USER) {
+        throw error$1;
+      }
       const mastraError = new error.MastraError(
         {
-          id: storage.createStorageErrorId("LIBSQL", "LIST_THREADS_BY_RESOURCE_ID", "FAILED"),
+          id: storage.createStorageErrorId("LIBSQL", "LIST_THREADS", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { resourceId }
+          details: {
+            ...filter?.resourceId && { resourceId: filter.resourceId },
+            hasMetadataFilter: !!filter?.metadata
+          }
         },
         error$1
       );
@@ -2672,8 +2971,8 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
       await this.#db.insert({
         tableName: storage.TABLE_THREADS,
         record: {
-          ...thread,
-          metadata: JSON.stringify(thread.metadata)
+          ...thread
+          // metadata is handled by prepareStatement which stringifies jsonb columns
         }
       });
       return thread;
@@ -2720,7 +3019,7 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
     };
     try {
       await this.#client.execute({
-        sql: `UPDATE ${storage.TABLE_THREADS} SET title = ?, metadata = ? WHERE id = ?`,
+        sql: `UPDATE ${storage.TABLE_THREADS} SET title = ?, metadata = jsonb(?) WHERE id = ?`,
         args: [title, JSON.stringify(updatedThread.metadata), id]
       });
       return updatedThread;
@@ -2759,6 +3058,148 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
       );
     }
   }
+  async cloneThread(args) {
+    const { sourceThreadId, newThreadId: providedThreadId, resourceId, title, metadata, options } = args;
+    const sourceThread = await this.getThreadById({ threadId: sourceThreadId });
+    if (!sourceThread) {
+      throw new error.MastraError({
+        id: storage.createStorageErrorId("LIBSQL", "CLONE_THREAD", "SOURCE_NOT_FOUND"),
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        text: `Source thread with id ${sourceThreadId} not found`,
+        details: { sourceThreadId }
+      });
+    }
+    const newThreadId = providedThreadId || crypto.randomUUID();
+    const existingThread = await this.getThreadById({ threadId: newThreadId });
+    if (existingThread) {
+      throw new error.MastraError({
+        id: storage.createStorageErrorId("LIBSQL", "CLONE_THREAD", "THREAD_EXISTS"),
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        text: `Thread with id ${newThreadId} already exists`,
+        details: { newThreadId }
+      });
+    }
+    try {
+      let messageQuery = `SELECT id, content, role, type, "createdAt", thread_id, "resourceId"
+                          FROM "${storage.TABLE_MESSAGES}" WHERE thread_id = ?`;
+      const messageParams = [sourceThreadId];
+      if (options?.messageFilter?.startDate) {
+        messageQuery += ` AND "createdAt" >= ?`;
+        messageParams.push(
+          options.messageFilter.startDate instanceof Date ? options.messageFilter.startDate.toISOString() : options.messageFilter.startDate
+        );
+      }
+      if (options?.messageFilter?.endDate) {
+        messageQuery += ` AND "createdAt" <= ?`;
+        messageParams.push(
+          options.messageFilter.endDate instanceof Date ? options.messageFilter.endDate.toISOString() : options.messageFilter.endDate
+        );
+      }
+      if (options?.messageFilter?.messageIds && options.messageFilter.messageIds.length > 0) {
+        messageQuery += ` AND id IN (${options.messageFilter.messageIds.map(() => "?").join(", ")})`;
+        messageParams.push(...options.messageFilter.messageIds);
+      }
+      messageQuery += ` ORDER BY "createdAt" ASC`;
+      if (options?.messageLimit && options.messageLimit > 0) {
+        const limitQuery = `SELECT * FROM (${messageQuery.replace('ORDER BY "createdAt" ASC', 'ORDER BY "createdAt" DESC')} LIMIT ?) ORDER BY "createdAt" ASC`;
+        messageParams.push(options.messageLimit);
+        messageQuery = limitQuery;
+      }
+      const sourceMessagesResult = await this.#client.execute({ sql: messageQuery, args: messageParams });
+      const sourceMessages = sourceMessagesResult.rows || [];
+      const now = /* @__PURE__ */ new Date();
+      const nowStr = now.toISOString();
+      const lastMessageId = sourceMessages.length > 0 ? sourceMessages[sourceMessages.length - 1].id : void 0;
+      const cloneMetadata = {
+        sourceThreadId,
+        clonedAt: now,
+        ...lastMessageId && { lastMessageId }
+      };
+      const newThread = {
+        id: newThreadId,
+        resourceId: resourceId || sourceThread.resourceId,
+        title: title || (sourceThread.title ? `Clone of ${sourceThread.title}` : void 0),
+        metadata: {
+          ...metadata,
+          clone: cloneMetadata
+        },
+        createdAt: now,
+        updatedAt: now
+      };
+      const tx = await this.#client.transaction("write");
+      try {
+        await tx.execute({
+          sql: `INSERT INTO "${storage.TABLE_THREADS}" (id, "resourceId", title, metadata, "createdAt", "updatedAt")
+                VALUES (?, ?, ?, jsonb(?), ?, ?)`,
+          args: [
+            newThread.id,
+            newThread.resourceId,
+            newThread.title || null,
+            JSON.stringify(newThread.metadata),
+            nowStr,
+            nowStr
+          ]
+        });
+        const clonedMessages = [];
+        const targetResourceId = resourceId || sourceThread.resourceId;
+        for (const sourceMsg of sourceMessages) {
+          const newMessageId = crypto.randomUUID();
+          const contentStr = sourceMsg.content;
+          let parsedContent;
+          try {
+            parsedContent = JSON.parse(contentStr);
+          } catch {
+            parsedContent = { format: 2, parts: [{ type: "text", text: contentStr }] };
+          }
+          await tx.execute({
+            sql: `INSERT INTO "${storage.TABLE_MESSAGES}" (id, thread_id, content, role, type, "createdAt", "resourceId")
+                  VALUES (?, ?, ?, ?, ?, ?, ?)`,
+            args: [
+              newMessageId,
+              newThreadId,
+              contentStr,
+              sourceMsg.role,
+              sourceMsg.type || "v2",
+              sourceMsg.createdAt,
+              targetResourceId
+            ]
+          });
+          clonedMessages.push({
+            id: newMessageId,
+            threadId: newThreadId,
+            content: parsedContent,
+            role: sourceMsg.role,
+            type: sourceMsg.type || void 0,
+            createdAt: new Date(sourceMsg.createdAt),
+            resourceId: targetResourceId
+          });
+        }
+        await tx.commit();
+        return {
+          thread: newThread,
+          clonedMessages
+        };
+      } catch (error) {
+        await tx.rollback();
+        throw error;
+      }
+    } catch (error$1) {
+      if (error$1 instanceof error.MastraError) {
+        throw error$1;
+      }
+      throw new error.MastraError(
+        {
+          id: storage.createStorageErrorId("LIBSQL", "CLONE_THREAD", "FAILED"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { sourceThreadId, newThreadId }
+        },
+        error$1
+      );
+    }
+  }
 };
 var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
   #db;
@@ -2773,11 +3214,38 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
   async dangerouslyClearAll() {
     await this.#db.deleteData({ tableName: storage.TABLE_SPANS });
   }
-  async createSpan(span) {
+  /**
+   * 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
       };
@@ -2792,19 +3260,72 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
             spanId: span.spanId,
             traceId: span.traceId,
             spanType: span.spanType,
-            spanName: span.name
+            name: span.name
           }
         },
         error$1
       );
     }
   }
-  async getTrace(traceId) {
+  async getSpan(args) {
+    const { traceId, spanId } = args;
+    try {
+      const rows = await this.#db.selectMany({
+        tableName: storage.TABLE_SPANS,
+        whereClause: { sql: " WHERE traceId = ? AND spanId = ?", args: [traceId, spanId] },
+        limit: 1
+      });
+      if (!rows || rows.length === 0) {
+        return null;
+      }
+      return {
+        span: transformFromSqlRow({ tableName: storage.TABLE_SPANS, sqlRow: rows[0] })
+      };
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: storage.createStorageErrorId("LIBSQL", "GET_SPAN", "FAILED"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { traceId, spanId }
+        },
+        error$1
+      );
+    }
+  }
+  async getRootSpan(args) {
+    const { traceId } = args;
+    try {
+      const rows = await this.#db.selectMany({
+        tableName: storage.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: storage.TABLE_SPANS, sqlRow: rows[0] })
+      };
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: storage.createStorageErrorId("LIBSQL", "GET_ROOT_SPAN", "FAILED"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { traceId }
+        },
+        error$1
+      );
+    }
+  }
+  async getTrace(args) {
+    const { traceId } = args;
     try {
       const spans = await this.#db.selectMany({
         tableName: storage.TABLE_SPANS,
         whereClause: { sql: " WHERE traceId = ?", args: [traceId] },
-        orderBy: "startedAt DESC"
+        orderBy: "startedAt ASC"
       });
       if (!spans || spans.length === 0) {
         return null;
@@ -2827,16 +3348,21 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
       );
     }
   }
-  async updateSpan({
-    spanId,
-    traceId,
-    updates
-  }) {
+  async updateSpan(args) {
+    const { traceId, spanId, updates } = args;
     try {
+      const data = { ...updates };
+      if (data.endedAt instanceof Date) {
+        data.endedAt = data.endedAt.toISOString();
+      }
+      if (data.startedAt instanceof Date) {
+        data.startedAt = data.startedAt.toISOString();
+      }
+      data.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
       await this.#db.update({
         tableName: storage.TABLE_SPANS,
         keys: { spanId, traceId },
-        data: { ...updates, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }
+        data
       });
     } catch (error$1) {
       throw new error.MastraError(
@@ -2853,83 +3379,175 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
       );
     }
   }
-  async getTracesPaginated({
-    filters,
-    pagination
-  }) {
-    const page = pagination?.page ?? 0;
-    const perPage = pagination?.perPage ?? 10;
-    const { entityId, entityType, ...actualFilters } = filters || {};
-    const filtersWithDateRange = {
-      ...actualFilters,
-      ...buildDateRangeFilter(pagination?.dateRange, "startedAt"),
-      parentSpanId: null
-    };
-    const whereClause = prepareWhereClause(filtersWithDateRange, storage.SPAN_SCHEMA);
-    let actualWhereClause = whereClause.sql || "";
-    if (entityId && entityType) {
-      const statement = `name = ?`;
-      let name = "";
-      if (entityType === "workflow") {
-        name = `workflow run: '${entityId}'`;
-      } else if (entityType === "agent") {
-        name = `agent run: '${entityId}'`;
-      } else {
-        const error$1 = new error.MastraError({
-          id: storage.createStorageErrorId("LIBSQL", "GET_TRACES_PAGINATED", "INVALID_ENTITY_TYPE"),
-          domain: error.ErrorDomain.STORAGE,
-          category: error.ErrorCategory.USER,
-          details: {
-            entityType
-          },
-          text: `Cannot filter by entity type: ${entityType}`
-        });
-        this.logger?.trackException(error$1);
-        throw error$1;
+  async listTraces(args) {
+    const { filters, pagination, orderBy } = storage.listTracesArgsSchema.parse(args);
+    const { page, perPage } = pagination;
+    const tableName = utils.parseSqlIdentifier(storage.TABLE_SPANS, "table name");
+    try {
+      const conditions = ["parentSpanId IS NULL"];
+      const queryArgs = [];
+      if (filters) {
+        if (filters.startedAt?.start) {
+          conditions.push(`startedAt >= ?`);
+          queryArgs.push(filters.startedAt.start.toISOString());
+        }
+        if (filters.startedAt?.end) {
+          conditions.push(`startedAt <= ?`);
+          queryArgs.push(filters.startedAt.end.toISOString());
+        }
+        if (filters.endedAt?.start) {
+          conditions.push(`endedAt >= ?`);
+          queryArgs.push(filters.endedAt.start.toISOString());
+        }
+        if (filters.endedAt?.end) {
+          conditions.push(`endedAt <= ?`);
+          queryArgs.push(filters.endedAt.end.toISOString());
+        }
+        if (filters.spanType !== void 0) {
+          conditions.push(`spanType = ?`);
+          queryArgs.push(filters.spanType);
+        }
+        if (filters.entityType !== void 0) {
+          conditions.push(`entityType = ?`);
+          queryArgs.push(filters.entityType);
+        }
+        if (filters.entityId !== void 0) {
+          conditions.push(`entityId = ?`);
+          queryArgs.push(filters.entityId);
+        }
+        if (filters.entityName !== void 0) {
+          conditions.push(`entityName = ?`);
+          queryArgs.push(filters.entityName);
+        }
+        if (filters.userId !== void 0) {
+          conditions.push(`userId = ?`);
+          queryArgs.push(filters.userId);
+        }
+        if (filters.organizationId !== void 0) {
+          conditions.push(`organizationId = ?`);
+          queryArgs.push(filters.organizationId);
+        }
+        if (filters.resourceId !== void 0) {
+          conditions.push(`resourceId = ?`);
+          queryArgs.push(filters.resourceId);
+        }
+        if (filters.runId !== void 0) {
+          conditions.push(`runId = ?`);
+          queryArgs.push(filters.runId);
+        }
+        if (filters.sessionId !== void 0) {
+          conditions.push(`sessionId = ?`);
+          queryArgs.push(filters.sessionId);
+        }
+        if (filters.threadId !== void 0) {
+          conditions.push(`threadId = ?`);
+          queryArgs.push(filters.threadId);
+        }
+        if (filters.requestId !== void 0) {
+          conditions.push(`requestId = ?`);
+          queryArgs.push(filters.requestId);
+        }
+        if (filters.environment !== void 0) {
+          conditions.push(`environment = ?`);
+          queryArgs.push(filters.environment);
+        }
+        if (filters.source !== void 0) {
+          conditions.push(`source = ?`);
+          queryArgs.push(filters.source);
+        }
+        if (filters.serviceName !== void 0) {
+          conditions.push(`serviceName = ?`);
+          queryArgs.push(filters.serviceName);
+        }
+        if (filters.scope != null) {
+          for (const [key, value] of Object.entries(filters.scope)) {
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(key)) {
+              throw new error.MastraError({
+                id: storage.createStorageErrorId("LIBSQL", "LIST_TRACES", "INVALID_FILTER_KEY"),
+                domain: error.ErrorDomain.STORAGE,
+                category: error.ErrorCategory.USER,
+                details: { key }
+              });
+            }
+            conditions.push(`json_extract(scope, '$.${key}') = ?`);
+            queryArgs.push(typeof value === "string" ? value : JSON.stringify(value));
+          }
+        }
+        if (filters.metadata != null) {
+          for (const [key, value] of Object.entries(filters.metadata)) {
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(key)) {
+              throw new error.MastraError({
+                id: storage.createStorageErrorId("LIBSQL", "LIST_TRACES", "INVALID_FILTER_KEY"),
+                domain: error.ErrorDomain.STORAGE,
+                category: error.ErrorCategory.USER,
+                details: { key }
+              });
+            }
+            conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+            queryArgs.push(typeof value === "string" ? value : JSON.stringify(value));
+          }
+        }
+        if (filters.tags != null && filters.tags.length > 0) {
+          for (const tag of filters.tags) {
+            conditions.push(`EXISTS (SELECT 1 FROM json_each(${tableName}.tags) WHERE value = ?)`);
+            queryArgs.push(tag);
+          }
+        }
+        if (filters.status !== void 0) {
+          switch (filters.status) {
+            case storage.TraceStatus.ERROR:
+              conditions.push(`error IS NOT NULL`);
+              break;
+            case storage.TraceStatus.RUNNING:
+              conditions.push(`endedAt IS NULL AND error IS NULL`);
+              break;
+            case storage.TraceStatus.SUCCESS:
+              conditions.push(`endedAt IS NOT NULL AND error IS NULL`);
+              break;
+          }
+        }
+        if (filters.hasChildError !== void 0) {
+          if (filters.hasChildError) {
+            conditions.push(`EXISTS (
+              SELECT 1 FROM ${tableName} c
+              WHERE c.traceId = ${tableName}.traceId AND c.error IS NOT NULL
+            )`);
+          } else {
+            conditions.push(`NOT EXISTS (
+              SELECT 1 FROM ${tableName} c
+              WHERE c.traceId = ${tableName}.traceId AND c.error IS NOT NULL
+            )`);
+          }
+        }
       }
-      whereClause.args.push(name);
-      if (actualWhereClause) {
-        actualWhereClause += ` AND ${statement}`;
+      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const sortField = orderBy.field;
+      const sortDirection = orderBy.direction;
+      let orderByClause;
+      if (sortField === "endedAt") {
+        orderByClause = sortDirection === "DESC" ? `CASE WHEN ${sortField} IS NULL THEN 0 ELSE 1 END, ${sortField} DESC` : `CASE WHEN ${sortField} IS NULL THEN 1 ELSE 0 END, ${sortField} ASC`;
       } else {
-        actualWhereClause += `WHERE ${statement}`;
+        orderByClause = `${sortField} ${sortDirection}`;
       }
-    }
-    const orderBy = "startedAt DESC";
-    let count = 0;
-    try {
-      count = await this.#db.selectTotalCount({
+      const count = await this.#db.selectTotalCount({
         tableName: storage.TABLE_SPANS,
-        whereClause: { sql: actualWhereClause, args: whereClause.args }
+        whereClause: { sql: whereClause, args: queryArgs }
       });
-    } catch (error$1) {
-      throw new error.MastraError(
-        {
-          id: storage.createStorageErrorId("LIBSQL", "GET_TRACES_PAGINATED", "COUNT_FAILED"),
-          domain: error.ErrorDomain.STORAGE,
-          category: error.ErrorCategory.USER
-        },
-        error$1
-      );
-    }
-    if (count === 0) {
-      return {
-        pagination: {
-          total: 0,
-          page,
-          perPage,
-          hasMore: false
-        },
-        spans: []
-      };
-    }
-    try {
+      if (count === 0) {
+        return {
+          pagination: {
+            total: 0,
+            page,
+            perPage,
+            hasMore: false
+          },
+          spans: []
+        };
+      }
       const spans = await this.#db.selectMany({
         tableName: storage.TABLE_SPANS,
-        whereClause: {
-          sql: actualWhereClause,
-          args: whereClause.args
-        },
-        orderBy,
+        whereClause: { sql: whereClause, args: queryArgs },
+        orderBy: orderByClause,
         offset: page * perPage,
         limit: perPage
       });
@@ -2938,14 +3556,14 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
           total: count,
           page,
           perPage,
-          hasMore: spans.length === perPage
+          hasMore: (page + 1) * perPage < count
         },
         spans: spans.map((span) => transformFromSqlRow({ tableName: storage.TABLE_SPANS, sqlRow: span }))
       };
     } catch (error$1) {
       throw new error.MastraError(
         {
-          id: storage.createStorageErrorId("LIBSQL", "GET_TRACES_PAGINATED", "FAILED"),
+          id: storage.createStorageErrorId("LIBSQL", "LIST_TRACES", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.USER
         },
@@ -2956,13 +3574,20 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
   async batchCreateSpans(args) {
     try {
       const now = (/* @__PURE__ */ new Date()).toISOString();
-      return this.#db.batchInsert({
-        tableName: storage.TABLE_SPANS,
-        records: args.records.map((record) => ({
+      const records = args.records.map((record) => {
+        const startedAt = record.startedAt instanceof Date ? record.startedAt.toISOString() : record.startedAt;
+        const endedAt = record.endedAt instanceof Date ? record.endedAt.toISOString() : record.endedAt;
+        return {
           ...record,
+          startedAt,
+          endedAt,
           createdAt: now,
           updatedAt: now
-        }))
+        };
+      });
+      return this.#db.batchInsert({
+        tableName: storage.TABLE_SPANS,
+        records
       });
     } catch (error$1) {
       throw new error.MastraError(
@@ -2976,13 +3601,24 @@ var ObservabilityLibSQL = class extends storage.ObservabilityStorage {
     }
   }
   async batchUpdateSpans(args) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
     try {
       return this.#db.batchUpdate({
         tableName: storage.TABLE_SPANS,
-        updates: args.records.map((record) => ({
-          keys: { spanId: record.spanId, traceId: record.traceId },
-          data: { ...record.updates, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }
-        }))
+        updates: args.records.map((record) => {
+          const data = { ...record.updates };
+          if (data.endedAt instanceof Date) {
+            data.endedAt = data.endedAt.toISOString();
+          }
+          if (data.startedAt instanceof Date) {
+            data.startedAt = data.startedAt.toISOString();
+          }
+          data.updatedAt = now;
+          return {
+            keys: { spanId: record.spanId, traceId: record.traceId },
+            data
+          };
+        })
       });
     } catch (error$1) {
       throw new error.MastraError(
@@ -3061,7 +3697,7 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
       const limitValue = perPageInput === false ? total : perPage;
       const end = perPageInput === false ? total : start + perPage;
       const result = await this.#client.execute({
-        sql: `SELECT * FROM ${storage.TABLE_SCORERS} WHERE runId = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT ${buildSelectColumns(storage.TABLE_SCORERS)} FROM ${storage.TABLE_SCORERS} WHERE runId = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
         args: [runId, limitValue, start]
       });
       const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
@@ -3134,7 +3770,7 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
       const limitValue = perPageInput === false ? total : perPage;
       const end = perPageInput === false ? total : start + perPage;
       const result = await this.#client.execute({
-        sql: `SELECT * FROM ${storage.TABLE_SCORERS} ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT ${buildSelectColumns(storage.TABLE_SCORERS)} FROM ${storage.TABLE_SCORERS} ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
         args: [...queryParams, limitValue, start]
       });
       const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
@@ -3160,16 +3796,13 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
   }
   /**
    * LibSQL-specific score row transformation.
-   * Maps additionalLLMContext column to additionalContext field.
    */
   transformScoreRow(row) {
-    return storage.transformScoreRow(row, {
-      fieldMappings: { additionalContext: "additionalLLMContext" }
-    });
+    return storage.transformScoreRow(row);
   }
   async getScoreById({ id }) {
     const result = await this.#client.execute({
-      sql: `SELECT * FROM ${storage.TABLE_SCORERS} WHERE id = ?`,
+      sql: `SELECT ${buildSelectColumns(storage.TABLE_SCORERS)} FROM ${storage.TABLE_SCORERS} WHERE id = ?`,
       args: [id]
     });
     return result.rows?.[0] ? this.transformScoreRow(result.rows[0]) : null;
@@ -3185,7 +3818,7 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.USER,
           details: {
-            scorer: score.scorer?.id ?? "unknown",
+            scorer: typeof score.scorer?.id === "string" ? score.scorer.id : String(score.scorer?.id ?? "unknown"),
             entityId: score.entityId ?? "unknown",
             entityType: score.entityType ?? "unknown",
             traceId: score.traceId ?? "",
@@ -3247,7 +3880,7 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
       const limitValue = perPageInput === false ? total : perPage;
       const end = perPageInput === false ? total : start + perPage;
       const result = await this.#client.execute({
-        sql: `SELECT * FROM ${storage.TABLE_SCORERS} WHERE entityId = ? AND entityType = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT ${buildSelectColumns(storage.TABLE_SCORERS)} FROM ${storage.TABLE_SCORERS} WHERE entityId = ? AND entityType = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
         args: [entityId, entityType, limitValue, start]
       });
       const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
@@ -3288,7 +3921,7 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
       const limitValue = perPageInput === false ? total : perPage;
       const end = perPageInput === false ? total : start + perPage;
       const result = await this.#client.execute({
-        sql: `SELECT * FROM ${storage.TABLE_SCORERS} WHERE traceId = ? AND spanId = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT ${buildSelectColumns(storage.TABLE_SCORERS)} FROM ${storage.TABLE_SCORERS} WHERE traceId = ? AND spanId = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
         args: [traceId, spanId, limitValue, start]
       });
       const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
@@ -3313,24 +3946,6 @@ var ScoresLibSQL = class extends storage.ScoresStorage {
     }
   }
 };
-function parseWorkflowRun(row) {
-  let parsedSnapshot = row.snapshot;
-  if (typeof parsedSnapshot === "string") {
-    try {
-      parsedSnapshot = JSON.parse(row.snapshot);
-    } catch (e) {
-      console.warn(`Failed to parse snapshot for workflow ${row.workflow_name}: ${e}`);
-    }
-  }
-  return {
-    workflowName: row.workflow_name,
-    runId: row.run_id,
-    snapshot: parsedSnapshot,
-    resourceId: row.resourceId,
-    createdAt: new Date(row.createdAt),
-    updatedAt: new Date(row.updatedAt)
-  };
-}
 var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
   #db;
   #client;
@@ -3351,6 +3966,24 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
       (err) => this.logger.warn("LibSQL Workflows: Failed to setup PRAGMA settings.", err)
     );
   }
+  parseWorkflowRun(row) {
+    let parsedSnapshot = row.snapshot;
+    if (typeof parsedSnapshot === "string") {
+      try {
+        parsedSnapshot = JSON.parse(row.snapshot);
+      } catch (e) {
+        this.logger.warn(`Failed to parse snapshot for workflow ${row.workflow_name}: ${e}`);
+      }
+    }
+    return {
+      workflowName: row.workflow_name,
+      runId: row.run_id,
+      snapshot: parsedSnapshot,
+      resourceId: row.resourceId,
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
   async init() {
     const schema = storage.TABLE_SCHEMAS[storage.TABLE_WORKFLOW_SNAPSHOT];
     await this.#db.createTable({ tableName: storage.TABLE_WORKFLOW_SNAPSHOT, schema });
@@ -3394,7 +4027,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
       const tx = await this.#client.transaction("write");
       try {
         const existingSnapshotResult = await tx.execute({
-          sql: `SELECT snapshot FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+          sql: `SELECT json(snapshot) as snapshot FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
           args: [workflowName, runId]
         });
         let snapshot;
@@ -3419,9 +4052,13 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
         }
         snapshot.context[stepId] = result;
         snapshot.requestContext = { ...snapshot.requestContext, ...requestContext };
+        const now = (/* @__PURE__ */ new Date()).toISOString();
         await tx.execute({
-          sql: `UPDATE ${storage.TABLE_WORKFLOW_SNAPSHOT} SET snapshot = ? WHERE workflow_name = ? AND run_id = ?`,
-          args: [JSON.stringify(snapshot), workflowName, runId]
+          sql: `INSERT INTO ${storage.TABLE_WORKFLOW_SNAPSHOT} (workflow_name, run_id, snapshot, createdAt, updatedAt)
+                VALUES (?, ?, jsonb(?), ?, ?)
+                ON CONFLICT(workflow_name, run_id)
+                DO UPDATE SET snapshot = excluded.snapshot, updatedAt = excluded.updatedAt`,
+          args: [workflowName, runId, JSON.stringify(snapshot), now, now]
         });
         await tx.commit();
         return snapshot.context;
@@ -3442,7 +4079,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
       const tx = await this.#client.transaction("write");
       try {
         const existingSnapshotResult = await tx.execute({
-          sql: `SELECT snapshot FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+          sql: `SELECT json(snapshot) as snapshot FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
           args: [workflowName, runId]
         });
         if (!existingSnapshotResult.rows?.[0]) {
@@ -3457,7 +4094,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
         }
         const updatedSnapshot = { ...snapshot, ...opts };
         await tx.execute({
-          sql: `UPDATE ${storage.TABLE_WORKFLOW_SNAPSHOT} SET snapshot = ? WHERE workflow_name = ? AND run_id = ?`,
+          sql: `UPDATE ${storage.TABLE_WORKFLOW_SNAPSHOT} SET snapshot = jsonb(?) WHERE workflow_name = ? AND run_id = ?`,
           args: [JSON.stringify(updatedSnapshot), workflowName, runId]
         });
         await tx.commit();
@@ -3521,13 +4158,13 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
     const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
     try {
       const result = await this.#client.execute({
-        sql: `SELECT * FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC LIMIT 1`,
+        sql: `SELECT workflow_name, run_id, resourceId, json(snapshot) as snapshot, createdAt, updatedAt FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC LIMIT 1`,
         args
       });
       if (!result.rows?.[0]) {
         return null;
       }
-      return parseWorkflowRun(result.rows[0]);
+      return this.parseWorkflowRun(result.rows[0]);
     } catch (error$1) {
       throw new error.MastraError(
         {
@@ -3593,7 +4230,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
           conditions.push("resourceId = ?");
           args.push(resourceId);
         } else {
-          console.warn(`[${storage.TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
+          this.logger.warn(`[${storage.TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
         }
       }
       const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
@@ -3609,10 +4246,10 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
       const normalizedPerPage = usePagination ? storage.normalizePerPage(perPage, Number.MAX_SAFE_INTEGER) : 0;
       const offset = usePagination ? page * normalizedPerPage : 0;
       const result = await this.#client.execute({
-        sql: `SELECT * FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC${usePagination ? ` LIMIT ? OFFSET ?` : ""}`,
+        sql: `SELECT workflow_name, run_id, resourceId, json(snapshot) as snapshot, createdAt, updatedAt FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC${usePagination ? ` LIMIT ? OFFSET ?` : ""}`,
         args: usePagination ? [...args, normalizedPerPage, offset] : args
       });
-      const runs = (result.rows || []).map((row) => parseWorkflowRun(row));
+      const runs = (result.rows || []).map((row) => this.parseWorkflowRun(row));
       return { runs, total: total || runs.length };
     } catch (error$1) {
       throw new error.MastraError(
@@ -3628,7 +4265,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
 };
 
 // src/storage/index.ts
-var LibSQLStore = class extends storage.MastraStorage {
+var LibSQLStore = class extends storage.MastraCompositeStore {
   client;
   maxRetries;
   initialBackoffMs;
@@ -3673,160 +4310,6 @@ var LibSQLStore = class extends storage.MastraStorage {
       agents
     };
   }
-  get supports() {
-    return {
-      selectByIncludeResourceScope: true,
-      resourceWorkingMemory: true,
-      hasColumn: true,
-      createTable: true,
-      deleteMessages: true,
-      observabilityInstance: true,
-      listScoresBySpan: true,
-      agents: true
-    };
-  }
-  async getThreadById({ threadId }) {
-    return this.stores.memory.getThreadById({ threadId });
-  }
-  async saveThread({ thread }) {
-    return this.stores.memory.saveThread({ thread });
-  }
-  async updateThread({
-    id,
-    title,
-    metadata
-  }) {
-    return this.stores.memory.updateThread({ id, title, metadata });
-  }
-  async deleteThread({ threadId }) {
-    return this.stores.memory.deleteThread({ threadId });
-  }
-  async listMessagesById({ messageIds }) {
-    return this.stores.memory.listMessagesById({ messageIds });
-  }
-  async saveMessages(args) {
-    const result = await this.stores.memory.saveMessages({ messages: args.messages });
-    return { messages: result.messages };
-  }
-  async updateMessages({
-    messages
-  }) {
-    return this.stores.memory.updateMessages({ messages });
-  }
-  async deleteMessages(messageIds) {
-    return this.stores.memory.deleteMessages(messageIds);
-  }
-  async getScoreById({ id }) {
-    return this.stores.scores.getScoreById({ id });
-  }
-  async saveScore(score) {
-    return this.stores.scores.saveScore(score);
-  }
-  async listScoresByScorerId({
-    scorerId,
-    entityId,
-    entityType,
-    source,
-    pagination
-  }) {
-    return this.stores.scores.listScoresByScorerId({ scorerId, entityId, entityType, source, pagination });
-  }
-  async listScoresByRunId({
-    runId,
-    pagination
-  }) {
-    return this.stores.scores.listScoresByRunId({ runId, pagination });
-  }
-  async listScoresByEntityId({
-    entityId,
-    entityType,
-    pagination
-  }) {
-    return this.stores.scores.listScoresByEntityId({ entityId, entityType, pagination });
-  }
-  /**
-   * WORKFLOWS
-   */
-  async updateWorkflowResults({
-    workflowName,
-    runId,
-    stepId,
-    result,
-    requestContext
-  }) {
-    return this.stores.workflows.updateWorkflowResults({ workflowName, runId, stepId, result, requestContext });
-  }
-  async updateWorkflowState({
-    workflowName,
-    runId,
-    opts
-  }) {
-    return this.stores.workflows.updateWorkflowState({ workflowName, runId, opts });
-  }
-  async persistWorkflowSnapshot({
-    workflowName,
-    runId,
-    resourceId,
-    snapshot
-  }) {
-    return this.stores.workflows.persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot });
-  }
-  async loadWorkflowSnapshot({
-    workflowName,
-    runId
-  }) {
-    return this.stores.workflows.loadWorkflowSnapshot({ workflowName, runId });
-  }
-  async listWorkflowRuns(args = {}) {
-    return this.stores.workflows.listWorkflowRuns(args);
-  }
-  async getWorkflowRunById({
-    runId,
-    workflowName
-  }) {
-    return this.stores.workflows.getWorkflowRunById({ runId, workflowName });
-  }
-  async deleteWorkflowRunById({ runId, workflowName }) {
-    return this.stores.workflows.deleteWorkflowRunById({ runId, workflowName });
-  }
-  async getResourceById({ resourceId }) {
-    return this.stores.memory.getResourceById({ resourceId });
-  }
-  async saveResource({ resource }) {
-    return this.stores.memory.saveResource({ resource });
-  }
-  async updateResource({
-    resourceId,
-    workingMemory,
-    metadata
-  }) {
-    return this.stores.memory.updateResource({ resourceId, workingMemory, metadata });
-  }
-  async createSpan(span) {
-    return this.stores.observability.createSpan(span);
-  }
-  async updateSpan(params) {
-    return this.stores.observability.updateSpan(params);
-  }
-  async getTrace(traceId) {
-    return this.stores.observability.getTrace(traceId);
-  }
-  async getTracesPaginated(args) {
-    return this.stores.observability.getTracesPaginated(args);
-  }
-  async listScoresBySpan({
-    traceId,
-    spanId,
-    pagination
-  }) {
-    return this.stores.scores.listScoresBySpan({ traceId, spanId, pagination });
-  }
-  async batchCreateSpans(args) {
-    return this.stores.observability.batchCreateSpans(args);
-  }
-  async batchUpdateSpans(args) {
-    return this.stores.observability.batchUpdateSpans(args);
-  }
 };
 
 // src/vector/prompt.ts
@@ -3928,9 +4411,14 @@ Example Complex Query:
   ]
 }`;
 
+exports.AgentsLibSQL = AgentsLibSQL;
 exports.DefaultStorage = LibSQLStore;
 exports.LIBSQL_PROMPT = LIBSQL_PROMPT;
 exports.LibSQLStore = LibSQLStore;
 exports.LibSQLVector = LibSQLVector;
+exports.MemoryLibSQL = MemoryLibSQL;
+exports.ObservabilityLibSQL = ObservabilityLibSQL;
+exports.ScoresLibSQL = ScoresLibSQL;
+exports.WorkflowsLibSQL = WorkflowsLibSQL;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map