@mastra/libsql 1.10.0 → 1.10.1-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/libsql
 
+## 1.10.1-alpha.1
+
+### Patch Changes
+
+- **Fixed** Workflow runs no longer fail to persist when request context contains non-serializable values (for example functions, circular references, or platform proxy objects). This prevents errors when saving workflow snapshots and scorer results. See #12301. ([#12573](https://github.com/mastra-ai/mastra/pull/12573))
+
+- Updated dependencies [[`6742347`](https://github.com/mastra-ai/mastra/commit/6742347d71955d7639adc9ddf6ff8282de7ee3ba), [`7b0ad1f`](https://github.com/mastra-ai/mastra/commit/7b0ad1f5c53dc118c6da12ae82ae2587037dc2b8), [`62666c3`](https://github.com/mastra-ai/mastra/commit/62666c367eaeac3941ead454b1d38810cc855721), [`4af2160`](https://github.com/mastra-ai/mastra/commit/4af2160322f4718cac421930cce85641e9512389), [`136c959`](https://github.com/mastra-ai/mastra/commit/136c9592fb0eeb0cd212f28629d8a29b7557a2fc), [`4df7cc7`](https://github.com/mastra-ai/mastra/commit/4df7cc79342fd065fe7fdeef93c094db14b12bcd), [`aca3121`](https://github.com/mastra-ai/mastra/commit/aca31211233dac25459f140ea4fcfb3a5af64c18), [`9cdf38e`](https://github.com/mastra-ai/mastra/commit/9cdf38e58506e1109c8b38f97cd7770978a4218e), [`990851e`](https://github.com/mastra-ai/mastra/commit/990851edcb0e30be5c2c18b6532f1a876cc2d335), [`6068a6c`](https://github.com/mastra-ai/mastra/commit/6068a6c42950fad3ebfc92346417896ba60803d2), [`00106be`](https://github.com/mastra-ai/mastra/commit/00106bede59b81e5b0e9cd6aad8d3b5dbc336387), [`e2a079c`](https://github.com/mastra-ai/mastra/commit/e2a079cc3755b1895f7bd5dc36e9be81b11c7c22), [`534a456`](https://github.com/mastra-ai/mastra/commit/534a456a25e4df1e5407e7e632f4cb3b1fa14f9d), [`36bae07`](https://github.com/mastra-ai/mastra/commit/36bae07c0e70b1b3006f2fd20830e8883dcbd066)]:
+  - @mastra/core@1.33.0-alpha.7
+
+## 1.10.1-alpha.0
+
+### Patch Changes
+
+- Track `suspendedAt` and `suspendPayload` on background tasks. SQL adapters auto-migrate the new columns via `alterTable`. ([#16260](https://github.com/mastra-ai/mastra/pull/16260))
+
+- Updated dependencies [[`9f17410`](https://github.com/mastra-ai/mastra/commit/9f1741080def23d42ee50b39887a385ae316a3c6), [`c6eb39e`](https://github.com/mastra-ai/mastra/commit/c6eb39ea6dca381c6563cb240237fbe608e02f93), [`900d086`](https://github.com/mastra-ai/mastra/commit/900d086bb737b9cf2fcf68f11b0389b801a2738c), [`4c0e286`](https://github.com/mastra-ai/mastra/commit/4c0e28637c9cfb4f416549b55e97ebfa13319dfc), [`25184ff`](https://github.com/mastra-ai/mastra/commit/25184ffaf1293ec95119426eb1a1f8d38831b96c), [`aebde9c`](https://github.com/mastra-ai/mastra/commit/aebde9cfacf56592c6b6350cae721740fe090b8a)]:
+  - @mastra/core@1.33.0-alpha.4
+
 ## 1.10.0
 
 ### Minor Changes

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.10.0"
+  version: "1.10.1-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.10.0",
+  "version": "1.10.1-alpha.1",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-memory-overview.md

@@ -237,4 +237,5 @@ export const memoryAgent = new Agent({
 
 - [`Memory` reference](https://mastra.ai/reference/memory/memory-class)
 - [Tracing](https://mastra.ai/docs/observability/tracing/overview)
-- [Request Context](https://mastra.ai/docs/server/request-context)
+- [Request Context](https://mastra.ai/docs/server/request-context)
+- [Mastra Code](https://code.mastra.ai/): A coding agent using Mastra's memory system

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

@@ -121,26 +121,88 @@ Each vector store page below includes installation instructions, configuration p
 
 ## Recall configuration
 
-The three main parameters that control semantic recall behavior are:
+The following options control semantic recall behavior:
 
-1. **topK**: How many semantically similar messages to retrieve
-2. **messageRange**: How much surrounding context to include with each match
-3. **scope**: Whether to search within the current thread or across all threads owned by a resource (the default is resource scope).
+1. **topK**: The number of similar messages to retrieve
+2. **messageRange**: The surrounding messages to include with each match
+3. **scope**: Whether to search the current thread or all threads for a resource
+4. **filter**: Metadata criteria that restrict search results
 
 ```typescript
 const agent = new Agent({
   memory: new Memory({
     options: {
       semanticRecall: {
-        topK: 3, // Retrieve 3 most similar messages
+        topK: 3, // Retrieve 3 similar messages
         messageRange: 2, // Include 2 messages before and after each match
-        scope: 'resource', // Search across all threads for this user (default setting if omitted)
+        scope: 'resource', // Search all threads for this resource
+        filter: { projectId: { $eq: 'project-a' } },
       },
     },
   }),
 })
 ```
 
+> **Note:** `scope: 'resource'` is supported by the LibSQL, PostgreSQL, and Upstash storage adapters.
+
+### Metadata filtering
+
+The `filter` option restricts semantic recall results to messages with matching thread metadata.
+
+```typescript
+const agent = new Agent({
+  memory: new Memory({
+    options: {
+      semanticRecall: {
+        scope: 'resource',
+        filter: {
+          projectId: { $eq: 'project-a' },
+          category: { $in: ['work', 'personal'] },
+        },
+      },
+    },
+  }),
+})
+```
+
+Filters match metadata stored on message embeddings when messages are saved. If thread metadata changes later, existing embeddings keep their previous metadata until those messages are saved or indexed again.
+
+Supported filter operators:
+
+- `$and`: Logical AND
+- `$eq`: Equal to
+- `$gt`: Greater than
+- `$gte`: Greater than or equal
+- `$in`: In array
+- `$lt`: Less than
+- `$lte`: Less than or equal
+- `$ne`: Not equal to
+- `$nin`: Not in array
+- `$or`: Logical OR
+
+The following example demonstrates metadata filters for common use cases:
+
+```typescript
+// Filter by project
+const options = {
+  semanticRecall: { filter: { projectId: { $eq: 'my-project' } } },
+}
+
+// Filter by multiple categories
+const options = {
+  semanticRecall: { filter: { category: { $in: ['work', 'research'] } } },
+}
+
+// Filter by project and priority
+const options = {
+  semanticRecall: {
+    filter: {
+      $and: [{ projectId: { $eq: 'project-a' } }, { priority: { $gte: 3 } }],
+    },
+  },
+}
+```
+
 ## 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/index.cjs

@@ -1172,6 +1172,33 @@ var LibSQLVector = class extends vector.MastraVector {
     });
   }
 };
+var safeStringify = (value) => {
+  const seen = /* @__PURE__ */ new WeakSet();
+  const sanitize = (val) => {
+    if (val === null || val === void 0) return val;
+    if (typeof val === "function") return void 0;
+    if (typeof val === "symbol") return void 0;
+    if (typeof val === "bigint") return val.toString();
+    if (typeof val !== "object") return val;
+    if (seen.has(val)) return void 0;
+    seen.add(val);
+    if (typeof val.toJSON === "function") {
+      return sanitize(val.toJSON());
+    }
+    if (Array.isArray(val)) {
+      return val.map((item) => sanitize(item));
+    }
+    const result = {};
+    for (const key of Object.keys(val)) {
+      const sanitized = sanitize(val[key]);
+      if (sanitized !== void 0) {
+        result[key] = sanitized;
+      }
+    }
+    return result;
+  };
+  return JSON.stringify(sanitize(value)) ?? "null";
+};
 function buildSelectColumns(tableName) {
   const schema = storage.TABLE_SCHEMAS[tableName];
   return Object.keys(schema).map((col) => {
@@ -1238,12 +1265,12 @@ function prepareStatement({ tableName, record }) {
     }
     const colDef = schema[col];
     if (colDef?.type === "jsonb") {
-      return JSON.stringify(v);
+      return safeStringify(v);
     }
     if (v instanceof Date) {
       return v.toISOString();
     }
-    return typeof v === "object" ? JSON.stringify(v) : v;
+    return typeof v === "object" ? safeStringify(v) : v;
   });
   const placeholders = columnNames.map((col) => {
     const colDef = schema[col];
@@ -1286,12 +1313,12 @@ function transformToSqlValue(value, forceJsonStringify = false) {
     return null;
   }
   if (forceJsonStringify) {
-    return JSON.stringify(value);
+    return safeStringify(value);
   }
   if (value instanceof Date) {
     return value.toISOString();
   }
-  return typeof value === "object" ? JSON.stringify(value) : value;
+  return typeof value === "object" ? safeStringify(value) : value;
 }
 function prepareDeleteStatement({ tableName, keys }) {
   const parsedTableName = utils.parseSqlIdentifier(tableName, "table name");
@@ -2993,11 +3020,13 @@ function rowToTask(row) {
     runId: String(row.run_id),
     result: parseJson(row.result),
     error: parseJson(row.error),
+    suspendPayload: parseJson(row.suspend_payload),
     retryCount: Number(row.retry_count),
     maxRetries: Number(row.max_retries),
     timeoutMs: Number(row.timeout_ms),
     createdAt: new Date(String(row.createdAt)),
     startedAt: row.startedAt ? new Date(String(row.startedAt)) : void 0,
+    suspendedAt: row.suspendedAt ? new Date(String(row.suspendedAt)) : void 0,
     completedAt: row.completedAt ? new Date(String(row.completedAt)) : void 0
   };
 }
@@ -3015,6 +3044,11 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
       tableName: storage.TABLE_BACKGROUND_TASKS,
       schema: storage.TABLE_SCHEMAS[storage.TABLE_BACKGROUND_TASKS]
     });
+    await this.#db.alterTable({
+      tableName: storage.TABLE_BACKGROUND_TASKS,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_BACKGROUND_TASKS],
+      ifNotExists: ["suspend_payload", "suspendedAt"]
+    });
   }
   async dangerouslyClearAll() {
     await this.#db.deleteData({ tableName: storage.TABLE_BACKGROUND_TASKS });
@@ -3034,11 +3068,13 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
         args: task.args,
         result: task.result ?? null,
         error: task.error ?? null,
+        suspend_payload: task.suspendPayload ?? null,
         retry_count: task.retryCount,
         max_retries: task.maxRetries,
         timeout_ms: task.timeoutMs,
         createdAt: task.createdAt.toISOString(),
         startedAt: task.startedAt?.toISOString() ?? null,
+        suspendedAt: task.suspendedAt?.toISOString() ?? null,
         completedAt: task.completedAt?.toISOString() ?? null
       }
     });
@@ -3058,6 +3094,10 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
       setClauses.push("error = jsonb(?)");
       params.push(serializeJson(update.error));
     }
+    if ("suspendPayload" in update) {
+      setClauses.push("suspend_payload = jsonb(?)");
+      params.push(serializeJson(update.suspendPayload));
+    }
     if ("retryCount" in update) {
       setClauses.push("retry_count = ?");
       params.push(update.retryCount);
@@ -3066,6 +3106,10 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
       setClauses.push("startedAt = ?");
       params.push(update.startedAt?.toISOString() ?? null);
     }
+    if ("suspendedAt" in update) {
+      setClauses.push("suspendedAt = ?");
+      params.push(update.suspendedAt?.toISOString() ?? null);
+    }
     if ("completedAt" in update) {
       setClauses.push("completedAt = ?");
       params.push(update.completedAt?.toISOString() ?? null);
@@ -3113,7 +3157,11 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
       conditions.push("tool_name = ?");
       params.push(filter.toolName);
     }
-    const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
+    if (filter.toolCallId) {
+      conditions.push("tool_call_id = ?");
+      params.push(filter.toolCallId);
+    }
+    const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "suspendedAt" ? "suspendedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
     if (filter.fromDate) {
       conditions.push(`${dateCol} >= ?`);
       params.push(filter.fromDate.toISOString());
@@ -3128,7 +3176,7 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
       args: [...params]
     });
     const total = Number(countResult.rows[0]?.count ?? 0);
-    const orderCol = filter.orderBy === "startedAt" ? "startedAt" : filter.orderBy === "completedAt" ? "completedAt" : "createdAt";
+    const orderCol = filter.orderBy === "startedAt" ? "startedAt" : filter.orderBy === "suspendedAt" ? "suspendedAt" : filter.orderBy === "completedAt" ? "completedAt" : "createdAt";
     const direction = filter.orderDirection === "desc" ? "DESC" : "ASC";
     let sql = `SELECT ${buildSelectColumns(storage.TABLE_BACKGROUND_TASKS)} FROM ${storage.TABLE_BACKGROUND_TASKS} ${where} ORDER BY ${orderCol} ${direction}`;
     if (filter.perPage != null) {
@@ -3156,7 +3204,7 @@ var BackgroundTasksLibSQL = class extends storage.BackgroundTasksStorage {
       conditions.push(`status IN (${statuses.map(() => "?").join(", ")})`);
       params.push(...statuses);
     }
-    const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
+    const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "suspendedAt" ? "suspendedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
     if (filter.fromDate) {
       conditions.push(`${dateCol} >= ?`);
       params.push(filter.fromDate.toISOString());
@@ -10586,7 +10634,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
                 VALUES (?, ?, jsonb(?), ?, ?)
                 ON CONFLICT(workflow_name, run_id)
                 DO UPDATE SET snapshot = excluded.snapshot, updatedAt = excluded.updatedAt`,
-          args: [workflowName, runId, JSON.stringify(snapshot), now, now]
+          args: [workflowName, runId, safeStringify(snapshot), now, now]
         });
         await tx.commit();
         return snapshot.context;
@@ -10623,7 +10671,7 @@ var WorkflowsLibSQL = class extends storage.WorkflowsStorage {
         const updatedSnapshot = { ...snapshot, ...opts };
         await tx.execute({
           sql: `UPDATE ${storage.TABLE_WORKFLOW_SNAPSHOT} SET snapshot = jsonb(?) WHERE workflow_name = ? AND run_id = ?`,
-          args: [JSON.stringify(updatedSnapshot), workflowName, runId]
+          args: [safeStringify(updatedSnapshot), workflowName, runId]
         });
         await tx.commit();
         return updatedSnapshot;