@dxos/plugin-observability 0.8.4-main.9be5663bfe → 0.8.4-main.abd8ff62ef

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-observability",
-  "version": "0.8.4-main.9be5663bfe",
+  "version": "0.8.4-main.abd8ff62ef",
   "description": "DXOS app framework plugin for hooking up app observability",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -18,6 +18,12 @@
     "#containers": "./src/containers/index.ts",
     "#meta": "./src/meta.ts",
     "#operations": "./src/operations/index.ts",
+    "#translations": "./src/translations.ts",
+    "#plugin": {
+      "browser": "./src/ObservabilityPlugin.ts",
+      "node": "./src/ObservabilityPlugin.node.ts",
+      "default": "./src/ObservabilityPlugin.ts"
+    },
     "#types": "./src/types/index.ts"
   },
   "exports": {
@@ -27,11 +33,11 @@
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/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",
+      "browser": "./dist/lib/browser/components/index.mjs",
+      "node": "./dist/lib/node-esm/components/index.mjs"
     },
     "./operations": {
       "source": "./src/operations/index.ts",
@@ -39,6 +45,12 @@
       "browser": "./dist/lib/browser/operations/index.mjs",
       "node": "./dist/lib/node-esm/operations/index.mjs"
     },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "browser": "./dist/lib/browser/translations.mjs",
+      "node": "./dist/lib/node-esm/translations.mjs"
+    },
     "./types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
@@ -47,16 +59,6 @@
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ],
-      "operations": [
-        "dist/types/src/operations/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
@@ -66,34 +68,35 @@
     "@effect-atom/atom-react": "^0.5.0",
     "effect": "3.20.0",
     "localforage": "^1.10.0",
-    "@dxos/app-framework": "0.8.4-main.9be5663bfe",
-    "@dxos/app-toolkit": "0.8.4-main.9be5663bfe",
-    "@dxos/context": "0.8.4-main.9be5663bfe",
-    "@dxos/async": "0.8.4-main.9be5663bfe",
-    "@dxos/echo": "0.8.4-main.9be5663bfe",
-    "@dxos/effect": "0.8.4-main.9be5663bfe",
-    "@dxos/observability": "0.8.4-main.9be5663bfe",
-    "@dxos/operation": "0.8.4-main.9be5663bfe",
-    "@dxos/plugin-graph": "0.8.4-main.9be5663bfe",
-    "@dxos/invariant": "0.8.4-main.9be5663bfe",
-    "@dxos/react-client": "0.8.4-main.9be5663bfe",
-    "@dxos/protocols": "0.8.4-main.9be5663bfe",
-    "@dxos/react-hooks": "0.8.4-main.9be5663bfe",
-    "@dxos/react-ui-attention": "0.8.4-main.9be5663bfe",
-    "@dxos/react-ui-stack": "0.8.4-main.9be5663bfe",
-    "@dxos/react-ui-form": "0.8.4-main.9be5663bfe",
-    "@dxos/util": "0.8.4-main.9be5663bfe",
-    "@dxos/log": "0.8.4-main.9be5663bfe"
+    "@dxos/app-toolkit": "0.8.4-main.abd8ff62ef",
+    "@dxos/app-framework": "0.8.4-main.abd8ff62ef",
+    "@dxos/compute": "0.8.4-main.abd8ff62ef",
+    "@dxos/async": "0.8.4-main.abd8ff62ef",
+    "@dxos/context": "0.8.4-main.abd8ff62ef",
+    "@dxos/echo": "0.8.4-main.abd8ff62ef",
+    "@dxos/effect": "0.8.4-main.abd8ff62ef",
+    "@dxos/log": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-graph": "0.8.4-main.abd8ff62ef",
+    "@dxos/invariant": "0.8.4-main.abd8ff62ef",
+    "@dxos/protocols": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-client": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-hooks": "0.8.4-main.abd8ff62ef",
+    "@dxos/observability": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-form": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-stack": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-attention": "0.8.4-main.abd8ff62ef",
+    "@dxos/util": "0.8.4-main.abd8ff62ef"
   },
   "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.9be5663bfe",
-    "@dxos/storybook-utils": "0.8.4-main.9be5663bfe",
-    "@dxos/ui-theme": "0.8.4-main.9be5663bfe"
+    "vite": "^8.0.10",
+    "@dxos/plugin-testing": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui": "0.8.4-main.abd8ff62ef",
+    "@dxos/ui-theme": "0.8.4-main.abd8ff62ef",
+    "@dxos/storybook-utils": "0.8.4-main.abd8ff62ef"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
@@ -101,8 +104,8 @@
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/ui-theme": "0.8.4-main.9be5663bfe",
-    "@dxos/react-ui": "0.8.4-main.9be5663bfe"
+    "@dxos/react-ui": "0.8.4-main.abd8ff62ef",
+    "@dxos/ui-theme": "0.8.4-main.abd8ff62ef"
   },
   "publishConfig": {
     "access": "public"

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

@@ -1,12 +1,12 @@
 //
-// 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';
@@ -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,25 @@ import {
   ReactSurface,
 } from '#capabilities';
 import { meta } from '#meta';
+import { translations } from '#translations';
 import { ClientReadyEvent, ObservabilityEvents } from '#types';
 import { ObservabilityCapabilities } from '#types';
 
-import { translations } from './translations';
-
 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 +51,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,6 +59,14 @@ 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),
@@ -71,3 +83,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,6 +6,7 @@ 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';
@@ -49,10 +50,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 +65,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 +101,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

@@ -20,8 +20,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();

package/src/components/FeedbackForm/FeedbackForm.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 { FeedbackForm } from './FeedbackForm';
 
 const meta = {
@@ -30,3 +31,14 @@ export const Default: Story = {
     },
   },
 };
+
+export const WithDownloadLogs: Story = {
+  args: {
+    onSave: (values) => {
+      console.log(values);
+    },
+    onDownloadLogs: () => {
+      console.log('download logs clicked');
+    },
+  },
+};

package/src/components/FeedbackForm/FeedbackForm.tsx

@@ -4,20 +4,24 @@
 
 import React from 'react';
 
-import { useTranslation } from '@dxos/react-ui';
+import { IconButton, useTranslation } from '@dxos/react-ui';
 import { Form, type FormRootProps, type FormSubmitProps } from '@dxos/react-ui-form';
 
 import { meta } from '#meta';
 import { UserFeedback } from '#operations';
 
-export type FeedbackFormProps = Pick<FormRootProps<UserFeedback>, 'onSave'> & Pick<FormSubmitProps, 'disabled'>;
+export type FeedbackFormProps = Pick<FormRootProps<UserFeedback>, 'onSave'> &
+  Pick<FormSubmitProps, 'disabled'> & {
+    /** Optional handler — when supplied a "Download logs" button is rendered below the submit action. */
+    onDownloadLogs?: () => void | Promise<void>;
+  };
 
 const defaultValues: UserFeedback = {
   message: '',
   includeLogs: true,
 };
 
-export const FeedbackForm = ({ onSave, disabled }: FeedbackFormProps) => {
+export const FeedbackForm = ({ onSave, disabled, onDownloadLogs }: FeedbackFormProps) => {
   const { t } = useTranslation(meta.id);
 
   return (
@@ -26,6 +30,18 @@ export const FeedbackForm = ({ onSave, disabled }: FeedbackFormProps) => {
         <Form.Content>
           <Form.FieldSet />
           <Form.Submit icon='ph--paper-plane-tilt--regular' label={t('send-feedback.label')} disabled={disabled} />
+          {onDownloadLogs && (
+            <div role='none' className='flex w-full pt-form-padding'>
+              <IconButton
+                classNames='w-full'
+                type='button'
+                icon='ph--download-simple--regular'
+                label={t('download-logs.label')}
+                onClick={() => void onDownloadLogs()}
+                data-testid='download-logs-button'
+              />
+            </div>
+          )}
         </Form.Content>
       </Form.Viewport>
     </Form.Root>

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/containers/HelpContainer/HelpContainer.tsx

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 import React, { useCallback, useState } from 'react';
 
-import { useCapability, useOperationInvoker } from '@dxos/app-framework/ui';
+import { useCapabilities, useCapability, useOperationInvoker } from '@dxos/app-framework/ui';
 import { LayoutOperation } from '@dxos/app-toolkit';
 import { runAndForwardErrors } from '@dxos/effect';
 import { useAsyncEffect } from '@dxos/react-hooks';
@@ -20,6 +20,7 @@ import { ObservabilityCapabilities } from '#types';
 export const HelpContainer = () => {
   const { invokePromise } = useOperationInvoker();
   const observability = useCapability(ObservabilityCapabilities.Observability);
+  const [downloadLogs] = useCapabilities(ObservabilityCapabilities.LogDownloader);
   const [feedbackAvailable, setFeedbackAvailable] = useState(false);
 
   useAsyncEffect(
@@ -52,5 +53,5 @@ export const HelpContainer = () => {
     [invokePromise],
   );
 
-  return <FeedbackForm onSave={handleSave} disabled={!feedbackAvailable} />;
+  return <FeedbackForm onSave={handleSave} disabled={!feedbackAvailable} onDownloadLogs={downloadLogs} />;
 };

package/src/index.ts

@@ -2,8 +2,12 @@
 // Copyright 2023 DXOS.org
 //
 
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
 export { ObservabilityCapabilities, ObservabilityEvents } from './types';
-export * from './components';
+// TODO(wittjosiah): FeedbackForm should be factored out of plugin-observability into a shared UI package.
 export * from './meta';
-export * from './ObservabilityPlugin';
+export const ObservabilityPlugin = Plugin.lazy(meta, () => import('#plugin'));
 export { translations as observabilityTranslations } from './translations';

package/src/operations/capture-user-feedback.ts

@@ -5,7 +5,7 @@
 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 { CaptureUserFeedback } from './definitions';

package/src/operations/definitions.ts

@@ -5,12 +5,11 @@
 import * as Schema from 'effect/Schema';
 
 import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
 import { Format } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
 
 import { meta } from '#meta';
-
-import { translations } from '../translations';
+import { translations } from '#translations';
 
 const t = translations[0]['en-US'][meta.id];
 

package/src/operations/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export * as ObservabilityOperation from './definitions';
 export { UserFeedback } from './definitions';

package/src/operations/send-event.ts

@@ -5,7 +5,7 @@
 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';

package/src/operations/toggle.ts

@@ -6,8 +6,8 @@ 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';
 

package/src/translations.ts

@@ -18,8 +18,6 @@ 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.',
@@ -28,6 +26,7 @@ export const translations = [
         'feedback-textarea.placeholder': 'Please enter your feedback, technical issue, or feature request.',
         'include-debug-logs.label': 'Include debug logs',
         'send-feedback.label': 'Send Feedback',
+        'download-logs.label': 'Download logs',
         '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/Settings.ts

@@ -8,7 +8,10 @@ import * as Schema from 'effect/Schema';
 
 export const Settings = Schema.mutable(
   Schema.Struct({
-    enabled: Schema.Boolean,
+    enabled: Schema.Boolean.annotations({
+      title: 'Enable telemetry',
+      description: 'Send anonymous usage and performance data to help improve the product.',
+    }),
     // TODO(wittjosiah): Separate settings for each observability feature.
     // metrics?: boolean;
     // telemetry?: boolean;
@@ -16,4 +19,4 @@ export const Settings = Schema.mutable(
   }),
 );
 
-export type Settings = Schema.Schema.Type<typeof Settings>;
+export interface Settings extends Schema.Schema.Type<typeof Settings> {}

package/src/types/capabilities.ts

@@ -30,6 +30,13 @@ export namespace ObservabilityCapabilities {
   export const State = Capability.make<Atom.Writable<State>>(`${meta.id}.capability.state`);
 
   export const Observability = Capability.make<Observability.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.

package/dist/lib/browser/ObservabilitySettings-EM7ABGCA.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/components/ObservabilitySettings/ObservabilitySettings.tsx"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Input, Message, useTranslation } from '@dxos/react-ui';\nimport { Settings as SettingsForm } from '@dxos/react-ui-form';\n\nimport { meta } from '#meta';\nimport { type Settings } from '#types';\n\nexport type ObservabilitySettingsProps = AppSurface.SettingsArticleProps<Settings.Settings>;\n\nexport const ObservabilitySettings = ({ settings, onSettingsChange }: ObservabilitySettingsProps) => {\n  const { t } = useTranslation(meta.id);\n\n  return (\n    <SettingsForm.Viewport>\n      <SettingsForm.Section title={t('settings.title', { ns: meta.id })}>\n        <Message.Root valence='info'>\n          <Message.Content>{t('observability.description')}</Message.Content>\n        </Message.Root>\n        <SettingsForm.Item\n          title={t('observability-enabled.label')}\n          description={t('observability-enabled.description')}\n        >\n          <Input.Switch\n            disabled={!onSettingsChange}\n            checked={settings.enabled}\n            onCheckedChange={(checked) => onSettingsChange?.((s) => ({ ...s, enabled: !!checked }))}\n          />\n        </SettingsForm.Item>\n      </SettingsForm.Section>\n    </SettingsForm.Viewport>\n  );\n};\n"],
-  "mappings": ";;;AAIA,OAAOA,WAAW;AAGlB,SAASC,OAAOC,SAASC,sBAAsB;AAC/C,SAASC,YAAYC,oBAAoB;AAEzC,SAASC,YAAY;AAKd,IAAMC,wBAAwB,CAAC,EAAEC,UAAUC,iBAAgB,MAA8B;AAC9F,QAAM,EAAEC,EAAC,IAAKC,eAAeC,KAAKC,EAAE;AAEpC,SACE,sBAAA,cAACC,aAAaC,UAAQ,MACpB,sBAAA,cAACD,aAAaE,SAAO;IAACC,OAAOP,EAAE,kBAAkB;MAAEQ,IAAIN,KAAKC;IAAG,CAAA;KAC7D,sBAAA,cAACM,QAAQC,MAAI;IAACC,SAAQ;KACpB,sBAAA,cAACF,QAAQG,SAAO,MAAEZ,EAAE,2BAAA,CAAA,CAAA,GAEtB,sBAAA,cAACI,aAAaS,MAAI;IAChBN,OAAOP,EAAE,6BAAA;IACTc,aAAad,EAAE,mCAAA;KAEf,sBAAA,cAACe,MAAMC,QAAM;IACXC,UAAU,CAAClB;IACXmB,SAASpB,SAASqB;IAClBC,iBAAiB,CAACF,YAAYnB,mBAAmB,CAACsB,OAAO;MAAE,GAAGA;MAAGF,SAAS,CAAC,CAACD;IAAQ,EAAA;;AAMhG;",
-  "names": ["React", "Input", "Message", "useTranslation", "Settings", "SettingsForm", "meta", "ObservabilitySettings", "settings", "onSettingsChange", "t", "useTranslation", "meta", "id", "SettingsForm", "Viewport", "Section", "title", "ns", "Message", "Root", "valence", "Content", "Item", "description", "Input", "Switch", "disabled", "checked", "enabled", "onCheckedChange", "s"]
-}