@dxos/plugin-debug 0.8.4-main.72ec0f3 → 0.8.4-main.7996785055

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@dxos/plugin-debug",
-  "version": "0.8.4-main.72ec0f3",
+  "version": "0.8.4-main.7996785055",
   "description": "DXOS Surface plugin for testing.",
   "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,
@@ -26,84 +30,85 @@
   "dependencies": {
     "@antv/graphlib": "^2.0.4",
     "@antv/layout": "^1.2.13",
-    "@automerge/automerge": "3.1.2",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
+    "@automerge/automerge": "3.2.3",
+    "@effect-atom/atom": "^0.5.1",
+    "@effect-atom/atom-react": "^0.5.0",
     "@tldraw/tldraw": "^3.0.0",
     "date-fns": "^3.3.1",
     "react-json-tree": "^0.18.0",
     "react-resize-detector": "^11.0.1",
     "workerize-loader": "^2.0.2",
-    "@dxos/app-framework": "0.8.4-main.72ec0f3",
-    "@dxos/assistant-toolkit": "0.8.4-main.72ec0f3",
-    "@dxos/async": "0.8.4-main.72ec0f3",
-    "@dxos/blueprints": "0.8.4-main.72ec0f3",
-    "@dxos/compute": "0.8.4-main.72ec0f3",
-    "@dxos/client-services": "0.8.4-main.72ec0f3",
-    "@dxos/conductor": "0.8.4-main.72ec0f3",
-    "@dxos/config": "0.8.4-main.72ec0f3",
-    "@dxos/context": "0.8.4-main.72ec0f3",
-    "@dxos/devtools": "0.8.4-main.72ec0f3",
-    "@dxos/echo": "0.8.4-main.72ec0f3",
-    "@dxos/echo-generator": "0.8.4-main.72ec0f3",
-    "@dxos/echo-pipeline": "0.8.4-main.72ec0f3",
-    "@dxos/invariant": "0.8.4-main.72ec0f3",
-    "@dxos/keys": "0.8.4-main.72ec0f3",
-    "@dxos/live-object": "0.8.4-main.72ec0f3",
-    "@dxos/local-storage": "0.8.4-main.72ec0f3",
-    "@dxos/log": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-deck": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-client": "0.8.4-main.72ec0f3",
-    "@dxos/functions": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-graph": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-inbox": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-markdown": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-script": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-sketch": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-meeting": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-sheet": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-space": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-status-bar": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-theme": "0.8.4-main.72ec0f3",
-    "@dxos/plugin-table": "0.8.4-main.72ec0f3",
-    "@dxos/random": "0.8.4-main.72ec0f3",
-    "@dxos/protocols": "0.8.4-main.72ec0f3",
-    "@dxos/react-client": "0.8.4-main.72ec0f3",
-    "@dxos/react-hooks": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-attention": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-canvas-editor": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-stack": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-table": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-kanban": "0.8.4-main.72ec0f3",
-    "@dxos/types": "0.8.4-main.72ec0f3",
-    "@dxos/schema": "0.8.4-main.72ec0f3",
-    "@dxos/util": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-form": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-canvas-compute": "0.8.4-main.72ec0f3"
+    "@dxos/async": "0.8.4-main.7996785055",
+    "@dxos/assistant-toolkit": "0.8.4-main.7996785055",
+    "@dxos/app-toolkit": "0.8.4-main.7996785055",
+    "@dxos/app-framework": "0.8.4-main.7996785055",
+    "@dxos/client-services": "0.8.4-main.7996785055",
+    "@dxos/blueprints": "0.8.4-main.7996785055",
+    "@dxos/compute": "0.8.4-main.7996785055",
+    "@dxos/config": "0.8.4-main.7996785055",
+    "@dxos/conductor": "0.8.4-main.7996785055",
+    "@dxos/context": "0.8.4-main.7996785055",
+    "@dxos/echo": "0.8.4-main.7996785055",
+    "@dxos/echo-pipeline": "0.8.4-main.7996785055",
+    "@dxos/effect": "0.8.4-main.7996785055",
+    "@dxos/functions": "0.8.4-main.7996785055",
+    "@dxos/invariant": "0.8.4-main.7996785055",
+    "@dxos/keys": "0.8.4-main.7996785055",
+    "@dxos/echo-generator": "0.8.4-main.7996785055",
+    "@dxos/log": "0.8.4-main.7996785055",
+    "@dxos/plugin-client": "0.8.4-main.7996785055",
+    "@dxos/operation": "0.8.4-main.7996785055",
+    "@dxos/plugin-deck": "0.8.4-main.7996785055",
+    "@dxos/plugin-graph": "0.8.4-main.7996785055",
+    "@dxos/plugin-inbox": "0.8.4-main.7996785055",
+    "@dxos/plugin-markdown": "0.8.4-main.7996785055",
+    "@dxos/plugin-meeting": "0.8.4-main.7996785055",
+    "@dxos/plugin-sheet": "0.8.4-main.7996785055",
+    "@dxos/plugin-script": "0.8.4-main.7996785055",
+    "@dxos/plugin-space": "0.8.4-main.7996785055",
+    "@dxos/plugin-sketch": "0.8.4-main.7996785055",
+    "@dxos/plugin-table": "0.8.4-main.7996785055",
+    "@dxos/plugin-status-bar": "0.8.4-main.7996785055",
+    "@dxos/plugin-theme": "0.8.4-main.7996785055",
+    "@dxos/protocols": "0.8.4-main.7996785055",
+    "@dxos/devtools": "0.8.4-main.7996785055",
+    "@dxos/random": "0.8.4-main.7996785055",
+    "@dxos/react-hooks": "0.8.4-main.7996785055",
+    "@dxos/react-ui-attention": "0.8.4-main.7996785055",
+    "@dxos/react-ui-canvas-compute": "0.8.4-main.7996785055",
+    "@dxos/react-ui-canvas-editor": "0.8.4-main.7996785055",
+    "@dxos/react-client": "0.8.4-main.7996785055",
+    "@dxos/react-ui-form": "0.8.4-main.7996785055",
+    "@dxos/react-ui-stack": "0.8.4-main.7996785055",
+    "@dxos/react-ui-mosaic": "0.8.4-main.7996785055",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.7996785055",
+    "@dxos/schema": "0.8.4-main.7996785055",
+    "@dxos/util": "0.8.4-main.7996785055",
+    "@dxos/types": "0.8.4-main.7996785055",
+    "@dxos/react-ui-table": "0.8.4-main.7996785055"
   },
   "devDependencies": {
-    "@effect-atom/atom-react": "^0.3.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",
-    "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-theme": "0.8.4-main.72ec0f3",
-    "@dxos/storybook-utils": "0.8.4-main.72ec0f3"
+    "@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.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^7.1.11",
+    "@dxos/react-ui": "0.8.4-main.7996785055",
+    "@dxos/storybook-utils": "0.8.4-main.7996785055",
+    "@dxos/ui-theme": "0.8.4-main.7996785055"
   },
   "peerDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
-    "@dxos/random": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui": "0.8.4-main.72ec0f3",
-    "@dxos/react-ui-theme": "0.8.4-main.72ec0f3"
+    "@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/random": "0.8.4-main.7996785055",
+    "@dxos/ui-theme": "0.8.4-main.7996785055",
+    "@dxos/react-ui": "0.8.4-main.7996785055"
   },
   "publishConfig": {
     "access": "public"

package/src/DebugPlugin.tsx

@@ -2,44 +2,40 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, defineModule, definePlugin } from '@dxos/app-framework';
+import * as Effect from 'effect/Effect';
+
+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 { translations } from './translations';
 
+export type DebugPluginOptions = {
+  /** Shared log buffer for capturing and downloading logs. */
+  logBuffer: LogBuffer;
+};
+
 // TODO(wittjosiah): Factor out DevtoolsPlugin?
-export const DebugPlugin = definePlugin(meta, () => {
-  setupDevtools();
-  return [
-    defineModule({
-      id: `${meta.id}/module/settings`,
-      activatesOn: Events.SetupSettings,
-      activate: DebugSettings,
-    }),
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-context`,
-      activatesOn: Events.Startup,
-      activate: ReactContext,
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-    defineModule({
-      id: `${meta.id}/module/app-graph-builder`,
-      activatesOn: Events.SetupAppGraph,
-      activate: AppGraphBuilder,
-    }),
-  ];
-});
+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: ActivationEvents.Startup,
+    activate: () => Effect.sync(() => setupDevtools()),
+  }),
+  Plugin.make,
+);
 
 const setupDevtools = () => {
   (globalThis as any).composer ??= {};

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

@@ -0,0 +1,419 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities, getSpaceIdFromPath } from '@dxos/app-toolkit';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { DECK_COMPANION_TYPE, PLANK_COMPANION_TYPE } from '@dxos/plugin-deck/types';
+import { GraphBuilder, Node, NodeMatcher } from '@dxos/plugin-graph';
+import { meta as spaceMeta } from '@dxos/plugin-space';
+
+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 [
+              {
+                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`
+                    ? [
+                        {
+                          id: 'debug',
+                          type: `${meta.id}.space`,
+                          data: { space, type: `${meta.id}.space` },
+                          properties: {
+                            label: ['debug label', { ns: meta.id }],
+                            icon: 'ph--bug--regular',
+                          },
+                        },
+                      ]
+                    : []),
+                  {
+                    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',
+                    },
+                  },
+                  {
+                    id: Devtools.Client.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['client label', { ns: meta.id }],
+                      icon: 'ph--users--regular',
+                    },
+                    nodes: [
+                      {
+                        id: Devtools.Client.Config,
+                        data: Devtools.Client.Config,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['config label', { ns: meta.id }],
+                          icon: 'ph--gear--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Client.Storage,
+                        data: Devtools.Client.Storage,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['storage label', { ns: meta.id }],
+                          icon: 'ph--hard-drives--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Client.Logs,
+                        data: Devtools.Client.Logs,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['logs label', { ns: meta.id }],
+                          icon: 'ph--file-text--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Client.Diagnostics,
+                        data: Devtools.Client.Diagnostics,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['diagnostics label', { ns: meta.id }],
+                          icon: 'ph--chart-line--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Client.Tracing,
+                        data: Devtools.Client.Tracing,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['tracing label', { ns: meta.id }],
+                          icon: 'ph--fire--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: Devtools.Halo.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['halo label', { ns: meta.id }],
+                      icon: 'ph--identification-badge--regular',
+                    },
+                    nodes: [
+                      {
+                        id: Devtools.Halo.Identity,
+                        data: Devtools.Halo.Identity,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['identity label', { ns: meta.id }],
+                          icon: 'ph--identification-badge--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Halo.Devices,
+                        data: Devtools.Halo.Devices,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['devices label', { ns: meta.id }],
+                          icon: 'ph--devices--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Halo.Keyring,
+                        data: Devtools.Halo.Keyring,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['keyring label', { ns: meta.id }],
+                          icon: 'ph--key--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Halo.Credentials,
+                        data: Devtools.Halo.Credentials,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['credentials label', { ns: meta.id }],
+                          icon: 'ph--credit-card--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: Devtools.Echo.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['echo label', { ns: meta.id }],
+                      icon: 'ph--database--regular',
+                    },
+                    nodes: [
+                      {
+                        id: Devtools.Echo.Spaces,
+                        data: Devtools.Echo.Spaces,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['spaces label', { ns: meta.id }],
+                          icon: 'ph--graph--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Space,
+                        data: Devtools.Echo.Space,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['space label', { ns: meta.id }],
+                          icon: 'ph--planet--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Feeds,
+                        data: Devtools.Echo.Feeds,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['feeds label', { ns: meta.id }],
+                          icon: 'ph--list-bullets--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Objects,
+                        data: Devtools.Echo.Objects,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['objects label', { ns: meta.id }],
+                          icon: 'ph--cube--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Schema,
+                        data: Devtools.Echo.Schema,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['schema label', { ns: meta.id }],
+                          icon: 'ph--database--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Automerge,
+                        data: Devtools.Echo.Automerge,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['automerge label', { ns: meta.id }],
+                          icon: 'ph--gear-six--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Queues,
+                        data: Devtools.Echo.Queues,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['queues label', { ns: meta.id }],
+                          icon: 'ph--queue--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Members,
+                        data: Devtools.Echo.Members,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['members label', { ns: meta.id }],
+                          icon: 'ph--users--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Echo.Metadata,
+                        data: Devtools.Echo.Metadata,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['metadata label', { ns: meta.id }],
+                          icon: 'ph--hard-drive--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: Devtools.Mesh.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['mesh label', { ns: meta.id }],
+                      icon: 'ph--graph--regular',
+                    },
+                    nodes: [
+                      {
+                        id: Devtools.Mesh.Signal,
+                        data: Devtools.Mesh.Signal,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['signal label', { ns: meta.id }],
+                          icon: 'ph--wifi-high--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Mesh.Swarm,
+                        data: Devtools.Mesh.Swarm,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['swarm label', { ns: meta.id }],
+                          icon: 'ph--users-three--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Mesh.Network,
+                        data: Devtools.Mesh.Network,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['network label', { ns: meta.id }],
+                          icon: 'ph--polygon--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: Devtools.Edge.id,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['edge label', { ns: meta.id }],
+                      icon: 'ph--cloud--regular',
+                    },
+                    nodes: [
+                      {
+                        id: Devtools.Edge.Dashboard,
+                        data: Devtools.Edge.Dashboard,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['dashboard label', { ns: meta.id }],
+                          icon: 'ph--computer-tower--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Edge.Workflows,
+                        data: Devtools.Edge.Workflows,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['workflows label', { ns: meta.id }],
+                          icon: 'ph--function--regular',
+                        },
+                      },
+                      {
+                        id: Devtools.Edge.Traces,
+                        data: Devtools.Edge.Traces,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['traces label', { ns: meta.id }],
+                          icon: 'ph--line-segments--regular',
+                        },
+                      },
+                      {
+                        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([
+            {
+              id: 'debug',
+              type: PLANK_COMPANION_TYPE,
+              data: 'debug',
+              properties: {
+                label: ['debug label', { ns: meta.id }],
+                icon: 'ph--bug--regular',
+                disposition: 'hidden',
+                position: 'fallback',
+              },
+            },
+          ]),
+      }),
+
+      // Devtools deck companion.
+      GraphBuilder.createExtension({
+        id: `${meta.id}.devtools-overview`,
+        match: NodeMatcher.whenRoot,
+        connector: () =>
+          Effect.succeed([
+            {
+              id: 'devtools',
+              type: DECK_COMPANION_TYPE,
+              data: 'devtools' as const,
+              properties: {
+                label: ['devtools overview label', { ns: meta.id }],
+                icon: 'ph--equalizer--regular',
+                disposition: 'hidden',
+                position: 'fallback',
+              },
+            },
+          ]),
+      }),
+
+      // Object explorer.
+      GraphBuilder.createExtension({
+        id: `${meta.id}.space-objects`,
+        match: NodeMatcher.whenRoot,
+        connector: () =>
+          Effect.succeed([
+            {
+              id: 'space-objects',
+              type: DECK_COMPANION_TYPE,
+              data: 'space-objects' as const,
+              properties: {
+                label: ['space objects label', { ns: meta.id }],
+                icon: 'ph--cube--regular',
+                disposition: 'hidden',
+                position: 'fallback',
+              },
+            },
+          ]),
+      }),
+    ]);
+
+    return Capability.contributes(AppCapabilities.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'));