@mastra/libsql 1.7.1 → 1.7.2-alpha.0

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

@@ -100,7 +100,7 @@ This is useful when different types of data have different performance or operat
 
 ### Agent-level storage
 
-Agent-level storage overrides storage configured at the instance level. Add storage to a specific agent when you need data boundaries or compliance requirements:
+Agent-level storage overrides storage configured at the instance level. Add storage to a specific agent when you need to keep data separate or use different providers per agent.
 
 ```typescript
 import { Agent } from '@mastra/core/agent'
@@ -118,14 +118,14 @@ export const agent = new Agent({
 })
 ```
 
-> **Warning:** [Mastra Cloud Store](https://mastra.ai/docs/mastra-cloud/deployment) doesn't support agent-level storage.
+> **Warning:** Agent-level storage isn't supported when using [Mastra Cloud Store](https://mastra.ai/docs/mastra-cloud/deployment). If you use Mastra Cloud Store, configure storage on the Mastra instance instead. This limitation doesn't apply if you bring your own database.
 
 ## Threads and resources
 
 Mastra organizes conversations using two identifiers:
 
-- **Thread** - a conversation session containing a sequence of messages.
-- **Resource** - the entity that owns the thread, such as a user, organization, project, or any other domain entity in your application.
+- **Thread**: A conversation session containing a sequence of messages.
+- **Resource**: The entity that owns the thread, such as a user, organization, project, or any other domain entity in your application.
 
 Both identifiers are required for agents to store information:
 

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

@@ -13,7 +13,7 @@ Working memory can persist at two different scopes:
 
 **Important:** Switching between scopes means the agent won't see memory from the other scope - thread-scoped memory is completely separate from resource-scoped memory.
 
-## Quick start
+## Quickstart
 
 Here's a minimal example of setting up an agent with working memory:
 

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

@@ -19,7 +19,7 @@ The `DefaultExporter` persists traces to your configured storage backend. Not al
 
 For production environments with high traffic, we recommend using **ClickHouse** for the observability domain via [composite storage](https://mastra.ai/reference/storage/composite). See [Production Recommendations](https://mastra.ai/docs/observability/tracing/exporters/default) for details.
 
-## Quick start
+## Quickstart
 
 Configure Observability in your Mastra instance:
 

package/dist/docs/references/reference-core-getMemory.md

@@ -46,5 +46,4 @@ const memory = mastra.getMemory('conversationMemory')
 ## Related
 
 - [Mastra.listMemory()](https://mastra.ai/reference/core/listMemory)
-- [Memory overview](https://mastra.ai/docs/memory/overview)
-- [Agent Memory](https://mastra.ai/docs/agents/agent-memory)
+- [Memory overview](https://mastra.ai/docs/memory/overview)

package/dist/docs/references/reference-core-listMemory.md

@@ -52,5 +52,4 @@ console.log(Object.keys(allMemory)) // ["conversationMemory", "analyticsMemory"]
 ## Related
 
 - [Mastra.getMemory()](https://mastra.ai/reference/core/getMemory)
-- [Memory overview](https://mastra.ai/docs/memory/overview)
-- [Agent Memory](https://mastra.ai/docs/agents/agent-memory)
+- [Memory overview](https://mastra.ai/docs/memory/overview)

package/dist/index.cjs

@@ -2987,7 +2987,11 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
     await this.#db.createTable({ tableName: storage.TABLE_DATASET_ITEMS, schema: storage.DATASET_ITEMS_SCHEMA });
     await this.#db.createTable({ tableName: storage.TABLE_DATASET_VERSIONS, schema: storage.DATASET_VERSIONS_SCHEMA });
     await this.#addColumnIfNotExists(storage.TABLE_DATASETS, "requestContextSchema", "TEXT");
+    await this.#addColumnIfNotExists(storage.TABLE_DATASETS, "tags", "TEXT");
+    await this.#addColumnIfNotExists(storage.TABLE_DATASETS, "targetType", "TEXT");
+    await this.#addColumnIfNotExists(storage.TABLE_DATASETS, "targetIds", "TEXT");
     await this.#addColumnIfNotExists(storage.TABLE_DATASET_ITEMS, "requestContext", "TEXT");
+    await this.#addColumnIfNotExists(storage.TABLE_DATASET_ITEMS, "source", "TEXT");
     await this.#client.execute({
       sql: `CREATE INDEX IF NOT EXISTS idx_dataset_items_dataset_validto ON "${storage.TABLE_DATASET_ITEMS}" ("datasetId", "validTo")`,
       args: []
@@ -3030,6 +3034,9 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
       inputSchema: row.inputSchema ? storage.safelyParseJSON(row.inputSchema) : void 0,
       groundTruthSchema: row.groundTruthSchema ? storage.safelyParseJSON(row.groundTruthSchema) : void 0,
       requestContextSchema: row.requestContextSchema ? storage.safelyParseJSON(row.requestContextSchema) : void 0,
+      tags: row.tags ? storage.safelyParseJSON(row.tags) : void 0,
+      targetType: row.targetType || void 0,
+      targetIds: row.targetIds ? storage.safelyParseJSON(row.targetIds) : void 0,
       version: row.version,
       createdAt: storage.ensureDate(row.createdAt),
       updatedAt: storage.ensureDate(row.updatedAt)
@@ -3044,6 +3051,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
       groundTruth: row.groundTruth ? storage.safelyParseJSON(row.groundTruth) : void 0,
       requestContext: row.requestContext ? storage.safelyParseJSON(row.requestContext) : void 0,
       metadata: row.metadata ? storage.safelyParseJSON(row.metadata) : void 0,
+      source: row.source ? storage.safelyParseJSON(row.source) : void 0,
       createdAt: storage.ensureDate(row.createdAt),
       updatedAt: storage.ensureDate(row.updatedAt)
     };
@@ -3059,6 +3067,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
       groundTruth: row.groundTruth ? storage.safelyParseJSON(row.groundTruth) : void 0,
       requestContext: row.requestContext ? storage.safelyParseJSON(row.requestContext) : void 0,
       metadata: row.metadata ? storage.safelyParseJSON(row.metadata) : void 0,
+      source: row.source ? storage.safelyParseJSON(row.source) : void 0,
       createdAt: storage.ensureDate(row.createdAt),
       updatedAt: storage.ensureDate(row.updatedAt)
     };
@@ -3087,6 +3096,8 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
           inputSchema: input.inputSchema ?? null,
           groundTruthSchema: input.groundTruthSchema ?? null,
           requestContextSchema: input.requestContextSchema ?? null,
+          targetType: input.targetType ?? null,
+          targetIds: input.targetIds ? JSON.stringify(input.targetIds) : null,
           version: 0,
           createdAt: nowIso,
           updatedAt: nowIso
@@ -3100,6 +3111,8 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         inputSchema: input.inputSchema ?? void 0,
         groundTruthSchema: input.groundTruthSchema ?? void 0,
         requestContextSchema: input.requestContextSchema ?? void 0,
+        targetType: input.targetType ?? void 0,
+        targetIds: input.targetIds ?? void 0,
         version: 0,
         createdAt: now,
         updatedAt: now
@@ -3171,6 +3184,18 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         updates.push("requestContextSchema = ?");
         values.push(args.requestContextSchema === null ? null : JSON.stringify(args.requestContextSchema));
       }
+      if (args.tags !== void 0) {
+        updates.push("tags = ?");
+        values.push(args.tags === null ? null : JSON.stringify(args.tags));
+      }
+      if (args.targetType !== void 0) {
+        updates.push("targetType = ?");
+        values.push(args.targetType === null ? null : args.targetType);
+      }
+      if (args.targetIds !== void 0) {
+        updates.push("targetIds = ?");
+        values.push(args.targetIds === null ? null : JSON.stringify(args.targetIds));
+      }
       values.push(args.id);
       await this.#client.execute({
         sql: `UPDATE ${storage.TABLE_DATASETS} SET ${updates.join(", ")} WHERE id = ?`,
@@ -3184,6 +3209,9 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         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) ?? void 0,
+        targetType: (args.targetType !== void 0 ? args.targetType : existing.targetType) ?? void 0,
+        targetIds: (args.targetIds !== void 0 ? args.targetIds : existing.targetIds) ?? void 0,
         updatedAt: new Date(now)
       };
     } catch (error$1) {
@@ -3289,7 +3317,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
             args: [args.datasetId]
           },
           {
-            sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 0, jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
+            sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, source, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 0, jsonb(?), jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
             args: [
               id,
               args.datasetId,
@@ -3298,6 +3326,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
               jsonbArg(args.groundTruth),
               jsonbArg(args.requestContext),
               jsonbArg(args.metadata),
+              jsonbArg(args.source),
               nowIso,
               nowIso
             ]
@@ -3318,6 +3347,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         groundTruth: args.groundTruth,
         requestContext: args.requestContext,
         metadata: args.metadata,
+        source: args.source,
         createdAt: now,
         updatedAt: now
       };
@@ -3359,6 +3389,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
       const mergedGroundTruth = args.groundTruth ?? existing.groundTruth;
       const mergedRequestContext = args.requestContext ?? existing.requestContext;
       const mergedMetadata = args.metadata ?? existing.metadata;
+      const mergedSource = args.source ?? existing.source;
       const results = await this.#client.batch(
         [
           {
@@ -3370,7 +3401,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
             args: [args.datasetId, args.id]
           },
           {
-            sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 0, jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
+            sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, source, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 0, jsonb(?), jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
             args: [
               args.id,
               args.datasetId,
@@ -3379,6 +3410,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
               jsonbArg(mergedGroundTruth),
               jsonbArg(mergedRequestContext),
               jsonbArg(mergedMetadata),
+              jsonbArg(mergedSource),
               existing.createdAt.toISOString(),
               nowIso
             ]
@@ -3398,6 +3430,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         groundTruth: mergedGroundTruth,
         requestContext: mergedRequestContext,
         metadata: mergedMetadata,
+        source: mergedSource,
         updatedAt: now
       };
     } catch (error$1) {
@@ -3437,7 +3470,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
             args: [datasetId, id]
           },
           {
-            sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 1, jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
+            sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, source, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 1, jsonb(?), jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
             args: [
               id,
               datasetId,
@@ -3446,6 +3479,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
               jsonbArg(existing.groundTruth),
               jsonbArg(existing.requestContext),
               jsonbArg(existing.metadata),
+              jsonbArg(existing.source),
               existing.createdAt.toISOString(),
               nowIso
             ]
@@ -3725,7 +3759,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         const id = crypto.randomUUID();
         items.push({ id, input: itemInput });
         statements.push({
-          sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 0, jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
+          sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, source, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 0, jsonb(?), jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
           args: [
             id,
             input.datasetId,
@@ -3734,6 +3768,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
             jsonbArg(itemInput.groundTruth),
             jsonbArg(itemInput.requestContext),
             jsonbArg(itemInput.metadata),
+            jsonbArg(itemInput.source),
             nowIso,
             nowIso
           ]
@@ -3753,6 +3788,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
         groundTruth: itemInput.groundTruth,
         requestContext: itemInput.requestContext,
         metadata: itemInput.metadata,
+        source: itemInput.source,
         createdAt: now,
         updatedAt: now
       }));
@@ -3801,7 +3837,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
           args: [input.datasetId, item.id]
         });
         statements.push({
-          sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 1, jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
+          sql: `INSERT INTO ${storage.TABLE_DATASET_ITEMS} (id, datasetId, datasetVersion, validTo, isDeleted, input, groundTruth, requestContext, metadata, source, createdAt, updatedAt) VALUES (?, ?, (SELECT version FROM ${storage.TABLE_DATASETS} WHERE id = ?), NULL, 1, jsonb(?), jsonb(?), jsonb(?), jsonb(?), jsonb(?), ?, ?)`,
           args: [
             item.id,
             input.datasetId,
@@ -3810,6 +3846,7 @@ var DatasetsLibSQL = class extends storage.DatasetsStorage {
             jsonbArg(item.groundTruth),
             jsonbArg(item.requestContext),
             jsonbArg(item.metadata),
+            jsonbArg(item.source),
             item.createdAt.toISOString(),
             nowIso
           ]
@@ -3902,6 +3939,8 @@ var ExperimentsLibSQL = class extends storage.ExperimentsStorage {
       completedAt: storage.ensureDate(row.completedAt),
       retryCount: row.retryCount,
       traceId: row.traceId ?? null,
+      status: row.status ?? null,
+      tags: row.tags ? storage.safelyParseJSON(row.tags) : null,
       createdAt: storage.ensureDate(row.createdAt)
     };
   }
@@ -4145,6 +4184,8 @@ var ExperimentsLibSQL = class extends storage.ExperimentsStorage {
           completedAt: input.completedAt.toISOString(),
           retryCount: input.retryCount,
           traceId: input.traceId ?? null,
+          status: input.status ?? null,
+          tags: input.tags !== void 0 && input.tags !== null ? JSON.stringify(input.tags) : null,
           createdAt: nowIso
         }
       });
@@ -4161,6 +4202,8 @@ var ExperimentsLibSQL = class extends storage.ExperimentsStorage {
         completedAt: input.completedAt,
         retryCount: input.retryCount,
         traceId: input.traceId ?? null,
+        status: input.status ?? null,
+        tags: input.tags ?? null,
         createdAt: now
       };
     } catch (error$1) {
@@ -4174,6 +4217,70 @@ var ExperimentsLibSQL = class extends storage.ExperimentsStorage {
       );
     }
   }
+  async updateExperimentResult(input) {
+    try {
+      const setClauses = [];
+      const values = [];
+      if (input.status !== void 0) {
+        setClauses.push(`"status" = ?`);
+        values.push(input.status);
+      }
+      if (input.tags !== void 0) {
+        setClauses.push(`"tags" = ?`);
+        values.push(JSON.stringify(input.tags));
+      }
+      if (setClauses.length === 0) {
+        const existing = await this.getExperimentResultById({ id: input.id });
+        if (!existing) {
+          throw new error.MastraError({
+            id: storage.createStorageErrorId("LIBSQL", "UPDATE_EXPERIMENT_RESULT", "NOT_FOUND"),
+            domain: error.ErrorDomain.STORAGE,
+            category: error.ErrorCategory.USER,
+            details: { resultId: input.id }
+          });
+        }
+        return existing;
+      }
+      values.push(input.id);
+      let whereClause = `"id" = ?`;
+      if (input.experimentId) {
+        values.push(input.experimentId);
+        whereClause += ` AND "experimentId" = ?`;
+      }
+      const updateResult = await this.#client.execute({
+        sql: `UPDATE ${storage.TABLE_EXPERIMENT_RESULTS} SET ${setClauses.join(", ")} WHERE ${whereClause}`,
+        args: values
+      });
+      if (updateResult.rowsAffected === 0) {
+        throw new error.MastraError({
+          id: storage.createStorageErrorId("LIBSQL", "UPDATE_EXPERIMENT_RESULT", "NOT_FOUND"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { resultId: input.id, ...input.experimentId ? { experimentId: input.experimentId } : {} }
+        });
+      }
+      const result = await this.getExperimentResultById({ id: input.id });
+      if (!result) {
+        throw new error.MastraError({
+          id: storage.createStorageErrorId("LIBSQL", "UPDATE_EXPERIMENT_RESULT", "NOT_FOUND"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { resultId: input.id }
+        });
+      }
+      return result;
+    } catch (error$1) {
+      if (error$1 instanceof error.MastraError) throw error$1;
+      throw new error.MastraError(
+        {
+          id: storage.createStorageErrorId("LIBSQL", "UPDATE_EXPERIMENT_RESULT", "FAILED"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
+    }
+  }
   async getExperimentResultById(args) {
     try {
       const result = await this.#client.execute({