@mastra/libsql 0.11.2 → 0.11.3-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/libsql@0.11.1 build /home/runner/work/mastra/mastra/stores/libsql
+> @mastra/libsql@0.11.3-alpha.1 build /home/runner/work/mastra/mastra/stores/libsql
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
 TSC Build start
-TSC ⚡️ Build success in 10836ms
+TSC ⚡️ Build success in 10968ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/libsql/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/libsql/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 12706ms
+DTS ⚡️ Build success in 13655ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 88.28 KB
-CJS ⚡️ Build success in 2514ms
-ESM dist/index.js 87.22 KB
-ESM ⚡️ Build success in 2514ms
+CJS dist/index.cjs 90.83 KB
+CJS ⚡️ Build success in 2374ms
+ESM dist/index.js 89.73 KB
+ESM ⚡️ Build success in 2376ms

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @mastra/libsql
 
+## 0.11.3-alpha.1
+
+### Patch Changes
+
+- ff9c125: enhance thread retrieval with sorting options in libsql and pg
+- b8efbb9: feat: add flexible deleteMessages method to memory API
+  - Added `memory.deleteMessages(input)` method that accepts multiple input types:
+    - Single message ID as string: `deleteMessages('msg-123')`
+    - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
+    - Message object with id property: `deleteMessages({ id: 'msg-123' })`
+    - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
+  - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
+  - Added REST API endpoint: `POST /api/memory/messages/delete`
+  - Updated client SDK: `thread.deleteMessages()` accepts all input types
+  - Updates thread timestamps when messages are deleted
+  - Added comprehensive test coverage and documentation
+
+- Updated dependencies [27cc97a]
+- Updated dependencies [41daa63]
+- Updated dependencies [254a36b]
+- Updated dependencies [0b89602]
+- Updated dependencies [4d37822]
+- Updated dependencies [ff9c125]
+- Updated dependencies [b8efbb9]
+- Updated dependencies [71466e7]
+- Updated dependencies [0c99fbe]
+  - @mastra/core@0.12.0-alpha.2
+
+## 0.11.3-alpha.0
+
+### Patch Changes
+
+- 24ac5ff: dependencies updates:
+  - Updated dependency [`@libsql/client@^0.15.10` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.10) (from `^0.15.9`, in `dependencies`)
+- a3ca14c: `LibSQLVector.doUpsert`: check if transaction is open before attempting rollback
+- Updated dependencies [510e2c8]
+- Updated dependencies [2f72fb2]
+- Updated dependencies [3f89307]
+- Updated dependencies [9eda7d4]
+- Updated dependencies [9d49408]
+- Updated dependencies [2ecf658]
+- Updated dependencies [7a7754f]
+- Updated dependencies [fc92d80]
+- Updated dependencies [23a6a7c]
+- Updated dependencies [09bca64]
+  - @mastra/core@0.12.0-alpha.0
+
 ## 0.11.2
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -34,6 +34,7 @@ import type { StorageResourceType } from '@mastra/core/storage';
 import type { StorageThreadType } from '@mastra/core/memory';
 import { StoreOperations } from '@mastra/core/storage';
 import type { TABLE_NAMES } from '@mastra/core/storage';
+import type { ThreadSortOptions } from '@mastra/core/storage';
 import type { Trace } from '@mastra/core/telemetry';
 import { TracesStorage } from '@mastra/core/storage';
 import type { UpdateVectorParams } from '@mastra/core/vector';
@@ -147,6 +148,7 @@ declare class LibSQLStore extends MastraStorage {
         resourceWorkingMemory: boolean;
         hasColumn: boolean;
         createTable: boolean;
+        deleteMessages: boolean;
     };
     createTable({ tableName, schema, }: {
         tableName: TABLE_NAMES;
@@ -189,12 +191,12 @@ declare class LibSQLStore extends MastraStorage {
      */
     getThreadsByResourceId(args: {
         resourceId: string;
-    }): Promise<StorageThreadType[]>;
+    } & ThreadSortOptions): Promise<StorageThreadType[]>;
     getThreadsByResourceIdPaginated(args: {
         resourceId: string;
         page: number;
         perPage: number;
-    }): Promise<PaginationInfo & {
+    } & ThreadSortOptions): Promise<PaginationInfo & {
         threads: StorageThreadType[];
     }>;
     saveThread({ thread }: {
@@ -239,6 +241,7 @@ declare class LibSQLStore extends MastraStorage {
             };
         })[];
     }): Promise<MastraMessageV2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
     /** @deprecated use getEvals instead */
     getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
     getEvals(options?: {
@@ -443,6 +446,7 @@ export declare class MemoryLibSQL extends MemoryStorage {
             };
         })[];
     }): Promise<MastraMessageV2_2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
     getResourceById({ resourceId }: {
         resourceId: string;
     }): Promise<StorageResourceType | null>;
@@ -462,12 +466,12 @@ export declare class MemoryLibSQL extends MemoryStorage {
      */
     getThreadsByResourceId(args: {
         resourceId: string;
-    }): Promise<StorageThreadType[]>;
+    } & ThreadSortOptions): Promise<StorageThreadType[]>;
     getThreadsByResourceIdPaginated(args: {
         resourceId: string;
         page: number;
         perPage: number;
-    }): Promise<PaginationInfo & {
+    } & ThreadSortOptions): Promise<PaginationInfo & {
         threads: StorageThreadType[];
     }>;
     saveThread({ thread }: {

package/dist/_tsup-dts-rollup.d.ts

@@ -34,6 +34,7 @@ import type { StorageResourceType } from '@mastra/core/storage';
 import type { StorageThreadType } from '@mastra/core/memory';
 import { StoreOperations } from '@mastra/core/storage';
 import type { TABLE_NAMES } from '@mastra/core/storage';
+import type { ThreadSortOptions } from '@mastra/core/storage';
 import type { Trace } from '@mastra/core/telemetry';
 import { TracesStorage } from '@mastra/core/storage';
 import type { UpdateVectorParams } from '@mastra/core/vector';
@@ -147,6 +148,7 @@ declare class LibSQLStore extends MastraStorage {
         resourceWorkingMemory: boolean;
         hasColumn: boolean;
         createTable: boolean;
+        deleteMessages: boolean;
     };
     createTable({ tableName, schema, }: {
         tableName: TABLE_NAMES;
@@ -189,12 +191,12 @@ declare class LibSQLStore extends MastraStorage {
      */
     getThreadsByResourceId(args: {
         resourceId: string;
-    }): Promise<StorageThreadType[]>;
+    } & ThreadSortOptions): Promise<StorageThreadType[]>;
     getThreadsByResourceIdPaginated(args: {
         resourceId: string;
         page: number;
         perPage: number;
-    }): Promise<PaginationInfo & {
+    } & ThreadSortOptions): Promise<PaginationInfo & {
         threads: StorageThreadType[];
     }>;
     saveThread({ thread }: {
@@ -239,6 +241,7 @@ declare class LibSQLStore extends MastraStorage {
             };
         })[];
     }): Promise<MastraMessageV2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
     /** @deprecated use getEvals instead */
     getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
     getEvals(options?: {
@@ -443,6 +446,7 @@ export declare class MemoryLibSQL extends MemoryStorage {
             };
         })[];
     }): Promise<MastraMessageV2_2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
     getResourceById({ resourceId }: {
         resourceId: string;
     }): Promise<StorageResourceType | null>;
@@ -462,12 +466,12 @@ export declare class MemoryLibSQL extends MemoryStorage {
      */
     getThreadsByResourceId(args: {
         resourceId: string;
-    }): Promise<StorageThreadType[]>;
+    } & ThreadSortOptions): Promise<StorageThreadType[]>;
     getThreadsByResourceIdPaginated(args: {
         resourceId: string;
         page: number;
         perPage: number;
-    }): Promise<PaginationInfo & {
+    } & ThreadSortOptions): Promise<PaginationInfo & {
         threads: StorageThreadType[];
     }>;
     saveThread({ thread }: {

package/dist/index.cjs

@@ -652,7 +652,7 @@ var LibSQLVector = class extends vector.MastraVector {
       await tx.commit();
       return vectorIds;
     } catch (error) {
-      await tx.rollback();
+      !tx.closed && await tx.rollback();
       if (error instanceof Error && error.message?.includes("dimensions are different")) {
         const match = error.message.match(/dimensions are different: (\d+) != (\d+)/);
         if (match) {
@@ -1249,14 +1249,14 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
           );
         }
         return {
-          sql: `INSERT INTO ${storage.TABLE_MESSAGES} (id, thread_id, content, role, type, createdAt, resourceId) 
+          sql: `INSERT INTO "${storage.TABLE_MESSAGES}" (id, thread_id, content, role, type, "createdAt", "resourceId") 
                   VALUES (?, ?, ?, ?, ?, ?, ?)
                   ON CONFLICT(id) DO UPDATE SET
                     thread_id=excluded.thread_id,
                     content=excluded.content,
                     role=excluded.role,
                     type=excluded.type,
-                    resourceId=excluded.resourceId
+                    "resourceId"=excluded."resourceId"
                 `,
           args: [
             message.id,
@@ -1271,10 +1271,21 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
       });
       const now = (/* @__PURE__ */ new Date()).toISOString();
       batchStatements.push({
-        sql: `UPDATE ${storage.TABLE_THREADS} SET updatedAt = ? WHERE id = ?`,
+        sql: `UPDATE "${storage.TABLE_THREADS}" SET "updatedAt" = ? WHERE id = ?`,
         args: [now, threadId]
       });
-      await this.client.batch(batchStatements, "write");
+      const BATCH_SIZE = 50;
+      const messageStatements = batchStatements.slice(0, -1);
+      const threadUpdateStatement = batchStatements[batchStatements.length - 1];
+      for (let i = 0; i < messageStatements.length; i += BATCH_SIZE) {
+        const batch = messageStatements.slice(i, i + BATCH_SIZE);
+        if (batch.length > 0) {
+          await this.client.batch(batch, "write");
+        }
+      }
+      if (threadUpdateStatement) {
+        await this.client.execute(threadUpdateStatement);
+      }
       const list = new agent.MessageList().add(messages, "memory");
       if (format === `v2`) return list.get.all.v2();
       return list.get.all.v1();
@@ -1368,6 +1379,56 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
     const updatedResult = await this.client.execute({ sql: selectSql, args: messageIds });
     return updatedResult.rows.map((row) => this.parseRow(row));
   }
+  async deleteMessages(messageIds) {
+    if (!messageIds || messageIds.length === 0) {
+      return;
+    }
+    try {
+      const BATCH_SIZE = 100;
+      const threadIds = /* @__PURE__ */ new Set();
+      const tx = await this.client.transaction("write");
+      try {
+        for (let i = 0; i < messageIds.length; i += BATCH_SIZE) {
+          const batch = messageIds.slice(i, i + BATCH_SIZE);
+          const placeholders = batch.map(() => "?").join(",");
+          const result = await tx.execute({
+            sql: `SELECT DISTINCT thread_id FROM "${storage.TABLE_MESSAGES}" WHERE id IN (${placeholders})`,
+            args: batch
+          });
+          result.rows?.forEach((row) => {
+            if (row.thread_id) threadIds.add(row.thread_id);
+          });
+          await tx.execute({
+            sql: `DELETE FROM "${storage.TABLE_MESSAGES}" WHERE id IN (${placeholders})`,
+            args: batch
+          });
+        }
+        if (threadIds.size > 0) {
+          const now = (/* @__PURE__ */ new Date()).toISOString();
+          for (const threadId of threadIds) {
+            await tx.execute({
+              sql: `UPDATE "${storage.TABLE_THREADS}" SET "updatedAt" = ? WHERE id = ?`,
+              args: [now, threadId]
+            });
+          }
+        }
+        await tx.commit();
+      } catch (error) {
+        await tx.rollback();
+        throw error;
+      }
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_DELETE_MESSAGES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { messageIds: messageIds.join(", ") }
+        },
+        error$1
+      );
+    }
+  }
   async getResourceById({ resourceId }) {
     const result = await this.operations.load({
       tableName: storage.TABLE_RESOURCES,
@@ -1471,7 +1532,9 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
    * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
    */
   async getThreadsByResourceId(args) {
-    const { resourceId } = args;
+    const resourceId = args.resourceId;
+    const orderBy = this.castThreadOrderBy(args.orderBy);
+    const sortDirection = this.castThreadSortDirection(args.sortDirection);
     try {
       const baseQuery = `FROM ${storage.TABLE_THREADS} WHERE resourceId = ?`;
       const queryParams = [resourceId];
@@ -1486,7 +1549,7 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
         metadata: typeof row.metadata === "string" ? JSON.parse(row.metadata) : row.metadata
       });
       const result = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY createdAt DESC`,
+        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection}`,
         args: queryParams
       });
       if (!result.rows) {
@@ -1510,6 +1573,8 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
   }
   async getThreadsByResourceIdPaginated(args) {
     const { resourceId, page = 0, perPage = 100 } = args;
+    const orderBy = this.castThreadOrderBy(args.orderBy);
+    const sortDirection = this.castThreadSortDirection(args.sortDirection);
     try {
       const baseQuery = `FROM ${storage.TABLE_THREADS} WHERE resourceId = ?`;
       const queryParams = [resourceId];
@@ -1539,7 +1604,7 @@ var MemoryLibSQL = class extends storage.MemoryStorage {
         };
       }
       const dataResult = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection} LIMIT ? OFFSET ?`,
         args: [...queryParams, perPage, currentOffset]
       });
       const threads = (dataResult.rows || []).map(mapRowToStorageThreadType);
@@ -2451,7 +2516,8 @@ var LibSQLStore = class extends storage.MastraStorage {
       selectByIncludeResourceScope: true,
       resourceWorkingMemory: true,
       hasColumn: true,
-      createTable: true
+      createTable: true,
+      deleteMessages: true
     };
   }
   async createTable({
@@ -2531,6 +2597,9 @@ var LibSQLStore = class extends storage.MastraStorage {
   }) {
     return this.stores.memory.updateMessages({ messages });
   }
+  async deleteMessages(messageIds) {
+    return this.stores.memory.deleteMessages(messageIds);
+  }
   /** @deprecated use getEvals instead */
   async getEvalsByAgentName(agentName, type) {
     return this.stores.legacyEvals.getEvalsByAgentName(agentName, type);

package/dist/index.js

@@ -650,7 +650,7 @@ var LibSQLVector = class extends MastraVector {
       await tx.commit();
       return vectorIds;
     } catch (error) {
-      await tx.rollback();
+      !tx.closed && await tx.rollback();
       if (error instanceof Error && error.message?.includes("dimensions are different")) {
         const match = error.message.match(/dimensions are different: (\d+) != (\d+)/);
         if (match) {
@@ -1247,14 +1247,14 @@ var MemoryLibSQL = class extends MemoryStorage {
           );
         }
         return {
-          sql: `INSERT INTO ${TABLE_MESSAGES} (id, thread_id, content, role, type, createdAt, resourceId) 
+          sql: `INSERT INTO "${TABLE_MESSAGES}" (id, thread_id, content, role, type, "createdAt", "resourceId") 
                   VALUES (?, ?, ?, ?, ?, ?, ?)
                   ON CONFLICT(id) DO UPDATE SET
                     thread_id=excluded.thread_id,
                     content=excluded.content,
                     role=excluded.role,
                     type=excluded.type,
-                    resourceId=excluded.resourceId
+                    "resourceId"=excluded."resourceId"
                 `,
           args: [
             message.id,
@@ -1269,10 +1269,21 @@ var MemoryLibSQL = class extends MemoryStorage {
       });
       const now = (/* @__PURE__ */ new Date()).toISOString();
       batchStatements.push({
-        sql: `UPDATE ${TABLE_THREADS} SET updatedAt = ? WHERE id = ?`,
+        sql: `UPDATE "${TABLE_THREADS}" SET "updatedAt" = ? WHERE id = ?`,
         args: [now, threadId]
       });
-      await this.client.batch(batchStatements, "write");
+      const BATCH_SIZE = 50;
+      const messageStatements = batchStatements.slice(0, -1);
+      const threadUpdateStatement = batchStatements[batchStatements.length - 1];
+      for (let i = 0; i < messageStatements.length; i += BATCH_SIZE) {
+        const batch = messageStatements.slice(i, i + BATCH_SIZE);
+        if (batch.length > 0) {
+          await this.client.batch(batch, "write");
+        }
+      }
+      if (threadUpdateStatement) {
+        await this.client.execute(threadUpdateStatement);
+      }
       const list = new MessageList().add(messages, "memory");
       if (format === `v2`) return list.get.all.v2();
       return list.get.all.v1();
@@ -1366,6 +1377,56 @@ var MemoryLibSQL = class extends MemoryStorage {
     const updatedResult = await this.client.execute({ sql: selectSql, args: messageIds });
     return updatedResult.rows.map((row) => this.parseRow(row));
   }
+  async deleteMessages(messageIds) {
+    if (!messageIds || messageIds.length === 0) {
+      return;
+    }
+    try {
+      const BATCH_SIZE = 100;
+      const threadIds = /* @__PURE__ */ new Set();
+      const tx = await this.client.transaction("write");
+      try {
+        for (let i = 0; i < messageIds.length; i += BATCH_SIZE) {
+          const batch = messageIds.slice(i, i + BATCH_SIZE);
+          const placeholders = batch.map(() => "?").join(",");
+          const result = await tx.execute({
+            sql: `SELECT DISTINCT thread_id FROM "${TABLE_MESSAGES}" WHERE id IN (${placeholders})`,
+            args: batch
+          });
+          result.rows?.forEach((row) => {
+            if (row.thread_id) threadIds.add(row.thread_id);
+          });
+          await tx.execute({
+            sql: `DELETE FROM "${TABLE_MESSAGES}" WHERE id IN (${placeholders})`,
+            args: batch
+          });
+        }
+        if (threadIds.size > 0) {
+          const now = (/* @__PURE__ */ new Date()).toISOString();
+          for (const threadId of threadIds) {
+            await tx.execute({
+              sql: `UPDATE "${TABLE_THREADS}" SET "updatedAt" = ? WHERE id = ?`,
+              args: [now, threadId]
+            });
+          }
+        }
+        await tx.commit();
+      } catch (error) {
+        await tx.rollback();
+        throw error;
+      }
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LIBSQL_STORE_DELETE_MESSAGES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { messageIds: messageIds.join(", ") }
+        },
+        error
+      );
+    }
+  }
   async getResourceById({ resourceId }) {
     const result = await this.operations.load({
       tableName: TABLE_RESOURCES,
@@ -1469,7 +1530,9 @@ var MemoryLibSQL = class extends MemoryStorage {
    * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
    */
   async getThreadsByResourceId(args) {
-    const { resourceId } = args;
+    const resourceId = args.resourceId;
+    const orderBy = this.castThreadOrderBy(args.orderBy);
+    const sortDirection = this.castThreadSortDirection(args.sortDirection);
     try {
       const baseQuery = `FROM ${TABLE_THREADS} WHERE resourceId = ?`;
       const queryParams = [resourceId];
@@ -1484,7 +1547,7 @@ var MemoryLibSQL = class extends MemoryStorage {
         metadata: typeof row.metadata === "string" ? JSON.parse(row.metadata) : row.metadata
       });
       const result = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY createdAt DESC`,
+        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection}`,
         args: queryParams
       });
       if (!result.rows) {
@@ -1508,6 +1571,8 @@ var MemoryLibSQL = class extends MemoryStorage {
   }
   async getThreadsByResourceIdPaginated(args) {
     const { resourceId, page = 0, perPage = 100 } = args;
+    const orderBy = this.castThreadOrderBy(args.orderBy);
+    const sortDirection = this.castThreadSortDirection(args.sortDirection);
     try {
       const baseQuery = `FROM ${TABLE_THREADS} WHERE resourceId = ?`;
       const queryParams = [resourceId];
@@ -1537,7 +1602,7 @@ var MemoryLibSQL = class extends MemoryStorage {
         };
       }
       const dataResult = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection} LIMIT ? OFFSET ?`,
         args: [...queryParams, perPage, currentOffset]
       });
       const threads = (dataResult.rows || []).map(mapRowToStorageThreadType);
@@ -2449,7 +2514,8 @@ var LibSQLStore = class extends MastraStorage {
       selectByIncludeResourceScope: true,
       resourceWorkingMemory: true,
       hasColumn: true,
-      createTable: true
+      createTable: true,
+      deleteMessages: true
     };
   }
   async createTable({
@@ -2529,6 +2595,9 @@ var LibSQLStore = class extends MastraStorage {
   }) {
     return this.stores.memory.updateMessages({ messages });
   }
+  async deleteMessages(messageIds) {
+    return this.stores.memory.deleteMessages(messageIds);
+  }
   /** @deprecated use getEvals instead */
   async getEvalsByAgentName(agentName, type) {
     return this.stores.legacyEvals.getEvalsByAgentName(agentName, type);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/libsql",
-  "version": "0.11.2",
+  "version": "0.11.3-alpha.1",
   "description": "Libsql provider for Mastra - includes both vector and db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@libsql/client": "^0.15.9"
+    "@libsql/client": "^0.15.10"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.8",
@@ -29,9 +29,9 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.22",
-    "@internal/storage-test-utils": "0.0.18",
-    "@mastra/core": "0.11.1"
+    "@internal/lint": "0.0.23",
+    "@mastra/core": "0.12.0-alpha.2",
+    "@internal/storage-test-utils": "0.0.19"
   },
   "peerDependencies": {
     "@mastra/core": ">=0.10.7-0 <0.12.0-0"

package/src/storage/domains/memory/index.ts

@@ -4,7 +4,12 @@ import type { MastraMessageContentV2 } from '@mastra/core/agent';
 import { MessageList } from '@mastra/core/agent';
 import { ErrorCategory, ErrorDomain, MastraError } from '@mastra/core/error';
 import type { MastraMessageV1, MastraMessageV2, StorageThreadType } from '@mastra/core/memory';
-import type { PaginationInfo, StorageGetMessagesArg, StorageResourceType } from '@mastra/core/storage';
+import type {
+  PaginationInfo,
+  StorageGetMessagesArg,
+  StorageResourceType,
+  ThreadSortOptions,
+} from '@mastra/core/storage';
 import {
   MemoryStorage,
   resolveMessageLimit,
@@ -288,14 +293,14 @@ export class MemoryLibSQL extends MemoryStorage {
           );
         }
         return {
-          sql: `INSERT INTO ${TABLE_MESSAGES} (id, thread_id, content, role, type, createdAt, resourceId) 
+          sql: `INSERT INTO "${TABLE_MESSAGES}" (id, thread_id, content, role, type, "createdAt", "resourceId") 
                   VALUES (?, ?, ?, ?, ?, ?, ?)
                   ON CONFLICT(id) DO UPDATE SET
                     thread_id=excluded.thread_id,
                     content=excluded.content,
                     role=excluded.role,
                     type=excluded.type,
-                    resourceId=excluded.resourceId
+                    "resourceId"=excluded."resourceId"
                 `,
           args: [
             message.id,
@@ -311,12 +316,29 @@ export class MemoryLibSQL extends MemoryStorage {
 
       const now = new Date().toISOString();
       batchStatements.push({
-        sql: `UPDATE ${TABLE_THREADS} SET updatedAt = ? WHERE id = ?`,
+        sql: `UPDATE "${TABLE_THREADS}" SET "updatedAt" = ? WHERE id = ?`,
         args: [now, threadId],
       });
 
-      // Execute all inserts in a single batch
-      await this.client.batch(batchStatements, 'write');
+      // Execute in batches to avoid potential limitations
+      const BATCH_SIZE = 50; // Safe batch size for libsql
+
+      // Separate message statements from thread update
+      const messageStatements = batchStatements.slice(0, -1);
+      const threadUpdateStatement = batchStatements[batchStatements.length - 1];
+
+      // Process message statements in batches
+      for (let i = 0; i < messageStatements.length; i += BATCH_SIZE) {
+        const batch = messageStatements.slice(i, i + BATCH_SIZE);
+        if (batch.length > 0) {
+          await this.client.batch(batch, 'write');
+        }
+      }
+
+      // Execute thread update separately
+      if (threadUpdateStatement) {
+        await this.client.execute(threadUpdateStatement);
+      }
 
       const list = new MessageList().add(messages, 'memory');
       if (format === `v2`) return list.get.all.v2();
@@ -439,6 +461,74 @@ export class MemoryLibSQL extends MemoryStorage {
     return updatedResult.rows.map(row => this.parseRow(row));
   }
 
+  async deleteMessages(messageIds: string[]): Promise<void> {
+    if (!messageIds || messageIds.length === 0) {
+      return;
+    }
+
+    try {
+      // Process in batches to avoid SQL parameter limits
+      const BATCH_SIZE = 100;
+      const threadIds = new Set<string>();
+
+      // Use a transaction to ensure consistency
+      const tx = await this.client.transaction('write');
+
+      try {
+        for (let i = 0; i < messageIds.length; i += BATCH_SIZE) {
+          const batch = messageIds.slice(i, i + BATCH_SIZE);
+          const placeholders = batch.map(() => '?').join(',');
+
+          // Get thread IDs for this batch
+          const result = await tx.execute({
+            sql: `SELECT DISTINCT thread_id FROM "${TABLE_MESSAGES}" WHERE id IN (${placeholders})`,
+            args: batch,
+          });
+
+          result.rows?.forEach(row => {
+            if (row.thread_id) threadIds.add(row.thread_id as string);
+          });
+
+          // Delete messages in this batch
+          await tx.execute({
+            sql: `DELETE FROM "${TABLE_MESSAGES}" WHERE id IN (${placeholders})`,
+            args: batch,
+          });
+        }
+
+        // Update thread timestamps within the transaction
+        if (threadIds.size > 0) {
+          const now = new Date().toISOString();
+          for (const threadId of threadIds) {
+            await tx.execute({
+              sql: `UPDATE "${TABLE_THREADS}" SET "updatedAt" = ? WHERE id = ?`,
+              args: [now, threadId],
+            });
+          }
+        }
+
+        // Commit the transaction
+        await tx.commit();
+      } catch (error) {
+        // Rollback on error
+        await tx.rollback();
+        throw error;
+      }
+
+      // TODO: Delete from vector store if semantic recall is enabled
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: 'LIBSQL_STORE_DELETE_MESSAGES_FAILED',
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { messageIds: messageIds.join(', ') },
+        },
+        error,
+      );
+    }
+  }
+
   async getResourceById({ resourceId }: { resourceId: string }): Promise<StorageResourceType | null> {
     const result = await this.operations.load<StorageResourceType>({
       tableName: TABLE_RESOURCES,
@@ -569,8 +659,10 @@ export class MemoryLibSQL extends MemoryStorage {
   /**
    * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
    */
-  public async getThreadsByResourceId(args: { resourceId: string }): Promise<StorageThreadType[]> {
-    const { resourceId } = args;
+  public async getThreadsByResourceId(args: { resourceId: string } & ThreadSortOptions): Promise<StorageThreadType[]> {
+    const resourceId = args.resourceId;
+    const orderBy = this.castThreadOrderBy(args.orderBy);
+    const sortDirection = this.castThreadSortDirection(args.sortDirection);
 
     try {
       const baseQuery = `FROM ${TABLE_THREADS} WHERE resourceId = ?`;
@@ -587,7 +679,7 @@ export class MemoryLibSQL extends MemoryStorage {
 
       // Non-paginated path
       const result = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY createdAt DESC`,
+        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection}`,
         args: queryParams,
       });
 
@@ -611,12 +703,16 @@ export class MemoryLibSQL extends MemoryStorage {
     }
   }
 
-  public async getThreadsByResourceIdPaginated(args: {
-    resourceId: string;
-    page: number;
-    perPage: number;
-  }): Promise<PaginationInfo & { threads: StorageThreadType[] }> {
+  public async getThreadsByResourceIdPaginated(
+    args: {
+      resourceId: string;
+      page: number;
+      perPage: number;
+    } & ThreadSortOptions,
+  ): Promise<PaginationInfo & { threads: StorageThreadType[] }> {
     const { resourceId, page = 0, perPage = 100 } = args;
+    const orderBy = this.castThreadOrderBy(args.orderBy);
+    const sortDirection = this.castThreadSortDirection(args.sortDirection);
 
     try {
       const baseQuery = `FROM ${TABLE_THREADS} WHERE resourceId = ?`;
@@ -650,7 +746,7 @@ export class MemoryLibSQL extends MemoryStorage {
       }
 
       const dataResult = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection} LIMIT ? OFFSET ?`,
         args: [...queryParams, perPage, currentOffset],
       });
 

package/src/storage/index.ts

@@ -17,6 +17,7 @@ import type {
   WorkflowRuns,
   StorageGetTracesArg,
   StorageDomains,
+  ThreadSortOptions,
 } from '@mastra/core/storage';
 
 import type { Trace } from '@mastra/core/telemetry';
@@ -117,6 +118,7 @@ export class LibSQLStore extends MastraStorage {
       resourceWorkingMemory: true,
       hasColumn: true,
       createTable: true,
+      deleteMessages: true,
     };
   }
 
@@ -175,15 +177,17 @@ export class LibSQLStore extends MastraStorage {
   /**
    * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
    */
-  public async getThreadsByResourceId(args: { resourceId: string }): Promise<StorageThreadType[]> {
+  public async getThreadsByResourceId(args: { resourceId: string } & ThreadSortOptions): Promise<StorageThreadType[]> {
     return this.stores.memory.getThreadsByResourceId(args);
   }
 
-  public async getThreadsByResourceIdPaginated(args: {
-    resourceId: string;
-    page: number;
-    perPage: number;
-  }): Promise<PaginationInfo & { threads: StorageThreadType[] }> {
+  public async getThreadsByResourceIdPaginated(
+    args: {
+      resourceId: string;
+      page: number;
+      perPage: number;
+    } & ThreadSortOptions,
+  ): Promise<PaginationInfo & { threads: StorageThreadType[] }> {
     return this.stores.memory.getThreadsByResourceIdPaginated(args);
   }
 
@@ -249,6 +253,10 @@ export class LibSQLStore extends MastraStorage {
     return this.stores.memory.updateMessages({ messages });
   }
 
+  async deleteMessages(messageIds: string[]): Promise<void> {
+    return this.stores.memory.deleteMessages(messageIds);
+  }
+
   /** @deprecated use getEvals instead */
   async getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]> {
     return this.stores.legacyEvals.getEvalsByAgentName(agentName, type);

package/src/vector/index.ts

@@ -232,7 +232,7 @@ export class LibSQLVector extends MastraVector<LibSQLVectorFilter> {
       await tx.commit();
       return vectorIds;
     } catch (error) {
-      await tx.rollback();
+      !tx.closed && (await tx.rollback());
       if (error instanceof Error && error.message?.includes('dimensions are different')) {
         const match = error.message.match(/dimensions are different: (\d+) != (\d+)/);
         if (match) {