@absolutejs/voice 0.0.22-beta.549 → 0.0.22-beta.550

package/dist/core/scribe.d.ts

@@ -0,0 +1,50 @@
+import type { AudioChunk, AudioFormat, STTAdapter, Transcript, VoiceCloseEvent, VoiceErrorEvent, VoiceLanguageStrategy, VoiceLexiconEntry, VoicePhraseHint } from "./types";
+export type VoiceScribeTurn = {
+    speaker: string;
+    text: string;
+    confidence?: number;
+    startedAtMs?: number;
+    endedAtMs?: number;
+};
+export type VoiceScribePartialEvent = {
+    type: "partial";
+    transcript: Transcript;
+};
+export type VoiceScribeTurnEvent = {
+    type: "turn";
+    turn: VoiceScribeTurn;
+};
+export type VoiceScribeEventMap = {
+    partial: VoiceScribePartialEvent;
+    turn: VoiceScribeTurnEvent;
+    error: VoiceErrorEvent;
+    close: VoiceCloseEvent;
+};
+export type VoiceScribeSession = {
+    on: <K extends keyof VoiceScribeEventMap>(event: K, handler: (payload: VoiceScribeEventMap[K]) => void | Promise<void>) => () => void;
+    /** Push a chunk of audio (same format declared in `open`). */
+    send: (audio: AudioChunk) => Promise<void>;
+    /** All finalized, speaker-labelled turns so far, in order. */
+    getTranscript: () => VoiceScribeTurn[];
+    close: (reason?: string) => Promise<void>;
+};
+export type VoiceScribeOptions = {
+    stt: STTAdapter;
+    sessionId: string;
+    format: AudioFormat;
+    languageStrategy?: VoiceLanguageStrategy;
+    lexicon?: VoiceLexiconEntry[];
+    phraseHints?: VoicePhraseHint[];
+    signal?: AbortSignal;
+};
+/**
+ * A listen-only transcription session — a "scribe". It drives an STT adapter
+ * over a stream of audio chunks and emits diarized transcript turns, with NO
+ * assistant (no LLM) and NO TTS. Use it to turn any audio source — an
+ * onSpark-hosted meeting, or a meeting-bot adapter piping in an external call —
+ * into a live, speaker-labelled transcript that downstream consumers (e.g. a
+ * deal-call analyzer) read or act on. Diarization comes from the STT adapter
+ * (e.g. `deepgram({ diarize: true })`); speakers are surfaced as stable string
+ * labels on each turn.
+ */
+export declare const createVoiceScribe: (options: VoiceScribeOptions) => Promise<VoiceScribeSession>;

package/dist/index.d.ts

@@ -197,6 +197,8 @@ export { createVoiceHandoffHealthHTMLHandler, createVoiceHandoffHealthJSONHandle
 export { createVoiceHandoffDeliveryWorker, createVoiceHandoffDeliveryWorkerLoop, createVoiceIntegrationSinkWorker, createVoiceIntegrationSinkWorkerLoop, createVoiceOpsTaskWorker, createVoiceOpsTaskProcessorWorker, createVoiceOpsTaskProcessorWorkerLoop, createVoiceRedisIdempotencyStore, createVoiceRedisTelephonyWebhookIdempotencyStore, createVoiceRedisTaskLeaseCoordinator, createVoiceTraceSinkDeliveryWorker, createVoiceTraceSinkDeliveryWorkerLoop, createVoiceWebhookDeliveryWorker, createVoiceWebhookDeliveryWorkerLoop, summarizeVoiceHandoffDeliveries, summarizeVoiceTraceSinkDeliveries, summarizeVoiceOpsTaskQueue, summarizeVoiceIntegrationEvents, } from "./core/queue";
 export { assignVoiceOpsTask, applyVoiceOpsTaskAssignmentRule, applyVoiceOpsTaskPolicy, buildVoiceOpsTaskFromReview, buildVoiceOpsTaskFromSLABreach, claimVoiceOpsTask, completeVoiceOpsTask, createVoiceExternalObjectMap, createVoiceExternalObjectMapId, createVoiceCallCompletedEvent, createVoiceTaskSLABreachedEvent, deadLetterVoiceOpsTask, deliverVoiceIntegrationEvent, failVoiceOpsTask, hasVoiceOpsTaskSLABreach, heartbeatVoiceOpsTask, isVoiceOpsTaskOverdue, markVoiceOpsTaskSLABreached, matchesVoiceOpsTaskAssignmentRule, resolveVoiceOpsTaskAgeBucket, createVoiceIntegrationEvent, createVoiceReviewSavedEvent, resolveVoiceOpsTaskAssignment, resolveVoiceOpsTaskPolicy, requeueVoiceOpsTask, createVoiceTaskCreatedEvent, createVoiceTaskUpdatedEvent, listVoiceOpsTasks, reopenVoiceOpsTask, startVoiceOpsTask, summarizeVoiceOpsTaskAnalytics, summarizeVoiceOpsTasks, withVoiceIntegrationEventId, withVoiceOpsTaskId, } from "./core/ops";
 export { createVoiceSession } from "./core/session";
+export { createVoiceScribe } from "./core/scribe";
+export type { VoiceScribeSession, VoiceScribeOptions, VoiceScribeTurn, VoiceScribeEventMap, VoiceScribePartialEvent, VoiceScribeTurnEvent, } from "./core/scribe";
 export { createVoiceCallReviewFromSession, recordVoiceRuntimeOps, } from "./core/runtimeOps";
 export { createVoiceOpsRuntime } from "./core/opsRuntime";
 export { resolveVoiceOpsPreset } from "./core/opsPresets";

package/dist/index.js

@@ -46486,6 +46486,56 @@ var createVoiceMemoryStore = () => {
   };
   return { get, getOrCreate, list, remove, set };
 };
+// src/core/scribe.ts
+var createVoiceScribe = async (options) => {
+  const session = await options.stt.open({
+    format: options.format,
+    languageStrategy: options.languageStrategy,
+    lexicon: options.lexicon,
+    phraseHints: options.phraseHints,
+    sessionId: options.sessionId,
+    signal: options.signal
+  });
+  const turns = [];
+  const listeners = {
+    close: new Set,
+    error: new Set,
+    partial: new Set,
+    turn: new Set
+  };
+  const emit2 = (event, payload) => {
+    for (const handler of listeners[event])
+      handler(payload);
+  };
+  session.on("final", ({ transcript }) => {
+    const text = transcript.text.trim();
+    if (!text)
+      return;
+    const turn = {
+      confidence: transcript.confidence,
+      endedAtMs: transcript.endedAtMs,
+      speaker: transcript.speaker === undefined ? "0" : String(transcript.speaker),
+      startedAtMs: transcript.startedAtMs,
+      text
+    };
+    turns.push(turn);
+    emit2("turn", { turn, type: "turn" });
+  });
+  session.on("partial", ({ transcript }) => emit2("partial", { transcript, type: "partial" }));
+  session.on("error", (event) => emit2("error", event));
+  session.on("close", (event) => emit2("close", event));
+  return {
+    close: (reason) => session.close(reason),
+    getTranscript: () => [...turns],
+    on: (event, handler) => {
+      listeners[event].add(handler);
+      return () => {
+        listeners[event].delete(handler);
+      };
+    },
+    send: (audio) => session.send(audio)
+  };
+};
 // src/core/opsRuntime.ts
 var resolveTaskStores = (config) => {
   if (!config.ops.tasks) {
@@ -52346,6 +52396,7 @@ export {
   createVoiceSessionObservabilityRoutes,
   createVoiceSessionListRoutes,
   createVoiceSession,
+  createVoiceScribe,
   createVoiceScopedTraceEventStore,
   createVoiceScopedAuditEventStore,
   createVoiceSTTRoutingCorrectionHandler,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.549",
+	"version": "0.0.22-beta.550",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",