@mastra/lance 0.1.2 → 0.1.3-alpha.1

package/dist/index.cjs

@@ -2,6 +2,7 @@
 
 var lancedb = require('@lancedb/lancedb');
 var agent = require('@mastra/core/agent');
+var error = require('@mastra/core/error');
 var storage = require('@mastra/core/storage');
 var apacheArrow = require('apache-arrow');
 var vector = require('@mastra/core/vector');
@@ -38,7 +39,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       instance.lanceClient = await lancedb.connect(uri, options);
       return instance;
     } catch (e) {
-      throw new Error(`Failed to connect to LanceDB: ${e}`);
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CONNECT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          text: `Failed to connect to LanceDB: ${e.message || e}`,
+          details: { uri, optionsProvided: !!options }
+        },
+        e
+      );
     }
   }
   /**
@@ -52,11 +62,40 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
     tableName,
     schema
   }) {
+    try {
+      if (!this.lanceClient) {
+        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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { tableName }
+        },
+        error$1
+      );
+    }
     try {
       const arrowSchema = this.translateSchema(schema);
       await this.lanceClient.createEmptyTable(tableName, arrowSchema);
-    } catch (error) {
-      throw new Error(`Failed to create table: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CREATE_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   translateSchema(schema) {
@@ -99,14 +138,41 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
    * @param tableName Name of the table to drop
    */
   async dropTable(tableName) {
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
     try {
       await this.lanceClient.dropTable(tableName);
-    } catch (error) {
-      if (error.toString().includes("was not found")) {
+    } catch (error$1) {
+      if (error$1.toString().includes("was not found") || error$1.message?.includes("Table not found")) {
         this.logger.debug(`Table '${tableName}' does not exist, skipping drop`);
         return;
       }
-      throw new Error(`Failed to drop table: ${error}`);
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_DROP_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -115,6 +181,25 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
    * @returns Table schema
    */
   async getTableSchema(tableName) {
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
     try {
       const table = await this.lanceClient.openTable(tableName);
       const rawSchema = await table.schema();
@@ -126,8 +211,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
           return fields.map((field) => field.name);
         }
       };
-    } catch (error) {
-      throw new Error(`Failed to get table schema: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_GET_TABLE_SCHEMA_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   getDefaultValue(type) {
@@ -158,32 +251,101 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
     schema,
     ifNotExists
   }) {
-    const table = await this.lanceClient.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"]})`
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
+    try {
+      const table = await this.lanceClient.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"
       };
-    });
-    if (columnsToAdd.length > 0) {
-      await table.addColumns(columnsToAdd);
-      this.logger?.info?.(`Added columns [${columnsToAdd.map((c) => c.name).join(", ")}] to table ${tableName}`);
+      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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_ALTER_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   async clearTable({ tableName }) {
-    const table = await this.lanceClient.openTable(tableName);
-    await table.delete("1=1");
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
+    try {
+      const table = await this.lanceClient.openTable(tableName);
+      await table.delete("1=1");
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_CLEAR_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
+    }
   }
   /**
    * Insert a single record into a table. This function overwrites the existing record if it exists. Use this function for inserting records into tables with custom schemas.
@@ -191,6 +353,28 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
    * @param record The record to insert.
    */
   async insert({ tableName, record }) {
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_INSERT_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
     try {
       const table = await this.lanceClient.openTable(tableName);
       const processedRecord = { ...record };
@@ -201,8 +385,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         }
       }
       await table.add([processedRecord], { mode: "overwrite" });
-    } catch (error) {
-      throw new Error(`Failed to insert record: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_INSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -211,6 +403,28 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
    * @param records The records to insert.
    */
   async batchInsert({ tableName, records }) {
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
     try {
       const table = await this.lanceClient.openTable(tableName);
       const processedRecords = records.map((record) => {
@@ -224,8 +438,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         return processedRecord;
       });
       await table.add(processedRecords, { mode: "overwrite" });
-    } catch (error) {
-      throw new Error(`Failed to batch insert records: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_BATCH_INSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -236,6 +458,28 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
    * @returns The loaded record with proper type conversions, or null if not found
    */
   async load({ tableName, keys }) {
+    try {
+      if (!this.lanceClient) {
+        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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_LOAD_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: validationError.message,
+          details: { tableName }
+        },
+        validationError
+      );
+    }
     try {
       const table = await this.lanceClient.openTable(tableName);
       const tableSchema = await this.getTableSchema(tableName);
@@ -262,8 +506,17 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         return null;
       }
       return this.processResultWithTypeConversion(result[0], tableSchema);
-    } catch (error) {
-      throw new Error(`Failed to load record: ${error}`);
+    } catch (error$1) {
+      if (error$1 instanceof error.MastraError) throw error$1;
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_STORAGE_LOAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName, keyCount: Object.keys(keys).length, firstKey: Object.keys(keys)[0] ?? "" }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -337,8 +590,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
   getThreadById({ threadId }) {
     try {
       return this.load({ tableName: storage.TABLE_THREADS, keys: { id: threadId } });
-    } catch (error) {
-      throw new Error(`Failed to get thread by ID: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_THREAD_BY_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async getThreadsByResourceId({ resourceId }) {
@@ -350,8 +610,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         records,
         await this.getTableSchema(storage.TABLE_THREADS)
       );
-    } catch (error) {
-      throw new Error(`Failed to get threads by resource ID: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_THREADS_BY_RESOURCE_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   /**
@@ -365,8 +632,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       const table = await this.lanceClient.openTable(storage.TABLE_THREADS);
       await table.add([record], { mode: "append" });
       return thread;
-    } catch (error) {
-      throw new Error(`Failed to save thread: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_SAVE_THREAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async updateThread({
@@ -384,16 +658,30 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         records[0],
         await this.getTableSchema(storage.TABLE_THREADS)
       );
-    } catch (error) {
-      throw new Error(`Failed to update thread: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_UPDATE_THREAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async deleteThread({ threadId }) {
     try {
       const table = await this.lanceClient.openTable(storage.TABLE_THREADS);
       await table.delete(`id = '${threadId}'`);
-    } catch (error) {
-      throw new Error(`Failed to delete thread: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_DELETE_THREAD_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   /**
@@ -455,6 +743,7 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       if (threadConfig) {
         throw new Error("ThreadConfig is not supported by LanceDB storage");
       }
+      const limit = this.resolveMessageLimit({ last: selectBy?.last, defaultLimit: Number.MAX_SAFE_INTEGER });
       const table = await this.lanceClient.openTable(storage.TABLE_MESSAGES);
       let query = table.query().where(`\`threadId\` = '${threadId}'`);
       if (selectBy) {
@@ -473,8 +762,8 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       if (selectBy?.include && selectBy.include.length > 0) {
         records = this.processMessagesWithContext(records, selectBy.include);
       }
-      if (selectBy?.last !== void 0 && selectBy.last !== false) {
-        records = records.slice(-selectBy.last);
+      if (limit !== Number.MAX_SAFE_INTEGER) {
+        records = records.slice(-limit);
       }
       const messages = this.processResultWithTypeConversion(records, await this.getTableSchema(storage.TABLE_MESSAGES));
       const normalized = messages.map((msg) => ({
@@ -490,8 +779,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       const list = new agent.MessageList({ threadId, resourceId }).add(normalized, "memory");
       if (format === "v2") return list.get.all.v2();
       return list.get.all.v1();
-    } catch (error) {
-      throw new Error(`Failed to get messages: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_MESSAGES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async saveMessages(args) {
@@ -513,8 +809,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       const list = new agent.MessageList().add(messages, "memory");
       if (format === `v2`) return list.get.all.v2();
       return list.get.all.v1();
-    } catch (error) {
-      throw new Error(`Failed to save messages: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_SAVE_MESSAGES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async saveTrace({ trace }) {
@@ -530,8 +833,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       };
       await table.add([record], { mode: "append" });
       return trace;
-    } catch (error) {
-      throw new Error(`Failed to save trace: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_SAVE_TRACE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async getTraceById({ traceId }) {
@@ -540,8 +850,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       const query = table.query().where(`id = '${traceId}'`);
       const records = await query.toArray();
       return this.processResultWithTypeConversion(records[0], await this.getTableSchema(storage.TABLE_TRACES));
-    } catch (error) {
-      throw new Error(`Failed to get trace by ID: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_TRACE_BY_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async getTraces({
@@ -582,8 +899,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
           createdAt: new Date(record.createdAt)
         };
       });
-    } catch (error) {
-      throw new Error(`Failed to get traces: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_TRACES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { name: name ?? "", scope: scope ?? "" }
+        },
+        error$1
+      );
     }
   }
   async saveEvals({ evals }) {
@@ -603,8 +928,15 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       }));
       await table.add(transformedEvals, { mode: "append" });
       return evals;
-    } catch (error) {
-      throw new Error(`Failed to save evals: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_SAVE_EVALS_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async getEvalsByAgentName(agentName, type) {
@@ -630,8 +962,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
           createdAt: new Date(record.created_at).toString()
         };
       });
-    } catch (error) {
-      throw new Error(`Failed to get evals by agent name: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_EVALS_BY_AGENT_NAME_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { agentName }
+        },
+        error$1
+      );
     }
   }
   parseWorkflowRun(row) {
@@ -676,8 +1016,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         runs: records.map((record) => this.parseWorkflowRun(record)),
         total: records.length
       };
-    } catch (error) {
-      throw new Error(`Failed to get workflow runs: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_WORKFLOW_RUNS_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { namespace: args?.namespace ?? "", workflowName: args?.workflowName ?? "" }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -697,8 +1045,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       if (records.length === 0) return null;
       const record = records[0];
       return this.parseWorkflowRun(record);
-    } catch (error) {
-      throw new Error(`Failed to get workflow run by id: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_GET_WORKFLOW_RUN_BY_ID_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { runId: args.runId, workflowName: args.workflowName ?? "" }
+        },
+        error$1
+      );
     }
   }
   async persistWorkflowSnapshot({
@@ -727,8 +1083,16 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
         updatedAt: now
       };
       await table.add([record], { mode });
-    } catch (error) {
-      throw new Error(`Failed to persist workflow snapshot: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_PERSIST_WORKFLOW_SNAPSHOT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { workflowName, runId }
+        },
+        error$1
+      );
     }
   }
   async loadWorkflowSnapshot({
@@ -740,18 +1104,51 @@ var LanceStorage = class _LanceStorage extends storage.MastraStorage {
       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 Error(`Failed to load workflow snapshot: ${error}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LANCE_STORE_LOAD_WORKFLOW_SNAPSHOT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { workflowName, runId }
+        },
+        error$1
+      );
     }
   }
   async getTracesPaginated(_args) {
-    throw new Error("Method not implemented.");
+    throw new error.MastraError(
+      {
+        id: "LANCE_STORE_GET_TRACES_PAGINATED_FAILED",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.THIRD_PARTY
+      },
+      "Method not implemented."
+    );
   }
   async getThreadsByResourceIdPaginated(_args) {
-    throw new Error("Method not implemented.");
+    throw new error.MastraError(
+      {
+        id: "LANCE_STORE_GET_THREADS_BY_RESOURCE_ID_PAGINATED_FAILED",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.THIRD_PARTY
+      },
+      "Method not implemented."
+    );
   }
   async getMessagesPaginated(_args) {
-    throw new Error("Method not implemented.");
+    throw new error.MastraError(
+      {
+        id: "LANCE_STORE_GET_MESSAGES_PAGINATED_FAILED",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.THIRD_PARTY
+      },
+      "Method not implemented."
+    );
+  }
+  async updateMessages(_args) {
+    this.logger.error("updateMessages is not yet implemented in LanceStore");
+    throw new Error("Method not implemented");
   }
 };
 var LanceFilterTranslator = class extends filter.BaseFilterTranslator {
@@ -1105,7 +1502,15 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
       instance.lanceClient = await lancedb.connect(uri, options);
       return instance;
     } catch (e) {
-      throw new Error(`Failed to connect to LanceDB: ${e}`);
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CONNECT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { uri }
+        },
+        e
+      );
     }
   }
   /**
@@ -1129,14 +1534,27 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
     columns = [],
     includeAllColumns = false
   }) {
-    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");
+    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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+          details: { tableName }
+        },
+        error$1
+      );
     }
     try {
       const table = await this.lanceClient.openTable(tableName);
@@ -1174,8 +1592,16 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
           score: result._distance
         };
       });
-    } catch (error) {
-      throw new Error(`Failed to query vectors: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_QUERY_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName, includeVector, columnsCount: columns?.length, includeAllColumns }
+        },
+        error$1
+      );
     }
   }
   filterTranslator(filter) {
@@ -1208,14 +1634,27 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
     return translator.translate(prefixedFilter);
   }
   async upsert({ tableName, vectors, metadata = [], ids = [] }) {
-    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");
+    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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+          details: { tableName }
+        },
+        error$1
+      );
     }
     try {
       const tables = await this.lanceClient.tableNames();
@@ -1241,8 +1680,16 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
       });
       await table.add(data, { mode: "overwrite" });
       return vectorIds;
-    } catch (error) {
-      throw new Error(`Failed to upsert vectors: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName, vectorCount: vectors.length, metadataCount: metadata.length, idsCount: ids.length }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -1262,29 +1709,78 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
   }
   async createTable(tableName, data, options) {
     if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      throw new error.MastraError({
+        id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.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 {
-      if (Array.isArray(data)) {
-        data = data.map((record) => this.flattenObject(record));
-      }
       return await this.lanceClient.createTable(tableName, data, options);
-    } catch (error) {
-      throw new Error(`Failed to create table: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CREATE_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   async listTables() {
     if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      throw new error.MastraError({
+        id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_LIST_TABLES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
-    return await this.lanceClient.tableNames();
   }
   async getTableSchema(tableName) {
     if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      throw new error.MastraError({
+        id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_GET_TABLE_SCHEMA_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
-    const table = await this.lanceClient.openTable(tableName);
-    return await table.schema();
   }
   /**
    * indexName is actually a column name in a table in lanceDB
@@ -1296,10 +1792,10 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
     metric = "cosine",
     indexConfig = {}
   }) {
-    if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
-    }
     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");
       }
@@ -1309,6 +1805,18 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
       if (typeof dimension !== "number" || dimension <= 0) {
         throw new Error("dimension must be a positive number");
       }
+    } catch (err) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { tableName: tableName || "", indexName, dimension, metric }
+        },
+        err
+      );
+    }
+    try {
       const tables = await this.lanceClient.tableNames();
       if (!tables.includes(tableName)) {
         throw new Error(
@@ -1342,13 +1850,27 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
           })
         });
       }
-    } catch (error) {
-      throw new Error(`Failed to create index: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_CREATE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName: tableName || "", indexName, dimension }
+        },
+        error$1
+      );
     }
   }
   async listIndexes() {
     if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      throw new error.MastraError({
+        id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        text: "LanceDB client not initialized. Use LanceVectorStore.create() to create an instance",
+        details: { methodName: "listIndexes" }
+      });
     }
     try {
       const tables = await this.lanceClient.tableNames();
@@ -1359,16 +1881,35 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
         allIndices.push(...tableIndices.map((index) => index.name));
       }
       return allIndices;
-    } catch (error) {
-      throw new Error(`Failed to list indexes: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_LIST_INDEXES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   async describeIndex({ indexName }) {
-    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");
+    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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName }
+        },
+        err
+      );
     }
     try {
       const tables = await this.lanceClient.tableNames();
@@ -1394,16 +1935,36 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
         }
       }
       throw new Error(`IndexName: ${indexName} not found`);
-    } catch (error) {
-      throw new Error(`Failed to describe index: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DESCRIBE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error$1
+      );
     }
   }
   async deleteIndex({ indexName }) {
-    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");
+    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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName }
+        },
+        err
+      );
     }
     try {
       const tables = await this.lanceClient.tableNames();
@@ -1417,8 +1978,16 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
         }
       }
       throw new Error(`Index ${indexName} not found`);
-    } catch (error) {
-      throw new Error(`Failed to delete index: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -1426,33 +1995,73 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
    */
   async deleteAllTables() {
     if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      throw new error.MastraError({
+        id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.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 Error(`Failed to delete tables: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_ALL_TABLES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { methodName: "deleteAllTables" }
+        },
+        error$1
+      );
     }
   }
   async deleteTable(tableName) {
     if (!this.lanceClient) {
-      throw new Error("LanceDB client not initialized. Use LanceVectorStore.create() to create an instance");
+      throw new error.MastraError({
+        id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.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 Error(`Failed to delete tables: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_TABLE_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { tableName }
+        },
+        error$1
+      );
     }
   }
   async updateVector({ indexName, id, update }) {
-    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");
+    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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, id }
+        },
+        err
+      );
     }
     try {
       const tables = await this.lanceClient.tableNames();
@@ -1505,19 +2114,39 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
         }
       }
       throw new Error(`No table found with column/index '${indexName}'`);
-    } catch (error) {
-      throw new Error(`Failed to update index: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id, hasVector: !!update.vector, hasMetadata: !!update.metadata }
+        },
+        error$1
+      );
     }
   }
   async deleteVector({ indexName, id }) {
-    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");
+    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 error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED_INVALID_ARGS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, id }
+        },
+        err
+      );
     }
     try {
       const tables = await this.lanceClient.tableNames();
@@ -1538,8 +2167,16 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
         }
       }
       throw new Error(`No table found with column/index '${indexName}'`);
-    } catch (error) {
-      throw new Error(`Failed to delete index: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_LANCE_VECTOR_DELETE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error$1
+      );
     }
   }
   /**