@mastra/editor 0.11.0-alpha.2 → 0.11.0-alpha.3

package/dist/index.d.cts

@@ -156,6 +156,7 @@ declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgen
     private accumulateObjectVariants;
     private createAgentFromStoredConfig;
     private resolveStoredInstructions;
+    private applyStoredToolDescriptions;
     /**
      * Resolve stored tool IDs to actual tool instances from Mastra's registry.
      * Applies description overrides from per-tool config when present.
@@ -442,6 +443,8 @@ declare class MastraEditor implements IMastraEditor {
     __logger?: IMastraLogger;
     private __toolProviders;
     private __processorProviders;
+    private __source?;
+    private __codePath;
     private readonly __builderConfig?;
     private __builderInstance?;
     private __builderResolved;
@@ -521,6 +524,8 @@ declare class MastraEditor implements IMastraEditor {
      * valid EE license. Dev environments bypass via `isEEEnabled()`.
      */
     private assertAgentBuilderLicensed;
+    /** Returns the editor's configured source, or undefined if unset. */
+    getSource(): 'code' | 'db' | undefined;
     /** Registered tool providers */
     getToolProvider(id: string): ToolProvider | undefined;
     /**

package/dist/index.d.ts

@@ -156,6 +156,7 @@ declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgen
     private accumulateObjectVariants;
     private createAgentFromStoredConfig;
     private resolveStoredInstructions;
+    private applyStoredToolDescriptions;
     /**
      * Resolve stored tool IDs to actual tool instances from Mastra's registry.
      * Applies description overrides from per-tool config when present.
@@ -442,6 +443,8 @@ declare class MastraEditor implements IMastraEditor {
     __logger?: IMastraLogger;
     private __toolProviders;
     private __processorProviders;
+    private __source?;
+    private __codePath;
     private readonly __builderConfig?;
     private __builderInstance?;
     private __builderResolved;
@@ -521,6 +524,8 @@ declare class MastraEditor implements IMastraEditor {
      * valid EE license. Dev environments bypass via `isEEEnabled()`.
      */
     private assertAgentBuilderLicensed;
+    /** Returns the editor's configured source, or undefined if unset. */
+    getSource(): 'code' | 'db' | undefined;
     /** Registered tool providers */
     getToolProvider(id: string): ToolProvider | undefined;
     /**

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/index.ts
 import { BUILT_IN_PROCESSOR_PROVIDERS } from "@mastra/core/processor-provider";
+import { FilesystemStore, MastraCompositeStore } from "@mastra/core/storage";
 import { UnknownToolProviderError } from "@mastra/core/tool-provider";
 
 // src/namespaces/base.ts
@@ -703,6 +704,14 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
    * Returns the (possibly mutated) agent.
    */
   async applyStoredOverrides(agent, options, requestContext) {
+    const editorConfig = agent.__getEditorConfig?.();
+    if (editorConfig === false) {
+      return agent;
+    }
+    const instructionsEditable = editorConfig === void 0 ? true : editorConfig.instructions === true;
+    const toolsConfig = editorConfig === void 0 ? true : editorConfig.tools;
+    const toolsEditable = toolsConfig === true;
+    const toolDescriptionsEditable = typeof toolsConfig === "object" && toolsConfig !== null && toolsConfig.description === true;
     let storedConfig = null;
     try {
       this.ensureRegistered();
@@ -724,7 +733,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     }
     const fork = agent.__fork();
     this.logger?.debug(`[applyStoredOverrides] Applying stored overrides to code agent "${agent.id}"`);
-    if (storedConfig.instructions !== void 0 && storedConfig.instructions !== null) {
+    if (instructionsEditable && storedConfig.instructions !== void 0 && storedConfig.instructions !== null) {
       const resolved = this.resolveStoredInstructions(storedConfig.instructions);
       if (resolved !== void 0) {
         fork.__updateInstructions(resolved);
@@ -734,7 +743,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     const hasStoredMCPClients = storedConfig.mcpClients != null;
     const hasStoredIntegrationTools = storedConfig.integrationTools != null;
     const hasStoredToolProviders = storedConfig.toolProviders != null && Object.keys(storedConfig.toolProviders).length > 0;
-    if (hasStoredTools || hasStoredMCPClients || hasStoredIntegrationTools || hasStoredToolProviders) {
+    if (toolsEditable && (hasStoredTools || hasStoredMCPClients || hasStoredIntegrationTools || hasStoredToolProviders)) {
       const hasConditionalTools = this.isConditionalVariants(storedConfig.tools);
       const hasConditionalMCPClients = storedConfig.mcpClients != null && this.isConditionalVariants(storedConfig.mcpClients);
       const hasConditionalIntegrationTools = storedConfig.integrationTools != null && this.isConditionalVariants(storedConfig.integrationTools);
@@ -793,6 +802,28 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
         );
         fork.__setTools({ ...codeTools, ...registryTools, ...mcpTools, ...integrationTools });
       }
+    } else if (toolDescriptionsEditable && hasStoredTools) {
+      const hasConditionalTools = this.isConditionalVariants(storedConfig.tools);
+      if (hasConditionalTools) {
+        const originalTools = agent.listTools.bind(agent);
+        const toolsFn = async ({ requestContext: requestContext2 }) => {
+          const codeTools = await originalTools({ requestContext: requestContext2 });
+          const resolvedToolsConfig = this.accumulateObjectVariants(
+            storedConfig.tools,
+            requestContext2.toJSON()
+          );
+          return this.applyStoredToolDescriptions(codeTools, resolvedToolsConfig);
+        };
+        fork.__setTools(toolsFn);
+      } else {
+        const codeTools = await fork.listTools();
+        fork.__setTools(
+          this.applyStoredToolDescriptions(
+            codeTools,
+            storedConfig.tools
+          )
+        );
+      }
     }
     if (storedConfig.resolvedVersionId) {
       const existing = fork.toRawConfig() ?? {};
@@ -1093,6 +1124,20 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       return resolveInstructionBlocks(blocks, context, { promptBlocksStorage: promptBlocksStore });
     };
   }
+  applyStoredToolDescriptions(codeTools, storedTools) {
+    if (!storedTools || Array.isArray(storedTools)) {
+      return codeTools;
+    }
+    let nextTools;
+    for (const [toolKey, toolConfig] of Object.entries(storedTools)) {
+      if (!toolConfig.description || !(toolKey in codeTools)) {
+        continue;
+      }
+      nextTools ?? (nextTools = { ...codeTools });
+      nextTools[toolKey] = { ...codeTools[toolKey], description: toolConfig.description };
+    }
+    return nextTools ?? codeTools;
+  }
   /**
    * Resolve stored tool IDs to actual tool instances from Mastra's registry.
    * Applies description overrides from per-tool config when present.
@@ -2207,6 +2252,8 @@ var MastraEditor = class {
     this.__logger = config?.logger;
     this.__toolProviders = config?.toolProviders ?? {};
     this.__processorProviders = { ...BUILT_IN_PROCESSOR_PROVIDERS, ...config?.processorProviders };
+    this.__source = config?.source;
+    this.__codePath = config?.codePath ?? "./mastra/editor";
     this.__filesystems = /* @__PURE__ */ new Map();
     this.__filesystems.set(localFilesystemProvider.id, localFilesystemProvider);
     for (const [id, provider] of Object.entries(config?.filesystems ?? {})) {
@@ -2244,6 +2291,21 @@ var MastraEditor = class {
     if (!this.__logger) {
       this.__logger = mastra.getLogger();
     }
+    if (this.__source === "code") {
+      const filesystemStore = new FilesystemStore({ dir: this.__codePath });
+      const existingStorage = mastra.getStorage();
+      if (existingStorage) {
+        mastra.setStorage(
+          new MastraCompositeStore({
+            id: `${existingStorage.id}-with-editor-filesystem`,
+            default: existingStorage,
+            editor: filesystemStore
+          })
+        );
+      } else {
+        mastra.setStorage(filesystemStore);
+      }
+    }
     this.ensureBuilderWorkspaces().then(() => this.reconcileBuilderWorkspaces()).catch((err) => {
       this.__logger?.warn("[MastraEditor] Failed to persist/reconcile builder workspaces on startup", {
         error: err
@@ -2392,6 +2454,10 @@ var MastraEditor = class {
       );
     }
   }
+  /** Returns the editor's configured source, or undefined if unset. */
+  getSource() {
+    return this.__source;
+  }
   /** Registered tool providers */
   getToolProvider(id) {
     return this.__toolProviders[id];