@dxos/plugin-transcription 0.8.4-main.2e9d522 → 0.8.4-main.5ea62a8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-transcription",
-  "version": "0.8.4-main.2e9d522",
+  "version": "0.8.4-main.5ea62a8",
   "description": "Voice transcription.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -9,11 +9,13 @@
   "type": "module",
   "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"
     },
     "./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"
@@ -44,64 +46,64 @@
     "react-router-dom": "^6.4.0",
     "react-use": "^17.5.1",
     "wavefile": "^11.0.0",
-    "@dxos/ai": "0.8.4-main.2e9d522",
-    "@dxos/app-framework": "0.8.4-main.2e9d522",
-    "@dxos/assistant": "0.8.4-main.2e9d522",
-    "@dxos/async": "0.8.4-main.2e9d522",
-    "@dxos/blueprints": "0.8.4-main.2e9d522",
-    "@dxos/client": "0.8.4-main.2e9d522",
-    "@dxos/codec-protobuf": "0.8.4-main.2e9d522",
-    "@dxos/context": "0.8.4-main.2e9d522",
-    "@dxos/display-name": "0.8.4-main.2e9d522",
-    "@dxos/echo": "0.8.4-main.2e9d522",
-    "@dxos/debug": "0.8.4-main.2e9d522",
-    "@dxos/echo-db": "0.8.4-main.2e9d522",
-    "@dxos/echo-schema": "0.8.4-main.2e9d522",
-    "@dxos/functions": "0.8.4-main.2e9d522",
-    "@dxos/invariant": "0.8.4-main.2e9d522",
-    "@dxos/keys": "0.8.4-main.2e9d522",
-    "@dxos/live-object": "0.8.4-main.2e9d522",
-    "@dxos/local-storage": "0.8.4-main.2e9d522",
-    "@dxos/log": "0.8.4-main.2e9d522",
-    "@dxos/plugin-client": "0.8.4-main.2e9d522",
-    "@dxos/plugin-deck": "0.8.4-main.2e9d522",
-    "@dxos/plugin-graph": "0.8.4-main.2e9d522",
-    "@dxos/plugin-markdown": "0.8.4-main.2e9d522",
-    "@dxos/plugin-space": "0.8.4-main.2e9d522",
-    "@dxos/plugin-thread": "0.8.4-main.2e9d522",
-    "@dxos/protocols": "0.8.4-main.2e9d522",
-    "@dxos/react-client": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-attention": "0.8.4-main.2e9d522",
-    "@dxos/react-edge-client": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-components": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-editor": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-form": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-sfx": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-grid": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-stack": "0.8.4-main.2e9d522",
-    "@dxos/schema": "0.8.4-main.2e9d522",
-    "@dxos/tracing": "0.8.4-main.2e9d522",
-    "@dxos/util": "0.8.4-main.2e9d522"
+    "@dxos/ai": "0.8.4-main.5ea62a8",
+    "@dxos/app-framework": "0.8.4-main.5ea62a8",
+    "@dxos/assistant": "0.8.4-main.5ea62a8",
+    "@dxos/client": "0.8.4-main.5ea62a8",
+    "@dxos/codec-protobuf": "0.8.4-main.5ea62a8",
+    "@dxos/blueprints": "0.8.4-main.5ea62a8",
+    "@dxos/context": "0.8.4-main.5ea62a8",
+    "@dxos/debug": "0.8.4-main.5ea62a8",
+    "@dxos/display-name": "0.8.4-main.5ea62a8",
+    "@dxos/async": "0.8.4-main.5ea62a8",
+    "@dxos/echo-schema": "0.8.4-main.5ea62a8",
+    "@dxos/echo-db": "0.8.4-main.5ea62a8",
+    "@dxos/echo": "0.8.4-main.5ea62a8",
+    "@dxos/functions": "0.8.4-main.5ea62a8",
+    "@dxos/keys": "0.8.4-main.5ea62a8",
+    "@dxos/live-object": "0.8.4-main.5ea62a8",
+    "@dxos/local-storage": "0.8.4-main.5ea62a8",
+    "@dxos/invariant": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-deck": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-graph": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-markdown": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-space": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-thread": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-client": "0.8.4-main.5ea62a8",
+    "@dxos/log": "0.8.4-main.5ea62a8",
+    "@dxos/protocols": "0.8.4-main.5ea62a8",
+    "@dxos/react-client": "0.8.4-main.5ea62a8",
+    "@dxos/react-edge-client": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-attention": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-components": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-editor": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-form": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-sfx": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-stack": "0.8.4-main.5ea62a8",
+    "@dxos/schema": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-grid": "0.8.4-main.5ea62a8",
+    "@dxos/tracing": "0.8.4-main.5ea62a8",
+    "@dxos/util": "0.8.4-main.5ea62a8"
   },
   "devDependencies": {
     "@effect-rx/rx-react": "0.38.0",
-    "@effect/platform": "0.89.0",
+    "@effect/platform": "0.90.2",
     "@types/dom-speech-recognition": "^0.0.6",
     "@types/react": "~18.2.0",
-    "effect": "3.17.0",
+    "effect": "3.17.7",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "tailwindcss": "~3.4.1",
-    "@dxos/plugin-preview": "0.8.4-main.2e9d522",
-    "@dxos/plugin-storybook-layout": "0.8.4-main.2e9d522",
-    "@dxos/plugin-theme": "0.8.4-main.2e9d522",
-    "@dxos/random": "0.8.4-main.2e9d522",
-    "@dxos/react-ui": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-form": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-theme": "0.8.4-main.2e9d522",
-    "@dxos/storybook-utils": "0.8.4-main.2e9d522",
-    "@dxos/test-utils": "0.8.4-main.2e9d522"
+    "@dxos/plugin-preview": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-theme": "0.8.4-main.5ea62a8",
+    "@dxos/random": "0.8.4-main.5ea62a8",
+    "@dxos/plugin-storybook-layout": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-form": "0.8.4-main.5ea62a8",
+    "@dxos/storybook-utils": "0.8.4-main.5ea62a8",
+    "@dxos/test-utils": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-theme": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.5ea62a8"
   },
   "peerDependencies": {
     "@effect-rx/rx-react": "^0.34.1",
@@ -109,8 +111,8 @@
     "effect": "^3.13.3",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-theme": "0.8.4-main.2e9d522"
+    "@dxos/react-ui": "0.8.4-main.5ea62a8",
+    "@dxos/react-ui-theme": "0.8.4-main.5ea62a8"
   },
   "publishConfig": {
     "access": "public"

package/src/TranscriptionPlugin.tsx

@@ -8,11 +8,11 @@ import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
 import { getSpace } from '@dxos/react-client/echo';
 import { DataType } from '@dxos/schema';
 
-import { IntentResolver, ReactSurface, Transcriber } from './capabilities';
+import { BlueprintDefinition, IntentResolver, ReactSurface, Transcriber } from './capabilities';
 import { renderMarkdown } from './components';
 import { meta } from './meta';
 import { translations } from './translations';
-import { TranscriptType } from './types';
+import { Transcript } from './types';
 
 export const TranscriptionPlugin = () =>
   definePlugin(meta, [
@@ -26,11 +26,11 @@ export const TranscriptionPlugin = () =>
       activatesOn: Events.SetupMetadata,
       activate: (context) =>
         contributes(Capabilities.Metadata, {
-          id: TranscriptType.typename,
+          id: Transcript.Transcript.typename,
           metadata: {
             icon: 'ph--subtitles--regular',
             // TODO(wittjosiah): Factor out. Artifact? Separate capability?
-            getTextContent: async (transcript: TranscriptType) => {
+            getTextContent: async (transcript: Transcript.Transcript) => {
               const space = getSpace(transcript);
               const members = space?.members.get().map((member) => member.identity) ?? [];
               const queue = space?.queues.get<DataType.Message>(transcript.queue.dxn);
@@ -47,7 +47,7 @@ export const TranscriptionPlugin = () =>
     defineModule({
       id: `${meta.id}/module/schema`,
       activatesOn: ClientEvents.SetupSchema,
-      activate: () => [contributes(ClientCapabilities.Schema, [TranscriptType])],
+      activate: () => [contributes(ClientCapabilities.Schema, [Transcript.Transcript])],
     }),
     defineModule({
       id: `${meta.id}/module/react-surface`,
@@ -64,4 +64,9 @@ export const TranscriptionPlugin = () =>
       activatesOn: Events.SetupAppGraph,
       activate: Transcriber,
     }),
+    defineModule({
+      id: `${meta.id}/module/blueprint`,
+      activatesOn: Events.SetupArtifactDefinition,
+      activate: BlueprintDefinition,
+    }),
   ]);

package/src/capabilities/blueprint-definition.ts

@@ -0,0 +1,31 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes } from '@dxos/app-framework';
+import { Blueprint, Template } from '@dxos/blueprints';
+import { type FunctionDefinition } from '@dxos/functions';
+import { trim } from '@dxos/util';
+
+import { open, summarize } from '../functions';
+
+const functions: FunctionDefinition[] = [open, summarize];
+
+export default () => {
+  return [
+    contributes(Capabilities.Functions, functions),
+    contributes(
+      Capabilities.BlueprintDefinition,
+      Blueprint.make({
+        key: 'dxos.org/blueprint/transcription',
+        name: 'Transcription',
+        tools: Blueprint.toolDefinitions({ functions }),
+        instructions: Template.make({
+          source: trim`
+            You can open and summarize a meeting transcript.
+          `,
+        }),
+      }),
+    ),
+  ];
+};

package/src/capabilities/capabilities.ts

@@ -6,11 +6,11 @@ import { defineCapability } from '@dxos/app-framework';
 
 import { TRANSCRIPTION_PLUGIN } from '../meta';
 import {
-  type TranscriberParams,
+  type MediaStreamRecorderParams,
   type Transcriber,
-  type TranscriptionManager,
+  type TranscriberParams,
   type TranscriptMessageEnricher,
-  type MediaStreamRecorderParams,
+  type TranscriptionManager,
 } from '../transcriber';
 
 export namespace TranscriptionCapabilities {

package/src/capabilities/index.ts

@@ -4,6 +4,7 @@
 
 import { lazy } from '@dxos/app-framework';
 
+export const BlueprintDefinition = lazy(() => import('./blueprint-definition'));
 export const IntentResolver = lazy(() => import('./intent-resolver'));
 export const ReactSurface = lazy(() => import('./react-surface'));
 export const Transcriber = lazy(() => import('./transcriber'));

package/src/capabilities/intent-resolver.ts

@@ -2,22 +2,16 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Capabilities, contributes, createResolver, type PluginContext } from '@dxos/app-framework';
-import { type Key, Obj, Ref } from '@dxos/echo';
-import { createQueueDXN } from '@dxos/echo-schema';
+import { Capabilities, type PluginContext, contributes, createResolver } from '@dxos/app-framework';
 
-import { TranscriptionAction, TranscriptType } from '../types';
+import { Transcript, TranscriptAction } from '../types';
 
 export default (context: PluginContext) =>
   contributes(Capabilities.IntentResolver, [
     createResolver({
-      intent: TranscriptionAction.Create,
-      resolve: ({ name, spaceId }) => {
-        const transcript = Obj.make(TranscriptType, {
-          // TODO(dmaretskyi): Use space.queues.create() instead.
-          queue: Ref.fromDXN(createQueueDXN(spaceId as Key.SpaceId)),
-        });
-
+      intent: TranscriptAction.Create,
+      resolve: ({ name, space }) => {
+        const transcript = Transcript.makeTranscript(space.queues.create().dxn);
         return { data: { object: transcript } };
       },
     }),

package/src/capabilities/react-surface.tsx

@@ -9,14 +9,14 @@ import { Obj } from '@dxos/echo';
 
 import { TranscriptionContainer } from '../components';
 import { meta } from '../meta';
-import { TranscriptType } from '../types';
+import { Transcript } from '../types';
 
 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),
+      filter: (data): data is { subject: Transcript.Transcript } => Obj.instanceOf(Transcript.Transcript, data.subject),
       component: ({ data, role }) => <TranscriptionContainer transcript={data.subject} role={role} />,
     }),
   ]);

package/src/capabilities/transcriber.ts

@@ -2,12 +2,13 @@
 // Copyright 2025 DXOS.org
 //
 
-import { contributes, type PluginContext } from '@dxos/app-framework';
+import { type PluginContext, contributes } from '@dxos/app-framework';
 import { ClientCapabilities } from '@dxos/plugin-client';
 
-import { TranscriptionCapabilities } from './capabilities';
 import { MediaStreamRecorder, Transcriber, TranscriptionManager } from '../transcriber';
 
+import { TranscriptionCapabilities } from './capabilities';
+
 // TODO(burdon): Move to config?
 
 /**

package/src/components/Transcript/Transcript.stories.tsx

@@ -24,7 +24,6 @@ import { DataType } from '@dxos/schema';
 import { Testing } from '@dxos/schema/testing';
 import { withLayout } from '@dxos/storybook-utils';
 
-import { renderMarkdown, Transcript, type TranscriptProps } from './Transcript';
 import { useQueueModelAdapter } from '../../hooks';
 import { SerializationModel } from '../../model';
 import {
@@ -35,13 +34,15 @@ import {
 } from '../../testing';
 import { translations } from '../../translations';
 
+import { TranscriptView, type TranscriptViewProps, renderMarkdown } from './Transcript';
+
 faker.seed(1);
 
 /**
  * Story wrapper with test controls.
  */
 const TranscriptContainer: FC<
-  TranscriptProps & {
+  TranscriptViewProps & {
     running: boolean;
     onRunningChange: (running: boolean) => void;
     onReset?: () => void;
@@ -49,7 +50,7 @@ const TranscriptContainer: FC<
 > = ({ space, model, running, onRunningChange, onReset }) => {
   return (
     <div className='grid grid-rows-[1fr_40px] grow divide-y divide-separator'>
-      <Transcript space={space} model={model} />
+      <TranscriptView space={space} model={model} />
       <div className='grid grid-cols-[1fr_16rem] overflow-hidden'>
         <div className='flex items-center'>
           <SyntaxHighlighter language='json' className='text-sm'>
@@ -69,7 +70,7 @@ const TranscriptContainer: FC<
   );
 };
 
-type StoryProps = { messages?: DataType.Message[] } & Pick<TranscriptProps, 'ignoreAttention' | 'attendableId'>;
+type StoryProps = { messages?: DataType.Message[] } & Pick<TranscriptViewProps, 'ignoreAttention' | 'attendableId'>;
 
 /**
  * Basic story mutates array of messages.
@@ -178,7 +179,7 @@ const QueueStoryWrapper = () => {
   return <QueueStory key={key} queueId={queueId} onReset={handleReset} />;
 };
 
-const meta: Meta<typeof QueueStory> = {
+const meta = {
   title: 'plugins/plugin-transcription/Transcript',
   decorators: [
     withPluginManager({
@@ -187,7 +188,7 @@ const meta: Meta<typeof QueueStory> = {
         StorybookLayoutPlugin(),
         ClientPlugin({
           types: [TestItem, Testing.DocumentType, DataType.Person, DataType.Organization],
-          onClientInitialized: async (_, client) => {
+          onClientInitialized: async ({ client }) => {
             await client.halo.createIdentity();
           },
         }),
@@ -202,13 +203,11 @@ const meta: Meta<typeof QueueStory> = {
   parameters: {
     translations,
   },
-};
+} satisfies Meta;
 
 export default meta;
 
-type Story = StoryObj<typeof QueueStory>;
-
-export const Default: Story = {
+export const Default: StoryObj<typeof BasicStory> = {
   render: BasicStory,
   args: {
     ignoreAttention: true,
@@ -217,7 +216,7 @@ export const Default: Story = {
   },
 };
 
-export const Empty: Story = {
+export const Empty: StoryObj<typeof BasicStory> = {
   render: BasicStory,
   args: {
     ignoreAttention: true,
@@ -225,7 +224,7 @@ export const Empty: Story = {
   },
 };
 
-export const WithQueue: Story = {
+export const WithQueue: StoryObj<typeof QueueStoryWrapper> = {
   render: QueueStoryWrapper,
   args: {
     ignoreAttention: true,
@@ -233,7 +232,7 @@ export const WithQueue: Story = {
   },
 };
 
-export const WithEntityExtractionQueue: Story = {
+export const WithEntityExtractionQueue: StoryObj<typeof EntityExtractionQueueStory> = {
   render: EntityExtractionQueueStory,
   args: {
     ignoreAttention: true,

package/src/components/Transcript/Transcript.tsx

@@ -21,9 +21,10 @@ import { mx } from '@dxos/react-ui-theme';
 import { type DataType } from '@dxos/schema';
 import { isNotFalsy } from '@dxos/util';
 
-import { transcript } from './transcript-extension';
 import { type SerializationModel } from '../../model';
-import { type TranscriptType } from '../../types';
+import { type Transcript } from '../../types';
+
+import { transcript } from './transcript-extension';
 
 export const renderMarkdown =
   (identities: Identity[]) =>
@@ -50,8 +51,8 @@ export const renderMarkdown =
     ];
   };
 
-export type TranscriptProps = ThemedClassName<{
-  transcript?: TranscriptType;
+export type TranscriptViewProps = ThemedClassName<{
+  transcript?: Transcript.Transcript;
   space?: Space;
   model: SerializationModel<DataType.Message>;
   // TODO(wittjosiah): Move to container.
@@ -62,19 +63,19 @@ export type TranscriptProps = ThemedClassName<{
 /**
  * Transcript component implemented using the editor.
  */
-export const Transcript = ({
+export const TranscriptView = ({
   classNames,
   transcript: object,
   space,
   model,
   attendableId,
   ignoreAttention,
-}: TranscriptProps) => {
+}: TranscriptViewProps) => {
   const { themeMode } = useThemeContext();
   const { parentRef } = useTextEditor(() => {
     return {
       extensions: [
-        createBasicExtensions({ readOnly: true, lineWrapping: true }),
+        createBasicExtensions({ readOnly: true, lineWrapping: true, search: true }),
         createMarkdownExtensions({ themeMode }),
         createThemeExtensions({ themeMode }),
         decorateMarkdown(),

package/src/components/Transcript/deprecated/OldTranscript.tsx

@@ -5,16 +5,16 @@
 import { intervalToDuration } from 'date-fns/intervalToDuration';
 import { Schema } from 'effect';
 import { yieldOrContinue } from 'main-thread-scheduling';
-import React, { type FC, useCallback, useEffect, useMemo, useRef, useState, type WheelEvent } from 'react';
+import React, { type FC, type WheelEvent, useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { type OnResizeCallback, useResizeDetector } from 'react-resize-detector';
 
 import { Type } from '@dxos/echo';
 import { IconButton, type ThemedClassName, useTranslation } from '@dxos/react-ui';
 import { useAttention } from '@dxos/react-ui-attention';
 import {
+  type DxGridAxisMeta,
   type DxGridCellValue,
   type DxGridElement,
-  type DxGridAxisMeta,
   type DxGridPlaneCells,
   Grid,
   toPlaneCellIndex,
@@ -115,7 +115,7 @@ const measureRows = async (
   return result;
 };
 
-export type TranscriptProps = ThemedClassName<{
+export type TranscriptViewProps = ThemedClassName<{
   blocks?: TranscriptBlock[];
   attendableId?: string;
   ignoreAttention?: boolean;
@@ -124,7 +124,7 @@ export type TranscriptProps = ThemedClassName<{
 /**
  * @@deprecated
  */
-export const Transcript: FC<TranscriptProps> = ({ classNames, blocks, attendableId, ignoreAttention }) => {
+export const Transcript: FC<TranscriptViewProps> = ({ classNames, blocks, attendableId, ignoreAttention }) => {
   const { t } = useTranslation(TRANSCRIPTION_PLUGIN);
   const [dxGrid, setDxGrid] = useState<DxGridElement | null>(null);
   const [rows, setRows] = useState<DxGridAxisMeta | undefined>(undefined);

package/src/components/TranscriptContainer.tsx

@@ -9,13 +9,14 @@ import { useMembers, useQueue } from '@dxos/react-client/echo';
 import { StackItem } from '@dxos/react-ui-stack';
 import { type DataType } from '@dxos/schema';
 
-import { Transcript, renderMarkdown } from './Transcript';
 import { useQueueModelAdapter } from '../hooks';
-import { type TranscriptType } from '../types';
+import { type Transcript } from '../types';
+
+import { TranscriptView, renderMarkdown } from './Transcript';
 
 export type TranscriptionContainerProps = {
   role: string;
-  transcript: TranscriptType;
+  transcript: Transcript.Transcript;
 };
 
 export const TranscriptionContainer = ({ transcript }: TranscriptionContainerProps) => {
@@ -27,7 +28,7 @@ export const TranscriptionContainer = ({ transcript }: TranscriptionContainerPro
 
   return (
     <StackItem.Content classNames='container-max-width pli-2'>
-      <Transcript attendableId={attendableId} space={space} model={model} transcript={transcript} />
+      <TranscriptView attendableId={attendableId} space={space} model={model} transcript={transcript} />
     </StackItem.Content>
   );
 };

package/src/components/stories/FileTranscription.stories.tsx

@@ -23,18 +23,19 @@ import { StorybookLayoutPlugin } from '@dxos/plugin-storybook-layout';
 import { ThemePlugin } from '@dxos/plugin-theme';
 import { defaultTx } from '@dxos/react-ui-theme';
 import { DataType } from '@dxos/schema';
-import { seedTestData, Testing } from '@dxos/schema/testing';
+import { Testing, seedTestData } from '@dxos/schema/testing';
 import { withLayout, withTheme } from '@dxos/storybook-utils';
 
-import { TranscriptionStory } from './TranscriptionStory';
-import { useIsSpeaking } from './useIsSpeaking';
-import { TranscriptionPlugin } from '../../TranscriptionPlugin';
 import { useAudioFile, useQueueModelAdapter, useTranscriber } from '../../hooks';
-import { getActorId, MessageNormalizer } from '../../segments-normalization';
+import { MessageNormalizer, getActorId } from '../../segments-normalization';
 import { TestItem } from '../../testing';
 import { type MediaStreamRecorderParams, type TranscriberParams } from '../../transcriber';
+import { TranscriptionPlugin } from '../../TranscriptionPlugin';
 import { renderMarkdown } from '../Transcript';
 
+import { TranscriptionStory } from './TranscriptionStory';
+import { useIsSpeaking } from './useIsSpeaking';
+
 const AudioFile = ({
   detectSpeaking,
   audioUrl,
@@ -67,7 +68,6 @@ const AudioFile = ({
 
   useEffect(() => {
     if (!audio) {
-      log.warn('no audio');
       return;
     }
 
@@ -146,10 +146,10 @@ const AudioFile = ({
   }, [normalizer]);
 
   const manageChunkRecording = () => {
-    if (running && isSpeaking) {
+    if (running && isSpeaking && transcriber) {
       log.info('starting transcription');
       transcriber?.startChunksRecording();
-    } else if (!isSpeaking || !running) {
+    } else if ((!isSpeaking || !running) && transcriber) {
       log.info('stopping transcription');
       transcriber?.stopChunksRecording();
     }
@@ -175,10 +175,18 @@ const AudioFile = ({
     manageChunkRecording();
   }, [isSpeaking, stream]);
 
-  return <TranscriptionStory model={model} running={running} onRunningChange={setRunning} audioRef={ref} />;
+  return (
+    <TranscriptionStory
+      disabled={!stream}
+      model={model}
+      running={running}
+      onRunningChange={setRunning}
+      audioRef={ref}
+    />
+  );
 };
 
-const meta: Meta<typeof AudioFile> = {
+const meta = {
   title: 'plugins/plugin-transcription/FileTranscription',
   decorators: [
     withPluginManager({
@@ -187,7 +195,7 @@ const meta: Meta<typeof AudioFile> = {
         StorybookLayoutPlugin(),
         ClientPlugin({
           types: [TestItem, DataType.Person, DataType.Organization, Testing.DocumentType],
-          onClientInitialized: async (_, client) => {
+          onClientInitialized: async ({ client }) => {
             await client.halo.createIdentity();
             await client.spaces.waitUntilReady();
             await client.spaces.default.waitUntilReady();
@@ -205,10 +213,12 @@ const meta: Meta<typeof AudioFile> = {
     withTheme,
     withLayout({ fullscreen: true, classNames: 'justify-center' }),
   ],
-};
+} satisfies Meta;
 
 export default meta;
 
+type Story = StoryObj<typeof meta>;
+
 const TRANSCRIBER_CONFIG = {
   transcribeAfterChunksAmount: 100,
   prefixBufferChunksAmount: 50,