@mastra/convex 1.7.3 → 1.7.4-alpha.0

package/dist/index.js

@@ -1,7 +1,7 @@
-import { a as mastraCache, i as mastraStorage, n as mastraNativeVectorMutation, r as mastraNativeVectorQuery, t as mastraNativeVectorAction } from "./server-B8RSiOmu.js";
+import { a as mastraCache, i as mastraStorage, n as mastraNativeVectorMutation, r as mastraNativeVectorQuery, t as mastraNativeVectorAction } from "./server-DCzSpppl.js";
 import { TABLE_BACKGROUND_TASKS, TABLE_CHANNEL_CONFIG, TABLE_CHANNEL_INSTALLATIONS, TABLE_MESSAGES, TABLE_OBSERVATIONAL_MEMORY, TABLE_RESOURCES, TABLE_SCHEDULES, TABLE_SCHEDULE_TRIGGERS, TABLE_SCORERS, TABLE_THREADS, TABLE_WORKFLOW_SNAPSHOT, defineMastraNativeVectorTable, mastraBackgroundTasksTable, mastraCacheListItemsTable, mastraCacheTable, mastraChannelConfigTable, mastraChannelInstallationsTable, mastraDocumentsTable, mastraMessagesTable, mastraObservationalMemoryTable, mastraResourcesTable, mastraScheduleTriggersTable, mastraSchedulesTable, mastraScoresTable, mastraThreadsTable, mastraVectorIndexesTable, mastraVectorsTable, mastraWorkflowSnapshotsTable } from "./schema.js";
 import { MastraServerCache } from "@mastra/core/cache";
-import { BackgroundTasksStorage, ChannelsStorage, MastraCompositeStore, MemoryStorage, RUN_FENCE_CONFLICT_ERROR_ID, RunFenceConflictError, SchedulesStorage, ScoresStorage, TABLE_BACKGROUND_TASKS as TABLE_BACKGROUND_TASKS$1, TABLE_CHANNEL_CONFIG as TABLE_CHANNEL_CONFIG$1, TABLE_CHANNEL_INSTALLATIONS as TABLE_CHANNEL_INSTALLATIONS$1, TABLE_MEMORY_RUN_FENCES, TABLE_MESSAGES as TABLE_MESSAGES$1, TABLE_RESOURCES as TABLE_RESOURCES$1, TABLE_SCHEDULES as TABLE_SCHEDULES$1, TABLE_SCHEDULE_TRIGGERS as TABLE_SCHEDULE_TRIGGERS$1, TABLE_SCORERS as TABLE_SCORERS$1, TABLE_THREADS as TABLE_THREADS$1, TABLE_WORKFLOW_RUN_OWNERS, TABLE_WORKFLOW_SNAPSHOT as TABLE_WORKFLOW_SNAPSHOT$1, WorkflowsStorage, calculatePagination, createStorageErrorId, createVectorErrorId, filterByDateRange, normalizePerPage, normalizeScheduleTarget, resolveRunFence, safelyParseJSON, storageMessageMatchesMetadataFilter, validateStorageMetadataFilter } from "@mastra/core/storage";
+import { BackgroundTasksStorage, ChannelsStorage, MastraCompositeStore, MemoryStorage, RUN_FENCE_CONFLICT_ERROR_ID, RunFenceConflictError, SchedulesStorage, ScoresStorage, TABLE_BACKGROUND_TASKS as TABLE_BACKGROUND_TASKS$1, TABLE_CHANNEL_CONFIG as TABLE_CHANNEL_CONFIG$1, TABLE_CHANNEL_INSTALLATIONS as TABLE_CHANNEL_INSTALLATIONS$1, TABLE_MEMORY_RUN_FENCES, TABLE_MESSAGES as TABLE_MESSAGES$1, TABLE_RESOURCES as TABLE_RESOURCES$1, TABLE_SCHEDULES as TABLE_SCHEDULES$1, TABLE_SCHEDULE_TRIGGERS as TABLE_SCHEDULE_TRIGGERS$1, TABLE_SCORERS as TABLE_SCORERS$1, TABLE_THREADS as TABLE_THREADS$1, TABLE_WORKFLOW_RUN_OWNERS, TABLE_WORKFLOW_SNAPSHOT as TABLE_WORKFLOW_SNAPSHOT$1, WorkflowsStorage, calculatePagination, createStorageErrorId, createVectorErrorId, executeRetentionPrune, filterByDateRange, normalizePerPage, normalizeScheduleTarget, resolveRetentionTargets, resolveRunFence, retentionCutoffMs, safelyParseJSON, storageMessageMatchesMetadataFilter, validateStorageMetadataFilter } from "@mastra/core/storage";
 import { MastraBase } from "@mastra/core/base";
 import { MessageList } from "@mastra/core/agent";
 import { ErrorCategory, ErrorDomain, MastraError } from "@mastra/core/error";
@@ -399,6 +399,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
 /**
@@ -1172,7 +1183,18 @@ function parseStoredOMRecord(doc) {
 		supersededBy: doc.supersededBy ?? null
 	};
 }
-var MemoryConvex = class extends MemoryStorage {
+var MemoryConvex = class MemoryConvex extends 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: TABLE_MEMORY_RUN_FENCES,
+		column: "retiredAt",
+		indexed: false,
+		anchorType: "epoch-ms"
+	} };
 	supportsPartialThreadUpdate = true;
 	supportsObservationalMemory = true;
 	supportsObservationalMemoryHistorySearch = true;
@@ -1205,6 +1227,19 @@ var MemoryConvex = class extends MemoryStorage {
 		return this.#db.fenced(this.#runFenceCheck(fence, operation));
 	}
 	async init() {}
+	async prune(policies, options) {
+		return executeRetentionPrune({
+			domain: "memory",
+			targets: resolveRetentionTargets({
+				policies,
+				descriptor: MemoryConvex.retentionTables,
+				order: ["runFences"]
+			}),
+			options,
+			cutoffFor: (target, now) => retentionCutoffMs(target.policy, now),
+			deleteBatch: (_target, cutoff, limit) => pruneRunClaims(this.#client, TABLE_MEMORY_RUN_FENCES, "retiredAt", Number(cutoff), limit)
+		});
+	}
 	async dangerouslyClearAll() {
 		await this.#db.clearTable({ tableName: TABLE_THREADS$1 });
 		await this.#db.clearTable({ tableName: TABLE_MESSAGES$1 });
@@ -2270,7 +2305,18 @@ var ScoresConvex = class extends ScoresStorage {
 };
 //#endregion
 //#region src/storage/domains/workflows/index.ts
-var WorkflowsConvex = class extends WorkflowsStorage {
+var WorkflowsConvex = class WorkflowsConvex extends 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: TABLE_WORKFLOW_RUN_OWNERS,
+		column: "updatedAt",
+		indexed: false,
+		anchorType: "epoch-ms"
+	} };
 	#db;
 	#client;
 	constructor(config) {
@@ -2285,6 +2331,19 @@ var WorkflowsConvex = class extends WorkflowsStorage {
 		return true;
 	}
 	async init() {}
+	async prune(policies, options) {
+		return executeRetentionPrune({
+			domain: "workflows",
+			targets: resolveRetentionTargets({
+				policies,
+				descriptor: WorkflowsConvex.retentionTables,
+				order: ["runOwnership"]
+			}),
+			options,
+			cutoffFor: (target, now) => retentionCutoffMs(target.policy, now),
+			deleteBatch: (_target, cutoff, limit) => pruneRunClaims(this.#client, TABLE_WORKFLOW_RUN_OWNERS, "updatedAt", Number(cutoff), limit)
+		});
+	}
 	async dangerouslyClearAll() {
 		await this.#db.clearTable({ tableName: TABLE_WORKFLOW_SNAPSHOT$1 });
 		await this.#db.clearTable({ tableName: TABLE_WORKFLOW_RUN_OWNERS });