@mastra/libsql 0.16.2 → 0.16.3-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @mastra/libsql
 
+## 0.16.3-alpha.0
+
+### Patch Changes
+
+- deleteVectors, deleteFilter when upserting, updateVector filter (#10244) ([#10526](https://github.com/mastra-ai/mastra/pull/10526))
+
+- Fix message sorting in getMessagesPaginated when using semantic recall (include parameter). Messages are now always sorted by createdAt after combining paginated and included messages, ensuring correct chronological ordering of conversation history. All stores now consistently use MessageList for deduplication followed by explicit sorting. ([#10573](https://github.com/mastra-ai/mastra/pull/10573))
+
+- Updated dependencies [[`5657314`](https://github.com/mastra-ai/mastra/commit/5657314a1f9d49019bb53f357fa48f75a69247ca), [`e5aca78`](https://github.com/mastra-ai/mastra/commit/e5aca78bb7f263bb8b470bedae81efe9805d7544), [`33a607a`](https://github.com/mastra-ai/mastra/commit/33a607a1f716c2029d4a1ff1603dd756129a33b3), [`cc10fc1`](https://github.com/mastra-ai/mastra/commit/cc10fc192d9f527c71a23cc9def10d8718935ee1), [`1f7ee84`](https://github.com/mastra-ai/mastra/commit/1f7ee841a643ef12d90392125881f06fdf877293), [`e7d5149`](https://github.com/mastra-ai/mastra/commit/e7d514995260b63b2108308e85c64de37dcd0f71), [`f195082`](https://github.com/mastra-ai/mastra/commit/f1950822a2425d5ccae78c5d010e02ddb027a869), [`d9986dd`](https://github.com/mastra-ai/mastra/commit/d9986dd3513f7ca3244a8e599a440ccf4d8bc28b), [`a45b0f0`](https://github.com/mastra-ai/mastra/commit/a45b0f0cd19eab1fe4deceae3abf029442c22f74), [`f6e8eb3`](https://github.com/mastra-ai/mastra/commit/f6e8eb3dac53b70b06e906b2818b1d2a5b0486d7), [`ce57a2b`](https://github.com/mastra-ai/mastra/commit/ce57a2b62fd0d5f6532e4ecd1ba9ba93ac9b95fc), [`3236f35`](https://github.com/mastra-ai/mastra/commit/3236f352ae13cc8552c2965164e97bd125dae48d), [`ce57a2b`](https://github.com/mastra-ai/mastra/commit/ce57a2b62fd0d5f6532e4ecd1ba9ba93ac9b95fc), [`0230321`](https://github.com/mastra-ai/mastra/commit/02303217870bedea0ef009bea9a952f24ed38aaf), [`7b541f4`](https://github.com/mastra-ai/mastra/commit/7b541f49eda6f5a87b738198edbd136927599475), [`0eea842`](https://github.com/mastra-ai/mastra/commit/0eea8423cbdd37f2111593c6f7d2efcde4b7e4ce), [`63ae8a2`](https://github.com/mastra-ai/mastra/commit/63ae8a22c0c09bbb8b9779f5f38934cd75f616af), [`bf810c5`](https://github.com/mastra-ai/mastra/commit/bf810c5c561bd8ef221c0f6bd84e69770b9a38cc), [`ac7ef07`](https://github.com/mastra-ai/mastra/commit/ac7ef07633caee89707142171d2873c888ffef85), [`522f0b4`](https://github.com/mastra-ai/mastra/commit/522f0b45330719858794eabffffde4f343f55549), [`bf810c5`](https://github.com/mastra-ai/mastra/commit/bf810c5c561bd8ef221c0f6bd84e69770b9a38cc), [`8b51d55`](https://github.com/mastra-ai/mastra/commit/8b51d55bae531edf7e383958d7ecee04df31f5d5), [`2131ac5`](https://github.com/mastra-ai/mastra/commit/2131ac571d5065f0a656c57494bca98691bb7609)]:
+  - @mastra/core@0.24.6-alpha.0
+
 ## 0.16.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -92,12 +92,20 @@ var createBasicOperator = (symbol) => {
   };
 };
 var createNumericOperator = (symbol) => {
-  return (key) => {
+  return (key, value) => {
     const jsonPath = getJsonPath(key);
-    return {
-      sql: `CAST(json_extract(metadata, ${jsonPath}) AS NUMERIC) ${symbol} ?`,
-      needsValue: true
-    };
+    const isNumeric = typeof value === "number" || typeof value === "string" && !isNaN(Number(value)) && value.trim() !== "";
+    if (isNumeric) {
+      return {
+        sql: `CAST(json_extract(metadata, ${jsonPath}) AS NUMERIC) ${symbol} ?`,
+        needsValue: true
+      };
+    } else {
+      return {
+        sql: `CAST(json_extract(metadata, ${jsonPath}) AS TEXT) ${symbol} ?`,
+        needsValue: true
+      };
+    }
   };
 };
 var validateJsonArray = (key) => {
@@ -825,8 +833,27 @@ var LibSQLVector = class extends vector.MastraVector {
   updateVector(args) {
     return this.executeWriteOperationWithRetry(() => this.doUpdateVector(args));
   }
-  async doUpdateVector({ indexName, id, update }) {
+  async doUpdateVector(params) {
+    const { indexName, update } = params;
     const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
+    if ("id" in params && params.id && "filter" in params && params.filter) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_UPDATE_MUTUALLY_EXCLUSIVE_PARAMS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "id and filter are mutually exclusive - provide only one"
+      });
+    }
+    if (!update.vector && !update.metadata) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "No updates provided"
+      });
+    }
     const updates = [];
     const args = [];
     if (update.vector) {
@@ -838,32 +865,81 @@ var LibSQLVector = class extends vector.MastraVector {
       args.push(JSON.stringify(update.metadata));
     }
     if (updates.length === 0) {
+      return;
+    }
+    let whereClause;
+    let whereValues;
+    if ("id" in params && params.id) {
+      whereClause = "vector_id = ?";
+      whereValues = [params.id];
+    } else if ("filter" in params && params.filter) {
+      const filter = params.filter;
+      if (!filter || Object.keys(filter).length === 0) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_UPDATE_EMPTY_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Cannot update with empty filter"
+        });
+      }
+      const translatedFilter = this.transformFilter(filter);
+      const { sql: filterSql, values: filterValues } = buildFilterQuery(translatedFilter);
+      if (!filterSql || filterSql.trim() === "") {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_UPDATE_INVALID_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Filter produced empty WHERE clause"
+        });
+      }
+      const normalizedCondition = filterSql.replace(/^\s*WHERE\s+/i, "").trim().toLowerCase();
+      const matchAllPatterns = ["true", "1 = 1", "1=1"];
+      if (matchAllPatterns.includes(normalizedCondition)) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_UPDATE_MATCH_ALL_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, filterSql: normalizedCondition },
+          text: "Filter matches all vectors. Provide a specific filter to update targeted vectors."
+        });
+      }
+      whereClause = filterSql.replace(/^WHERE\s+/i, "");
+      whereValues = filterValues;
+    } else {
       throw new error.MastraError({
-        id: "LIBSQL_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        id: "LIBSQL_VECTOR_UPDATE_MISSING_PARAMS",
         domain: error.ErrorDomain.STORAGE,
         category: error.ErrorCategory.USER,
-        details: { indexName, id },
-        text: "No updates provided"
+        details: { indexName },
+        text: "Either id or filter must be provided"
       });
     }
-    args.push(id);
     const query = `
-        UPDATE ${parsedIndexName}
-        SET ${updates.join(", ")}
-        WHERE vector_id = ?;
-      `;
+      UPDATE ${parsedIndexName}
+      SET ${updates.join(", ")}
+      WHERE ${whereClause};
+    `;
     try {
       await this.turso.execute({
         sql: query,
-        args
+        args: [...args, ...whereValues]
       });
     } catch (error$1) {
+      const errorDetails = { indexName };
+      if ("id" in params && params.id) {
+        errorDetails.id = params.id;
+      }
+      if ("filter" in params && params.filter) {
+        errorDetails.filter = JSON.stringify(params.filter);
+      }
       throw new error.MastraError(
         {
           id: "LIBSQL_VECTOR_UPDATE_VECTOR_FAILED",
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { indexName, id }
+          details: errorDetails
         },
         error$1
       );
@@ -885,7 +961,10 @@ var LibSQLVector = class extends vector.MastraVector {
           id: "LIBSQL_VECTOR_DELETE_VECTOR_FAILED",
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { indexName: args.indexName, id: args.id }
+          details: {
+            indexName: args.indexName,
+            ...args.id && { id: args.id }
+          }
         },
         error$1
       );
@@ -898,6 +977,100 @@ var LibSQLVector = class extends vector.MastraVector {
       args: [id]
     });
   }
+  deleteVectors(args) {
+    return this.executeWriteOperationWithRetry(() => this.doDeleteVectors(args));
+  }
+  async doDeleteVectors({ indexName, filter, ids }) {
+    const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
+    if (!filter && !ids) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_DELETE_MISSING_PARAMS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "Either filter or ids must be provided"
+      });
+    }
+    if (filter && ids) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_DELETE_CONFLICTING_PARAMS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "Cannot provide both filter and ids - they are mutually exclusive"
+      });
+    }
+    let query;
+    let values;
+    if (ids) {
+      if (ids.length === 0) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_EMPTY_IDS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Cannot delete with empty ids array"
+        });
+      }
+      const placeholders = ids.map(() => "?").join(", ");
+      query = `DELETE FROM ${parsedIndexName} WHERE vector_id IN (${placeholders})`;
+      values = ids;
+    } else {
+      if (!filter || Object.keys(filter).length === 0) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_EMPTY_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Cannot delete with empty filter. Use deleteIndex to delete all vectors."
+        });
+      }
+      const translatedFilter = this.transformFilter(filter);
+      const { sql: filterSql, values: filterValues } = buildFilterQuery(translatedFilter);
+      if (!filterSql || filterSql.trim() === "") {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_INVALID_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Filter produced empty WHERE clause"
+        });
+      }
+      const normalizedCondition = filterSql.replace(/^\s*WHERE\s+/i, "").trim().toLowerCase();
+      const matchAllPatterns = ["true", "1 = 1", "1=1"];
+      if (matchAllPatterns.includes(normalizedCondition)) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_MATCH_ALL_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, filterSql: normalizedCondition },
+          text: "Filter matches all vectors. Use deleteIndex to delete all vectors from an index."
+        });
+      }
+      query = `DELETE FROM ${parsedIndexName} ${filterSql}`;
+      values = filterValues;
+    }
+    try {
+      await this.turso.execute({
+        sql: query,
+        args: values
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_DELETE_VECTORS_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: {
+            indexName,
+            ...filter && { filter: JSON.stringify(filter) },
+            ...ids && { idsCount: ids.length }
+          }
+        },
+        error$1
+      );
+    }
+  }
   truncateIndex(args) {
     try {
       return this.executeWriteOperationWithRetry(() => this._doTruncateIndex(args));
@@ -1256,7 +1429,11 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
         args: [...queryParams, ...excludeIds, perPage, currentOffset]
       });
       messages.push(...(dataResult.rows || []).map((row) => this.parseRow(row)));
-      const messagesToReturn = format === "v1" ? new agent.MessageList().add(messages, "memory").get.all.v1() : new agent.MessageList().add(messages, "memory").get.all.v2();
+      const list = new agent.MessageList().add(messages, "memory");
+      let messagesToReturn = format === "v1" ? list.get.all.v1() : list.get.all.v2();
+      messagesToReturn = messagesToReturn.sort(
+        (a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime()
+      );
       return {
         messages: messagesToReturn,
         total,