@dxos/plugin-transcription 0.8.4-main.fd6878d → 0.9.0

package/package.json

@@ -1,118 +1,186 @@
 {
   "name": "@dxos/plugin-transcription",
-  "version": "0.8.4-main.fd6878d",
+  "version": "0.9.0",
   "description": "Voice transcription.",
   "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",
   "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/TranscriptionPlugin.workerd.ts",
+        "node": "./src/TranscriptionPlugin.node.ts",
+        "default": "./src/TranscriptionPlugin.tsx"
+      },
+      "types": "./dist/types/src/TranscriptionPlugin.d.ts",
+      "workerd": "./dist/lib/neutral/TranscriptionPlugin.workerd.mjs",
+      "node": "./dist/lib/neutral/TranscriptionPlugin.node.mjs",
+      "default": "./dist/lib/neutral/TranscriptionPlugin.mjs"
+    },
+    "#testing": "./src/testing/index.ts",
+    "#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"
+    },
+    "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
+    "./blueprints": {
+      "source": "./src/blueprints/index.ts",
+      "types": "./dist/types/src/blueprints/index.d.ts",
+      "default": "./dist/lib/neutral/blueprints/index.mjs"
+    },
+    "./components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
+    },
+    "./hooks": {
+      "source": "./src/hooks/index.ts",
+      "types": "./dist/types/src/hooks/index.d.ts",
+      "default": "./dist/lib/neutral/hooks/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": {
       "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"
+      "default": "./dist/lib/neutral/types/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
-    "src"
+    "src",
+    "PLUGIN.mdl"
   ],
   "dependencies": {
-    "@codemirror/state": "^6.4.1",
-    "@codemirror/view": "^6.34.1",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
-    "date-fns": "^3.3.1",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.43.0",
+    "@radix-ui/react-primitive": "2.0.2",
+    "@radix-ui/react-slot": "1.1.2",
+    "date-fns": "^3.6.0",
     "extendable-media-recorder": "^9.2.19",
     "extendable-media-recorder-wav-encoder": "^7.0.123",
-    "main-thread-scheduling": "^14.1.1",
-    "react-resize-detector": "^11.0.1",
-    "react-router-dom": "^6.4.0",
-    "react-use": "^17.5.1",
     "wavefile": "^11.0.0",
-    "@dxos/ai": "0.8.4-main.fd6878d",
-    "@dxos/app-framework": "0.8.4-main.fd6878d",
-    "@dxos/assistant": "0.8.4-main.fd6878d",
-    "@dxos/async": "0.8.4-main.fd6878d",
-    "@dxos/client": "0.8.4-main.fd6878d",
-    "@dxos/blueprints": "0.8.4-main.fd6878d",
-    "@dxos/codec-protobuf": "0.8.4-main.fd6878d",
-    "@dxos/context": "0.8.4-main.fd6878d",
-    "@dxos/debug": "0.8.4-main.fd6878d",
-    "@dxos/display-name": "0.8.4-main.fd6878d",
-    "@dxos/echo": "0.8.4-main.fd6878d",
-    "@dxos/echo-db": "0.8.4-main.fd6878d",
-    "@dxos/functions": "0.8.4-main.fd6878d",
-    "@dxos/echo-schema": "0.8.4-main.fd6878d",
-    "@dxos/invariant": "0.8.4-main.fd6878d",
-    "@dxos/keys": "0.8.4-main.fd6878d",
-    "@dxos/live-object": "0.8.4-main.fd6878d",
-    "@dxos/log": "0.8.4-main.fd6878d",
-    "@dxos/plugin-client": "0.8.4-main.fd6878d",
-    "@dxos/local-storage": "0.8.4-main.fd6878d",
-    "@dxos/plugin-deck": "0.8.4-main.fd6878d",
-    "@dxos/plugin-graph": "0.8.4-main.fd6878d",
-    "@dxos/plugin-space": "0.8.4-main.fd6878d",
-    "@dxos/plugin-markdown": "0.8.4-main.fd6878d",
-    "@dxos/plugin-thread": "0.8.4-main.fd6878d",
-    "@dxos/protocols": "0.8.4-main.fd6878d",
-    "@dxos/react-client": "0.8.4-main.fd6878d",
-    "@dxos/react-edge-client": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-attention": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-components": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-form": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-editor": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-grid": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-stack": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-sfx": "0.8.4-main.fd6878d",
-    "@dxos/schema": "0.8.4-main.fd6878d",
-    "@dxos/tracing": "0.8.4-main.fd6878d",
-    "@dxos/util": "0.8.4-main.fd6878d"
+    "@dxos/ai": "0.9.0",
+    "@dxos/app-toolkit": "0.9.0",
+    "@dxos/app-framework": "0.9.0",
+    "@dxos/async": "0.9.0",
+    "@dxos/assistant": "0.9.0",
+    "@dxos/client": "0.9.0",
+    "@dxos/compute": "0.9.0",
+    "@dxos/effect": "0.9.0",
+    "@dxos/echo": "0.9.0",
+    "@dxos/functions-runtime": "0.9.0",
+    "@dxos/invariant": "0.9.0",
+    "@dxos/log": "0.9.0",
+    "@dxos/plugin-client": "0.9.0",
+    "@dxos/keys": "0.9.0",
+    "@dxos/plugin-calls": "0.9.0",
+    "@dxos/react-edge-client": "0.9.0",
+    "@dxos/react-client": "0.9.0",
+    "@dxos/react-ui-audio": "0.9.0",
+    "@dxos/react-ui-components": "0.9.0",
+    "@dxos/react-ui-graph": "0.9.0",
+    "@dxos/react-ui-editor": "0.9.0",
+    "@dxos/context": "0.9.0",
+    "@dxos/react-ui-menu": "0.9.0",
+    "@dxos/tracing": "0.9.0",
+    "@dxos/types": "0.9.0",
+    "@dxos/schema": "0.9.0",
+    "@dxos/ui-types": "0.9.0",
+    "@dxos/ui-editor": "0.9.0",
+    "@dxos/util": "0.9.0"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "0.38.0",
-    "@effect/platform": "0.90.2",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.96.1",
     "@types/dom-speech-recognition": "^0.0.6",
-    "@types/react": "~18.2.0",
-    "effect": "3.17.7",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "tailwindcss": "~3.4.1",
-    "@dxos/plugin-storybook-layout": "0.8.4-main.fd6878d",
-    "@dxos/plugin-preview": "0.8.4-main.fd6878d",
-    "@dxos/plugin-theme": "0.8.4-main.fd6878d",
-    "@dxos/react-ui": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-form": "0.8.4-main.fd6878d",
-    "@dxos/random": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-theme": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.fd6878d",
-    "@dxos/storybook-utils": "0.8.4-main.fd6878d",
-    "@dxos/test-utils": "0.8.4-main.fd6878d"
+    "@types/react": "~19.2.7",
+    "effect": "3.21.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "tailwindcss": "^4.3.0",
+    "@dxos/plugin-preview": "0.9.0",
+    "@dxos/plugin-testing": "0.9.0",
+    "@dxos/random": "0.9.0",
+    "@dxos/plugin-theme": "0.9.0",
+    "@dxos/react-ui": "0.9.0",
+    "@dxos/react-ui-form": "0.9.0",
+    "@dxos/react-ui-syntax-highlighter": "0.9.0",
+    "@dxos/storybook-utils": "0.9.0",
+    "@dxos/ui-theme": "0.9.0",
+    "@dxos/test-utils": "0.9.0"
   },
   "peerDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.4-main.fd6878d",
-    "@dxos/react-ui-theme": "0.8.4-main.fd6878d"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.96.1",
+    "effect": "3.21.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/ui-theme": "0.9.0",
+    "@dxos/react-ui": "0.9.0"
   },
   "publishConfig": {
     "access": "public"

package/src/TranscriptionPlugin.node.ts

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

package/src/TranscriptionPlugin.test.ts

@@ -0,0 +1,31 @@
+//
+// 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 { meta } from '#meta';
+import { TranscriptionPlugin } from '#plugin';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('TranscriptionPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [ClientPlugin({}), TranscriptionPlugin()],
+    });
+
+    // After autoStart: schema, OperationHandler all auto-cascade.
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('schema'), moduleId('OperationHandler')]),
+    );
+
+    // 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'));
+  });
+});

package/src/TranscriptionPlugin.tsx

@@ -2,66 +2,33 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, defineModule, definePlugin } from '@dxos/app-framework';
-import { Obj } from '@dxos/echo';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
-import { getSpace } from '@dxos/react-client/echo';
-import { DataType } from '@dxos/schema';
+import { Plugin } from '@dxos/app-framework';
+import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
+import { Transcript } from '@dxos/types';
 
-import { IntentResolver, ReactSurface, Transcriber } from './capabilities';
-import { renderMarkdown } from './components';
-import { meta } from './meta';
-import { translations } from './translations';
-import { TranscriptType } from './types';
+import { BlueprintDefinition, OperationHandler, ReactSurface, TextContent, Transcriber } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
 
-export const TranscriptionPlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/metadata`,
-      activatesOn: Events.SetupMetadata,
-      activate: (context) =>
-        contributes(Capabilities.Metadata, {
-          id: TranscriptType.typename,
-          metadata: {
-            icon: 'ph--subtitles--regular',
-            // TODO(wittjosiah): Factor out. Artifact? Separate capability?
-            getTextContent: async (transcript: TranscriptType) => {
-              const space = getSpace(transcript);
-              const members = space?.members.get().map((member) => member.identity) ?? [];
-              const queue = space?.queues.get<DataType.Message>(transcript.queue.dxn);
-              await queue?.refresh();
-              const content = queue?.objects
-                .filter((message) => Obj.instanceOf(DataType.Message, message))
-                .flatMap((message, index) => renderMarkdown(members)(message, index))
-                .join('\n\n');
-              return content;
-            },
-          },
-        }),
-    }),
-    defineModule({
-      id: `${meta.id}/module/schema`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () => [contributes(ClientCapabilities.Schema, [TranscriptType])],
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-    defineModule({
-      id: `${meta.id}/module/intent-resolver`,
-      activatesOn: Events.SetupIntentResolver,
-      activate: IntentResolver,
-    }),
-    defineModule({
-      id: `${meta.id}/module/transcription`,
-      activatesOn: Events.SetupAppGraph,
-      activate: Transcriber,
-    }),
-  ]);
+// eslint-disable-next-line import/no-relative-packages
+import pluginSpec from '../PLUGIN.mdl?raw';
+
+export const TranscriptionPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addTextContentModule({ activate: TextContent }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addSchemaModule({ schema: [Transcript.Transcript] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
+  Plugin.addModule({
+    id: 'transcription',
+    activatesOn: AppActivationEvents.SetupAppGraph,
+    activate: Transcriber,
+  }),
+  AppPlugin.addPluginAssetModule({
+    asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
+  }),
+  Plugin.make,
+);
+
+export default TranscriptionPlugin;

package/src/TranscriptionPlugin.workerd.ts

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

package/src/blueprints/index.ts

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

package/src/blueprints/transcription-blueprint.ts

@@ -0,0 +1,29 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Blueprint, Template } from '@dxos/compute';
+import { trim } from '@dxos/util';
+
+import { TranscriptOperation } from '#types';
+
+const BLUEPRINT_KEY = 'org.dxos.blueprint.transcription';
+
+const make = () =>
+  Blueprint.make({
+    key: BLUEPRINT_KEY,
+    name: 'Transcription',
+    tools: Blueprint.toolDefinitions({ operations: [TranscriptOperation.Open, TranscriptOperation.Summarize] }),
+    instructions: Template.make({
+      source: trim`
+        You can open and summarize a meeting transcript.
+      `,
+    }),
+  });
+
+const blueprint: Blueprint.Definition = {
+  key: BLUEPRINT_KEY,
+  make,
+};
+
+export default blueprint;

package/src/capabilities/blueprint-definition.ts

@@ -0,0 +1,19 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+
+import { TranscriptionBlueprint } from '#blueprints';
+
+// NOTE: Explicit annotation required: d.ts emit cannot portably name the inferred @dxos/compute types (TS2883).
+const blueprintDefinition: () => Effect.Effect<
+  Capability.Capability<typeof AppCapabilities.BlueprintDefinition>[],
+  never,
+  Capability.Service
+> = () => Effect.succeed([Capability.contributes(AppCapabilities.BlueprintDefinition, TranscriptionBlueprint)]);
+
+export default blueprintDefinition;

package/src/capabilities/index.ts

@@ -2,10 +2,20 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
+import { Capability } from '@dxos/app-framework';
+import { type AppCapabilities } from '@dxos/app-toolkit';
+import type { OperationHandlerSet } from '@dxos/compute';
 
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
-export const Transcriber = lazy(() => import('./transcriber'));
-
-export * from './capabilities';
+// The contributed capability type references Blueprint types from @dxos/compute, so the lazy
+// wrapper needs an explicit annotation to keep the inferred type portable (TS2883).
+export const BlueprintDefinition: Capability.LazyCapability<
+  void,
+  Capability.Capability<typeof AppCapabilities.BlueprintDefinition>[]
+> = Capability.lazy('BlueprintDefinition', () => import('./blueprint-definition'));
+export const TextContent = Capability.lazy('TextContent', () => import('./text-content'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const Transcriber = Capability.lazy('Transcriber', () => import('./transcriber'));

package/src/capabilities/operation-handler.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import type { OperationHandlerSet } from '@dxos/compute';
+
+import { TranscriptionOperationHandlerSet } from '#operations';
+
+export default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Capabilities.OperationHandler, TranscriptionOperationHandlerSet);
+  }),
+);

package/src/capabilities/react-surface.tsx

@@ -2,21 +2,30 @@
 // Copyright 2025 DXOS.org
 //
 
+import * as Effect from 'effect/Effect';
 import React from 'react';
 
-import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
-import { Obj } from '@dxos/echo';
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
+import { Transcript } from '@dxos/types';
 
-import { TranscriptionContainer } from '../components';
-import { meta } from '../meta';
-import { TranscriptType } from '../types';
+import { TranscriptionArticle } from '#containers';
 
-export default () =>
-  contributes(Capabilities.ReactSurface, [
-    createSurface({
-      id: `${meta.id}/article/transcript`,
-      role: ['article', 'section'],
-      filter: (data): data is { subject: TranscriptType } => Obj.instanceOf(TranscriptType, data.subject),
-      component: ({ data, role }) => <TranscriptionContainer transcript={data.subject} role={role} />,
-    }),
-  ]);
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Capabilities.ReactSurface, [
+      Surface.create({
+        id: 'article.transcript',
+        // TODO(wittjosiah): Split into multiple surfaces if this filter proves too strict for non-article roles.
+        filter: AppSurface.oneOf(
+          AppSurface.object(AppSurface.Article, Transcript.Transcript),
+          AppSurface.object(AppSurface.Section, Transcript.Transcript),
+        ),
+        component: ({ data, role }) => (
+          <TranscriptionArticle role={role} subject={data.subject} attendableId={data.attendableId} />
+        ),
+      }),
+    ]),
+  ),
+);

package/src/capabilities/text-content.ts

@@ -0,0 +1,33 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+import { Feed, Obj, Type } from '@dxos/echo';
+import { getSpace } from '@dxos/react-client/echo';
+import { Message, Transcript } from '@dxos/types';
+
+import { renderByline } from '../util';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(AppCapabilities.TextContent, {
+      id: Type.getTypename(Transcript.Transcript),
+      getTextContent: async (transcript: Transcript.Transcript) => {
+        const space = getSpace(transcript);
+        const members = space?.members.get().map((member) => member.identity) ?? [];
+        const feed = await transcript.feed.load();
+        const feedDXN = Feed.getQueueUri(feed);
+        const queue = feedDXN ? space?.queues.get<Message.Message>(feedDXN) : undefined;
+        await queue?.refresh();
+        return queue?.objects
+          .filter((message) => Obj.instanceOf(Message.Message, message))
+          .flatMap((message, index) => renderByline(members)(message, index))
+          .join('\n\n');
+      },
+    });
+  }),
+);