@mastra/libsql 1.1.0-alpha.0 → 1.1.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @mastra/libsql
 
+## 1.1.0-alpha.1
+
+### Minor Changes
+
+- Restructured stored agents to use a thin metadata record with versioned configuration snapshots. ([#12488](https://github.com/mastra-ai/mastra/pull/12488))
+
+  The agent record now only stores metadata fields (id, status, activeVersionId, authorId, metadata, timestamps). All configuration fields (name, instructions, model, tools, etc.) live exclusively in version snapshot rows, enabling full version history and rollback.
+
+  **Key changes:**
+  - Stored Agent records are now thin metadata-only (StorageAgentType)
+  - All config lives in version snapshots (StorageAgentSnapshotType)
+  - New resolved type (StorageResolvedAgentType) merges agent record + active version config
+  - Renamed `ownerId` to `authorId` for multi-tenant filtering
+  - Changed `memory` field type from `string` to `Record<string, unknown>`
+  - Added `status` field ('draft' | 'published') to agent records
+  - Flattened CreateAgent/UpdateAgent input types (config fields at top level, no nested snapshot)
+  - Version config columns are top-level in the agent_versions table (no single snapshot jsonb column)
+  - List endpoints return resolved agents (thin record + active version config)
+  - Auto-versioning on update with retention limits and race condition handling
+
+### Patch Changes
+
+- Updated dependencies [[`b99ceac`](https://github.com/mastra-ai/mastra/commit/b99ceace2c830dbdef47c8692d56a91954aefea2), [`deea43e`](https://github.com/mastra-ai/mastra/commit/deea43eb1366d03a864c5e597d16a48592b9893f), [`ac9ec66`](https://github.com/mastra-ai/mastra/commit/ac9ec6672779b2e6d4344e415481d1a6a7d4911a)]:
+  - @mastra/core@1.1.0-alpha.1
+
 ## 1.1.0-alpha.0
 
 ### Minor Changes

package/dist/docs/README.md

@@ -36,4 +36,4 @@ docs/
 ## Version
 
 Package: @mastra/libsql
-Version: 1.1.0-alpha.0
+Version: 1.1.0-alpha.1

package/dist/docs/SKILL.md

@@ -5,7 +5,7 @@ description: Documentation for @mastra/libsql. Includes links to type definition
 
 # @mastra/libsql Documentation
 
-> **Version**: 1.1.0-alpha.0
+> **Version**: 1.1.0-alpha.1
 > **Package**: @mastra/libsql
 
 ## Quick Navigation

package/dist/docs/SOURCE_MAP.json

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

package/dist/index.cjs

@@ -2083,21 +2083,9 @@ var AgentsLibSQL = class extends storage.AgentsStorage {
   parseRow(row) {
     return {
       id: row.id,
-      name: row.name,
-      description: row.description,
-      instructions: row.instructions,
-      model: this.parseJson(row.model, "model"),
-      tools: this.parseJson(row.tools, "tools"),
-      defaultOptions: this.parseJson(row.defaultOptions, "defaultOptions"),
-      workflows: this.parseJson(row.workflows, "workflows"),
-      agents: this.parseJson(row.agents, "agents"),
-      inputProcessors: this.parseJson(row.inputProcessors, "inputProcessors"),
-      outputProcessors: this.parseJson(row.outputProcessors, "outputProcessors"),
-      memory: this.parseJson(row.memory, "memory"),
-      scorers: this.parseJson(row.scorers, "scorers"),
-      integrationTools: this.parseJson(row.integrationTools, "integrationTools"),
-      ownerId: row.ownerId,
+      status: row.status,
       activeVersionId: row.activeVersionId,
+      authorId: row.authorId,
       metadata: this.parseJson(row.metadata, "metadata"),
       createdAt: new Date(row.createdAt),
       updatedAt: new Date(row.updatedAt)
@@ -2129,32 +2117,48 @@ var AgentsLibSQL = class extends storage.AgentsStorage {
         tableName: storage.TABLE_AGENTS,
         record: {
           id: agent.id,
-          name: agent.name,
-          description: agent.description ?? null,
-          instructions: agent.instructions,
-          model: agent.model,
-          tools: agent.tools ?? null,
-          defaultOptions: agent.defaultOptions ?? null,
-          workflows: agent.workflows ?? null,
-          agents: agent.agents ?? null,
-          inputProcessors: agent.inputProcessors ?? null,
-          outputProcessors: agent.outputProcessors ?? null,
-          memory: agent.memory ?? null,
-          scorers: agent.scorers ?? null,
-          integrationTools: agent.integrationTools ?? null,
-          ownerId: agent.ownerId ?? null,
-          activeVersionId: agent.activeVersionId ?? null,
+          status: "draft",
+          activeVersionId: null,
+          authorId: agent.authorId ?? null,
           metadata: agent.metadata ?? null,
           createdAt: now,
           updatedAt: now
         }
       });
-      return {
-        ...agent,
-        createdAt: now,
-        updatedAt: now
-      };
+      const { id: _id, authorId: _authorId, metadata: _metadata, ...snapshotConfig } = agent;
+      const versionId = crypto.randomUUID();
+      await this.createVersion({
+        id: versionId,
+        agentId: agent.id,
+        versionNumber: 1,
+        ...snapshotConfig,
+        changedFields: Object.keys(snapshotConfig),
+        changeMessage: "Initial version"
+      });
+      await this.#db.update({
+        tableName: storage.TABLE_AGENTS,
+        keys: { id: agent.id },
+        data: {
+          activeVersionId: versionId,
+          status: "published",
+          updatedAt: /* @__PURE__ */ new Date()
+        }
+      });
+      const created = await this.getAgentById({ id: agent.id });
+      if (!created) {
+        throw new error.MastraError({
+          id: storage.createStorageErrorId("LIBSQL", "CREATE_AGENT", "NOT_FOUND_AFTER_CREATE"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.SYSTEM,
+          text: `Agent ${agent.id} not found after creation`,
+          details: { agentId: agent.id }
+        });
+      }
+      return created;
     } catch (error$1) {
+      if (error$1 instanceof error.MastraError) {
+        throw error$1;
+      }
       throw new error.MastraError(
         {
           id: storage.createStorageErrorId("LIBSQL", "CREATE_AGENT", "FAILED"),
@@ -2181,21 +2185,11 @@ var AgentsLibSQL = class extends storage.AgentsStorage {
       const data = {
         updatedAt: /* @__PURE__ */ new Date()
       };
-      if (updates.name !== void 0) data.name = updates.name;
-      if (updates.description !== void 0) data.description = updates.description;
-      if (updates.instructions !== void 0) data.instructions = updates.instructions;
-      if (updates.model !== void 0) data.model = updates.model;
-      if (updates.tools !== void 0) data.tools = updates.tools;
-      if (updates.defaultOptions !== void 0) data.defaultOptions = updates.defaultOptions;
-      if (updates.workflows !== void 0) data.workflows = updates.workflows;
-      if (updates.agents !== void 0) data.agents = updates.agents;
-      if (updates.inputProcessors !== void 0) data.inputProcessors = updates.inputProcessors;
-      if (updates.outputProcessors !== void 0) data.outputProcessors = updates.outputProcessors;
-      if (updates.memory !== void 0) data.memory = updates.memory;
-      if (updates.scorers !== void 0) data.scorers = updates.scorers;
-      if (updates.integrationTools !== void 0) data.integrationTools = updates.integrationTools;
-      if (updates.ownerId !== void 0) data.ownerId = updates.ownerId;
-      if (updates.activeVersionId !== void 0) data.activeVersionId = updates.activeVersionId;
+      if (updates.authorId !== void 0) data.authorId = updates.authorId;
+      if (updates.activeVersionId !== void 0) {
+        data.activeVersionId = updates.activeVersionId;
+        data.status = "published";
+      }
       if (updates.metadata !== void 0) {
         data.metadata = { ...existingAgent.metadata, ...updates.metadata };
       }
@@ -2317,7 +2311,18 @@ var AgentsLibSQL = class extends storage.AgentsStorage {
           agentId: input.agentId,
           versionNumber: input.versionNumber,
           name: input.name ?? null,
-          snapshot: input.snapshot,
+          description: input.description ?? null,
+          instructions: input.instructions,
+          model: input.model,
+          tools: input.tools ?? null,
+          defaultOptions: input.defaultOptions ?? null,
+          workflows: input.workflows ?? null,
+          agents: input.agents ?? null,
+          integrationTools: input.integrationTools ?? null,
+          inputProcessors: input.inputProcessors ?? null,
+          outputProcessors: input.outputProcessors ?? null,
+          memory: input.memory ?? null,
+          scorers: input.scorers ?? null,
           changedFields: input.changedFields ?? null,
           changeMessage: input.changeMessage ?? null,
           createdAt: now
@@ -2554,7 +2559,18 @@ var AgentsLibSQL = class extends storage.AgentsStorage {
       agentId: row.agentId,
       versionNumber: row.versionNumber,
       name: row.name,
-      snapshot: this.parseJson(row.snapshot, "snapshot"),
+      description: row.description,
+      instructions: row.instructions,
+      model: this.parseJson(row.model, "model"),
+      tools: this.parseJson(row.tools, "tools"),
+      defaultOptions: this.parseJson(row.defaultOptions, "defaultOptions"),
+      workflows: this.parseJson(row.workflows, "workflows"),
+      agents: this.parseJson(row.agents, "agents"),
+      integrationTools: this.parseJson(row.integrationTools, "integrationTools"),
+      inputProcessors: this.parseJson(row.inputProcessors, "inputProcessors"),
+      outputProcessors: this.parseJson(row.outputProcessors, "outputProcessors"),
+      memory: this.parseJson(row.memory, "memory"),
+      scorers: this.parseJson(row.scorers, "scorers"),
       changedFields: this.parseJson(row.changedFields, "changedFields"),
       changeMessage: row.changeMessage,
       createdAt: new Date(row.createdAt)