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

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

@@ -1,421 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Capability } from '@dxos/app-framework';
-import { AppCapabilities } from '@dxos/app-toolkit';
-import { Obj } from '@dxos/echo';
-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(AppCapabilities.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(AppCapabilities.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: (object) =>
-          Effect.succeed([
-            {
-              id: [Obj.getDXN(object).toString(), '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(AppCapabilities.AppGraphBuilder, extensions);
-  }),
-);

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

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));

package/src/capabilities/react-context/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const ReactContext = Capability.lazy('ReactContext', () => import('./react-context'));

package/src/capabilities/react-surface/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/settings/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const DebugSettings = Capability.lazy('DebugSettings', () => import('./settings'));

package/src/components/Container.tsx

@@ -1,15 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import React, { type PropsWithChildren, type ReactNode } from 'react';
-
-// TODO(burdon): Convert to grid.
-export const Container = ({ toolbar, children }: PropsWithChildren<{ toolbar: ReactNode }>) => {
-  return (
-    <div role='none' className='flex flex-col grow overflow-hidden divide-y divide-separator'>
-      {toolbar}
-      <div className='flex flex-col grow overflow-auto'>{children}</div>
-    </div>
-  );
-};

package/src/components/DebugObjectPanel.tsx

@@ -1,32 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import React from 'react';
-
-import { type Obj } from '@dxos/echo';
-import { Clipboard, Input, Layout, Toolbar } from '@dxos/react-ui';
-import { Json } from '@dxos/react-ui-syntax-highlighter';
-
-export type DebugObjectPanelProps = {
-  object: Obj.Unknown;
-};
-
-// TODO(burdon): Get schema and traverse references.
-export const DebugObjectPanel = ({ object }: DebugObjectPanelProps) => {
-  const dxn = `dxn:echo:@:${object.id}`;
-
-  return (
-    <Clipboard.Provider>
-      <Layout.Main toolbar>
-        <Toolbar.Root>
-          <Input.Root>
-            <Input.TextInput disabled value={dxn} />
-            <Clipboard.IconButton value={dxn} />
-          </Input.Root>
-        </Toolbar.Root>
-        <Json data={object} />
-      </Layout.Main>
-    </Clipboard.Provider>
-  );
-};

package/src/components/DebugSettings.tsx

@@ -1,185 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import React, { useEffect, useState } from 'react';
-
-import { useCapabilities } from '@dxos/app-framework/ui';
-import { AppCapabilities } from '@dxos/app-toolkit';
-import { type ConfigProto, SaveConfig, Storage, defs } from '@dxos/config';
-import { log } from '@dxos/log';
-import { useClient } from '@dxos/react-client';
-import { Icon, IconButton, Input, Select, Toast, useFileDownload, useTranslation } from '@dxos/react-ui';
-import { Settings } from '@dxos/react-ui-form';
-import { setDeep } from '@dxos/util';
-
-import { meta } from '../meta';
-import { type DebugSettingsProps } from '../types';
-
-type Toast = {
-  title: string;
-  description?: string;
-};
-
-const StorageAdapters = {
-  opfs: defs.Runtime.Client.Storage.StorageDriver.WEBFS,
-  idb: defs.Runtime.Client.Storage.StorageDriver.IDB,
-} as const;
-
-export type DebugSettingsComponentProps = {
-  settings: DebugSettingsProps;
-  onSettingsChange: (fn: (current: DebugSettingsProps) => DebugSettingsProps) => void;
-};
-
-export const DebugSettings = ({ settings, onSettingsChange }: DebugSettingsComponentProps) => {
-  const { t } = useTranslation(meta.id);
-  const [toast, setToast] = useState<Toast>();
-  const client = useClient();
-  const download = useFileDownload();
-  // TODO(mykola): Get updates from other places that change Config.
-  const [storageConfig, setStorageConfig] = useState<ConfigProto>({});
-  const [upload] = useCapabilities(AppCapabilities.FileUploader);
-
-  useEffect(() => {
-    void Storage().then((config) => setStorageConfig(config));
-  }, []);
-
-  const handleToast = (toast: Toast) => {
-    setToast(toast);
-    const t = setTimeout(() => setToast(undefined), 5_000);
-    return () => clearTimeout(t);
-  };
-
-  const handleDownload = async () => {
-    const data = await client.diagnostics();
-    const file = new Blob([JSON.stringify(data, undefined, 2)], {
-      type: 'text/plain',
-    });
-    const fileName = `composer-${new Date().toISOString().replace(/\W/g, '-')}.json`;
-    download(file, fileName);
-
-    if (upload) {
-      const info = await upload(client.spaces.default.db, new File([file], fileName));
-      if (!info) {
-        log.error('diagnostics failed to upload to IPFS');
-        return;
-      }
-      handleToast({
-        title: t('settings uploaded'),
-        description: t('settings uploaded to clipboard'),
-      });
-
-      // TODO(nf): move to IpfsPlugin?
-      const url = client.config.values.runtime!.services!.ipfs!.gateway + '/' + info.cid;
-      void navigator.clipboard.writeText(url);
-      handleToast({
-        title: t('settings uploaded'),
-        description: t('settings uploaded to clipboard'),
-      });
-      log.info('diagnostics', { url });
-    }
-  };
-
-  const handleRepair = async () => {
-    try {
-      const info = await client.repair();
-      setStorageConfig(await Storage());
-      handleToast({
-        title: t('settings repair success'),
-        description: JSON.stringify(info, undefined, 2),
-      });
-    } catch (err: any) {
-      handleToast({
-        title: t('settings repair failed'),
-        description: err.message,
-      });
-    }
-  };
-
-  return (
-    <Settings.Root>
-      <Settings.Section title={t('settings title', { ns: meta.id })}>
-        <Settings.Group>
-          <Settings.ItemInput title={t('settings wireframe')}>
-            <Input.Switch
-              checked={settings.wireframe}
-              onCheckedChange={(checked) => onSettingsChange((s) => ({ ...s, wireframe: !!checked }))}
-            />
-          </Settings.ItemInput>
-          <Settings.ItemInput title={t('settings download diagnostics')}>
-            <IconButton
-              icon='ph--download-simple--regular'
-              iconOnly
-              label={t('settings download diagnostics')}
-              onClick={handleDownload}
-            />
-          </Settings.ItemInput>
-          <Settings.ItemInput title={t('settings repair')}>
-            <IconButton
-              icon='ph--first-aid-kit--regular'
-              iconOnly
-              label={t('settings repair')}
-              onClick={handleRepair}
-            />
-          </Settings.ItemInput>
-
-          {/* TODO(burdon): Move to layout? */}
-          {toast && (
-            <Toast.Root>
-              <Toast.Body>
-                <Toast.Title>
-                  <Icon icon='ph--gift--duotone' size={5} classNames='inline mr-1' />
-                  <span>{toast.title}</span>
-                </Toast.Title>
-                {toast.description && <Toast.Description>{toast.description}</Toast.Description>}
-              </Toast.Body>
-            </Toast.Root>
-          )}
-
-          <Settings.ItemInput title={t('settings choose storage adaptor')}>
-            <Select.Root
-              value={
-                Object.entries(StorageAdapters).find(
-                  ([_name, value]) => value === storageConfig?.runtime?.client?.storage?.dataStore,
-                )?.[0]
-              }
-              onValueChange={(value) => {
-                if (confirm(t('settings storage adapter changed alert'))) {
-                  updateConfig(
-                    storageConfig,
-                    setStorageConfig,
-                    ['runtime', 'client', 'storage', 'dataStore'],
-                    StorageAdapters[value as keyof typeof StorageAdapters],
-                  );
-                }
-              }}
-            >
-              <Select.TriggerButton placeholder={t('settings data store label')} />
-              <Select.Portal>
-                <Select.Content>
-                  <Select.Viewport>
-                    {Object.keys(StorageAdapters).map((key) => (
-                      <Select.Option key={key} value={key}>
-                        {t(`settings storage adaptor ${key} label`)}
-                      </Select.Option>
-                    ))}
-                  </Select.Viewport>
-                  <Select.Arrow />
-                </Select.Content>
-              </Select.Portal>
-            </Select.Root>
-          </Settings.ItemInput>
-        </Settings.Group>
-      </Settings.Section>
-    </Settings.Root>
-  );
-};
-
-const updateConfig = (config: ConfigProto, setConfig: (newConfig: ConfigProto) => void, path: string[], value: any) => {
-  const storageConfigCopy = JSON.parse(JSON.stringify(config ?? {}));
-  setDeep(storageConfigCopy, path, value);
-  setConfig(storageConfigCopy);
-  queueMicrotask(async () => {
-    await SaveConfig(storageConfigCopy);
-  });
-};