@dxos/plugin-client 0.9.0 → 0.9.1-staging.ee54ba693a

package/src/containers/InvitationsContainer/InvitationsContainer.tsx

@@ -7,44 +7,45 @@ import React, { useCallback, useState } from 'react';
 
 import { useCapability } from '@dxos/app-framework/ui';
 import { Context } from '@dxos/context';
-import { Clipboard, Icon, IconButton, List, ListItem, useAsyncEffect, useTranslation } from '@dxos/react-ui';
-import { Settings } from '@dxos/react-ui-form';
+import { Clipboard, Icon, IconButton, useAsyncEffect, useTranslation } from '@dxos/react-ui';
+import { Form } from '@dxos/react-ui-form';
+import { Listbox } from '@dxos/react-ui-list';
 
 import { meta } from '#meta';
-import { ClientCapabilities } from '#types';
+import { type AccountCacheInvitation, ClientCapabilities } from '#types';
 
-import { type AccountCacheInvitation } from '../../state/account-cache';
-import { useHubHttpClient } from '../../state/use-hub-http';
+import { useHubHttpClient } from '../../hooks';
 
 export const InvitationsContainer = () => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const accountCacheAtom = useCapability(ClientCapabilities.AccountCache);
   const [cache] = useAtom(accountCacheAtom);
   const setCache = useAtomSet(accountCacheAtom);
   const [pending, setPending] = useState(false);
 
   // Account/invitation routes live on hub-service, not the edge worker.
-  const hubHttp = useHubHttpClient();
+  const hubClient = useHubHttpClient();
 
   useAsyncEffect(async () => {
-    if (!hubHttp) {
+    if (!hubClient) {
       return;
     }
+
     try {
-      const result = await hubHttp.listAccountInvitations(new Context());
+      const result = await hubClient.listAccountInvitations(new Context());
       setCache((prev) => ({ ...prev, invitations: result.invitations, fetchedAt: Date.now() }));
     } catch {
       // Offline: keep cache.
     }
-  }, [hubHttp, setCache]);
+  }, [hubClient, setCache]);
 
   const handleIssue = useCallback(async () => {
-    if (!hubHttp) {
+    if (!hubClient) {
       return;
     }
     setPending(true);
     try {
-      const result = await hubHttp.issueAccountInvitation(new Context());
+      const result = await hubClient.issueAccountInvitation(new Context());
       // Optimistically push the new code and decrement the remaining quota; the
       // server consumes one slot at issue time. Next refresh reconciles.
       setCache((prev) => ({
@@ -57,7 +58,7 @@ export const InvitationsContainer = () => {
     } finally {
       setPending(false);
     }
-  }, [hubHttp, setCache]);
+  }, [hubClient, setCache]);
 
   const remaining = cache.account?.invitationsRemaining ?? 0;
   const list = cache.invitations ?? [];
@@ -66,72 +67,74 @@ export const InvitationsContainer = () => {
 
   return (
     <Clipboard.Provider>
-      <Settings.Viewport>
-        <Settings.Section title={t('invitations-section.title')} description={t('invitations-section.description')}>
-          <Settings.Item
-            title={t('generate-invitation.label')}
-            description={t('generate-invitation.description', { count: remaining })}
-          >
-            <IconButton
-              icon='ph--plus--regular'
-              label={t('generate-invitation.label')}
-              variant='primary'
-              onClick={handleIssue}
-              disabled={pending || remaining <= 0}
-            />
-          </Settings.Item>
-        </Settings.Section>
+      <Form.Root variant='settings'>
+        <Form.Viewport scroll>
+          <Form.Content>
+            <Form.Section title={t('invitations-section.title')} description={t('invitations-section.description')}>
+              <Form.Row
+                label={t('generate-invitation.label')}
+                description={t('generate-invitation.description', { count: remaining })}
+              >
+                <IconButton
+                  icon='ph--plus--regular'
+                  label={t('generate-invitation.label')}
+                  variant='primary'
+                  onClick={handleIssue}
+                  disabled={pending || remaining <= 0}
+                />
+              </Form.Row>
+            </Form.Section>
 
-        {available.length > 0 ? (
-          <Settings.Section title={t('available-invitations.title')}>
-            <List>
-              {available.map((row) => (
-                <AvailableInvitationItem key={row.code} row={row} />
-              ))}
-            </List>
-          </Settings.Section>
-        ) : null}
+            {available.length > 0 ? (
+              <Form.Section title={t('available-invitations.title')}>
+                <Listbox.Root>
+                  <Listbox.Content classNames='gap-1'>
+                    {available.map((row) => (
+                      <AvailableInvitationItem key={row.code} row={row} />
+                    ))}
+                  </Listbox.Content>
+                </Listbox.Root>
+              </Form.Section>
+            ) : null}
 
-        {redeemed.length > 0 ? (
-          <Settings.Section title={t('redeemed-invitations.title')}>
-            <List>
-              {redeemed.map((row) => (
-                <RedeemedInvitationItem key={row.code} row={row} />
-              ))}
-            </List>
-          </Settings.Section>
-        ) : null}
-      </Settings.Viewport>
+            {redeemed.length > 0 ? (
+              <Form.Section title={t('redeemed-invitations.title')}>
+                <Listbox.Root>
+                  <Listbox.Content classNames='gap-1'>
+                    {redeemed.map((row) => (
+                      <RedeemedInvitationItem key={row.code} row={row} />
+                    ))}
+                  </Listbox.Content>
+                </Listbox.Root>
+              </Form.Section>
+            ) : null}
+          </Form.Content>
+        </Form.Viewport>
+      </Form.Root>
     </Clipboard.Provider>
   );
 };
 
 const AvailableInvitationItem = ({ row }: { row: AccountCacheInvitation }) => (
-  <ListItem.Root classNames='grid grid-cols-[min-content_1fr_min-content] items-center gap-2'>
-    <ListItem.Endcap>
-      <Icon icon='ph--paper-plane-tilt--duotone' size={5} classNames='text-description' />
-    </ListItem.Endcap>
+  <Listbox.Item id={row.code} classNames='grid grid-cols-[min-content_1fr_min-content] items-center gap-2'>
+    <Icon icon='ph--paper-plane-tilt--duotone' size={5} classNames='text-description' />
     <div className='flex flex-col min-w-0'>
-      <ListItem.Heading classNames='font-mono truncate'>{row.code}</ListItem.Heading>
+      <div className='font-mono truncate'>{row.code}</div>
       <p className='text-description text-xs'>{new Date(row.createdAt).toLocaleString()}</p>
     </div>
-    <ListItem.Endcap>
-      <Clipboard.IconButton value={row.code} />
-    </ListItem.Endcap>
-  </ListItem.Root>
+    <Clipboard.IconButton value={row.code} />
+  </Listbox.Item>
 );
 
 const RedeemedInvitationItem = ({ row }: { row: AccountCacheInvitation }) => {
   const date = row.redeemedAt ?? row.createdAt;
   return (
-    <ListItem.Root classNames='grid grid-cols-[min-content_1fr] items-center gap-2'>
-      <ListItem.Endcap>
-        <Icon icon='ph--check-circle--duotone' size={5} classNames='text-success-text' />
-      </ListItem.Endcap>
+    <Listbox.Item id={row.code} classNames='grid grid-cols-[min-content_1fr] items-center gap-2'>
+      <Icon icon='ph--check-circle--duotone' size={5} classNames='text-success-text' />
       <div className='flex flex-col min-w-0'>
-        <ListItem.Heading classNames='font-mono truncate'>{row.code}</ListItem.Heading>
+        <div className='font-mono truncate'>{row.code}</div>
         <p className='text-description text-xs'>{new Date(date).toLocaleString()}</p>
       </div>
-    </ListItem.Root>
+    </Listbox.Item>
   );
 };

package/src/containers/JoinDialog/JoinDialog.tsx

@@ -17,7 +17,7 @@ import { ClientOperation } from '#operations';
 
 export const JoinDialog = (props: JoinPanelProps) => {
   const { invokePromise } = useOperationInvoker();
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
 
   const handleCancelResetStorage = useCallback(() => invokePromise(ClientOperation.ShareIdentity), [invokePromise]);
 

package/src/containers/ProfileContainer/ProfileContainer.tsx

@@ -9,7 +9,7 @@ import { debounce } from '@dxos/async';
 import { useClient } from '@dxos/react-client';
 import { type Identity, useIdentity } from '@dxos/react-client/halo';
 import { ButtonGroup, Clipboard, Input, useTranslation } from '@dxos/react-ui';
-import { Form, type FormFieldMap, type FormUpdateMeta, Settings } from '@dxos/react-ui-form';
+import { Form, type FormFieldMap, type FormUpdateMeta } from '@dxos/react-ui-form';
 import { EmojiPickerBlock, HuePicker } from '@dxos/react-ui-pickers';
 import { hexToEmoji, hexToHue } from '@dxos/util';
 
@@ -33,7 +33,7 @@ const getDefaultEmojiValue = (identity: Identity | null) => hexToEmoji(identity?
 const getEmojiValue = (identity: Identity | null) => identity?.profile?.data?.emoji || getDefaultEmojiValue(identity);
 
 export const ProfileContainer = () => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const client = useClient();
   const identity = useIdentity();
   const [displayName, setDisplayNameDirectly] = useState(identity?.profile?.displayName ?? '');
@@ -101,14 +101,16 @@ export const ProfileContainer = () => {
         );
 
         return (
-          <Settings.Item title={label} description={t('display-name.description')}>
-            <Input.TextInput
-              value={getValue()}
-              onChange={handleChange}
-              placeholder={t('display-name-input.placeholder')}
-              classNames='min-w-64'
-            />
-          </Settings.Item>
+          <Form.Row label={label} description={t('display-name.description')}>
+            <Input.Root>
+              <Input.TextInput
+                value={getValue()}
+                onChange={handleChange}
+                placeholder={t('display-name-input.placeholder')}
+                classNames='min-w-64'
+              />
+            </Input.Root>
+          </Form.Row>
         );
       },
       emoji: ({ type, label, getValue, onValueChange }) => {
@@ -119,7 +121,7 @@ export const ProfileContainer = () => {
         );
 
         return (
-          <Settings.Item title={label} description={t('icon.description')}>
+          <Form.Row label={label} description={t('icon.description')}>
             <EmojiPickerBlock
               triggerVariant='default'
               emoji={getValue()}
@@ -127,7 +129,7 @@ export const ProfileContainer = () => {
               onClickClear={handleEmojiReset}
               classNames='justify-self-end'
             />
-          </Settings.Item>
+          </Form.Row>
         );
       },
       hue: ({ type, label, getValue, onValueChange }) => {
@@ -138,22 +140,24 @@ export const ProfileContainer = () => {
         );
 
         return (
-          <Settings.Item title={label} description={t('hue.description')}>
+          <Form.Row label={label} description={t('hue.description')}>
             <div className='flex justify-self-end'>
               <HuePicker value={getValue()} onChange={handleChange} onReset={handleHueReset} />
             </div>
-          </Settings.Item>
+          </Form.Row>
         );
       },
       // TODO(wittjosiah): We need text input annotations for disabled and copyable.
       did: ({ label, getValue }) => {
         return (
-          <Settings.Item title={label} description={t('did.description')}>
-            <ButtonGroup classNames='w-full'>
-              <Input.TextInput value={getValue()} disabled classNames='min-w-64' />
-              <Clipboard.IconButton value={getValue() ?? ''} />
-            </ButtonGroup>
-          </Settings.Item>
+          <Form.Row label={label} description={t('did.description')}>
+            <Input.Root>
+              <ButtonGroup classNames='w-full'>
+                <Input.TextInput value={getValue()} disabled classNames='min-w-64' />
+                <Clipboard.IconButton value={getValue() ?? ''} />
+              </ButtonGroup>
+            </Input.Root>
+          </Form.Row>
         );
       },
     }),
@@ -162,15 +166,21 @@ export const ProfileContainer = () => {
 
   return (
     <Clipboard.Provider>
-      <Settings.Viewport>
-        <Settings.Section title={t('profile.label')} description={t('profile.description')}>
-          <Form.Root schema={UserProfile} values={values} fieldMap={fieldMap} onValuesChanged={handleChange}>
-            <Form.Content classNames='gap-form-gap'>
+      <Form.Root
+        variant='settings'
+        schema={UserProfile}
+        values={values}
+        fieldMap={fieldMap}
+        onValuesChanged={handleChange}
+      >
+        <Form.Viewport scroll>
+          <Form.Content>
+            <Form.Section title={t('profile.label')} description={t('profile.description')}>
               <Form.FieldSet />
-            </Form.Content>
-          </Form.Root>
-        </Settings.Section>
-      </Settings.Viewport>
+            </Form.Section>
+          </Form.Content>
+        </Form.Viewport>
+      </Form.Root>
     </Clipboard.Provider>
   );
 };

package/src/containers/RecoveryCodeDialog/RecoveryCodeDialog.tsx

@@ -14,7 +14,7 @@ export type RecoveryCodeDialogProps = {
 
 // TODO(burdon): Should have cancel button.
 export const RecoveryCodeDialog = ({ code }: RecoveryCodeDialogProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const [confirmation, setConfirmation] = useState(false);
 
   const handleConfirmation = useCallback((checked: boolean) => setConfirmation(checked), []);

package/src/containers/RecoveryCredentialsContainer/RecoveryCredentialsContainer.tsx

@@ -6,16 +6,17 @@ import React from 'react';
 
 import { useOperationInvoker } from '@dxos/app-framework/ui';
 import { useCredentials } from '@dxos/react-client/halo';
-import { Icon, IconButton, List, ListItem, Message, useTranslation } from '@dxos/react-ui';
-import { Settings } from '@dxos/react-ui-form';
+import { Icon, IconButton, Message, useTranslation } from '@dxos/react-ui';
+import { Form } from '@dxos/react-ui-form';
+import { Listbox } from '@dxos/react-ui-list';
 
 import { meta } from '#meta';
 import { ClientOperation } from '#operations';
 
-export const MANAGE_CREDENTIALS_DIALOG = `${meta.id}.ManageCredentialsDialog`;
+export const MANAGE_CREDENTIALS_DIALOG = `${meta.profile.key}.ManageCredentialsDialog`;
 
 export const RecoveryCredentialsContainer = () => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const { invokePromise } = useOperationInvoker();
   const credentials = useCredentials();
   const recoveryCredentials = credentials.filter(
@@ -23,44 +24,52 @@ export const RecoveryCredentialsContainer = () => {
   );
 
   return (
-    <Settings.Viewport>
-      <Settings.Section title={t('recovery-setup-dialog.title')} description={t('recovery-setup-dialog.description')}>
-        <Settings.Item title={t('create-passkey.label')} description={t('create-passkey.description')}>
-          <IconButton
-            label={t('create-passkey.label')}
-            icon='ph--key--duotone'
-            variant='primary'
-            onClick={() => invokePromise(ClientOperation.CreatePasskey)}
-          />
-        </Settings.Item>
-        <Settings.Item title={t('create-recovery-code.label')} description={t('create-recovery-code.description')}>
-          <IconButton
-            label={t('create-recovery-code.label')}
-            icon='ph--receipt--duotone'
-            variant='default'
-            onClick={() => invokePromise(ClientOperation.CreateRecoveryCode)}
-          />
-        </Settings.Item>
-      </Settings.Section>
-      <Settings.Section title={t('credentials-list.label')}>
-        {recoveryCredentials.length < 1 ? (
-          <Message.Root valence='error'>
-            <Message.Title icon='ph--shield-warning--duotone'>{t('no-credentials.title')}</Message.Title>
-            <Message.Content>{t('no-credentials.message')}</Message.Content>
-          </Message.Root>
-        ) : (
-          <List>
-            {recoveryCredentials.map((credential) => (
-              <ListItem.Root key={credential.id?.toHex()}>
-                <ListItem.Endcap>
-                  <Icon icon='ph--key--regular' />
-                </ListItem.Endcap>
-                <ListItem.Heading>{credential.issuanceDate.toLocaleString()}</ListItem.Heading>
-              </ListItem.Root>
-            ))}
-          </List>
-        )}
-      </Settings.Section>
-    </Settings.Viewport>
+    <Form.Root variant='settings'>
+      <Form.Viewport scroll>
+        <Form.Content>
+          <Form.Section title={t('recovery-setup-dialog.title')} description={t('recovery-setup-dialog.description')}>
+            <Form.Row label={t('create-passkey.label')} description={t('create-passkey.description')}>
+              <IconButton
+                label={t('create-passkey.label')}
+                icon='ph--key--duotone'
+                variant='primary'
+                onClick={() => invokePromise(ClientOperation.CreatePasskey)}
+              />
+            </Form.Row>
+            <Form.Row label={t('create-recovery-code.label')} description={t('create-recovery-code.description')}>
+              <IconButton
+                label={t('create-recovery-code.label')}
+                icon='ph--receipt--duotone'
+                variant='default'
+                onClick={() => invokePromise(ClientOperation.CreateRecoveryCode)}
+              />
+            </Form.Row>
+          </Form.Section>
+          <Form.Section title={t('credentials-list.label')}>
+            {recoveryCredentials.length < 1 ? (
+              <Message.Root valence='error'>
+                <Message.Title icon='ph--shield-warning--duotone'>{t('no-credentials.title')}</Message.Title>
+                <Message.Content>{t('no-credentials.message')}</Message.Content>
+              </Message.Root>
+            ) : (
+              <Listbox.Root>
+                <Listbox.Content classNames='gap-1'>
+                  {recoveryCredentials.map((credential, index) => (
+                    <Listbox.Item
+                      key={credential.id?.toHex() ?? index}
+                      id={credential.id?.toHex() ?? `${index}`}
+                      classNames='gap-2'
+                    >
+                      <Icon icon='ph--key--regular' />
+                      <Listbox.ItemLabel>{credential.issuanceDate.toLocaleString()}</Listbox.ItemLabel>
+                    </Listbox.Item>
+                  ))}
+                </Listbox.Content>
+              </Listbox.Root>
+            )}
+          </Form.Section>
+        </Form.Content>
+      </Form.Viewport>
+    </Form.Root>
   );
 };

package/src/containers/UsageContainer/UsageContainer.tsx

@@ -0,0 +1,48 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import React, { useCallback, useState } from 'react';
+
+import { Context } from '@dxos/context';
+import { log } from '@dxos/log';
+import { type GetProfileUsageResponse } from '@dxos/protocols';
+import { useAsyncEffect } from '@dxos/react-ui';
+
+import { useHubHttpClient } from '../../hooks';
+import { UsageView, type UsageViewState } from './UsageView';
+
+/** State + payload kept together so `ready` always carries data (mirrors the discriminated `UsageViewProps`). */
+type UsageFetchState = { state: Exclude<UsageViewState, 'ready'> } | { state: 'ready'; data: GetProfileUsageResponse };
+
+/**
+ * Fetches rolling-window profile usage from the hub service and renders it.
+ * Connected wrapper around the presentational {@link UsageView}.
+ */
+export const UsageContainer = () => {
+  const hubHttp = useHubHttpClient();
+  const [fetchState, setFetchState] = useState<UsageFetchState>({ state: 'loading' });
+  const [lastUpdated, setLastUpdated] = useState<number | undefined>();
+  const [refreshCount, setRefreshCount] = useState(0);
+
+  useAsyncEffect(async () => {
+    if (!hubHttp) {
+      setFetchState({ state: 'unavailable' });
+      return;
+    }
+    // Keep prior data visible while refetching; only show the loading state on first load.
+    setFetchState((previous) => (previous.state === 'ready' ? previous : { state: 'loading' }));
+    try {
+      const result = await hubHttp.getProfileUsage(new Context());
+      setFetchState({ state: 'ready', data: result });
+      setLastUpdated(Date.now());
+    } catch (err) {
+      log.catch(err);
+      setFetchState({ state: 'error' });
+    }
+  }, [hubHttp, refreshCount]);
+
+  const handleRefresh = useCallback(() => setRefreshCount((count) => count + 1), []);
+
+  return <UsageView {...fetchState} lastUpdated={lastUpdated} onRefresh={handleRefresh} />;
+};

package/src/containers/UsageContainer/UsageView.stories.tsx

@@ -0,0 +1,127 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import { expect, userEvent, within } from 'storybook/test';
+
+import { type GetProfileUsageResponse } from '@dxos/protocols';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { translations } from '#translations';
+
+import { UsageView } from './UsageView';
+
+// Mock payload shaped like the `/api/metering/profile/usage` response.
+const usageData: GetProfileUsageResponse = {
+  profileId: 'did:key:z6MkExampleProfileIdentity',
+  usage: [
+    { eventType: 'ai', valueKey: 'inputTokens', subtypePattern: ['claude-opus-4'], amount: 1_284_500 },
+    { eventType: 'ai', valueKey: 'outputTokens', subtypePattern: ['claude-opus-4'], amount: 238_900 },
+    { eventType: 'ai', valueKey: 'inputTokens', subtypePattern: ['claude-sonnet-4'], amount: 92_300 },
+    { eventType: 'ai', valueKey: 'outputTokens', subtypePattern: ['claude-sonnet-4'], amount: 18_400 },
+  ],
+  limits: [
+    {
+      eventType: 'ai',
+      valueKey: 'inputTokens',
+      subtypePattern: ['claude-opus-4'],
+      limit: 5_000_000,
+      windowDuration: 24 * 7 * 60 * 60,
+    },
+    {
+      eventType: 'ai',
+      valueKey: 'outputTokens',
+      subtypePattern: ['*'],
+      limit: 1_000_000,
+      windowDuration: 24 * 30 * 60 * 60,
+    },
+    {
+      eventType: 'ai',
+      valueKey: 'inputTokens',
+      subtypePattern: ['*'],
+      limit: 20_000_000,
+      windowDuration: 24 * 30 * 60 * 60,
+    },
+  ],
+  buckets: [],
+};
+
+const meta = {
+  title: 'plugins/plugin-client/containers/UsageView',
+  component: UsageView,
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
+  tags: ['test'],
+  parameters: {
+    layout: 'fullscreen',
+    translations,
+  },
+} satisfies Meta<typeof UsageView>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    state: 'ready',
+    data: usageData,
+    lastUpdated: new Date('2026-06-16T12:00:00Z').getTime(),
+    onRefresh: () => {},
+  },
+};
+
+// Internal plan: a single unlimited (`limit: null`) `ai` limit — renders without a meter.
+export const Internal: Story = {
+  args: {
+    state: 'ready',
+    data: {
+      profileId: usageData.profileId,
+      usage: usageData.usage,
+      limits: [
+        {
+          eventType: 'ai',
+          valueKey: 'outputTokens',
+          subtypePattern: ['*'],
+          limit: null,
+          windowDuration: 24 * 30 * 60 * 60,
+        },
+      ],
+      buckets: [],
+    },
+    lastUpdated: new Date('2026-06-16T12:00:00Z').getTime(),
+    onRefresh: () => {},
+  },
+};
+
+export const Loading: Story = {
+  args: { state: 'loading' },
+};
+
+export const Error: Story = {
+  args: { state: 'error' },
+};
+
+export const Empty: Story = {
+  args: {
+    state: 'ready',
+    data: { profileId: usageData.profileId, usage: [], limits: [], buckets: [] },
+    lastUpdated: new Date('2026-06-16T12:00:00Z').getTime(),
+    onRefresh: () => {},
+  },
+};
+
+export const Unavailable: Story = {
+  args: { state: 'unavailable' },
+};
+
+// Drives the raw-response disclosure: collapsed until toggled, then the JSON viewer appears.
+export const Test: Story = {
+  args: Default.args,
+  play: async () => {
+    const screen = within(document.body);
+    await expect(screen.queryByTestId('usage-raw-json')).toBeNull();
+    await userEvent.click(await screen.findByRole('button', { name: 'Raw JSON' }, { timeout: 10_000 }));
+    await screen.findByTestId('usage-raw-json');
+  },
+};