@dxos/plugin-registry 0.8.4-main.422d1c7879 → 0.8.4-main.4f23b4e393

package/src/containers/PublicRegistryArticle/PublicRegistryArticle.tsx

@@ -0,0 +1,192 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+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 { useOperationInvoker, usePluginManager } from '@dxos/app-framework/ui';
+import { runAndForwardErrors } from '@dxos/effect';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
+import { useTranslation } from '@dxos/react-ui';
+import { composable } from '@dxos/ui-theme';
+
+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 sortPlugins = (a: Plugin.Plugin, b: Plugin.Plugin) =>
+  (a.meta.name ?? a.meta.id).localeCompare(b.meta.name ?? b.meta.id);
+
+/**
+ * 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 =>
+  ({
+    [Plugin.PluginTypeId]: Plugin.PluginTypeId,
+    meta: {
+      id: 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,
+    },
+    modules: [],
+  }) as Plugin.Plugin;
+
+export type PublicRegistryArticleProps = {
+  id: string;
+};
+
+export const PublicRegistryArticle = composable<HTMLDivElement, PublicRegistryArticleProps>(
+  ({ id, ...props }, forwardedRef) => {
+    const { t } = useTranslation(meta.id);
+    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 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)),
+    );
+
+    const [installingIds, setInstallingIds] = useState<readonly string[]>([]);
+    const [updatingIds, setUpdatingIds] = useState<readonly string[]>([]);
+    const updateAvailableIds = useUpdateAvailableIds(entries);
+
+    const sortedEntries = useMemo(() => [...entries].sort(sortEntries), [entries]);
+    const moduleUrlById = useMemo(() => {
+      const map: Record<string, string> = {};
+      for (const entry of sortedEntries) {
+        map[entry.id] = entry.moduleUrl;
+      }
+      return map;
+    }, [sortedEntries]);
+
+    // Maps plugin id → current registry version (i.e. plugin.version from the catalog).
+    const versionById = useMemo(() => {
+      const map: Record<string, string> = {};
+      for (const entry of sortedEntries) {
+        map[entry.id] = entry.version;
+      }
+      return map;
+    }, [sortedEntries]);
+
+    // Single list with installed-at-mount plugins sorted to the top. Sort order
+    // 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 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 installedFirst = [...fromCatalog, ...fromUrlOnly].sort((a, b) => {
+        const aInstalled = installedSnapshot.has(a.meta.id);
+        const bInstalled = installedSnapshot.has(b.meta.id);
+        if (aInstalled !== bInstalled) {
+          return aInstalled ? -1 : 1;
+        }
+        return sortPlugins(a, b);
+      });
+      return installedFirst;
+    }, [sortedEntries, installedSnapshot, plugins]);
+
+    const handleInstall = useCallback(
+      (pluginId: string) => {
+        const moduleUrl = moduleUrlById[pluginId];
+        const version = versionById[pluginId];
+        if (!moduleUrl) {
+          return;
+        }
+        setInstallingIds((prev) => (prev.includes(pluginId) ? prev : [...prev, pluginId]));
+        void Effect.gen(function* () {
+          const plugin = yield* manager.add(moduleUrl);
+          yield* manager.enable(plugin.meta.id);
+          // Persist the installed version for future update detection.
+          if (version) {
+            UrlLoader.setInstalledVersion(plugin.meta.id, version);
+          }
+          yield* invoke(ObservabilityOperation.SendEvent, {
+            name: 'plugins.install',
+            properties: { plugin: plugin.meta.id, source: 'registry' },
+          });
+        }).pipe(
+          Effect.ensuring(Effect.sync(() => setInstallingIds((prev) => prev.filter((pid) => pid !== pluginId)))),
+          runAndForwardErrors,
+        );
+      },
+      [invoke, manager, moduleUrlById, versionById],
+    );
+
+    const handleUpdate = useCallback(
+      (pluginId: string) => {
+        const moduleUrl = moduleUrlById[pluginId];
+        const version = versionById[pluginId];
+        if (!moduleUrl) {
+          return;
+        }
+        setUpdatingIds((prev) => (prev.includes(pluginId) ? prev : [...prev, pluginId]));
+        void Effect.gen(function* () {
+          // 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);
+          if (version) {
+            UrlLoader.setInstalledVersion(plugin.meta.id, version);
+          }
+          yield* invoke(ObservabilityOperation.SendEvent, {
+            name: 'plugins.update',
+            properties: { plugin: plugin.meta.id, source: 'registry' },
+          });
+        }).pipe(
+          Effect.ensuring(Effect.sync(() => setUpdatingIds((prev) => prev.filter((pid) => pid !== pluginId)))),
+          runAndForwardErrors,
+        );
+      },
+      [invoke, manager, moduleUrlById, versionById],
+    );
+
+    const empty = error ? (
+      <div className='p-4 text-description'>{t('registry.error.label', { message: error.message })}</div>
+    ) : loading ? (
+      <div className='p-4 text-description'>{t('registry.loading.label')}</div>
+    ) : (
+      <div className='p-4 text-description'>{t('registry.empty.label')}</div>
+    );
+
+    return (
+      <BaseRegistryArticle
+        {...props}
+        id={id}
+        source='registry'
+        plugins={items}
+        installed={installedIds}
+        installing={installingIds}
+        updating={updatingIds}
+        updateAvailableIds={updateAvailableIds}
+        extraTagsById={extraTagsById}
+        onInstall={handleInstall}
+        onUpdate={handleUpdate}
+        empty={empty}
+        ref={forwardedRef}
+      />
+    );
+  },
+);
+
+PublicRegistryArticle.displayName = 'PublicRegistryArticle';

package/src/containers/PublicRegistryArticle/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { PublicRegistryArticle as default, PublicRegistryArticle } from './PublicRegistryArticle';

package/src/containers/RegistryArticle/RegistryArticle.tsx

@@ -0,0 +1,53 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { useAtomValue } from '@effect-atom/atom-react';
+import React, { useMemo } from 'react';
+
+import { type Plugin, type PluginManager } from '@dxos/app-framework';
+import { usePluginManager } from '@dxos/app-framework/ui';
+import { composable } from '@dxos/ui-theme';
+
+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);
+
+export type RegistryArticleProps = {
+  id: string;
+  plugins: Plugin.Plugin[];
+  /**
+   * Map from plugin id → display-only tags (e.g. `registry`, `local`) computed by the caller.
+   */
+  extraTagsById?: Record<string, readonly string[]>;
+};
+
+export const RegistryArticle = composable<HTMLDivElement, RegistryArticleProps>(
+  ({ id, plugins: pluginsProp, extraTagsById, ...props }, forwardedRef) => {
+    const manager = usePluginManager();
+    const failed = useAtomValue(manager.failed);
+    const plugins = useMemo(() => [...pluginsProp].sort(sortByPluginMeta), [pluginsProp]);
+    const failuresById = useMemo(
+      () =>
+        failed.reduce<Record<string, PluginManager.PluginFailure>>((acc, failure) => {
+          acc[failure.id] = failure;
+          return acc;
+        }, {}),
+      [failed],
+    );
+
+    return (
+      <BaseRegistryArticle
+        {...props}
+        id={id}
+        plugins={plugins}
+        extraTagsById={extraTagsById}
+        failuresById={failuresById}
+        ref={forwardedRef}
+      />
+    );
+  },
+);
+
+RegistryArticle.displayName = 'RegistryArticle';

package/src/containers/RegistryArticle/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export { RegistryArticle as default, RegistryArticle } from './RegistryArticle';

package/src/containers/RegistrySettingsContainer/RegistrySettingsContainer.tsx

@@ -0,0 +1,59 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { useAtomValue } from '@effect-atom/atom-react';
+import * as Effect from 'effect/Effect';
+import React, { useCallback } from 'react';
+
+import { useSettingsState, usePluginManager } from '@dxos/app-framework/ui';
+import { type AppCapabilities } from '@dxos/app-toolkit';
+import { runAndForwardErrors } from '@dxos/effect';
+
+import { RegistrySettings } from '../../components';
+import { type RegistrySettings as RegistrySettingsType } from '../../types';
+
+export type RegistrySettingsContainerProps = {
+  subject: AppCapabilities.Settings;
+};
+
+/**
+ * Wires the {@link RegistrySettings} presentational component to the plugin
+ * manager and the settings atom: subscribes to `manager.devPluginIds` for the
+ * "currently loaded" indicator and exposes enable/disable callbacks that drive
+ * the manager's add/enable/remove flow.
+ */
+export const RegistrySettingsContainer = ({ subject }: RegistrySettingsContainerProps) => {
+  const manager = usePluginManager();
+  const { settings, updateSettings } = useSettingsState<RegistrySettingsType>(subject.atom);
+  const activeDevPluginIds = useAtomValue(manager.devPluginIds);
+
+  const onEnableDev = useCallback(
+    async (url: string) => {
+      await runAndForwardErrors(
+        Effect.gen(function* () {
+          const plugin = yield* manager.add(url);
+          yield* manager.enable(plugin.meta.id);
+        }),
+      );
+    },
+    [manager],
+  );
+
+  const onDisableDev = useCallback(
+    async (id: string) => {
+      await runAndForwardErrors(manager.remove(id));
+    },
+    [manager],
+  );
+
+  return (
+    <RegistrySettings
+      settings={settings}
+      onSettingsChange={updateSettings}
+      activeDevPluginIds={activeDevPluginIds}
+      onEnableDev={onEnableDev}
+      onDisableDev={onDisableDev}
+    />
+  );
+};

package/src/containers/RegistrySettingsContainer/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { RegistrySettingsContainer as default } from './RegistrySettingsContainer';

package/src/containers/index.ts

@@ -5,7 +5,8 @@
 import { type ComponentType, lazy } from 'react';
 
 export { LOAD_PLUGIN_DIALOG } from './LoadPluginDialog/LoadPluginDialog';
-export const CommunityRegistry: ComponentType<any> = lazy(() => import('./CommunityRegistry'));
 export const LoadPluginDialog: ComponentType<any> = lazy(() => import('./LoadPluginDialog'));
 export const PluginArticle: ComponentType<any> = lazy(() => import('./PluginArticle'));
-export const PluginRegistry: ComponentType<any> = lazy(() => import('./PluginRegistry'));
+export const PublicRegistryArticle: ComponentType<any> = lazy(() => import('./PublicRegistryArticle'));
+export const RegistryArticle: ComponentType<any> = lazy(() => import('./RegistryArticle'));
+export const RegistrySettingsContainer: ComponentType<any> = lazy(() => import('./RegistrySettingsContainer'));

package/src/hooks/index.ts

@@ -3,4 +3,5 @@
 //
 
 export * from './use-auto-tags';
-export * from './use-community-plugins';
+export * from './use-registry-plugins';
+export * from './use-update-available';

package/src/hooks/use-auto-tags.ts

@@ -4,12 +4,11 @@
 
 import { useMemo } from 'react';
 
-import { UrlLoader } from '@dxos/app-framework';
-import { type PluginEntry } from '@dxos/protocols';
+import { type Registry, UrlLoader } from '@dxos/app-framework';
 
 /**
  * Auto-tags that are derived at display time rather than persisted to `Plugin.Meta`.
- * - `community`: plugin id appears in the community registry manifest.
+ * - `registry`: plugin id appears in the registry catalog manifest.
  * - `local`: plugin was loaded from a `localhost` / `127.0.0.1` / `::1` URL.
  */
 export type AutoTagsMap = Record<string, readonly string[]>;
@@ -18,9 +17,9 @@ export type AutoTagsMap = Record<string, readonly string[]>;
  * Computes the per-plugin-id extra tags the UI should display.
  *
  * Reads the persisted remote-plugin entries synchronously to derive `local`, and
- * adds `community` for any plugin id found in the supplied community manifest entries.
+ * adds `registry` for any plugin id found in the supplied registry manifest entries.
  */
-export const useAutoTags = (communityEntries: readonly PluginEntry[]): AutoTagsMap =>
+export const useAutoTags = (registryEntries: readonly Registry.Plugin[]): AutoTagsMap =>
   useMemo(() => {
     const byId: Record<string, string[]> = {};
     const addTag = (id: string, tag: string) => {
@@ -37,12 +36,12 @@ export const useAutoTags = (communityEntries: readonly PluginEntry[]): AutoTagsM
         addTag(entry.id, 'local');
       }
     }
-    for (const entry of communityEntries) {
-      addTag(entry.meta.id, 'community');
+    for (const entry of registryEntries) {
+      addTag(entry.id, 'registry');
     }
 
     return byId;
-  }, [communityEntries]);
+  }, [registryEntries]);
 
 /**
  * Returns the set of plugin ids known to originate from a remote URL (not bundled).

package/src/hooks/use-registry-plugins.ts

@@ -0,0 +1,29 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { useAtomValue } from '@effect-atom/atom-react';
+
+import { type Registry } from '@dxos/app-framework';
+import { usePluginManager } from '@dxos/app-framework/ui';
+
+/**
+ * Reads the registry plugin catalog from `manager.pluginRegistry.plugins`.
+ * The catalog is loaded once when the plugin manager is constructed (with a
+ * provider) so this hook is purely reactive — subscribers re-render as the
+ * `{entries, loading, error}` state settles.
+ */
+export const useRegistryPlugins = (): Registry.PluginsState => {
+  const manager = usePluginManager();
+  return useAtomValue(manager.pluginRegistry.plugins);
+};
+
+/**
+ * Returns the live `Registry.Manager` from the plugin manager so callers can
+ * issue `listVersions` / `getPlugin` calls directly. The catalog state itself
+ * is best read through {@link useRegistryPlugins} above.
+ */
+export const useRegistryPluginProvider = (): Registry.Manager => {
+  const manager = usePluginManager();
+  return manager.pluginRegistry;
+};

package/src/hooks/use-update-available.ts

@@ -0,0 +1,31 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Registry, UrlLoader } from '@dxos/app-framework';
+
+/**
+ * Returns a set of plugin ids for which the registry has a newer version
+ * than what was recorded at install time.
+ *
+ * Only flags plugins where a version was recorded at install time AND it differs
+ * from the catalog's current version. Legacy installs (no version stored) are ignored.
+ *
+ * NOTE: this is intentionally NOT memoised. The installed-version side of the
+ * comparison lives in localStorage and is mutated by `manager.add` /
+ * `manager.remove` / `UrlLoader.setInstalledVersion` outside React's view, so a
+ * memo keyed on `entries` would happily return stale data for the rest of the
+ * session after an update completes (the bug that produced "Update button
+ * 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> => {
+  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);
+    }
+  }
+  return ids;
+};

package/src/index.ts

@@ -3,4 +3,4 @@
 //
 
 export * from './meta';
-export * from './RegistryPlugin';
+export * from './storage';

package/src/meta.ts

@@ -25,4 +25,6 @@ export const meta: Plugin.Meta = {
     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'],
 };

package/src/operations/index.ts

@@ -2,6 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export const RegistryOperationHandlerSet = OperationHandlerSet.lazy(() => import('./open-plugin-registry'));

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

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation, SettingsOperation, getSpacePath } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { REGISTRY_ID } from '#meta';
 

package/src/plugin.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const RegistryPlugin = Plugin.lazy(meta, () => import('#plugin'));
+
+export { RegistryOperationHandlerSet } from './operations';

package/src/translations.ts

@@ -14,23 +14,53 @@ export const translations = [
         'details.label': 'Details',
         'home-page.label': 'Website',
         'source.label': 'Source',
-        'plugin-registry.label': 'Plugin Registry',
+        'plugin-registry.label': 'Plugins',
+        'plugin-settings.label': 'Plugin Settings',
         'official-plugins.label': 'Official',
         'installed-plugins.label': 'Enabled',
         'recommended-plugins.label': 'Recommended',
         'labs-plugins.label': 'Labs',
-        'community-plugins.label': 'Community',
+        'registry-plugins.label': 'Registry',
         'load-by-url.label': 'Load from URL',
         'load-by-url-dialog.title': 'Load Plugin from URL',
         'plugin-url.label': 'Plugin URL',
         'load-plugin.label': 'Load Plugin',
         'loading.label': 'Loading...',
+        'filter.label': 'Filter plugins',
+        'filter.placeholder': 'Filter…',
+        'registry.loading.label': 'Loading registry plugins…',
+        'registry.error.label': 'Failed to load registry plugins: {{message}}',
+        'registry.empty.label': 'No registry plugins available.',
+        'dev-plugin.section.title': 'Dev plugin',
+        'dev-plugin.description':
+          'Load a plugin from a local Vite dev server (the `composerPlugin` defaults to port 3967). Composer reattaches it on every reload, surviving HMR — useful when iterating on a community plugin against a live registry version.',
+        'dev-plugin.url.label': 'Manifest URL',
+        'dev-plugin.url.description':
+          'Defaults to the local dev server. Edit if your dev server runs on a different port.',
+        'dev-plugin.toggle.label': 'Dev plugin',
+        'dev-plugin.toggle.description':
+          'Stays on across reloads. If the dev server is offline at boot, a warning is logged and the next reload retries.',
+        'dev-plugin.enable.label': 'Enable',
+        'dev-plugin.disable.label': 'Disable',
+        'dev-plugin.busy.label': 'Loading…',
+        'dev-plugin.not-loaded.message':
+          'Dev plugin is enabled but not currently loaded. Check that the dev server is running, then reload.',
         'coming-soon.label': 'Coming soon!',
         'open-plugin-registry.label': 'Open plugin registry',
-        'settings.label': 'Settings',
         'install.label': 'Install',
         'installing.label': 'Installing…',
         'uninstall.label': 'Uninstall',
+        'update.label': 'Update',
+        'updating.label': 'Updating…',
+        'versions.label': 'Versions',
+        'installed.label': 'installed',
+        'install-version.label': 'Install version',
+        'failure-badge.label': 'Plugin failure details',
+        'failure-title.label': 'Plugin {{phase}} failed: {{reason}}',
+        'failure-phase-load.label': 'load',
+        'failure-phase-activation.label': 'activation',
+        'failure-reason-timeout.label': 'timed out',
+        'failure-reason-error.label': 'error',
       },
     },
   },

package/src/types.ts

@@ -6,28 +6,35 @@ import { type Atom } from '@effect-atom/atom-react';
 import * as Schema from 'effect/Schema';
 
 import { Capability } from '@dxos/app-framework';
-import { type PluginEntry } from '@dxos/protocols';
-
-import { meta } from '#meta';
-
-export type CommunityPluginsState = {
-  entries: readonly PluginEntry[];
-  loading: boolean;
-  error: Error | null;
-};
-
-export namespace RegistryCapabilities {
-  export const State = Capability.make<Atom.Atom<CommunityPluginsState>>(`${meta.id}.capability.state`);
-}
 
 export const RegistrySettingsSchema = Schema.mutable(
   Schema.Struct({
     experimental: Schema.optional(Schema.Boolean),
+    /**
+     * Manifest URL for a plugin served by a local Vite dev server. The
+     * registry settings panel pre-fills this with `localhost:3967`; authors
+     * iterating on a different port can edit it.
+     */
+    devPluginUrl: Schema.optional(Schema.String),
+    /**
+     * When true, the registry plugin attempts to load `devPluginUrl` on every
+     * app boot. Failures (dev server offline, manifest 404) are logged and
+     * the flag stays on so the next boot retries — the user explicitly turns
+     * it off when they're done iterating.
+     */
+    devPluginEnabled: Schema.optional(Schema.Boolean),
   }),
 );
 
 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 RegistryTagType = Schema.Literal(
   'new',
   'beta',
@@ -35,7 +42,7 @@ export const RegistryTagType = Schema.Literal(
   'popular',
   'featured',
   'experimental',
-  'community',
+  'registry',
   'local',
 );
 

package/dist/lib/browser/cli/index.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/cli/plugin.ts", "../../../../src/cli/commands/index.ts", "../../../../src/cli/commands/disable.ts", "../../../../src/cli/storage.ts", "../../../../src/cli/commands/enable.ts", "../../../../src/cli/commands/list.ts", "../../../../src/cli/commands/util.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\n\nimport { plugin } from './commands';\n\nexport const RegistryPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addCommandModule({\n    commands: [plugin],\n  }),\n  Plugin.make,\n);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Command from '@effect/cli/Command';\n\nimport { disable } from './disable';\nimport { enable } from './enable';\nimport { list } from './list';\n\nexport const plugin: Command.Command<any, any, any, any> = Command.make('plugin').pipe(\n  Command.withDescription('Manage plugins.'),\n  Command.withSubcommands([enable, disable, list]),\n);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Args from '@effect/cli/Args';\nimport * as Command from '@effect/cli/Command';\nimport * as Console from 'effect/Console';\nimport * as Effect from 'effect/Effect';\n\nimport { Plugin } from '@dxos/app-framework';\nimport { CommandConfig } from '@dxos/cli-util';\nimport { invariant } from '@dxos/invariant';\n\nimport { saveEnabledPlugins } from '../storage';\n\nexport const handler = Effect.fn(function* ({ id }: { id: string }) {\n  const { json, profile } = yield* CommandConfig;\n  const manager = yield* Plugin.Service;\n\n  const plugins = manager.getPlugins();\n  const plugin = plugins.find((p: Plugin.Plugin) => p.meta.id === id);\n  invariant(plugin, `Plugin not found: ${id}`);\n\n  const core = manager.getCore();\n  invariant(!core.includes(id), `Cannot disable core plugin: ${id}`);\n\n  const disabled = yield* manager.disable(id);\n  invariant(disabled, `Failed to disable plugin: ${id}`);\n\n  // Save enabled plugins to storage\n  const enabledPlugins = manager.getEnabled();\n  yield* saveEnabledPlugins({ profile, enabled: [...enabledPlugins] });\n\n  if (json) {\n    yield* Console.log(JSON.stringify({ id, enabled: false }, null, 2));\n  } else {\n    yield* Console.log(`Plugin \"${plugin.meta.name ?? id}\" disabled.`);\n  }\n});\n\nexport const disable = Command.make(\n  'disable',\n  {\n    id: Args.text({ name: 'id' }).pipe(Args.withDescription('The ID of the plugin to disable.')),\n  },\n  handler,\n).pipe(Command.withDescription('Disable a plugin.'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as FileSystem from '@effect/platform/FileSystem';\nimport * as Path from '@effect/platform/Path';\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\nimport * as Yaml from 'yaml';\n\nimport { DX_CONFIG } from '@dxos/client-protocol';\n\n// TODO(wittjosiah): Factor out to app-framework?\n\nconst PluginsSchema = Schema.Array(Schema.String);\n\n/** CLI-only: path to plugins/<profile>.yml (sibling to profile/). */\nconst getPluginsConfigPath = (profile: string) => `${DX_CONFIG}/plugins/${profile}.yml`;\n\n/**\n * Load enabled plugins from plugins/<profile>.yml (sibling to profile/).\n * Returns the list of enabled plugin IDs, or an empty array if the file doesn't exist.\n */\nexport const loadEnabledPlugins = Effect.fn(function* ({ profile }: { profile: string }) {\n  const fs = yield* FileSystem.FileSystem;\n  const pluginsPath = getPluginsConfigPath(profile);\n\n  const content = yield* fs\n    .readFileString(pluginsPath)\n    .pipe(Effect.catchTag('SystemError', () => Effect.succeed('[]')));\n\n  const raw = Yaml.parse(content);\n  const parsed = yield* Schema.decodeUnknown(PluginsSchema)(raw ?? []).pipe(\n    Effect.catchAll(() => Effect.succeed([] as string[])),\n  );\n\n  return parsed;\n});\n\n/**\n * Save enabled plugins to plugins/<profile>.yml.\n */\nexport const saveEnabledPlugins = Effect.fn(function* ({ profile, enabled }: { profile: string; enabled: string[] }) {\n  const fs = yield* FileSystem.FileSystem;\n  const path = yield* Path.Path;\n  const pluginsPath = getPluginsConfigPath(profile);\n  yield* fs.makeDirectory(path.dirname(pluginsPath), { recursive: true });\n  const encoded = Yaml.stringify(enabled);\n  yield* fs.writeFileString(pluginsPath, encoded);\n});\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Args from '@effect/cli/Args';\nimport * as Command from '@effect/cli/Command';\nimport * as Console from 'effect/Console';\nimport * as Effect from 'effect/Effect';\n\nimport { Plugin } from '@dxos/app-framework';\nimport { CommandConfig } from '@dxos/cli-util';\nimport { invariant } from '@dxos/invariant';\n\nimport { saveEnabledPlugins } from '../storage';\n\nexport const handler = Effect.fn(function* ({ id }: { id: string }) {\n  const { json, profile } = yield* CommandConfig;\n  const manager = yield* Plugin.Service;\n\n  const plugins = manager.getPlugins();\n  const plugin = plugins.find((p: Plugin.Plugin) => p.meta.id === id);\n  invariant(plugin, `Plugin not found: ${id}`);\n\n  const enabled = yield* manager.enable(id);\n  invariant(enabled, `Failed to enable plugin: ${id}`);\n\n  // Save enabled plugins to storage\n  const enabledPlugins = manager.getEnabled();\n  yield* saveEnabledPlugins({ profile, enabled: [...enabledPlugins] });\n\n  if (json) {\n    yield* Console.log(JSON.stringify({ id, enabled: true }, null, 2));\n  } else {\n    yield* Console.log(`Plugin \"${plugin.meta.name ?? id}\" enabled.`);\n  }\n});\n\nexport const enable = Command.make(\n  'enable',\n  {\n    id: Args.text({ name: 'id' }).pipe(Args.withDescription('The ID of the plugin to enable.')),\n  },\n  handler,\n).pipe(Command.withDescription('Enable a plugin.'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Command from '@effect/cli/Command';\nimport * as Console from 'effect/Console';\nimport * as Effect from 'effect/Effect';\n\nimport { Plugin } from '@dxos/app-framework';\nimport { CommandConfig, printList } from '@dxos/cli-util';\n\nimport { type FormattedPlugin, printPlugin } from './util';\n\nexport const handler = Effect.fn(function* () {\n  const { json } = yield* CommandConfig;\n  const manager = yield* Plugin.Service;\n\n  const plugins = manager.getPlugins();\n  const enabled = manager.getEnabled();\n  const core = manager.getCore();\n\n  const formattedPlugins: FormattedPlugin[] = plugins.map((plugin: Plugin.Plugin) => {\n    const isEnabled = enabled.includes(plugin.meta.id);\n    const isCore = core.includes(plugin.meta.id);\n    return {\n      id: plugin.meta.id,\n      name: plugin.meta.name ?? plugin.meta.id,\n      enabled: isEnabled,\n      core: isCore,\n    };\n  });\n\n  if (json) {\n    yield* Console.log(JSON.stringify(formattedPlugins, null, 2));\n  } else {\n    const formatted = formattedPlugins.map(printPlugin);\n    yield* Console.log(printList(formatted));\n  }\n});\n\nexport const list = Command.make('list', {}, handler).pipe(Command.withDescription('List all available plugins.'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { FormBuilder } from '@dxos/cli-util';\n\nexport type FormattedPlugin = {\n  id: string;\n  name: string;\n  enabled: boolean;\n  core: boolean;\n};\n\n/**\n * Pretty prints a plugin with ANSI colors.\n */\nexport const printPlugin = (plugin: FormattedPlugin) => {\n  const status = plugin.core ? 'core' : plugin.enabled ? 'enabled' : 'disabled';\n  return FormBuilder.make({ title: plugin.name }).pipe(\n    FormBuilder.set('id', plugin.id),\n    FormBuilder.set('status', status),\n    FormBuilder.build,\n  );\n};\n"],
-  "mappings": "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",
-  "names": ["Plugin", "AppPlugin", "meta", "Command", "Args", "Command", "Console", "Effect", "Plugin", "CommandConfig", "invariant", "FileSystem", "Path", "Effect", "Schema", "Yaml", "DX_CONFIG", "PluginsSchema", "Array", "String", "getPluginsConfigPath", "profile", "DX_CONFIG", "loadEnabledPlugins", "fn", "fs", "FileSystem", "pluginsPath", "content", "readFileString", "pipe", "catchTag", "succeed", "raw", "parse", "parsed", "decodeUnknown", "catchAll", "saveEnabledPlugins", "enabled", "path", "Path", "makeDirectory", "dirname", "recursive", "encoded", "stringify", "writeFileString", "handler", "fn", "id", "json", "profile", "CommandConfig", "manager", "Plugin", "Service", "plugins", "getPlugins", "plugin", "find", "p", "meta", "invariant", "core", "getCore", "includes", "disabled", "disable", "enabledPlugins", "getEnabled", "saveEnabledPlugins", "enabled", "log", "JSON", "stringify", "name", "make", "text", "pipe", "withDescription", "Args", "Command", "Console", "Effect", "Plugin", "CommandConfig", "invariant", "handler", "fn", "id", "json", "profile", "CommandConfig", "manager", "Plugin", "Service", "plugins", "getPlugins", "plugin", "find", "p", "meta", "invariant", "enabled", "enable", "enabledPlugins", "getEnabled", "saveEnabledPlugins", "log", "JSON", "stringify", "name", "make", "text", "pipe", "withDescription", "Command", "Console", "Effect", "Plugin", "CommandConfig", "printList", "FormBuilder", "printPlugin", "plugin", "status", "core", "enabled", "FormBuilder", "make", "title", "name", "pipe", "set", "id", "build", "handler", "fn", "json", "CommandConfig", "manager", "Plugin", "Service", "plugins", "getPlugins", "enabled", "getEnabled", "core", "getCore", "formattedPlugins", "map", "plugin", "isEnabled", "includes", "meta", "id", "isCore", "name", "log", "JSON", "stringify", "formatted", "printPlugin", "printList", "list", "make", "pipe", "withDescription", "plugin", "make", "pipe", "withDescription", "withSubcommands", "enable", "disable", "list", "RegistryPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addCommandModule", "commands", "plugin", "make"]
-}