@mastra/editor 0.13.8 → 0.13.9

package/dist/index.d.cts

@@ -1,44 +1,43 @@
-import { Mastra } from '@mastra/core';
-import { IAgentBuilder } from '@mastra/core/agent-builder/ee';
-import { GetByIdOptions, IEditorFavoritesNamespace, EditorFavoriteTargetInput, EditorFavoriteToggleResult, EditorIsFavoritedBatchInput, EditorListFavoritedIdsInput, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, BrowserProvider, WorkspaceProvider, MastraEditorConfig } from '@mastra/core/editor';
-export { BrowserProvider, MastraEditorConfig } from '@mastra/core/editor';
-import { IMastraLogger } from '@mastra/core/logger';
-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, SourceControlProvider, 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';
-
+import { ToolProvider } from "@mastra/core/tool-provider";
+import { AgentInstructionBlock, BlobStore, PromptBlocksStorage, RuleGroup, SourceControlProvider, StorageCreateAgentInput, StorageCreateMCPClientInput, StorageCreateMCPServerInput, StorageCreatePromptBlockInput, StorageCreateScorerDefinitionInput, StorageCreateSkillInput, StorageCreateWorkspaceInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageListMCPServersInput, StorageListMCPServersOutput, StorageListMCPServersResolvedOutput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageMCPServerConfig, StorageResolvedAgentType, StorageResolvedMCPClientType, StorageResolvedMCPServerType, StorageResolvedPromptBlockType, StorageResolvedScorerDefinitionType, StorageResolvedSkillType, StorageResolvedWorkspaceType, StorageUpdateAgentInput, StorageUpdateMCPClientInput, StorageUpdateMCPServerInput, StorageUpdatePromptBlockInput, StorageUpdateScorerDefinitionInput, StorageUpdateSkillInput, StorageUpdateWorkspaceInput, StorageWorkspaceSnapshotType } from "@mastra/core/storage";
+import { IAgentBuilder } from "@mastra/core/agent-builder/ee";
+import { Agent } from "@mastra/core/agent";
+import { Mastra } from "@mastra/core";
+import { BlobStoreProvider, BrowserProvider, BrowserProvider as BrowserProvider$1, EditorFavoriteTargetInput, EditorFavoriteToggleResult, EditorIsFavoritedBatchInput, EditorListFavoritedIdsInput, FilesystemProvider, GetByIdOptions, IEditorFavoritesNamespace, IMastraEditor, MastraEditorConfig, SandboxProvider, WorkspaceProvider } from "@mastra/core/editor";
+import { IMastraLogger } from "@mastra/core/logger";
+import { ProcessorProvider } from "@mastra/core/processor-provider";
+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";
+//#region src/namespaces/base.d.ts
 /**
  * Adapter interface that bridges entity-specific storage method names
  * to a generic CRUD interface. Each CrudEditorNamespace subclass implements
  * this to map its storage domain's methods.
  */
 interface StorageAdapter<TCreateInput extends {
-    id: string;
+  id: string;
 }, TUpdateInput extends {
-    id: string;
+  id: string;
 }, TListInput, TListOutput, TListResolvedOutput, TResolved> {
-    create(input: TCreateInput): Promise<unknown>;
-    getByIdResolved(id: string, options?: GetByIdOptions): Promise<TResolved | null>;
-    update(input: TUpdateInput): Promise<unknown>;
-    delete(id: string): Promise<void>;
-    list(args?: TListInput): Promise<TListOutput>;
-    listResolved(args?: TListInput): Promise<TListResolvedOutput>;
+  create(input: TCreateInput): Promise<unknown>;
+  getByIdResolved(id: string, options?: GetByIdOptions): Promise<TResolved | null>;
+  update(input: TUpdateInput): Promise<unknown>;
+  delete(id: string): Promise<void>;
+  list(args?: TListInput): Promise<TListOutput>;
+  listResolved(args?: TListInput): Promise<TListResolvedOutput>;
 }
 /**
  * Base class for all editor namespaces.
  * Provides shared infrastructure: mastra/logger access and registration check.
  */
 declare abstract class EditorNamespace {
-    protected editor: MastraEditor;
-    constructor(editor: MastraEditor);
-    protected get mastra(): Mastra | undefined;
-    protected get logger(): IMastraLogger | undefined;
-    protected ensureRegistered(): void;
+  protected editor: MastraEditor;
+  constructor(editor: MastraEditor);
+  protected get mastra(): Mastra | undefined;
+  protected get logger(): IMastraLogger | undefined;
+  protected ensureRegistered(): void;
 }
 /**
  * Abstract base class for editor namespaces with full CRUD operations.
@@ -56,293 +55,301 @@ declare abstract class EditorNamespace {
  * automatically invalidate the cache for the affected entity.
  */
 declare abstract class CrudEditorNamespace<TCreateInput extends {
-    id: string;
+  id: string;
 }, TUpdateInput extends {
-    id: string;
+  id: string;
 }, TListInput, TListOutput, TListResolvedOutput, TResolved, THydrated = TResolved> extends EditorNamespace {
-    protected _cache: Map<string, THydrated>;
-    /**
-     * Each subclass must provide a storage adapter that maps
-     * entity-specific storage method names to the generic interface.
-     */
-    protected abstract getStorageAdapter(): Promise<StorageAdapter<TCreateInput, TUpdateInput, TListInput, TListOutput, TListResolvedOutput, TResolved>>;
-    /**
-     * Convert a raw resolved config into a runtime primitive.
-     * Override in subclasses that need hydration (e.g. agents → Agent instance).
-     * Default implementation returns the resolved config as-is.
-     */
-    protected hydrate(resolved: TResolved): Promise<THydrated>;
-    /**
-     * Hook called when an entity is evicted from the cache (on delete, update, or clearCache).
-     * Override in subclasses to also remove the entity from the Mastra runtime registry.
-     */
-    protected onCacheEvict(_id: string): void;
-    create(input: TCreateInput): Promise<THydrated>;
-    getById(id: string, options?: GetByIdOptions): Promise<THydrated | null>;
-    update(input: TUpdateInput): Promise<THydrated>;
-    delete(id: string): Promise<void>;
-    list(args?: TListInput): Promise<TListOutput>;
-    listResolved(args?: TListInput): Promise<TListResolvedOutput>;
-    /**
-     * Clear cached entities. If an id is provided, only that entity is cleared.
-     * Otherwise all cached entities in this namespace are cleared.
-     */
-    clearCache(id?: string): void;
+  protected _cache: Map<string, THydrated>;
+  /**
+   * Each subclass must provide a storage adapter that maps
+   * entity-specific storage method names to the generic interface.
+   */
+  protected abstract getStorageAdapter(): Promise<StorageAdapter<TCreateInput, TUpdateInput, TListInput, TListOutput, TListResolvedOutput, TResolved>>;
+  /**
+   * Convert a raw resolved config into a runtime primitive.
+   * Override in subclasses that need hydration (e.g. agents → Agent instance).
+   * Default implementation returns the resolved config as-is.
+   */
+  protected hydrate(resolved: TResolved): Promise<THydrated>;
+  /**
+   * Hook called when an entity is evicted from the cache (on delete, update, or clearCache).
+   * Override in subclasses to also remove the entity from the Mastra runtime registry.
+   */
+  protected onCacheEvict(_id: string): void;
+  create(input: TCreateInput): Promise<THydrated>;
+  getById(id: string, options?: GetByIdOptions): Promise<THydrated | null>;
+  update(input: TUpdateInput): Promise<THydrated>;
+  delete(id: string): Promise<void>;
+  list(args?: TListInput): Promise<TListOutput>;
+  listResolved(args?: TListInput): Promise<TListResolvedOutput>;
+  /**
+   * Clear cached entities. If an id is provided, only that entity is cleared.
+   * Otherwise all cached entities in this namespace are cleared.
+   */
+  clearCache(id?: string): void;
 }
-
+//#endregion
+//#region src/namespaces/agent.d.ts
 declare class EditorAgentNamespace extends CrudEditorNamespace<StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType, Agent> {
-    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType>>;
-    /**
-     * Hydrate a stored agent config into a runtime Agent instance.
-     */
-    protected hydrate(storedAgent: StorageResolvedAgentType): Promise<Agent>;
-    update(input: StorageUpdateAgentInput): Promise<Agent>;
-    /**
-     * Create a new agent, applying builder defaults for fields not specified in input.
-     * Also ensures the referenced workspace (if any) is persisted as a stored workspace.
-     */
-    create(input: StorageCreateAgentInput): Promise<Agent>;
-    private getCodeDefinedAgent;
-    private ensureStoredWorkspaceRefs;
-    /**
-     * Ensure a workspace reference is persisted in the DB.
-     *
-     * For `type: 'id'`: looks up the runtime workspace, serializes its config,
-     * and creates a stored workspace record if one doesn't already exist.
-     *
-     * For `type: 'inline'`: derives a deterministic ID from the config and
-     * persists it as a stored workspace if one doesn't already exist.
-     */
-    private ensureStoredWorkspace;
-    protected onCacheEvict(id: string): void;
-    /**
-     * Evict all cached agents that reference a given skill ID.
-     * Called by EditorSkillNamespace after a skill is published so that
-     * 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, options?: {
-        status?: 'draft' | 'published';
-    } | {
-        versionId: string;
-    }, requestContext?: RequestContext): Promise<Agent>;
-    /**
-     * Detect whether a StorageConditionalField value is a conditional variant array
-     * (as opposed to the plain static value T).
-     */
-    private isConditionalVariants;
-    /**
-     * Accumulate all matching variants for an array-typed field.
-     * Each matching variant's value (an array) is concatenated in order.
-     * Variants with no rules are treated as unconditional (always included).
-     */
-    private accumulateArrayVariants;
-    /**
-     * Accumulate all matching variants for an object/record-typed field.
-     * Each matching variant's value is shallow-merged in order, so later
-     * matches override keys from earlier ones.
-     * Variants with no rules are treated as unconditional (always included).
-     */
-    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.
-     */
-    private resolveStoredTools;
-    /**
-     * Resolve MCP client/server references to tools.
-     *
-     * For each entry in `mcpClients`, resolution checks two sources in order:
-     * 1. Stored MCP clients (from DB) — creates an MCPClient to fetch remote tools
-     * 2. Code-defined MCP servers on the Mastra instance — uses `server.tools()` directly
-     *
-     * When `clientToolsConfig.tools` is absent, no tools are included (client registered but nothing selected).
-     * When `clientToolsConfig.tools` is an empty object `{}`, all tools from the source are included.
-     * When specified with keys, only listed tools are included with optional description overrides.
-     */
-    private resolveStoredMCPTools;
-    /**
-     * Resolve integration tool references from tool providers.
-     *
-     * For each entry in `integrationTools`, looks up the tool provider by ID
-     * from the editor's registered tool providers and calls `getTools()` on it.
-     *
-     * When `providerConfig.tools` is absent, no tools are included (provider registered but nothing selected).
-     * When `providerConfig.tools` is an empty object `{}`, all tools from the provider are included.
-     * When `providerConfig.tools` has specific keys, only those tools are included with optional overrides.
-     */
-    private resolveStoredIntegrationTools;
-    private resolveStoredWorkflows;
-    private resolveStoredAgents;
-    private resolveStoredMemory;
-    private resolveStoredScorers;
-    /**
-     * Clone a runtime Agent instance into storage, creating a new stored agent
-     * with the resolved configuration of the source agent.
-     */
-    clone(agent: Agent, options: {
-        newId: string;
-        newName?: string;
-        metadata?: Record<string, unknown>;
-        authorId?: string;
-        visibility?: 'private' | 'public';
-        requestContext?: RequestContext;
-    }): Promise<StorageResolvedAgentType>;
-    /**
-     * Resolve a stored workspace reference to a runtime Workspace instance.
-     * Handles both ID-based references (looked up from editor.workspace) and
-     * inline workspace configurations (hydrated directly).
-     *
-     * When a skillSource is provided (from resolveAgentSkillSource), it is passed
-     * to the workspace hydration so the workspace uses versioned blob-backed skills
-     * instead of filesystem-based discovery.
-     */
-    private resolveStoredWorkspace;
-    /**
-     * Resolve a stored browser config to a runtime MastraBrowser instance.
-     * Looks up the provider by ID in the editor's browser registry.
-     * Only supports `type: 'inline'` refs (config is embedded in the agent snapshot).
-     */
-    private resolveStoredBrowser;
-    /**
-     * Resolve agent-level skill configurations into a CompositeVersionedSkillSource.
-     *
-     * For each skill in the agent's `skills` map, checks the resolution strategy:
-     * - `pin: '<versionId>'` → reads the specific version's tree from the DB
-     * - `strategy: 'latest'` → reads the skill's active version tree
-     * - `strategy: 'live'` or no strategy → skips (uses filesystem-based discovery)
-     *
-     * Returns a CompositeVersionedSkillSource if any versioned skills were resolved,
-     * or undefined if all skills use filesystem-based discovery.
-     */
-    private resolveAgentSkillSource;
+  protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateAgentInput, StorageUpdateAgentInput, StorageListAgentsInput, StorageListAgentsOutput, StorageListAgentsResolvedOutput, StorageResolvedAgentType>>;
+  /**
+   * Hydrate a stored agent config into a runtime Agent instance.
+   */
+  protected hydrate(storedAgent: StorageResolvedAgentType): Promise<Agent>;
+  update(input: StorageUpdateAgentInput): Promise<Agent>;
+  /**
+   * Create a new agent, applying builder defaults for fields not specified in input.
+   * Also ensures the referenced workspace (if any) is persisted as a stored workspace.
+   */
+  create(input: StorageCreateAgentInput): Promise<Agent>;
+  private getCodeDefinedAgent;
+  private ensureStoredWorkspaceRefs;
+  /**
+   * Ensure a workspace reference is persisted in the DB.
+   *
+   * For `type: 'id'`: looks up the runtime workspace, serializes its config,
+   * and creates a stored workspace record if one doesn't already exist.
+   *
+   * For `type: 'inline'`: derives a deterministic ID from the config and
+   * persists it as a stored workspace if one doesn't already exist.
+   */
+  private ensureStoredWorkspace;
+  protected onCacheEvict(id: string): void;
+  /**
+   * Evict all cached agents that reference a given skill ID.
+   * Called by EditorSkillNamespace after a skill is published so that
+   * 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, options?: {
+    status?: 'draft' | 'published';
+  } | {
+    versionId: string;
+  }, requestContext?: RequestContext): Promise<Agent>;
+  /**
+   * Detect whether a StorageConditionalField value is a conditional variant array
+   * (as opposed to the plain static value T).
+   */
+  private isConditionalVariants;
+  /**
+   * Accumulate all matching variants for an array-typed field.
+   * Each matching variant's value (an array) is concatenated in order.
+   * Variants with no rules are treated as unconditional (always included).
+   */
+  private accumulateArrayVariants;
+  /**
+   * Accumulate all matching variants for an object/record-typed field.
+   * Each matching variant's value is shallow-merged in order, so later
+   * matches override keys from earlier ones.
+   * Variants with no rules are treated as unconditional (always included).
+   */
+  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.
+   */
+  private resolveStoredTools;
+  /**
+   * Resolve MCP client/server references to tools.
+   *
+   * For each entry in `mcpClients`, resolution checks two sources in order:
+   * 1. Stored MCP clients (from DB) — creates an MCPClient to fetch remote tools
+   * 2. Code-defined MCP servers on the Mastra instance — uses `server.tools()` directly
+   *
+   * When `clientToolsConfig.tools` is absent, no tools are included (client registered but nothing selected).
+   * When `clientToolsConfig.tools` is an empty object `{}`, all tools from the source are included.
+   * When specified with keys, only listed tools are included with optional description overrides.
+   */
+  private resolveStoredMCPTools;
+  /**
+   * Resolve integration tool references from tool providers.
+   *
+   * For each entry in `integrationTools`, looks up the tool provider by ID
+   * from the editor's registered tool providers and calls `getTools()` on it.
+   *
+   * When `providerConfig.tools` is absent, no tools are included (provider registered but nothing selected).
+   * When `providerConfig.tools` is an empty object `{}`, all tools from the provider are included.
+   * When `providerConfig.tools` has specific keys, only those tools are included with optional overrides.
+   */
+  private resolveStoredIntegrationTools;
+  private resolveStoredWorkflows;
+  private resolveStoredAgents;
+  private resolveStoredMemory;
+  private resolveStoredScorers;
+  /**
+   * Clone a runtime Agent instance into storage, creating a new stored agent
+   * with the resolved configuration of the source agent.
+   */
+  clone(agent: Agent, options: {
+    newId: string;
+    newName?: string;
+    metadata?: Record<string, unknown>;
+    authorId?: string;
+    visibility?: 'private' | 'public';
+    requestContext?: RequestContext;
+  }): Promise<StorageResolvedAgentType>;
+  /**
+   * Resolve a stored workspace reference to a runtime Workspace instance.
+   * Handles both ID-based references (looked up from editor.workspace) and
+   * inline workspace configurations (hydrated directly).
+   *
+   * When a skillSource is provided (from resolveAgentSkillSource), it is passed
+   * to the workspace hydration so the workspace uses versioned blob-backed skills
+   * instead of filesystem-based discovery.
+   */
+  private resolveStoredWorkspace;
+  /**
+   * Resolve a stored browser config to a runtime MastraBrowser instance.
+   * Looks up the provider by ID in the editor's browser registry.
+   * Only supports `type: 'inline'` refs (config is embedded in the agent snapshot).
+   */
+  private resolveStoredBrowser;
+  /**
+   * Resolve agent-level skill configurations into a CompositeVersionedSkillSource.
+   *
+   * For each skill in the agent's `skills` map, checks the resolution strategy:
+   * - `pin: '<versionId>'` → reads the specific version's tree from the DB
+   * - `strategy: 'latest'` → reads the skill's active version tree
+   * - `strategy: 'live'` or no strategy → skips (uses filesystem-based discovery)
+   *
+   * Returns a CompositeVersionedSkillSource if any versioned skills were resolved,
+   * or undefined if all skills use filesystem-based discovery.
+   */
+  private resolveAgentSkillSource;
 }
-
+//#endregion
+//#region src/namespaces/mcp.d.ts
 declare class EditorMCPNamespace extends CrudEditorNamespace<StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType> {
-    protected onCacheEvict(_id: string): void;
-    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType>>;
-    /**
-     * Convert a stored MCP server config into the shape expected by MCPClient.
-     * Converts `url` from string to URL for HTTP servers.
-     * Returns a plain object — callers must pass it to `new MCPClient()`.
-     */
-    static toMCPServerDefinition(serverConfig: StorageMCPServerConfig, requestInit?: {
-        headers: Record<string, string>;
-    }): Record<string, unknown>;
-    /**
-     * Convert all servers in a stored MCP client to MCPClientOptions shape.
-     */
-    static toMCPClientOptions(config: StorageResolvedMCPClientType, requestInit?: {
-        headers: Record<string, string>;
-    }): {
-        id: string;
-        servers: Record<string, Record<string, unknown>>;
-    };
+  protected onCacheEvict(_id: string): void;
+  protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateMCPClientInput, StorageUpdateMCPClientInput, StorageListMCPClientsInput, StorageListMCPClientsOutput, StorageListMCPClientsResolvedOutput, StorageResolvedMCPClientType>>;
+  /**
+   * Convert a stored MCP server config into the shape expected by MCPClient.
+   * Converts `url` from string to URL for HTTP servers.
+   * Returns a plain object — callers must pass it to `new MCPClient()`.
+   */
+  static toMCPServerDefinition(serverConfig: StorageMCPServerConfig, requestInit?: {
+    headers: Record<string, string>;
+  }): Record<string, unknown>;
+  /**
+   * Convert all servers in a stored MCP client to MCPClientOptions shape.
+   */
+  static toMCPClientOptions(config: StorageResolvedMCPClientType, requestInit?: {
+    headers: Record<string, string>;
+  }): {
+    id: string;
+    servers: Record<string, Record<string, unknown>>;
+  };
 }
-
+//#endregion
+//#region src/namespaces/mcp-server.d.ts
 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>>;
+  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>>;
 }
-
+//#endregion
+//#region src/namespaces/prompt.d.ts
 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>>;
-    update(input: StorageUpdatePromptBlockInput): Promise<StorageResolvedPromptBlockType>;
-    preview(blocks: AgentInstructionBlock[], context: Record<string, unknown>): Promise<string>;
+  protected onCacheEvict(id: string): void;
+  protected getStorageAdapter(): Promise<StorageAdapter<StorageCreatePromptBlockInput, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput, StorageResolvedPromptBlockType>>;
+  update(input: StorageUpdatePromptBlockInput): Promise<StorageResolvedPromptBlockType>;
+  preview(blocks: AgentInstructionBlock[], context: Record<string, unknown>): Promise<string>;
 }
-
+//#endregion
+//#region src/namespaces/scorer.d.ts
 declare class EditorScorerNamespace extends CrudEditorNamespace<StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType> {
-    protected onCacheEvict(id: string): void;
-    /**
-     * Hydrate a stored scorer definition into a runtime MastraScorer instance
-     * and register it on the Mastra instance so it can be discovered via
-     * `mastra.getScorer()` / `mastra.getScorerById()`.
-     */
-    protected hydrate(storedScorer: StorageResolvedScorerDefinitionType): Promise<StorageResolvedScorerDefinitionType>;
-    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType>>;
-    /**
-     * Create a MastraScorer instance from a stored scorer definition.
-     * Supports:
-     * - 'llm-judge': Creates a scorer with a single LLM call using custom instructions
-     * - Preset types (e.g., 'bias', 'toxicity'): Not yet supported, returns null
-     */
-    resolve(storedScorer: StorageResolvedScorerDefinitionType): MastraScorer<any, any, any, any> | null;
+  protected onCacheEvict(id: string): void;
+  /**
+   * Hydrate a stored scorer definition into a runtime MastraScorer instance
+   * and register it on the Mastra instance so it can be discovered via
+   * `mastra.getScorer()` / `mastra.getScorerById()`.
+   */
+  protected hydrate(storedScorer: StorageResolvedScorerDefinitionType): Promise<StorageResolvedScorerDefinitionType>;
+  protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateScorerDefinitionInput, StorageUpdateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageListScorerDefinitionsResolvedOutput, StorageResolvedScorerDefinitionType>>;
+  /**
+   * Create a MastraScorer instance from a stored scorer definition.
+   * Supports:
+   * - 'llm-judge': Creates a scorer with a single LLM call using custom instructions
+   * - Preset types (e.g., 'bias', 'toxicity'): Not yet supported, returns null
+   */
+  resolve(storedScorer: StorageResolvedScorerDefinitionType): MastraScorer<any, any, any, any> | null;
 }
-
+//#endregion
+//#region src/namespaces/workspace.d.ts
 declare class EditorWorkspaceNamespace extends CrudEditorNamespace<StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType, StorageResolvedWorkspaceType> {
-    protected onCacheEvict(_id: string): void;
-    /**
-     * Hydrate a stored workspace snapshot config into a runtime Workspace instance.
-     * Resolves provider strings to actual instances using the editor's registries.
-     *
-     * This is NOT called from the CrudEditorNamespace flow — it is a public utility
-     * used by EditorAgentNamespace during agent hydration.
-     */
-    hydrateSnapshotToWorkspace(id: string, snapshot: StorageWorkspaceSnapshotType, options?: {
-        skillSource?: SkillSource;
-    }): Promise<Workspace<WorkspaceFilesystem | undefined, WorkspaceSandbox | undefined, Record<string, WorkspaceFilesystem> | undefined>>;
-    /**
-     * Serialize a runtime Workspace instance into a StorageWorkspaceSnapshotType.
-     * The reverse of hydrateSnapshotToWorkspace — extracts provider IDs and config
-     * from live filesystem/sandbox instances so the workspace can be persisted to the DB.
-     */
-    snapshotFromWorkspace(workspace: Workspace): Promise<StorageWorkspaceSnapshotType>;
-    /**
-     * Serialize a runtime WorkspaceFilesystem into a StorageFilesystemConfig.
-     * Awaits getInfo() so async providers like CompositeFilesystem keep their mount metadata.
-     */
-    private serializeFilesystem;
-    /**
-     * Resolve a stored filesystem config to a runtime WorkspaceFilesystem instance.
-     * Looks up the provider by ID in the editor's registry (which includes built-in providers).
-     */
-    private resolveFilesystem;
-    /**
-     * Resolve a stored sandbox config to a runtime WorkspaceSandbox instance.
-     * Looks up the provider by ID in the editor's registry (which includes built-in providers).
-     */
-    private resolveSandbox;
-    /**
-     * Resolve a stored workspace provider config to a complete runtime Workspace instance.
-     * Looks up the provider by ID in the editor's workspace provider registry.
-     */
-    resolveWorkspaceProvider(providerId: string, config: Record<string, unknown>): Promise<Workspace<any, any, any>>;
-    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType>>;
+  protected onCacheEvict(_id: string): void;
+  /**
+   * Hydrate a stored workspace snapshot config into a runtime Workspace instance.
+   * Resolves provider strings to actual instances using the editor's registries.
+   *
+   * This is NOT called from the CrudEditorNamespace flow — it is a public utility
+   * used by EditorAgentNamespace during agent hydration.
+   */
+  hydrateSnapshotToWorkspace(id: string, snapshot: StorageWorkspaceSnapshotType, options?: {
+    skillSource?: SkillSource;
+  }): Promise<Workspace<WorkspaceFilesystem | undefined, WorkspaceSandbox | undefined, Record<string, WorkspaceFilesystem> | undefined>>;
+  /**
+   * Serialize a runtime Workspace instance into a StorageWorkspaceSnapshotType.
+   * The reverse of hydrateSnapshotToWorkspace — extracts provider IDs and config
+   * from live filesystem/sandbox instances so the workspace can be persisted to the DB.
+   */
+  snapshotFromWorkspace(workspace: Workspace): Promise<StorageWorkspaceSnapshotType>;
+  /**
+   * Serialize a runtime WorkspaceFilesystem into a StorageFilesystemConfig.
+   * Awaits getInfo() so async providers like CompositeFilesystem keep their mount metadata.
+   */
+  private serializeFilesystem;
+  /**
+   * Resolve a stored filesystem config to a runtime WorkspaceFilesystem instance.
+   * Looks up the provider by ID in the editor's registry (which includes built-in providers).
+   */
+  private resolveFilesystem;
+  /**
+   * Resolve a stored sandbox config to a runtime WorkspaceSandbox instance.
+   * Looks up the provider by ID in the editor's registry (which includes built-in providers).
+   */
+  private resolveSandbox;
+  /**
+   * Resolve a stored workspace provider config to a complete runtime Workspace instance.
+   * Looks up the provider by ID in the editor's workspace provider registry.
+   */
+  resolveWorkspaceProvider(providerId: string, config: Record<string, unknown>): Promise<Workspace<any, any, any>>;
+  protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateWorkspaceInput, StorageUpdateWorkspaceInput, StorageListWorkspacesInput, StorageListWorkspacesOutput, StorageListWorkspacesResolvedOutput, StorageResolvedWorkspaceType>>;
 }
-
+//#endregion
+//#region src/namespaces/skill.d.ts
 declare class EditorSkillNamespace extends CrudEditorNamespace<StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType> {
-    protected onCacheEvict(_id: string): void;
-    protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType>>;
-    /**
-     * Publish a skill from a live filesystem source.
-     * Walks the skill directory, hashes files into the blob store,
-     * creates a new version with the tree manifest, and sets activeVersionId.
-     */
-    publish(skillId: string, source: SkillSource, skillPath: string): Promise<StorageResolvedSkillType>;
+  protected onCacheEvict(_id: string): void;
+  protected getStorageAdapter(): Promise<StorageAdapter<StorageCreateSkillInput, StorageUpdateSkillInput, StorageListSkillsInput, StorageListSkillsOutput, StorageListSkillsResolvedOutput, StorageResolvedSkillType>>;
+  /**
+   * Publish a skill from a live filesystem source.
+   * Walks the skill directory, hashes files into the blob store,
+   * creates a new version with the tree manifest, and sets activeVersionId.
+   */
+  publish(skillId: string, source: SkillSource, skillPath: string): Promise<StorageResolvedSkillType>;
 }
-
+//#endregion
+//#region src/namespaces/favorites.d.ts
 /**
  * Favorites namespace.
  *
@@ -352,14 +359,15 @@ declare class EditorSkillNamespace extends CrudEditorNamespace<StorageCreateSkil
  * perform their own access check before invoking these methods.
  */
 declare class EditorFavoritesNamespace extends EditorNamespace implements IEditorFavoritesNamespace {
-    favorite(input: EditorFavoriteTargetInput): Promise<EditorFavoriteToggleResult>;
-    unfavorite(input: EditorFavoriteTargetInput): Promise<EditorFavoriteToggleResult>;
-    isFavorited(input: EditorFavoriteTargetInput): Promise<boolean>;
-    isFavoritedBatch(input: EditorIsFavoritedBatchInput): Promise<Set<string>>;
-    listFavoritedIds(input: EditorListFavoritedIdsInput): Promise<string[]>;
-    private getFavoritesStore;
+  favorite(input: EditorFavoriteTargetInput): Promise<EditorFavoriteToggleResult>;
+  unfavorite(input: EditorFavoriteTargetInput): Promise<EditorFavoriteToggleResult>;
+  isFavorited(input: EditorFavoriteTargetInput): Promise<boolean>;
+  isFavoritedBatch(input: EditorIsFavoritedBatchInput): Promise<Set<string>>;
+  listFavoritedIds(input: EditorListFavoritedIdsInput): Promise<string[]>;
+  private getFavoritesStore;
 }
-
+//#endregion
+//#region src/template-engine.d.ts
 /**
  * TemplateEngine: Simple variable interpolation for prompt block content.
  *
@@ -378,17 +386,8 @@ declare class EditorFavoritesNamespace extends EditorNamespace implements IEdito
  * @returns The rendered string with variables replaced
  */
 declare function renderTemplate(template: string, context: Record<string, unknown>): string;
-
-/**
- * RuleEvaluator: Evaluates recursive RuleGroup conditions against a context object.
- *
- * Supports:
- *   - Leaf rules with operators: equals, not_equals, contains, not_contains,
- *     greater_than, less_than, greater_than_or_equal, less_than_or_equal,
- *     in, not_in, exists, not_exists
- *   - Recursive AND / OR grouping via RuleGroup
- */
-
+//#endregion
+//#region src/rule-evaluator.d.ts
 /**
  * Evaluates a RuleGroup (which may contain nested RuleGroups) against a context object.
  *
@@ -397,24 +396,12 @@ declare function renderTemplate(template: string, context: Record<string, unknow
  * @returns true if the rule group passes, false otherwise
  */
 declare function evaluateRuleGroup(ruleGroup: RuleGroup, context: Record<string, unknown>): boolean;
-
-/**
- * InstructionBuilder: Resolves an array of AgentInstructionBlock items
- * into a final instruction string.
- *
- * For each block:
- *  - `{ type: 'text', content }` → render template with context
- *  - `{ type: 'prompt_block_ref', id }` → fetch from storage, evaluate rules, render template
- *  - `{ type: 'prompt_block', content, rules? }` → inline block, evaluate rules, render template
- *
- * Blocks that fail rule evaluation are excluded.
- * Resolved text segments are joined with double newlines.
- */
-
+//#endregion
+//#region src/instruction-builder.d.ts
 interface InstructionBuilderDeps {
-    promptBlocksStorage: PromptBlocksStorage;
-    /** When true, include draft (unpublished) prompt block refs. Used for preview mode. */
-    includeDrafts?: boolean;
+  promptBlocksStorage: PromptBlocksStorage;
+  /** When true, include draft (unpublished) prompt block refs. Used for preview mode. */
+  includeDrafts?: boolean;
 }
 /**
  * Resolves an array of instruction blocks into a final instruction string.
@@ -425,155 +412,151 @@ interface InstructionBuilderDeps {
  * @returns The resolved instruction string
  */
 declare function resolveInstructionBlocks(blocks: AgentInstructionBlock[], context: Record<string, unknown>, deps: InstructionBuilderDeps): Promise<string>;
-
-/**
- * Built-in workspace provider descriptors.
- *
- * These are auto-registered by MastraEditor and always available.
- * External providers (S3, GCS, E2B) are supplied via MastraEditorConfig.
- */
-
+//#endregion
+//#region src/providers.d.ts
 declare const localFilesystemProvider: FilesystemProvider<{
-    basePath: string;
-    contained?: boolean;
-    readOnly?: boolean;
+  basePath: string;
+  contained?: boolean;
+  readOnly?: boolean;
 }>;
 declare const localSandboxProvider: SandboxProvider<{
-    workingDirectory?: string;
-    timeout?: number;
-    isolation?: 'none' | 'seatbelt' | 'bwrap';
-    env?: Record<string, string>;
+  workingDirectory?: string;
+  timeout?: number;
+  isolation?: 'none' | 'seatbelt' | 'bwrap';
+  env?: Record<string, string>;
 }>;
-
+//#endregion
+//#region src/index.d.ts
 declare class MastraEditor implements IMastraEditor {
-    /** @internal — exposed for namespace classes, not part of public API */
-    __mastra?: Mastra;
-    /** @internal — exposed for namespace classes, not part of public API */
-    __logger?: IMastraLogger;
-    private __toolProviders;
-    private __processorProviders;
-    private __source?;
-    private __codePath;
-    private __sourceControlProvider?;
-    private readonly __builderConfig?;
-    private __builderInstance?;
-    private __builderResolved;
-    /**
-     * @internal — exposed for namespace classes to hydrate stored workspace configs.
-     * Maps provider ID (e.g., 'local', 's3') to the provider descriptor.
-     * Built-in providers are auto-registered; additional providers come from config.
-     */
-    readonly __filesystems: Map<string, FilesystemProvider>;
-    /**
-     * @internal — exposed for namespace classes to hydrate stored workspace configs.
-     * Maps provider ID (e.g., 'local', 'e2b') to the provider descriptor.
-     * Built-in providers are auto-registered; additional providers come from config.
-     */
-    readonly __sandboxes: Map<string, SandboxProvider>;
-    /**
-     * @internal — exposed for namespace classes to resolve blob stores.
-     * Maps provider ID (e.g., 'storage', 's3') to the provider descriptor.
-     * The built-in 'storage' provider uses the configured storage backend.
-     * Additional providers come from config.
-     */
-    readonly __blobStores: Map<string, BlobStoreProvider>;
-    /**
-     * @internal — exposed for namespace classes to hydrate stored browser configs.
-     * Maps provider ID (e.g., 'stagehand', 'agent-browser') to the provider descriptor.
-     * No built-in providers — browser packages must be registered via config.
-     */
-    readonly __browsers: Map<string, BrowserProvider>;
-    /**
-     * @internal — exposed for namespace classes to hydrate stored workspace configs.
-     * Maps provider ID to the provider descriptor.
-     * No built-in providers — workspace providers must be registered via config.
-     */
-    readonly __workspaces: Map<string, WorkspaceProvider>;
-    readonly agent: EditorAgentNamespace;
-    readonly mcp: EditorMCPNamespace;
-    readonly mcpServer: EditorMCPServerNamespace;
-    readonly prompt: EditorPromptNamespace;
-    readonly scorer: EditorScorerNamespace;
-    readonly workspace: EditorWorkspaceNamespace;
-    readonly skill: EditorSkillNamespace;
-    readonly favorites: EditorFavoritesNamespace;
-    constructor(config?: MastraEditorConfig);
-    /**
-     * Register this editor with a Mastra instance.
-     * This gives the editor access to Mastra's storage, tools, workflows, etc.
-     */
-    registerWithMastra(mastra: Mastra): void;
-    /**
-     * Ensure the builder default workspace is persisted to the DB.
-     * Called automatically on startup when the editor registers with Mastra.
-     * Goes through the normal create() path so hydration validates that
-     * all providers (filesystem, sandbox) are properly registered.
-     *
-     * If the workspace already exists but its config has drifted from the
-     * runtime workspace, the DB record is updated (creating a new version).
-     * Builder-created workspaces are tagged with `metadata.source = 'builder'`
-     * so they can be identified during reconciliation.
-     */
-    private ensureBuilderWorkspaces;
-    /**
-     * Archive builder-created workspaces that no longer match the current
-     * builder configuration. Called after `ensureBuilderWorkspaces()` on startup.
-     *
-     * Only touches workspaces tagged with `metadata.source === 'builder'`.
-     * The current builder workspace (if any) is never archived.
-     */
-    private reconcileBuilderWorkspaces;
-    /**
-     * Sync. OSS-safe. Does NOT import @mastra/editor/ee.
-     * Returns true if builder config is present and enabled.
-     */
-    hasEnabledBuilderConfig(): boolean;
-    /**
-     * Async. Dynamic-imports @mastra/editor/ee on first call. Caches result.
-     * Returns undefined if builder is not enabled.
-     */
-    resolveBuilder(): Promise<IAgentBuilder | undefined>;
-    /**
-     * Defense-in-depth license guard for the Agent Builder. Mirrors the
-     * startup-time check in `MastraServer.validateAgentBuilderLicense()` so the
-     * builder cannot be instantiated outside the server boot path without a
-     * valid EE license. Dev environments bypass via `isEEEnabled()`.
-     */
-    private assertAgentBuilderLicensed;
-    /** Returns the editor's configured source, or undefined if unset. */
-    getSource(): 'code' | 'db' | undefined;
-    /** Returns the configured source control provider, if any. */
-    getSourceControlProvider(): SourceControlProvider | undefined;
-    /** Registered tool providers */
-    getToolProvider(id: string): ToolProvider | undefined;
-    /**
-     * Like {@link getToolProvider}, but throws {@link UnknownToolProviderError}
-     * when the id is unknown.
-     */
-    getToolProviderOrThrow(id: string): ToolProvider;
-    /** 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 */
-    getSandboxProviders(): SandboxProvider[];
-    /** List all registered blob store providers */
-    getBlobStoreProviders(): BlobStoreProvider[];
-    /**
-     * Resolve a blob store from the provider registry, or fall back to the
-     * storage backend's blobs domain.
-     *
-     * @param providerId - If specified, look up a registered provider by ID
-     *   and create a blob store from the given config. If omitted, falls back
-     *   to `storage.getStore('blobs')`.
-     * @param providerConfig - Provider-specific configuration (only used when
-     *   `providerId` is specified).
-     */
-    resolveBlobStore(providerId?: string, providerConfig?: Record<string, unknown>): Promise<BlobStore>;
+  /** @internal — exposed for namespace classes, not part of public API */
+  __mastra?: Mastra;
+  /** @internal — exposed for namespace classes, not part of public API */
+  __logger?: IMastraLogger;
+  private __toolProviders;
+  private __processorProviders;
+  private __source?;
+  private __codePath;
+  private __sourceControlProvider?;
+  private readonly __builderConfig?;
+  private __builderInstance?;
+  private __builderResolved;
+  /**
+   * @internal — exposed for namespace classes to hydrate stored workspace configs.
+   * Maps provider ID (e.g., 'local', 's3') to the provider descriptor.
+   * Built-in providers are auto-registered; additional providers come from config.
+   */
+  readonly __filesystems: Map<string, FilesystemProvider>;
+  /**
+   * @internal — exposed for namespace classes to hydrate stored workspace configs.
+   * Maps provider ID (e.g., 'local', 'e2b') to the provider descriptor.
+   * Built-in providers are auto-registered; additional providers come from config.
+   */
+  readonly __sandboxes: Map<string, SandboxProvider>;
+  /**
+   * @internal — exposed for namespace classes to resolve blob stores.
+   * Maps provider ID (e.g., 'storage', 's3') to the provider descriptor.
+   * The built-in 'storage' provider uses the configured storage backend.
+   * Additional providers come from config.
+   */
+  readonly __blobStores: Map<string, BlobStoreProvider>;
+  /**
+   * @internal — exposed for namespace classes to hydrate stored browser configs.
+   * Maps provider ID (e.g., 'stagehand', 'agent-browser') to the provider descriptor.
+   * No built-in providers — browser packages must be registered via config.
+   */
+  readonly __browsers: Map<string, BrowserProvider$1>;
+  /**
+   * @internal — exposed for namespace classes to hydrate stored workspace configs.
+   * Maps provider ID to the provider descriptor.
+   * No built-in providers — workspace providers must be registered via config.
+   */
+  readonly __workspaces: Map<string, WorkspaceProvider>;
+  readonly agent: EditorAgentNamespace;
+  readonly mcp: EditorMCPNamespace;
+  readonly mcpServer: EditorMCPServerNamespace;
+  readonly prompt: EditorPromptNamespace;
+  readonly scorer: EditorScorerNamespace;
+  readonly workspace: EditorWorkspaceNamespace;
+  readonly skill: EditorSkillNamespace;
+  readonly favorites: EditorFavoritesNamespace;
+  constructor(config?: MastraEditorConfig);
+  /**
+   * Register this editor with a Mastra instance.
+   * This gives the editor access to Mastra's storage, tools, workflows, etc.
+   */
+  registerWithMastra(mastra: Mastra): void;
+  /**
+   * Ensure the builder default workspace is persisted to the DB.
+   * Called automatically on startup when the editor registers with Mastra.
+   * Goes through the normal create() path so hydration validates that
+   * all providers (filesystem, sandbox) are properly registered.
+   *
+   * If the workspace already exists but its config has drifted from the
+   * runtime workspace, the DB record is updated (creating a new version).
+   * Builder-created workspaces are tagged with `metadata.source = 'builder'`
+   * so they can be identified during reconciliation.
+   */
+  private ensureBuilderWorkspaces;
+  /**
+   * Archive builder-created workspaces that no longer match the current
+   * builder configuration. Called after `ensureBuilderWorkspaces()` on startup.
+   *
+   * Only touches workspaces tagged with `metadata.source === 'builder'`.
+   * The current builder workspace (if any) is never archived.
+   */
+  private reconcileBuilderWorkspaces;
+  /**
+   * Sync. OSS-safe. Does NOT import @mastra/editor/ee.
+   * Returns true if builder config is present and enabled.
+   */
+  hasEnabledBuilderConfig(): boolean;
+  /**
+   * Async. Dynamic-imports @mastra/editor/ee on first call. Caches result.
+   * Returns undefined if builder is not enabled.
+   */
+  resolveBuilder(): Promise<IAgentBuilder | undefined>;
+  /**
+   * Defense-in-depth license guard for the Agent Builder. Mirrors the
+   * startup-time check in `MastraServer.validateAgentBuilderLicense()` so the
+   * builder cannot be instantiated outside the server boot path without a
+   * valid EE license. Dev environments bypass via `isEEEnabled()`.
+   */
+  private assertAgentBuilderLicensed;
+  /** Returns the editor's configured source, or undefined if unset. */
+  getSource(): 'code' | 'db' | undefined;
+  /** Returns the configured source control provider, if any. */
+  getSourceControlProvider(): SourceControlProvider | undefined;
+  /** Registered tool providers */
+  getToolProvider(id: string): ToolProvider | undefined;
+  /**
+   * Like {@link getToolProvider}, but throws {@link UnknownToolProviderError}
+   * when the id is unknown.
+   */
+  getToolProviderOrThrow(id: string): ToolProvider;
+  /** 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 */
+  getSandboxProviders(): SandboxProvider[];
+  /** List all registered blob store providers */
+  getBlobStoreProviders(): BlobStoreProvider[];
+  /**
+   * Resolve a blob store from the provider registry, or fall back to the
+   * storage backend's blobs domain.
+   *
+   * @param providerId - If specified, look up a registered provider by ID
+   *   and create a blob store from the given config. If omitted, falls back
+   *   to `storage.getStore('blobs')`.
+   * @param providerConfig - Provider-specific configuration (only used when
+   *   `providerId` is specified).
+   */
+  resolveBlobStore(providerId?: string, providerConfig?: Record<string, unknown>): Promise<BlobStore>;
 }
-
-export { CrudEditorNamespace, EditorAgentNamespace, EditorFavoritesNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };
+//#endregion
+export { type BrowserProvider, CrudEditorNamespace, EditorAgentNamespace, EditorFavoritesNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type MastraEditorConfig, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };
+//# sourceMappingURL=index.d.cts.map