@mastra/editor 0.6.3-alpha.0 → 0.7.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @mastra/editor
 
+## 0.7.0-alpha.0
+
+### Minor Changes
+
+- Added `FilesystemStore`, a file-based storage adapter for editor domains. Stores agent configurations, prompt blocks, scorer definitions, MCP clients, MCP servers, workspaces, and skills as JSON files in a local directory (default: `.mastra-storage/`). Only published snapshots are written to disk — version history is kept in memory. Use with `MastraCompositeStore`'s `editor` shorthand to enable Git-friendly editor configurations. ([#13727](https://github.com/mastra-ai/mastra/pull/13727))
+
+  ```typescript
+  import { FilesystemStore, MastraCompositeStore } from '@mastra/core/storage';
+  import { PostgresStore } from '@mastra/pg';
+
+  export const mastra = new Mastra({
+    storage: new MastraCompositeStore({
+      id: 'composite',
+      default: new PostgresStore({ id: 'pg', connectionString: process.env.DATABASE_URL }),
+      editor: new FilesystemStore({ dir: '.mastra-storage' }),
+    }),
+  });
+  ```
+
+  Added `applyStoredOverrides` to the editor agent namespace. When a stored configuration exists for a code-defined agent, the editor merges the stored **instructions** and **tools** on top of the code agent's values at runtime. Model, memory, workspace, and other code-defined fields are never overridden — they may contain SDK instances or dynamic functions that cannot be safely serialized. Original code-defined values are preserved via a WeakMap and restored if the stored override is deleted.
+
+### Patch Changes
+
+- Updated dependencies [[`41e48c1`](https://github.com/mastra-ai/mastra/commit/41e48c198eee846478e60c02ec432c19d322a517), [`82469d3`](https://github.com/mastra-ai/mastra/commit/82469d3135d5a49dd8dc8feec0ff398b4e0225a0), [`33e2fd5`](https://github.com/mastra-ai/mastra/commit/33e2fd5088f83666df17401e2da68c943dbc0448), [`7ef6e2c`](https://github.com/mastra-ai/mastra/commit/7ef6e2c61be5a42e26f55d15b5902866fc76634f), [`08072ec`](https://github.com/mastra-ai/mastra/commit/08072ec54b5dfe810ed66c0d583ae9d1a9103c11), [`ef9d0f0`](https://github.com/mastra-ai/mastra/commit/ef9d0f0fa98ff225b17afe071f5b84a9258dc142), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`9e21667`](https://github.com/mastra-ai/mastra/commit/9e2166746df81da8f1f933a918741fc52f922c70), [`fa37d39`](https://github.com/mastra-ai/mastra/commit/fa37d39910421feaf8847716292e3d65dd4f30c2), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`1391f22`](https://github.com/mastra-ai/mastra/commit/1391f227ff197080de185ac1073c1d1568c0631f), [`71c38bf`](https://github.com/mastra-ai/mastra/commit/71c38bf905905148ecd0e75c07c1f9825d299b76), [`f993c38`](https://github.com/mastra-ai/mastra/commit/f993c3848c97479b813231be872443bedeced6ab), [`f51849a`](https://github.com/mastra-ai/mastra/commit/f51849a568935122b5100b7ee69704e6d680cf7b), [`3ceb231`](https://github.com/mastra-ai/mastra/commit/3ceb2317aad7da36df5053e7c84f9381eeb68d11), [`9bf3a0d`](https://github.com/mastra-ai/mastra/commit/9bf3a0dac602787925f1762f1f0387d7b4a59620), [`cafa045`](https://github.com/mastra-ai/mastra/commit/cafa0453c9de141ad50c09a13894622dffdd9978), [`1fd9ddb`](https://github.com/mastra-ai/mastra/commit/1fd9ddbb3fe83b281b12bd2e27e426ae86288266), [`1391f22`](https://github.com/mastra-ai/mastra/commit/1391f227ff197080de185ac1073c1d1568c0631f), [`ef888d2`](https://github.com/mastra-ai/mastra/commit/ef888d23c77f85f4c202228b63f8fd9b6d9361af), [`e7a567c`](https://github.com/mastra-ai/mastra/commit/e7a567cfb3e65c955a07d0167cb1b4141f5bda01), [`3626623`](https://github.com/mastra-ai/mastra/commit/36266238eb7db78fce2ac34187194613f6f53733), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443), [`d9d228c`](https://github.com/mastra-ai/mastra/commit/d9d228c0c6ae82ae6ce3b540a3a56b2b1c2b8d98), [`5576507`](https://github.com/mastra-ai/mastra/commit/55765071e360fb97e443aa0a91ccf7e1cd8d92aa), [`79d69c9`](https://github.com/mastra-ai/mastra/commit/79d69c9d5f842ff1c31352fb6026f04c1f6190f3), [`94f44b8`](https://github.com/mastra-ai/mastra/commit/94f44b827ce57b179e50f4916a84c0fa6e7f3b8c), [`13187db`](https://github.com/mastra-ai/mastra/commit/13187dbac880174232dedc5a501ff6c5d0fe59bc), [`2ae5311`](https://github.com/mastra-ai/mastra/commit/2ae531185fff66a80fa165c0999e3d801900e89d), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443)]:
+  - @mastra/core@1.10.0-alpha.0
+  - @mastra/memory@1.6.1-alpha.0
+  - @mastra/mcp@1.1.0-alpha.0
+
+## 0.6.3
+
+### Patch Changes
+
+- Updated dependencies [[`504fc8b`](https://github.com/mastra-ai/mastra/commit/504fc8b9d0ddab717577ad3bf9c95ea4bd5377bd), [`f9c150b`](https://github.com/mastra-ai/mastra/commit/f9c150b7595ad05ad9cc9a11098e2944361e8c22), [`88de7e8`](https://github.com/mastra-ai/mastra/commit/88de7e8dfe4b7e1951a9e441bb33136e705ce24e), [`edee4b3`](https://github.com/mastra-ai/mastra/commit/edee4b37dff0af515fc7cc0e8d71ee39e6a762f0), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`3790c75`](https://github.com/mastra-ai/mastra/commit/3790c7578cc6a47d854eb12d89e6b1912867fe29), [`e7a235b`](https://github.com/mastra-ai/mastra/commit/e7a235be6472e0c870ed6c791ddb17c492dc188b), [`d51d298`](https://github.com/mastra-ai/mastra/commit/d51d298953967aab1f58ec965b644d109214f085), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d5f0d8d`](https://github.com/mastra-ai/mastra/commit/d5f0d8d6a03e515ddaa9b5da19b7e44b8357b07b), [`09c3b18`](https://github.com/mastra-ai/mastra/commit/09c3b1802ff14e243a8a8baea327440bc8cc2e32), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`85c84eb`](https://github.com/mastra-ai/mastra/commit/85c84ebb78aebfcba9d209c8e152b16d7a00cb71), [`a89272a`](https://github.com/mastra-ai/mastra/commit/a89272a5d71939b9fcd284e6a6dc1dd091a6bdcf), [`ee9c8df`](https://github.com/mastra-ai/mastra/commit/ee9c8df644f19d055af5f496bf4942705f5a47b7), [`77b4a25`](https://github.com/mastra-ai/mastra/commit/77b4a254e51907f8ff3a3ba95596a18e93ae4b35), [`276246e`](https://github.com/mastra-ai/mastra/commit/276246e0b9066a1ea48bbc70df84dbe528daaf99), [`08ecfdb`](https://github.com/mastra-ai/mastra/commit/08ecfdbdad6fb8285deef86a034bdf4a6047cfca), [`d5f628c`](https://github.com/mastra-ai/mastra/commit/d5f628ca86c6f6f3ff1035d52f635df32dd81cab), [`24f7204`](https://github.com/mastra-ai/mastra/commit/24f72046eb35b47c75d36193af4fb817b588720d), [`359d687`](https://github.com/mastra-ai/mastra/commit/359d687527ab95a79e0ec0487dcecec8d9c7c7dc), [`524c0f3`](https://github.com/mastra-ai/mastra/commit/524c0f3c434c3d9d18f66338dcef383d6161b59c), [`c18a0e9`](https://github.com/mastra-ai/mastra/commit/c18a0e9cef1e4ca004b2963d35e4cfc031971eac), [`4bd21ea`](https://github.com/mastra-ai/mastra/commit/4bd21ea43d44d0a0427414fc047577f9f0aa3bec), [`115a7a4`](https://github.com/mastra-ai/mastra/commit/115a7a47db5e9896fec12ae6507501adb9ec89bf), [`22a48ae`](https://github.com/mastra-ai/mastra/commit/22a48ae2513eb54d8d79dad361fddbca97a155e8), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9e77e8f`](https://github.com/mastra-ai/mastra/commit/9e77e8f0e823ef58cb448dd1f390fce987a101f3), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`7edf78f`](https://github.com/mastra-ai/mastra/commit/7edf78f80422c43e84585f08ba11df0d4d0b73c5), [`1c4221c`](https://github.com/mastra-ai/mastra/commit/1c4221cf6032ec98d0e094d4ee11da3e48490d96), [`d25b9ea`](https://github.com/mastra-ai/mastra/commit/d25b9eabd400167255a97b690ffbc4ee4097ded5), [`fe1ce5c`](https://github.com/mastra-ai/mastra/commit/fe1ce5c9211c03d561606fda95cbfe7df1d9a9b5), [`b03c0e0`](https://github.com/mastra-ai/mastra/commit/b03c0e0389a799523929a458b0509c9e4244d562), [`0a8366b`](https://github.com/mastra-ai/mastra/commit/0a8366b0a692fcdde56c4d526e4cf03c502ae4ac), [`56f2018`](https://github.com/mastra-ai/mastra/commit/56f2018cb38969c11933e815a5f70cf631d3964a), [`85664e9`](https://github.com/mastra-ai/mastra/commit/85664e9fd857320fbc245e301f764f45f66f32a3), [`bc79650`](https://github.com/mastra-ai/mastra/commit/bc796500c6e0334faa158a96077e3fb332274869), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`3a3a59e`](https://github.com/mastra-ai/mastra/commit/3a3a59e8ffaa6a985fe3d9a126a3f5ade11a6724), [`3108d4e`](https://github.com/mastra-ai/mastra/commit/3108d4e649c9fddbf03253a6feeb388a5fa9fa5a), [`0c33b2c`](https://github.com/mastra-ai/mastra/commit/0c33b2c9db537f815e1c59e2c898ffce2e395a79), [`191e5bd`](https://github.com/mastra-ai/mastra/commit/191e5bd29b82f5bda35243945790da7bc7b695c2), [`fde104d`](https://github.com/mastra-ai/mastra/commit/fde104da80935d6e0dd24327e86a51011fcb3173), [`f77cd94`](https://github.com/mastra-ai/mastra/commit/f77cd94c44eabed490384e7d19232a865e13214c), [`e8135c7`](https://github.com/mastra-ai/mastra/commit/e8135c7e300dac5040670eec7eab896ac6092e30), [`daca48f`](https://github.com/mastra-ai/mastra/commit/daca48f0fb17b7ae0b62a2ac40cf0e491b2fd0b7), [`257d14f`](https://github.com/mastra-ai/mastra/commit/257d14faca5931f2e4186fc165b6f0b1f915deee), [`352f25d`](https://github.com/mastra-ai/mastra/commit/352f25da316b24cdd5b410fd8dddf6a8b763da2a), [`93477d0`](https://github.com/mastra-ai/mastra/commit/93477d0769b8a13ea5ed73d508d967fb23eaeed9), [`31c78b3`](https://github.com/mastra-ai/mastra/commit/31c78b3eb28f58a8017f1dcc795c33214d87feac), [`0bc0720`](https://github.com/mastra-ai/mastra/commit/0bc07201095791858087cc56f353fcd65e87ab54), [`36516ac`](https://github.com/mastra-ai/mastra/commit/36516aca1021cbeb42e74751b46a2614101f37c8), [`e947652`](https://github.com/mastra-ai/mastra/commit/e9476527fdecb4449e54570e80dfaf8466901254), [`23b43dd`](https://github.com/mastra-ai/mastra/commit/23b43ddd0e3db05dee828c2733faa2496b7b0319), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`ec248f6`](https://github.com/mastra-ai/mastra/commit/ec248f6b56e8a037c066c49b2178e2507471d988)]:
+  - @mastra/core@1.9.0
+  - @mastra/memory@1.6.0
+  - @mastra/mcp@1.0.3
+
 ## 0.6.3-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -154,8 +154,11 @@ var CrudEditorNamespace = class extends EditorNamespace {
    */
   clearCache(id) {
     if (id) {
+      const wasCached = this._cache.has(id);
       this._cache.delete(id);
-      this.onCacheEvict(id);
+      if (wasCached) {
+        this.onCacheEvict(id);
+      }
       this.logger?.debug(`[clearCache] Cleared cache for "${id}"`);
     } else {
       for (const cachedId of Array.from(this._cache.keys())) {
@@ -559,6 +562,7 @@ var EditorMCPNamespace = class _EditorMCPNamespace extends CrudEditorNamespace {
 };
 
 // src/namespaces/agent.ts
+var codeDefaults = /* @__PURE__ */ new WeakMap();
 var EditorAgentNamespace = class extends CrudEditorNamespace {
   async getStorageAdapter() {
     const storage = this.mastra?.getStorage();
@@ -599,7 +603,13 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     return this.createAgentFromStoredConfig(storedAgent);
   }
   onCacheEvict(id) {
-    this.mastra?.removeAgent(id);
+    try {
+      const existing = this.mastra?.getAgentById(id);
+      if (existing?.source === "stored") {
+        this.mastra?.removeAgent(id);
+      }
+    } catch {
+    }
   }
   /**
    * Evict all cached agents that reference a given skill ID.
@@ -628,6 +638,117 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       }
     }
   }
+  /**
+   * Apply stored configuration overrides to a code-defined agent.
+   *
+   * When a stored config exists for the given agent's ID, the following fields
+   * from the stored config override the code agent's values (if explicitly set):
+   * - `instructions` — system prompt
+   * - `tools` — tool selection with description overrides (merged on top of code tools)
+   *
+   * Fields that are absent or undefined in the stored config are left untouched.
+   * Model, workspace, memory, and other code-defined fields are never overridden —
+   * they may contain SDK instances or dynamic functions that cannot be safely serialized.
+   * Returns the (possibly mutated) agent.
+   */
+  async applyStoredOverrides(agent) {
+    let storedConfig = null;
+    try {
+      this.ensureRegistered();
+      const adapter = await this.getStorageAdapter();
+      storedConfig = await adapter.getByIdResolved(agent.id, { status: "draft" });
+    } catch {
+      this.restoreCodeDefaults(agent);
+      return agent;
+    }
+    if (!storedConfig) {
+      this.restoreCodeDefaults(agent);
+      return agent;
+    }
+    this.saveCodeDefaults(agent);
+    this.restoreCodeDefaults(agent);
+    this.saveCodeDefaults(agent);
+    this.logger?.debug(`[applyStoredOverrides] Applying stored overrides to code agent "${agent.id}"`);
+    if (storedConfig.instructions !== void 0 && storedConfig.instructions !== null) {
+      const resolved = this.resolveStoredInstructions(storedConfig.instructions);
+      if (resolved !== void 0) {
+        agent.__updateInstructions(resolved);
+      }
+    }
+    const hasStoredTools = storedConfig.tools != null;
+    const hasStoredMCPClients = storedConfig.mcpClients != null;
+    const hasStoredIntegrationTools = storedConfig.integrationTools != null;
+    if (hasStoredTools || hasStoredMCPClients || hasStoredIntegrationTools) {
+      const hasConditionalTools = this.isConditionalVariants(storedConfig.tools);
+      const hasConditionalMCPClients = storedConfig.mcpClients != null && this.isConditionalVariants(storedConfig.mcpClients);
+      const hasConditionalIntegrationTools = storedConfig.integrationTools != null && this.isConditionalVariants(storedConfig.integrationTools);
+      const isDynamicTools = hasConditionalTools || hasConditionalMCPClients || hasConditionalIntegrationTools;
+      if (isDynamicTools) {
+        const originalTools = agent.listTools.bind(agent);
+        const toolsFn = async ({ requestContext }) => {
+          const codeTools = await originalTools({ requestContext });
+          const ctx = requestContext.toJSON();
+          const resolvedToolsConfig = hasConditionalTools ? this.accumulateObjectVariants(
+            storedConfig.tools,
+            ctx
+          ) : storedConfig.tools;
+          const registryTools = this.resolveStoredTools(resolvedToolsConfig);
+          const resolvedMCPClientsConfig = hasConditionalMCPClients ? this.accumulateObjectVariants(
+            storedConfig.mcpClients,
+            ctx
+          ) : storedConfig.mcpClients;
+          const mcpTools = await this.resolveStoredMCPTools(resolvedMCPClientsConfig);
+          const resolvedIntegrationToolsConfig = hasConditionalIntegrationTools ? this.accumulateObjectVariants(
+            storedConfig.integrationTools,
+            ctx
+          ) : storedConfig.integrationTools;
+          const integrationTools = await this.resolveStoredIntegrationTools(resolvedIntegrationToolsConfig, ctx);
+          return { ...codeTools, ...registryTools, ...mcpTools, ...integrationTools };
+        };
+        agent.__setTools(toolsFn);
+      } else {
+        const codeTools = await agent.listTools();
+        const registryTools = this.resolveStoredTools(
+          storedConfig.tools
+        );
+        const mcpTools = await this.resolveStoredMCPTools(
+          storedConfig.mcpClients
+        );
+        const integrationTools = await this.resolveStoredIntegrationTools(
+          storedConfig.integrationTools
+        );
+        agent.__setTools({ ...codeTools, ...registryTools, ...mcpTools, ...integrationTools });
+      }
+    }
+    return agent;
+  }
+  /**
+   * Save the agent's current field values to the module-level WeakMap
+   * so they can be restored if the stored config is later removed.
+   * Only saves on the first call (guards against overwriting originals with overridden values).
+   *
+   * Only instructions and tools are saved — these are the only fields
+   * that `applyStoredOverrides` mutates.
+   */
+  saveCodeDefaults(agent) {
+    if (codeDefaults.has(agent)) return;
+    const fields = agent.__getOverridableFields();
+    codeDefaults.set(agent, {
+      instructions: fields.instructions,
+      tools: fields.tools
+    });
+  }
+  /**
+   * Restore the agent's original code-defined field values from the WeakMap.
+   * Clears the saved snapshot afterward.
+   */
+  restoreCodeDefaults(agent) {
+    const saved = codeDefaults.get(agent);
+    if (!saved) return;
+    agent.__updateInstructions(saved.instructions);
+    agent.__setTools(saved.tools);
+    codeDefaults.delete(agent);
+  }
   // ============================================================================
   // Private helpers
   // ============================================================================
@@ -868,7 +989,16 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       workspace,
       ...skillsFormat && { skillsFormat }
     });
-    this.mastra?.addAgent(agent, storedAgent.id, { source: "stored" });
+    const existingCodeAgent = (() => {
+      try {
+        return this.mastra?.getAgentById(storedAgent.id);
+      } catch {
+        return void 0;
+      }
+    })();
+    if (!existingCodeAgent || existingCodeAgent.source !== "code") {
+      this.mastra?.addAgent(agent, storedAgent.id, { source: "stored" });
+    }
     this.logger?.debug(`[createAgentFromStoredConfig] Successfully created agent "${storedAgent.id}"`);
     return agent;
   }

package/dist/index.d.cts

@@ -102,6 +102,34 @@ declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgen
      * subsequent agent.getById() calls re-hydrate with the updated skill version.
      */
     invalidateAgentsReferencingSkill(skillId: string): void;
+    /**
+     * Apply stored configuration overrides to a code-defined agent.
+     *
+     * When a stored config exists for the given agent's ID, the following fields
+     * from the stored config override the code agent's values (if explicitly set):
+     * - `instructions` — system prompt
+     * - `tools` — tool selection with description overrides (merged on top of code tools)
+     *
+     * Fields that are absent or undefined in the stored config are left untouched.
+     * Model, workspace, memory, and other code-defined fields are never overridden —
+     * they may contain SDK instances or dynamic functions that cannot be safely serialized.
+     * Returns the (possibly mutated) agent.
+     */
+    applyStoredOverrides(agent: Agent): Promise<Agent>;
+    /**
+     * Save the agent's current field values to the module-level WeakMap
+     * so they can be restored if the stored config is later removed.
+     * Only saves on the first call (guards against overwriting originals with overridden values).
+     *
+     * Only instructions and tools are saved — these are the only fields
+     * that `applyStoredOverrides` mutates.
+     */
+    private saveCodeDefaults;
+    /**
+     * Restore the agent's original code-defined field values from the WeakMap.
+     * Clears the saved snapshot afterward.
+     */
+    private restoreCodeDefaults;
     /**
      * Detect whether a StorageConditionalField value is a conditional variant array
      * (as opposed to the plain static value T).

package/dist/index.d.ts

@@ -102,6 +102,34 @@ declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgen
      * subsequent agent.getById() calls re-hydrate with the updated skill version.
      */
     invalidateAgentsReferencingSkill(skillId: string): void;
+    /**
+     * Apply stored configuration overrides to a code-defined agent.
+     *
+     * When a stored config exists for the given agent's ID, the following fields
+     * from the stored config override the code agent's values (if explicitly set):
+     * - `instructions` — system prompt
+     * - `tools` — tool selection with description overrides (merged on top of code tools)
+     *
+     * Fields that are absent or undefined in the stored config are left untouched.
+     * Model, workspace, memory, and other code-defined fields are never overridden —
+     * they may contain SDK instances or dynamic functions that cannot be safely serialized.
+     * Returns the (possibly mutated) agent.
+     */
+    applyStoredOverrides(agent: Agent): Promise<Agent>;
+    /**
+     * Save the agent's current field values to the module-level WeakMap
+     * so they can be restored if the stored config is later removed.
+     * Only saves on the first call (guards against overwriting originals with overridden values).
+     *
+     * Only instructions and tools are saved — these are the only fields
+     * that `applyStoredOverrides` mutates.
+     */
+    private saveCodeDefaults;
+    /**
+     * Restore the agent's original code-defined field values from the WeakMap.
+     * Clears the saved snapshot afterward.
+     */
+    private restoreCodeDefaults;
     /**
      * Detect whether a StorageConditionalField value is a conditional variant array
      * (as opposed to the plain static value T).

package/dist/index.js

@@ -106,8 +106,11 @@ var CrudEditorNamespace = class extends EditorNamespace {
    */
   clearCache(id) {
     if (id) {
+      const wasCached = this._cache.has(id);
       this._cache.delete(id);
-      this.onCacheEvict(id);
+      if (wasCached) {
+        this.onCacheEvict(id);
+      }
       this.logger?.debug(`[clearCache] Cleared cache for "${id}"`);
     } else {
       for (const cachedId of Array.from(this._cache.keys())) {
@@ -511,6 +514,7 @@ var EditorMCPNamespace = class _EditorMCPNamespace extends CrudEditorNamespace {
 };
 
 // src/namespaces/agent.ts
+var codeDefaults = /* @__PURE__ */ new WeakMap();
 var EditorAgentNamespace = class extends CrudEditorNamespace {
   async getStorageAdapter() {
     const storage = this.mastra?.getStorage();
@@ -551,7 +555,13 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     return this.createAgentFromStoredConfig(storedAgent);
   }
   onCacheEvict(id) {
-    this.mastra?.removeAgent(id);
+    try {
+      const existing = this.mastra?.getAgentById(id);
+      if (existing?.source === "stored") {
+        this.mastra?.removeAgent(id);
+      }
+    } catch {
+    }
   }
   /**
    * Evict all cached agents that reference a given skill ID.
@@ -580,6 +590,117 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       }
     }
   }
+  /**
+   * Apply stored configuration overrides to a code-defined agent.
+   *
+   * When a stored config exists for the given agent's ID, the following fields
+   * from the stored config override the code agent's values (if explicitly set):
+   * - `instructions` — system prompt
+   * - `tools` — tool selection with description overrides (merged on top of code tools)
+   *
+   * Fields that are absent or undefined in the stored config are left untouched.
+   * Model, workspace, memory, and other code-defined fields are never overridden —
+   * they may contain SDK instances or dynamic functions that cannot be safely serialized.
+   * Returns the (possibly mutated) agent.
+   */
+  async applyStoredOverrides(agent) {
+    let storedConfig = null;
+    try {
+      this.ensureRegistered();
+      const adapter = await this.getStorageAdapter();
+      storedConfig = await adapter.getByIdResolved(agent.id, { status: "draft" });
+    } catch {
+      this.restoreCodeDefaults(agent);
+      return agent;
+    }
+    if (!storedConfig) {
+      this.restoreCodeDefaults(agent);
+      return agent;
+    }
+    this.saveCodeDefaults(agent);
+    this.restoreCodeDefaults(agent);
+    this.saveCodeDefaults(agent);
+    this.logger?.debug(`[applyStoredOverrides] Applying stored overrides to code agent "${agent.id}"`);
+    if (storedConfig.instructions !== void 0 && storedConfig.instructions !== null) {
+      const resolved = this.resolveStoredInstructions(storedConfig.instructions);
+      if (resolved !== void 0) {
+        agent.__updateInstructions(resolved);
+      }
+    }
+    const hasStoredTools = storedConfig.tools != null;
+    const hasStoredMCPClients = storedConfig.mcpClients != null;
+    const hasStoredIntegrationTools = storedConfig.integrationTools != null;
+    if (hasStoredTools || hasStoredMCPClients || hasStoredIntegrationTools) {
+      const hasConditionalTools = this.isConditionalVariants(storedConfig.tools);
+      const hasConditionalMCPClients = storedConfig.mcpClients != null && this.isConditionalVariants(storedConfig.mcpClients);
+      const hasConditionalIntegrationTools = storedConfig.integrationTools != null && this.isConditionalVariants(storedConfig.integrationTools);
+      const isDynamicTools = hasConditionalTools || hasConditionalMCPClients || hasConditionalIntegrationTools;
+      if (isDynamicTools) {
+        const originalTools = agent.listTools.bind(agent);
+        const toolsFn = async ({ requestContext }) => {
+          const codeTools = await originalTools({ requestContext });
+          const ctx = requestContext.toJSON();
+          const resolvedToolsConfig = hasConditionalTools ? this.accumulateObjectVariants(
+            storedConfig.tools,
+            ctx
+          ) : storedConfig.tools;
+          const registryTools = this.resolveStoredTools(resolvedToolsConfig);
+          const resolvedMCPClientsConfig = hasConditionalMCPClients ? this.accumulateObjectVariants(
+            storedConfig.mcpClients,
+            ctx
+          ) : storedConfig.mcpClients;
+          const mcpTools = await this.resolveStoredMCPTools(resolvedMCPClientsConfig);
+          const resolvedIntegrationToolsConfig = hasConditionalIntegrationTools ? this.accumulateObjectVariants(
+            storedConfig.integrationTools,
+            ctx
+          ) : storedConfig.integrationTools;
+          const integrationTools = await this.resolveStoredIntegrationTools(resolvedIntegrationToolsConfig, ctx);
+          return { ...codeTools, ...registryTools, ...mcpTools, ...integrationTools };
+        };
+        agent.__setTools(toolsFn);
+      } else {
+        const codeTools = await agent.listTools();
+        const registryTools = this.resolveStoredTools(
+          storedConfig.tools
+        );
+        const mcpTools = await this.resolveStoredMCPTools(
+          storedConfig.mcpClients
+        );
+        const integrationTools = await this.resolveStoredIntegrationTools(
+          storedConfig.integrationTools
+        );
+        agent.__setTools({ ...codeTools, ...registryTools, ...mcpTools, ...integrationTools });
+      }
+    }
+    return agent;
+  }
+  /**
+   * Save the agent's current field values to the module-level WeakMap
+   * so they can be restored if the stored config is later removed.
+   * Only saves on the first call (guards against overwriting originals with overridden values).
+   *
+   * Only instructions and tools are saved — these are the only fields
+   * that `applyStoredOverrides` mutates.
+   */
+  saveCodeDefaults(agent) {
+    if (codeDefaults.has(agent)) return;
+    const fields = agent.__getOverridableFields();
+    codeDefaults.set(agent, {
+      instructions: fields.instructions,
+      tools: fields.tools
+    });
+  }
+  /**
+   * Restore the agent's original code-defined field values from the WeakMap.
+   * Clears the saved snapshot afterward.
+   */
+  restoreCodeDefaults(agent) {
+    const saved = codeDefaults.get(agent);
+    if (!saved) return;
+    agent.__updateInstructions(saved.instructions);
+    agent.__setTools(saved.tools);
+    codeDefaults.delete(agent);
+  }
   // ============================================================================
   // Private helpers
   // ============================================================================
@@ -820,7 +941,16 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       workspace,
       ...skillsFormat && { skillsFormat }
     });
-    this.mastra?.addAgent(agent, storedAgent.id, { source: "stored" });
+    const existingCodeAgent = (() => {
+      try {
+        return this.mastra?.getAgentById(storedAgent.id);
+      } catch {
+        return void 0;
+      }
+    })();
+    if (!existingCodeAgent || existingCodeAgent.source !== "code") {
+      this.mastra?.addAgent(agent, storedAgent.id, { source: "stored" });
+    }
     this.logger?.debug(`[createAgentFromStoredConfig] Successfully created agent "${storedAgent.id}"`);
     return agent;
   }

package/dist/storage/index.cjs

@@ -0,0 +1,36 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/storage/index.ts
+var storage_exports = {};
+__export(storage_exports, {
+  FilesystemDB: () => import_storage.FilesystemDB,
+  FilesystemStore: () => import_storage.FilesystemStore,
+  FilesystemVersionedHelpers: () => import_storage.FilesystemVersionedHelpers,
+  GitHistory: () => import_storage.GitHistory
+});
+module.exports = __toCommonJS(storage_exports);
+var import_storage = require("@mastra/core/storage");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FilesystemDB,
+  FilesystemStore,
+  FilesystemVersionedHelpers,
+  GitHistory
+});

package/dist/storage/index.d.cts

@@ -0,0 +1 @@
+export { FilesystemDB, FilesystemStore, FilesystemStoreConfig, FilesystemVersionedHelpers, GitHistory } from '@mastra/core/storage';

package/dist/storage/index.d.ts

@@ -0,0 +1 @@
+export { FilesystemDB, FilesystemStore, FilesystemStoreConfig, FilesystemVersionedHelpers, GitHistory } from '@mastra/core/storage';

package/dist/storage/index.js

@@ -0,0 +1,13 @@
+// src/storage/index.ts
+import {
+  FilesystemStore,
+  FilesystemDB,
+  FilesystemVersionedHelpers,
+  GitHistory
+} from "@mastra/core/storage";
+export {
+  FilesystemDB,
+  FilesystemStore,
+  FilesystemVersionedHelpers,
+  GitHistory
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/editor",
-  "version": "0.6.3-alpha.0",
+  "version": "0.7.0-alpha.0",
   "description": "Mastra Editor for agent management and instantiation",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -36,6 +36,16 @@
         "types": "./dist/arcade.d.ts",
         "default": "./dist/arcade.cjs"
       }
+    },
+    "./storage": {
+      "import": {
+        "types": "./dist/storage/index.d.ts",
+        "default": "./dist/storage/index.js"
+      },
+      "require": {
+        "types": "./dist/storage/index.d.ts",
+        "default": "./dist/storage/index.cjs"
+      }
     }
   },
   "files": [
@@ -55,26 +65,26 @@
     "@arcadeai/arcadejs": "^2.2.0",
     "@composio/core": "^0.6.3",
     "@composio/mastra": "^0.6.3",
-    "@mastra/memory": "1.6.0-alpha.0",
+    "@mastra/memory": "1.6.1-alpha.0",
     "@mastra/schema-compat": "1.1.3"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.14.1",
+    "@hono/node-server": "^1.19.9",
     "hono": "^4.7.10",
     "tsup": "^8.0.2",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
     "zod": "^3.25.76",
-    "@internal/ai-sdk-v4": "0.0.10",
-    "@mastra/core": "1.9.0-alpha.0",
-    "@internal/ai-sdk-v5": "0.0.10",
-    "@mastra/hono": "1.1.8-alpha.0",
-    "@internal/ai-v6": "0.0.10",
-    "@mastra/libsql": "1.6.3-alpha.0",
-    "@mastra/mcp": "1.0.3-alpha.0"
+    "@internal/ai-sdk-v4": "0.0.12",
+    "@internal/ai-sdk-v5": "0.0.12",
+    "@internal/ai-v6": "0.0.12",
+    "@mastra/core": "1.10.0-alpha.0",
+    "@mastra/hono": "1.1.9-alpha.0",
+    "@mastra/libsql": "1.6.4-alpha.0",
+    "@mastra/mcp": "1.1.0-alpha.0"
   },
   "peerDependencies": {
-    "@mastra/core": ">=1.0.0-0 <2.0.0-0",
+    "@mastra/core": ">=1.7.1-0 <2.0.0-0",
     "@mastra/mcp": ">=1.0.0-0 <2.0.0-0",
     "zod": "^3.25.0 || ^4.0.0"
   },
@@ -87,8 +97,8 @@
     "node": ">=22.13.0"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/composio.ts src/arcade.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts src/composio.ts src/arcade.ts --format cjs,esm --dts --watch",
+    "build": "tsup src/index.ts src/composio.ts src/arcade.ts src/storage/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/composio.ts src/arcade.ts src/storage/index.ts --format cjs,esm --dts --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",