@mastra/lance 1.5.2-alpha.1 → 1.6.0-alpha.0

package/README.md

@@ -26,7 +26,7 @@ await vectorStore.createIndex({
 ## Documentation
 
 - [LanceDB integration guide](https://mastra.ai/integrations/databases/lancedb)
-- [Lance vector reference](https://mastra.ai/reference/vectors/lance)
+- [Lance vector reference](https://mastra.ai/integrations/vectors/lance)
 
 ## Changelog
 

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-lance
 description: Documentation for @mastra/lance. Use when working with @mastra/lance APIs, configuration, or implementation.
 metadata:
   package: "@mastra/lance"
-  version: "1.5.2-alpha.1"
+  version: "1.6.0-alpha.0"
 ---
 
 ## When to use
@@ -17,11 +17,11 @@ Read the individual reference documents for detailed explanations and code examp
 ### Integrations
 
 - [LanceDB](references/integrations-databases-lancedb.md) - Use LanceDB for Mastra application storage and vector operations, configure tables and initialization, and account for its observability limitations.
+- [Lance](references/integrations-vectors-lance.md) - Store embeddings in LanceDB through Mastra's LanceVectorStore with embedded similarity search for local, S3, and managed cloud deployments.
 
 ### Reference
 
 - [Storing embeddings in a vector database](references/reference-rag-vector-databases.md) - After generating embeddings, you need to store them in a database that supports vector similarity search.
-- [Reference: Lance vector store](references/reference-vectors-lance.md) - The LanceVectorStore class provides vector search using LanceDB, an embedded vector database built on the Lance columnar format.
 
 
 Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.2-alpha.1",
+  "version": "1.6.0-alpha.0",
   "package": "@mastra/lance",
   "exports": {},
   "modules": {}

package/dist/docs/references/{reference-vectors-lance.md → integrations-vectors-lance.md}

@@ -12,7 +12,7 @@ The LanceVectorStore uses a factory pattern for creation. You should use the sta
 
 **uri** (`string`): Path to LanceDB database or URI for cloud deployments
 
-**options** (`ConnectionOptions`): Additional connection options for LanceDB
+**options** (`ConnectionOptions & { id?: string }`): Additional connection options for LanceDB. Pass id to name the store; otherwise a random UUID is used.
 
 ## Constructor examples
 

package/dist/docs/references/reference-rag-vector-databases.md

@@ -35,7 +35,7 @@ MongoDB Vector Search is a good solution for teams who want to consolidate vecto
 
 ### Using VoyageAI with MongoDB
 
-MongoDB works directly with VoyageAI's embedding models, which are optimized for retrieval tasks. For complete examples and specialized models, see the [VoyageAI embeddings documentation](https://mastra.ai/models/embeddings) and [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb).
+MongoDB works directly with VoyageAI's embedding models, which are optimized for retrieval tasks. For complete examples and specialized models, see the [VoyageAI embeddings documentation](https://mastra.ai/models/embeddings) and [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb).
 
 ### Hybrid Search (Vector + Full-Text)
 
@@ -52,7 +52,7 @@ const results = await store.hybridQuery({
 })
 ```
 
-See the [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb) for details on `createSearchIndex()`, `textQuery()`, and `hybridQuery()`.
+See the [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb) for details on `createSearchIndex()`, `textQuery()`, and `hybridQuery()`.
 
 ### Automated Embedding
 
@@ -75,7 +75,7 @@ const results = await store.query({
 })
 ```
 
-Automated Embedding is a MongoDB Preview feature and needs a deployment where it's available. See the [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb) for the supported options and requirements.
+Automated Embedding is a MongoDB Preview feature and needs a deployment where it's available. See the [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb) for the supported options and requirements.
 
 **PgVector**:
 

package/dist/index.cjs

@@ -412,7 +412,7 @@ var LanceDB = class extends _mastra_core_base.MastraBase {
 					const quotedKey = /^[a-z][a-zA-Z]*$/.test(key) && /[A-Z]/.test(key) ? `\`${key}\`` : key;
 					if (typeof value === "string") return `${quotedKey} = '${value}'`;
 					else if (value === null) return `${quotedKey} IS NULL`;
-					else return `${quotedKey} = ${value}`;
+					return `${quotedKey} = ${value}`;
 				}).join(" AND ");
 				this.logger.debug("where clause generated: " + filterConditions);
 				query.where(filterConditions);
@@ -465,7 +465,9 @@ function toRecord(task) {
 		suspendedAt: task.suspendedAt ?? /* @__PURE__ */ new Date(0),
 		completedAt: task.completedAt ?? /* @__PURE__ */ new Date(0),
 		ownerId: task.ownerId ?? null,
-		leaseExpiresAt: task.leaseExpiresAt ?? null
+		leaseExpiresAt: task.leaseExpiresAt ?? null,
+		expiresAt: task.expiresAt ?? null,
+		metadata: serializeJson(task.metadata) ?? null
 	};
 }
 function fromRecord(row) {
@@ -482,6 +484,7 @@ function fromRecord(row) {
 	const suspendedAt = row.suspendedAt instanceof Date ? row.suspendedAt : row.suspendedAt ? new Date(row.suspendedAt) : void 0;
 	const completedAt = row.completedAt instanceof Date ? row.completedAt : row.completedAt ? new Date(row.completedAt) : void 0;
 	const leaseExpiresAt = row.leaseExpiresAt instanceof Date ? row.leaseExpiresAt : row.leaseExpiresAt ? new Date(row.leaseExpiresAt) : void 0;
+	const expiresAt = row.expiresAt instanceof Date ? row.expiresAt : row.expiresAt ? new Date(row.expiresAt) : void 0;
 	return {
 		id: String(row.id),
 		status: String(row.status),
@@ -503,13 +506,16 @@ function fromRecord(row) {
 		suspendedAt: suspendedAt && suspendedAt.getTime() > 0 ? suspendedAt : void 0,
 		completedAt: completedAt && completedAt.getTime() > 0 ? completedAt : void 0,
 		ownerId: row.ownerId != null && row.ownerId !== "" ? String(row.ownerId) : void 0,
-		leaseExpiresAt
+		leaseExpiresAt,
+		expiresAt,
+		metadata: parseJson(row.metadata)
 	};
 }
 function escapeStr(val) {
 	return val.replace(/'/g, "''");
 }
 var StoreBackgroundTasksLance = class extends _mastra_core_storage.BackgroundTasksStorage {
+	supportsTaskExpiry = true;
 	client;
 	#db;
 	constructor(config) {
@@ -530,7 +536,9 @@ var StoreBackgroundTasksLance = class extends _mastra_core_storage.BackgroundTas
 				"suspend_payload",
 				"suspendedAt",
 				"ownerId",
-				"leaseExpiresAt"
+				"leaseExpiresAt",
+				"expiresAt",
+				"metadata"
 			]
 		});
 	}
@@ -552,11 +560,14 @@ var StoreBackgroundTasksLance = class extends _mastra_core_storage.BackgroundTas
 		if ("completedAt" in update) values.completedAt = update.completedAt?.getTime() ?? 0;
 		if ("ownerId" in update) values.ownerId = update.ownerId ?? null;
 		if ("leaseExpiresAt" in update) values.leaseExpiresAt = update.leaseExpiresAt?.getTime() ?? null;
+		if ("expiresAt" in update) values.expiresAt = update.expiresAt?.getTime() ?? null;
+		if ("metadata" in update) values.metadata = serializeJson(update.metadata) ?? null;
 		if (Object.keys(values).length === 0) return false;
 		const conditions = [`id = '${escapeStr(taskId)}'`];
 		if (options?.expectedStatus) conditions.push(`status = '${escapeStr(options.expectedStatus)}'`);
 		if (options?.expectedOwnerId !== void 0) conditions.push(options.expectedOwnerId === null ? "ownerId IS NULL" : `ownerId = '${escapeStr(options.expectedOwnerId)}'`);
 		if (options?.expectedLeaseExpiresAt !== void 0) conditions.push(options.expectedLeaseExpiresAt === null ? "leaseExpiresAt IS NULL" : `leaseExpiresAt = ${options.expectedLeaseExpiresAt.getTime()}`);
+		if (options?.expectedSuspendedAt !== void 0) conditions.push(options.expectedSuspendedAt === null ? "(suspendedAt IS NULL OR suspendedAt = 0)" : `suspendedAt = ${options.expectedSuspendedAt.getTime()}`);
 		return (await (await this.client.openTable(_mastra_core_storage.TABLE_BACKGROUND_TASKS)).update({
 			where: conditions.join(" AND "),
 			values
@@ -588,6 +599,7 @@ var StoreBackgroundTasksLance = class extends _mastra_core_storage.BackgroundTas
 			let query = table.query();
 			if (conditions.length > 0) query = query.where(conditions.join(" AND "));
 			let tasks = (await query.toArray()).map(fromRecord);
+			if (filter.hasExpiresAt !== void 0) tasks = tasks.filter((t) => t.expiresAt != null === filter.hasExpiresAt);
 			const dateCol = filter.dateFilterBy ?? "createdAt";
 			if (filter.fromDate) tasks = tasks.filter((t) => {
 				const val = t[dateCol];
@@ -1986,13 +1998,13 @@ var LanceFilterTranslator = class extends _mastra_core_vector_filter.BaseFilterT
 			if (keys.length > 1) return 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 this.processField(key, value);
 			}).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 this.processField(key, value);
 			}
 		}
 		return "";
@@ -2007,7 +2019,7 @@ var LanceFilterTranslator = class extends _mastra_core_vector_filter.BaseFilterT
 			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(_mastra_core_vector_filter.BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(keys[0]));
+				throw new Error(_mastra_core_vector_filter.BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(keys[0]));
 			}
 			if (keys.length > 1) return `(${this.processFilter(condition)})`;
 			return this.processFilter(condition);
@@ -2022,7 +2034,7 @@ var LanceFilterTranslator = class extends _mastra_core_vector_filter.BaseFilterT
 		return 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 this.processField(nestedPath, obj[key]);
 		}).join(" AND ");
 	}
 	processField(field, value) {
@@ -2594,7 +2606,8 @@ var LanceVectorStore = class LanceVectorStore extends _mastra_core_vector.Mastra
 				}
 				this.logger.debug(`Table ${resolvedTableName} created. Index creation deferred until data is available.`);
 				return;
-			} else table = await this.lanceClient.openTable(resolvedTableName);
+			}
+			table = await this.lanceClient.openTable(resolvedTableName);
 			const metricType = this.mastraMetricToLance(metric);
 			const rowCount = await table.countRows();
 			if (rowCount < 256) {