@mastra/editor 0.9.0-alpha.1 → 0.9.0-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @mastra/editor
 
+## 0.9.0-alpha.2
+
+### Minor Changes
+
+- Added an `editor.favorites` namespace so direct (non-HTTP) callers can favorite, unfavorite, and query favorited stored agents/skills through the editor instance. ([#16749](https://github.com/mastra-ai/mastra/pull/16749))
+
+  ```ts
+  import { MastraEditor } from '@mastra/editor';
+
+  const editor = new MastraEditor({ mastra });
+
+  // Toggle
+  await editor.favorites.favorite({ userId, entityType: 'agent', entityId });
+  await editor.favorites.unfavorite({ userId, entityType: 'agent', entityId });
+
+  // Lookups
+  const isFav = await editor.favorites.isFavorited({ userId, entityType: 'agent', entityId });
+  const favSet = await editor.favorites.isFavoritedBatch({ userId, entityType: 'agent', entityIds });
+  const ids = await editor.favorites.listFavoritedIds({ userId, entityType: 'agent' });
+  ```
+
+  The namespace performs the storage mutation only — visibility and ownership enforcement still belong to the caller (the HTTP route handlers in `@mastra/server` already do this).
+
+### Patch Changes
+
+- Updated dependencies [[`5556cc1`](https://github.com/mastra-ai/mastra/commit/5556cc1befec71518d84f826b3bfe3a079a9daf7), [`5499303`](https://github.com/mastra-ai/mastra/commit/54993032c1ebc09642625b78d2014e0cf84a3cae), [`e47bca7`](https://github.com/mastra-ai/mastra/commit/e47bca7b72866d3abd173b9f530ac4318113a8ff), [`0031d0f`](https://github.com/mastra-ai/mastra/commit/0031d0f13831d7843ac5d498734a7d92862e2ce3), [`3498b49`](https://github.com/mastra-ai/mastra/commit/3498b4946be94f4313cd817733589680dcda5278), [`359439b`](https://github.com/mastra-ai/mastra/commit/359439bb8c635e048176306828195f8297f50021)]:
+  - @mastra/core@1.36.0-alpha.3
+
 ## 0.9.0-alpha.1
 
 ### Minor Changes

package/dist/index.cjs

@@ -32,6 +32,7 @@ var index_exports = {};
 __export(index_exports, {
   CrudEditorNamespace: () => CrudEditorNamespace,
   EditorAgentNamespace: () => EditorAgentNamespace,
+  EditorFavoritesNamespace: () => EditorFavoritesNamespace,
   EditorMCPNamespace: () => EditorMCPNamespace,
   EditorMCPServerNamespace: () => EditorMCPServerNamespace,
   EditorNamespace: () => EditorNamespace,
@@ -1958,6 +1959,59 @@ var EditorSkillNamespace = class extends CrudEditorNamespace {
   }
 };
 
+// src/namespaces/favorites.ts
+var EditorFavoritesNamespace = class extends EditorNamespace {
+  async favorite(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.favorite({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityId: input.entityId
+    });
+  }
+  async unfavorite(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.unfavorite({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityId: input.entityId
+    });
+  }
+  async isFavorited(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.isFavorited({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityId: input.entityId
+    });
+  }
+  async isFavoritedBatch(input) {
+    this.ensureRegistered();
+    if (input.entityIds.length === 0) return /* @__PURE__ */ new Set();
+    const store = await this.getFavoritesStore();
+    return store.isFavoritedBatch({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityIds: input.entityIds
+    });
+  }
+  async listFavoritedIds(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.listFavoritedIds({ userId: input.userId, entityType: input.entityType });
+  }
+  async getFavoritesStore() {
+    const storage = this.mastra?.getStorage();
+    if (!storage) throw new Error("Storage is not configured");
+    const store = await storage.getStore("favorites");
+    if (!store) throw new Error("Favorites storage domain is not available");
+    return store;
+  }
+};
+
 // src/providers.ts
 var import_workspace5 = require("@mastra/core/workspace");
 var import_workspace6 = require("@mastra/core/workspace");
@@ -2036,6 +2090,7 @@ var MastraEditor = class {
     this.scorer = new EditorScorerNamespace(this);
     this.workspace = new EditorWorkspaceNamespace(this);
     this.skill = new EditorSkillNamespace(this);
+    this.favorites = new EditorFavoritesNamespace(this);
   }
   /**
    * Register this editor with a Mastra instance.
@@ -2108,6 +2163,7 @@ var MastraEditor = class {
 0 && (module.exports = {
   CrudEditorNamespace,
   EditorAgentNamespace,
+  EditorFavoritesNamespace,
   EditorMCPNamespace,
   EditorMCPServerNamespace,
   EditorNamespace,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { Mastra } from '@mastra/core';
-import { GetByIdOptions, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, MastraEditorConfig } from '@mastra/core/editor';
+import { GetByIdOptions, IEditorFavoritesNamespace, EditorFavoriteTargetInput, EditorFavoriteToggleResult, EditorIsFavoritedBatchInput, EditorListFavoritedIdsInput, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, MastraEditorConfig } from '@mastra/core/editor';
 export { MastraEditorConfig } from '@mastra/core/editor';
 import { IMastraLogger } from '@mastra/core/logger';
 import { ProcessorProvider } from '@mastra/core/processor-provider';
@@ -310,6 +310,23 @@ declare class EditorSkillNamespace extends CrudEditorNamespace<StorageCreateSkil
     publish(skillId: string, source: SkillSource, skillPath: string): Promise<StorageResolvedSkillType>;
 }
 
+/**
+ * Favorites namespace.
+ *
+ * Verifies the target entity exists and performs the storage mutation.
+ * Visibility / ownership enforcement (`assertReadAccess`) lives at the
+ * route handler in `@mastra/server`. Direct callers of this namespace must
+ * 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;
+}
+
 /**
  * TemplateEngine: Simple variable interpolation for prompt block content.
  *
@@ -428,6 +445,7 @@ declare class MastraEditor implements IMastraEditor {
     readonly scorer: EditorScorerNamespace;
     readonly workspace: EditorWorkspaceNamespace;
     readonly skill: EditorSkillNamespace;
+    readonly favorites: EditorFavoritesNamespace;
     constructor(config?: MastraEditorConfig);
     /**
      * Register this editor with a Mastra instance.
@@ -461,4 +479,4 @@ declare class MastraEditor implements IMastraEditor {
     resolveBlobStore(providerId?: string, providerConfig?: Record<string, unknown>): Promise<BlobStore>;
 }
 
-export { CrudEditorNamespace, EditorAgentNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };
+export { CrudEditorNamespace, EditorAgentNamespace, EditorFavoritesNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Mastra } from '@mastra/core';
-import { GetByIdOptions, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, MastraEditorConfig } from '@mastra/core/editor';
+import { GetByIdOptions, IEditorFavoritesNamespace, EditorFavoriteTargetInput, EditorFavoriteToggleResult, EditorIsFavoritedBatchInput, EditorListFavoritedIdsInput, FilesystemProvider, SandboxProvider, IMastraEditor, BlobStoreProvider, MastraEditorConfig } from '@mastra/core/editor';
 export { MastraEditorConfig } from '@mastra/core/editor';
 import { IMastraLogger } from '@mastra/core/logger';
 import { ProcessorProvider } from '@mastra/core/processor-provider';
@@ -310,6 +310,23 @@ declare class EditorSkillNamespace extends CrudEditorNamespace<StorageCreateSkil
     publish(skillId: string, source: SkillSource, skillPath: string): Promise<StorageResolvedSkillType>;
 }
 
+/**
+ * Favorites namespace.
+ *
+ * Verifies the target entity exists and performs the storage mutation.
+ * Visibility / ownership enforcement (`assertReadAccess`) lives at the
+ * route handler in `@mastra/server`. Direct callers of this namespace must
+ * 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;
+}
+
 /**
  * TemplateEngine: Simple variable interpolation for prompt block content.
  *
@@ -428,6 +445,7 @@ declare class MastraEditor implements IMastraEditor {
     readonly scorer: EditorScorerNamespace;
     readonly workspace: EditorWorkspaceNamespace;
     readonly skill: EditorSkillNamespace;
+    readonly favorites: EditorFavoritesNamespace;
     constructor(config?: MastraEditorConfig);
     /**
      * Register this editor with a Mastra instance.
@@ -461,4 +479,4 @@ declare class MastraEditor implements IMastraEditor {
     resolveBlobStore(providerId?: string, providerConfig?: Record<string, unknown>): Promise<BlobStore>;
 }
 
-export { CrudEditorNamespace, EditorAgentNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };
+export { CrudEditorNamespace, EditorAgentNamespace, EditorFavoritesNamespace, EditorMCPNamespace, EditorMCPServerNamespace, EditorNamespace, EditorPromptNamespace, EditorScorerNamespace, EditorSkillNamespace, EditorWorkspaceNamespace, MastraEditor, type StorageAdapter, evaluateRuleGroup, localFilesystemProvider, localSandboxProvider, renderTemplate, resolveInstructionBlocks };

package/dist/index.js

@@ -1910,6 +1910,59 @@ var EditorSkillNamespace = class extends CrudEditorNamespace {
   }
 };
 
+// src/namespaces/favorites.ts
+var EditorFavoritesNamespace = class extends EditorNamespace {
+  async favorite(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.favorite({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityId: input.entityId
+    });
+  }
+  async unfavorite(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.unfavorite({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityId: input.entityId
+    });
+  }
+  async isFavorited(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.isFavorited({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityId: input.entityId
+    });
+  }
+  async isFavoritedBatch(input) {
+    this.ensureRegistered();
+    if (input.entityIds.length === 0) return /* @__PURE__ */ new Set();
+    const store = await this.getFavoritesStore();
+    return store.isFavoritedBatch({
+      userId: input.userId,
+      entityType: input.entityType,
+      entityIds: input.entityIds
+    });
+  }
+  async listFavoritedIds(input) {
+    this.ensureRegistered();
+    const store = await this.getFavoritesStore();
+    return store.listFavoritedIds({ userId: input.userId, entityType: input.entityType });
+  }
+  async getFavoritesStore() {
+    const storage = this.mastra?.getStorage();
+    if (!storage) throw new Error("Storage is not configured");
+    const store = await storage.getStore("favorites");
+    if (!store) throw new Error("Favorites storage domain is not available");
+    return store;
+  }
+};
+
 // src/providers.ts
 import { LocalFilesystem } from "@mastra/core/workspace";
 import { LocalSandbox } from "@mastra/core/workspace";
@@ -1988,6 +2041,7 @@ var MastraEditor = class {
     this.scorer = new EditorScorerNamespace(this);
     this.workspace = new EditorWorkspaceNamespace(this);
     this.skill = new EditorSkillNamespace(this);
+    this.favorites = new EditorFavoritesNamespace(this);
   }
   /**
    * Register this editor with a Mastra instance.
@@ -2059,6 +2113,7 @@ var MastraEditor = class {
 export {
   CrudEditorNamespace,
   EditorAgentNamespace,
+  EditorFavoritesNamespace,
   EditorMCPNamespace,
   EditorMCPServerNamespace,
   EditorNamespace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/editor",
-  "version": "0.9.0-alpha.1",
+  "version": "0.9.0-alpha.2",
   "description": "Mastra Editor for agent management and instantiation",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -77,11 +77,11 @@
     "zod": "^3.25.76",
     "@internal/ai-sdk-v4": "0.0.43",
     "@internal/ai-sdk-v5": "0.0.43",
-    "@mastra/hono": "1.4.18-alpha.2",
-    "@mastra/core": "1.36.0-alpha.2",
     "@internal/ai-v6": "0.0.43",
+    "@mastra/hono": "1.4.18-alpha.3",
     "@mastra/libsql": "1.11.0",
-    "@mastra/mcp": "1.7.1-alpha.0"
+    "@mastra/mcp": "1.7.1-alpha.0",
+    "@mastra/core": "1.36.0-alpha.3"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.13.2-0 <2.0.0-0",