@mastra/lance 0.0.0-add-libsql-changeset-20250910154739

package/dist/index.js

@@ -0,0 +1,3300 @@
+import { connect, Index } from '@lancedb/lancedb';
+import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
+import { MastraStorage, StoreOperations, LegacyEvalsStorage, TABLE_EVALS, MemoryStorage, TABLE_THREADS, TABLE_MESSAGES, resolveMessageLimit, TABLE_RESOURCES, ScoresStorage, TABLE_SCORERS, TracesStorage, TABLE_TRACES, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, ensureDate } from '@mastra/core/storage';
+import { MessageList } from '@mastra/core/agent';
+import { Utf8, Float64, Binary, Float32, Int32, Field, Schema } from 'apache-arrow';
+import { MastraVector } from '@mastra/core/vector';
+import { BaseFilterTranslator } from '@mastra/core/vector/filter';
+
+// src/storage/index.ts
+var StoreLegacyEvalsLance = class extends LegacyEvalsStorage {
+  client;
+  constructor({ client }) {
+    super();
+    this.client = client;
+  }
+  async getEvalsByAgentName(agentName, type) {
+    try {
+      const table = await this.client.openTable(TABLE_EVALS);
+      const query = table.query().where(`agent_name = '${agentName}'`);
+      const records = await query.toArray();
+      let filteredRecords = records;
+      if (type === "live") {
+        filteredRecords = records.filter((record) => record.test_info === null);
+      } else if (type === "test") {
+        filteredRecords = records.filter((record) => record.test_info !== null);
+      }
+      return filteredRecords.map((record) => {
+        return {
+          id: record.id,
+          input: record.input,
+          output: record.output,
+          agentName: record.agent_name,
+          metricName: record.metric_name,
+          result: JSON.parse(record.result),
+          instructions: record.instructions,
+          testInfo: record.test_info ? JSON.parse(record.test_info) : null,
+          globalRunId: record.global_run_id,
+          runId: record.run_id,
+          createdAt: new Date(record.created_at).toString()
+        };
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_EVALS_BY_AGENT_NAME_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { agentName }
+        },
+        error
+      );
+    }
+  }
+  async getEvals(options) {
+    try {
+      const table = await this.client.openTable(TABLE_EVALS);
+      const conditions = [];
+      if (options.agentName) {
+        conditions.push(`agent_name = '${options.agentName}'`);
+      }
+      if (options.type === "live") {
+        conditions.push("length(test_info) = 0");
+      } else if (options.type === "test") {
+        conditions.push("length(test_info) > 0");
+      }
+      const startDate = options.dateRange?.start || options.fromDate;
+      const endDate = options.dateRange?.end || options.toDate;
+      if (startDate) {
+        conditions.push(`\`created_at\` >= ${startDate.getTime()}`);
+      }
+      if (endDate) {
+        conditions.push(`\`created_at\` <= ${endDate.getTime()}`);
+      }
+      let total = 0;
+      if (conditions.length > 0) {
+        total = await table.countRows(conditions.join(" AND "));
+      } else {
+        total = await table.countRows();
+      }
+      const query = table.query();
+      if (conditions.length > 0) {
+        const whereClause = conditions.join(" AND ");
+        query.where(whereClause);
+      }
+      const records = await query.toArray();
+      const evals = records.sort((a, b) => b.created_at - a.created_at).map((record) => {
+        return {
+          id: record.id,
+          input: record.input,
+          output: record.output,
+          agentName: record.agent_name,
+          metricName: record.metric_name,
+          result: JSON.parse(record.result),
+          instructions: record.instructions,
+          testInfo: record.test_info ? JSON.parse(record.test_info) : null,
+          globalRunId: record.global_run_id,
+          runId: record.run_id,
+          createdAt: new Date(record.created_at).toISOString()
+        };
+      });
+      const page = options.page || 0;
+      const perPage = options.perPage || 10;
+      const pagedEvals = evals.slice(page * perPage, (page + 1) * perPage);
+      return {
+        evals: pagedEvals,
+        total,
+        page,
+        perPage,
+        hasMore: total > (page + 1) * perPage
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_EVALS_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { agentName: options.agentName ?? "" }
+        },
+        error
+      );
+    }
+  }
+};
+function getPrimaryKeys(tableName) {
+  let primaryId = ["id"];
+  if (tableName === TABLE_WORKFLOW_SNAPSHOT) {
+    primaryId = ["workflow_name", "run_id"];
+  } else if (tableName === TABLE_EVALS) {
+    primaryId = ["agent_name", "metric_name", "run_id"];
+  }
+  return primaryId;
+}
+function validateKeyTypes(keys, tableSchema) {
+  const fieldTypes = new Map(
+    tableSchema.fields.map((field) => [field.name, field.type?.toString().toLowerCase()])
+  );
+  for (const [key, value] of Object.entries(keys)) {
+    const fieldType = fieldTypes.get(key);
+    if (!fieldType) {
+      throw new Error(`Field '${key}' does not exist in table schema`);
+    }
+    if (value !== null) {
+      if ((fieldType.includes("int") || fieldType.includes("bigint")) && typeof value !== "number") {
+        throw new Error(`Expected numeric value for field '${key}', got ${typeof value}`);
+      }
+      if (fieldType.includes("utf8") && typeof value !== "string") {
+        throw new Error(`Expected string value for field '${key}', got ${typeof value}`);
+      }
+      if (fieldType.includes("timestamp") && !(value instanceof Date) && typeof value !== "string") {
+        throw new Error(`Expected Date or string value for field '${key}', got ${typeof value}`);
+      }
+    }
+  }
+}
+function processResultWithTypeConversion(rawResult, tableSchema) {
+  const fieldTypeMap = /* @__PURE__ */ new Map();
+  tableSchema.fields.forEach((field) => {
+    const fieldName = field.name;
+    const fieldTypeStr = field.type.toString().toLowerCase();
+    fieldTypeMap.set(fieldName, fieldTypeStr);
+  });
+  if (Array.isArray(rawResult)) {
+    return rawResult.map((item) => processResultWithTypeConversion(item, tableSchema));
+  }
+  const processedResult = { ...rawResult };
+  for (const key in processedResult) {
+    const fieldTypeStr = fieldTypeMap.get(key);
+    if (!fieldTypeStr) continue;
+    if (typeof processedResult[key] === "string") {
+      if (fieldTypeStr.includes("int32") || fieldTypeStr.includes("float32")) {
+        if (!isNaN(Number(processedResult[key]))) {
+          processedResult[key] = Number(processedResult[key]);
+        }
+      } else if (fieldTypeStr.includes("int64")) {
+        processedResult[key] = Number(processedResult[key]);
+      } else if (fieldTypeStr.includes("utf8") && key !== "id") {
+        try {
+          const parsed = JSON.parse(processedResult[key]);
+          if (typeof parsed === "object") {
+            processedResult[key] = JSON.parse(processedResult[key]);
+          }
+        } catch {
+        }
+      }
+    } else if (typeof processedResult[key] === "bigint") {
+      processedResult[key] = Number(processedResult[key]);
+    } else if (fieldTypeStr.includes("float64") && ["createdAt", "updatedAt"].includes(key)) {
+      processedResult[key] = new Date(processedResult[key]);
+    }
+    console.log(key, "processedResult", processedResult);
+  }
+  return processedResult;
+}
+async function getTableSchema({
+  tableName,
+  client
+}) {
+  try {
+    if (!client) {
+      throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+    }
+    if (!tableName) {
+      throw new Error("tableName is required for getTableSchema.");
+    }
+  } catch (validationError) {
+    throw new MastraError(
+      {
+        id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: validationError.message,
+        details: { tableName }
+      },
+      validationError
+    );
+  }
+  try {
+    const table = await client.openTable(tableName);
+    const rawSchema = await table.schema();
+    const fields = rawSchema.fields;
+    return {
+      fields,
+      metadata: /* @__PURE__ */ new Map(),
+      get names() {
+        return fields.map((field) => field.name);
+      }
+    };
+  } catch (error) {
+    throw new MastraError(
+      {
+        id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_FAILED",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.THIRD_PARTY,
+        details: { tableName }
+      },
+      error
+    );
+  }
+}
+
+// src/storage/domains/memory/index.ts
+var StoreMemoryLance = class extends MemoryStorage {
+  client;
+  operations;
+  constructor({ client, operations }) {
+    super();
+    this.client = client;
+    this.operations = operations;
+  }
+  async getThreadById({ threadId }) {
+    try {
+      const thread = await this.operations.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: "LANCE_STORE_GET_THREAD_BY_ID_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getThreadsByResourceId({ resourceId }) {
+    try {
+      const table = await this.client.openTable(TABLE_THREADS);
+      const query = table.query().where(`\`resourceId\` = '${resourceId}'`);
+      const records = await query.toArray();
+      return processResultWithTypeConversion(
+        records,
+        await getTableSchema({ tableName: TABLE_THREADS, client: this.client })
+      );
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_THREADS_BY_RESOURCE_ID_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        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;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_SAVE_THREAD_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        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 }) {
+    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) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_DELETE_THREAD_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  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 getMessages({
+    threadId,
+    resourceId,
+    selectBy,
+    format,
+    threadConfig
+  }) {
+    try {
+      if (!threadId.trim()) throw new Error("threadId must be a non-empty string");
+      if (threadConfig) {
+        throw new Error("ThreadConfig is not supported by LanceDB storage");
+      }
+      const limit = resolveMessageLimit({ last: selectBy?.last, defaultLimit: Number.MAX_SAFE_INTEGER });
+      const table = await this.client.openTable(TABLE_MESSAGES);
+      let allRecords = [];
+      if (selectBy?.include && selectBy.include.length > 0) {
+        const threadIds = [...new Set(selectBy.include.map((item) => item.threadId))];
+        for (const threadId2 of threadIds) {
+          const threadQuery = table.query().where(`thread_id = '${threadId2}'`);
+          let threadRecords = await threadQuery.toArray();
+          allRecords.push(...threadRecords);
+        }
+      } else {
+        let query = table.query().where(`\`thread_id\` = '${threadId}'`);
+        allRecords = await query.toArray();
+      }
+      allRecords.sort((a, b) => {
+        const dateA = new Date(a.createdAt).getTime();
+        const dateB = new Date(b.createdAt).getTime();
+        return dateA - dateB;
+      });
+      if (selectBy?.include && selectBy.include.length > 0) {
+        allRecords = this.processMessagesWithContext(allRecords, selectBy.include);
+      }
+      if (limit !== Number.MAX_SAFE_INTEGER) {
+        allRecords = allRecords.slice(-limit);
+      }
+      const messages = processResultWithTypeConversion(
+        allRecords,
+        await getTableSchema({ tableName: TABLE_MESSAGES, client: this.client })
+      );
+      const list = new MessageList({ threadId, resourceId }).add(messages.map(this.normalizeMessage), "memory");
+      if (format === "v2") return list.get.all.v2();
+      return list.get.all.v1();
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_MESSAGES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: {
+            threadId,
+            resourceId: resourceId ?? ""
+          }
+        },
+        error
+      );
+    }
+  }
+  async getMessagesById({
+    messageIds,
+    format
+  }) {
+    if (messageIds.length === 0) return [];
+    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");
+      if (format === `v1`) return list.get.all.v1();
+      return list.get.all.v2();
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_MESSAGES_BY_ID_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: {
+            messageIds: JSON.stringify(messageIds)
+          }
+        },
+        error
+      );
+    }
+  }
+  async saveMessages(args) {
+    try {
+      const { messages, format = "v1" } = args;
+      if (messages.length === 0) {
+        return [];
+      }
+      const threadId = messages[0]?.threadId;
+      if (!threadId) {
+        throw new Error("Thread ID is required");
+      }
+      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");
+      if (format === `v2`) return list.get.all.v2();
+      return list.get.all.v1();
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_SAVE_MESSAGES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getThreadsByResourceIdPaginated(args) {
+    try {
+      const { resourceId, page = 0, perPage = 10 } = args;
+      const table = await this.client.openTable(TABLE_THREADS);
+      const total = await table.countRows(`\`resourceId\` = '${resourceId}'`);
+      const query = table.query().where(`\`resourceId\` = '${resourceId}'`);
+      const offset = page * perPage;
+      query.limit(perPage);
+      if (offset > 0) {
+        query.offset(offset);
+      }
+      const records = await query.toArray();
+      records.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+      const schema = await getTableSchema({ tableName: TABLE_THREADS, client: this.client });
+      const threads = records.map((record) => processResultWithTypeConversion(record, schema));
+      return {
+        threads,
+        total,
+        page,
+        perPage,
+        hasMore: total > (page + 1) * perPage
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_THREADS_BY_RESOURCE_ID_PAGINATED_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        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);
+          }
+        }
+      }
+    }
+    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 getMessagesPaginated(args) {
+    const { threadId, resourceId, selectBy, format = "v1" } = args;
+    const page = selectBy?.pagination?.page ?? 0;
+    const perPage = selectBy?.pagination?.perPage ?? 10;
+    try {
+      if (!threadId.trim()) throw new Error("threadId must be a non-empty string");
+      const dateRange = selectBy?.pagination?.dateRange;
+      const fromDate = dateRange?.start;
+      const toDate = dateRange?.end;
+      const table = await this.client.openTable(TABLE_MESSAGES);
+      const messages = [];
+      if (selectBy?.include && Array.isArray(selectBy.include)) {
+        const threadIds = [...new Set(selectBy.include.map((item) => item.threadId))];
+        const allThreadMessages = [];
+        for (const threadId2 of threadIds) {
+          const threadQuery = table.query().where(`thread_id = '${threadId2}'`);
+          let threadRecords = await threadQuery.toArray();
+          if (fromDate) threadRecords = threadRecords.filter((m) => m.createdAt >= fromDate.getTime());
+          if (toDate) threadRecords = threadRecords.filter((m) => m.createdAt <= toDate.getTime());
+          allThreadMessages.push(...threadRecords);
+        }
+        allThreadMessages.sort((a, b) => a.createdAt - b.createdAt);
+        const contextMessages = this.processMessagesWithContext(allThreadMessages, selectBy.include);
+        messages.push(...contextMessages);
+      }
+      const conditions = [`thread_id = '${threadId}'`];
+      if (resourceId) {
+        conditions.push(`\`resourceId\` = '${resourceId}'`);
+      }
+      if (fromDate) {
+        conditions.push(`\`createdAt\` >= ${fromDate.getTime()}`);
+      }
+      if (toDate) {
+        conditions.push(`\`createdAt\` <= ${toDate.getTime()}`);
+      }
+      let total = 0;
+      if (conditions.length > 0) {
+        total = await table.countRows(conditions.join(" AND "));
+      } else {
+        total = await table.countRows();
+      }
+      if (total === 0 && messages.length === 0) {
+        return {
+          messages: [],
+          total: 0,
+          page,
+          perPage,
+          hasMore: false
+        };
+      }
+      const excludeIds = messages.map((m) => m.id);
+      let selectedMessages = [];
+      if (selectBy?.last && selectBy.last > 0) {
+        const query = table.query();
+        if (conditions.length > 0) {
+          query.where(conditions.join(" AND "));
+        }
+        let records = await query.toArray();
+        records = records.sort((a, b) => a.createdAt - b.createdAt);
+        if (excludeIds.length > 0) {
+          records = records.filter((m) => !excludeIds.includes(m.id));
+        }
+        selectedMessages = records.slice(-selectBy.last);
+      } else {
+        const query = table.query();
+        if (conditions.length > 0) {
+          query.where(conditions.join(" AND "));
+        }
+        let records = await query.toArray();
+        records = records.sort((a, b) => a.createdAt - b.createdAt);
+        if (excludeIds.length > 0) {
+          records = records.filter((m) => !excludeIds.includes(m.id));
+        }
+        selectedMessages = records.slice(page * perPage, (page + 1) * perPage);
+      }
+      const allMessages = [...messages, ...selectedMessages];
+      const seen = /* @__PURE__ */ new Set();
+      const dedupedMessages = allMessages.filter((m) => {
+        const key = `${m.id}:${m.thread_id}`;
+        if (seen.has(key)) return false;
+        seen.add(key);
+        return true;
+      });
+      const formattedMessages = dedupedMessages.map((msg) => {
+        const { thread_id, ...rest } = msg;
+        return {
+          ...rest,
+          threadId: thread_id,
+          content: typeof msg.content === "string" ? (() => {
+            try {
+              return JSON.parse(msg.content);
+            } catch {
+              return msg.content;
+            }
+          })() : msg.content
+        };
+      });
+      const list = new MessageList().add(formattedMessages, "memory");
+      return {
+        messages: format === "v2" ? list.get.all.v2() : list.get.all.v1(),
+        total,
+        // Total should be the count of messages matching the filters
+        page,
+        perPage,
+        hasMore: total > (page + 1) * perPage
+      };
+    } catch (error) {
+      const mastraError = new MastraError(
+        {
+          id: "LANCE_STORE_GET_MESSAGES_PAGINATED_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: {
+            threadId,
+            resourceId: resourceId ?? ""
+          }
+        },
+        error
+      );
+      this.logger?.trackException?.(mastraError);
+      this.logger?.error?.(mastraError.toString());
+      return { messages: [], total: 0, page, perPage, hasMore: false };
+    }
+  }
+  /**
+   * Parse message data from LanceDB record format to MastraMessageV2 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 {
+      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;
+          }
+          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;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_UPDATE_MESSAGES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { count: messages.length }
+        },
+        error
+      );
+    }
+  }
+  async getResourceById({ resourceId }) {
+    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();
+      }
+      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 {
+        ...resource,
+        createdAt,
+        updatedAt,
+        workingMemory,
+        metadata
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_RESOURCE_BY_ID_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  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;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_SAVE_RESOURCE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          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: "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 {
+  client;
+  constructor({ client }) {
+    super();
+    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);
+    });
+    return new Schema(fields);
+  }
+  async createTable({
+    tableName,
+    schema
+  }) {
+    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.");
+      }
+      if (!schema) {
+        throw new Error("schema is required for createTable.");
+      }
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { tableName }
+        },
+        error
+      );
+    }
+    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;
+      }
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  async dropTable({ tableName }) {
+    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) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
+    try {
+      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: "STORAGE_LANCE_STORAGE_DROP_TABLE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  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_STORAGE_ALTER_TABLE_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
+    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];
+        return {
+          name: col,
+          valueSql: colDef?.nullable ? `cast(NULL as ${typeMap[colDef.type ?? "text"]})` : `cast(${this.getDefaultValue(colDef?.type ?? "text")} as ${typeMap[colDef?.type ?? "text"]})`
+        };
+      });
+      if (columnsToAdd.length > 0) {
+        await table.addColumns(columnsToAdd);
+        this.logger?.info?.(`Added columns [${columnsToAdd.map((c) => c.name).join(", ")}] to table ${tableName}`);
+      }
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  async clearTable({ tableName }) {
+    try {
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      }
+      if (!tableName) {
+        throw new Error("tableName is required for clearTable.");
+      }
+    } catch (validationError) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_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: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        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.");
+      }
+      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: "STORAGE_LANCE_STORAGE_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 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]);
+        }
+      }
+      console.log(await table.schema());
+      await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([processedRecord]);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_INSERT_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  async batchInsert({ tableName, records }) {
+    try {
+      if (!this.client) {
+        throw new Error("LanceDB client not initialized. Call LanceStorage.create() first.");
+      }
+      if (!tableName) {
+        throw new Error("tableName is required for batchInsert.");
+      }
+      if (!records || records.length === 0) {
+        throw new Error("records array is required and cannot be empty for batchInsert.");
+      }
+    } 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]);
+          }
+        }
+        return processedRecord;
+      });
+      console.log(processedRecords);
+      await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute(processedRecords);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        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
+      );
+    }
+    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);
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_LOAD_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName, keyCount: Object.keys(keys).length, firstKey: Object.keys(keys)[0] ?? "" }
+        },
+        error
+      );
+    }
+  }
+};
+var StoreScoresLance = class extends ScoresStorage {
+  client;
+  constructor({ client }) {
+    super();
+    this.client = client;
+  }
+  async saveScore(score) {
+    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(score).forEach((key) => {
+        if (allowedFields.has(key)) {
+          filteredScore[key] = score[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;
+      await table.add([filteredScore], { mode: "append" });
+      return { score };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORAGE_SAVE_SCORE_FAILED",
+          text: "Failed to save score in LanceStorage",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { error: error?.message }
+        },
+        error
+      );
+    }
+  }
+  async getScoreById({ id }) {
+    try {
+      const table = await this.client.openTable(TABLE_SCORERS);
+      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);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORAGE_GET_SCORE_BY_ID_FAILED",
+          text: "Failed to get score by id in LanceStorage",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { error: error?.message }
+        },
+        error
+      );
+    }
+  }
+  async getScoresByScorerId({
+    scorerId,
+    pagination,
+    entityId,
+    entityType,
+    source
+  }) {
+    try {
+      const table = await this.client.openTable(TABLE_SCORERS);
+      const { page = 0, perPage = 10 } = pagination || {};
+      const offset = page * perPage;
+      let query = table.query().where(`\`scorerId\` = '${scorerId}'`);
+      if (source) {
+        query = query.where(`\`source\` = '${source}'`);
+      }
+      if (entityId) {
+        query = query.where(`\`entityId\` = '${entityId}'`);
+      }
+      if (entityType) {
+        query = query.where(`\`entityType\` = '${entityType}'`);
+      }
+      query = query.limit(perPage);
+      if (offset > 0) query.offset(offset);
+      const records = await query.toArray();
+      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
+      const scores = processResultWithTypeConversion(records, schema);
+      let totalQuery = table.query().where(`\`scorerId\` = '${scorerId}'`);
+      if (source) {
+        totalQuery = totalQuery.where(`\`source\` = '${source}'`);
+      }
+      const allRecords = await totalQuery.toArray();
+      const total = allRecords.length;
+      return {
+        pagination: {
+          page,
+          perPage,
+          total,
+          hasMore: offset + scores.length < total
+        },
+        scores
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORAGE_GET_SCORES_BY_SCORER_ID_FAILED",
+          text: "Failed to get scores by scorerId in LanceStorage",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { error: error?.message }
+        },
+        error
+      );
+    }
+  }
+  async getScoresByRunId({
+    runId,
+    pagination
+  }) {
+    try {
+      const table = await this.client.openTable(TABLE_SCORERS);
+      const { page = 0, perPage = 10 } = pagination || {};
+      const offset = page * perPage;
+      const query = table.query().where(`\`runId\` = '${runId}'`).limit(perPage);
+      if (offset > 0) query.offset(offset);
+      const records = await query.toArray();
+      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
+      const scores = processResultWithTypeConversion(records, schema);
+      const allRecords = await table.query().where(`\`runId\` = '${runId}'`).toArray();
+      const total = allRecords.length;
+      return {
+        pagination: {
+          page,
+          perPage,
+          total,
+          hasMore: offset + scores.length < total
+        },
+        scores
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORAGE_GET_SCORES_BY_RUN_ID_FAILED",
+          text: "Failed to get scores by runId in LanceStorage",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { error: error?.message }
+        },
+        error
+      );
+    }
+  }
+  async getScoresByEntityId({
+    entityId,
+    entityType,
+    pagination
+  }) {
+    try {
+      const table = await this.client.openTable(TABLE_SCORERS);
+      const { page = 0, perPage = 10 } = pagination || {};
+      const offset = page * perPage;
+      const query = table.query().where(`\`entityId\` = '${entityId}' AND \`entityType\` = '${entityType}'`).limit(perPage);
+      if (offset > 0) query.offset(offset);
+      const records = await query.toArray();
+      const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
+      const scores = processResultWithTypeConversion(records, schema);
+      const allRecords = await table.query().where(`\`entityId\` = '${entityId}' AND \`entityType\` = '${entityType}'`).toArray();
+      const total = allRecords.length;
+      return {
+        pagination: {
+          page,
+          perPage,
+          total,
+          hasMore: offset + scores.length < total
+        },
+        scores
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORAGE_GET_SCORES_BY_ENTITY_ID_FAILED",
+          text: "Failed to get scores by entityId and entityType in LanceStorage",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { error: error?.message }
+        },
+        error
+      );
+    }
+  }
+};
+var StoreTracesLance = class extends TracesStorage {
+  client;
+  operations;
+  constructor({ client, operations }) {
+    super();
+    this.client = client;
+    this.operations = operations;
+  }
+  async saveTrace({ trace }) {
+    try {
+      const table = await this.client.openTable(TABLE_TRACES);
+      const record = {
+        ...trace,
+        attributes: JSON.stringify(trace.attributes),
+        status: JSON.stringify(trace.status),
+        events: JSON.stringify(trace.events),
+        links: JSON.stringify(trace.links),
+        other: JSON.stringify(trace.other)
+      };
+      await table.add([record], { mode: "append" });
+      return trace;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_SAVE_TRACE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getTraceById({ traceId }) {
+    try {
+      const table = await this.client.openTable(TABLE_TRACES);
+      const query = table.query().where(`id = '${traceId}'`);
+      const records = await query.toArray();
+      return records[0];
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_TRACE_BY_ID_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getTraces({
+    name,
+    scope,
+    page = 1,
+    perPage = 10,
+    attributes
+  }) {
+    try {
+      const table = await this.client.openTable(TABLE_TRACES);
+      const query = table.query();
+      if (name) {
+        query.where(`name = '${name}'`);
+      }
+      if (scope) {
+        query.where(`scope = '${scope}'`);
+      }
+      if (attributes) {
+        query.where(`attributes = '${JSON.stringify(attributes)}'`);
+      }
+      const offset = (page - 1) * perPage;
+      query.limit(perPage);
+      if (offset > 0) {
+        query.offset(offset);
+      }
+      const records = await query.toArray();
+      return records.map((record) => {
+        const processed = {
+          ...record,
+          attributes: record.attributes ? JSON.parse(record.attributes) : {},
+          status: record.status ? JSON.parse(record.status) : {},
+          events: record.events ? JSON.parse(record.events) : [],
+          links: record.links ? JSON.parse(record.links) : [],
+          other: record.other ? JSON.parse(record.other) : {},
+          startTime: new Date(record.startTime),
+          endTime: new Date(record.endTime),
+          createdAt: new Date(record.createdAt)
+        };
+        if (processed.parentSpanId === null || processed.parentSpanId === void 0) {
+          processed.parentSpanId = "";
+        } else {
+          processed.parentSpanId = String(processed.parentSpanId);
+        }
+        return processed;
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_TRACES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { name: name ?? "", scope: scope ?? "" }
+        },
+        error
+      );
+    }
+  }
+  async getTracesPaginated(args) {
+    try {
+      const table = await this.client.openTable(TABLE_TRACES);
+      const query = table.query();
+      const conditions = [];
+      if (args.name) {
+        conditions.push(`name = '${args.name}'`);
+      }
+      if (args.scope) {
+        conditions.push(`scope = '${args.scope}'`);
+      }
+      if (args.attributes) {
+        const attributesStr = JSON.stringify(args.attributes);
+        conditions.push(`attributes LIKE '%${attributesStr.replace(/"/g, '\\"')}%'`);
+      }
+      if (args.dateRange?.start) {
+        conditions.push(`\`createdAt\` >= ${args.dateRange.start.getTime()}`);
+      }
+      if (args.dateRange?.end) {
+        conditions.push(`\`createdAt\` <= ${args.dateRange.end.getTime()}`);
+      }
+      if (conditions.length > 0) {
+        const whereClause = conditions.join(" AND ");
+        query.where(whereClause);
+      }
+      let total = 0;
+      if (conditions.length > 0) {
+        const countQuery = table.query().where(conditions.join(" AND "));
+        const allRecords = await countQuery.toArray();
+        total = allRecords.length;
+      } else {
+        total = await table.countRows();
+      }
+      const page = args.page || 0;
+      const perPage = args.perPage || 10;
+      const offset = page * perPage;
+      query.limit(perPage);
+      if (offset > 0) {
+        query.offset(offset);
+      }
+      const records = await query.toArray();
+      const traces = records.map((record) => {
+        const processed = {
+          ...record,
+          attributes: record.attributes ? JSON.parse(record.attributes) : {},
+          status: record.status ? JSON.parse(record.status) : {},
+          events: record.events ? JSON.parse(record.events) : [],
+          links: record.links ? JSON.parse(record.links) : [],
+          other: record.other ? JSON.parse(record.other) : {},
+          startTime: new Date(record.startTime),
+          endTime: new Date(record.endTime),
+          createdAt: new Date(record.createdAt)
+        };
+        if (processed.parentSpanId === null || processed.parentSpanId === void 0) {
+          processed.parentSpanId = "";
+        } else {
+          processed.parentSpanId = String(processed.parentSpanId);
+        }
+        return processed;
+      });
+      return {
+        traces,
+        total,
+        page,
+        perPage,
+        hasMore: total > (page + 1) * perPage
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_TRACES_PAGINATED_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { name: args.name ?? "", scope: args.scope ?? "" }
+        },
+        error
+      );
+    }
+  }
+  async batchTraceInsert({ records }) {
+    this.logger.debug("Batch inserting traces", { count: records.length });
+    await this.operations.batchInsert({
+      tableName: TABLE_TRACES,
+      records
+    });
+  }
+};
+function parseWorkflowRun(row) {
+  let parsedSnapshot = row.snapshot;
+  if (typeof parsedSnapshot === "string") {
+    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
+  };
+}
+var StoreWorkflowsLance = class extends WorkflowsStorage {
+  client;
+  constructor({ client }) {
+    super();
+    this.client = client;
+  }
+  updateWorkflowResults({
+    // workflowName,
+    // runId,
+    // stepId,
+    // result,
+    // runtimeContext,
+  }) {
+    throw new Error("Method not implemented.");
+  }
+  updateWorkflowState({
+    // workflowName,
+    // runId,
+    // opts,
+  }) {
+    throw new Error("Method not implemented.");
+  }
+  async persistWorkflowSnapshot({
+    workflowName,
+    runId,
+    snapshot
+  }) {
+    try {
+      const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
+      const query = table.query().where(`workflow_name = '${workflowName}' AND run_id = '${runId}'`);
+      const records = await query.toArray();
+      let createdAt;
+      const now = Date.now();
+      if (records.length > 0) {
+        createdAt = records[0].createdAt ?? now;
+      } else {
+        createdAt = now;
+      }
+      const record = {
+        workflow_name: workflowName,
+        run_id: runId,
+        snapshot: JSON.stringify(snapshot),
+        createdAt,
+        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",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { workflowName, runId }
+        },
+        error
+      );
+    }
+  }
+  async loadWorkflowSnapshot({
+    workflowName,
+    runId
+  }) {
+    try {
+      const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
+      const query = table.query().where(`workflow_name = '${workflowName}' AND run_id = '${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",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { workflowName, runId }
+        },
+        error
+      );
+    }
+  }
+  async getWorkflowRunById(args) {
+    try {
+      const table = await this.client.openTable(TABLE_WORKFLOW_SNAPSHOT);
+      let whereClause = `run_id = '${args.runId}'`;
+      if (args.workflowName) {
+        whereClause += ` AND workflow_name = '${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);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "LANCE_STORE_GET_WORKFLOW_RUN_BY_ID_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { runId: args.runId, workflowName: args.workflowName ?? "" }
+        },
+        error
+      );
+    }
+  }
+  async getWorkflowRuns(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, "''")}'`);
+      }
+      if (args?.resourceId) {
+        conditions.push(`\`resourceId\` = '${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?.limit) {
+        query.limit(args.limit);
+      }
+      if (args?.offset) {
+        query.offset(args.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_GET_WORKFLOW_RUNS_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { namespace: args?.namespace ?? "", workflowName: args?.workflowName ?? "" }
+        },
+        error
+      );
+    }
+  }
+};
+
+// src/storage/index.ts
+var LanceStorage = class _LanceStorage extends MastraStorage {
+  stores;
+  lanceClient;
+  /**
+   * Creates a new instance of LanceStorage
+   * @param uri The URI to connect to LanceDB
+   * @param options connection options
+   *
+   * Usage:
+   *
+   * Connect to a local database
+   * ```ts
+   * const store = await LanceStorage.create('/path/to/db');
+   * ```
+   *
+   * Connect to a LanceDB cloud database
+   * ```ts
+   * const store = await LanceStorage.create('db://host:port');
+   * ```
+   *
+   * Connect to a cloud database
+   * ```ts
+   * const store = await LanceStorage.create('s3://bucket/db', { storageOptions: { timeout: '60s' } });
+   * ```
+   */
+  static async create(name, uri, options) {
+    const instance = new _LanceStorage(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 }),
+        traces: new StoreTracesLance({ client: instance.lanceClient, operations }),
+        scores: new StoreScoresLance({ client: instance.lanceClient }),
+        memory: new StoreMemoryLance({ client: instance.lanceClient, operations }),
+        legacyEvals: new StoreLegacyEvalsLance({ client: instance.lanceClient })
+      };
+      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(name) {
+    super({ name });
+    const operations = new StoreOperationsLance({ client: this.lanceClient });
+    this.stores = {
+      operations: new StoreOperationsLance({ client: this.lanceClient }),
+      workflows: new StoreWorkflowsLance({ client: this.lanceClient }),
+      traces: new StoreTracesLance({ client: this.lanceClient, operations }),
+      scores: new StoreScoresLance({ client: this.lanceClient }),
+      legacyEvals: new StoreLegacyEvalsLance({ 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 });
+  }
+  async getThreadsByResourceId({ resourceId }) {
+    return this.stores.memory.getThreadsByResourceId({ resourceId });
+  }
+  /**
+   * 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
+    };
+  }
+  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 getMessages({
+    threadId,
+    resourceId,
+    selectBy,
+    format,
+    threadConfig
+  }) {
+    return this.stores.memory.getMessages({ threadId, resourceId, selectBy, format, threadConfig });
+  }
+  async getMessagesById({
+    messageIds,
+    format
+  }) {
+    return this.stores.memory.getMessagesById({ messageIds, format });
+  }
+  async saveMessages(args) {
+    return this.stores.memory.saveMessages(args);
+  }
+  async getThreadsByResourceIdPaginated(args) {
+    return this.stores.memory.getThreadsByResourceIdPaginated(args);
+  }
+  async getMessagesPaginated(args) {
+    return this.stores.memory.getMessagesPaginated(args);
+  }
+  async updateMessages(_args) {
+    return this.stores.memory.updateMessages(_args);
+  }
+  async getTraceById(args) {
+    return this.stores.traces.getTraceById(args);
+  }
+  async getTraces(args) {
+    return this.stores.traces.getTraces(args);
+  }
+  async getTracesPaginated(args) {
+    return this.stores.traces.getTracesPaginated(args);
+  }
+  async getEvalsByAgentName(agentName, type) {
+    return this.stores.legacyEvals.getEvalsByAgentName(agentName, type);
+  }
+  async getEvals(options) {
+    return this.stores.legacyEvals.getEvals(options);
+  }
+  async getWorkflowRuns(args) {
+    return this.stores.workflows.getWorkflowRuns(args);
+  }
+  async getWorkflowRunById(args) {
+    return this.stores.workflows.getWorkflowRunById(args);
+  }
+  async updateWorkflowResults({
+    workflowName,
+    runId,
+    stepId,
+    result,
+    runtimeContext
+  }) {
+    return this.stores.workflows.updateWorkflowResults({ workflowName, runId, stepId, result, runtimeContext });
+  }
+  async updateWorkflowState({
+    workflowName,
+    runId,
+    opts
+  }) {
+    return this.stores.workflows.updateWorkflowState({ workflowName, runId, opts });
+  }
+  async persistWorkflowSnapshot({
+    workflowName,
+    runId,
+    snapshot
+  }) {
+    return this.stores.workflows.persistWorkflowSnapshot({ workflowName, runId, snapshot });
+  }
+  async loadWorkflowSnapshot({
+    workflowName,
+    runId
+  }) {
+    return this.stores.workflows.loadWorkflowSnapshot({ workflowName, runId });
+  }
+  async getScoreById({ id: _id }) {
+    return this.stores.scores.getScoreById({ id: _id });
+  }
+  async getScoresByScorerId({
+    scorerId,
+    source,
+    entityId,
+    entityType,
+    pagination
+  }) {
+    return this.stores.scores.getScoresByScorerId({ scorerId, source, pagination, entityId, entityType });
+  }
+  async saveScore(_score) {
+    return this.stores.scores.saveScore(_score);
+  }
+  async getScoresByRunId({
+    runId,
+    pagination
+  }) {
+    return this.stores.scores.getScoresByRunId({ runId, pagination });
+  }
+  async getScoresByEntityId({
+    entityId,
+    entityType,
+    pagination
+  }) {
+    return this.stores.scores.getScoresByEntityId({ entityId, entityType, pagination });
+  }
+};
+var LanceFilterTranslator = class extends BaseFilterTranslator {
+  translate(filter) {
+    if (!filter || Object.keys(filter).length === 0) {
+      return "";
+    }
+    if (typeof filter === "object" && filter !== null) {
+      const keys = Object.keys(filter);
+      for (const key of keys) {
+        if (key.includes(".") && !this.isNormalNestedField(key)) {
+          throw new Error(`Field names containing periods (.) are not supported: ${key}`);
+        }
+      }
+    }
+    return this.processFilter(filter);
+  }
+  processFilter(filter, parentPath = "") {
+    if (filter === null) {
+      return `${parentPath} IS NULL`;
+    }
+    if (filter instanceof Date) {
+      return `${parentPath} = ${this.formatValue(filter)}`;
+    }
+    if (typeof filter === "object" && filter !== null) {
+      const obj = filter;
+      const keys = Object.keys(obj);
+      if (keys.length === 1 && this.isOperator(keys[0])) {
+        const operator = keys[0];
+        const operatorValue = obj[operator];
+        if (this.isLogicalOperator(operator)) {
+          if (operator === "$and" || operator === "$or") {
+            return this.processLogicalOperator(operator, operatorValue);
+          }
+          throw new Error(BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(operator));
+        }
+        throw new Error(BaseFilterTranslator.ErrorMessages.INVALID_TOP_LEVEL_OPERATOR(operator));
+      }
+      for (const key of keys) {
+        if (key.includes(".") && !this.isNormalNestedField(key)) {
+          throw new Error(`Field names containing periods (.) are not supported: ${key}`);
+        }
+      }
+      if (keys.length > 1) {
+        const conditions = keys.map((key) => {
+          const value = obj[key];
+          if (this.isNestedObject(value) && !this.isDateObject(value)) {
+            return this.processNestedObject(key, value);
+          } else {
+            return this.processField(key, value);
+          }
+        });
+        return conditions.join(" AND ");
+      }
+      if (keys.length === 1) {
+        const key = keys[0];
+        const value = obj[key];
+        if (this.isNestedObject(value) && !this.isDateObject(value)) {
+          return this.processNestedObject(key, value);
+        } else {
+          return this.processField(key, value);
+        }
+      }
+    }
+    return "";
+  }
+  processLogicalOperator(operator, conditions) {
+    if (!Array.isArray(conditions)) {
+      throw new Error(`Logical operator ${operator} must have an array value`);
+    }
+    if (conditions.length === 0) {
+      return operator === "$and" ? "true" : "false";
+    }
+    const sqlOperator = operator === "$and" ? "AND" : "OR";
+    const processedConditions = conditions.map((condition) => {
+      if (typeof condition !== "object" || condition === null) {
+        throw new Error(BaseFilterTranslator.ErrorMessages.INVALID_LOGICAL_OPERATOR_CONTENT(operator));
+      }
+      const condObj = condition;
+      const keys = Object.keys(condObj);
+      if (keys.length === 1 && this.isOperator(keys[0])) {
+        if (this.isLogicalOperator(keys[0])) {
+          return `(${this.processLogicalOperator(keys[0], condObj[keys[0]])})`;
+        } else {
+          throw new Error(BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(keys[0]));
+        }
+      }
+      if (keys.length > 1) {
+        return `(${this.processFilter(condition)})`;
+      }
+      return this.processFilter(condition);
+    });
+    return processedConditions.join(` ${sqlOperator} `);
+  }
+  processNestedObject(path, value) {
+    if (typeof value !== "object" || value === null) {
+      throw new Error(`Expected object for nested path ${path}`);
+    }
+    const obj = value;
+    const keys = Object.keys(obj);
+    if (keys.length === 0) {
+      return `${path} = {}`;
+    }
+    if (keys.every((k) => this.isOperator(k))) {
+      return this.processOperators(path, obj);
+    }
+    const conditions = keys.map((key) => {
+      const nestedPath = key.includes(".") ? `${path}.${key}` : `${path}.${key}`;
+      if (this.isNestedObject(obj[key]) && !this.isDateObject(obj[key])) {
+        return this.processNestedObject(nestedPath, obj[key]);
+      } else {
+        return this.processField(nestedPath, obj[key]);
+      }
+    });
+    return conditions.join(" AND ");
+  }
+  processField(field, value) {
+    if (field.includes(".") && !this.isNormalNestedField(field)) {
+      throw new Error(`Field names containing periods (.) are not supported: ${field}`);
+    }
+    const escapedField = this.escapeFieldName(field);
+    if (value === null) {
+      return `${escapedField} IS NULL`;
+    }
+    if (value instanceof Date) {
+      return `${escapedField} = ${this.formatValue(value)}`;
+    }
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        return "false";
+      }
+      const normalizedValues = this.normalizeArrayValues(value);
+      return `${escapedField} IN (${this.formatArrayValues(normalizedValues)})`;
+    }
+    if (this.isOperatorObject(value)) {
+      return this.processOperators(field, value);
+    }
+    return `${escapedField} = ${this.formatValue(this.normalizeComparisonValue(value))}`;
+  }
+  processOperators(field, operators) {
+    const escapedField = this.escapeFieldName(field);
+    const operatorKeys = Object.keys(operators);
+    if (operatorKeys.some((op) => this.isLogicalOperator(op))) {
+      const logicalOp = operatorKeys.find((op) => this.isLogicalOperator(op)) || "";
+      throw new Error(`Unsupported operator: ${logicalOp} cannot be used at field level`);
+    }
+    return operatorKeys.map((op) => {
+      const value = operators[op];
+      if (!this.isFieldOperator(op) && !this.isCustomOperator(op)) {
+        throw new Error(BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(op));
+      }
+      switch (op) {
+        case "$eq":
+          if (value === null) {
+            return `${escapedField} IS NULL`;
+          }
+          return `${escapedField} = ${this.formatValue(this.normalizeComparisonValue(value))}`;
+        case "$ne":
+          if (value === null) {
+            return `${escapedField} IS NOT NULL`;
+          }
+          return `${escapedField} != ${this.formatValue(this.normalizeComparisonValue(value))}`;
+        case "$gt":
+          return `${escapedField} > ${this.formatValue(this.normalizeComparisonValue(value))}`;
+        case "$gte":
+          return `${escapedField} >= ${this.formatValue(this.normalizeComparisonValue(value))}`;
+        case "$lt":
+          return `${escapedField} < ${this.formatValue(this.normalizeComparisonValue(value))}`;
+        case "$lte":
+          return `${escapedField} <= ${this.formatValue(this.normalizeComparisonValue(value))}`;
+        case "$in":
+          if (!Array.isArray(value)) {
+            throw new Error(`$in operator requires array value for field: ${field}`);
+          }
+          if (value.length === 0) {
+            return "false";
+          }
+          const normalizedValues = this.normalizeArrayValues(value);
+          return `${escapedField} IN (${this.formatArrayValues(normalizedValues)})`;
+        case "$like":
+          return `${escapedField} LIKE ${this.formatValue(value)}`;
+        case "$notLike":
+          return `${escapedField} NOT LIKE ${this.formatValue(value)}`;
+        case "$regex":
+          return `regexp_match(${escapedField}, ${this.formatValue(value)})`;
+        default:
+          throw new Error(BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(op));
+      }
+    }).join(" AND ");
+  }
+  formatValue(value) {
+    if (value === null) {
+      return "NULL";
+    }
+    if (typeof value === "string") {
+      return `'${value.replace(/'/g, "''")}'`;
+    }
+    if (typeof value === "number") {
+      return value.toString();
+    }
+    if (typeof value === "boolean") {
+      return value ? "true" : "false";
+    }
+    if (value instanceof Date) {
+      return `timestamp '${value.toISOString()}'`;
+    }
+    if (typeof value === "object") {
+      if (value instanceof Date) {
+        return `timestamp '${value.toISOString()}'`;
+      }
+      return JSON.stringify(value);
+    }
+    return String(value);
+  }
+  formatArrayValues(array) {
+    return array.map((item) => this.formatValue(item)).join(", ");
+  }
+  normalizeArrayValues(array) {
+    return array.map((item) => {
+      if (item instanceof Date) {
+        return item;
+      }
+      return this.normalizeComparisonValue(item);
+    });
+  }
+  normalizeComparisonValue(value) {
+    if (value instanceof Date) {
+      return value;
+    }
+    return super.normalizeComparisonValue(value);
+  }
+  isOperatorObject(value) {
+    if (typeof value !== "object" || value === null) {
+      return false;
+    }
+    const obj = value;
+    const keys = Object.keys(obj);
+    return keys.length > 0 && keys.some((key) => this.isOperator(key));
+  }
+  isNestedObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+  }
+  isNormalNestedField(field) {
+    const parts = field.split(".");
+    return !field.startsWith(".") && !field.endsWith(".") && parts.every((part) => part.trim().length > 0);
+  }
+  escapeFieldName(field) {
+    if (field.includes(" ") || field.includes("-") || /^[A-Z]+$/.test(field) || this.isSqlKeyword(field)) {
+      if (field.includes(".")) {
+        return field.split(".").map((part) => `\`${part}\``).join(".");
+      }
+      return `\`${field}\``;
+    }
+    return field;
+  }
+  isSqlKeyword(str) {
+    const sqlKeywords = [
+      "SELECT",
+      "FROM",
+      "WHERE",
+      "AND",
+      "OR",
+      "NOT",
+      "INSERT",
+      "UPDATE",
+      "DELETE",
+      "CREATE",
+      "ALTER",
+      "DROP",
+      "TABLE",
+      "VIEW",
+      "INDEX",
+      "JOIN",
+      "INNER",
+      "OUTER",
+      "LEFT",
+      "RIGHT",
+      "FULL",
+      "UNION",
+      "ALL",
+      "DISTINCT",
+      "AS",
+      "ON",
+      "BETWEEN",
+      "LIKE",
+      "IN",
+      "IS",
+      "NULL",
+      "TRUE",
+      "FALSE",
+      "ASC",
+      "DESC",
+      "GROUP",
+      "ORDER",
+      "BY",
+      "HAVING",
+      "LIMIT",
+      "OFFSET",
+      "CASE",
+      "WHEN",
+      "THEN",
+      "ELSE",
+      "END",
+      "CAST",
+      "CUBE"
+    ];
+    return sqlKeywords.includes(str.toUpperCase());
+  }
+  isDateObject(value) {
+    return value instanceof Date;
+  }
+  /**
+   * Override getSupportedOperators to add custom operators for LanceDB
+   */
+  getSupportedOperators() {
+    return {
+      ...BaseFilterTranslator.DEFAULT_OPERATORS,
+      custom: ["$like", "$notLike", "$regex"]
+    };
+  }
+};
+
+// src/vector/index.ts
+var LanceVectorStore = class _LanceVectorStore extends MastraVector {
+  lanceClient;
+  /**
+   * Creates a new instance of LanceVectorStore
+   * @param uri The URI to connect to LanceDB
+   * @param options connection options
+   *
+   * Usage:
+   *
+   * Connect to a local database
+   * ```ts
+   * const store = await LanceVectorStore.create('/path/to/db');
+   * ```
+   *
+   * Connect to a LanceDB cloud database
+   * ```ts
+   * const store = await LanceVectorStore.create('db://host:port');
+   * ```
+   *
+   * Connect to a cloud database
+   * ```ts
+   * const store = await LanceVectorStore.create('s3://bucket/db', { storageOptions: { timeout: '60s' } });
+   * ```
+   */
+  static async create(uri, options) {
+    const instance = new _LanceVectorStore();
+    try {
+      instance.lanceClient = await connect(uri, options);
+      return instance;
+    } catch (e) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CONNECT_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { uri }
+        },
+        e
+      );
+    }
+  }
+  /**
+   * @internal
+   * Private constructor to enforce using the create factory method
+   */
+  constructor() {
+    super();
+  }
+  close() {
+    if (this.lanceClient) {
+      this.lanceClient.close();
+    }
+  }
+  async query({
+    tableName,
+    queryVector,
+    filter,
+    includeVector = false,
+    topK = 10,
+    columns = [],
+    includeAllColumns = false
+  }) {
+    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 (!queryVector) {
+        throw new Error("queryVector is required");
+      }
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+          details: { tableName }
+        },
+        error
+      );
+    }
+    try {
+      const table = await this.lanceClient.openTable(tableName);
+      const selectColumns = [...columns];
+      if (!selectColumns.includes("id")) {
+        selectColumns.push("id");
+      }
+      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) {
+        query = query.select(selectColumns);
+      }
+      query = query.limit(topK);
+      const results = await query.toArray();
+      return results.map((result) => {
+        const flatMetadata = {};
+        Object.keys(result).forEach((key) => {
+          if (key !== "id" && key !== "score" && key !== "vector" && key !== "_distance") {
+            if (key.startsWith("metadata_")) {
+              const metadataKey = key.substring("metadata_".length);
+              flatMetadata[metadataKey] = result[key];
+            }
+          }
+        });
+        const metadata = this.unflattenObject(flatMetadata);
+        return {
+          id: String(result.id || ""),
+          metadata,
+          vector: includeVector && result.vector ? Array.isArray(result.vector) ? result.vector : Array.from(result.vector) : void 0,
+          document: result.document,
+          score: result._distance
+        };
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName, includeVector, columnsCount: columns?.length, includeAllColumns }
+        },
+        error
+      );
+    }
+  }
+  filterTranslator(filter) {
+    const processFilterKeys = (filterObj) => {
+      const result = {};
+      Object.entries(filterObj).forEach(([key, value]) => {
+        if (key === "$or" || key === "$and" || key === "$not" || key === "$in") {
+          if (Array.isArray(value)) {
+            result[key] = value.map(
+              (item) => typeof item === "object" && item !== null ? processFilterKeys(item) : item
+            );
+          } else {
+            result[key] = value;
+          }
+        } else if (key.startsWith("metadata_")) {
+          result[key] = value;
+        } else {
+          if (key.includes(".")) {
+            const convertedKey = `metadata_${key.replace(/\./g, "_")}`;
+            result[convertedKey] = value;
+          } else {
+            result[`metadata_${key}`] = value;
+          }
+        }
+      });
+      return result;
+    };
+    const prefixedFilter = filter && typeof filter === "object" ? processFilterKeys(filter) : {};
+    const translator = new LanceFilterTranslator();
+    return translator.translate(prefixedFilter);
+  }
+  async upsert({ tableName, vectors, metadata = [], ids = [] }) {
+    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 (!vectors || !Array.isArray(vectors) || vectors.length === 0) {
+        throw new Error("vectors array is required and must not be empty");
+      }
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+          details: { tableName }
+        },
+        error
+      );
+    }
+    try {
+      const tables = await this.lanceClient.tableNames();
+      if (!tables.includes(tableName)) {
+        throw new Error(`Table ${tableName} does not exist`);
+      }
+      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]);
+        const metadataItem = metadata[i] || {};
+        const rowData = {
+          id,
+          vector
+        };
+        if (Object.keys(metadataItem).length > 0) {
+          const flattenedMetadata = this.flattenObject(metadataItem, "metadata");
+          Object.entries(flattenedMetadata).forEach(([key, value]) => {
+            rowData[key] = value;
+          });
+        }
+        return rowData;
+      });
+      await table.add(data, { mode: "overwrite" });
+      return vectorIds;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName, vectorCount: vectors.length, metadataCount: metadata.length, idsCount: ids.length }
+        },
+        error
+      );
+    }
+  }
+  /**
+   * Flattens a nested object, creating new keys with underscores for nested properties.
+   * Example: { metadata: { text: 'test' } } → { metadata_text: 'test' }
+   */
+  flattenObject(obj, prefix = "") {
+    return Object.keys(obj).reduce((acc, k) => {
+      const pre = prefix.length ? `${prefix}_` : "";
+      if (typeof obj[k] === "object" && obj[k] !== null && !Array.isArray(obj[k])) {
+        Object.assign(acc, this.flattenObject(obj[k], pre + k));
+      } else {
+        acc[pre + k] = obj[k];
+      }
+      return acc;
+    }, {});
+  }
+  async createTable(tableName, data, options) {
+    if (!this.lanceClient) {
+      throw new MastraError({
+        id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+        details: { tableName }
+      });
+    }
+    if (Array.isArray(data)) {
+      data = data.map((record) => this.flattenObject(record));
+    }
+    try {
+      return await this.lanceClient.createTable(tableName, data, options);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  async listTables() {
+    if (!this.lanceClient) {
+      throw new MastraError({
+        id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+        details: { methodName: "listTables" }
+      });
+    }
+    try {
+      return await this.lanceClient.tableNames();
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getTableSchema(tableName) {
+    if (!this.lanceClient) {
+      throw new MastraError({
+        id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+        details: { tableName }
+      });
+    }
+    try {
+      const table = await this.lanceClient.openTable(tableName);
+      return await table.schema();
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  /**
+   * indexName is actually a column name in a table in lanceDB
+   */
+  async createIndex({
+    tableName,
+    indexName,
+    dimension,
+    metric = "cosine",
+    indexConfig = {}
+  }) {
+    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");
+      }
+      if (typeof dimension !== "number" || dimension <= 0) {
+        throw new Error("dimension must be a positive number");
+      }
+    } catch (err) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { tableName: tableName || "", 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.`
+        );
+      }
+      const table = await this.lanceClient.openTable(tableName);
+      let metricType;
+      if (metric === "euclidean") {
+        metricType = "l2";
+      } else if (metric === "dotproduct") {
+        metricType = "dot";
+      } else if (metric === "cosine") {
+        metricType = "cosine";
+      }
+      if (indexConfig.type === "ivfflat") {
+        await table.createIndex(indexName, {
+          config: Index.ivfPq({
+            numPartitions: indexConfig.numPartitions || 128,
+            numSubVectors: indexConfig.numSubVectors || 16,
+            distanceType: metricType
+          })
+        });
+      } else {
+        this.logger.debug("Creating HNSW PQ index with config:", indexConfig);
+        await table.createIndex(indexName, {
+          config: Index.hnswPq({
+            m: indexConfig?.hnsw?.m || 16,
+            efConstruction: indexConfig?.hnsw?.efConstruction || 100,
+            distanceType: metricType
+          })
+        });
+      }
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName: tableName || "", indexName, dimension }
+        },
+        error
+      );
+    }
+  }
+  async listIndexes() {
+    if (!this.lanceClient) {
+      throw new MastraError({
+        id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+        details: { methodName: "listIndexes" }
+      });
+    }
+    try {
+      const tables = await this.lanceClient.tableNames();
+      const allIndices = [];
+      for (const tableName of tables) {
+        const table = await this.lanceClient.openTable(tableName);
+        const tableIndices = await table.listIndices();
+        allIndices.push(...tableIndices.map((index) => index.name));
+      }
+      return allIndices;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async describeIndex({ 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");
+      }
+    } catch (err) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { indexName }
+        },
+        err
+      );
+    }
+    try {
+      const tables = await this.lanceClient.tableNames();
+      for (const tableName of tables) {
+        this.logger.debug("Checking table:" + tableName);
+        const table = await this.lanceClient.openTable(tableName);
+        const tableIndices = await table.listIndices();
+        const foundIndex = tableIndices.find((index) => index.name === indexName);
+        if (foundIndex) {
+          const stats = await table.indexStats(foundIndex.name);
+          if (!stats) {
+            throw new Error(`Index stats not found for index: ${indexName}`);
+          }
+          const schema = await table.schema();
+          const vectorCol = foundIndex.columns[0] || "vector";
+          const vectorField = schema.fields.find((field) => field.name === vectorCol);
+          const dimension = vectorField?.type?.["listSize"] || 0;
+          return {
+            dimension,
+            metric: stats.distanceType,
+            count: stats.numIndexedRows
+          };
+        }
+      }
+      throw new Error(`IndexName: ${indexName} not found`);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error
+      );
+    }
+  }
+  async deleteIndex({ 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");
+      }
+    } catch (err) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED_INVALID_ARGS",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          details: { indexName }
+        },
+        err
+      );
+    }
+    try {
+      const tables = await this.lanceClient.tableNames();
+      for (const tableName of tables) {
+        const table = await this.lanceClient.openTable(tableName);
+        const tableIndices = await table.listIndices();
+        const foundIndex = tableIndices.find((index) => index.name === indexName);
+        if (foundIndex) {
+          await table.dropIndex(indexName);
+          return;
+        }
+      }
+      throw new Error(`Index ${indexName} not found`);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error
+      );
+    }
+  }
+  /**
+   * Deletes all tables in the database
+   */
+  async deleteAllTables() {
+    if (!this.lanceClient) {
+      throw new MastraError({
+        id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { methodName: "deleteAllTables" },
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance"
+      });
+    }
+    try {
+      await this.lanceClient.dropAllTables();
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { methodName: "deleteAllTables" }
+        },
+        error
+      );
+    }
+  }
+  async deleteTable(tableName) {
+    if (!this.lanceClient) {
+      throw new MastraError({
+        id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { tableName },
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance"
+      });
+    }
+    try {
+      await this.lanceClient.dropTable(tableName);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error
+      );
+    }
+  }
+  async updateVector({ indexName, id, update }) {
+    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");
+      }
+      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);
+        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}`);
+            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}`);
+            }
+            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);
+                    } else {
+                      rowData[key] = value;
+                    }
+                  }
+                } else {
+                  rowData[key] = value;
+                }
+              }
+            });
+            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" });
+            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) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, id, hasVector: !!update.vector, hasMetadata: !!update.metadata }
+        },
+        error
+      );
+    }
+  }
+  async deleteVector({ indexName, id }) {
+    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");
+      }
+      if (!id) {
+        throw new Error("id is required");
+      }
+    } catch (err) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_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);
+        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}`);
+            await table.delete(`id = '${id}'`);
+            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) {
+      throw new MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error
+      );
+    }
+  }
+  /**
+   * Converts a flattened object with keys using underscore notation back to a nested object.
+   * Example: { name: 'test', details_text: 'test' } → { name: 'test', details: { text: 'test' } }
+   */
+  unflattenObject(obj) {
+    const result = {};
+    Object.keys(obj).forEach((key) => {
+      const value = obj[key];
+      const parts = key.split("_");
+      let current = result;
+      for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!part) continue;
+        if (!current[part] || typeof current[part] !== "object") {
+          current[part] = {};
+        }
+        current = current[part];
+      }
+      const lastPart = parts[parts.length - 1];
+      if (lastPart) {
+        current[lastPart] = value;
+      }
+    });
+    return result;
+  }
+};
+
+export { LanceStorage, LanceVectorStore };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map