@mastra/redis 1.4.6-alpha.0 → 1.4.7-alpha.0

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-redis
 description: Documentation for @mastra/redis. Use when working with @mastra/redis APIs, configuration, or implementation.
 metadata:
   package: "@mastra/redis"
-  version: "1.4.6-alpha.0"
+  version: "1.4.7-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.6-alpha.0",
+  "version": "1.4.7-alpha.0",
   "package": "@mastra/redis",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -60,8 +60,7 @@ function processRecord(tableName, record) {
 	else if (tableName === _mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT) key = getKey(tableName, {
 		namespace: record.namespace || "workflows",
 		workflow_name: record.workflow_name,
-		run_id: record.run_id,
-		...record.resourceId ? { resourceId: record.resourceId } : {}
+		run_id: record.run_id
 	});
 	else key = getKey(tableName, { id: record.id });
 	const processedRecord = {
@@ -1195,6 +1194,22 @@ function parseWorkflowRun(row) {
 		resourceId: row.resourceId
 	};
 }
+function escapeGlob(value) {
+	return value.replace(/[*?[\]\\]/g, "\\$&");
+}
+function snapshotKey(namespace, workflowName, runId) {
+	return getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
+		namespace,
+		workflow_name: workflowName,
+		run_id: runId
+	});
+}
+/**
+* Earlier versions appended `:resourceId:<id>` to snapshot keys. Matches those keys for a run.
+*/
+function legacySnapshotKeyPattern(namespace, workflowName, runId) {
+	return `${escapeGlob(snapshotKey(namespace, workflowName, runId))}:resourceId:*`;
+}
 var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 	client;
 	db;
@@ -1203,6 +1218,18 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 		this.client = config.client;
 		this.db = new RedisDB({ client: config.client });
 	}
+	/**
+	* Reads a run's snapshot record by its canonical key, falling back to legacy
+	* `:resourceId:`-suffixed keys only when the canonical key is missing.
+	*/
+	async getSnapshotRecord(namespace, workflowName, runId) {
+		const data = await this.client.get(snapshotKey(namespace, workflowName, runId));
+		if (data) return JSON.parse(data);
+		const legacyKeys = await this.db.scanKeys(legacySnapshotKeyPattern(namespace, workflowName, runId));
+		if (legacyKeys.length === 0) return null;
+		const legacyData = await this.client.get(legacyKeys[0]);
+		return legacyData ? JSON.parse(legacyData) : null;
+	}
 	supportsConcurrentUpdates() {
 		return false;
 	}
@@ -1211,14 +1238,7 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 	}
 	async updateWorkflowResults({ workflowName, runId, stepId, result, requestContext }) {
 		try {
-			const existingRecord = await this.db.get({
-				tableName: _mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT,
-				keys: {
-					namespace: "workflows",
-					workflow_name: workflowName,
-					run_id: runId
-				}
-			});
+			const existingRecord = await this.getSnapshotRecord("workflows", workflowName, runId);
 			let snapshot = existingRecord?.snapshot;
 			if (!snapshot) snapshot = {
 				context: {},
@@ -1243,6 +1263,7 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 				namespace: "workflows",
 				workflowName,
 				runId,
+				resourceId: existingRecord?.resourceId,
 				snapshot,
 				createdAt: existingRecord?.createdAt ? (0, _mastra_core_storage.ensureDate)(existingRecord.createdAt) : void 0
 			});
@@ -1263,14 +1284,7 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 	}
 	async updateWorkflowState({ workflowName, runId, opts }) {
 		try {
-			const existingRecord = await this.db.get({
-				tableName: _mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT,
-				keys: {
-					namespace: "workflows",
-					workflow_name: workflowName,
-					run_id: runId
-				}
-			});
+			const existingRecord = await this.getSnapshotRecord("workflows", workflowName, runId);
 			const existingSnapshot = existingRecord?.snapshot;
 			if (!existingSnapshot || !existingSnapshot.context) return;
 			const { expectedStatus, ...state } = opts;
@@ -1283,6 +1297,7 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 				namespace: "workflows",
 				workflowName,
 				runId,
+				resourceId: existingRecord.resourceId,
 				snapshot: updatedSnapshot,
 				createdAt: existingRecord?.createdAt ? (0, _mastra_core_storage.ensureDate)(existingRecord.createdAt) : void 0
 			});
@@ -1304,16 +1319,13 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 		const { namespace = "workflows", workflowName, runId, resourceId, snapshot, createdAt, updatedAt } = params;
 		try {
 			let finalCreatedAt = createdAt;
-			if (!finalCreatedAt) {
-				const existing = await this.db.get({
-					tableName: _mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT,
-					keys: {
-						namespace,
-						workflow_name: workflowName,
-						run_id: runId
-					}
-				});
-				finalCreatedAt = existing?.createdAt ? (0, _mastra_core_storage.ensureDate)(existing.createdAt) : /* @__PURE__ */ new Date();
+			let finalResourceId = resourceId;
+			if (!finalCreatedAt || !finalResourceId) {
+				const canonicalKey = snapshotKey(namespace, workflowName, runId);
+				const existingData = await this.client.get(canonicalKey) ?? (resourceId ? await this.client.get(`${canonicalKey}:resourceId:${resourceId}`) : null);
+				const existing = existingData ? JSON.parse(existingData) : null;
+				finalCreatedAt ??= existing?.createdAt ? (0, _mastra_core_storage.ensureDate)(existing.createdAt) : /* @__PURE__ */ new Date();
+				finalResourceId ??= existing?.resourceId;
 			}
 			await this.db.insert({
 				tableName: _mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT,
@@ -1321,7 +1333,7 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 					namespace,
 					workflow_name: workflowName,
 					run_id: runId,
-					resourceId,
+					resourceId: finalResourceId,
 					snapshot,
 					createdAt: finalCreatedAt,
 					updatedAt: updatedAt ?? /* @__PURE__ */ new Date()
@@ -1342,15 +1354,8 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 	}
 	async loadWorkflowSnapshot(params) {
 		const { namespace = "workflows", workflowName, runId } = params;
-		const key = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
-			namespace,
-			workflow_name: workflowName,
-			run_id: runId
-		});
 		try {
-			const data = await this.client.get(key);
-			if (!data) return null;
-			return JSON.parse(data).snapshot;
+			return (await this.getSnapshotRecord(namespace, workflowName, runId))?.snapshot ?? null;
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("REDIS", "LOAD_WORKFLOW_SNAPSHOT", "FAILED"),
@@ -1366,12 +1371,9 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 	}
 	async getWorkflowRunById({ runId, workflowName }) {
 		try {
-			const key = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
-				namespace: "workflows",
-				workflow_name: workflowName,
-				run_id: runId
-			}) + "*";
-			const keys = await this.db.scanKeys(key);
+			const workflowNamePattern = workflowName ? escapeGlob(workflowName) : "*";
+			const canonicalPattern = `${escapeGlob(getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, { namespace: "workflows" }))}:workflow_name:${workflowNamePattern}:run_id:${escapeGlob(runId)}`;
+			const keys = [...await this.db.scanKeys(canonicalPattern), ...await this.db.scanKeys(`${canonicalPattern}:resourceId:*`)];
 			if (keys.length === 0) return null;
 			const data = (await this.client.mGet(keys)).filter((data) => data !== null).map((data) => JSON.parse(data)).find((workflow) => {
 				if (!workflow) return false;
@@ -1395,13 +1397,9 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 		}
 	}
 	async deleteWorkflowRunById({ runId, workflowName }) {
-		const key = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
-			namespace: "workflows",
-			workflow_name: workflowName,
-			run_id: runId
-		});
 		try {
-			await this.client.del(key);
+			const legacyKeys = await this.db.scanKeys(legacySnapshotKeyPattern("workflows", workflowName, runId));
+			await this.client.del([snapshotKey("workflows", workflowName, runId), ...legacyKeys]);
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("REDIS", "DELETE_WORKFLOW_RUN_BY_ID", "FAILED"),
@@ -1425,29 +1423,30 @@ var WorkflowsRedis = class extends _mastra_core_storage.WorkflowsStorage {
 			}, /* @__PURE__ */ new Error("page must be >= 0"));
 			const normalizedFrom = fromDate ? (0, _mastra_core_storage.ensureDate)(fromDate) : void 0;
 			const normalizedTo = toDate ? (0, _mastra_core_storage.ensureDate)(toDate) : void 0;
-			let pattern = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, { namespace: "workflows" }) + ":*";
-			if (workflowName && resourceId) pattern = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
-				namespace: "workflows",
-				workflow_name: workflowName,
-				run_id: "*",
-				resourceId
-			});
-			else if (workflowName) pattern = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
+			const pattern = workflowName ? `${escapeGlob(getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
 				namespace: "workflows",
 				workflow_name: workflowName
-			}) + ":*";
-			else if (resourceId) pattern = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
-				namespace: "workflows",
-				workflow_name: "*",
-				run_id: "*",
-				resourceId
-			});
+			}))}:*` : `${getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, { namespace: "workflows" })}:*`;
 			const keys = await this.db.scanKeys(pattern);
 			if (keys.length === 0) return {
 				runs: [],
 				total: 0
 			};
-			let runs = (await this.client.mGet(keys)).filter((data) => data !== null).map((data) => JSON.parse(data)).filter((record) => record !== null && record !== void 0 && typeof record === "object" && "workflow_name" in record).filter((record) => !workflowName || record.workflow_name === workflowName).map((w) => parseWorkflowRun(w)).filter((w) => {
+			const results = await this.client.mGet(keys);
+			const recordsByRun = /* @__PURE__ */ new Map();
+			results.forEach((data, index) => {
+				if (data === null) return;
+				const record = JSON.parse(data);
+				if (record === null || typeof record !== "object" || !("workflow_name" in record)) return;
+				const legacy = keys[index] !== snapshotKey(record.namespace ?? "workflows", record.workflow_name, record.run_id);
+				const runKey = `${record.workflow_name}\u0000${record.run_id}`;
+				const current = recordsByRun.get(runKey);
+				if (!current || current.legacy && !legacy) recordsByRun.set(runKey, {
+					record,
+					legacy
+				});
+			});
+			let runs = [...recordsByRun.values()].map(({ record }) => record).filter((record) => !workflowName || record.workflow_name === workflowName).filter((record) => !resourceId || record.resourceId === resourceId).map((w) => parseWorkflowRun(w)).filter((w) => {
 				if (normalizedFrom && w.createdAt < normalizedFrom) return false;
 				if (normalizedTo && w.createdAt > normalizedTo) return false;
 				if (status) {