@mastra/convex 1.7.3 → 1.7.4-alpha.0

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.3"
+  version: "1.7.4-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.3",
+  "version": "1.7.4-alpha.0",
   "package": "@mastra/convex",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_server = require("./server-Bcgr5CcA.cjs");
+const require_server = require("./server-uHLma0g7.cjs");
 const require_schema = require("./schema.cjs");
 let _mastra_core_cache = require("@mastra/core/cache");
 let _mastra_core_storage = require("@mastra/core/storage");
@@ -401,6 +401,17 @@ async function retireRunFence(client, fence) {
 	});
 	return applied;
 }
+/** Deletes up to `limit` claims whose epoch-ms `column` is older than `cutoff`. Returns how many were deleted. */
+async function pruneRunClaims(client, tableName, column, cutoff, limit) {
+	const { result } = await callRunClaim(client, {
+		op: "pruneRunClaims",
+		tableName,
+		column,
+		cutoff,
+		limit
+	}, "prune");
+	return result;
+}
 //#endregion
 //#region src/storage/types.ts
 /**
@@ -1174,7 +1185,18 @@ function parseStoredOMRecord(doc) {
 		supersededBy: doc.supersededBy ?? null
 	};
 }
-var MemoryConvex = class extends _mastra_core_storage.MemoryStorage {
+var MemoryConvex = class MemoryConvex extends _mastra_core_storage.MemoryStorage {
+	/**
+	* Tables `prune()` can clean up. Run fences anchor on `retiredAt` (epoch ms), which stays unset until the
+	* execution holding the fence settles, so a running execution's fence is
+	* never pruned.
+	*/
+	static retentionTables = { runFences: {
+		table: _mastra_core_storage.TABLE_MEMORY_RUN_FENCES,
+		column: "retiredAt",
+		indexed: false,
+		anchorType: "epoch-ms"
+	} };
 	supportsPartialThreadUpdate = true;
 	supportsObservationalMemory = true;
 	supportsObservationalMemoryHistorySearch = true;
@@ -1207,6 +1229,19 @@ var MemoryConvex = class extends _mastra_core_storage.MemoryStorage {
 		return this.#db.fenced(this.#runFenceCheck(fence, operation));
 	}
 	async init() {}
+	async prune(policies, options) {
+		return (0, _mastra_core_storage.executeRetentionPrune)({
+			domain: "memory",
+			targets: (0, _mastra_core_storage.resolveRetentionTargets)({
+				policies,
+				descriptor: MemoryConvex.retentionTables,
+				order: ["runFences"]
+			}),
+			options,
+			cutoffFor: (target, now) => (0, _mastra_core_storage.retentionCutoffMs)(target.policy, now),
+			deleteBatch: (_target, cutoff, limit) => pruneRunClaims(this.#client, _mastra_core_storage.TABLE_MEMORY_RUN_FENCES, "retiredAt", Number(cutoff), limit)
+		});
+	}
 	async dangerouslyClearAll() {
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_THREADS });
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_MESSAGES });
@@ -2272,7 +2307,18 @@ var ScoresConvex = class extends _mastra_core_storage.ScoresStorage {
 };
 //#endregion
 //#region src/storage/domains/workflows/index.ts
-var WorkflowsConvex = class extends _mastra_core_storage.WorkflowsStorage {
+var WorkflowsConvex = class WorkflowsConvex extends _mastra_core_storage.WorkflowsStorage {
+	/**
+	* Tables `prune()` can clean up. Run ownership records anchor on `updatedAt` (epoch ms), which every
+	* claim, renewal and release refreshes, so a live execution's record is never
+	* older than its renew interval.
+	*/
+	static retentionTables = { runOwnership: {
+		table: _mastra_core_storage.TABLE_WORKFLOW_RUN_OWNERS,
+		column: "updatedAt",
+		indexed: false,
+		anchorType: "epoch-ms"
+	} };
 	#db;
 	#client;
 	constructor(config) {
@@ -2287,6 +2333,19 @@ var WorkflowsConvex = class extends _mastra_core_storage.WorkflowsStorage {
 		return true;
 	}
 	async init() {}
+	async prune(policies, options) {
+		return (0, _mastra_core_storage.executeRetentionPrune)({
+			domain: "workflows",
+			targets: (0, _mastra_core_storage.resolveRetentionTargets)({
+				policies,
+				descriptor: WorkflowsConvex.retentionTables,
+				order: ["runOwnership"]
+			}),
+			options,
+			cutoffFor: (target, now) => (0, _mastra_core_storage.retentionCutoffMs)(target.policy, now),
+			deleteBatch: (_target, cutoff, limit) => pruneRunClaims(this.#client, _mastra_core_storage.TABLE_WORKFLOW_RUN_OWNERS, "updatedAt", Number(cutoff), limit)
+		});
+	}
 	async dangerouslyClearAll() {
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT });
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_WORKFLOW_RUN_OWNERS });