@mastra/libsql 0.10.4-alpha.0 → 0.10.4-alpha.2

package/dist/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var client = require('@libsql/client');
+var error = require('@mastra/core/error');
 var utils = require('@mastra/core/utils');
 var vector = require('@mastra/core/vector');
 var filter = require('@mastra/core/vector/filter');
@@ -408,7 +409,7 @@ function buildCondition(key, value, parentPath) {
   return handleOperator(key, value);
 }
 function handleLogicalOperator(key, value, parentPath) {
-  if (!value || value.length === 0) {
+  if (!value || Array.isArray(value) && value.length === 0) {
     switch (key) {
       case "$and":
       case "$nor":
@@ -432,7 +433,7 @@ function handleLogicalOperator(key, value, parentPath) {
   const values = [];
   const joinOperator = key === "$or" || key === "$nor" ? "OR" : "AND";
   const conditions = Array.isArray(value) ? value.map((f) => {
-    const entries = Object.entries(f);
+    const entries = !!f ? Object.entries(f) : [];
     return entries.map(([k, v]) => buildCondition(k, v));
   }) : [buildCondition(key, value)];
   const joined = conditions.flat().map((c) => {
@@ -556,6 +557,17 @@ var LibSQLVector = class extends vector.MastraVector {
       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: "LIBSQL_VECTOR_QUERY_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER
+        },
+        error$1
+      );
+    }
+    try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
       const vectorStr = `[${queryVector.join(",")}]`;
       const translatedFilter = this.transformFilter(filter);
@@ -587,11 +599,30 @@ var LibSQLVector = class extends vector.MastraVector {
         metadata: JSON.parse(metadata ?? "{}"),
         ...includeVector && embedding && { vector: JSON.parse(embedding) }
       }));
-    } finally {
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_QUERY_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   upsert(args) {
-    return this.executeWriteOperationWithRetry(() => this.doUpsert(args), true);
+    try {
+      return this.executeWriteOperationWithRetry(() => this.doUpsert(args), true);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_UPSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
+    }
   }
   async doUpsert({ indexName, vectors, metadata, ids }) {
     const tx = await this.turso.transaction("write");
@@ -634,7 +665,19 @@ var LibSQLVector = class extends vector.MastraVector {
     }
   }
   createIndex(args) {
-    return this.executeWriteOperationWithRetry(() => this.doCreateIndex(args));
+    try {
+      return this.executeWriteOperationWithRetry(() => this.doCreateIndex(args));
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_CREATE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName: args.indexName, dimension: args.dimension }
+        },
+        error$1
+      );
+    }
   }
   async doCreateIndex({ indexName, dimension }) {
     if (!Number.isInteger(dimension) || dimension <= 0) {
@@ -661,7 +704,19 @@ var LibSQLVector = class extends vector.MastraVector {
     });
   }
   deleteIndex(args) {
-    return this.executeWriteOperationWithRetry(() => this.doDeleteIndex(args));
+    try {
+      return this.executeWriteOperationWithRetry(() => this.doDeleteIndex(args));
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_DELETE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName: args.indexName }
+        },
+        error$1
+      );
+    }
   }
   async doDeleteIndex({ indexName }) {
     const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
@@ -682,8 +737,15 @@ var LibSQLVector = class extends vector.MastraVector {
         args: []
       });
       return result.rows.map((row) => row.name);
-    } catch (error) {
-      throw new Error(`Failed to list vector tables: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_LIST_INDEXES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   /**
@@ -724,7 +786,15 @@ var LibSQLVector = class extends vector.MastraVector {
         metric
       };
     } catch (e) {
-      throw new Error(`Failed to describe vector table: ${e.message}`);
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_DESCRIBE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        e
+      );
     }
   }
   /**
@@ -754,7 +824,13 @@ var LibSQLVector = class extends vector.MastraVector {
       args.push(JSON.stringify(update.metadata));
     }
     if (updates.length === 0) {
-      throw new Error("No updates provided");
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName, id },
+        text: "No updates provided"
+      });
     }
     args.push(id);
     const query = `
@@ -762,10 +838,22 @@ var LibSQLVector = class extends vector.MastraVector {
         SET ${updates.join(", ")}
         WHERE vector_id = ?;
       `;
-    await this.turso.execute({
-      sql: query,
-      args
-    });
+    try {
+      await this.turso.execute({
+        sql: query,
+        args
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error$1
+      );
+    }
   }
   /**
    * Deletes a vector by its ID.
@@ -775,7 +863,19 @@ var LibSQLVector = class extends vector.MastraVector {
    * @throws Will throw an error if the deletion operation fails.
    */
   deleteVector(args) {
-    return this.executeWriteOperationWithRetry(() => this.doDeleteVector(args));
+    try {
+      return this.executeWriteOperationWithRetry(() => this.doDeleteVector(args));
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_DELETE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName: args.indexName, id: args.id }
+        },
+        error$1
+      );
+    }
   }
   async doDeleteVector({ indexName, id }) {
     const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
@@ -785,7 +885,19 @@ var LibSQLVector = class extends vector.MastraVector {
     });
   }
   truncateIndex(args) {
-    return this.executeWriteOperationWithRetry(() => this._doTruncateIndex(args));
+    try {
+      return this.executeWriteOperationWithRetry(() => this._doTruncateIndex(args));
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_TRUNCATE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName: args.indexName }
+        },
+        error$1
+      );
+    }
   }
   async _doTruncateIndex({ indexName }) {
     await this.turso.execute({
@@ -820,7 +932,8 @@ var LibSQLStore = class extends storage.MastraStorage {
   }
   get supports() {
     return {
-      selectByIncludeResourceScope: true
+      selectByIncludeResourceScope: true,
+      resourceWorkingMemory: true
     };
   }
   getCreateTableSQL(tableName, schema) {
@@ -851,9 +964,18 @@ var LibSQLStore = class extends storage.MastraStorage {
       this.logger.debug(`Creating database table`, { tableName, operation: "schema init" });
       const sql = this.getCreateTableSQL(tableName, schema);
       await this.client.execute(sql);
-    } catch (error) {
-      this.logger.error(`Error creating table ${tableName}: ${error}`);
-      throw error;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_CREATE_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: {
+            tableName
+          }
+        },
+        error$1
+      );
     }
   }
   getSqlType(type) {
@@ -895,11 +1017,18 @@ var LibSQLStore = class extends storage.MastraStorage {
           this.logger?.debug?.(`Added column ${columnName} to table ${parsedTableName}`);
         }
       }
-    } catch (error) {
-      this.logger?.error?.(
-        `Error altering table ${tableName}: ${error instanceof Error ? error.message : String(error)}`
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_ALTER_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: {
+            tableName
+          }
+        },
+        error$1
       );
-      throw new Error(`Failed to alter table ${tableName}: ${error}`);
     }
   }
   async clearTable({ tableName }) {
@@ -907,9 +1036,19 @@ var LibSQLStore = class extends storage.MastraStorage {
     try {
       await this.client.execute(`DELETE FROM ${parsedTableName}`);
     } catch (e) {
-      if (e instanceof Error) {
-        this.logger.error(e.message);
-      }
+      const mastraError = new error.MastraError(
+        {
+          id: "LIBSQL_STORE_CLEAR_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: {
+            tableName
+          }
+        },
+        e
+      );
+      this.logger?.trackException?.(mastraError);
+      this.logger?.error?.(mastraError.toString());
     }
   }
   prepareStatement({ tableName, record }) {
@@ -968,7 +1107,19 @@ var LibSQLStore = class extends storage.MastraStorage {
     return this.executeWriteOperationWithRetry(
       () => this.doBatchInsert(args),
       `batch insert into table ${args.tableName}`
-    );
+    ).catch((error$1) => {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_BATCH_INSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: {
+            tableName: args.tableName
+          }
+        },
+        error$1
+      );
+    });
   }
   async doBatchInsert({
     tableName,
@@ -1003,17 +1154,29 @@ var LibSQLStore = class extends storage.MastraStorage {
     return parsed;
   }
   async getThreadById({ threadId }) {
-    const result = await this.load({
-      tableName: storage.TABLE_THREADS,
-      keys: { id: threadId }
-    });
-    if (!result) {
-      return null;
+    try {
+      const result = await this.load({
+        tableName: storage.TABLE_THREADS,
+        keys: { id: threadId }
+      });
+      if (!result) {
+        return null;
+      }
+      return {
+        ...result,
+        metadata: typeof result.metadata === "string" ? JSON.parse(result.metadata) : result.metadata
+      };
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_THREAD_BY_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { threadId }
+        },
+        error$1
+      );
     }
-    return {
-      ...result,
-      metadata: typeof result.metadata === "string" ? JSON.parse(result.metadata) : result.metadata
-    };
   }
   /**
    * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
@@ -1041,8 +1204,18 @@ var LibSQLStore = class extends storage.MastraStorage {
         return [];
       }
       return result.rows.map(mapRowToStorageThreadType);
-    } catch (error) {
-      this.logger.error(`Error getting threads for resource ${resourceId}:`, error);
+    } catch (error$1) {
+      const mastraError = new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_THREADS_BY_RESOURCE_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { resourceId }
+        },
+        error$1
+      );
+      this.logger?.trackException?.(mastraError);
+      this.logger?.error?.(mastraError.toString());
       return [];
     }
   }
@@ -1088,20 +1261,45 @@ var LibSQLStore = class extends storage.MastraStorage {
         perPage,
         hasMore: currentOffset + threads.length < total
       };
-    } catch (error) {
-      this.logger.error(`Error getting threads for resource ${resourceId}:`, error);
+    } catch (error$1) {
+      const mastraError = new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_THREADS_BY_RESOURCE_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { resourceId }
+        },
+        error$1
+      );
+      this.logger?.trackException?.(mastraError);
+      this.logger?.error?.(mastraError.toString());
       return { threads: [], total: 0, page, perPage, hasMore: false };
     }
   }
   async saveThread({ thread }) {
-    await this.insert({
-      tableName: storage.TABLE_THREADS,
-      record: {
-        ...thread,
-        metadata: JSON.stringify(thread.metadata)
-      }
-    });
-    return thread;
+    try {
+      await this.insert({
+        tableName: storage.TABLE_THREADS,
+        record: {
+          ...thread,
+          metadata: JSON.stringify(thread.metadata)
+        }
+      });
+      return thread;
+    } catch (error$1) {
+      const mastraError = new error.MastraError(
+        {
+          id: "LIBSQL_STORE_SAVE_THREAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { threadId: thread.id }
+        },
+        error$1
+      );
+      this.logger?.trackException?.(mastraError);
+      this.logger?.error?.(mastraError.toString());
+      throw mastraError;
+    }
   }
   async updateThread({
     id,
@@ -1110,7 +1308,13 @@ var LibSQLStore = class extends storage.MastraStorage {
   }) {
     const thread = await this.getThreadById({ threadId: id });
     if (!thread) {
-      throw new Error(`Thread ${id} not found`);
+      throw new error.MastraError({
+        id: "LIBSQL_STORE_UPDATE_THREAD_FAILED_THREAD_NOT_FOUND",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        text: `Thread ${id} not found`,
+        details: { threadId: id }
+      });
     }
     const updatedThread = {
       ...thread,
@@ -1120,21 +1324,46 @@ var LibSQLStore = class extends storage.MastraStorage {
         ...metadata
       }
     };
-    await this.client.execute({
-      sql: `UPDATE ${storage.TABLE_THREADS} SET title = ?, metadata = ? WHERE id = ?`,
-      args: [title, JSON.stringify(updatedThread.metadata), id]
-    });
-    return updatedThread;
+    try {
+      await this.client.execute({
+        sql: `UPDATE ${storage.TABLE_THREADS} SET title = ?, metadata = ? WHERE id = ?`,
+        args: [title, JSON.stringify(updatedThread.metadata), id]
+      });
+      return updatedThread;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_UPDATE_THREAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          text: `Failed to update thread ${id}`,
+          details: { threadId: id }
+        },
+        error$1
+      );
+    }
   }
   async deleteThread({ threadId }) {
-    await this.client.execute({
-      sql: `DELETE FROM ${storage.TABLE_MESSAGES} WHERE thread_id = ?`,
-      args: [threadId]
-    });
-    await this.client.execute({
-      sql: `DELETE FROM ${storage.TABLE_THREADS} WHERE id = ?`,
-      args: [threadId]
-    });
+    try {
+      await this.client.execute({
+        sql: `DELETE FROM ${storage.TABLE_MESSAGES} WHERE thread_id = ?`,
+        args: [threadId]
+      });
+      await this.client.execute({
+        sql: `DELETE FROM ${storage.TABLE_THREADS} WHERE id = ?`,
+        args: [threadId]
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_DELETE_THREAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { threadId }
+        },
+        error$1
+      );
+    }
   }
   parseRow(row) {
     let content = row.content;
@@ -1207,7 +1436,7 @@ var LibSQLStore = class extends storage.MastraStorage {
   }) {
     try {
       const messages = [];
-      const limit = typeof selectBy?.last === `number` ? selectBy.last : 40;
+      const limit = this.resolveMessageLimit({ last: selectBy?.last, defaultLimit: 40 });
       if (selectBy?.include?.length) {
         const includeMessages = await this._getIncludedMessages({ threadId, selectBy });
         if (includeMessages) {
@@ -1239,21 +1468,41 @@ var LibSQLStore = class extends storage.MastraStorage {
       const list = new agent.MessageList().add(messages, "memory");
       if (format === `v2`) return list.get.all.v2();
       return list.get.all.v1();
-    } catch (error) {
-      this.logger.error("Error getting messages:", error);
-      throw error;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_MESSAGES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { threadId }
+        },
+        error$1
+      );
     }
   }
   async getMessagesPaginated(args) {
     const { threadId, format, selectBy } = args;
-    const { page = 0, perPage = 40, dateRange } = selectBy?.pagination || {};
+    const { page = 0, perPage: perPageInput, dateRange } = selectBy?.pagination || {};
+    const perPage = perPageInput !== void 0 ? perPageInput : this.resolveMessageLimit({ last: selectBy?.last, defaultLimit: 40 });
     const fromDate = dateRange?.start;
     const toDate = dateRange?.end;
     const messages = [];
     if (selectBy?.include?.length) {
-      const includeMessages = await this._getIncludedMessages({ threadId, selectBy });
-      if (includeMessages) {
-        messages.push(...includeMessages);
+      try {
+        const includeMessages = await this._getIncludedMessages({ threadId, selectBy });
+        if (includeMessages) {
+          messages.push(...includeMessages);
+        }
+      } catch (error$1) {
+        throw new error.MastraError(
+          {
+            id: "LIBSQL_STORE_GET_MESSAGES_PAGINATED_GET_INCLUDE_MESSAGES_FAILED",
+            domain: error.ErrorDomain.STORAGE,
+            category: error.ErrorCategory.THIRD_PARTY,
+            details: { threadId }
+          },
+          error$1
+        );
       }
     }
     try {
@@ -1274,7 +1523,7 @@ var LibSQLStore = class extends storage.MastraStorage {
         args: queryParams
       });
       const total = Number(countResult.rows?.[0]?.count ?? 0);
-      if (total === 0) {
+      if (total === 0 && messages.length === 0) {
         return {
           messages: [],
           total: 0,
@@ -1283,9 +1532,11 @@ var LibSQLStore = class extends storage.MastraStorage {
           hasMore: false
         };
       }
+      const excludeIds = messages.map((m) => m.id);
+      const excludeIdsParam = excludeIds.map((_, idx) => `$${idx + queryParams.length + 1}`).join(", ");
       const dataResult = await this.client.execute({
-        sql: `SELECT id, content, role, type, "createdAt", thread_id FROM ${storage.TABLE_MESSAGES} ${whereClause} ORDER BY "createdAt" DESC LIMIT ? OFFSET ?`,
-        args: [...queryParams, perPage, currentOffset]
+        sql: `SELECT id, content, role, type, "createdAt", "resourceId", "thread_id" FROM ${storage.TABLE_MESSAGES} ${whereClause} ${excludeIds.length ? `AND id NOT IN (${excludeIdsParam})` : ""} ORDER BY "createdAt" DESC LIMIT ? OFFSET ?`,
+        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();
@@ -1296,8 +1547,18 @@ var LibSQLStore = class extends storage.MastraStorage {
         perPage,
         hasMore: currentOffset + messages.length < total
       };
-    } catch (error) {
-      this.logger.error("Error getting paginated messages:", error);
+    } catch (error$1) {
+      const mastraError = new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_MESSAGES_PAGINATED_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { threadId }
+        },
+        error$1
+      );
+      this.logger?.trackException?.(mastraError);
+      this.logger?.error?.(mastraError.toString());
       return { messages: [], total: 0, page, perPage, hasMore: false };
     }
   }
@@ -1325,7 +1586,14 @@ var LibSQLStore = class extends storage.MastraStorage {
         }
         return {
           sql: `INSERT INTO ${storage.TABLE_MESSAGES} (id, thread_id, content, role, type, createdAt, resourceId) 
-                VALUES (?, ?, ?, ?, ?, ?, ?)`,
+                VALUES (?, ?, ?, ?, ?, ?, ?)
+                ON CONFLICT(id) DO UPDATE SET
+                  thread_id=excluded.thread_id,
+                  content=excluded.content,
+                  role=excluded.role,
+                  type=excluded.type,
+                  resourceId=excluded.resourceId
+              `,
           args: [
             message.id,
             message.threadId,
@@ -1346,9 +1614,15 @@ var LibSQLStore = class extends storage.MastraStorage {
       const list = new agent.MessageList().add(messages, "memory");
       if (format === `v2`) return list.get.all.v2();
       return list.get.all.v1();
-    } catch (error) {
-      this.logger.error("Failed to save messages in database: " + error?.message);
-      throw error;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_SAVE_MESSAGES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async updateMessages({
@@ -1459,12 +1733,19 @@ var LibSQLStore = class extends storage.MastraStorage {
         args: [agentName]
       });
       return result.rows?.map((row) => this.transformEvalRow(row)) ?? [];
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("no such table")) {
+    } catch (error$1) {
+      if (error$1 instanceof Error && error$1.message.includes("no such table")) {
         return [];
       }
-      this.logger.error("Failed to get evals for the specified agent: " + error?.message);
-      throw error;
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_EVALS_BY_AGENT_NAME_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { agentName }
+        },
+        error$1
+      );
     }
   }
   async getEvals(options = {}) {
@@ -1491,33 +1772,44 @@ var LibSQLStore = class extends storage.MastraStorage {
       queryParams.push(toDate.toISOString());
     }
     const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const countResult = await this.client.execute({
-      sql: `SELECT COUNT(*) as count FROM ${storage.TABLE_EVALS} ${whereClause}`,
-      args: queryParams
-    });
-    const total = Number(countResult.rows?.[0]?.count ?? 0);
-    const currentOffset = page * perPage;
-    const hasMore = currentOffset + perPage < total;
-    if (total === 0) {
+    try {
+      const countResult = await this.client.execute({
+        sql: `SELECT COUNT(*) as count FROM ${storage.TABLE_EVALS} ${whereClause}`,
+        args: queryParams
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      const currentOffset = page * perPage;
+      const hasMore = currentOffset + perPage < total;
+      if (total === 0) {
+        return {
+          evals: [],
+          total: 0,
+          page,
+          perPage,
+          hasMore: false
+        };
+      }
+      const dataResult = await this.client.execute({
+        sql: `SELECT * FROM ${storage.TABLE_EVALS} ${whereClause} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
+        args: [...queryParams, perPage, currentOffset]
+      });
       return {
-        evals: [],
-        total: 0,
+        evals: dataResult.rows?.map((row) => this.transformEvalRow(row)) ?? [],
+        total,
         page,
         perPage,
-        hasMore: false
+        hasMore
       };
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_EVALS_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
-    const dataResult = await this.client.execute({
-      sql: `SELECT * FROM ${storage.TABLE_EVALS} ${whereClause} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
-      args: [...queryParams, perPage, currentOffset]
-    });
-    return {
-      evals: dataResult.rows?.map((row) => this.transformEvalRow(row)) ?? [],
-      total,
-      page,
-      perPage,
-      hasMore
-    };
   }
   /**
    * @deprecated use getTracesPaginated instead.
@@ -1529,8 +1821,19 @@ var LibSQLStore = class extends storage.MastraStorage {
         end: args.toDate
       };
     }
-    const result = await this.getTracesPaginated(args);
-    return result.traces;
+    try {
+      const result = await this.getTracesPaginated(args);
+      return result.traces;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_TRACES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
+    }
   }
   async getTracesPaginated(args) {
     const { name, scope, page = 0, perPage = 100, attributes, filters, dateRange } = args;
@@ -1568,49 +1871,60 @@ var LibSQLStore = class extends storage.MastraStorage {
       queryArgs.push(toDate.toISOString());
     }
     const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const countResult = await this.client.execute({
-      sql: `SELECT COUNT(*) as count FROM ${storage.TABLE_TRACES} ${whereClause}`,
-      args: queryArgs
-    });
-    const total = Number(countResult.rows?.[0]?.count ?? 0);
-    if (total === 0) {
+    try {
+      const countResult = await this.client.execute({
+        sql: `SELECT COUNT(*) as count FROM ${storage.TABLE_TRACES} ${whereClause}`,
+        args: queryArgs
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          traces: [],
+          total: 0,
+          page,
+          perPage,
+          hasMore: false
+        };
+      }
+      const dataResult = await this.client.execute({
+        sql: `SELECT * FROM ${storage.TABLE_TRACES} ${whereClause} ORDER BY "startTime" DESC LIMIT ? OFFSET ?`,
+        args: [...queryArgs, perPage, currentOffset]
+      });
+      const traces = dataResult.rows?.map(
+        (row) => ({
+          id: row.id,
+          parentSpanId: row.parentSpanId,
+          traceId: row.traceId,
+          name: row.name,
+          scope: row.scope,
+          kind: row.kind,
+          status: safelyParseJSON(row.status),
+          events: safelyParseJSON(row.events),
+          links: safelyParseJSON(row.links),
+          attributes: safelyParseJSON(row.attributes),
+          startTime: row.startTime,
+          endTime: row.endTime,
+          other: safelyParseJSON(row.other),
+          createdAt: row.createdAt
+        })
+      ) ?? [];
       return {
-        traces: [],
-        total: 0,
+        traces,
+        total,
         page,
         perPage,
-        hasMore: false
+        hasMore: currentOffset + traces.length < total
       };
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_TRACES_PAGINATED_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
-    const dataResult = await this.client.execute({
-      sql: `SELECT * FROM ${storage.TABLE_TRACES} ${whereClause} ORDER BY "startTime" DESC LIMIT ? OFFSET ?`,
-      args: [...queryArgs, perPage, currentOffset]
-    });
-    const traces = dataResult.rows?.map(
-      (row) => ({
-        id: row.id,
-        parentSpanId: row.parentSpanId,
-        traceId: row.traceId,
-        name: row.name,
-        scope: row.scope,
-        kind: row.kind,
-        status: safelyParseJSON(row.status),
-        events: safelyParseJSON(row.events),
-        links: safelyParseJSON(row.links),
-        attributes: safelyParseJSON(row.attributes),
-        startTime: row.startTime,
-        endTime: row.endTime,
-        other: safelyParseJSON(row.other),
-        createdAt: row.createdAt
-      })
-    ) ?? [];
-    return {
-      traces,
-      total,
-      page,
-      perPage,
-      hasMore: currentOffset + traces.length < total
-    };
   }
   async getWorkflowRuns({
     workflowName,
@@ -1659,9 +1973,15 @@ var LibSQLStore = class extends storage.MastraStorage {
       });
       const runs = (result.rows || []).map((row) => this.parseWorkflowRun(row));
       return { runs, total: total || runs.length };
-    } catch (error) {
-      console.error("Error getting workflow runs:", error);
-      throw error;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_WORKFLOW_RUNS_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async getWorkflowRunById({
@@ -1679,14 +1999,94 @@ var LibSQLStore = class extends storage.MastraStorage {
       args.push(workflowName);
     }
     const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const result = await this.client.execute({
-      sql: `SELECT * FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} ${whereClause}`,
-      args
+    try {
+      const result = await this.client.execute({
+        sql: `SELECT * FROM ${storage.TABLE_WORKFLOW_SNAPSHOT} ${whereClause}`,
+        args
+      });
+      if (!result.rows?.[0]) {
+        return null;
+      }
+      return this.parseWorkflowRun(result.rows[0]);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_STORE_GET_WORKFLOW_RUN_BY_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
+    }
+  }
+  async getResourceById({ resourceId }) {
+    const result = await this.load({
+      tableName: storage.TABLE_RESOURCES,
+      keys: { id: resourceId }
     });
-    if (!result.rows?.[0]) {
+    if (!result) {
       return null;
     }
-    return this.parseWorkflowRun(result.rows[0]);
+    return {
+      ...result,
+      // Ensure workingMemory is always returned as a string, even if auto-parsed as JSON
+      workingMemory: typeof result.workingMemory === "object" ? JSON.stringify(result.workingMemory) : result.workingMemory,
+      metadata: typeof result.metadata === "string" ? JSON.parse(result.metadata) : result.metadata
+    };
+  }
+  async saveResource({ resource }) {
+    await this.insert({
+      tableName: storage.TABLE_RESOURCES,
+      record: {
+        ...resource,
+        metadata: JSON.stringify(resource.metadata)
+      }
+    });
+    return resource;
+  }
+  async updateResource({
+    resourceId,
+    workingMemory,
+    metadata
+  }) {
+    const existingResource = await this.getResourceById({ resourceId });
+    if (!existingResource) {
+      const newResource = {
+        id: resourceId,
+        workingMemory,
+        metadata: metadata || {},
+        createdAt: /* @__PURE__ */ new Date(),
+        updatedAt: /* @__PURE__ */ new Date()
+      };
+      return this.saveResource({ resource: newResource });
+    }
+    const updatedResource = {
+      ...existingResource,
+      workingMemory: workingMemory !== void 0 ? workingMemory : existingResource.workingMemory,
+      metadata: {
+        ...existingResource.metadata,
+        ...metadata
+      },
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+    const updates = [];
+    const values = [];
+    if (workingMemory !== void 0) {
+      updates.push("workingMemory = ?");
+      values.push(workingMemory);
+    }
+    if (metadata) {
+      updates.push("metadata = ?");
+      values.push(JSON.stringify(updatedResource.metadata));
+    }
+    updates.push("updatedAt = ?");
+    values.push(updatedResource.updatedAt.toISOString());
+    values.push(resourceId);
+    await this.client.execute({
+      sql: `UPDATE ${storage.TABLE_RESOURCES} SET ${updates.join(", ")} WHERE id = ?`,
+      args: values
+    });
+    return updatedResource;
   }
   async hasColumn(table, column) {
     const result = await this.client.execute({