@dxos/plugin-transcription 0.10.0 → 0.11.0

package/dist/lib/chunk-types.mjs

@@ -0,0 +1,141 @@
+import { Capability } from "@dxos/app-framework";
+import { Operation } from "@dxos/compute";
+import * as Schema from "effect/Schema";
+import { meta } from "#meta";
+import { AiService } from "@dxos/ai";
+import { SpaceSchema } from "@dxos/client/echo";
+import { DXN, Database, Ref, Type } from "@dxos/echo";
+import { Message, Transcript } from "@dxos/types";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/types/Settings.ts
+var Settings_exports = /* @__PURE__ */ __exportAll({ Settings: () => Settings$1 });
+var Settings$1 = Schema.mutable(Schema.Struct({
+	entityExtraction: Schema.optional(Schema.Boolean.annotations({
+		title: "Entity extraction",
+		description: "While transcribing, use the Assistant to detect and annotate mentions of known objects such as people or organizations."
+	})).pipe(Schema.withConstructorDefault(() => true)),
+	recordMode: Schema.optional(Schema.Literal("toggle", "hold").annotations({
+		title: "Record mode",
+		description: "Whether the mic toggles recording on each click, or records only while the control is held (push-to-talk)."
+	})).pipe(Schema.withConstructorDefault(() => "toggle")),
+	audioDeviceId: Schema.optional(Schema.String.annotations({
+		title: "Audio input device",
+		description: "Identifier of the microphone to capture from; empty uses the system default."
+	})),
+	transcribeAfterMs: Schema.optional(Schema.Number.annotations({
+		title: "Initial buffering (ms)",
+		description: "How long to accumulate audio before producing the first transcription."
+	})).pipe(Schema.withConstructorDefault(() => 4e3)),
+	streamMode: Schema.optional(Schema.Literal("batch", "word").annotations({
+		title: "Reveal mode",
+		description: "Whether transcribed text appears in batches or streams word-by-word."
+	})).pipe(Schema.withConstructorDefault(() => "word")),
+	wordIntervalMs: Schema.optional(Schema.Number.annotations({
+		title: "Word interval (ms)",
+		description: "Pacing between words when streaming word-by-word."
+	})).pipe(Schema.withConstructorDefault(() => 80))
+}));
+//#endregion
+//#region src/types/TranscriptionCapabilities.ts
+var TranscriptionCapabilities_exports = /* @__PURE__ */ __exportAll({
+	EntityLookup: () => EntityLookup,
+	PipelineStatus: () => PipelineStatus,
+	RecordingSession: () => RecordingSession,
+	Settings: () => Settings,
+	TranscriptionManagerProvider: () => TranscriptionManagerProvider
+});
+var TranscriptionManagerProvider = Capability.make(`${meta.profile.key}.capability.transcription-manager`);
+var Settings = Capability.make(`${meta.profile.key}.capability.settings`);
+var RecordingSession = Capability.make(`${meta.profile.key}.capability.recording-session`);
+var EntityLookup = Capability.make(`${meta.profile.key}.capability.entity-lookup`);
+var PipelineStatus = Capability.make(`${meta.profile.key}.capability.pipeline-status`);
+//#endregion
+//#region src/types/TranscriptOperation.ts
+var TranscriptOperation_exports = /* @__PURE__ */ __exportAll({
+	Create: () => Create,
+	EnrichMessage: () => EnrichMessage,
+	MessageWithRangeId: () => MessageWithRangeId,
+	Open: () => Open,
+	SentenceNormalization: () => SentenceNormalization,
+	SentenceNormalizationInput: () => SentenceNormalizationInput,
+	SentenceNormalizationOutput: () => SentenceNormalizationOutput,
+	Summarize: () => Summarize
+});
+var makeKey = (name) => DXN.make(`${meta.profile.key}.operation.${name}`);
+var Create = Operation.make({
+	meta: {
+		key: makeKey("create"),
+		name: "Create Transcript",
+		icon: "ph--microphone--regular"
+	},
+	input: Schema.Struct({
+		name: Schema.optional(Schema.String),
+		space: SpaceSchema
+	}),
+	output: Schema.Struct({ object: Type.getSchema(Transcript.Transcript) })
+});
+var MessageWithRangeId = Schema.extend(Type.getSchema(Message.Message), Schema.Struct({ rangeId: Schema.optional(Schema.Array(Schema.String)).annotations({ description: "The IDs of the messages that contain the sentences." }) }));
+var Open = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.transcription.open"),
+		name: "Open",
+		description: "Opens and reads the contents of a transcription object.",
+		icon: "ph--folder-open--regular"
+	},
+	input: Schema.Struct({ transcript: Ref.Ref(Transcript.Transcript).annotations({ description: "The ID of the transcription object." }) }),
+	output: Schema.Struct({ content: Schema.String }),
+	services: [Database.Service]
+});
+var Summarize = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.transcription.summarize"),
+		name: "Summarize",
+		description: "Summarize a transcript of a meeting.",
+		icon: "ph--text-align-left--regular"
+	},
+	input: Schema.Struct({
+		transcript: Schema.String.annotations({ description: "The transcript of the meeting." }),
+		notes: Schema.optional(Schema.String).annotations({ description: "Additional notes from the participants." })
+	}),
+	output: Schema.Struct({ summary: Schema.String.annotations({ description: "The summary of the transcript." }) }),
+	services: [AiService.AiService]
+}).pipe(Operation.visible);
+var EnrichMessage = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.transcription.enrichMessage"),
+		name: "Enrich Transcript Message",
+		description: "Extract proper nouns from a transcript message and link them to objects in the space.",
+		icon: "ph--text-t--regular"
+	},
+	input: Schema.Struct({ message: Type.getSchema(Message.Message) }),
+	output: Schema.Struct({ message: Type.getSchema(Message.Message) }),
+	services: [AiService.AiService, Database.Service]
+});
+var SentenceNormalizationInput = Schema.Struct({ messages: Schema.Array(MessageWithRangeId).annotations({ description: "Messages to normalize into sentences." }) });
+var SentenceNormalizationOutput = Schema.Struct({ sentences: Schema.Array(MessageWithRangeId.pipe(Schema.mutable)).pipe(Schema.mutable).annotations({ description: "The sentences of the transcript." }) });
+var SentenceNormalization = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.transcription.sentenceNormalization"),
+		name: "Sentence Normalization",
+		description: "Post process of transcription for sentence normalization",
+		icon: "ph--text-t--regular"
+	},
+	input: SentenceNormalizationInput,
+	output: SentenceNormalizationOutput,
+	services: []
+});
+//#endregion
+export { TranscriptOperation_exports as a, Summarize as i, EnrichMessage as n, TranscriptionCapabilities_exports as o, Open as r, Settings_exports as s, Create as t };
+
+//# sourceMappingURL=chunk-types.mjs.map

package/dist/lib/chunk-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-types.mjs","names":[],"sources":["../../src/types/Settings.ts","../../src/types/TranscriptionCapabilities.ts","../../src/types/TranscriptOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nexport type RecordMode = 'toggle' | 'hold';\n\nexport const Settings = Schema.mutable(\n  Schema.Struct({\n    entityExtraction: Schema.optional(\n      Schema.Boolean.annotations({\n        title: 'Entity extraction',\n        description:\n          'While transcribing, use the Assistant to detect and annotate mentions of known objects such as people or organizations.',\n      }),\n    ).pipe(Schema.withConstructorDefault(() => true)),\n\n    recordMode: Schema.optional(\n      Schema.Literal('toggle', 'hold').annotations({\n        title: 'Record mode',\n        description:\n          'Whether the mic toggles recording on each click, or records only while the control is held (push-to-talk).',\n      }),\n    ).pipe(Schema.withConstructorDefault(() => 'toggle' as const)),\n\n    audioDeviceId: Schema.optional(\n      Schema.String.annotations({\n        title: 'Audio input device',\n        description: 'Identifier of the microphone to capture from; empty uses the system default.',\n      }),\n    ),\n\n    transcribeAfterMs: Schema.optional(\n      Schema.Number.annotations({\n        title: 'Initial buffering (ms)',\n        description: 'How long to accumulate audio before producing the first transcription.',\n      }),\n    ).pipe(Schema.withConstructorDefault(() => 4000)),\n\n    streamMode: Schema.optional(\n      Schema.Literal('batch', 'word').annotations({\n        title: 'Reveal mode',\n        description: 'Whether transcribed text appears in batches or streams word-by-word.',\n      }),\n    ).pipe(Schema.withConstructorDefault(() => 'word' as const)),\n\n    wordIntervalMs: Schema.optional(\n      Schema.Number.annotations({\n        title: 'Word interval (ms)',\n        description: 'Pacing between words when streaming word-by-word.',\n      }),\n    ).pipe(Schema.withConstructorDefault(() => 80)),\n  }),\n);\n\nexport interface Settings extends Schema.Schema.Type<typeof Settings> {}\n","//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { type Atom } from '@effect-atom/atom';\n\nimport { Capability } from '@dxos/app-framework';\nimport { type Space } from '@dxos/client/echo';\nimport { type Feed } from '@dxos/echo';\nimport { type EntityLookup as EntityLookupFn } from '@dxos/pipeline-transcription';\nimport { type Message } from '@dxos/types';\n\nimport { meta } from '#meta';\n\nimport * as SettingsModule from './Settings';\n\n/**\n * Enriches a transcript message before it is written to the feed (e.g. entity linking).\n */\nexport type TranscriptMessageEnricher = (message: Message.Message) => Promise<Message.Message>;\n\n/**\n * Service contract for the meeting transcription manager. Consumers (e.g. plugin-meeting) depend on\n * this interface via the {@link TranscriptionManagerProvider} capability, not on the concrete\n * implementation, keeping the manager's browser/SDK dependencies out of consumer packages.\n */\nexport interface TranscriptionManager {\n  readonly enabled: Atom.Atom<boolean>;\n  setFeed(space: Space, feed: Feed.Feed): void;\n  setAudioTrack(track?: MediaStreamTrack): Promise<void>;\n  setRecording(recording?: boolean): void;\n  setEnabled(enabled: boolean): Promise<void>;\n  open(): Promise<this>;\n  close(): Promise<this>;\n}\n\nexport type TranscriptionManagerProviderProps = {\n  messageEnricher?: TranscriptMessageEnricher;\n};\n\nexport type TranscriptionManagerProvider = (props: TranscriptionManagerProviderProps) => TranscriptionManager;\n\nexport const TranscriptionManagerProvider = Capability.make<TranscriptionManagerProvider>(\n  `${meta.profile.key}.capability.transcription-manager`,\n);\n\nexport const Settings = Capability.make<Atom.Writable<SettingsModule.Settings>>(\n  `${meta.profile.key}.capability.settings`,\n);\n\n/**\n * The single active editor transcription session. `id` is the editor's attendable id (the key it\n * registered under in `MarkdownCapabilities.EditorViews`); `recording` gates audio capture. `null`\n * when no session is active.\n */\nexport type RecordingSession = { id: string; recording: boolean };\n\nexport const RecordingSession = Capability.make<Atom.Writable<RecordingSession | null>>(\n  `${meta.profile.key}.capability.recording-session`,\n);\n\n/**\n * Resolves entity references for live-transcription enrichment. Backend-agnostic (full-text, vector,\n * a remote service, …) so the headless driver depends on the function, not the database.\n */\nexport type EntityLookup = EntityLookupFn;\n\nexport const EntityLookup = Capability.make<EntityLookupFn>(`${meta.profile.key}.capability.entity-lookup`);\n\n/**\n * Live transcription lifecycle, published by the driver for observers (toolbar spinner, testbench):\n * `recording` (mic capturing) → `draining` (mic off, finishing the pipeline) → `idle`.\n */\nexport type PipelinePhase = 'idle' | 'recording' | 'draining';\n\nexport const PipelineStatus = Capability.make<Atom.Writable<{ phase: PipelinePhase }>>(\n  `${meta.profile.key}.capability.pipeline-status`,\n);\n","//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport { SpaceSchema } from '@dxos/client/echo';\nimport { Operation } from '@dxos/compute';\nimport { Database, DXN, Ref, Type } from '@dxos/echo';\n// Message and Person are used via Type.getSchema(Message.Message); they also appear in emitted .d.ts.\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport { Message, type Person, Transcript } from '@dxos/types';\n\nimport { meta } from '#meta';\n\nconst makeKey = (name: string) => DXN.make(`${meta.profile.key}.operation.${name}`);\n\nexport const Create = Operation.make({\n  meta: { key: makeKey('create'), name: 'Create Transcript', icon: 'ph--microphone--regular' },\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String),\n    space: SpaceSchema,\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Transcript.Transcript),\n  }),\n});\n\nexport const MessageWithRangeId = Schema.extend(\n  Type.getSchema(Message.Message),\n  Schema.Struct({\n    rangeId: Schema.optional(Schema.Array(Schema.String)).annotations({\n      description: 'The IDs of the messages that contain the sentences.',\n    }),\n  }),\n);\n\nexport type MessageWithRangeIdType = Schema.Schema.Type<typeof MessageWithRangeId>;\n\nexport const Open = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.transcription.open'),\n    name: 'Open',\n    description: 'Opens and reads the contents of a transcription object.',\n    icon: 'ph--folder-open--regular',\n  },\n  input: Schema.Struct({\n    transcript: Ref.Ref(Transcript.Transcript).annotations({\n      description: 'The ID of the transcription object.',\n    }),\n  }),\n  output: Schema.Struct({\n    content: Schema.String,\n  }),\n  services: [Database.Service],\n});\n\nexport const Summarize = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.transcription.summarize'),\n    name: 'Summarize',\n    description: 'Summarize a transcript of a meeting.',\n    icon: 'ph--text-align-left--regular',\n  },\n  input: Schema.Struct({\n    transcript: Schema.String.annotations({\n      description: 'The transcript of the meeting.',\n    }),\n    notes: Schema.optional(Schema.String).annotations({\n      description: 'Additional notes from the participants.',\n    }),\n  }),\n  output: Schema.Struct({\n    summary: Schema.String.annotations({\n      description: 'The summary of the transcript.',\n    }),\n  }),\n  services: [AiService.AiService],\n}).pipe(Operation.visible);\n\nexport const EnrichMessage = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.transcription.enrichMessage'),\n    name: 'Enrich Transcript Message',\n    description: 'Extract proper nouns from a transcript message and link them to objects in the space.',\n    icon: 'ph--text-t--regular',\n  },\n  input: Schema.Struct({\n    message: Type.getSchema(Message.Message),\n  }),\n  output: Schema.Struct({\n    message: Type.getSchema(Message.Message),\n  }),\n  services: [AiService.AiService, Database.Service],\n});\n\nexport const SentenceNormalizationInput = Schema.Struct({\n  messages: Schema.Array(MessageWithRangeId).annotations({\n    description: 'Messages to normalize into sentences.',\n  }),\n});\n\nexport type SentenceNormalizationInputType = Schema.Schema.Type<typeof SentenceNormalizationInput>;\n\nexport const SentenceNormalizationOutput = Schema.Struct({\n  sentences: Schema.Array(MessageWithRangeId.pipe(Schema.mutable)).pipe(Schema.mutable).annotations({\n    description: 'The sentences of the transcript.',\n  }),\n});\n\nexport const SentenceNormalization = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.transcription.sentenceNormalization'),\n    name: 'Sentence Normalization',\n    description: 'Post process of transcription for sentence normalization',\n    icon: 'ph--text-t--regular',\n  },\n  input: SentenceNormalizationInput,\n  output: SentenceNormalizationOutput,\n  services: [],\n});\n"],"mappings":"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"}

package/dist/lib/components.mjs

@@ -0,0 +1,108 @@
+import { TranscriptionCapabilities } from "#types";
+import { meta } from "#meta";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useAtomCapabilityState } from "@dxos/app-framework/ui";
+import { MicButton, useTranslation } from "@dxos/react-ui";
+import { useSoundEffect } from "@dxos/react-ui-audio";
+import { MicSettings } from "@dxos/react-ui-transcription";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/Mic/Mic.tsx
+/**
+* Connects the {@link MicButton} and {@link MicSettings} to the recording session and settings
+* capabilities, and enumerates available audio inputs. Mounted from the toolbar's custom action, so
+* capability hooks resolve.
+*/
+var Mic = ({ docId }) => {
+	const { t } = useTranslation(meta.profile.key);
+	const [session, setSession] = useAtomCapabilityState(TranscriptionCapabilities.RecordingSession);
+	const [settings, setSettings] = useAtomCapabilityState(TranscriptionCapabilities.Settings);
+	const recording = !!session?.recording && session.id === docId;
+	const soundStart = useSoundEffect("StartRecording");
+	const soundStop = useSoundEffect("StopRecording");
+	const wasRecording = useRef(recording);
+	useEffect(() => {
+		if (wasRecording.current === recording) return;
+		wasRecording.current = recording;
+		(recording ? soundStart : soundStop).play();
+	}, [
+		recording,
+		soundStart,
+		soundStop
+	]);
+	const recordMode = settings?.recordMode ?? "toggle";
+	const entityExtraction = settings?.entityExtraction !== false;
+	const selectedDeviceId = settings?.audioDeviceId ?? "";
+	const [devices, setDevices] = useState([]);
+	useEffect(() => {
+		if (!navigator.mediaDevices?.enumerateDevices) return;
+		let cancelled = false;
+		const refresh = async () => {
+			const all = await navigator.mediaDevices.enumerateDevices();
+			if (cancelled) return;
+			setDevices(all.filter((device) => device.kind === "audioinput" && device.deviceId).map((device, index) => ({
+				deviceId: device.deviceId,
+				label: device.label || `Microphone ${index + 1}`
+			})));
+		};
+		refresh();
+		navigator.mediaDevices.addEventListener("devicechange", refresh);
+		return () => {
+			cancelled = true;
+			navigator.mediaDevices.removeEventListener("devicechange", refresh);
+		};
+	}, []);
+	const handleToggle = useCallback(() => {
+		setSession((current) => current?.recording && current.id === docId ? null : {
+			id: docId,
+			recording: true
+		});
+	}, [setSession, docId]);
+	const handlePressStart = useCallback(() => {
+		setSession(() => ({
+			id: docId,
+			recording: true
+		}));
+	}, [setSession, docId]);
+	const handlePressEnd = useCallback(() => {
+		setSession((current) => current?.id === docId ? null : current);
+	}, [setSession, docId]);
+	const handleRecordModeChange = useCallback((mode) => setSettings((current) => ({
+		...current,
+		recordMode: mode
+	})), [setSettings]);
+	const handleEntityExtractionChange = useCallback((value) => setSettings((current) => ({
+		...current,
+		entityExtraction: value
+	})), [setSettings]);
+	const handleSelectDevice = useCallback((deviceId) => setSettings((current) => ({
+		...current,
+		audioDeviceId: deviceId || void 0
+	})), [setSettings]);
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex items-center",
+		children: [/* @__PURE__ */ jsx(MicButton, {
+			iconOnly: true,
+			variant: "ghost",
+			label: recording ? t("stop-recording.label") : recordMode === "hold" ? t("hold-to-record.label") : t("start-recording.label"),
+			recording,
+			mode: recordMode,
+			onToggle: handleToggle,
+			onPressStart: handlePressStart,
+			onPressEnd: handlePressEnd,
+			"data-testid": "transcription.record"
+		}), /* @__PURE__ */ jsx(MicSettings, {
+			translationNs: meta.profile.key,
+			recordMode,
+			entityExtraction,
+			devices,
+			selectedDeviceId,
+			onRecordModeChange: handleRecordModeChange,
+			onEntityExtractionChange: handleEntityExtractionChange,
+			onSelectDevice: handleSelectDevice
+		})]
+	});
+};
+//#endregion
+export { Mic };
+
+//# sourceMappingURL=components.mjs.map

package/dist/lib/components.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.mjs","names":[],"sources":["../../src/components/Mic/Mic.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useAtomCapabilityState } from '@dxos/app-framework/ui';\nimport { MicButton, useTranslation } from '@dxos/react-ui';\nimport { useSoundEffect } from '@dxos/react-ui-audio';\nimport { type AudioInputDevice, MicSettings } from '@dxos/react-ui-transcription';\n\nimport { meta } from '#meta';\nimport { type Settings, TranscriptionCapabilities } from '#types';\n\nexport type MicProps = {\n  /** Attendable id of the target editor; keys the recording session. */\n  docId: string;\n};\n\n/**\n * Connects the {@link MicButton} and {@link MicSettings} to the recording session and settings\n * capabilities, and enumerates available audio inputs. Mounted from the toolbar's custom action, so\n * capability hooks resolve.\n */\nexport const Mic = ({ docId }: MicProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const [session, setSession] = useAtomCapabilityState(TranscriptionCapabilities.RecordingSession);\n  const [settings, setSettings] = useAtomCapabilityState(TranscriptionCapabilities.Settings);\n\n  const recording = !!session?.recording && session.id === docId;\n\n  // Play start/stop cues as this session's recording flag flips (skip the initial mount).\n  const soundStart = useSoundEffect('StartRecording');\n  const soundStop = useSoundEffect('StopRecording');\n  const wasRecording = useRef(recording);\n  useEffect(() => {\n    if (wasRecording.current === recording) {\n      return;\n    }\n    wasRecording.current = recording;\n    void (recording ? soundStart : soundStop).play();\n  }, [recording, soundStart, soundStop]);\n\n  const recordMode: Settings.RecordMode = settings?.recordMode ?? 'toggle';\n  const entityExtraction = settings?.entityExtraction !== false;\n  const selectedDeviceId = settings?.audioDeviceId ?? '';\n\n  const [devices, setDevices] = useState<AudioInputDevice[]>([]);\n  useEffect(() => {\n    if (!navigator.mediaDevices?.enumerateDevices) {\n      return;\n    }\n    let cancelled = false;\n    const refresh = async () => {\n      const all = await navigator.mediaDevices.enumerateDevices();\n      if (cancelled) {\n        return;\n      }\n      // Labels are blank until microphone permission is granted; fall back to an ordinal name.\n      setDevices(\n        all\n          .filter((device) => device.kind === 'audioinput' && device.deviceId)\n          .map((device, index) => ({\n            deviceId: device.deviceId,\n            label: device.label || `Microphone ${index + 1}`,\n          })),\n      );\n    };\n    void refresh();\n    navigator.mediaDevices.addEventListener('devicechange', refresh);\n    return () => {\n      cancelled = true;\n      navigator.mediaDevices.removeEventListener('devicechange', refresh);\n    };\n  }, []);\n\n  const handleToggle = useCallback(() => {\n    setSession((current) => (current?.recording && current.id === docId ? null : { id: docId, recording: true }));\n  }, [setSession, docId]);\n\n  const handlePressStart = useCallback(() => {\n    setSession(() => ({ id: docId, recording: true }));\n  }, [setSession, docId]);\n\n  const handlePressEnd = useCallback(() => {\n    // Only stop our own session; a stray release must not clear another editor's recording.\n    setSession((current) => (current?.id === docId ? null : current));\n  }, [setSession, docId]);\n\n  const handleRecordModeChange = useCallback(\n    (mode: Settings.RecordMode) => setSettings((current) => ({ ...current, recordMode: mode })),\n    [setSettings],\n  );\n\n  const handleEntityExtractionChange = useCallback(\n    (value: boolean) => setSettings((current) => ({ ...current, entityExtraction: value })),\n    [setSettings],\n  );\n\n  const handleSelectDevice = useCallback(\n    (deviceId: string) => setSettings((current) => ({ ...current, audioDeviceId: deviceId || undefined })),\n    [setSettings],\n  );\n\n  const recordLabel = recording\n    ? t('stop-recording.label')\n    : recordMode === 'hold'\n      ? t('hold-to-record.label')\n      : t('start-recording.label');\n\n  return (\n    <div className='flex items-center'>\n      <MicButton\n        iconOnly\n        variant='ghost'\n        label={recordLabel}\n        recording={recording}\n        mode={recordMode}\n        onToggle={handleToggle}\n        onPressStart={handlePressStart}\n        onPressEnd={handlePressEnd}\n        data-testid='transcription.record'\n      />\n      <MicSettings\n        translationNs={meta.profile.key}\n        recordMode={recordMode}\n        entityExtraction={entityExtraction}\n        devices={devices}\n        selectedDeviceId={selectedDeviceId}\n        onRecordModeChange={handleRecordModeChange}\n        onEntityExtractionChange={handleEntityExtractionChange}\n        onSelectDevice={handleSelectDevice}\n      />\n    </div>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;AAwBA,IAAa,OAAO,EAAE,YAAsB;CAC1C,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,CAAC,SAAS,cAAc,uBAAuB,0BAA0B,gBAAgB;CAC/F,MAAM,CAAC,UAAU,eAAe,uBAAuB,0BAA0B,QAAQ;CAEzF,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,QAAQ,OAAO;CAGzD,MAAM,aAAa,eAAe,gBAAgB;CAClD,MAAM,YAAY,eAAe,eAAe;CAChD,MAAM,eAAe,OAAO,SAAS;CACrC,gBAAgB;EACd,IAAI,aAAa,YAAY,WAC3B;EAEF,aAAa,UAAU;EACvB,CAAM,YAAY,aAAa,UAAA,CAAW,KAAK;CACjD,GAAG;EAAC;EAAW;EAAY;CAAS,CAAC;CAErC,MAAM,aAAkC,UAAU,cAAc;CAChE,MAAM,mBAAmB,UAAU,qBAAqB;CACxD,MAAM,mBAAmB,UAAU,iBAAiB;CAEpD,MAAM,CAAC,SAAS,cAAc,SAA6B,CAAC,CAAC;CAC7D,gBAAgB;EACd,IAAI,CAAC,UAAU,cAAc,kBAC3B;EAEF,IAAI,YAAY;EAChB,MAAM,UAAU,YAAY;GAC1B,MAAM,MAAM,MAAM,UAAU,aAAa,iBAAiB;GAC1D,IAAI,WACF;GAGF,WACE,IACG,QAAQ,WAAW,OAAO,SAAS,gBAAgB,OAAO,QAAQ,CAAA,CAClE,KAAK,QAAQ,WAAW;IACvB,UAAU,OAAO;IACjB,OAAO,OAAO,SAAS,cAAc,QAAQ;GAC/C,EAAE,CACN;EACF;EACA,QAAa;EACb,UAAU,aAAa,iBAAiB,gBAAgB,OAAO;EAC/D,aAAa;GACX,YAAY;GACZ,UAAU,aAAa,oBAAoB,gBAAgB,OAAO;EACpE;CACF,GAAG,CAAC,CAAC;CAEL,MAAM,eAAe,kBAAkB;EACrC,YAAY,YAAa,SAAS,aAAa,QAAQ,OAAO,QAAQ,OAAO;GAAE,IAAI;GAAO,WAAW;EAAK,CAAE;CAC9G,GAAG,CAAC,YAAY,KAAK,CAAC;CAEtB,MAAM,mBAAmB,kBAAkB;EACzC,kBAAkB;GAAE,IAAI;GAAO,WAAW;EAAK,EAAE;CACnD,GAAG,CAAC,YAAY,KAAK,CAAC;CAEtB,MAAM,iBAAiB,kBAAkB;EAEvC,YAAY,YAAa,SAAS,OAAO,QAAQ,OAAO,OAAQ;CAClE,GAAG,CAAC,YAAY,KAAK,CAAC;CAEtB,MAAM,yBAAyB,aAC5B,SAA8B,aAAa,aAAa;EAAE,GAAG;EAAS,YAAY;CAAK,EAAE,GAC1F,CAAC,WAAW,CACd;CAEA,MAAM,+BAA+B,aAClC,UAAmB,aAAa,aAAa;EAAE,GAAG;EAAS,kBAAkB;CAAM,EAAE,GACtF,CAAC,WAAW,CACd;CAEA,MAAM,qBAAqB,aACxB,aAAqB,aAAa,aAAa;EAAE,GAAG;EAAS,eAAe,YAAY,KAAA;CAAU,EAAE,GACrG,CAAC,WAAW,CACd;CAQA,OACE,qBAAC,OAAD;EAAK,WAAU;YAAf,CACE,oBAAC,WAAD;GACE,UAAA;GACA,SAAQ;GACR,OAXc,YAChB,EAAE,sBAAsB,IACxB,eAAe,SACb,EAAE,sBAAsB,IACxB,EAAE,uBAAuB;GAQd;GACX,MAAM;GACN,UAAU;GACV,cAAc;GACd,YAAY;GACZ,eAAY;EACb,CAAA,GACD,oBAAC,aAAD;GACE,eAAe,KAAK,QAAQ;GAChB;GACM;GACT;GACS;GAClB,oBAAoB;GACpB,0BAA0B;GAC1B,gBAAgB;EACjB,CAAA,CACE;;AAET"}

package/dist/lib/containers.mjs

@@ -0,0 +1,7 @@
+import { lazy } from "react";
+//#region src/containers/index.ts
+var TranscriptionArticle = lazy(() => import("./chunk-TranscriptionArticle.mjs"));
+//#endregion
+export { TranscriptionArticle };
+
+//# sourceMappingURL=containers.mjs.map

package/dist/lib/containers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.mjs","names":[],"sources":["../../src/containers/index.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const TranscriptionArticle: ComponentType<any> = lazy(() => import('./TranscriptionArticle'));\n"],"mappings":";;AAMA,IAAa,uBAA2C,WAAW,OAAO,mCAAyB"}

package/dist/lib/hooks.mjs

@@ -0,0 +1,87 @@
+import { TranscriptOperation, TranscriptionCapabilities } from "#types";
+import { Database, Feed, Obj } from "@dxos/echo";
+import { Message } from "@dxos/types";
+import { useCallback, useEffect, useState } from "react";
+import { useAtomCapability, useOperationInvoker } from "@dxos/app-framework/ui";
+import { useAudioTrack, useTranscriber } from "@dxos/react-ui-transcription";
+import * as Effect from "effect/Effect";
+import { EffectEx } from "@dxos/effect";
+import { useIdentity } from "@dxos/halo-react";
+import { log } from "@dxos/log";
+//#region src/hooks/useTranscriptionRecording.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-transcription/src/hooks/useTranscriptionRecording.ts";
+/**
+* Drives the recording lifecycle for a transcript: opens an audio track, feeds it through the
+* transcriber, and appends transcribed message batches to the transcript's feed. Returns the
+* recording flag and a toggle callback for the caller to wire to UI.
+*/
+var useTranscriptionRecording = (transcript) => {
+	const db = Obj.getDatabase(transcript);
+	const identity = useIdentity();
+	const feed = transcript.feed.target;
+	const [recording, setRecording] = useState(false);
+	const track = useAudioTrack(recording);
+	const { invokePromise } = useOperationInvoker();
+	const settings = useAtomCapability(TranscriptionCapabilities.Settings);
+	const transcriber = useTranscriber({
+		audioStreamTrack: track,
+		onSegments: useCallback(async (blocks) => {
+			if (!db || !feed || blocks.length === 0) return;
+			const sender = identity ? {
+				identityDid: identity.did,
+				name: identity.displayName
+			} : {};
+			let message = Obj.make(Message.Message, {
+				sender,
+				created: (/* @__PURE__ */ new Date()).toISOString(),
+				blocks
+			});
+			if (settings?.entityExtraction ?? true) {
+				const { data, error } = await invokePromise(TranscriptOperation.EnrichMessage, { message }, { spaceId: db.spaceId });
+				if (error) log.warn("entity extraction failed; using raw transcript", { error }, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 61,
+					S: void 0
+				});
+				else if (data?.message) message = data.message;
+			}
+			await Feed.append(feed, [message]).pipe(Effect.provide(Database.layer(db)), EffectEx.runAndForwardErrors);
+		}, [
+			db,
+			feed,
+			identity,
+			invokePromise,
+			settings
+		])
+	});
+	useEffect(() => {
+		if (!transcriber) return;
+		let cancelled = false;
+		transcriber.open().then(() => {
+			if (!cancelled && recording) transcriber.startChunksRecording();
+		}, (err) => {
+			if (!cancelled) {
+				log.catch(err, void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 90,
+					S: void 0
+				});
+				setRecording(false);
+			}
+		});
+		return () => {
+			cancelled = true;
+			transcriber.stopChunksRecording();
+		};
+	}, [transcriber, recording]);
+	return {
+		recording,
+		toggleRecording: useCallback(() => setRecording((value) => !value), [])
+	};
+};
+//#endregion
+export { useTranscriptionRecording };
+
+//# sourceMappingURL=hooks.mjs.map

package/dist/lib/hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.mjs","names":[],"sources":["../../src/hooks/useTranscriptionRecording.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport { useCallback, useEffect, useState } from 'react';\n\nimport { useAtomCapability, useOperationInvoker } from '@dxos/app-framework/ui';\nimport { Database, Feed, Obj } from '@dxos/echo';\nimport { EffectEx } from '@dxos/effect';\nimport { useIdentity } from '@dxos/halo-react';\nimport { log } from '@dxos/log';\nimport { useAudioTrack, useTranscriber } from '@dxos/react-ui-transcription';\nimport { Message, type Transcript } from '@dxos/types';\n\nimport { TranscriptionCapabilities, TranscriptOperation } from '#types';\n\nexport type TranscriptionRecording = {\n  recording: boolean;\n  toggleRecording: () => void;\n};\n\n/**\n * Drives the recording lifecycle for a transcript: opens an audio track, feeds it through the\n * transcriber, and appends transcribed message batches to the transcript's feed. Returns the\n * recording flag and a toggle callback for the caller to wire to UI.\n */\nexport const useTranscriptionRecording = (transcript: Transcript.Transcript): TranscriptionRecording => {\n  const db = Obj.getDatabase(transcript);\n  const identity = useIdentity();\n  const feed = transcript.feed.target;\n\n  const [recording, setRecording] = useState(false);\n  const track = useAudioTrack(recording);\n  const { invokePromise } = useOperationInvoker();\n  const settings = useAtomCapability(TranscriptionCapabilities.Settings);\n\n  // Append a transcribed message batch to the transcript's feed, enriching it first (when entity\n  // extraction is enabled) with references to known entities mentioned in the transcript.\n  const handleSegments = useCallback(\n    async (blocks: Message.Message['blocks']) => {\n      if (!db || !feed || blocks.length === 0) {\n        return;\n      }\n      const sender = identity ? { identityDid: identity.did, name: identity.displayName } : {};\n      let message = Obj.make(Message.Message, {\n        sender,\n        created: new Date().toISOString(),\n        blocks,\n      });\n\n      // `spaceId` provides the space context required by the process-affinity AiService/Database.\n      // Fall back to the raw message if extraction fails (e.g. AI service unavailable).\n      if (settings?.entityExtraction ?? true) {\n        const { data, error } = await invokePromise(\n          TranscriptOperation.EnrichMessage,\n          { message },\n          { spaceId: db.spaceId },\n        );\n        if (error) {\n          log.warn('entity extraction failed; using raw transcript', { error });\n        } else if (data?.message) {\n          message = data.message;\n        }\n      }\n\n      await Feed.append(feed, [message]).pipe(Effect.provide(Database.layer(db)), EffectEx.runAndForwardErrors);\n    },\n    [db, feed, identity, invokePromise, settings],\n  );\n\n  // Drive the transcriber lifecycle off the recording flag + audio track.\n  const transcriber = useTranscriber({ audioStreamTrack: track, onSegments: handleSegments });\n  useEffect(() => {\n    if (!transcriber) {\n      return;\n    }\n    let cancelled = false;\n    // If `open()` rejects (e.g. mic permission denied, device init failure) we must\n    // clear `recording` — otherwise the toolbar button reports \"stop\" forever while\n    // nothing is actually being captured.\n    void transcriber.open().then(\n      () => {\n        if (!cancelled && recording) {\n          transcriber.startChunksRecording();\n        }\n      },\n      (err) => {\n        if (!cancelled) {\n          log.catch(err);\n          setRecording(false);\n        }\n      },\n    );\n    return () => {\n      cancelled = true;\n      transcriber.stopChunksRecording();\n    };\n  }, [transcriber, recording]);\n\n  const toggleRecording = useCallback(() => setRecording((value) => !value), []);\n\n  return { recording, toggleRecording };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,IAAa,6BAA6B,eAA8D;CACtG,MAAM,KAAK,IAAI,YAAY,UAAU;CACrC,MAAM,WAAW,YAAY;CAC7B,MAAM,OAAO,WAAW,KAAK;CAE7B,MAAM,CAAC,WAAW,gBAAgB,SAAS,KAAK;CAChD,MAAM,QAAQ,cAAc,SAAS;CACrC,MAAM,EAAE,kBAAkB,oBAAoB;CAC9C,MAAM,WAAW,kBAAkB,0BAA0B,QAAQ;CAqCrE,MAAM,cAAc,eAAe;EAAE,kBAAkB;EAAO,YAjCvC,YACrB,OAAO,WAAsC;GAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,OAAO,WAAW,GACpC;GAEF,MAAM,SAAS,WAAW;IAAE,aAAa,SAAS;IAAK,MAAM,SAAS;GAAY,IAAI,CAAC;GACvF,IAAI,UAAU,IAAI,KAAK,QAAQ,SAAS;IACtC;IACA,0BAAS,IAAI,KAAK,EAAA,CAAE,YAAY;IAChC;GACF,CAAC;GAID,IAAI,UAAU,oBAAoB,MAAM;IACtC,MAAM,EAAE,MAAM,UAAU,MAAM,cAC5B,oBAAoB,eACpB,EAAE,QAAQ,GACV,EAAE,SAAS,GAAG,QAAQ,CACxB;IACA,IAAI,OACF,IAAI,KAAK,kDAAkD,EAAE,MAAM,GAAA;KAAA,YAAA;KAAA,GAAA;KAAA,GAAA;KAAA,GAAA,KAAA;IAAA,CAAC;SAC/D,IAAI,MAAM,SACf,UAAU,KAAK;GAEnB;GAEA,MAAM,KAAK,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,GAAG,SAAS,mBAAmB;EAC1G,GACA;GAAC;GAAI;GAAM;GAAU;GAAe;EAAQ,CAI4B;CAAe,CAAC;CAC1F,gBAAgB;EACd,IAAI,CAAC,aACH;EAEF,IAAI,YAAY;EAIhB,YAAiB,KAAK,CAAC,CAAC,WAChB;GACJ,IAAI,CAAC,aAAa,WAChB,YAAY,qBAAqB;EAErC,IACC,QAAQ;GACP,IAAI,CAAC,WAAW;IACd,IAAI,MAAM,KAAE,KAAA,GAAA;KAAA,YAAA;KAAA,GAAA;KAAA,GAAA;KAAA,GAAA,KAAA;IAAA,CAAC;IACb,aAAa,KAAK;GACpB;EACF,CACF;EACA,aAAa;GACX,YAAY;GACZ,YAAY,oBAAoB;EAClC;CACF,GAAG,CAAC,aAAa,SAAS,CAAC;CAI3B,OAAO;EAAE;EAAW,iBAFI,kBAAkB,cAAc,UAAU,CAAC,KAAK,GAAG,CAAC,CAExD;CAAgB;AACtC"}

package/dist/lib/index.mjs

@@ -0,0 +1,4 @@
+import { a as TranscriptOperation_exports, o as TranscriptionCapabilities_exports, s as Settings_exports } from "./chunk-types.mjs";
+import { t as meta } from "./chunk-meta.mjs";
+import { t as skill } from "./chunk-skills.mjs";
+export { Settings_exports as Settings, TranscriptOperation_exports as TranscriptOperation, TranscriptionCapabilities_exports as TranscriptionCapabilities, skill as TranscriptionSkill, meta };

package/dist/lib/meta.mjs

@@ -0,0 +1,2 @@
+import { t as meta } from "./chunk-meta.mjs";
+export { meta };

package/dist/lib/operations.mjs

@@ -0,0 +1,7 @@
+import { OperationHandlerSet } from "@dxos/compute";
+//#region src/operations/index.ts
+var TranscriptionOperationHandlerSet = OperationHandlerSet.lazy(() => import("./chunk-create.mjs"), () => import("./chunk-open.mjs"), () => import("./chunk-summarize.mjs"), () => import("./chunk-enrich-message.mjs"));
+//#endregion
+export { TranscriptionOperationHandlerSet };
+
+//# sourceMappingURL=operations.mjs.map

package/dist/lib/operations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.mjs","names":[],"sources":["../../src/operations/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { OperationHandlerSet } from '@dxos/compute';\n\nexport const TranscriptionOperationHandlerSet = OperationHandlerSet.lazy(\n  () => import('./create'),\n  () => import('./open'),\n  () => import('./summarize'),\n  () => import('./enrich-message'),\n);\n"],"mappings":";;AAMA,IAAa,mCAAmC,oBAAoB,WAC5D,OAAO,6BACP,OAAO,2BACP,OAAO,gCACP,OAAO,6BACf"}

package/dist/lib/plugin.mjs

@@ -0,0 +1,9 @@
+import { t as meta } from "./chunk-meta.mjs";
+import { TranscriptionOperationHandlerSet } from "./operations.mjs";
+import { Plugin } from "@dxos/app-framework";
+//#region src/plugin.ts
+var TranscriptionPlugin = Plugin.lazy(meta, () => import("#plugin"));
+//#endregion
+export { TranscriptionOperationHandlerSet, TranscriptionPlugin };
+
+//# sourceMappingURL=plugin.mjs.map

package/dist/lib/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/plugin.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from './meta';\n\nexport const TranscriptionPlugin = Plugin.lazy(meta, () => import('#plugin'));\n\nexport { TranscriptionOperationHandlerSet } from './operations';\n"],"mappings":";;;;AAQA,IAAa,sBAAsB,OAAO,KAAK,YAAY,OAAO,UAAU"}

package/dist/lib/skills.mjs

@@ -0,0 +1,2 @@
+import { t as skill } from "./chunk-skills.mjs";
+export { skill as TranscriptionSkill };

package/dist/lib/testing.mjs

@@ -0,0 +1,118 @@
+import { t as TranscriptionPlugin } from "./chunk-TranscriptionPlugin.mjs";
+import * as Schema from "effect/Schema";
+import { DXN, Obj, Ref, Type } from "@dxos/echo";
+import { Message, Organization, Person } from "@dxos/types";
+import { AppActivationEvents } from "@dxos/app-toolkit";
+import * as Effect from "effect/Effect";
+import { withPluginManager } from "@dxos/app-framework/testing";
+import { ClientPlugin, initializeIdentity } from "@dxos/plugin-client/testing";
+import { PreviewPlugin } from "@dxos/plugin-preview/testing";
+import { StorybookPlugin, corePlugins } from "@dxos/plugin-testing";
+import { IndexKind } from "@dxos/react-client/echo";
+import { withLayout } from "@dxos/react-ui/testing";
+import { seedTestData } from "@dxos/types/testing";
+import { IdentityDid } from "@dxos/keys";
+import { random } from "@dxos/random";
+//#region src/testing/testing.ts
+var TestItem = Type.makeObject(DXN.make("org.dxos.type.test", "0.1.0"))(Schema.Struct({
+	title: Schema.String.annotations({
+		title: "Title",
+		description: "Product title"
+	}),
+	description: Schema.String.annotations({
+		title: "Description",
+		description: "Product description"
+	})
+}));
+var AbstractMessageBuilder = class {};
+/**
+* Generator of transcript messages.
+*/
+var MessageBuilder = class MessageBuilder extends AbstractMessageBuilder {
+	_space;
+	static singleton = new MessageBuilder();
+	users = Array.from({ length: 5 }, () => ({
+		identityDid: IdentityDid.random().toString(),
+		name: random.person.fullName(),
+		email: random.internet.email()
+	}));
+	start = /* @__PURE__ */ new Date(Date.now() - 1440 * 60 * 1e4);
+	constructor(_space) {
+		super();
+		this._space = _space;
+	}
+	async createMessage(numSegments = 1) {
+		return Obj.make(Message.Message, {
+			created: this.next().toISOString(),
+			sender: random.helpers.arrayElement(this.users),
+			blocks: Array.from({ length: numSegments }).map(() => this.createBlock())
+		});
+	}
+	createBlock() {
+		let text = random.lorem.paragraph();
+		if (this._space) {
+			const label = random.commerce.productName();
+			const obj = this._space.db.add(Obj.make(TestItem, {
+				title: label,
+				description: random.lorem.paragraph()
+			}));
+			const dxn = Ref.make(obj).uri;
+			const words = text.split(" ");
+			words.splice(Math.floor(Math.random() * words.length), 0, `[${label}](${dxn})`);
+			text = words.join(" ");
+		}
+		return {
+			_tag: "transcript",
+			started: this.next().toISOString(),
+			text
+		};
+	}
+	next() {
+		this.start = new Date(this.start.getTime() + Math.random() * 1e4);
+		return this.start;
+	}
+};
+//#endregion
+//#region src/testing/decorators.ts
+var enableQueryIndexes = (services) => Effect.gen(function* () {
+	yield* Effect.promise(() => services.QueryService.setConfig({
+		enabled: true,
+		indexes: [
+			{ kind: IndexKind.Kind.SCHEMA_MATCH },
+			{ kind: IndexKind.Kind.GRAPH },
+			{ kind: IndexKind.Kind.VECTOR },
+			{ kind: IndexKind.Kind.FULL_TEXT }
+		]
+	}));
+	yield* Effect.promise(() => services.QueryService.reindex());
+});
+/**
+* Standard plugin-manager decorator for transcription stories: core plugins, `ClientPlugin` with
+* `Person`/`Organization`/`TestItem` schemas + seeded test data, plus `PreviewPlugin` and
+* `TranscriptionPlugin`. Toggle `enableVectorIndex` for entity-extraction.
+*/
+var createStoryDecorators = ({ enableVectorIndex = false } = {}) => [withLayout({ layout: "column" }), withPluginManager({
+	plugins: [
+		...corePlugins(),
+		StorybookPlugin({}),
+		ClientPlugin({
+			types: [
+				TestItem,
+				Person.Person,
+				Organization.Organization
+			],
+			onClientInitialized: ({ client }) => Effect.gen(function* () {
+				const { personalSpace } = yield* initializeIdentity(client);
+				if (enableVectorIndex) yield* enableQueryIndexes(client.services.services);
+				yield* Effect.promise(() => seedTestData(personalSpace));
+			})
+		}),
+		PreviewPlugin(),
+		TranscriptionPlugin()
+	],
+	setupEvents: [AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph]
+})];
+//#endregion
+export { MessageBuilder, TestItem, createStoryDecorators, enableQueryIndexes };
+
+//# sourceMappingURL=testing.mjs.map

package/dist/lib/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.mjs","names":[],"sources":["../../src/testing/testing.ts","../../src/testing/decorators.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { type Space } from '@dxos/client/echo';\nimport { DXN, Obj, Ref, Type } from '@dxos/echo';\nimport { IdentityDid } from '@dxos/keys';\nimport { random } from '@dxos/random';\nimport { type ContentBlock, Message } from '@dxos/types';\n\n// TODO(burdon): Reconcile with plugin-markdown. Move to @dxos/schema/testing.\nexport const TestItem = Type.makeObject(DXN.make('org.dxos.type.test', '0.1.0'))(\n  Schema.Struct({\n    title: Schema.String.annotations({\n      title: 'Title',\n      description: 'Product title',\n    }),\n    description: Schema.String.annotations({\n      title: 'Description',\n      description: 'Product description',\n    }),\n  }),\n);\n\n// TODO(wittjosiah): Make builder generic and reuse for all message types.\nabstract class AbstractMessageBuilder {\n  abstract createMessage(numSegments?: number): Promise<Message.Message>;\n}\n\n/**\n * Generator of transcript messages.\n */\nexport class MessageBuilder extends AbstractMessageBuilder {\n  static readonly singleton = new MessageBuilder();\n\n  users = Array.from({ length: 5 }, () => ({\n    identityDid: IdentityDid.random().toString(),\n    name: random.person.fullName(),\n    email: random.internet.email(),\n  }));\n\n  start = new Date(Date.now() - 24 * 60 * 60 * 10_000);\n\n  constructor(private readonly _space?: Space) {\n    super();\n  }\n\n  override async createMessage(numSegments = 1): Promise<Message.Message> {\n    return Obj.make(Message.Message, {\n      created: this.next().toISOString(),\n      sender: random.helpers.arrayElement(this.users),\n      blocks: Array.from({ length: numSegments }).map(() => this.createBlock()),\n    });\n  }\n\n  createBlock(): ContentBlock.Transcript {\n    let text = random.lorem.paragraph();\n    if (this._space) {\n      const label = random.commerce.productName();\n      const obj = this._space.db.add(\n        Obj.make(TestItem, {\n          title: label,\n          description: random.lorem.paragraph(),\n        }),\n      );\n      const dxn = Ref.make(obj).uri;\n      const words = text.split(' ');\n      words.splice(Math.floor(Math.random() * words.length), 0, `[${label}](${dxn})`);\n      text = words.join(' ');\n    }\n\n    return {\n      _tag: 'transcript',\n      started: this.next().toISOString(),\n      text,\n    };\n  }\n\n  next(): Date {\n    this.start = new Date(this.start.getTime() + Math.random() * 10_000);\n    return this.start;\n  }\n}\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Decorator } from '@storybook/react-vite';\nimport * as Effect from 'effect/Effect';\n\nimport { withPluginManager } from '@dxos/app-framework/testing';\nimport { AppActivationEvents } from '@dxos/app-toolkit';\nimport { ClientPlugin, initializeIdentity } from '@dxos/plugin-client/testing';\nimport { PreviewPlugin } from '@dxos/plugin-preview/testing';\nimport { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';\nimport { IndexKind } from '@dxos/react-client/echo';\nimport { withLayout } from '@dxos/react-ui/testing';\nimport { Organization, Person } from '@dxos/types';\nimport { seedTestData } from '@dxos/types/testing';\n\nimport { TranscriptionPlugin } from '../TranscriptionPlugin';\nimport { TestItem } from './testing';\n\n// TODO(mykola): Make API easier to use.\n// TODO(mykola): Delete after enabling vector indexing by default.\nexport const enableQueryIndexes = (services: { QueryService?: any }) =>\n  Effect.gen(function* () {\n    yield* Effect.promise(() =>\n      services.QueryService!.setConfig({\n        enabled: true,\n        indexes: [\n          { kind: IndexKind.Kind.SCHEMA_MATCH },\n          { kind: IndexKind.Kind.GRAPH },\n          { kind: IndexKind.Kind.VECTOR },\n          { kind: IndexKind.Kind.FULL_TEXT },\n        ],\n      }),\n    );\n    yield* Effect.promise(() => services.QueryService!.reindex());\n  });\n\ntype StoryDecoratorsOptions = {\n  /**\n   * Enable schema/graph/vector indexes after the client boots; needed for entity-extraction\n   * queries over seeded `Person` / `Organization` objects.\n   * @default false\n   */\n  enableVectorIndex?: boolean;\n};\n\n/**\n * Standard plugin-manager decorator for transcription stories: core plugins, `ClientPlugin` with\n * `Person`/`Organization`/`TestItem` schemas + seeded test data, plus `PreviewPlugin` and\n * `TranscriptionPlugin`. Toggle `enableVectorIndex` for entity-extraction.\n */\nexport const createStoryDecorators = ({ enableVectorIndex = false }: StoryDecoratorsOptions = {}): Decorator[] => [\n  withLayout({ layout: 'column' }),\n  withPluginManager({\n    plugins: [\n      ...corePlugins(),\n      StorybookPlugin({}),\n      ClientPlugin({\n        types: [TestItem, Person.Person, Organization.Organization],\n        onClientInitialized: ({ client }) =>\n          Effect.gen(function* () {\n            const { personalSpace } = yield* initializeIdentity(client);\n            if (enableVectorIndex) {\n              yield* enableQueryIndexes(client.services.services);\n            }\n            yield* Effect.promise(() => seedTestData(personalSpace));\n          }),\n      }),\n      PreviewPlugin(),\n      TranscriptionPlugin(),\n    ],\n    // setupEvents (not fireEvents) so capabilities activate during app setup, before the always-mounted\n    // driver renders: SetupSettings registers the session/settings/status capabilities it reads,\n    // SetupAppGraph the graph + transcriber contributions.\n    setupEvents: [AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph],\n  }),\n];\n"],"mappings":"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"}

package/dist/lib/translations.mjs

@@ -0,0 +1,23 @@
+import { meta } from "#meta";
+//#region src/translations.ts
+var translations = [{ "en-US": { [meta.profile.key]: {
+	"plugin.name": "Transcription",
+	"transcript-companion.label": "Transcript",
+	"delete.button": "Delete",
+	"bookmark.button": "Bookmark",
+	"scroll-to-end.label": "Scroll to latest",
+	"start-recording.label": "Start recording",
+	"stop-recording.label": "Stop recording",
+	"hold-to-record.label": "Hold to record",
+	"recording-options.label": "Recording options",
+	"record-mode.label": "Record mode",
+	"record-mode.toggle.label": "Toggle",
+	"record-mode.hold.label": "Hold to record (push to talk)",
+	"audio-device.label": "Microphone",
+	"audio-device.default.label": "System default",
+	"settings.entity-extraction.label": "Entity extraction"
+} } }];
+//#endregion
+export { translations };
+
+//# sourceMappingURL=translations.mjs.map

package/dist/lib/translations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.mjs","names":[],"sources":["../../src/translations.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Resource } from '@dxos/react-ui';\n\nimport { meta } from '#meta';\n\nexport const translations = [\n  {\n    'en-US': {\n      [meta.profile.key]: {\n        'plugin.name': 'Transcription',\n        'transcript-companion.label': 'Transcript',\n\n        'delete.button': 'Delete',\n        'bookmark.button': 'Bookmark',\n        'scroll-to-end.label': 'Scroll to latest',\n\n        'start-recording.label': 'Start recording',\n        'stop-recording.label': 'Stop recording',\n        'hold-to-record.label': 'Hold to record',\n\n        'recording-options.label': 'Recording options',\n        'record-mode.label': 'Record mode',\n        'record-mode.toggle.label': 'Toggle',\n        'record-mode.hold.label': 'Hold to record (push to talk)',\n        'audio-device.label': 'Microphone',\n        'audio-device.default.label': 'System default',\n\n        'settings.entity-extraction.label': 'Entity extraction',\n      },\n    },\n  },\n] as const satisfies Resource[];\n"],"mappings":";;AAQA,IAAa,eAAe,CAC1B,EACE,SAAS,GACN,KAAK,QAAQ,MAAM;CAClB,eAAe;CACf,8BAA8B;CAE9B,iBAAiB;CACjB,mBAAmB;CACnB,uBAAuB;CAEvB,yBAAyB;CACzB,wBAAwB;CACxB,wBAAwB;CAExB,2BAA2B;CAC3B,qBAAqB;CACrB,4BAA4B;CAC5B,0BAA0B;CAC1B,sBAAsB;CACtB,8BAA8B;CAE9B,oCAAoC;AACtC,EACF,EACF,CACF"}

package/dist/lib/types.mjs

@@ -0,0 +1,2 @@
+import { a as TranscriptOperation_exports, o as TranscriptionCapabilities_exports, s as Settings_exports } from "./chunk-types.mjs";
+export { Settings_exports as Settings, TranscriptOperation_exports as TranscriptOperation, TranscriptionCapabilities_exports as TranscriptionCapabilities };

package/dist/types/src/capabilities/app-graph-builder.d.ts

@@ -1,5 +1,5 @@
 import * as Effect from 'effect/Effect';
 import { Capability } from '@dxos/app-framework';
-declare const _default: (props: void) => Effect.Effect<Capability.Any, never, never>;
+declare const _default: (props: void) => Effect.Effect<Capability.Any, never, import("effect/Scope").Scope>;
 export default _default;
 //# sourceMappingURL=app-graph-builder.d.ts.map