@mastra/lance 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/index.js

@@ -1,6 +1,6 @@
 import { connect, Index } from '@lancedb/lancedb';
 import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
-import { MastraStorage, StoreOperations, MemoryStorage, TABLE_THREADS, TABLE_MESSAGES, normalizePerPage, calculatePagination, TABLE_RESOURCES, ScoresStorage, TABLE_SCORERS, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, ensureDate } from '@mastra/core/storage';
+import { MastraStorage, createStorageErrorId, createVectorErrorId, StoreOperations, MemoryStorage, TABLE_THREADS, TABLE_MESSAGES, normalizePerPage, calculatePagination, TABLE_RESOURCES, ScoresStorage, TABLE_SCORERS, 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 { saveScorePayloadSchema } from '@mastra/core/evals';
@@ -89,7 +89,7 @@ async function getTableSchema({
   } catch (validationError) {
     throw new MastraError(
       {
-        id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_INVALID_ARGS",
+        id: createStorageErrorId("LANCE", "GET_TABLE_SCHEMA", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: validationError.message,
@@ -112,7 +112,7 @@ async function getTableSchema({
   } catch (error) {
     throw new MastraError(
       {
-        id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_FAILED",
+        id: createStorageErrorId("LANCE", "GET_TABLE_SCHEMA", "FAILED"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.THIRD_PARTY,
         details: { tableName }
@@ -149,7 +149,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_GET_THREAD_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "GET_THREAD_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -171,7 +171,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_SAVE_THREAD_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_THREAD", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -213,7 +213,7 @@ var StoreMemoryLance = class extends MemoryStorage {
         }
         throw new MastraError(
           {
-            id: "LANCE_STORE_UPDATE_THREAD_FAILED",
+            id: createStorageErrorId("LANCE", "UPDATE_THREAD", "FAILED"),
             domain: ErrorDomain.STORAGE,
             category: ErrorCategory.THIRD_PARTY
           },
@@ -223,7 +223,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     }
     throw new MastraError(
       {
-        id: "LANCE_STORE_UPDATE_THREAD_FAILED",
+        id: createStorageErrorId("LANCE", "UPDATE_THREAD", "FAILED"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.THIRD_PARTY
       },
@@ -239,7 +239,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_DELETE_THREAD_FAILED",
+          id: createStorageErrorId("LANCE", "DELETE_THREAD", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -279,7 +279,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_LIST_MESSAGES_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_MESSAGES_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: {
@@ -296,7 +296,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     if (threadIds.length === 0 || threadIds.some((id) => !id.trim())) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_LIST_MESSAGES_INVALID_THREAD_ID",
+          id: createStorageErrorId("LANCE", "LIST_MESSAGES", "INVALID_THREAD_ID"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { threadId: Array.isArray(threadId) ? threadId.join(",") : threadId }
@@ -310,7 +310,7 @@ var StoreMemoryLance = class extends MemoryStorage {
       if (page < 0) {
         throw new MastraError(
           {
-            id: "STORAGE_LANCE_LIST_MESSAGES_INVALID_PAGE",
+            id: createStorageErrorId("LANCE", "LIST_MESSAGES", "INVALID_PAGE"),
             domain: ErrorDomain.STORAGE,
             category: ErrorCategory.USER,
             details: { page }
@@ -405,7 +405,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       const mastraError = new MastraError(
         {
-          id: "LANCE_STORE_LIST_MESSAGES_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: {
@@ -470,7 +470,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_SAVE_MESSAGES_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -485,7 +485,7 @@ var StoreMemoryLance = class extends MemoryStorage {
       if (page < 0) {
         throw new MastraError(
           {
-            id: "STORAGE_LANCE_LIST_THREADS_BY_RESOURCE_ID_INVALID_PAGE",
+            id: createStorageErrorId("LANCE", "LIST_THREADS_BY_RESOURCE_ID", "INVALID_PAGE"),
             domain: ErrorDomain.STORAGE,
             category: ErrorCategory.USER,
             details: { page }
@@ -525,7 +525,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_LIST_THREADS_BY_RESOURCE_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_THREADS_BY_RESOURCE_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -660,7 +660,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_UPDATE_MESSAGES_FAILED",
+          id: createStorageErrorId("LANCE", "UPDATE_MESSAGES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { count: messages.length }
@@ -737,7 +737,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_GET_RESOURCE_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "GET_RESOURCE_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -761,7 +761,7 @@ var StoreMemoryLance = class extends MemoryStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_SAVE_RESOURCE_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_RESOURCE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -815,7 +815,7 @@ var StoreMemoryLance = class extends MemoryStorage {
         }
         throw new MastraError(
           {
-            id: "LANCE_STORE_UPDATE_RESOURCE_FAILED",
+            id: createStorageErrorId("LANCE", "UPDATE_RESOURCE", "FAILED"),
             domain: ErrorDomain.STORAGE,
             category: ErrorCategory.THIRD_PARTY
           },
@@ -906,7 +906,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "CREATE_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: { tableName }
@@ -924,7 +924,7 @@ var StoreOperationsLance = class extends StoreOperations {
       }
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "CREATE_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -944,7 +944,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "DROP_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: validationError.message,
@@ -962,7 +962,7 @@ var StoreOperationsLance = class extends StoreOperations {
       }
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "DROP_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -993,7 +993,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "ALTER_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: validationError.message,
@@ -1028,7 +1028,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "ALTER_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -1048,7 +1048,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "CLEAR_TABLE", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: validationError.message,
@@ -1063,7 +1063,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_FAILED",
+          id: createStorageErrorId("LANCE", "CLEAR_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -1086,7 +1086,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_INSERT_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "INSERT", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: validationError.message,
@@ -1105,12 +1105,11 @@ var StoreOperationsLance = class extends StoreOperations {
           processedRecord[key] = JSON.stringify(processedRecord[key]);
         }
       }
-      console.info(await table.schema());
       await table.mergeInsert(primaryId).whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([processedRecord]);
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_INSERT_FAILED",
+          id: createStorageErrorId("LANCE", "INSERT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -1133,7 +1132,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "BATCH_INSERT", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: validationError.message,
@@ -1159,7 +1158,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_FAILED",
+          id: createStorageErrorId("LANCE", "BATCH_INSERT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -1182,7 +1181,7 @@ var StoreOperationsLance = class extends StoreOperations {
     } catch (validationError) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_LOAD_INVALID_ARGS",
+          id: createStorageErrorId("LANCE", "LOAD", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: validationError.message,
@@ -1221,7 +1220,7 @@ var StoreOperationsLance = class extends StoreOperations {
       if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_LOAD_FAILED",
+          id: createStorageErrorId("LANCE", "LOAD", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName, keyCount: Object.keys(keys).length, firstKey: Object.keys(keys)[0] ?? "" }
@@ -1244,39 +1243,47 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_SAVE_SCORE_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_SCORE", "VALIDATION_FAILED"),
           text: "Failed to save score in LanceStorage",
           domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY
+          category: ErrorCategory.USER,
+          details: {
+            scorer: score.scorer?.id ?? "unknown",
+            entityId: score.entityId ?? "unknown",
+            entityType: score.entityType ?? "unknown",
+            traceId: score.traceId ?? "",
+            spanId: score.spanId ?? ""
+          }
         },
         error
       );
     }
+    const id = crypto.randomUUID();
+    const now = /* @__PURE__ */ new Date();
     try {
-      const id = crypto.randomUUID();
       const table = await this.client.openTable(TABLE_SCORERS);
       const schema = await getTableSchema({ tableName: TABLE_SCORERS, client: this.client });
       const allowedFields = new Set(schema.fields.map((f) => f.name));
       const filteredScore = {};
-      Object.keys(validatedScore).forEach((key) => {
+      for (const key of Object.keys(validatedScore)) {
         if (allowedFields.has(key)) {
-          filteredScore[key] = score[key];
+          filteredScore[key] = validatedScore[key];
         }
-      });
+      }
       for (const key in filteredScore) {
         if (filteredScore[key] !== null && typeof filteredScore[key] === "object" && !(filteredScore[key] instanceof Date)) {
           filteredScore[key] = JSON.stringify(filteredScore[key]);
         }
       }
-      filteredScore.createdAt = /* @__PURE__ */ new Date();
-      filteredScore.updatedAt = /* @__PURE__ */ new Date();
       filteredScore.id = id;
+      filteredScore.createdAt = now;
+      filteredScore.updatedAt = now;
       await table.add([filteredScore], { mode: "append" });
-      return { score };
+      return { score: { ...validatedScore, id, createdAt: now, updatedAt: now } };
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_SAVE_SCORE_FAILED",
+          id: createStorageErrorId("LANCE", "SAVE_SCORE", "FAILED"),
           text: "Failed to save score in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1296,7 +1303,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORE_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "GET_SCORE_BY_ID", "FAILED"),
           text: "Failed to get score by id in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1375,7 +1382,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_SCORER_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_SCORER_ID", "FAILED"),
           text: "Failed to get scores by scorerId in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1416,7 +1423,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_RUN_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_RUN_ID", "FAILED"),
           text: "Failed to get scores by runId in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1458,7 +1465,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_ENTITY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_ENTITY_ID", "FAILED"),
           text: "Failed to get scores by entityId and entityType in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1500,7 +1507,7 @@ var StoreScoresLance = class extends ScoresStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORAGE_GET_SCORES_BY_SPAN_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_SCORES_BY_SPAN", "FAILED"),
           text: "Failed to get scores by traceId and spanId in LanceStorage",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
@@ -1582,7 +1589,7 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_PERSIST_WORKFLOW_SNAPSHOT_FAILED",
+          id: createStorageErrorId("LANCE", "PERSIST_WORKFLOW_SNAPSHOT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { workflowName, runId }
@@ -1603,7 +1610,7 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_LOAD_WORKFLOW_SNAPSHOT_FAILED",
+          id: createStorageErrorId("LANCE", "LOAD_WORKFLOW_SNAPSHOT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { workflowName, runId }
@@ -1627,7 +1634,7 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_GET_WORKFLOW_RUN_BY_ID_FAILED",
+          id: createStorageErrorId("LANCE", "GET_WORKFLOW_RUN_BY_ID", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { runId: args.runId, workflowName: args.workflowName ?? "" }
@@ -1669,7 +1676,7 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
         if (args.page < 0 || !Number.isInteger(args.page)) {
           throw new MastraError(
             {
-              id: "LANCE_STORE_INVALID_PAGINATION_PARAMS",
+              id: createStorageErrorId("LANCE", "LIST_WORKFLOW_RUNS", "INVALID_PAGINATION"),
               domain: ErrorDomain.STORAGE,
               category: ErrorCategory.USER,
               details: { page: args.page, perPage: args.perPage }
@@ -1689,7 +1696,7 @@ var StoreWorkflowsLance = class extends WorkflowsStorage {
     } catch (error) {
       throw new MastraError(
         {
-          id: "LANCE_STORE_LIST_WORKFLOW_RUNS_FAILED",
+          id: createStorageErrorId("LANCE", "LIST_WORKFLOW_RUNS", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { resourceId: args?.resourceId ?? "", workflowName: args?.workflowName ?? "" }
@@ -1709,7 +1716,8 @@ var LanceStorage = class _LanceStorage extends MastraStorage {
    * @param id The unique identifier for this storage instance
    * @param name The name for this storage instance
    * @param uri The URI to connect to LanceDB
-   * @param options connection options
+   * @param connectionOptions connection options for LanceDB
+   * @param storageOptions storage options including disableInit
    *
    * Usage:
    *
@@ -1727,11 +1735,16 @@ var LanceStorage = class _LanceStorage extends MastraStorage {
    * ```ts
    * const store = await LanceStorage.create('my-storage-id', 'MyStorage', 's3://bucket/db', { storageOptions: { timeout: '60s' } });
    * ```
+   *
+   * Disable auto-init for runtime (after CI/CD has run migrations)
+   * ```ts
+   * const store = await LanceStorage.create('my-storage-id', 'MyStorage', '/path/to/db', undefined, { disableInit: true });
+   * ```
    */
-  static async create(id, name, uri, options) {
-    const instance = new _LanceStorage(id, name);
+  static async create(id, name, uri, connectionOptions, storageOptions) {
+    const instance = new _LanceStorage(id, name, storageOptions?.disableInit);
     try {
-      instance.lanceClient = await connect(uri, options);
+      instance.lanceClient = await connect(uri, connectionOptions);
       const operations = new StoreOperationsLance({ client: instance.lanceClient });
       instance.stores = {
         operations: new StoreOperationsLance({ client: instance.lanceClient }),
@@ -1743,11 +1756,11 @@ var LanceStorage = class _LanceStorage extends MastraStorage {
     } catch (e) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_STORAGE_CONNECT_FAILED",
+          id: createStorageErrorId("LANCE", "CONNECT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           text: `Failed to connect to LanceDB: ${e.message || e}`,
-          details: { uri, optionsProvided: !!options }
+          details: { uri, optionsProvided: !!connectionOptions }
         },
         e
       );
@@ -1757,8 +1770,8 @@ var LanceStorage = class _LanceStorage extends MastraStorage {
    * @internal
    * Private constructor to enforce using the create factory method
    */
-  constructor(id, name) {
-    super({ id, name });
+  constructor(id, name, disableInit) {
+    super({ id, name, disableInit });
     const operations = new StoreOperationsLance({ client: this.lanceClient });
     this.stores = {
       operations: new StoreOperationsLance({ client: this.lanceClient }),
@@ -1944,8 +1957,8 @@ var LanceStorage = class _LanceStorage extends MastraStorage {
   }) {
     return this.stores.scores.listScoresByScorerId({ scorerId, source, pagination, entityId, entityType });
   }
-  async saveScore(_score) {
-    return this.stores.scores.saveScore(_score);
+  async saveScore(score) {
+    return this.stores.scores.saveScore(score);
   }
   async listScoresByRunId({
     runId,
@@ -2321,7 +2334,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (e) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CONNECT_FAILED",
+          id: createVectorErrorId("LANCE", "CONNECT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { uri }
@@ -2364,7 +2377,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "QUERY", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2412,7 +2425,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED",
+          id: createVectorErrorId("LANCE", "QUERY", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName, includeVector, columnsCount: columns?.length, includeAllColumns }
@@ -2464,7 +2477,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "UPSERT", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2500,7 +2513,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED",
+          id: createVectorErrorId("LANCE", "UPSERT", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName, vectorCount: vectors.length, metadataCount: metadata.length, idsCount: ids.length }
@@ -2527,7 +2540,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async createTable(tableName, data, options) {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "CREATE_TABLE", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2542,7 +2555,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED",
+          id: createVectorErrorId("LANCE", "CREATE_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -2554,7 +2567,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async listTables() {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "LIST_TABLES", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2566,7 +2579,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED",
+          id: createVectorErrorId("LANCE", "LIST_TABLES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -2577,7 +2590,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async getTableSchema(tableName) {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "GET_TABLE_SCHEMA", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2590,7 +2603,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED",
+          id: createVectorErrorId("LANCE", "GET_TABLE_SCHEMA", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -2625,7 +2638,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "CREATE_INDEX", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: { tableName: tableName || "", indexName, dimension, metric }
@@ -2670,7 +2683,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED",
+          id: createVectorErrorId("LANCE", "CREATE_INDEX", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName: tableName || "", indexName, dimension }
@@ -2682,7 +2695,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async listIndexes() {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "LIST_INDEXES", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
@@ -2701,7 +2714,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED",
+          id: createVectorErrorId("LANCE", "LIST_INDEXES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -2720,7 +2733,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "DESCRIBE_INDEX", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: { indexName }
@@ -2755,7 +2768,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED",
+          id: createVectorErrorId("LANCE", "DESCRIBE_INDEX", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { indexName }
@@ -2775,7 +2788,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "DELETE_INDEX", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: { indexName }
@@ -2798,7 +2811,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_INDEX", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { indexName }
@@ -2813,7 +2826,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async deleteAllTables() {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_ALL_TABLES", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         details: { methodName: "deleteAllTables" },
@@ -2825,7 +2838,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_ALL_TABLES", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { methodName: "deleteAllTables" }
@@ -2837,7 +2850,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async deleteTable(tableName) {
     if (!this.lanceClient) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_TABLE", "INVALID_ARGS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         details: { tableName },
@@ -2849,7 +2862,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_TABLE", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: { tableName }
@@ -2862,7 +2875,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     const { indexName, update } = params;
     if ("id" in params && "filter" in params && params.id && params.filter) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "MUTUALLY_EXCLUSIVE"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "id and filter are mutually exclusive",
@@ -2871,7 +2884,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
     if (!("id" in params || "filter" in params) || !params.id && !params.filter) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "NO_TARGET"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "Either id or filter must be provided",
@@ -2880,7 +2893,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
     if ("filter" in params && params.filter && Object.keys(params.filter).length === 0) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "EMPTY_FILTER"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "Cannot update with empty filter",
@@ -2889,7 +2902,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
     if (!update.vector && !update.metadata) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "NO_PAYLOAD"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "No updates provided",
@@ -2984,7 +2997,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
       if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_FAILED",
+          id: createVectorErrorId("LANCE", "UPDATE_VECTOR", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: {
@@ -3013,7 +3026,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (err) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED_INVALID_ARGS",
+          id: createVectorErrorId("LANCE", "DELETE_VECTOR", "INVALID_ARGS"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.USER,
           details: {
@@ -3046,7 +3059,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     } catch (error) {
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_VECTOR", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: {
@@ -3086,7 +3099,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
   async deleteVectors({ indexName, filter, ids }) {
     if (ids && filter) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_VECTORS_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "MUTUALLY_EXCLUSIVE"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "ids and filter are mutually exclusive",
@@ -3095,7 +3108,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
     if (!ids && !filter) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_VECTORS_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "NO_TARGET"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "Either filter or ids must be provided",
@@ -3104,7 +3117,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
     if (ids && ids.length === 0) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_VECTORS_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "EMPTY_IDS"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "Cannot delete with empty ids array",
@@ -3113,7 +3126,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
     }
     if (filter && Object.keys(filter).length === 0) {
       throw new MastraError({
-        id: "STORAGE_LANCE_VECTOR_DELETE_VECTORS_INVALID_ARGS",
+        id: createVectorErrorId("LANCE", "DELETE_VECTORS", "EMPTY_FILTER"),
         domain: ErrorDomain.STORAGE,
         category: ErrorCategory.USER,
         text: "Cannot delete with empty filter",
@@ -3173,7 +3186,7 @@ var LanceVectorStore = class _LanceVectorStore extends MastraVector {
       if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: "STORAGE_LANCE_VECTOR_DELETE_VECTORS_FAILED",
+          id: createVectorErrorId("LANCE", "DELETE_VECTORS", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
           details: {