@dxos/plugin-registry 0.8.4-main.ae835ea → 0.8.4-main.bc674ce

package/package.json

@@ -1,18 +1,29 @@
 {
   "name": "@dxos/plugin-registry",
-  "version": "0.8.4-main.ae835ea",
+  "version": "0.8.4-main.bc674ce",
   "description": "Braneframe plugin gallery",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
   "exports": {
     ".": {
+      "browser": "./dist/lib/browser/index.mjs",
+      "node": "./dist/lib/node-esm/index.mjs",
       "source": "./src/index.ts",
-      "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs"
+      "types": "./dist/types/src/index.d.ts"
+    },
+    "./cli": {
+      "browser": "./dist/lib/browser/cli/index.mjs",
+      "node": "./dist/lib/node-esm/cli/index.mjs",
+      "source": "./src/cli/index.ts",
+      "types": "./dist/types/src/cli/index.d.ts"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -24,39 +35,44 @@
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "@dxos/echo": "0.8.4-main.ae835ea",
-    "@dxos/live-object": "0.8.4-main.ae835ea",
-    "@dxos/app-framework": "0.8.4-main.ae835ea",
-    "@dxos/plugin-observability": "0.8.4-main.ae835ea",
-    "@dxos/plugin-graph": "0.8.4-main.ae835ea",
-    "@dxos/react-ui-stack": "0.8.4-main.ae835ea",
-    "@dxos/invariant": "0.8.4-main.ae835ea",
-    "@dxos/util": "0.8.4-main.ae835ea",
-    "@dxos/react-ui-form": "0.8.4-main.ae835ea"
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/cli": "0.72.1",
+    "@dxos/app-framework": "0.8.4-main.bc674ce",
+    "@dxos/client-protocol": "0.8.4-main.bc674ce",
+    "@dxos/cli-util": "0.8.4-main.bc674ce",
+    "@dxos/echo": "0.8.4-main.bc674ce",
+    "@dxos/invariant": "0.8.4-main.bc674ce",
+    "@dxos/operation": "0.8.4-main.bc674ce",
+    "@dxos/plugin-graph": "0.8.4-main.bc674ce",
+    "@dxos/plugin-observability": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-form": "0.8.4-main.bc674ce",
+    "@dxos/effect": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-stack": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-mosaic": "0.8.4-main.bc674ce",
+    "@dxos/util": "0.8.4-main.bc674ce"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "0.42.4",
-    "@effect/platform": "0.92.1",
-    "@types/react": "~19.2.2",
-    "@types/react-dom": "~19.2.2",
-    "effect": "3.18.3",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/platform": "0.93.6",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
     "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.ae835ea",
-    "@dxos/random": "0.8.4-main.ae835ea",
-    "@dxos/react-ui-theme": "0.8.4-main.ae835ea",
-    "@dxos/storybook-utils": "0.8.4-main.ae835ea"
+    "@dxos/react-ui": "0.8.4-main.bc674ce",
+    "@dxos/random": "0.8.4-main.bc674ce",
+    "@dxos/storybook-utils": "0.8.4-main.bc674ce",
+    "@dxos/ui-theme": "0.8.4-main.bc674ce"
   },
   "peerDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.ae835ea",
-    "@dxos/react-ui-theme": "0.8.4-main.ae835ea"
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/platform": "0.93.6",
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.bc674ce",
+    "@dxos/ui-theme": "0.8.4-main.bc674ce"
   },
   "publishConfig": {
     "access": "public"

package/src/RegistryPlugin.tsx

@@ -2,31 +2,16 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, defineModule, definePlugin } from '@dxos/app-framework';
+import { Common, Plugin } from '@dxos/app-framework';
 
-import { AppGraphBuilder, IntentResolver, ReactSurface } from './capabilities';
+import { AppGraphBuilder, OperationResolver, ReactSurface } from './capabilities';
 import { meta } from './meta';
 import { translations } from './translations';
 
-export const RegistryPlugin = definePlugin(meta, () => [
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, translations),
-  }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.SetupReactSurface,
-    activate: ReactSurface,
-  }),
-  defineModule({
-    id: `${meta.id}/module/intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: IntentResolver,
-  }),
-  defineModule({
-    id: `${meta.id}/module/app-graph-builder`,
-    activatesOn: Events.SetupAppGraph,
-    activate: AppGraphBuilder,
-  }),
-]);
+export const RegistryPlugin = Plugin.define(meta).pipe(
+  Common.Plugin.addTranslationsModule({ translations }),
+  Common.Plugin.addSurfaceModule({ activate: ReactSurface }),
+  Common.Plugin.addOperationResolverModule({ activate: OperationResolver }),
+  Common.Plugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  Plugin.make,
+);

package/src/capabilities/app-graph-builder/app-graph-builder.ts

@@ -0,0 +1,136 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Common, SettingsOperation } from '@dxos/app-framework';
+import { Operation } from '@dxos/operation';
+import { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';
+
+import { REGISTRY_ID, REGISTRY_KEY, meta } from '../../meta';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+
+    const extensions = yield* Effect.all([
+      GraphBuilder.createExtension({
+        id: meta.id,
+        match: NodeMatcher.whenRoot,
+        actions: () =>
+          Effect.succeed([
+            {
+              id: meta.id,
+              data: () => Operation.invoke(SettingsOperation.OpenPluginRegistry),
+              properties: {
+                label: ['open plugin registry label', { ns: meta.id }],
+                icon: 'ph--squares-four--regular',
+                disposition: 'menu',
+              },
+            },
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: meta.id,
+        match: NodeMatcher.whenRoot,
+        connector: () =>
+          Effect.succeed([
+            {
+              id: REGISTRY_ID,
+              type: meta.id,
+              properties: {
+                label: ['plugin registry label', { ns: meta.id }],
+                icon: 'ph--squares-four--regular',
+                disposition: 'pin-end',
+                testId: 'treeView.pluginRegistry',
+              },
+              nodes: [
+                {
+                  id: `${REGISTRY_KEY}+all`,
+                  type: 'category',
+                  data: `${REGISTRY_KEY}+all`,
+                  properties: {
+                    label: ['all plugins label', { ns: meta.id }],
+                    icon: 'ph--squares-four--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.all',
+                  },
+                },
+                {
+                  id: `${REGISTRY_KEY}+installed`,
+                  type: 'category',
+                  data: `${REGISTRY_KEY}+installed`,
+                  properties: {
+                    label: ['installed plugins label', { ns: meta.id }],
+                    icon: 'ph--check--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.installed',
+                  },
+                },
+                {
+                  id: `${REGISTRY_KEY}+recommended`,
+                  type: 'category',
+                  data: `${REGISTRY_KEY}+recommended`,
+                  properties: {
+                    label: ['recommended plugins label', { ns: meta.id }],
+                    icon: 'ph--star--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.recommended',
+                  },
+                },
+                {
+                  id: `${REGISTRY_KEY}+labs`,
+                  type: 'category',
+                  data: `${REGISTRY_KEY}+labs`,
+                  properties: {
+                    label: ['labs plugins label', { ns: meta.id }],
+                    icon: 'ph--flask--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.labs',
+                  },
+                },
+              ],
+            },
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: `${meta.id}/actions`,
+        match: NodeMatcher.whenId(REGISTRY_ID),
+        actions: () =>
+          Effect.succeed([
+            {
+              id: `${meta.id}/load-by-url`,
+              data: Effect.fnUntraced(function* () {}),
+              properties: {
+                label: ['load by url label', { ns: meta.id }],
+                icon: 'ph--cloud-arrow-down--regular',
+                disabled: true,
+              },
+            },
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: `${meta.id}/plugins`,
+        match: NodeMatcher.whenId(REGISTRY_ID),
+        connector: () => {
+          const manager = capabilities.get(Common.Capability.PluginManager);
+          return Effect.succeed(
+            manager.getPlugins().map((plugin) => ({
+              id: plugin.meta.id.replaceAll('/', ':'),
+              type: 'dxos.org/plugin',
+              data: plugin,
+              properties: {
+                label: plugin.meta.name ?? plugin.meta.id,
+                icon: plugin.meta.icon ?? 'ph--circle--regular',
+                disposition: 'hidden',
+              },
+            })),
+          );
+        },
+      }),
+    ]);
+
+    return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);
+  }),
+);

package/src/capabilities/app-graph-builder/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));

package/src/capabilities/index.ts

@@ -2,8 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
-
-export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
+export * from './app-graph-builder';
+export * from './operation-resolver';
+export * from './react-surface';

package/src/capabilities/operation-resolver/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const OperationResolver = Capability.lazy('OperationResolver', () => import('./operation-resolver'));

package/src/capabilities/operation-resolver/operation-resolver.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Common, SettingsOperation } from '@dxos/app-framework';
+import { Operation, OperationResolver } from '@dxos/operation';
+
+import { REGISTRY_ID } from '../../meta';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Common.Capability.OperationResolver, [
+      OperationResolver.make({
+        operation: SettingsOperation.OpenPluginRegistry,
+        handler: Effect.fnUntraced(function* () {
+          yield* Operation.invoke(Common.LayoutOperation.SwitchWorkspace, { subject: REGISTRY_ID });
+        }),
+      }),
+    ]);
+  }),
+);

package/src/capabilities/react-surface/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,99 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React, { useCallback, useMemo } from 'react';
+
+import { Capability, Common, Plugin } from '@dxos/app-framework';
+import { usePluginManager } from '@dxos/app-framework/react';
+import { runAndForwardErrors } from '@dxos/effect';
+
+import { PluginDetail, RegistryContainer } from '../../components';
+import { REGISTRY_KEY, meta } from '../../meta';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Common.Capability.ReactSurface, [
+      Common.createSurface({
+        id: `${meta.id}/all`,
+        role: 'article',
+        filter: (data): data is any => data.subject === `${REGISTRY_KEY}+all`,
+        component: () => {
+          const manager = usePluginManager();
+          const filtered = useMemo(
+            () => manager.getPlugins().filter(({ meta }) => !manager.getCore().includes(meta.id)),
+            [],
+          );
+
+          return <RegistryContainer id={`${REGISTRY_KEY}+all`} plugins={filtered} />;
+        },
+      }),
+      Common.createSurface({
+        id: `${meta.id}/installed`,
+        role: 'article',
+        filter: (data): data is any => data.subject === `${REGISTRY_KEY}+installed`,
+        component: () => {
+          const manager = usePluginManager();
+          const filtered = useMemo(
+            () =>
+              manager
+                .getPlugins()
+                .filter(({ meta }) => !manager.getCore().includes(meta.id))
+                .filter(({ meta }) => manager.getEnabled().includes(meta.id)),
+            [],
+          );
+
+          return <RegistryContainer id={`${REGISTRY_KEY}+installed`} plugins={filtered} />;
+        },
+      }),
+      Common.createSurface({
+        id: `${meta.id}/recommended`,
+        role: 'article',
+        filter: (data): data is any => data.subject === `${REGISTRY_KEY}+recommended`,
+        component: () => {
+          const manager = usePluginManager();
+          const filtered = useMemo(
+            () =>
+              manager
+                .getPlugins()
+                .filter(({ meta }) => !manager.getCore().includes(meta.id))
+                .filter(({ meta }) => !meta.tags?.includes('labs')),
+            [],
+          );
+
+          return <RegistryContainer id={`${REGISTRY_KEY}+recommended`} plugins={filtered} />;
+        },
+      }),
+      Common.createSurface({
+        id: `${meta.id}/labs`,
+        role: 'article',
+        filter: (data): data is any => data.subject === `${REGISTRY_KEY}+labs`,
+        component: () => {
+          const manager = usePluginManager();
+          const filtered = useMemo(() => manager.getPlugins().filter(({ meta }) => meta.tags?.includes('labs')), []);
+
+          return <RegistryContainer id={`${REGISTRY_KEY}+labs`} plugins={filtered} />;
+        },
+      }),
+      Common.createSurface({
+        id: `${meta.id}/plugin-details`,
+        role: 'article',
+        filter: (data): data is { subject: Plugin.Plugin } => Plugin.isPlugin(data.subject),
+        component: ({ data: { subject } }) => {
+          const manager = usePluginManager();
+          const enabled = manager.getEnabled().includes(subject.meta.id);
+          const handleEnableChange = useCallback(
+            (enabled: boolean) =>
+              enabled
+                ? runAndForwardErrors(manager.enable(subject.meta.id))
+                : runAndForwardErrors(manager.disable(subject.meta.id)),
+            [manager, subject.meta.id],
+          );
+
+          return <PluginDetail plugin={subject} enabled={enabled} onEnabledChange={handleEnableChange} />;
+        },
+      }),
+    ]),
+  ),
+);

package/src/cli/commands/disable.ts

@@ -0,0 +1,47 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Args from '@effect/cli/Args';
+import * as Command from '@effect/cli/Command';
+import * as Console from 'effect/Console';
+import * as Effect from 'effect/Effect';
+
+import { Plugin } from '@dxos/app-framework';
+import { CommandConfig } from '@dxos/cli-util';
+import { invariant } from '@dxos/invariant';
+
+import { saveEnabledPlugins } from '../storage';
+
+export const handler = Effect.fn(function* ({ id }: { id: string }) {
+  const { json, profile } = yield* CommandConfig;
+  const manager = yield* Plugin.Service;
+
+  const plugins = manager.getPlugins();
+  const plugin = plugins.find((p: Plugin.Plugin) => p.meta.id === id);
+  invariant(plugin, `Plugin not found: ${id}`);
+
+  const core = manager.getCore();
+  invariant(!core.includes(id), `Cannot disable core plugin: ${id}`);
+
+  const disabled = yield* manager.disable(id);
+  invariant(disabled, `Failed to disable plugin: ${id}`);
+
+  // Save enabled plugins to storage
+  const enabledPlugins = manager.getEnabled();
+  yield* saveEnabledPlugins({ profile, enabled: [...enabledPlugins] });
+
+  if (json) {
+    yield* Console.log(JSON.stringify({ id, enabled: false }, null, 2));
+  } else {
+    yield* Console.log(`Plugin "${plugin.meta.name ?? id}" disabled.`);
+  }
+});
+
+export const disable = Command.make(
+  'disable',
+  {
+    id: Args.text({ name: 'id' }).pipe(Args.withDescription('The ID of the plugin to disable.')),
+  },
+  handler,
+).pipe(Command.withDescription('Disable a plugin.'));

package/src/cli/commands/enable.ts

@@ -0,0 +1,44 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Args from '@effect/cli/Args';
+import * as Command from '@effect/cli/Command';
+import * as Console from 'effect/Console';
+import * as Effect from 'effect/Effect';
+
+import { Plugin } from '@dxos/app-framework';
+import { CommandConfig } from '@dxos/cli-util';
+import { invariant } from '@dxos/invariant';
+
+import { saveEnabledPlugins } from '../storage';
+
+export const handler = Effect.fn(function* ({ id }: { id: string }) {
+  const { json, profile } = yield* CommandConfig;
+  const manager = yield* Plugin.Service;
+
+  const plugins = manager.getPlugins();
+  const plugin = plugins.find((p: Plugin.Plugin) => p.meta.id === id);
+  invariant(plugin, `Plugin not found: ${id}`);
+
+  const enabled = yield* manager.enable(id);
+  invariant(enabled, `Failed to enable plugin: ${id}`);
+
+  // Save enabled plugins to storage
+  const enabledPlugins = manager.getEnabled();
+  yield* saveEnabledPlugins({ profile, enabled: [...enabledPlugins] });
+
+  if (json) {
+    yield* Console.log(JSON.stringify({ id, enabled: true }, null, 2));
+  } else {
+    yield* Console.log(`Plugin "${plugin.meta.name ?? id}" enabled.`);
+  }
+});
+
+export const enable = Command.make(
+  'enable',
+  {
+    id: Args.text({ name: 'id' }).pipe(Args.withDescription('The ID of the plugin to enable.')),
+  },
+  handler,
+).pipe(Command.withDescription('Enable a plugin.'));

package/src/cli/commands/index.ts

@@ -0,0 +1,14 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Command from '@effect/cli/Command';
+
+import { disable } from './disable';
+import { enable } from './enable';
+import { list } from './list';
+
+export const plugin: Command.Command<any, any, any, any> = Command.make('plugin').pipe(
+  Command.withDescription('Manage plugins.'),
+  Command.withSubcommands([enable, disable, list]),
+);

package/src/cli/commands/list.ts

@@ -0,0 +1,41 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Command from '@effect/cli/Command';
+import * as Console from 'effect/Console';
+import * as Effect from 'effect/Effect';
+
+import { Plugin } from '@dxos/app-framework';
+import { CommandConfig, printList } from '@dxos/cli-util';
+
+import { type FormattedPlugin, printPlugin } from './util';
+
+export const handler = Effect.fn(function* () {
+  const { json } = yield* CommandConfig;
+  const manager = yield* Plugin.Service;
+
+  const plugins = manager.getPlugins();
+  const enabled = manager.getEnabled();
+  const core = manager.getCore();
+
+  const formattedPlugins: FormattedPlugin[] = plugins.map((plugin: Plugin.Plugin) => {
+    const isEnabled = enabled.includes(plugin.meta.id);
+    const isCore = core.includes(plugin.meta.id);
+    return {
+      id: plugin.meta.id,
+      name: plugin.meta.name ?? plugin.meta.id,
+      enabled: isEnabled,
+      core: isCore,
+    };
+  });
+
+  if (json) {
+    yield* Console.log(JSON.stringify(formattedPlugins, null, 2));
+  } else {
+    const formatted = formattedPlugins.map(printPlugin);
+    yield* Console.log(printList(formatted));
+  }
+});
+
+export const list = Command.make('list', {}, handler).pipe(Command.withDescription('List all available plugins.'));

package/src/cli/commands/util.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { FormBuilder } from '@dxos/cli-util';
+
+export type FormattedPlugin = {
+  id: string;
+  name: string;
+  enabled: boolean;
+  core: boolean;
+};
+
+/**
+ * Pretty prints a plugin with ANSI colors.
+ */
+export const printPlugin = (plugin: FormattedPlugin) => {
+  const status = plugin.core ? 'core' : plugin.enabled ? 'enabled' : 'disabled';
+  return FormBuilder.make({ title: plugin.name }).pipe(
+    FormBuilder.set('id', plugin.id),
+    FormBuilder.set('status', status),
+    FormBuilder.build,
+  );
+};

package/src/cli/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './plugin';
+export * from './storage';

package/src/cli/plugin.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Common, Plugin } from '@dxos/app-framework';
+
+import { meta } from '../meta';
+
+import { plugin } from './commands';
+
+export const RegistryPlugin = Plugin.define(meta).pipe(
+  Common.Plugin.addCommandModule({
+    commands: [plugin],
+  }),
+  Plugin.make,
+);