@dxos/plugin-thread 0.8.4-main.72ec0f3 → 0.8.4-main.765dc60934

package/src/components/ThreadCompanion.tsx

@@ -1,188 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import React, { useCallback, useMemo } from 'react';
-
-import { Capabilities, CollaborationActions, LayoutAction, createIntent } from '@dxos/app-framework';
-import { useCapabilities, useCapability, useIntentDispatcher } from '@dxos/app-framework/react';
-import { Filter, Obj, Query, Relation } from '@dxos/echo';
-import { Ref, getSpace, useQuery } from '@dxos/react-client/echo';
-import { useIdentity } from '@dxos/react-client/halo';
-import { useTranslation } from '@dxos/react-ui';
-import { useAttended } from '@dxos/react-ui-attention';
-import { StackItem } from '@dxos/react-ui-stack';
-import { Tabs } from '@dxos/react-ui-tabs';
-import { mx } from '@dxos/react-ui-theme';
-import { AnchoredTo } from '@dxos/types';
-
-import { ThreadCapabilities } from '../capabilities';
-import { CommentsContainer, type CommentsContainerProps } from '../components';
-import { meta } from '../meta';
-import { Thread, ThreadAction } from '../types';
-
-export const ThreadCompanion = ({ subject }: { subject: any }) => {
-  const { t } = useTranslation(meta.id);
-  const { dispatchPromise: dispatch } = useIntentDispatcher();
-  const identity = useIdentity();
-  const subjectId = Obj.getDXN(subject).toString();
-
-  const { state, getViewState } = useCapability(ThreadCapabilities.MutableState);
-  const drafts = state.drafts[subjectId];
-  const viewState = useMemo(() => getViewState(subjectId), [getViewState, subjectId]);
-  const { showResolvedThreads } = viewState;
-  const onChangeViewState = useCallback(
-    (nextValue: string) => {
-      viewState.showResolvedThreads = nextValue === 'all';
-    },
-    [viewState],
-  );
-
-  const anchorSorts = useCapabilities(Capabilities.AnchorSort);
-  const sort = useMemo(
-    () => anchorSorts.find(({ key }) => key === Obj.getTypename(subject))?.sort,
-    [anchorSorts, subject],
-  );
-
-  const space = getSpace(subject);
-  const objectsAnchoredTo = useQuery(space, Query.select(Filter.ids(subject.id)).targetOf(AnchoredTo.AnchoredTo));
-  const anchors = objectsAnchoredTo
-    .toSorted((a, b) => sort?.(a, b) ?? 0)
-    .filter((anchor) => Obj.instanceOf(Thread.Thread, Relation.getSource(anchor)))
-    .concat(drafts ?? []);
-
-  const attended = useAttended();
-
-  const handleAttend = useCallback(
-    (anchor: AnchoredTo.AnchoredTo) => {
-      const thread = Relation.getSource(anchor) as Thread.Thread;
-      const threadId = Obj.getDXN(thread).toString();
-
-      if (state.current !== threadId) {
-        state.current = threadId;
-
-        // TODO(wittjosiah): Should this be a thread-specific intent?
-        //  The layout doesn't know about threads and this working depends on other plugins conditionally handling it.
-        //  This may be overloading this intent or highjacking its intended purpose.
-        void dispatch(
-          createIntent(LayoutAction.ScrollIntoView, {
-            part: 'current',
-            subject: Obj.getDXN(subject).toString(),
-            options: {
-              cursor: anchor.anchor,
-              ref: threadId,
-            },
-          }),
-        );
-      }
-    },
-    [state.current, dispatch, subject],
-  );
-
-  const handleComment = useCallback(
-    async (anchor: AnchoredTo.AnchoredTo, text: string) => {
-      await dispatch(
-        createIntent(ThreadAction.AddMessage, {
-          anchor,
-          subject,
-          sender: { identityDid: identity?.did },
-          text,
-        }),
-      );
-
-      const thread = Relation.getSource(anchor) as Thread.Thread;
-      state.current = Obj.getDXN(thread).toString();
-    },
-    [dispatch, identity, subject],
-  );
-
-  const handleResolve = useCallback(
-    (anchor: AnchoredTo.AnchoredTo) =>
-      dispatch(
-        createIntent(ThreadAction.ToggleResolved, {
-          thread: Relation.getSource(anchor) as Thread.Thread,
-        }),
-      ),
-    [dispatch],
-  );
-
-  const handleThreadDelete = useCallback(
-    (anchor: AnchoredTo.AnchoredTo) => dispatch(createIntent(ThreadAction.Delete, { anchor, subject })),
-    [dispatch, subject],
-  );
-
-  const handleMessageDelete = useCallback(
-    (anchor: AnchoredTo.AnchoredTo, messageId: string) =>
-      dispatch(
-        createIntent(ThreadAction.DeleteMessage, {
-          anchor,
-          subject,
-          messageId,
-        }),
-      ),
-    [dispatch, subject],
-  );
-
-  const handleAcceptProposal = useCallback<NonNullable<CommentsContainerProps['onAcceptProposal']>>(
-    async (anchor, messageId) => {
-      const thread = Relation.getSource(anchor) as Thread.Thread;
-      const messageIndex = thread.messages.findIndex(Ref.hasObjectId(messageId));
-      const message = thread.messages[messageIndex]?.target;
-      const proposal = message?.blocks.find((block) => block._tag === 'proposal');
-      if (!proposal || !anchor.anchor) {
-        return;
-      }
-
-      await dispatch(
-        createIntent(CollaborationActions.AcceptProposal, {
-          subject,
-          anchor: anchor.anchor,
-          proposal,
-        }),
-      );
-      await dispatch(createIntent(ThreadAction.ToggleResolved, { thread }));
-    },
-    [dispatch, subject],
-  );
-
-  const comments = (
-    <CommentsContainer
-      anchors={anchors}
-      currentId={attended.includes(subjectId) ? state.current : undefined}
-      showResolvedThreads={showResolvedThreads}
-      onAttend={handleAttend}
-      onComment={handleComment}
-      onResolve={handleResolve}
-      onMessageDelete={handleMessageDelete}
-      onThreadDelete={handleThreadDelete}
-      onAcceptProposal={handleAcceptProposal}
-    />
-  );
-
-  return (
-    <StackItem.Content toolbar>
-      <Tabs.Root
-        value={showResolvedThreads ? 'all' : 'unresolved'}
-        orientation='horizontal'
-        classNames={[
-          'contents [&_[role="tabpanel"]]:min-bs-0 [&_[role="tabpanel"]]:overflow-y-auto [&_[role="tabpanel"]]:scrollbar-thin',
-        ]}
-        onValueChange={onChangeViewState}
-      >
-        {/* TODO(burdon): Standardize (like Tollbar). */}
-        <Tabs.Tablist classNames={mx('bg-toolbarSurface border-be border-subduedSeparator')}>
-          <Tabs.Tab value='unresolved' classNames='text-sm'>
-            {t('show unresolved label')}
-          </Tabs.Tab>
-          <Tabs.Tab value='all' classNames='text-sm'>
-            {t('show all label')}
-          </Tabs.Tab>
-        </Tabs.Tablist>
-        <div className='overflow-y-auto'>
-          <Tabs.Tabpanel value='all'>{showResolvedThreads && comments}</Tabs.Tabpanel>
-          <Tabs.Tabpanel value='unresolved'>{!showResolvedThreads && comments}</Tabs.Tabpanel>
-        </div>
-      </Tabs.Root>
-    </StackItem.Content>
-  );
-};

package/src/components/ThreadSettings.tsx

@@ -1,16 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import React from 'react';
-
-import { useTranslation } from '@dxos/react-ui';
-import { ControlPage } from '@dxos/react-ui-form';
-
-import { meta } from '../meta';
-import type { ThreadSettingsProps } from '../types';
-
-export const ThreadSettings = ({ settings: _settings }: { settings: ThreadSettingsProps }) => {
-  const { t: _t } = useTranslation(meta.id);
-  return <ControlPage></ControlPage>;
-};

package/src/functions/create-proposals.ts

@@ -1,58 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Array from 'effect/Array';
-import * as Effect from 'effect/Effect';
-import * as Function from 'effect/Function';
-import * as Schema from 'effect/Schema';
-
-import { ArtifactId, computeDiffsWithCursors } from '@dxos/assistant';
-import { Obj, Ref, Relation } from '@dxos/echo';
-import { createDocAccessor } from '@dxos/echo-db';
-import { DatabaseService, defineFunction } from '@dxos/functions';
-import { DXN } from '@dxos/keys';
-import { Markdown } from '@dxos/plugin-markdown/types';
-import { AnchoredTo, Message } from '@dxos/types';
-
-import { Thread } from '../types';
-
-export default defineFunction({
-  key: 'dxos.org/function/thread/create-proposals',
-  name: 'Create Proposals',
-  description: 'Proposes a set of changes to a document.',
-  inputSchema: Schema.Struct({
-    id: ArtifactId,
-    diffs: Schema.Array(Schema.String).annotations({
-      description: 'The diffs to propose for the document.',
-    }),
-  }),
-  outputSchema: Schema.Void,
-  handler: Effect.fn(function* ({ data: { id, diffs: _diffs } }) {
-    const object = yield* DatabaseService.resolve(DXN.parse(id), Markdown.Document);
-    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* DatabaseService.add(thread);
-          yield* DatabaseService.add(relation);
-        }),
-      ),
-      Effect.allWith({ concurrency: 'unbounded' }),
-    );
-  }),
-});

package/src/functions/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-export { default as createProposals } from './create-proposals';

package/src/hooks/useBlackCanvasStreamTrack.tsx

@@ -1,27 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-import { scheduleTask } from '@dxos/async';
-import { Context } from '@dxos/context';
-
-import { createBlackCanvasStreamTrack } from '../calls/util/stub-media-streams';
-
-export const useBlackCanvasStreamTrack = () => {
-  const [blackCanvasStreamTrack, setBlackCanvasStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
-  useEffect(() => {
-    const ctx = new Context();
-    scheduleTask(ctx, async () => {
-      const blackCanvasStreamTrack = await createBlackCanvasStreamTrack({ ctx, width: 720, height: 480 });
-      setBlackCanvasStreamTrack(blackCanvasStreamTrack);
-    });
-
-    return () => {
-      void ctx.dispose();
-    };
-  }, []);
-
-  return blackCanvasStreamTrack;
-};

package/src/hooks/useDebugMode.ts

@@ -1,25 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-// TODO(burdon): Standardize across plugins/composer.
-export const useDebugMode = () => {
-  const [enabled, setEnabled] = useState(false);
-  useEffect(() => {
-    const handler = (ev: KeyboardEvent) => {
-      if (ev.key.toLowerCase() === 'd' && ev.ctrlKey) {
-        ev.preventDefault();
-        setEnabled(!enabled);
-      }
-    };
-
-    document.addEventListener('keypress', handler);
-    return () => {
-      document.removeEventListener('keypress', handler);
-    };
-  }, [enabled]);
-
-  return enabled;
-};

package/src/hooks/useInaudibleAudioStreamTrack.tsx

@@ -1,27 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-import { scheduleTask } from '@dxos/async';
-import { Context } from '@dxos/context';
-
-import { createInaudibleAudioStreamTrack } from '../calls/util/stub-media-streams';
-
-export const useInaudibleAudioStreamTrack = () => {
-  const [audioStreamTrack, setAudioStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
-  useEffect(() => {
-    const ctx = new Context();
-    scheduleTask(ctx, async () => {
-      const audioStreamTrack = await createInaudibleAudioStreamTrack({ ctx });
-      setAudioStreamTrack(audioStreamTrack);
-    });
-
-    return () => {
-      void ctx.dispose();
-    };
-  }, []);
-
-  return audioStreamTrack;
-};

package/src/hooks/useVideoStreamTrack.tsx

@@ -1,36 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type RefObject, useEffect, useRef, useState } from 'react';
-
-export const useVideoStreamTrack = (videoElement: RefObject<HTMLVideoElement | null>, videoSrc: string) => {
-  // Get video stream track.
-  const [videoStreamTrack, setVideoStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
-  const hadRun = useRef(false);
-  useEffect(() => {
-    // This is done to capture only one video stream.
-    if (!videoElement.current || hadRun.current || !videoSrc) {
-      return;
-    }
-    hadRun.current = true;
-    videoElement.current.addEventListener('playing', () => {
-      if (videoStreamTrack) {
-        return;
-      }
-      const stream = (videoElement.current as any).captureStream();
-      const track = stream.getTracks()[0];
-      if (track && !videoStreamTrack) {
-        setVideoStreamTrack(track);
-      }
-      stream.onaddtrack = (event: MediaStreamTrackEvent) => {
-        if (event.track.kind === 'video' && !videoStreamTrack) {
-          setVideoStreamTrack(event.track);
-        }
-      };
-    });
-    videoElement.current.src = videoSrc;
-  }, [videoElement.current, videoSrc]);
-
-  return videoStreamTrack;
-};

package/src/testing/stories.ts

@@ -1,51 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import { IntentPlugin, SettingsPlugin } from '@dxos/app-framework';
-import { ClientPlugin } from '@dxos/plugin-client';
-import { GraphPlugin } from '@dxos/plugin-graph';
-import { SpacePlugin } from '@dxos/plugin-space';
-import { ThemePlugin } from '@dxos/plugin-theme';
-import { Config } from '@dxos/react-client';
-import { defaultTx } from '@dxos/react-ui-theme';
-
-import { ThreadPlugin } from '../ThreadPlugin';
-import { Channel } from '../types';
-
-export const createThreadPlugins = async () => [
-  ThemePlugin({ tx: defaultTx }),
-  ClientPlugin({
-    onClientInitialized: async ({ client }) => {
-      await client.halo.createIdentity({ displayName: 'Test User' });
-    },
-    onSpacesReady: async ({ client }) => {
-      await client.spaces.default.waitUntilReady();
-      client.spaces.default.db.add(Channel.make());
-    },
-    config: new Config({
-      runtime: {
-        client: {
-          edgeFeatures: {
-            signaling: true,
-          },
-        },
-        services: {
-          edge: {
-            url: 'https://edge.dxos.workers.dev/',
-          },
-          iceProviders: [
-            {
-              urls: 'https://edge.dxos.workers.dev/ice',
-            },
-          ],
-        },
-      },
-    }),
-  }),
-  SpacePlugin({}),
-  IntentPlugin(),
-  SettingsPlugin(),
-  GraphPlugin(),
-  ThreadPlugin(),
-];

package/src/types/Channel.ts

@@ -1,27 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Obj, Ref, Type } from '@dxos/echo';
-import { FormAnnotation } from '@dxos/echo/internal';
-
-import * as Thread from './Thread';
-
-const _Channel = Schema.Struct({
-  name: Schema.optional(Schema.String),
-  defaultThread: Type.Ref(Thread.Thread).pipe(FormAnnotation.set(false)),
-  // TODO(wittjosiah): Should be an "ordered collection".
-  threads: Type.Ref(Thread.Thread).pipe(Schema.Array, Schema.mutable, FormAnnotation.set(false)),
-}).pipe(Type.Obj({ typename: 'dxos.org/type/Channel', version: '0.1.0' }));
-export interface Channel extends Schema.Schema.Type<typeof _Channel> {}
-export interface ChannelEncoded extends Schema.Schema.Encoded<typeof _Channel> {}
-export const Channel: Schema.Schema<Channel, ChannelEncoded> = _Channel;
-
-export const make = (props: Pick<Obj.MakeProps<typeof Channel>, 'name'> = {}) =>
-  Obj.make(Channel, {
-    ...props,
-    defaultThread: Ref.make(Obj.make(Thread.Thread, { messages: [], status: 'active' })),
-    threads: [],
-  });

package/src/types/Thread.ts

@@ -1,26 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Obj, Type } from '@dxos/echo';
-import { Message } from '@dxos/types';
-
-export const ThreadStatus = Schema.Union(
-  Schema.Literal('staged'),
-  Schema.Literal('active'),
-  Schema.Literal('resolved'),
-);
-
-const _Thread = Schema.Struct({
-  name: Schema.String.pipe(Schema.optional),
-  status: ThreadStatus.pipe(Schema.optional),
-  messages: Schema.mutable(Schema.Array(Type.Ref(Message.Message))),
-}).pipe(Type.Obj({ typename: 'dxos.org/type/Thread', version: '0.1.0' }));
-export interface Thread extends Schema.Schema.Type<typeof _Thread> {}
-export interface ThreadEncoded extends Schema.Schema.Encoded<typeof _Thread> {}
-export const Thread: Schema.Schema<Thread, ThreadEncoded> = _Thread;
-
-export const make = ({ status = 'staged', messages = [], ...props }: Partial<Obj.MakeProps<typeof Thread>> = {}) =>
-  Obj.make(Thread, { status, messages, ...props });

package/src/typings/peermetrics-webrtc-stats.d.ts

@@ -1,46 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-declare module '@peermetrics/webrtc-stats' {
-  import { EventEmitter } from 'events';
-
-  export interface WebRTCStatsConstructorOptions {
-    getStatsInterval?: number;
-    rawStats?: boolean;
-    statsObject?: boolean;
-    filteredStats?: boolean;
-    wrapGetUserMedia?: boolean;
-    debug?: boolean;
-    remote?: boolean;
-    logLevel?: LogLevel;
-  }
-
-  export interface ConnectionInfo {
-    pc: RTCPeerConnection;
-    peerId: number | string;
-    connectionId: string;
-  }
-
-  type TrackStats = {
-    id: string;
-    kind: 'audio' | 'video';
-    codecId: string;
-    mid: string;
-    bytesSent: number;
-    bytesReceived: number;
-  };
-
-  export type WebRTCStatsEvent = {
-    data: {
-      audio: { inbound: TrackStats[]; outbound: TrackStats[] };
-      video: { inbound: TrackStats[]; outbound: TrackStats[] };
-    };
-  };
-
-  export class WebRTCStats extends EventEmitter<{ stats: WebRTCStatsEvent }> {
-    constructor(options: WebRTCStatsConstructorOptions);
-    addConnection(info: ConnectionInfo): void;
-    removeConnection(info: Pick<ConnectionInfo, 'pc'>): void;
-  }
-}

package/src/typings.d.ts

@@ -1,8 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-declare module '*.mp4?raw' {
-  const content: string;
-  export default content;
-}