@mastra/editor 0.8.2-alpha.0 → 0.9.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @mastra/editor
 
+## 0.9.0-alpha.1
+
+### Minor Changes
+
+- `EditorWorkspaceNamespace` can now snapshot a live `Workspace` for persistence — the reverse of `hydrateSnapshotToWorkspace()`: ([#16673](https://github.com/mastra-ai/mastra/pull/16673))
+
+  ```ts
+  const snapshot = await editor.workspace.snapshotFromWorkspace(runtimeWorkspace);
+  await editor.workspace.create({ id: 'my-workspace', ...snapshot });
+  ```
+
+  `snapshotFromWorkspace()` is `async` and awaits `sandbox.getInfo()` and `filesystem.getInfo()` so async providers like `CompositeFilesystem` keep their mount metadata in the stored config.
+
+  Also includes two smaller behavioral fixes:
+  - `EditorSkillNamespace.publishSkillFromSource()` stores the new `files` field on the published skill version and strips `undefined` keys before calling `update()` (libsql/pg adapters reject `undefined` bind arguments).
+  - `CrudEditorNamespace.clearCache(id)` always calls `onCacheEvict(id)`, even when the entity wasn't cached, so subclasses can clean up runtime registries for version-specific lookups that bypass the editor cache.
+
+### Patch Changes
+
+- Updated dependencies [[`5ba7253`](https://github.com/mastra-ai/mastra/commit/5ba7253745c85e8df8012a76d954c640ffa336f7), [`f73980d`](https://github.com/mastra-ai/mastra/commit/f73980d651eb5f7f1ab20582de4615a1b6f10fce), [`9c88701`](https://github.com/mastra-ai/mastra/commit/9c8870195b41a38dc40b6ba2aa55eda04df8fa69), [`4e88dc6`](https://github.com/mastra-ai/mastra/commit/4e88dc6b89f154c0eae37221c8126be0c23c569f), [`19018f0`](https://github.com/mastra-ai/mastra/commit/19018f05722af74a5978781a7731a654b26f7f2a)]:
+  - @mastra/core@1.36.0-alpha.2
+
 ## 0.8.2-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -154,11 +154,8 @@ var CrudEditorNamespace = class extends EditorNamespace {
    */
   clearCache(id) {
     if (id) {
-      const wasCached = this._cache.has(id);
       this._cache.delete(id);
-      if (wasCached) {
-        this.onCacheEvict(id);
-      }
+      this.onCacheEvict(id);
       this.logger?.debug(`[clearCache] Cleared cache for "${id}"`);
     } else {
       for (const cachedId of Array.from(this._cache.keys())) {
@@ -1804,6 +1801,59 @@ var EditorWorkspaceNamespace = class extends CrudEditorNamespace {
     }
     return new import_workspace2.Workspace(config);
   }
+  /**
+   * 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.
+   */
+  async snapshotFromWorkspace(workspace) {
+    const snapshot = {
+      name: workspace.name
+    };
+    const fs = workspace.filesystem;
+    if (fs) {
+      if (fs instanceof import_workspace2.CompositeFilesystem) {
+        const mounts = {};
+        for (const [mountPath, mountedFs] of fs.mounts) {
+          mounts[mountPath] = await this.serializeFilesystem(mountedFs);
+        }
+        snapshot.mounts = mounts;
+      } else {
+        snapshot.filesystem = await this.serializeFilesystem(fs);
+      }
+    }
+    const sandbox = workspace.sandbox;
+    if (sandbox) {
+      const info = typeof sandbox.getInfo === "function" ? await sandbox.getInfo() : void 0;
+      snapshot.sandbox = {
+        provider: sandbox.provider,
+        config: info?.metadata ?? {}
+      };
+    }
+    const tools = workspace.getToolsConfig();
+    if (tools) {
+      const storageTools = {};
+      if (typeof tools.enabled === "boolean") storageTools.enabled = tools.enabled;
+      if (typeof tools.requireApproval === "boolean") storageTools.requireApproval = tools.requireApproval;
+      if (Object.keys(storageTools).length > 0) {
+        snapshot.tools = storageTools;
+      }
+    }
+    return snapshot;
+  }
+  /**
+   * Serialize a runtime WorkspaceFilesystem into a StorageFilesystemConfig.
+   * Awaits getInfo() so async providers like CompositeFilesystem keep their mount metadata.
+   */
+  async serializeFilesystem(fs) {
+    const info = typeof fs.getInfo === "function" ? await fs.getInfo() : void 0;
+    const metadata = info && typeof info === "object" && "metadata" in info ? info.metadata : void 0;
+    return {
+      provider: fs.provider,
+      config: metadata ?? {},
+      readOnly: fs.readOnly
+    };
+  }
   /**
    * 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).
@@ -1880,11 +1930,16 @@ var EditorSkillNamespace = class extends CrudEditorNamespace {
     const blobStore = await this.editor.resolveBlobStore();
     if (!blobStore)
       throw new Error("No blob store is configured. Register one via new MastraEditor({ blobStores: [...] })");
-    const { snapshot, tree } = await (0, import_workspace3.publishSkillFromSource)(source, skillPath, blobStore);
+    const { snapshot, tree, files } = await (0, import_workspace3.publishSkillFromSource)(source, skillPath, blobStore);
+    const snapshotUpdate = {};
+    for (const [key, value] of Object.entries(snapshot)) {
+      if (value !== void 0) snapshotUpdate[key] = value;
+    }
     await skillStore.update({
       id: skillId,
-      ...snapshot,
+      ...snapshotUpdate,
       tree,
+      files,
       status: "published"
     });
     const latestVersion = await skillStore.getLatestVersion(skillId);

package/dist/index.d.cts

@@ -275,6 +275,17 @@ declare class EditorWorkspaceNamespace extends CrudEditorNamespace<StorageCreate
     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).

package/dist/index.d.ts

@@ -275,6 +275,17 @@ declare class EditorWorkspaceNamespace extends CrudEditorNamespace<StorageCreate
     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).

package/dist/index.js

@@ -106,11 +106,8 @@ var CrudEditorNamespace = class extends EditorNamespace {
    */
   clearCache(id) {
     if (id) {
-      const wasCached = this._cache.has(id);
       this._cache.delete(id);
-      if (wasCached) {
-        this.onCacheEvict(id);
-      }
+      this.onCacheEvict(id);
       this.logger?.debug(`[clearCache] Cleared cache for "${id}"`);
     } else {
       for (const cachedId of Array.from(this._cache.keys())) {
@@ -1683,7 +1680,7 @@ Explain your reasoning for this score in a clear, concise paragraph.`;
 };
 
 // src/namespaces/workspace.ts
-import { Workspace as Workspace2 } from "@mastra/core/workspace";
+import { Workspace as Workspace2, CompositeFilesystem } from "@mastra/core/workspace";
 var EditorWorkspaceNamespace = class extends CrudEditorNamespace {
   onCacheEvict(_id) {
   }
@@ -1756,6 +1753,59 @@ var EditorWorkspaceNamespace = class extends CrudEditorNamespace {
     }
     return new Workspace2(config);
   }
+  /**
+   * 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.
+   */
+  async snapshotFromWorkspace(workspace) {
+    const snapshot = {
+      name: workspace.name
+    };
+    const fs = workspace.filesystem;
+    if (fs) {
+      if (fs instanceof CompositeFilesystem) {
+        const mounts = {};
+        for (const [mountPath, mountedFs] of fs.mounts) {
+          mounts[mountPath] = await this.serializeFilesystem(mountedFs);
+        }
+        snapshot.mounts = mounts;
+      } else {
+        snapshot.filesystem = await this.serializeFilesystem(fs);
+      }
+    }
+    const sandbox = workspace.sandbox;
+    if (sandbox) {
+      const info = typeof sandbox.getInfo === "function" ? await sandbox.getInfo() : void 0;
+      snapshot.sandbox = {
+        provider: sandbox.provider,
+        config: info?.metadata ?? {}
+      };
+    }
+    const tools = workspace.getToolsConfig();
+    if (tools) {
+      const storageTools = {};
+      if (typeof tools.enabled === "boolean") storageTools.enabled = tools.enabled;
+      if (typeof tools.requireApproval === "boolean") storageTools.requireApproval = tools.requireApproval;
+      if (Object.keys(storageTools).length > 0) {
+        snapshot.tools = storageTools;
+      }
+    }
+    return snapshot;
+  }
+  /**
+   * Serialize a runtime WorkspaceFilesystem into a StorageFilesystemConfig.
+   * Awaits getInfo() so async providers like CompositeFilesystem keep their mount metadata.
+   */
+  async serializeFilesystem(fs) {
+    const info = typeof fs.getInfo === "function" ? await fs.getInfo() : void 0;
+    const metadata = info && typeof info === "object" && "metadata" in info ? info.metadata : void 0;
+    return {
+      provider: fs.provider,
+      config: metadata ?? {},
+      readOnly: fs.readOnly
+    };
+  }
   /**
    * 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).
@@ -1832,11 +1882,16 @@ var EditorSkillNamespace = class extends CrudEditorNamespace {
     const blobStore = await this.editor.resolveBlobStore();
     if (!blobStore)
       throw new Error("No blob store is configured. Register one via new MastraEditor({ blobStores: [...] })");
-    const { snapshot, tree } = await publishSkillFromSource(source, skillPath, blobStore);
+    const { snapshot, tree, files } = await publishSkillFromSource(source, skillPath, blobStore);
+    const snapshotUpdate = {};
+    for (const [key, value] of Object.entries(snapshot)) {
+      if (value !== void 0) snapshotUpdate[key] = value;
+    }
     await skillStore.update({
       id: skillId,
-      ...snapshot,
+      ...snapshotUpdate,
       tree,
+      files,
       status: "published"
     });
     const latestVersion = await skillStore.getLatestVersion(skillId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/editor",
-  "version": "0.8.2-alpha.0",
+  "version": "0.9.0-alpha.1",
   "description": "Mastra Editor for agent management and instantiation",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -65,8 +65,8 @@
     "@arcadeai/arcadejs": "^2.3.0",
     "@composio/core": "^0.6.5",
     "@composio/mastra": "^0.6.5",
-    "@mastra/schema-compat": "1.2.10",
-    "@mastra/memory": "1.18.3-alpha.0"
+    "@mastra/memory": "1.18.3-alpha.0",
+    "@mastra/schema-compat": "1.2.10"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -76,11 +76,11 @@
     "vitest": "4.1.5",
     "zod": "^3.25.76",
     "@internal/ai-sdk-v4": "0.0.43",
-    "@internal/ai-v6": "0.0.43",
     "@internal/ai-sdk-v5": "0.0.43",
-    "@mastra/hono": "1.4.18-alpha.0",
+    "@mastra/hono": "1.4.18-alpha.2",
+    "@mastra/core": "1.36.0-alpha.2",
+    "@internal/ai-v6": "0.0.43",
     "@mastra/libsql": "1.11.0",
-    "@mastra/core": "1.36.0-alpha.0",
     "@mastra/mcp": "1.7.1-alpha.0"
   },
   "peerDependencies": {