@dxos/plugin-thread 0.8.4-main.c85a9c8dae → 0.8.4-main.d9fc60f731

package/src/containers/ThreadContainer/ThreadContainer.tsx

@@ -0,0 +1,75 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import React, { useMemo } from 'react';
+
+import { Obj, Ref } from '@dxos/echo';
+import { type Space, useMembers } from '@dxos/react-client/echo';
+import { useIdentity } from '@dxos/react-client/halo';
+import { type ThemedClassName } from '@dxos/react-ui';
+import { composable, composableProps } from '@dxos/react-ui';
+import { type ThreadRootProps } from '@dxos/react-ui-thread';
+import { Message, type Thread } from '@dxos/types';
+import { isNonNullable } from '@dxos/util';
+
+import { Chat } from '#components';
+import { useStatus } from '#hooks';
+
+export type ThreadContainerProps = ThemedClassName<
+  {
+    space: Space;
+    thread: Thread.Thread;
+    context?: Obj.Unknown;
+    autoFocusTextbox?: boolean;
+  } & Pick<ThreadRootProps, 'current'>
+>;
+
+/**
+ * Renders an AutoMerge {@link Thread} as a chat: appends new messages by pushing
+ * onto `thread.messages`. Used for comment threads and the meeting in-call chat.
+ */
+export const ThreadContainer = composable<HTMLDivElement, ThreadContainerProps>(
+  ({ space, thread, context, autoFocusTextbox, current, ...props }, forwardedRef) => {
+    const id = Obj.getURI(thread);
+    const identity = useIdentity()!;
+    const members = useMembers(space?.id);
+    const activity = useStatus(space, id);
+
+    const messages = useMemo(
+      () => thread.messages.map((message) => message.target).filter(isNonNullable),
+      [thread.messages],
+    );
+
+    const handleSend = (text: string) => {
+      Obj.update(thread, (thread) => {
+        thread.messages.push(
+          Ref.make(
+            Obj.make(Message.Message, {
+              created: new Date().toISOString(),
+              sender: { identityDid: identity.did },
+              blocks: [{ _tag: 'text', text }],
+              properties: context ? { context: Ref.make(context) } : undefined,
+            }),
+          ),
+        );
+      });
+      return true;
+    };
+
+    return (
+      <Chat
+        {...composableProps(props)}
+        id={id}
+        identity={identity}
+        members={members}
+        messages={messages}
+        activity={activity}
+        onSend={handleSend}
+        autoFocusTextbox={autoFocusTextbox}
+        current={current}
+        ref={forwardedRef}
+      />
+    );
+  },
+);

package/src/containers/ThreadContainer/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { ThreadContainer } from './ThreadContainer';
+
+export { ThreadContainer };
+export default ThreadContainer;

package/src/containers/index.ts

@@ -4,9 +4,7 @@
 
 import { type ComponentType, lazy } from 'react';
 
-export const CallDebugPanel: ComponentType<any> = lazy(() => import('./CallDebugPanel'));
-export const CallSidebar: ComponentType<any> = lazy(() => import('./CallSidebar'));
-export const ChannelContainer: ComponentType<any> = lazy(() => import('./ChannelContainer'));
-export const ChatContainer: ComponentType<any> = lazy(() => import('./ChatContainer'));
-export const ThreadCompanion: ComponentType<any> = lazy(() => import('./ThreadCompanion'));
-export const ThreadSettings: ComponentType<any> = lazy(() => import('./ThreadSettings'));
+export const ChannelChat: ComponentType<any> = lazy(() => import('./ChannelChat'));
+export const ChannelArticle: ComponentType<any> = lazy(() => import('./ChannelArticle'));
+export const ThreadContainer: ComponentType<any> = lazy(() => import('./ThreadContainer'));
+export const CommentsCompanion: ComponentType<any> = lazy(() => import('./CommentsCompanion'));

package/src/{components/command-extension.ts → extensions/command.ts}

@@ -29,7 +29,7 @@ const parser = StreamLanguage.define<{ count: number }>({
 const styles = HighlightStyle.define([
   {
     tag: tags.tagName,
-    class: mx('dx-tag dx-tag--indigo text-base-surface-text font-medium'),
+    class: mx('dx-tag dx-tag--indigo text-base-fg font-medium'),
   },
 ]);
 

package/src/extensions/index.ts

@@ -2,4 +2,5 @@
 // Copyright 2024 DXOS.org
 //
 
+export * from './command';
 export * from './threads';

package/src/extensions/threads.ts

@@ -8,12 +8,13 @@ import { type Atom, type Registry } from '@effect-atom/atom-react';
 
 import { Filter, Obj, Query, Relation } from '@dxos/echo';
 import { createDocAccessor, getTextInRange } from '@dxos/echo-db';
-import { type OperationInvoker } from '@dxos/operation';
-import { type Markdown } from '@dxos/plugin-markdown/types';
+import { OperationInvoker } from '@dxos/operation';
+import { type Markdown } from '@dxos/plugin-markdown';
 import { AnchoredTo, Thread } from '@dxos/types';
 import { comments, createExternalCommentSync } from '@dxos/ui-editor';
 
-import { ThreadOperation, type ThreadState } from '../types';
+import { ThreadOperation } from '#types';
+import { type ThreadState } from '#types';
 
 // TODO(burdon): Factor out.
 const getName = (doc: Markdown.Document, anchor: string): string | undefined => {
@@ -44,7 +45,7 @@ export const threads = (
   }
 
   const { registry, stateAtom } = store;
-  const objectId = Obj.getDXN(doc).toString();
+  const objectId = Obj.getURI(doc);
   const query = db.query(Query.select(Filter.id(doc.id)).targetOf(AnchoredTo.AnchoredTo));
 
   // Get current anchors by combining query results with store drafts.
@@ -72,8 +73,8 @@ export const threads = (
             const name = getName(doc, anchor.anchor);
             const thread = Relation.getSource(anchor) as Thread.Thread;
             if (name && name !== thread.name) {
-              Obj.change(thread, (t) => {
-                t.name = name;
+              Obj.update(thread, (thread) => {
+                thread.name = name;
               });
             }
           }
@@ -96,7 +97,7 @@ export const threads = (
         getAnchors()
           .filter((anchor) => anchor.anchor)
           .map((anchor) => ({
-            id: Obj.getDXN(Relation.getSource(anchor)).toString(),
+            id: Obj.getURI(Relation.getSource(anchor)),
             cursor: anchor.anchor,
           })),
     ),
@@ -114,7 +115,7 @@ export const threads = (
       onDelete: ({ id }) => {
         const drafts = registry.get(stateAtom).drafts[objectId];
         if (drafts) {
-          const index = drafts.findIndex((draft) => Relation.getDXN(draft).toString() === id);
+          const index = drafts.findIndex((draft) => Relation.getURI(draft) === id);
           if (index !== -1) {
             const current = registry.get(stateAtom);
             registry.set(stateAtom, {
@@ -129,20 +130,20 @@ export const threads = (
 
         const thread = query.results.find((object) => Relation.getSource(object).id === id);
         if (thread) {
-          Relation.change(thread, (t) => {
-            t.anchor = undefined;
+          Relation.update(thread, (thread) => {
+            thread.anchor = undefined;
           });
         }
       },
       onUpdate: ({ id, cursor }) => {
-        const draft = registry.get(stateAtom).drafts[objectId]?.find((d) => Relation.getDXN(d).toString() === id);
+        const draft = registry.get(stateAtom).drafts[objectId]?.find((d) => Relation.getURI(d) === id);
         if (draft) {
           const thread = Relation.getSource(draft) as Thread.Thread;
-          Obj.change(thread, (t) => {
-            t.name = getName(doc, cursor);
+          Obj.update(thread, (thread) => {
+            thread.name = getName(doc, cursor);
           });
-          Relation.change(draft, (d) => {
-            d.anchor = cursor;
+          Relation.update(draft, (draft) => {
+            draft.anchor = cursor;
           });
         }
 
@@ -150,11 +151,11 @@ export const threads = (
         if (relation) {
           const thread = Relation.getSource(relation);
           if (Obj.instanceOf(Thread.Thread, thread)) {
-            Obj.change(thread, (t) => {
-              t.name = getName(doc, cursor);
+            Obj.update(thread, (thread) => {
+              thread.name = getName(doc, cursor);
             });
-            Relation.change(relation, (r) => {
-              r.anchor = cursor;
+            Relation.update(relation, (relation) => {
+              relation.anchor = cursor;
             });
           }
         }

package/src/hooks/analytics.ts

@@ -6,7 +6,7 @@ import { useCallback } from 'react';
 
 import { useOperationInvoker } from '@dxos/app-framework/ui';
 import { Obj } from '@dxos/echo';
-import { ObservabilityOperation } from '@dxos/plugin-observability/types';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
 import { useOnTransition } from '@dxos/react-ui';
 import { type ContentBlock } from '@dxos/types';
 

package/src/hooks/index.ts

@@ -3,9 +3,4 @@
 //
 
 export * from './analytics';
-
-export * from './useBlackCanvasStreamTrack';
-export * from './useDebugMode';
-export * from './useInaudibleAudioStreamTrack';
 export * from './useStatus';
-export * from './useVideoStreamTrack';

package/src/index.ts

@@ -2,9 +2,9 @@
 // Copyright 2023 DXOS.org
 //
 
-export { ThreadCapabilities } from './types';
-export * from './calls';
+export * from './blueprints';
+// TODO(wittjosiah): Hooks should not be exported from the plugin package at all.
+//   Either refactor callers to not need them or factor them out to a shared package.
 export * from './hooks';
 export * from './meta';
-
-export * from './ThreadPlugin';
+export * from './types';

package/src/meta.ts

@@ -2,20 +2,46 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Plugin } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { DXN } from '@dxos/keys';
 import { trim } from '@dxos/util';
 
-// TODO(wittjosiah): Needs screenshots.
-export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/thread',
-  name: 'Chat',
+export const meta = Plugin.makeMeta({
+  key: DXN.make('org.dxos.plugin.thread'),
+  name: 'Threads',
+  author: 'DXOS',
   description: trim`
-    Multi-modal communication platform supporting text chat, voice, and video conferencing.
-    Create threaded conversations and add contextual comments directly on any workspace object.
+    ThreadPlugin renders comment threads anchored to ECHO objects and provides a
+    persistent chat channel attached to every workspace. Threads can be created
+    inline on any Markdown document, letting collaborators leave contextual
+    comments and hold focused discussions without leaving the document surface.
+
+    Each thread carries an optional AI agent configuration that controls how the
+    built-in assistant participates in the conversation. Threads can be set to
+    off, mention-only (the agent responds only when @-mentioned by name), or
+    auto mode (the agent replies to every new user message). The agent identity —
+    display name, DID, and avatar — is resolved at runtime from a pluggable
+    Effect capability so host applications can substitute their own assistant
+    persona.
+
+    When the agent is enabled, it executes one LLM turn per trigger via the
+    AgentRunner capability. The runner has access to edit tools that can splice
+    a replacement range into the anchored document span or replace the entire
+    document content, so the assistant can propose inline edits in addition to
+    posting chat replies. A self-loop guard prevents the agent from responding
+    to its own messages, and resolved threads are excluded from triggering.
+
+    The toggle UI appears as a per-thread icon button in the CommentsPanel
+    header. Clicking it opens a popover with three radio options (off / mention /
+    auto) and a read-only label showing the active agent name. All state changes
+    go through the SetAgentConfig operation rather than direct schema writes,
+    keeping mutation logic in one place and making the feature testable with
+    stub runners in storybook.
   `,
   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.id}.item`;

package/src/operations/add-message.ts

@@ -0,0 +1,94 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { Obj, Ref, Relation } from '@dxos/echo';
+import { invariant } from '@dxos/invariant';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
+import { SpaceOperation } from '@dxos/plugin-space';
+import { AnchoredTo, Message, Thread } from '@dxos/types';
+
+import { shouldTriggerAgent } from '../should-trigger-agent';
+import { AgentIdentity, ThreadCapabilities } from '../types';
+import { ThreadOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof ThreadOperation.AddMessage> = ThreadOperation.AddMessage.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ anchor, subject, sender, text }) {
+      const registry = yield* Capability.get(Capabilities.AtomRegistry);
+      const stateAtom = yield* Capability.get(ThreadCapabilities.State);
+      const thread = Relation.getSource(anchor) as Thread.Thread;
+      const subjectId = Obj.getURI(subject);
+      const db = Obj.getDatabase(subject);
+      invariant(db, 'Database not found');
+
+      const message = Obj.make(Message.Message, {
+        created: new Date().toISOString(),
+        sender,
+        blocks: [{ _tag: 'text', text }],
+      });
+      Obj.update(thread, (thread) => {
+        thread.messages.push(Ref.make(message));
+      });
+
+      const state = registry.get(stateAtom);
+      const draft = state.drafts[subjectId]?.find((a: { id: string }) => a.id === anchor.id);
+      if (draft) {
+        Obj.update(thread, (thread) => {
+          thread.status = 'active';
+        });
+        registry.set(stateAtom, {
+          ...state,
+          drafts: {
+            ...state.drafts,
+            [subjectId]: state.drafts[subjectId]?.filter((a: { id: string }) => a.id !== anchor.id),
+          },
+        });
+        yield* Operation.invoke(SpaceOperation.AddObject, { object: thread, target: db, hidden: true });
+        yield* Operation.invoke(SpaceOperation.AddRelation, {
+          db,
+          schema: AnchoredTo.AnchoredTo,
+          source: thread,
+          target: subject,
+          fields: { anchor: draft.anchor },
+        });
+        yield* Operation.schedule(ObservabilityOperation.SendEvent, {
+          name: 'threads.create',
+          properties: {
+            spaceId: db.spaceId,
+            threadId: thread.id,
+          },
+        });
+      }
+
+      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
+        name: 'threads.message.add',
+        properties: {
+          spaceId: db.spaceId,
+          threadId: thread.id,
+          threadLength: thread.messages.length,
+          messageId: message.id,
+          messageLength: text.length,
+        },
+      });
+
+      // Gate the comment-thread agent. Identity is optional — if no capability
+      // is contributed we simply never trigger. Schedule (not invoke) so the
+      // user's message commit returns immediately and the agent runs out-of-band.
+      const identities = yield* Capability.getAll(AgentIdentity);
+      const identity = identities[0];
+      if (identity && shouldTriggerAgent(thread, message, identity.name)) {
+        yield* Operation.schedule(ThreadOperation.RespondToThread, {
+          thread: Ref.make(thread),
+          subject: Ref.make(subject),
+        });
+      }
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/append-channel-message.ts

@@ -0,0 +1,37 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { Database, Feed, Obj } from '@dxos/echo';
+import { createFeedServiceLayer } from '@dxos/echo-db';
+import { invariant } from '@dxos/invariant';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { Message } from '@dxos/types';
+
+import { ThreadOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof ThreadOperation.AppendChannelMessage> =
+  ThreadOperation.AppendChannelMessage.pipe(
+    Operation.withHandler(
+      Effect.fnUntraced(function* ({ channel, sender, text }) {
+        const db = Obj.getDatabase(channel);
+        invariant(db, 'Database not found');
+        const client = yield* Capability.get(ClientCapabilities.Client);
+        const space = client.spaces.get(db.spaceId);
+        invariant(space, 'Space not found');
+
+        const feed = yield* Database.load(channel.feed);
+        const message = Message.make({
+          sender,
+          blocks: [{ _tag: 'text', text }],
+        });
+        yield* Feed.append(feed, [message]).pipe(Effect.provide(createFeedServiceLayer(space.queues)));
+      }),
+    ),
+  );
+
+export default handler;

package/src/operations/create-channel.ts

@@ -0,0 +1,20 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Operation } from '@dxos/compute';
+import { Channel } from '@dxos/types';
+
+import { ThreadOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof ThreadOperation.CreateChannel> = ThreadOperation.CreateChannel.pipe(
+  Operation.withHandler((input) =>
+    Effect.sync(() => ({
+      object: Channel.make({ name: input.name }),
+    })),
+  ),
+);
+
+export default handler;

package/src/operations/create-proposals.ts

@@ -0,0 +1,49 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Array from 'effect/Array';
+import * as Effect from 'effect/Effect';
+import * as Function from 'effect/Function';
+
+import { computeDiffsWithCursors } from '@dxos/assistant';
+import { Operation } from '@dxos/compute';
+import { Database, Obj, Ref, Relation } from '@dxos/echo';
+import { createDocAccessor } from '@dxos/echo-db';
+import { AnchoredTo, Message, Thread } from '@dxos/types';
+
+import { ThreadOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof ThreadOperation.CreateProposals> = ThreadOperation.CreateProposals.pipe(
+  Operation.withHandler(
+    Effect.fn(function* ({ doc, diffs }) {
+      const object = yield* Database.load(doc);
+      const content = yield* Effect.promise(() => object.content.load());
+      const accessor = createDocAccessor(content, ['content']);
+
+      yield* Function.pipe(
+        computeDiffsWithCursors(accessor, diffs),
+        Array.map(
+          Effect.fnUntraced(function* ({ cursor, text }) {
+            const proposal = Obj.make(Message.Message, {
+              created: new Date().toISOString(),
+              sender: { role: 'assistant' },
+              blocks: [{ _tag: 'proposal', text }],
+            });
+            const thread = Thread.make({ name: 'Proposal', messages: [Ref.make(proposal)], status: 'active' });
+            const relation = Relation.make(AnchoredTo.AnchoredTo, {
+              [Relation.Source]: thread,
+              [Relation.Target]: object,
+              anchor: cursor,
+            });
+            yield* Database.add(thread);
+            yield* Database.add(relation);
+          }),
+        ),
+        Effect.allWith({ concurrency: 'unbounded' }),
+      );
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/create.ts

@@ -0,0 +1,63 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { LayoutOperation } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { Obj, Relation } from '@dxos/echo';
+import { Markdown, MarkdownCapabilities } from '@dxos/plugin-markdown';
+import { linkedSegment } from '@dxos/react-ui-attention';
+import { AnchoredTo, Thread } from '@dxos/types';
+
+import { ThreadCapabilities } from '../types';
+import { ThreadOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof ThreadOperation.Create> = ThreadOperation.Create.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ name, anchor: _anchor, subject }) {
+      const registry = yield* Capability.get(Capabilities.AtomRegistry);
+      const stateAtom = yield* Capability.get(ThreadCapabilities.State);
+      const subjectId = Obj.getURI(subject);
+
+      // Inherit the markdown plugin's `commentAgentMode` setting when the
+      // subject is a Markdown.Document, so new comment threads on docs are
+      // opted-in (or not) based on the user's preference. Non-markdown
+      // subjects always get an un-opted thread (no agent).
+      const markdownSettingsAtoms = yield* Capability.getAll(MarkdownCapabilities.Settings);
+      const markdownSettingsAtom = markdownSettingsAtoms[0];
+      const commentAgentMode =
+        markdownSettingsAtom && Obj.instanceOf(Markdown.Document, subject)
+          ? registry.get(markdownSettingsAtom).commentAgentMode
+          : undefined;
+      const agent =
+        commentAgentMode && commentAgentMode !== 'off' ? { enabled: true, mode: commentAgentMode } : undefined;
+
+      const thread = Thread.make({ name, agent });
+      const anchor = Relation.make(AnchoredTo.AnchoredTo, {
+        [Relation.Source]: thread,
+        [Relation.Target]: subject,
+        anchor: _anchor,
+      });
+
+      const state = registry.get(stateAtom);
+      const existingDrafts = state.drafts[subjectId];
+      registry.set(stateAtom, {
+        ...state,
+        drafts: {
+          ...state.drafts,
+          [subjectId]: existingDrafts ? [...existingDrafts, anchor] : [anchor],
+        },
+      });
+
+      yield* Operation.invoke(ThreadOperation.Select, { current: Obj.getURI(thread) });
+      yield* Operation.invoke(LayoutOperation.UpdateCompanion, {
+        subject: linkedSegment('comments'),
+      });
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/delete-message.ts

@@ -0,0 +1,53 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Operation } from '@dxos/compute';
+import { Obj, Relation } from '@dxos/echo';
+import { invariant } from '@dxos/invariant';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
+import { Thread } from '@dxos/types';
+
+import { ThreadOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof ThreadOperation.DeleteMessage> = ThreadOperation.DeleteMessage.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ subject, anchor, messageId }) {
+      const thread = Relation.getSource(anchor) as Thread.Thread;
+      const db = Obj.getDatabase(subject);
+      invariant(db, 'Database not found');
+
+      const msgIndex = thread.messages.findIndex((ref) => ref.target?.id === messageId);
+      const msg = thread.messages[msgIndex]?.target;
+      if (!msg) {
+        return { messageIndex: -1 };
+      }
+
+      if (msgIndex === 0 && thread.messages.length === 1) {
+        // TODO(wittjosiah): This doesn't support restoring the thread.
+        yield* Operation.invoke(ThreadOperation.Delete, { subject, anchor });
+        return { messageIndex: -1 };
+      }
+
+      Obj.update(thread, (thread) => {
+        thread.messages.splice(msgIndex, 1);
+      });
+
+      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
+        name: 'threads.message.delete',
+        properties: {
+          spaceId: db.spaceId,
+          threadId: thread.id,
+          threadLength: thread.messages.length,
+          messageId,
+        },
+      });
+
+      return { message: msg, messageIndex: msgIndex };
+    }),
+  ),
+);
+
+export default handler;