@mastra/libsql 0.16.2 → 1.0.0-beta.0

package/dist/index.js

@@ -3,9 +3,9 @@ import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
 import { parseSqlIdentifier, parseFieldKey } from '@mastra/core/utils';
 import { MastraVector } from '@mastra/core/vector';
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-import { MastraStorage, StoreOperations, TABLE_WORKFLOW_SNAPSHOT, TABLE_AI_SPANS, ScoresStorage, TABLE_SCORERS, safelyParseJSON, TracesStorage, TABLE_TRACES, WorkflowsStorage, MemoryStorage, resolveMessageLimit, TABLE_MESSAGES, TABLE_THREADS, TABLE_RESOURCES, LegacyEvalsStorage, TABLE_EVALS, ObservabilityStorage, TABLE_SCHEMAS, AI_SPAN_SCHEMA } from '@mastra/core/storage';
+import { MastraStorage, StoreOperations, TABLE_WORKFLOW_SNAPSHOT, TABLE_SPANS, ScoresStorage, TABLE_SCORERS, normalizePerPage, calculatePagination, safelyParseJSON, WorkflowsStorage, MemoryStorage, TABLE_MESSAGES, TABLE_THREADS, TABLE_RESOURCES, ObservabilityStorage, TABLE_SCHEMAS, SPAN_SCHEMA } from '@mastra/core/storage';
 import { MessageList } from '@mastra/core/agent';
-import { saveScorePayloadSchema } from '@mastra/core/scores';
+import { saveScorePayloadSchema } from '@mastra/core/evals';
 
 // src/vector/index.ts
 var LibSQLFilterTranslator = class extends BaseFilterTranslator {
@@ -505,9 +505,10 @@ var LibSQLVector = class extends MastraVector {
     syncUrl,
     syncInterval,
     maxRetries = 5,
-    initialBackoffMs = 100
+    initialBackoffMs = 100,
+    id
   }) {
-    super();
+    super({ id });
     this.turso = createClient({
       url: connectionUrl,
       syncUrl,
@@ -918,120 +919,6 @@ var LibSQLVector = class extends MastraVector {
     });
   }
 };
-function transformEvalRow(row) {
-  const resultValue = JSON.parse(row.result);
-  const testInfoValue = row.test_info ? JSON.parse(row.test_info) : void 0;
-  if (!resultValue || typeof resultValue !== "object" || !("score" in resultValue)) {
-    throw new Error(`Invalid MetricResult format: ${JSON.stringify(resultValue)}`);
-  }
-  return {
-    input: row.input,
-    output: row.output,
-    result: resultValue,
-    agentName: row.agent_name,
-    metricName: row.metric_name,
-    instructions: row.instructions,
-    testInfo: testInfoValue,
-    globalRunId: row.global_run_id,
-    runId: row.run_id,
-    createdAt: row.created_at
-  };
-}
-var LegacyEvalsLibSQL = class extends LegacyEvalsStorage {
-  client;
-  constructor({ client }) {
-    super();
-    this.client = client;
-  }
-  /** @deprecated use getEvals instead */
-  async getEvalsByAgentName(agentName, type) {
-    try {
-      const baseQuery = `SELECT * FROM ${TABLE_EVALS} WHERE agent_name = ?`;
-      const typeCondition = type === "test" ? " AND test_info IS NOT NULL AND test_info->>'testPath' IS NOT NULL" : type === "live" ? " AND (test_info IS NULL OR test_info->>'testPath' IS NULL)" : "";
-      const result = await this.client.execute({
-        sql: `${baseQuery}${typeCondition} ORDER BY created_at DESC`,
-        args: [agentName]
-      });
-      return result.rows?.map((row) => transformEvalRow(row)) ?? [];
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("no such table")) {
-        return [];
-      }
-      throw new MastraError(
-        {
-          id: "LIBSQL_STORE_GET_EVALS_BY_AGENT_NAME_FAILED",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { agentName }
-        },
-        error
-      );
-    }
-  }
-  async getEvals(options = {}) {
-    const { agentName, type, page = 0, perPage = 100, dateRange } = options;
-    const fromDate = dateRange?.start;
-    const toDate = dateRange?.end;
-    const conditions = [];
-    const queryParams = [];
-    if (agentName) {
-      conditions.push(`agent_name = ?`);
-      queryParams.push(agentName);
-    }
-    if (type === "test") {
-      conditions.push(`(test_info IS NOT NULL AND json_extract(test_info, '$.testPath') IS NOT NULL)`);
-    } else if (type === "live") {
-      conditions.push(`(test_info IS NULL OR json_extract(test_info, '$.testPath') IS NULL)`);
-    }
-    if (fromDate) {
-      conditions.push(`created_at >= ?`);
-      queryParams.push(fromDate.toISOString());
-    }
-    if (toDate) {
-      conditions.push(`created_at <= ?`);
-      queryParams.push(toDate.toISOString());
-    }
-    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    try {
-      const countResult = await this.client.execute({
-        sql: `SELECT COUNT(*) as count FROM ${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 ${TABLE_EVALS} ${whereClause} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
-        args: [...queryParams, perPage, currentOffset]
-      });
-      return {
-        evals: dataResult.rows?.map((row) => transformEvalRow(row)) ?? [],
-        total,
-        page,
-        perPage,
-        hasMore
-      };
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: "LIBSQL_STORE_GET_EVALS_FAILED",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
-        },
-        error
-      );
-    }
-  }
-};
 var MemoryLibSQL = class extends MemoryStorage {
   client;
   operations;
@@ -1059,10 +946,9 @@ var MemoryLibSQL = class extends MemoryStorage {
   }
   async _getIncludedMessages({
     threadId,
-    selectBy
+    include
   }) {
     if (!threadId.trim()) throw new Error("threadId must be a non-empty string");
-    const include = selectBy?.include;
     if (!include) return null;
     const unionQueries = [];
     const params = [];
@@ -1105,24 +991,10 @@ var MemoryLibSQL = class extends MemoryStorage {
     });
     return dedupedRows;
   }
-  async getMessages({
-    threadId,
-    resourceId,
-    selectBy,
-    format
-  }) {
+  async listMessagesById({ messageIds }) {
+    if (messageIds.length === 0) return { messages: [] };
     try {
-      if (!threadId.trim()) throw new Error("threadId must be a non-empty string");
-      const messages = [];
-      const limit = resolveMessageLimit({ last: selectBy?.last, defaultLimit: 40 });
-      if (selectBy?.include?.length) {
-        const includeMessages = await this._getIncludedMessages({ threadId, selectBy });
-        if (includeMessages) {
-          messages.push(...includeMessages);
-        }
-      }
-      const excludeIds = messages.map((m) => m.id);
-      const remainingSql = `
+      const sql = `
         SELECT 
           id, 
           content, 
@@ -1132,105 +1004,71 @@ var MemoryLibSQL = class extends MemoryStorage {
           thread_id,
           "resourceId"
         FROM "${TABLE_MESSAGES}"
-        WHERE thread_id = ?
-        ${excludeIds.length ? `AND id NOT IN (${excludeIds.map(() => "?").join(", ")})` : ""}
+        WHERE id IN (${messageIds.map(() => "?").join(", ")})
         ORDER BY "createdAt" DESC
-        LIMIT ?
       `;
-      const remainingArgs = [threadId, ...excludeIds.length ? excludeIds : [], limit];
-      const remainingResult = await this.client.execute({ sql: remainingSql, args: remainingArgs });
-      if (remainingResult.rows) {
-        messages.push(...remainingResult.rows.map((row) => this.parseRow(row)));
-      }
-      messages.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
-      const list = new MessageList().add(messages, "memory");
-      if (format === `v2`) return list.get.all.v2();
-      return list.get.all.v1();
+      const result = await this.client.execute({ sql, args: messageIds });
+      if (!result.rows) return { messages: [] };
+      const list = new MessageList().add(result.rows.map(this.parseRow), "memory");
+      return { messages: list.get.all.db() };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_MESSAGES_FAILED",
+          id: "LIBSQL_STORE_LIST_MESSAGES_BY_ID_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { threadId, resourceId: resourceId ?? "" }
+          details: { messageIds: JSON.stringify(messageIds) }
         },
         error
       );
     }
   }
-  async getMessagesById({
-    messageIds,
-    format
-  }) {
-    if (messageIds.length === 0) return [];
-    try {
-      const sql = `
-        SELECT 
-          id, 
-          content, 
-          role, 
-          type,
-          "createdAt", 
-          thread_id,
-          "resourceId"
-        FROM "${TABLE_MESSAGES}"
-        WHERE id IN (${messageIds.map(() => "?").join(", ")})
-        ORDER BY "createdAt" DESC
-      `;
-      const result = await this.client.execute({ sql, args: messageIds });
-      if (!result.rows) return [];
-      const list = new MessageList().add(result.rows.map(this.parseRow), "memory");
-      if (format === `v1`) return list.get.all.v1();
-      return list.get.all.v2();
-    } catch (error) {
+  async listMessages(args) {
+    const { threadId, resourceId, include, filter, perPage: perPageInput, page = 0, orderBy } = args;
+    if (!threadId.trim()) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_MESSAGES_BY_ID_FAILED",
+          id: "STORAGE_LIBSQL_LIST_MESSAGES_INVALID_THREAD_ID",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { messageIds: JSON.stringify(messageIds) }
+          details: { threadId }
         },
-        error
+        new Error("threadId must be a non-empty string")
       );
     }
-  }
-  async getMessagesPaginated(args) {
-    const { threadId, format, selectBy } = args;
-    const { page = 0, perPage: perPageInput, dateRange } = selectBy?.pagination || {};
-    const perPage = perPageInput !== void 0 ? perPageInput : resolveMessageLimit({ last: selectBy?.last, defaultLimit: 40 });
-    const fromDate = dateRange?.start;
-    const toDate = dateRange?.end;
-    const messages = [];
-    if (selectBy?.include?.length) {
-      try {
-        const includeMessages = await this._getIncludedMessages({ threadId, selectBy });
-        if (includeMessages) {
-          messages.push(...includeMessages);
-        }
-      } catch (error) {
-        throw new MastraError(
-          {
-            id: "LIBSQL_STORE_GET_MESSAGES_PAGINATED_GET_INCLUDE_MESSAGES_FAILED",
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.THIRD_PARTY,
-            details: { threadId }
-          },
-          error
-        );
-      }
+    if (page < 0) {
+      throw new MastraError(
+        {
+          id: "LIBSQL_STORE_LIST_MESSAGES_INVALID_PAGE",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { page }
+        },
+        new Error("page must be >= 0")
+      );
     }
+    const perPage = normalizePerPage(perPageInput, 40);
+    const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
     try {
-      if (!threadId.trim()) throw new Error("threadId must be a non-empty string");
-      const currentOffset = page * perPage;
+      const { field, direction } = this.parseOrderBy(orderBy, "ASC");
+      const orderByStatement = `ORDER BY "${field}" ${direction}`;
       const conditions = [`thread_id = ?`];
       const queryParams = [threadId];
-      if (fromDate) {
+      if (resourceId) {
+        conditions.push(`"resourceId" = ?`);
+        queryParams.push(resourceId);
+      }
+      if (filter?.dateRange?.start) {
         conditions.push(`"createdAt" >= ?`);
-        queryParams.push(fromDate.toISOString());
+        queryParams.push(
+          filter.dateRange.start instanceof Date ? filter.dateRange.start.toISOString() : filter.dateRange.start
+        );
       }
-      if (toDate) {
+      if (filter?.dateRange?.end) {
         conditions.push(`"createdAt" <= ?`);
-        queryParams.push(toDate.toISOString());
+        queryParams.push(
+          filter.dateRange.end instanceof Date ? filter.dateRange.end.toISOString() : filter.dateRange.end
+        );
       }
       const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
       const countResult = await this.client.execute({
@@ -1238,50 +1076,80 @@ var MemoryLibSQL = class extends MemoryStorage {
         args: queryParams
       });
       const total = Number(countResult.rows?.[0]?.count ?? 0);
-      if (total === 0 && messages.length === 0) {
+      const limitValue = perPageInput === false ? total : perPage;
+      const dataResult = await this.client.execute({
+        sql: `SELECT id, content, role, type, "createdAt", "resourceId", "thread_id" FROM ${TABLE_MESSAGES} ${whereClause} ${orderByStatement} LIMIT ? OFFSET ?`,
+        args: [...queryParams, limitValue, offset]
+      });
+      const messages = (dataResult.rows || []).map((row) => this.parseRow(row));
+      if (total === 0 && messages.length === 0 && (!include || include.length === 0)) {
         return {
           messages: [],
           total: 0,
           page,
-          perPage,
+          perPage: perPageForResponse,
           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", "resourceId", "thread_id" FROM ${TABLE_MESSAGES} ${whereClause} ${excludeIds.length ? `AND id NOT IN (${excludeIdsParam})` : ""} ORDER BY "createdAt" DESC LIMIT ? OFFSET ?`,
-        args: [...queryParams, ...excludeIds, perPage, currentOffset]
+      const messageIds = new Set(messages.map((m) => m.id));
+      if (include && include.length > 0) {
+        const includeMessages = await this._getIncludedMessages({ threadId, include });
+        if (includeMessages) {
+          for (const includeMsg of includeMessages) {
+            if (!messageIds.has(includeMsg.id)) {
+              messages.push(includeMsg);
+              messageIds.add(includeMsg.id);
+            }
+          }
+        }
+      }
+      const list = new MessageList().add(messages, "memory");
+      let finalMessages = list.get.all.db();
+      finalMessages = finalMessages.sort((a, b) => {
+        const isDateField = field === "createdAt" || field === "updatedAt";
+        const aValue = isDateField ? new Date(a[field]).getTime() : a[field];
+        const bValue = isDateField ? new Date(b[field]).getTime() : b[field];
+        if (typeof aValue === "number" && typeof bValue === "number") {
+          return direction === "ASC" ? aValue - bValue : bValue - aValue;
+        }
+        return direction === "ASC" ? String(aValue).localeCompare(String(bValue)) : String(bValue).localeCompare(String(aValue));
       });
-      messages.push(...(dataResult.rows || []).map((row) => this.parseRow(row)));
-      const messagesToReturn = format === "v1" ? new MessageList().add(messages, "memory").get.all.v1() : new MessageList().add(messages, "memory").get.all.v2();
+      const returnedThreadMessageIds = new Set(finalMessages.filter((m) => m.threadId === threadId).map((m) => m.id));
+      const allThreadMessagesReturned = returnedThreadMessageIds.size >= total;
+      const hasMore = perPageInput !== false && !allThreadMessagesReturned && offset + perPage < total;
       return {
-        messages: messagesToReturn,
+        messages: finalMessages,
         total,
         page,
-        perPage,
-        hasMore: currentOffset + messages.length < total
+        perPage: perPageForResponse,
+        hasMore
       };
     } catch (error) {
       const mastraError = new MastraError(
         {
-          id: "LIBSQL_STORE_GET_MESSAGES_PAGINATED_FAILED",
+          id: "LIBSQL_STORE_LIST_MESSAGES_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { threadId }
+          details: {
+            threadId,
+            resourceId: resourceId ?? ""
+          }
         },
         error
       );
-      this.logger?.trackException?.(mastraError);
       this.logger?.error?.(mastraError.toString());
-      return { messages: [], total: 0, page, perPage, hasMore: false };
+      this.logger?.trackException?.(mastraError);
+      return {
+        messages: [],
+        total: 0,
+        page,
+        perPage: perPageForResponse,
+        hasMore: false
+      };
     }
   }
-  async saveMessages({
-    messages,
-    format
-  }) {
-    if (messages.length === 0) return messages;
+  async saveMessages({ messages }) {
+    if (messages.length === 0) return { messages };
     try {
       const threadId = messages[0]?.threadId;
       if (!threadId) {
@@ -1338,8 +1206,7 @@ var MemoryLibSQL = class extends MemoryStorage {
         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();
+      return { messages: list.get.all.db() };
     } catch (error) {
       throw new MastraError(
         {
@@ -1578,53 +1445,22 @@ var MemoryLibSQL = class extends MemoryStorage {
       );
     }
   }
-  /**
-   * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
-   */
-  async getThreadsByResourceId(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];
-      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 result = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection}`,
-        args: queryParams
-      });
-      if (!result.rows) {
-        return [];
-      }
-      return result.rows.map(mapRowToStorageThreadType);
-    } catch (error) {
-      const mastraError = new MastraError(
+  async listThreadsByResourceId(args) {
+    const { resourceId, page = 0, perPage: perPageInput, orderBy } = args;
+    if (page < 0) {
+      throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_THREADS_BY_RESOURCE_ID_FAILED",
+          id: "LIBSQL_STORE_LIST_THREADS_BY_RESOURCE_ID_INVALID_PAGE",
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { resourceId }
+          category: ErrorCategory.USER,
+          details: { page }
         },
-        error
+        new Error("page must be >= 0")
       );
-      this.logger?.trackException?.(mastraError);
-      this.logger?.error?.(mastraError.toString());
-      return [];
     }
-  }
-  async getThreadsByResourceIdPaginated(args) {
-    const { resourceId, page = 0, perPage = 100 } = args;
-    const orderBy = this.castThreadOrderBy(args.orderBy);
-    const sortDirection = this.castThreadSortDirection(args.sortDirection);
+    const perPage = normalizePerPage(perPageInput, 100);
+    const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+    const { field, direction } = this.parseOrderBy(orderBy);
     try {
       const baseQuery = `FROM ${TABLE_THREADS} WHERE resourceId = ?`;
       const queryParams = [resourceId];
@@ -1638,7 +1474,6 @@ var MemoryLibSQL = class extends MemoryStorage {
         // Convert string to Date
         metadata: typeof row.metadata === "string" ? JSON.parse(row.metadata) : row.metadata
       });
-      const currentOffset = page * perPage;
       const countResult = await this.client.execute({
         sql: `SELECT COUNT(*) as count ${baseQuery}`,
         args: queryParams
@@ -1649,26 +1484,27 @@ var MemoryLibSQL = class extends MemoryStorage {
           threads: [],
           total: 0,
           page,
-          perPage,
+          perPage: perPageForResponse,
           hasMore: false
         };
       }
+      const limitValue = perPageInput === false ? total : perPage;
       const dataResult = await this.client.execute({
-        sql: `SELECT * ${baseQuery} ORDER BY ${orderBy} ${sortDirection} LIMIT ? OFFSET ?`,
-        args: [...queryParams, perPage, currentOffset]
+        sql: `SELECT * ${baseQuery} ORDER BY "${field}" ${direction} LIMIT ? OFFSET ?`,
+        args: [...queryParams, limitValue, offset]
       });
       const threads = (dataResult.rows || []).map(mapRowToStorageThreadType);
       return {
         threads,
         total,
         page,
-        perPage,
-        hasMore: currentOffset + threads.length < total
+        perPage: perPageForResponse,
+        hasMore: perPageInput === false ? false : offset + perPage < total
       };
     } catch (error) {
       const mastraError = new MastraError(
         {
-          id: "LIBSQL_STORE_GET_THREADS_BY_RESOURCE_ID_FAILED",
+          id: "LIBSQL_STORE_LIST_THREADS_BY_RESOURCE_ID_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { resourceId }
@@ -1677,7 +1513,13 @@ var MemoryLibSQL = class extends MemoryStorage {
       );
       this.logger?.trackException?.(mastraError);
       this.logger?.error?.(mastraError.toString());
-      return { threads: [], total: 0, page, perPage, hasMore: false };
+      return {
+        threads: [],
+        total: 0,
+        page,
+        perPage: perPageForResponse,
+        hasMore: false
+      };
     }
   }
   async saveThread({ thread }) {
@@ -1948,7 +1790,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     super();
     this.operations = operations;
   }
-  async createAISpan(span) {
+  async createSpan(span) {
     try {
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const record = {
@@ -1956,11 +1798,11 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
         createdAt: now,
         updatedAt: now
       };
-      return this.operations.insert({ tableName: TABLE_AI_SPANS, record });
+      return this.operations.insert({ tableName: TABLE_SPANS, record });
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_CREATE_AI_SPAN_FAILED",
+          id: "LIBSQL_STORE_CREATE_SPAN_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: {
@@ -1974,10 +1816,10 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       );
     }
   }
-  async getAITrace(traceId) {
+  async getTrace(traceId) {
     try {
       const spans = await this.operations.loadMany({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         whereClause: { sql: " WHERE traceId = ?", args: [traceId] },
         orderBy: "startedAt DESC"
       });
@@ -1986,12 +1828,12 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       }
       return {
         traceId,
-        spans: spans.map((span) => transformFromSqlRow({ tableName: TABLE_AI_SPANS, sqlRow: span }))
+        spans: spans.map((span) => transformFromSqlRow({ tableName: TABLE_SPANS, sqlRow: span }))
       };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_AI_TRACE_FAILED",
+          id: "LIBSQL_STORE_GET_TRACE_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: {
@@ -2002,21 +1844,21 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       );
     }
   }
-  async updateAISpan({
+  async updateSpan({
     spanId,
     traceId,
     updates
   }) {
     try {
       await this.operations.update({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         keys: { spanId, traceId },
         data: { ...updates, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }
       });
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_UPDATE_AI_SPAN_FAILED",
+          id: "LIBSQL_STORE_UPDATE_SPAN_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: {
@@ -2028,7 +1870,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       );
     }
   }
-  async getAITracesPaginated({
+  async getTracesPaginated({
     filters,
     pagination
   }) {
@@ -2040,7 +1882,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       ...buildDateRangeFilter(pagination?.dateRange, "startedAt"),
       parentSpanId: null
     };
-    const whereClause = prepareWhereClause(filtersWithDateRange, AI_SPAN_SCHEMA);
+    const whereClause = prepareWhereClause(filtersWithDateRange, SPAN_SCHEMA);
     let actualWhereClause = whereClause.sql || "";
     if (entityId && entityType) {
       const statement = `name = ?`;
@@ -2051,7 +1893,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
         name = `agent run: '${entityId}'`;
       } else {
         const error = new MastraError({
-          id: "LIBSQL_STORE_GET_AI_TRACES_PAGINATED_FAILED",
+          id: "LIBSQL_STORE_GET_TRACES_PAGINATED_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: {
@@ -2073,13 +1915,13 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     let count = 0;
     try {
       count = await this.operations.loadTotalCount({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         whereClause: { sql: actualWhereClause, args: whereClause.args }
       });
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_AI_TRACES_PAGINATED_COUNT_FAILED",
+          id: "LIBSQL_STORE_GET_TRACES_PAGINATED_COUNT_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER
         },
@@ -2099,7 +1941,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     }
     try {
       const spans = await this.operations.loadMany({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         whereClause: {
           sql: actualWhereClause,
           args: whereClause.args
@@ -2115,12 +1957,12 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
           perPage,
           hasMore: spans.length === perPage
         },
-        spans: spans.map((span) => transformFromSqlRow({ tableName: TABLE_AI_SPANS, sqlRow: span }))
+        spans: spans.map((span) => transformFromSqlRow({ tableName: TABLE_SPANS, sqlRow: span }))
       };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_AI_TRACES_PAGINATED_FAILED",
+          id: "LIBSQL_STORE_GET_TRACES_PAGINATED_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER
         },
@@ -2128,11 +1970,11 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       );
     }
   }
-  async batchCreateAISpans(args) {
+  async batchCreateSpans(args) {
     try {
       const now = (/* @__PURE__ */ new Date()).toISOString();
       return this.operations.batchInsert({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         records: args.records.map((record) => ({
           ...record,
           createdAt: now,
@@ -2142,7 +1984,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_BATCH_CREATE_AI_SPANS_FAILED",
+          id: "LIBSQL_STORE_BATCH_CREATE_SPANS_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER
         },
@@ -2150,10 +1992,10 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       );
     }
   }
-  async batchUpdateAISpans(args) {
+  async batchUpdateSpans(args) {
     try {
       return this.operations.batchUpdate({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         updates: args.records.map((record) => ({
           keys: { spanId: record.spanId, traceId: record.traceId },
           data: { ...record.updates, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }
@@ -2162,7 +2004,7 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_BATCH_UPDATE_AI_SPANS_FAILED",
+          id: "LIBSQL_STORE_BATCH_UPDATE_SPANS_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER
         },
@@ -2170,17 +2012,17 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
       );
     }
   }
-  async batchDeleteAITraces(args) {
+  async batchDeleteTraces(args) {
     try {
       const keys = args.traceIds.map((traceId) => ({ traceId }));
       return this.operations.batchDelete({
-        tableName: TABLE_AI_SPANS,
+        tableName: TABLE_SPANS,
         keys
       });
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_BATCH_DELETE_AI_TRACES_FAILED",
+          id: "LIBSQL_STORE_BATCH_DELETE_TRACES_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER
         },
@@ -2236,7 +2078,7 @@ var StoreOperationsLibSQL = class extends StoreOperations {
                 )`;
       return stmnt;
     }
-    if (tableName === TABLE_AI_SPANS) {
+    if (tableName === TABLE_SPANS) {
       const stmnt = `CREATE TABLE IF NOT EXISTS ${parsedTableName} (
                     ${columns.join(",\n")},
                     PRIMARY KEY (traceId, spanId)
@@ -2584,22 +2426,44 @@ var ScoresLibSQL = class extends ScoresStorage {
     this.operations = operations;
     this.client = client;
   }
-  async getScoresByRunId({
+  async listScoresByRunId({
     runId,
     pagination
   }) {
     try {
+      const { page, perPage: perPageInput } = pagination;
+      const countResult = await this.client.execute({
+        sql: `SELECT COUNT(*) as count FROM ${TABLE_SCORERS} WHERE runId = ?`,
+        args: [runId]
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          pagination: {
+            total: 0,
+            page,
+            perPage: perPageInput,
+            hasMore: false
+          },
+          scores: []
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
       const result = await this.client.execute({
         sql: `SELECT * FROM ${TABLE_SCORERS} WHERE runId = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
-        args: [runId, pagination.perPage + 1, pagination.page * pagination.perPage]
+        args: [runId, limitValue, start]
       });
+      const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
       return {
-        scores: result.rows?.slice(0, pagination.perPage).map((row) => this.transformScoreRow(row)) ?? [],
+        scores,
         pagination: {
-          total: result.rows?.length ?? 0,
-          page: pagination.page,
-          perPage: pagination.perPage,
-          hasMore: result.rows?.length > pagination.perPage
+          total,
+          page,
+          perPage: perPageForResponse,
+          hasMore: end < total
         }
       };
     } catch (error) {
@@ -2613,7 +2477,7 @@ var ScoresLibSQL = class extends ScoresStorage {
       );
     }
   }
-  async getScoresByScorerId({
+  async listScoresByScorerId({
     scorerId,
     entityId,
     entityType,
@@ -2621,6 +2485,7 @@ var ScoresLibSQL = class extends ScoresStorage {
     pagination
   }) {
     try {
+      const { page, perPage: perPageInput } = pagination;
       const conditions = [];
       const queryParams = [];
       if (scorerId) {
@@ -2640,17 +2505,38 @@ var ScoresLibSQL = class extends ScoresStorage {
         queryParams.push(source);
       }
       const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const countResult = await this.client.execute({
+        sql: `SELECT COUNT(*) as count FROM ${TABLE_SCORERS} ${whereClause}`,
+        args: queryParams
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          pagination: {
+            total: 0,
+            page,
+            perPage: perPageInput,
+            hasMore: false
+          },
+          scores: []
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
       const result = await this.client.execute({
         sql: `SELECT * FROM ${TABLE_SCORERS} ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
-        args: [...queryParams, pagination.perPage + 1, pagination.page * pagination.perPage]
+        args: [...queryParams, limitValue, start]
       });
+      const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
       return {
-        scores: result.rows?.slice(0, pagination.perPage).map((row) => this.transformScoreRow(row)) ?? [],
+        scores,
         pagination: {
-          total: result.rows?.length ?? 0,
-          page: pagination.page,
-          perPage: pagination.perPage,
-          hasMore: result.rows?.length > pagination.perPage
+          total,
+          page,
+          perPage: perPageForResponse,
+          hasMore: end < total
         }
       };
     } catch (error) {
@@ -2669,7 +2555,7 @@ var ScoresLibSQL = class extends ScoresStorage {
     const inputValue = safelyParseJSON(row.input ?? "{}");
     const outputValue = safelyParseJSON(row.output ?? "{}");
     const additionalLLMContextValue = row.additionalLLMContext ? safelyParseJSON(row.additionalLLMContext) : null;
-    const runtimeContextValue = row.runtimeContext ? safelyParseJSON(row.runtimeContext) : null;
+    const requestContextValue = row.requestContext ? safelyParseJSON(row.requestContext) : null;
     const metadataValue = row.metadata ? safelyParseJSON(row.metadata) : null;
     const entityValue = row.entity ? safelyParseJSON(row.entity) : null;
     const preprocessStepResultValue = row.preprocessStepResult ? safelyParseJSON(row.preprocessStepResult) : null;
@@ -2692,7 +2578,7 @@ var ScoresLibSQL = class extends ScoresStorage {
       input: inputValue,
       output: outputValue,
       additionalContext: additionalLLMContextValue,
-      runtimeContext: runtimeContextValue,
+      requestContext: requestContextValue,
       entityType: row.entityType,
       entity: entityValue,
       entityId: row.entityId,
@@ -2722,7 +2608,7 @@ var ScoresLibSQL = class extends ScoresStorage {
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: {
-            scorer: score.scorer.name,
+            scorer: score.scorer.id,
             entityId: score.entityId,
             entityType: score.entityType,
             traceId: score.traceId || "",
@@ -2756,23 +2642,45 @@ var ScoresLibSQL = class extends ScoresStorage {
       );
     }
   }
-  async getScoresByEntityId({
+  async listScoresByEntityId({
     entityId,
     entityType,
     pagination
   }) {
     try {
+      const { page, perPage: perPageInput } = pagination;
+      const countResult = await this.client.execute({
+        sql: `SELECT COUNT(*) as count FROM ${TABLE_SCORERS} WHERE entityId = ? AND entityType = ?`,
+        args: [entityId, entityType]
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          pagination: {
+            total: 0,
+            page,
+            perPage: perPageInput,
+            hasMore: false
+          },
+          scores: []
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
       const result = await this.client.execute({
         sql: `SELECT * FROM ${TABLE_SCORERS} WHERE entityId = ? AND entityType = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
-        args: [entityId, entityType, pagination.perPage + 1, pagination.page * pagination.perPage]
+        args: [entityId, entityType, limitValue, start]
       });
+      const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
       return {
-        scores: result.rows?.slice(0, pagination.perPage).map((row) => this.transformScoreRow(row)) ?? [],
+        scores,
         pagination: {
-          total: result.rows?.length ?? 0,
-          page: pagination.page,
-          perPage: pagination.perPage,
-          hasMore: result.rows?.length > pagination.perPage
+          total,
+          page,
+          perPage: perPageForResponse,
+          hasMore: end < total
         }
       };
     } catch (error) {
@@ -2786,30 +2694,34 @@ var ScoresLibSQL = class extends ScoresStorage {
       );
     }
   }
-  async getScoresBySpan({
+  async listScoresBySpan({
     traceId,
     spanId,
     pagination
   }) {
     try {
+      const { page, perPage: perPageInput } = pagination;
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
       const countSQLResult = await this.client.execute({
         sql: `SELECT COUNT(*) as count FROM ${TABLE_SCORERS} WHERE traceId = ? AND spanId = ?`,
         args: [traceId, spanId]
       });
       const total = Number(countSQLResult.rows?.[0]?.count ?? 0);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
       const result = await this.client.execute({
         sql: `SELECT * FROM ${TABLE_SCORERS} WHERE traceId = ? AND spanId = ? ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
-        args: [traceId, spanId, pagination.perPage + 1, pagination.page * pagination.perPage]
+        args: [traceId, spanId, limitValue, start]
       });
-      const hasMore = result.rows?.length > pagination.perPage;
-      const scores = result.rows?.slice(0, pagination.perPage).map((row) => this.transformScoreRow(row)) ?? [];
+      const scores = result.rows?.map((row) => this.transformScoreRow(row)) ?? [];
       return {
         scores,
         pagination: {
           total,
-          page: pagination.page,
-          perPage: pagination.perPage,
-          hasMore
+          page,
+          perPage: perPageForResponse,
+          hasMore: end < total
         }
       };
     } catch (error) {
@@ -2824,134 +2736,6 @@ var ScoresLibSQL = class extends ScoresStorage {
     }
   }
 };
-var TracesLibSQL = class extends TracesStorage {
-  client;
-  operations;
-  constructor({ client, operations }) {
-    super();
-    this.client = client;
-    this.operations = operations;
-  }
-  async getTraces(args) {
-    if (args.fromDate || args.toDate) {
-      args.dateRange = {
-        start: args.fromDate,
-        end: args.toDate
-      };
-    }
-    try {
-      const result = await this.getTracesPaginated(args);
-      return result.traces;
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: "LIBSQL_STORE_GET_TRACES_FAILED",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
-        },
-        error
-      );
-    }
-  }
-  async getTracesPaginated(args) {
-    const { name, scope, page = 0, perPage = 100, attributes, filters, dateRange } = args;
-    const fromDate = dateRange?.start;
-    const toDate = dateRange?.end;
-    const currentOffset = page * perPage;
-    const queryArgs = [];
-    const conditions = [];
-    if (name) {
-      conditions.push("name LIKE ?");
-      queryArgs.push(`${name}%`);
-    }
-    if (scope) {
-      conditions.push("scope = ?");
-      queryArgs.push(scope);
-    }
-    if (attributes) {
-      Object.entries(attributes).forEach(([key, value]) => {
-        conditions.push(`json_extract(attributes, '$.${key}') = ?`);
-        queryArgs.push(value);
-      });
-    }
-    if (filters) {
-      Object.entries(filters).forEach(([key, value]) => {
-        conditions.push(`${parseSqlIdentifier(key, "filter key")} = ?`);
-        queryArgs.push(value);
-      });
-    }
-    if (fromDate) {
-      conditions.push("createdAt >= ?");
-      queryArgs.push(fromDate.toISOString());
-    }
-    if (toDate) {
-      conditions.push("createdAt <= ?");
-      queryArgs.push(toDate.toISOString());
-    }
-    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    try {
-      const countResult = await this.client.execute({
-        sql: `SELECT COUNT(*) as count FROM ${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 ${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
-      };
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: "LIBSQL_STORE_GET_TRACES_PAGINATED_FAILED",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
-        },
-        error
-      );
-    }
-  }
-  async batchTraceInsert({ records }) {
-    this.logger.debug("Batch inserting traces", { count: records.length });
-    await this.operations.batchInsert({
-      tableName: TABLE_TRACES,
-      records
-    });
-  }
-};
 function parseWorkflowRun(row) {
   let parsedSnapshot = row.snapshot;
   if (typeof parsedSnapshot === "string") {
@@ -3053,7 +2837,7 @@ var WorkflowsLibSQL = class extends WorkflowsStorage {
     runId,
     stepId,
     result,
-    runtimeContext
+    requestContext
   }) {
     return this.executeWithRetry(async () => {
       const tx = await this.client.transaction("write");
@@ -3075,14 +2859,14 @@ var WorkflowsLibSQL = class extends WorkflowsStorage {
             waitingPaths: {},
             status: "pending",
             runId,
-            runtimeContext: {}
+            requestContext: {}
           };
         } else {
           const existingSnapshot = existingSnapshotResult.rows[0].snapshot;
           snapshot = typeof existingSnapshot === "string" ? JSON.parse(existingSnapshot) : existingSnapshot;
         }
         snapshot.context[stepId] = result;
-        snapshot.runtimeContext = { ...snapshot.runtimeContext, ...runtimeContext };
+        snapshot.requestContext = { ...snapshot.requestContext, ...requestContext };
         await tx.execute({
           sql: `UPDATE ${TABLE_WORKFLOW_SNAPSHOT} SET snapshot = ? WHERE workflow_name = ? AND run_id = ?`,
           args: [JSON.stringify(snapshot), workflowName, runId]
@@ -3200,12 +2984,12 @@ var WorkflowsLibSQL = class extends WorkflowsStorage {
       );
     }
   }
-  async getWorkflowRuns({
+  async listWorkflowRuns({
     workflowName,
     fromDate,
     toDate,
-    limit,
-    offset,
+    page,
+    perPage,
     resourceId
   } = {}) {
     try {
@@ -3234,23 +3018,26 @@ var WorkflowsLibSQL = class extends WorkflowsStorage {
       }
       const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
       let total = 0;
-      if (limit !== void 0 && offset !== void 0) {
+      const usePagination = typeof perPage === "number" && typeof page === "number";
+      if (usePagination) {
         const countResult = await this.client.execute({
           sql: `SELECT COUNT(*) as count FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause}`,
           args
         });
         total = Number(countResult.rows?.[0]?.count ?? 0);
       }
+      const normalizedPerPage = usePagination ? normalizePerPage(perPage, Number.MAX_SAFE_INTEGER) : 0;
+      const offset = usePagination ? page * normalizedPerPage : 0;
       const result = await this.client.execute({
-        sql: `SELECT * FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC${limit !== void 0 && offset !== void 0 ? ` LIMIT ? OFFSET ?` : ""}`,
-        args: limit !== void 0 && offset !== void 0 ? [...args, limit, offset] : args
+        sql: `SELECT * FROM ${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));
       return { runs, total: total || runs.length };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LIBSQL_STORE_GET_WORKFLOW_RUNS_FAILED",
+          id: "LIBSQL_STORE_LIST_WORKFLOW_RUNS_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -3267,7 +3054,10 @@ var LibSQLStore = class extends MastraStorage {
   initialBackoffMs;
   stores;
   constructor(config) {
-    super({ name: `LibSQLStore` });
+    if (!config.id || typeof config.id !== "string" || config.id.trim() === "") {
+      throw new Error("LibSQLStore: id must be provided and cannot be empty.");
+    }
+    super({ id: config.id, name: `LibSQLStore` });
     this.maxRetries = config.maxRetries ?? 5;
     this.initialBackoffMs = config.initialBackoffMs ?? 100;
     if ("url" in config) {
@@ -3291,18 +3081,14 @@ var LibSQLStore = class extends MastraStorage {
       initialBackoffMs: this.initialBackoffMs
     });
     const scores = new ScoresLibSQL({ client: this.client, operations });
-    const traces = new TracesLibSQL({ client: this.client, operations });
     const workflows = new WorkflowsLibSQL({ client: this.client, operations });
     const memory = new MemoryLibSQL({ client: this.client, operations });
-    const legacyEvals = new LegacyEvalsLibSQL({ client: this.client });
     const observability = new ObservabilityLibSQL({ operations });
     this.stores = {
       operations,
       scores,
-      traces,
       workflows,
       memory,
-      legacyEvals,
       observability
     };
   }
@@ -3313,8 +3099,8 @@ var LibSQLStore = class extends MastraStorage {
       hasColumn: true,
       createTable: true,
       deleteMessages: true,
-      aiTracing: true,
-      getScoresBySpan: true
+      observabilityInstance: true,
+      listScoresBySpan: true
     };
   }
   async createTable({
@@ -3354,15 +3140,6 @@ var LibSQLStore = class extends MastraStorage {
   async getThreadById({ threadId }) {
     return this.stores.memory.getThreadById({ threadId });
   }
-  /**
-   * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
-   */
-  async getThreadsByResourceId(args) {
-    return this.stores.memory.getThreadsByResourceId(args);
-  }
-  async getThreadsByResourceIdPaginated(args) {
-    return this.stores.memory.getThreadsByResourceIdPaginated(args);
-  }
   async saveThread({ thread }) {
     return this.stores.memory.saveThread({ thread });
   }
@@ -3376,24 +3153,12 @@ var LibSQLStore = class extends MastraStorage {
   async deleteThread({ threadId }) {
     return this.stores.memory.deleteThread({ threadId });
   }
-  async getMessages({
-    threadId,
-    selectBy,
-    format
-  }) {
-    return this.stores.memory.getMessages({ threadId, selectBy, format });
-  }
-  async getMessagesById({
-    messageIds,
-    format
-  }) {
-    return this.stores.memory.getMessagesById({ messageIds, format });
-  }
-  async getMessagesPaginated(args) {
-    return this.stores.memory.getMessagesPaginated(args);
+  async listMessagesById({ messageIds }) {
+    return this.stores.memory.listMessagesById({ messageIds });
   }
   async saveMessages(args) {
-    return this.stores.memory.saveMessages(args);
+    const result = await this.stores.memory.saveMessages({ messages: args.messages });
+    return { messages: result.messages };
   }
   async updateMessages({
     messages
@@ -3403,55 +3168,33 @@ var LibSQLStore = class extends MastraStorage {
   async deleteMessages(messageIds) {
     return this.stores.memory.deleteMessages(messageIds);
   }
-  /** @deprecated use getEvals instead */
-  async getEvalsByAgentName(agentName, type) {
-    return this.stores.legacyEvals.getEvalsByAgentName(agentName, type);
-  }
-  async getEvals(options = {}) {
-    return this.stores.legacyEvals.getEvals(options);
-  }
   async getScoreById({ id }) {
     return this.stores.scores.getScoreById({ id });
   }
   async saveScore(score) {
     return this.stores.scores.saveScore(score);
   }
-  async getScoresByScorerId({
+  async listScoresByScorerId({
     scorerId,
     entityId,
     entityType,
     source,
     pagination
   }) {
-    return this.stores.scores.getScoresByScorerId({ scorerId, entityId, entityType, source, pagination });
+    return this.stores.scores.listScoresByScorerId({ scorerId, entityId, entityType, source, pagination });
   }
-  async getScoresByRunId({
+  async listScoresByRunId({
     runId,
     pagination
   }) {
-    return this.stores.scores.getScoresByRunId({ runId, pagination });
+    return this.stores.scores.listScoresByRunId({ runId, pagination });
   }
-  async getScoresByEntityId({
+  async listScoresByEntityId({
     entityId,
     entityType,
     pagination
   }) {
-    return this.stores.scores.getScoresByEntityId({ entityId, entityType, pagination });
-  }
-  /**
-   * TRACES
-   */
-  /**
-   * @deprecated use getTracesPaginated instead.
-   */
-  async getTraces(args) {
-    return this.stores.traces.getTraces(args);
-  }
-  async getTracesPaginated(args) {
-    return this.stores.traces.getTracesPaginated(args);
-  }
-  async batchTraceInsert(args) {
-    return this.stores.traces.batchTraceInsert(args);
+    return this.stores.scores.listScoresByEntityId({ entityId, entityType, pagination });
   }
   /**
    * WORKFLOWS
@@ -3461,9 +3204,9 @@ var LibSQLStore = class extends MastraStorage {
     runId,
     stepId,
     result,
-    runtimeContext
+    requestContext
   }) {
-    return this.stores.workflows.updateWorkflowResults({ workflowName, runId, stepId, result, runtimeContext });
+    return this.stores.workflows.updateWorkflowResults({ workflowName, runId, stepId, result, requestContext });
   }
   async updateWorkflowState({
     workflowName,
@@ -3486,15 +3229,15 @@ var LibSQLStore = class extends MastraStorage {
   }) {
     return this.stores.workflows.loadWorkflowSnapshot({ workflowName, runId });
   }
-  async getWorkflowRuns({
+  async listWorkflowRuns({
     workflowName,
     fromDate,
     toDate,
-    limit,
-    offset,
+    perPage,
+    page,
     resourceId
   } = {}) {
-    return this.stores.workflows.getWorkflowRuns({ workflowName, fromDate, toDate, limit, offset, resourceId });
+    return this.stores.workflows.listWorkflowRuns({ workflowName, fromDate, toDate, perPage, page, resourceId });
   }
   async getWorkflowRunById({
     runId,
@@ -3515,30 +3258,30 @@ var LibSQLStore = class extends MastraStorage {
   }) {
     return this.stores.memory.updateResource({ resourceId, workingMemory, metadata });
   }
-  async createAISpan(span) {
-    return this.stores.observability.createAISpan(span);
+  async createSpan(span) {
+    return this.stores.observability.createSpan(span);
   }
-  async updateAISpan(params) {
-    return this.stores.observability.updateAISpan(params);
+  async updateSpan(params) {
+    return this.stores.observability.updateSpan(params);
   }
-  async getAITrace(traceId) {
-    return this.stores.observability.getAITrace(traceId);
+  async getTrace(traceId) {
+    return this.stores.observability.getTrace(traceId);
   }
-  async getAITracesPaginated(args) {
-    return this.stores.observability.getAITracesPaginated(args);
+  async getTracesPaginated(args) {
+    return this.stores.observability.getTracesPaginated(args);
   }
-  async getScoresBySpan({
+  async listScoresBySpan({
     traceId,
     spanId,
     pagination
   }) {
-    return this.stores.scores.getScoresBySpan({ traceId, spanId, pagination });
+    return this.stores.scores.listScoresBySpan({ traceId, spanId, pagination });
   }
-  async batchCreateAISpans(args) {
-    return this.stores.observability.batchCreateAISpans(args);
+  async batchCreateSpans(args) {
+    return this.stores.observability.batchCreateSpans(args);
   }
-  async batchUpdateAISpans(args) {
-    return this.stores.observability.batchUpdateAISpans(args);
+  async batchUpdateSpans(args) {
+    return this.stores.observability.batchUpdateSpans(args);
   }
 };