@dxos/plugin-client 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-UsageContainer.mjs","names":[],"sources":["../../src/containers/UsageContainer/UsageView.tsx","../../src/containers/UsageContainer/UsageContainer.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\nimport React, { useCallback, useMemo, useState } from 'react';\n\nimport { type GetProfileUsageResponse, type MeteringLimit, type MeteringUsageItem } from '@dxos/protocols';\nimport { Banner, Progress, useTranslation } from '@dxos/react-ui';\nimport { Form, type FormFieldProvider } from '@dxos/react-ui-form';\n\nimport { meta } from '#meta';\n\nexport type UsageViewState = 'loading' | 'ready' | 'error' | 'unavailable';\n\ntype UsageViewCommonProps = {\n  /** Epoch milliseconds of the last successful fetch. */\n  lastUpdated?: number;\n  /** Invoked when the user requests a refresh. */\n  onRefresh?: () => void;\n};\n\n/**\n * Discriminated on `state`: the payload is required (and only present) when `state` is `'ready'`, so a\n * missing payload can't be silently rendered as an empty plan.\n */\nexport type UsageViewProps =\n  | (UsageViewCommonProps & { state: Exclude<UsageViewState, 'ready'>; data?: undefined })\n  | (UsageViewCommonProps & { state: 'ready'; data: GetProfileUsageResponse });\n\ntype TFunction = (key: string, options?: Record<string, unknown>) => string;\n\n/**\n * Whether a usage row falls under a limit. Subtype segments are matched positionally against\n * `subtypePattern` where `*` matches any segment.\n */\nconst usageMatchesLimit = (item: MeteringUsageItem, limit: MeteringLimit): boolean => {\n  if (item.eventType !== limit.eventType || item.valueKey !== limit.valueKey) {\n    return false;\n  }\n  return limit.subtypePattern.every((pattern, index) => pattern === '*' || pattern === item.subtypePattern[index]);\n};\n\n/** Sum every usage item that falls under the limit. */\nconst sumUsageForLimit = (usage: GetProfileUsageResponse['usage'], limit: MeteringLimit): number =>\n  usage.reduce((total, item) => (usageMatchesLimit(item, limit) ? total + item.amount : total), 0);\n\n/** Humanize a camelCase value key, e.g. `outputTokens` → `output tokens`. */\nconst formatValueKey = (valueKey: string): string =>\n  valueKey\n    .replace(/([A-Z])/g, ' $1')\n    .trim()\n    .toLowerCase();\n\n/**\n * Human label for a limit: a scope followed by the value key, e.g.\n * `{ eventType: 'ai', valueKey: 'outputTokens', subtypePattern: ['*'] }` → `All models · output tokens`,\n * `{ eventType: 'ai', valueKey: 'inputTokens', subtypePattern: ['claude-opus-4'] }` → `claude-opus-4 · input tokens`.\n */\nconst formatLimitLabel = (limit: MeteringLimit, t: TFunction): string => {\n  const metric = formatValueKey(limit.valueKey);\n  const subtype = limit.subtypePattern.filter((segment) => segment && segment !== '*').join('/');\n  if (limit.eventType === 'ai') {\n    return `${subtype || t('usage-all-models.label')} · ${metric}`;\n  }\n  return `${subtype ? `${limit.eventType}/${subtype}` : limit.eventType} · ${metric}`;\n};\n\nconst formatAmount = (amount: number): string => amount.toLocaleString();\n\nconst SECONDS_PER_HOUR = 60 * 60;\n\n/** Render `windowHours` as a localized \"N months / days / hours\" string. */\nconst formatWindow = (windowHours: number, t: TFunction): string => {\n  if (windowHours % (24 * 30) === 0) {\n    return t('usage-window-months.label', { count: windowHours / (24 * 30) });\n  }\n  if (windowHours % 24 === 0) {\n    return t('usage-window-days.label', { count: windowHours / 24 });\n  }\n  return t('usage-window-hours.label', { count: windowHours });\n};\n\ntype UsageRow = {\n  key: string;\n  /** Field label (schema `title` annotation). */\n  label: string;\n  /** Field caption (schema `description` annotation). */\n  caption: string;\n  /** Consumption as a whole percentage (`0`–`100`); `undefined` for an unlimited limit. */\n  percent?: number;\n  windowHours: number;\n};\n\n/** One display row per limit, shorter windows first. A `null` limit is reported as unlimited. */\nconst computeRows = (data: GetProfileUsageResponse, t: TFunction): UsageRow[] =>\n  data.limits\n    .map((limit): UsageRow => {\n      const used = sumUsageForLimit(data.usage, limit);\n      const label = formatLimitLabel(limit, t);\n      const windowHours = limit.windowDuration / SECONDS_PER_HOUR;\n      const window = formatWindow(windowHours, t);\n      const key = `${limit.eventType}/${limit.subtypePattern.join(',')}/${limit.valueKey}/${limit.windowDuration}/${limit.limit ?? 'unlimited'}`;\n      if (limit.limit === null) {\n        return {\n          key,\n          label,\n          caption: t('usage-unlimited.description', { used: formatAmount(used), window }),\n          windowHours,\n        };\n      }\n      const percent = limit.limit > 0 ? Math.min(100, Math.round((used / limit.limit) * 100)) : used > 0 ? 100 : 0;\n      return {\n        key,\n        label,\n        caption: `${t('usage-percent-used.label', { percent })} · ${t('usage-limit.description', { used: formatAmount(used), limit: formatAmount(limit.limit), window })}`,\n        percent,\n        windowHours,\n      };\n    })\n    .sort((left, right) => left.windowHours - right.windowHours);\n\n/**\n * A single usage field: an optional number carrying its label/caption as `title`/`description`\n * annotations and the consumption percentage as its value. Optional so the form renders no required\n * markers; `Schema.Number` keeps the field context-free (`R = never`) so the struct stays assignable to `Form`.\n */\nconst usageField = (title: string, description: string) =>\n  Schema.optional(Schema.Number.annotate({ title, description }));\n\n/**\n * Build the Effect schema (one annotated field per limit) and matching values. Unlimited limits have no\n * value, so their field reads `undefined` and the renderer shows the \"Unlimited\" label instead of a meter.\n */\nconst buildUsageForm = (rows: UsageRow[]) => {\n  const fields: Record<string, ReturnType<typeof usageField>> = {};\n  const values: Record<string, number> = {};\n  rows.forEach((row, index) => {\n    const field = `metric_${index}`;\n    fields[field] = usageField(row.label, row.caption);\n    if (row.percent !== undefined) {\n      values[field] = row.percent;\n    }\n  });\n  return { schema: Schema.Struct(fields), values };\n};\n\n/** Non-data states shown as a single `Message`, keyed by message variant (translation keys for the copy). */\nconst STATE_MESSAGES = {\n  unavailable: {\n    valence: 'warning',\n    icon: 'ph--cloud-slash--duotone',\n    title: 'usage-unavailable.title',\n    description: 'usage-unavailable.description',\n  },\n  error: {\n    valence: 'error',\n    icon: 'ph--cloud-x--duotone',\n    title: 'usage-offline.title',\n    description: 'usage-offline.description',\n  },\n  empty: {\n    valence: 'neutral',\n    icon: 'ph--chart-bar--duotone',\n    title: 'usage-empty.title',\n    description: 'usage-empty.description',\n  },\n} as const;\n\n/**\n * Presentational view of profile usage: renders loading/error/unavailable/empty states, or a\n * schema-driven settings form (one read-only field per limit), plus a refresh control and a\n * collapsible raw-response viewer. Pure — all data via props.\n */\nexport const UsageView = ({ state, data, lastUpdated, onRefresh }: UsageViewProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const [rawExpanded, setRawExpanded] = useState(false);\n\n  const { schema, values, empty } = useMemo(() => {\n    const rows = data ? computeRows(data, t) : [];\n    return { ...buildUsageForm(rows), empty: rows.length === 0 };\n  }, [data, t]);\n\n  // Non-data states resolve to a `Message`; `loading` shows a spinner and `ready` with data shows the form.\n  const message =\n    state === 'unavailable'\n      ? STATE_MESSAGES.unavailable\n      : state === 'error'\n        ? STATE_MESSAGES.error\n        : state === 'ready' && empty\n          ? STATE_MESSAGES.empty\n          : undefined;\n\n  // Render each metric as a meter from its percentage value; unlimited limits (no value) show a label.\n  const meterFieldProvider = useCallback<FormFieldProvider>(\n    ({ fieldProps: { label, description, getValue } }) => {\n      const percent = getValue();\n      return (\n        <Form.Row label={label} description={description}>\n          {typeof percent === 'number' ? (\n            <Progress progress={percent / 100} aria-label={t('usage-percent-used.label', { percent })} />\n          ) : (\n            t('usage-unlimited.label')\n          )}\n        </Form.Row>\n      );\n    },\n    [t],\n  );\n\n  return (\n    <Form.Root variant='settings' layout='static' schema={schema} values={values}>\n      <Form.Viewport scroll>\n        <Form.Content>\n          <Form.Section title={t('usage-section.title')} description={t('usage-section.description')}>\n            {message ? (\n              <Banner.Root valence={message.valence}>\n                <Banner.Content>\n                  <Banner.Title icon={message.icon}>{t(message.title)}</Banner.Title>\n                  <Banner.Body>{t(message.description)}</Banner.Body>\n                </Banner.Content>\n              </Banner.Root>\n            ) : (\n              <Form.FieldSet fieldProvider={meterFieldProvider} />\n            )}\n          </Form.Section>\n\n          {/* {state === 'ready' && data && (\n            <Form.Section>\n              <Form.Row\n                label={\n                  lastUpdated !== undefined\n                    ? t('usage-last-updated.label', { time: new Date(lastUpdated).toLocaleTimeString() })\n                    : t('usage-refresh.label')\n                }\n              >\n                {onRefresh && (\n                  <IconButton\n                    iconOnly\n                    variant='ghost'\n                    icon='ph--arrow-clockwise--regular'\n                    label={t('usage-refresh.label')}\n                    onClick={onRefresh}\n                  />\n                )}\n              </Form.Row>\n            </Form.Section>\n          )} */}\n\n          {/* {state === 'ready' && data && (\n            <Form.Section>\n              <Form.Row label={t('usage-raw-json.label')}>\n                <ToggleIconButton\n                  iconOnly\n                  variant='ghost'\n                  active={rawExpanded}\n                  icon='ph--caret-right--regular'\n                  label={t('usage-raw-json.label')}\n                  onClick={() => setRawExpanded((value) => !value)}\n                />\n              </Form.Row>\n              {rawExpanded && <JsonHighlighter data={data} testId='usage-raw-json' />}\n            </Form.Section>\n          )} */}\n        </Form.Content>\n      </Form.Viewport>\n    </Form.Root>\n  );\n};\n\nUsageView.displayName = 'UsageView';\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useState } from 'react';\n\nimport { Context } from '@dxos/context';\nimport { log } from '@dxos/log';\nimport { type GetProfileUsageResponse } from '@dxos/protocols';\nimport { useAsyncEffect } from '@dxos/react-ui';\n\nimport { useHubHttpClient } from '../../hooks';\nimport { UsageView, type UsageViewState } from './UsageView';\n\n/** State + payload kept together so `ready` always carries data (mirrors the discriminated `UsageViewProps`). */\ntype UsageFetchState =\n  | {\n      state: Exclude<UsageViewState, 'ready'>;\n    }\n  | {\n      state: 'ready';\n      data: GetProfileUsageResponse;\n    };\n\n/**\n * Fetches rolling-window profile usage from the hub service and renders it.\n * Connected wrapper around the presentational {@link UsageView}.\n */\nexport const UsageContainer = () => {\n  const hubHttp = useHubHttpClient();\n  const [fetchState, setFetchState] = useState<UsageFetchState>({ state: 'loading' });\n  const [lastUpdated, setLastUpdated] = useState<number | undefined>();\n  const [refreshCount, setRefreshCount] = useState(0);\n\n  useAsyncEffect(async () => {\n    if (!hubHttp) {\n      setFetchState({ state: 'unavailable' });\n      return;\n    }\n    // Keep prior data visible while refetching; only show the loading state on first load.\n    setFetchState((previous) => (previous.state === 'ready' ? previous : { state: 'loading' }));\n    try {\n      const result = await hubHttp.getProfileUsage(new Context());\n      setFetchState({ state: 'ready', data: result });\n      setLastUpdated(Date.now());\n    } catch (err) {\n      log.catch(err);\n      setFetchState({ state: 'error' });\n    }\n  }, [hubHttp, refreshCount]);\n\n  const handleRefresh = useCallback(() => setRefreshCount((count) => count + 1), []);\n\n  return <UsageView {...fetchState} lastUpdated={lastUpdated} onRefresh={handleRefresh} />;\n};\n\nUsageContainer.displayName = 'UsageContainer';\n"],"mappings":"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"}
+{"version":3,"file":"chunk-UsageContainer.mjs","names":[],"sources":["../../src/containers/UsageContainer/UsageView.tsx","../../src/containers/UsageContainer/UsageContainer.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\nimport React, { useCallback, useMemo, useState } from 'react';\n\nimport { type GetProfileUsageResponse, type MeteringLimit, type MeteringUsageItem } from '@dxos/protocols';\nimport { Form, type FormFieldProvider } from '@dxos/react-ui-form';\nimport * as Banner from '@dxos/react-ui/Banner';\nimport * as Hooks from '@dxos/react-ui/Hooks';\nimport * as Status from '@dxos/react-ui/Status';\n\nimport { meta } from '#meta';\n\nexport type UsageViewState = 'loading' | 'ready' | 'error' | 'unavailable';\n\ntype UsageViewCommonProps = {\n  /** Epoch milliseconds of the last successful fetch. */\n  lastUpdated?: number;\n  /** Invoked when the user requests a refresh. */\n  onRefresh?: () => void;\n};\n\n/**\n * Discriminated on `state`: the payload is required (and only present) when `state` is `'ready'`, so a\n * missing payload can't be silently rendered as an empty plan.\n */\nexport type UsageViewProps =\n  | (UsageViewCommonProps & { state: Exclude<UsageViewState, 'ready'>; data?: undefined })\n  | (UsageViewCommonProps & { state: 'ready'; data: GetProfileUsageResponse });\n\ntype TFunction = (key: string, options?: Record<string, unknown>) => string;\n\n/**\n * Whether a usage row falls under a limit. Subtype segments are matched positionally against\n * `subtypePattern` where `*` matches any segment.\n */\nconst usageMatchesLimit = (item: MeteringUsageItem, limit: MeteringLimit): boolean => {\n  if (item.eventType !== limit.eventType || item.valueKey !== limit.valueKey) {\n    return false;\n  }\n  return limit.subtypePattern.every((pattern, index) => pattern === '*' || pattern === item.subtypePattern[index]);\n};\n\n/** Sum every usage item that falls under the limit. */\nconst sumUsageForLimit = (usage: GetProfileUsageResponse['usage'], limit: MeteringLimit): number =>\n  usage.reduce((total, item) => (usageMatchesLimit(item, limit) ? total + item.amount : total), 0);\n\n/** Humanize a camelCase value key, e.g. `outputTokens` → `output tokens`. */\nconst formatValueKey = (valueKey: string): string =>\n  valueKey\n    .replace(/([A-Z])/g, ' $1')\n    .trim()\n    .toLowerCase();\n\n/**\n * Human label for a limit: a scope followed by the value key, e.g.\n * `{ eventType: 'ai', valueKey: 'outputTokens', subtypePattern: ['*'] }` → `All models · output tokens`,\n * `{ eventType: 'ai', valueKey: 'inputTokens', subtypePattern: ['claude-opus-4'] }` → `claude-opus-4 · input tokens`.\n */\nconst formatLimitLabel = (limit: MeteringLimit, t: TFunction): string => {\n  const metric = formatValueKey(limit.valueKey);\n  const subtype = limit.subtypePattern.filter((segment) => segment && segment !== '*').join('/');\n  if (limit.eventType === 'ai') {\n    return `${subtype || t('usage-all-models.label')} · ${metric}`;\n  }\n  return `${subtype ? `${limit.eventType}/${subtype}` : limit.eventType} · ${metric}`;\n};\n\nconst SECONDS_PER_HOUR = 60 * 60;\n\n/** Render `windowHours` as a localized \"N months / days / hours\" string. */\nconst formatWindow = (windowHours: number, t: TFunction): string => {\n  if (windowHours % (24 * 30) === 0) {\n    return t('usage-window-months.label', { count: windowHours / (24 * 30) });\n  }\n  if (windowHours % 24 === 0) {\n    return t('usage-window-days.label', { count: windowHours / 24 });\n  }\n  return t('usage-window-hours.label', { count: windowHours });\n};\n\ntype UsageRow = {\n  key: string;\n  /** Field label (schema `title` annotation). */\n  label: string;\n  /** Field caption (schema `description` annotation). */\n  caption: string;\n  /** Consumption as a whole percentage (`0`–`100`); `undefined` for an unlimited limit. */\n  percent?: number;\n  windowHours: number;\n};\n\n/** One display row per limit, shorter windows first. A `null` limit is reported as unlimited. */\nconst computeRows = (data: GetProfileUsageResponse, t: TFunction): UsageRow[] =>\n  data.limits\n    .map((limit): UsageRow => {\n      const used = sumUsageForLimit(data.usage, limit);\n      const label = formatLimitLabel(limit, t);\n      const windowHours = limit.windowDuration / SECONDS_PER_HOUR;\n      const window = formatWindow(windowHours, t);\n      const key = `${limit.eventType}/${limit.subtypePattern.join(',')}/${limit.valueKey}/${limit.windowDuration}/${limit.limit ?? 'unlimited'}`;\n      if (limit.limit === null) {\n        return {\n          key,\n          label,\n          caption: t('usage-unlimited.description', { used: used.toLocaleString(), window }),\n          windowHours,\n        };\n      }\n      const percent = limit.limit > 0 ? Math.min(100, Math.round((used / limit.limit) * 100)) : used > 0 ? 100 : 0;\n      return {\n        key,\n        label,\n        caption: `${t('usage-percent-used.label', { percent })} · ${t('usage-limit.description', { used: used.toLocaleString(), limit: limit.limit.toLocaleString(), window })}`,\n        percent,\n        windowHours,\n      };\n    })\n    .sort((left, right) => left.windowHours - right.windowHours);\n\n/**\n * A single usage field: an optional number carrying its label/caption as `title`/`description`\n * annotations and the consumption percentage as its value. Optional so the form renders no required\n * markers; `Schema.Number` keeps the field context-free (`R = never`) so the struct stays assignable to `Form`.\n */\nconst usageField = (title: string, description: string) =>\n  Schema.optional(Schema.Number.annotate({ title, description }));\n\n/**\n * Build the Effect schema (one annotated field per limit) and matching values. Unlimited limits have no\n * value, so their field reads `undefined` and the renderer shows the \"Unlimited\" label instead of a meter.\n */\nconst buildUsageForm = (rows: UsageRow[]) => {\n  const fields: Record<string, ReturnType<typeof usageField>> = {};\n  const values: Record<string, number> = {};\n  rows.forEach((row, index) => {\n    const field = `metric_${index}`;\n    fields[field] = usageField(row.label, row.caption);\n    if (row.percent !== undefined) {\n      values[field] = row.percent;\n    }\n  });\n  return { schema: Schema.Struct(fields), values };\n};\n\n/** Non-data states shown as a single `Message`, keyed by message variant (translation keys for the copy). */\nconst STATE_MESSAGES = {\n  unavailable: {\n    valence: 'warning',\n    icon: 'ph--cloud-slash--duotone',\n    title: 'usage-unavailable.title',\n    description: 'usage-unavailable.description',\n  },\n  error: {\n    valence: 'error',\n    icon: 'ph--cloud-x--duotone',\n    title: 'usage-offline.title',\n    description: 'usage-offline.description',\n  },\n  empty: {\n    valence: 'neutral',\n    icon: 'ph--chart-bar--duotone',\n    title: 'usage-empty.title',\n    description: 'usage-empty.description',\n  },\n} as const;\n\n/**\n * Presentational view of profile usage: renders loading/error/unavailable/empty states, or a\n * schema-driven settings form (one read-only field per limit), plus a refresh control and a\n * collapsible raw-response viewer. Pure — all data via props.\n */\nexport const UsageView = ({ state, data, lastUpdated, onRefresh }: UsageViewProps) => {\n  const { t } = Hooks.useTranslation(meta.profile.key);\n  const [rawExpanded, setRawExpanded] = useState(false);\n\n  const { schema, values, empty } = useMemo(() => {\n    const rows = data ? computeRows(data, t) : [];\n    return { ...buildUsageForm(rows), empty: rows.length === 0 };\n  }, [data, t]);\n\n  // Non-data states resolve to a `Message`; `loading` shows a spinner and `ready` with data shows the form.\n  const message =\n    state === 'unavailable'\n      ? STATE_MESSAGES.unavailable\n      : state === 'error'\n        ? STATE_MESSAGES.error\n        : state === 'ready' && empty\n          ? STATE_MESSAGES.empty\n          : undefined;\n\n  // Render each metric as a meter from its percentage value; unlimited limits (no value) show a label.\n  const meterFieldProvider = useCallback<FormFieldProvider>(\n    ({ fieldProps: { label, description, getValue } }) => {\n      const percent = getValue();\n      return (\n        <Form.Field standalone label={label} description={description}>\n          {typeof percent === 'number' ? (\n            <Status.Progress value={percent / 100} label={t('usage-percent-used.label', { percent })} />\n          ) : (\n            t('usage-unlimited.label')\n          )}\n        </Form.Field>\n      );\n    },\n    [t],\n  );\n\n  return (\n    <Form.Root variant='settings' layout='static' schema={schema} values={values}>\n      <Form.Viewport scroll>\n        <Form.Content>\n          <Form.FieldSet label={t('usage-section.title')} description={t('usage-section.description')}>\n            {message ? (\n              <Banner.Root valence={message.valence}>\n                <Banner.Title icon={message.icon}>{t(message.title)}</Banner.Title>\n                <Banner.Body>{t(message.description)}</Banner.Body>\n              </Banner.Root>\n            ) : (\n              <Form.Fields fieldProvider={meterFieldProvider} />\n            )}\n          </Form.FieldSet>\n\n          {/* {state === 'ready' && data && (\n            <Form.FieldSet>\n              <Form.Field standalone\n                label={\n                  lastUpdated !== undefined\n                    ? t('usage-last-updated.label', { time: new Date(lastUpdated).toLocaleTimeString() })\n                    : t('usage-refresh.label')\n                }\n              >\n                {onRefresh && (\n                  <IconButton\n                    iconOnly\n                    variant='ghost'\n                    icon='ph--arrow-clockwise--regular'\n                    label={t('usage-refresh.label')}\n                    onClick={onRefresh}\n                  />\n                )}\n              </Form.Field>\n            </Form.FieldSet>\n          )} */}\n\n          {/* {state === 'ready' && data && (\n            <Form.FieldSet>\n              <Form.Field standalone label={t('usage-raw-json.label')}>\n                <ToggleIconButton\n                  iconOnly\n                  variant='ghost'\n                  active={rawExpanded}\n                  icon='ph--caret-right--regular'\n                  label={t('usage-raw-json.label')}\n                  onClick={() => setRawExpanded((value) => !value)}\n                />\n              </Form.Field>\n              {rawExpanded && <JsonHighlighter data={data} testId='usage-raw-json' />}\n            </Form.FieldSet>\n          )} */}\n        </Form.Content>\n      </Form.Viewport>\n    </Form.Root>\n  );\n};\n\nUsageView.displayName = 'UsageView';\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useState } from 'react';\n\nimport { Context } from '@dxos/context';\nimport { log } from '@dxos/log';\nimport { type GetProfileUsageResponse } from '@dxos/protocols';\nimport * as Hooks from '@dxos/react-ui/Hooks';\n\nimport { useHubHttpClient } from '../../hooks/index.ts';\nimport { UsageView, type UsageViewState } from './UsageView.tsx';\n\n/** State + payload kept together so `ready` always carries data (mirrors the discriminated `UsageViewProps`). */\ntype UsageFetchState =\n  | {\n      state: Exclude<UsageViewState, 'ready'>;\n    }\n  | {\n      state: 'ready';\n      data: GetProfileUsageResponse;\n    };\n\n/**\n * Fetches rolling-window profile usage from the hub service and renders it.\n * Connected wrapper around the presentational {@link UsageView}.\n */\nexport const UsageContainer = () => {\n  const hubHttp = useHubHttpClient();\n  const [fetchState, setFetchState] = useState<UsageFetchState>({ state: 'loading' });\n  const [lastUpdated, setLastUpdated] = useState<number | undefined>();\n  const [refreshCount, setRefreshCount] = useState(0);\n\n  Hooks.useAsyncEffect(async () => {\n    if (!hubHttp) {\n      setFetchState({ state: 'unavailable' });\n      return;\n    }\n    // Keep prior data visible while refetching; only show the loading state on first load.\n    setFetchState((previous) => (previous.state === 'ready' ? previous : { state: 'loading' }));\n    try {\n      const result = await hubHttp.getProfileUsage(new Context());\n      setFetchState({ state: 'ready', data: result });\n      setLastUpdated(Date.now());\n    } catch (err) {\n      log.catch(err);\n      setFetchState({ state: 'error' });\n    }\n  }, [hubHttp, refreshCount]);\n\n  const handleRefresh = useCallback(() => setRefreshCount((count) => count + 1), []);\n\n  return <UsageView {...fetchState} lastUpdated={lastUpdated} onRefresh={handleRefresh} />;\n};\n\nUsageContainer.displayName = 'UsageContainer';\n"],"mappings":"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"}

package/dist/lib/chunk-account-cache.mjs

@@ -1,9 +1,9 @@
 import * as Capability from "@dxos/app-framework/Capability";
 import { AccountCache, ClientCapabilities } from "#types";
 import * as Effect from "effect/Effect";
-import { createKvsStore } from "@dxos/effect";
+import * as KvsStore from "@dxos/effect/KvsStore";
 //#region src/capabilities/account-cache.ts
-var account_cache_default = Capability.makeModule(() => Effect.succeed(Capability.contribute(ClientCapabilities.AccountCache, createKvsStore({
+var account_cache_default = Capability.makeModule(() => Effect.succeed(Capability.contribute(ClientCapabilities.AccountCache, KvsStore.make({
 	key: "composer.account",
 	schema: AccountCache.AccountCache,
 	defaultValue: () => ({})

package/dist/lib/chunk-account-cache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-account-cache.mjs","names":[],"sources":["../../src/capabilities/account-cache.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { createKvsStore } from '@dxos/effect';\n\nimport { AccountCache, ClientCapabilities } from '#types';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contribute(\n      ClientCapabilities.AccountCache,\n      createKvsStore<AccountCache.AccountCache>({\n        key: 'composer.account',\n        schema: AccountCache.AccountCache,\n        defaultValue: () => ({}),\n      }),\n    ),\n  ),\n);\n"],"mappings":";;;;;AAWA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,WACT,mBAAmB,cACnB,eAA0C;CACxC,KAAK;CACL,QAAQ,aAAa;CACrB,qBAAqB,CAAC;AACxB,CAAC,CACH,CACF,CACF"}
+{"version":3,"file":"chunk-account-cache.mjs","names":[],"sources":["../../src/capabilities/account-cache.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as KvsStore from '@dxos/effect/KvsStore';\n\nimport { AccountCache, ClientCapabilities } from '#types';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contribute(\n      ClientCapabilities.AccountCache,\n      KvsStore.make<AccountCache.AccountCache>({\n        key: 'composer.account',\n        schema: AccountCache.AccountCache,\n        defaultValue: () => ({}),\n      }),\n    ),\n  ),\n);\n"],"mappings":";;;;;AAWA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,WACT,mBAAmB,cACnB,SAAS,KAAgC;CACvC,KAAK;CACL,QAAQ,aAAa;CACrB,qBAAqB,CAAC;AACxB,CAAC,CACH,CACF,CACF"}

package/dist/lib/chunk-app-graph-builder.mjs

@@ -4,8 +4,8 @@ import { Account, ClientCapabilities } from "#types";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import { ClientOperation } from "#operations";
-import { meta } from "#meta";
 import { Identity } from "@dxos/halo";
+import { meta } from "#meta";
 import * as Operation from "@dxos/compute/Operation";
 import * as AppGraphBuilder from "@dxos/app-graph/AppGraphBuilder";
 import * as AppGraphNode from "@dxos/app-graph/AppGraphNode";
@@ -15,6 +15,7 @@ import * as GraphNodeMatcher from "@dxos/graph/GraphNodeMatcher";
 //#region src/capabilities/app-graph-builder.ts
 var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function* () {
 	const clientAtom = yield* Capability.atom(ClientCapabilities.Client);
+	const hasHub = (clients) => !!clients[0]?.config.values?.runtime?.app?.env?.DX_HUB_URL;
 	const identityServiceAtom = yield* Capability.atom(ClientCapabilities.IdentityService);
 	const extensions = yield* AppGraphBuilder.createExtension({
 		id: "root",
@@ -39,7 +40,7 @@ var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function
 			const [identityService] = get(identityServiceAtom);
 			const identity = identityService ? Option.getOrUndefined(get(Identity.atom(identityService))) : void 0;
 			const status = get(CreateAtom.fromObservable(client.mesh.networkStatus));
-			const hub = !!client.config.values?.runtime?.app?.env?.DX_HUB_URL;
+			hasHub([client]);
 			return [AppGraphNode.make({
 				id: Account.id,
 				type: meta.profile.key,
@@ -52,67 +53,165 @@ var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function
 					hue: identity?.data?.hue,
 					emoji: identity?.data?.emoji,
 					status: status.swarm === ConnectionState.OFFLINE ? "error" : "active"
-				},
-				nodes: [
-					AppGraphNode.make({
-						id: Account.Profile,
-						data: Account.Profile,
-						type: meta.profile.key,
-						properties: {
-							label: ["profile.label", { ns: meta.profile.key }],
-							icon: "ph--user--regular"
-						}
-					}),
-					...hub ? [AppGraphNode.make({
-						id: Account.Account,
-						data: Account.Account,
-						type: meta.profile.key,
-						properties: {
-							label: ["account-panel.label", { ns: meta.profile.key }],
-							icon: "ph--identification-card--regular"
-						}
-					})] : [],
-					AppGraphNode.make({
-						id: Account.Security,
-						data: Account.Security,
-						type: meta.profile.key,
-						properties: {
-							label: ["security.label", { ns: meta.profile.key }],
-							icon: "ph--key--regular"
-						}
-					}),
-					AppGraphNode.make({
-						id: Account.Devices,
-						data: Account.Devices,
-						type: meta.profile.key,
-						properties: {
-							label: ["devices.label", { ns: meta.profile.key }],
-							icon: "ph--devices--regular",
-							testId: "clientPlugin.devices"
-						}
-					}),
-					...hub ? [AppGraphNode.make({
-						id: Account.Invitations,
-						data: Account.Invitations,
-						type: meta.profile.key,
-						properties: {
-							label: ["invitations-panel.label", { ns: meta.profile.key }],
-							icon: "ph--ticket--regular"
-						}
-					}), AppGraphNode.make({
-						id: Account.Usage,
-						data: Account.Usage,
-						type: meta.profile.key,
-						properties: {
-							label: ["usage-panel.label", { ns: meta.profile.key }],
-							icon: "ph--chart-bar--regular"
-						}
-					})] : []
-				]
+				}
+			})];
+		}).pipe(Effect.orDie)
+	});
+	const accountProfile = yield* AppGraphBuilder.createExtension({
+		id: "accountProfile",
+		url: {
+			key: Account.Profile,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: (_node, get) => Effect.gen(function* () {
+			return [AppGraphNode.make({
+				id: Account.Profile,
+				data: Account.path(Account.Profile),
+				type: meta.profile.key,
+				properties: {
+					label: ["profile.label", { ns: meta.profile.key }],
+					icon: "ph--user--regular",
+					testId: "clientPlugin.profile"
+				}
+			})];
+		}).pipe(Effect.orDie)
+	});
+	const accountAccount = yield* AppGraphBuilder.createExtension({
+		id: "accountAccount",
+		url: {
+			key: Account.Account,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: (_node, get) => Effect.gen(function* () {
+			if (!hasHub(get(clientAtom))) return [];
+			return [AppGraphNode.make({
+				id: Account.Account,
+				data: Account.path(Account.Account),
+				type: meta.profile.key,
+				properties: {
+					label: ["account-panel.label", { ns: meta.profile.key }],
+					icon: "ph--identification-card--regular"
+				}
+			})];
+		}).pipe(Effect.orDie)
+	});
+	const accountSecurity = yield* AppGraphBuilder.createExtension({
+		id: "accountSecurity",
+		url: {
+			key: Account.Security,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: (_node, get) => Effect.gen(function* () {
+			return [AppGraphNode.make({
+				id: Account.Security,
+				data: Account.path(Account.Security),
+				type: meta.profile.key,
+				properties: {
+					label: ["security.label", { ns: meta.profile.key }],
+					icon: "ph--key--regular",
+					testId: "clientPlugin.security"
+				}
+			})];
+		}).pipe(Effect.orDie)
+	});
+	const accountDevices = yield* AppGraphBuilder.createExtension({
+		id: "accountDevices",
+		url: {
+			key: Account.Devices,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: (_node, get) => Effect.gen(function* () {
+			return [AppGraphNode.make({
+				id: Account.Devices,
+				data: Account.path(Account.Devices),
+				type: meta.profile.key,
+				properties: {
+					label: ["devices.label", { ns: meta.profile.key }],
+					icon: "ph--devices--regular",
+					testId: "clientPlugin.devices"
+				}
+			})];
+		}).pipe(Effect.orDie)
+	});
+	const accountContacts = yield* AppGraphBuilder.createExtension({
+		id: "accountContacts",
+		url: {
+			key: Account.Contacts,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: () => Effect.succeed([AppGraphNode.make({
+			id: Account.Contacts,
+			data: Account.path(Account.Contacts),
+			type: meta.profile.key,
+			properties: {
+				label: ["contacts.label", { ns: meta.profile.key }],
+				icon: "ph--address-book--regular",
+				testId: "clientPlugin.contacts"
+			}
+		})])
+	});
+	const accountInvitations = yield* AppGraphBuilder.createExtension({
+		id: "accountInvitations",
+		url: {
+			key: Account.Invitations,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: (_node, get) => Effect.gen(function* () {
+			if (!hasHub(get(clientAtom))) return [];
+			return [AppGraphNode.make({
+				id: Account.Invitations,
+				data: Account.path(Account.Invitations),
+				type: meta.profile.key,
+				properties: {
+					label: ["invitations-panel.label", { ns: meta.profile.key }],
+					icon: "ph--ticket--regular"
+				}
+			})];
+		}).pipe(Effect.orDie)
+	});
+	const accountUsage = yield* AppGraphBuilder.createExtension({
+		id: "accountUsage",
+		url: {
+			key: Account.Usage,
+			kind: "singleton",
+			path: []
+		},
+		match: GraphNodeMatcher.whenId(Account.workspacePath),
+		connector: (_node, get) => Effect.gen(function* () {
+			if (!hasHub(get(clientAtom))) return [];
+			return [AppGraphNode.make({
+				id: Account.Usage,
+				data: Account.path(Account.Usage),
+				type: meta.profile.key,
+				properties: {
+					label: ["usage-panel.label", { ns: meta.profile.key }],
+					icon: "ph--chart-bar--regular"
+				}
 			})];
 		}).pipe(Effect.orDie)
 	});
-	return Capability.contribute(AppCapabilities.AppGraphBuilder, extensions);
+	return Capability.contribute(AppCapabilities.AppGraphBuilder, [
+		...extensions,
+		...accountProfile,
+		...accountAccount,
+		...accountSecurity,
+		...accountDevices,
+		...accountContacts,
+		...accountInvitations,
+		...accountUsage
+	]);
 }));
 //#endregion
 export { app_graph_builder_default as default };

package/dist/lib/chunk-app-graph-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-app-graph-builder.mjs","names":[],"sources":["../../src/capabilities/app-graph-builder.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';\nimport * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as CreateAtom from '@dxos/app-graph/CreateAtom';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport { ConnectionState } from '@dxos/client/mesh';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as GraphNodeMatcher from '@dxos/graph/GraphNodeMatcher';\nimport { Identity } from '@dxos/halo';\n\nimport { meta } from '#meta';\nimport { ClientOperation } from '#operations';\nimport { Account, ClientCapabilities } from '#types';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Read the client through its atom so the extension establishes a reactive dependency:\n    // the connector may evaluate before the client module finishes activating (dependency\n    // modules contribute individually, not batched per wave) and re-evaluates when it lands.\n    const clientAtom = yield* Capability.atom(ClientCapabilities.Client);\n    const identityServiceAtom = yield* Capability.atom(ClientCapabilities.IdentityService);\n    const extensions = yield* AppGraphBuilder.createExtension({\n      id: 'root',\n      match: GraphNodeMatcher.whenRoot,\n      actions: () =>\n        Effect.succeed([\n          {\n            id: 'openUserAccount',\n            data: () => Operation.invoke(ClientOperation.ShareIdentity),\n            properties: {\n              label: ['open-user-account.label', { ns: meta.profile.key }],\n              icon: 'ph--user--regular',\n              disposition: 'menu',\n              keyBinding: {\n                macos: 'meta+shift+.',\n                // TODO(wittjosiah): Test on windows to see if it behaves the same as linux.\n                windows: 'alt+shift+.',\n                linux: 'alt+shift+>',\n              },\n            },\n          },\n        ]),\n      connector: (node, get) =>\n        Effect.gen(function* () {\n          const [client] = get(clientAtom);\n          if (!client) {\n            return [];\n          }\n          const [identityService] = get(identityServiceAtom);\n          const identity = identityService ? Option.getOrUndefined(get(Identity.atom(identityService))) : undefined;\n          const status = get(CreateAtom.fromObservable(client.mesh.networkStatus));\n          // Account, invitations, and usage are all hub-service reads; without a hub URL there is\n          // no `HubHttpClient` capability and those panels render empty shells forever.\n          const hub = !!client.config.values?.runtime?.app?.env?.DX_HUB_URL;\n\n          return [\n            AppGraphNode.make({\n              id: Account.id,\n              type: meta.profile.key,\n              properties: {\n                label: ['account.label', { ns: meta.profile.key }],\n                icon: 'ph--user--regular',\n                disposition: 'user-account',\n                testId: 'clientPlugin.account',\n                // NOTE: This currently needs to be the identity key because the fallback is generated from hex.\n                userId: identity?.identityKey,\n                hue: identity?.data?.hue,\n                emoji: identity?.data?.emoji,\n                status: status.swarm === ConnectionState.OFFLINE ? 'error' : 'active',\n              },\n              nodes: [\n                AppGraphNode.make({\n                  id: Account.Profile,\n                  data: Account.Profile,\n                  type: meta.profile.key,\n                  properties: {\n                    label: ['profile.label', { ns: meta.profile.key }],\n                    icon: 'ph--user--regular',\n                  },\n                }),\n                ...(hub\n                  ? [\n                      AppGraphNode.make({\n                        id: Account.Account,\n                        data: Account.Account,\n                        type: meta.profile.key,\n                        properties: {\n                          label: ['account-panel.label', { ns: meta.profile.key }],\n                          icon: 'ph--identification-card--regular',\n                        },\n                      }),\n                    ]\n                  : []),\n                AppGraphNode.make({\n                  id: Account.Security,\n                  data: Account.Security,\n                  type: meta.profile.key,\n                  properties: {\n                    label: ['security.label', { ns: meta.profile.key }],\n                    icon: 'ph--key--regular',\n                  },\n                }),\n                AppGraphNode.make({\n                  id: Account.Devices,\n                  data: Account.Devices,\n                  type: meta.profile.key,\n                  properties: {\n                    label: ['devices.label', { ns: meta.profile.key }],\n                    icon: 'ph--devices--regular',\n                    testId: 'clientPlugin.devices',\n                  },\n                }),\n                ...(hub\n                  ? [\n                      AppGraphNode.make({\n                        id: Account.Invitations,\n                        data: Account.Invitations,\n                        type: meta.profile.key,\n                        properties: {\n                          label: ['invitations-panel.label', { ns: meta.profile.key }],\n                          icon: 'ph--ticket--regular',\n                        },\n                      }),\n                      AppGraphNode.make({\n                        id: Account.Usage,\n                        data: Account.Usage,\n                        type: meta.profile.key,\n                        properties: {\n                          label: ['usage-panel.label', { ns: meta.profile.key }],\n                          icon: 'ph--chart-bar--regular',\n                        },\n                      }),\n                    ]\n                  : []),\n              ],\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    return Capability.contribute(AppCapabilities.AppGraphBuilder, extensions);\n  }),\n);\n"],"mappings":"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"}
+{"version":3,"file":"chunk-app-graph-builder.mjs","names":[],"sources":["../../src/capabilities/app-graph-builder.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';\nimport * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as CreateAtom from '@dxos/app-graph/CreateAtom';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport { type Client } from '@dxos/client';\nimport { ConnectionState } from '@dxos/client/mesh';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as GraphNodeMatcher from '@dxos/graph/GraphNodeMatcher';\nimport { Identity } from '@dxos/halo';\n\nimport { meta } from '#meta';\nimport { ClientOperation } from '#operations';\nimport { Account, ClientCapabilities } from '#types';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Read the client through its atom so the extension establishes a reactive dependency:\n    // the connector may evaluate before the client module finishes activating (dependency\n    // modules contribute individually, not batched per wave) and re-evaluates when it lands.\n    const clientAtom = yield* Capability.atom(ClientCapabilities.Client);\n    // Panels backed by hub services render an empty shell without one, so they contribute no node.\n    const hasHub = (clients: readonly Client[]): boolean => !!clients[0]?.config.values?.runtime?.app?.env?.DX_HUB_URL;\n    const identityServiceAtom = yield* Capability.atom(ClientCapabilities.IdentityService);\n    const extensions = yield* AppGraphBuilder.createExtension({\n      id: 'root',\n      match: GraphNodeMatcher.whenRoot,\n      actions: () =>\n        Effect.succeed([\n          {\n            id: 'openUserAccount',\n            data: () => Operation.invoke(ClientOperation.ShareIdentity),\n            properties: {\n              label: ['open-user-account.label', { ns: meta.profile.key }],\n              icon: 'ph--user--regular',\n              disposition: 'menu',\n              keyBinding: {\n                macos: 'meta+shift+.',\n                // TODO(wittjosiah): Test on windows to see if it behaves the same as linux.\n                windows: 'alt+shift+.',\n                linux: 'alt+shift+>',\n              },\n            },\n          },\n        ]),\n      connector: (node, get) =>\n        Effect.gen(function* () {\n          const [client] = get(clientAtom);\n          if (!client) {\n            return [];\n          }\n          const [identityService] = get(identityServiceAtom);\n          const identity = identityService ? Option.getOrUndefined(get(Identity.atom(identityService))) : undefined;\n          const status = get(CreateAtom.fromObservable(client.mesh.networkStatus));\n          const hub = hasHub([client]);\n\n          return [\n            AppGraphNode.make({\n              id: Account.id,\n              type: meta.profile.key,\n              properties: {\n                label: ['account.label', { ns: meta.profile.key }],\n                icon: 'ph--user--regular',\n                disposition: 'user-account',\n                testId: 'clientPlugin.account',\n                // NOTE: This currently needs to be the identity key because the fallback is generated from hex.\n                userId: identity?.identityKey,\n                hue: identity?.data?.hue,\n                emoji: identity?.data?.emoji,\n                status: status.swarm === ConnectionState.OFFLINE ? 'error' : 'active',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    const accountProfile = yield* AppGraphBuilder.createExtension({\n      id: 'accountProfile',\n      url: { key: Account.Profile, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: (_node, get) =>\n        Effect.gen(function* () {\n          return [\n            AppGraphNode.make({\n              id: Account.Profile,\n              data: Account.path(Account.Profile),\n              type: meta.profile.key,\n              properties: {\n                label: ['profile.label', { ns: meta.profile.key }],\n                icon: 'ph--user--regular',\n                testId: 'clientPlugin.profile',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    const accountAccount = yield* AppGraphBuilder.createExtension({\n      id: 'accountAccount',\n      url: { key: Account.Account, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: (_node, get) =>\n        Effect.gen(function* () {\n          if (!hasHub(get(clientAtom))) {\n            return [];\n          }\n          return [\n            AppGraphNode.make({\n              id: Account.Account,\n              data: Account.path(Account.Account),\n              type: meta.profile.key,\n              properties: {\n                label: ['account-panel.label', { ns: meta.profile.key }],\n                icon: 'ph--identification-card--regular',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    const accountSecurity = yield* AppGraphBuilder.createExtension({\n      id: 'accountSecurity',\n      url: { key: Account.Security, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: (_node, get) =>\n        Effect.gen(function* () {\n          return [\n            AppGraphNode.make({\n              id: Account.Security,\n              data: Account.path(Account.Security),\n              type: meta.profile.key,\n              properties: {\n                label: ['security.label', { ns: meta.profile.key }],\n                icon: 'ph--key--regular',\n                testId: 'clientPlugin.security',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    const accountDevices = yield* AppGraphBuilder.createExtension({\n      id: 'accountDevices',\n      url: { key: Account.Devices, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: (_node, get) =>\n        Effect.gen(function* () {\n          return [\n            AppGraphNode.make({\n              id: Account.Devices,\n              data: Account.path(Account.Devices),\n              type: meta.profile.key,\n              properties: {\n                label: ['devices.label', { ns: meta.profile.key }],\n                icon: 'ph--devices--regular',\n                testId: 'clientPlugin.devices',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    const accountContacts = yield* AppGraphBuilder.createExtension({\n      id: 'accountContacts',\n      url: { key: Account.Contacts, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: () =>\n        Effect.succeed([\n          AppGraphNode.make({\n            id: Account.Contacts,\n            data: Account.path(Account.Contacts),\n            type: meta.profile.key,\n            properties: {\n              label: ['contacts.label', { ns: meta.profile.key }],\n              icon: 'ph--address-book--regular',\n              testId: 'clientPlugin.contacts',\n            },\n          }),\n        ]),\n    });\n\n    const accountInvitations = yield* AppGraphBuilder.createExtension({\n      id: 'accountInvitations',\n      url: { key: Account.Invitations, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: (_node, get) =>\n        Effect.gen(function* () {\n          if (!hasHub(get(clientAtom))) {\n            return [];\n          }\n          return [\n            AppGraphNode.make({\n              id: Account.Invitations,\n              data: Account.path(Account.Invitations),\n              type: meta.profile.key,\n              properties: {\n                label: ['invitations-panel.label', { ns: meta.profile.key }],\n                icon: 'ph--ticket--regular',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    const accountUsage = yield* AppGraphBuilder.createExtension({\n      id: 'accountUsage',\n      url: { key: Account.Usage, kind: 'singleton', path: [] },\n      match: GraphNodeMatcher.whenId(Account.workspacePath),\n      connector: (_node, get) =>\n        Effect.gen(function* () {\n          if (!hasHub(get(clientAtom))) {\n            return [];\n          }\n          return [\n            AppGraphNode.make({\n              id: Account.Usage,\n              data: Account.path(Account.Usage),\n              type: meta.profile.key,\n              properties: {\n                label: ['usage-panel.label', { ns: meta.profile.key }],\n                icon: 'ph--chart-bar--regular',\n              },\n            }),\n          ];\n        }).pipe(Effect.orDie),\n    });\n\n    return Capability.contribute(AppCapabilities.AppGraphBuilder, [\n      ...extensions,\n      ...accountProfile,\n      ...accountAccount,\n      ...accountSecurity,\n      ...accountDevices,\n      ...accountContacts,\n      ...accountInvitations,\n      ...accountUsage,\n    ]);\n  }),\n);\n"],"mappings":"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"}

package/dist/lib/chunk-client-services.mjs

@@ -0,0 +1,21 @@
+import * as Capability from "@dxos/app-framework/Capability";
+import { ClientCapabilities } from "#types";
+import * as Effect from "effect/Effect";
+//#region src/capabilities/client-services.ts
+/**
+* Exposes the pieces of the client that plugins read directly — config, the EDGE HTTP client and
+* the ECHO graph — as capabilities, so those plugins need not depend on `@dxos/client`.
+*/
+var client_services_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	const client = yield* ClientCapabilities.Client;
+	const edgeUrl = client.config.get("runtime.services.edge.url");
+	return [
+		Capability.contribute(ClientCapabilities.Config, client.config),
+		Capability.contribute(ClientCapabilities.Hypergraph, client.graph),
+		...edgeUrl ? [Capability.contribute(ClientCapabilities.EdgeHttpClient, client.edge.http)] : []
+	];
+}));
+//#endregion
+export { client_services_default as default };
+
+//# sourceMappingURL=chunk-client-services.mjs.map

package/dist/lib/chunk-client-services.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-client-services.mjs","names":[],"sources":["../../src/capabilities/client-services.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\n\nimport { ClientCapabilities } from '#types';\n\n/**\n * Exposes the pieces of the client that plugins read directly — config, the EDGE HTTP client and\n * the ECHO graph — as capabilities, so those plugins need not depend on `@dxos/client`.\n */\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const client = yield* ClientCapabilities.Client;\n    const edgeUrl = client.config.get('runtime.services.edge.url');\n    return [\n      Capability.contribute(ClientCapabilities.Config, client.config),\n      Capability.contribute(ClientCapabilities.Hypergraph, client.graph),\n      ...(edgeUrl ? [Capability.contribute(ClientCapabilities.EdgeHttpClient, client.edge.http)] : []),\n    ];\n  }),\n);\n"],"mappings":";;;;;;;;AAcA,IAAA,0BAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,MAAM,SAAS,OAAO,mBAAmB;CACzC,MAAM,UAAU,OAAO,OAAO,IAAI,2BAA2B;CAC7D,OAAO;EACL,WAAW,WAAW,mBAAmB,QAAQ,OAAO,MAAM;EAC9D,WAAW,WAAW,mBAAmB,YAAY,OAAO,KAAK;EACjE,GAAI,UAAU,CAAC,WAAW,WAAW,mBAAmB,gBAAgB,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC;CAChG;AACF,CAAC,CACH"}

package/dist/lib/chunk-client.mjs

@@ -2,24 +2,27 @@ import * as Capabilities from "@dxos/app-framework/Capabilities";
 import * as Capability from "@dxos/app-framework/Capability";
 import { ClientCapabilities, ClientEvents } from "#types";
 import * as Effect from "effect/Effect";
-import { Client, ClientService } from "@dxos/client";
+import { Client, ClientService, fromClient } from "@dxos/client";
+import { BaseError } from "@dxos/errors";
 import * as Plugin from "@dxos/app-framework/Plugin";
 import { INITIALIZE_TIMEOUT } from "@dxos/client-protocol";
 import * as Cause from "effect/Cause";
 import { log } from "@dxos/log";
 import * as Layer from "effect/Layer";
-import { EffectEx } from "@dxos/effect";
 import * as Exit from "effect/Exit";
+import * as EffectEx from "@dxos/effect/EffectEx";
 import { makeIdentityService, makeSpaceService } from "@dxos/halo-adapter-client";
 //#region src/capabilities/client.ts
 var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-client/src/capabilities/client.ts";
-var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client: hostClient, onClientInitialized, onClientInitializationError, onSpacesReady, initializeTimeout = INITIALIZE_TIMEOUT, awaitInitialization = false, ...options }) {
+/** The client did not finish initializing inside the configured timeout. */
+var ClientInitError = class extends BaseError.extend("ClientInitError", "Client failed to initialize.") {};
+var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client: hostClient, onClientInitialized, onClientInitializationError, onSpacesAvailable, initializeTimeout = INITIALIZE_TIMEOUT, awaitInitialization = false, ...options }) {
 	const capabilityManager = yield* Capability.Service;
 	const pluginManager = yield* Plugin.Service;
 	log(hostClient ? "adopting host client" : "creating client", void 0, {
 		"~LogMeta": "~LogMeta",
 		F: __dxlog_file,
-		L: 39,
+		L: 43,
 		S: this
 	});
 	const client = hostClient ?? new Client(options);
@@ -27,7 +30,7 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 	log("initializing client (forked)...", void 0, {
 		"~LogMeta": "~LogMeta",
 		F: __dxlog_file,
-		L: 45,
+		L: 49,
 		S: this
 	});
 	let subscription;
@@ -35,14 +38,14 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 		log.info("client capability: destroying client", void 0, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 54,
+			L: 58,
 			S: this
 		});
 		subscription?.unsubscribe();
 		yield* Effect.tryPromise(() => client.destroy()).pipe(Effect.catch((error) => Effect.sync(() => log.warn("client destroy failed", { error: String(error) }, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 58,
+			L: 62,
 			S: this
 		}))));
 	}));
@@ -52,7 +55,7 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 		log("client.initialize() returned successfully", void 0, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 73,
+			L: 77,
 			S: this
 		});
 		if (onClientInitialized) yield* onClientInitialized({ client });
@@ -60,7 +63,7 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 		log("called client initialized callback", void 0, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 78,
+			L: 82,
 			S: this
 		});
 		yield* Plugin.activate(ClientEvents.Initialized);
@@ -73,20 +76,20 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 			log.info("client reconnected, reloading to re-establish session", void 0, {
 				"~LogMeta": "~LogMeta",
 				F: __dxlog_file,
-				L: 104,
+				L: 108,
 				S: this
 			});
 			if (client.resetting) window.location.href = window.location.origin;
 			else window.location.reload();
 		});
-		let spacesReadyFired = false;
+		let spacesAvailableFired = false;
 		subscription = client.spaces.subscribe(async () => {
-			if (!spacesReadyFired) {
-				spacesReadyFired = true;
+			if (!spacesAvailableFired) {
+				spacesAvailableFired = true;
 				performance.mark("milestone:spaces-ready");
 				const exit = await Effect.gen(function* () {
-					yield* Plugin.activate(ClientEvents.SpacesReady);
-					if (onSpacesReady) yield* onSpacesReady({ client });
+					yield* Plugin.activate(ClientEvents.SpacesAvailable);
+					if (onSpacesAvailable) yield* onSpacesAvailable({ client });
 				}).pipe(Effect.provideService(Capability.Service, capabilityManager), Effect.provideService(Plugin.Service, pluginManager), Effect.runPromiseExit);
 				if (Exit.isFailure(exit) && !Cause.hasInterruptsOnly(exit.cause)) EffectEx.throwCause(exit.cause);
 			}
@@ -95,7 +98,7 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 		log.error("client initialization failed", { error: String(error) }, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 141,
+			L: 145,
 			S: this
 		});
 		if (onClientInitializationError) yield* onClientInitializationError({ error });
@@ -103,21 +106,25 @@ var client_default = Capability.makeModule(Effect.fnUntraced(function* ({ client
 	log("client capability ready (initialization in flight)", void 0, {
 		"~LogMeta": "~LogMeta",
 		F: __dxlog_file,
-		L: 155,
+		L: 159,
 		S: this
 	});
 	const clientServiceLayer = awaitInitialization ? Layer.effect(ClientService, Effect.tryPromise({
 		try: () => client.waitUntilInitialized({ timeout: initializeTimeout }),
-		catch: (error) => /* @__PURE__ */ new Error(`Client failed to initialize within ${initializeTimeout}ms: ${String(error)}`)
-	}).pipe(Effect.as(client))) : ClientService.fromClient(client);
+		catch: (error) => new ClientInitError({
+			context: { initializeTimeout },
+			cause: error
+		})
+	}).pipe(Effect.as(client))) : fromClient(client);
 	return [
 		Capability.contribute(ClientCapabilities.Client, client),
+		Capability.contribute(ClientCapabilities.InitializeTimeout, initializeTimeout),
 		Capability.contribute(Capabilities.Layer, clientServiceLayer),
 		Capability.contribute(ClientCapabilities.IdentityService, makeIdentityService(client)),
 		Capability.contribute(ClientCapabilities.SpaceService, makeSpaceService(client))
 	];
 }));
 //#endregion
-export { client_default as default };
+export { ClientInitError, client_default as default };
 
 //# sourceMappingURL=chunk-client.mjs.map