@dxos/plugin-debug 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

package/dx.config.ts

@@ -11,8 +11,9 @@ export default Config2.make({
     name: 'Debug',
     author: 'DXOS',
     description: trim`
-      DebugPlugin bundles developer debugging utilities for DXOS Composer under a Debug node in the
-      SYSTEM navigation group (a sibling of the Devtools inspector).
+      DebugPlugin bundles developer debugging utilities for DXOS Composer in a floating debug panel
+      opened from the status bar: a navtree over a hidden debug category of the app graph, with the
+      console, the log viewer, the Devtools inspector, and the tools below as its pages.
 
       Test-data generation is available via a SpaceGenerator article surface: developers can
       create configurable batches of synthetic ECHO objects into any space collection, with a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-debug",
-  "version": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
+  "version": "0.13.0",
   "description": "DXOS developer debugging utilities plugin.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -10,19 +10,21 @@
   },
   "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
-  "sideEffects": true,
+  "sideEffects": false,
   "type": "module",
   "imports": {
     "#capabilities": {
       "source": {
         "workerd": "./src/capabilities/gen/workerd.ts",
         "node": "./src/capabilities/gen/node.ts",
-        "default": "./src/capabilities/index.ts"
+        "tauri": "./src/capabilities/gen/tauri.ts",
+        "browser": "./src/capabilities/gen/browser.ts"
       },
       "types": "./dist/types/src/capabilities/index.d.ts",
       "workerd": "./dist/lib/capabilities.workerd.mjs",
       "node": "./dist/lib/capabilities.node.mjs",
-      "default": "./dist/lib/capabilities.mjs"
+      "tauri": "./dist/lib/capabilities.tauri.mjs",
+      "browser": "./dist/lib/capabilities.browser.mjs"
     },
     "#components": {
       "source": "./src/components/index.ts",
@@ -66,13 +68,6 @@
       "types": "./dist/types/src/index.d.ts",
       "import": "./dist/lib/index.mjs"
     },
-    "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
-    "./package.json": "./package.json",
-    "./translations": {
-      "source": "./src/translations.ts",
-      "types": "./dist/types/src/translations.d.ts",
-      "import": "./dist/lib/translations.mjs"
-    },
     "./Debug": {
       "source": "./src/types/Debug.ts",
       "types": "./dist/types/src/types/Debug.d.ts",
@@ -103,10 +98,52 @@
       "types": "./dist/types/src/types/DebugSurface.d.ts",
       "import": "./dist/lib/DebugSurface.mjs"
     },
+    "./IncidentSpace": {
+      "source": "./src/samples/incident/IncidentSpace.ts",
+      "types": "./dist/types/src/samples/incident/IncidentSpace.d.ts",
+      "import": "./dist/lib/IncidentSpace.mjs"
+    },
+    "./PipelineSpace": {
+      "source": "./src/samples/crm/PipelineSpace.ts",
+      "types": "./dist/types/src/samples/crm/PipelineSpace.d.ts",
+      "import": "./dist/lib/PipelineSpace.mjs"
+    },
+    "./ReviewSpace": {
+      "source": "./src/samples/review/ReviewSpace.ts",
+      "types": "./dist/types/src/samples/review/ReviewSpace.d.ts",
+      "import": "./dist/lib/ReviewSpace.mjs"
+    },
     "./Settings": {
       "source": "./src/types/Settings.ts",
       "types": "./dist/types/src/types/Settings.d.ts",
       "import": "./dist/lib/Settings.mjs"
+    },
+    "./StockfishSpace": {
+      "source": "./src/samples/stockfish/StockfishSpace.ts",
+      "types": "./dist/types/src/samples/stockfish/StockfishSpace.d.ts",
+      "import": "./dist/lib/StockfishSpace.mjs"
+    },
+    "./TidepoolSpace": {
+      "source": "./src/samples/tidepool/TidepoolSpace.ts",
+      "types": "./dist/types/src/samples/tidepool/TidepoolSpace.d.ts",
+      "import": "./dist/lib/TidepoolSpace.mjs"
+    },
+    "./WeatherSpace": {
+      "source": "./src/samples/weather/WeatherSpace.ts",
+      "types": "./dist/types/src/samples/weather/WeatherSpace.d.ts",
+      "import": "./dist/lib/WeatherSpace.mjs"
+    },
+    "./WorkerSpace": {
+      "source": "./src/samples/worker/WorkerSpace.ts",
+      "types": "./dist/types/src/samples/worker/WorkerSpace.d.ts",
+      "import": "./dist/lib/WorkerSpace.mjs"
+    },
+    "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
+    "./package.json": "./package.json",
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "import": "./dist/lib/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -133,83 +170,102 @@
     "dist",
     "dx.config.ts",
     "src",
-    "PLUGIN.mdl"
+    "PLUGIN.mdl",
+    "scripts"
   ],
   "dependencies": {
-    "@effect/atom-react": "4.0.0-rc.108",
+    "@effect/atom-react": "4.0.0",
     "react-resize-detector": "^11.0.1",
-    "@dxos/app-graph": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/app-toolkit": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/assistant-toolkit": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/async": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/app-framework": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/compute": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/conductor": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/compute-hyperformula": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/config": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/devtools": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/echo-react": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/effect": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/echo": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/graph": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/invariant": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/link": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/log": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/keys": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/log-store-idb": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-connector": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/operation": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-google": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-illustrator": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-inbox": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-markdown": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-sheet": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-tldraw": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/protocols": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-client": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/random": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-space": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-status-bar": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-attention": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-canvas-compute": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-components": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-debug": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-form": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-canvas-editor": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-menu": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/schema": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/tracing": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-syntax-highlighter": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/ui-editor": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/util": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/types": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264"
+    "@dxos/app-framework": "0.13.0",
+    "@dxos/app-graph": "0.13.0",
+    "@dxos/app-toolkit": "0.13.0",
+    "@dxos/assistant-toolkit": "0.13.0",
+    "@dxos/async": "0.13.0",
+    "@dxos/compute": "0.13.0",
+    "@dxos/compute-hyperformula": "0.13.0",
+    "@dxos/conductor": "0.13.0",
+    "@dxos/config": "0.13.0",
+    "@dxos/devtools": "0.13.0",
+    "@dxos/echo": "0.13.0",
+    "@dxos/echo-react": "0.13.0",
+    "@dxos/effect": "0.13.0",
+    "@dxos/errors": "0.13.0",
+    "@dxos/graph": "0.13.0",
+    "@dxos/invariant": "0.13.0",
+    "@dxos/keys": "0.13.0",
+    "@dxos/link": "0.13.0",
+    "@dxos/log": "0.13.0",
+    "@dxos/log-store-idb": "0.13.0",
+    "@dxos/operation": "0.13.0",
+    "@dxos/plugin-attention": "0.13.0",
+    "@dxos/plugin-chess": "0.13.0",
+    "@dxos/plugin-client": "0.13.0",
+    "@dxos/plugin-connector": "0.13.0",
+    "@dxos/plugin-game": "0.13.0",
+    "@dxos/plugin-google": "0.13.0",
+    "@dxos/plugin-graph": "0.13.0",
+    "@dxos/plugin-illustrator": "0.13.0",
+    "@dxos/plugin-inbox": "0.13.0",
+    "@dxos/plugin-markdown": "0.13.0",
+    "@dxos/plugin-sheet": "0.13.0",
+    "@dxos/plugin-space": "0.13.0",
+    "@dxos/plugin-status-bar": "0.13.0",
+    "@dxos/plugin-tldraw": "0.13.0",
+    "@dxos/protocols": "0.13.0",
+    "@dxos/random": "0.13.0",
+    "@dxos/react-client": "0.13.0",
+    "@dxos/react-ui-attention": "0.13.0",
+    "@dxos/react-ui-canvas-compute": "0.13.0",
+    "@dxos/react-ui-canvas-editor": "0.13.0",
+    "@dxos/react-ui-components": "0.13.0",
+    "@dxos/react-ui-debug": "0.13.0",
+    "@dxos/react-ui-form": "0.13.0",
+    "@dxos/react-ui-list": "0.13.0",
+    "@dxos/react-ui-menu": "0.13.0",
+    "@dxos/react-ui-terminal": "0.13.0",
+    "@dxos/types": "0.13.0",
+    "@dxos/ui-editor": "0.13.0",
+    "@dxos/util": "0.13.0",
+    "@dxos/tracing": "0.13.0",
+    "@dxos/schema": "0.13.0",
+    "@dxos/react-ui-syntax-highlighter": "0.13.0"
   },
   "devDependencies": {
-    "@effect/atom-react": "4.0.0-rc.108",
-    "@storybook/react-vite": "^10.5.8",
+    "@effect/atom-react": "4.0.0",
+    "@effect/vitest": "4.0.0",
+    "@storybook/react-vite": "^10.6.0",
     "@types/react": "~19.2.17",
     "@types/react-dom": "~19.2.3",
-    "effect": "4.0.0-rc.108",
+    "effect": "4.0.0",
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
-    "vite": "^8.2.1",
-    "@dxos/plugin-client": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui-list": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-testing": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/plugin-progress": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/ui-theme": "0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264"
+    "vite": "^8.2.2",
+    "@dxos/agent-runtime": "0.13.0",
+    "@dxos/ai": "0.13.0",
+    "@dxos/assistant": "0.13.0",
+    "@dxos/client-protocol": "0.13.0",
+    "@dxos/plugin-inbox": "0.13.0",
+    "@dxos/plugin-progress": "0.13.0",
+    "@dxos/plugin-projects": "0.13.0",
+    "@dxos/plugin-sandbox": "0.13.0",
+    "@dxos/plugin-tasks": "0.13.0",
+    "@dxos/plugin-testing": "0.13.0",
+    "@dxos/react-ui": "0.13.0",
+    "@dxos/ui-theme": "0.13.0"
   },
   "peerDependencies": {
-    "@effect/atom-react": "4.0.0-rc.108",
-    "effect": "4.0.0-rc.108",
+    "@effect/atom-react": "4.0.0",
+    "effect": "4.0.0",
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
-    "@dxos/random": "^0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/ui-theme": "^0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264",
-    "@dxos/react-ui": "^0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264"
+    "@dxos/random": "^0.13.0",
+    "@dxos/ui-theme": "^0.13.0",
+    "@dxos/react-ui": "^0.13.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build-template": "vite-node ./scripts/build-template-archive.ts"
   }
 }

package/scripts/build-template-archive.ts

@@ -0,0 +1,65 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+/**
+ * Builds one of the space templates and writes its JSON archive to disk.
+ *
+ * Produced on demand rather than committed, so there is no fixture to keep in step with the
+ * schemas; each template's `template.test.ts` asserts its shape instead.
+ *
+ *   pnpm run build-template -- --space crm --out ./northwind.dx.json
+ *
+ *
+ * Needs Node 22+ (`node:sqlite`) — run it through moon or with proto's Node on PATH.
+ */
+
+import * as Effect from 'effect/Effect';
+import { writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { buildArchive } from '@dxos/app-toolkit/testing';
+import * as EffectEx from '@dxos/effect/EffectEx';
+
+import { PipelineSpace, TidepoolSpace } from '../src/samples/index.ts';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Only the output name is shared. Each definition has its own phase map, so the two `buildArchive`
+// calls stay in separate branches below rather than behind one value whose type would unify to one
+// of them.
+const SPACES = {
+  crm: { file: 'northwind.dx.json' },
+  projects: { file: 'tidepool.dx.json' },
+} as const;
+
+type SpaceKey = keyof typeof SPACES;
+
+const parseArgs = (argv: string[]): { space: SpaceKey; out: string } => {
+  const flag = (name: string): string | undefined => {
+    const index = argv.indexOf(`--${name}`);
+    return index >= 0 ? argv[index + 1] : undefined;
+  };
+
+  const space = (flag('space') ?? 'crm') as SpaceKey;
+  if (!(space in SPACES)) {
+    throw new Error(`--space must be one of ${Object.keys(SPACES).join(', ')}, got "${space}"`);
+  }
+
+  const out = flag('out');
+  return { space, out: out ? resolve(out) : resolve(__dirname, SPACES[space].file) };
+};
+
+const { space, out } = parseArgs(process.argv.slice(2));
+
+await EffectEx.runPromise(
+  Effect.gen(function* () {
+    yield* Effect.log(`building ${space}…`);
+    const { json, objectCount } =
+      space === 'crm' ? yield* buildArchive(PipelineSpace.make()) : yield* buildArchive(TidepoolSpace.make());
+
+    yield* Effect.promise(() => writeFile(out, json + '\n', 'utf8'));
+    yield* Effect.log(`wrote ${out} (${json.length} bytes, ${objectCount} objects)`);
+  }),
+);

package/src/DebugPlugin.ts

@@ -14,4 +14,4 @@ export const meta = pluginMeta;
 /** Constructs the plugin; the body loads on first enable. */
 export const make = Plugin.lazy(meta, () => import('#plugin'));
 
-export type { DebugPluginOptions } from './types/Debug';
+export type { DebugPluginOptions as Options } from './types/Debug.ts';

package/src/capabilities/DebugSurfaces.tsx

@@ -8,64 +8,34 @@ import { useAtomValue } from '@effect/atom-react/Hooks';
 import * as Option from 'effect/Option';
 import React, { useCallback, useMemo } from 'react';
 
-import { useAtomCapability, useOperationInvoker, useSettingsState } from '@dxos/app-framework/ui';
+import * as Hooks from '@dxos/app-framework/Hooks';
 import * as AppAnnotation from '@dxos/app-toolkit/AppAnnotation';
 import type * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';
 import * as GraphPath from '@dxos/app-toolkit/GraphPath';
+import * as ToolkitHooks from '@dxos/app-toolkit/Hooks';
 import * as LayoutOperation from '@dxos/app-toolkit/LayoutOperation';
-import { useActiveSpace } from '@dxos/app-toolkit/ui';
+import * as SettingsScope from '@dxos/app-toolkit/SettingsScope';
+import * as TypeOptions from '@dxos/app-toolkit/TypeOptions';
 import { Annotation, Collection, Entity, Filter, Obj, Type } from '@dxos/echo';
-import { HiddenAnnotation } from '@dxos/echo/Annotation';
 import { type IdbLogStore } from '@dxos/log-store-idb';
 import * as SpaceCapabilities from '@dxos/plugin-space/SpaceCapabilities';
 import * as SpaceOperation from '@dxos/plugin-space/SpaceOperation';
 import { useClient } from '@dxos/react-client';
-import { type Space, SpaceState } from '@dxos/react-client/echo';
-import { Panel } from '@dxos/react-ui';
-import { Logger } from '@dxos/react-ui-debug';
+import { SpaceState } from '@dxos/react-client/echo';
 
-import { DebugObjectPanel, DebugSettings, DebugSpaceObjectsPanel, SpaceGenerator } from '#containers';
+import { DebugConsole, DebugObjectPanel, DebugSettings, DebugSpaceObjectsPanel, SpaceGenerator } from '#containers';
 import { Settings } from '#types';
 
-/** Returns `onOpen` and `canOpen` for the ObjectsTree "Open" action. */
-const useObjectOpenAction = (invokePromise: ReturnType<typeof useOperationInvoker>['invokePromise']) => {
-  const client = useClient();
-  const spaceSettings = useAtomCapability(SpaceCapabilities.SettingsAtom);
-  const showHidden = spaceSettings?.showHidden ?? false;
-
-  const allTypes = useAtomValue(useMemo(() => client.graph.registry.query(Filter.type(Type.Type)).atom, [client]));
-
-  const hiddenTypenames = useMemo(() => {
-    const result = new Set<string>();
-    for (const typeEntity of allTypes) {
-      const schema = Type.getSchema(typeEntity);
-      if (HiddenAnnotation.get(schema).pipe(Option.getOrElse(() => false))) {
-        result.add(Type.getTypename(typeEntity));
-      }
-    }
-    return result;
-  }, [allTypes]);
-
-  const onOpen = useCallback(
-    (object: Obj.Unknown) => {
-      void invokePromise(LayoutOperation.Open, { subject: [GraphPath.getObjectPathFromObject(object)] });
-    },
-    [invokePromise],
-  );
+//
+// DebugConsoleArticle
+//
 
-  const canOpen = useCallback(
-    (entity: Entity.Snapshot) => {
-      if (showHidden) {
-        return true;
-      }
-      const typename = Entity.getTypename(entity);
-      return !hiddenTypenames.has(typename ?? '');
-    },
-    [showHidden, hiddenTypenames],
-  );
+/** `react-surface.ts` is a plain `.ts` file, so the JSX for the console page's article surface lives here. */
+export const DebugConsoleArticle = () => <DebugConsole fit />;
 
-  return { onOpen, canOpen };
-};
+//
+// DebugSettings
+//
 
 export type DebugSettingsSurfaceProps = {
   subject: AppCapabilities.Settings;
@@ -74,25 +44,36 @@ export type DebugSettingsSurfaceProps = {
 };
 
 export const DebugSettingsSurface = ({ subject, logStore, onUpload }: DebugSettingsSurfaceProps) => {
-  const { settings, updateSettings } = useSettingsState<Settings.Settings>(subject.atom);
+  const { settings, updateSettings } = Hooks.useSettingsState<Settings.Settings>(subject.atom);
 
   return (
-    <DebugSettings settings={settings} onSettingsChange={updateSettings} logStore={logStore} onUpload={onUpload} />
+    <DebugSettings
+      settings={settings}
+      onSettingsChange={updateSettings}
+      logStore={logStore}
+      onUpload={onUpload}
+      scope={<SettingsScope.Root prefix={subject.prefix} />}
+    />
   );
 };
 
+//
+// SpaceGeneratorSurface
+//
+
 export type SpaceGeneratorSurfaceProps = {
   role: string;
-  space: Space;
 };
 
-/** Generated objects are added to the space's root collection, resolved at invocation time. */
-export const SpaceGeneratorSurface = ({ role, space }: SpaceGeneratorSurfaceProps) => {
-  const { invokePromise } = useOperationInvoker();
+/** Generated objects are added to the active space's root collection, resolved at invocation time. */
+export const SpaceGeneratorSurface = ({ role }: SpaceGeneratorSurfaceProps) => {
+  const space = ToolkitHooks.useActiveSpace();
+  const { invokePromise } = Hooks.useOperationInvoker();
+
   const handleCreateObjects = useCallback(
     (objects: Obj.Unknown[]) => {
       const collection =
-        space.state.get() === SpaceState.SPACE_READY &&
+        space?.state.get() === SpaceState.SPACE_READY &&
         Annotation.get(space.properties, AppAnnotation.RootCollectionAnnotation).pipe(Option.getOrUndefined)?.target;
       if (!Obj.instanceOf(Collection.Collection, collection)) {
         return;
@@ -105,24 +86,36 @@ export const SpaceGeneratorSurface = ({ role, space }: SpaceGeneratorSurfaceProp
     [space, invokePromise],
   );
 
+  if (!space) {
+    return null;
+  }
+
   return <SpaceGenerator role={role} space={space} onCreateObjects={handleCreateObjects} />;
 };
 
+//
+// ObjectDebugSurface
+//
+
 export type ObjectDebugSurfaceProps = {
   role: string;
   companionTo: Obj.Unknown;
 };
 
 export const ObjectDebugSurface = ({ role, companionTo }: ObjectDebugSurfaceProps) => {
-  const { invokePromise } = useOperationInvoker();
+  const { invokePromise } = Hooks.useOperationInvoker();
   const { onOpen, canOpen } = useObjectOpenAction(invokePromise);
 
   return <DebugObjectPanel role={role} companionTo={companionTo} onOpen={onOpen} canOpen={canOpen} />;
 };
 
+//
+// SpaceObjectsSurface
+//
+
 export const SpaceObjectsSurface = () => {
-  const space = useActiveSpace();
-  const { invokePromise } = useOperationInvoker();
+  const space = ToolkitHooks.useActiveSpace();
+  const { invokePromise } = Hooks.useOperationInvoker();
   const { onOpen, canOpen } = useObjectOpenAction(invokePromise);
   if (!space) {
     return null;
@@ -131,20 +124,41 @@ export const SpaceObjectsSurface = () => {
   return <DebugSpaceObjectsPanel space={space} onOpen={onOpen} canOpen={canOpen} />;
 };
 
-export const LoggerSurface = () => (
-  <Logger.Root>
-    <Panel.Root>
-      <Panel.Toolbar asChild>
-        <Logger.Toolbar />
-      </Panel.Toolbar>
-      <Panel.Content asChild>
-        <Logger.Content>
-          <Logger.List />
-        </Logger.Content>
-      </Panel.Content>
-      <Panel.Statusbar asChild>
-        <Logger.Filter />
-      </Panel.Statusbar>
-    </Panel.Root>
-  </Logger.Root>
-);
+/** Returns `onOpen` and `canOpen` for the ObjectsTree "Open" action. */
+const useObjectOpenAction = (invokePromise: ReturnType<typeof Hooks.useOperationInvoker>['invokePromise']) => {
+  const client = useClient();
+  const spaceSettings = Hooks.useAtomCapability(SpaceCapabilities.SettingsAtom);
+  const showHidden = spaceSettings?.showHidden ?? false;
+
+  const allTypes = useAtomValue(useMemo(() => client.graph.registry.query(Filter.type(Type.Type)).atom, [client]));
+
+  const hiddenTypenames = useMemo(() => {
+    const result = new Set<string>();
+    for (const typeEntity of allTypes) {
+      if (!TypeOptions.isUserType(typeEntity)) {
+        result.add(Type.getTypename(typeEntity));
+      }
+    }
+    return result;
+  }, [allTypes]);
+
+  const onOpen = useCallback(
+    (object: Obj.Unknown) => {
+      void invokePromise(LayoutOperation.Open, { subject: [GraphPath.getObjectPathFromObject(object)] });
+    },
+    [invokePromise],
+  );
+
+  const canOpen = useCallback(
+    (entity: Entity.Snapshot) => {
+      if (showHidden) {
+        return true;
+      }
+      const typename = Entity.getTypename(entity);
+      return !hiddenTypenames.has(typename ?? '');
+    },
+    [showHidden, hiddenTypenames],
+  );
+
+  return { onOpen, canOpen };
+};

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

@@ -0,0 +1,45 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Option from 'effect/Option';
+import { describe, test } from 'vitest';
+
+import * as AppGraph from '@dxos/app-graph/AppGraph';
+import * as AppGraphNode from '@dxos/app-graph/AppGraphNode';
+import { setupGraphBuilder } from '@dxos/app-graph/testing';
+import * as EffectEx from '@dxos/effect/EffectEx';
+import * as GraphNode from '@dxos/graph/GraphNode';
+
+import { DebugNodes } from '#types';
+
+import { createDebugExtension, createDebugRootExtension } from './app-graph-builder.ts';
+
+describe('debug graph extensions', () => {
+  const setup = async () => {
+    const rootExtensions = await EffectEx.runPromise(createDebugRootExtension());
+    const debugExtensions = await EffectEx.runPromise(createDebugExtension());
+    const context = setupGraphBuilder({ extensions: [...rootExtensions, ...debugExtensions] });
+    await context.expand(GraphNode.RootId);
+    await context.expand(DebugNodes.DEBUG_ROOT_ID);
+    await context.expand(DebugNodes.DEBUG_NODE_ID);
+    return context;
+  };
+
+  test('root/debug is a hidden root child', async ({ expect }) => {
+    const { graph } = await setup();
+    const node = Option.getOrThrow(AppGraph.getNode(graph, DebugNodes.DEBUG_ROOT_ID));
+    expect(AppGraphNode.hasDisposition(node, 'hidden')).toBe(true);
+    expect(node.data).toBeNull();
+  });
+
+  test('the Debug node hosts console, logs, then the generator', async ({ expect }) => {
+    const { getConnections } = await setup();
+    expect(getConnections(DebugNodes.DEBUG_ROOT_ID).map((node) => node.id)).toEqual([DebugNodes.DEBUG_NODE_ID]);
+    expect(getConnections(DebugNodes.DEBUG_NODE_ID).map((node) => node.id)).toEqual([
+      DebugNodes.CONSOLE_NODE_ID,
+      `${DebugNodes.DEBUG_NODE_ID}/${DebugNodes.nodeId(DebugNodes.Logs)}`,
+      `${DebugNodes.DEBUG_NODE_ID}/${DebugNodes.nodeId(DebugNodes.SpaceType)}`,
+    ]);
+  });
+});