@mastra/mysql 0.14.0 → 0.14.1-alpha.0

package/dist/_types/@internal_core/dist/memory/index.d.ts

@@ -1,4 +1,3 @@
-//#region src/memory/index.d.ts
 /**
  * Shared rules for observational memory lifecycle writes. Every storage adapter applies
  * these inside its own atomic section (lock, transaction, or conditional update), so the
@@ -9,18 +8,18 @@
  * into the table schema they get from `@mastra/core`, so the columns exist even when the
  * installed core predates them.
  */
-declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
+export declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
   readonly supersededBy: {
     readonly type: 'text';
     readonly nullable: true;
   };
 };
 /** `schema` plus {@link OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS}; `undefined` when `schema` is. */
-declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
+export declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
 /**
  * Result of `commitActiveObservations`.
  */
-interface UpdateActiveObservationsResult {
+export interface UpdateActiveObservationsResult {
   /** Whether the observations were written. */
   applied: boolean;
   /**
@@ -38,14 +37,14 @@ interface UpdateActiveObservationsResult {
  * the head's cursor. Chunks carry `lastObservedAt = max message time + 1ms`, so a chunk is
  * wholly covered iff `head.lastObservedAt >= chunk.lastObservedAt - 1ms`.
  */
-interface UpdateBufferedObservationsResult {
+export interface UpdateBufferedObservationsResult {
   /** Whether the chunk was stored. */
   persisted: boolean;
   /** The record the chunk was written to (or would have been written to). */
   recordId: string;
 }
 /** The fields of an observational memory record that decide head order. */
-interface ObservationalMemoryHeadOrderFields {
+export interface ObservationalMemoryHeadOrderFields {
   generationCount: number;
   createdAt: Date | string;
   id: string;
@@ -54,16 +53,16 @@ interface ObservationalMemoryHeadOrderFields {
  * Canonical head order: `generationCount DESC, createdAt ASC, id ASC`.
  * Returns a negative number when `a` sorts before `b` (i.e. `a` is the better head candidate).
  */
-declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
+export declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
 /**
  * A buffered chunk stores `lastObservedAt = max message time + 1ms`. It is wholly covered
  * (every message it observed is already at or before the cursor) iff
  * `cursor >= chunk.lastObservedAt - 1ms`.
  */
-declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
+export declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
 /** The later of two cursors; `undefined` only when both are absent. */
-declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
-interface ReflectionTextPlan {
+export declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
+export interface ReflectionTextPlan {
   /** `equal`: stored text equals the snapshot. `append`: observations were appended after the snapshot. */
   mode: 'equal' | 'append';
   observations: string;
@@ -78,7 +77,7 @@ interface ReflectionTextPlan {
  *   after the reflection, and its tokens are added.
  * - Anything else (a non-append rewrite): `null` — the reflection must not be applied.
  */
-declare function planReflectionGenerationText(input: {
+export declare function planReflectionGenerationText(input: {
   storedObservations: string;
   storedObservationTokenCount: number;
   snapshotObservations: string;
@@ -91,12 +90,10 @@ declare function planReflectionGenerationText(input: {
  * Callers of `updateActiveObservations` (which resolves `void`) can't see a commit result, so a
  * write that was not applied throws instead of resolving as if it had committed.
  */
-declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
+export declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
 /**
  * Whether the stored text can still accept a reflection built from `snapshot`
  * (equal, or only appended to since).
  */
-declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
-//#endregion
-export { OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS, ObservationalMemoryHeadOrderFields, ReflectionTextPlan, UpdateActiveObservationsResult, UpdateBufferedObservationsResult, assertActiveObservationsApplied, compareObservationalMemoryHeadOrder, isAppendOnlySince, isBufferedChunkCoveredByCursor, maxObservationCursor, planReflectionGenerationText, withObservationalMemoryLifecycleColumns };
+export declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
 //# sourceMappingURL=index.d.ts.map

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.14.0"
+  version: "0.14.1-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.14.0",
+  "version": "0.14.1-alpha.0",
   "package": "@mastra/mysql",
   "exports": {},
   "modules": {}

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

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

package/dist/index.cjs

@@ -6,7 +6,7 @@ let _mastra_core_utils = require("@mastra/core/utils");
 let crypto$1 = require("crypto");
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_storage_domains_skills = require("@mastra/core/storage/domains/skills");
-//#region src/storage/db/schema-snapshot.ts
+// src/storage/db/schema-snapshot.ts
 /** Builds the `table.index` presence key the snapshot uses. */
 function indexKey(table, index) {
 	return `${table.toLowerCase()}.${index.toLowerCase()}`;
@@ -45,8 +45,7 @@ async function loadSchemaSnapshot(pool, schemaName) {
 		indexes
 	};
 }
-//#endregion
-//#region src/storage/domains/utils.ts
+// src/storage/domains/utils.ts
 function quoteIdentifier(value, context) {
 	return `\`${(0, _mastra_core_utils.parseSqlIdentifier)(value, context)}\``;
 }
@@ -181,8 +180,7 @@ function parseDateTime(value) {
 	const withZone = /[zZ]|[+-]\d\d:?\d\d$/.test(normalized) ? normalized : `${normalized}Z`;
 	return new Date(withZone);
 }
-//#endregion
-//#region src/storage/domains/operations/index.ts
+// src/storage/domains/operations/index.ts
 var StoreOperationsMySQL = class extends _mastra_core_storage.StoreOperations {
 	pool;
 	database;
@@ -776,8 +774,7 @@ function mapToMySqlType(type, isKey = false) {
 		default: return "TEXT";
 	}
 }
-//#endregion
-//#region src/storage/domains/agents/index.ts
+// src/storage/domains/agents/index.ts
 var AgentsMySQL = class AgentsMySQL extends _mastra_core_storage.AgentsStorage {
 	pool;
 	operations;
@@ -1374,8 +1371,7 @@ var AgentsMySQL = class AgentsMySQL extends _mastra_core_storage.AgentsStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/background-tasks/index.ts
+// src/storage/domains/background-tasks/index.ts
 function serializeJson(v) {
 	if (typeof v === "object" && v != null) return JSON.stringify(v);
 	return v ?? null;
@@ -1693,8 +1689,7 @@ var BackgroundTasksMySQL = class BackgroundTasksMySQL extends _mastra_core_stora
 		return Number(rows[0]?.count ?? 0);
 	}
 };
-//#endregion
-//#region src/storage/domains/blobs/index.ts
+// src/storage/domains/blobs/index.ts
 const INSERT_IGNORE_SQL = `INSERT IGNORE INTO ${formatTableName(_mastra_core_storage.TABLE_SKILL_BLOBS)} (${[
 	"hash",
 	"content",
@@ -1775,8 +1770,7 @@ var BlobsMySQL = class extends _mastra_core_storage.BlobStore {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/channels/index.ts
+// src/storage/domains/channels/index.ts
 var ChannelsMySQL = class ChannelsMySQL extends _mastra_core_storage.ChannelsStorage {
 	pool;
 	operations;
@@ -1910,8 +1904,7 @@ var ChannelsMySQL = class ChannelsMySQL extends _mastra_core_storage.ChannelsSto
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/datasets/index.ts
+// src/storage/domains/datasets/index.ts
 function parseJSON$3(value) {
 	if (value === null || value === void 0) return void 0;
 	if (typeof value === "string") try {
@@ -3062,8 +3055,7 @@ var DatasetsMySQL = class DatasetsMySQL extends _mastra_core_storage.DatasetsSto
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/experiments/index.ts
+// src/storage/domains/experiments/index.ts
 function parseJSON$2(value) {
 	if (value === null || value === void 0) return void 0;
 	if (typeof value === "string") {
@@ -3935,8 +3927,7 @@ var ExperimentsMySQL = class ExperimentsMySQL extends _mastra_core_storage.Exper
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/favorites/index.ts
+// src/storage/domains/favorites/index.ts
 /**
 * Maps a favorite entity type to its parent entity table.
 */
@@ -4172,8 +4163,7 @@ var FavoritesMySQL = class FavoritesMySQL extends _mastra_core_storage.Favorites
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/knowledge/index.ts
+// src/storage/domains/knowledge/index.ts
 let assertDescriptionWithinBound;
 async function assertKnowledgeDescriptionWithinBoundCompat(description) {
 	let assertWithinBound = assertDescriptionWithinBound;
@@ -5068,8 +5058,7 @@ var KnowledgeMySQL = class extends _mastra_core_storage.KnowledgeStorage {
 		});
 	}
 };
-//#endregion
-//#region src/storage/domains/mcp-clients/index.ts
+// src/storage/domains/mcp-clients/index.ts
 var MCPClientsMySQL = class MCPClientsMySQL extends _mastra_core_storage.MCPClientsStorage {
 	pool;
 	operations;
@@ -5542,8 +5531,7 @@ var MCPClientsMySQL = class MCPClientsMySQL extends _mastra_core_storage.MCPClie
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/mcp-servers/index.ts
+// src/storage/domains/mcp-servers/index.ts
 var MCPServersMySQL = class MCPServersMySQL extends _mastra_core_storage.MCPServersStorage {
 	pool;
 	operations;
@@ -6032,8 +6020,7 @@ var MCPServersMySQL = class MCPServersMySQL extends _mastra_core_storage.MCPServ
 		}
 	}
 };
-//#endregion
-//#region ../../packages/_internal-core/dist/memory/index.js
+// ../../packages/_internal-core/dist/memory/index.js
 /**
 * Shared rules for observational memory lifecycle writes. Every storage adapter applies
 * these inside its own atomic section (lock, transaction, or conditional update), so the
@@ -6118,8 +6105,7 @@ function isAppendOnlySince(storedObservations, snapshotObservations) {
 	const snapshot = snapshotObservations ?? "";
 	return stored === snapshot || stored.startsWith(snapshot);
 }
-//#endregion
-//#region src/storage/db/run-fencing.ts
+// src/storage/db/run-fencing.ts
 /**
 * Epoch milliseconds on the database clock. `UTC_TIMESTAMP` is the time the
 * statement started and doesn't depend on the session time zone. Every lease
@@ -6187,8 +6173,7 @@ async function claimTransaction(pool, fn) {
 		if (attempt >= MAX_CLAIM_ATTEMPTS || errno !== ER_DUP_ENTRY && errno !== ER_LOCK_DEADLOCK) throw error;
 	}
 }
-//#endregion
-//#region src/storage/domains/memory/index.ts
+// src/storage/domains/memory/index.ts
 const OM_TABLE = "mastra_observational_memory";
 const OM_TABLE_QUOTED = quoteIdentifier(OM_TABLE, "table name");
 const RUN_FENCES_TABLE = formatTableName(_mastra_core_storage.TABLE_MEMORY_RUN_FENCES);
@@ -8379,8 +8364,7 @@ var MemoryMySQL = class MemoryMySQL extends _mastra_core_storage.MemoryStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/observability/index.ts
+// src/storage/domains/observability/index.ts
 const JSON_SPAN_FIELDS = [
 	"input",
 	"output",
@@ -8914,8 +8898,7 @@ var ObservabilityMySQL = class ObservabilityMySQL extends _mastra_core_storage.O
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/prompt-blocks/index.ts
+// src/storage/domains/prompt-blocks/index.ts
 var PromptBlocksMySQL = class PromptBlocksMySQL extends _mastra_core_storage.PromptBlocksStorage {
 	pool;
 	operations;
@@ -9387,8 +9370,7 @@ var PromptBlocksMySQL = class PromptBlocksMySQL extends _mastra_core_storage.Pro
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/schedules/index.ts
+// src/storage/domains/schedules/index.ts
 function parseJson(val) {
 	if (val == null) return void 0;
 	if (typeof val === "string") try {
@@ -9657,8 +9639,7 @@ var SchedulesMySQL = class SchedulesMySQL extends _mastra_core_storage.Schedules
 		return rows.map((r) => rowToTrigger(r));
 	}
 };
-//#endregion
-//#region src/storage/domains/scorer-definitions/index.ts
+// src/storage/domains/scorer-definitions/index.ts
 var ScorerDefinitionsMySQL = class ScorerDefinitionsMySQL extends _mastra_core_storage.ScorerDefinitionsStorage {
 	pool;
 	operations;
@@ -10133,8 +10114,7 @@ var ScorerDefinitionsMySQL = class ScorerDefinitionsMySQL extends _mastra_core_s
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/scores/index.ts
+// src/storage/domains/scores/index.ts
 function parseJSON(value) {
 	if (value === null || value === void 0) return void 0;
 	if (typeof value === "string") {
@@ -10429,8 +10409,7 @@ var ScoresMySQL = class ScoresMySQL extends _mastra_core_storage.ScoresStorage {
 		}), pagination);
 	}
 };
-//#endregion
-//#region src/storage/domains/skills/index.ts
+// src/storage/domains/skills/index.ts
 const SNAPSHOT_FIELDS$1 = [
 	"name",
 	"description",
@@ -10990,8 +10969,7 @@ var SkillsMySQL = class SkillsMySQL extends _mastra_core_storage.SkillsStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/tool-provider-connections/index.ts
+// src/storage/domains/tool-provider-connections/index.ts
 function normaliseScope(raw) {
 	const value = raw == null ? "per-author" : String(raw);
 	if (value === "shared") return "shared";
@@ -11216,8 +11194,7 @@ var ToolProviderConnectionsMySQL = class ToolProviderConnectionsMySQL extends _m
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workflow-definitions/index.ts
+// src/storage/domains/workflow-definitions/index.ts
 function rowToDefinition(row) {
 	const transformed = transformFromSqlRow({
 		tableName: _mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS,
@@ -11358,8 +11335,7 @@ var WorkflowDefinitionsMySQL = class extends _mastra_core_storage.WorkflowDefini
 		await this.pool.execute(`DELETE FROM ${formatTableName(_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS, this.database)} WHERE ${quoteIdentifier("id", "column name")} = ?`, [id]);
 	}
 };
-//#endregion
-//#region src/storage/domains/workflows/index.ts
+// src/storage/domains/workflows/index.ts
 function parseSnapshot(snapshot) {
 	if (typeof snapshot === "string") try {
 		return JSON.parse(snapshot);
@@ -11878,8 +11854,7 @@ var WorkflowsMySQL = class WorkflowsMySQL extends _mastra_core_storage.Workflows
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workspaces/index.ts
+// src/storage/domains/workspaces/index.ts
 const SNAPSHOT_FIELDS = [
 	"name",
 	"description",
@@ -12397,8 +12372,7 @@ var WorkspacesMySQL = class WorkspacesMySQL extends _mastra_core_storage.Workspa
 		}
 	}
 };
-//#endregion
-//#region src/storage/index.ts
+// src/storage/index.ts
 function validateConfig(config) {
 	if ("connectionString" in config) {
 		if (!config.connectionString || typeof config.connectionString !== "string") throw new Error("MySQLStore: connectionString must be a non-empty string.");
@@ -12671,7 +12645,6 @@ var MySQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 		await this.pool.end();
 	}
 };
-//#endregion
 exports.AgentsMySQL = AgentsMySQL;
 exports.BlobsMySQL = BlobsMySQL;
 exports.DatasetsMySQL = DatasetsMySQL;