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

package/dx.config.ts

@@ -0,0 +1,33 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Config2 } from '@dxos/app-framework/config';
+import { trim } from '@dxos/util';
+
+export default Config2.make({
+  plugin: {
+    key: 'org.dxos.plugin.thread',
+    name: 'Threads',
+    author: 'DXOS',
+    description: trim`
+      ThreadPlugin provides chat: channels backed by an ECHO feed and free-standing
+      message threads. It renders the channel article and companion surfaces plus a
+      thread surface, and contributes the operations that create a default channel on
+      space creation, create new channels, and append messages.
+
+      Channel messages are stored in the channel's feed queue and rendered newest-last
+      with a pinned composer; externally-synced channels (carrying foreign-key
+      metadata, e.g. Slack/Discord-sourced rooms) render read-only because there is no
+      local-write path back to the source. Free-standing threads render their messages
+      and append by pushing onto the thread's message list.
+
+      The shared message and thread UI comes from @dxos/react-ui-thread; the Channel,
+      Message, and Thread schema come from @dxos/types. Document comments and the
+      comment-thread AI agent live in the @dxos/plugin-comments plugin.
+    `,
+    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-thread',
+    icon: { key: 'ph--video-conference--regular', hue: 'rose' },
+    spec: 'PLUGIN.mdl',
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-thread",
-  "version": "0.9.0",
+  "version": "0.9.1-staging.ee54ba693a",
   "description": "DXOS Threads Surface plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -91,48 +91,54 @@
   "types": "dist/types/src/index.d.ts",
   "files": [
     "dist",
+    "dx.config.ts",
     "src",
     "PLUGIN.mdl"
   ],
   "dependencies": {
-    "@dxos/app-framework": "0.9.0",
-    "@dxos/app-toolkit": "0.9.0",
-    "@dxos/client": "0.9.0",
-    "@dxos/compute": "0.9.0",
-    "@dxos/display-name": "0.9.0",
-    "@dxos/invariant": "0.9.0",
-    "@dxos/echo": "0.9.0",
-    "@dxos/keys": "0.9.0",
-    "@dxos/client-protocol": "0.9.0",
-    "@dxos/plugin-client": "0.9.0",
-    "@dxos/plugin-graph": "0.9.0",
-    "@dxos/plugin-space": "0.9.0",
-    "@dxos/random": "0.9.0",
-    "@dxos/react-ui-thread": "0.9.0",
-    "@dxos/echo-client": "0.9.0",
-    "@dxos/react-client": "0.9.0",
-    "@dxos/types": "0.9.0",
-    "@dxos/util": "0.9.0"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@dxos/app-toolkit": "0.9.1-staging.ee54ba693a",
+    "@dxos/app-framework": "0.9.1-staging.ee54ba693a",
+    "@dxos/client-protocol": "0.9.1-staging.ee54ba693a",
+    "@dxos/client": "0.9.1-staging.ee54ba693a",
+    "@dxos/display-name": "0.9.1-staging.ee54ba693a",
+    "@dxos/echo": "0.9.1-staging.ee54ba693a",
+    "@dxos/compute": "0.9.1-staging.ee54ba693a",
+    "@dxos/invariant": "0.9.1-staging.ee54ba693a",
+    "@dxos/echo-client": "0.9.1-staging.ee54ba693a",
+    "@dxos/keys": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-client": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-graph": "0.9.1-staging.ee54ba693a",
+    "@dxos/random": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-space": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-client": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-thread": "0.9.1-staging.ee54ba693a",
+    "@dxos/types": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-calls": "0.9.1-staging.ee54ba693a",
+    "@dxos/util": "0.9.1-staging.ee54ba693a"
   },
   "devDependencies": {
-    "@types/react": "~19.2.7",
+    "@types/react": "~19.2.17",
     "@types/react-dom": "~19.2.3",
-    "effect": "3.21.3",
-    "react": "~19.2.3",
-    "react-dom": "~19.2.3",
+    "effect": "3.21.4",
+    "react": "~19.2.7",
+    "react-dom": "~19.2.7",
     "vite": "^8.0.16",
-    "@dxos/react-ui": "0.9.0",
-    "@dxos/react-ui-form": "0.9.0",
-    "@dxos/plugin-testing": "0.9.0",
-    "@dxos/ui-theme": "0.9.0"
+    "@dxos/plugin-testing": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-menu": "0.9.1-staging.ee54ba693a",
+    "@dxos/ui-theme": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-form": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui": "0.9.1-staging.ee54ba693a"
   },
   "peerDependencies": {
-    "effect": "3.21.3",
-    "react": "~19.2.3",
-    "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.9.0",
-    "@dxos/ui-theme": "0.9.0",
-    "@dxos/react-ui-form": "0.9.0"
+    "@effect-atom/atom-react": "^0.5.0",
+    "effect": "3.21.4",
+    "react": "~19.2.7",
+    "react-dom": "~19.2.7",
+    "@dxos/react-ui": "0.9.1-staging.ee54ba693a",
+    "@dxos/ui-theme": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-menu": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-form": "0.9.1-staging.ee54ba693a"
   },
   "publishConfig": {
     "access": "public"

package/src/ThreadPlugin.test.ts

@@ -11,7 +11,7 @@ import { ThreadPlugin } from '#plugin';
 
 import { meta } from './meta';
 
-const moduleId = (name: string) => `${meta.id}.module.${name}`;
+const moduleId = (name: string) => `${meta.profile.key}.module.${name}`;
 
 describe('ThreadPlugin', () => {
   test('modules activate on the expected events', async ({ expect }) => {

package/src/ThreadPlugin.tsx

@@ -4,6 +4,7 @@
 
 import { ActivationEvents, Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
+import { ClientEvents } from '@dxos/plugin-client';
 import { translations as threadTranslations } from '@dxos/react-ui-thread/translations';
 import { Channel, Message, Thread } from '@dxos/types';
 
@@ -25,7 +26,7 @@ import pluginSpec from '../PLUGIN.mdl?raw';
 
 export const ThreadPlugin = Plugin.define(meta).pipe(
   AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
-  AppPlugin.addNavigationResolverModule({ activate: NavigationResolver }),
+  AppPlugin.addNavigationResolverModule({ activatesOn: ClientEvents.ClientReady, activate: NavigationResolver }),
   AppPlugin.addCreateObjectModule({ activate: CreateObject }),
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   AppPlugin.addSchemaModule({
@@ -41,7 +42,7 @@ export const ThreadPlugin = Plugin.define(meta).pipe(
     activate: ChannelBackendFeed,
   }),
   AppPlugin.addPluginAssetModule({
-    asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
+    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
   }),
   Plugin.make,
 );

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

@@ -3,46 +3,62 @@
 //
 
 import * as Effect from 'effect/Effect';
-import * as Option from 'effect/Option';
 
 import { Capability } from '@dxos/app-framework';
-import { AppCapabilities, createTypeSectionExtension } from '@dxos/app-toolkit';
-import { isSpace } from '@dxos/client/echo';
+import { AppCapabilities, AppNode, AppNodeMatcher, Paths, TypeSection } from '@dxos/app-toolkit';
 import { Operation } from '@dxos/compute';
-import { Type } from '@dxos/echo';
-import { GraphBuilder, Node } from '@dxos/plugin-graph';
+import { Obj, Type } from '@dxos/echo';
+import { CallsCapabilities } from '@dxos/plugin-calls/types';
+import { GraphBuilder } from '@dxos/plugin-graph';
 import { SpaceOperation } from '@dxos/plugin-space';
 import { Channel } from '@dxos/types';
+import { Position } from '@dxos/util';
+
+import { meta } from '#meta';
+
+import { getChannelsPath } from '../paths';
 
 const channelTypename = Type.getTypename(Channel.Channel);
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+
     const extensions = yield* Effect.all([
-      createTypeSectionExtension(Channel.Channel),
+      TypeSection.createTypeSectionExtension(Channel.Channel, {
+        match: AppNodeMatcher.whenNavTreeGroup(Paths.GroupTypes.communications),
+        createObject: (space) =>
+          Operation.invoke(SpaceOperation.OpenCreateObject, {
+            target: space.db,
+            typename: channelTypename,
+            targetNodeId: getChannelsPath(space.db.spaceId),
+          }),
+      }),
 
-      GraphBuilder.createExtension({
-        id: 'channelsSectionActions',
-        match: (node) => {
-          const space = isSpace(node.properties.space) ? node.properties.space : undefined;
-          return node.type === channelTypename && space ? Option.some(space) : Option.none();
-        },
-        actions: (space) =>
-          Effect.succeed([
-            Node.makeAction({
-              id: 'create-channel',
-              data: () =>
-                Operation.invoke(SpaceOperation.OpenCreateObject, {
-                  target: space.db,
-                  typename: channelTypename,
-                }),
-              properties: {
-                label: ['add-object.label', { ns: channelTypename }],
-                icon: 'ph--plus--regular',
-                disposition: 'list-item-primary',
-              },
+      GraphBuilder.createTypeExtension({
+        id: 'channelChatCompanion',
+        type: Channel.Channel,
+        connector: (channel, get) => {
+          const [callManager] = get(capabilities.atom(CallsCapabilities.Manager));
+          if (!callManager) {
+            return Effect.succeed([]);
+          }
+          const joined = get(callManager.joinedAtom);
+          const roomId = get(callManager.roomIdAtom);
+          if (!joined || roomId !== Obj.getURI(channel)) {
+            return Effect.succeed([]);
+          }
+
+          return Effect.succeed([
+            AppNode.makeCompanion({
+              id: 'chat',
+              label: ['channel-companion.label', { ns: meta.profile.key }],
+              icon: 'ph--hash--regular',
+              data: 'chat',
+              position: Position.first,
             }),
-          ]),
+          ]);
+        },
       }),
     ]);
 

package/src/capabilities/channel-backend-feed.ts

@@ -6,8 +6,7 @@ import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
 
 import { Capability } from '@dxos/app-framework';
-import { Feed, Filter, Obj, Query } from '@dxos/echo';
-import { createFeedServiceLayer } from '@dxos/echo-client';
+import { Database, Feed, Filter, Obj, Query } from '@dxos/echo';
 import { invariant } from '@dxos/invariant';
 import { ClientCapabilities } from '@dxos/plugin-client';
 import { Channel, Message } from '@dxos/types';
@@ -45,7 +44,7 @@ export const feedChannelBackend: ThreadCapabilities.ChannelBackendProvider = {
       invariant(space, 'Space not found');
       const feed = Channel.getFeed(channel);
       invariant(feed, 'Channel is not feed-backed');
-      yield* Feed.append(feed, [message]).pipe(Effect.provide(createFeedServiceLayer(space.queues)));
+      yield* Feed.append(feed, [message]).pipe(Effect.provide(Database.layer(space.db)));
     }),
   readOnly: (channel) => Obj.getMeta(channel).keys.length > 0,
 };

package/src/capabilities/create-object.ts

@@ -37,7 +37,6 @@ export default Capability.makeModule(
           return yield* Operation.invoke(SpaceOperation.AddObject, {
             object,
             target: opts.target,
-            hidden: true,
             targetNodeId: opts.targetNodeId ?? getChannelsPath(opts.db.spaceId),
           });
         }),

package/src/capabilities/navigation-resolver.ts

@@ -5,14 +5,16 @@
 import * as Effect from 'effect/Effect';
 
 import { Capability } from '@dxos/app-framework';
-import { AppCapabilities, createTypeSectionPathResolver } from '@dxos/app-toolkit';
+import { AppCapabilities, Paths, TypeSection } from '@dxos/app-toolkit';
 import { Channel } from '@dxos/types';
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
-    return Capability.contributes(
-      AppCapabilities.NavigationPathResolver,
-      createTypeSectionPathResolver(Channel.Channel),
-    );
+    return [
+      Capability.contributes(
+        AppCapabilities.NavigationPathResolver,
+        TypeSection.createTypeSectionPathResolver(Channel.Channel, { groupId: Paths.GroupSegments.communications }),
+      ),
+    ];
   }),
 );

package/src/capabilities/react-surface.tsx

@@ -29,7 +29,7 @@ export default Capability.makeModule(() =>
           AppSurface.literal(AppSurface.Article, 'chat'),
           AppSurface.companion(AppSurface.Article, Channel.Channel),
         ),
-        component: ({ data: { companionTo: channel } }) => <ChannelArticle subject={channel} />,
+        component: ({ data: { companionTo: channel } }) => <ChannelArticle subject={channel} chatOnly />,
       }),
       // TODO(burdon): Disambiguate with Channel.
       Surface.create({

package/src/components/Chat/Chat.tsx

@@ -9,7 +9,7 @@ import { AppSurface } from '@dxos/app-toolkit/ui';
 import { PublicKey } from '@dxos/react-client';
 import { type SpaceMember } from '@dxos/react-client/echo';
 import { type Identity } from '@dxos/react-client/halo';
-import { composable, Card, type ThemedClassName, useTranslation } from '@dxos/react-ui';
+import { Card, type ThemedClassName, composable, useTranslation } from '@dxos/react-ui';
 import { type ObjectTileComponent, Thread } from '@dxos/react-ui-thread';
 import { type Message } from '@dxos/types';
 import { hoverableControls, hoverableFocusedWithinControls, mx } from '@dxos/ui-theme';
@@ -54,8 +54,8 @@ export type ChatProps = ThemedClassName<{
  * `ChannelArticle` and `ThreadArticle`.
  */
 export const Chat = composable<HTMLDivElement, ChatProps>(
-  ({ id, identity, members, messages, activity, onSend, autoFocus, current, readOnly }, forwardedRef) => {
-    const { t } = useTranslation(meta.id);
+  ({ id, identity, members, messages, activity, onSend, autoFocus, current, readOnly, classNames }, forwardedRef) => {
+    const { t } = useTranslation(meta.profile.key);
 
     const components = useMemo(() => ({ Object: ObjectTile }), []);
 
@@ -80,7 +80,7 @@ export const Chat = composable<HTMLDivElement, ChatProps>(
 
     return (
       <Thread.Root getMetadata={getMetadata} components={components} identityDid={identity?.did} editable={false}>
-        <Thread.Content id={id} current={current} classNames='dx-container' ref={forwardedRef}>
+        <Thread.Content id={id} current={current} classNames={['dx-container', classNames]} ref={forwardedRef}>
           <Thread.Messages messages={messages} />
           {!readOnly && (
             <>
@@ -109,7 +109,7 @@ const ObjectTile: ObjectTileComponent = ({ subject }) => {
   return (
     <Card.Root className={mx('grid col-span-3 py-1 pr-4', hoverableControls, hoverableFocusedWithinControls)}>
       <Surface.Surface
-        type={AppSurface.Card}
+        type={AppSurface.CardContent}
         limit={1}
         data={{ subject } satisfies AppSurface.ObjectCardData}
         fallback={Fallback}

package/src/containers/ChannelArticle/ChannelArticle.stories.tsx

@@ -9,16 +9,17 @@ import React from 'react';
 import { Capability } from '@dxos/app-framework';
 import { withPluginManager } from '@dxos/app-framework/testing';
 import { AppCapabilities } from '@dxos/app-toolkit';
-import { Feed, Query } from '@dxos/echo';
-import { createFeedServiceLayer } from '@dxos/echo-client';
+import { AppSurface } from '@dxos/app-toolkit/ui';
+import { Database, Feed, Query } from '@dxos/echo';
 import { invariant } from '@dxos/invariant';
+import { CallsPlugin } from '@dxos/plugin-calls/plugin';
 import { ClientPlugin } from '@dxos/plugin-client/testing';
 import { initializeIdentity } from '@dxos/plugin-client/testing';
 import { SpacePlugin } from '@dxos/plugin-space/testing';
 import { corePlugins } from '@dxos/plugin-testing';
 import { Config } from '@dxos/react-client';
 import { useQuery, useSpaces } from '@dxos/react-client/echo';
-import { withLayout, withTheme, Loading } from '@dxos/react-ui/testing';
+import { Loading, withLayout, withTheme } from '@dxos/react-ui/testing';
 import { Channel, Message, Thread } from '@dxos/types';
 
 import { translations } from '#translations';
@@ -80,11 +81,12 @@ const meta = {
                   blocks: [{ _tag: 'text', text: 'Messages are stored in the feed.' }],
                 }),
               ];
-              yield* Feed.append(feed, seed).pipe(Effect.provide(createFeedServiceLayer(personalSpace.queues)));
+              yield* Feed.append(feed, seed).pipe(Effect.provide(Database.layer(personalSpace.db)));
             }),
         }),
         SpacePlugin({}),
         ThreadPlugin(),
+        CallsPlugin(),
       ],
     }),
   ],
@@ -102,7 +104,7 @@ export const Default: Story = {
     // Fixed room for testing.
     subject: undefined,
     attendableId: 'story',
-    role: 'article',
+    role: AppSurface.Article.role,
     roomId: '04a1d1911703b8e929d0649021a965',
   },
 };

package/src/containers/ChannelArticle/ChannelArticle.tsx

@@ -2,25 +2,35 @@
 // Copyright 2025 DXOS.org
 //
 
-import React from 'react';
+import { Atom, useAtomValue } from '@effect-atom/atom-react';
+import React, { useCallback } from 'react';
 
-import { useCapabilities, useOperationInvoker } from '@dxos/app-framework/ui';
-import { type AppSurface } from '@dxos/app-toolkit/ui';
+import { Surface, useCapabilities, useOperationInvoker } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
+import { CallsCapabilities } from '@dxos/plugin-calls/types';
 import { getSpace, useMembers } from '@dxos/react-client/echo';
 import { useIdentity } from '@dxos/react-client/halo';
 import { Panel } from '@dxos/react-ui';
+import { Menu, MenuBuilder, useMenuBuilder } from '@dxos/react-ui-menu';
 import { type Channel } from '@dxos/types';
 
 import { Chat } from '#components';
 import { useMessages, useStatus } from '#hooks';
+import { meta } from '#meta';
 import { ThreadCapabilities, ThreadOperation, resolveProvider } from '#types';
 
+// Stable fallbacks so `useAtomValue` always receives an atom when plugin-calls isn't present.
+const NOT_JOINED = Atom.make(false);
+const NO_ROOM = Atom.make<string | undefined>(undefined);
+
 export type ChannelArticleProps = AppSurface.ObjectArticleProps<
   Channel.Channel | undefined,
   {
     roomId?: string;
     fullscreen?: boolean;
+    /** Always render the chat, even while in this channel's call (used by the in-call chat companion). */
+    chatOnly?: boolean;
   }
 >;
 
@@ -29,12 +39,10 @@ export type ChannelArticleProps = AppSurface.ObjectArticleProps<
  * are read and written through the channel's backend provider (resolved by
  * `channel.backend.kind`), so the container is agnostic to where messages are
  * stored. Read-only state defaults to the provider's policy, or to "channel
- * carries foreign-key `Obj.Meta`" when the provider has none.
- *
- * The "Start video call" action and the in-call surface are contributed by
- * plugin-calls — this container is call-agnostic.
+ * carries foreign-key `Obj.Meta`" when the provider has none. When plugin-calls is present, a
+ * "Start video call" action switches the article to the call surface and the chat moves to a companion.
  */
-export const ChannelArticle = ({ subject: channel }: ChannelArticleProps) => {
+export const ChannelArticle = ({ role, subject: channel, attendableId, chatOnly }: ChannelArticleProps) => {
   const identity = useIdentity();
   const space = channel ? getSpace(channel) : undefined;
   const members = useMembers(space?.id);
@@ -47,6 +55,36 @@ export const ChannelArticle = ({ subject: channel }: ChannelArticleProps) => {
   const messages = useMessages(channel);
   const readOnly = channel ? (provider?.readOnly?.(channel) ?? Obj.getMeta(channel).keys.length > 0) : false;
 
+  const callProvider = useCapabilities(CallsCapabilities.CallTransportProvider)[0];
+  const callManager = useCapabilities(CallsCapabilities.Manager)[0];
+  const joined = useAtomValue(callManager?.joinedAtom ?? NOT_JOINED);
+  const currentRoomId = useAtomValue(callManager?.roomIdAtom ?? NO_ROOM);
+  // `chatOnly` (the in-call chat companion) keeps showing messages so the call lives only in the primary.
+  const inThisCall = !!id && joined && currentRoomId === id;
+  const showCall = inThisCall && !chatOnly;
+  const canStartCall = !!callProvider && !inThisCall;
+
+  const handleStartCall = useCallback(async () => {
+    if (!callProvider || !id) {
+      return;
+    }
+    await callProvider.join(id);
+  }, [callProvider, id]);
+
+  const menuActions = useMenuBuilder(() => {
+    const builder = MenuBuilder.make().root({ label: ['channel-toolbar.title', { ns: meta.profile.key }] });
+    if (canStartCall) {
+      builder.action(
+        'start-video-call',
+        { label: ['start-video-call.menu', { ns: meta.profile.key }], icon: 'ph--video-camera--regular' },
+        () => {
+          void handleStartCall();
+        },
+      );
+    }
+    return builder.build();
+  }, [canStartCall, handleStartCall]);
+
   const handleSend = (text: string) => {
     if (!channel || !identity || readOnly) {
       return false;
@@ -66,18 +104,32 @@ export const ChannelArticle = ({ subject: channel }: ChannelArticleProps) => {
   }
 
   return (
-    <Panel.Root classNames='dx-document'>
-      <Panel.Content asChild>
-        <Chat
-          id={id}
-          identity={identity ?? undefined}
-          members={members}
-          messages={messages}
-          activity={activity}
-          onSend={handleSend}
-          readOnly={readOnly}
-        />
-      </Panel.Content>
+    <Panel.Root role={role}>
+      {canStartCall && (
+        <Menu.Root {...menuActions} attendableId={attendableId}>
+          <Panel.Toolbar asChild>
+            <Menu.Toolbar />
+          </Panel.Toolbar>
+        </Menu.Root>
+      )}
+      {showCall ? (
+        <Panel.Content>
+          <Surface.Surface type={AppSurface.Article} data={{ subject: { roomId: id }, attendableId }} limit={1} />
+        </Panel.Content>
+      ) : (
+        <Panel.Content asChild>
+          <Chat
+            id={id}
+            classNames='dx-document'
+            identity={identity ?? undefined}
+            members={members}
+            messages={messages}
+            activity={activity}
+            onSend={handleSend}
+            readOnly={readOnly}
+          />
+        </Panel.Content>
+      )}
     </Panel.Root>
   );
 };

package/src/containers/ThreadArticle/ThreadArticle.stories.tsx

@@ -8,6 +8,7 @@ import React, { useState } from 'react';
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { withPluginManager } from '@dxos/app-framework/testing';
 import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 import { corePlugins } from '@dxos/plugin-testing';
 import { random } from '@dxos/random';
 import { useClient } from '@dxos/react-client';
@@ -16,7 +17,7 @@ import { useIdentity } from '@dxos/react-client/halo';
 import { withClientProvider } from '@dxos/react-client/testing';
 import { useAsyncEffect } from '@dxos/react-ui';
 import { Thread as ThreadComponent } from '@dxos/react-ui-thread';
-import { withLayout, Loading } from '@dxos/react-ui/testing';
+import { Loading, withLayout } from '@dxos/react-ui/testing';
 import { Message, Thread } from '@dxos/types';
 
 import { translations } from '#translations';
@@ -62,7 +63,7 @@ const meta = {
           Capabilities.ReactSurface,
           Surface.create({
             id: 'test',
-            role: 'card',
+            filter: Surface.makeFilter(AppSurface.CardContent),
             component: ({ role }) => <span>{JSON.stringify({ role })}</span>,
           }),
         ),

package/src/meta.ts

@@ -3,33 +3,9 @@
 //
 
 import { Plugin } from '@dxos/app-framework';
-import { DXN } from '@dxos/keys';
-import { trim } from '@dxos/util';
 
-export const meta = Plugin.makeMeta({
-  key: DXN.make('org.dxos.plugin.thread'),
-  name: 'Threads',
-  author: 'DXOS',
-  description: trim`
-    ThreadPlugin provides chat: channels backed by an ECHO feed and free-standing
-    message threads. It renders the channel article and companion surfaces plus a
-    thread surface, and contributes the operations that create a default channel on
-    space creation, create new channels, and append messages.
+import config from '../dx.config';
 
-    Channel messages are stored in the channel's feed queue and rendered newest-last
-    with a pinned composer; externally-synced channels (carrying foreign-key
-    metadata, e.g. Slack/Discord-sourced rooms) render read-only because there is no
-    local-write path back to the source. Free-standing threads render their messages
-    and append by pushing onto the thread's message list.
+export const meta = Plugin.getMetaFromConfig(config);
 
-    The shared message and thread UI comes from @dxos/react-ui-thread; the Channel,
-    Message, and Thread schema come from @dxos/types. Document comments and the
-    comment-thread AI agent live in the @dxos/plugin-comments plugin.
-  `,
-  icon: 'ph--video-conference--regular',
-  iconHue: 'rose',
-  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-thread',
-  spec: 'PLUGIN.mdl',
-});
-
-export const THREAD_ITEM = `${meta.id}.item`;
+export const THREAD_ITEM = `${meta.profile.key}.item`;

package/src/paths.ts

@@ -2,9 +2,12 @@
 // Copyright 2025 DXOS.org
 //
 
-import { createTypeSectionPaths } from '@dxos/app-toolkit';
+import { Paths } from '@dxos/app-toolkit';
 import { Channel } from '@dxos/types';
 
-const { getSectionPath: getChannelsPath, getObjectPath: getChannelPath } = createTypeSectionPaths(Channel.Channel);
+const { getSectionPath: getChannelsPath, getObjectPath: getChannelPath } = Paths.createTypeSectionPaths(
+  Channel.Channel,
+  { groupId: Paths.GroupSegments.communications },
+);
 
-export { getChannelsPath, getChannelPath };
+export { getChannelPath, getChannelsPath };

package/src/translations.ts

@@ -23,7 +23,7 @@ export const translations = [
         'delete-object.label': 'Delete channel',
         'object-deleted.label': 'Channel deleted',
       },
-      [meta.id]: {
+      [meta.profile.key]: {
         'plugin.name': 'Chat',
         'channel-title.label': 'Title',
         'message.placeholder': 'Reply…',

package/src/types/ThreadCapabilities.ts

@@ -44,4 +44,4 @@ export interface ChannelBackendProvider {
 }
 
 /** Registry of channel-message backends. Collect with `Capability.getAll`. */
-export const ChannelBackend = Capability.make<ChannelBackendProvider>(`${meta.id}.capability.channel-backend`);
+export const ChannelBackend = Capability.make<ChannelBackendProvider>(`${meta.profile.key}.capability.channel-backend`);