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

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @mastra/libsql
 
+## 1.1.0-alpha.2
+
+### Patch Changes
+
+- Stored agent edits no longer fail silently. PATCH requests now save changes correctly. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
+
+- Fix PATCH request JSON-body handling in `@mastra/client-js` so stored agent edit flows work correctly. Fix stored agent schema migration in `@mastra/libsql` and `@mastra/pg` to drop and recreate the versions table when the old snapshot-based schema is detected, clean up stale draft records from partial create failures, and remove lingering legacy tables. Restores create and edit flows for stored agents. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
+
+- Updated dependencies:
+  - @mastra/core@1.1.0-alpha.2
+
+## 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.2

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.2
 > **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.2",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -2043,14 +2043,122 @@ Note: This migration may take some time for large tables.
 // src/storage/domains/agents/index.ts
 var AgentsLibSQL = class extends storage.AgentsStorage {
   #db;
+  #client;
   constructor(config) {
     super();
     const client = resolveClient(config);
+    this.#client = client;
     this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
   }
   async init() {
+    await this.#migrateFromLegacySchema();
+    await this.#migrateVersionsSchema();
     await this.#db.createTable({ tableName: storage.TABLE_AGENTS, schema: storage.AGENTS_SCHEMA });
     await this.#db.createTable({ tableName: storage.TABLE_AGENT_VERSIONS, schema: storage.AGENT_VERSIONS_SCHEMA });
+    await this.#db.alterTable({
+      tableName: storage.TABLE_AGENTS,
+      schema: storage.AGENTS_SCHEMA,
+      ifNotExists: ["status", "authorId"]
+    });
+    await this.#cleanupStaleDrafts();
+  }
+  /**
+   * Migrates from the legacy flat agent schema (where config fields like name, instructions, model
+   * were stored directly on mastra_agents) to the new versioned schema (thin agent record + versions table).
+   * SQLite cannot drop columns or alter NOT NULL constraints, so we must recreate the table.
+   */
+  async #migrateFromLegacySchema() {
+    const legacyTable = `${storage.TABLE_AGENTS}_legacy`;
+    const hasLegacyColumns = await this.#db.hasColumn(storage.TABLE_AGENTS, "name");
+    if (hasLegacyColumns) {
+      await this.#client.execute({
+        sql: `ALTER TABLE "${storage.TABLE_AGENTS}" RENAME TO "${legacyTable}"`
+      });
+      await this.#client.execute({
+        sql: `DROP TABLE IF EXISTS "${storage.TABLE_AGENT_VERSIONS}"`
+      });
+    }
+    const legacyExists = await this.#db.hasColumn(legacyTable, "name");
+    if (!legacyExists) return;
+    const result = await this.#client.execute({
+      sql: `SELECT * FROM "${legacyTable}"`
+    });
+    const oldAgents = result.rows || [];
+    await this.#db.createTable({ tableName: storage.TABLE_AGENTS, schema: storage.AGENTS_SCHEMA });
+    await this.#db.createTable({ tableName: storage.TABLE_AGENT_VERSIONS, schema: storage.AGENT_VERSIONS_SCHEMA });
+    for (const row of oldAgents) {
+      const agentId = row.id;
+      if (!agentId) continue;
+      const versionId = crypto.randomUUID();
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: storage.TABLE_AGENTS,
+        record: {
+          id: agentId,
+          status: "published",
+          activeVersionId: versionId,
+          authorId: row.ownerId ?? row.authorId ?? null,
+          metadata: row.metadata ?? null,
+          createdAt: row.createdAt ?? now,
+          updatedAt: row.updatedAt ?? now
+        }
+      });
+      await this.#db.insert({
+        tableName: storage.TABLE_AGENT_VERSIONS,
+        record: {
+          id: versionId,
+          agentId,
+          versionNumber: 1,
+          name: row.name ?? agentId,
+          description: row.description ?? null,
+          instructions: row.instructions ?? "",
+          model: row.model ?? "{}",
+          tools: row.tools ?? null,
+          defaultOptions: row.defaultOptions ?? null,
+          workflows: row.workflows ?? null,
+          agents: row.agents ?? null,
+          integrationTools: row.integrationTools ?? null,
+          inputProcessors: row.inputProcessors ?? null,
+          outputProcessors: row.outputProcessors ?? null,
+          memory: row.memory ?? null,
+          scorers: row.scorers ?? null,
+          changedFields: null,
+          changeMessage: "Migrated from legacy schema",
+          createdAt: row.createdAt ?? now
+        }
+      });
+    }
+    await this.#client.execute({
+      sql: `DROP TABLE IF EXISTS "${legacyTable}"`
+    });
+  }
+  /**
+   * Migrates the agent_versions table from the old snapshot-based schema (single `snapshot` JSON column)
+   * to the new flat schema (individual config columns). This handles the case where the agents table
+   * was already migrated but the versions table still has the old schema.
+   */
+  async #migrateVersionsSchema() {
+    const hasSnapshotColumn = await this.#db.hasColumn(storage.TABLE_AGENT_VERSIONS, "snapshot");
+    if (!hasSnapshotColumn) return;
+    await this.#client.execute({
+      sql: `DROP TABLE IF EXISTS "${storage.TABLE_AGENT_VERSIONS}"`
+    });
+    await this.#client.execute({
+      sql: `DROP TABLE IF EXISTS "${storage.TABLE_AGENTS}_legacy"`
+    });
+  }
+  /**
+   * Removes stale draft agent records that have no activeVersionId.
+   * These are left behind when createAgent partially fails (inserts thin record
+   * but fails to create the version due to schema mismatch).
+   */
+  async #cleanupStaleDrafts() {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${storage.TABLE_AGENTS}" WHERE status = 'draft' AND activeVersionId IS NULL`
+      });
+    } catch {
+    }
   }
   async dangerouslyClearAll() {
     await this.#db.deleteData({ tableName: storage.TABLE_AGENT_VERSIONS });
@@ -2083,21 +2191,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 +2225,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 +2293,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 +2419,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 +2667,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)