@mastra/libsql 1.24.1 → 1.25.1-alpha.0

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.24.1",
+  "version": "1.25.1-alpha.0",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -20,7 +20,7 @@ After getting a response from the LLM, all new messages (user, assistant, and to
 
 ## Quickstart
 
-Semantic recall is disabled by default. To enable it, set `semanticRecall: true` in `options` and provide a `vector` store and `embedder`:
+Semantic recall is disabled by default. To enable it, set `semanticRecall: true` in `options` and provide a `vector` store and an `embedder`. A store that generates embeddings itself, such as MongoDB with Automated Embedding, works without one. See [Server-side embeddings](#server-side-embeddings).
 
 **LibSQL**:
 
@@ -242,6 +242,40 @@ const options = {
 }
 ```
 
+## Server-side embeddings
+
+Some vector stores generate the embeddings themselves. With one of those, semantic recall runs without an `embedder`: the database embeds each message on write and the search string on arrival. The embedding provider stays out of your application entirely.
+
+MongoDB does this through [Automated Embedding](https://mastra.ai/reference/vectors/mongodb): name a Voyage AI model on the vector store and leave the `embedder` out.
+
+```typescript
+import { Memory } from '@mastra/memory'
+import { MongoDBStore, MongoDBVector } from '@mastra/mongodb'
+
+const memory = new Memory({
+  storage: new MongoDBStore({
+    id: 'agent-storage',
+    uri: process.env.MONGODB_URI,
+    dbName: process.env.MONGODB_DB_NAME,
+  }),
+  vector: new MongoDBVector({
+    id: 'agent-vector',
+    uri: process.env.MONGODB_URI,
+    dbName: process.env.MONGODB_DB_NAME,
+    autoEmbed: { model: 'voyage-4' },
+  }),
+  options: {
+    semanticRecall: { topK: 3, messageRange: 2 },
+  },
+})
+```
+
+Messages are stored as text and MongoDB embeds them, so the model choice and the vector size belong to the index rather than to your application. Recall works the same way through an agent and through [`recall()`](#using-the-recall-method).
+
+MongoDB embeds newly written messages in the background. A message saved moments ago may not be recallable immediately.
+
+Every other store expects your application to supply the vectors, and keeps requiring an `embedder`. Enabling semantic recall with neither an `embedder` nor a store that embeds server-side raises an error naming both options.
+
 ## Embedder configuration
 
 Semantic recall relies on an [embedding model](https://mastra.ai/reference/memory/memory-class) to convert messages into embeddings. Mastra supports embedding models through the model router using `provider/model` strings, or you can use any [embedding model](https://sdk.vercel.ai/docs/ai-sdk-core/embeddings) compatible with the AI SDK.

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

@@ -194,6 +194,7 @@ Each provider page includes installation instructions, configuration parameters,
 
 - [Aurora DSQL](https://mastra.ai/integrations/databases/aurora-dsql)
 - [ClickHouse](https://mastra.ai/integrations/databases/clickhouse)
+- [ClickHouse Managed Postgres](https://mastra.ai/integrations/databases/clickhouse-managed-postgres)
 - [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
 - [Cloudflare KV](https://mastra.ai/integrations/databases/cloudflare-kv)
 - [Convex](https://mastra.ai/integrations/databases/convex)

package/dist/index.cjs

@@ -7827,6 +7827,7 @@ function addSqliteMetadataValuePredicate(conditions, params, path, value) {
 var MemoryLibSQL = class MemoryLibSQL extends _mastra_core_storage.MemoryStorage {
 	supportsPartialThreadUpdate = true;
 	supportsObservationalMemory = true;
+	supportsObservationalMemoryHistorySearch = true;
 	/**
 	* Retention-eligible tables. `threads`, `messages`, and `resources` all anchor
 	* on `createdAt` and are indexed for fast batched deletes. Cascade order is
@@ -8998,6 +8999,10 @@ var MemoryLibSQL = class MemoryLibSQL extends _mastra_core_storage.MemoryStorage
 			const lookupKey = this.getOMKey(threadId, resourceId);
 			const conditions = [`"lookupKey" = ?`];
 			const args = [lookupKey];
+			if (options?.recordId !== void 0) {
+				conditions.push(`id = ?`);
+				args.push(options.recordId);
+			}
 			if (options?.from) {
 				conditions.push(`"createdAt" >= ?`);
 				args.push(options.from.toISOString());
@@ -9006,8 +9011,25 @@ var MemoryLibSQL = class MemoryLibSQL extends _mastra_core_storage.MemoryStorage
 				conditions.push(`"createdAt" <= ?`);
 				args.push(options.to.toISOString());
 			}
+			if (options?.groupId !== void 0) {
+				conditions.push(`(instr("activeObservations", ?) > 0 OR EXISTS (
+          SELECT 1 FROM json_each("bufferedObservationChunks") AS chunk
+          WHERE instr(json_extract(chunk.value, '$.observations'), ?) > 0
+        ))`);
+				const prefix = `<observation-group id="${options.groupId}"`;
+				args.push(prefix, prefix);
+			}
+			if (options?.beforeGeneration !== void 0) {
+				conditions.push(`"generationCount" < ?`);
+				args.push(options.beforeGeneration);
+			}
+			if (options?.afterGeneration !== void 0) {
+				conditions.push(`"generationCount" > ?`);
+				args.push(options.afterGeneration);
+			}
+			const direction = options?.sortDirection === "ASC" ? "ASC" : "DESC";
 			args.push(limit);
-			let sql = `SELECT * FROM "${OM_TABLE}" WHERE ${conditions.join(" AND ")} ORDER BY "generationCount" DESC LIMIT ?`;
+			let sql = `SELECT * FROM "${OM_TABLE}" WHERE ${conditions.join(" AND ")} ORDER BY "generationCount" ${direction}, "createdAt" ASC, id ASC LIMIT ?`;
 			if (options?.offset != null) {
 				args.push(options.offset);
 				sql += ` OFFSET ?`;
@@ -11433,16 +11455,17 @@ var SchedulesLibSQL = class SchedulesLibSQL extends _mastra_core_storage.Schedul
 		if (!updated) throw new Error(`Schedule ${id} not found`);
 		return updated;
 	}
-	async updateScheduleNextFire(id, expectedNextFireAt, newNextFireAt, lastFireAt, lastRunId) {
+	async updateScheduleNextFire(id, expectedNextFireAt, newNextFireAt, lastFireAt, lastRunId, newStatus) {
 		return ((await this.#client.execute({
 			sql: `UPDATE ${_mastra_core_storage.TABLE_SCHEDULES}
-            SET next_fire_at = ?, last_fire_at = ?, last_run_id = ?, updated_at = ?
+            SET next_fire_at = ?, last_fire_at = ?, last_run_id = ?, updated_at = ?, status = COALESCE(?, status)
             WHERE id = ? AND next_fire_at = ? AND status = ?`,
 			args: [
 				newNextFireAt,
 				lastFireAt,
 				lastRunId,
 				Date.now(),
+				newStatus ?? null,
 				id,
 				expectedNextFireAt,
 				"active"