@dxos/plugin-thread 0.8.4-main.e8ec1fe → 0.8.4-main.effb148878

package/package.json

@@ -1,117 +1,184 @@
 {
   "name": "@dxos/plugin-thread",
-  "version": "0.8.4-main.e8ec1fe",
+  "version": "0.8.4-main.effb148878",
   "description": "DXOS Threads Surface plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
-  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#blueprints": {
+      "source": "./src/blueprints/index.ts",
+      "types": "./dist/types/src/blueprints/index.d.ts",
+      "default": "./dist/lib/neutral/blueprints/index.mjs"
+    },
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
+    },
+    "#components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
+    },
+    "#containers": {
+      "source": "./src/containers/index.ts",
+      "types": "./dist/types/src/containers/index.d.ts",
+      "default": "./dist/lib/neutral/containers/index.mjs"
+    },
+    "#hooks": {
+      "source": "./src/hooks/index.ts",
+      "types": "./dist/types/src/hooks/index.d.ts",
+      "default": "./dist/lib/neutral/hooks/index.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#operations": {
+      "source": "./src/operations/index.ts",
+      "types": "./dist/types/src/operations/index.d.ts",
+      "default": "./dist/lib/neutral/operations/index.mjs"
+    },
+    "#plugin": {
+      "source": {
+        "workerd": "./src/ThreadPlugin.workerd.ts",
+        "node": "./src/ThreadPlugin.node.ts",
+        "default": "./src/ThreadPlugin.tsx"
+      },
+      "types": "./dist/types/src/ThreadPlugin.d.ts",
+      "workerd": "./dist/lib/neutral/ThreadPlugin.workerd.mjs",
+      "node": "./dist/lib/neutral/ThreadPlugin.node.mjs",
+      "default": "./dist/lib/neutral/ThreadPlugin.mjs"
+    },
+    "#testing": {
+      "source": "./src/testing/index.ts",
+      "types": "./dist/types/src/testing/index.d.ts",
+      "default": "./dist/lib/neutral/testing/index.mjs"
+    },
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    },
+    "#types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "default": "./dist/lib/neutral/types/index.mjs"
+    }
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "default": "./dist/lib/neutral/index.mjs"
     },
-    "./types": {
-      "source": "./src/types/index.ts",
-      "types": "./dist/types/src/types/index.d.ts",
-      "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs"
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
-    "@codemirror/language": "^6.11.3",
-    "@codemirror/state": "^6.5.2",
-    "@codemirror/view": "^6.38.4",
-    "@effect/ai": "0.29.1",
-    "@effect/experimental": "0.56.0",
-    "@peermetrics/webrtc-stats": "5.7.1",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
-    "date-fns": "^3.3.1",
-    "extendable-media-recorder": "^9.2.19",
-    "extendable-media-recorder-wav-encoder": "^7.0.123",
-    "md5-hex": "5.0.0",
-    "react-resize-detector": "^11.0.1",
-    "wavefile": "^11.0.0",
-    "@dxos/assistant": "0.8.4-main.e8ec1fe",
-    "@dxos/async": "0.8.4-main.e8ec1fe",
-    "@dxos/app-framework": "0.8.4-main.e8ec1fe",
-    "@dxos/codec-protobuf": "0.8.4-main.e8ec1fe",
-    "@dxos/blueprints": "0.8.4-main.e8ec1fe",
-    "@dxos/context": "0.8.4-main.e8ec1fe",
-    "@dxos/display-name": "0.8.4-main.e8ec1fe",
-    "@dxos/devtools": "0.8.4-main.e8ec1fe",
-    "@dxos/echo": "0.8.4-main.e8ec1fe",
-    "@dxos/echo-db": "0.8.4-main.e8ec1fe",
-    "@dxos/functions": "0.8.4-main.e8ec1fe",
-    "@dxos/invariant": "0.8.4-main.e8ec1fe",
-    "@dxos/local-storage": "0.8.4-main.e8ec1fe",
-    "@dxos/live-object": "0.8.4-main.e8ec1fe",
-    "@dxos/log": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-attention": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-client": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-deck": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-graph": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-markdown": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-observability": "0.8.4-main.e8ec1fe",
-    "@dxos/keys": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-space": "0.8.4-main.e8ec1fe",
-    "@dxos/debug": "0.8.4-main.e8ec1fe",
-    "@dxos/react-client": "0.8.4-main.e8ec1fe",
-    "@dxos/protocols": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-attention": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-dnd": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-editor": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-form": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-menu": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-sfx": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-stack": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-thread": "0.8.4-main.e8ec1fe",
-    "@dxos/schema": "0.8.4-main.e8ec1fe",
-    "@dxos/types": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-tabs": "0.8.4-main.e8ec1fe",
-    "@dxos/util": "0.8.4-main.e8ec1fe"
+    "@codemirror/language": "^6.12.3",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.43.0",
+    "@effect-atom/atom": "^0.5.1",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/ai": "0.33.2",
+    "@effect/ai-anthropic": "0.23.0",
+    "@effect/experimental": "0.58.0",
+    "date-fns": "^3.6.0",
+    "@dxos/ai": "0.8.4-main.effb148878",
+    "@dxos/app-framework": "0.8.4-main.effb148878",
+    "@dxos/app-toolkit": "0.8.4-main.effb148878",
+    "@dxos/assistant": "0.8.4-main.effb148878",
+    "@dxos/client-protocol": "0.8.4-main.effb148878",
+    "@dxos/async": "0.8.4-main.effb148878",
+    "@dxos/codec-protobuf": "0.8.4-main.effb148878",
+    "@dxos/compute": "0.8.4-main.effb148878",
+    "@dxos/context": "0.8.4-main.effb148878",
+    "@dxos/debug": "0.8.4-main.effb148878",
+    "@dxos/devtools": "0.8.4-main.effb148878",
+    "@dxos/display-name": "0.8.4-main.effb148878",
+    "@dxos/echo-db": "0.8.4-main.effb148878",
+    "@dxos/echo": "0.8.4-main.effb148878",
+    "@dxos/effect": "0.8.4-main.effb148878",
+    "@dxos/echo-react": "0.8.4-main.effb148878",
+    "@dxos/invariant": "0.8.4-main.effb148878",
+    "@dxos/keys": "0.8.4-main.effb148878",
+    "@dxos/log": "0.8.4-main.effb148878",
+    "@dxos/operation": "0.8.4-main.effb148878",
+    "@dxos/plugin-attention": "0.8.4-main.effb148878",
+    "@dxos/plugin-calls": "0.8.4-main.effb148878",
+    "@dxos/plugin-client": "0.8.4-main.effb148878",
+    "@dxos/plugin-graph": "0.8.4-main.effb148878",
+    "@dxos/plugin-deck": "0.8.4-main.effb148878",
+    "@dxos/plugin-markdown": "0.8.4-main.effb148878",
+    "@dxos/plugin-observability": "0.8.4-main.effb148878",
+    "@dxos/plugin-settings": "0.8.4-main.effb148878",
+    "@dxos/plugin-space": "0.8.4-main.effb148878",
+    "@dxos/protocols": "0.8.4-main.effb148878",
+    "@dxos/random": "0.8.4-main.effb148878",
+    "@dxos/react-client": "0.8.4-main.effb148878",
+    "@dxos/react-ui-attention": "0.8.4-main.effb148878",
+    "@dxos/react-ui-editor": "0.8.4-main.effb148878",
+    "@dxos/react-ui-dnd": "0.8.4-main.effb148878",
+    "@dxos/react-ui-form": "0.8.4-main.effb148878",
+    "@dxos/react-ui-menu": "0.8.4-main.effb148878",
+    "@dxos/react-ui-mosaic": "0.8.4-main.effb148878",
+    "@dxos/react-ui-sfx": "0.8.4-main.effb148878",
+    "@dxos/react-ui-stack": "0.8.4-main.effb148878",
+    "@dxos/react-ui-tabs": "0.8.4-main.effb148878",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.effb148878",
+    "@dxos/react-ui-thread": "0.8.4-main.effb148878",
+    "@dxos/schema": "0.8.4-main.effb148878",
+    "@dxos/types": "0.8.4-main.effb148878",
+    "@dxos/ui-editor": "0.8.4-main.effb148878",
+    "@dxos/util": "0.8.4-main.effb148878"
   },
   "devDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "0.92.1",
-    "@types/react": "~19.2.2",
-    "@types/react-dom": "~19.2.2",
-    "effect": "3.18.3",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
-    "vite": "7.1.9",
-    "@dxos/random": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-theme": "0.8.4-main.e8ec1fe",
-    "@dxos/plugin-theme": "0.8.4-main.e8ec1fe",
-    "@dxos/storybook-utils": "0.8.4-main.e8ec1fe"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^8.0.14",
+    "@dxos/echo-atom": "0.8.4-main.effb148878",
+    "@dxos/plugin-theme": "0.8.4-main.effb148878",
+    "@dxos/plugin-testing": "0.8.4-main.effb148878",
+    "@dxos/storybook-utils": "0.8.4-main.effb148878",
+    "@dxos/ui-theme": "0.8.4-main.effb148878",
+    "@dxos/react-ui": "0.8.4-main.effb148878"
   },
   "peerDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.e8ec1fe",
-    "@dxos/react-ui-theme": "0.8.4-main.e8ec1fe"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/ui-theme": "0.8.4-main.effb148878",
+    "@dxos/react-ui": "0.8.4-main.effb148878"
   },
   "publishConfig": {
     "access": "public"

package/src/ThreadPlugin.node.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { SpaceCapabilities, SpaceEvents } from '@dxos/plugin-space';
+import { AnchoredTo, Channel, Message, Thread } from '@dxos/types';
+
+import { AppGraphBuilder, BlueprintDefinition, CreateObject, OperationHandler, UndoMappings } from '#capabilities';
+import { meta } from '#meta';
+import { ThreadOperation } from '#types';
+
+export const ThreadPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addCreateObjectModule({ activate: CreateObject }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addUndoMappingsModule({ activate: UndoMappings }),
+  AppPlugin.addSchemaModule({
+    schema: [AnchoredTo.AnchoredTo, Channel.Channel, Message.Message, Thread.Thread],
+  }),
+  Plugin.addModule({
+    id: 'on-space-created',
+    activatesOn: SpaceEvents.SpaceCreated,
+    activate: () =>
+      Effect.succeed(
+        Capability.contributes(SpaceCapabilities.OnCreateSpace, (params) =>
+          Operation.invoke(ThreadOperation.OnCreateSpace, params),
+        ),
+      ),
+  }),
+  Plugin.make,
+);
+
+export default ThreadPlugin;

package/src/ThreadPlugin.test.ts

@@ -0,0 +1,37 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { AppActivationEvents } from '@dxos/app-toolkit';
+import { ClientPlugin } from '@dxos/plugin-client/plugin';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { ThreadPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('ThreadPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [ClientPlugin({}), ThreadPlugin()],
+    });
+
+    // After autoStart: AppGraphBuilder, CreateObject, schema, OperationHandler, UndoMappings all auto-cascade.
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('AppGraphBuilder'), moduleId('CreateObject'), moduleId('schema')]),
+    );
+
+    // SetupArtifactDefinition is fired by AssistantPlugin, which can't be included here due to a workspace cycle.
+    await harness.fire(AppActivationEvents.SetupArtifactDefinition);
+    expect(harness.manager.getActive()).toContain(moduleId('BlueprintDefinition'));
+
+    // Operation handlers auto-cascade from ProcessManagerPlugin.
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('OperationHandler'), moduleId('UndoMappings')]),
+    );
+  });
+});

package/src/ThreadPlugin.tsx

@@ -2,168 +2,94 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, createIntent, defineModule, definePlugin } from '@dxos/app-framework';
-import { Ref, Type } from '@dxos/echo';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import * as Effect from 'effect/Effect';
+
+import { ActivationEvents, Capability, Plugin } from '@dxos/app-framework';
+import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
 import { MarkdownEvents } from '@dxos/plugin-markdown';
 import { SpaceCapabilities, SpaceEvents } from '@dxos/plugin-space';
-import { defineObjectForm } from '@dxos/plugin-space/types';
-import { translations as threadTranslations } from '@dxos/react-ui-thread';
-import { AnchoredTo, Message, Thread } from '@dxos/types';
+import { translations as threadTranslations } from '@dxos/react-ui-thread/translations';
+import { AnchoredTo, Channel, Message, Thread } from '@dxos/types';
 
 import {
+  AgentRunner,
   AppGraphBuilder,
   BlueprintDefinition,
-  CallManager,
-  IntentResolver,
+  CreateObject,
   Markdown,
-  ReactRoot,
+  OperationHandler,
+  UndoMappings,
   ReactSurface,
   ThreadState,
-} from './capabilities';
-import { THREAD_ITEM, meta } from './meta';
-import { translations } from './translations';
-import { Channel, ThreadAction } from './types';
+} from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
+import { AgentIdentity, DEFAULT_AGENT_IDENTITY, ThreadOperation } from '#types';
 
 // TODO(Zan): Every instance of `cursor` should be replaced with `anchor`.
 //  NOTE(burdon): Review/discuss CursorConverter semantics.
 
 // TODO(wittjosiah): Rename to ChatPlugin.
 // TODO(wittjosiah): Enabling comments should likely be factored out of this plugin but depend on it's capabilities.
-export const ThreadPlugin = definePlugin(meta, () => [
-  defineModule({
-    id: `${meta.id}/module/call-manager`,
-    activatesOn: ClientEvents.ClientReady,
-    activate: CallManager,
+
+export const ThreadPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addCreateObjectModule({ activate: CreateObject }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addUndoMappingsModule({ activate: UndoMappings }),
+  AppPlugin.addSchemaModule({
+    schema: [AnchoredTo.AnchoredTo, Channel.Channel, Message.Message, Thread.Thread],
   }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations: [...translations, ...threadTranslations] }),
   // TODO(wittjosiah): Currently not used but leaving because there will likely be settings for threads again.
-  // defineModule({
-  //   id: `${meta.id}/module/settings`,
+  // Plugin.addModule({
+  //   id: 'settings',
   //   activatesOn: Events.SetupSettings,
   //   activate: ThreadSettings,
   // }),
-  defineModule({
-    id: `${meta.id}/module/state`,
+  Plugin.addModule({
+    id: 'state',
     // TODO(wittjosiah): Does not integrate with settings store.
     //   Should this be a different event?
     //   Should settings store be renamed to be more generic?
-    activatesOn: Events.SetupSettings,
+    activatesOn: AppActivationEvents.SetupSettings,
     activate: ThreadState,
   }),
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, [...translations, ...threadTranslations]),
-  }),
-  defineModule({
-    id: `${meta.id}/module/metadata`,
-    activatesOn: Events.SetupMetadata,
-    activate: () => [
-      contributes(Capabilities.Metadata, {
-        id: Type.getTypename(Channel.Channel),
-        metadata: {
-          icon: 'ph--hash--regular',
-          iconHue: 'rose',
-        },
-      }),
-      contributes(Capabilities.Metadata, {
-        id: Type.getTypename(Thread.Thread),
-        metadata: {
-          // TODO(wittjosiah): Move out of metadata.
-          loadReferences: async (thread: Thread.Thread) => await Ref.Array.loadAll(thread.messages ?? []),
-        },
-      }),
-      contributes(Capabilities.Metadata, {
-        id: Message.Message.typename,
-        metadata: {
-          // TODO(wittjosiah): Move out of metadata.
-          loadReferences: () => [], // loadObjectReferences(message, (message) => [...message.parts, message.context]),
-        },
-      }),
-      contributes(Capabilities.Metadata, {
-        id: THREAD_ITEM,
-        metadata: {
-          parse: (item: Thread.Thread, type: string) => {
-            switch (type) {
-              case 'node':
-                return { id: item.id, label: item.name, data: item };
-              case 'object':
-                return item;
-              case 'view-object':
-                return { id: `${item.id}-view`, object: item };
-            }
-          },
-        },
-      }),
-    ],
-  }),
-  defineModule({
-    id: `${meta.id}/module/object-form`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () =>
-      contributes(
-        SpaceCapabilities.ObjectForm,
-        defineObjectForm({
-          objectSchema: Channel.Channel,
-          getIntent: (_, options) =>
-            createIntent(ThreadAction.CreateChannel, {
-              spaceId: options.space.id,
-            }),
-        }),
-      ),
-  }),
-  defineModule({
-    id: `${meta.id}/module/schema`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () =>
-      contributes(ClientCapabilities.Schema, [
-        AnchoredTo.AnchoredTo,
-        Thread.Thread,
-        Message.Message,
-        Message.MessageV1,
-      ]),
-  }),
-  defineModule({
-    id: `${meta.id}/module/migration`,
-    activatesOn: ClientEvents.SetupMigration,
-    activate: () => contributes(ClientCapabilities.Migration, [Message.MessageV1ToV2]),
-  }),
-  defineModule({
-    id: `${meta.id}/module/on-space-created`,
+  Plugin.addModule({
+    id: 'on-space-created',
     activatesOn: SpaceEvents.SpaceCreated,
     activate: () =>
-      contributes(SpaceCapabilities.onCreateSpace, ({ space, rootCollection }) =>
-        createIntent(ThreadAction.onCreateSpace, { space, rootCollection }),
+      Effect.succeed(
+        Capability.contributes(SpaceCapabilities.OnCreateSpace, (params) =>
+          Operation.invoke(ThreadOperation.OnCreateSpace, params),
+        ),
       ),
   }),
-  defineModule({
-    id: `${meta.id}/module/markdown`,
+  Plugin.addModule({
+    id: 'markdown',
     activatesOn: MarkdownEvents.SetupExtensions,
     activate: Markdown,
   }),
-  defineModule({
-    id: `${meta.id}/module/react-root`,
-    activatesOn: Events.Startup,
-    activate: ReactRoot,
-  }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.SetupReactSurface,
-    activate: ReactSurface,
+  // Default comment-thread agent runner (one-shot LLM call per scheduled turn).
+  // Test/storybook hosts that contribute a stub `AgentRunner` earlier in plugin
+  // order — i.e. before ThreadPlugin in the plugins list — win, because
+  // `Capability.get` returns the first contribution.
+  Plugin.addModule({
+    id: 'agent-runner',
+    activatesOn: ActivationEvents.Startup,
+    activate: AgentRunner,
   }),
-  defineModule({
-    id: `${meta.id}/module/intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: IntentResolver,
+  // Default agent identity. Hosts wanting a different name contribute their own
+  // `AgentIdentity` earlier in plugin order to win the `Capability.get`.
+  Plugin.addModule({
+    id: 'agent-identity',
+    activatesOn: ActivationEvents.Startup,
+    activate: () => Effect.succeed(Capability.contributes(AgentIdentity, DEFAULT_AGENT_IDENTITY)),
   }),
-  defineModule({
-    id: `${meta.id}/module/app-graph-builder`,
-    activatesOn: Events.SetupAppGraph,
-    activate: AppGraphBuilder,
-  }),
-  defineModule({
-    id: `${meta.id}/module/blueprint`,
-    activatesOn: Events.SetupArtifactDefinition,
-    activate: BlueprintDefinition,
-  }),
-]);
+  Plugin.make,
+);
+
+export default ThreadPlugin;

package/src/ThreadPlugin.workerd.ts

@@ -0,0 +1,20 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { AnchoredTo, Channel, Message, Thread } from '@dxos/types';
+
+import { OperationHandler } from '#capabilities';
+import { meta } from '#meta';
+
+export const ThreadPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addSchemaModule({
+    schema: [AnchoredTo.AnchoredTo, Channel.Channel, Message.Message, Thread.Thread],
+  }),
+  Plugin.make,
+);
+
+export default ThreadPlugin;

package/src/blueprints/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export { default as ThreadBlueprint } from './thread-blueprint';

package/src/blueprints/thread-blueprint.ts

@@ -0,0 +1,36 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Blueprint, Template } from '@dxos/compute';
+import { trim } from '@dxos/util';
+
+import { ThreadOperation } from '#types';
+
+const BLUEPRINT_KEY = 'org.dxos.blueprint.thread';
+
+const make = () =>
+  Blueprint.make({
+    key: BLUEPRINT_KEY,
+    name: 'Thread',
+    tools: Blueprint.toolDefinitions({ operations: [ThreadOperation.CreateProposals] }),
+    instructions: Template.make({
+      // TODO(wittjosiah): Move example to function input schema annotation.
+      source: trim`
+        You can update markdown documents via proposals.
+        For each diff, respond with the smallest possible matching span.
+        For example:
+          - "There is a tyop in this sentence."
+          + "There is a typo in this sentence."
+          - "This id goof."
+          + "This is good."
+      `,
+    }),
+  });
+
+const blueprint: Blueprint.Definition = {
+  key: BLUEPRINT_KEY,
+  make,
+};
+
+export default blueprint;