@mastra/convex 1.7.6-alpha.0 → 1.8.0-alpha.0

package/README.md

@@ -27,7 +27,7 @@ await vectorStore.createIndex({ indexName: 'documents', dimension: 1536 });
 ## Documentation
 
 - [Convex integration guide](https://mastra.ai/integrations/databases/convex)
-- [Convex vector reference](https://mastra.ai/reference/vectors/convex)
+- [Convex vector reference](https://mastra.ai/integrations/vectors/convex)
 
 ## Changelog
 

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-convex
 description: Documentation for @mastra/convex. Use when working with @mastra/convex APIs, configuration, or implementation.
 metadata:
   package: "@mastra/convex"
-  version: "1.7.6-alpha.0"
+  version: "1.8.0-alpha.0"
 ---
 
 ## When to use
@@ -17,10 +17,7 @@ Read the individual reference documents for detailed explanations and code examp
 ### Integrations
 
 - [Convex](references/integrations-databases-convex.md) - Store Mastra application data in Convex by defining schemas, deploying storage handlers, configuring the client, and enabling real-time serverless persistence.
-
-### Reference
-
-- [Reference: Convex vector store](references/reference-vectors-convex.md) - The ConvexVector class provides vector storage and similarity search using Convex. It stores embeddings inside Convex and performs cosine similarity search in the Mastra adapter.
+- [Convex](references/integrations-vectors-convex.md) - Store embeddings in Convex and query them from Mastra with cosine similarity and metadata filtering, for development-scale search.
 
 
 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.7.6-alpha.0",
+  "version": "1.8.0-alpha.0",
   "package": "@mastra/convex",
   "exports": {},
   "modules": {}

package/dist/docs/references/integrations-databases-convex.md

@@ -230,5 +230,5 @@ Set these environment variables for your deployment:
 
 ## Related
 
-- [Convex Vector Store](https://mastra.ai/reference/vectors/convex)
+- [Convex Vector Store](https://mastra.ai/integrations/vectors/convex)
 - [Convex Documentation](https://docs.convex.dev/)

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

@@ -42,6 +42,8 @@ Before using `ConvexVector`, you need to set up the Convex schema and storage ha
 
 ## Constructor options
 
+**id** (`string`): Unique identifier for this vector store instance
+
 **deploymentUrl** (`string`): Convex deployment URL (e.g., https\://your-project.convex.cloud)
 
 **adminAuthToken** (`string`): Convex admin authentication token
@@ -271,6 +273,16 @@ Deletes the index and all its vectors.
 await vectorStore.deleteIndex({ indexName: 'my_vectors' })
 ```
 
+### `truncateIndex()`
+
+Deletes every vector in an index while keeping the index itself. Rows are removed in batches so each mutation stays within Convex's per-mutation time limit. This method is available on `ConvexVector`; `ConvexNativeVector` uses Convex's own table operations instead.
+
+**indexName** (`string`): Name of the index to clear
+
+```typescript
+await vectorStore.truncateIndex({ indexName: 'my_vectors' })
+```
+
 ### `updateVector()`
 
 Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
@@ -346,7 +358,7 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```

package/dist/index.cjs

@@ -766,7 +766,9 @@ function toStored(task) {
 		suspendedAt: task.suspendedAt?.toISOString() ?? null,
 		completedAt: task.completedAt?.toISOString() ?? null,
 		ownerId: task.ownerId ?? null,
-		leaseExpiresAt: task.leaseExpiresAt?.toISOString() ?? null
+		leaseExpiresAt: task.leaseExpiresAt?.toISOString() ?? null,
+		expiresAt: task.expiresAt?.toISOString() ?? null,
+		metadata: serializeJson$1(task.metadata)
 	};
 }
 function toStoredPatch(update) {
@@ -783,6 +785,8 @@ function toStoredPatch(update) {
 	if ("completedAt" in update) patch.completedAt = update.completedAt?.toISOString() ?? null;
 	if ("ownerId" in update) patch.ownerId = update.ownerId ?? null;
 	if ("leaseExpiresAt" in update) patch.leaseExpiresAt = update.leaseExpiresAt?.toISOString() ?? null;
+	if ("expiresAt" in update) patch.expiresAt = update.expiresAt?.toISOString() ?? null;
+	if ("metadata" in update) patch.metadata = serializeJson$1(update.metadata);
 	return patch;
 }
 function legacyOrCurrent(stored, currentKey, legacyKey) {
@@ -819,13 +823,16 @@ function fromStored(stored) {
 		suspendedAt: record.suspendedAt ? new Date(record.suspendedAt) : void 0,
 		completedAt: record.completedAt ? new Date(record.completedAt) : void 0,
 		ownerId: record.ownerId ?? void 0,
-		leaseExpiresAt: record.leaseExpiresAt ? new Date(record.leaseExpiresAt) : void 0
+		leaseExpiresAt: record.leaseExpiresAt ? new Date(record.leaseExpiresAt) : void 0,
+		expiresAt: record.expiresAt ? new Date(record.expiresAt) : void 0,
+		metadata: parseJson(record.metadata)
 	};
 }
 function hasDeleteFilter(filter) {
-	return Boolean((Array.isArray(filter.status) ? filter.status.length > 0 : filter.status) || filter.agentId || filter.threadId || filter.resourceId || filter.toolName || filter.toolCallId || filter.runId || filter.fromDate || filter.toDate);
+	return Boolean((Array.isArray(filter.status) ? filter.status.length > 0 : filter.status) || filter.agentId || filter.threadId || filter.resourceId || filter.toolName || filter.toolCallId || filter.runId || filter.hasExpiresAt !== void 0 || filter.fromDate || filter.toDate);
 }
 var BackgroundTasksConvex = class extends _mastra_core_storage.BackgroundTasksStorage {
+	supportsTaskExpiry = true;
 	#db;
 	constructor(config) {
 		super();
@@ -848,6 +855,7 @@ var BackgroundTasksConvex = class extends _mastra_core_storage.BackgroundTasksSt
 		if (options?.expectedStatus) expected.status = options.expectedStatus;
 		if (options?.expectedOwnerId !== void 0) expected.ownerId = options.expectedOwnerId;
 		if (options?.expectedLeaseExpiresAt !== void 0) expected.leaseExpiresAt = options.expectedLeaseExpiresAt?.toISOString() ?? null;
+		if (options?.expectedSuspendedAt !== void 0) expected.suspendedAt = options.expectedSuspendedAt?.toISOString() ?? null;
 		return this.#db.patch({
 			tableName: _mastra_core_storage.TABLE_BACKGROUND_TASKS,
 			id: taskId,
@@ -907,6 +915,7 @@ var BackgroundTasksConvex = class extends _mastra_core_storage.BackgroundTasksSt
 		if (filter.toolName) tasks = tasks.filter((t) => t.toolName === filter.toolName);
 		if (filter.toolCallId) tasks = tasks.filter((t) => t.toolCallId === filter.toolCallId);
 		if (filter.runId) tasks = tasks.filter((t) => t.runId === filter.runId);
+		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];