@dxos/plugin-transcription 0.8.2-main.12df754 → 0.8.2-main.36232bc

package/dist/types/src/types/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,OAAO,EAAO,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;IAO3B;;OAEG;;EAGH,CAAC;;;;;;;;;;;;AAEH,qBAAa,cAAe,SAAQ,mBAGT;CAAG;AAI9B;;;GAGG;AACH,QAAA,MAAM,gBAAgB;;EAEpB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEtE;;GAEG;AACH,QAAA,MAAM,iBAAiB;;;EAIrB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;GAKwD,CAAC;AAErF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAO,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;IAO3B;;OAEG;;EAGH,CAAC;;;;;;;;;;;;AAEH,qBAAa,cAAe,SAAQ,mBAGT;CAAG;AAI9B;;;GAGG;AACH,QAAA,MAAM,gBAAgB;;EAEpB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/types/src/types/types.d.ts

@@ -10,7 +10,7 @@ export declare namespace TranscriptionAction {
     } & {
         input: S.Struct<{
             name: S.optional<typeof S.String>;
-            spaceId: typeof S.String;
+            spaceId: S.Schema<import("@dxos/keys").SpaceId, string, never>;
         }>;
         output: S.Struct<{
             object: typeof TranscriptType;
@@ -21,4 +21,8 @@ export declare namespace TranscriptionAction {
     export {};
 }
 export declare const isTranscript: (object: unknown) => object is typeof TranscriptType;
+export declare const TranscriptionSettingsSchema: S.mutable<S.Struct<{
+    entityExtraction: S.PropertySignature<"?:", boolean | undefined, never, "?:", boolean | undefined, true, never>;
+}>>;
+export type TranscriptionSettingsProps = S.Schema.Type<typeof TranscriptionSettingsSchema>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types/src/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAgB,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK1C;;GAEG;AAEH,eAAO,MAAM,iBAAiB,2CAA2C,CAAC;AAE1E,yBAAiB,mBAAmB,CAAC;;;;;;;;;;;;IAGnC,MAAM,OAAO,MAAO,SAAQ,WAS1B;KAAG;;CACN;AAED,eAAO,MAAM,YAAY,WAAY,OAAO,KAAG,MAAM,IAAI,OAAO,cAE/D,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,CAAC,EAAgB,MAAM,mBAAmB,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK1C;;GAEG;AAEH,eAAO,MAAM,iBAAiB,2CAA2C,CAAC;AAE1E,yBAAiB,mBAAmB,CAAC;;;;;;;;;;;;IAGnC,MAAM,OAAO,MAAO,SAAQ,WAQ1B;KAAG;;CACN;AAED,eAAO,MAAM,YAAY,WAAY,OAAO,KAAG,MAAM,IAAI,OAAO,cAE/D,CAAC;AAGF,eAAO,MAAM,2BAA2B;;GAIvC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-transcription",
-  "version": "0.8.2-main.12df754",
+  "version": "0.8.2-main.36232bc",
   "description": "Voice transcription.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -44,60 +44,63 @@
     "react-router-dom": "^6.4.0",
     "react-use": "^17.5.1",
     "wavefile": "^11.0.0",
-    "@dxos/app-framework": "0.8.2-main.12df754",
-    "@dxos/artifact": "0.8.2-main.12df754",
-    "@dxos/assistant": "0.8.2-main.12df754",
-    "@dxos/async": "0.8.2-main.12df754",
-    "@dxos/client": "0.8.2-main.12df754",
-    "@dxos/codec-protobuf": "0.8.2-main.12df754",
-    "@dxos/context": "0.8.2-main.12df754",
-    "@dxos/debug": "0.8.2-main.12df754",
-    "@dxos/echo-db": "0.8.2-main.12df754",
-    "@dxos/display-name": "0.8.2-main.12df754",
-    "@dxos/invariant": "0.8.2-main.12df754",
-    "@dxos/echo-schema": "0.8.2-main.12df754",
-    "@dxos/live-object": "0.8.2-main.12df754",
-    "@dxos/keys": "0.8.2-main.12df754",
-    "@dxos/log": "0.8.2-main.12df754",
-    "@dxos/plugin-client": "0.8.2-main.12df754",
-    "@dxos/plugin-deck": "0.8.2-main.12df754",
-    "@dxos/plugin-graph": "0.8.2-main.12df754",
-    "@dxos/protocols": "0.8.2-main.12df754",
-    "@dxos/react-client": "0.8.2-main.12df754",
-    "@dxos/plugin-meeting": "0.8.2-main.12df754",
-    "@dxos/react-edge-client": "0.8.2-main.12df754",
-    "@dxos/react-ui-attention": "0.8.2-main.12df754",
-    "@dxos/plugin-space": "0.8.2-main.12df754",
-    "@dxos/react-ui-components": "0.8.2-main.12df754",
-    "@dxos/react-ui-grid": "0.8.2-main.12df754",
-    "@dxos/react-ui-sfx": "0.8.2-main.12df754",
-    "@dxos/react-ui-editor": "0.8.2-main.12df754",
-    "@dxos/react-ui-stack": "0.8.2-main.12df754",
-    "@dxos/schema": "0.8.2-main.12df754",
-    "@dxos/tracing": "0.8.2-main.12df754",
-    "@dxos/util": "0.8.2-main.12df754"
+    "@dxos/artifact": "0.8.2-main.36232bc",
+    "@dxos/async": "0.8.2-main.36232bc",
+    "@dxos/client": "0.8.2-main.36232bc",
+    "@dxos/assistant": "0.8.2-main.36232bc",
+    "@dxos/app-framework": "0.8.2-main.36232bc",
+    "@dxos/context": "0.8.2-main.36232bc",
+    "@dxos/codec-protobuf": "0.8.2-main.36232bc",
+    "@dxos/debug": "0.8.2-main.36232bc",
+    "@dxos/echo-db": "0.8.2-main.36232bc",
+    "@dxos/echo-schema": "0.8.2-main.36232bc",
+    "@dxos/keys": "0.8.2-main.36232bc",
+    "@dxos/display-name": "0.8.2-main.36232bc",
+    "@dxos/invariant": "0.8.2-main.36232bc",
+    "@dxos/live-object": "0.8.2-main.36232bc",
+    "@dxos/log": "0.8.2-main.36232bc",
+    "@dxos/plugin-client": "0.8.2-main.36232bc",
+    "@dxos/local-storage": "0.8.2-main.36232bc",
+    "@dxos/plugin-graph": "0.8.2-main.36232bc",
+    "@dxos/plugin-markdown": "0.8.2-main.36232bc",
+    "@dxos/plugin-deck": "0.8.2-main.36232bc",
+    "@dxos/plugin-meeting": "0.8.2-main.36232bc",
+    "@dxos/protocols": "0.8.2-main.36232bc",
+    "@dxos/react-client": "0.8.2-main.36232bc",
+    "@dxos/plugin-space": "0.8.2-main.36232bc",
+    "@dxos/react-ui-attention": "0.8.2-main.36232bc",
+    "@dxos/react-ui-components": "0.8.2-main.36232bc",
+    "@dxos/react-ui-form": "0.8.2-main.36232bc",
+    "@dxos/react-edge-client": "0.8.2-main.36232bc",
+    "@dxos/react-ui-editor": "0.8.2-main.36232bc",
+    "@dxos/react-ui-sfx": "0.8.2-main.36232bc",
+    "@dxos/react-ui-grid": "0.8.2-main.36232bc",
+    "@dxos/react-ui-stack": "0.8.2-main.36232bc",
+    "@dxos/schema": "0.8.2-main.36232bc",
+    "@dxos/tracing": "0.8.2-main.36232bc",
+    "@dxos/util": "0.8.2-main.36232bc"
   },
   "devDependencies": {
     "@types/react": "~18.2.0",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "tailwindcss": "~3.4.1",
-    "@dxos/plugin-preview": "0.8.2-main.12df754",
-    "@dxos/plugin-storybook-layout": "0.8.2-main.12df754",
-    "@dxos/plugin-theme": "0.8.2-main.12df754",
-    "@dxos/random": "0.8.2-main.12df754",
-    "@dxos/react-ui": "0.8.2-main.12df754",
-    "@dxos/react-ui-form": "0.8.2-main.12df754",
-    "@dxos/react-ui-syntax-highlighter": "0.8.2-main.12df754",
-    "@dxos/react-ui-theme": "0.8.2-main.12df754",
-    "@dxos/test-utils": "0.8.2-main.12df754",
-    "@dxos/storybook-utils": "0.8.2-main.12df754"
+    "@dxos/plugin-preview": "0.8.2-main.36232bc",
+    "@dxos/plugin-storybook-layout": "0.8.2-main.36232bc",
+    "@dxos/plugin-theme": "0.8.2-main.36232bc",
+    "@dxos/random": "0.8.2-main.36232bc",
+    "@dxos/react-ui-form": "0.8.2-main.36232bc",
+    "@dxos/react-ui": "0.8.2-main.36232bc",
+    "@dxos/react-ui-syntax-highlighter": "0.8.2-main.36232bc",
+    "@dxos/storybook-utils": "0.8.2-main.36232bc",
+    "@dxos/test-utils": "0.8.2-main.36232bc",
+    "@dxos/react-ui-theme": "0.8.2-main.36232bc"
   },
   "optionalDependencies": {
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.2-main.12df754",
-    "@dxos/react-ui-theme": "0.8.2-main.12df754"
+    "@dxos/react-ui": "0.8.2-main.36232bc",
+    "@dxos/react-ui-theme": "0.8.2-main.36232bc"
   },
   "publishConfig": {
     "access": "public"

package/src/TranscriptionPlugin.tsx

@@ -6,11 +6,21 @@ import { Capabilities, Events, contributes, defineModule, definePlugin } from '@
 import { QueueImpl } from '@dxos/echo-db';
 import { isInstanceOf } from '@dxos/echo-schema';
 import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import { getSpace } from '@dxos/react-client/echo';
+import { MessageType } from '@dxos/schema';
 
-import { AppGraphBuilder, IntentResolver, MeetingTranscriptionState, ReactSurface, Transcriber } from './capabilities';
+import {
+  AppGraphBuilder,
+  IntentResolver,
+  MeetingTranscriptionState,
+  ReactSurface,
+  Transcriber,
+  Settings,
+} from './capabilities';
+import { renderMarkdown } from './components';
 import { meta } from './meta';
 import translations from './translations';
-import { TranscriptBlock, TranscriptType } from './types';
+import { TranscriptType } from './types';
 
 export const TranscriptionPlugin = () =>
   definePlugin(meta, [
@@ -20,14 +30,9 @@ export const TranscriptionPlugin = () =>
       activate: () => contributes(Capabilities.Translations, translations),
     }),
     defineModule({
-      id: `${meta.id}/module/transcription`,
-      activatesOn: Events.SetupAppGraph,
-      activate: Transcriber,
-    }),
-    defineModule({
-      id: `${meta.id}/module/meeting-transcription-state`,
-      activatesOn: Events.SetupAppGraph,
-      activate: MeetingTranscriptionState,
+      id: `${meta.id}/module/settings`,
+      activatesOn: Events.SetupSettings,
+      activate: Settings,
     }),
     defineModule({
       id: `${meta.id}/module/metadata`,
@@ -40,11 +45,13 @@ export const TranscriptionPlugin = () =>
             // TODO(wittjosiah): Factor out. Artifact? Separate capability?
             getTextContent: async (transcript: TranscriptType) => {
               const client = context.requestCapability(ClientCapabilities.Client);
+              const space = getSpace(transcript);
+              const members = space?.members.get().map((member) => member.identity) ?? [];
               const queue = new QueueImpl(client.edge, transcript.queue.dxn);
               await queue.refresh();
               const content = queue.items
-                .filter((block) => isInstanceOf(TranscriptBlock, block))
-                .map((block) => `${block.authorName}: ${block.segments.map((segment) => segment.text).join('\n')}`)
+                .filter((message) => isInstanceOf(MessageType, message))
+                .flatMap((message, index) => renderMarkdown(members)(message, index))
                 .join('\n\n');
               return content;
             },
@@ -71,4 +78,14 @@ export const TranscriptionPlugin = () =>
       activatesOn: Events.SetupAppGraph,
       activate: AppGraphBuilder,
     }),
+    defineModule({
+      id: `${meta.id}/module/transcription`,
+      activatesOn: Events.SetupAppGraph,
+      activate: Transcriber,
+    }),
+    defineModule({
+      id: `${meta.id}/module/meeting-transcription-state`,
+      activatesOn: Events.SetupAppGraph,
+      activate: MeetingTranscriptionState,
+    }),
   ]);

package/src/capabilities/app-graph-builder.ts

@@ -2,24 +2,31 @@
 // Copyright 2025 DXOS.org
 //
 
+import type { Schema } from 'effect';
+
 import { Capabilities, contributes, createIntent, type PluginsContext } from '@dxos/app-framework';
-import { fullyQualifiedId, getSpace, makeRef, type Space } from '@dxos/client/echo';
-import { generateName } from '@dxos/display-name';
-import { getSchemaTypename, isInstanceOf } from '@dxos/echo-schema';
+import { AIServiceEdgeClient, type AIServiceClient } from '@dxos/assistant';
+import { AI_SERVICE_ENDPOINT, Contact, Organization } from '@dxos/assistant/testing';
+import { Filter, fullyQualifiedId, getSpace, makeRef, type Space } from '@dxos/client/echo';
+import { getSchemaTypename, isInstanceOf, type BaseEchoObject } from '@dxos/echo-schema';
 import { invariant } from '@dxos/invariant';
+import { DXN } from '@dxos/keys';
+import { log } from '@dxos/log';
 import { ClientCapabilities } from '@dxos/plugin-client';
 import { PLANK_COMPANION_TYPE, ATTENDABLE_PATH_SEPARATOR } from '@dxos/plugin-deck/types';
 import { createExtension, type Node } from '@dxos/plugin-graph';
+import { DocumentType } from '@dxos/plugin-markdown/types';
 import { MeetingCapabilities, type CallState, type MediaState } from '@dxos/plugin-meeting';
-import { MeetingType } from '@dxos/plugin-meeting/types';
+import { MeetingType, type MeetingCallProperties } from '@dxos/plugin-meeting/types';
 import { type buf } from '@dxos/protocols/buf';
 import { type TranscriptionPayloadSchema } from '@dxos/protocols/buf/dxos/edge/calls_pb';
-import { keyToFallback } from '@dxos/util';
+import type { MessageType } from '@dxos/schema';
 
 import { TranscriptionCapabilities } from './capabilities';
+import { processTranscriptMessage } from '../entity-extraction';
 import { TRANSCRIPTION_PLUGIN } from '../meta';
 import { TranscriptionManager } from '../transcriber';
-import { TranscriptionAction, TranscriptType } from '../types';
+import { TranscriptionAction, type TranscriptionSettingsProps, TranscriptType } from '../types';
 
 // TODO(wittjosiah): Factor out.
 // TODO(wittjosiah): Can we stop using protobuf for this?
@@ -49,8 +56,7 @@ export default (context: PluginsContext) =>
   contributes(Capabilities.AppGraphBuilder, [
     createExtension({
       id: `${TRANSCRIPTION_PLUGIN}/meeting-transcript`,
-      filter: (node): node is Node<MeetingType> =>
-        isInstanceOf(MeetingType, node.data) && node.type !== PLANK_COMPANION_TYPE,
+      filter: (node): node is Node<MeetingType> => isInstanceOf(MeetingType, node.data),
       actions: ({ node }) => {
         const meeting = node.data;
         const state = context.requestCapability(TranscriptionCapabilities.MeetingTranscriptionState);
@@ -61,14 +67,13 @@ export default (context: PluginsContext) =>
               // NOTE: We are not saving the state of the transcription manager here.
               // We expect the state to be updated through `onCallStateUpdated` once it is propagated through Swarm.
               // This is done to avoid race conditions and to not handle optimistic updates.
-
               const transcript = await getMeetingTranscript(context, meeting);
               invariant(transcript, 'Failed to create transcript');
 
-              const call = context.requestCapability(MeetingCapabilities.CallManager);
-              call.setActivity(getSchemaTypename(TranscriptType)!, {
-                enabled: !state.enabled,
+              const callManager = context.requestCapability(MeetingCapabilities.CallManager);
+              callManager.setActivity(getSchemaTypename(TranscriptType)!, {
                 queueDxn: transcript.queue.dxn.toString(),
+                enabled: !state.enabled,
               });
             },
             properties: {
@@ -86,6 +91,14 @@ export default (context: PluginsContext) =>
         const meeting = node.data;
         const client = context.requestCapability(ClientCapabilities.Client);
         const state = context.requestCapability(TranscriptionCapabilities.MeetingTranscriptionState);
+        const settings = context
+          .requestCapability(Capabilities.SettingsStore)
+          .getStore<TranscriptionSettingsProps>(TRANSCRIPTION_PLUGIN)!.value;
+
+        // TODO(dmaretskyi): Request via capability.
+        const aiClient: AIServiceClient | undefined = new AIServiceEdgeClient({
+          endpoint: AI_SERVICE_ENDPOINT.REMOTE,
+        });
 
         return [
           {
@@ -95,29 +108,45 @@ export default (context: PluginsContext) =>
             properties: {
               label: ['transcript companion label', { ns: TRANSCRIPTION_PLUGIN }],
               icon: 'ph--subtitles--regular',
+              position: 'hoist',
               disposition: 'hidden',
               schema: TranscriptType,
               getIntent: ({ space }: { space: Space }) =>
                 createIntent(TranscriptionAction.Create, { spaceId: space.id }),
-              onJoin: () => {
-                const transcriptionManager = new TranscriptionManager(client.edge);
+
+              // TODO(burdon): Is this the right place to inisitalize the state? Change to a capability?
+              onJoin: async ({ meeting }: { meeting: MeetingType; roomId: string }) => {
                 const identity = client.halo.identity.get();
                 invariant(identity);
-                transcriptionManager.setName(
-                  identity.profile?.displayName ?? generateName(identity.identityKey.toHex()),
-                );
-                const fallbackValue = keyToFallback(identity!.identityKey);
-                const userHue = identity!.profile?.data?.hue || fallbackValue.hue;
-                transcriptionManager.setHue(userHue);
-                void transcriptionManager.open();
-                state.transcriptionManager = transcriptionManager;
+                const space = getSpace(meeting);
+                invariant(space);
+
+                let messageEnricher;
+                if (aiClient && settings.entityExtraction) {
+                  messageEnricher = createEntityExtractionEnricher({
+                    aiClient,
+                    // TODO(dmaretskyi): Have those be discovered from the schema graph or contributed by capabilities?
+                    //  This forced me to add a dependency on markdown plugin.
+                    //  This will be replaced with a vector search index anyway, so its not a big deal.
+                    contextTypes: [DocumentType, Contact, Organization],
+                    space,
+                  });
+                }
+
+                // TODO(burdon): The TranscriptionManager singleton is part of the state and should just be updated here.
+                state.transcriptionManager = await new TranscriptionManager({
+                  edgeClient: client.edge,
+                  messageEnricher,
+                })
+                  .setIdentityDid(identity.did)
+                  .open();
               },
-              onLeave: () => {
-                void state.transcriptionManager?.close();
+              onLeave: async () => {
+                await state.transcriptionManager?.close();
                 state.transcriptionManager = undefined;
                 state.enabled = false;
               },
-              onCallStateUpdated: (callState: CallState) => {
+              onCallStateUpdated: async (callState: CallState) => {
                 const typename = getSchemaTypename(TranscriptType);
                 const transcription = typename ? callState.activities?.[typename] : undefined;
                 if (!transcription?.payload) {
@@ -126,16 +155,57 @@ export default (context: PluginsContext) =>
 
                 const payload: TranscriptionPayload = transcription.payload;
                 state.enabled = !!payload.enabled;
-                void state.transcriptionManager?.setEnabled(payload.enabled);
-                void state.transcriptionManager?.setQueue(payload.queueDxn);
+                if (payload.queueDxn) {
+                  // NOTE: Must set queue before enabling transcription.
+                  state.transcriptionManager?.setQueue(DXN.parse(payload.queueDxn));
+                }
+                await state.transcriptionManager?.setEnabled(payload.enabled);
               },
-              onMediaStateUpdated: ([mediaState, isSpeaking]: [MediaState, boolean]) => {
+              onMediaStateUpdated: async ([mediaState, isSpeaking]: [MediaState, boolean]) => {
                 void state.transcriptionManager?.setAudioTrack(mediaState.audioTrack);
                 void state.transcriptionManager?.setRecording(isSpeaking);
               },
-            },
+            } satisfies MeetingCallProperties,
           },
         ];
       },
     }),
   ]);
+
+type EntityExtractionEnricherFactoryOptions = {
+  aiClient: AIServiceClient;
+  contextTypes: Schema.Schema.AnyNoContext[];
+  space: Space;
+};
+
+const createEntityExtractionEnricher = ({ aiClient, contextTypes, space }: EntityExtractionEnricherFactoryOptions) => {
+  return async (message: MessageType) => {
+    const { objects } = await space.db.query(Filter.or(...contextTypes.map((s) => Filter.schema(s)))).run();
+    log.info('context', { objects });
+
+    const { message: enhancedMessage, timeElapsed } = await processTranscriptMessage({
+      aiService: aiClient,
+      message,
+      context: { objects: await Promise.all(objects.map(processContextObject)) },
+      options: { timeout: ENTITY_EXTRACTOR_TIMEOUT, fallbackToRaw: true },
+    });
+
+    log.info('entity extraction time', { timeElapsed });
+    return enhancedMessage;
+  };
+};
+
+const processContextObject = async (object: BaseEchoObject): Promise<any> => {
+  // TODO(dmaretskyi): Documents need special processing is the content is behind a ref.
+  // TODO(dmaretskyi): Think about a way to handle this serialization with a decorator.
+  if (isInstanceOf(DocumentType, object)) {
+    return {
+      ...object,
+      content: await object.content.load(),
+    };
+  }
+
+  return object;
+};
+
+const ENTITY_EXTRACTOR_TIMEOUT = 25_000;

package/src/capabilities/capabilities.ts

@@ -18,8 +18,8 @@ export namespace TranscriptionCapabilities {
   export const Transcriber = defineCapability<GetTranscriber>(`${TRANSCRIPTION_PLUGIN}/capability/transcriber`);
 
   export type MeetingTranscriptionState = Live<{
-    enabled: boolean;
     transcriptionManager?: TranscriptionManager;
+    enabled: boolean; // TODO(burdon): Move state into TranscriptionManager.
   }>;
   export const MeetingTranscriptionState = defineCapability<MeetingTranscriptionState>(
     `${TRANSCRIPTION_PLUGIN}/capability/meeting-transcription-state`,

package/src/capabilities/index.ts

@@ -9,5 +9,6 @@ export const IntentResolver = lazy(() => import('./intent-resolver'));
 export const MeetingTranscriptionState = lazy(() => import('./meeting-transcription-state'));
 export const ReactSurface = lazy(() => import('./react-surface'));
 export const Transcriber = lazy(() => import('./transcriber'));
+export const Settings = lazy(() => import('./settings'));
 
 export * from './capabilities';

package/src/capabilities/intent-resolver.ts

@@ -4,7 +4,7 @@
 
 import { Capabilities, contributes, createResolver, type PluginsContext } from '@dxos/app-framework';
 import { live, refFromDXN } from '@dxos/live-object';
-import { type SpaceId, randomQueueDxn } from '@dxos/react-client/echo';
+import { type SpaceId, createQueueDxn } from '@dxos/react-client/echo';
 
 import { TranscriptionAction, TranscriptType } from '../types';
 import { getTimeStr } from '../util';
@@ -15,7 +15,7 @@ export default (context: PluginsContext) =>
       intent: TranscriptionAction.Create,
       resolve: ({ name, spaceId }) => {
         const transcript = live(TranscriptType, {
-          queue: refFromDXN(randomQueueDxn(spaceId as SpaceId)),
+          queue: refFromDXN(createQueueDxn(spaceId as SpaceId)),
           name: name ?? `Transcript ${getTimeStr(Date.now())}`,
         });
 

package/src/capabilities/react-surface.tsx

@@ -5,15 +5,23 @@
 import React from 'react';
 
 import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
+import { SettingsStore } from '@dxos/local-storage';
 
-import { TranscriptionContainer } from '../components';
-import { TRANSCRIPTION_PLUGIN } from '../meta';
-import { isTranscript, type TranscriptType } from '../types';
+import { TranscriptionContainer, TranscriptionSettings } from '../components';
+import { meta } from '../meta';
+import { isTranscript, type TranscriptionSettingsProps, type TranscriptType } from '../types';
 
 export default () =>
   contributes(Capabilities.ReactSurface, [
     createSurface({
-      id: `${TRANSCRIPTION_PLUGIN}/article/transcript`,
+      id: `${meta.id}/plugin-settings`,
+      role: 'article',
+      filter: (data): data is { subject: SettingsStore<TranscriptionSettingsProps> } =>
+        data.subject instanceof SettingsStore && data.subject.prefix === meta.id,
+      component: ({ data: { subject } }) => <TranscriptionSettings settings={subject.value} />,
+    }),
+    createSurface({
+      id: `${meta.id}/article/transcript`,
       role: ['article', 'section'],
       filter: (data): data is { subject: TranscriptType } => isTranscript(data.subject),
       component: ({ data, role }) => <TranscriptionContainer transcript={data.subject} role={role} />,

package/src/capabilities/settings.ts

@@ -0,0 +1,20 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes } from '@dxos/app-framework';
+import { live } from '@dxos/live-object';
+
+import { TRANSCRIPTION_PLUGIN } from '../meta';
+import { TranscriptionSettingsSchema } from '../types';
+
+export default () => {
+  // TODO(wittjosiah): `live` currently doesn't handle schema default values.
+  const settings = live(TranscriptionSettingsSchema, { entityExtraction: true });
+
+  return contributes(Capabilities.Settings, {
+    schema: TranscriptionSettingsSchema,
+    prefix: TRANSCRIPTION_PLUGIN,
+    value: settings,
+  });
+};