@dxos/plugin-transcription 0.8.4-main.ae835ea → 0.8.4-main.bc2380dfbc

package/src/functions/summarize.ts

@@ -1,103 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Array from 'effect/Array';
-import * as Effect from 'effect/Effect';
-import * as Function from 'effect/Function';
-import * as Layer from 'effect/Layer';
-import * as Option from 'effect/Option';
-import * as Schema from 'effect/Schema';
-
-import { AiService, ConsolePrinter, ToolExecutionService, ToolResolverService } from '@dxos/ai';
-import { AiSession, GenerationObserver } from '@dxos/assistant';
-import { TracingService, defineFunction } from '@dxos/functions';
-import { trim } from '@dxos/util';
-
-/**
- * Summarize a transcript of a meeting.
- */
-export default defineFunction({
-  key: 'dxos.org/function/transcription/summarize',
-  name: 'Summarize',
-  description: 'Summarize a transcript of a meeting.',
-  inputSchema: Schema.Struct({
-    transcript: Schema.String.annotations({
-      description: 'The transcript of the meeting.',
-    }),
-    notes: Schema.optional(Schema.String).annotations({
-      description: 'Additional notes from the participants.',
-    }),
-  }),
-  outputSchema: Schema.Struct({
-    summary: Schema.String.annotations({
-      description: 'The summary of the transcript.',
-    }),
-  }),
-  handler: Effect.fnUntraced(
-    function* ({ data: { transcript, notes } }) {
-      const result = yield* new AiSession().run({
-        prompt: `Transcript: ${transcript}\n\nNotes: ${notes}`,
-        history: [],
-        system: systemPrompt,
-        observer: GenerationObserver.fromPrinter(new ConsolePrinter({ tag: 'summarize' })),
-      });
-
-      const summary = Function.pipe(
-        result,
-        Array.findLast((msg) => msg.sender.role === 'assistant' && msg.blocks.some((block) => block._tag === 'text')),
-        Option.flatMap((msg) =>
-          Function.pipe(
-            msg.blocks,
-            Array.findLast((block) => block._tag === 'text'),
-            Option.map((block) => block.text),
-          ),
-        ),
-        Option.getOrThrowWith(() => new Error('No summary found')),
-      );
-
-      return { summary };
-    },
-    Effect.provide(
-      Layer.mergeAll(
-        AiService.model('@anthropic/claude-sonnet-4-0'),
-        ToolResolverService.layerEmpty,
-        ToolExecutionService.layerEmpty,
-        TracingService.layerNoop,
-      ),
-    ),
-  ),
-});
-
-const systemPrompt = trim`
-  You are a helpful assistant that summarizes transcripts of meetings.
-
-  # Goal
-  Create a markdown summary of the meeting transcript with text notes provided.
-  Notes are very important so make sure to include them in the summary if they contain meaningful information.
-
-  # Formatting
-  - Format the summary as a markdown document without extra comments like "Here is the summary of the transcript:".
-  - Use markdown formatting for headings and bullet points.
-  - Format the summary as a list of key points and takeaways.
-  - All names of people should be in bold.
-
-  # Note Taking
-  - Correlate items in the summary with the person of origin to build a coherent narrative.
-  - Include short quotes verbatim where appropriate. Especially when concerned with design decisions and problem descriptions.
-
-  # Tasks
-  At the end of the summary include tasks.
-  Extract only the tasks that are:
-  - Directly actionable.
-  - Clearly assigned to a person or team (or can easily be inferred).
-  - Strongly implied by the conversation and/or user note (no speculative tasks).
-  - Specific enough that someone reading them would know exactly what to do next.
-
-  Format all tasks as markdown checkboxes using the syntax:
-  - [ ] Task description.
-
-  Additional information can be included (indented).
-
-  If no actionable tasks are found, omit this tasks section.
-`;

package/src/hooks/useQueueModelAdapter.ts

@@ -1,66 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useMemo, useState } from 'react';
-
-import type { Obj } from '@dxos/echo';
-import { type Queue } from '@dxos/react-client/echo';
-
-import { type ChunkRenderer, SerializationModel } from '../model';
-
-/**
- * Model adapter for a queue.
- */
-export const useQueueModelAdapter = <T extends Obj.Any>(
-  renderer: ChunkRenderer<T>,
-  queue: Queue<T> | undefined,
-  initialChunks: T[] = [],
-): SerializationModel<T> => {
-  const model = useMemo(() => new SerializationModel<T>(renderer, initialChunks), [queue]);
-  const [loaded, setLoaded] = useState(false);
-
-  // Set initial blocks.
-  useEffect(() => {
-    if (!queue) {
-      return;
-    }
-
-    const update = () => {
-      for (const block of queue?.objects ?? []) {
-        model.appendChunk(block);
-      }
-
-      setLoaded(true);
-    };
-
-    // TODO(burdon): This is a hack to ensure the queue is loaded.
-    let i: NodeJS.Timeout | undefined;
-    if (queue.isLoading) {
-      i = setInterval(() => {
-        if (!queue?.isLoading) {
-          clearInterval(i);
-          update();
-        }
-      }, 1_000);
-    } else {
-      update();
-    }
-
-    return () => clearTimeout(i);
-  }, [model, queue]);
-
-  // TODO(burdon): Can we listen for queue events?
-  useEffect(() => {
-    if (!loaded || !queue || model.chunks.length === queue.objects.length) {
-      return;
-    }
-
-    const chunk = queue.objects.at(-1);
-    if (chunk) {
-      model.appendChunk(chunk);
-    }
-  }, [model, loaded, queue?.objects.length]);
-
-  return model;
-};

package/src/segments-normalization/normalization.ts

@@ -1,115 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-// ISSUE(burdon): defineFunction
-// @ts-nocheck
-
-import * as Schema from 'effect/Schema';
-
-import { AiService, DEFAULT_EDGE_MODEL } from '@dxos/ai';
-import { AiSession } from '@dxos/assistant';
-import { Obj } from '@dxos/echo';
-import { defineFunction } from '@dxos/functions';
-import { ObjectId } from '@dxos/keys';
-import { log } from '@dxos/log';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-const MessageWithRangeId = Schema.extend(
-  DataType.Message,
-  Schema.Struct({
-    // TODO(mykola): Move to meta in DataType.Message. Use `DataType.Message` instead.
-    rangeId: Schema.optional(Schema.Array(Schema.String)).annotations({
-      description: 'The IDs of the messages that contain the sentences.',
-    }),
-  }),
-);
-
-export interface MessageWithRangeId extends Schema.Schema.Type<typeof MessageWithRangeId> {}
-
-export const NormalizationInput = Schema.Struct({
-  // TODO(mykola): Move to meta in DataType.Message. Use `DataType.Message` instead.
-  messages: Schema.Array(MessageWithRangeId).annotations({
-    description: 'Messages to normalize into sentences.',
-  }),
-});
-export interface NormalizationInput extends Schema.Schema.Type<typeof NormalizationInput> {}
-
-export const NormalizationOutput = Schema.Struct({
-  sentences: Schema.Array(MessageWithRangeId.pipe(Schema.mutable)).pipe(Schema.mutable).annotations({
-    description: 'The sentences of the transcript.',
-  }),
-});
-export interface NormalizationOutput extends Schema.Schema.Type<typeof NormalizationOutput> {}
-
-export const sentenceNormalization = defineFunction<NormalizationInput, NormalizationOutput>({
-  description: 'Post process of transcription for sentence normalization',
-  inputSchema: NormalizationInput,
-  outputSchema: NormalizationOutput,
-  handler: async ({ data: { messages }, context }) => {
-    log.info('input', { messages });
-    const ai = context.getService(AiService);
-    const session = new AiSession({ operationModel: 'configured' });
-
-    // TODO(dmaretskyi): This got broken after effect-ai transition.
-    const response = session.runStructured(NormalizationOutput, {
-      generationOptions: {
-        model: DEFAULT_EDGE_MODEL,
-      },
-      client: ai.client,
-      tools: [],
-      artifacts: [],
-      history: [
-        Obj.make(DataType.Message, {
-          created: new Date().toISOString(),
-          sender: {
-            role: 'user',
-          },
-          blocks: messages.map((message) => ({ _tag: 'text', text: JSON.stringify(message) }) as const),
-        }),
-      ],
-      prompt,
-    }) as any;
-
-    response.sentences.forEach((sentence) => {
-      sentence.id = ObjectId.random();
-    });
-    log.info('response', { response });
-    return response;
-  },
-});
-
-const prompt = trim`
-  You are observing a real-time transcript of a single person speaking.
-  The transcription is delivered in chunks of 10 seconds or less. As a result, individual sentences may be split across multiple messages, or multiple sentences may appear within a single message. Additionally, because this is real-time transcription, punctuation and capitalization may be incorrect or missing.
-
-  # Task Description:
-    - Your task is to detect and reconstruct broken or incomplete sentences by merging segments into coherent, grammatically correct sentences where appropriate.
-
-  # Input Format:
-    - The input is an array of messages that contain transcription blocks.
-    - Each message is a DataType.Message, as described in the output format.
-
-  # Output Format:
-    - You have been provided with the tool that defines the output format; make sure to query it.
-    - Do not output anything other than the expected format.
-
-  # Segment Handling Rules:
-    - Sort messages by timestamp.
-    - Leave ID of the first message in a sentence.
-    - Each divided sentence should be added to the output as a separate message or block within existing messages, preserving the original order.
-    - If one message contains multiple sentences, you should not split them.
-    - The last sentence may be incomplete; it should still be output as a separate block or message.
-    - Keep track of the original timestamps of the messages and blocks and, use the timestamp of the first message/block of a sentence as the 'started' field of the merged message.
-    - The 'rangeId' field of the merged message should include 'messageId'-s and 'rangeId'-s of all messages that have been used to construct this message.
-
-  # Punctuation and Capitalization:
-    - Do not rely on the original punctuation and capitalization—they may be incorrect.
-    - Use logical reasoning to apply appropriate punctuation (e.g., period, comma, question mark, exclamation mark) and capitalization.
-
-  # Restrictions:
-    - Do not alter the order of the original messages; maintain the natural flow of speech.
-    - Do not interpret or infer meaning beyond reconstructing sentences.
-    - Do not add or remove any words or phrases.
-`;

package/src/types/Transcript.ts

@@ -1,44 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Queue } from '@dxos/client/echo';
-import { type DXN, Obj, Ref, Type } from '@dxos/echo';
-
-/**
- * Root transcript object created when the user starts a transcription.
- */
-export const Transcript = Schema.Struct({
-  // TODO(wittjosiah): Remove?
-  // TODO(burdon): Use Date or string?
-  started: Schema.optional(Schema.String),
-  ended: Schema.optional(Schema.String),
-
-  /**
-   * Queue containing TranscriptBlock objects.
-   */
-  queue: Type.Ref(Queue),
-}).pipe(
-  Type.Obj({
-    typename: 'dxos.org/type/Transcript',
-    version: '0.1.0',
-  }),
-);
-
-export type Transcript = Schema.Schema.Type<typeof Transcript>;
-
-// TODO(burdon): Do these need to be kept in sync with EDGE?
-
-/**
- * First message in queue.
- * Contains metadata for the recording and transcript.
- */
-const TranscriptHeader = Schema.Struct({
-  started: Schema.optional(Schema.String),
-});
-
-export type TranscriptHeader = Schema.Schema.Type<typeof TranscriptHeader>;
-
-export const makeTranscript = (queueDxn: DXN) => Obj.make(Transcript, { queue: Ref.fromDXN(queueDxn) });

package/src/types/TranscriptAction.ts

@@ -1,24 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { SpaceSchema } from '@dxos/client/echo';
-
-import { meta } from '../meta';
-
-import { Transcript } from './Transcript';
-
-/**
- * Endpoint to the calls service.
- */
-export class Create extends Schema.TaggedClass<Create>()(`${meta.id}/action/create`, {
-  input: Schema.Struct({
-    name: Schema.optional(Schema.String),
-    space: SpaceSchema,
-  }),
-  output: Schema.Struct({
-    object: Transcript,
-  }),
-}) {}

package/src/types/types.ts

@@ -1,9 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-/**
- * Endpoint to the calls service.
- */
-// TODO(burdon): Reconfigure/move.
-export const TRANSCRIPTION_URL = 'https://calls-service.dxos.workers.dev';

package/src/{segments-normalization → normalization}/index.ts

@@ -2,6 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './normalization';
 export * from './message-normalizer';
+export * from './normalization';
 export * from './utils';