@dxos/plugin-registry 0.8.4-staging.60fe92afc8 → 0.9.1-main.c7dcc2e112

package/src/components/RegistrySettings/RegistrySettings.tsx

@@ -37,7 +37,7 @@ export const RegistrySettings = ({
   onEnableDev,
   onDisableDev,
 }: RegistrySettingsProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const [busy, setBusy] = useState(false);
   const enabled = !!settings.devPluginEnabled;
   const url = settings.devPluginUrl ?? '';

package/src/containers/BaseRegistryArticle/BaseRegistryArticle.tsx

@@ -20,7 +20,7 @@ import { getPluginPath, meta } from '#meta';
 import { useDisableConfirmation } from '../../hooks';
 
 const matchesFilter = (plugin: Plugin.Plugin, query: string) => {
-  const haystack = `${plugin.meta.name ?? ''} ${plugin.meta.id}`.toLowerCase();
+  const haystack = `${plugin.meta.profile.name ?? ''} ${plugin.meta.profile.key}`.toLowerCase();
   return haystack.includes(query);
 };
 
@@ -67,7 +67,7 @@ export const BaseRegistryArticle = composable<HTMLDivElement, BaseRegistryArticl
     },
     forwardedRef,
   ) => {
-    const { t } = useTranslation(meta.id);
+    const { t } = useTranslation(meta.profile.key);
     const manager = usePluginManager();
     const { invoke, invokePromise } = useOperationInvoker();
     const allSettings = useCapabilities(AppCapabilities.Settings);

package/src/containers/LoadPluginDialog/LoadPluginDialog.tsx

@@ -12,11 +12,11 @@ import { Button, Dialog, Input, useTranslation } from '@dxos/react-ui';
 
 import { meta } from '../../meta';
 
-export const LOAD_PLUGIN_DIALOG = DXN.make(`${meta.id}.loadPluginDialog`);
+export const LOAD_PLUGIN_DIALOG = DXN.make(`${meta.profile.key}.loadPluginDialog`);
 
 export const LoadPluginDialog = () => {
   const manager = usePluginManager();
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const [url, setUrl] = useState('');
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
@@ -33,7 +33,7 @@ export const LoadPluginDialog = () => {
 
     void Effect.gen(function* () {
       const plugin = yield* manager.add(trimmed);
-      yield* manager.enable(plugin.meta.id);
+      yield* manager.enable(plugin.meta.profile.key);
       closeRef.current?.click();
     }).pipe(
       Effect.catchAll((err) =>

package/src/containers/PluginArticle/PluginArticle.tsx

@@ -24,19 +24,18 @@ import {
 export type PluginArticleProps = { subject: Plugin.Plugin };
 
 export const PluginArticle = ({ subject: plugin }: PluginArticleProps) => {
-  const pluginId = plugin.meta.id;
+  const pluginId = plugin.meta.profile.key;
   const manager = usePluginManager();
   const plugins = useAtomValue(manager.plugins);
   const remotePluginIds = useRemotePluginIds();
   const provider = useRegistryPluginProvider();
   const { invokePromise } = useOperationInvoker();
 
-  const { catalogEntry, moduleUrl, repo } = useCatalogEntry(pluginId);
+  const { catalogEntry, moduleUrl } = useCatalogEntry(pluginId);
   const { installedVersionTag, syncInstalledVersion } = useInstalledVersionTag(pluginId, plugins);
   const { pickerVersions, selectedVersionTag, setSelectedVersionTag } = useVersionPicker({
     provider,
     pluginId,
-    repo,
     moduleUrl,
     installedVersionTag,
   });
@@ -44,11 +43,14 @@ export const PluginArticle = ({ subject: plugin }: PluginArticleProps) => {
   const enabled = manager.getEnabled().includes(pluginId);
   const failed = useAtomValue(manager.failed);
   const failure = useMemo(() => failed.find((entry) => entry.id === pluginId), [failed, pluginId]);
-  const isInstalled = useMemo(() => plugins.some((candidate) => candidate.meta.id === pluginId), [plugins, pluginId]);
+  const isInstalled = useMemo(
+    () => plugins.some((candidate) => candidate.meta.profile.key === pluginId),
+    [plugins, pluginId],
+  );
   const isCore = manager.getCore().includes(pluginId);
   const canUninstall = isInstalled && !isCore && remotePluginIds.has(pluginId);
   const hasUpdate =
-    isInstalled && !!catalogEntry && !!installedVersionTag && installedVersionTag !== catalogEntry.version;
+    isInstalled && !!catalogEntry && !!installedVersionTag && installedVersionTag !== catalogEntry.release?.version;
 
   // Recompute graph slices whenever the plugin list changes, so installs /
   // removals through other surfaces (or this article's own actions) keep the
@@ -66,7 +68,7 @@ export const PluginArticle = ({ subject: plugin }: PluginArticleProps) => {
   // only loaded when it is activated, so the always-available `meta.name`
   // from the registered plugin set is the right source for chip labels.
   const handleResolvePluginName = useCallback(
-    (id: string): string => plugins.find((candidate) => candidate.meta.id === id)?.meta.name ?? id,
+    (id: string): string => plugins.find((candidate) => candidate.meta.profile.key === id)?.meta.profile.name ?? id,
     [plugins],
   );
 

package/src/containers/PublicRegistryArticle/PublicRegistryArticle.tsx

@@ -6,7 +6,7 @@ import { useAtomValue } from '@effect-atom/atom-react';
 import * as Effect from 'effect/Effect';
 import React, { useCallback, useMemo, useState } from 'react';
 
-import { type Registry, Plugin, UrlLoader } from '@dxos/app-framework';
+import { Plugin, UrlLoader } from '@dxos/app-framework';
 import { useOperationInvoker, usePluginManager } from '@dxos/app-framework/ui';
 import { EffectEx } from '@dxos/effect';
 import { DXN } from '@dxos/keys';
@@ -19,29 +19,30 @@ import { meta } from '#meta';
 import { useAutoTags, useRegistryPlugins, useUpdateAvailableIds } from '../../hooks';
 import { BaseRegistryArticle } from '../BaseRegistryArticle';
 
-const sortEntries = (a: Registry.Plugin, b: Registry.Plugin) => (a.name ?? a.id).localeCompare(b.name ?? b.id);
+const sortEntries = (a: Plugin.Meta, b: Plugin.Meta) =>
+  (a.profile.name ?? a.profile.key).localeCompare(b.profile.name ?? b.profile.key);
 
 const sortPlugins = (a: Plugin.Plugin, b: Plugin.Plugin) =>
-  (a.meta.name ?? a.meta.id).localeCompare(b.meta.name ?? b.meta.id);
+  (a.meta.profile.name ?? a.meta.profile.key).localeCompare(b.meta.profile.name ?? b.meta.profile.key);
 
 /**
  * Turns a registry catalog entry into a minimal Plugin object so we can reuse
  * {@link BaseRegistryArticle} for rendering. The synthesized plugin has no
  * modules — it exists only for display until the user installs it.
  */
-const toDisplayPlugin = (plugin: Registry.Plugin): Plugin.Plugin =>
+const toDisplayPlugin = (plugin: Plugin.Meta): Plugin.Plugin =>
   ({
     [Plugin.PluginTypeId]: Plugin.PluginTypeId,
     meta: Plugin.makeMeta({
-      key: DXN.make(plugin.id),
-      name: plugin.name,
-      description: plugin.description,
-      homePage: plugin.homePage,
-      source: plugin.source,
-      screenshots: plugin.screenshots,
-      tags: plugin.tags,
-      icon: plugin.icon,
-      iconHue: plugin.iconHue,
+      key: DXN.make(plugin.profile.key),
+      name: plugin.profile.name,
+      description: plugin.profile.description,
+      homePage: plugin.profile.homePage,
+      source: plugin.profile.source,
+      screenshots: plugin.profile.screenshots,
+      tags: plugin.profile.tags,
+      icon: plugin.profile.icon,
+      author: plugin.profile.author,
     }),
     modules: [],
   }) as Plugin.Plugin;
@@ -52,18 +53,18 @@ export type PublicRegistryArticleProps = {
 
 export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryArticleProps>(
   ({ id, ...props }, forwardedRef) => {
-    const { t } = useTranslation(meta.id);
+    const { t } = useTranslation(meta.profile.key);
     const manager = usePluginManager();
     const { invoke } = useOperationInvoker();
     const { entries, loading, error } = useRegistryPlugins();
     const plugins = useAtomValue(manager.plugins);
-    const installedIds = useMemo(() => plugins.map((plugin) => plugin.meta.id), [plugins]);
+    const installedIds = useMemo(() => plugins.map((plugin) => plugin.meta.profile.key), [plugins]);
     const extraTagsById = useAutoTags(entries);
 
     // Snapshot of installed plugin ids at mount time. Used to sort installed
     // plugins to the top without having newly-installed rows jump up mid-session.
     const [installedSnapshot] = useState<ReadonlySet<string>>(
-      () => new Set(manager.getPlugins().map((plugin) => plugin.meta.id)),
+      () => new Set(manager.getPlugins().map((plugin) => plugin.meta.profile.key)),
     );
 
     const [installingIds, setInstallingIds] = useState<readonly string[]>([]);
@@ -74,7 +75,9 @@ export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryAr
     const moduleUrlById = useMemo(() => {
       const map: Record<string, string> = {};
       for (const entry of sortedEntries) {
-        map[entry.id] = entry.moduleUrl;
+        if (entry.release?.moduleUrl) {
+          map[entry.profile.key] = entry.release.moduleUrl;
+        }
       }
       return map;
     }, [sortedEntries]);
@@ -83,7 +86,9 @@ export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryAr
     const versionById = useMemo(() => {
       const map: Record<string, string> = {};
       for (const entry of sortedEntries) {
-        map[entry.id] = entry.version;
+        if (entry.release?.version) {
+          map[entry.profile.key] = entry.release.version;
+        }
       }
       return map;
     }, [sortedEntries]);
@@ -92,13 +97,15 @@ export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryAr
     // is based on the mount-time snapshot so rows don't jump as the user
     // installs plugins during the session.
     const items = useMemo(() => {
-      const catalogIds = new Set(sortedEntries.map((entry) => entry.id));
+      const catalogIds = new Set(sortedEntries.map((entry) => entry.profile.key));
       const remoteIds = new Set(UrlLoader.getRemoteEntries().map((entry) => entry.id));
       const fromCatalog = sortedEntries.map(toDisplayPlugin);
-      const fromUrlOnly = plugins.filter((plugin) => remoteIds.has(plugin.meta.id) && !catalogIds.has(plugin.meta.id));
+      const fromUrlOnly = plugins.filter(
+        (plugin) => remoteIds.has(plugin.meta.profile.key) && !catalogIds.has(plugin.meta.profile.key),
+      );
       const installedFirst = [...fromCatalog, ...fromUrlOnly].sort((a, b) => {
-        const aInstalled = installedSnapshot.has(a.meta.id);
-        const bInstalled = installedSnapshot.has(b.meta.id);
+        const aInstalled = installedSnapshot.has(a.meta.profile.key);
+        const bInstalled = installedSnapshot.has(b.meta.profile.key);
         if (aInstalled !== bInstalled) {
           return aInstalled ? -1 : 1;
         }
@@ -117,14 +124,14 @@ export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryAr
         setInstallingIds((prev) => (prev.includes(pluginId) ? prev : [...prev, pluginId]));
         void Effect.gen(function* () {
           const plugin = yield* manager.add(moduleUrl);
-          yield* manager.enable(plugin.meta.id);
+          yield* manager.enable(plugin.meta.profile.key);
           // Persist the installed version for future update detection.
           if (version) {
-            UrlLoader.setInstalledVersion(plugin.meta.id, version);
+            UrlLoader.setInstalledVersion(plugin.meta.profile.key, version);
           }
           yield* invoke(ObservabilityOperation.SendEvent, {
             name: 'plugins.install',
-            properties: { plugin: plugin.meta.id, source: 'registry' },
+            properties: { plugin: plugin.meta.profile.key, source: 'registry' },
           });
         }).pipe(
           Effect.ensuring(Effect.sync(() => setInstallingIds((prev) => prev.filter((pid) => pid !== pluginId)))),
@@ -146,13 +153,13 @@ export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryAr
           // Unload the old version then re-install from the new URL.
           yield* manager.remove(pluginId);
           const plugin = yield* manager.add(moduleUrl);
-          yield* manager.enable(plugin.meta.id);
+          yield* manager.enable(plugin.meta.profile.key);
           if (version) {
-            UrlLoader.setInstalledVersion(plugin.meta.id, version);
+            UrlLoader.setInstalledVersion(plugin.meta.profile.key, version);
           }
           yield* invoke(ObservabilityOperation.SendEvent, {
             name: 'plugins.update',
-            properties: { plugin: plugin.meta.id, source: 'registry' },
+            properties: { plugin: plugin.meta.profile.key, source: 'registry' },
           });
         }).pipe(
           Effect.ensuring(Effect.sync(() => setUpdatingIds((prev) => prev.filter((pid) => pid !== pluginId)))),

package/src/containers/RegistryArticle/RegistryArticle.tsx

@@ -12,7 +12,7 @@ import { composable } from '@dxos/react-ui';
 import { BaseRegistryArticle } from '../BaseRegistryArticle';
 
 const sortByPluginMeta = (a: Plugin.Plugin, b: Plugin.Plugin) =>
-  (a.meta.name ?? a.meta.id).localeCompare(b.meta.name ?? b.meta.id);
+  (a.meta.profile.name ?? a.meta.profile.key).localeCompare(b.meta.profile.name ?? b.meta.profile.key);
 
 export type RegistryArticleProps = {
   id: string;

package/src/containers/RegistrySettingsContainer/RegistrySettingsContainer.tsx

@@ -33,7 +33,7 @@ export const RegistrySettingsContainer = ({ subject }: RegistrySettingsContainer
       await EffectEx.runAndForwardErrors(
         Effect.gen(function* () {
           const plugin = yield* manager.add(url);
-          yield* manager.enable(plugin.meta.id);
+          yield* manager.enable(plugin.meta.profile.key);
         }),
       );
     },

package/src/hooks/useAutoTags.ts

@@ -4,7 +4,7 @@
 
 import { useMemo } from 'react';
 
-import { type Registry, UrlLoader } from '@dxos/app-framework';
+import { type Plugin, UrlLoader } from '@dxos/app-framework';
 
 import { getRemotePluginIds } from '../categories';
 
@@ -21,7 +21,7 @@ export type AutoTagsMap = Record<string, readonly string[]>;
  * Reads the persisted remote-plugin entries synchronously to derive `local`, and
  * adds `registry` for any plugin id found in the supplied registry manifest entries.
  */
-export const useAutoTags = (registryEntries: readonly Registry.Plugin[]): AutoTagsMap =>
+export const useAutoTags = (registryEntries: readonly Plugin.Meta[]): AutoTagsMap =>
   useMemo(() => {
     const byId: Record<string, string[]> = {};
     const addTag = (id: string, tag: string) => {
@@ -39,7 +39,7 @@ export const useAutoTags = (registryEntries: readonly Registry.Plugin[]): AutoTa
       }
     }
     for (const entry of registryEntries) {
-      addTag(entry.id, 'registry');
+      addTag(entry.profile.key, 'registry');
     }
 
     return byId;

package/src/hooks/useCatalogEntry.ts

@@ -4,22 +4,21 @@
 
 import { useMemo } from 'react';
 
-import { type Registry } from '@dxos/app-framework';
+import { type Plugin } from '@dxos/app-framework';
 
 import { useRegistryPlugins } from './useRegistryPlugins';
 
 /**
- * Resolves the registry catalog entry for a plugin by id, plus the two fields
- * (`moduleUrl`, `repo`) the rest of the article cares about.
+ * Resolves the registry catalog entry for a plugin by id, plus the `moduleUrl`
+ * the install/update actions need.
  */
 export const useCatalogEntry = (
   pluginId: string,
 ): {
-  catalogEntry: Registry.Plugin | undefined;
+  catalogEntry: Plugin.Meta | undefined;
   moduleUrl: string | undefined;
-  repo: string | undefined;
 } => {
   const { entries } = useRegistryPlugins();
-  const catalogEntry = useMemo(() => entries.find((entry) => entry.id === pluginId), [entries, pluginId]);
-  return { catalogEntry, moduleUrl: catalogEntry?.moduleUrl, repo: catalogEntry?.repo };
+  const catalogEntry = useMemo(() => entries.find((entry) => entry.profile.key === pluginId), [entries, pluginId]);
+  return { catalogEntry, moduleUrl: catalogEntry?.release?.moduleUrl };
 };

package/src/hooks/useDisableConfirmation.ts

@@ -37,7 +37,7 @@ export const useDisableConfirmation = (manager: PluginManager.PluginManager, dis
         return;
       }
       const resolveName = (id: string): string =>
-        manager.getPlugins().find((plugin) => plugin.meta.id === id)?.meta.name ?? id;
+        manager.getPlugins().find((plugin) => plugin.meta.profile.key === id)?.meta.profile.name ?? id;
       void invokePromise(LayoutOperation.UpdateDialog, {
         subject: DISABLE_DEPENDENTS_DIALOG,
         state: true,

package/src/hooks/usePluginActions.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 import { useCallback, useState } from 'react';
 
-import { type PluginManager, type Registry, UrlLoader } from '@dxos/app-framework';
+import { type Plugin, type PluginManager, UrlLoader } from '@dxos/app-framework';
 import { useOperationInvoker } from '@dxos/app-framework/ui';
 import { LayoutOperation } from '@dxos/app-toolkit';
 import { useAppGraph } from '@dxos/app-toolkit/ui';
@@ -21,8 +21,8 @@ export type PluginActionsProps = {
   pluginId: string;
   isInstalled: boolean;
   moduleUrl: string | undefined;
-  catalogEntry: Registry.Plugin | undefined;
-  pickerVersions: readonly Registry.PluginVersion[];
+  catalogEntry: Plugin.Meta | undefined;
+  pickerVersions: readonly Plugin.Release[];
   selectedVersionTag: string | undefined;
   syncInstalledVersion: () => void;
 };
@@ -101,9 +101,9 @@ export const usePluginActions = ({
     setInstalling(true);
     void Effect.gen(function* () {
       const added = yield* manager.add(moduleUrl);
-      yield* manager.enable(added.meta.id);
-      if (catalogEntry) {
-        UrlLoader.setInstalledVersion(added.meta.id, catalogEntry.version);
+      yield* manager.enable(added.meta.profile.key);
+      if (catalogEntry?.release?.version) {
+        UrlLoader.setInstalledVersion(added.meta.profile.key, catalogEntry.release.version);
       }
     }).pipe(
       Effect.ensuring(
@@ -125,8 +125,10 @@ export const usePluginActions = ({
     void Effect.gen(function* () {
       yield* manager.remove(pluginId);
       const added = yield* manager.add(moduleUrl);
-      yield* manager.enable(added.meta.id);
-      UrlLoader.setInstalledVersion(added.meta.id, catalogEntry.version);
+      yield* manager.enable(added.meta.profile.key);
+      if (catalogEntry.release?.version) {
+        UrlLoader.setInstalledVersion(added.meta.profile.key, catalogEntry.release.version);
+      }
     }).pipe(
       Effect.ensuring(
         Effect.sync(() => {
@@ -139,7 +141,7 @@ export const usePluginActions = ({
   }, [manager, pluginId, moduleUrl, catalogEntry, syncInstalledVersion]);
 
   const handleInstallVersion = useCallback(() => {
-    const version = pickerVersions.find((candidate) => candidate.tag === selectedVersionTag);
+    const version = pickerVersions.find((candidate) => candidate.version === selectedVersionTag);
     if (!version || !version.moduleUrl) {
       return;
     }
@@ -151,8 +153,8 @@ export const usePluginActions = ({
         yield* manager.remove(pluginId);
       }
       const added = yield* manager.add(version.moduleUrl);
-      yield* manager.enable(added.meta.id);
-      UrlLoader.setInstalledVersion(added.meta.id, version.tag);
+      yield* manager.enable(added.meta.profile.key);
+      UrlLoader.setInstalledVersion(added.meta.profile.key, version.version);
     }).pipe(
       Effect.ensuring(
         Effect.sync(() => {

package/src/hooks/useUpdateAvailable.ts

@@ -2,7 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-import { type Registry, UrlLoader } from '@dxos/app-framework';
+import { type Plugin, UrlLoader } from '@dxos/app-framework';
 
 /**
  * Returns a set of plugin ids for which the registry has a newer version
@@ -19,12 +19,12 @@ import { type Registry, UrlLoader } from '@dxos/app-framework';
  * reappears after Updating…"). The loop is O(catalog size) sync reads — cheap
  * enough to do every render.
  */
-export const useUpdateAvailableIds = (entries: readonly Registry.Plugin[]): ReadonlySet<string> => {
+export const useUpdateAvailableIds = (entries: readonly Plugin.Meta[]): ReadonlySet<string> => {
   const ids = new Set<string>();
   for (const entry of entries) {
-    const installedVersion = UrlLoader.getInstalledVersion(entry.id);
-    if (installedVersion !== undefined && installedVersion !== entry.version) {
-      ids.add(entry.id);
+    const installedVersion = UrlLoader.getInstalledVersion(entry.profile.key);
+    if (installedVersion !== undefined && installedVersion !== entry.release?.version) {
+      ids.add(entry.profile.key);
     }
   }
   return ids;

package/src/hooks/useVersionPicker.ts

@@ -5,53 +5,45 @@
 import * as Effect from 'effect/Effect';
 import { type Dispatch, type SetStateAction, useEffect, useMemo, useState } from 'react';
 
-import { type Registry, UrlLoader } from '@dxos/app-framework';
+import { type Plugin, type Registry, UrlLoader } from '@dxos/app-framework';
 import { EffectEx } from '@dxos/effect';
 
 /**
  * Owns the version picker's state machine: fetches the available versions list
- * from the provider, prepends the installed version when the catalog stub omits
- * it, and keeps the selection clamped to whatever's currently in the list (so
- * an external update doesn't strand the trigger on a tag that's no longer
- * available).
+ * from the provider (served from the inlined `releases` array on each entry —
+ * no separate endpoint needed) and keeps the selection clamped to whatever's
+ * currently in the list so an external update doesn't strand the trigger on a
+ * tag that's no longer available.
  */
 export const useVersionPicker = ({
   provider,
   pluginId,
-  repo,
   moduleUrl,
   installedVersionTag,
 }: {
   provider: Registry.Manager;
   pluginId: string;
-  repo: string | undefined;
   moduleUrl: string | undefined;
   installedVersionTag: string | undefined;
 }): {
-  pickerVersions: readonly Registry.PluginVersion[];
+  pickerVersions: readonly Plugin.Release[];
   selectedVersionTag: string | undefined;
   setSelectedVersionTag: Dispatch<SetStateAction<string | undefined>>;
 } => {
-  const [versions, setVersions] = useState<readonly Registry.PluginVersion[]>([]);
+  const [versions, setVersions] = useState<readonly Plugin.Release[]>([]);
   const [selectedVersionTag, setSelectedVersionTag] = useState<string | undefined>();
 
-  // Load version list once the catalog entry's repo is known. Reset state
-  // when `repo` is absent or the fetch fails so a previous plugin's
-  // versions don't leak into the picker for the current plugin. The
-  // `cancelled` flag guards against a stale in-flight `listVersions`
-  // response overwriting the newer state after `repo`/`pluginId` changes.
+  // Load version list whenever pluginId changes. The `cancelled` flag guards
+  // against a stale in-flight response overwriting newer state when the user
+  // navigates between plugins quickly.
   useEffect(() => {
-    if (!repo) {
-      setVersions([]);
-      setSelectedVersionTag(undefined);
-      return;
-    }
-    // Clear stale picker state before fetching so the UI doesn't display the
-    // previous plugin's versions/selection while `listVersions` is pending.
     setVersions([]);
     setSelectedVersionTag(undefined);
+    if (!pluginId) {
+      return;
+    }
     let cancelled = false;
-    void provider.listVersions(repo).pipe(
+    void provider.listVersions(pluginId).pipe(
       Effect.match({
         onSuccess: (vs) => {
           if (cancelled) {
@@ -60,7 +52,7 @@ export const useVersionPicker = ({
           setVersions(vs);
           // Default selection: the currently installed version, or the latest.
           const installedVersion = UrlLoader.getInstalledVersion(pluginId);
-          setSelectedVersionTag(installedVersion ?? vs[0]?.tag);
+          setSelectedVersionTag(installedVersion ?? vs[0]?.version);
         },
         onFailure: () => {
           if (cancelled) {
@@ -75,19 +67,19 @@ export const useVersionPicker = ({
     return () => {
       cancelled = true;
     };
-  }, [provider, repo, pluginId]);
+  }, [provider, pluginId]);
 
   // Make sure the picker always lists the installed version, even if the catalog
   // hasn't surfaced it (the current `listVersions` stub only returns latest).
-  const pickerVersions = useMemo<readonly Registry.PluginVersion[]>(() => {
+  const pickerVersions = useMemo<readonly Plugin.Release[]>(() => {
     if (!installedVersionTag) {
       return versions;
     }
-    if (versions.some((entry) => entry.tag === installedVersionTag)) {
+    if (versions.some((entry) => entry.version === installedVersionTag)) {
       return versions;
     }
-    const installedEntry: Registry.PluginVersion = {
-      tag: installedVersionTag,
+    const installedEntry: Plugin.Release = {
+      version: installedVersionTag,
       // Picker won't be re-installing this entry unless the user selects + clicks Install,
       // and the catalog moduleUrl is the closest stand-in we have.
       moduleUrl: moduleUrl ?? '',
@@ -102,10 +94,10 @@ export const useVersionPicker = ({
     if (pickerVersions.length === 0) {
       return;
     }
-    if (selectedVersionTag && pickerVersions.some((entry) => entry.tag === selectedVersionTag)) {
+    if (selectedVersionTag && pickerVersions.some((entry) => entry.version === selectedVersionTag)) {
       return;
     }
-    setSelectedVersionTag(installedVersionTag ?? pickerVersions[0]?.tag);
+    setSelectedVersionTag(installedVersionTag ?? pickerVersions[0]?.version);
   }, [pickerVersions, selectedVersionTag, installedVersionTag]);
 
   return { pickerVersions, selectedVersionTag, setSelectedVersionTag };

package/src/meta.ts

@@ -3,11 +3,12 @@
 //
 
 import { Plugin } from '@dxos/app-framework';
-import { pinnedWorkspaceId } from '@dxos/app-toolkit';
+import { Paths } from '@dxos/app-toolkit';
 import { DXN } from '@dxos/keys';
-import { trim } from '@dxos/util';
 
-export const REGISTRY_ID = pinnedWorkspaceId('dxos:plugin-registry');
+import config from '../dx.config';
+
+export const REGISTRY_ID = Paths.pinnedWorkspaceId('dxos:plugin-registry');
 export const REGISTRY_KEY = 'plugin-registry';
 
 // TODO(wittjosiah): Should this be a special separator or use the standard path separator?
@@ -31,17 +32,7 @@ export const getPluginPath = (pluginId: string): string => `root/${REGISTRY_ID}/
  */
 export const getPluginSpecPath = (pluginId: string): string => `${getPluginPath(pluginId)}/spec`;
 
-export const meta = Plugin.makeMeta({
-  key: DXN.make('org.dxos.plugin.registry'),
-  name: 'Plugins',
-  author: 'DXOS',
-  description: trim`
-    Plugin management system for discovering, installing, and configuring workspace extensions.
-    Browse available plugins and customize your workspace capabilities.
-  `,
-  icon: 'ph--squares-four--regular',
-  tags: ['system'],
-});
+export const meta = Plugin.getMetaFromConfig(config);
 
 /** Cascade-disable confirmation dialog surface id. */
-export const DISABLE_DEPENDENTS_DIALOG = DXN.make(`${meta.id}.disableDependentsDialog`);
+export const DISABLE_DEPENDENTS_DIALOG = DXN.make(`${meta.profile.key}.disableDependentsDialog`);

package/src/operations/open-plugin-registry.ts

@@ -4,7 +4,7 @@
 
 import * as Effect from 'effect/Effect';
 
-import { LayoutOperation, SettingsOperation, getSpacePath } from '@dxos/app-toolkit';
+import { LayoutOperation, Paths, SettingsOperation } from '@dxos/app-toolkit';
 import { Operation } from '@dxos/compute';
 
 import { REGISTRY_ID } from '#meta';
@@ -13,7 +13,7 @@ const handler: Operation.WithHandler<typeof SettingsOperation.OpenPluginRegistry
   SettingsOperation.OpenPluginRegistry.pipe(
     Operation.withHandler(
       Effect.fnUntraced(function* () {
-        yield* Operation.invoke(LayoutOperation.SwitchWorkspace, { subject: getSpacePath(REGISTRY_ID) });
+        yield* Operation.invoke(LayoutOperation.SwitchWorkspace, { subject: Paths.getSpacePath(REGISTRY_ID) });
       }),
     ),
   );

package/src/translations.ts

@@ -9,7 +9,7 @@ import { meta } from '#meta';
 export const translations = [
   {
     'en-US': {
-      [meta.id]: {
+      [meta.profile.key]: {
         'plugin.name': 'Registry',
         'details.label': 'Details',
         'description.label': 'Description',

package/src/types.ts

@@ -7,6 +7,8 @@ import * as Schema from 'effect/Schema';
 
 import { Capability } from '@dxos/app-framework';
 
+import { meta } from './meta';
+
 export const RegistrySettingsSchema = Schema.mutable(
   Schema.Struct({
     experimental: Schema.optional(Schema.Boolean),
@@ -32,7 +34,7 @@ export type RegistrySettings = Schema.Schema.Type<typeof RegistrySettingsSchema>
  * Per-plugin capabilities exposed by `@dxos/plugin-registry`.
  */
 export namespace RegistryCapabilities {
-  export const Settings = Capability.make<Atom.Writable<RegistrySettings>>('@dxos/plugin-registry/settings');
+  export const Settings = Capability.make<Atom.Writable<RegistrySettings>>(`${meta.profile.key}.capability.settings`);
 }
 
 export const RegistryTagType = Schema.Literal(