@dxos/plugin-debug 0.8.4-main.bc674ce → 0.8.4-main.bcb3aa67d6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-debug",
-  "version": "0.8.4-main.bc674ce",
+  "version": "0.8.4-main.bcb3aa67d6",
   "description": "DXOS Surface plugin for testing.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,11 +12,18 @@
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#meta": "./src/meta.ts",
+    "#types": "./src/types/index.ts"
+  },
   "exports": {
     ".": {
-      "browser": "./dist/lib/browser/index.mjs",
       "source": "./src/index.ts",
-      "types": "./dist/types/src/index.d.ts"
+      "types": "./dist/types/src/index.d.ts",
+      "browser": "./dist/lib/browser/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -31,84 +38,84 @@
     "@antv/graphlib": "^2.0.4",
     "@antv/layout": "^1.2.13",
     "@automerge/automerge": "3.2.3",
-    "@effect-atom/atom": "^0.4.13",
-    "@effect-atom/atom-react": "^0.4.6",
+    "@effect-atom/atom": "^0.5.1",
+    "@effect-atom/atom-react": "^0.5.0",
     "@tldraw/tldraw": "^3.0.0",
-    "date-fns": "^3.3.1",
+    "date-fns": "^3.6.0",
     "react-json-tree": "^0.18.0",
     "react-resize-detector": "^11.0.1",
     "workerize-loader": "^2.0.2",
-    "@dxos/assistant-toolkit": "0.8.4-main.bc674ce",
-    "@dxos/app-framework": "0.8.4-main.bc674ce",
-    "@dxos/blueprints": "0.8.4-main.bc674ce",
-    "@dxos/client-services": "0.8.4-main.bc674ce",
-    "@dxos/async": "0.8.4-main.bc674ce",
-    "@dxos/compute": "0.8.4-main.bc674ce",
-    "@dxos/conductor": "0.8.4-main.bc674ce",
-    "@dxos/config": "0.8.4-main.bc674ce",
-    "@dxos/context": "0.8.4-main.bc674ce",
-    "@dxos/devtools": "0.8.4-main.bc674ce",
-    "@dxos/echo-generator": "0.8.4-main.bc674ce",
-    "@dxos/echo": "0.8.4-main.bc674ce",
-    "@dxos/effect": "0.8.4-main.bc674ce",
-    "@dxos/echo-pipeline": "0.8.4-main.bc674ce",
-    "@dxos/functions": "0.8.4-main.bc674ce",
-    "@dxos/keys": "0.8.4-main.bc674ce",
-    "@dxos/log": "0.8.4-main.bc674ce",
-    "@dxos/invariant": "0.8.4-main.bc674ce",
-    "@dxos/operation": "0.8.4-main.bc674ce",
-    "@dxos/plugin-client": "0.8.4-main.bc674ce",
-    "@dxos/plugin-deck": "0.8.4-main.bc674ce",
-    "@dxos/plugin-graph": "0.8.4-main.bc674ce",
-    "@dxos/plugin-meeting": "0.8.4-main.bc674ce",
-    "@dxos/plugin-inbox": "0.8.4-main.bc674ce",
-    "@dxos/plugin-script": "0.8.4-main.bc674ce",
-    "@dxos/plugin-markdown": "0.8.4-main.bc674ce",
-    "@dxos/plugin-sheet": "0.8.4-main.bc674ce",
-    "@dxos/plugin-sketch": "0.8.4-main.bc674ce",
-    "@dxos/plugin-status-bar": "0.8.4-main.bc674ce",
-    "@dxos/plugin-space": "0.8.4-main.bc674ce",
-    "@dxos/plugin-table": "0.8.4-main.bc674ce",
-    "@dxos/plugin-theme": "0.8.4-main.bc674ce",
-    "@dxos/protocols": "0.8.4-main.bc674ce",
-    "@dxos/react-client": "0.8.4-main.bc674ce",
-    "@dxos/random": "0.8.4-main.bc674ce",
-    "@dxos/react-hooks": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-canvas-compute": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-attention": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-canvas-editor": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-kanban": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-stack": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-form": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-mosaic": "0.8.4-main.bc674ce",
-    "@dxos/react-ui-table": "0.8.4-main.bc674ce",
-    "@dxos/types": "0.8.4-main.bc674ce",
-    "@dxos/util": "0.8.4-main.bc674ce",
-    "@dxos/schema": "0.8.4-main.bc674ce"
+    "@dxos/app-framework": "0.8.4-main.bcb3aa67d6",
+    "@dxos/app-toolkit": "0.8.4-main.bcb3aa67d6",
+    "@dxos/assistant-toolkit": "0.8.4-main.bcb3aa67d6",
+    "@dxos/blueprints": "0.8.4-main.bcb3aa67d6",
+    "@dxos/async": "0.8.4-main.bcb3aa67d6",
+    "@dxos/client-services": "0.8.4-main.bcb3aa67d6",
+    "@dxos/compute": "0.8.4-main.bcb3aa67d6",
+    "@dxos/conductor": "0.8.4-main.bcb3aa67d6",
+    "@dxos/config": "0.8.4-main.bcb3aa67d6",
+    "@dxos/context": "0.8.4-main.bcb3aa67d6",
+    "@dxos/devtools": "0.8.4-main.bcb3aa67d6",
+    "@dxos/echo": "0.8.4-main.bcb3aa67d6",
+    "@dxos/echo-generator": "0.8.4-main.bcb3aa67d6",
+    "@dxos/echo-pipeline": "0.8.4-main.bcb3aa67d6",
+    "@dxos/effect": "0.8.4-main.bcb3aa67d6",
+    "@dxos/functions": "0.8.4-main.bcb3aa67d6",
+    "@dxos/invariant": "0.8.4-main.bcb3aa67d6",
+    "@dxos/keys": "0.8.4-main.bcb3aa67d6",
+    "@dxos/log": "0.8.4-main.bcb3aa67d6",
+    "@dxos/operation": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-client": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-graph": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-deck": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-inbox": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-markdown": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-meeting": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-script": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-sheet": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-space": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-status-bar": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-sketch": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-table": "0.8.4-main.bcb3aa67d6",
+    "@dxos/protocols": "0.8.4-main.bcb3aa67d6",
+    "@dxos/random": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-client": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-hooks": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-canvas-compute": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-attention": "0.8.4-main.bcb3aa67d6",
+    "@dxos/plugin-theme": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-canvas-editor": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-form": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.bcb3aa67d6",
+    "@dxos/schema": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-stack": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-mosaic": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui-table": "0.8.4-main.bcb3aa67d6",
+    "@dxos/util": "0.8.4-main.bcb3aa67d6",
+    "@dxos/types": "0.8.4-main.bcb3aa67d6"
   },
   "devDependencies": {
-    "@effect-atom/atom-react": "^0.4.6",
-    "@effect/platform": "0.93.6",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
-    "effect": "3.19.11",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.bc674ce",
-    "@dxos/ui-theme": "0.8.4-main.bc674ce",
-    "@dxos/storybook-utils": "0.8.4-main.bc674ce"
+    "vite": "^7.1.11",
+    "@dxos/storybook-utils": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui": "0.8.4-main.bcb3aa67d6",
+    "@dxos/ui-theme": "0.8.4-main.bcb3aa67d6"
   },
   "peerDependencies": {
-    "@effect-atom/atom-react": "^0.4.6",
-    "@effect/platform": "0.93.6",
-    "effect": "3.19.11",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/ui-theme": "0.8.4-main.bc674ce",
-    "@dxos/react-ui": "0.8.4-main.bc674ce",
-    "@dxos/random": "0.8.4-main.bc674ce"
+    "@dxos/random": "0.8.4-main.bcb3aa67d6",
+    "@dxos/react-ui": "0.8.4-main.bcb3aa67d6",
+    "@dxos/ui-theme": "0.8.4-main.bcb3aa67d6"
   },
   "publishConfig": {
     "access": "public"

package/src/DebugPlugin.tsx

@@ -4,25 +4,38 @@
 
 import * as Effect from 'effect/Effect';
 
-import { Common, Plugin } from '@dxos/app-framework';
+import { ActivationEvents, Capability, Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { type LogBuffer } from '@dxos/log';
 import { type Client } from '@dxos/react-client';
 
-import { AppGraphBuilder, DebugSettings, ReactContext, ReactSurface } from './capabilities';
-import { meta } from './meta';
+import { meta } from '#meta';
 import { translations } from './translations';
 
+import { AppGraphBuilder, DebugSettings, ReactContext, ReactSurface } from '#capabilities';
+
+export type DebugPluginOptions = {
+  /** Shared log buffer for capturing and downloading logs. */
+  logBuffer: LogBuffer;
+};
+
 // TODO(wittjosiah): Factor out DevtoolsPlugin?
-export const DebugPlugin = Plugin.define(meta).pipe(
+
+export const DebugPlugin = Plugin.define<DebugPluginOptions>(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  AppPlugin.addReactContextModule({ activate: ReactContext }),
+  AppPlugin.addSettingsModule({ activate: DebugSettings }),
+  Plugin.addModule(({ logBuffer }) => ({
+    id: Capability.getModuleTag(ReactSurface) ?? 'surfaces',
+    activatesOn: ActivationEvents.SetupReactSurface,
+    activate: () => ReactSurface({ logBuffer }),
+  })),
+  AppPlugin.addTranslationsModule({ translations }),
   Plugin.addModule({
     id: 'setup-devtools',
-    activatesOn: Common.ActivationEvent.Startup,
+    activatesOn: ActivationEvents.Startup,
     activate: () => Effect.sync(() => setupDevtools()),
   }),
-  Common.Plugin.addSettingsModule({ activate: DebugSettings }),
-  Common.Plugin.addTranslationsModule({ translations }),
-  Common.Plugin.addReactContextModule({ activate: ReactContext }),
-  Common.Plugin.addSurfaceModule({ activate: ReactSurface }),
-  Common.Plugin.addAppGraphModule({ activate: AppGraphBuilder }),
   Plugin.make,
 );
 

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

@@ -0,0 +1,406 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities, AppNode, getSpaceIdFromPath } from '@dxos/app-toolkit';
+import { ClientCapabilities } from '@dxos/plugin-client/types';
+import { GraphBuilder, Node, NodeMatcher } from '@dxos/plugin-graph';
+import { meta as spaceMeta } from '@dxos/plugin-space/meta';
+
+import { meta } from '#meta';
+import { Devtools } from '#types';
+import { getParentId } from '@dxos/react-ui-attention';
+
+const DEVTOOLS_TYPE = `${meta.id}.devtools`;
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const extensions = yield* Effect.all([
+      // Devtools node.
+      GraphBuilder.createExtension({
+        id: `${meta.id}.devtools`,
+        match: NodeMatcher.whenAny(NodeMatcher.whenRoot, NodeMatcher.whenNodeType(`${spaceMeta.id}.settings`)),
+        connector: (node, get) =>
+          Effect.gen(function* () {
+            const client = yield* Capability.get(ClientCapabilities.Client);
+            const layoutAtom = get(yield* Capability.atom(AppCapabilities.Layout))[0];
+            const layout = layoutAtom ? get(layoutAtom) : undefined;
+            const spaceId = layout?.workspace ? getSpaceIdFromPath(layout.workspace) : undefined;
+            const space = spaceId ? client.spaces.get(spaceId) : undefined;
+            const [graph] = get(yield* Capability.atom(AppCapabilities.AppGraph));
+
+            return [
+              Node.make({
+                id: Devtools.id,
+                data: null,
+                type: DEVTOOLS_TYPE,
+                properties: {
+                  label: ['devtools.label', { ns: meta.id }],
+                  icon: 'ph--hammer--regular',
+                  disposition: 'pin-end',
+                  position: 'fallback',
+                },
+                nodes: [
+                  ...(space && node.type === `${spaceMeta.id}.settings`
+                    ? [
+                        Node.make({
+                          id: 'debug',
+                          type: `${meta.id}.space`,
+                          data: { space, type: `${meta.id}.space` },
+                          properties: {
+                            label: ['debug.label', { ns: meta.id }],
+                            icon: 'ph--bug--regular',
+                          },
+                        }),
+                      ]
+                    : []),
+                  Node.make({
+                    id: 'app-graph',
+                    type: `${meta.id}.app-graph`,
+                    data: { graph: graph?.graph, root: node.id === Node.RootId ? node.id : getParentId(node.id) },
+                    properties: {
+                      label: ['debug-app-graph.label', { ns: meta.id }],
+                      icon: 'ph--graph--regular',
+                    },
+                  }),
+                  Node.make({
+                    id: Devtools.Client.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['client.label', { ns: meta.id }],
+                      icon: 'ph--users--regular',
+                    },
+                    nodes: [
+                      Node.make({
+                        id: Devtools.Client.Config,
+                        data: Devtools.Client.Config,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['config.label', { ns: meta.id }],
+                          icon: 'ph--gear--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Client.Storage,
+                        data: Devtools.Client.Storage,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['storage.label', { ns: meta.id }],
+                          icon: 'ph--hard-drives--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Client.Logs,
+                        data: Devtools.Client.Logs,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['logs.label', { ns: meta.id }],
+                          icon: 'ph--file-text--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Client.Diagnostics,
+                        data: Devtools.Client.Diagnostics,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['diagnostics.label', { ns: meta.id }],
+                          icon: 'ph--chart-line--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Client.Tracing,
+                        data: Devtools.Client.Tracing,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['tracing.label', { ns: meta.id }],
+                          icon: 'ph--fire--regular',
+                        },
+                      }),
+                    ],
+                  }),
+                  Node.make({
+                    id: Devtools.Halo.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['halo.label', { ns: meta.id }],
+                      icon: 'ph--identification-badge--regular',
+                    },
+                    nodes: [
+                      Node.make({
+                        id: Devtools.Halo.Identity,
+                        data: Devtools.Halo.Identity,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['identity.label', { ns: meta.id }],
+                          icon: 'ph--identification-badge--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Halo.Devices,
+                        data: Devtools.Halo.Devices,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['devices.label', { ns: meta.id }],
+                          icon: 'ph--devices--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Halo.Keyring,
+                        data: Devtools.Halo.Keyring,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['keyring.label', { ns: meta.id }],
+                          icon: 'ph--key--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Halo.Credentials,
+                        data: Devtools.Halo.Credentials,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['credentials.label', { ns: meta.id }],
+                          icon: 'ph--credit-card--regular',
+                        },
+                      }),
+                    ],
+                  }),
+                  Node.make({
+                    id: Devtools.Echo.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['echo.label', { ns: meta.id }],
+                      icon: 'ph--database--regular',
+                    },
+                    nodes: [
+                      Node.make({
+                        id: Devtools.Echo.Spaces,
+                        data: Devtools.Echo.Spaces,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['spaces.label', { ns: meta.id }],
+                          icon: 'ph--graph--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Space,
+                        data: Devtools.Echo.Space,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['space.label', { ns: meta.id }],
+                          icon: 'ph--planet--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Feeds,
+                        data: Devtools.Echo.Feeds,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['feeds.label', { ns: meta.id }],
+                          icon: 'ph--list-bullets--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Objects,
+                        data: Devtools.Echo.Objects,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['objects.label', { ns: meta.id }],
+                          icon: 'ph--cube--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Schema,
+                        data: Devtools.Echo.Schema,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['schema.label', { ns: meta.id }],
+                          icon: 'ph--database--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Automerge,
+                        data: Devtools.Echo.Automerge,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['automerge.label', { ns: meta.id }],
+                          icon: 'ph--gear-six--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Queues,
+                        data: Devtools.Echo.Queues,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['queues.label', { ns: meta.id }],
+                          icon: 'ph--queue--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Members,
+                        data: Devtools.Echo.Members,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['members.label', { ns: meta.id }],
+                          icon: 'ph--users--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Echo.Metadata,
+                        data: Devtools.Echo.Metadata,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['metadata.label', { ns: meta.id }],
+                          icon: 'ph--hard-drive--regular',
+                        },
+                      }),
+                    ],
+                  }),
+                  Node.make({
+                    id: Devtools.Mesh.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['mesh.label', { ns: meta.id }],
+                      icon: 'ph--graph--regular',
+                    },
+                    nodes: [
+                      Node.make({
+                        id: Devtools.Mesh.Signal,
+                        data: Devtools.Mesh.Signal,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['signal.label', { ns: meta.id }],
+                          icon: 'ph--wifi-high--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Mesh.Swarm,
+                        data: Devtools.Mesh.Swarm,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['swarm.label', { ns: meta.id }],
+                          icon: 'ph--users-three--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Mesh.Network,
+                        data: Devtools.Mesh.Network,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['network.label', { ns: meta.id }],
+                          icon: 'ph--polygon--regular',
+                        },
+                      }),
+                    ],
+                  }),
+                  Node.make({
+                    id: Devtools.Edge.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['edge.label', { ns: meta.id }],
+                      icon: 'ph--cloud--regular',
+                    },
+                    nodes: [
+                      Node.make({
+                        id: Devtools.Edge.Dashboard,
+                        data: Devtools.Edge.Dashboard,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['dashboard.label', { ns: meta.id }],
+                          icon: 'ph--computer-tower--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Edge.Workflows,
+                        data: Devtools.Edge.Workflows,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['workflows.label', { ns: meta.id }],
+                          icon: 'ph--function--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Edge.Traces,
+                        data: Devtools.Edge.Traces,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['traces.label', { ns: meta.id }],
+                          icon: 'ph--line-segments--regular',
+                        },
+                      }),
+                      Node.make({
+                        id: Devtools.Edge.Testing,
+                        data: Devtools.Edge.Testing,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['testing.label', { ns: meta.id }],
+                          icon: 'ph--flask--regular',
+                        },
+                      }),
+                    ],
+                  }),
+                ],
+              }),
+            ];
+          }),
+      }),
+
+      // Debug object companion.
+      GraphBuilder.createExtension({
+        id: `${meta.id}.debug-object`,
+        match: NodeMatcher.whenEchoObject,
+        connector: () =>
+          Effect.succeed([
+            AppNode.makeCompanion({
+              id: 'debug',
+              label: ['debug.label', { ns: meta.id }],
+              icon: 'ph--bug--regular',
+              data: 'debug',
+              position: 'fallback',
+            }),
+          ]),
+      }),
+
+      // Devtools deck companion.
+      GraphBuilder.createExtension({
+        id: `${meta.id}.devtools-overview`,
+        match: NodeMatcher.whenRoot,
+        connector: () =>
+          Effect.succeed([
+            AppNode.makeDeckCompanion({
+              id: 'devtools',
+              label: ['devtools-overview.label', { ns: meta.id }],
+              icon: 'ph--equalizer--regular',
+              data: 'devtools' as const,
+              position: 'fallback',
+            }),
+          ]),
+      }),
+
+      // Object explorer.
+      GraphBuilder.createExtension({
+        id: `${meta.id}.space-objects`,
+        match: NodeMatcher.whenRoot,
+        connector: () =>
+          Effect.succeed([
+            AppNode.makeDeckCompanion({
+              id: 'space-objects',
+              label: ['space-objects.label', { ns: meta.id }],
+              icon: 'ph--cube--regular',
+              data: 'space-objects' as const,
+              position: 'fallback',
+            }),
+          ]),
+      }),
+    ]);
+
+    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
+  }),
+);

package/src/capabilities/index.ts

@@ -2,7 +2,9 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './app-graph-builder';
-export * from './react-context';
-export * from './react-surface';
-export * from './settings';
+import { Capability } from '@dxos/app-framework';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));
+export const ReactContext = Capability.lazy('ReactContext', () => import('./react-context'));
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const DebugSettings = Capability.lazy('DebugSettings', () => import('./settings'));