@mastra/editor 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,153 @@
 # @mastra/editor
 
+## 0.6.0
+
+### Minor Changes
+
+- Added Processor Providers — a new system for configuring and hydrating processors on stored agents. Define custom processor types with config schemas, available phases, and a factory method, then compose them into serializable processor graphs that support sequential, parallel, and conditional execution. ([#13219](https://github.com/mastra-ai/mastra/pull/13219))
+
+  **Example — custom processor provider:**
+
+  ```ts
+  import { MastraEditor } from '@mastra/editor';
+
+  // Built-in processors (token-limiter, unicode-normalizer, etc.) are registered automatically.
+  // Only register custom providers for your own processors:
+  const editor = new MastraEditor({
+    processorProviders: {
+      'my-custom-filter': myCustomFilterProvider,
+    },
+  });
+  ```
+
+  **Example — stored agent with a processor graph:**
+
+  ```ts
+  const agentConfig = {
+    inputProcessors: {
+      steps: [
+        {
+          type: 'step',
+          step: { id: 'norm', providerId: 'unicode-normalizer', config: {}, enabledPhases: ['processInput'] },
+        },
+        {
+          type: 'step',
+          step: {
+            id: 'limit',
+            providerId: 'token-limiter',
+            config: { limit: 4000 },
+            enabledPhases: ['processInput', 'processOutputStream'],
+          },
+        },
+      ],
+    },
+  };
+  ```
+
+- Added MCP server storage and editor support. MCP server configurations can now be persisted in storage and managed through the editor CMS. The editor's `mcpServer` namespace provides full CRUD operations and automatically hydrates stored configs into running `MCPServer` instances by resolving tool, agent, and workflow references from the Mastra registry. ([#13285](https://github.com/mastra-ai/mastra/pull/13285))
+
+  ```ts
+  const editor = new MastraEditor();
+  const mastra = new Mastra({
+    tools: { getWeather: weatherTool, calculate: calculatorTool },
+    storage: new LibSQLStore({ url: ':memory:' }),
+    editor,
+  });
+
+  // Store an MCP server config referencing tools by ID
+  const server = await editor.mcpServer.create({
+    id: 'my-server',
+    name: 'My MCP Server',
+    version: '1.0.0',
+    tools: { getWeather: {}, calculate: { description: 'Custom description' } },
+  });
+
+  // Retrieve — automatically hydrates into a real MCPServer with resolved tools
+  const mcp = await editor.mcpServer.getById('my-server');
+  const tools = mcp.tools(); // { getWeather: ..., calculate: ... }
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`0d9efb4`](https://github.com/mastra-ai/mastra/commit/0d9efb47992c34aa90581c18b9f51f774f6252a5), [`7184d87`](https://github.com/mastra-ai/mastra/commit/7184d87c9237d26862f500ccfd0c9f9eadd38ddf), [`5caa13d`](https://github.com/mastra-ai/mastra/commit/5caa13d1b2a496e2565ab124a11de9a51ad3e3b9), [`270dd16`](https://github.com/mastra-ai/mastra/commit/270dd168a86698a699d8a9de8dbce1a40f72d862), [`940163f`](https://github.com/mastra-ai/mastra/commit/940163fc492401d7562301e6f106ccef4fefe06f), [`b260123`](https://github.com/mastra-ai/mastra/commit/b2601234bd093d358c92081a58f9b0befdae52b3), [`47892c8`](https://github.com/mastra-ai/mastra/commit/47892c85708eac348209f99f10f9a5f5267e11c0), [`45bb78b`](https://github.com/mastra-ai/mastra/commit/45bb78b70bd9db29678fe49476cd9f4ed01bfd0b), [`70eef84`](https://github.com/mastra-ai/mastra/commit/70eef84b8f44493598fdafa2980a0e7283415eda), [`d84e52d`](https://github.com/mastra-ai/mastra/commit/d84e52d0f6511283ddd21ed5fe7f945449d0f799), [`24b80af`](https://github.com/mastra-ai/mastra/commit/24b80af87da93bb84d389340181e17b7477fa9ca), [`608e156`](https://github.com/mastra-ai/mastra/commit/608e156def954c9604c5e3f6d9dfce3bcc7aeab0), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`2b2e157`](https://github.com/mastra-ai/mastra/commit/2b2e157a092cd597d9d3f0000d62b8bb4a7348ed), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`59d30b5`](https://github.com/mastra-ai/mastra/commit/59d30b5d0cb44ea7a1c440e7460dfb57eac9a9b5), [`453693b`](https://github.com/mastra-ai/mastra/commit/453693bf9e265ddccecef901d50da6caaea0fbc6), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`c204b63`](https://github.com/mastra-ai/mastra/commit/c204b632d19e66acb6d6e19b11c4540dd6ad5380), [`742a417`](https://github.com/mastra-ai/mastra/commit/742a417896088220a3b5560c354c45c5ca6d88b9)]:
+  - @mastra/core@1.6.0
+  - @mastra/schema-compat@1.1.2
+  - @mastra/memory@1.5.0
+
+## 0.6.0-alpha.0
+
+### Minor Changes
+
+- Added Processor Providers — a new system for configuring and hydrating processors on stored agents. Define custom processor types with config schemas, available phases, and a factory method, then compose them into serializable processor graphs that support sequential, parallel, and conditional execution. ([#13219](https://github.com/mastra-ai/mastra/pull/13219))
+
+  **Example — custom processor provider:**
+
+  ```ts
+  import { MastraEditor } from '@mastra/editor';
+
+  // Built-in processors (token-limiter, unicode-normalizer, etc.) are registered automatically.
+  // Only register custom providers for your own processors:
+  const editor = new MastraEditor({
+    processorProviders: {
+      'my-custom-filter': myCustomFilterProvider,
+    },
+  });
+  ```
+
+  **Example — stored agent with a processor graph:**
+
+  ```ts
+  const agentConfig = {
+    inputProcessors: {
+      steps: [
+        {
+          type: 'step',
+          step: { id: 'norm', providerId: 'unicode-normalizer', config: {}, enabledPhases: ['processInput'] },
+        },
+        {
+          type: 'step',
+          step: {
+            id: 'limit',
+            providerId: 'token-limiter',
+            config: { limit: 4000 },
+            enabledPhases: ['processInput', 'processOutputStream'],
+          },
+        },
+      ],
+    },
+  };
+  ```
+
+- Added MCP server storage and editor support. MCP server configurations can now be persisted in storage and managed through the editor CMS. The editor's `mcpServer` namespace provides full CRUD operations and automatically hydrates stored configs into running `MCPServer` instances by resolving tool, agent, and workflow references from the Mastra registry. ([#13285](https://github.com/mastra-ai/mastra/pull/13285))
+
+  ```ts
+  const editor = new MastraEditor();
+  const mastra = new Mastra({
+    tools: { getWeather: weatherTool, calculate: calculatorTool },
+    storage: new LibSQLStore({ url: ':memory:' }),
+    editor,
+  });
+
+  // Store an MCP server config referencing tools by ID
+  const server = await editor.mcpServer.create({
+    id: 'my-server',
+    name: 'My MCP Server',
+    version: '1.0.0',
+    tools: { getWeather: {}, calculate: { description: 'Custom description' } },
+  });
+
+  // Retrieve — automatically hydrates into a real MCPServer with resolved tools
+  const mcp = await editor.mcpServer.getById('my-server');
+  const tools = mcp.tools(); // { getWeather: ..., calculate: ... }
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`0d9efb4`](https://github.com/mastra-ai/mastra/commit/0d9efb47992c34aa90581c18b9f51f774f6252a5), [`7184d87`](https://github.com/mastra-ai/mastra/commit/7184d87c9237d26862f500ccfd0c9f9eadd38ddf), [`5caa13d`](https://github.com/mastra-ai/mastra/commit/5caa13d1b2a496e2565ab124a11de9a51ad3e3b9), [`270dd16`](https://github.com/mastra-ai/mastra/commit/270dd168a86698a699d8a9de8dbce1a40f72d862), [`940163f`](https://github.com/mastra-ai/mastra/commit/940163fc492401d7562301e6f106ccef4fefe06f), [`b260123`](https://github.com/mastra-ai/mastra/commit/b2601234bd093d358c92081a58f9b0befdae52b3), [`47892c8`](https://github.com/mastra-ai/mastra/commit/47892c85708eac348209f99f10f9a5f5267e11c0), [`45bb78b`](https://github.com/mastra-ai/mastra/commit/45bb78b70bd9db29678fe49476cd9f4ed01bfd0b), [`70eef84`](https://github.com/mastra-ai/mastra/commit/70eef84b8f44493598fdafa2980a0e7283415eda), [`d84e52d`](https://github.com/mastra-ai/mastra/commit/d84e52d0f6511283ddd21ed5fe7f945449d0f799), [`24b80af`](https://github.com/mastra-ai/mastra/commit/24b80af87da93bb84d389340181e17b7477fa9ca), [`608e156`](https://github.com/mastra-ai/mastra/commit/608e156def954c9604c5e3f6d9dfce3bcc7aeab0), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`2b2e157`](https://github.com/mastra-ai/mastra/commit/2b2e157a092cd597d9d3f0000d62b8bb4a7348ed), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`59d30b5`](https://github.com/mastra-ai/mastra/commit/59d30b5d0cb44ea7a1c440e7460dfb57eac9a9b5), [`453693b`](https://github.com/mastra-ai/mastra/commit/453693bf9e265ddccecef901d50da6caaea0fbc6), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`c204b63`](https://github.com/mastra-ai/mastra/commit/c204b632d19e66acb6d6e19b11c4540dd6ad5380), [`742a417`](https://github.com/mastra-ai/mastra/commit/742a417896088220a3b5560c354c45c5ca6d88b9)]:
+  - @mastra/core@1.6.0-alpha.0
+  - @mastra/schema-compat@1.1.2-alpha.0
+  - @mastra/memory@1.5.0-alpha.0
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(index_exports, {
   CrudEditorNamespace: () => CrudEditorNamespace,
   EditorAgentNamespace: () => EditorAgentNamespace,
   EditorMCPNamespace: () => EditorMCPNamespace,
+  EditorMCPServerNamespace: () => EditorMCPServerNamespace,
   EditorNamespace: () => EditorNamespace,
   EditorPromptNamespace: () => EditorPromptNamespace,
   EditorScorerNamespace: () => EditorScorerNamespace,
@@ -46,6 +47,7 @@ __export(index_exports, {
   resolveInstructionBlocks: () => resolveInstructionBlocks
 });
 module.exports = __toCommonJS(index_exports);
+var import_processor_provider2 = require("@mastra/core/processor-provider");
 
 // src/namespaces/base.ts
 var EditorNamespace = class {
@@ -336,6 +338,177 @@ async function resolveInstructionBlocks(blocks, context, deps) {
   return segments.join("\n\n");
 }
 
+// src/processor-graph-hydrator.ts
+var import_processors = require("@mastra/core/processors");
+var import_processor_provider = require("@mastra/core/processor-provider");
+var import_workflows = require("@mastra/core/workflows");
+var PASSTHROUGH_STEP_PREFIX = "passthrough-";
+function resolveStep(step, ctx) {
+  const provider = ctx.providers[step.providerId];
+  if (!provider) {
+    ctx.logger?.warn(`ProcessorProvider "${step.providerId}" not found for graph step "${step.id}"`);
+    return void 0;
+  }
+  const processor = provider.createProcessor(step.config);
+  const allProviderPhases = provider.availablePhases;
+  const enabledSet = new Set(step.enabledPhases);
+  const needsFiltering = allProviderPhases.some((p) => !enabledSet.has(p));
+  if (needsFiltering) {
+    const filtered = new import_processor_provider.PhaseFilteredProcessor(processor, step.enabledPhases);
+    if (ctx.mastra) {
+      filtered.__registerMastra(ctx.mastra);
+    }
+    return filtered;
+  }
+  if (ctx.mastra && processor.__registerMastra) {
+    processor.__registerMastra(ctx.mastra);
+  }
+  return processor;
+}
+function isSequentialOnly(entries) {
+  return entries.every((e) => e.type === "step");
+}
+function hydrateSequential(entries, ctx) {
+  const processors = [];
+  for (const entry of entries) {
+    if (entry.type !== "step") continue;
+    const processor = resolveStep(entry.step, ctx);
+    if (processor) {
+      processors.push(processor);
+    }
+  }
+  return processors;
+}
+async function mergeBranchOutputs({ inputData }) {
+  const keys = Object.keys(inputData).sort((a, b) => {
+    const aPass = a.startsWith(PASSTHROUGH_STEP_PREFIX) ? 1 : 0;
+    const bPass = b.startsWith(PASSTHROUGH_STEP_PREFIX) ? 1 : 0;
+    return aPass - bPass;
+  });
+  for (const key of keys) {
+    const val = inputData[key];
+    if (val && typeof val === "object" && "phase" in val) {
+      return {
+        phase: val.phase,
+        messages: val.messages,
+        messageList: val.messageList,
+        ...val.systemMessages ? { systemMessages: val.systemMessages } : {},
+        ...val.part !== void 0 ? { part: val.part } : {},
+        ...val.streamParts ? { streamParts: val.streamParts } : {},
+        ...val.state ? { state: val.state } : {},
+        ...val.text !== void 0 ? { text: val.text } : {},
+        ...val.retryCount !== void 0 ? { retryCount: val.retryCount } : {}
+      };
+    }
+  }
+  return inputData;
+}
+function buildWorkflow(entries, workflowId, ctx) {
+  let workflow = (0, import_workflows.createWorkflow)({
+    id: workflowId,
+    inputSchema: import_processors.ProcessorStepSchema,
+    outputSchema: import_processors.ProcessorStepSchema,
+    type: "processor",
+    options: {
+      validateInputs: false
+    }
+  });
+  let hasSteps = false;
+  for (const entry of entries) {
+    if (entry.type === "step") {
+      const processor = resolveStep(entry.step, ctx);
+      if (!processor) continue;
+      const step = (0, import_workflows.createStep)(processor);
+      workflow = workflow.then(step);
+      hasSteps = true;
+    } else if (entry.type === "parallel") {
+      const branchSteps = entry.branches.map((branchEntries, branchIdx) => {
+        if (branchEntries.length === 1 && branchEntries[0].type === "step") {
+          const proc = resolveStep(branchEntries[0].step, ctx);
+          if (!proc) return void 0;
+          return (0, import_workflows.createStep)(proc);
+        }
+        const subWorkflow = buildWorkflow(branchEntries, `${workflowId}-parallel-branch-${branchIdx}`, ctx);
+        return subWorkflow;
+      }).filter(Boolean);
+      if (branchSteps.length > 0) {
+        workflow = workflow.parallel(branchSteps);
+        workflow = workflow.map(mergeBranchOutputs);
+        hasSteps = true;
+      }
+    } else if (entry.type === "conditional") {
+      const branchTuples = [];
+      for (const [i, condition] of entry.conditions.entries()) {
+        let branchStep;
+        if (condition.steps.length === 1 && condition.steps[0].type === "step") {
+          const proc = resolveStep(condition.steps[0].step, ctx);
+          if (!proc) continue;
+          branchStep = (0, import_workflows.createStep)(proc);
+        } else {
+          branchStep = buildWorkflow(condition.steps, `${workflowId}-cond-branch-${i}`, ctx);
+          if (!branchStep) continue;
+        }
+        if (condition.rules) {
+          const rules = condition.rules;
+          const conditionFn = async ({ inputData }) => {
+            return evaluateRuleGroup(rules, inputData);
+          };
+          branchTuples.push([conditionFn, branchStep]);
+        } else {
+          branchTuples.push([async () => true, branchStep]);
+        }
+      }
+      if (branchTuples.length > 0) {
+        const passthroughStep = (0, import_workflows.createStep)({
+          id: `${PASSTHROUGH_STEP_PREFIX}${workflowId}`,
+          inputSchema: import_processors.ProcessorStepSchema,
+          outputSchema: import_processors.ProcessorStepSchema,
+          execute: async ({ inputData }) => inputData
+        });
+        branchTuples.push([async () => true, passthroughStep]);
+        workflow = workflow.branch(branchTuples);
+        workflow = workflow.map(mergeBranchOutputs);
+        hasSteps = true;
+      }
+    }
+  }
+  if (!hasSteps) return void 0;
+  return workflow.commit();
+}
+function hydrateProcessorGraph(graph, mode, ctx) {
+  if (!graph) return void 0;
+  if (Array.isArray(graph)) {
+    ctx.logger?.warn(
+      "Processor graph is in legacy string[] format and cannot be hydrated. Re-save the agent to migrate."
+    );
+    return void 0;
+  }
+  if (!Array.isArray(graph.steps) || graph.steps.length === 0) return void 0;
+  if (isSequentialOnly(graph.steps)) {
+    const processors = hydrateSequential(graph.steps, ctx);
+    if (processors.length === 0) return void 0;
+    if (mode === "input") {
+      const filtered = processors.filter((p) => p.processInput || p.processInputStep);
+      return filtered.length > 0 ? filtered : void 0;
+    } else {
+      const filtered = processors.filter((p) => p.processOutputStream || p.processOutputResult || p.processOutputStep);
+      return filtered.length > 0 ? filtered : void 0;
+    }
+  }
+  const workflowId = `stored-${mode}-processor-graph`;
+  const workflow = buildWorkflow(graph.steps, workflowId, ctx);
+  if (!workflow) return void 0;
+  return [workflow];
+}
+function selectFirstMatchingGraph(variants, context) {
+  for (const variant of variants) {
+    if (!variant.rules || evaluateRuleGroup(variant.rules, context)) {
+      return variant.value;
+    }
+  }
+  return void 0;
+}
+
 // src/namespaces/mcp.ts
 var EditorMCPNamespace = class _EditorMCPNamespace extends CrudEditorNamespace {
   onCacheEvict(_id) {
@@ -580,22 +753,24 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       );
       return this.resolveStoredScorers(resolved);
     } : await this.resolveStoredScorers(storedAgent.scorers);
+    const processorProviders = this.editor.getProcessorProviders();
+    const hydrationCtx = { providers: processorProviders, mastra: this.mastra, logger: this.logger };
     const inputProcessors = hasConditionalInputProcessors ? ({ requestContext }) => {
       const ctx = requestContext.toJSON();
-      const resolved = this.accumulateArrayVariants(
+      const graph = selectFirstMatchingGraph(
         storedAgent.inputProcessors,
         ctx
       );
-      return this.resolveStoredInputProcessors(resolved);
-    } : this.resolveStoredInputProcessors(storedAgent.inputProcessors);
+      return hydrateProcessorGraph(graph, "input", hydrationCtx);
+    } : hydrateProcessorGraph(storedAgent.inputProcessors, "input", hydrationCtx);
     const outputProcessors = hasConditionalOutputProcessors ? ({ requestContext }) => {
       const ctx = requestContext.toJSON();
-      const resolved = this.accumulateArrayVariants(
+      const graph = selectFirstMatchingGraph(
         storedAgent.outputProcessors,
         ctx
       );
-      return this.resolveStoredOutputProcessors(resolved);
-    } : this.resolveStoredOutputProcessors(storedAgent.outputProcessors);
+      return hydrateProcessorGraph(graph, "output", hydrationCtx);
+    } : hydrateProcessorGraph(storedAgent.outputProcessors, "output", hydrationCtx);
     let model;
     let staticModelConfig;
     const modelSettingsFrom = (cfg) => ({
@@ -985,41 +1160,6 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     }
     return Object.keys(resolvedScorers).length > 0 ? resolvedScorers : void 0;
   }
-  findProcessor(processorKey) {
-    if (!this.mastra) return void 0;
-    try {
-      return this.mastra.getProcessor(processorKey);
-    } catch {
-      try {
-        return this.mastra.getProcessorById(processorKey);
-      } catch {
-        this.logger?.warn(`Processor "${processorKey}" referenced in stored agent but not registered in Mastra`);
-        return void 0;
-      }
-    }
-  }
-  resolveStoredInputProcessors(storedProcessors) {
-    if (!storedProcessors || storedProcessors.length === 0) return void 0;
-    const resolved = [];
-    for (const key of storedProcessors) {
-      const processor = this.findProcessor(key);
-      if (processor && (processor.processInput || processor.processInputStep)) {
-        resolved.push(processor);
-      }
-    }
-    return resolved.length > 0 ? resolved : void 0;
-  }
-  resolveStoredOutputProcessors(storedProcessors) {
-    if (!storedProcessors || storedProcessors.length === 0) return void 0;
-    const resolved = [];
-    for (const key of storedProcessors) {
-      const processor = this.findProcessor(key);
-      if (processor && (processor.processOutputStream || processor.processOutputResult || processor.processOutputStep)) {
-        resolved.push(processor);
-      }
-    }
-    return resolved.length > 0 ? resolved : void 0;
-  }
   // ============================================================================
   // Clone
   // ============================================================================
@@ -1067,9 +1207,6 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     const agentKeys = Object.keys(agentsResolved || {});
     const memory = await agent.getMemory({ requestContext });
     const memoryConfig = memory?.getConfig();
-    const { inputProcessorIds, outputProcessorIds } = await agent.getConfiguredProcessorIds(requestContext);
-    const inputProcessorKeys = inputProcessorIds.length > 0 ? inputProcessorIds : void 0;
-    const outputProcessorKeys = outputProcessorIds.length > 0 ? outputProcessorIds : void 0;
     let storedScorers;
     const resolvedScorers = await agent.listScorers({ requestContext });
     if (resolvedScorers && Object.keys(resolvedScorers).length > 0) {
@@ -1104,8 +1241,6 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       workflows: workflowKeys.length > 0 ? Object.fromEntries(workflowKeys.map((key) => [key, {}])) : void 0,
       agents: agentKeys.length > 0 ? Object.fromEntries(agentKeys.map((key) => [key, {}])) : void 0,
       memory: memoryConfig,
-      inputProcessors: inputProcessorKeys,
-      outputProcessors: outputProcessorKeys,
       scorers: storedScorers,
       defaultOptions: storageDefaultOptions,
       metadata: options.metadata,
@@ -1220,6 +1355,112 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
   }
 };
 
+// src/namespaces/mcp-server.ts
+var EditorMCPServerNamespace = class extends CrudEditorNamespace {
+  onCacheEvict(_id) {
+  }
+  async hydrate(resolved) {
+    if (!this.mastra) {
+      throw new Error("MastraEditor is not registered with a Mastra instance");
+    }
+    const tools = this.resolveStoredTools(resolved.tools);
+    const agents = this.resolveStoredAgents(resolved.agents);
+    const workflows = this.resolveStoredWorkflows(resolved.workflows);
+    if (!this.mcpServerCtor) {
+      try {
+        const mod = await import("@mastra/mcp");
+        this.mcpServerCtor = mod.MCPServer;
+      } catch {
+        throw new Error(
+          "@mastra/mcp is required to hydrate MCP server configurations. Install it with: npm install @mastra/mcp"
+        );
+      }
+    }
+    const server = new this.mcpServerCtor({
+      id: resolved.id,
+      name: resolved.name,
+      version: resolved.version,
+      description: resolved.description,
+      instructions: resolved.instructions,
+      repository: resolved.repository,
+      releaseDate: resolved.releaseDate,
+      isLatest: resolved.isLatest,
+      packageCanonical: resolved.packageCanonical,
+      tools,
+      agents,
+      workflows
+    });
+    this.mastra.addMCPServer(server, resolved.id);
+    return server;
+  }
+  resolveStoredTools(storedTools) {
+    if (!storedTools || Object.keys(storedTools).length === 0) return {};
+    if (!this.mastra) return {};
+    const resolved = {};
+    for (const [toolKey, toolConfig] of Object.entries(storedTools)) {
+      try {
+        const tool = this.mastra.getToolById(toolKey);
+        if (toolConfig.description) {
+          resolved[toolKey] = { ...tool, description: toolConfig.description };
+        } else {
+          resolved[toolKey] = tool;
+        }
+      } catch {
+        this.logger?.warn(`Tool "${toolKey}" referenced in stored MCP server but not registered in Mastra`);
+      }
+    }
+    return resolved;
+  }
+  resolveStoredAgents(storedAgents) {
+    if (!storedAgents || Object.keys(storedAgents).length === 0) return {};
+    if (!this.mastra) return {};
+    const resolved = {};
+    for (const agentKey of Object.keys(storedAgents)) {
+      try {
+        resolved[agentKey] = this.mastra.getAgent(agentKey);
+      } catch {
+        try {
+          resolved[agentKey] = this.mastra.getAgentById(agentKey);
+        } catch {
+          this.logger?.warn(`Agent "${agentKey}" referenced in stored MCP server but not registered in Mastra`);
+        }
+      }
+    }
+    return resolved;
+  }
+  resolveStoredWorkflows(storedWorkflows) {
+    if (!storedWorkflows || Object.keys(storedWorkflows).length === 0) return {};
+    if (!this.mastra) return {};
+    const resolved = {};
+    for (const workflowKey of Object.keys(storedWorkflows)) {
+      try {
+        resolved[workflowKey] = this.mastra.getWorkflow(workflowKey);
+      } catch {
+        try {
+          resolved[workflowKey] = this.mastra.getWorkflowById(workflowKey);
+        } catch {
+          this.logger?.warn(`Workflow "${workflowKey}" referenced in stored MCP server but not registered in Mastra`);
+        }
+      }
+    }
+    return resolved;
+  }
+  async getStorageAdapter() {
+    const storage = this.mastra?.getStorage();
+    if (!storage) throw new Error("Storage is not configured");
+    const store = await storage.getStore("mcpServers");
+    if (!store) throw new Error("MCP servers storage domain is not available");
+    return {
+      create: (input) => store.create({ mcpServer: input }),
+      getByIdResolved: (id) => store.getByIdResolved(id),
+      update: (input) => store.update(input),
+      delete: (id) => store.delete(id),
+      list: (args) => store.list(args),
+      listResolved: (args) => store.listResolved(args)
+    };
+  }
+};
+
 // src/namespaces/prompt.ts
 var EditorPromptNamespace = class extends CrudEditorNamespace {
   onCacheEvict(id) {
@@ -1578,6 +1819,7 @@ var MastraEditor = class {
   constructor(config) {
     this.__logger = config?.logger;
     this.__toolProviders = config?.toolProviders ?? {};
+    this.__processorProviders = { ...import_processor_provider2.BUILT_IN_PROCESSOR_PROVIDERS, ...config?.processorProviders };
     this.__filesystems = /* @__PURE__ */ new Map();
     this.__filesystems.set(localFilesystemProvider.id, localFilesystemProvider);
     for (const [id, provider] of Object.entries(config?.filesystems ?? {})) {
@@ -1594,6 +1836,7 @@ var MastraEditor = class {
     }
     this.agent = new EditorAgentNamespace(this);
     this.mcp = new EditorMCPNamespace(this);
+    this.mcpServer = new EditorMCPServerNamespace(this);
     this.prompt = new EditorPromptNamespace(this);
     this.scorer = new EditorScorerNamespace(this);
     this.workspace = new EditorWorkspaceNamespace(this);
@@ -1617,6 +1860,14 @@ var MastraEditor = class {
   getToolProviders() {
     return this.__toolProviders;
   }
+  /** Get a processor provider by ID */
+  getProcessorProvider(id) {
+    return this.__processorProviders[id];
+  }
+  /** List all registered processor providers */
+  getProcessorProviders() {
+    return this.__processorProviders;
+  }
   /** List all registered filesystem providers */
   getFilesystemProviders() {
     return Array.from(this.__filesystems.values());
@@ -1663,6 +1914,7 @@ var MastraEditor = class {
   CrudEditorNamespace,
   EditorAgentNamespace,
   EditorMCPNamespace,
+  EditorMCPServerNamespace,
   EditorNamespace,
   EditorPromptNamespace,
   EditorScorerNamespace,

package/dist/index.d.cts

@@ -2,10 +2,12 @@ import { Mastra } from '@mastra/core';
 import { GetByIdOptions, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, MastraEditorConfig } from '@mastra/core/editor';
 export { MastraEditorConfig } from '@mastra/core/editor';
 import { IMastraLogger } from '@mastra/core/logger';
-import { StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType, StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType, StorageMCPServerConfig, StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType, AgentInstructionBlock, StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType, StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType, StorageWorkspaceSnapshotType, StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType, RuleGroup, PromptBlocksStorage, BlobStore } from '@mastra/core/storage';
+import { ProcessorProvider } from '@mastra/core/processor-provider';
+import { StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType, StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType, StorageMCPServerConfig, StorageCreateMCPServerInput, StorageUpdateMCPServerInput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageResolvedMCPServerType, StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType, AgentInstructionBlock, StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType, StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType, StorageWorkspaceSnapshotType, StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType, RuleGroup, PromptBlocksStorage, BlobStore } from '@mastra/core/storage';
 import { ToolProvider } from '@mastra/core/tool-provider';
 import { Agent } from '@mastra/core/agent';
 import { RequestContext } from '@mastra/core/request-context';
+import { MCPServerBase } from '@mastra/core/mcp';
 import { MastraScorer } from '@mastra/core/evals';
 import { SkillSource, Workspace, WorkspaceFilesystem, WorkspaceSandbox } from '@mastra/core/workspace';
 
@@ -152,9 +154,6 @@ declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgen
     private resolveStoredAgents;
     private resolveStoredMemory;
     private resolveStoredScorers;
-    private findProcessor;
-    private resolveStoredInputProcessors;
-    private resolveStoredOutputProcessors;
     /**
      * Clone a runtime Agent instance into storage, creating a new stored agent
      * with the resolved configuration of the source agent.
@@ -208,6 +207,16 @@ declare class EditorMCPNamespace extends CrudEditorNamespace<StorageCreateMCPCli
     };
 }
 
+declare class EditorMCPServerNamespace extends CrudEditorNamespace<StorageCreateMCPServerInput, StorageUpdateMCPServerInput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageResolvedMCPServerType, MCPServerBase> {
+    private mcpServerCtor;
+    protected onCacheEvict(_id: string): void;
+    protected hydrate(resolved: StorageResolvedMCPServerType): Promise<MCPServerBase>;
+    private resolveStoredTools;
+    private resolveStoredAgents;
+    private resolveStoredWorkflows;
+    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateMCPServerInput, StorageUpdateMCPServerInput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageResolvedMCPServerType>>;
+}
+
 declare class EditorPromptNamespace extends CrudEditorNamespace<StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType> {
     protected onCacheEvict(id: string): void;
     protected getStorageAdapter(): Promise<StorageAdapter<StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType>>;
@@ -357,6 +366,7 @@ declare class MastraEditor implements IMastraEditor {
     /** @internal — exposed for namespace classes, not part of public API */
     __logger?: IMastraLogger;
     private __toolProviders;
+    private __processorProviders;
     /**
      * @internal — exposed for namespace classes to hydrate stored workspace configs.
      * Maps provider ID (e.g., 'local', 's3') to the provider descriptor.
@@ -378,6 +388,7 @@ declare class MastraEditor implements IMastraEditor {
     readonly __blobStores: Map<string, BlobStoreProvider>;
     readonly agent: EditorAgentNamespace;
     readonly mcp: EditorMCPNamespace;
+    readonly mcpServer: EditorMCPServerNamespace;
     readonly prompt: EditorPromptNamespace;
     readonly scorer: EditorScorerNamespace;
     readonly workspace: EditorWorkspaceNamespace;
@@ -392,6 +403,10 @@ declare class MastraEditor implements IMastraEditor {
     getToolProvider(id: string): ToolProvider | undefined;
     /** List all registered tool providers */
     getToolProviders(): Record<string, ToolProvider>;
+    /** Get a processor provider by ID */
+    getProcessorProvider(id: string): ProcessorProvider | undefined;
+    /** List all registered processor providers */
+    getProcessorProviders(): Record<string, ProcessorProvider>;
     /** List all registered filesystem providers */
     getFilesystemProviders(): FilesystemProvider[];
     /** List all registered sandbox providers */
@@ -411,4 +426,4 @@ declare class MastraEditor implements IMastraEditor {
     resolveBlobStore(providerId?: string, providerConfig?: Record<string, unknown>): Promise<BlobStore>;
 }
 
-export { CrudEditorNamespace, EditorAgentNamespace, EditorMCPNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };
+export { CrudEditorNamespace, EditorAgentNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };

package/dist/index.d.ts

@@ -2,10 +2,12 @@ import { Mastra } from '@mastra/core';
 import { GetByIdOptions, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, MastraEditorConfig } from '@mastra/core/editor';
 export { MastraEditorConfig } from '@mastra/core/editor';
 import { IMastraLogger } from '@mastra/core/logger';
-import { StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType, StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType, StorageMCPServerConfig, StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType, AgentInstructionBlock, StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType, StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType, StorageWorkspaceSnapshotType, StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType, RuleGroup, PromptBlocksStorage, BlobStore } from '@mastra/core/storage';
+import { ProcessorProvider } from '@mastra/core/processor-provider';
+import { StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType, StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType, StorageMCPServerConfig, StorageCreateMCPServerInput, StorageUpdateMCPServerInput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageResolvedMCPServerType, StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType, AgentInstructionBlock, StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType, StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType, StorageWorkspaceSnapshotType, StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType, RuleGroup, PromptBlocksStorage, BlobStore } from '@mastra/core/storage';
 import { ToolProvider } from '@mastra/core/tool-provider';
 import { Agent } from '@mastra/core/agent';
 import { RequestContext } from '@mastra/core/request-context';
+import { MCPServerBase } from '@mastra/core/mcp';
 import { MastraScorer } from '@mastra/core/evals';
 import { SkillSource, Workspace, WorkspaceFilesystem, WorkspaceSandbox } from '@mastra/core/workspace';
 
@@ -152,9 +154,6 @@ declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgen
     private resolveStoredAgents;
     private resolveStoredMemory;
     private resolveStoredScorers;
-    private findProcessor;
-    private resolveStoredInputProcessors;
-    private resolveStoredOutputProcessors;
     /**
      * Clone a runtime Agent instance into storage, creating a new stored agent
      * with the resolved configuration of the source agent.
@@ -208,6 +207,16 @@ declare class EditorMCPNamespace extends CrudEditorNamespace<StorageCreateMCPCli
     };
 }
 
+declare class EditorMCPServerNamespace extends CrudEditorNamespace<StorageCreateMCPServerInput, StorageUpdateMCPServerInput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageResolvedMCPServerType, MCPServerBase> {
+    private mcpServerCtor;
+    protected onCacheEvict(_id: string): void;
+    protected hydrate(resolved: StorageResolvedMCPServerType): Promise<MCPServerBase>;
+    private resolveStoredTools;
+    private resolveStoredAgents;
+    private resolveStoredWorkflows;
+    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateMCPServerInput, StorageUpdateMCPServerInput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageResolvedMCPServerType>>;
+}
+
 declare class EditorPromptNamespace extends CrudEditorNamespace<StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType> {
     protected onCacheEvict(id: string): void;
     protected getStorageAdapter(): Promise<StorageAdapter<StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType>>;
@@ -357,6 +366,7 @@ declare class MastraEditor implements IMastraEditor {
     /** @internal — exposed for namespace classes, not part of public API */
     __logger?: IMastraLogger;
     private __toolProviders;
+    private __processorProviders;
     /**
      * @internal — exposed for namespace classes to hydrate stored workspace configs.
      * Maps provider ID (e.g., 'local', 's3') to the provider descriptor.
@@ -378,6 +388,7 @@ declare class MastraEditor implements IMastraEditor {
     readonly __blobStores: Map<string, BlobStoreProvider>;
     readonly agent: EditorAgentNamespace;
     readonly mcp: EditorMCPNamespace;
+    readonly mcpServer: EditorMCPServerNamespace;
     readonly prompt: EditorPromptNamespace;
     readonly scorer: EditorScorerNamespace;
     readonly workspace: EditorWorkspaceNamespace;
@@ -392,6 +403,10 @@ declare class MastraEditor implements IMastraEditor {
     getToolProvider(id: string): ToolProvider | undefined;
     /** List all registered tool providers */
     getToolProviders(): Record<string, ToolProvider>;
+    /** Get a processor provider by ID */
+    getProcessorProvider(id: string): ProcessorProvider | undefined;
+    /** List all registered processor providers */
+    getProcessorProviders(): Record<string, ProcessorProvider>;
     /** List all registered filesystem providers */
     getFilesystemProviders(): FilesystemProvider[];
     /** List all registered sandbox providers */
@@ -411,4 +426,4 @@ declare class MastraEditor implements IMastraEditor {
     resolveBlobStore(providerId?: string, providerConfig?: Record<string, unknown>): Promise<BlobStore>;
 }
 
-export { CrudEditorNamespace, EditorAgentNamespace, EditorMCPNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };
+export { CrudEditorNamespace, EditorAgentNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/index.ts
+import { BUILT_IN_PROCESSOR_PROVIDERS } from "@mastra/core/processor-provider";
+
 // src/namespaces/base.ts
 var EditorNamespace = class {
   constructor(editor) {
@@ -287,6 +290,177 @@ async function resolveInstructionBlocks(blocks, context, deps) {
   return segments.join("\n\n");
 }
 
+// src/processor-graph-hydrator.ts
+import { ProcessorStepSchema } from "@mastra/core/processors";
+import { PhaseFilteredProcessor } from "@mastra/core/processor-provider";
+import { createWorkflow, createStep } from "@mastra/core/workflows";
+var PASSTHROUGH_STEP_PREFIX = "passthrough-";
+function resolveStep(step, ctx) {
+  const provider = ctx.providers[step.providerId];
+  if (!provider) {
+    ctx.logger?.warn(`ProcessorProvider "${step.providerId}" not found for graph step "${step.id}"`);
+    return void 0;
+  }
+  const processor = provider.createProcessor(step.config);
+  const allProviderPhases = provider.availablePhases;
+  const enabledSet = new Set(step.enabledPhases);
+  const needsFiltering = allProviderPhases.some((p) => !enabledSet.has(p));
+  if (needsFiltering) {
+    const filtered = new PhaseFilteredProcessor(processor, step.enabledPhases);
+    if (ctx.mastra) {
+      filtered.__registerMastra(ctx.mastra);
+    }
+    return filtered;
+  }
+  if (ctx.mastra && processor.__registerMastra) {
+    processor.__registerMastra(ctx.mastra);
+  }
+  return processor;
+}
+function isSequentialOnly(entries) {
+  return entries.every((e) => e.type === "step");
+}
+function hydrateSequential(entries, ctx) {
+  const processors = [];
+  for (const entry of entries) {
+    if (entry.type !== "step") continue;
+    const processor = resolveStep(entry.step, ctx);
+    if (processor) {
+      processors.push(processor);
+    }
+  }
+  return processors;
+}
+async function mergeBranchOutputs({ inputData }) {
+  const keys = Object.keys(inputData).sort((a, b) => {
+    const aPass = a.startsWith(PASSTHROUGH_STEP_PREFIX) ? 1 : 0;
+    const bPass = b.startsWith(PASSTHROUGH_STEP_PREFIX) ? 1 : 0;
+    return aPass - bPass;
+  });
+  for (const key of keys) {
+    const val = inputData[key];
+    if (val && typeof val === "object" && "phase" in val) {
+      return {
+        phase: val.phase,
+        messages: val.messages,
+        messageList: val.messageList,
+        ...val.systemMessages ? { systemMessages: val.systemMessages } : {},
+        ...val.part !== void 0 ? { part: val.part } : {},
+        ...val.streamParts ? { streamParts: val.streamParts } : {},
+        ...val.state ? { state: val.state } : {},
+        ...val.text !== void 0 ? { text: val.text } : {},
+        ...val.retryCount !== void 0 ? { retryCount: val.retryCount } : {}
+      };
+    }
+  }
+  return inputData;
+}
+function buildWorkflow(entries, workflowId, ctx) {
+  let workflow = createWorkflow({
+    id: workflowId,
+    inputSchema: ProcessorStepSchema,
+    outputSchema: ProcessorStepSchema,
+    type: "processor",
+    options: {
+      validateInputs: false
+    }
+  });
+  let hasSteps = false;
+  for (const entry of entries) {
+    if (entry.type === "step") {
+      const processor = resolveStep(entry.step, ctx);
+      if (!processor) continue;
+      const step = createStep(processor);
+      workflow = workflow.then(step);
+      hasSteps = true;
+    } else if (entry.type === "parallel") {
+      const branchSteps = entry.branches.map((branchEntries, branchIdx) => {
+        if (branchEntries.length === 1 && branchEntries[0].type === "step") {
+          const proc = resolveStep(branchEntries[0].step, ctx);
+          if (!proc) return void 0;
+          return createStep(proc);
+        }
+        const subWorkflow = buildWorkflow(branchEntries, `${workflowId}-parallel-branch-${branchIdx}`, ctx);
+        return subWorkflow;
+      }).filter(Boolean);
+      if (branchSteps.length > 0) {
+        workflow = workflow.parallel(branchSteps);
+        workflow = workflow.map(mergeBranchOutputs);
+        hasSteps = true;
+      }
+    } else if (entry.type === "conditional") {
+      const branchTuples = [];
+      for (const [i, condition] of entry.conditions.entries()) {
+        let branchStep;
+        if (condition.steps.length === 1 && condition.steps[0].type === "step") {
+          const proc = resolveStep(condition.steps[0].step, ctx);
+          if (!proc) continue;
+          branchStep = createStep(proc);
+        } else {
+          branchStep = buildWorkflow(condition.steps, `${workflowId}-cond-branch-${i}`, ctx);
+          if (!branchStep) continue;
+        }
+        if (condition.rules) {
+          const rules = condition.rules;
+          const conditionFn = async ({ inputData }) => {
+            return evaluateRuleGroup(rules, inputData);
+          };
+          branchTuples.push([conditionFn, branchStep]);
+        } else {
+          branchTuples.push([async () => true, branchStep]);
+        }
+      }
+      if (branchTuples.length > 0) {
+        const passthroughStep = createStep({
+          id: `${PASSTHROUGH_STEP_PREFIX}${workflowId}`,
+          inputSchema: ProcessorStepSchema,
+          outputSchema: ProcessorStepSchema,
+          execute: async ({ inputData }) => inputData
+        });
+        branchTuples.push([async () => true, passthroughStep]);
+        workflow = workflow.branch(branchTuples);
+        workflow = workflow.map(mergeBranchOutputs);
+        hasSteps = true;
+      }
+    }
+  }
+  if (!hasSteps) return void 0;
+  return workflow.commit();
+}
+function hydrateProcessorGraph(graph, mode, ctx) {
+  if (!graph) return void 0;
+  if (Array.isArray(graph)) {
+    ctx.logger?.warn(
+      "Processor graph is in legacy string[] format and cannot be hydrated. Re-save the agent to migrate."
+    );
+    return void 0;
+  }
+  if (!Array.isArray(graph.steps) || graph.steps.length === 0) return void 0;
+  if (isSequentialOnly(graph.steps)) {
+    const processors = hydrateSequential(graph.steps, ctx);
+    if (processors.length === 0) return void 0;
+    if (mode === "input") {
+      const filtered = processors.filter((p) => p.processInput || p.processInputStep);
+      return filtered.length > 0 ? filtered : void 0;
+    } else {
+      const filtered = processors.filter((p) => p.processOutputStream || p.processOutputResult || p.processOutputStep);
+      return filtered.length > 0 ? filtered : void 0;
+    }
+  }
+  const workflowId = `stored-${mode}-processor-graph`;
+  const workflow = buildWorkflow(graph.steps, workflowId, ctx);
+  if (!workflow) return void 0;
+  return [workflow];
+}
+function selectFirstMatchingGraph(variants, context) {
+  for (const variant of variants) {
+    if (!variant.rules || evaluateRuleGroup(variant.rules, context)) {
+      return variant.value;
+    }
+  }
+  return void 0;
+}
+
 // src/namespaces/mcp.ts
 var EditorMCPNamespace = class _EditorMCPNamespace extends CrudEditorNamespace {
   onCacheEvict(_id) {
@@ -531,22 +705,24 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       );
       return this.resolveStoredScorers(resolved);
     } : await this.resolveStoredScorers(storedAgent.scorers);
+    const processorProviders = this.editor.getProcessorProviders();
+    const hydrationCtx = { providers: processorProviders, mastra: this.mastra, logger: this.logger };
     const inputProcessors = hasConditionalInputProcessors ? ({ requestContext }) => {
       const ctx = requestContext.toJSON();
-      const resolved = this.accumulateArrayVariants(
+      const graph = selectFirstMatchingGraph(
         storedAgent.inputProcessors,
         ctx
       );
-      return this.resolveStoredInputProcessors(resolved);
-    } : this.resolveStoredInputProcessors(storedAgent.inputProcessors);
+      return hydrateProcessorGraph(graph, "input", hydrationCtx);
+    } : hydrateProcessorGraph(storedAgent.inputProcessors, "input", hydrationCtx);
     const outputProcessors = hasConditionalOutputProcessors ? ({ requestContext }) => {
       const ctx = requestContext.toJSON();
-      const resolved = this.accumulateArrayVariants(
+      const graph = selectFirstMatchingGraph(
         storedAgent.outputProcessors,
         ctx
       );
-      return this.resolveStoredOutputProcessors(resolved);
-    } : this.resolveStoredOutputProcessors(storedAgent.outputProcessors);
+      return hydrateProcessorGraph(graph, "output", hydrationCtx);
+    } : hydrateProcessorGraph(storedAgent.outputProcessors, "output", hydrationCtx);
     let model;
     let staticModelConfig;
     const modelSettingsFrom = (cfg) => ({
@@ -936,41 +1112,6 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     }
     return Object.keys(resolvedScorers).length > 0 ? resolvedScorers : void 0;
   }
-  findProcessor(processorKey) {
-    if (!this.mastra) return void 0;
-    try {
-      return this.mastra.getProcessor(processorKey);
-    } catch {
-      try {
-        return this.mastra.getProcessorById(processorKey);
-      } catch {
-        this.logger?.warn(`Processor "${processorKey}" referenced in stored agent but not registered in Mastra`);
-        return void 0;
-      }
-    }
-  }
-  resolveStoredInputProcessors(storedProcessors) {
-    if (!storedProcessors || storedProcessors.length === 0) return void 0;
-    const resolved = [];
-    for (const key of storedProcessors) {
-      const processor = this.findProcessor(key);
-      if (processor && (processor.processInput || processor.processInputStep)) {
-        resolved.push(processor);
-      }
-    }
-    return resolved.length > 0 ? resolved : void 0;
-  }
-  resolveStoredOutputProcessors(storedProcessors) {
-    if (!storedProcessors || storedProcessors.length === 0) return void 0;
-    const resolved = [];
-    for (const key of storedProcessors) {
-      const processor = this.findProcessor(key);
-      if (processor && (processor.processOutputStream || processor.processOutputResult || processor.processOutputStep)) {
-        resolved.push(processor);
-      }
-    }
-    return resolved.length > 0 ? resolved : void 0;
-  }
   // ============================================================================
   // Clone
   // ============================================================================
@@ -1018,9 +1159,6 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
     const agentKeys = Object.keys(agentsResolved || {});
     const memory = await agent.getMemory({ requestContext });
     const memoryConfig = memory?.getConfig();
-    const { inputProcessorIds, outputProcessorIds } = await agent.getConfiguredProcessorIds(requestContext);
-    const inputProcessorKeys = inputProcessorIds.length > 0 ? inputProcessorIds : void 0;
-    const outputProcessorKeys = outputProcessorIds.length > 0 ? outputProcessorIds : void 0;
     let storedScorers;
     const resolvedScorers = await agent.listScorers({ requestContext });
     if (resolvedScorers && Object.keys(resolvedScorers).length > 0) {
@@ -1055,8 +1193,6 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       workflows: workflowKeys.length > 0 ? Object.fromEntries(workflowKeys.map((key) => [key, {}])) : void 0,
       agents: agentKeys.length > 0 ? Object.fromEntries(agentKeys.map((key) => [key, {}])) : void 0,
       memory: memoryConfig,
-      inputProcessors: inputProcessorKeys,
-      outputProcessors: outputProcessorKeys,
       scorers: storedScorers,
       defaultOptions: storageDefaultOptions,
       metadata: options.metadata,
@@ -1171,6 +1307,112 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
   }
 };
 
+// src/namespaces/mcp-server.ts
+var EditorMCPServerNamespace = class extends CrudEditorNamespace {
+  onCacheEvict(_id) {
+  }
+  async hydrate(resolved) {
+    if (!this.mastra) {
+      throw new Error("MastraEditor is not registered with a Mastra instance");
+    }
+    const tools = this.resolveStoredTools(resolved.tools);
+    const agents = this.resolveStoredAgents(resolved.agents);
+    const workflows = this.resolveStoredWorkflows(resolved.workflows);
+    if (!this.mcpServerCtor) {
+      try {
+        const mod = await import("@mastra/mcp");
+        this.mcpServerCtor = mod.MCPServer;
+      } catch {
+        throw new Error(
+          "@mastra/mcp is required to hydrate MCP server configurations. Install it with: npm install @mastra/mcp"
+        );
+      }
+    }
+    const server = new this.mcpServerCtor({
+      id: resolved.id,
+      name: resolved.name,
+      version: resolved.version,
+      description: resolved.description,
+      instructions: resolved.instructions,
+      repository: resolved.repository,
+      releaseDate: resolved.releaseDate,
+      isLatest: resolved.isLatest,
+      packageCanonical: resolved.packageCanonical,
+      tools,
+      agents,
+      workflows
+    });
+    this.mastra.addMCPServer(server, resolved.id);
+    return server;
+  }
+  resolveStoredTools(storedTools) {
+    if (!storedTools || Object.keys(storedTools).length === 0) return {};
+    if (!this.mastra) return {};
+    const resolved = {};
+    for (const [toolKey, toolConfig] of Object.entries(storedTools)) {
+      try {
+        const tool = this.mastra.getToolById(toolKey);
+        if (toolConfig.description) {
+          resolved[toolKey] = { ...tool, description: toolConfig.description };
+        } else {
+          resolved[toolKey] = tool;
+        }
+      } catch {
+        this.logger?.warn(`Tool "${toolKey}" referenced in stored MCP server but not registered in Mastra`);
+      }
+    }
+    return resolved;
+  }
+  resolveStoredAgents(storedAgents) {
+    if (!storedAgents || Object.keys(storedAgents).length === 0) return {};
+    if (!this.mastra) return {};
+    const resolved = {};
+    for (const agentKey of Object.keys(storedAgents)) {
+      try {
+        resolved[agentKey] = this.mastra.getAgent(agentKey);
+      } catch {
+        try {
+          resolved[agentKey] = this.mastra.getAgentById(agentKey);
+        } catch {
+          this.logger?.warn(`Agent "${agentKey}" referenced in stored MCP server but not registered in Mastra`);
+        }
+      }
+    }
+    return resolved;
+  }
+  resolveStoredWorkflows(storedWorkflows) {
+    if (!storedWorkflows || Object.keys(storedWorkflows).length === 0) return {};
+    if (!this.mastra) return {};
+    const resolved = {};
+    for (const workflowKey of Object.keys(storedWorkflows)) {
+      try {
+        resolved[workflowKey] = this.mastra.getWorkflow(workflowKey);
+      } catch {
+        try {
+          resolved[workflowKey] = this.mastra.getWorkflowById(workflowKey);
+        } catch {
+          this.logger?.warn(`Workflow "${workflowKey}" referenced in stored MCP server but not registered in Mastra`);
+        }
+      }
+    }
+    return resolved;
+  }
+  async getStorageAdapter() {
+    const storage = this.mastra?.getStorage();
+    if (!storage) throw new Error("Storage is not configured");
+    const store = await storage.getStore("mcpServers");
+    if (!store) throw new Error("MCP servers storage domain is not available");
+    return {
+      create: (input) => store.create({ mcpServer: input }),
+      getByIdResolved: (id) => store.getByIdResolved(id),
+      update: (input) => store.update(input),
+      delete: (id) => store.delete(id),
+      list: (args) => store.list(args),
+      listResolved: (args) => store.listResolved(args)
+    };
+  }
+};
+
 // src/namespaces/prompt.ts
 var EditorPromptNamespace = class extends CrudEditorNamespace {
   onCacheEvict(id) {
@@ -1529,6 +1771,7 @@ var MastraEditor = class {
   constructor(config) {
     this.__logger = config?.logger;
     this.__toolProviders = config?.toolProviders ?? {};
+    this.__processorProviders = { ...BUILT_IN_PROCESSOR_PROVIDERS, ...config?.processorProviders };
     this.__filesystems = /* @__PURE__ */ new Map();
     this.__filesystems.set(localFilesystemProvider.id, localFilesystemProvider);
     for (const [id, provider] of Object.entries(config?.filesystems ?? {})) {
@@ -1545,6 +1788,7 @@ var MastraEditor = class {
     }
     this.agent = new EditorAgentNamespace(this);
     this.mcp = new EditorMCPNamespace(this);
+    this.mcpServer = new EditorMCPServerNamespace(this);
     this.prompt = new EditorPromptNamespace(this);
     this.scorer = new EditorScorerNamespace(this);
     this.workspace = new EditorWorkspaceNamespace(this);
@@ -1568,6 +1812,14 @@ var MastraEditor = class {
   getToolProviders() {
     return this.__toolProviders;
   }
+  /** Get a processor provider by ID */
+  getProcessorProvider(id) {
+    return this.__processorProviders[id];
+  }
+  /** List all registered processor providers */
+  getProcessorProviders() {
+    return this.__processorProviders;
+  }
   /** List all registered filesystem providers */
   getFilesystemProviders() {
     return Array.from(this.__filesystems.values());
@@ -1613,6 +1865,7 @@ export {
   CrudEditorNamespace,
   EditorAgentNamespace,
   EditorMCPNamespace,
+  EditorMCPServerNamespace,
   EditorNamespace,
   EditorPromptNamespace,
   EditorScorerNamespace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/editor",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Mastra Editor for agent management and instantiation",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -55,19 +55,23 @@
     "@arcadeai/arcadejs": "^2.2.0",
     "@composio/core": "^0.6.3",
     "@composio/mastra": "^0.6.3",
-    "@mastra/memory": "1.4.0",
-    "@mastra/schema-compat": "1.1.1"
+    "@mastra/memory": "1.5.0",
+    "@mastra/schema-compat": "1.1.2"
   },
   "devDependencies": {
+    "@hono/node-server": "^1.14.1",
+    "hono": "^4.7.10",
     "tsup": "^8.0.2",
     "typescript": "^5.9.3",
-    "vitest": "4.0.16",
+    "vitest": "4.0.18",
     "zod": "^3.25.76",
-    "@internal/ai-sdk-v4": "0.0.7",
-    "@internal/ai-v6": "0.0.7",
-    "@internal/ai-sdk-v5": "0.0.7",
-    "@mastra/core": "1.5.0",
-    "@mastra/libsql": "1.5.0"
+    "@internal/ai-sdk-v5": "0.0.8",
+    "@internal/ai-sdk-v4": "0.0.8",
+    "@mastra/core": "1.6.0",
+    "@internal/ai-v6": "0.0.8",
+    "@mastra/hono": "1.1.5",
+    "@mastra/libsql": "1.6.0",
+    "@mastra/mcp": "1.0.1"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0",