@mastra/lance 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/index.js

@@ -1,7 +1,8 @@
 import { connect, Index } from '@lancedb/lancedb';
 import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
-import { MastraStorage, StoreOperations, MemoryStorage, TABLE_THREADS, TABLE_MESSAGES, normalizePerPage, calculatePagination, TABLE_RESOURCES, ScoresStorage, TABLE_SCORERS, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, ensureDate } from '@mastra/core/storage';
+import { MemoryStorage, TABLE_SCHEMAS, TABLE_THREADS, TABLE_MESSAGES, TABLE_RESOURCES, createStorageErrorId, normalizePerPage, calculatePagination, ScoresStorage, SCORERS_SCHEMA, TABLE_SCORERS, WorkflowsStorage, ensureDate, TABLE_WORKFLOW_SNAPSHOT, MastraStorage, createVectorErrorId, getDefaultValue } from '@mastra/core/storage';
 import { MessageList } from '@mastra/core/agent';
+import { MastraBase } from '@mastra/core/base';
 import { Utf8, Float64, Binary, Float32, Int32, Field, Schema } from 'apache-arrow';
 import { saveScorePayloadSchema } from '@mastra/core/evals';
 import { MastraVector } from '@mastra/core/vector';
@@ -89,7 +90,7 @@ async function getTableSchema({
   } catch (validationError) {
     throw new MastraError(
       {
-        id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_INVALID_ARGS",
+        id: createStorageErrorId("LANCE", "GET_TABLE_SCHEMA", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: validationError.message,
@@ -112,7 +113,7 @@ async function getTableSchema({
   } catch (error) {
     throw new MastraError(
       {
-        id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_FAILED",
+        id: createStorageErrorId("LANCE", "GET_TABLE_SCHEMA", "FAILED"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.THIRD_PARTY,
         details: { tableName }
@@ -122,1118 +123,1200 @@ async function getTableSchema({
   }
 }
 
-// src/storage/domains/memory/index.ts
-var StoreMemoryLance = class extends MemoryStorage {
+// src/storage/db/index.ts
+function resolveLanceConfig(config) {
+  return config.client;
+}
+var LanceDB = class extends MastraBase {
   client;
-  operations;
-  constructor({ client, operations }) {
-    super();
+  constructor({ client }) {
+    super({ name: "lance-db" });
     this.client = client;
-    this.operations = operations;
   }
-  // Utility to escape single quotes in SQL strings
-  escapeSql(str) {
-    return str.replace(/'/g, "''");
+  getDefaultValue(type) {
+    switch (type) {
+      case "text":
+        return "''";
+      case "timestamp":
+        return "CURRENT_TIMESTAMP";
+      case "integer":
+      case "bigint":
+        return "0";
+      case "jsonb":
+        return "'{}'";
+      case "uuid":
+        return "''";
+      default:
+        return getDefaultValue(type);
+    }
   }
-  async getThreadById({ threadId }) {
+  async hasColumn(tableName, columnName) {
+    const table = await this.client.openTable(tableName);
+    const schema = await table.schema();
+    return schema.fields.some((field) => field.name === columnName);
+  }
+  translateSchema(schema) {
+    const fields = Object.entries(schema).map(([name, column]) => {
+      let arrowType;
+      switch (column.type.toLowerCase()) {
+        case "text":
+        case "uuid":
+          arrowType = new Utf8();
+          break;
+        case "int":
+        case "integer":
+          arrowType = new Int32();
+          break;
+        case "bigint":
+          arrowType = new Float64();
+          break;
+        case "float":
+          arrowType = new Float32();
+          break;
+        case "jsonb":
+        case "json":
+          arrowType = new Utf8();
+          break;
+        case "binary":
+          arrowType = new Binary();
+          break;
+        case "timestamp":
+          arrowType = new Float64();
+          break;
+        default:
+          arrowType = new Utf8();
+      }
+      return new Field(name, arrowType, column.nullable ?? true);
+    });
+    return new Schema(fields);
+  }
+  async createTable({
+    tableName,
+    schema
+  }) {
     try {
-      const thread = await this.operations.load({ tableName: TABLE_THREADS, keys: { id: threadId } });
-      if (!thread) {
-        return null;
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      }
+      if (!tableName) {
+        throw new Error("tableName is required for createTable.");
+      }
+      if (!schema) {
+        throw new Error("schema is required for createTable.");
       }
-      return {
-        ...thread,
-        createdAt: new Date(thread.createdAt),
-        updatedAt: new Date(thread.updatedAt)
-      };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_GET_THREAD_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "CREATE_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.USER,
+          details: { tableName }
         },
         error
       );
     }
-  }
-  /**
-   * Saves a thread to the database. This function doesn't overwrite existing threads.
-   * @param thread - The thread to save
-   * @returns The saved thread
-   */
-  async saveThread({ thread }) {
     try {
-      const record = { ...thread, metadata: JSON.stringify(thread.metadata) };
-      const table = await this.client.openTable(TABLE_THREADS);
-      await table.add([record], { mode: "append" });
-      return thread;
+      const arrowSchema = this.translateSchema(schema);
+      await this.client.createEmptyTable(tableName, arrowSchema);
     } catch (error) {
+      if (error.message?.includes("already exists")) {
+        this.logger.debug(`Table '${tableName}' already exists, skipping create`);
+        return;
+      }
       throw new MastraError(
         {
-          id: "LANCE_STORE_SAVE_THREAD_FAILED",
+          id: createStorageErrorId("LANCE", "CREATE_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
         },
         error
       );
     }
   }
-  async updateThread({
-    id,
-    title,
-    metadata
-  }) {
-    const maxRetries = 5;
-    for (let attempt = 0; attempt < maxRetries; attempt++) {
-      try {
-        const current = await this.getThreadById({ threadId: id });
-        if (!current) {
-          throw new Error(`Thread with id ${id} not found`);
-        }
-        const mergedMetadata = { ...current.metadata, ...metadata };
-        const record = {
-          id,
-          title,
-          metadata: JSON.stringify(mergedMetadata),
-          updatedAt: (/* @__PURE__ */ new Date()).getTime()
-        };
-        const table = await this.client.openTable(TABLE_THREADS);
-        await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([record]);
-        const updatedThread = await this.getThreadById({ threadId: id });
-        if (!updatedThread) {
-          throw new Error(`Failed to retrieve updated thread ${id}`);
-        }
-        return updatedThread;
-      } catch (error) {
-        if (error.message?.includes("Commit conflict") && attempt < maxRetries - 1) {
-          const delay = Math.pow(2, attempt) * 10;
-          await new Promise((resolve) => setTimeout(resolve, delay));
-          continue;
-        }
-        throw new MastraError(
-          {
-            id: "LANCE_STORE_UPDATE_THREAD_FAILED",
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.THIRD_PARTY
-          },
-          error
-        );
-      }
-    }
-    throw new MastraError(
-      {
-        id: "LANCE_STORE_UPDATE_THREAD_FAILED",
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.THIRD_PARTY
-      },
-      new Error("All retries exhausted")
-    );
-  }
-  async deleteThread({ threadId }) {
+  async dropTable({ tableName }) {
     try {
-      const table = await this.client.openTable(TABLE_THREADS);
-      await table.delete(`id = '${threadId}'`);
-      const messagesTable = await this.client.openTable(TABLE_MESSAGES);
-      await messagesTable.delete(`thread_id = '${threadId}'`);
-    } catch (error) {
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      }
+      if (!tableName) {
+        throw new Error("tableName is required for dropTable.");
+      }
+    } catch (validationError) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_DELETE_THREAD_FAILED",
+          id: createStorageErrorId("LANCE", "DROP_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
         },
-        error
+        validationError
       );
     }
-  }
-  normalizeMessage(message) {
-    const { thread_id, ...rest } = message;
-    return {
-      ...rest,
-      threadId: thread_id,
-      content: typeof message.content === "string" ? (() => {
-        try {
-          return JSON.parse(message.content);
-        } catch {
-          return message.content;
-        }
-      })() : message.content
-    };
-  }
-  async listMessagesById({ messageIds }) {
-    if (messageIds.length === 0) return { messages: [] };
     try {
-      const table = await this.client.openTable(TABLE_MESSAGES);
-      const quotedIds = messageIds.map((id) => `'${id}'`).join(", ");
-      const allRecords = await table.query().where(`id IN (${quotedIds})`).toArray();
-      const messages = processResultWithTypeConversion(
-        allRecords,
-        await getTableSchema({ tableName: TABLE_MESSAGES, client: this.client })
-      );
-      const list = new MessageList().add(
-        messages.map(this.normalizeMessage),
-        "memory"
-      );
-      return { messages: list.get.all.db() };
+      await this.client.dropTable(tableName);
     } catch (error) {
+      if (error.toString().includes("was not found") || error.message?.includes("Table not found")) {
+        this.logger.debug(`Table '${tableName}' does not exist, skipping drop`);
+        return;
+      }
       throw new MastraError(
         {
-          id: "LANCE_STORE_LIST_MESSAGES_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "DROP_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: {
-            messageIds: JSON.stringify(messageIds)
-          }
+          details: { tableName }
         },
         error
       );
     }
   }
-  async listMessages(args) {
-    const { threadId, resourceId, include, filter, perPage: perPageInput, page = 0, orderBy } = args;
-    if (!threadId.trim()) {
+  async alterTable({
+    tableName,
+    schema,
+    ifNotExists
+  }) {
+    try {
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      }
+      if (!tableName) {
+        throw new Error("tableName is required for alterTable.");
+      }
+      if (!schema) {
+        throw new Error("schema is required for alterTable.");
+      }
+      if (!ifNotExists || ifNotExists.length === 0) {
+        this.logger.debug("No columns specified to add in alterTable, skipping.");
+        return;
+      }
+    } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_LIST_MESSAGES_INVALID_THREAD_ID",
+          id: createStorageErrorId("LANCE", "ALTER_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { threadId }
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
         },
-        new Error("threadId must be a non-empty string")
+        validationError
       );
     }
-    const perPage = normalizePerPage(perPageInput, 40);
-    const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
     try {
-      if (page < 0) {
-        throw new MastraError(
-          {
-            id: "STORAGE_LANCE_LIST_MESSAGES_INVALID_PAGE",
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.USER,
-            details: { page }
-          },
-          new Error("page must be >= 0")
-        );
-      }
-      const { field, direction } = this.parseOrderBy(orderBy, "ASC");
-      const table = await this.client.openTable(TABLE_MESSAGES);
-      const conditions = [`thread_id = '${this.escapeSql(threadId)}'`];
-      if (resourceId) {
-        conditions.push(`\`resourceId\` = '${this.escapeSql(resourceId)}'`);
-      }
-      if (filter?.dateRange?.start) {
-        const startTime = filter.dateRange.start instanceof Date ? filter.dateRange.start.getTime() : new Date(filter.dateRange.start).getTime();
-        conditions.push(`\`createdAt\` >= ${startTime}`);
-      }
-      if (filter?.dateRange?.end) {
-        const endTime = filter.dateRange.end instanceof Date ? filter.dateRange.end.getTime() : new Date(filter.dateRange.end).getTime();
-        conditions.push(`\`createdAt\` <= ${endTime}`);
-      }
-      const whereClause = conditions.join(" AND ");
-      const total = await table.countRows(whereClause);
-      const query = table.query().where(whereClause);
-      let allRecords = await query.toArray();
-      allRecords.sort((a, b) => {
-        const aValue = field === "createdAt" ? a.createdAt : a[field];
-        const bValue = field === "createdAt" ? b.createdAt : b[field];
-        if (aValue == null && bValue == null) return 0;
-        if (aValue == null) return direction === "ASC" ? -1 : 1;
-        if (bValue == null) return direction === "ASC" ? 1 : -1;
-        if (typeof aValue === "string" && typeof bValue === "string") {
-          return direction === "ASC" ? aValue.localeCompare(bValue) : bValue.localeCompare(aValue);
-        }
-        return direction === "ASC" ? aValue - bValue : bValue - aValue;
-      });
-      const paginatedRecords = allRecords.slice(offset, offset + perPage);
-      const messages = paginatedRecords.map((row) => this.normalizeMessage(row));
-      if (total === 0 && messages.length === 0 && (!include || include.length === 0)) {
+      const table = await this.client.openTable(tableName);
+      const currentSchema = await table.schema();
+      const existingFields = new Set(currentSchema.fields.map((f) => f.name));
+      const typeMap = {
+        text: "string",
+        integer: "int",
+        bigint: "bigint",
+        timestamp: "timestamp",
+        jsonb: "string",
+        uuid: "string"
+      };
+      const columnsToAdd = ifNotExists.filter((col) => schema[col] && !existingFields.has(col)).map((col) => {
+        const colDef = schema[col];
         return {
-          messages: [],
-          total: 0,
-          page,
-          perPage: perPageForResponse,
-          hasMore: false
+          name: col,
+          valueSql: colDef?.nullable ? `cast(NULL as ${typeMap[colDef.type ?? "text"]})` : `cast(${this.getDefaultValue(colDef?.type ?? "text")} as ${typeMap[colDef?.type ?? "text"]})`
         };
-      }
-      const messageIds = new Set(messages.map((m) => m.id));
-      if (include && include.length > 0) {
-        const threadIds = [...new Set(include.map((item) => item.threadId || threadId))];
-        const allThreadMessages = [];
-        for (const tid of threadIds) {
-          const threadQuery = table.query().where(`thread_id = '${tid}'`);
-          let threadRecords = await threadQuery.toArray();
-          allThreadMessages.push(...threadRecords);
-        }
-        allThreadMessages.sort((a, b) => a.createdAt - b.createdAt);
-        const contextMessages = this.processMessagesWithContext(allThreadMessages, include);
-        const includedMessages = contextMessages.map((row) => this.normalizeMessage(row));
-        for (const includeMsg of includedMessages) {
-          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 aValue = field === "createdAt" ? new Date(a.createdAt).getTime() : a[field];
-        const bValue = field === "createdAt" ? new Date(b.createdAt).getTime() : b[field];
-        if (aValue == null && bValue == null) return 0;
-        if (aValue == null) return direction === "ASC" ? -1 : 1;
-        if (bValue == null) return direction === "ASC" ? 1 : -1;
-        if (typeof aValue === "string" && typeof bValue === "string") {
-          return direction === "ASC" ? aValue.localeCompare(bValue) : bValue.localeCompare(aValue);
-        }
-        return direction === "ASC" ? aValue - bValue : bValue - aValue;
       });
-      const returnedThreadMessageIds = new Set(finalMessages.filter((m) => m.threadId === threadId).map((m) => m.id));
-      const allThreadMessagesReturned = returnedThreadMessageIds.size >= total;
-      const fetchedAll = perPageInput === false || allThreadMessagesReturned;
-      const hasMore = !fetchedAll && offset + perPage < total;
-      return {
-        messages: finalMessages,
-        total,
-        page,
-        perPage: perPageForResponse,
-        hasMore
-      };
+      if (columnsToAdd.length > 0) {
+        await table.addColumns(columnsToAdd);
+        this.logger?.info?.(`Added columns [${columnsToAdd.map((c) => c.name).join(", ")}] to table ${tableName}`);
+      }
     } catch (error) {
-      const mastraError = new MastraError(
+      throw new MastraError(
         {
-          id: "LANCE_STORE_LIST_MESSAGES_FAILED",
+          id: createStorageErrorId("LANCE", "ALTER_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: {
-            threadId,
-            resourceId: resourceId ?? ""
-          }
+          details: { tableName }
         },
         error
       );
-      this.logger?.error?.(mastraError.toString());
-      this.logger?.trackException?.(mastraError);
-      return {
-        messages: [],
-        total: 0,
-        page,
-        perPage: perPageForResponse,
-        hasMore: false
-      };
     }
   }
-  async saveMessages(args) {
+  async clearTable({ tableName }) {
     try {
-      const { messages } = args;
-      if (messages.length === 0) {
-        return { messages: [] };
-      }
-      const threadId = messages[0]?.threadId;
-      if (!threadId) {
-        throw new Error("Thread ID is required");
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
       }
-      for (const message of messages) {
-        if (!message.id) {
-          throw new Error("Message ID is required");
-        }
-        if (!message.threadId) {
-          throw new Error("Thread ID is required for all messages");
-        }
-        if (message.resourceId === null || message.resourceId === void 0) {
-          throw new Error("Resource ID cannot be null or undefined");
-        }
-        if (!message.content) {
-          throw new Error("Message content is required");
-        }
+      if (!tableName) {
+        throw new Error("tableName is required for clearTable.");
       }
-      const transformedMessages = messages.map((message) => {
-        const { threadId: threadId2, type, ...rest } = message;
-        return {
-          ...rest,
-          thread_id: threadId2,
-          type: type ?? "v2",
-          content: JSON.stringify(message.content)
-        };
-      });
-      const table = await this.client.openTable(TABLE_MESSAGES);
-      await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(transformedMessages);
-      const threadsTable = await this.client.openTable(TABLE_THREADS);
-      const currentTime = (/* @__PURE__ */ new Date()).getTime();
-      const updateRecord = { id: threadId, updatedAt: currentTime };
-      await threadsTable.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([updateRecord]);
-      const list = new MessageList().add(messages, "memory");
-      return { messages: list.get.all.db() };
+    } catch (validationError) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "CLEAR_TABLE", "INVALID_ARGS"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
+    try {
+      const table = await this.client.openTable(tableName);
+      await table.delete("1=1");
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_SAVE_MESSAGES_FAILED",
+          id: createStorageErrorId("LANCE", "CLEAR_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
         },
         error
       );
     }
   }
-  async listThreadsByResourceId(args) {
+  async insert({ tableName, record }) {
     try {
-      const { resourceId, page = 0, perPage: perPageInput, orderBy } = args;
-      const perPage = normalizePerPage(perPageInput, 100);
-      if (page < 0) {
-        throw new MastraError(
-          {
-            id: "STORAGE_LANCE_LIST_THREADS_BY_RESOURCE_ID_INVALID_PAGE",
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.USER,
-            details: { page }
-          },
-          new Error("page must be >= 0")
-        );
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
       }
-      const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
-      const { field, direction } = this.parseOrderBy(orderBy);
-      const table = await this.client.openTable(TABLE_THREADS);
-      const total = await table.countRows(`\`resourceId\` = '${this.escapeSql(resourceId)}'`);
-      const query = table.query().where(`\`resourceId\` = '${this.escapeSql(resourceId)}'`);
-      const records = await query.toArray();
-      records.sort((a, b) => {
-        const aValue = ["createdAt", "updatedAt"].includes(field) ? new Date(a[field]).getTime() : a[field];
-        const bValue = ["createdAt", "updatedAt"].includes(field) ? new Date(b[field]).getTime() : b[field];
-        if (aValue == null && bValue == null) return 0;
-        if (aValue == null) return direction === "ASC" ? -1 : 1;
-        if (bValue == null) return direction === "ASC" ? 1 : -1;
-        if (typeof aValue === "string" && typeof bValue === "string") {
-          return direction === "ASC" ? aValue.localeCompare(bValue) : bValue.localeCompare(aValue);
-        }
-        return direction === "ASC" ? aValue - bValue : bValue - aValue;
-      });
-      const paginatedRecords = records.slice(offset, offset + perPage);
-      const schema = await getTableSchema({ tableName: TABLE_THREADS, client: this.client });
-      const threads = paginatedRecords.map(
-        (record) => processResultWithTypeConversion(record, schema)
+      if (!tableName) {
+        throw new Error("tableName is required for insert.");
+      }
+      if (!record || Object.keys(record).length === 0) {
+        throw new Error("record is required and cannot be empty for insert.");
+      }
+    } catch (validationError) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "INSERT", "INVALID_ARGS"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
       );
-      return {
-        threads,
-        total,
-        page,
-        perPage: perPageForResponse,
-        hasMore: offset + perPage < total
-      };
+    }
+    try {
+      const table = await this.client.openTable(tableName);
+      const primaryId = getPrimaryKeys(tableName);
+      const processedRecord = { ...record };
+      for (const key in processedRecord) {
+        if (processedRecord[key] !== null && typeof processedRecord[key] === "object" && !(processedRecord[key] instanceof Date)) {
+          this.logger.debug("Converting object to JSON string: ", processedRecord[key]);
+          processedRecord[key] = JSON.stringify(processedRecord[key]);
+        }
+      }
+      await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([processedRecord]);
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_LIST_THREADS_BY_RESOURCE_ID_FAILED",
+          id: createStorageErrorId("LANCE", "INSERT", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
         },
         error
       );
     }
   }
-  /**
-   * Processes messages to include context messages based on withPreviousMessages and withNextMessages
-   * @param records - The sorted array of records to process
-   * @param include - The array of include specifications with context parameters
-   * @returns The processed array with context messages included
-   */
-  processMessagesWithContext(records, include) {
-    const messagesWithContext = include.filter((item) => item.withPreviousMessages || item.withNextMessages);
-    if (messagesWithContext.length === 0) {
-      return records;
-    }
-    const messageIndexMap = /* @__PURE__ */ new Map();
-    records.forEach((message, index) => {
-      messageIndexMap.set(message.id, index);
-    });
-    const additionalIndices = /* @__PURE__ */ new Set();
-    for (const item of messagesWithContext) {
-      const messageIndex = messageIndexMap.get(item.id);
-      if (messageIndex !== void 0) {
-        if (item.withPreviousMessages) {
-          const startIdx = Math.max(0, messageIndex - item.withPreviousMessages);
-          for (let i = startIdx; i < messageIndex; i++) {
-            additionalIndices.add(i);
-          }
-        }
-        if (item.withNextMessages) {
-          const endIdx = Math.min(records.length - 1, messageIndex + item.withNextMessages);
-          for (let i = messageIndex + 1; i <= endIdx; i++) {
-            additionalIndices.add(i);
-          }
-        }
+  async batchInsert({ tableName, records }) {
+    try {
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
       }
-    }
-    if (additionalIndices.size === 0) {
-      return records;
-    }
-    const originalMatchIds = new Set(include.map((item) => item.id));
-    const allIndices = /* @__PURE__ */ new Set();
-    records.forEach((record, index) => {
-      if (originalMatchIds.has(record.id)) {
-        allIndices.add(index);
+      if (!tableName) {
+        throw new Error("tableName is required for batchInsert.");
       }
-    });
-    additionalIndices.forEach((index) => {
-      allIndices.add(index);
-    });
-    return Array.from(allIndices).sort((a, b) => a - b).map((index) => records[index]);
-  }
-  /**
-   * Parse message data from LanceDB record format to MastraDBMessage format
-   */
-  parseMessageData(data) {
-    const { thread_id, ...rest } = data;
-    return {
-      ...rest,
-      threadId: thread_id,
-      content: typeof data.content === "string" ? (() => {
-        try {
-          return JSON.parse(data.content);
-        } catch {
-          return data.content;
-        }
-      })() : data.content,
-      createdAt: new Date(data.createdAt),
-      updatedAt: new Date(data.updatedAt)
-    };
-  }
-  async updateMessages(args) {
-    const { messages } = args;
-    this.logger.debug("Updating messages", { count: messages.length });
-    if (!messages.length) {
-      return [];
+      if (!records || records.length === 0) {
+        throw new Error("records array is required and cannot be empty for batchInsert.");
+      }
+    } catch (validationError) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "BATCH_INSERT", "INVALID_ARGS"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
     }
-    const updatedMessages = [];
-    const affectedThreadIds = /* @__PURE__ */ new Set();
     try {
-      for (const updateData of messages) {
-        const { id, ...updates } = updateData;
-        const existingMessage = await this.operations.load({ tableName: TABLE_MESSAGES, keys: { id } });
-        if (!existingMessage) {
-          this.logger.warn("Message not found for update", { id });
-          continue;
-        }
-        const existingMsg = this.parseMessageData(existingMessage);
-        const originalThreadId = existingMsg.threadId;
-        affectedThreadIds.add(originalThreadId);
-        const updatePayload = {};
-        if ("role" in updates && updates.role !== void 0) updatePayload.role = updates.role;
-        if ("type" in updates && updates.type !== void 0) updatePayload.type = updates.type;
-        if ("resourceId" in updates && updates.resourceId !== void 0) updatePayload.resourceId = updates.resourceId;
-        if ("threadId" in updates && updates.threadId !== void 0 && updates.threadId !== null) {
-          updatePayload.thread_id = updates.threadId;
-          affectedThreadIds.add(updates.threadId);
-        }
-        if (updates.content) {
-          const existingContent = existingMsg.content;
-          let newContent = { ...existingContent };
-          if (updates.content.metadata !== void 0) {
-            newContent.metadata = {
-              ...existingContent.metadata || {},
-              ...updates.content.metadata || {}
-            };
-          }
-          if (updates.content.content !== void 0) {
-            newContent.content = updates.content.content;
-          }
-          if ("parts" in updates.content && updates.content.parts !== void 0) {
-            newContent.parts = updates.content.parts;
+      const table = await this.client.openTable(tableName);
+      const primaryId = getPrimaryKeys(tableName);
+      const processedRecords = records.map((record) => {
+        const processedRecord = { ...record };
+        for (const key in processedRecord) {
+          if (processedRecord[key] == null) continue;
+          if (processedRecord[key] !== null && typeof processedRecord[key] === "object" && !(processedRecord[key] instanceof Date)) {
+            processedRecord[key] = JSON.stringify(processedRecord[key]);
           }
-          updatePayload.content = JSON.stringify(newContent);
-        }
-        await this.operations.insert({ tableName: TABLE_MESSAGES, record: { id, ...updatePayload } });
-        const updatedMessage = await this.operations.load({ tableName: TABLE_MESSAGES, keys: { id } });
-        if (updatedMessage) {
-          updatedMessages.push(this.parseMessageData(updatedMessage));
         }
-      }
-      for (const threadId of affectedThreadIds) {
-        await this.operations.insert({
-          tableName: TABLE_THREADS,
-          record: { id: threadId, updatedAt: Date.now() }
-        });
-      }
-      return updatedMessages;
+        return processedRecord;
+      });
+      await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(processedRecords);
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_UPDATE_MESSAGES_FAILED",
+          id: createStorageErrorId("LANCE", "BATCH_INSERT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { count: messages.length }
+          details: { tableName }
         },
         error
       );
     }
   }
-  async getResourceById({ resourceId }) {
+  async load({ tableName, keys }) {
     try {
-      const resource = await this.operations.load({ tableName: TABLE_RESOURCES, keys: { id: resourceId } });
-      if (!resource) {
-        return null;
-      }
-      let createdAt;
-      let updatedAt;
-      try {
-        if (resource.createdAt instanceof Date) {
-          createdAt = resource.createdAt;
-        } else if (typeof resource.createdAt === "string") {
-          createdAt = new Date(resource.createdAt);
-        } else if (typeof resource.createdAt === "number") {
-          createdAt = new Date(resource.createdAt);
-        } else {
-          createdAt = /* @__PURE__ */ new Date();
-        }
-        if (isNaN(createdAt.getTime())) {
-          createdAt = /* @__PURE__ */ new Date();
-        }
-      } catch {
-        createdAt = /* @__PURE__ */ new Date();
-      }
-      try {
-        if (resource.updatedAt instanceof Date) {
-          updatedAt = resource.updatedAt;
-        } else if (typeof resource.updatedAt === "string") {
-          updatedAt = new Date(resource.updatedAt);
-        } else if (typeof resource.updatedAt === "number") {
-          updatedAt = new Date(resource.updatedAt);
-        } else {
-          updatedAt = /* @__PURE__ */ new Date();
-        }
-        if (isNaN(updatedAt.getTime())) {
-          updatedAt = /* @__PURE__ */ new Date();
-        }
-      } catch {
-        updatedAt = /* @__PURE__ */ new Date();
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
       }
-      let workingMemory = resource.workingMemory;
-      if (workingMemory === null || workingMemory === void 0) {
-        workingMemory = void 0;
-      } else if (workingMemory === "") {
-        workingMemory = "";
-      } else if (typeof workingMemory === "object") {
-        workingMemory = JSON.stringify(workingMemory);
+      if (!tableName) {
+        throw new Error("tableName is required for load.");
       }
-      let metadata = resource.metadata;
-      if (metadata === "" || metadata === null || metadata === void 0) {
-        metadata = void 0;
-      } else if (typeof metadata === "string") {
-        try {
-          metadata = JSON.parse(metadata);
-        } catch {
-          metadata = metadata;
-        }
+      if (!keys || Object.keys(keys).length === 0) {
+        throw new Error("keys are required and cannot be empty for load.");
       }
-      return {
-        ...resource,
-        createdAt,
-        updatedAt,
-        workingMemory,
-        metadata
-      };
-    } catch (error) {
+    } catch (validationError) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_GET_RESOURCE_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LOAD", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
         },
-        error
+        validationError
       );
     }
-  }
-  async saveResource({ resource }) {
     try {
-      const record = {
-        ...resource,
-        metadata: resource.metadata ? JSON.stringify(resource.metadata) : "",
-        createdAt: resource.createdAt.getTime(),
-        // Store as timestamp (milliseconds)
-        updatedAt: resource.updatedAt.getTime()
-        // Store as timestamp (milliseconds)
-      };
-      const table = await this.client.openTable(TABLE_RESOURCES);
-      await table.add([record], { mode: "append" });
-      return resource;
+      const table = await this.client.openTable(tableName);
+      const tableSchema = await getTableSchema({ tableName, client: this.client });
+      const query = table.query();
+      if (Object.keys(keys).length > 0) {
+        validateKeyTypes(keys, tableSchema);
+        const filterConditions = Object.entries(keys).map(([key, value]) => {
+          const isCamelCase = /^[a-z][a-zA-Z]*$/.test(key) && /[A-Z]/.test(key);
+          const quotedKey = isCamelCase ? `\`${key}\`` : key;
+          if (typeof value === "string") {
+            return `${quotedKey} = '${value}'`;
+          } else if (value === null) {
+            return `${quotedKey} IS NULL`;
+          } else {
+            return `${quotedKey} = ${value}`;
+          }
+        }).join(" AND ");
+        this.logger.debug("where clause generated: " + filterConditions);
+        query.where(filterConditions);
+      }
+      const result = await query.limit(1).toArray();
+      if (result.length === 0) {
+        this.logger.debug("No record found");
+        return null;
+      }
+      return processResultWithTypeConversion(result[0], tableSchema);
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: "LANCE_STORE_SAVE_RESOURCE_FAILED",
+          id: createStorageErrorId("LANCE", "LOAD", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName, keyCount: Object.keys(keys).length, firstKey: Object.keys(keys)[0] ?? "" }
         },
         error
       );
     }
   }
-  async updateResource({
-    resourceId,
-    workingMemory,
-    metadata
-  }) {
-    const maxRetries = 3;
-    for (let attempt = 0; attempt < maxRetries; attempt++) {
-      try {
-        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 record = {
-          id: resourceId,
-          workingMemory: updatedResource.workingMemory || "",
-          metadata: updatedResource.metadata ? JSON.stringify(updatedResource.metadata) : "",
-          updatedAt: updatedResource.updatedAt.getTime()
-          // Store as timestamp (milliseconds)
-        };
-        const table = await this.client.openTable(TABLE_RESOURCES);
-        await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([record]);
-        return updatedResource;
-      } catch (error) {
-        if (error.message?.includes("Commit conflict") && attempt < maxRetries - 1) {
-          const delay = Math.pow(2, attempt) * 10;
-          await new Promise((resolve) => setTimeout(resolve, delay));
-          continue;
-        }
-        throw new MastraError(
-          {
-            id: "LANCE_STORE_UPDATE_RESOURCE_FAILED",
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.THIRD_PARTY
-          },
-          error
-        );
-      }
-    }
-    throw new Error("Unexpected end of retry loop");
-  }
 };
-var StoreOperationsLance = class extends StoreOperations {
+
+// src/storage/domains/memory/index.ts
+var StoreMemoryLance = class extends MemoryStorage {
   client;
-  constructor({ client }) {
+  #db;
+  constructor(config) {
     super();
+    const client = resolveLanceConfig(config);
     this.client = client;
-  }
-  getDefaultValue(type) {
-    switch (type) {
-      case "text":
-        return "''";
-      case "timestamp":
-        return "CURRENT_TIMESTAMP";
-      case "integer":
-      case "bigint":
-        return "0";
-      case "jsonb":
-        return "'{}'";
-      case "uuid":
-        return "''";
-      default:
-        return super.getDefaultValue(type);
-    }
-  }
-  async hasColumn(tableName, columnName) {
-    const table = await this.client.openTable(tableName);
-    const schema = await table.schema();
-    return schema.fields.some((field) => field.name === columnName);
-  }
-  translateSchema(schema) {
-    const fields = Object.entries(schema).map(([name, column]) => {
-      let arrowType;
-      switch (column.type.toLowerCase()) {
-        case "text":
-        case "uuid":
-          arrowType = new Utf8();
-          break;
-        case "int":
-        case "integer":
-          arrowType = new Int32();
-          break;
-        case "bigint":
-          arrowType = new Float64();
-          break;
-        case "float":
-          arrowType = new Float32();
-          break;
-        case "jsonb":
-        case "json":
-          arrowType = new Utf8();
-          break;
-        case "binary":
-          arrowType = new Binary();
-          break;
-        case "timestamp":
-          arrowType = new Float64();
-          break;
-        default:
-          arrowType = new Utf8();
-      }
-      return new Field(name, arrowType, column.nullable ?? true);
+    this.#db = new LanceDB({ client });
+  }
+  async init() {
+    await this.#db.createTable({ tableName: TABLE_THREADS, schema: TABLE_SCHEMAS[TABLE_THREADS] });
+    await this.#db.createTable({ tableName: TABLE_MESSAGES, schema: TABLE_SCHEMAS[TABLE_MESSAGES] });
+    await this.#db.createTable({ tableName: TABLE_RESOURCES, schema: TABLE_SCHEMAS[TABLE_RESOURCES] });
+    await this.#db.alterTable({
+      tableName: TABLE_MESSAGES,
+      schema: TABLE_SCHEMAS[TABLE_MESSAGES],
+      ifNotExists: ["resourceId"]
     });
-    return new Schema(fields);
   }
-  async createTable({
-    tableName,
-    schema
-  }) {
+  async dangerouslyClearAll() {
+    await this.#db.clearTable({ tableName: TABLE_THREADS });
+    await this.#db.clearTable({ tableName: TABLE_MESSAGES });
+    await this.#db.clearTable({ tableName: TABLE_RESOURCES });
+  }
+  async deleteMessages(messageIds) {
+    if (!messageIds || messageIds.length === 0) {
+      return;
+    }
+    this.logger.debug("Deleting messages", { count: messageIds.length });
     try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
-      }
-      if (!tableName) {
-        throw new Error("tableName is required for createTable.");
+      const threadIds = /* @__PURE__ */ new Set();
+      for (const messageId of messageIds) {
+        const message = await this.#db.load({ tableName: TABLE_MESSAGES, keys: { id: messageId } });
+        if (message?.thread_id) {
+          threadIds.add(message.thread_id);
+        }
       }
-      if (!schema) {
-        throw new Error("schema is required for createTable.");
+      const messagesTable = await this.client.openTable(TABLE_MESSAGES);
+      const idConditions = messageIds.map((id) => `id = '${this.escapeSql(id)}'`).join(" OR ");
+      await messagesTable.delete(idConditions);
+      const now = (/* @__PURE__ */ new Date()).getTime();
+      const threadsTable = await this.client.openTable(TABLE_THREADS);
+      for (const threadId of threadIds) {
+        const thread = await this.getThreadById({ threadId });
+        if (thread) {
+          const record = {
+            id: threadId,
+            resourceId: thread.resourceId,
+            title: thread.title,
+            metadata: JSON.stringify(thread.metadata),
+            createdAt: new Date(thread.createdAt).getTime(),
+            updatedAt: now
+          };
+          await threadsTable.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([record]);
+        }
       }
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "DELETE_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY,
+          details: { count: messageIds.length }
         },
         error
       );
     }
+  }
+  // Utility to escape single quotes in SQL strings
+  escapeSql(str) {
+    return str.replace(/'/g, "''");
+  }
+  async getThreadById({ threadId }) {
     try {
-      const arrowSchema = this.translateSchema(schema);
-      await this.client.createEmptyTable(tableName, arrowSchema);
-    } catch (error) {
-      if (error.message?.includes("already exists")) {
-        this.logger.debug(`Table '${tableName}' already exists, skipping create`);
-        return;
+      const thread = await this.#db.load({ tableName: TABLE_THREADS, keys: { id: threadId } });
+      if (!thread) {
+        return null;
       }
+      return {
+        ...thread,
+        createdAt: new Date(thread.createdAt),
+        updatedAt: new Date(thread.updatedAt)
+      };
+    } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "GET_THREAD_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY
         },
         error
       );
     }
   }
-  async dropTable({ tableName }) {
+  /**
+   * Saves a thread to the database. This function doesn't overwrite existing threads.
+   * @param thread - The thread to save
+   * @returns The saved thread
+   */
+  async saveThread({ thread }) {
     try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
-      }
-      if (!tableName) {
-        throw new Error("tableName is required for dropTable.");
-      }
-    } catch (validationError) {
+      const record = { ...thread, metadata: JSON.stringify(thread.metadata) };
+      const table = await this.client.openTable(TABLE_THREADS);
+      await table.add([record], { mode: "append" });
+      return thread;
+    } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "SAVE_THREAD", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          text: validationError.message,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY
         },
-        validationError
+        error
       );
     }
+  }
+  async updateThread({
+    id,
+    title,
+    metadata
+  }) {
+    const maxRetries = 5;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      try {
+        const current = await this.getThreadById({ threadId: id });
+        if (!current) {
+          throw new Error(`Thread with id ${id} not found`);
+        }
+        const mergedMetadata = { ...current.metadata, ...metadata };
+        const record = {
+          id,
+          title,
+          metadata: JSON.stringify(mergedMetadata),
+          updatedAt: (/* @__PURE__ */ new Date()).getTime()
+        };
+        const table = await this.client.openTable(TABLE_THREADS);
+        await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([record]);
+        const updatedThread = await this.getThreadById({ threadId: id });
+        if (!updatedThread) {
+          throw new Error(`Failed to retrieve updated thread ${id}`);
+        }
+        return updatedThread;
+      } catch (error) {
+        if (error.message?.includes("Commit conflict") && attempt < maxRetries - 1) {
+          const delay = Math.pow(2, attempt) * 10;
+          await new Promise((resolve) => setTimeout(resolve, delay));
+          continue;
+        }
+        throw new MastraError(
+          {
+            id: createStorageErrorId("LANCE", "UPDATE_THREAD", "FAILED"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.THIRD_PARTY
+          },
+          error
+        );
+      }
+    }
+    throw new MastraError(
+      {
+        id: createStorageErrorId("LANCE", "UPDATE_THREAD", "FAILED"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.THIRD_PARTY
+      },
+      new Error("All retries exhausted")
+    );
+  }
+  async deleteThread({ threadId }) {
     try {
-      await this.client.dropTable(tableName);
+      const table = await this.client.openTable(TABLE_THREADS);
+      await table.delete(`id = '${threadId}'`);
+      const messagesTable = await this.client.openTable(TABLE_MESSAGES);
+      await messagesTable.delete(`thread_id = '${threadId}'`);
     } catch (error) {
-      if (error.toString().includes("was not found") || error.message?.includes("Table not found")) {
-        this.logger.debug(`Table '${tableName}' does not exist, skipping drop`);
-        return;
-      }
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "DELETE_THREAD", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY
         },
         error
       );
     }
   }
-  async alterTable({
-    tableName,
-    schema,
-    ifNotExists
-  }) {
+  normalizeMessage(message) {
+    const { thread_id, ...rest } = message;
+    return {
+      ...rest,
+      threadId: thread_id,
+      content: typeof message.content === "string" ? (() => {
+        try {
+          return JSON.parse(message.content);
+        } catch {
+          return message.content;
+        }
+      })() : message.content
+    };
+  }
+  async listMessagesById({ messageIds }) {
+    if (messageIds.length === 0) return { messages: [] };
     try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
-      }
-      if (!tableName) {
-        throw new Error("tableName is required for alterTable.");
-      }
-      if (!schema) {
-        throw new Error("schema is required for alterTable.");
-      }
-      if (!ifNotExists || ifNotExists.length === 0) {
-        this.logger.debug("No columns specified to add in alterTable, skipping.");
-        return;
-      }
-    } catch (validationError) {
+      const table = await this.client.openTable(TABLE_MESSAGES);
+      const quotedIds = messageIds.map((id) => `'${id}'`).join(", ");
+      const allRecords = await table.query().where(`id IN (${quotedIds})`).toArray();
+      const messages = processResultWithTypeConversion(
+        allRecords,
+        await getTableSchema({ tableName: TABLE_MESSAGES, client: this.client })
+      );
+      const list = new MessageList().add(
+        messages.map(this.normalizeMessage),
+        "memory"
+      );
+      return { messages: list.get.all.db() };
+    } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "LIST_MESSAGES_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          text: validationError.message,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY,
+          details: {
+            messageIds: JSON.stringify(messageIds)
+          }
         },
-        validationError
+        error
       );
     }
+  }
+  async listMessages(args) {
+    const { threadId, resourceId, include, filter, perPage: perPageInput, page = 0, orderBy } = args;
+    const threadIds = Array.isArray(threadId) ? threadId : [threadId];
+    if (threadIds.length === 0 || threadIds.some((id) => !id.trim())) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "LIST_MESSAGES", "INVALID_THREAD_ID"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { threadId: Array.isArray(threadId) ? threadId.join(",") : threadId }
+        },
+        new Error("threadId must be a non-empty string or array of non-empty strings")
+      );
+    }
+    const perPage = normalizePerPage(perPageInput, 40);
+    const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
     try {
-      const table = await this.client.openTable(tableName);
-      const currentSchema = await table.schema();
-      const existingFields = new Set(currentSchema.fields.map((f) => f.name));
-      const typeMap = {
-        text: "string",
-        integer: "int",
-        bigint: "bigint",
-        timestamp: "timestamp",
-        jsonb: "string",
-        uuid: "string"
-      };
-      const columnsToAdd = ifNotExists.filter((col) => schema[col] && !existingFields.has(col)).map((col) => {
-        const colDef = schema[col];
+      if (page < 0) {
+        throw new MastraError(
+          {
+            id: createStorageErrorId("LANCE", "LIST_MESSAGES", "INVALID_PAGE"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.USER,
+            details: { page }
+          },
+          new Error("page must be >= 0")
+        );
+      }
+      const { field, direction } = this.parseOrderBy(orderBy, "ASC");
+      const table = await this.client.openTable(TABLE_MESSAGES);
+      const threadCondition = threadIds.length === 1 ? `thread_id = '${this.escapeSql(threadIds[0])}'` : `thread_id IN (${threadIds.map((t) => `'${this.escapeSql(t)}'`).join(", ")})`;
+      const conditions = [threadCondition];
+      if (resourceId) {
+        conditions.push(`\`resourceId\` = '${this.escapeSql(resourceId)}'`);
+      }
+      if (filter?.dateRange?.start) {
+        const startTime = filter.dateRange.start instanceof Date ? filter.dateRange.start.getTime() : new Date(filter.dateRange.start).getTime();
+        const startOp = filter.dateRange.startExclusive ? ">" : ">=";
+        conditions.push(`\`createdAt\` ${startOp} ${startTime}`);
+      }
+      if (filter?.dateRange?.end) {
+        const endTime = filter.dateRange.end instanceof Date ? filter.dateRange.end.getTime() : new Date(filter.dateRange.end).getTime();
+        const endOp = filter.dateRange.endExclusive ? "<" : "<=";
+        conditions.push(`\`createdAt\` ${endOp} ${endTime}`);
+      }
+      const whereClause = conditions.join(" AND ");
+      const total = await table.countRows(whereClause);
+      const query = table.query().where(whereClause);
+      let allRecords = await query.toArray();
+      allRecords.sort((a, b) => {
+        const aValue = field === "createdAt" ? a.createdAt : a[field];
+        const bValue = field === "createdAt" ? b.createdAt : b[field];
+        if (aValue == null && bValue == null) return 0;
+        if (aValue == null) return direction === "ASC" ? -1 : 1;
+        if (bValue == null) return direction === "ASC" ? 1 : -1;
+        if (typeof aValue === "string" && typeof bValue === "string") {
+          return direction === "ASC" ? aValue.localeCompare(bValue) : bValue.localeCompare(aValue);
+        }
+        return direction === "ASC" ? aValue - bValue : bValue - aValue;
+      });
+      const paginatedRecords = allRecords.slice(offset, offset + perPage);
+      const messages = paginatedRecords.map((row) => this.normalizeMessage(row));
+      if (total === 0 && messages.length === 0 && (!include || include.length === 0)) {
         return {
-          name: col,
-          valueSql: colDef?.nullable ? `cast(NULL as ${typeMap[colDef.type ?? "text"]})` : `cast(${this.getDefaultValue(colDef?.type ?? "text")} as ${typeMap[colDef?.type ?? "text"]})`
+          messages: [],
+          total: 0,
+          page,
+          perPage: perPageForResponse,
+          hasMore: false
         };
-      });
-      if (columnsToAdd.length > 0) {
-        await table.addColumns(columnsToAdd);
-        this.logger?.info?.(`Added columns [${columnsToAdd.map((c) => c.name).join(", ")}] to table ${tableName}`);
       }
+      const messageIds = new Set(messages.map((m) => m.id));
+      if (include && include.length > 0) {
+        const threadIds2 = [...new Set(include.map((item) => item.threadId || threadId))];
+        const allThreadMessages = [];
+        for (const tid of threadIds2) {
+          const threadQuery = table.query().where(`thread_id = '${tid}'`);
+          let threadRecords = await threadQuery.toArray();
+          allThreadMessages.push(...threadRecords);
+        }
+        allThreadMessages.sort((a, b) => a.createdAt - b.createdAt);
+        const contextMessages = this.processMessagesWithContext(allThreadMessages, include);
+        const includedMessages = contextMessages.map((row) => this.normalizeMessage(row));
+        for (const includeMsg of includedMessages) {
+          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 aValue = field === "createdAt" ? new Date(a.createdAt).getTime() : a[field];
+        const bValue = field === "createdAt" ? new Date(b.createdAt).getTime() : b[field];
+        if (aValue == null && bValue == null) return 0;
+        if (aValue == null) return direction === "ASC" ? -1 : 1;
+        if (bValue == null) return direction === "ASC" ? 1 : -1;
+        if (typeof aValue === "string" && typeof bValue === "string") {
+          return direction === "ASC" ? aValue.localeCompare(bValue) : bValue.localeCompare(aValue);
+        }
+        return direction === "ASC" ? aValue - bValue : bValue - aValue;
+      });
+      const returnedThreadMessageIds = new Set(finalMessages.filter((m) => m.threadId === threadId).map((m) => m.id));
+      const allThreadMessagesReturned = returnedThreadMessageIds.size >= total;
+      const fetchedAll = perPageInput === false || allThreadMessagesReturned;
+      const hasMore = !fetchedAll && offset + perPage < total;
+      return {
+        messages: finalMessages,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore
+      };
     } catch (error) {
-      throw new MastraError(
+      const mastraError = new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { tableName }
+          details: {
+            threadId: Array.isArray(threadId) ? threadId.join(",") : threadId,
+            resourceId: resourceId ?? ""
+          }
         },
         error
       );
+      this.logger?.error?.(mastraError.toString());
+      this.logger?.trackException?.(mastraError);
+      return {
+        messages: [],
+        total: 0,
+        page,
+        perPage: perPageForResponse,
+        hasMore: false
+      };
     }
   }
-  async clearTable({ tableName }) {
+  async saveMessages(args) {
     try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      const { messages } = args;
+      if (messages.length === 0) {
+        return { messages: [] };
       }
-      if (!tableName) {
-        throw new Error("tableName is required for clearTable.");
+      const threadId = messages[0]?.threadId;
+      if (!threadId) {
+        throw new Error("Thread ID is required");
       }
-    } catch (validationError) {
+      for (const message of messages) {
+        if (!message.id) {
+          throw new Error("Message ID is required");
+        }
+        if (!message.threadId) {
+          throw new Error("Thread ID is required for all messages");
+        }
+        if (message.resourceId === null || message.resourceId === void 0) {
+          throw new Error("Resource ID cannot be null or undefined");
+        }
+        if (!message.content) {
+          throw new Error("Message content is required");
+        }
+      }
+      const transformedMessages = messages.map((message) => {
+        const { threadId: threadId2, type, ...rest } = message;
+        return {
+          ...rest,
+          thread_id: threadId2,
+          type: type ?? "v2",
+          content: JSON.stringify(message.content)
+        };
+      });
+      const table = await this.client.openTable(TABLE_MESSAGES);
+      await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(transformedMessages);
+      const threadsTable = await this.client.openTable(TABLE_THREADS);
+      const currentTime = (/* @__PURE__ */ new Date()).getTime();
+      const updateRecord = { id: threadId, updatedAt: currentTime };
+      await threadsTable.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([updateRecord]);
+      const list = new MessageList().add(messages, "memory");
+      return { messages: list.get.all.db() };
+    } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "SAVE_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          text: validationError.message,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY
         },
-        validationError
+        error
       );
     }
+  }
+  async listThreadsByResourceId(args) {
     try {
-      const table = await this.client.openTable(tableName);
-      await table.delete("1=1");
+      const { resourceId, page = 0, perPage: perPageInput, orderBy } = args;
+      const perPage = normalizePerPage(perPageInput, 100);
+      if (page < 0) {
+        throw new MastraError(
+          {
+            id: createStorageErrorId("LANCE", "LIST_THREADS_BY_RESOURCE_ID", "INVALID_PAGE"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.USER,
+            details: { page }
+          },
+          new Error("page must be >= 0")
+        );
+      }
+      const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const { field, direction } = this.parseOrderBy(orderBy);
+      const table = await this.client.openTable(TABLE_THREADS);
+      const total = await table.countRows(`\`resourceId\` = '${this.escapeSql(resourceId)}'`);
+      const query = table.query().where(`\`resourceId\` = '${this.escapeSql(resourceId)}'`);
+      const records = await query.toArray();
+      records.sort((a, b) => {
+        const aValue = ["createdAt", "updatedAt"].includes(field) ? new Date(a[field]).getTime() : a[field];
+        const bValue = ["createdAt", "updatedAt"].includes(field) ? new Date(b[field]).getTime() : b[field];
+        if (aValue == null && bValue == null) return 0;
+        if (aValue == null) return direction === "ASC" ? -1 : 1;
+        if (bValue == null) return direction === "ASC" ? 1 : -1;
+        if (typeof aValue === "string" && typeof bValue === "string") {
+          return direction === "ASC" ? aValue.localeCompare(bValue) : bValue.localeCompare(aValue);
+        }
+        return direction === "ASC" ? aValue - bValue : bValue - aValue;
+      });
+      const paginatedRecords = records.slice(offset, offset + perPage);
+      const schema = await getTableSchema({ tableName: TABLE_THREADS, client: this.client });
+      const threads = paginatedRecords.map(
+        (record) => processResultWithTypeConversion(record, schema)
+      );
+      return {
+        threads,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: offset + perPage < total
+      };
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_THREADS_BY_RESOURCE_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY
         },
         error
       );
     }
   }
-  async insert({ tableName, record }) {
-    try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
-      }
-      if (!tableName) {
-        throw new Error("tableName is required for insert.");
+  /**
+   * Processes messages to include context messages based on withPreviousMessages and withNextMessages
+   * @param records - The sorted array of records to process
+   * @param include - The array of include specifications with context parameters
+   * @returns The processed array with context messages included
+   */
+  processMessagesWithContext(records, include) {
+    const messagesWithContext = include.filter((item) => item.withPreviousMessages || item.withNextMessages);
+    if (messagesWithContext.length === 0) {
+      return records;
+    }
+    const messageIndexMap = /* @__PURE__ */ new Map();
+    records.forEach((message, index) => {
+      messageIndexMap.set(message.id, index);
+    });
+    const additionalIndices = /* @__PURE__ */ new Set();
+    for (const item of messagesWithContext) {
+      const messageIndex = messageIndexMap.get(item.id);
+      if (messageIndex !== void 0) {
+        if (item.withPreviousMessages) {
+          const startIdx = Math.max(0, messageIndex - item.withPreviousMessages);
+          for (let i = startIdx; i < messageIndex; i++) {
+            additionalIndices.add(i);
+          }
+        }
+        if (item.withNextMessages) {
+          const endIdx = Math.min(records.length - 1, messageIndex + item.withNextMessages);
+          for (let i = messageIndex + 1; i <= endIdx; i++) {
+            additionalIndices.add(i);
+          }
+        }
       }
-      if (!record || Object.keys(record).length === 0) {
-        throw new Error("record is required and cannot be empty for insert.");
+    }
+    if (additionalIndices.size === 0) {
+      return records;
+    }
+    const originalMatchIds = new Set(include.map((item) => item.id));
+    const allIndices = /* @__PURE__ */ new Set();
+    records.forEach((record, index) => {
+      if (originalMatchIds.has(record.id)) {
+        allIndices.add(index);
       }
-    } catch (validationError) {
-      throw new MastraError(
-        {
-          id: "STORAGE_LANCE_STORAGE_INSERT_INVALID_ARGS",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          text: validationError.message,
-          details: { tableName }
-        },
-        validationError
-      );
+    });
+    additionalIndices.forEach((index) => {
+      allIndices.add(index);
+    });
+    return Array.from(allIndices).sort((a, b) => a - b).map((index) => records[index]);
+  }
+  /**
+   * Parse message data from LanceDB record format to MastraDBMessage format
+   */
+  parseMessageData(data) {
+    const { thread_id, ...rest } = data;
+    return {
+      ...rest,
+      threadId: thread_id,
+      content: typeof data.content === "string" ? (() => {
+        try {
+          return JSON.parse(data.content);
+        } catch {
+          return data.content;
+        }
+      })() : data.content,
+      createdAt: new Date(data.createdAt),
+      updatedAt: new Date(data.updatedAt)
+    };
+  }
+  async updateMessages(args) {
+    const { messages } = args;
+    this.logger.debug("Updating messages", { count: messages.length });
+    if (!messages.length) {
+      return [];
     }
+    const updatedMessages = [];
+    const affectedThreadIds = /* @__PURE__ */ new Set();
     try {
-      const table = await this.client.openTable(tableName);
-      const primaryId = getPrimaryKeys(tableName);
-      const processedRecord = { ...record };
-      for (const key in processedRecord) {
-        if (processedRecord[key] !== null && typeof processedRecord[key] === "object" && !(processedRecord[key] instanceof Date)) {
-          this.logger.debug("Converting object to JSON string: ", processedRecord[key]);
-          processedRecord[key] = JSON.stringify(processedRecord[key]);
+      for (const updateData of messages) {
+        const { id, ...updates } = updateData;
+        const existingMessage = await this.#db.load({ tableName: TABLE_MESSAGES, keys: { id } });
+        if (!existingMessage) {
+          this.logger.warn("Message not found for update", { id });
+          continue;
+        }
+        const existingMsg = this.parseMessageData(existingMessage);
+        const originalThreadId = existingMsg.threadId;
+        affectedThreadIds.add(originalThreadId);
+        const updatePayload = {};
+        if ("role" in updates && updates.role !== void 0) updatePayload.role = updates.role;
+        if ("type" in updates && updates.type !== void 0) updatePayload.type = updates.type;
+        if ("resourceId" in updates && updates.resourceId !== void 0) updatePayload.resourceId = updates.resourceId;
+        if ("threadId" in updates && updates.threadId !== void 0 && updates.threadId !== null) {
+          updatePayload.thread_id = updates.threadId;
+          affectedThreadIds.add(updates.threadId);
         }
+        if (updates.content) {
+          const existingContent = existingMsg.content;
+          let newContent = { ...existingContent };
+          if (updates.content.metadata !== void 0) {
+            newContent.metadata = {
+              ...existingContent.metadata || {},
+              ...updates.content.metadata || {}
+            };
+          }
+          if (updates.content.content !== void 0) {
+            newContent.content = updates.content.content;
+          }
+          if ("parts" in updates.content && updates.content.parts !== void 0) {
+            newContent.parts = updates.content.parts;
+          }
+          updatePayload.content = JSON.stringify(newContent);
+        }
+        await this.#db.insert({ tableName: TABLE_MESSAGES, record: { id, ...updatePayload } });
+        const updatedMessage = await this.#db.load({ tableName: TABLE_MESSAGES, keys: { id } });
+        if (updatedMessage) {
+          updatedMessages.push(this.parseMessageData(updatedMessage));
+        }
+      }
+      for (const threadId of affectedThreadIds) {
+        await this.#db.insert({
+          tableName: TABLE_THREADS,
+          record: { id: threadId, updatedAt: Date.now() }
+        });
       }
-      console.info(await table.schema());
-      await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([processedRecord]);
+      return updatedMessages;
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_INSERT_FAILED",
+          id: createStorageErrorId("LANCE", "UPDATE_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { tableName }
+          details: { count: messages.length }
         },
         error
       );
     }
   }
-  async batchInsert({ tableName, records }) {
+  async getResourceById({ resourceId }) {
     try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      const resource = await this.#db.load({ tableName: TABLE_RESOURCES, keys: { id: resourceId } });
+      if (!resource) {
+        return null;
       }
-      if (!tableName) {
-        throw new Error("tableName is required for batchInsert.");
+      let createdAt;
+      let updatedAt;
+      try {
+        if (resource.createdAt instanceof Date) {
+          createdAt = resource.createdAt;
+        } else if (typeof resource.createdAt === "string") {
+          createdAt = new Date(resource.createdAt);
+        } else if (typeof resource.createdAt === "number") {
+          createdAt = new Date(resource.createdAt);
+        } else {
+          createdAt = /* @__PURE__ */ new Date();
+        }
+        if (isNaN(createdAt.getTime())) {
+          createdAt = /* @__PURE__ */ new Date();
+        }
+      } catch {
+        createdAt = /* @__PURE__ */ new Date();
       }
-      if (!records || records.length === 0) {
-        throw new Error("records array is required and cannot be empty for batchInsert.");
+      try {
+        if (resource.updatedAt instanceof Date) {
+          updatedAt = resource.updatedAt;
+        } else if (typeof resource.updatedAt === "string") {
+          updatedAt = new Date(resource.updatedAt);
+        } else if (typeof resource.updatedAt === "number") {
+          updatedAt = new Date(resource.updatedAt);
+        } else {
+          updatedAt = /* @__PURE__ */ new Date();
+        }
+        if (isNaN(updatedAt.getTime())) {
+          updatedAt = /* @__PURE__ */ new Date();
+        }
+      } catch {
+        updatedAt = /* @__PURE__ */ new Date();
       }
-    } catch (validationError) {
-      throw new MastraError(
-        {
-          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_INVALID_ARGS",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          text: validationError.message,
-          details: { tableName }
-        },
-        validationError
-      );
-    }
-    try {
-      const table = await this.client.openTable(tableName);
-      const primaryId = getPrimaryKeys(tableName);
-      const processedRecords = records.map((record) => {
-        const processedRecord = { ...record };
-        for (const key in processedRecord) {
-          if (processedRecord[key] == null) continue;
-          if (processedRecord[key] !== null && typeof processedRecord[key] === "object" && !(processedRecord[key] instanceof Date)) {
-            processedRecord[key] = JSON.stringify(processedRecord[key]);
-          }
+      let workingMemory = resource.workingMemory;
+      if (workingMemory === null || workingMemory === void 0) {
+        workingMemory = void 0;
+      } else if (workingMemory === "") {
+        workingMemory = "";
+      } else if (typeof workingMemory === "object") {
+        workingMemory = JSON.stringify(workingMemory);
+      }
+      let metadata = resource.metadata;
+      if (metadata === "" || metadata === null || metadata === void 0) {
+        metadata = void 0;
+      } else if (typeof metadata === "string") {
+        try {
+          metadata = JSON.parse(metadata);
+        } catch {
+          metadata = metadata;
         }
-        return processedRecord;
-      });
-      await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(processedRecords);
+      }
+      return {
+        ...resource,
+        createdAt,
+        updatedAt,
+        workingMemory,
+        metadata
+      };
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_FAILED",
+          id: createStorageErrorId("LANCE", "GET_RESOURCE_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { tableName }
+          category: ErrorCategory.THIRD_PARTY
         },
         error
       );
     }
   }
-  async load({ tableName, keys }) {
-    try {
-      if (!this.client) {
-        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
-      }
-      if (!tableName) {
-        throw new Error("tableName is required for load.");
-      }
-      if (!keys || Object.keys(keys).length === 0) {
-        throw new Error("keys are required and cannot be empty for load.");
-      }
-    } catch (validationError) {
-      throw new MastraError(
-        {
-          id: "STORAGE_LANCE_STORAGE_LOAD_INVALID_ARGS",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          text: validationError.message,
-          details: { tableName }
-        },
-        validationError
-      );
-    }
+  async saveResource({ resource }) {
     try {
-      const table = await this.client.openTable(tableName);
-      const tableSchema = await getTableSchema({ tableName, client: this.client });
-      const query = table.query();
-      if (Object.keys(keys).length > 0) {
-        validateKeyTypes(keys, tableSchema);
-        const filterConditions = Object.entries(keys).map(([key, value]) => {
-          const isCamelCase = /^[a-z][a-zA-Z]*$/.test(key) && /[A-Z]/.test(key);
-          const quotedKey = isCamelCase ? `\`${key}\`` : key;
-          if (typeof value === "string") {
-            return `${quotedKey} = '${value}'`;
-          } else if (value === null) {
-            return `${quotedKey} IS NULL`;
-          } else {
-            return `${quotedKey} = ${value}`;
-          }
-        }).join(" AND ");
-        this.logger.debug("where clause generated: " + filterConditions);
-        query.where(filterConditions);
-      }
-      const result = await query.limit(1).toArray();
-      if (result.length === 0) {
-        this.logger.debug("No record found");
-        return null;
-      }
-      return processResultWithTypeConversion(result[0], tableSchema);
+      const record = {
+        ...resource,
+        metadata: resource.metadata ? JSON.stringify(resource.metadata) : "",
+        createdAt: resource.createdAt.getTime(),
+        // Store as timestamp (milliseconds)
+        updatedAt: resource.updatedAt.getTime()
+        // Store as timestamp (milliseconds)
+      };
+      const table = await this.client.openTable(TABLE_RESOURCES);
+      await table.add([record], { mode: "append" });
+      return resource;
     } catch (error) {
-      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_LOAD_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_RESOURCE", "FAILED"),
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { tableName, keyCount: Object.keys(keys).length, firstKey: Object.keys(keys)[0] ?? "" }
+          category: ErrorCategory.THIRD_PARTY
         },
         error
       );
     }
   }
+  async updateResource({
+    resourceId,
+    workingMemory,
+    metadata
+  }) {
+    const maxRetries = 3;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      try {
+        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 record = {
+          id: resourceId,
+          workingMemory: updatedResource.workingMemory || "",
+          metadata: updatedResource.metadata ? JSON.stringify(updatedResource.metadata) : "",
+          updatedAt: updatedResource.updatedAt.getTime()
+          // Store as timestamp (milliseconds)
+        };
+        const table = await this.client.openTable(TABLE_RESOURCES);
+        await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([record]);
+        return updatedResource;
+      } catch (error) {
+        if (error.message?.includes("Commit conflict") && attempt < maxRetries - 1) {
+          const delay = Math.pow(2, attempt) * 10;
+          await new Promise((resolve) => setTimeout(resolve, delay));
+          continue;
+        }
+        throw new MastraError(
+          {
+            id: createStorageErrorId("LANCE", "UPDATE_RESOURCE", "FAILED"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.THIRD_PARTY
+          },
+          error
+        );
+      }
+    }
+    throw new Error("Unexpected end of retry loop");
+  }
 };
 var StoreScoresLance = class extends ScoresStorage {
   client;
-  constructor({ client }) {
+  #db;
+  constructor(config) {
     super();
+    const client = resolveLanceConfig(config);
     this.client = client;
+    this.#db = new LanceDB({ client });
+  }
+  async init() {
+    await this.#db.createTable({ tableName: TABLE_SCORERS, schema: SCORERS_SCHEMA });
+    await this.#db.alterTable({
+      tableName: TABLE_SCORERS,
+      schema: SCORERS_SCHEMA,
+      ifNotExists: ["spanId", "requestContext"]
+    });
+  }
+  async dangerouslyClearAll() {
+    await this.#db.clearTable({ tableName: TABLE_SCORERS });
   }
   async saveScore(score) {
     let validatedScore;
@@ -1242,37 +1325,47 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_SAVE_SCORE_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_SCORE", "VALIDATION_FAILED"),
           text: "Failed to save score in LanceStorage",
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.USER,
+          details: {
+            scorer: typeof score.scorer?.id === "string" ? score.scorer.id : String(score.scorer?.id ?? "unknown"),
+            entityId: score.entityId ?? "unknown",
+            entityType: score.entityType ?? "unknown",
+            traceId: score.traceId ?? "",
+            spanId: score.spanId ?? ""
+          }
         },
         error
       );
     }
+    const id = crypto.randomUUID();
+    const now = /* @__PURE__ */ new Date();
     try {
-      const id = crypto.randomUUID();
       const table = await this.client.openTable(TABLE_SCORERS);
       const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
       const allowedFields = new Set(schema.fields.map((f) => f.name));
       const filteredScore = {};
-      Object.keys(validatedScore).forEach((key) => {
+      for (const key of Object.keys(validatedScore)) {
         if (allowedFields.has(key)) {
-          filteredScore[key] = score[key];
+          filteredScore[key] = validatedScore[key];
         }
-      });
+      }
       for (const key in filteredScore) {
         if (filteredScore[key] !== null && typeof filteredScore[key] === "object" && !(filteredScore[key] instanceof Date)) {
           filteredScore[key] = JSON.stringify(filteredScore[key]);
         }
       }
       filteredScore.id = id;
+      filteredScore.createdAt = now;
+      filteredScore.updatedAt = now;
       await table.add([filteredScore], { mode: "append" });
-      return { score };
+      return { score: { ...validatedScore, id, createdAt: now, updatedAt: now } };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_SAVE_SCORE_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_SCORE", "FAILED"),
           text: "Failed to save score in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1288,12 +1381,11 @@ var StoreScoresLance = class extends ScoresStorage {
       const query = table.query().where(`id = '${id}'`).limit(1);
       const records = await query.toArray();
       if (records.length === 0) return null;
-      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
-      return processResultWithTypeConversion(records[0], schema);
+      return await this.transformScoreRow(records[0]);
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORE_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "GET_SCORE_BY_ID", "FAILED"),
           text: "Failed to get score by id in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1303,6 +1395,22 @@ var StoreScoresLance = class extends ScoresStorage {
       );
     }
   }
+  /**
+   * LanceDB-specific score row transformation.
+   *
+   * Note: This implementation does NOT use coreTransformScoreRow because:
+   * 1. LanceDB stores schema information in the table itself (requires async fetch)
+   * 2. Uses processResultWithTypeConversion utility for LanceDB-specific type handling
+   */
+  async transformScoreRow(row) {
+    const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
+    const transformed = processResultWithTypeConversion(row, schema);
+    return {
+      ...transformed,
+      createdAt: row.createdAt,
+      updatedAt: row.updatedAt
+    };
+  }
   async listScoresByScorerId({
     scorerId,
     pagination,
@@ -1343,8 +1451,7 @@ var StoreScoresLance = class extends ScoresStorage {
         if (start > 0) query = query.offset(start);
       }
       const records = await query.toArray();
-      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
-      const scores = processResultWithTypeConversion(records, schema);
+      const scores = await Promise.all(records.map(async (record) => await this.transformScoreRow(record)));
       return {
         pagination: {
           page,
@@ -1357,7 +1464,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_SCORER_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_SCORER_ID", "FAILED"),
           text: "Failed to get scores by scorerId in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1385,8 +1492,7 @@ var StoreScoresLance = class extends ScoresStorage {
         if (start > 0) query = query.offset(start);
       }
       const records = await query.toArray();
-      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
-      const scores = processResultWithTypeConversion(records, schema);
+      const scores = await Promise.all(records.map(async (record) => await this.transformScoreRow(record)));
       return {
         pagination: {
           page,
@@ -1399,7 +1505,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_RUN_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_RUN_ID", "FAILED"),
           text: "Failed to get scores by runId in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1428,8 +1534,7 @@ var StoreScoresLance = class extends ScoresStorage {
         if (start > 0) query = query.offset(start);
       }
       const records = await query.toArray();
-      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
-      const scores = processResultWithTypeConversion(records, schema);
+      const scores = await Promise.all(records.map(async (record) => await this.transformScoreRow(record)));
       return {
         pagination: {
           page,
@@ -1442,7 +1547,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_ENTITY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_ENTITY_ID", "FAILED"),
           text: "Failed to get scores by entityId and entityType in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1471,8 +1576,7 @@ var StoreScoresLance = class extends ScoresStorage {
         if (start > 0) query = query.offset(start);
       }
       const records = await query.toArray();
-      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
-      const scores = processResultWithTypeConversion(records, schema);
+      const scores = await Promise.all(records.map(async (record) => await this.transformScoreRow(record)));
       return {
         pagination: {
           page,
@@ -1485,7 +1589,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_SPAN_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_SPAN", "FAILED"),
           text: "Failed to get scores by traceId and spanId in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1496,62 +1600,111 @@ var StoreScoresLance = class extends ScoresStorage {
     }
   }
 };
-function parseWorkflowRun(row) {
-  let parsedSnapshot = row.snapshot;
-  if (typeof parsedSnapshot === "string") {
-    try {
-      parsedSnapshot = JSON.parse(row.snapshot);
-    } catch (e) {
-      console.warn(`Failed to parse snapshot for workflow ${row.workflow_name}: ${e}`);
-    }
-  }
-  return {
-    workflowName: row.workflow_name,
-    runId: row.run_id,
-    snapshot: parsedSnapshot,
-    createdAt: ensureDate(row.createdAt),
-    updatedAt: ensureDate(row.updatedAt),
-    resourceId: row.resourceId
-  };
+function escapeSql(str) {
+  return str.replace(/'/g, "''");
 }
 var StoreWorkflowsLance = class extends WorkflowsStorage {
   client;
-  constructor({ client }) {
+  #db;
+  constructor(config) {
     super();
+    const client = resolveLanceConfig(config);
     this.client = client;
+    this.#db = new LanceDB({ client });
   }
-  updateWorkflowResults({
-    // workflowName,
-    // runId,
-    // stepId,
-    // result,
-    // requestContext,
+  parseWorkflowRun(row) {
+    let parsedSnapshot = row.snapshot;
+    if (typeof parsedSnapshot === "string") {
+      try {
+        parsedSnapshot = JSON.parse(row.snapshot);
+      } catch (e) {
+        this.logger.warn(`Failed to parse snapshot for workflow ${row.workflow_name}: ${e}`);
+      }
+    }
+    return {
+      workflowName: row.workflow_name,
+      runId: row.run_id,
+      snapshot: parsedSnapshot,
+      createdAt: ensureDate(row.createdAt),
+      updatedAt: ensureDate(row.updatedAt),
+      resourceId: row.resourceId
+    };
+  }
+  async init() {
+    const schema = TABLE_SCHEMAS[TABLE_WORKFLOW_SNAPSHOT];
+    await this.#db.createTable({ tableName: TABLE_WORKFLOW_SNAPSHOT, schema });
+    await this.#db.alterTable({
+      tableName: TABLE_WORKFLOW_SNAPSHOT,
+      schema,
+      ifNotExists: ["resourceId"]
+    });
+  }
+  async dangerouslyClearAll() {
+    await this.#db.clearTable({ tableName: TABLE_WORKFLOW_SNAPSHOT });
+  }
+  async updateWorkflowResults({
+    workflowName,
+    runId,
+    stepId,
+    result,
+    requestContext
   }) {
-    throw new Error("Method not implemented.");
+    let snapshot = await this.loadWorkflowSnapshot({ workflowName, runId });
+    if (!snapshot) {
+      snapshot = {
+        context: {},
+        activePaths: [],
+        timestamp: Date.now(),
+        suspendedPaths: {},
+        activeStepsPath: {},
+        resumeLabels: {},
+        serializedStepGraph: [],
+        status: "pending",
+        value: {},
+        waitingPaths: {},
+        runId,
+        requestContext: {}
+      };
+    }
+    snapshot.context[stepId] = result;
+    snapshot.requestContext = { ...snapshot.requestContext, ...requestContext };
+    await this.persistWorkflowSnapshot({ workflowName, runId, snapshot });
+    return snapshot.context;
   }
-  updateWorkflowState({
-    // workflowName,
-    // runId,
-    // opts,
+  async updateWorkflowState({
+    workflowName,
+    runId,
+    opts
   }) {
-    throw new Error("Method not implemented.");
+    const snapshot = await this.loadWorkflowSnapshot({ workflowName, runId });
+    if (!snapshot) {
+      return void 0;
+    }
+    if (!snapshot.context) {
+      throw new Error(`Snapshot not found for runId ${runId}`);
+    }
+    const updatedSnapshot = { ...snapshot, ...opts };
+    await this.persistWorkflowSnapshot({ workflowName, runId, snapshot: updatedSnapshot });
+    return updatedSnapshot;
   }
   async persistWorkflowSnapshot({
     workflowName,
     runId,
     resourceId,
-    snapshot
+    snapshot,
+    createdAt,
+    updatedAt
   }) {
     try {
       const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
-      const query = table.query().where(`workflow_name = '${workflowName}' AND run_id = '${runId}'`);
+      const query = table.query().where(`workflow_name = '${escapeSql(workflowName)}' AND run_id = '${escapeSql(runId)}'`);
       const records = await query.toArray();
-      let createdAt;
-      const now = Date.now();
+      let createdAtValue;
+      const now = createdAt?.getTime() ?? Date.now();
       if (records.length > 0) {
-        createdAt = records[0].createdAt ?? now;
+        createdAtValue = records[0].createdAt ?? now;
       } else {
-        createdAt = now;
+        createdAtValue = now;
       }
       const { status, value, ...rest } = snapshot;
       const record = {
@@ -1560,14 +1713,14 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
         resourceId,
         snapshot: JSON.stringify({ status, value, ...rest }),
         // this is to ensure status is always just before value, for when querying the db by status
-        createdAt,
-        updatedAt: now
+        createdAt: createdAtValue,
+        updatedAt: updatedAt ?? now
       };
       await table.mergeInsert(["workflow_name", "run_id"]).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([record]);
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_PERSIST_WORKFLOW_SNAPSHOT_FAILED",
+          id: createStorageErrorId("LANCE", "PERSIST_WORKFLOW_SNAPSHOT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { workflowName, runId }
@@ -1582,13 +1735,13 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
   }) {
     try {
       const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
-      const query = table.query().where(`workflow_name = '${workflowName}' AND run_id = '${runId}'`);
+      const query = table.query().where(`workflow_name = '${escapeSql(workflowName)}' AND run_id = '${escapeSql(runId)}'`);
       const records = await query.toArray();
       return records.length > 0 ? JSON.parse(records[0].snapshot) : null;
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_LOAD_WORKFLOW_SNAPSHOT_FAILED",
+          id: createStorageErrorId("LANCE", "LOAD_WORKFLOW_SNAPSHOT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { workflowName, runId }
@@ -1600,19 +1753,19 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
   async getWorkflowRunById(args) {
     try {
       const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
-      let whereClause = `run_id = '${args.runId}'`;
+      let whereClause = `run_id = '${escapeSql(args.runId)}'`;
       if (args.workflowName) {
-        whereClause += ` AND workflow_name = '${args.workflowName}'`;
+        whereClause += ` AND workflow_name = '${escapeSql(args.workflowName)}'`;
       }
       const query = table.query().where(whereClause);
       const records = await query.toArray();
       if (records.length === 0) return null;
       const record = records[0];
-      return parseWorkflowRun(record);
+      return this.parseWorkflowRun(record);
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_GET_WORKFLOW_RUN_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "GET_WORKFLOW_RUN_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { runId: args.runId, workflowName: args.workflowName ?? "" }
@@ -1621,336 +1774,182 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
       );
     }
   }
+  async deleteWorkflowRunById({ runId, workflowName }) {
+    try {
+      const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
+      const whereClause = `run_id = '${escapeSql(runId)}' AND workflow_name = '${escapeSql(workflowName)}'`;
+      await table.delete(whereClause);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "DELETE_WORKFLOW_RUN_BY_ID", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { runId, workflowName }
+        },
+        error
+      );
+    }
+  }
   async listWorkflowRuns(args) {
     try {
       const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
       let query = table.query();
       const conditions = [];
       if (args?.workflowName) {
-        conditions.push(`workflow_name = '${args.workflowName.replace(/'/g, "''")}'`);
+        conditions.push(`workflow_name = '${escapeSql(args.workflowName)}'`);
       }
       if (args?.status) {
         const escapedStatus = args.status.replace(/\\/g, "\\\\").replace(/'/g, "''").replace(/%/g, "\\%").replace(/_/g, "\\_");
         conditions.push(`\`snapshot\` LIKE '%"status":"${escapedStatus}","value"%'`);
       }
       if (args?.resourceId) {
-        conditions.push(`\`resourceId\` = '${args.resourceId}'`);
+        conditions.push(`\`resourceId\` = '${escapeSql(args.resourceId)}'`);
       }
       if (args?.fromDate instanceof Date) {
         conditions.push(`\`createdAt\` >= ${args.fromDate.getTime()}`);
       }
       if (args?.toDate instanceof Date) {
-        conditions.push(`\`createdAt\` <= ${args.toDate.getTime()}`);
-      }
-      let total = 0;
-      if (conditions.length > 0) {
-        query = query.where(conditions.join(" AND "));
-        total = await table.countRows(conditions.join(" AND "));
-      } else {
-        total = await table.countRows();
-      }
-      if (args?.perPage !== void 0 && args?.page !== void 0) {
-        const normalizedPerPage = normalizePerPage(args.perPage, Number.MAX_SAFE_INTEGER);
-        if (args.page < 0 || !Number.isInteger(args.page)) {
-          throw new MastraError(
-            {
-              id: "LANCE_STORE_INVALID_PAGINATION_PARAMS",
-              domain: ErrorDomain.STORAGE,
-              category: ErrorCategory.USER,
-              details: { page: args.page, perPage: args.perPage }
-            },
-            new Error(`Invalid pagination parameters: page=${args.page}, perPage=${args.perPage}`)
-          );
-        }
-        const offset = args.page * normalizedPerPage;
-        query.limit(normalizedPerPage);
-        query.offset(offset);
-      }
-      const records = await query.toArray();
-      return {
-        runs: records.map((record) => parseWorkflowRun(record)),
-        total: total || records.length
-      };
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: "LANCE_STORE_LIST_WORKFLOW_RUNS_FAILED",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { resourceId: args?.resourceId ?? "", workflowName: args?.workflowName ?? "" }
-        },
-        error
-      );
-    }
-  }
-};
-
-// src/storage/index.ts
-var LanceStorage = class _LanceStorage extends MastraStorage {
-  stores;
-  lanceClient;
-  /**
-   * Creates a new instance of LanceStorage
-   * @param id The unique identifier for this storage instance
-   * @param name The name for this storage instance
-   * @param uri The URI to connect to LanceDB
-   * @param options connection options
-   *
-   * Usage:
-   *
-   * Connect to a local database
-   * ```ts
-   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', '/path/to/db');
-   * ```
-   *
-   * Connect to a LanceDB cloud database
-   * ```ts
-   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', 'db://host:port');
-   * ```
-   *
-   * Connect to a cloud database
-   * ```ts
-   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', 's3://bucket/db', { storageOptions: { timeout: '60s' } });
-   * ```
-   */
-  static async create(id, name, uri, options) {
-    const instance = new _LanceStorage(id, name);
-    try {
-      instance.lanceClient = await connect(uri, options);
-      const operations = new StoreOperationsLance({ client: instance.lanceClient });
-      instance.stores = {
-        operations: new StoreOperationsLance({ client: instance.lanceClient }),
-        workflows: new StoreWorkflowsLance({ client: instance.lanceClient }),
-        scores: new StoreScoresLance({ client: instance.lanceClient }),
-        memory: new StoreMemoryLance({ client: instance.lanceClient, operations })
-      };
-      return instance;
-    } catch (e) {
-      throw new MastraError(
-        {
-          id: "STORAGE_LANCE_STORAGE_CONNECT_FAILED",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          text: `Failed to connect to LanceDB: ${e.message || e}`,
-          details: { uri, optionsProvided: !!options }
-        },
-        e
-      );
-    }
-  }
-  /**
-   * @internal
-   * Private constructor to enforce using the create factory method
-   */
-  constructor(id, name) {
-    super({ id, name });
-    const operations = new StoreOperationsLance({ client: this.lanceClient });
-    this.stores = {
-      operations: new StoreOperationsLance({ client: this.lanceClient }),
-      workflows: new StoreWorkflowsLance({ client: this.lanceClient }),
-      scores: new StoreScoresLance({ client: this.lanceClient }),
-      memory: new StoreMemoryLance({ client: this.lanceClient, operations })
-    };
-  }
-  async createTable({
-    tableName,
-    schema
-  }) {
-    return this.stores.operations.createTable({ tableName, schema });
-  }
-  async dropTable({ tableName }) {
-    return this.stores.operations.dropTable({ tableName });
-  }
-  async alterTable({
-    tableName,
-    schema,
-    ifNotExists
-  }) {
-    return this.stores.operations.alterTable({ tableName, schema, ifNotExists });
-  }
-  async clearTable({ tableName }) {
-    return this.stores.operations.clearTable({ tableName });
-  }
-  async insert({ tableName, record }) {
-    return this.stores.operations.insert({ tableName, record });
-  }
-  async batchInsert({ tableName, records }) {
-    return this.stores.operations.batchInsert({ tableName, records });
-  }
-  async load({ tableName, keys }) {
-    return this.stores.operations.load({ tableName, keys });
-  }
-  async getThreadById({ threadId }) {
-    return this.stores.memory.getThreadById({ threadId });
-  }
-  /**
-   * Saves a thread to the database. This function doesn't overwrite existing threads.
-   * @param thread - The thread to save
-   * @returns The saved thread
-   */
-  async saveThread({ thread }) {
-    return this.stores.memory.saveThread({ thread });
-  }
-  async updateThread({
-    id,
-    title,
-    metadata
-  }) {
-    return this.stores.memory.updateThread({ id, title, metadata });
-  }
-  async deleteThread({ threadId }) {
-    return this.stores.memory.deleteThread({ threadId });
-  }
-  get supports() {
-    return {
-      selectByIncludeResourceScope: true,
-      resourceWorkingMemory: true,
-      hasColumn: true,
-      createTable: true,
-      deleteMessages: false,
-      listScoresBySpan: true
-    };
-  }
-  async getResourceById({ resourceId }) {
-    return this.stores.memory.getResourceById({ resourceId });
-  }
-  async saveResource({ resource }) {
-    return this.stores.memory.saveResource({ resource });
-  }
-  async updateResource({
-    resourceId,
-    workingMemory,
-    metadata
-  }) {
-    return this.stores.memory.updateResource({ resourceId, workingMemory, metadata });
-  }
-  /**
-   * Processes messages to include context messages based on withPreviousMessages and withNextMessages
-   * @param records - The sorted array of records to process
-   * @param include - The array of include specifications with context parameters
-   * @returns The processed array with context messages included
-   */
-  processMessagesWithContext(records, include) {
-    const messagesWithContext = include.filter((item) => item.withPreviousMessages || item.withNextMessages);
-    if (messagesWithContext.length === 0) {
-      return records;
-    }
-    const messageIndexMap = /* @__PURE__ */ new Map();
-    records.forEach((message, index) => {
-      messageIndexMap.set(message.id, index);
-    });
-    const additionalIndices = /* @__PURE__ */ new Set();
-    for (const item of messagesWithContext) {
-      const messageIndex = messageIndexMap.get(item.id);
-      if (messageIndex !== void 0) {
-        if (item.withPreviousMessages) {
-          const startIdx = Math.max(0, messageIndex - item.withPreviousMessages);
-          for (let i = startIdx; i < messageIndex; i++) {
-            additionalIndices.add(i);
-          }
-        }
-        if (item.withNextMessages) {
-          const endIdx = Math.min(records.length - 1, messageIndex + item.withNextMessages);
-          for (let i = messageIndex + 1; i <= endIdx; i++) {
-            additionalIndices.add(i);
-          }
-        }
-      }
-    }
-    if (additionalIndices.size === 0) {
-      return records;
-    }
-    const originalMatchIds = new Set(include.map((item) => item.id));
-    const allIndices = /* @__PURE__ */ new Set();
-    records.forEach((record, index) => {
-      if (originalMatchIds.has(record.id)) {
-        allIndices.add(index);
-      }
-    });
-    additionalIndices.forEach((index) => {
-      allIndices.add(index);
-    });
-    return Array.from(allIndices).sort((a, b) => a - b).map((index) => records[index]);
-  }
-  async listMessagesById({ messageIds }) {
-    return this.stores.memory.listMessagesById({ messageIds });
-  }
-  async saveMessages(args) {
-    return this.stores.memory.saveMessages(args);
-  }
-  async updateMessages(_args) {
-    return this.stores.memory.updateMessages(_args);
-  }
-  async listWorkflowRuns(args) {
-    return this.stores.workflows.listWorkflowRuns(args);
-  }
-  async getWorkflowRunById(args) {
-    return this.stores.workflows.getWorkflowRunById(args);
-  }
-  async updateWorkflowResults({
-    workflowName,
-    runId,
-    stepId,
-    result,
-    requestContext
-  }) {
-    return this.stores.workflows.updateWorkflowResults({ workflowName, runId, stepId, result, requestContext });
-  }
-  async updateWorkflowState({
-    workflowName,
-    runId,
-    opts
-  }) {
-    return this.stores.workflows.updateWorkflowState({ workflowName, runId, opts });
-  }
-  async persistWorkflowSnapshot({
-    workflowName,
-    runId,
-    resourceId,
-    snapshot
-  }) {
-    return this.stores.workflows.persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot });
-  }
-  async loadWorkflowSnapshot({
-    workflowName,
-    runId
-  }) {
-    return this.stores.workflows.loadWorkflowSnapshot({ workflowName, runId });
-  }
-  async getScoreById({ id: _id }) {
-    return this.stores.scores.getScoreById({ id: _id });
-  }
-  async listScoresByScorerId({
-    scorerId,
-    source,
-    entityId,
-    entityType,
-    pagination
-  }) {
-    return this.stores.scores.listScoresByScorerId({ scorerId, source, pagination, entityId, entityType });
-  }
-  async saveScore(_score) {
-    return this.stores.scores.saveScore(_score);
+        conditions.push(`\`createdAt\` <= ${args.toDate.getTime()}`);
+      }
+      let total = 0;
+      if (conditions.length > 0) {
+        query = query.where(conditions.join(" AND "));
+        total = await table.countRows(conditions.join(" AND "));
+      } else {
+        total = await table.countRows();
+      }
+      if (args?.perPage !== void 0 && args?.page !== void 0) {
+        const normalizedPerPage = normalizePerPage(args.perPage, Number.MAX_SAFE_INTEGER);
+        if (args.page < 0 || !Number.isInteger(args.page)) {
+          throw new MastraError(
+            {
+              id: createStorageErrorId("LANCE", "LIST_WORKFLOW_RUNS", "INVALID_PAGINATION"),
+              domain: ErrorDomain.STORAGE,
+              category: ErrorCategory.USER,
+              details: { page: args.page, perPage: args.perPage }
+            },
+            new Error(`Invalid pagination parameters: page=${args.page}, perPage=${args.perPage}`)
+          );
+        }
+        const offset = args.page * normalizedPerPage;
+        query.limit(normalizedPerPage);
+        query.offset(offset);
+      }
+      const records = await query.toArray();
+      return {
+        runs: records.map((record) => this.parseWorkflowRun(record)),
+        total: total || records.length
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "LIST_WORKFLOW_RUNS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { resourceId: args?.resourceId ?? "", workflowName: args?.workflowName ?? "" }
+        },
+        error
+      );
+    }
   }
-  async listScoresByRunId({
-    runId,
-    pagination
-  }) {
-    return this.stores.scores.listScoresByRunId({ runId, pagination });
+};
+
+// src/storage/index.ts
+var LanceStorage = class _LanceStorage extends MastraStorage {
+  stores;
+  lanceClient;
+  /**
+   * Creates a new instance of LanceStorage
+   * @param id The unique identifier for this storage instance
+   * @param name The name for this storage instance
+   * @param uri The URI to connect to LanceDB
+   * @param connectionOptions connection options for LanceDB
+   * @param storageOptions storage options including disableInit
+   *
+   * Usage:
+   *
+   * Connect to a local database
+   * ```ts
+   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', '/path/to/db');
+   * ```
+   *
+   * Connect to a LanceDB cloud database
+   * ```ts
+   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', 'db://host:port');
+   * ```
+   *
+   * Connect to a cloud database
+   * ```ts
+   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', 's3://bucket/db', { storageOptions: { timeout: '60s' } });
+   * ```
+   *
+   * Disable auto-init for runtime (after CI/CD has run migrations)
+   * ```ts
+   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', '/path/to/db', undefined, { disableInit: true });
+   * ```
+   */
+  static async create(id, name, uri, connectionOptions, storageOptions) {
+    const instance = new _LanceStorage(id, name, storageOptions?.disableInit);
+    try {
+      instance.lanceClient = await connect(uri, connectionOptions);
+      instance.stores = {
+        workflows: new StoreWorkflowsLance({ client: instance.lanceClient }),
+        scores: new StoreScoresLance({ client: instance.lanceClient }),
+        memory: new StoreMemoryLance({ client: instance.lanceClient })
+      };
+      return instance;
+    } catch (e) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LANCE", "CONNECT", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          text: `Failed to connect to LanceDB: ${e.message || e}`,
+          details: { uri, optionsProvided: !!connectionOptions }
+        },
+        e
+      );
+    }
   }
-  async listScoresByEntityId({
-    entityId,
-    entityType,
-    pagination
-  }) {
-    return this.stores.scores.listScoresByEntityId({ entityId, entityType, pagination });
+  /**
+   * Creates a new instance of LanceStorage from a pre-configured LanceDB connection.
+   * Use this when you need to configure the connection before initialization.
+   *
+   * @param id The unique identifier for this storage instance
+   * @param name The name for this storage instance
+   * @param client Pre-configured LanceDB connection
+   * @param options Storage options including disableInit
+   *
+   * @example
+   * ```typescript
+   * import { connect } from '@lancedb/lancedb';
+   *
+   * const client = await connect('/path/to/db', {
+   *   // Custom connection options
+   * });
+   *
+   * const store = LanceStorage.fromClient('my-id', 'MyStorage', client);
+   * ```
+   */
+  static fromClient(id, name, client, options) {
+    const instance = new _LanceStorage(id, name, options?.disableInit);
+    instance.lanceClient = client;
+    instance.stores = {
+      workflows: new StoreWorkflowsLance({ client }),
+      scores: new StoreScoresLance({ client }),
+      memory: new StoreMemoryLance({ client })
+    };
+    return instance;
   }
-  async listScoresBySpan({
-    traceId,
-    spanId,
-    pagination
-  }) {
-    return this.stores.scores.listScoresBySpan({ traceId, spanId, pagination });
+  /**
+   * @internal
+   * Private constructor to enforce using the create factory method.
+   * Note: stores is initialized in create() after the lanceClient is connected.
+   */
+  constructor(id, name, disableInit) {
+    super({ id, name, disableInit });
+    this.stores = {};
   }
 };
 var LanceFilterTranslator = class extends BaseFilterTranslator {
@@ -2306,7 +2305,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (e) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CONNECT_FAILED",
+          id: createVectorErrorId("LANCE", "CONNECT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { uri }
@@ -2329,6 +2328,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   }
   async query({
     tableName,
+    indexName,
     queryVector,
     filter,
     includeVector = false,
@@ -2336,12 +2336,13 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     columns = [],
     includeAllColumns = false
   }) {
+    const resolvedTableName = tableName ?? indexName;
     try {
       if (!this.lanceClient) {
         throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
       }
-      if (!tableName) {
-        throw new Error("tableName is required");
+      if (!resolvedTableName) {
+        throw new Error("tableName or indexName is required");
       }
       if (!queryVector) {
         throw new Error("queryVector is required");
@@ -2349,28 +2350,33 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "QUERY", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
-          text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
-          details: { tableName }
+          text: error instanceof Error ? error.message : "Invalid query arguments",
+          details: { tableName: resolvedTableName }
         },
         error
       );
     }
     try {
-      const table = await this.lanceClient.openTable(tableName);
-      const selectColumns = [...columns];
-      if (!selectColumns.includes("id")) {
-        selectColumns.push("id");
+      const tables = await this.lanceClient.tableNames();
+      if (!tables.includes(resolvedTableName)) {
+        this.logger.debug(`Table ${resolvedTableName} does not exist. Returning empty results.`);
+        return [];
       }
+      const table = await this.lanceClient.openTable(resolvedTableName);
       let query = table.search(queryVector);
       if (filter && Object.keys(filter).length > 0) {
         const whereClause = this.filterTranslator(filter);
         this.logger.debug(`Where clause generated: ${whereClause}`);
         query = query.where(whereClause);
       }
-      if (!includeAllColumns && selectColumns.length > 0) {
+      if (!includeAllColumns && columns.length > 0) {
+        const selectColumns = [...columns];
+        if (!selectColumns.includes("id")) {
+          selectColumns.push("id");
+        }
         query = query.select(selectColumns);
       }
       query = query.limit(topK);
@@ -2397,10 +2403,10 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED",
+          id: createVectorErrorId("LANCE", "QUERY", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { tableName, includeVector, columnsCount: columns?.length, includeAllColumns }
+          details: { tableName: resolvedTableName, includeVector, columnsCount: columns?.length, includeAllColumns }
         },
         error
       );
@@ -2435,13 +2441,14 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     const translator = new LanceFilterTranslator();
     return translator.translate(prefixedFilter);
   }
-  async upsert({ tableName, vectors, metadata = [], ids = [] }) {
+  async upsert({ tableName, indexName, vectors, metadata = [], ids = [] }) {
+    const resolvedTableName = tableName ?? indexName;
     try {
       if (!this.lanceClient) {
         throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
       }
-      if (!tableName) {
-        throw new Error("tableName is required");
+      if (!resolvedTableName) {
+        throw new Error("tableName or indexName is required");
       }
       if (!vectors || !Array.isArray(vectors) || vectors.length === 0) {
         throw new Error("vectors array is required and must not be empty");
@@ -2449,21 +2456,24 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "UPSERT", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
-          text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
-          details: { tableName }
+          text: error instanceof Error ? error.message : "Invalid upsert arguments",
+          details: { tableName: resolvedTableName }
         },
         error
       );
     }
     try {
       const tables = await this.lanceClient.tableNames();
-      if (!tables.includes(tableName)) {
-        throw new Error(`Table ${tableName} does not exist`);
+      const tableExists = tables.includes(resolvedTableName);
+      let table = null;
+      if (!tableExists) {
+        this.logger.debug(`Table ${resolvedTableName} does not exist. Creating it with the first upsert data.`);
+      } else {
+        table = await this.lanceClient.openTable(resolvedTableName);
       }
-      const table = await this.lanceClient.openTable(tableName);
       const vectorIds = ids.length === vectors.length ? ids : vectors.map((_, i) => ids[i] || crypto.randomUUID());
       const data = vectors.map((vector, i) => {
         const id = String(vectorIds[i]);
@@ -2480,15 +2490,55 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
         }
         return rowData;
       });
-      await table.add(data, { mode: "overwrite" });
+      if (table !== null) {
+        const rowCount = await table.countRows();
+        const schema = await table.schema();
+        const existingColumns = new Set(schema.fields.map((f) => f.name));
+        const dataColumns = new Set(Object.keys(data[0] || {}));
+        const extraColumns = [...dataColumns].filter((col) => !existingColumns.has(col));
+        const missingSchemaColumns = [...existingColumns].filter((col) => !dataColumns.has(col));
+        const hasSchemaMismatch = extraColumns.length > 0 || missingSchemaColumns.length > 0;
+        if (rowCount === 0 && extraColumns.length > 0) {
+          this.logger.warn(
+            `Table ${resolvedTableName} is empty and data has extra columns ${extraColumns.join(", ")}. Recreating with new schema.`
+          );
+          await this.lanceClient.dropTable(resolvedTableName);
+          await this.lanceClient.createTable(resolvedTableName, data);
+        } else if (hasSchemaMismatch) {
+          if (extraColumns.length > 0) {
+            this.logger.warn(
+              `Table ${resolvedTableName} has ${rowCount} rows. Columns ${extraColumns.join(", ")} will be dropped from upsert.`
+            );
+          }
+          const schemaFieldNames = schema.fields.map((f) => f.name);
+          const normalizedData = data.map((row) => {
+            const normalized = {};
+            for (const col of schemaFieldNames) {
+              normalized[col] = col in row ? row[col] : null;
+            }
+            return normalized;
+          });
+          await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(normalizedData);
+        } else {
+          await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(data);
+        }
+      } else {
+        this.logger.debug(`Creating table ${resolvedTableName} with initial data`);
+        await this.lanceClient.createTable(resolvedTableName, data);
+      }
       return vectorIds;
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED",
+          id: createVectorErrorId("LANCE", "UPSERT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { tableName, vectorCount: vectors.length, metadataCount: metadata.length, idsCount: ids.length }
+          details: {
+            tableName: resolvedTableName,
+            vectorCount: vectors.length,
+            metadataCount: metadata.length,
+            idsCount: ids.length
+          }
         },
         error
       );
@@ -2512,7 +2562,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async createTable(tableName, data, options) {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "CREATE_TABLE", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2527,7 +2577,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED",
+          id: createVectorErrorId("LANCE", "CREATE_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -2539,7 +2589,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async listTables() {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "LIST_TABLES", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2551,7 +2601,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED",
+          id: createVectorErrorId("LANCE", "LIST_TABLES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -2562,7 +2612,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async getTableSchema(tableName) {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "GET_TABLE_SCHEMA", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2575,7 +2625,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED",
+          id: createVectorErrorId("LANCE", "GET_TABLE_SCHEMA", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -2585,7 +2635,17 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
   }
   /**
-   * indexName is actually a column name in a table in lanceDB
+   * Creates a vector index on a table.
+   *
+   * The behavior of `indexName` depends on whether `tableName` is provided:
+   * - With `tableName`: `indexName` is the column to index (advanced use case)
+   * - Without `tableName`: `indexName` becomes the table name, and 'vector' is used as the column (Memory compatibility)
+   *
+   * @param tableName - Optional table name. If not provided, defaults to indexName.
+   * @param indexName - The index/column name, or table name if tableName is not provided.
+   * @param dimension - Vector dimension size.
+   * @param metric - Distance metric: 'cosine', 'euclidean', or 'dotproduct'.
+   * @param indexConfig - Optional index configuration.
    */
   async createIndex({
     tableName,
@@ -2594,13 +2654,12 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     metric = "cosine",
     indexConfig = {}
   }) {
+    const resolvedTableName = tableName ?? indexName;
+    const columnToIndex = tableName ? indexName : "vector";
     try {
       if (!this.lanceClient) {
         throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
       }
-      if (!tableName) {
-        throw new Error("tableName is required");
-      }
       if (!indexName) {
         throw new Error("indexName is required");
       }
@@ -2610,22 +2669,36 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "CREATE_INDEX", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
-          details: { tableName: tableName || "", indexName, dimension, metric }
+          details: { tableName: resolvedTableName, indexName, dimension, metric }
         },
         err
       );
     }
     try {
       const tables = await this.lanceClient.tableNames();
-      if (!tables.includes(tableName)) {
-        throw new Error(
-          `Table ${tableName} does not exist. Please create the table first by calling createTable() method.`
+      let table;
+      if (!tables.includes(resolvedTableName)) {
+        this.logger.debug(
+          `Table ${resolvedTableName} does not exist. Creating empty table with dimension ${dimension}.`
         );
+        const initVector = new Array(dimension).fill(0);
+        table = await this.lanceClient.createTable(resolvedTableName, [{ id: "__init__", vector: initVector }]);
+        try {
+          await table.delete("id = '__init__'");
+        } catch (deleteError) {
+          this.logger.warn(
+            `Failed to delete initialization row from ${resolvedTableName}. Subsequent queries may include '__init__' row.`,
+            deleteError
+          );
+        }
+        this.logger.debug(`Table ${resolvedTableName} created. Index creation deferred until data is available.`);
+        return;
+      } else {
+        table = await this.lanceClient.openTable(resolvedTableName);
       }
-      const table = await this.lanceClient.openTable(tableName);
       let metricType;
       if (metric === "euclidean") {
         metricType = "l2";
@@ -2634,8 +2707,15 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
       } else if (metric === "cosine") {
         metricType = "cosine";
       }
+      const rowCount = await table.countRows();
+      if (rowCount < 256) {
+        this.logger.warn(
+          `Table ${resolvedTableName} has ${rowCount} rows, which is below the 256 row minimum for index creation. Skipping index creation.`
+        );
+        return;
+      }
       if (indexConfig.type === "ivfflat") {
-        await table.createIndex(indexName, {
+        await table.createIndex(columnToIndex, {
           config: Index.ivfPq({
             numPartitions: indexConfig.numPartitions || 128,
             numSubVectors: indexConfig.numSubVectors || 16,
@@ -2644,7 +2724,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
         });
       } else {
         this.logger.debug("Creating HNSW PQ index with config:", indexConfig);
-        await table.createIndex(indexName, {
+        await table.createIndex(columnToIndex, {
           config: Index.hnswPq({
             m: indexConfig?.hnsw?.m || 16,
             efConstruction: indexConfig?.hnsw?.efConstruction || 100,
@@ -2655,10 +2735,10 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED",
+          id: createVectorErrorId("LANCE", "CREATE_INDEX", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { tableName: tableName || "", indexName, dimension }
+          details: { tableName: resolvedTableName, indexName, dimension }
         },
         error
       );
@@ -2667,7 +2747,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async listIndexes() {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "LIST_INDEXES", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2686,7 +2766,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED",
+          id: createVectorErrorId("LANCE", "LIST_INDEXES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -2705,7 +2785,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "DESCRIBE_INDEX", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: { indexName }
@@ -2740,7 +2820,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED",
+          id: createVectorErrorId("LANCE", "DESCRIBE_INDEX", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { indexName }
@@ -2760,7 +2840,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "DELETE_INDEX", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: { indexName }
@@ -2783,7 +2863,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_INDEX", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { indexName }
@@ -2798,7 +2878,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async deleteAllTables() {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_ALL_TABLES", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         details: { methodName: "deleteAllTables" },
@@ -2810,7 +2890,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_ALL_TABLES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { methodName: "deleteAllTables" }
@@ -2822,7 +2902,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async deleteTable(tableName) {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_TABLE", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         details: { tableName },
@@ -2834,7 +2914,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -2843,7 +2923,44 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
       );
     }
   }
-  async updateVector({ indexName, id, update }) {
+  async updateVector(params) {
+    const { indexName, update } = params;
+    if ("id" in params && "filter" in params && params.id && params.filter) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "MUTUALLY_EXCLUSIVE"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "id and filter are mutually exclusive",
+        details: { indexName }
+      });
+    }
+    if (!("id" in params || "filter" in params) || !params.id && !params.filter) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "NO_TARGET"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "Either id or filter must be provided",
+        details: { indexName }
+      });
+    }
+    if ("filter" in params && params.filter && Object.keys(params.filter).length === 0) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "EMPTY_FILTER"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "Cannot update with empty filter",
+        details: { indexName }
+      });
+    }
+    if (!update.vector && !update.metadata) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "NO_PAYLOAD"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "No updates provided",
+        details: { indexName }
+      });
+    }
     try {
       if (!this.lanceClient) {
         throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
@@ -2851,21 +2968,6 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
       if (!indexName) {
         throw new Error("indexName is required");
       }
-      if (!id) {
-        throw new Error("id is required");
-      }
-    } catch (err) {
-      throw new MastraError(
-        {
-          id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_FAILED_INVALID_ARGS",
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          details: { indexName, id }
-        },
-        err
-      );
-    }
-    try {
       const tables = await this.lanceClient.tableNames();
       for (const tableName of tables) {
         this.logger.debug("Checking table:" + tableName);
@@ -2875,39 +2977,66 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
           const hasColumn = schema.fields.some((field) => field.name === indexName);
           if (hasColumn) {
             this.logger.debug(`Found column ${indexName} in table ${tableName}`);
-            const existingRecord = await table.query().where(`id = '${id}'`).select(schema.fields.map((field) => field.name)).limit(1).toArray();
-            if (existingRecord.length === 0) {
-              throw new Error(`Record with id '${id}' not found in table ${tableName}`);
+            let whereClause;
+            if ("id" in params && params.id) {
+              whereClause = `id = '${params.id}'`;
+            } else if ("filter" in params && params.filter) {
+              const translator = new LanceFilterTranslator();
+              const processFilterKeys = (filter) => {
+                const processedFilter = {};
+                Object.entries(filter).forEach(([key, value]) => {
+                  if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+                    Object.entries(value).forEach(([nestedKey, nestedValue]) => {
+                      processedFilter[`metadata_${key}_${nestedKey}`] = nestedValue;
+                    });
+                  } else {
+                    processedFilter[`metadata_${key}`] = value;
+                  }
+                });
+                return processedFilter;
+              };
+              const prefixedFilter = processFilterKeys(params.filter);
+              whereClause = translator.translate(prefixedFilter) || "";
+              if (!whereClause) {
+                throw new Error("Failed to translate filter to SQL");
+              }
+            } else {
+              throw new Error("Either id or filter must be provided");
             }
-            const rowData = {
-              id
-            };
-            Object.entries(existingRecord[0]).forEach(([key, value]) => {
-              if (key !== "id" && key !== "_distance") {
-                if (key === indexName) {
-                  if (!update.vector) {
-                    if (Array.isArray(value)) {
-                      rowData[key] = [...value];
-                    } else if (typeof value === "object" && value !== null) {
-                      rowData[key] = Array.from(value);
+            const existingRecords = await table.query().where(whereClause).select(schema.fields.map((field) => field.name)).toArray();
+            if (existingRecords.length === 0) {
+              this.logger.info(`No records found matching criteria in table ${tableName}`);
+              return;
+            }
+            const updatedRecords = existingRecords.map((record) => {
+              const rowData = {};
+              Object.entries(record).forEach(([key, value]) => {
+                if (key !== "_distance") {
+                  if (key === indexName) {
+                    if (update.vector) {
+                      rowData[key] = update.vector;
                     } else {
-                      rowData[key] = value;
+                      if (Array.isArray(value)) {
+                        rowData[key] = [...value];
+                      } else if (typeof value === "object" && value !== null) {
+                        rowData[key] = Array.from(value);
+                      } else {
+                        rowData[key] = value;
+                      }
                     }
+                  } else {
+                    rowData[key] = value;
                   }
-                } else {
-                  rowData[key] = value;
                 }
+              });
+              if (update.metadata) {
+                Object.entries(update.metadata).forEach(([key, value]) => {
+                  rowData[`metadata_${key}`] = value;
+                });
               }
+              return rowData;
             });
-            if (update.vector) {
-              rowData[indexName] = update.vector;
-            }
-            if (update.metadata) {
-              Object.entries(update.metadata).forEach(([key, value]) => {
-                rowData[`metadata_${key}`] = value;
-              });
-            }
-            await table.add([rowData], { mode: "overwrite" });
+            await table.mergeInsert("id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(updatedRecords);
             return;
           }
         } catch (err) {
@@ -2917,12 +3046,19 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
       }
       throw new Error(`No table found with column/index '${indexName}'`);
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_FAILED",
+          id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { indexName, id, hasVector: !!update.vector, hasMetadata: !!update.metadata }
+          details: {
+            indexName,
+            ..."id" in params && params.id && { id: params.id },
+            ..."filter" in params && params.filter && { filter: JSON.stringify(params.filter) },
+            hasVector: !!update.vector,
+            hasMetadata: !!update.metadata
+          }
         },
         error
       );
@@ -2942,10 +3078,13 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "DELETE_VECTOR", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
-          details: { indexName, id }
+          details: {
+            indexName,
+            ...id && { id }
+          }
         },
         err
       );
@@ -2972,10 +3111,13 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_VECTOR", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { indexName, id }
+          details: {
+            indexName,
+            ...id && { id }
+          }
         },
         error
       );
@@ -3006,8 +3148,111 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     });
     return result;
   }
+  async deleteVectors({ indexName, filter, ids }) {
+    if (ids && filter) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "MUTUALLY_EXCLUSIVE"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "ids and filter are mutually exclusive",
+        details: { indexName }
+      });
+    }
+    if (!ids && !filter) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "NO_TARGET"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "Either filter or ids must be provided",
+        details: { indexName }
+      });
+    }
+    if (ids && ids.length === 0) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "EMPTY_IDS"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "Cannot delete with empty ids array",
+        details: { indexName }
+      });
+    }
+    if (filter && Object.keys(filter).length === 0) {
+      throw new MastraError({
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "EMPTY_FILTER"),
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "Cannot delete with empty filter",
+        details: { indexName }
+      });
+    }
+    try {
+      if (!this.lanceClient) {
+        throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      }
+      if (!indexName) {
+        throw new Error("indexName is required");
+      }
+      const tables = await this.lanceClient.tableNames();
+      for (const tableName of tables) {
+        this.logger.debug("Checking table:" + tableName);
+        const table = await this.lanceClient.openTable(tableName);
+        try {
+          const schema = await table.schema();
+          const hasColumn = schema.fields.some((field) => field.name === indexName);
+          if (hasColumn) {
+            this.logger.debug(`Found column ${indexName} in table ${tableName}`);
+            if (ids) {
+              const idsConditions = ids.map((id) => `id = '${id}'`).join(" OR ");
+              await table.delete(idsConditions);
+            } else if (filter) {
+              const translator = new LanceFilterTranslator();
+              const processFilterKeys = (filter2) => {
+                const processedFilter = {};
+                Object.entries(filter2).forEach(([key, value]) => {
+                  if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+                    Object.entries(value).forEach(([nestedKey, nestedValue]) => {
+                      processedFilter[`metadata_${key}_${nestedKey}`] = nestedValue;
+                    });
+                  } else {
+                    processedFilter[`metadata_${key}`] = value;
+                  }
+                });
+                return processedFilter;
+              };
+              const prefixedFilter = processFilterKeys(filter);
+              const whereClause = translator.translate(prefixedFilter);
+              if (!whereClause) {
+                throw new Error("Failed to translate filter to SQL");
+              }
+              await table.delete(whereClause);
+            }
+            return;
+          }
+        } catch (err) {
+          this.logger.error(`Error checking schema for table ${tableName}:` + err);
+          continue;
+        }
+      }
+      throw new Error(`No table found with column/index '${indexName}'`);
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createVectorErrorId("LANCE", "DELETE_VECTORS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: {
+            indexName,
+            ...filter && { filter: JSON.stringify(filter) },
+            ...ids && { idsCount: ids.length }
+          }
+        },
+        error
+      );
+    }
+  }
 };
 
-export { LanceStorage, LanceVectorStore };
+export { LanceStorage, LanceVectorStore, StoreMemoryLance, StoreScoresLance, StoreWorkflowsLance };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map