@mastra/libsql 1.27.0 → 1.27.1-alpha.1

package/dist/index.cjs

@@ -14,7 +14,7 @@ let _mastra_core_features = require("@mastra/core/features");
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_evals = require("@mastra/core/evals");
 let _mastra_core_storage_domains_skills = require("@mastra/core/storage/domains/skills");
-//#region src/shared/file-transaction-gate.ts
+// src/shared/file-transaction-gate.ts
 /** Interactive transactions open in this process, per database file. */
 const openTransactions = /* @__PURE__ */ new Map();
 /** The database file a local `file:` url points at, or `undefined` for anything else. */
@@ -151,8 +151,7 @@ function gateIfLocalFile(client, url, options) {
 	const key = localDatabaseFileKey(url);
 	return key ? gateLocalFileClient(client, key, options) : client;
 }
-//#endregion
-//#region src/shared/reset-after-busy-client.ts
+// src/shared/reset-after-busy-client.ts
 function isBusy(error) {
 	return error?.code === "SQLITE_BUSY";
 }
@@ -355,8 +354,7 @@ function resetConnectionsAfterBusy(client, { afterReset, maxWaitMs = 5e3 } = {})
 		}
 	} });
 }
-//#endregion
-//#region src/shared/single-connection-client.ts
+// src/shared/single-connection-client.ts
 /**
 * Whether `@libsql/client` backs this database with exactly one connection.
 *
@@ -434,8 +432,7 @@ function gateSingleConnectionClient(client) {
 		}
 	} });
 }
-//#endregion
-//#region src/vector/filter.ts
+// src/vector/filter.ts
 /**
 * Translates MongoDB-style filters to LibSQL compatible filters.
 *
@@ -481,8 +478,7 @@ var LibSQLFilterTranslator = class extends _mastra_core_vector_filter.BaseFilter
 		return result;
 	}
 };
-//#endregion
-//#region src/vector/sql-builder.ts
+// src/vector/sql-builder.ts
 const createBasicOperator = (symbol) => {
 	return (key, value) => {
 		const jsonPath = getJsonPath(key);
@@ -772,7 +768,7 @@ function handleLogicalOperator(key, value, parentPath) {
 	const values = [];
 	const joinOperator = key === "$or" || key === "$nor" ? "OR" : "AND";
 	const joined = (Array.isArray(value) ? value.flatMap((f) => {
-		const branch = (!!f ? Object.entries(f) : []).map(([k, v]) => buildCondition$1(k, v, key));
+		const branch = (f ? Object.entries(f) : []).map(([k, v]) => buildCondition$1(k, v, key));
 		if (branch.length <= 1) return branch;
 		return [{
 			sql: `(${branch.map((c) => c.sql).join(" AND ")})`,
@@ -816,8 +812,7 @@ const processOperator = (key, operator, operatorValue) => {
 		values: Array.isArray(transformed) ? transformed : [transformed]
 	};
 };
-//#endregion
-//#region src/vector/write-lock.ts
+// src/vector/write-lock.ts
 const databaseWriteChains = /* @__PURE__ */ new Map();
 async function getLocalFileDatabaseKey({ url, syncUrl, cwd }) {
 	if (!url.startsWith("file:") || url.includes(":memory:") || syncUrl) return;
@@ -841,8 +836,7 @@ function withLocalFileDatabaseWriteLock(key, fn) {
 	});
 	return result;
 }
-//#endregion
-//#region src/vector/index.ts
+// src/vector/index.ts
 var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	turso;
 	maxRetries;
@@ -1460,8 +1454,7 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 		});
 	}
 };
-//#endregion
-//#region src/storage/db/write-lock.ts
+// src/storage/db/write-lock.ts
 /**
 * Per-client write serialization.
 *
@@ -1497,8 +1490,7 @@ function withClientWriteLock(client, fn) {
 	clientWriteChains.set(client, result.then(() => void 0, () => void 0));
 	return result;
 }
-//#endregion
-//#region src/storage/db/run-fencing.ts
+// src/storage/db/run-fencing.ts
 /**
 * Epoch milliseconds on the database clock. `julianday('now')` rather than
 * `unixepoch('subsec')`, which needs SQLite 3.42 on the server.
@@ -1565,8 +1557,7 @@ function withRunFence(client, check, write) {
 		});
 	});
 }
-//#endregion
-//#region src/storage/db/utils.ts
+// src/storage/db/utils.ts
 const MAX_DEPTH = 100;
 /**
 * Safely serializes a value to JSON string with pre-sanitization.
@@ -1839,8 +1830,7 @@ function transformFromSqlRow({ tableName, sqlRow }) {
 	}
 	return result;
 }
-//#endregion
-//#region src/storage/db/index.ts
+// src/storage/db/index.ts
 /**
 * Default SQLite `busy_timeout` (ms) for local LibSQL connections. Chosen to
 * comfortably exceed the write-retry backoff window so contended writes block
@@ -2069,6 +2059,41 @@ var LibSQLDB = class extends _mastra_core_base.MastraBase {
 		});
 	}
 	/**
+	* Updates multiple records in one write batch, with the same retry behavior as
+	* {@link batchUpdate}. Returns, in input order, whether each update changed a row,
+	* so callers can put extra conditions in `keys` (for example `{ endedAt: null }`).
+	*/
+	async batchUpdateReportingChanges({ tableName, updates }) {
+		return this.executeWriteOperationWithRetry(async () => {
+			const changed = updates.map(() => false);
+			const statements = [];
+			const statementIndexes = [];
+			for (const [index, { keys, data }] of updates.entries()) {
+				const filteredData = await this.filterRecordToKnownColumns(tableName, data);
+				if (Object.keys(filteredData).length === 0) continue;
+				statements.push(prepareUpdateStatement({
+					tableName,
+					updates: filteredData,
+					keys
+				}));
+				statementIndexes.push(index);
+			}
+			if (statements.length === 0) return changed;
+			(await withClientWriteLock(this.client, () => this.client.batch(statements, "write"))).forEach((result, i) => {
+				const index = statementIndexes[i];
+				if (index !== void 0) changed[index] = result.rowsAffected > 0;
+			});
+			return changed;
+		}, `batch update in table ${tableName}`).catch((error) => {
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("LIBSQL", "BATCH_UPDATE_REPORTING_CHANGES", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
+				details: { tableName }
+			}, error);
+		});
+	}
+	/**
 	* Internal batch delete implementation without retry logic.
 	* Each record can be deleted based on single or composite keys.
 	*/
@@ -2201,7 +2226,7 @@ var LibSQLDB = class extends _mastra_core_base.MastraBase {
 	* @returns The total count of matching records
 	*/
 	async selectTotalCount({ tableName, whereClause }) {
-		const statement = `SELECT COUNT(*) as count FROM ${(0, _mastra_core_utils.parseSqlIdentifier)(tableName, "table name")} ${whereClause ? `${whereClause.sql}` : ""}`;
+		const statement = `SELECT COUNT(*) as count FROM ${(0, _mastra_core_utils.parseSqlIdentifier)(tableName, "table name")} ${whereClause ? whereClause.sql : ""}`;
 		const result = await this.client.execute({
 			sql: statement,
 			args: whereClause?.args ?? []
@@ -2573,8 +2598,7 @@ MIGRATION REQUIRED: Duplicate spans detected in ${_mastra_core_storage.TABLE_SPA
 		await this.client.execute(`CREATE INDEX IF NOT EXISTS "${parsedIndex}" ON "${parsedTable}" ("${parsedColumn}")`);
 	}
 };
-//#endregion
-//#region src/storage/domains/agents/index.ts
+// src/storage/domains/agents/index.ts
 var AgentsLibSQL = class extends _mastra_core_storage.AgentsStorage {
 	#db;
 	#client;
@@ -3318,8 +3342,7 @@ var AgentsLibSQL = class extends _mastra_core_storage.AgentsStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/retention.ts
+// src/storage/retention.ts
 async function ensureAnchorIndex(db, target, logger) {
 	if (!target.indexed) return;
 	try {
@@ -3359,8 +3382,7 @@ function resolveTargets({ policies, descriptor, order }) {
 		order
 	});
 }
-//#endregion
-//#region src/storage/domains/background-tasks/index.ts
+// src/storage/domains/background-tasks/index.ts
 function serializeJson(v) {
 	if (v === void 0) return null;
 	let serialized;
@@ -3685,8 +3707,7 @@ var BackgroundTasksLibSQL = class BackgroundTasksLibSQL extends _mastra_core_sto
 		return Number(result.rows[0]?.count ?? 0);
 	}
 };
-//#endregion
-//#region src/storage/domains/blobs/index.ts
+// src/storage/domains/blobs/index.ts
 var BlobsLibSQL = class extends _mastra_core_storage.BlobStore {
 	#db;
 	#client;
@@ -3784,8 +3805,7 @@ var BlobsLibSQL = class extends _mastra_core_storage.BlobStore {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/channels/index.ts
+// src/storage/domains/channels/index.ts
 var ChannelsLibSQL = class extends _mastra_core_storage.ChannelsStorage {
 	#db;
 	#client;
@@ -3933,8 +3953,7 @@ var ChannelsLibSQL = class extends _mastra_core_storage.ChannelsStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/utils.ts
+// src/storage/domains/utils.ts
 /**
 * Build additional `AND col = ?` conditions for a tenancy read-scope filter.
 * Returned in the shape expected by libsql's parameterized SQL builders.
@@ -3975,8 +3994,7 @@ function buildScopedWhere(idColumn, idValue, filters) {
 		args: [idValue, ...params]
 	};
 }
-//#endregion
-//#region src/storage/domains/datasets/index.ts
+// src/storage/domains/datasets/index.ts
 /** Serialize a value for a jsonb column. Returns null for null/undefined. */
 function jsonbArg(value) {
 	return value === void 0 || value === null ? null : JSON.stringify(value);
@@ -5244,8 +5262,7 @@ var DatasetsLibSQL = class extends _mastra_core_storage.DatasetsStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/experiments/index.ts
+// src/storage/domains/experiments/index.ts
 const DEFAULT_PRUNE_BATCH_SIZE = 1e3;
 const TAGS_IS_JSON = `CASE typeof(tags) WHEN 'blob' THEN 1 WHEN 'text' THEN json_valid(tags) ELSE 0 END`;
 var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
@@ -6099,8 +6116,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/favorites/index.ts
+// src/storage/domains/favorites/index.ts
 /**
 * Maps a favorite entity type to its parent entity table.
 */
@@ -6353,8 +6369,7 @@ var FavoritesLibSQL = class extends _mastra_core_storage.FavoritesStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/harness/index.ts
+// src/storage/domains/harness/index.ts
 const toDate$1 = (value) => new Date(value);
 const toOptionalDate = (value) => {
 	if (value == null) return void 0;
@@ -6498,8 +6513,7 @@ var HarnessLibSQL = class HarnessLibSQL extends _mastra_core_storage.HarnessStor
 		})).map(rowToSession);
 	}
 };
-//#endregion
-//#region ../../packages/_internal-core/dist/knowledge-compat/index.js
+// ../../packages/_internal-core/dist/knowledge-compat/index.js
 const KNOWLEDGE_V2_CORE_FEATURE = "knowledge-v2";
 /** Hard cap on scope nodes returned by one `listScopeNodes` read. */
 const MAX_KNOWLEDGE_SCOPE_NODES = 1e3;
@@ -7133,8 +7147,7 @@ function createKnowledgeV2CoreLoader(features, loadStorageModule) {
 		return knowledgeV2Core;
 	};
 }
-//#endregion
-//#region src/storage/domains/knowledge/index.ts
+// src/storage/domains/knowledge/index.ts
 const loadKnowledgeV2Core = createKnowledgeV2CoreLoader(_mastra_core_features.coreFeatures, () => import("@mastra/core/storage"));
 async function assertKnowledgeDescriptionWithinBoundCompat(description) {
 	const { assertKnowledgeDescriptionWithinBound } = await loadKnowledgeV2Core();
@@ -8469,8 +8482,7 @@ var KnowledgeLibSQL = class extends _mastra_core_storage.KnowledgeStorage {
 		});
 	}
 };
-//#endregion
-//#region src/storage/domains/mcp-clients/index.ts
+// src/storage/domains/mcp-clients/index.ts
 var MCPClientsLibSQL = class extends _mastra_core_storage.MCPClientsStorage {
 	#db;
 	#client;
@@ -8893,8 +8905,7 @@ var MCPClientsLibSQL = class extends _mastra_core_storage.MCPClientsStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/mcp-servers/index.ts
+// src/storage/domains/mcp-servers/index.ts
 var MCPServersLibSQL = class extends _mastra_core_storage.MCPServersStorage {
 	#db;
 	#client;
@@ -9324,8 +9335,7 @@ var MCPServersLibSQL = class extends _mastra_core_storage.MCPServersStorage {
 		};
 	}
 };
-//#endregion
-//#region ../../packages/_internal-core/dist/memory/index.js
+// ../../packages/_internal-core/dist/memory/index.js
 /**
 * Shared rules for observational memory lifecycle writes. Every storage adapter applies
 * these inside its own atomic section (lock, transaction, or conditional update), so the
@@ -9410,8 +9420,7 @@ function isAppendOnlySince(storedObservations, snapshotObservations) {
 	const snapshot = snapshotObservations ?? "";
 	return stored === snapshot || stored.startsWith(snapshot);
 }
-//#endregion
-//#region src/storage/domains/memory/index.ts
+// src/storage/domains/memory/index.ts
 /**
 * Local constant for the observational memory table name.
 * Defined locally to avoid a static import that crashes on older @mastra/core
@@ -11773,8 +11782,7 @@ var MemoryLibSQL = class MemoryLibSQL extends _mastra_core_storage.MemoryStorage
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/notifications/index.ts
+// src/storage/domains/notifications/index.ts
 /** Ids per UPDATE statement — keeps bind parameters well under SQLite's per-statement limit. */
 const BULK_ID_BATCH_SIZE = 500;
 const statusTimestamp = (status, now) => {
@@ -12145,8 +12153,7 @@ var NotificationsLibSQL = class NotificationsLibSQL extends _mastra_core_storage
 		return row ? rowToNotification(row) : void 0;
 	}
 };
-//#endregion
-//#region src/storage/domains/observability/index.ts
+// src/storage/domains/observability/index.ts
 var ObservabilityLibSQL = class ObservabilityLibSQL extends _mastra_core_storage.ObservabilityStorage {
 	/**
 	* Spans are the only physical table; traces are derived from them. Spans
@@ -12591,24 +12598,27 @@ var ObservabilityLibSQL = class ObservabilityLibSQL extends _mastra_core_storage
 			}, error);
 		}
 	}
-	async batchUpdateSpans(args) {
+	#toSpanUpdates(records) {
 		const now = (/* @__PURE__ */ new Date()).toISOString();
+		return records.map((record) => {
+			const data = { ...record.updates };
+			if (data.endedAt instanceof Date) data.endedAt = data.endedAt.toISOString();
+			if (data.startedAt instanceof Date) data.startedAt = data.startedAt.toISOString();
+			data.updatedAt = now;
+			return {
+				keys: {
+					spanId: record.spanId,
+					traceId: record.traceId
+				},
+				data
+			};
+		});
+	}
+	async batchUpdateSpans(args) {
 		try {
 			return this.#db.batchUpdate({
 				tableName: _mastra_core_storage.TABLE_SPANS,
-				updates: args.records.map((record) => {
-					const data = { ...record.updates };
-					if (data.endedAt instanceof Date) data.endedAt = data.endedAt.toISOString();
-					if (data.startedAt instanceof Date) data.startedAt = data.startedAt.toISOString();
-					data.updatedAt = now;
-					return {
-						keys: {
-							spanId: record.spanId,
-							traceId: record.traceId
-						},
-						data
-					};
-				})
+				updates: this.#toSpanUpdates(args.records)
 			});
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -12618,6 +12628,30 @@ var ObservabilityLibSQL = class ObservabilityLibSQL extends _mastra_core_storage
 			}, error);
 		}
 	}
+	async batchUpdateUnendedSpans(args) {
+		try {
+			const changed = await this.#db.batchUpdateReportingChanges({
+				tableName: _mastra_core_storage.TABLE_SPANS,
+				updates: this.#toSpanUpdates(args.records).map((update) => ({
+					...update,
+					keys: {
+						...update.keys,
+						endedAt: null
+					}
+				}))
+			});
+			return { updated: args.records.filter((_, index) => changed[index]).map(({ traceId, spanId }) => ({
+				traceId,
+				spanId
+			})) };
+		} catch (error) {
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("LIBSQL", "BATCH_UPDATE_UNENDED_SPANS", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.USER
+			}, error);
+		}
+	}
 	async batchDeleteTraces(args) {
 		this.assertUnscopedBatchDeleteTraces(args);
 		try {
@@ -12635,8 +12669,7 @@ var ObservabilityLibSQL = class ObservabilityLibSQL extends _mastra_core_storage
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/prompt-blocks/index.ts
+// src/storage/domains/prompt-blocks/index.ts
 var PromptBlocksLibSQL = class extends _mastra_core_storage.PromptBlocksStorage {
 	#db;
 	#client;
@@ -13062,8 +13095,7 @@ var PromptBlocksLibSQL = class extends _mastra_core_storage.PromptBlocksStorage
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/schedules/index.ts
+// src/storage/domains/schedules/index.ts
 function parseJson$1(val) {
 	if (val == null) return void 0;
 	if (typeof val === "string") try {
@@ -13411,8 +13443,7 @@ var SchedulesLibSQL = class SchedulesLibSQL extends _mastra_core_storage.Schedul
 		})).rows.map((r) => rowToTrigger(r));
 	}
 };
-//#endregion
-//#region src/storage/domains/scorer-definitions/index.ts
+// src/storage/domains/scorer-definitions/index.ts
 var ScorerDefinitionsLibSQL = class extends _mastra_core_storage.ScorerDefinitionsStorage {
 	#db;
 	#client;
@@ -13839,8 +13870,7 @@ var ScorerDefinitionsLibSQL = class extends _mastra_core_storage.ScorerDefinitio
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/scores/index.ts
+// src/storage/domains/scores/index.ts
 /** Appends multi-tenant scope conditions (`?` placeholders). Mutates inputs. */
 function appendTenancyConditions(conditions, args, filters) {
 	if (filters?.organizationId !== void 0) {
@@ -14176,8 +14206,7 @@ var ScoresLibSQL = class ScoresLibSQL extends _mastra_core_storage.ScoresStorage
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/skills/index.ts
+// src/storage/domains/skills/index.ts
 /**
 * Config fields that live on version rows (from StorageSkillSnapshotType).
 */
@@ -14743,8 +14772,7 @@ var SkillsLibSQL = class extends _mastra_core_storage.SkillsStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/thread-state/index.ts
+// src/storage/domains/thread-state/index.ts
 /**
 * LibSQL implementation of {@link ThreadStateStorage}.
 *
@@ -14876,8 +14904,7 @@ var ThreadStateLibSQL = class ThreadStateLibSQL extends _mastra_core_storage.Thr
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/tool-provider-connections/index.ts
+// src/storage/domains/tool-provider-connections/index.ts
 function normaliseScope(raw) {
 	const value = raw == null ? "per-author" : String(raw);
 	if (value === "shared") return "shared";
@@ -15087,8 +15114,7 @@ var ToolProviderConnectionsLibSQL = class extends _mastra_core_storage.ToolProvi
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workflow-definitions/index.ts
+// src/storage/domains/workflow-definitions/index.ts
 function parseJson(val, column, rowId) {
 	if (val == null) return void 0;
 	if (typeof val === "string") try {
@@ -15256,8 +15282,7 @@ var WorkflowDefinitionsLibSQL = class extends _mastra_core_storage.WorkflowDefin
 		});
 	}
 };
-//#endregion
-//#region src/storage/domains/workflows/index.ts
+// src/storage/domains/workflows/index.ts
 const RUN_OWNER_COLUMNS = `generation, ownerId, leaseExpiresAt, ${DB_NOW_MS} AS nowMs`;
 function toRunOwnershipRecord(runId, row) {
 	const leaseExpiresAt = row.leaseExpiresAt === null ? null : Number(row.leaseExpiresAt);
@@ -15315,6 +15340,9 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 	supportsConcurrentUpdates() {
 		return true;
 	}
+	supportsGuardedSnapshotWrites() {
+		return true;
+	}
 	parseWorkflowRun(row) {
 		let parsedSnapshot = row.snapshot;
 		if (typeof parsedSnapshot === "string") try {
@@ -15588,7 +15616,7 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 			}
 		}), "updateWorkflowState");
 	}
-	async persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot, createdAt, updatedAt, fence }) {
+	async persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot, createdAt, updatedAt, fence, expectedStatus }) {
 		const now = /* @__PURE__ */ new Date();
 		const createdAtValue = (createdAt ?? now).toISOString();
 		const updatedAtValue = (updatedAt ?? now).toISOString();
@@ -15596,21 +15624,30 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 			workflowName,
 			runId
 		});
+		const expected = expectedStatus === void 0 ? [] : Array.isArray(expectedStatus) ? expectedStatus : [expectedStatus];
+		const guard = expectedStatus === void 0 ? "" : expected.length ? ` WHERE json_extract(${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}.snapshot, '$.status') IN (${expected.map(() => "?").join(", ")})` : " WHERE 0";
 		const check = this.#runFenceCheck(fence, runId, "persistWorkflowSnapshot");
-		await this.executeWithRetry(() => withRunFence(this.#client, check, (writer) => writer.execute({
+		return (await this.executeWithRetry(() => withRunFence(this.#client, check, (writer) => writer.execute({
 			sql: `INSERT INTO ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT} (workflow_name, run_id, resourceId, snapshot, createdAt, updatedAt)
                 VALUES (?, ?, ?, jsonb(?), ?, ?)
                 ON CONFLICT(workflow_name, run_id)
-                DO UPDATE SET resourceId = COALESCE(excluded.resourceId, ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}.resourceId), snapshot = excluded.snapshot, updatedAt = excluded.updatedAt`,
+                DO UPDATE SET resourceId = COALESCE(excluded.resourceId, ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}.resourceId), snapshot = excluded.snapshot, updatedAt = excluded.updatedAt${guard}`,
 			args: [
 				workflowName,
 				runId,
 				resourceId ?? null,
 				safeStringify(snapshot),
 				createdAtValue,
-				updatedAtValue
+				updatedAtValue,
+				...expected
 			]
-		})), "persistWorkflowSnapshot");
+		})), "persistWorkflowSnapshot")).rowsAffected > 0;
+	}
+	async loadWorkflowRunStatus({ workflowName, runId }) {
+		return (await this.#client.execute({
+			sql: `SELECT json_extract(snapshot, '$.status') AS status FROM ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+			args: [workflowName, runId]
+		})).rows?.[0]?.status ?? null;
 	}
 	async loadWorkflowSnapshot({ workflowName, runId }) {
 		this.logger.debug("Loading workflow snapshot", {
@@ -15738,8 +15775,7 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workspaces/index.ts
+// src/storage/domains/workspaces/index.ts
 /**
 * Config fields that live on version rows (from StorageWorkspaceSnapshotType).
 */
@@ -16228,8 +16264,7 @@ var WorkspacesLibSQL = class extends _mastra_core_storage.WorkspacesStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/factory-storage.ts
+// src/storage/factory-storage.ts
 const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
 const COLUMN_DDL = {
 	text: "TEXT",
@@ -16644,8 +16679,7 @@ var LibSQLFactoryStorage = class extends _mastra_core_storage.FactoryStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/index.ts
+// src/storage/index.ts
 const REMOTE_INIT_CONCURRENCY = 5;
 const REMOTE_INIT_MAX_ATTEMPTS = 3;
 const DEFAULT_LOCAL_CACHE_SIZE = -16e3;
@@ -16862,8 +16896,7 @@ var LibSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 		if (!this.client.closed) await this.client.close();
 	}
 };
-//#endregion
-//#region src/vector/prompt.ts
+// src/vector/prompt.ts
 /**
 * Vector store specific prompt that details supported operators and examples.
 * This prompt helps users construct valid filters for LibSQL Vector.
@@ -16965,7 +16998,6 @@ Example Complex Query:
     ]}
   ]
 }`;
-//#endregion
 exports.AgentsLibSQL = AgentsLibSQL;
 exports.BackgroundTasksLibSQL = BackgroundTasksLibSQL;
 exports.BlobsLibSQL = BlobsLibSQL;