@mastra/editor 0.11.2 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @mastra/editor
 
+## 0.12.0
+
+### Minor Changes
+
+- Added source-backed storage primitives for code-mode agent editing. ([#17582](https://github.com/mastra-ai/mastra/pull/17582))
+
+  Mastra now exposes a `SourceControlProvider` interface for hosted source-control-backed editor storage, and `MastraEditor` can persist code-mode agent overrides through either local filesystem storage or a source provider.
+
+  ```ts
+  const editor = new MastraEditor({
+    source: 'code',
+    sourceControlProvider,
+  });
+  ```
+
+  Code-defined agents still respect their `editor` ownership config, while source-backed storage can read, write, list history, and open change requests through a provider implementation.
+
+### Patch Changes
+
+- Updated dependencies [[`de66bb0`](https://github.com/mastra-ai/mastra/commit/de66bb040570444c702ce4d8e1e228a5de2949cb), [`67bf8e2`](https://github.com/mastra-ai/mastra/commit/67bf8e206dfe583954d96015cf0d09f7ac50e45f), [`8216d05`](https://github.com/mastra-ai/mastra/commit/8216d0528d866eb9a07f5d4c87ea3bb1e1139b45), [`d18b23c`](https://github.com/mastra-ai/mastra/commit/d18b23c5e29dfc381e73e3c51fcf6c779afd1823), [`5eb94eb`](https://github.com/mastra-ai/mastra/commit/5eb94ebcf66d4e28c9e26d5821ac93379bab20a0), [`1fa3e12`](https://github.com/mastra-ai/mastra/commit/1fa3e123582b63cfe49de4ee52dc6a065e8d956a), [`f9ee2ac`](https://github.com/mastra-ai/mastra/commit/f9ee2ac661af584e61bc063ac208c9035cd752ef), [`c853d53`](https://github.com/mastra-ai/mastra/commit/c853d535d2df84ab89db1adb4c28900c54c9a2d2), [`d8df1f8`](https://github.com/mastra-ai/mastra/commit/d8df1f8e947e1966c9d4e54713df56d0d0d65226), [`9192ddb`](https://github.com/mastra-ai/mastra/commit/9192ddbced8949113b30de444cbe763f075b59f5), [`ae96523`](https://github.com/mastra-ai/mastra/commit/ae965231f562d9766b0c90c49a69fc68acaa031c), [`17d5a92`](https://github.com/mastra-ai/mastra/commit/17d5a9211aa293b4d4418de3de70dc0394d58101), [`5573693`](https://github.com/mastra-ai/mastra/commit/5573693b589822250e20dfe6cf66e9ff3bc96da8), [`ec4da8a`](https://github.com/mastra-ai/mastra/commit/ec4da8a09e0d2ab452c6ee2c786042ea826b77e5), [`adc44e1`](https://github.com/mastra-ai/mastra/commit/adc44e13c7e570b91e86b20ea7556e61d819db31), [`218d952`](https://github.com/mastra-ai/mastra/commit/218d952ec09e5111c10ccd143b5bc0ef19434376), [`7c987b4`](https://github.com/mastra-ai/mastra/commit/7c987b4cfcc498bb579f986d07f794633f8e0ff8), [`ed346c0`](https://github.com/mastra-ai/mastra/commit/ed346c0bee2d8496690a4e538bfba1e46894660f), [`9b1adf7`](https://github.com/mastra-ai/mastra/commit/9b1adf7f39943c869182106bc4016e793b3304ac), [`c9ce1b2`](https://github.com/mastra-ai/mastra/commit/c9ce1b28d10871110648f9d7b6d76e880b9fa999), [`3ef01fd`](https://github.com/mastra-ai/mastra/commit/3ef01fd130b53d5bd4f828beb174e516a2eb1158), [`245a9a3`](https://github.com/mastra-ai/mastra/commit/245a9a315705fce17ddd980f78a92504b6615c4a), [`dc0b611`](https://github.com/mastra-ai/mastra/commit/dc0b6119b769bd00ee2c5df9259fb376fe63077a), [`38b5de8`](https://github.com/mastra-ai/mastra/commit/38b5de8e5d1d41a69522addf53d96f4b3a1d5bf0), [`eae1556`](https://github.com/mastra-ai/mastra/commit/eae1556eedac109b67d91b627689cdf70a83bab7), [`efe917d`](https://github.com/mastra-ai/mastra/commit/efe917d524f285d9d131804027c7201bf7aee110), [`dc0b611`](https://github.com/mastra-ai/mastra/commit/dc0b6119b769bd00ee2c5df9259fb376fe63077a), [`dd6a66e`](https://github.com/mastra-ai/mastra/commit/dd6a66ea0b32e0dea8059aec6b35d151e2c87dc4), [`d785c59`](https://github.com/mastra-ai/mastra/commit/d785c593b67fcb4cdc4fab9fdbde5f3b7665efc0), [`1fa3e12`](https://github.com/mastra-ai/mastra/commit/1fa3e123582b63cfe49de4ee52dc6a065e8d956a), [`8b984f4`](https://github.com/mastra-ai/mastra/commit/8b984f4361c202270ceb69257185c4756c9a7c56), [`bf08402`](https://github.com/mastra-ai/mastra/commit/bf084022374fa5d06ca70ed67a86dd64e379071b), [`81fe587`](https://github.com/mastra-ai/mastra/commit/81fe587275035715c1720ddf3fee0505cf053036), [`1fa3e12`](https://github.com/mastra-ai/mastra/commit/1fa3e123582b63cfe49de4ee52dc6a065e8d956a), [`403c438`](https://github.com/mastra-ai/mastra/commit/403c438e417278989ce247233d2c465b8d902cdd), [`f8ba195`](https://github.com/mastra-ai/mastra/commit/f8ba1954e27ee2b20586cc6cd9cf13c002c232f2)]:
+  - @mastra/core@1.43.0
+  - @mastra/memory@1.20.4
+  - @mastra/schema-compat@1.2.12
+  - @mastra/mcp@1.10.0
+
 ## 0.11.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -956,8 +956,24 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       finalInput = applyBuilderDefaults(input, agentConfig);
     }
     await this.ensureStoredWorkspace(finalInput.workspace);
+    const existingCodeAgent = this.getCodeDefinedAgent(finalInput.id);
+    if (existingCodeAgent) {
+      const adapter = await this.getStorageAdapter();
+      await adapter.create(finalInput);
+      this._cache.set(finalInput.id, existingCodeAgent);
+      return existingCodeAgent;
+    }
     return super.create(finalInput);
   }
+  getCodeDefinedAgent(id) {
+    let agent;
+    try {
+      agent = this.mastra?.getAgentById(id);
+    } catch {
+      return void 0;
+    }
+    return agent?.source === "code" ? agent : void 0;
+  }
   /**
    * Ensure a workspace reference is persisted in the DB.
    *
@@ -1449,14 +1465,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       browser,
       ...skillsFormat && { skillsFormat }
     });
-    const existingCodeAgent = (() => {
-      try {
-        return this.mastra?.getAgentById(storedAgent.id);
-      } catch {
-        return void 0;
-      }
-    })();
-    if (!existingCodeAgent || existingCodeAgent.source !== "code") {
+    if (!this.getCodeDefinedAgent(storedAgent.id)) {
       this.mastra?.addAgent(agent, storedAgent.id, { source: "stored" });
     }
     this.logger?.debug(`[createAgentFromStoredConfig] Successfully created agent "${storedAgent.id}"`);
@@ -2605,6 +2614,7 @@ var MastraEditor = class {
     this.__processorProviders = { ...import_processor_provider2.BUILT_IN_PROCESSOR_PROVIDERS, ...config?.processorProviders };
     this.__source = config?.source;
     this.__codePath = config?.codePath ?? "./mastra/editor";
+    this.__sourceControlProvider = config?.sourceControlProvider ?? (0, import_storage.createGitHubSourceControlProviderFromEnv)(process.env, { pathPrefix: this.__codePath });
     this.__filesystems = /* @__PURE__ */ new Map();
     this.__filesystems.set(localFilesystemProvider.id, localFilesystemProvider);
     for (const [id, provider] of Object.entries(config?.filesystems ?? {})) {
@@ -2643,18 +2653,33 @@ var MastraEditor = class {
       this.__logger = mastra.getLogger();
     }
     if (this.__source === "code") {
-      const filesystemStore = new import_storage.FilesystemStore({ dir: this.__codePath });
       const existingStorage = mastra.getStorage();
-      if (existingStorage) {
+      if (this.__sourceControlProvider) {
+        const sourceAgentsStore = new import_storage.SourceAgentsSourceControl({
+          provider: this.__sourceControlProvider
+        });
+        const filesystemStore = new import_storage.FilesystemStore({ dir: this.__codePath });
         mastra.setStorage(
           new import_storage.MastraCompositeStore({
-            id: `${existingStorage.id}-with-editor-filesystem`,
-            default: existingStorage,
-            editor: filesystemStore
+            id: `${existingStorage?.id ?? "mastra"}-with-editor-source-control`,
+            ...existingStorage ? { default: existingStorage } : {},
+            editor: filesystemStore,
+            domains: { agents: sourceAgentsStore }
           })
         );
       } else {
-        mastra.setStorage(filesystemStore);
+        const filesystemStore = new import_storage.FilesystemStore({ dir: this.__codePath });
+        if (existingStorage) {
+          mastra.setStorage(
+            new import_storage.MastraCompositeStore({
+              id: `${existingStorage.id}-with-editor-filesystem`,
+              default: existingStorage,
+              editor: filesystemStore
+            })
+          );
+        } else {
+          mastra.setStorage(filesystemStore);
+        }
       }
     }
     this.ensureBuilderWorkspaces().then(() => this.reconcileBuilderWorkspaces()).catch((err) => {
@@ -2809,6 +2834,10 @@ var MastraEditor = class {
   getSource() {
     return this.__source;
   }
+  /** Returns the configured source control provider, if any. */
+  getSourceControlProvider() {
+    return this.__sourceControlProvider;
+  }
   /** Registered tool providers */
   getToolProvider(id) {
     return this.__toolProviders[id];