@mastra/mssql 1.10.5-alpha.0 → 1.10.6-alpha.0

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.10.5-alpha.0",
+  "version": "1.10.6-alpha.0",
   "package": "@mastra/mssql",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-storage-retention.md

@@ -294,7 +294,7 @@ const storage = new MongoDBStore({
 
 ## Reclaiming disk
 
-`prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist and are reused by future writes, so the file stops growing: for most users this alone solves the unbounded-growth problem.
+`prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist for reuse by future writes. Reusing these pages prevents unbounded file growth for most users.
 
 Handing that free space back to the OS is a separate concern that Mastra doesn't manage. If you specifically need to shrink the file, run the underlying database's compaction (for example `VACUUM` on self-hosted libSQL) yourself in a maintenance window. A full `VACUUM` locks the file and needs roughly twice the file size in free disk. On PostgreSQL, autovacuum reclaims dead tuples for reuse automatically. A manual `VACUUM FULL` is only needed if you must return disk to the OS.
 

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -16,11 +16,10 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let _mastra_core_error = require("@mastra/core/error");
 let _mastra_core_storage = require("@mastra/core/storage");
 let mssql = require("mssql");
@@ -29,7 +28,7 @@ let _mastra_core_utils = require("@mastra/core/utils");
 let _mastra_core_base = require("@mastra/core/base");
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_evals = require("@mastra/core/evals");
-//#region src/storage/db/utils.ts
+// src/storage/db/utils.ts
 function getSchemaName$1(schema) {
 	return schema ? `[${(0, _mastra_core_utils.parseSqlIdentifier)(schema, "schema name")}]` : void 0;
 }
@@ -38,8 +37,7 @@ function getTableName$1({ indexName, schemaName }) {
 	const quotedSchemaName = schemaName;
 	return quotedSchemaName ? `${quotedSchemaName}.${quotedIndexName}` : quotedIndexName;
 }
-//#endregion
-//#region src/storage/db/index.ts
+// src/storage/db/index.ts
 /**
 * Resolves MssqlDomainConfig to pool and schema.
 * Domain classes create their own MssqlDB instance from the returned pool.
@@ -1057,8 +1055,7 @@ MIGRATION REQUIRED: Duplicate spans detected in ${duplicateInfo.tableName}\n====
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/utils.ts
+// src/storage/domains/utils.ts
 function getSchemaName(schema) {
 	return schema ? `[${(0, _mastra_core_utils.parseSqlIdentifier)(schema, "schema name")}]` : void 0;
 }
@@ -1134,21 +1131,22 @@ function prepareWhereClause(filters, _schema) {
 				}
 				conditions.push(`[${(0, _mastra_core_utils.parseSqlIdentifier)(key, "field name")}] IN (${inParamNames.join(", ")})`);
 			}
-		} else if (Array.isArray(value)) if (value.length === 0) conditions.push("1 = 0");
-		else if (value.length === 1) {
-			const paramName = `p${paramIndex++}`;
-			conditions.push(`[${(0, _mastra_core_utils.parseSqlIdentifier)(key, "field name")}] = @${paramName}`);
-			params[paramName] = value[0] instanceof Date ? value[0].toISOString() : value[0];
-		} else {
-			const inParamNames = [];
-			for (const item of value) {
+		} else if (Array.isArray(value)) {
+			if (value.length === 0) conditions.push("1 = 0");
+			else if (value.length === 1) {
 				const paramName = `p${paramIndex++}`;
-				inParamNames.push(`@${paramName}`);
-				params[paramName] = item instanceof Date ? item.toISOString() : item;
+				conditions.push(`[${(0, _mastra_core_utils.parseSqlIdentifier)(key, "field name")}] = @${paramName}`);
+				params[paramName] = value[0] instanceof Date ? value[0].toISOString() : value[0];
+			} else {
+				const inParamNames = [];
+				for (const item of value) {
+					const paramName = `p${paramIndex++}`;
+					inParamNames.push(`@${paramName}`);
+					params[paramName] = item instanceof Date ? item.toISOString() : item;
+				}
+				conditions.push(`[${(0, _mastra_core_utils.parseSqlIdentifier)(key, "field name")}] IN (${inParamNames.join(", ")})`);
 			}
-			conditions.push(`[${(0, _mastra_core_utils.parseSqlIdentifier)(key, "field name")}] IN (${inParamNames.join(", ")})`);
-		}
-		else {
+		} else {
 			const paramName = `p${paramIndex++}`;
 			conditions.push(`[${(0, _mastra_core_utils.parseSqlIdentifier)(key, "field name")}] = @${paramName}`);
 			params[paramName] = value instanceof Date ? value.toISOString() : value;
@@ -1179,8 +1177,7 @@ function transformFromSqlRow({ tableName, sqlRow }) {
 	});
 	return result;
 }
-//#endregion
-//#region src/storage/domains/agents/index.ts
+// src/storage/domains/agents/index.ts
 var AgentsMSSQL = class AgentsMSSQL extends _mastra_core_storage.AgentsStorage {
 	pool;
 	schema;
@@ -1768,8 +1765,7 @@ var AgentsMSSQL = class AgentsMSSQL extends _mastra_core_storage.AgentsStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/background-tasks/index.ts
+// src/storage/domains/background-tasks/index.ts
 function serializeJson(v) {
 	if (typeof v === "object" && v != null) return JSON.stringify(v);
 	return v ?? null;
@@ -1983,15 +1979,19 @@ var BackgroundTasksMSSQL = class BackgroundTasksMSSQL extends _mastra_core_stora
 			params[`p${idx}`] = options.expectedStatus;
 			predicates.push(`[status] = @p${idx++}`);
 		}
-		if (options?.expectedOwnerId !== void 0) if (options.expectedOwnerId === null) predicates.push(`[ownerId] IS NULL`);
-		else {
-			params[`p${idx}`] = options.expectedOwnerId;
-			predicates.push(`[ownerId] = @p${idx++}`);
+		if (options?.expectedOwnerId !== void 0) {
+			if (options.expectedOwnerId === null) predicates.push(`[ownerId] IS NULL`);
+			else {
+				params[`p${idx}`] = options.expectedOwnerId;
+				predicates.push(`[ownerId] = @p${idx++}`);
+			}
 		}
-		if (options?.expectedLeaseExpiresAt !== void 0) if (options.expectedLeaseExpiresAt === null) predicates.push(`[leaseExpiresAt] IS NULL`);
-		else {
-			params[`p${idx}`] = options.expectedLeaseExpiresAt.toISOString();
-			predicates.push(`[leaseExpiresAt] = @p${idx++}`);
+		if (options?.expectedLeaseExpiresAt !== void 0) {
+			if (options.expectedLeaseExpiresAt === null) predicates.push(`[leaseExpiresAt] IS NULL`);
+			else {
+				params[`p${idx}`] = options.expectedLeaseExpiresAt.toISOString();
+				predicates.push(`[leaseExpiresAt] = @p${idx++}`);
+			}
 		}
 		const predicateSql = predicates.length > 0 ? ` AND ${predicates.join(" AND ")}` : "";
 		const request = this.pool.request();
@@ -2126,8 +2126,7 @@ var BackgroundTasksMSSQL = class BackgroundTasksMSSQL extends _mastra_core_stora
 		return Number(result.recordset[0]?.count ?? 0);
 	}
 };
-//#endregion
-//#region src/storage/db/run-fencing.ts
+// src/storage/db/run-fencing.ts
 /**
 * Epoch milliseconds on the database clock. SQL Server evaluates
 * `SYSUTCDATETIME()` once when a statement starts, so a statement that waits
@@ -2148,10 +2147,11 @@ const MAX_CLAIM_ATTEMPTS = 5;
 */
 async function assertRunFence(q, claimsTable, fence, operation) {
 	const row = (await q.request().input("runId", fence.runId).query(`SELECT [generation], [ownerId] FROM ${claimsTable} WITH (HOLDLOCK) WHERE [runId] = @runId`)).recordset[0];
-	if (!(0, _mastra_core_storage.matchesRunFence)(row ? {
+	const current = row ? {
 		generation: Number(row.generation),
 		ownerId: String(row.ownerId)
-	} : null, fence)) throw new _mastra_core_storage.RunFenceConflictError(fence, operation);
+	} : null;
+	if (!(0, _mastra_core_storage.matchesRunFence)(current, fence)) throw new _mastra_core_storage.RunFenceConflictError(fence, operation);
 }
 /** Runs `fn` in a transaction. */
 async function inTransaction(pool, fn) {
@@ -2193,8 +2193,7 @@ async function claimTransaction(pool, fn) {
 		if (attempt >= MAX_CLAIM_ATTEMPTS || !(number === ERR_DEADLOCK_VICTIM || number === ERR_PRIMARY_KEY || number === ERR_UNIQUE_INDEX)) throw error;
 	}
 }
-//#endregion
-//#region src/storage/domains/memory/index.ts
+// src/storage/domains/memory/index.ts
 function bindMssqlMetadataParams(request, params) {
 	for (const [paramName, paramValue] of Object.entries(params)) request.input(paramName, paramValue);
 }
@@ -2396,13 +2395,14 @@ var MemoryMSSQL = class MemoryMSSQL extends _mastra_core_storage.MemoryStorage {
 		}
 	}
 	async prune(policies, options) {
+		const targets = (0, _mastra_core_storage.resolveRetentionTargets)({
+			policies,
+			descriptor: MemoryMSSQL.retentionTables,
+			order: ["runFences"]
+		});
 		return (0, _mastra_core_storage.executeRetentionPrune)({
 			domain: "memory",
-			targets: (0, _mastra_core_storage.resolveRetentionTargets)({
-				policies,
-				descriptor: MemoryMSSQL.retentionTables,
-				order: ["runFences"]
-			}),
+			targets,
 			options,
 			cutoffFor: (target, now) => (0, _mastra_core_storage.retentionCutoffMs)(target.policy, now),
 			deleteBatch: (target, cutoff, limit) => this.db.pruneBatch({
@@ -3353,8 +3353,7 @@ var MemoryMSSQL = class MemoryMSSQL extends _mastra_core_storage.MemoryStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/observability/index.ts
+// src/storage/domains/observability/index.ts
 var ObservabilityMSSQL = class ObservabilityMSSQL extends _mastra_core_storage.ObservabilityStorage {
 	static retentionTables = { spans: {
 		table: _mastra_core_storage.TABLE_SPANS,
@@ -3384,13 +3383,14 @@ var ObservabilityMSSQL = class ObservabilityMSSQL extends _mastra_core_storage.O
 		this.indexes = indexes?.filter((idx) => ObservabilityMSSQL.MANAGED_TABLES.includes(idx.table));
 	}
 	async prune(policies, options) {
+		const targets = (0, _mastra_core_storage.resolveRetentionTargets)({
+			policies,
+			descriptor: ObservabilityMSSQL.retentionTables,
+			order: ["spans"]
+		});
 		return (0, _mastra_core_storage.executeRetentionPrune)({
 			domain: "observability",
-			targets: (0, _mastra_core_storage.resolveRetentionTargets)({
-				policies,
-				descriptor: ObservabilityMSSQL.retentionTables,
-				order: ["spans"]
-			}),
+			targets,
 			options,
 			cutoffFor: (target, now) => new Date((0, _mastra_core_storage.retentionCutoffMs)(target.policy, now)),
 			deleteBatch: (target, cutoff, limit) => this.db.pruneBatch({
@@ -3853,18 +3853,18 @@ var ObservabilityMSSQL = class ObservabilityMSSQL extends _mastra_core_storage.O
 					case _mastra_core_storage.TraceStatus.RUNNING:
 						conditions.push(`r.[endedAt] IS NULL AND r.[error] IS NULL`);
 						break;
-					case _mastra_core_storage.TraceStatus.SUCCESS:
-						conditions.push(`r.[endedAt] IS NOT NULL AND r.[error] IS NULL`);
-						break;
+					case _mastra_core_storage.TraceStatus.SUCCESS: conditions.push(`r.[endedAt] IS NOT NULL AND r.[error] IS NULL`);
 				}
-				if (filters.hasChildError !== void 0) if (filters.hasChildError) conditions.push(`EXISTS (
+				if (filters.hasChildError !== void 0) {
+					if (filters.hasChildError) conditions.push(`EXISTS (
               SELECT 1 FROM ${tableName} c
               WHERE c.[traceId] = r.[traceId] AND c.[error] IS NOT NULL
             )`);
-				else conditions.push(`NOT EXISTS (
+					else conditions.push(`NOT EXISTS (
               SELECT 1 FROM ${tableName} c
               WHERE c.[traceId] = r.[traceId] AND c.[error] IS NOT NULL
             )`);
+				}
 			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
 			const sortField = orderBy?.field ?? "startedAt";
@@ -3994,8 +3994,7 @@ var ObservabilityMSSQL = class ObservabilityMSSQL extends _mastra_core_storage.O
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/scores/index.ts
+// src/storage/domains/scores/index.ts
 /**
 * MSSQL-specific score row transformation.
 * Converts timestamp strings to Date objects.
@@ -4411,8 +4410,7 @@ var ScoresMSSQL = class ScoresMSSQL extends _mastra_core_storage.ScoresStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workflow-definitions/index.ts
+// src/storage/domains/workflow-definitions/index.ts
 function parseJson(value, column, rowId) {
 	if (value == null) return null;
 	if (typeof value === "string") try {
@@ -4615,8 +4613,7 @@ var WorkflowDefinitionsMSSQL = class WorkflowDefinitionsMSSQL extends _mastra_co
 		await request.query(`DELETE FROM ${tableName} WHERE [id] = @id`);
 	}
 };
-//#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);
@@ -4707,13 +4704,14 @@ var WorkflowsMSSQL = class WorkflowsMSSQL extends _mastra_core_storage.Workflows
 		}
 	}
 	async prune(policies, options) {
+		const targets = (0, _mastra_core_storage.resolveRetentionTargets)({
+			policies,
+			descriptor: WorkflowsMSSQL.retentionTables,
+			order: ["runOwnership"]
+		});
 		return (0, _mastra_core_storage.executeRetentionPrune)({
 			domain: "workflows",
-			targets: (0, _mastra_core_storage.resolveRetentionTargets)({
-				policies,
-				descriptor: WorkflowsMSSQL.retentionTables,
-				order: ["runOwnership"]
-			}),
+			targets,
 			options,
 			cutoffFor: (target, now) => (0, _mastra_core_storage.retentionCutoffMs)(target.policy, now),
 			deleteBatch: (target, cutoff, limit) => this.db.pruneBatch({
@@ -5098,10 +5096,12 @@ var WorkflowsMSSQL = class WorkflowsMSSQL extends _mastra_core_storage.Workflows
 				conditions.push(`JSON_VALUE([snapshot], '$.status') = @status`);
 				paramMap["status"] = status;
 			}
-			if (resourceId) if (await this.db.hasColumn(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, "resourceId")) {
-				conditions.push(`[resourceId] = @resourceId`);
-				paramMap["resourceId"] = resourceId;
-			} else this.logger?.warn?.(`[${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
+			if (resourceId) {
+				if (await this.db.hasColumn(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, "resourceId")) {
+					conditions.push(`[resourceId] = @resourceId`);
+					paramMap["resourceId"] = resourceId;
+				} else this.logger?.warn?.(`[${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
+			}
 			if (fromDate instanceof Date && !isNaN(fromDate.getTime())) {
 				conditions.push(`[createdAt] >= @fromDate`);
 				paramMap[`fromDate`] = fromDate.toISOString();
@@ -5150,8 +5150,7 @@ var WorkflowsMSSQL = class WorkflowsMSSQL extends _mastra_core_storage.Workflows
 		}
 	}
 };
-//#endregion
-//#region src/storage/index.ts
+// src/storage/index.ts
 /**
 * Type guard for pre-configured pool config
 */
@@ -5264,12 +5263,8 @@ var MSSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 		}
 	}
 	async _performInitializationAndStore() {
-		try {
-			await this.pool.connect();
-			return true;
-		} catch (err) {
-			throw err;
-		}
+		await this.pool.connect();
+		return true;
 	}
 	/**
 	* Closes the MSSQL connection pool.
@@ -5280,7 +5275,6 @@ var MSSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 		await this.pool.close();
 	}
 };
-//#endregion
 exports.AgentsMSSQL = AgentsMSSQL;
 exports.BackgroundTasksMSSQL = BackgroundTasksMSSQL;
 exports.MSSQLStore = MSSQLStore;