@dxos/plugin-debug 0.8.4-main.3fbcb4aa9b → 0.8.4-main.43cb759274

package/src/components/SpaceGenerator/presets.ts

@@ -7,8 +7,9 @@ import * as Schema from 'effect/Schema';
 import { AgentPrompt, WebSearchBlueprint } from '@dxos/assistant-toolkit';
 import { Routine, Trigger, Operation } from '@dxos/compute';
 import { type ComputeGraphModel, NODE_INPUT } from '@dxos/conductor';
-import { DXN, Feed, Filter, JsonSchema, Key, Obj, Query, type QueryAST, Ref, Tag } from '@dxos/echo';
+import { Feed, Filter, JsonSchema, Key, Obj, Query, type QueryAST, Ref, Scope, Tag } from '@dxos/echo';
 import { invariant } from '@dxos/invariant';
+import { EID } from '@dxos/keys';
 import { InboxOperation } from '@dxos/plugin-inbox';
 import { Mailbox } from '@dxos/plugin-inbox';
 import { Markdown } from '@dxos/plugin-markdown';
@@ -71,9 +72,9 @@ export const generator = () => ({
           );
 
           const tag = space.db.add(Tag.make({ label: 'Investor' }));
-          const tagDxn = Obj.getDXN(tag).toString();
+          const tagRef = Ref.make(tag);
           Obj.update(doc, (doc) => {
-            Obj.getMeta(doc).tags = [tagDxn];
+            Obj.getMeta(doc).tags = [tagRef];
           });
 
           // space.db.add(
@@ -85,7 +86,7 @@ export const generator = () => ({
           // );
 
           space.db.add(
-            Obj.make(Person.Person, { [Obj.Meta]: { tags: [tagDxn] }, fullName: 'Rich', organization: Ref.make(org) }),
+            Obj.make(Person.Person, { [Obj.Meta]: { tags: [tagRef] }, fullName: 'Rich', organization: Ref.make(org) }),
           );
           space.db.add(
             Obj.make(Person.Person, {
@@ -120,15 +121,15 @@ export const generator = () => ({
         invariant(mailbox, 'Mailbox not found');
         const mailboxFeed = await mailbox.feed?.tryLoad();
         invariant(mailboxFeed, 'Mailbox missing feed reference');
-        const queueDxn = Feed.getQueueDxn(mailboxFeed)?.toString();
+        const queueDxn = Feed.getQueueUri(mailboxFeed);
         invariant(queueDxn, 'Mailbox feed missing queue DXN key');
         const tag = await space.db.query(Filter.type(Tag.Tag, { label: 'Investor' })).first();
-        const tagDxn = Obj.getDXN(tag).toString();
+        const tagUri = Obj.getURI(tag);
 
         const objects = range(n, () => {
-          const contactsQuery = Query.select(Filter.type(Person.Person)).select(Filter.tag(tagDxn));
-          const organizationsQuery = Query.select(Filter.type(Organization.Organization)).select(Filter.tag(tagDxn));
-          const notesQuery = Query.select(Filter.type(Markdown.Document)).select(Filter.tag(tagDxn));
+          const contactsQuery = Query.select(Filter.type(Person.Person)).select(Filter.tag(tagUri));
+          const organizationsQuery = Query.select(Filter.type(Organization.Organization)).select(Filter.tag(tagUri));
+          const notesQuery = Query.select(Filter.type(Markdown.Document)).select(Filter.tag(tagUri));
 
           space.db.add(
             Trigger.make({
@@ -178,9 +179,7 @@ export const generator = () => ({
               Filter.type(Message.Message, {
                 properties: { labels: Filter.contains('investor') },
               }),
-            ).from({
-              queues: [queueDxn],
-            }),
+            ).from(Scope.feed(Obj.getURI(mailboxFeed))),
             jsonSchema: JsonSchema.toJsonSchema(Message.Message),
           });
           const contactsView = ViewModel.make({
@@ -587,7 +586,7 @@ export const generator = () => ({
             );
             const queueId = canvasModel.createNode(
               createConstant({
-                value: new DXN(DXN.kind.QUEUE, ['data', space.id, Key.ObjectId.random()]).toString(),
+                value: EID.make({ spaceId: space.id, entityId: Key.EntityId.random() }),
                 ...position({ x: -10, y: 5 }),
               }),
             );
@@ -774,7 +773,7 @@ const setupQueue = (
 ) => {
   const queueId = canvasModel.createNode(
     createConstant({
-      value: new DXN(DXN.kind.QUEUE, ['data', space.id, Key.ObjectId.random()]).toString(),
+      value: EID.make({ spaceId: space.id, entityId: Key.EntityId.random() }),
       ...(args?.idPosition ? rawPosition(args.idPosition) : position({ x: -18, y: 5, width: 8, height: 6 })),
     }),
   );

package/src/containers/DebugObjectPanel/DebugObjectPanel.tsx

@@ -7,7 +7,7 @@ import React, { useMemo, useState } from 'react';
 import { AppSurface } from '@dxos/app-toolkit/ui';
 import { ObjectsTree } from '@dxos/devtools';
 import { Filter, Json, Obj, Query } from '@dxos/echo';
-import type { ObjectId } from '@dxos/keys';
+import type { EntityId } from '@dxos/keys';
 import { useQuery } from '@dxos/react-client/echo';
 import { Clipboard, Input, Panel, ScrollArea, Toolbar } from '@dxos/react-ui';
 import { Syntax } from '@dxos/react-ui-syntax-highlighter';
@@ -20,7 +20,7 @@ export type DebugObjectPanelProps = Pick<
 
 export const DebugObjectPanel = ({ role, companionTo }: DebugObjectPanelProps) => {
   const db = Obj.getDatabase(companionTo);
-  const [selectedId, setSelectedId] = useState<ObjectId | null>(null);
+  const [selectedId, setSelectedId] = useState<EntityId | null>(null);
   const [depth, setDepth] = useState(0);
   const [selectedObject] = useQuery(
     db,

package/src/containers/DebugSpaceObjectsPanel/DebugSpaceObjectsPanel.tsx

@@ -7,7 +7,7 @@ import React, { useState } from 'react';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { ObjectsTree } from '@dxos/devtools';
 import { Filter, Query } from '@dxos/echo';
-import { type ObjectId } from '@dxos/keys';
+import { type EntityId } from '@dxos/keys';
 import { useQuery } from '@dxos/react-client/echo';
 import { Clipboard, Grid, Input, Panel, ScrollArea, Toolbar } from '@dxos/react-ui';
 import { JsonHighlighter } from '@dxos/react-ui-syntax-highlighter';
@@ -15,7 +15,7 @@ import { JsonHighlighter } from '@dxos/react-ui-syntax-highlighter';
 export type DebugSpaceObjectsPanelProps = AppSurface.SpaceArticleProps;
 
 export const DebugSpaceObjectsPanel = ({ space }: DebugSpaceObjectsPanelProps) => {
-  const [selectedId, setSelectedId] = useState<ObjectId | null>(null);
+  const [selectedId, setSelectedId] = useState<EntityId | null>(null);
   const [selectedObject] = useQuery(
     space.db,
     selectedId ? Query.select(Filter.id(selectedId)) : Query.select(Filter.nothing()),

package/src/containers/DebugStatus/DebugStatus.tsx

@@ -90,6 +90,7 @@ const ErrorIndicator = () => {
     return (
       <StatusBar.Item>
         <IconButton
+          variant='ghost'
           icon='ph--warning-circle--duotone'
           iconOnly
           label={errorRef.current.message}

package/src/containers/GithubPanel/GithubComponent.stories.tsx

@@ -0,0 +1,38 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { translations } from '#translations';
+
+import { GithubComponent } from './GithubComponent';
+
+const DefaultStory = () => (
+  <GithubComponent.Root>
+    <div className='grid grid-rows-[auto_minmax(0,1fr)_auto] overflow-hidden h-full is-full'>
+      <GithubComponent.Header />
+      <GithubComponent.Content />
+      <GithubComponent.StatusBar />
+    </div>
+  </GithubComponent.Root>
+);
+
+const meta = {
+  title: 'plugins/plugin-debug/containers/GithubComponent',
+  component: DefaultStory,
+  decorators: [withTheme(), withLayout({ layout: 'column', classNames: 'w-(--dx-r1-size)' })],
+  parameters: {
+    layout: 'fullscreen',
+    translations,
+  },
+} satisfies Meta<typeof DefaultStory>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

package/src/containers/GithubPanel/GithubComponent.tsx

@@ -0,0 +1,192 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { type ReactNode, createContext, useContext, useEffect, useState } from 'react';
+
+import { IconButton, ScrollArea, useTranslation } from '@dxos/react-ui';
+
+import { meta } from '#meta';
+
+const DEFAULT_REPO = 'dxos/dxos';
+const DEFAULT_LIMIT = 20;
+
+type GithubUser = {
+  login: string;
+  avatar_url: string;
+  html_url: string;
+};
+
+type GithubPullRequest = {
+  number: number;
+  title: string;
+  html_url: string;
+  merged_at: string | null;
+  user: GithubUser;
+};
+
+type ComponentContextValue = {
+  repo: string;
+  pulls: GithubPullRequest[];
+  unavailable: boolean;
+};
+
+const ComponentContext = createContext<ComponentContextValue | null>(null);
+
+const useComponentContext = () => {
+  const ctx = useContext(ComponentContext);
+  if (!ctx) {
+    throw new Error('GithubComponent.* parts must be rendered inside GithubComponent.Root.');
+  }
+  return ctx;
+};
+
+export type GithubComponentRootProps = {
+  /** `<owner>/<name>`. Defaults to `dxos/dxos`. */
+  repo?: string;
+  /** Maximum number of merged PRs to fetch. */
+  limit?: number;
+  children?: ReactNode;
+};
+
+const Root = ({ repo = DEFAULT_REPO, limit = DEFAULT_LIMIT, children }: GithubComponentRootProps) => {
+  const [pulls, setPulls] = useState<GithubPullRequest[]>([]);
+  const [unavailable, setUnavailable] = useState(false);
+
+  useEffect(() => {
+    const controller = new AbortController();
+    setPulls([]);
+    setUnavailable(false);
+    void (async () => {
+      try {
+        const url = new URL(`https://api.github.com/repos/${repo}/pulls`);
+        url.searchParams.set('state', 'closed');
+        url.searchParams.set('sort', 'updated');
+        url.searchParams.set('direction', 'desc');
+        url.searchParams.set('per_page', String(limit * 2));
+        const response = await fetch(url.toString(), {
+          signal: controller.signal,
+          headers: { Accept: 'application/vnd.github+json' },
+        });
+        if (!response.ok) {
+          setUnavailable(true);
+          return;
+        }
+        const items = (await response.json()) as GithubPullRequest[];
+        setPulls(items.filter((pull) => pull.merged_at !== null).slice(0, limit));
+        setUnavailable(false);
+      } catch {
+        if (controller.signal.aborted) {
+          return;
+        }
+        setPulls([]);
+        setUnavailable(true);
+      }
+    })();
+    return () => controller.abort();
+  }, [repo, limit]);
+
+  return <ComponentContext.Provider value={{ repo, pulls, unavailable }}>{children}</ComponentContext.Provider>;
+};
+
+const Header = () => {
+  const { t } = useTranslation(meta.id);
+  const { repo, pulls, unavailable } = useComponentContext();
+  return (
+    <header className='flex items-center justify-between gap-1 px-4 py-3 bg-modal-surface border-b border-subdued-separator'>
+      <a
+        href={`https://github.com/${repo}`}
+        target='_blank'
+        rel='noopener noreferrer'
+        className='text-sm font-medium truncate'
+      >
+        @{repo}
+      </a>
+      <div className='text-xs text-description'>
+        {unavailable
+          ? t('github-unavailable.message')
+          : pulls.length > 0
+            ? t('recent-prs.label', { count: pulls.length })
+            : t('github-loading.message')}
+      </div>
+    </header>
+  );
+};
+
+const RELATIVE_UNITS: Array<[Intl.RelativeTimeFormatUnit, number]> = [
+  ['year', 60 * 60 * 24 * 365],
+  ['month', 60 * 60 * 24 * 30],
+  ['week', 60 * 60 * 24 * 7],
+  ['day', 60 * 60 * 24],
+  ['hour', 60 * 60],
+  ['minute', 60],
+];
+
+const formatRelative = (iso: string): string => {
+  const formatter = new Intl.RelativeTimeFormat(undefined, { numeric: 'auto' });
+  const diffSeconds = (Date.parse(iso) - Date.now()) / 1000;
+  const absDiff = Math.abs(diffSeconds);
+  for (const [unit, secondsInUnit] of RELATIVE_UNITS) {
+    if (absDiff >= secondsInUnit) {
+      return formatter.format(Math.round(diffSeconds / secondsInUnit), unit);
+    }
+  }
+  return formatter.format(Math.round(diffSeconds), 'second');
+};
+
+const PullRow = ({ pull }: { pull: GithubPullRequest }) => (
+  <li>
+    <a
+      href={pull.html_url}
+      target='_blank'
+      rel='noopener noreferrer'
+      className='flex items-start gap-2 px-2 py-1 rounded-sm hover:bg-hover-surface'
+    >
+      <img src={pull.user.avatar_url} alt='' className='w-6 h-6 rounded-full shrink-0 mt-0.5' />
+      <div className='flex flex-col min-w-0 flex-1'>
+        <span className='text-sm truncate'>{pull.title}</span>
+        <span className='text-xs text-description truncate'>
+          #{pull.number} · {pull.user.login} · {pull.merged_at ? formatRelative(pull.merged_at) : ''}
+        </span>
+      </div>
+    </a>
+  </li>
+);
+
+const Content = () => {
+  const { pulls } = useComponentContext();
+  return (
+    <ScrollArea.Root orientation='vertical'>
+      <ScrollArea.Viewport>
+        <ul className='flex flex-col p-1'>
+          {pulls.map((pull) => (
+            <PullRow key={pull.number} pull={pull} />
+          ))}
+        </ul>
+      </ScrollArea.Viewport>
+    </ScrollArea.Root>
+  );
+};
+
+const StatusBar = () => {
+  const { t } = useTranslation(meta.id);
+  const { repo } = useComponentContext();
+  return (
+    <IconButton
+      icon='ph--github-logo--regular'
+      label={t('view-on-github.button')}
+      variant='primary'
+      classNames='w-full'
+      onClick={() => {
+        window.open(`https://github.com/${repo}`, '_blank', 'noopener,noreferrer');
+      }}
+    />
+  );
+};
+
+export const GithubComponent = {
+  Root,
+  Header,
+  Content,
+  StatusBar,
+};

package/src/containers/GithubPanel/GithubPanel.tsx

@@ -0,0 +1,17 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React from 'react';
+
+import { GithubComponent } from './GithubComponent';
+
+export const GithubPanel = () => (
+  <GithubComponent.Root>
+    <div className='h-full grid grid-rows-[auto_minmax(0,1fr)_auto] overflow-hidden h-full is-full'>
+      <GithubComponent.Header />
+      <GithubComponent.Content />
+      <GithubComponent.StatusBar />
+    </div>
+  </GithubComponent.Root>
+);

package/src/containers/GithubPanel/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { GithubPanel as default } from './GithubPanel';

package/src/containers/RegistryPanel/RegistryPanel.tsx

@@ -0,0 +1,150 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useCallback, useEffect, useMemo, useState } from 'react';
+
+import { Operation } from '@dxos/compute';
+import { JsonView, PanelContainer, Placeholder, Searchbar } from '@dxos/devtools';
+import { Entity, Format, Obj, Type } from '@dxos/echo';
+import { useClient } from '@dxos/react-client';
+import { Toolbar } from '@dxos/react-ui';
+import { DynamicTable, type TableFeatures } from '@dxos/react-ui-table';
+import { mx } from '@dxos/ui-theme';
+
+type RegistryRow = {
+  id: string;
+  kind: string;
+  label: string;
+  _entity: Entity.Unknown;
+};
+
+const textFilter = (text?: string) => {
+  if (!text) {
+    return () => true;
+  }
+
+  const matcher = new RegExp(text, 'i');
+  return (entity: Entity.Unknown) => {
+    const typename = Entity.getTypename(entity) ?? '';
+    const metaKey = Obj.isObject(entity) ? (Obj.getMeta(entity).key ?? '') : '';
+    const uri = Type.isType(entity) ? (Type.getURI(entity)?.toString() ?? '') : '';
+    const operationKey =
+      Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)
+        ? (Operation.getKey(entity) ?? '')
+        : '';
+    const name = Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity) ? entity.name : '';
+    return [typename, metaKey, uri, operationKey, name, getEntityId(entity)].some((value) => value.match(matcher));
+  };
+};
+
+const getEntityId = (entity: Entity.Unknown): string => {
+  if (entity.id) {
+    return entity.id;
+  }
+  if (Type.isType(entity)) {
+    return Type.getURI(entity)?.toString() ?? Type.getTypename(entity) ?? 'unknown-type';
+  }
+  return Entity.getTypename(entity) ?? 'unknown';
+};
+
+const getKind = (entity: Entity.Unknown): string => {
+  if (Type.isType(entity)) {
+    return 'type';
+  }
+  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {
+    return 'operation';
+  }
+  return 'other';
+};
+
+const getLabel = (entity: Entity.Unknown): string => {
+  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {
+    return entity.name || Operation.getKey(entity) || getEntityId(entity);
+  }
+  if (Type.isType(entity)) {
+    return Type.getTypename(entity) ?? getEntityId(entity);
+  }
+  return getEntityId(entity);
+};
+
+const toDetailJson = (entity: Entity.Unknown): object => {
+  if (Type.isType(entity)) {
+    return {
+      id: getEntityId(entity),
+      typename: Type.getTypename(entity),
+      uri: Type.getURI(entity)?.toString(),
+      version: Type.getVersion(entity),
+      jsonSchema: entity.jsonSchema,
+    };
+  }
+  if (Obj.isObject(entity)) {
+    return Obj.toJSON(entity);
+  }
+  return { id: getEntityId(entity), typename: Entity.getTypename(entity) };
+};
+
+export const RegistryPanel = () => {
+  const client = useClient();
+  const [entities, setEntities] = useState<Entity.Unknown[]>([]);
+  const [filter, setFilter] = useState('');
+  const [selected, setSelected] = useState<Entity.Unknown>();
+
+  useEffect(() => {
+    const registry = client.graph.registry;
+    const refresh = () => setEntities([...registry.list()]);
+    refresh();
+    return registry.changed.on(refresh);
+  }, [client]);
+
+  const properties = useMemo(
+    () => [
+      { name: 'kind', format: Format.TypeFormat.String, size: 100 },
+      { name: 'label', format: Format.TypeFormat.String },
+      { name: 'id', format: Format.TypeFormat.String, size: 280 },
+    ],
+    [],
+  );
+
+  const rows = useMemo((): RegistryRow[] => {
+    return entities
+      .filter(textFilter(filter))
+      .map((entity) => ({
+        id: getEntityId(entity),
+        kind: getKind(entity),
+        label: getLabel(entity),
+        _entity: entity,
+      }))
+      .toSorted((left, right) => left.label.localeCompare(right.label));
+  }, [entities, filter]);
+
+  const handleRowClicked = useCallback((row: RegistryRow | undefined) => {
+    if (!row?._entity) {
+      return;
+    }
+    setSelected(row._entity);
+  }, []);
+
+  const detailJson = useMemo(() => (selected ? toDetailJson(selected) : undefined), [selected]);
+
+  const features: Partial<TableFeatures> = useMemo(() => ({ selection: { enabled: true, mode: 'single' } }), []);
+
+  return (
+    <PanelContainer
+      toolbar={
+        <Toolbar.Root>
+          <Searchbar placeholder='Filter...' onChange={setFilter} />
+        </Toolbar.Root>
+      }
+    >
+      <div className={mx('h-full grid grid-cols-[2fr_1fr] overflow-hidden')}>
+        <div className={mx('flex flex-col min-h-0 overflow-hidden')}>
+          <DynamicTable properties={properties} rows={rows} features={features} onRowClick={handleRowClicked} />
+        </div>
+        <div className={mx('min-h-0 h-full overflow-auto border-s border-separator text-sm')}>
+          {detailJson ? <JsonView data={detailJson} /> : <Placeholder label='Details' />}
+        </div>
+      </div>
+    </PanelContainer>
+  );
+};

package/src/containers/RegistryPanel/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { RegistryPanel as default, RegistryPanel } from './RegistryPanel';

package/src/containers/SpaceGenerator/SpaceGenerator.tsx

@@ -6,15 +6,15 @@ import React, { useCallback, useMemo, useState } from 'react';
 
 import { useOperationInvoker } from '@dxos/app-framework/ui';
 import { ComputeGraph } from '@dxos/conductor';
-import { Filter, Obj, type Type } from '@dxos/echo';
+import { Filter, Obj, Type } from '@dxos/echo';
 import { Markdown } from '@dxos/plugin-markdown';
 import { Sheet } from '@dxos/plugin-sheet';
 import { Sketch } from '@dxos/plugin-sketch';
 import { useClient } from '@dxos/react-client';
 import { type Space } from '@dxos/react-client/echo';
 import { IconButton, Input, Panel, ScrollArea, Toolbar, useAsyncEffect } from '@dxos/react-ui';
+import { composable, composableProps } from '@dxos/react-ui';
 import { Organization, Person, Task } from '@dxos/types';
-import { composable, composableProps } from '@dxos/ui-theme';
 import { sortKeys } from '@dxos/util';
 
 import { type ObjectGenerator, SchemaTable, createGenerator, generator, staticGenerators } from '#components';
@@ -44,7 +44,7 @@ export const SpaceGenerator = composable<HTMLDivElement, SpaceGeneratorProps>(
     // Create type generators.
     const typeMap = useMemo(() => {
       const recordGenerators = new Map<string, ObjectGenerator<any>>(
-        recordTypes.map((type) => [type.typename, createGenerator(client, invokePromise, type)]),
+        recordTypes.map((type) => [Type.getTypename(type), createGenerator(client, invokePromise, type)]),
       );
 
       return new Map([...staticGenerators, ...presets.items, ...recordGenerators]);
@@ -52,8 +52,9 @@ export const SpaceGenerator = composable<HTMLDivElement, SpaceGeneratorProps>(
 
     // Query space to get info.
     const updateInfo = useCallback(async () => {
-      const echoSchema = await space.db.schemaRegistry.query().run();
-      const staticSchema = await space.db.graph.schemaRegistry.query().run();
+      const allSchema = [...space.db.graph.registry.list().filter(Type.isType)];
+      const echoSchema = allSchema.filter((t) => Type.isTypeKind(t));
+      const staticSchema = allSchema.filter((t) => !Type.isTypeKind(t));
 
       const objects = await space.db.query(Filter.everything()).run();
       const objectMap = sortKeys(

package/src/containers/Wireframe/Wireframe.tsx

@@ -19,7 +19,7 @@ export type WireframeProps = ThemedClassName<{
 
 // TODO(burdon): Make focusable and attendable with input.
 export const Wireframe = ({ classNames, label, object }: WireframeProps) => {
-  const attentionAttrs = useAttentionAttributes(Obj.getDXN(object).toString());
+  const attentionAttrs = useAttentionAttributes(Obj.getURI(object));
   const { width, height, ref } = useResizeDetector();
 
   return (

package/src/containers/index.ts

@@ -11,3 +11,5 @@ export const DevtoolsOverviewContainer: ComponentType<any> = lazy(() => import('
 export const SpaceGenerator: ComponentType<any> = lazy(() => import('./SpaceGenerator'));
 export const Wireframe: ComponentType<any> = lazy(() => import('./Wireframe'));
 export const DebugSpaceObjectsPanel: ComponentType<any> = lazy(() => import('./DebugSpaceObjectsPanel'));
+export const GithubPanel: ComponentType<any> = lazy(() => import('./GithubPanel'));
+export const RegistryPanel: ComponentType<any> = lazy(() => import('./RegistryPanel'));

package/src/meta.ts

@@ -2,17 +2,37 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Plugin } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { DXN } from '@dxos/keys';
 import { trim } from '@dxos/util';
 
-export const meta: Plugin.Meta = {
-  id: 'org.dxos.plugin.debug',
+export const meta = Plugin.makeMeta({
+  key: DXN.make('org.dxos.plugin.debug'),
   name: 'Debug',
+  author: 'DXOS',
+  spec: 'PLUGIN.mdl',
   description: trim`
-    Comprehensive developer toolkit for troubleshooting applications, generating test data, and exploring automation capabilities.
-    Inspect objects, monitor events, and debug plugin behavior in real-time.
+    DebugPlugin is the developer toolkit for DXOS Composer. It adds a structured Devtools node
+    to the navigation graph — grouped into Client, HALO, ECHO, Mesh, and EDGE sub-sections —
+    exposing panel views for config, storage, logs, diagnostics, identity, devices, feeds,
+    objects, schemas, automerge internals, network topology, EDGE workflows, and invocation
+    traces, all driven by the @dxos/devtools component library.
+
+    The plugin contributes a Debug companion tab to every ECHO object in the deck so developers
+    can inspect raw field values and DXNs inline, and a Space Objects companion panel that lists
+    all objects in the active space with live reactive updates.
+
+    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
+    status indicator showing when generation is running.
+
+    Additional utilities include a wireframe overlay mode that draws labelled borders around
+    every article and section surface, a log-capture and download facility backed by an
+    IdbLogStore, a ToolsExplorer connected to the DXOS MCP introspect service, and a
+    globalThis helper for manual storage-version testing.
   `,
   icon: 'ph--bug--regular',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-debug',
   screenshots: ['https://dxos.network/plugin-details-debug-dark.png'],
-};
+  tags: ['labs'],
+});