@dxos/plugin-observability 0.8.4-main.74a063c4e0 → 0.8.4-main.765dc60934

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-observability",
-  "version": "0.8.4-main.74a063c4e0",
+  "version": "0.8.4-main.765dc60934",
   "description": "DXOS app framework plugin for hooking up app observability",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,55 +8,69 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
   "imports": {
-    "#capabilities": "./src/capabilities/index.ts",
-    "#components": "./src/components/index.ts",
-    "#containers": "./src/containers/index.ts",
-    "#meta": "./src/meta.ts",
-    "#operations": "./src/operations/index.ts",
-    "#types": "./src/types/index.ts"
-  },
-  "exports": {
-    ".": {
-      "source": "./src/index.ts",
-      "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
     },
-    "./cli": {
-      "source": "./src/cli/index.ts",
-      "types": "./dist/types/src/cli/index.d.ts",
-      "browser": "./dist/lib/browser/cli/index.mjs",
-      "node": "./dist/lib/node-esm/cli/index.mjs"
+    "#components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
     },
-    "./operations": {
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#operations": {
       "source": "./src/operations/index.ts",
       "types": "./dist/types/src/operations/index.d.ts",
-      "browser": "./dist/lib/browser/operations/index.mjs",
-      "node": "./dist/lib/node-esm/operations/index.mjs"
+      "default": "./dist/lib/neutral/operations/index.mjs"
+    },
+    "#plugin": {
+      "source": {
+        "node": "./src/ObservabilityPlugin.node.ts",
+        "default": "./src/ObservabilityPlugin.ts"
+      },
+      "types": "./dist/types/src/ObservabilityPlugin.d.ts",
+      "node": "./dist/lib/neutral/ObservabilityPlugin.node.mjs",
+      "default": "./dist/lib/neutral/ObservabilityPlugin.mjs"
     },
-    "./types": {
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    },
+    "#types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs"
+      "default": "./dist/lib/neutral/types/index.mjs"
     }
   },
-  "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ],
-      "operations": [
-        "dist/types/src/operations/index.d.ts"
-      ]
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/types/src/index.d.ts",
+      "default": "./dist/lib/neutral/index.mjs"
+    },
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
+  "types": "dist/types/src/index.d.ts",
   "files": [
     "dist",
     "src"
@@ -66,34 +80,36 @@
     "@effect-atom/atom-react": "^0.5.0",
     "effect": "3.20.0",
     "localforage": "^1.10.0",
-    "@dxos/app-framework": "0.8.4-main.74a063c4e0",
-    "@dxos/async": "0.8.4-main.74a063c4e0",
-    "@dxos/context": "0.8.4-main.74a063c4e0",
-    "@dxos/app-toolkit": "0.8.4-main.74a063c4e0",
-    "@dxos/echo": "0.8.4-main.74a063c4e0",
-    "@dxos/invariant": "0.8.4-main.74a063c4e0",
-    "@dxos/log": "0.8.4-main.74a063c4e0",
-    "@dxos/observability": "0.8.4-main.74a063c4e0",
-    "@dxos/operation": "0.8.4-main.74a063c4e0",
-    "@dxos/plugin-graph": "0.8.4-main.74a063c4e0",
-    "@dxos/react-ui-attention": "0.8.4-main.74a063c4e0",
-    "@dxos/protocols": "0.8.4-main.74a063c4e0",
-    "@dxos/react-ui-form": "0.8.4-main.74a063c4e0",
-    "@dxos/effect": "0.8.4-main.74a063c4e0",
-    "@dxos/react-ui-stack": "0.8.4-main.74a063c4e0",
-    "@dxos/util": "0.8.4-main.74a063c4e0",
-    "@dxos/react-client": "0.8.4-main.74a063c4e0",
-    "@dxos/react-hooks": "0.8.4-main.74a063c4e0"
+    "@dxos/app-framework": "0.8.4-main.765dc60934",
+    "@dxos/app-toolkit": "0.8.4-main.765dc60934",
+    "@dxos/async": "0.8.4-main.765dc60934",
+    "@dxos/compute": "0.8.4-main.765dc60934",
+    "@dxos/client": "0.8.4-main.765dc60934",
+    "@dxos/context": "0.8.4-main.765dc60934",
+    "@dxos/echo": "0.8.4-main.765dc60934",
+    "@dxos/effect": "0.8.4-main.765dc60934",
+    "@dxos/invariant": "0.8.4-main.765dc60934",
+    "@dxos/log": "0.8.4-main.765dc60934",
+    "@dxos/protocols": "0.8.4-main.765dc60934",
+    "@dxos/plugin-graph": "0.8.4-main.765dc60934",
+    "@dxos/observability": "0.8.4-main.765dc60934",
+    "@dxos/react-client": "0.8.4-main.765dc60934",
+    "@dxos/react-hooks": "0.8.4-main.765dc60934",
+    "@dxos/react-ui-attention": "0.8.4-main.765dc60934",
+    "@dxos/react-ui-stack": "0.8.4-main.765dc60934",
+    "@dxos/util": "0.8.4-main.765dc60934",
+    "@dxos/react-ui-form": "0.8.4-main.765dc60934"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
     "@types/react": "~19.2.7",
     "react": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/react-ui": "0.8.4-main.74a063c4e0",
-    "@dxos/storybook-utils": "0.8.4-main.74a063c4e0",
-    "@dxos/ui-theme": "0.8.4-main.74a063c4e0"
+    "vite": "^8.0.13",
+    "@dxos/react-ui": "0.8.4-main.765dc60934",
+    "@dxos/storybook-utils": "0.8.4-main.765dc60934",
+    "@dxos/plugin-testing": "0.8.4-main.765dc60934",
+    "@dxos/ui-theme": "0.8.4-main.765dc60934"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
@@ -101,10 +117,7 @@
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.74a063c4e0",
-    "@dxos/ui-theme": "0.8.4-main.74a063c4e0"
-  },
-  "publishConfig": {
-    "access": "public"
+    "@dxos/react-ui": "0.8.4-main.765dc60934",
+    "@dxos/ui-theme": "0.8.4-main.765dc60934"
   }
 }

package/src/{cli/plugin.ts → ObservabilityPlugin.node.ts}

@@ -1,15 +1,15 @@
 //
-// Copyright 2025 DXOS.org
+// Copyright 2026 DXOS.org
 //
 
 import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability, Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
-import { Operation, OperationHandlerSet } from '@dxos/operation';
+import { Operation, OperationHandlerSet } from '@dxos/compute';
 
 import { meta } from '#meta';
-import { ObservabilityOperation } from '#operations';
+import { ObservabilityOperation } from '#types';
 
 // TODO(wittjosiah): Hook up.
 export const ObservabilityPlugin = Plugin.define(meta).pipe(
@@ -29,3 +29,5 @@ export const ObservabilityPlugin = Plugin.define(meta).pipe(
   }),
   Plugin.make,
 );
+
+export default ObservabilityPlugin;

package/src/ObservabilityPlugin.test.ts

@@ -0,0 +1,25 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { ObservabilityPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('ObservabilityPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      // TODO(wittjosiah): Align browser and node variant option types.
+      plugins: [ObservabilityPlugin({} as any)],
+    });
+
+    // OperationHandler fires automatically (OperationPlugin fires SetupOperationHandler during Startup).
+    expect(harness.manager.getActive()).toContain(moduleId('OperationHandler'));
+  });
+});

package/src/ObservabilityPlugin.ts

@@ -17,21 +17,24 @@ import {
   ReactSurface,
 } from '#capabilities';
 import { meta } from '#meta';
-import { ClientReadyEvent, ObservabilityEvents } from '#types';
-import { ObservabilityCapabilities } from '#types';
-
-import { translations } from './translations';
+import { translations } from '#translations';
+import { ObservabilityCapabilities, ObservabilityEvents } from '#types';
 
 export type ObservabilityPluginOptions = {
   namespace: string;
   observability: () => Promise<Observability.Observability>;
+  /**
+   * Optional callback invoked by the help/feedback UI to download captured logs.
+   * When omitted the "Download logs" action is hidden.
+   */
+  downloadLogs?: () => void | Promise<void>;
 };
 
 export const ObservabilityPlugin = Plugin.define<ObservabilityPluginOptions>(meta).pipe(
   AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
-  Plugin.addModule(({ namespace, observability }) => ({
+  Plugin.addModule(({ observability }) => ({
     id: 'observability',
     activatesOn: ActivationEvents.Startup,
     activate: () =>
@@ -47,7 +50,7 @@ export const ObservabilityPlugin = Plugin.define<ObservabilityPluginOptions>(met
   Plugin.addModule(({ namespace }) => ({
     id: Capability.getModuleTag(ObservabilityState),
     activatesOn: ActivationEvents.Startup,
-    activatesAfter: [ObservabilityEvents.StateReady],
+    firesAfterActivation: [ObservabilityEvents.StateReady],
     activate: () => ObservabilityState({ namespace }),
   })),
   Plugin.addModule(({ namespace }) => ({
@@ -55,13 +58,21 @@ export const ObservabilityPlugin = Plugin.define<ObservabilityPluginOptions>(met
     activatesOn: ActivationEvents.Startup,
     activate: () => Effect.succeed(Capability.contributes(ObservabilityCapabilities.Namespace, namespace)),
   })),
+  Plugin.addModule(({ downloadLogs }) => ({
+    id: 'log-downloader',
+    activatesOn: ActivationEvents.Startup,
+    activate: () =>
+      Effect.succeed(
+        downloadLogs !== undefined ? Capability.contributes(ObservabilityCapabilities.LogDownloader, downloadLogs) : [],
+      ),
+  })),
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   Plugin.addModule(({ namespace, observability }) => ({
     id: Capability.getModuleTag(ClientReady),
     activatesOn: ActivationEvent.allOf(
       ActivationEvents.OperationInvokerReady,
       ObservabilityEvents.StateReady,
-      ClientReadyEvent,
+      ObservabilityEvents.ClientReadyEvent,
     ),
     activate: () =>
       Effect.gen(function* () {
@@ -71,3 +82,5 @@ export const ObservabilityPlugin = Plugin.define<ObservabilityPluginOptions>(met
   })),
   Plugin.make,
 );
+
+export default ObservabilityPlugin;

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

@@ -25,6 +25,7 @@ export default Capability.makeModule(
               icon: 'ph--question--regular',
               data: null,
               position: 'hoist',
+              joyride: 'welcome/feedback',
             }),
           ]),
       }),

package/src/capabilities/client-ready.ts

@@ -6,11 +6,11 @@ import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { LayoutOperation, SettingsOperation } from '@dxos/app-toolkit';
+import { log } from '@dxos/log';
 import { type Observability, ObservabilityProvider } from '@dxos/observability';
 
 import { meta } from '#meta';
-import { ObservabilityOperation } from '#operations';
-import { ClientCapability, ObservabilityCapabilities } from '#types';
+import { ObservabilityCapabilities, ObservabilityOperation } from '#types';
 
 export type ClientReadyOptions = {
   namespace: string;
@@ -23,7 +23,7 @@ export default Capability.makeModule(
     const { invokePromise } = yield* Capability.get(Capabilities.OperationInvoker);
     const registry = yield* Capability.get(Capabilities.AtomRegistry);
     const stateAtom = yield* Capability.get(ObservabilityCapabilities.State);
-    const client = yield* Capability.get(ClientCapability);
+    const client = yield* Capability.get(ObservabilityCapabilities.ClientCapability);
 
     const sendPrivacyNotice = async () => {
       const environment = client?.config?.values.runtime?.app?.env?.DX_ENVIRONMENT;
@@ -49,10 +49,12 @@ export default Capability.makeModule(
 
     // Ensure errors are tagged with enabled plugins to help with reproductions.
     const enabledPlugins = manager.getEnabled();
+    log('client-ready: tagging enabled plugins', { count: enabledPlugins.length });
     for (const plugin of enabledPlugins) {
       observability.setTags({ [`pluginEnabled-${plugin}`]: 'true' }, 'errors');
     }
 
+    log('client-ready: sending page.load event');
     yield* Effect.tryPromise(() =>
       invokePromise(ObservabilityOperation.SendEvent, {
         name: 'page.load',
@@ -62,16 +64,34 @@ export default Capability.makeModule(
         },
       }),
     );
+    log('client-ready: page.load event sent');
 
-    // Add client data providers.
+    // Each provider is logged individually because some provider setups perform
+    // RPC calls (e.g. runtimeMetricsProvider awaits SystemService.getPlatform());
+    // a hung worker pipe surfaces as a missing "added" log, so the last
+    // "adding ..." line points to the stall.
+    log('client-ready: adding identity data provider');
     yield* observability.addDataProvider(ObservabilityProvider.Client.identityProvider(client.services.services));
+    log('client-ready: identity data provider added');
+
+    log('client-ready: adding network metrics data provider');
     yield* observability.addDataProvider(ObservabilityProvider.Client.networkMetricsProvider(client.services.services));
+    log('client-ready: network metrics data provider added');
+
+    log('client-ready: adding runtime metrics data provider');
     yield* observability.addDataProvider(ObservabilityProvider.Client.runtimeMetricsProvider(client.services.services));
+    log('client-ready: runtime metrics data provider added');
+
+    log('client-ready: adding space metrics data provider');
     yield* observability.addDataProvider(ObservabilityProvider.Client.spacesMetricsProvider(client));
+    log('client-ready: space metrics data provider added');
 
     if (client.halo.identity.get()) {
+      log('client-ready: identity present, sending privacy notice');
       yield* Effect.tryPromise(() => sendPrivacyNotice());
+      log('client-ready: privacy notice sent');
     } else {
+      log('client-ready: no identity, deferring privacy notice');
       const subscription = client.halo.identity.subscribe(async (identity) => {
         if (identity && observability) {
           await sendPrivacyNotice();
@@ -80,6 +100,7 @@ export default Capability.makeModule(
       });
     }
 
+    log('client-ready: contributing observability capability');
     return Capability.contributes(ObservabilityCapabilities.Observability, observability, () => observability.close());
   }),
 );

package/src/capabilities/index.ts

@@ -3,7 +3,7 @@
 //
 
 import { Capability } from '@dxos/app-framework';
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 import type { ClientReadyOptions } from './client-ready';
 

package/src/capabilities/operation-handler.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
-import type { OperationHandlerSet } from '@dxos/operation';
+import type { OperationHandlerSet } from '@dxos/compute';
 
 import { ObservabilityOperationHandlerSet } from '#operations';
 

package/src/capabilities/react-surface.tsx

@@ -10,9 +10,8 @@ import { Surface, useOperationInvoker, useSettingsState } from '@dxos/app-framew
 import { AppSurface } from '@dxos/app-toolkit/ui';
 
 import { ObservabilitySettings } from '#components';
-import { HelpContainer } from '#containers';
 import { meta } from '#meta';
-import { ObservabilityOperation } from '#operations';
+import { ObservabilityOperation } from '#types';
 import { type Settings } from '#types';
 
 export default Capability.makeModule(() =>
@@ -20,8 +19,7 @@ export default Capability.makeModule(() =>
     Capability.contributes(Capabilities.ReactSurface, [
       Surface.create({
         id: 'root',
-        role: 'article',
-        filter: AppSurface.settingsArticle(meta.id),
+        filter: AppSurface.settings(AppSurface.Article, meta.id),
         component: ({ data: { subject } }) => {
           const { settings } = useSettingsState<Settings.Settings>(subject.atom);
           const { invokePromise } = useOperationInvoker();
@@ -32,11 +30,6 @@ export default Capability.makeModule(() =>
           return <ObservabilitySettings settings={settings} onSettingsChange={handleSettingsChange} />;
         },
       }),
-      Surface.create({
-        id: 'help',
-        role: 'deck-companion--help',
-        component: () => <HelpContainer />,
-      }),
     ]),
   ),
 );

package/src/components/ObservabilitySettings/ObservabilitySettings.stories.tsx

@@ -6,7 +6,8 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
-import { translations } from '../../translations';
+import { translations } from '#translations';
+
 import { ObservabilitySettings } from './ObservabilitySettings';
 
 const meta = {

package/src/components/ObservabilitySettings/ObservabilitySettings.tsx

@@ -5,11 +5,11 @@
 import React from 'react';
 
 import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Input, Message, useTranslation } from '@dxos/react-ui';
+import { Message, useTranslation } from '@dxos/react-ui';
 import { Settings as SettingsForm } from '@dxos/react-ui-form';
 
 import { meta } from '#meta';
-import { type Settings } from '#types';
+import { Settings } from '#types';
 
 export type ObservabilitySettingsProps = AppSurface.SettingsArticleProps<Settings.Settings>;
 
@@ -22,16 +22,12 @@ export const ObservabilitySettings = ({ settings, onSettingsChange }: Observabil
         <Message.Root valence='info'>
           <Message.Content>{t('observability.description')}</Message.Content>
         </Message.Root>
-        <SettingsForm.Item
-          title={t('observability-enabled.label')}
-          description={t('observability-enabled.description')}
-        >
-          <Input.Switch
-            disabled={!onSettingsChange}
-            checked={settings.enabled}
-            onCheckedChange={(checked) => onSettingsChange?.((s) => ({ ...s, enabled: !!checked }))}
-          />
-        </SettingsForm.Item>
+        <SettingsForm.FieldSet
+          readonly={!onSettingsChange}
+          schema={Settings.Settings}
+          values={settings}
+          onValuesChanged={(values) => onSettingsChange?.(() => values)}
+        />
       </SettingsForm.Section>
     </SettingsForm.Viewport>
   );

package/src/components/index.ts

@@ -4,6 +4,4 @@
 
 import { type ComponentType, lazy } from 'react';
 
-export * from './FeedbackForm';
-
 export const ObservabilitySettings: ComponentType<any> = lazy(() => import('./ObservabilitySettings'));

package/src/index.ts

@@ -2,8 +2,5 @@
 // Copyright 2023 DXOS.org
 //
 
-export { ObservabilityCapabilities, ObservabilityEvents } from './types';
-export * from './components';
 export * from './meta';
-export * from './ObservabilityPlugin';
-export { translations as observabilityTranslations } from './translations';
+export * from './types';

package/src/meta.ts

@@ -13,4 +13,5 @@ export const meta: Plugin.Meta = {
     Track metrics, logs, and traces for system health and analytics.
   `,
   icon: 'ph--eye--regular',
+  tags: ['system'],
 };

package/src/operations/index.ts

@@ -2,13 +2,9 @@
 // Copyright 2025 DXOS.org
 //
 
-import { OperationHandlerSet } from '@dxos/operation';
-
-export * as ObservabilityOperation from './definitions';
-export { UserFeedback } from './definitions';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export const ObservabilityOperationHandlerSet = OperationHandlerSet.lazy(
-  () => import('./capture-user-feedback'),
   () => import('./send-event'),
   () => import('./toggle'),
 );

package/src/operations/send-event.ts

@@ -5,12 +5,11 @@
 import * as Effect from 'effect/Effect';
 
 import { Capability } from '@dxos/app-framework';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
-import { ObservabilityCapabilities } from '../types';
-import { SendEvent } from './definitions';
+import { ObservabilityCapabilities, ObservabilityOperation } from '../types';
 
-const handler: Operation.WithHandler<typeof SendEvent> = SendEvent.pipe(
+const handler: Operation.WithHandler<typeof ObservabilityOperation.SendEvent> = ObservabilityOperation.SendEvent.pipe(
   Operation.withHandler(
     Effect.fnUntraced(function* (input) {
       // NOTE: This is to ensure that events fired before observability is ready are still sent.

package/src/operations/toggle.ts

@@ -6,15 +6,14 @@ import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { AppCapabilities } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
 import { Observability } from '@dxos/observability';
-import { Operation } from '@dxos/operation';
 
 import { meta } from '#meta';
 
-import { ObservabilityCapabilities, type Settings } from '../types';
-import { Toggle } from './definitions';
+import { ObservabilityCapabilities, ObservabilityOperation, type Settings } from '../types';
 
-const handler: Operation.WithHandler<typeof Toggle> = Toggle.pipe(
+const handler: Operation.WithHandler<typeof ObservabilityOperation.Toggle> = ObservabilityOperation.Toggle.pipe(
   Operation.withHandler(
     Effect.fnUntraced(function* (input) {
       const namespace = yield* Capability.get(ObservabilityCapabilities.Namespace);

package/src/plugin.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const ObservabilityPlugin = Plugin.lazy(meta, () => import('#plugin'));
+
+export { ObservabilityOperationHandlerSet } from './operations';

package/src/translations.ts

@@ -18,18 +18,9 @@ export const translations = [
         'observability-toast-action.label': 'Settings',
         'observability-toast-action.alt': 'Open settings to learn more or to disable.',
         'observability-toast-close.label': 'Okay',
-        'observability-enabled.label': 'Enable telemetry',
-        'observability-enabled.description': 'Send anonymous usage and performance data to help improve the product.',
         // TODO: Add link about telemetry privacy. Make it clearer that user data is not collected.
         'observability.description':
           'When enabled, basic usage data will used to improve the product. This may include performance metrics, error logs, and usage data. No personally identifiable information, other than your public key, is included with this data and no private data ever leaves your devices.',
-        'help.label': 'Feedback & Support',
-        'feedback-textarea.label': 'Feedback',
-        'feedback-textarea.placeholder': 'Please enter your feedback, technical issue, or feature request.',
-        'include-debug-logs.label': 'Include debug logs',
-        'send-feedback.label': 'Send Feedback',
-        'feedback-toast.label': 'Thank you for your feedback!',
-        'feedback-toast.description': 'We will review your feedback and get back to you as soon as possible.',
       },
     },
   },

package/src/types/ObservabilityCapabilities.ts

@@ -0,0 +1,42 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import { type Atom } from '@effect-atom/atom-react';
+import * as Schema from 'effect/Schema';
+
+import { Capability } from '@dxos/app-framework';
+import { type Client } from '@dxos/client';
+import { type Observability as ObservabilityNs } from '@dxos/observability';
+
+import { meta } from '#meta';
+
+export const Namespace = Capability.make<string>(`${meta.id}.capability.namespace`);
+
+export const Settings = Capability.make<Atom.Writable<import('./Settings').Settings>>(`${meta.id}.capability.settings`);
+
+export const StateSchema = Schema.mutable(
+  Schema.Struct({
+    group: Schema.optional(Schema.String),
+    notified: Schema.optional(Schema.Boolean),
+  }),
+);
+
+export type State = Schema.Schema.Type<typeof StateSchema>;
+
+export const State = Capability.make<Atom.Writable<State>>(`${meta.id}.capability.state`);
+
+export const Observability = Capability.make<ObservabilityNs.Observability>(`${meta.id}.capability.observability`);
+
+/**
+ * Optional capability — when contributed, the help/feedback UI exposes a "Download logs" action.
+ * The callback is responsible for the entire download (read store, encode, save file).
+ */
+export type LogDownloader = () => void | Promise<void>;
+export const LogDownloader = Capability.make<LogDownloader>(`${meta.id}.capability.log-downloader`);
+
+// NOTE: This is cloned from the client plugin to avoid circular dependencies.
+// TODO(burdon): Figure out how to share defs.
+export const ClientCapability = Capability.make<Client>('org.dxos.plugin.client.capability.client');