@mastra/pg 1.23.0-alpha.0 → 1.23.0-alpha.2

package/dist/index.cjs

@@ -44,7 +44,11 @@ let _mastra_core_storage_domains_skills = require("@mastra/core/storage/domains/
 * Type guard for pre-configured pg.Pool config
 */
 const isPoolConfig = (cfg) => {
-	return "pool" in cfg;
+	return "pool" in cfg && cfg.pool !== void 0;
+};
+/** Type guard for an explicitly named pre-configured writer pool. */
+const isWritePoolConfig = (cfg) => {
+	return "writePool" in cfg && cfg.writePool !== void 0;
 };
 /**
 * Type guard for connection string config
@@ -69,10 +73,8 @@ const isCloudSqlConfig = (cfg) => {
 */
 const validateConfig = (name, config) => {
 	if (!config.id || typeof config.id !== "string" || config.id.trim() === "") throw new Error(`${name}: id must be provided and cannot be empty.`);
-	if (isPoolConfig(config)) {
-		if (!config.pool) throw new Error(`${name}: pool must be provided when using pool config.`);
-		return;
-	}
+	if ("pool" in config && "writePool" in config) throw new Error(`${name}: provide either pool or writePool, not both.`);
+	if (isPoolConfig(config) || isWritePoolConfig(config)) return;
 	if (isConnectionStringConfig(config)) {
 		if (!config.connectionString || typeof config.connectionString !== "string" || config.connectionString.trim() === "") throw new Error(`${name}: connectionString must be provided and cannot be empty. Passing an empty string may cause fallback to local Postgres defaults.`);
 	} else if (isCloudSqlConfig(config)) {} else if (isHostConfig(config)) {
@@ -2383,16 +2385,21 @@ async function loadSchemaSnapshot(client, schemaName) {
 function resolvePgConfig(config) {
 	if ("client" in config) return {
 		client: config.client,
+		readClient: config.readClient ?? config.client,
 		schemaName: config.schemaName,
 		skipDefaultIndexes: config.skipDefaultIndexes,
 		indexes: config.indexes
 	};
-	if ("pool" in config) return {
-		client: new PoolAdapter(config.pool),
-		schemaName: config.schemaName,
-		skipDefaultIndexes: config.skipDefaultIndexes,
-		indexes: config.indexes
-	};
+	if ("pool" in config) {
+		const client = new PoolAdapter(config.pool);
+		return {
+			client,
+			readClient: config.readPool && config.readPool !== config.pool ? new PoolAdapter(config.readPool) : client,
+			schemaName: config.schemaName,
+			skipDefaultIndexes: config.skipDefaultIndexes,
+			indexes: config.indexes
+		};
+	}
 	let pool;
 	if ("connectionString" in config) pool = new pg.Pool({
 		connectionString: config.connectionString,
@@ -2409,8 +2416,10 @@ function resolvePgConfig(config) {
 	pool.on("error", (err) => {
 		console.warn(`resolvePgConfig: idle pool client error (pool discards the client and reconnects on next checkout): ${err instanceof Error ? err.message : String(err)}`);
 	});
+	const client = new PoolAdapter(pool);
 	return {
-		client: new PoolAdapter(pool),
+		client,
+		readClient: client,
 		schemaName: config.schemaName,
 		skipDefaultIndexes: config.skipDefaultIndexes,
 		indexes: config.indexes
@@ -2618,6 +2627,7 @@ function assertPositiveLimit(limit) {
 }
 var PgDB = class extends _mastra_core_base.MastraBase {
 	client;
+	readClient;
 	schemaName;
 	skipDefaultIndexes;
 	/** Cache of actual table columns: tableName -> Set<columnName> */
@@ -2630,6 +2640,7 @@ var PgDB = class extends _mastra_core_base.MastraBase {
 			name: "PG_DB_LAYER"
 		});
 		this.client = config.client;
+		this.readClient = config.readClient ?? config.client;
 		this.schemaName = config.schemaName;
 		this.skipDefaultIndexes = config.skipDefaultIndexes;
 	}
@@ -3885,9 +3896,10 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_AGENTS, _mastra_core_storage.TABLE_AGENT_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -4146,12 +4158,19 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 		};
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_AGENTS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseRow(result);
 		} catch (error) {
@@ -4236,7 +4255,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				indexName: _mastra_core_storage.TABLE_AGENTS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			if (!await this.getById(id)) throw new _mastra_core_error.MastraError({
+			if (!await this.#getById(this.#db.client, id)) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_AGENT", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
 				category: _mastra_core_error.ErrorCategory.USER,
@@ -4274,7 +4293,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 			values.push(now);
 			values.push(id);
 			await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedAgent = await this.getById(id);
+			const updatedAgent = await this.#getById(this.#db.client, id);
 			if (!updatedAgent) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_AGENT", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -4371,7 +4390,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 			const joinClause = useJoin && joinSqlIdx !== null ? `LEFT JOIN ${favoritesTable} s ON s."entityType" = 'agent' AND s."entityId" = a.id AND s."userId" = $${joinSqlIdx}` : "";
 			const joinParams = useJoin && joinUserId ? [joinUserId] : [];
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} a ${joinClause} ${whereClause}`, [...joinParams, ...queryParams]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} a ${joinClause} ${whereClause}`, [...joinParams, ...queryParams]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				agents: [],
@@ -4389,7 +4408,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 			const limitIdx = paramIdx++;
 			const offsetIdx = paramIdx++;
 			return {
-				agents: (await this.#db.client.manyOrNone(`SELECT a.* FROM ${tableName} a ${joinClause} ${whereClause} ${orderByClause} LIMIT $${limitIdx} OFFSET $${offsetIdx}`, [
+				agents: (await this.#db.readClient.manyOrNone(`SELECT a.* FROM ${tableName} a ${joinClause} ${whereClause} ${orderByClause} LIMIT $${limitIdx} OFFSET $${offsetIdx}`, [
 					...joinParams,
 					...queryParams,
 					limitValue,
@@ -4489,7 +4508,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				indexName: _mastra_core_storage.TABLE_AGENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -4510,7 +4529,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				schemaName: getSchemaName$5(this.#schema)
 			});
 			const placeholders = ids.map((_, i) => `$${i + 1}`).join(", ");
-			return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE id IN (${placeholders})`, ids)).map((row) => this.parseVersionRow(row));
+			return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE id IN (${placeholders})`, ids)).map((row) => this.parseVersionRow(row));
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
 			throw new _mastra_core_error.MastraError({
@@ -4527,7 +4546,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				indexName: _mastra_core_storage.TABLE_AGENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "agentId" = $1 AND "versionNumber" = $2`, [agentId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "agentId" = $1 AND "versionNumber" = $2`, [agentId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -4549,7 +4568,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				indexName: _mastra_core_storage.TABLE_AGENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "agentId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [agentId]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "agentId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [agentId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -4578,7 +4597,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				indexName: _mastra_core_storage.TABLE_AGENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "agentId" = $1`, [agentId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "agentId" = $1`, [agentId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -4589,7 +4608,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "agentId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "agentId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					agentId,
 					limitValue,
 					offset
@@ -4659,7 +4678,7 @@ var AgentsPG = class AgentsPG extends _mastra_core_storage.AgentsStorage {
 				indexName: _mastra_core_storage.TABLE_AGENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "agentId" = $1`, [agentId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "agentId" = $1`, [agentId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -4916,9 +4935,10 @@ var BackgroundTasksPG = class BackgroundTasksPG extends _mastra_core_storage.Bac
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -5170,7 +5190,7 @@ var BackgroundTasksPG = class BackgroundTasksPG extends _mastra_core_storage.Bac
 			params.push(filter.toDate.toISOString());
 		}
 		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-		const countResult = await this.#db.client.oneOrNone(`SELECT COUNT(*) as count FROM ${table} ${where}`, params.slice(0, paramIdx - 1));
+		const countResult = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) as count FROM ${table} ${where}`, params.slice(0, paramIdx - 1));
 		const total = Number(countResult?.count ?? 0);
 		let sql = `SELECT * FROM ${table} ${where} ORDER BY ${filter.orderBy === "startedAt" ? "\"startedAt\"" : filter.orderBy === "suspendedAt" ? "\"suspendedAt\"" : filter.orderBy === "completedAt" ? "\"completedAt\"" : "\"createdAt\""} ${filter.orderDirection === "desc" ? "DESC" : "ASC"}`;
 		if (filter.perPage != null) {
@@ -5182,7 +5202,7 @@ var BackgroundTasksPG = class BackgroundTasksPG extends _mastra_core_storage.Bac
 			}
 		}
 		return {
-			tasks: (await this.#db.client.manyOrNone(sql, params)).map(rowToTask),
+			tasks: (await this.#db.readClient.manyOrNone(sql, params)).map(rowToTask),
 			total
 		};
 	}
@@ -5219,12 +5239,12 @@ var BackgroundTasksPG = class BackgroundTasksPG extends _mastra_core_storage.Bac
 	}
 	async getRunningCount() {
 		const table = getTableName$4(getSchemaName$4(this.#schema));
-		const result = await this.#db.client.oneOrNone(`SELECT COUNT(*) FROM ${table} WHERE "status" = 'running'`);
+		const result = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) FROM ${table} WHERE "status" = 'running'`);
 		return Number(result?.count ?? 0);
 	}
 	async getRunningCountByAgent(agentId) {
 		const table = getTableName$4(getSchemaName$4(this.#schema));
-		const result = await this.#db.client.oneOrNone(`SELECT COUNT(*) FROM ${table} WHERE "status" = 'running' AND "agent_id" = $1`, [agentId]);
+		const result = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) FROM ${table} WHERE "status" = 'running' AND "agent_id" = $1`, [agentId]);
 		return Number(result?.count ?? 0);
 	}
 };
@@ -5236,9 +5256,10 @@ var BlobsPG = class extends _mastra_core_storage.BlobStore {
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_SKILL_BLOBS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -5280,7 +5301,7 @@ var BlobsPG = class extends _mastra_core_storage.BlobStore {
 			indexName: _mastra_core_storage.TABLE_SKILL_BLOBS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "hash" = $1`, [hash]);
+		const row = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "hash" = $1`, [hash]);
 		if (!row) return null;
 		return this.#parseRow(row);
 	}
@@ -5289,7 +5310,7 @@ var BlobsPG = class extends _mastra_core_storage.BlobStore {
 			indexName: _mastra_core_storage.TABLE_SKILL_BLOBS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		return await this.#db.client.oneOrNone(`SELECT 1 FROM ${tableName} WHERE "hash" = $1 LIMIT 1`, [hash]) !== null;
+		return await this.#db.readClient.oneOrNone(`SELECT 1 FROM ${tableName} WHERE "hash" = $1 LIMIT 1`, [hash]) !== null;
 	}
 	async delete(hash) {
 		const tableName = getTableName$5({
@@ -5310,7 +5331,7 @@ var BlobsPG = class extends _mastra_core_storage.BlobStore {
 			schemaName: getSchemaName$5(this.#schema)
 		});
 		const placeholders = hashes.map((_, i) => `$${i + 1}`).join(", ");
-		const rows = await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "hash" IN (${placeholders})`, hashes);
+		const rows = await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "hash" IN (${placeholders})`, hashes);
 		for (const row of rows) {
 			const entry = this.#parseRow(row);
 			result.set(entry.hash, entry);
@@ -5340,9 +5361,10 @@ var ChannelsPG = class ChannelsPG extends _mastra_core_storage.ChannelsStorage {
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_CHANNEL_INSTALLATIONS, _mastra_core_storage.TABLE_CHANNEL_CONFIG];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -5449,7 +5471,7 @@ var ChannelsPG = class ChannelsPG extends _mastra_core_storage.ChannelsStorage {
 			indexName: _mastra_core_storage.TABLE_CHANNEL_INSTALLATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1`, [id]);
+		const row = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1`, [id]);
 		return row ? this.#parseInstallationRow(row) : null;
 	}
 	async getInstallationByAgent(platform, agentId) {
@@ -5457,7 +5479,7 @@ var ChannelsPG = class ChannelsPG extends _mastra_core_storage.ChannelsStorage {
 			indexName: _mastra_core_storage.TABLE_CHANNEL_INSTALLATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1 AND "agentId" = $2 ORDER BY CASE "status" WHEN 'active' THEN 0 WHEN 'pending' THEN 1 ELSE 2 END, "updatedAt" DESC LIMIT 1`, [platform, agentId]);
+		const row = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1 AND "agentId" = $2 ORDER BY CASE "status" WHEN 'active' THEN 0 WHEN 'pending' THEN 1 ELSE 2 END, "updatedAt" DESC LIMIT 1`, [platform, agentId]);
 		return row ? this.#parseInstallationRow(row) : null;
 	}
 	async getInstallationByWebhookId(webhookId) {
@@ -5465,7 +5487,7 @@ var ChannelsPG = class ChannelsPG extends _mastra_core_storage.ChannelsStorage {
 			indexName: _mastra_core_storage.TABLE_CHANNEL_INSTALLATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "webhookId" = $1`, [webhookId]);
+		const row = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "webhookId" = $1`, [webhookId]);
 		return row ? this.#parseInstallationRow(row) : null;
 	}
 	async listInstallations(platform) {
@@ -5473,7 +5495,7 @@ var ChannelsPG = class ChannelsPG extends _mastra_core_storage.ChannelsStorage {
 			indexName: _mastra_core_storage.TABLE_CHANNEL_INSTALLATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1 ORDER BY "createdAt" DESC`, [platform])).map((row) => this.#parseInstallationRow(row));
+		return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1 ORDER BY "createdAt" DESC`, [platform])).map((row) => this.#parseInstallationRow(row));
 	}
 	async deleteInstallation(id) {
 		const tableName = getTableName$5({
@@ -5505,7 +5527,7 @@ var ChannelsPG = class ChannelsPG extends _mastra_core_storage.ChannelsStorage {
 			indexName: _mastra_core_storage.TABLE_CHANNEL_CONFIG,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1`, [platform]);
+		const row = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1`, [platform]);
 		if (!row) return null;
 		return {
 			platform: row.platform,
@@ -5553,9 +5575,10 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 	];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -5816,7 +5839,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			};
 		} catch (error) {
 			if (input.id !== void 0 && (0, _mastra_core_storage.hasErrorCode)(error, /* @__PURE__ */ new Set(["23505"]))) {
-				const existing = await this.getDatasetById({ id: input.id });
+				const existing = await this.#getDatasetById(this.#db.client, { id: input.id });
 				if (existing) return this.resolveExistingDataset(existing, {
 					...input,
 					id: input.id
@@ -5830,7 +5853,20 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			}, error);
 		}
 	}
-	async getDatasetById({ id, filters }) {
+	async getDatasetById(args) {
+		return this.#getDatasetById(this.#db.readClient, args);
+	}
+	getDatasetForMutation(args) {
+		return this.#getDatasetById(this.#db.client, args);
+	}
+	listItemsForMutation(args) {
+		return this.#listItems(this.#db.client, args);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getDatasetById(client, { id, filters }) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_DATASETS,
@@ -5838,7 +5874,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			});
 			const { conditions, params } = tenancyWhere(filters, 2);
 			const whereSql = ["\"id\" = $1", ...conditions].join(" AND ");
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE ${whereSql}`, [id, ...params]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE ${whereSql}`, [id, ...params]);
 			return result ? this.transformDatasetRow(result) : null;
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -5850,7 +5886,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 	}
 	async _doUpdateDataset(args) {
 		try {
-			const existing = await this.getDatasetById({
+			const existing = await this.#getDatasetById(this.#db.client, {
 				id: args.id,
 				filters: args.filters
 			});
@@ -6022,7 +6058,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 				}
 			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				datasets: [],
@@ -6037,7 +6073,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			const { offset, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				datasets: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "createdAt" DESC, "id" ASC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
+				datasets: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "createdAt" DESC, "id" ASC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -6141,7 +6177,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 	}
 	async _doUpdateItem(args) {
 		try {
-			const existing = await this.getItemById({ id: args.id });
+			const existing = await this.#getItemById(this.#db.client, { id: args.id });
 			if (!existing) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_ITEM", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -6247,7 +6283,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 	}
 	async _doDeleteItem({ id, datasetId }) {
 		try {
-			const existing = await this.getItemById({ id });
+			const existing = await this.#getItemById(this.#db.client, { id });
 			if (!existing) return;
 			if (existing.datasetId !== datasetId) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "DELETE_ITEM", "DATASET_MISMATCH"),
@@ -6414,7 +6450,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 	}
 	async _doBatchDeleteItems(input) {
 		try {
-			const dataset = await this.getDatasetById({ id: input.datasetId });
+			const dataset = await this.#getDatasetById(this.#db.client, { id: input.datasetId });
 			if (!dataset) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "BULK_DELETE_ITEMS", "DATASET_NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -6423,7 +6459,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			});
 			const currentItems = [];
 			for (const itemId of input.itemIds) {
-				const item = await this.getItemById({ id: itemId });
+				const item = await this.#getItemById(this.#db.client, { id: itemId });
 				if (item && item.datasetId === input.datasetId) currentItems.push(item);
 			}
 			if (currentItems.length === 0) return;
@@ -6487,14 +6523,17 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 		}
 	}
 	async getItemById(args) {
+		return this.#getItemById(this.#db.readClient, args);
+	}
+	async #getItemById(client, args) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_DATASET_ITEMS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
 			let result;
-			if (args.datasetVersion !== void 0) result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1 AND "datasetVersion" <= $2 AND ("validTo" IS NULL OR "validTo" > $2) AND "isDeleted" = false ORDER BY "datasetVersion" DESC LIMIT 1`, [args.id, args.datasetVersion]);
-			else result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1 AND "validTo" IS NULL AND "isDeleted" = false`, [args.id]);
+			if (args.datasetVersion !== void 0) result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1 AND "datasetVersion" <= $2 AND ("validTo" IS NULL OR "validTo" > $2) AND "isDeleted" = false ORDER BY "datasetVersion" DESC LIMIT 1`, [args.id, args.datasetVersion]);
+			else result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1 AND "validTo" IS NULL AND "isDeleted" = false`, [args.id]);
 			return result ? this.transformItemRow(result) : null;
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -6510,7 +6549,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 				indexName: _mastra_core_storage.TABLE_DATASET_ITEMS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "datasetId" = $1 AND "datasetVersion" <= $2 AND ("validTo" IS NULL OR "validTo" > $3) AND "isDeleted" = false ORDER BY "createdAt" DESC, "id" ASC`, [
+			return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "datasetId" = $1 AND "datasetVersion" <= $2 AND ("validTo" IS NULL OR "validTo" > $3) AND "isDeleted" = false ORDER BY "createdAt" DESC, "id" ASC`, [
 				datasetId,
 				version,
 				version
@@ -6529,7 +6568,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 				indexName: _mastra_core_storage.TABLE_DATASET_ITEMS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1 ORDER BY "datasetVersion" DESC`, [itemId]) || []).map((row) => this.transformItemRowFull(row));
+			return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1 ORDER BY "datasetVersion" DESC`, [itemId]) || []).map((row) => this.transformItemRowFull(row));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "GET_ITEM_HISTORY", "FAILED"),
@@ -6539,6 +6578,13 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 		}
 	}
 	async listItems(args) {
+		return this.#listItems(this.#db.readClient, args);
+	}
+	/**
+	* Same listing against an explicit client. `updateDataset` validates existing
+	* items on the writer so a lagging replica cannot hide freshly inserted rows.
+	*/
+	async #listItems(client, args) {
 		try {
 			const { page, perPage: perPageInput } = args.pagination;
 			const tableName = getTableName$5({
@@ -6575,7 +6621,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 				}
 			}
 			const whereClause = `WHERE ${conditions.join(" AND ")}`;
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				items: [],
@@ -6590,7 +6636,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			const { offset, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				items: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "createdAt" DESC, "id" ASC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
+				items: (await client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "createdAt" DESC, "id" ASC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -6645,7 +6691,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 				indexName: _mastra_core_storage.TABLE_DATASET_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "datasetId" = $1`, [input.datasetId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "datasetId" = $1`, [input.datasetId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -6660,7 +6706,7 @@ var DatasetsPG = class DatasetsPG extends _mastra_core_storage.DatasetsStorage {
 			const { offset, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "datasetId" = $1 ORDER BY "version" DESC LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "datasetId" = $1 ORDER BY "version" DESC LIMIT $2 OFFSET $3`, [
 					input.datasetId,
 					limitValue,
 					offset
@@ -6710,9 +6756,10 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -7050,7 +7097,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 	}
 	async updateExperiment(input) {
 		try {
-			if (!await this.getExperimentById({ id: input.id })) throw new _mastra_core_error.MastraError({
+			if (!await this.#getExperimentById(this.#db.client, { id: input.id })) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_EXPERIMENT", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
 				category: _mastra_core_error.ErrorCategory.USER,
@@ -7106,7 +7153,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			}
 			values.push(input.id);
 			await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE "id" = $${paramIndex}`, values);
-			return await this.getExperimentById({ id: input.id });
+			return await this.#getExperimentById(this.#db.client, { id: input.id });
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
 			throw new _mastra_core_error.MastraError({
@@ -7116,7 +7163,14 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			}, error);
 		}
 	}
-	async getExperimentById({ id, filters }) {
+	async getExperimentById(args) {
+		return this.#getExperimentById(this.#db.readClient, args);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getExperimentById(client, { id, filters }) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_EXPERIMENTS,
@@ -7124,7 +7178,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			});
 			const { conditions, params } = tenancyWhere(filters, 2);
 			const whereSql = ["\"id\" = $1", ...conditions].join(" AND ");
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE ${whereSql}`, [id, ...params]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE ${whereSql}`, [id, ...params]);
 			return result ? this.transformExperimentRow(result) : null;
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -7192,7 +7246,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 				}
 			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				experiments: [],
@@ -7207,7 +7261,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			const { offset, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				experiments: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
+				experiments: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -7411,7 +7465,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 				values.push(input.comment);
 			}
 			if (setClauses.length === 0) {
-				const existing = await this.getExperimentResultById({ id: input.id });
+				const existing = await this.#getExperimentResultById(this.#db.client, { id: input.id });
 				if (!existing) throw new _mastra_core_error.MastraError({
 					id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_EXPERIMENT_RESULT", "NOT_FOUND"),
 					domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -7444,7 +7498,14 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			}, error);
 		}
 	}
-	async getExperimentResultById({ id, filters }) {
+	async getExperimentResultById(args) {
+		return this.#getExperimentResultById(this.#db.readClient, args);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getExperimentResultById(client, { id, filters }) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_EXPERIMENT_RESULTS,
@@ -7452,7 +7513,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			});
 			const { conditions, params } = tenancyWhere(filters, 2);
 			const whereSql = ["\"id\" = $1", ...conditions].join(" AND ");
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE ${whereSql}`, [id, ...params]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE ${whereSql}`, [id, ...params]);
 			return result ? this.transformExperimentResultRow(result) : null;
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -7492,7 +7553,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 				}
 			}
 			const whereClause = `WHERE ${conditions.join(" AND ")}`;
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				results: [],
@@ -7507,7 +7568,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 			const { offset, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				results: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "startedAt" ASC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
+				results: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "startedAt" ASC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -7561,7 +7622,7 @@ var ExperimentsPG = class ExperimentsPG extends _mastra_core_storage.Experiments
 				indexName: _mastra_core_storage.TABLE_EXPERIMENT_RESULTS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			return (await this.#db.client.manyOrNone(`SELECT
+			return (await this.#db.readClient.manyOrNone(`SELECT
           "experimentId",
           COUNT(*)::int as total,
           SUM(CASE WHEN status = 'needs-review' THEN 1 ELSE 0 END)::int as "needsReview",
@@ -7603,9 +7664,10 @@ var FavoritesPG = class FavoritesPG extends _mastra_core_storage.FavoritesStorag
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_FAVORITES];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -7771,7 +7833,7 @@ var FavoritesPG = class FavoritesPG extends _mastra_core_storage.FavoritesStorag
 			schemaName: getSchemaName$5(this.#schema)
 		});
 		try {
-			return await this.#db.client.oneOrNone(`SELECT 1 FROM ${fullFavoritesTable} WHERE "userId" = $1 AND "entityType" = $2 AND "entityId" = $3 LIMIT 1`, [
+			return await this.#db.readClient.oneOrNone(`SELECT 1 FROM ${fullFavoritesTable} WHERE "userId" = $1 AND "entityType" = $2 AND "entityId" = $3 LIMIT 1`, [
 				input.userId,
 				input.entityType,
 				input.entityId
@@ -7794,7 +7856,7 @@ var FavoritesPG = class FavoritesPG extends _mastra_core_storage.FavoritesStorag
 		});
 		try {
 			const placeholders = entityIds.map((_, i) => `$${i + 3}`).join(", ");
-			const rows = await this.#db.client.manyOrNone(`SELECT "entityId" FROM ${fullFavoritesTable} WHERE "userId" = $1 AND "entityType" = $2 AND "entityId" IN (${placeholders})`, [
+			const rows = await this.#db.readClient.manyOrNone(`SELECT "entityId" FROM ${fullFavoritesTable} WHERE "userId" = $1 AND "entityType" = $2 AND "entityId" IN (${placeholders})`, [
 				userId,
 				entityType,
 				...entityIds
@@ -7817,7 +7879,7 @@ var FavoritesPG = class FavoritesPG extends _mastra_core_storage.FavoritesStorag
 			schemaName: getSchemaName$5(this.#schema)
 		});
 		try {
-			return (await this.#db.client.manyOrNone(`SELECT "entityId" FROM ${fullFavoritesTable} WHERE "userId" = $1 AND "entityType" = $2 ORDER BY "createdAt" DESC, "entityId" ASC`, [input.userId, input.entityType]) ?? []).map((row) => row.entityId);
+			return (await this.#db.readClient.manyOrNone(`SELECT "entityId" FROM ${fullFavoritesTable} WHERE "userId" = $1 AND "entityType" = $2 ORDER BY "createdAt" DESC, "entityId" ASC`, [input.userId, input.entityType]) ?? []).map((row) => row.entityId);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
 			throw new _mastra_core_error.MastraError({
@@ -8120,16 +8182,20 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 	}
 	#client;
 	#executor;
+	/** Reader-backed executor for standalone reads; mutations and read-modify-write stay on #executor. */
+	#readExecutor;
 	#db;
 	#schemaName;
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
 		this.#client = client;
 		this.#schemaName = schemaName;
 		this.#executor = createExecutor(client, schemaName);
+		this.#readExecutor = createExecutor(readClient, schemaName);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -8231,13 +8297,13 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 		});
 	}
 	async getNode(id) {
-		return this.#getNode(this.#executor, id);
+		return this.#getNode(this.#readExecutor, id);
 	}
 	async getNodeByName(input) {
-		return this.#getNodeByName(this.#executor, input.name, (0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope));
+		return this.#getNodeByName(this.#readExecutor, input.name, (0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope));
 	}
 	async resolveNode(input) {
-		return this.#resolveNode(this.#executor, input.name, (0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope));
+		return this.#resolveNode(this.#readExecutor, input.name, (0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope));
 	}
 	async listNodes(input) {
 		const key = (0, _mastra_core_storage.knowledgeScopeKey)((0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope));
@@ -8267,7 +8333,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 			args.push(updatedAt, updatedAt, cursor.name, cursor.name, cursor.id);
 		}
 		args.push(input.limit ?? 100);
-		return (await this.#executor.execute({
+		return (await this.#readExecutor.execute({
 			sql: `SELECT *, scope AS "scopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_NODES}" WHERE ${clauses.join(" AND ")} ORDER BY updatedAt DESC, name ASC, id ASC LIMIT ?`,
 			args
 		})).rows.map(parseNode);
@@ -8433,7 +8499,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 		});
 	}
 	async getKnowledge(input) {
-		const result = await this.#executor.execute({
+		const result = await this.#readExecutor.execute({
 			sql: `SELECT *,scope AS "scopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_RECORDS}" WHERE id=?${input.includeDeleted ? "" : " AND deletedAt IS NULL"}`,
 			args: [input.id]
 		});
@@ -8458,7 +8524,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 		if (input.after) args.push(input.after);
 		const limit = input.limit ?? 100;
 		args.push(limit + 1);
-		const records = (await this.#executor.execute({
+		const records = (await this.#readExecutor.execute({
 			sql: `SELECT *,scope AS "scopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_RECORDS}" WHERE sourceThreadId=? AND ${visibleSql}${input.includeDeleted ? "" : " AND deletedAt IS NULL"}${input.after ? " AND id > ?" : ""} ORDER BY id ASC LIMIT ?`,
 			args
 		})).rows.map(parseKnowledge);
@@ -8553,7 +8619,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 		const normalizedQuery = input.query.trim().toLocaleLowerCase();
 		if (!normalizedQuery) return [];
 		const query = `%${escapeLikePattern(normalizedQuery)}%`;
-		const results = (await this.#executor.execute({
+		const results = (await this.#readExecutor.execute({
 			sql: `SELECT *,scope AS "scopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_NODES}" WHERE mergedInto IS NULL AND ${visibleSql} AND (canonicalName LIKE ? ESCAPE '=' OR lower(COALESCE(kind,'')) LIKE ? ESCAPE '=' OR lower(COALESCE(content,'')) LIKE ? ESCAPE '=' OR lower(COALESCE(description,'')) LIKE ? ESCAPE '=') ORDER BY updatedAt DESC LIMIT ?`,
 			args: [
 				key,
@@ -8577,7 +8643,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 			scope: parseJson$1(row.scopeJson)
 		}));
 		if (results.length < (input.limit ?? 20)) {
-			const records = await this.#executor.execute({
+			const records = await this.#readExecutor.execute({
 				sql: `SELECT f.*,f.scope AS "scopeJson",r.name,r.scope AS "parentScopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_RECORDS}" f JOIN "${_mastra_core_storage.TABLE_KNOWLEDGE_NODES}" r ON r.id=f.node AND r.type='node' AND r.mergedInto IS NULL WHERE f.deletedAt IS NULL AND ${visibleSql.replaceAll("scopeKey", "f.scopeKey")} AND lower(f.text) LIKE ? ESCAPE '=' ORDER BY f.id DESC LIMIT ?`,
 				args: [
 					key,
@@ -8630,7 +8696,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 	}
 	async listActivity(input) {
 		const key = (0, _mastra_core_storage.knowledgeScopeKey)((0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope));
-		return (await this.#executor.execute({
+		return (await this.#readExecutor.execute({
 			sql: `SELECT *,scope AS "scopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_ACTIVITY}" WHERE ${visibleSql}${input.after ? " AND id < ?" : ""} ORDER BY id DESC LIMIT ?`,
 			args: [
 				key,
@@ -8774,7 +8840,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 	}
 	async #queryKnowledge(input, relationship) {
 		const scope = (0, _mastra_core_storage.canonicalizeKnowledgeScope)(input.scope);
-		const node = await this.#resolveTerminalNode(this.#executor, nodeReferenceId(input.node));
+		const node = await this.#resolveTerminalNode(this.#readExecutor, nodeReferenceId(input.node));
 		if (!node) return { records: [] };
 		const key = (0, _mastra_core_storage.knowledgeScopeKey)(scope);
 		const args = [
@@ -8785,7 +8851,7 @@ var KnowledgePG = class extends _mastra_core_storage.KnowledgeStorage {
 		];
 		if (input.after) args.push(input.after);
 		args.push((input.limit ?? 100) + 1);
-		const records = (await this.#executor.execute({
+		const records = (await this.#readExecutor.execute({
 			sql: `SELECT DISTINCT f.*,f.scope AS "scopeJson" FROM "${_mastra_core_storage.TABLE_KNOWLEDGE_RECORDS}" f${relationship === "about" ? "" : ` LEFT JOIN "${_mastra_core_storage.TABLE_KNOWLEDGE_MENTIONS}" m ON m.sourceType='record' AND m.sourceId=f.id`} WHERE ${relationship === "about" ? "f.node=?" : relationship === "mentioning" ? "m.recordId=?" : "(f.node=? OR m.recordId=?)"} AND ${visibleSql.replaceAll("scopeKey", "f.scopeKey")}${input.includeDeleted ? "" : " AND f.deletedAt IS NULL"}${input.after ? " AND f.id < ?" : ""} ORDER BY f.id DESC LIMIT ?`,
 			args
 		})).rows.map(parseKnowledge);
@@ -8897,9 +8963,10 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_MCP_CLIENTS, _mastra_core_storage.TABLE_MCP_CLIENT_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -8963,12 +9030,19 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_MCP_CLIENTS });
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENTS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseMCPClientRow(result);
 		} catch (error) {
@@ -9047,7 +9121,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENTS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const existingClient = await this.getById(id);
+			const existingClient = await this.#getById(this.#db.client, id);
 			if (!existingClient) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_MCP_CLIENT", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -9086,7 +9160,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 			values.push(now);
 			values.push(id);
 			await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedClient = await this.getById(id);
+			const updatedClient = await this.#getById(this.#db.client, id);
 			if (!updatedClient) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_MCP_CLIENT", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -9153,7 +9227,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				queryParams.push(JSON.stringify(metadata));
 			}
 			const whereClause = `WHERE ${conditions.join(" AND ")}`;
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				mcpClients: [],
@@ -9164,7 +9238,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				mcpClients: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
+				mcpClients: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -9241,7 +9315,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -9260,7 +9334,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpClientId" = $1 AND "versionNumber" = $2`, [mcpClientId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpClientId" = $1 AND "versionNumber" = $2`, [mcpClientId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -9282,7 +9356,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpClientId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [mcpClientId]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpClientId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [mcpClientId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -9311,7 +9385,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpClientId" = $1`, [mcpClientId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpClientId" = $1`, [mcpClientId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -9322,7 +9396,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "mcpClientId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "mcpClientId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					mcpClientId,
 					limitValue,
 					offset
@@ -9392,7 +9466,7 @@ var MCPClientsPG = class MCPClientsPG extends _mastra_core_storage.MCPClientsSto
 				indexName: _mastra_core_storage.TABLE_MCP_CLIENT_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpClientId" = $1`, [mcpClientId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpClientId" = $1`, [mcpClientId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -9452,9 +9526,10 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_MCP_SERVERS, _mastra_core_storage.TABLE_MCP_SERVER_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -9518,12 +9593,19 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_MCP_SERVERS });
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_MCP_SERVERS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseMCPServerRow(result);
 		} catch (error) {
@@ -9602,7 +9684,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				indexName: _mastra_core_storage.TABLE_MCP_SERVERS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const existingServer = await this.getById(id);
+			const existingServer = await this.#getById(this.#db.client, id);
 			if (!existingServer) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_MCP_SERVER", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -9641,7 +9723,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 			values.push(now);
 			values.push(id);
 			await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedServer = await this.getById(id);
+			const updatedServer = await this.#getById(this.#db.client, id);
 			if (!updatedServer) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_MCP_SERVER", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -9708,7 +9790,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				queryParams.push(JSON.stringify(metadata));
 			}
 			const whereClause = `WHERE ${conditions.join(" AND ")}`;
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				mcpServers: [],
@@ -9719,7 +9801,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				mcpServers: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
+				mcpServers: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -9806,7 +9888,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				indexName: _mastra_core_storage.TABLE_MCP_SERVER_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -9825,7 +9907,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				indexName: _mastra_core_storage.TABLE_MCP_SERVER_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpServerId" = $1 AND "versionNumber" = $2`, [mcpServerId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpServerId" = $1 AND "versionNumber" = $2`, [mcpServerId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -9847,7 +9929,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				indexName: _mastra_core_storage.TABLE_MCP_SERVER_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpServerId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [mcpServerId]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "mcpServerId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [mcpServerId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -9876,7 +9958,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				indexName: _mastra_core_storage.TABLE_MCP_SERVER_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpServerId" = $1`, [mcpServerId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpServerId" = $1`, [mcpServerId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -9887,7 +9969,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "mcpServerId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "mcpServerId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					mcpServerId,
 					limitValue,
 					offset
@@ -9957,7 +10039,7 @@ var MCPServersPG = class MCPServersPG extends _mastra_core_storage.MCPServersSto
 				indexName: _mastra_core_storage.TABLE_MCP_SERVER_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpServerId" = $1`, [mcpServerId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "mcpServerId" = $1`, [mcpServerId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -10126,9 +10208,10 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 	];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -10377,6 +10460,16 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 		};
 	}
 	async getThreadById({ threadId, resourceId }) {
+		return this.#getThreadById(this.#db.readClient, {
+			threadId,
+			resourceId
+		});
+	}
+	/**
+	* Thread lookup against an explicit client. Mutation paths pass the writer so
+	* a lagging read replica cannot produce false not-found or stale metadata.
+	*/
+	async #getThreadById(client, { threadId, resourceId }) {
 		try {
 			let query = `SELECT * FROM ${getTableName$3({
 				indexName: _mastra_core_storage.TABLE_THREADS,
@@ -10387,7 +10480,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 				query += ` AND "resourceId" = $2`;
 				params.push(resourceId);
 			}
-			const thread = await this.#db.client.oneOrNone(query, params);
+			const thread = await client.oneOrNone(query, params);
 			if (!thread) return null;
 			return {
 				id: thread.id,
@@ -10456,7 +10549,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			}
 			const baseQuery = `FROM ${tableName} ${whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : ""}`;
 			const countQuery = `SELECT COUNT(*) ${baseQuery}`;
-			const countResult = await this.#db.client.one(countQuery, queryParams);
+			const countResult = await this.#db.readClient.one(countQuery, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				threads: [],
@@ -10468,7 +10561,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			const limitValue = perPageInput === false ? total : perPage;
 			const dataQuery = `SELECT id, "resourceId", title, metadata, "createdAt", "createdAtZ", "updatedAt", "updatedAtZ" ${baseQuery} ORDER BY COALESCE("${field}Z", "${field}") ${direction} LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`;
 			return {
-				threads: (await this.#db.client.manyOrNone(dataQuery, [
+				threads: (await this.#db.readClient.manyOrNone(dataQuery, [
 					...queryParams,
 					limitValue,
 					offset
@@ -10552,7 +10645,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			indexName: _mastra_core_storage.TABLE_THREADS,
 			schemaName: getSchemaName$3(this.#schema)
 		});
-		const existingThread = await this.getThreadById({ threadId: id });
+		const existingThread = await this.#getThreadById(this.#db.client, { threadId: id });
 		if (!existingThread) throw new _mastra_core_error.MastraError({
 			id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_THREAD", "FAILED"),
 			domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -10684,7 +10777,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 		if (targetIds.length === 0) return null;
 		const idPlaceholders = targetIds.map((_, i) => "$" + (i + 1)).join(", ");
 		const targetResourceCondition = resourceId ? ` AND "resourceId" = $${targetIds.length + 1}` : "";
-		const targetRows = await this.#db.client.manyOrNone(`SELECT id, thread_id, "createdAt" FROM ${tableName} WHERE id IN (${idPlaceholders})${targetResourceCondition}`, resourceId ? [...targetIds, resourceId] : targetIds);
+		const targetRows = await this.#db.readClient.manyOrNone(`SELECT id, thread_id, "createdAt" FROM ${tableName} WHERE id IN (${idPlaceholders})${targetResourceCondition}`, resourceId ? [...targetIds, resourceId] : targetIds);
 		if (targetRows.length === 0) return null;
 		const targetMap = new Map(targetRows.map((r) => [r.id, {
 			threadId: r.thread_id,
@@ -10735,7 +10828,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 		let finalQuery;
 		if (unionQueries.length === 1) finalQuery = unionQueries[0].slice(1, -1);
 		else finalQuery = `SELECT * FROM (${unionQueries.join(" UNION ALL ")}) AS combined ORDER BY "createdAt" ASC, id ASC`;
-		const includedRows = await this.#db.client.manyOrNone(finalQuery, params);
+		const includedRows = await this.#db.readClient.manyOrNone(finalQuery, params);
 		const seen = /* @__PURE__ */ new Set();
 		return includedRows.filter((row) => {
 			if (seen.has(row.id)) return false;
@@ -10771,7 +10864,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
         WHERE id IN (${inPlaceholders(messageIds.length)})
         ORDER BY "createdAt" DESC
       `;
-			const resultRows = await this.#db.client.manyOrNone(query, messageIds);
+			const resultRows = await this.#db.readClient.manyOrNone(query, messageIds);
 			return { messages: new _mastra_core_agent.MessageList().add(resultRows.map((row) => this.parseRow(row)), "memory").get.all.db() };
 		} catch (error) {
 			const mastraError = new _mastra_core_error.MastraError({
@@ -10802,7 +10895,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			perPage,
 			offset
 		];
-		const rows = await this.#db.client.manyOrNone(`${selectStatement}, COUNT(*) OVER () AS "__total" FROM ${tableName} ${whereClause} ${orderByStatement}${limitClause}`, dataParams) || [];
+		const rows = await this.#db.readClient.manyOrNone(`${selectStatement}, COUNT(*) OVER () AS "__total" FROM ${tableName} ${whereClause} ${orderByStatement}${limitClause}`, dataParams) || [];
 		if (rows.length > 0) return {
 			total: Number(rows[0].__total),
 			messages: rows
@@ -10811,7 +10904,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			total: 0,
 			messages: []
 		};
-		const countResult = await this.#db.client.one(`SELECT COUNT(*) FROM ${tableName} ${whereClause}`, queryParams);
+		const countResult = await this.#db.readClient.one(`SELECT COUNT(*) FROM ${tableName} ${whereClause}`, queryParams);
 		return {
 			total: parseInt(countResult.count, 10),
 			messages: []
@@ -10905,7 +10998,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			let total;
 			let messages;
 			if (metadataFilter) {
-				const filteredRows = (await this.#db.client.manyOrNone(`${selectStatement} FROM ${tableName} ${whereClause} ${orderByStatement}`, queryParams) || []).filter((row) => (0, _mastra_core_storage.storageMessageMatchesMetadataFilter)(row.content, metadataFilter));
+				const filteredRows = (await this.#db.readClient.manyOrNone(`${selectStatement} FROM ${tableName} ${whereClause} ${orderByStatement}`, queryParams) || []).filter((row) => (0, _mastra_core_storage.storageMessageMatchesMetadataFilter)(row.content, metadataFilter));
 				total = filteredRows.length;
 				messages = perPageInput === false ? filteredRows : filteredRows.slice(offset, offset + perPage);
 			} else ({total, messages} = await this.#fetchMessagePage({
@@ -11051,7 +11144,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			let total;
 			let messages;
 			if (metadataFilter) {
-				const filteredRows = (await this.#db.client.manyOrNone(`${selectStatement} FROM ${tableName} ${whereClause} ${orderByStatement}`, queryParams) || []).filter((row) => (0, _mastra_core_storage.storageMessageMatchesMetadataFilter)(row.content, metadataFilter));
+				const filteredRows = (await this.#db.readClient.manyOrNone(`${selectStatement} FROM ${tableName} ${whereClause} ${orderByStatement}`, queryParams) || []).filter((row) => (0, _mastra_core_storage.storageMessageMatchesMetadataFilter)(row.content, metadataFilter));
 				total = filteredRows.length;
 				messages = perPageInput === false ? filteredRows : filteredRows.slice(offset, offset + perPage);
 			} else ({total, messages} = await this.#fetchMessagePage({
@@ -11126,7 +11219,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 				if (!message.resourceId) throw new Error(`Expected to find a resourceId for message, but couldn't find one. An unexpected error has occurred.`);
 				threadIds.add(message.threadId);
 			}
-			for (const threadIdToCheck of threadIds) if (!await this.getThreadById({ threadId: threadIdToCheck })) throw new _mastra_core_error.MastraError({
+			for (const threadIdToCheck of threadIds) if (!await this.#getThreadById(this.#db.client, { threadId: threadIdToCheck })) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "SAVE_MESSAGES", "FAILED"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
 				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
@@ -11294,11 +11387,14 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 		}
 	}
 	async getResourceById({ resourceId }) {
+		return this.#getResourceById(this.#db.readClient, resourceId);
+	}
+	async #getResourceById(client, resourceId) {
 		const tableName = getTableName$3({
 			indexName: _mastra_core_storage.TABLE_RESOURCES,
 			schemaName: getSchemaName$3(this.#schema)
 		});
-		const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [resourceId]);
+		const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [resourceId]);
 		if (!result) return null;
 		return {
 			id: result.id,
@@ -11323,7 +11419,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 		return resource;
 	}
 	async updateResource({ resourceId, workingMemory, metadata }) {
-		const existingResource = await this.getResourceById({ resourceId });
+		const existingResource = await this.#getResourceById(this.#db.client, resourceId);
 		if (!existingResource) {
 			const newResource = {
 				id: resourceId,
@@ -11371,7 +11467,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 	}
 	async cloneThread(args) {
 		const { sourceThreadId, newThreadId: providedThreadId, resourceId, title, metadata, options } = args;
-		const sourceThread = await this.getThreadById({ threadId: sourceThreadId });
+		const sourceThread = await this.#getThreadById(this.#db.client, { threadId: sourceThreadId });
 		if (!sourceThread) throw new _mastra_core_error.MastraError({
 			id: (0, _mastra_core_storage.createStorageErrorId)("PG", "CLONE_THREAD", "SOURCE_NOT_FOUND"),
 			domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -11380,7 +11476,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 			details: { sourceThreadId }
 		});
 		const newThreadId = providedThreadId || crypto.randomUUID();
-		if (await this.getThreadById({ threadId: newThreadId })) throw new _mastra_core_error.MastraError({
+		if (await this.#getThreadById(this.#db.client, { threadId: newThreadId })) throw new _mastra_core_error.MastraError({
 			id: (0, _mastra_core_storage.createStorageErrorId)("PG", "CLONE_THREAD", "THREAD_EXISTS"),
 			domain: _mastra_core_error.ErrorDomain.STORAGE,
 			category: _mastra_core_error.ErrorCategory.USER,
@@ -11555,7 +11651,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 				indexName: OM_TABLE,
 				schemaName: getSchemaName$3(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "lookupKey" = $1 ORDER BY "generationCount" DESC LIMIT 1`, [lookupKey]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "lookupKey" = $1 ORDER BY "generationCount" DESC LIMIT 1`, [lookupKey]);
 			if (!result) return null;
 			return this.parseOMRow(result);
 		} catch (error) {
@@ -11597,7 +11693,7 @@ var MemoryPG = class MemoryPG extends _mastra_core_storage.MemoryStorage {
 				params.push(options.offset);
 				sql += ` OFFSET $${paramIndex}`;
 			}
-			const result = await this.#db.client.manyOrNone(sql, params);
+			const result = await this.#db.readClient.manyOrNone(sql, params);
 			if (!result) return [];
 			return result.map((row) => this.parseOMRow(row));
 		} catch (error) {
@@ -12538,9 +12634,10 @@ var NotificationsPG = class NotificationsPG extends _mastra_core_storage.Notific
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -12709,7 +12806,7 @@ var NotificationsPG = class NotificationsPG extends _mastra_core_storage.Notific
 				coalescedCount: (existing.coalescedCount ?? 1) + 1,
 				metadata: metadata ?? null
 			});
-			const updated = await this.getNotification({
+			const updated = await this.#getNotification(this.#db.client, {
 				threadId: existing.threadId,
 				id: existing.id
 			});
@@ -12775,7 +12872,7 @@ var NotificationsPG = class NotificationsPG extends _mastra_core_storage.Notific
 			indexName: _mastra_core_storage.TABLE_NOTIFICATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE ${conditions.join(" AND ")} ORDER BY "updatedAt" DESC${limit}`, args)).map((row) => rowToNotification(row));
+		return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE ${conditions.join(" AND ")} ORDER BY "updatedAt" DESC${limit}`, args)).map((row) => rowToNotification(row));
 	}
 	async listDueNotifications(input) {
 		const conditions = ["\"status\" = $1", "((\"deliverAt\" IS NOT NULL AND \"deliverAt\" <= $2) OR (\"summaryAt\" IS NOT NULL AND \"summaryAt\" <= $3))"];
@@ -12798,18 +12895,25 @@ var NotificationsPG = class NotificationsPG extends _mastra_core_storage.Notific
 			indexName: _mastra_core_storage.TABLE_NOTIFICATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE ${conditions.join(" AND ")} ORDER BY CASE WHEN "deliverAt" IS NULL THEN "summaryAt" WHEN "summaryAt" IS NULL THEN "deliverAt" WHEN "deliverAt" <= "summaryAt" THEN "deliverAt" ELSE "summaryAt" END ASC, "updatedAt" ASC${limit}`, args)).map((row) => rowToNotification(row));
+		return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE ${conditions.join(" AND ")} ORDER BY CASE WHEN "deliverAt" IS NULL THEN "summaryAt" WHEN "summaryAt" IS NULL THEN "deliverAt" WHEN "deliverAt" <= "summaryAt" THEN "deliverAt" ELSE "summaryAt" END ASC, "updatedAt" ASC${limit}`, args)).map((row) => rowToNotification(row));
 	}
 	async getNotification(input) {
+		return this.#getNotification(this.#db.readClient, input);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getNotification(client, input) {
 		const tableName = getTableName$5({
 			indexName: _mastra_core_storage.TABLE_NOTIFICATIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "threadId" = $1 AND "id" = $2 LIMIT 1`, [input.threadId, input.id]);
+		const row = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE "threadId" = $1 AND "id" = $2 LIMIT 1`, [input.threadId, input.id]);
 		return row ? rowToNotification(row) : null;
 	}
 	async updateNotification(input) {
-		if (!await this.getNotification({
+		if (!await this.#getNotification(this.#db.client, {
 			threadId: input.threadId,
 			id: input.id
 		})) throw new Error(`Notification ${input.id} was not found for thread ${input.threadId}`);
@@ -12833,7 +12937,7 @@ var NotificationsPG = class NotificationsPG extends _mastra_core_storage.Notific
 			...input.summarySignalId !== void 0 ? { summarySignalId: input.summarySignalId } : {},
 			updatedAt: now
 		});
-		const updated = await this.getNotification({
+		const updated = await this.#getNotification(this.#db.client, {
 			threadId: input.threadId,
 			id: input.id
 		});
@@ -12880,9 +12984,10 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_SPANS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -13115,7 +13220,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 				indexName: _mastra_core_storage.TABLE_SPANS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const row = await this.#db.client.oneOrNone(`SELECT
+			const row = await this.#db.readClient.oneOrNone(`SELECT
           "traceId", "spanId", "parentSpanId", "name",
           "entityType", "entityId", "entityName",
           "userId", "organizationId", "resourceId",
@@ -13151,7 +13256,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 				indexName: _mastra_core_storage.TABLE_SPANS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const row = await this.#db.client.oneOrNone(`SELECT
+			const row = await this.#db.readClient.oneOrNone(`SELECT
           "traceId", "spanId", "parentSpanId", "name",
           "entityType", "entityId", "entityName",
           "userId", "organizationId", "resourceId",
@@ -13184,7 +13289,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 				indexName: _mastra_core_storage.TABLE_SPANS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const spans = await this.#db.client.manyOrNone(`SELECT
+			const spans = await this.#db.readClient.manyOrNone(`SELECT
           "traceId", "spanId", "parentSpanId", "name",
           "entityType", "entityId", "entityName",
           "userId", "organizationId", "resourceId",
@@ -13221,7 +13326,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 				indexName: _mastra_core_storage.TABLE_SPANS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const spans = await this.#db.client.manyOrNone(`SELECT
+			const spans = await this.#db.readClient.manyOrNone(`SELECT
           "traceId", "spanId", "parentSpanId", "name",
           "entityType", "entityId", "entityName",
           "spanType", "error", "isEvent",
@@ -13405,7 +13510,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 			let orderClause;
 			if (orderField === "endedAt") orderClause = `ORDER BY r."${sortField}" ${sortDirection} ${sortDirection === "DESC" ? "NULLS FIRST" : "NULLS LAST"}`;
 			else orderClause = `ORDER BY r."${sortField}" ${sortDirection}`;
-			const countResult = await this.#db.client.oneOrNone(`SELECT COUNT(*) FROM ${tableName} r ${whereClause}`, params);
+			const countResult = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) FROM ${tableName} r ${whereClause}`, params);
 			const count = Number(countResult?.count ?? 0);
 			if (count === 0) return {
 				pagination: {
@@ -13416,7 +13521,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 				},
 				spans: []
 			};
-			const spans = await this.#db.client.manyOrNone(`SELECT
+			const spans = await this.#db.readClient.manyOrNone(`SELECT
           r."traceId", r."spanId", r."parentSpanId", r."name",
           r."entityType", r."entityId", r."entityName",
           r."userId", r."organizationId", r."resourceId",
@@ -13513,6 +13618,7 @@ var ObservabilityPG = class ObservabilityPG extends _mastra_core_storage.Observa
 		}
 	}
 	async batchDeleteTraces(args) {
+		this.assertUnscopedBatchDeleteTraces(args);
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_SPANS,
@@ -17695,11 +17801,39 @@ async function getTraceLight(client, schema, args) {
 		spans: rows.map(rowToLightSpanRecord)
 	};
 }
+/**
+* Delete traces by traceId, cascading to trace-linked signal events
+* (metrics, logs, scores, feedback). Signal rows with a NULL traceId are
+* never affected. When the optional tenant scope (`organizationId` /
+* `resourceId`) is set, every DELETE additionally requires the row's tenant
+* columns to match.
+*/
 async function batchDeleteTraces(client, schema, args) {
 	if (args.traceIds.length === 0) return;
-	const span = qualifiedTable(schema, TABLE_SPAN_EVENTS);
+	const params = [...args.traceIds];
 	const placeholders = args.traceIds.map((_, i) => `$${i + 1}`).join(", ");
-	await client.query(`DELETE FROM ${span} WHERE "traceId" IN (${placeholders})`, args.traceIds);
+	let scopeCondition = "";
+	if (args.organizationId !== void 0) {
+		params.push(args.organizationId);
+		scopeCondition += ` AND "organizationId" = $${params.length}`;
+	}
+	if (args.resourceId !== void 0) {
+		params.push(args.resourceId);
+		scopeCondition += ` AND "resourceId" = $${params.length}`;
+	}
+	const tables = [
+		TABLE_SPAN_EVENTS,
+		TABLE_METRIC_EVENTS,
+		TABLE_LOG_EVENTS,
+		TABLE_SCORE_EVENTS,
+		TABLE_FEEDBACK_EVENTS
+	];
+	await client.tx(async (t) => {
+		for (const tableName of tables) {
+			const table = qualifiedTable(schema, tableName);
+			await t.query(`DELETE FROM ${table} WHERE "traceId" IN (${placeholders})${scopeCondition}`, params);
+		}
+	});
 }
 /** Truncate the span_events table. */
 async function dangerouslyClearTracing(client, schema) {
@@ -17742,6 +17876,8 @@ function wrapError(op, error, details) {
 }
 var ObservabilityStoragePostgresVNext = class ObservabilityStoragePostgresVNext extends _mastra_core_storage.ObservabilityStorage {
 	#client;
+	/** Reader-backed client for standalone reads; writes, DDL, and discovery-cache refresh stay on #client. */
+	#readClient;
 	#schema;
 	#partitioning;
 	#discoveryConfig;
@@ -17749,8 +17885,9 @@ var ObservabilityStoragePostgresVNext = class ObservabilityStoragePostgresVNext
 	#partitionMode;
 	constructor(config) {
 		super();
-		const { client, schemaName } = resolvePgConfig(config);
+		const { client, readClient, schemaName } = resolvePgConfig(config);
 		this.#client = client;
+		this.#readClient = readClient;
 		this.#schema = schemaName ?? "public";
 		this.#partitioning = config.partitioning ?? {};
 		this.#discoveryConfig = config.discovery ?? {};
@@ -17935,34 +18072,34 @@ var ObservabilityStoragePostgresVNext = class ObservabilityStoragePostgresVNext
 		await this.#run("BATCH_CREATE_SPANS", () => batchCreateSpans(this.#client, this.#schema, args), { count: args.records.length });
 	}
 	async getSpan(args) {
-		return this.#run("GET_SPAN", () => getSpan(this.#client, this.#schema, args), {
+		return this.#run("GET_SPAN", () => getSpan(this.#readClient, this.#schema, args), {
 			traceId: args.traceId,
 			spanId: args.spanId
 		});
 	}
 	async getSpans(args) {
-		return this.#run("GET_SPANS", () => getSpans(this.#client, this.#schema, args), {
+		return this.#run("GET_SPANS", () => getSpans(this.#readClient, this.#schema, args), {
 			traceId: args.traceId,
 			count: args.spanIds.length
 		});
 	}
 	async getRootSpan(args) {
-		return this.#run("GET_ROOT_SPAN", () => getRootSpan(this.#client, this.#schema, args), { traceId: args.traceId });
+		return this.#run("GET_ROOT_SPAN", () => getRootSpan(this.#readClient, this.#schema, args), { traceId: args.traceId });
 	}
 	async getTrace(args) {
-		return this.#run("GET_TRACE", () => getTrace(this.#client, this.#schema, args), { traceId: args.traceId });
+		return this.#run("GET_TRACE", () => getTrace(this.#readClient, this.#schema, args), { traceId: args.traceId });
 	}
 	async getTraceLight(args) {
-		return this.#run("GET_TRACE_LIGHT", () => getTraceLight(this.#client, this.#schema, args), { traceId: args.traceId });
+		return this.#run("GET_TRACE_LIGHT", () => getTraceLight(this.#readClient, this.#schema, args), { traceId: args.traceId });
 	}
 	async listTraces(args) {
-		return this.#run("LIST_TRACES", () => listTraces(this.#client, this.#schema, args));
+		return this.#run("LIST_TRACES", () => listTraces(this.#readClient, this.#schema, args));
 	}
 	async queryTraces(plan) {
-		return this.#run("QUERY_TRACES", () => queryTraces(this.#client, this.#schema, plan, this.#traceQueryTimeoutMs));
+		return this.#run("QUERY_TRACES", () => queryTraces(this.#readClient, this.#schema, plan, this.#traceQueryTimeoutMs));
 	}
 	async listBranches(args) {
-		return this.#run("LIST_BRANCHES", () => listBranches(this.#client, this.#schema, args));
+		return this.#run("LIST_BRANCHES", () => listBranches(this.#readClient, this.#schema, args));
 	}
 	async batchCreateLogs(args) {
 		await this.#run("BATCH_CREATE_LOGS", () => batchCreateLogs(this.#client, this.#schema, args), { count: args.logs.length });
@@ -17983,58 +18120,58 @@ var ObservabilityStoragePostgresVNext = class ObservabilityStoragePostgresVNext
 		await this.#run("BATCH_CREATE_FEEDBACK", () => batchCreateFeedback(this.#client, this.#schema, args), { count: args.feedbacks.length });
 	}
 	async listLogs(args) {
-		return this.#run("LIST_LOGS", () => listLogs(this.#client, this.#schema, args));
+		return this.#run("LIST_LOGS", () => listLogs(this.#readClient, this.#schema, args));
 	}
 	async listMetrics(args) {
-		return this.#run("LIST_METRICS", () => listMetrics(this.#client, this.#schema, args));
+		return this.#run("LIST_METRICS", () => listMetrics(this.#readClient, this.#schema, args));
 	}
 	async listScores(args) {
-		return this.#run("LIST_SCORES", () => listScores(this.#client, this.#schema, args));
+		return this.#run("LIST_SCORES", () => listScores(this.#readClient, this.#schema, args));
 	}
 	async getScoreById(scoreId) {
-		return this.#run("GET_SCORE_BY_ID", () => getScoreById(this.#client, this.#schema, scoreId), { scoreId });
+		return this.#run("GET_SCORE_BY_ID", () => getScoreById(this.#readClient, this.#schema, scoreId), { scoreId });
 	}
 	async listFeedback(args) {
-		return this.#run("LIST_FEEDBACK", () => listFeedback(this.#client, this.#schema, args));
+		return this.#run("LIST_FEEDBACK", () => listFeedback(this.#readClient, this.#schema, args));
 	}
 	async updateFeedbackReviewStatus(args) {
 		return this.#run("UPDATE_FEEDBACK_REVIEW_STATUS", () => updateFeedbackReviewStatus(this.#client, this.#schema, args), { feedbackId: args.feedbackId });
 	}
 	async getMetricAggregate(args) {
-		return this.#run("GET_METRIC_AGGREGATE", () => getMetricAggregate(this.#client, this.#schema, args));
+		return this.#run("GET_METRIC_AGGREGATE", () => getMetricAggregate(this.#readClient, this.#schema, args));
 	}
 	async getMetricBreakdown(args) {
-		return this.#run("GET_METRIC_BREAKDOWN", () => getMetricBreakdown(this.#client, this.#schema, args));
+		return this.#run("GET_METRIC_BREAKDOWN", () => getMetricBreakdown(this.#readClient, this.#schema, args));
 	}
 	async getMetricTimeSeries(args) {
-		return this.#run("GET_METRIC_TIME_SERIES", () => getMetricTimeSeries(this.#client, this.#schema, args));
+		return this.#run("GET_METRIC_TIME_SERIES", () => getMetricTimeSeries(this.#readClient, this.#schema, args));
 	}
 	async getMetricPercentiles(args) {
-		return this.#run("GET_METRIC_PERCENTILES", () => getMetricPercentiles(this.#client, this.#schema, args));
+		return this.#run("GET_METRIC_PERCENTILES", () => getMetricPercentiles(this.#readClient, this.#schema, args));
 	}
 	async getScoreAggregate(args) {
-		return this.#run("GET_SCORE_AGGREGATE", () => getScoreAggregate(this.#client, this.#schema, args));
+		return this.#run("GET_SCORE_AGGREGATE", () => getScoreAggregate(this.#readClient, this.#schema, args));
 	}
 	async getScoreBreakdown(args) {
-		return this.#run("GET_SCORE_BREAKDOWN", () => getScoreBreakdown(this.#client, this.#schema, args));
+		return this.#run("GET_SCORE_BREAKDOWN", () => getScoreBreakdown(this.#readClient, this.#schema, args));
 	}
 	async getScoreTimeSeries(args) {
-		return this.#run("GET_SCORE_TIME_SERIES", () => getScoreTimeSeries(this.#client, this.#schema, args));
+		return this.#run("GET_SCORE_TIME_SERIES", () => getScoreTimeSeries(this.#readClient, this.#schema, args));
 	}
 	async getScorePercentiles(args) {
-		return this.#run("GET_SCORE_PERCENTILES", () => getScorePercentiles(this.#client, this.#schema, args));
+		return this.#run("GET_SCORE_PERCENTILES", () => getScorePercentiles(this.#readClient, this.#schema, args));
 	}
 	async getFeedbackAggregate(args) {
-		return this.#run("GET_FEEDBACK_AGGREGATE", () => getFeedbackAggregate(this.#client, this.#schema, args));
+		return this.#run("GET_FEEDBACK_AGGREGATE", () => getFeedbackAggregate(this.#readClient, this.#schema, args));
 	}
 	async getFeedbackBreakdown(args) {
-		return this.#run("GET_FEEDBACK_BREAKDOWN", () => getFeedbackBreakdown(this.#client, this.#schema, args));
+		return this.#run("GET_FEEDBACK_BREAKDOWN", () => getFeedbackBreakdown(this.#readClient, this.#schema, args));
 	}
 	async getFeedbackTimeSeries(args) {
-		return this.#run("GET_FEEDBACK_TIME_SERIES", () => getFeedbackTimeSeries(this.#client, this.#schema, args));
+		return this.#run("GET_FEEDBACK_TIME_SERIES", () => getFeedbackTimeSeries(this.#readClient, this.#schema, args));
 	}
 	async getFeedbackPercentiles(args) {
-		return this.#run("GET_FEEDBACK_PERCENTILES", () => getFeedbackPercentiles(this.#client, this.#schema, args));
+		return this.#run("GET_FEEDBACK_PERCENTILES", () => getFeedbackPercentiles(this.#readClient, this.#schema, args));
 	}
 	async getEntityTypes(args) {
 		return this.#run("GET_ENTITY_TYPES", () => getEntityTypes(this.#client, this.#schema, args, this.#discovery));
@@ -18093,9 +18230,10 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_PROMPT_BLOCKS, _mastra_core_storage.TABLE_PROMPT_BLOCK_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -18172,12 +18310,19 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_PROMPT_BLOCKS });
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCKS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseBlockRow(result);
 		} catch (error) {
@@ -18256,7 +18401,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCKS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const existingBlock = await this.getById(id);
+			const existingBlock = await this.#getById(this.#db.client, id);
 			if (!existingBlock) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_PROMPT_BLOCK", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -18295,7 +18440,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 			values.push(now);
 			values.push(id);
 			await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedBlock = await this.getById(id);
+			const updatedBlock = await this.#getById(this.#db.client, id);
 			if (!updatedBlock) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_PROMPT_BLOCK", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -18364,7 +18509,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				queryParams.push(JSON.stringify(metadata));
 			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				promptBlocks: [],
@@ -18375,7 +18520,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				promptBlocks: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
+				promptBlocks: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -18454,7 +18599,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCK_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -18473,7 +18618,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCK_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "blockId" = $1 AND "versionNumber" = $2`, [blockId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "blockId" = $1 AND "versionNumber" = $2`, [blockId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -18495,7 +18640,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCK_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "blockId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [blockId]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "blockId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [blockId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -18524,7 +18669,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCK_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "blockId" = $1`, [blockId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "blockId" = $1`, [blockId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -18535,7 +18680,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "blockId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "blockId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					blockId,
 					limitValue,
 					offset
@@ -18605,7 +18750,7 @@ var PromptBlocksPG = class PromptBlocksPG extends _mastra_core_storage.PromptBlo
 				indexName: _mastra_core_storage.TABLE_PROMPT_BLOCK_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "blockId" = $1`, [blockId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "blockId" = $1`, [blockId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -18706,6 +18851,7 @@ function rowToTrigger(row) {
 var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorage {
 	#db;
 	#client;
+	#readClient;
 	#schema;
 	#skipDefaultIndexes;
 	#indexes;
@@ -18725,10 +18871,12 @@ var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorag
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#client = client;
+		this.#readClient = readClient;
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -18852,7 +19000,7 @@ var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorag
 		return getTableName$2(tableName, getSchemaName$2((0, _mastra_core_utils.parseSqlIdentifier)(this.#schema, "schema name")));
 	}
 	async createSchedule(schedule) {
-		if (await this.getSchedule(schedule.id)) throw new Error(`Schedule with id "${schedule.id}" already exists`);
+		if (await this.#getSchedule(this.#client, schedule.id)) throw new Error(`Schedule with id "${schedule.id}" already exists`);
 		await this.#db.insert({
 			tableName: _mastra_core_storage.TABLE_SCHEDULES,
 			record: {
@@ -18874,7 +19022,14 @@ var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorag
 		return schedule;
 	}
 	async getSchedule(id) {
-		const row = await this.#client.oneOrNone(`SELECT * FROM ${this.#table(_mastra_core_storage.TABLE_SCHEDULES)} WHERE id = $1`, [id]);
+		return this.#getSchedule(this.#readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getSchedule(client, id) {
+		const row = await client.oneOrNone(`SELECT * FROM ${this.#table(_mastra_core_storage.TABLE_SCHEDULES)} WHERE id = $1`, [id]);
 		return row ? rowToSchedule(row) : null;
 	}
 	async listSchedules(filter) {
@@ -18899,7 +19054,7 @@ var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorag
 			conditions.push(`owner_id = $${params.length}`);
 		}
 		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-		return (await this.#client.manyOrNone(`SELECT * FROM ${this.#table(_mastra_core_storage.TABLE_SCHEDULES)} ${where} ORDER BY created_at ASC`, params)).map(rowToSchedule);
+		return (await this.#readClient.manyOrNone(`SELECT * FROM ${this.#table(_mastra_core_storage.TABLE_SCHEDULES)} ${where} ORDER BY created_at ASC`, params)).map(rowToSchedule);
 	}
 	async listDueSchedules(now, limit) {
 		const cap = limit ?? 100;
@@ -18929,13 +19084,13 @@ var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorag
 		if ("ownerId" in patch) push("owner_id = ?", patch.ownerId ?? null);
 		push("updated_at = ?", Date.now());
 		if (setClauses.length === 1) {
-			const existing = await this.getSchedule(id);
+			const existing = await this.#getSchedule(this.#client, id);
 			if (!existing) throw new Error(`Schedule ${id} not found`);
 			return existing;
 		}
 		params.push(id);
 		await this.#client.none(`UPDATE ${this.#table(_mastra_core_storage.TABLE_SCHEDULES)} SET ${setClauses.join(", ")} WHERE id = $${params.length}`, params);
-		const updated = await this.getSchedule(id);
+		const updated = await this.#getSchedule(this.#client, id);
 		if (!updated) throw new Error(`Schedule ${id} not found`);
 		return updated;
 	}
@@ -18992,7 +19147,7 @@ var SchedulesPG = class SchedulesPG extends _mastra_core_storage.SchedulesStorag
 			params.push(Math.floor(opts.limit));
 			limitClause = `LIMIT $${params.length}`;
 		}
-		return (await this.#client.manyOrNone(`SELECT * FROM ${this.#table(_mastra_core_storage.TABLE_SCHEDULE_TRIGGERS)}
+		return (await this.#readClient.manyOrNone(`SELECT * FROM ${this.#table(_mastra_core_storage.TABLE_SCHEDULE_TRIGGERS)}
        WHERE ${conditions.join(" AND ")}
        ORDER BY actual_fire_at DESC
        ${limitClause}`, params)).map(rowToTrigger);
@@ -19018,9 +19173,10 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_SCORER_DEFINITIONS, _mastra_core_storage.TABLE_SCORER_DEFINITION_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -19097,12 +19253,19 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_SCORER_DEFINITIONS });
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseScorerRow(result);
 		} catch (error) {
@@ -19185,7 +19348,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const existingScorer = await this.getById(id);
+			const existingScorer = await this.#getById(this.#db.client, id);
 			if (!existingScorer) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_SCORER_DEFINITION", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -19224,7 +19387,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 			values.push(now);
 			values.push(id);
 			await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedScorer = await this.getById(id);
+			const updatedScorer = await this.#getById(this.#db.client, id);
 			if (!updatedScorer) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_SCORER_DEFINITION", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -19301,7 +19464,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				queryParams.push(JSON.stringify(metadata));
 			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				scorerDefinitions: [],
@@ -19312,7 +19475,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				scorerDefinitions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
+				scorerDefinitions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -19394,7 +19557,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITION_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -19413,7 +19576,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITION_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "scorerDefinitionId" = $1 AND "versionNumber" = $2`, [scorerDefinitionId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "scorerDefinitionId" = $1 AND "versionNumber" = $2`, [scorerDefinitionId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -19435,7 +19598,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITION_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "scorerDefinitionId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [scorerDefinitionId]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "scorerDefinitionId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [scorerDefinitionId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -19464,7 +19627,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITION_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "scorerDefinitionId" = $1`, [scorerDefinitionId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "scorerDefinitionId" = $1`, [scorerDefinitionId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -19475,7 +19638,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "scorerDefinitionId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "scorerDefinitionId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					scorerDefinitionId,
 					limitValue,
 					offset
@@ -19545,7 +19708,7 @@ var ScorerDefinitionsPG = class ScorerDefinitionsPG extends _mastra_core_storage
 				indexName: _mastra_core_storage.TABLE_SCORER_DEFINITION_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "scorerDefinitionId" = $1`, [scorerDefinitionId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "scorerDefinitionId" = $1`, [scorerDefinitionId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -19642,9 +19805,10 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -19778,7 +19942,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 	}
 	async getScoreById({ id }) {
 		try {
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${getTableName$1({
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE id = $1`, [id]);
@@ -19810,7 +19974,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			}
 			paramIndex = applyTenancyFilters(conditions, queryParams, paramIndex, filters);
 			const whereClause = conditions.join(" AND ");
-			const total = await this.#db.client.oneOrNone(`SELECT COUNT(*) FROM ${getTableName$1({
+			const total = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE ${whereClause}`, queryParams);
@@ -19828,7 +19992,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			};
 			const limitValue = perPageInput === false ? Number(total?.count) : perPage;
 			const end = perPageInput === false ? Number(total?.count) : start + perPage;
-			const result = await this.#db.client.manyOrNone(`SELECT * FROM ${getTableName$1({
+			const result = await this.#db.readClient.manyOrNone(`SELECT * FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex++} OFFSET $${paramIndex++}`, [
@@ -19918,7 +20082,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			const queryParams = [runId];
 			let paramIndex = applyTenancyFilters(conditions, queryParams, 2, filters);
 			const whereClause = conditions.join(" AND ");
-			const total = await this.#db.client.oneOrNone(`SELECT COUNT(*) FROM ${getTableName$1({
+			const total = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE ${whereClause}`, queryParams);
@@ -19936,7 +20100,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			};
 			const limitValue = perPageInput === false ? Number(total?.count) : perPage;
 			const end = perPageInput === false ? Number(total?.count) : start + perPage;
-			const result = await this.#db.client.manyOrNone(`SELECT * FROM ${getTableName$1({
+			const result = await this.#db.readClient.manyOrNone(`SELECT * FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex++} OFFSET $${paramIndex++}`, [
@@ -19967,7 +20131,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			const queryParams = [entityId, entityType];
 			let paramIndex = applyTenancyFilters(conditions, queryParams, 3, filters);
 			const whereClause = conditions.join(" AND ");
-			const total = await this.#db.client.oneOrNone(`SELECT COUNT(*) FROM ${getTableName$1({
+			const total = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE ${whereClause}`, queryParams);
@@ -19985,7 +20149,7 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			};
 			const limitValue = perPageInput === false ? Number(total?.count) : perPage;
 			const end = perPageInput === false ? Number(total?.count) : start + perPage;
-			const result = await this.#db.client.manyOrNone(`SELECT * FROM ${getTableName$1({
+			const result = await this.#db.readClient.manyOrNone(`SELECT * FROM ${getTableName$1({
 				indexName: _mastra_core_storage.TABLE_SCORERS,
 				schemaName: getSchemaName$1(this.#schema)
 			})} WHERE ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex++} OFFSET $${paramIndex++}`, [
@@ -20020,14 +20184,14 @@ var ScoresPG = class ScoresPG extends _mastra_core_storage.ScoresStorage {
 			const queryParams = [traceId, spanId];
 			let paramIndex = applyTenancyFilters(conditions, queryParams, 3, filters);
 			const whereClause = conditions.join(" AND ");
-			const countSQLResult = await this.#db.client.oneOrNone(`SELECT COUNT(*) as count FROM ${tableName} WHERE ${whereClause}`, queryParams);
+			const countSQLResult = await this.#db.readClient.oneOrNone(`SELECT COUNT(*) as count FROM ${tableName} WHERE ${whereClause}`, queryParams);
 			const total = Number(countSQLResult?.count ?? 0);
 			const { page, perPage: perPageInput } = pagination;
 			const perPage = (0, _mastra_core_storage.normalizePerPage)(perPageInput, 100);
 			const { offset: start, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
 			const end = perPageInput === false ? total : start + perPage;
-			const result = await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex++} OFFSET $${paramIndex++}`, [
+			const result = await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE ${whereClause} ORDER BY "createdAt" DESC LIMIT $${paramIndex++} OFFSET $${paramIndex++}`, [
 				...queryParams,
 				limitValue,
 				start
@@ -20075,9 +20239,10 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_SKILLS, _mastra_core_storage.TABLE_SKILL_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -20151,12 +20316,19 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_SKILLS });
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_SKILLS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseSkillRow(result);
 		} catch (error) {
@@ -20238,7 +20410,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 				indexName: _mastra_core_storage.TABLE_SKILLS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			if (!await this.getById(id)) throw new _mastra_core_error.MastraError({
+			if (!await this.#getById(this.#db.client, id)) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_SKILL", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
 				category: _mastra_core_error.ErrorCategory.USER,
@@ -20250,7 +20422,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 			const configFields = {};
 			for (const [key, value] of Object.entries(rawConfigFields)) if (value !== void 0) configFields[key] = value;
 			if (SNAPSHOT_FIELDS$1.some((field) => field in configFields)) {
-				const latestVersion = await this.getLatestVersion(id);
+				const latestVersion = await this.#getLatestVersion(this.#db.client, id);
 				if (!latestVersion) throw new _mastra_core_error.MastraError({
 					id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_SKILL", "NO_VERSIONS"),
 					domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -20307,7 +20479,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 			values.push(now);
 			values.push(id);
 			if (setClauses.length > 2 || versionCreated) await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedSkill = await this.getById(id);
+			const updatedSkill = await this.#getById(this.#db.client, id);
 			if (!updatedSkill) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_SKILL", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -20400,7 +20572,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 			const joinClause = useJoin && joinSqlIdx !== null ? `LEFT JOIN ${favoritesTable} sr ON sr."entityType" = 'skill' AND sr."entityId" = s.id AND sr."userId" = $${joinSqlIdx}` : "";
 			const joinParams = useJoin && joinUserId ? [joinUserId] : [];
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} s ${joinClause} ${whereClause}`, [...joinParams, ...queryParams]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} s ${joinClause} ${whereClause}`, [...joinParams, ...queryParams]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				skills: [],
@@ -20418,7 +20590,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 			const limitIdx = paramIdx++;
 			const offsetIdx = paramIdx++;
 			return {
-				skills: (await this.#db.client.manyOrNone(`SELECT s.* FROM ${tableName} s ${joinClause} ${whereClause} ${orderByClause} LIMIT $${limitIdx} OFFSET $${offsetIdx}`, [
+				skills: (await this.#db.readClient.manyOrNone(`SELECT s.* FROM ${tableName} s ${joinClause} ${whereClause} ${orderByClause} LIMIT $${limitIdx} OFFSET $${offsetIdx}`, [
 					...joinParams,
 					...queryParams,
 					limitValue,
@@ -20506,7 +20678,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 				indexName: _mastra_core_storage.TABLE_SKILL_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -20527,7 +20699,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 				schemaName: getSchemaName$5(this.#schema)
 			});
 			const placeholders = ids.map((_, i) => `$${i + 1}`).join(", ");
-			return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE id IN (${placeholders})`, ids)).map((row) => this.parseVersionRow(row));
+			return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE id IN (${placeholders})`, ids)).map((row) => this.parseVersionRow(row));
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
 			throw new _mastra_core_error.MastraError({
@@ -20544,7 +20716,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 				indexName: _mastra_core_storage.TABLE_SKILL_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "skillId" = $1 AND "versionNumber" = $2`, [skillId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "skillId" = $1 AND "versionNumber" = $2`, [skillId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -20561,12 +20733,19 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 		}
 	}
 	async getLatestVersion(skillId) {
+		return this.#getLatestVersion(this.#db.readClient, skillId);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getLatestVersion(client, skillId) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_SKILL_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "skillId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [skillId]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE "skillId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [skillId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -20595,7 +20774,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 				indexName: _mastra_core_storage.TABLE_SKILL_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "skillId" = $1`, [skillId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "skillId" = $1`, [skillId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -20606,7 +20785,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "skillId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "skillId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					skillId,
 					limitValue,
 					offset
@@ -20676,7 +20855,7 @@ var SkillsPG = class SkillsPG extends _mastra_core_storage.SkillsStorage {
 				indexName: _mastra_core_storage.TABLE_SKILL_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "skillId" = $1`, [skillId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "skillId" = $1`, [skillId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -20751,9 +20930,10 @@ var ThreadStatePG = class ThreadStatePG extends _mastra_core_storage.ThreadState
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -20916,9 +21096,10 @@ var ToolProviderConnectionsPG = class ToolProviderConnectionsPG extends _mastra_
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_TOOL_PROVIDER_CONNECTIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -20997,7 +21178,7 @@ var ToolProviderConnectionsPG = class ToolProviderConnectionsPG extends _mastra_
 			schemaName: getSchemaName$5(this.#schema)
 		});
 		try {
-			const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "authorId" = $1 AND "providerId" = $2 AND "connectionId" = $3 LIMIT 1`, [
+			const row = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "authorId" = $1 AND "providerId" = $2 AND "connectionId" = $3 LIMIT 1`, [
 				authorId,
 				providerId,
 				connectionId
@@ -21104,7 +21285,7 @@ var ToolProviderConnectionsPG = class ToolProviderConnectionsPG extends _mastra_
 				clauses.push(`scope = $${args.length}`);
 			}
 			const whereClause = clauses.length > 0 ? ` WHERE ${clauses.join(" AND ")}` : "";
-			return (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName}${whereClause}`, args)).map((row) => rowToToolProviderConnection(row));
+			return (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName}${whereClause}`, args)).map((row) => rowToToolProviderConnection(row));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "TOOL_PROVIDER_CONNECTION_LIST", "FAILED"),
@@ -21180,9 +21361,10 @@ var WorkflowDefinitionsPG = class WorkflowDefinitionsPG extends _mastra_core_sto
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -21239,7 +21421,7 @@ var WorkflowDefinitionsPG = class WorkflowDefinitionsPG extends _mastra_core_sto
 	}
 	async upsert(input) {
 		const now = /* @__PURE__ */ new Date();
-		if (!await this.get(input.id)) {
+		if (!await this.#get(this.#db.client, input.id)) {
 			if (!("inputSchema" in input) || !input.inputSchema) throw new Error(`Cannot create workflow definition "${input.id}": inputSchema is required.`);
 			if (!("outputSchema" in input) || !input.outputSchema) throw new Error(`Cannot create workflow definition "${input.id}": outputSchema is required.`);
 			if (!("graph" in input) || !input.graph) throw new Error(`Cannot create workflow definition "${input.id}": graph is required.`);
@@ -21265,10 +21447,10 @@ var WorkflowDefinitionsPG = class WorkflowDefinitionsPG extends _mastra_core_sto
 					record
 				});
 			} catch (error) {
-				if (!await this.get(input.id)) throw error;
+				if (!await this.#get(this.#db.client, input.id)) throw error;
 				return this.applyUpdate(input, now);
 			}
-			const created = await this.get(input.id);
+			const created = await this.#get(this.#db.client, input.id);
 			if (!created) throw new Error(`Failed to persist workflow definition "${input.id}".`);
 			return created;
 		}
@@ -21291,16 +21473,23 @@ var WorkflowDefinitionsPG = class WorkflowDefinitionsPG extends _mastra_core_sto
 			keys: { id: input.id },
 			data
 		});
-		const updated = await this.get(input.id);
+		const updated = await this.#get(this.#db.client, input.id);
 		if (!updated) throw new Error(`Failed to update workflow definition "${input.id}".`);
 		return updated;
 	}
 	async get(id) {
+		return this.#get(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #get(client, id) {
 		const tableName = getTableName$5({
 			indexName: _mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS,
 			schemaName: getSchemaName$5(this.#schema)
 		});
-		const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1`, [id]);
+		const row = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1`, [id]);
 		return row ? rowToDefinition(row) : null;
 	}
 	async list(args) {
@@ -21319,7 +21508,7 @@ var WorkflowDefinitionsPG = class WorkflowDefinitionsPG extends _mastra_core_sto
 			conditions.push(`"authorId" = $${params.length}`);
 		}
 		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-		const definitions = (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${where} ORDER BY "updatedAt" DESC`, params)).map((row) => rowToDefinition(row));
+		const definitions = (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${where} ORDER BY "updatedAt" DESC`, params)).map((row) => rowToDefinition(row));
 		return {
 			definitions,
 			total: definitions.length
@@ -21384,9 +21573,10 @@ var WorkflowsPG = class WorkflowsPG extends _mastra_core_storage.WorkflowsStorag
 	} };
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -21709,7 +21899,7 @@ var WorkflowsPG = class WorkflowsPG extends _mastra_core_storage.WorkflowsStorag
           ORDER BY "createdAt" DESC LIMIT 1
         `;
 			const queryValues = values;
-			const result = await this.#db.client.oneOrNone(query, queryValues);
+			const result = await this.#db.readClient.oneOrNone(query, queryValues);
 			if (!result) return null;
 			return this.parseWorkflowRun(result);
 		} catch (error) {
@@ -21838,9 +22028,10 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 	static MANAGED_TABLES = [_mastra_core_storage.TABLE_WORKSPACES, _mastra_core_storage.TABLE_WORKSPACE_VERSIONS];
 	constructor(config) {
 		super();
-		const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+		const { client, readClient, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
 		this.#db = new PgDB({
 			client,
+			readClient,
 			schemaName,
 			skipDefaultIndexes
 		});
@@ -21904,12 +22095,19 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 		await this.#db.clearTable({ tableName: _mastra_core_storage.TABLE_WORKSPACES });
 	}
 	async getById(id) {
+		return this.#getById(this.#db.readClient, id);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getById(client, id) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_WORKSPACES,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseWorkspaceRow(result);
 		} catch (error) {
@@ -21988,7 +22186,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 				indexName: _mastra_core_storage.TABLE_WORKSPACES,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const existingWorkspace = await this.getById(id);
+			const existingWorkspace = await this.#getById(this.#db.client, id);
 			if (!existingWorkspace) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_WORKSPACE", "NOT_FOUND"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -22001,7 +22199,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 			const configFields = {};
 			for (const [key, value] of Object.entries(rawConfigFields)) if (value !== void 0) configFields[key] = value;
 			if (SNAPSHOT_FIELDS.some((field) => field in configFields)) {
-				const latestVersion = await this.getLatestVersion(id);
+				const latestVersion = await this.#getLatestVersion(this.#db.client, id);
 				if (!latestVersion) throw new _mastra_core_error.MastraError({
 					id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_WORKSPACE", "NO_VERSIONS"),
 					domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -22062,7 +22260,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 			values.push(now);
 			values.push(id);
 			if (setClauses.length > 2 || versionCreated) await this.#db.client.none(`UPDATE ${tableName} SET ${setClauses.join(", ")} WHERE id = $${paramIndex}`, values);
-			const updatedWorkspace = await this.getById(id);
+			const updatedWorkspace = await this.#getById(this.#db.client, id);
 			if (!updatedWorkspace) throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createStorageErrorId)("PG", "UPDATE_WORKSPACE", "NOT_FOUND_AFTER_UPDATE"),
 				domain: _mastra_core_error.ErrorDomain.STORAGE,
@@ -22127,7 +22325,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 				queryParams.push(JSON.stringify(metadata));
 			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} ${whereClause}`, queryParams);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				workspaces: [],
@@ -22138,7 +22336,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				workspaces: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
+				workspaces: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} ${whereClause} ORDER BY "${field}" ${direction} LIMIT $${paramIdx++} OFFSET $${paramIdx++}`, [
 					...queryParams,
 					limitValue,
 					offset
@@ -22223,7 +22421,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 				indexName: _mastra_core_storage.TABLE_WORKSPACE_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE id = $1`, [id]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -22242,7 +22440,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 				indexName: _mastra_core_storage.TABLE_WORKSPACE_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "workspaceId" = $1 AND "versionNumber" = $2`, [workspaceId, versionNumber]);
+			const result = await this.#db.readClient.oneOrNone(`SELECT * FROM ${tableName} WHERE "workspaceId" = $1 AND "versionNumber" = $2`, [workspaceId, versionNumber]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -22259,12 +22457,19 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 		}
 	}
 	async getLatestVersion(workspaceId) {
+		return this.#getLatestVersion(this.#db.readClient, workspaceId);
+	}
+	/**
+	* Same lookup against an explicit client. Mutation paths pass the writer so a
+	* lagging read replica cannot yield stale or missing rows mid-update.
+	*/
+	async #getLatestVersion(client, workspaceId) {
 		try {
 			const tableName = getTableName$5({
 				indexName: _mastra_core_storage.TABLE_WORKSPACE_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "workspaceId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [workspaceId]);
+			const result = await client.oneOrNone(`SELECT * FROM ${tableName} WHERE "workspaceId" = $1 ORDER BY "versionNumber" DESC LIMIT 1`, [workspaceId]);
 			if (!result) return null;
 			return this.parseVersionRow(result);
 		} catch (error) {
@@ -22293,7 +22498,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 				indexName: _mastra_core_storage.TABLE_WORKSPACE_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const countResult = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "workspaceId" = $1`, [workspaceId]);
+			const countResult = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "workspaceId" = $1`, [workspaceId]);
 			const total = parseInt(countResult.count, 10);
 			if (total === 0) return {
 				versions: [],
@@ -22304,7 +22509,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 			};
 			const limitValue = perPageInput === false ? total : perPage;
 			return {
-				versions: (await this.#db.client.manyOrNone(`SELECT * FROM ${tableName} WHERE "workspaceId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
+				versions: (await this.#db.readClient.manyOrNone(`SELECT * FROM ${tableName} WHERE "workspaceId" = $1 ORDER BY "${field}" ${direction} LIMIT $2 OFFSET $3`, [
 					workspaceId,
 					limitValue,
 					offset
@@ -22374,7 +22579,7 @@ var WorkspacesPG = class WorkspacesPG extends _mastra_core_storage.WorkspacesSto
 				indexName: _mastra_core_storage.TABLE_WORKSPACE_VERSIONS,
 				schemaName: getSchemaName$5(this.#schema)
 			});
-			const result = await this.#db.client.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "workspaceId" = $1`, [workspaceId]);
+			const result = await this.#db.readClient.one(`SELECT COUNT(*) as count FROM ${tableName} WHERE "workspaceId" = $1`, [workspaceId]);
 			return parseInt(result.count, 10);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
@@ -22950,10 +23155,12 @@ function exportSchemas(schemaName) {
 * ```
 */
 var PostgresStore = class extends _mastra_core_storage.MastraCompositeStore {
-	#pool;
+	#writePool;
+	#readPool;
 	#db;
-	#ownsPool;
-	#poolClosed = false;
+	#readDb;
+	#ownsWritePool;
+	#writePoolClosed = false;
 	schema;
 	isInitialized = false;
 	#initPromise = null;
@@ -22969,15 +23176,21 @@ var PostgresStore = class extends _mastra_core_storage.MastraCompositeStore {
 			});
 			this.schema = (0, _mastra_core_utils.parseSqlIdentifier)(config.schemaName || "public", "schema name");
 			if (isPoolConfig(config)) {
-				this.#pool = config.pool;
-				this.#ownsPool = false;
+				this.#writePool = config.pool;
+				this.#ownsWritePool = false;
+			} else if (isWritePoolConfig(config)) {
+				this.#writePool = config.writePool;
+				this.#ownsWritePool = false;
 			} else {
-				this.#pool = this.createPool(config);
-				this.#ownsPool = true;
+				this.#writePool = this.createPool(config);
+				this.#ownsWritePool = true;
 			}
-			this.#db = new RoutingDbClient(new PoolAdapter(this.#pool));
+			this.#readPool = config.readPool ?? this.#writePool;
+			this.#db = new RoutingDbClient(new PoolAdapter(this.#writePool));
+			this.#readDb = this.#readPool === this.#writePool ? this.#db : new PoolAdapter(this.#readPool);
 			const domainConfig = {
 				client: this.#db,
+				readClient: this.#readDb,
 				schemaName: this.schema,
 				skipDefaultIndexes: config.skipDefaultIndexes,
 				indexes: config.indexes
@@ -23037,8 +23250,8 @@ var PostgresStore = class extends _mastra_core_storage.MastraCompositeStore {
 	async #runPinnedInit() {
 		let pinnedClient;
 		try {
-			pinnedClient = await this.#pool.connect();
-			const pinned = new PinnedClientAdapter(this.#pool, pinnedClient);
+			pinnedClient = await this.#writePool.connect();
+			const pinned = new PinnedClientAdapter(this.#writePool, pinnedClient);
 			this.#db.pin(pinned);
 			this.#db.setSchemaSnapshot(await loadSchemaSnapshot(pinned, this.schema));
 			await super.init();
@@ -23071,21 +23284,27 @@ var PostgresStore = class extends _mastra_core_storage.MastraCompositeStore {
 	get db() {
 		return this.#db;
 	}
-	/**
-	* The underlying pg.Pool for direct database access or ORM integration.
-	*/
+	/** Database client for queries that may run against the configured read replica. */
+	get readDb() {
+		return this.#readDb;
+	}
+	/** The underlying writer pg.Pool for direct database access or ORM integration. */
 	get pool() {
-		return this.#pool;
+		return this.#writePool;
+	}
+	/** The underlying reader pg.Pool, falling back to the writer pool when unset. */
+	get readPool() {
+		return this.#readPool;
 	}
 	/**
-	* Closes the connection pool if it was created by this store.
-	* If a pool was passed in via config, it will not be closed.
+	* Closes the writer connection pool if it was created by this store.
+	* Caller-provided writer and reader pools are not closed.
 	* Safe to call multiple times — subsequent calls are no-ops.
 	*/
 	async close() {
-		if (this.#ownsPool && !this.#poolClosed) {
-			this.#poolClosed = true;
-			await this.#pool.end();
+		if (this.#ownsWritePool && !this.#writePoolClosed) {
+			this.#writePoolClosed = true;
+			await this.#writePool.end();
 		}
 	}
 };