@dxos/plugin-debug 0.11.1 → 0.12.0-next-bbabc02363f18d7643ea4160e3a7a7809870fd0d

package/src/containers/DebugPortSettings/DebugPortSettings.stories.tsx

@@ -0,0 +1,144 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import * as Schema from 'effect/Schema';
+import React, { useEffect, useMemo, useRef } from 'react';
+
+import { type CallMetadata, log } from '@dxos/log';
+import {
+  type DebugPortController,
+  type DebugPortStartOptions,
+  type DebugPortStatus,
+} from '@dxos/react-client/devtools';
+import { ViewStateProvider } from '@dxos/react-ui-attention';
+import { Form } from '@dxos/react-ui-form';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { translations } from '#translations';
+
+import { DebugPortSettings } from './DebugPortSettings';
+
+const DEBUG_PORT_ORIGIN = 'http://127.0.0.1:9321';
+
+/** Matches the path `DebugPortSettings` filters the log panel on. */
+const CONTROLLER_META: CallMetadata = {
+  F: 'packages/sdk/client/src/devtools/debug-port-controller.ts',
+  L: 1,
+  S: undefined,
+};
+
+/**
+ * Stand-in for the page-wide controller: the real one long-polls a loopback server and evaluates
+ * whatever it returns, which a story must never do.
+ */
+const createFakeController = (initial: Partial<DebugPortStatus> = {}): DebugPortController => {
+  const listeners = new Set<() => void>();
+  let status: DebugPortStatus = { running: false, ...initial };
+
+  const update = (patch: Partial<DebugPortStatus>) => {
+    status = { ...status, ...patch };
+    listeners.forEach((listener) => listener());
+  };
+
+  // The panel reads its rows from the process-wide log buffer, so the fake emits through the same
+  // logger the real controller uses rather than carrying a log of its own. The metadata spoofs the
+  // controller's file because the panel filters on it — logging from here would be filtered out.
+  const emit = (line: string, session?: string) => log.info(line, { session }, CONTROLLER_META);
+
+  return {
+    getStatus: () => status,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    start: (_options?: DebugPortStartOptions) => {
+      const session = crypto.randomUUID();
+      update({ running: true, session, origin: DEBUG_PORT_ORIGIN });
+      emit(`Session: ${session}`, session);
+      emit(`Connecting to ${DEBUG_PORT_ORIGIN}…`, session);
+      emit('Waiting for debug server…', session);
+      return session;
+    },
+    // Nothing is persisted in a story, so there is never a session to carry across a reload.
+    resume: () => undefined,
+    stop: () => {
+      emit('Debug port stopped.', status.session);
+      update({ running: false });
+    },
+  };
+};
+
+/** `Form.Row` reads the form context for its variant; the section itself binds no fields. */
+const NoFields = Schema.Struct({});
+
+type StoryProps = {
+  initial?: Partial<DebugPortStatus>;
+  /** Emitted into the shared log buffer on mount, standing in for a session already under way. */
+  lines?: string[];
+};
+
+const DefaultStory = ({ initial, lines = [] }: StoryProps) => {
+  const controller = useMemo(() => createFakeController(initial), [initial]);
+  // Seed the shared buffer so a story that opens already-running has rows to show. The buffer
+  // outlives the component, so a remount (StrictMode, story switch) must not append a second copy.
+  const seeded = useRef(false);
+  useEffect(() => {
+    if (seeded.current) {
+      return;
+    }
+    seeded.current = true;
+    lines.forEach((line) => log.info(line, { session: initial?.session }, CONTROLLER_META));
+  }, [lines, initial?.session]);
+
+  return (
+    // `Logger.Root` keeps its per-file level overrides in view state.
+    <ViewStateProvider>
+      <Form.Root schema={NoFields} values={{}} variant='settings'>
+        <Form.Viewport scroll>
+          <Form.Content>
+            <DebugPortSettings controller={controller} />
+          </Form.Content>
+        </Form.Viewport>
+      </Form.Root>
+    </ViewStateProvider>
+  );
+};
+
+const meta = {
+  title: 'plugins/plugin-debug/containers/DebugPortSettings',
+  component: DefaultStory,
+  render: DefaultStory,
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
+  tags: ['settings'],
+  parameters: {
+    layout: 'fullscreen',
+    translations,
+  },
+} satisfies Meta<typeof DefaultStory>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Stopped: Story = {
+  args: {},
+};
+
+export const Running: Story = {
+  args: {
+    initial: {
+      running: true,
+      session: '951c7576-b636-47ff-acc6-a1c4fdf65fb6',
+      origin: DEBUG_PORT_ORIGIN,
+    },
+    lines: [
+      'Session: 951c7576-b636-47ff-acc6-a1c4fdf65fb6',
+      `Connecting to ${DEBUG_PORT_ORIGIN}…`,
+      'Command #1:',
+      'return dxos.client.spaces.get().length',
+      'Command #1 ok',
+    ],
+  },
+};

package/src/containers/DebugPortSettings/DebugPortSettings.tsx

@@ -0,0 +1,112 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useCallback, useSyncExternalStore } from 'react';
+
+import { type DebugPortController, getDebugPortController } from '@dxos/react-client/devtools';
+import { IconButton, Input, useTranslation } from '@dxos/react-ui';
+import { Logger, type LogRow } from '@dxos/react-ui-debug';
+import { Form } from '@dxos/react-ui-form';
+
+import { meta } from '#meta';
+
+/**
+ * Scopes the panel to the controller's own entries.
+ *
+ * A display filter, not `initialFilter`: that one narrows what the process-wide buffer captures,
+ * which would starve the main log companion reading the same buffer.
+ */
+const isDebugPortRow = (row: LogRow): boolean => (row.entry.meta?.F ?? '').includes(CONTROLLER_FILE);
+
+const CONTROLLER_FILE = 'devtools/debug-port-controller';
+
+export type DebugPortSettingsProps = {
+  /** Injectable for stories/tests; defaults to the page-wide controller. */
+  controller?: DebugPortController;
+  /** The switch starts arbitrary eval, so it follows the form's readonly state like every other control. */
+  disabled?: boolean;
+};
+
+/**
+ * Start/stop the agent debug port and surface the session id an agent needs.
+ *
+ * The port evaluates agent-supplied code against the live client, so it is off until this switch is
+ * flipped, the session id is regenerated on every activation, and nothing survives a reload.
+ */
+export const DebugPortSettings = ({ controller = getDebugPortController(), disabled }: DebugPortSettingsProps) => {
+  const { t } = useTranslation(meta.profile.key);
+  const subscribe = useCallback((listener: () => void) => controller.subscribe(listener), [controller]);
+  const getStatus = useCallback(() => controller.getStatus(), [controller]);
+  const status = useSyncExternalStore(subscribe, getStatus);
+
+  // `persist` keeps the session across reloads of this tab: an OAuth redirect or a HMR reload would
+  // otherwise strand the agent mid-investigation with a dead session id.
+  const handleToggle = useCallback(
+    (checked: boolean) => (checked ? controller.start({ persist: true }) : controller.stop()),
+    [controller],
+  );
+
+  const handleCopy = useCallback(() => {
+    if (status.session) {
+      void navigator.clipboard.writeText(status.session);
+    }
+  }, [status.session]);
+
+  return (
+    <Form.Section
+      title={t('settings.debug-port.section.label')}
+      description={t('settings.debug-port.section.description')}
+    >
+      <Form.Row label={t('settings.debug-port.label')} description={t('settings.debug-port.description')}>
+        <div className='flex items-center gap-3'>
+          {status.running && (
+            <span className='text-sm text-description'>
+              {t('settings.debug-port.running.label')} <span className='font-mono'>{status.origin}</span>
+            </span>
+          )}
+          <Input.Root>
+            <Input.Switch checked={status.running} disabled={disabled} onCheckedChange={handleToggle} />
+          </Input.Root>
+        </div>
+      </Form.Row>
+
+      {status.running && (
+        <>
+          <Form.Row
+            standalone
+            label={t('settings.debug-port.session.label')}
+            description={t('settings.debug-port.session.description')}
+          >
+            <div className='flex items-center gap-2'>
+              <span className='grow truncate font-mono text-sm'>{status.session}</span>
+              <IconButton
+                icon='ph--copy--regular'
+                iconOnly
+                label={t('settings.debug-port.copy-session.label')}
+                onClick={handleCopy}
+              />
+            </div>
+          </Form.Row>
+
+          {/* The settings variant puts the control in a right-hand column; log rows need the full
+              width, so this row collapses to a single column. */}
+          <Form.Row
+            standalone
+            label={t('settings.debug-port.log.label')}
+            classNames='md:grid-cols-1 md:[grid-template-areas:"header""description""control""validation"]'
+          >
+            {/* Only the rows: a settings card has no room for the panel's toolbar, levels or filter. */}
+            <Logger.Root rowFilter={isDebugPortRow}>
+              <Logger.Content classNames='max-h-[16lh]'>
+                <Logger.List />
+              </Logger.Content>
+            </Logger.Root>
+          </Form.Row>
+        </>
+      )}
+    </Form.Section>
+  );
+};
+
+DebugPortSettings.displayName = 'DebugPortSettings';

package/src/containers/DebugPortSettings/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export * from './DebugPortSettings';

package/src/containers/DebugSettings/DebugSettings.tsx

@@ -4,7 +4,8 @@
 
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
 
-import { AppCapabilities, AppSpace } from '@dxos/app-toolkit';
+import * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';
+import * as AppSpace from '@dxos/app-toolkit/AppSpace';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { type ConfigProto, SaveConfig, Storage, defs } from '@dxos/config';
 import { log } from '@dxos/log';
@@ -16,7 +17,9 @@ import { TRACE_ALL_KEY } from '@dxos/tracing';
 import { setDeep } from '@dxos/util';
 
 import { meta } from '#meta';
-import { Settings } from '#types';
+
+import * as Settings from '../../types/Settings';
+import { DebugPortSettings } from '../DebugPortSettings';
 
 type Toast = {
   title: string;
@@ -65,12 +68,12 @@ export const DebugSettings = ({ settings, onSettingsChange, logStore, onUpload }
     download(file, fileName);
 
     if (onUpload) {
-      const personalSpace = AppSpace.getPersonalSpace(client);
-      if (!personalSpace) {
-        log.error('no personal space available for upload');
+      const defaultSpace = AppSpace.getDefaultSpace(client);
+      if (!defaultSpace) {
+        log.error('no default space available for upload');
         return;
       }
-      const info = await onUpload(personalSpace.db, new File([file], fileName));
+      const info = await onUpload(defaultSpace.db, new File([file], fileName));
       if (!info) {
         log.error('diagnostics failed to upload to IPFS');
         return;
@@ -244,6 +247,8 @@ export const DebugSettings = ({ settings, onSettingsChange, logStore, onUpload }
               </Select.Root>
             </Form.Row>
           </Form.Section>
+
+          <DebugPortSettings disabled={!onSettingsChange} />
         </Form.Content>
       </Form.Viewport>
     </Form.Root>

package/src/containers/SpaceGenerator/SpaceGenerator.stories.tsx

@@ -0,0 +1,93 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { withPluginManager } from '@dxos/app-framework/testing';
+import { Filter, Obj, Query } from '@dxos/echo';
+import { useQuery } from '@dxos/echo-react';
+import { ClientPlugin, initializeIdentity } from '@dxos/plugin-client/testing';
+import { SpacePlugin } from '@dxos/plugin-space/testing';
+import { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';
+import { useSpaces } from '@dxos/react-client/echo';
+import { ScrollArea } from '@dxos/react-ui';
+import { Listbox } from '@dxos/react-ui-list';
+import { withLayout } from '@dxos/react-ui/testing';
+
+import { translations } from '#translations';
+
+import { SpaceGenerator } from './SpaceGenerator';
+
+/** Live list of every object in the space — updates as the generator creates objects. */
+const ObjectList = ({ space }: { space: Parameters<typeof SpaceGenerator>[0]['space'] }) => {
+  const objects = useQuery(space.db, Query.select(Filter.everything()));
+
+  return (
+    <ScrollArea.Root thin orientation='vertical'>
+      <ScrollArea.Viewport>
+        <Listbox.Root>
+          <Listbox.Content>
+            {objects.map((object) => (
+              <Listbox.Item key={object.id} id={object.id} classNames='px-2 gap-2'>
+                <div className='flex flex-col grow truncate'>
+                  <span className='truncate'>{Obj.getLabel(object) ?? object.id}</span>
+                  <span className='text-description text-sm truncate'>{Obj.getTypename(object)}</span>
+                </div>
+              </Listbox.Item>
+            ))}
+          </Listbox.Content>
+        </Listbox.Root>
+      </ScrollArea.Viewport>
+    </ScrollArea.Root>
+  );
+};
+
+const DefaultStory = () => {
+  const [space] = useSpaces();
+  if (!space) {
+    return <></>;
+  }
+
+  return (
+    <div className='dx-container grid grid-cols-2 divide-x divide-separator'>
+      <SpaceGenerator space={space} />
+      <ObjectList space={space} />
+    </div>
+  );
+};
+
+const meta = {
+  title: 'plugins/plugin-debug/containers/SpaceGenerator',
+  render: DefaultStory,
+  decorators: [
+    withLayout({ layout: 'fullscreen' }),
+    withPluginManager(() => ({
+      plugins: [
+        ...corePlugins(),
+        StorybookPlugin({}),
+        ClientPlugin({
+          onClientInitialized: ({ client }) =>
+            Effect.gen(function* () {
+              yield* initializeIdentity(client);
+            }),
+        }),
+        // Contributes the operation handlers the generators invoke (e.g. `SpaceOperation.AddType`).
+        SpacePlugin({}),
+      ],
+    })),
+  ],
+  parameters: {
+    layout: 'fullscreen',
+    controls: { disable: true },
+    translations,
+  },
+} satisfies Meta<typeof DefaultStory>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

package/src/containers/SpaceGenerator/SpaceGenerator.tsx

@@ -5,16 +5,27 @@
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import { useOperationInvoker, useOptionalCapability } from '@dxos/app-framework/ui';
-import { AppCapabilities } from '@dxos/app-toolkit';
+import * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';
 import { useProgress } from '@dxos/app-toolkit/ui';
 import { ComputeGraph } from '@dxos/conductor';
 import { Filter, Obj, Type } from '@dxos/echo';
-import { Drawing } from '@dxos/plugin-illustrator';
-import { Markdown } from '@dxos/plugin-markdown';
-import { Sheet } from '@dxos/plugin-sheet';
+import { log } from '@dxos/log';
+import * as Drawing from '@dxos/plugin-illustrator/Drawing';
+import * as Markdown from '@dxos/plugin-markdown/Markdown';
+import * as Sheet from '@dxos/plugin-sheet/Sheet';
+import { SpaceOperation } from '@dxos/plugin-space';
 import { useClient } from '@dxos/react-client';
 import { type Space } from '@dxos/react-client/echo';
-import { IconButton, Input, Panel, ScrollArea, ThemedClassName, Toolbar, useAsyncEffect } from '@dxos/react-ui';
+import {
+  DropdownMenu,
+  IconButton,
+  Input,
+  Panel,
+  ScrollArea,
+  ThemedClassName,
+  Toolbar,
+  useAsyncEffect,
+} from '@dxos/react-ui';
 import { composable, composableProps } from '@dxos/react-ui';
 import { Organization, Person, Task } from '@dxos/types';
 import { mx } from '@dxos/ui-theme';
@@ -84,6 +95,18 @@ export const SpaceGenerator = composable<HTMLDivElement, SpaceGeneratorProps>(
 
     useAsyncEffect(updateInfo, [updateInfo]);
 
+    const handleReset = useCallback(async () => {
+      try {
+        const { error } = await invokePromise(SpaceOperation.RemoveAllObjects, undefined, { spaceId: space.id });
+        if (error) {
+          log.catch(error);
+        }
+        await updateInfo();
+      } catch (error) {
+        log.catch(error);
+      }
+    }, [space, invokePromise, updateInfo]);
+
     const handleCreateData = useCallback(
       async (typename: string) => {
         const constructor = typeMap.get(typename);
@@ -93,7 +116,7 @@ export const SpaceGenerator = composable<HTMLDivElement, SpaceGeneratorProps>(
           await updateInfo();
         }
       },
-      [typeMap, count, space, onCreateObjects, updateInfo],
+      [space, typeMap, count, updateInfo, onCreateObjects],
     );
 
     return (
@@ -101,6 +124,21 @@ export const SpaceGenerator = composable<HTMLDivElement, SpaceGeneratorProps>(
         <Panel.Toolbar>
           <Toolbar.Root classNames='dx-document'>
             <IconButton icon='ph--arrow-clockwise--regular' iconOnly label='Refresh' onClick={updateInfo} />
+            <DropdownMenu.Root>
+              <DropdownMenu.Trigger asChild>
+                <IconButton icon='ph--trash--regular' iconOnly label='Reset space' data-testid='spaceGenerator.reset' />
+              </DropdownMenu.Trigger>
+              <DropdownMenu.Portal>
+                <DropdownMenu.Content side='bottom'>
+                  <DropdownMenu.Viewport>
+                    <DropdownMenu.Item data-testid='spaceGenerator.confirmReset' onClick={handleReset}>
+                      Confirm to remove all objects from the space.
+                    </DropdownMenu.Item>
+                  </DropdownMenu.Viewport>
+                  <DropdownMenu.Arrow />
+                </DropdownMenu.Content>
+              </DropdownMenu.Portal>
+            </DropdownMenu.Root>
             <Toolbar.Separator />
             <Input.Root>
               <Input.TextInput

package/src/containers/StatsPanel/StatsPanel.tsx

@@ -6,7 +6,7 @@ import { Atom, useAtomValue } from '@effect-atom/atom-react';
 import React, { Fragment } from 'react';
 
 import { useOptionalCapability } from '@dxos/app-framework/ui';
-import { AppCapabilities } from '@dxos/app-toolkit';
+import * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';
 import { ScrollArea } from '@dxos/react-ui';
 
 // Fallback so the atom hook is called unconditionally when no store is contributed (host plugin not
@@ -57,7 +57,7 @@ export const StatsPanel = () => {
             <dl className='grid grid-cols-[auto_minmax(0,1fr)] w-full'>
               {flatten(value).map(([key, cell]) => (
                 <Fragment key={key}>
-                  <dt className='border-be border-separator pbe-1 pbs-1 pie-2 text-description self-start'>{key}</dt>
+                  <dt className='border-be border-separator pbe-1 pbs-1 pe-2 text-description self-start'>{key}</dt>
                   <dd className='border-be border-separator pbe-1 pbs-1 truncate font-mono text-end'>
                     {formatValue(cell)}
                   </dd>

package/src/index.ts

@@ -2,5 +2,9 @@
 // Copyright 2026 DXOS.org
 //
 
+export * as Debug from './types/Debug';
+export * as DebugEvents from './types/DebugEvents';
+export * as DebugNodes from './types/DebugNodes';
+export * as DebugSurface from './types/DebugSurface';
+export * as Settings from './types/Settings';
 export * from './meta';
-export * from './types';

package/src/meta.ts

@@ -2,7 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-import { Plugin } from '@dxos/app-framework';
+import * as Plugin from '@dxos/app-framework/Plugin';
 
 import config from '../dx.config';
 

package/src/plugin.ts

@@ -2,9 +2,9 @@
 // Copyright 2026 DXOS.org
 //
 
-import { Plugin } from '@dxos/app-framework';
+import * as Plugin from '@dxos/app-framework/Plugin';
 
 import { meta } from './meta';
 
 export const DebugPlugin = Plugin.lazy(meta, () => import('#plugin'));
-export type { DebugPluginOptions } from '#types';
+export type { DebugPluginOptions } from './types/Debug';

package/src/translations.ts

@@ -49,6 +49,19 @@ export const translations = [
           'Warning: Swapping the storage adapter will make your data unavailable.',
 
         'settings.data-store.label': 'Data Store',
+
+        'settings.debug-port.section.label': 'Agent debug port',
+        'settings.debug-port.section.description':
+          'Lets a local agent evaluate code against this page via composer-recovery.js. Off by default; stops on reload.',
+        'settings.debug-port.label': 'Open debug port.',
+        'settings.debug-port.description':
+          'Runs arbitrary code from a loopback server with full access to your data. Only enable while you are working with an agent you trust.',
+        'settings.debug-port.running.label': 'Listening on',
+        'settings.debug-port.session.label': 'Session id',
+        'settings.debug-port.session.description':
+          'Pass to composer-recovery.js --session. A new id is issued on every restart.',
+        'settings.debug-port.copy-session.label': 'Copy session id.',
+        'settings.debug-port.log.label': 'Debug port log',
       },
     },
   },

package/src/types/{debug.ts → Debug.ts}

@@ -5,7 +5,7 @@
 import { type Atom } from '@effect-atom/atom';
 import { type Context, createContext } from 'react';
 
-import { Capability } from '@dxos/app-framework';
+import * as Capability from '@dxos/app-framework/Capability';
 import type { TimerCallback, TimerOptions } from '@dxos/async';
 import { type IdbLogStore } from '@dxos/log-store-idb';
 
@@ -33,5 +33,7 @@ export const DebugContext: Context<DebugContextType> = createContext<DebugContex
 });
 
 export namespace DebugCapabilities {
-  export const Settings = Capability.make<Atom.Writable<Settings.Settings>>(`${meta.profile.key}.capability.settings`);
+  export const Settings = Capability.makeSingleton<Atom.Writable<Settings.Settings>>()(
+    `${meta.profile.key}.capability.settings`,
+  );
 }

package/src/types/DebugEvents.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as ActivationEvent from '@dxos/app-framework/ActivationEvent';
+
+import { meta } from '#meta';
+
+/**
+ * The feature's start event: the plugin's start-gated modules (and cross-plugin
+ * contributions consumed by this feature) activate here. Fired on demand and by the
+ * host's idle trickle.
+ */
+export const Start = ActivationEvent.pluginStart(meta.profile.key);

package/dist/lib/chunk-types.mjs

@@ -1,60 +0,0 @@
-import { Capability, Role } from "@dxos/app-framework";
-import { createContext } from "react";
-import { meta } from "#meta";
-import * as Schema from "effect/Schema";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-//#region src/types/debug.ts
-var DebugContext = createContext({
-	running: false,
-	start: () => {},
-	stop: () => {}
-});
-var DebugCapabilities;
-(function(_DebugCapabilities) {
-	_DebugCapabilities.Settings = Capability.make(`${meta.profile.key}.capability.settings`);
-})(DebugCapabilities || (DebugCapabilities = {}));
-//#endregion
-//#region src/types/DebugNodes.ts
-var DebugNodes_exports = /* @__PURE__ */ __exportAll({
-	SpaceType: () => SpaceType,
-	id: () => id,
-	nodeId: () => nodeId
-});
-/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */
-var nodeId = (fullId) => fullId.split(".").at(-1) ?? "";
-var debugId = meta.profile.key;
-/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */
-var id = `${debugId}.debug`;
-/** Discriminator for the space-generator article surface (`node.data.type`). */
-var SpaceType = `${debugId}.space`;
-//#endregion
-//#region src/types/DebugSurface.ts
-var DebugSurface_exports = /* @__PURE__ */ __exportAll({ Stats: () => Stats });
-/**
-* Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store
-* (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);
-* the surface reads the store directly, so it needs no subject.
-*/
-var Stats = Role.make(`${meta.profile.key}.surface.stats`);
-//#endregion
-//#region src/types/Settings.ts
-var Settings_exports = /* @__PURE__ */ __exportAll({ Settings: () => Settings });
-var Settings = Schema.mutable(Schema.Struct({
-	wireframe: Schema.optional(Schema.Boolean),
-	traceAll: Schema.optional(Schema.Boolean)
-}));
-//#endregion
-export { DebugContext as a, DebugCapabilities as i, DebugSurface_exports as n, DebugNodes_exports as r, Settings_exports as t };
-
-//# sourceMappingURL=chunk-types.mjs.map

package/dist/lib/chunk-types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk-types.mjs","names":[],"sources":["../../src/types/debug.ts","../../src/types/DebugNodes.ts","../../src/types/DebugSurface.ts","../../src/types/Settings.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom';\nimport { type Context, createContext } from 'react';\n\nimport { Capability } from '@dxos/app-framework';\nimport type { TimerCallback, TimerOptions } from '@dxos/async';\nimport { type IdbLogStore } from '@dxos/log-store-idb';\n\nimport { meta } from '#meta';\n\nimport * as Settings from './Settings';\n\nexport type DebugPluginOptions = {\n  /** Shared persistent log store for capturing and downloading logs. */\n  logStore?: IdbLogStore;\n  /** Persist the stats-panel store to localStorage so it survives a reload. Defaults to `true`. */\n  persistStats?: boolean;\n};\n\nexport type DebugContextType = {\n  running: boolean;\n  start: (cb: TimerCallback, options: TimerOptions) => void;\n  stop: () => void;\n};\n\nexport const DebugContext: Context<DebugContextType> = createContext<DebugContextType>({\n  running: false,\n  start: () => {},\n  stop: () => {},\n});\n\nexport namespace DebugCapabilities {\n  export const Settings = Capability.make<Atom.Writable<Settings.Settings>>(`${meta.profile.key}.capability.settings`);\n}\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { meta } from '#meta';\n\n/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */\nexport const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';\n\nconst debugId = meta.profile.key;\n\n/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */\nexport const id = `${debugId}.debug`;\n\n/** Discriminator for the space-generator article surface (`node.data.type`). */\nexport const SpaceType = `${debugId}.space`;\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { Role } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\n/**\n * Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store\n * (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);\n * the surface reads the store directly, so it needs no subject.\n */\nexport const Stats = Role.make<Record<string, unknown>>(`${meta.profile.key}.surface.stats`);\n","//\n// Copyright 2023 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nexport const Settings = Schema.mutable(\n  Schema.Struct({\n    wireframe: Schema.optional(Schema.Boolean),\n    traceAll: Schema.optional(Schema.Boolean),\n  }),\n);\n\nexport interface Settings extends Schema.Schema.Type<typeof Settings> {}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4BA,IAAa,eAA0C,cAAgC;CACrF,SAAS;CACT,aAAa,CAAC;CACd,YAAY,CAAC;AACf,CAAC;AAEM,IAAA;;CACQ,mBAAA,WAAW,WAAW,KAAuC,GAAG,KAAK,QAAQ,IAAI,qBAAqB;GACrH,sBAAA,oBAAA,CAAA,EAAA;;;;;;;;;AC3BA,IAAa,UAAU,WAA2B,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;AAE9E,IAAM,UAAU,KAAK,QAAQ;;AAG7B,IAAa,KAAK,GAAG,QAAQ;;AAG7B,IAAa,YAAY,GAAG,QAAQ;;;;;;;;;ACFpC,IAAa,QAAQ,KAAK,KAA8B,GAAG,KAAK,QAAQ,IAAI,eAAe;;;;ACP3F,IAAa,WAAW,OAAO,QAC7B,OAAO,OAAO;CACZ,WAAW,OAAO,SAAS,OAAO,OAAO;CACzC,UAAU,OAAO,SAAS,OAAO,OAAO;AAC1C,CAAC,CACH"}

package/dist/lib/types.mjs

@@ -1,2 +0,0 @@
-import { a as DebugContext, i as DebugCapabilities, n as DebugSurface_exports, r as DebugNodes_exports, t as Settings_exports } from "./chunk-types.mjs";
-export { DebugCapabilities, DebugContext, DebugNodes_exports as DebugNodes, DebugSurface_exports as DebugSurface, Settings_exports as Settings };