@dxos/plugin-thread 0.8.4-main.fcfe5033a5 → 0.8.4-staging.60fe92afc8

package/src/operations/definitions.ts

@@ -1,177 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Capability } from '@dxos/app-framework';
-import { Database, Key, Obj, Ref } from '@dxos/echo';
-import { Collection } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { Markdown } from '@dxos/plugin-markdown/types';
-import { SpaceSchema } from '@dxos/react-client/echo';
-import { Actor, AnchoredTo, Message, Thread } from '@dxos/types';
-
-import { meta } from '#meta';
-
-import { Channel } from '../types';
-
-const THREAD_OPERATION = `${meta.id}.operation`;
-
-export const OnCreateSpace = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.on-create-space`, name: 'On Create Space' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    space: SpaceSchema,
-    rootCollection: Collection.Collection,
-    isDefault: Schema.Boolean.pipe(Schema.optional),
-  }),
-  output: Schema.Void,
-});
-
-export const CreateChannel = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.create-channel`, name: 'Create Channel' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    spaceId: Key.SpaceId,
-    name: Schema.optional(Schema.String),
-  }),
-  output: Schema.Struct({
-    object: Channel.Channel,
-  }),
-});
-
-export const CreateChannelThread = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.create-channel-thread`, name: 'Create Channel Thread' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    channel: Channel.Channel,
-  }),
-  output: Schema.Struct({
-    object: Thread.Thread,
-  }),
-});
-
-export const Create = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.create`, name: 'Create Thread' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    name: Schema.optional(Schema.String),
-    anchor: Schema.optional(Schema.String),
-    subject: Obj.Unknown,
-  }),
-  output: Schema.Void,
-});
-
-export const DeleteOutput = Schema.Struct({
-  thread: Thread.Thread.annotations({ description: 'The deleted thread.' }),
-  anchor: AnchoredTo.AnchoredTo.annotations({ description: 'The deleted anchor.' }),
-}).pipe(Schema.partial);
-
-export type DeleteOutput = Schema.Schema.Type<typeof DeleteOutput>;
-
-export const Delete = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.delete`, name: 'Delete Thread' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    anchor: AnchoredTo.AnchoredTo,
-    subject: Obj.Unknown,
-    thread: Schema.optional(Thread.Thread),
-  }),
-  output: DeleteOutput,
-});
-
-export const Select = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.select`, name: 'Select Thread' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    current: Schema.String,
-  }),
-  output: Schema.Void,
-});
-
-export const ToggleResolved = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.toggle-resolved`, name: 'Toggle Resolved' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    thread: Thread.Thread,
-  }),
-  output: Schema.Void,
-});
-
-export const AddMessage = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.add-message`, name: 'Add Message' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    subject: Obj.Unknown,
-    anchor: AnchoredTo.AnchoredTo,
-    sender: Actor.Actor,
-    text: Schema.String,
-  }),
-  output: Schema.Void,
-});
-
-export const DeleteMessageOutput = Schema.partial(
-  Schema.Struct({
-    message: Message.Message.annotations({ description: 'The deleted message.' }),
-    messageIndex: Schema.Number.annotations({ description: 'The index the message was at.' }),
-  }),
-);
-
-export type DeleteMessageOutput = Schema.Schema.Type<typeof DeleteMessageOutput>;
-
-export const DeleteMessage = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.delete-message`, name: 'Delete Message' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    anchor: AnchoredTo.AnchoredTo,
-    subject: Obj.Unknown,
-    messageId: Schema.String,
-  }),
-  output: DeleteMessageOutput,
-});
-
-/**
- * Restore a deleted thread (inverse of Delete).
- */
-export const Restore = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.restore`, name: 'Restore Thread' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    thread: Thread.Thread.annotations({ description: 'The thread to restore.' }),
-    anchor: AnchoredTo.AnchoredTo.annotations({ description: 'The anchor relation to restore.' }),
-  }),
-  output: Schema.Void,
-});
-
-/**
- * Restore a deleted message (inverse of DeleteMessage).
- */
-export const RestoreMessage = Operation.make({
-  meta: { key: `${THREAD_OPERATION}.restore-message`, name: 'Restore Message' },
-  services: [Capability.Service],
-  input: Schema.Struct({
-    anchor: AnchoredTo.AnchoredTo.annotations({ description: 'The anchor of the thread.' }),
-    message: Message.Message.annotations({ description: 'The message to restore.' }),
-    messageIndex: Schema.Number.annotations({ description: 'The index to restore the message at.' }),
-  }),
-  output: Schema.Void,
-});
-
-export const CreateProposals = Operation.make({
-  meta: {
-    key: 'org.dxos.function.thread.create-proposals',
-    name: 'Create Proposals',
-    description: 'Proposes a set of changes to a document.',
-  },
-  input: Schema.Struct({
-    doc: Ref.Ref(Markdown.Document).annotations({
-      description: 'The ID of the document.',
-    }),
-    diffs: Schema.Array(Schema.String).annotations({
-      description: 'The diffs to propose for the document.',
-    }),
-  }),
-  output: Schema.Void,
-  services: [Database.Service],
-});

package/src/operations/delete-message.ts

@@ -1,53 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Obj, Relation } from '@dxos/echo';
-import { invariant } from '@dxos/invariant';
-import { Operation } from '@dxos/operation';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
-import { Thread } from '@dxos/types';
-
-import { Delete, DeleteMessage } from './definitions';
-
-const handler: Operation.WithHandler<typeof DeleteMessage> = 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(Delete, { subject, anchor });
-        return { messageIndex: -1 };
-      }
-
-      Obj.change(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;

package/src/operations/delete.ts

@@ -1,63 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Capabilities, Capability } from '@dxos/app-framework';
-import { sleep } from '@dxos/async';
-import { Obj, Relation } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
-import { Thread } from '@dxos/types';
-
-import { ThreadCapabilities } from '../types';
-import { Delete } from './definitions';
-
-const handler: Operation.WithHandler<typeof Delete> = Delete.pipe(
-  Operation.withHandler(
-    Effect.fnUntraced(function* ({ subject, anchor, thread: _thread }) {
-      const registry = yield* Capability.get(Capabilities.AtomRegistry);
-      const stateAtom = yield* Capability.get(ThreadCapabilities.State);
-      const thread = _thread ?? (Relation.getSource(anchor) as Thread.Thread);
-      const subjectId = Obj.getDXN(subject).toString();
-      const state = registry.get(stateAtom);
-      const draft = state.drafts[subjectId];
-      if (draft) {
-        const index = draft.findIndex((a: { id: string }) => a.id === anchor.id);
-        if (index !== -1) {
-          registry.set(stateAtom, {
-            ...state,
-            drafts: {
-              ...state.drafts,
-              [subjectId]: state.drafts[subjectId]?.filter((_, i) => i !== index),
-            },
-          });
-          return {};
-        }
-      }
-
-      const db = Obj.getDatabase(thread);
-      if (!db) {
-        return {};
-      }
-
-      // TODO(wittjosiah): Without sleep, rendering crashes at `Relation.setSource(anchor)`.
-      db.remove(anchor);
-      yield* Effect.promise(() => sleep(100));
-      db.remove(thread);
-
-      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
-        name: 'threads.delete',
-        properties: {
-          spaceId: db.spaceId,
-          threadId: thread.id,
-        },
-      });
-
-      return { thread, anchor };
-    }),
-  ),
-);
-
-export default handler;

package/src/operations/on-create-space.ts

@@ -1,27 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Operation } from '@dxos/operation';
-
-import { CreateChannel, OnCreateSpace } from './definitions';
-
-const handler: Operation.WithHandler<typeof OnCreateSpace> = OnCreateSpace.pipe(
-  Operation.withHandler(
-    Effect.fnUntraced(function* ({ space, isDefault }) {
-      if (isDefault) {
-        return;
-      }
-
-      const { object: channel } = yield* Operation.invoke(CreateChannel, {
-        name: 'General',
-        spaceId: space.id,
-      });
-      space.db.add(channel);
-    }),
-  ),
-);
-
-export default handler;

package/src/operations/restore-message.ts

@@ -1,38 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Obj, Ref, Relation } from '@dxos/echo';
-import { invariant } from '@dxos/invariant';
-import { Operation } from '@dxos/operation';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
-import { Thread } from '@dxos/types';
-
-import { RestoreMessage } from './definitions';
-
-const handler: Operation.WithHandler<typeof RestoreMessage> = RestoreMessage.pipe(
-  Operation.withHandler(
-    Effect.fnUntraced(function* ({ anchor, message, messageIndex }) {
-      const thread = Relation.getSource(anchor) as Thread.Thread;
-      const db = Obj.getDatabase(thread);
-      invariant(db, 'Database not found');
-
-      Obj.change(thread, (thread) => {
-        thread.messages.splice(messageIndex, 0, Ref.make(message));
-      });
-
-      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
-        name: 'threads.message.undo-delete',
-        properties: {
-          spaceId: db.spaceId,
-          threadId: thread.id,
-          messageId: message.id,
-        },
-      });
-    }),
-  ),
-);
-
-export default handler;

package/src/operations/restore.ts

@@ -1,38 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { sleep } from '@dxos/async';
-import { Obj } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
-
-import { Restore } from './definitions';
-
-const handler: Operation.WithHandler<typeof Restore> = Restore.pipe(
-  Operation.withHandler(
-    Effect.fnUntraced(function* ({ thread, anchor }) {
-      const db = Obj.getDatabase(thread);
-      if (!db) {
-        return;
-      }
-
-      // TODO(wittjosiah): Without sleep, rendering crashes at `Relation.setSource(anchor)`.
-      db.add(thread);
-      yield* Effect.promise(() => sleep(100));
-      db.add(anchor);
-
-      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
-        name: 'threads.undo-delete',
-        properties: {
-          spaceId: db.spaceId,
-          threadId: thread.id,
-        },
-      });
-    }),
-  ),
-);
-
-export default handler;

package/src/operations/select.ts

@@ -1,24 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Capabilities, Capability } from '@dxos/app-framework';
-import { Operation } from '@dxos/operation';
-
-import { ThreadCapabilities } from '../types';
-import { Select } from './definitions';
-
-const handler: Operation.WithHandler<typeof Select> = Select.pipe(
-  Operation.withHandler(
-    Effect.fnUntraced(function* (input) {
-      const registry = yield* Capability.get(Capabilities.AtomRegistry);
-      const stateAtom = yield* Capability.get(ThreadCapabilities.State);
-      const current = registry.get(stateAtom);
-      registry.set(stateAtom, { ...current, current: input.current });
-    }),
-  ),
-);
-
-export default handler;

package/src/operations/toggle-resolved.ts

@@ -1,41 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Obj } from '@dxos/echo';
-import { invariant } from '@dxos/invariant';
-import { Operation } from '@dxos/operation';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
-
-import { ToggleResolved } from './definitions';
-
-const handler: Operation.WithHandler<typeof ToggleResolved> = ToggleResolved.pipe(
-  Operation.withHandler(
-    Effect.fnUntraced(function* (input) {
-      const thread = input.thread;
-
-      Obj.change(thread, (thread) => {
-        if (thread.status === 'active' || thread.status === undefined) {
-          thread.status = 'resolved';
-        } else if (thread.status === 'resolved') {
-          thread.status = 'active';
-        }
-      });
-
-      const db = Obj.getDatabase(thread);
-      invariant(db, 'Database not found');
-
-      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
-        name: 'threads.toggle-resolved',
-        properties: {
-          spaceId: db.spaceId,
-          threadId: thread.id,
-        },
-      });
-    }),
-  ),
-);
-
-export default handler;

package/src/testing/data.ts

@@ -1,49 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { Obj, Ref } from '@dxos/echo';
-import { IdentityDid } from '@dxos/keys';
-import { random } from '@dxos/random';
-import { type Identity } from '@dxos/react-client/halo';
-import { Message, Thread } from '@dxos/types';
-
-export const createCommentThread = (identity: Identity): Thread.Thread => {
-  return Thread.make({
-    name: 'Comment',
-    messages: random.helpers.multiple(
-      () =>
-        Ref.make(
-          Obj.make(Message.Message, {
-            created: new Date().toISOString(),
-            sender: {
-              identityDid: random.datatype.boolean() ? identity.did : IdentityDid.random(),
-            },
-            blocks: [{ _tag: 'text', text: random.lorem.sentences(3) }],
-          }),
-        ),
-      { count: { min: 2, max: 3 } },
-    ),
-    status: 'active',
-  });
-};
-
-export const createProposalThread = (identity: Identity): Thread.Thread => {
-  return Thread.make({
-    name: 'Proposal',
-    messages: random.helpers.multiple(
-      () =>
-        Ref.make(
-          Obj.make(Message.Message, {
-            created: new Date().toISOString(),
-            sender: {
-              identityDid: random.datatype.boolean() ? identity.did : IdentityDid.random(),
-            },
-            blocks: [{ _tag: 'proposal', text: random.lorem.sentences(3) }],
-          }),
-        ),
-      { count: { min: 1, max: 1 } },
-    ),
-    status: 'active',
-  });
-};

package/src/testing/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './stories';

package/src/testing/stories.ts

@@ -1,51 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { type Plugin } from '@dxos/app-framework';
-import { ClientPlugin } from '@dxos/plugin-client';
-import { SpacePlugin } from '@dxos/plugin-space';
-import { corePlugins } from '@dxos/plugin-testing';
-import { Config } from '@dxos/react-client';
-
-import { Channel } from '#types';
-
-import { ThreadPlugin } from '../ThreadPlugin';
-
-export const createThreadPlugins = async (): Promise<Array<Plugin.Plugin>> => [
-  ...corePlugins(),
-  ClientPlugin({
-    onClientInitialized: ({ client }) =>
-      Effect.gen(function* () {
-        yield* Effect.promise(() => client.halo.createIdentity({ displayName: 'Test User' }));
-      }),
-    onSpacesReady: ({ client }) =>
-      Effect.gen(function* () {
-        const space = client.spaces.get()[0];
-        space.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({}),
-  ThreadPlugin(),
-];

package/src/types/Channel.ts

@@ -1,37 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-// @import-as-namespace
-
-import * as Schema from 'effect/Schema';
-
-import { Annotation, Obj, Ref, Type } from '@dxos/echo';
-import { FormInputAnnotation } from '@dxos/echo/internal';
-import { Thread } from '@dxos/types';
-
-// TODO(burdon): What is the difference between Thread and Channel.
-export const Channel = Schema.Struct({
-  name: Schema.optional(Schema.String),
-  defaultThread: Ref.Ref(Thread.Thread).pipe(FormInputAnnotation.set(false)),
-  // TODO(wittjosiah): Should be an "ordered collection".
-  threads: Ref.Ref(Thread.Thread).pipe(Schema.Array, FormInputAnnotation.set(false)),
-}).pipe(
-  Type.object({
-    typename: 'org.dxos.type.channel',
-    version: '0.1.0',
-  }),
-  Annotation.IconAnnotation.set({
-    icon: 'ph--hash--regular',
-    hue: 'rose',
-  }),
-);
-
-export interface Channel extends Schema.Schema.Type<typeof 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/Settings.ts

@@ -1,10 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-// @import-as-namespace
-
-import * as Schema from 'effect/Schema';
-
-export const Settings = Schema.mutable(Schema.Struct({}));
-export interface Settings extends Schema.Schema.Type<typeof Settings> {}

package/src/types/capabilities.ts

@@ -1,36 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type Atom } from '@effect-atom/atom-react';
-
-import { Capability } from '@dxos/app-framework';
-
-import { meta } from '#meta';
-
-import { type CallManager, type CallState, type MediaState } from '../calls';
-import { type Channel, type ThreadState, type ViewStore } from '../types';
-import * as Settings from './Settings';
-
-export namespace ThreadCapabilities {
-  export const Settings = Capability.make<Atom.Writable<Settings.Settings>>(`${meta.id}.capability.settings`);
-  export const CallManager = Capability.make<CallManager>(`${meta.id}.capability.call-manager`);
-
-  // TODO(burdon): Better way to define specific extensions for meeting companions.
-  // TODO(burdon): This brings in deps from ../calls; how should we manage/minimize explicit type exposure to other plugins?
-  // TODO(wittjosiah): These callbacks could be intents once we support broadcast.
-  export type CallProperties = {
-    onJoin: (state: { channel?: Channel.Channel; roomId?: string }) => Promise<void>;
-    onLeave: (roomId?: string) => Promise<void>;
-    onCallStateUpdated: (callState: CallState) => Promise<void>;
-    onMediaStateUpdated: ([mediaState, isSpeaking]: [MediaState, boolean]) => Promise<void>;
-  };
-
-  export const CallExtension = Capability.make<CallProperties>(`${meta.id}.capability.call-extension`);
-
-  /** Thread state (drafts, toolbar state, current selection). */
-  export const State = Capability.make<Atom.Writable<ThreadState>>(`${meta.id}.capability.state`);
-
-  /** Per-subject view state (e.g., showResolvedThreads). */
-  export const ViewState = Capability.make<Atom.Writable<ViewStore>>(`${meta.id}.capability.view-state`);
-}

package/src/types/types.ts

@@ -1,24 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import { AnchoredTo, Thread } from '@dxos/types';
-
-export * as Settings from './Settings';
-
-export interface ThreadModel {
-  root: Thread.Thread;
-}
-
-type SubjectId = string;
-export type ViewState = { showResolvedThreads: boolean };
-export type ViewStore = Record<SubjectId, ViewState>;
-
-export type ThreadState = {
-  /** Object toolbar state. */
-  toolbar: Record<string, boolean>;
-  /** In-memory draft threads. */
-  // TODO(burdon): Drafts are getting lost.
-  drafts: Record<string, AnchoredTo.AnchoredTo[]>;
-  current?: string | undefined;
-};