@mastra/mysql 0.10.0 → 0.10.1

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-mysql
 description: Documentation for @mastra/mysql. Use when working with @mastra/mysql APIs, configuration, or implementation.
 metadata:
   package: "@mastra/mysql"
-  version: "0.10.0"
+  version: "0.10.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.10.0",
+  "version": "0.10.1",
   "package": "@mastra/mysql",
   "exports": {},
   "modules": {}

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

@@ -15,7 +15,7 @@ Storage adapters use the shared core retention contract for `prune()`, or a data
 | Adapter              | Mechanism               | Retention support                                                                                                                                                                      |
 | -------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | libSQL               | `prune()`               | All supported growth domains                                                                                                                                                           |
-| PostgreSQL           | `prune()`               | All supported growth domains. V-next observability drops expired partitions or chunks                                                                                                  |
+| PostgreSQL           | `prune()`               | All supported growth domains. vNext observability drops expired partitions or chunks                                                                                                   |
 | MongoDB              | `prune()` or native TTL | All supported growth domains. Native TTL indexes are also available                                                                                                                    |
 | DuckDB               | `prune()`               | Observability spans, metrics, logs, scores, and feedback                                                                                                                               |
 | MySQL                | `prune()`               | Observability spans                                                                                                                                                                    |
@@ -102,10 +102,10 @@ Each domain specifies its age-prunable tables and the timestamp column that anch
 | `memory`          | `resources`        | `createdAt`      | Resource age                                                     |
 | `threadState`     | `threadState`      | `updatedAt`      | Inactivity: state for still-active threads survives              |
 | `observability`   | `spans`            | `startedAt`      | Span age                                                         |
-| `observability`   | `metrics`          | `timestamp`      | Metric event age (v-next only)                                   |
-| `observability`   | `logs`             | `timestamp`      | Log event age (v-next only)                                      |
-| `observability`   | `scores`           | `timestamp`      | Score event age (v-next only)                                    |
-| `observability`   | `feedback`         | `timestamp`      | Feedback event age (v-next only)                                 |
+| `observability`   | `metrics`          | `timestamp`      | Metric event age (vNext only)                                    |
+| `observability`   | `logs`             | `timestamp`      | Log event age (vNext only)                                       |
+| `observability`   | `scores`           | `timestamp`      | Score event age (vNext only)                                     |
+| `observability`   | `feedback`         | `timestamp`      | Feedback event age (vNext only)                                  |
 | `scores`          | `scorers`          | `createdAt`      | Score record age                                                 |
 | `workflows`       | `workflowSnapshot` | `updatedAt`      | Inactivity, suspended or long-running workflows survive          |
 | `backgroundTasks` | `backgroundTasks`  | `completedAt`    | Time since completion, in-flight tasks (`NULL`) are never pruned |
@@ -122,7 +122,7 @@ Each domain specifies its age-prunable tables and the timestamp column that anch
 > - On PostgreSQL, timestamp anchors use the timezone-aware mirror columns (for example `createdAtZ`, `completedAtZ`).
 > - DuckDB observability stores append-only events for all five signals. Its `spans` policy uses the event `timestamp` column rather than `startedAt`.
 > - LibSQL and PostgreSQL support all domains above except `harness`, which PostgreSQL doesn't implement. MongoDB supports all except `threadState` and `harness`. DuckDB, MySQL, Microsoft SQL Server, Oracle Database, Amazon Aurora DSQL, and Google Cloud Spanner currently support retention only in their `observability` domains, with the signal coverage shown in the support matrix.
-> - The v-next PostgreSQL observability domain stores signal events in day-partitioned tables (`spans`, `metrics`, `logs`, `scores`, `feedback`). For it, `prune()` drops whole day partitions (or TimescaleDB chunks) that are entirely older than the cutoff instead of deleting rows: effective level of detail is one day, and a partition is only dropped once its entire day is past `maxAge`. `PruneResult.deleted` reports the number of rows in the dropped partitions.
+> - The vNext PostgreSQL observability domain stores signal events in day-partitioned tables (`spans`, `metrics`, `logs`, `scores`, `feedback`). For it, `prune()` drops whole day partitions (or TimescaleDB chunks) that are entirely older than the cutoff instead of deleting rows: effective level of detail is one day, and a partition is only dropped once its entire day is past `maxAge`. `PruneResult.deleted` reports the number of rows in the dropped partitions.
 
 ## Methods
 
@@ -208,7 +208,9 @@ You can also cancel a long-running prune with an `AbortSignal`: the loop stops b
 
 ClickHouse observability storage uses native table TTLs instead of `prune()`. Configure retention as days per signal. `init()` applies the TTLs to new and existing tables and skips `ALTER TABLE` statements when the configured TTL is already present.
 
-For deployments that need to update TTL configuration without running the full initialization path, call `applyRetention()` on the v-next observability store:
+Omitted signals, and signals set to zero or less, get no TTL. When you remove a signal from `retention`, the next `init()` or `applyRetention()` removes that table's TTL. If Mastra can't read the current TTLs from `system.tables`, it applies the configured TTLs and leaves the others unchanged.
+
+For deployments that need to update TTL configuration without running the full initialization path, call `applyRetention()` on the vNext observability store:
 
 ```typescript
 import { ObservabilityStorageClickhouseVNext } from '@mastra/clickhouse'

package/dist/index.cjs

@@ -1884,6 +1884,17 @@ function parseOptionalJSON(value, emptyValue) {
 function jsonArg(value) {
 	return value === void 0 || value === null ? null : JSON.stringify(value);
 }
+function jsonDataArg(value) {
+	return value === void 0 ? null : JSON.stringify(value);
+}
+const ITEM_SELECT_COLUMNS = Object.keys(_mastra_core_storage.DATASET_ITEMS_SCHEMA).map((column) => {
+	const name = quoteIdentifier(column, "column name");
+	return [
+		"input",
+		"groundTruth",
+		"expectedTrajectory"
+	].includes(column) ? `CAST(${name} AS CHAR CHARACTER SET utf8mb4) AS ${name}` : name;
+}).join(", ");
 var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsStorage {
 	pool;
 	operations;
@@ -2032,15 +2043,15 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 		return {
 			id: row.id,
 			name: row.name,
-			description: row.description,
+			description: row.description ?? void 0,
 			metadata: parseJSON$3(row.metadata),
 			inputSchema: parseJSON$3(row.inputSchema),
 			groundTruthSchema: parseJSON$3(row.groundTruthSchema),
 			requestContextSchema: parseJSON$3(row.requestContextSchema),
-			tags: parseJSON$3(row.tags) ?? null,
-			targetType: row.targetType ?? null,
-			targetIds: parseJSON$3(row.targetIds) ?? null,
-			scorerIds: parseJSON$3(row.scorerIds) ?? null,
+			tags: parseJSON$3(row.tags),
+			targetType: row.targetType ?? void 0,
+			targetIds: parseJSON$3(row.targetIds),
+			scorerIds: parseJSON$3(row.scorerIds),
 			version: row.version,
 			organizationId: row.organizationId ?? null,
 			projectId: row.projectId ?? null,
@@ -2141,9 +2152,9 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 				inputSchema: input.inputSchema ?? void 0,
 				groundTruthSchema: input.groundTruthSchema ?? void 0,
 				requestContextSchema: input.requestContextSchema ?? void 0,
-				targetType: input.targetType ?? null,
-				targetIds: input.targetIds ?? null,
-				scorerIds: input.scorerIds ?? null,
+				targetType: input.targetType ?? void 0,
+				targetIds: input.targetIds ?? void 0,
+				scorerIds: input.scorerIds ?? void 0,
 				version: 0,
 				organizationId: input.organizationId ?? null,
 				projectId: input.projectId ?? null,
@@ -2223,10 +2234,10 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 				inputSchema: (args.inputSchema !== void 0 ? args.inputSchema : existing.inputSchema) ?? void 0,
 				groundTruthSchema: (args.groundTruthSchema !== void 0 ? args.groundTruthSchema : existing.groundTruthSchema) ?? void 0,
 				requestContextSchema: (args.requestContextSchema !== void 0 ? args.requestContextSchema : existing.requestContextSchema) ?? void 0,
-				tags: (args.tags !== void 0 ? args.tags : existing.tags) ?? null,
-				targetType: (args.targetType !== void 0 ? args.targetType : existing.targetType) ?? null,
-				targetIds: (args.targetIds !== void 0 ? args.targetIds : existing.targetIds) ?? null,
-				scorerIds: (args.scorerIds !== void 0 ? args.scorerIds : existing.scorerIds) ?? null,
+				tags: (args.tags !== void 0 ? args.tags : existing.tags) ?? void 0,
+				targetType: (args.targetType !== void 0 ? args.targetType : existing.targetType) ?? void 0,
+				targetIds: (args.targetIds !== void 0 ? args.targetIds : existing.targetIds) ?? void 0,
+				scorerIds: (args.scorerIds !== void 0 ? args.scorerIds : existing.scorerIds) ?? void 0,
 				updatedAt: data.updatedAt
 			};
 		} catch (error) {
@@ -2386,8 +2397,8 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 				newVersion,
 				parentOrganizationId,
 				parentProjectId,
-				jsonArg(args.input),
-				jsonArg(args.groundTruth),
+				jsonDataArg(args.input),
+				jsonDataArg(args.groundTruth),
 				args.unmockedToolPolicy ?? null,
 				jsonArg(args.scorerIds),
 				jsonArg(args.metadata),
@@ -2438,7 +2449,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 			const tableItemsName = formatTableName(_mastra_core_storage.TABLE_DATASET_ITEMS);
 			const tableVersionsName = formatTableName(_mastra_core_storage.TABLE_DATASET_VERSIONS);
 			await connection.execute(`SELECT id FROM ${tableDatasetsName} WHERE id = ? FOR UPDATE`, [args.datasetId]);
-			const [itemRows] = await connection.execute(`SELECT * FROM ${tableItemsName} WHERE id = ? AND validTo IS NULL AND isDeleted = 0`, [args.id]);
+			const [itemRows] = await connection.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE id = ? AND validTo IS NULL AND isDeleted = 0`, [args.id]);
 			const itemRow = itemRows[0];
 			const existing = itemRow ? this.mapItem(itemRow) : null;
 			if (!existing) throw new _mastra_core_error.MastraError({
@@ -2467,9 +2478,9 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 				},
 				text: `Purged dataset item cannot be updated: ${args.id}`
 			});
-			const mergedInput = args.input ?? existing.input;
-			const mergedGroundTruth = args.groundTruth ?? existing.groundTruth;
-			const mergedExpectedTrajectory = args.expectedTrajectory ?? existing.expectedTrajectory;
+			const mergedInput = args.input !== void 0 ? args.input : existing.input;
+			const mergedGroundTruth = args.groundTruth !== void 0 ? args.groundTruth : existing.groundTruth;
+			const mergedExpectedTrajectory = args.expectedTrajectory !== void 0 ? args.expectedTrajectory : existing.expectedTrajectory;
 			const mergedToolMocks = args.toolMocks ?? existing.toolMocks;
 			const mergedUnmockedToolPolicy = args.unmockedToolPolicy ?? existing.unmockedToolPolicy;
 			const mergedScorerIds = args.scorerIds !== void 0 ? args.scorerIds ?? void 0 : existing.scorerIds;
@@ -2490,9 +2501,9 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 				existing.externalId ?? null,
 				parentOrganizationId,
 				parentProjectId,
-				jsonArg(mergedInput),
-				jsonArg(mergedGroundTruth),
-				jsonArg(mergedExpectedTrajectory),
+				jsonDataArg(mergedInput),
+				jsonDataArg(mergedGroundTruth),
+				jsonDataArg(mergedExpectedTrajectory),
 				jsonArg(mergedToolMocks),
 				mergedUnmockedToolPolicy ?? null,
 				jsonArg(mergedScorerIds),
@@ -2547,7 +2558,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 			const tableItemsName = formatTableName(_mastra_core_storage.TABLE_DATASET_ITEMS);
 			const tableVersionsName = formatTableName(_mastra_core_storage.TABLE_DATASET_VERSIONS);
 			await connection.execute(`SELECT id FROM ${tableDatasetsName} WHERE id = ? FOR UPDATE`, [datasetId]);
-			const [itemRows] = await connection.execute(`SELECT * FROM ${tableItemsName} WHERE id = ? AND validTo IS NULL AND isDeleted = 0`, [id]);
+			const [itemRows] = await connection.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE id = ? AND validTo IS NULL AND isDeleted = 0`, [id]);
 			const itemRow = itemRows[0];
 			const existing = itemRow ? this.mapItem(itemRow) : null;
 			if (!existing) {
@@ -2578,9 +2589,9 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 				existing.externalId ?? null,
 				parentOrganizationId,
 				parentProjectId,
-				jsonArg(existing.input),
-				jsonArg(existing.groundTruth),
-				jsonArg(existing.expectedTrajectory),
+				jsonDataArg(existing.input),
+				jsonDataArg(existing.groundTruth),
+				jsonDataArg(existing.expectedTrajectory),
 				jsonArg(existing.toolMocks),
 				existing.unmockedToolPolicy ?? null,
 				jsonArg(existing.scorerIds),
@@ -2660,12 +2671,12 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 		try {
 			const tableItemsName = formatTableName(_mastra_core_storage.TABLE_DATASET_ITEMS);
 			let rows;
-			if (args.datasetVersion !== void 0) [rows] = await this.pool.execute(`SELECT * FROM ${tableItemsName} WHERE \`id\` = ? AND \`datasetVersion\` <= ? AND (\`validTo\` IS NULL OR \`validTo\` > ?) AND \`isDeleted\` = 0 ORDER BY \`datasetVersion\` DESC LIMIT 1`, [
+			if (args.datasetVersion !== void 0) [rows] = await this.pool.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE \`id\` = ? AND \`datasetVersion\` <= ? AND (\`validTo\` IS NULL OR \`validTo\` > ?) AND \`isDeleted\` = 0 ORDER BY \`datasetVersion\` DESC LIMIT 1`, [
 				args.id,
 				args.datasetVersion,
 				args.datasetVersion
 			]);
-			else [rows] = await this.pool.execute(`SELECT * FROM ${tableItemsName} WHERE \`id\` = ? AND \`validTo\` IS NULL AND \`isDeleted\` = 0`, [args.id]);
+			else [rows] = await this.pool.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE \`id\` = ? AND \`validTo\` IS NULL AND \`isDeleted\` = 0`, [args.id]);
 			return rows.length > 0 ? this.mapItem(rows[0]) : null;
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -2678,7 +2689,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 	async getItemsByVersion({ datasetId, version }) {
 		try {
 			const tableItemsName = formatTableName(_mastra_core_storage.TABLE_DATASET_ITEMS);
-			const [rows] = await this.pool.execute(`SELECT * FROM ${tableItemsName} WHERE \`datasetId\` = ? AND \`datasetVersion\` <= ? AND (\`validTo\` IS NULL OR \`validTo\` > ?) AND \`isDeleted\` = 0 ORDER BY \`createdAt\` DESC, \`id\` ASC`, [
+			const [rows] = await this.pool.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE \`datasetId\` = ? AND \`datasetVersion\` <= ? AND (\`validTo\` IS NULL OR \`validTo\` > ?) AND \`isDeleted\` = 0 ORDER BY \`createdAt\` DESC, \`id\` ASC`, [
 				datasetId,
 				version,
 				version
@@ -2695,7 +2706,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 	async getItemHistory(itemId) {
 		try {
 			const tableItemsName = formatTableName(_mastra_core_storage.TABLE_DATASET_ITEMS);
-			const [rows] = await this.pool.execute(`SELECT * FROM ${tableItemsName} WHERE \`id\` = ? ORDER BY \`datasetVersion\` DESC`, [itemId]);
+			const [rows] = await this.pool.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE \`id\` = ? ORDER BY \`datasetVersion\` DESC`, [itemId]);
 			return rows.map((row) => this.mapItemFull(row));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -2752,7 +2763,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 			const perPage = (0, _mastra_core_storage.normalizePerPage)(perPageInput, 100);
 			const { offset, perPage: perPageForResponse } = (0, _mastra_core_storage.calculatePagination)(page, perPageInput, perPage);
 			const limitValue = perPageInput === false ? total : perPage;
-			const [rows] = await this.pool.execute(`SELECT * FROM ${tableItemsName}${whereSql} ORDER BY ${quoteIdentifier(orderBy.field, "column name")} ${orderBy.direction}, \`id\` ASC LIMIT ${limitValue} OFFSET ${offset}`, params);
+			const [rows] = await this.pool.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName}${whereSql} ORDER BY ${quoteIdentifier(orderBy.field, "column name")} ${orderBy.direction}, \`id\` ASC LIMIT ${limitValue} OFFSET ${offset}`, params);
 			return {
 				items: rows.map((row) => this.mapItem(row)),
 				pagination: {
@@ -2863,7 +2874,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 			let historyRows = [];
 			if (externalIds.length > 0) {
 				const placeholders = externalIds.map(() => "?").join(", ");
-				const [rows] = await connection.execute(`SELECT * FROM ${tableItemsName} WHERE \`datasetId\` = ? AND \`externalId\` IN (${placeholders}) ORDER BY \`datasetVersion\` ASC`, [input.datasetId, ...externalIds]);
+				const [rows] = await connection.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE \`datasetId\` = ? AND \`externalId\` IN (${placeholders}) ORDER BY \`datasetVersion\` ASC`, [input.datasetId, ...externalIds]);
 				historyRows = rows.map((row) => this.mapItemFull(row));
 			}
 			const plan = this.planDatasetItemBatch(input.items, historyRows, crypto$1.randomUUID);
@@ -2884,9 +2895,9 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 					item.externalId ?? null,
 					dataset.organizationId ?? null,
 					dataset.projectId ?? null,
-					jsonArg(item.input),
-					jsonArg(item.groundTruth),
-					jsonArg(item.expectedTrajectory),
+					jsonDataArg(item.input),
+					jsonDataArg(item.groundTruth),
+					jsonDataArg(item.expectedTrajectory),
 					jsonArg(item.toolMocks),
 					item.unmockedToolPolicy ?? null,
 					jsonArg(item.scorerIds),
@@ -2947,7 +2958,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 			await connection.execute(`SELECT id FROM ${tableDatasetsName} WHERE id = ? FOR UPDATE`, [input.datasetId]);
 			const currentItems = [];
 			for (const itemId of input.itemIds) {
-				const [itemRows] = await connection.execute(`SELECT * FROM ${tableItemsName} WHERE id = ? AND validTo IS NULL AND isDeleted = 0`, [itemId]);
+				const [itemRows] = await connection.execute(`SELECT ${ITEM_SELECT_COLUMNS} FROM ${tableItemsName} WHERE id = ? AND validTo IS NULL AND isDeleted = 0`, [itemId]);
 				const row = itemRows[0];
 				const item = row ? this.mapItem(row) : null;
 				if (item && item.datasetId === input.datasetId) currentItems.push(item);
@@ -2970,9 +2981,9 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 					item.externalId ?? null,
 					parentOrganizationId,
 					parentProjectId,
-					jsonArg(item.input),
-					jsonArg(item.groundTruth),
-					jsonArg(item.expectedTrajectory),
+					jsonDataArg(item.input),
+					jsonDataArg(item.groundTruth),
+					jsonDataArg(item.expectedTrajectory),
 					jsonArg(item.toolMocks),
 					item.unmockedToolPolicy ?? null,
 					jsonArg(item.scorerIds),