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

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "@dxos/plugin-debug",
-  "version": "0.8.4-main.72ec0f3",
+  "version": "0.8.4-main.937b3ca",
   "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,
   "type": "module",
   "exports": {
     ".": {
+      "browser": "./dist/lib/browser/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"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -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.4.13",
+    "@effect-atom/atom-react": "^0.4.6",
     "@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/assistant-toolkit": "0.8.4-main.937b3ca",
+    "@dxos/app-framework": "0.8.4-main.937b3ca",
+    "@dxos/async": "0.8.4-main.937b3ca",
+    "@dxos/blueprints": "0.8.4-main.937b3ca",
+    "@dxos/client-services": "0.8.4-main.937b3ca",
+    "@dxos/conductor": "0.8.4-main.937b3ca",
+    "@dxos/config": "0.8.4-main.937b3ca",
+    "@dxos/context": "0.8.4-main.937b3ca",
+    "@dxos/compute": "0.8.4-main.937b3ca",
+    "@dxos/devtools": "0.8.4-main.937b3ca",
+    "@dxos/echo-generator": "0.8.4-main.937b3ca",
+    "@dxos/echo": "0.8.4-main.937b3ca",
+    "@dxos/effect": "0.8.4-main.937b3ca",
+    "@dxos/echo-pipeline": "0.8.4-main.937b3ca",
+    "@dxos/invariant": "0.8.4-main.937b3ca",
+    "@dxos/functions": "0.8.4-main.937b3ca",
+    "@dxos/keys": "0.8.4-main.937b3ca",
+    "@dxos/log": "0.8.4-main.937b3ca",
+    "@dxos/operation": "0.8.4-main.937b3ca",
+    "@dxos/plugin-client": "0.8.4-main.937b3ca",
+    "@dxos/plugin-graph": "0.8.4-main.937b3ca",
+    "@dxos/plugin-deck": "0.8.4-main.937b3ca",
+    "@dxos/plugin-markdown": "0.8.4-main.937b3ca",
+    "@dxos/plugin-script": "0.8.4-main.937b3ca",
+    "@dxos/plugin-meeting": "0.8.4-main.937b3ca",
+    "@dxos/plugin-sheet": "0.8.4-main.937b3ca",
+    "@dxos/plugin-inbox": "0.8.4-main.937b3ca",
+    "@dxos/plugin-sketch": "0.8.4-main.937b3ca",
+    "@dxos/plugin-space": "0.8.4-main.937b3ca",
+    "@dxos/plugin-status-bar": "0.8.4-main.937b3ca",
+    "@dxos/plugin-theme": "0.8.4-main.937b3ca",
+    "@dxos/plugin-table": "0.8.4-main.937b3ca",
+    "@dxos/protocols": "0.8.4-main.937b3ca",
+    "@dxos/react-hooks": "0.8.4-main.937b3ca",
+    "@dxos/react-client": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-attention": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-canvas-editor": "0.8.4-main.937b3ca",
+    "@dxos/random": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-form": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-kanban": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-stack": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-table": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-mosaic": "0.8.4-main.937b3ca",
+    "@dxos/schema": "0.8.4-main.937b3ca",
+    "@dxos/types": "0.8.4-main.937b3ca",
+    "@dxos/util": "0.8.4-main.937b3ca",
+    "@dxos/react-ui-canvas-compute": "0.8.4-main.937b3ca"
   },
   "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",
+    "@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.72ec0f3",
-    "@dxos/react-ui-theme": "0.8.4-main.72ec0f3",
-    "@dxos/storybook-utils": "0.8.4-main.72ec0f3"
+    "@dxos/storybook-utils": "0.8.4-main.937b3ca",
+    "@dxos/react-ui": "0.8.4-main.937b3ca",
+    "@dxos/ui-theme": "0.8.4-main.937b3ca"
   },
   "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.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.937b3ca",
+    "@dxos/random": "0.8.4-main.937b3ca",
+    "@dxos/ui-theme": "0.8.4-main.937b3ca"
   },
   "publishConfig": {
     "access": "public"

package/src/DebugPlugin.tsx

@@ -2,7 +2,9 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, defineModule, definePlugin } from '@dxos/app-framework';
+import * as Effect from 'effect/Effect';
+
+import { Common, Plugin } from '@dxos/app-framework';
 import { type Client } from '@dxos/react-client';
 
 import { AppGraphBuilder, DebugSettings, ReactContext, ReactSurface } from './capabilities';
@@ -10,36 +12,19 @@ import { meta } from './meta';
 import { translations } from './translations';
 
 // 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(meta).pipe(
+  Plugin.addModule({
+    id: 'setup-devtools',
+    activatesOn: Common.ActivationEvent.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,
+);
 
 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, Common } from '@dxos/app-framework';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { ATTENDABLE_PATH_SEPARATOR, 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 { parseId } from '@dxos/react-client/echo';
+
+import { meta } from '../../meta';
+import { Devtools } from '../../types';
+
+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(Common.Capability.Layout))[0];
+            const layout = layoutAtom ? get(layoutAtom) : undefined;
+            const { spaceId } = parseId(layout?.workspace);
+            const space = spaceId ? client.spaces.get(spaceId) : undefined;
+            const [graph] = get(yield* Capability.atom(Common.Capability.AppGraph));
+
+            return [
+              {
+                id: `${Devtools.id}-${node.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-${node.id}`,
+                          type: `${meta.id}/space`,
+                          data: { space, type: `${meta.id}/space` },
+                          properties: {
+                            label: ['debug label', { ns: meta.id }],
+                            icon: 'ph--bug--regular',
+                          },
+                        },
+                      ]
+                    : []),
+                  {
+                    id: `app-graph-${node.id}`,
+                    type: `${meta.id}/app-graph`,
+                    data: { graph: graph?.graph, root: space ? space.id : Node.RootId },
+                    properties: {
+                      label: ['debug app graph label', { ns: meta.id }],
+                      icon: 'ph--graph--regular',
+                    },
+                  },
+                  {
+                    id: `${Devtools.Client.id}-${node.id}`,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['client label', { ns: meta.id }],
+                      icon: 'ph--users--regular',
+                    },
+                    nodes: [
+                      {
+                        id: `${Devtools.Client.Config}-${node.id}`,
+                        data: Devtools.Client.Config,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['config label', { ns: meta.id }],
+                          icon: 'ph--gear--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Client.Storage}-${node.id}`,
+                        data: Devtools.Client.Storage,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['storage label', { ns: meta.id }],
+                          icon: 'ph--hard-drives--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Client.Logs}-${node.id}`,
+                        data: Devtools.Client.Logs,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['logs label', { ns: meta.id }],
+                          icon: 'ph--file-text--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Client.Diagnostics}-${node.id}`,
+                        data: Devtools.Client.Diagnostics,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['diagnostics label', { ns: meta.id }],
+                          icon: 'ph--chart-line--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Client.Tracing}-${node.id}`,
+                        data: Devtools.Client.Tracing,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['tracing label', { ns: meta.id }],
+                          icon: 'ph--fire--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: `${Devtools.Halo.id}-${node.id}`,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['halo label', { ns: meta.id }],
+                      icon: 'ph--identification-badge--regular',
+                    },
+                    nodes: [
+                      {
+                        id: `${Devtools.Halo.Identity}-${node.id}`,
+                        data: Devtools.Halo.Identity,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['identity label', { ns: meta.id }],
+                          icon: 'ph--identification-badge--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Halo.Devices}-${node.id}`,
+                        data: Devtools.Halo.Devices,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['devices label', { ns: meta.id }],
+                          icon: 'ph--devices--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Halo.Keyring}-${node.id}`,
+                        data: Devtools.Halo.Keyring,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['keyring label', { ns: meta.id }],
+                          icon: 'ph--key--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Halo.Credentials}-${node.id}`,
+                        data: Devtools.Halo.Credentials,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['credentials label', { ns: meta.id }],
+                          icon: 'ph--credit-card--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: `${Devtools.Echo.id}-${node.id}`,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['echo label', { ns: meta.id }],
+                      icon: 'ph--database--regular',
+                    },
+                    nodes: [
+                      {
+                        id: `${Devtools.Echo.Spaces}-${node.id}`,
+                        data: Devtools.Echo.Spaces,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['spaces label', { ns: meta.id }],
+                          icon: 'ph--graph--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Space}-${node.id}`,
+                        data: Devtools.Echo.Space,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['space label', { ns: meta.id }],
+                          icon: 'ph--planet--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Feeds}-${node.id}`,
+                        data: Devtools.Echo.Feeds,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['feeds label', { ns: meta.id }],
+                          icon: 'ph--list-bullets--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Objects}-${node.id}`,
+                        data: Devtools.Echo.Objects,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['objects label', { ns: meta.id }],
+                          icon: 'ph--cube--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Schema}-${node.id}`,
+                        data: Devtools.Echo.Schema,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['schema label', { ns: meta.id }],
+                          icon: 'ph--database--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Automerge}-${node.id}`,
+                        data: Devtools.Echo.Automerge,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['automerge label', { ns: meta.id }],
+                          icon: 'ph--gear-six--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Queues}-${node.id}`,
+                        data: Devtools.Echo.Queues,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['queues label', { ns: meta.id }],
+                          icon: 'ph--queue--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Members}-${node.id}`,
+                        data: Devtools.Echo.Members,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['members label', { ns: meta.id }],
+                          icon: 'ph--users--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Echo.Metadata}-${node.id}`,
+                        data: Devtools.Echo.Metadata,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['metadata label', { ns: meta.id }],
+                          icon: 'ph--hard-drive--regular',
+                        },
+                      },
+                    ],
+                  },
+                  {
+                    id: `${Devtools.Mesh.id}-${node.id}`,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['mesh label', { ns: meta.id }],
+                      icon: 'ph--graph--regular',
+                    },
+                    nodes: [
+                      {
+                        id: `${Devtools.Mesh.Signal}-${node.id}`,
+                        data: Devtools.Mesh.Signal,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['signal label', { ns: meta.id }],
+                          icon: 'ph--wifi-high--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Mesh.Swarm}-${node.id}`,
+                        data: Devtools.Mesh.Swarm,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['swarm label', { ns: meta.id }],
+                          icon: 'ph--users-three--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Mesh.Network}-${node.id}`,
+                        data: Devtools.Mesh.Network,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['network label', { ns: meta.id }],
+                          icon: 'ph--polygon--regular',
+                        },
+                      },
+                    ],
+                  },
+                  // TODO(wittjosiah): Remove?
+                  // {
+                  //   id: `${prefix}-${Devtools.Agent.id}`,
+                  //   data: null,
+                  //   type: DEVTOOLS_TYPE,
+                  //   properties: {
+                  //     label: ['agent label', { ns: meta.id }],
+                  //     icon: 'ph--robot--regular',
+                  //   },
+                  //   nodes: [
+                  //     {
+                  //       id: `${prefix}-${Devtools.Agent.Dashboard}`,
+                  //       data: Devtools.Agent.Dashboard,
+                  //       type: DEVTOOLS_TYPE,
+                  //       properties: {
+                  //         label: ['dashboard label', { ns: meta.id }],
+                  //         icon: 'ph--computer-tower--regular',
+                  //       },
+                  //     },
+                  //   ],
+                  // },
+                  {
+                    id: `${Devtools.Edge.id}-${node.id}`,
+                    data: null,
+                    type: DEVTOOLS_TYPE,
+                    properties: {
+                      label: ['edge label', { ns: meta.id }],
+                      icon: 'ph--cloud--regular',
+                    },
+                    nodes: [
+                      {
+                        id: `${Devtools.Edge.Dashboard}-${node.id}`,
+                        data: Devtools.Edge.Dashboard,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['dashboard label', { ns: meta.id }],
+                          icon: 'ph--computer-tower--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Edge.Workflows}-${node.id}`,
+                        data: Devtools.Edge.Workflows,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['workflows label', { ns: meta.id }],
+                          icon: 'ph--function--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Edge.Traces}-${node.id}`,
+                        data: Devtools.Edge.Traces,
+                        type: DEVTOOLS_TYPE,
+                        properties: {
+                          label: ['traces label', { ns: meta.id }],
+                          icon: 'ph--line-segments--regular',
+                        },
+                      },
+                      {
+                        id: `${Devtools.Edge.Testing}-${node.id}`,
+                        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: (node) =>
+          Effect.succeed([
+            {
+              id: [node.id, 'debug'].join(ATTENDABLE_PATH_SEPARATOR),
+              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: (node) =>
+          Effect.succeed([
+            {
+              id: [node.id, 'devtools'].join(ATTENDABLE_PATH_SEPARATOR),
+              type: DECK_COMPANION_TYPE,
+              data: null,
+              properties: {
+                label: ['devtools overview label', { ns: meta.id }],
+                icon: 'ph--equalizer--regular',
+                disposition: 'hidden',
+                position: 'fallback',
+              },
+            },
+          ]),
+      }),
+    ]);
+
+    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'));