@absolutejs/voice 0.0.22-beta.52 → 0.0.22-beta.520

package/dist/transcriptAnnotator.d.ts

@@ -0,0 +1,41 @@
+export type VoiceTranscriptAnnotationKind = "great-recovery" | "missed-objection" | "compliance-concern" | "tone-issue" | "knowledge-gap" | "follow-up-needed" | "custom";
+export type VoiceTranscriptAnnotation = {
+    id: string;
+    sessionId: string;
+    supervisorId: string;
+    kind: VoiceTranscriptAnnotationKind;
+    customLabel?: string;
+    text?: string;
+    turnId?: string;
+    rangeStartMs: number;
+    rangeEndMs?: number;
+    createdAt: number;
+    severity: "info" | "minor" | "major";
+};
+export type CreateVoiceTranscriptAnnotatorOptions = {
+    sessionId: string;
+    generateId?: () => string;
+    now?: () => number;
+};
+export declare const DEFAULT_VOICE_ANNOTATION_KIND_SEVERITY: Record<VoiceTranscriptAnnotationKind, VoiceTranscriptAnnotation["severity"]>;
+export declare const createVoiceTranscriptAnnotator: (options: CreateVoiceTranscriptAnnotatorOptions) => {
+    add: (input: Omit<VoiceTranscriptAnnotation, "id" | "createdAt" | "sessionId" | "severity"> & {
+        severity?: VoiceTranscriptAnnotation["severity"];
+        id?: string;
+    }) => VoiceTranscriptAnnotation;
+    list: (filter?: {
+        kind?: VoiceTranscriptAnnotationKind;
+        supervisorId?: string;
+        severity?: VoiceTranscriptAnnotation["severity"];
+        fromMs?: number;
+        toMs?: number;
+    }) => VoiceTranscriptAnnotation[];
+    remove: (id: string) => boolean;
+    sessionId: string;
+    summarize: () => {
+        byKind: Partial<Record<VoiceTranscriptAnnotationKind, number>>;
+        bySeverity: Record<"info" | "minor" | "major", number>;
+        total: number;
+    };
+};
+export type VoiceTranscriptAnnotator = ReturnType<typeof createVoiceTranscriptAnnotator>;

package/dist/turnDetection.d.ts

@@ -1,4 +1,4 @@
-import type { AudioChunk, Transcript } from './types';
+import type { AudioChunk, Transcript } from "./types";
 export declare const DEFAULT_SILENCE_MS = 700;
 export declare const DEFAULT_SPEECH_THRESHOLD = 0.015;
 export declare const measureAudioLevel: (audio: AudioChunk) => number;

package/dist/turnLatency.d.ts

@@ -0,0 +1,95 @@
+import { Elysia } from "elysia";
+import type { VoiceTraceEventStore } from "./trace";
+import type { VoiceSessionRecord, VoiceSessionStore } from "./types";
+export type VoiceTurnLatencyStatus = "pass" | "warn" | "fail" | "empty";
+export type VoiceTurnLatencyStage = {
+    label: string;
+    valueMs?: number;
+};
+export type VoiceTurnLatencyItem = {
+    assistantTextStartedAt?: number;
+    committedAt: number;
+    finalTranscriptAt?: number;
+    firstTranscriptAt?: number;
+    sessionId: string;
+    stages: VoiceTurnLatencyStage[];
+    status: VoiceTurnLatencyStatus;
+    text: string;
+    totalMs?: number;
+    turnId: string;
+};
+export type VoiceTurnLatencyReport = {
+    averageTotalMs?: number;
+    checkedAt: number;
+    failed: number;
+    sessions: number;
+    status: VoiceTurnLatencyStatus;
+    total: number;
+    turns: VoiceTurnLatencyItem[];
+    warnings: number;
+};
+export type VoiceTurnLatencyOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = {
+    limit?: number;
+    sessionIds?: string[];
+    sessions?: TSession[];
+    store?: VoiceSessionStore<TSession>;
+    traceStore?: VoiceTraceEventStore;
+    warnAfterMs?: number;
+    failAfterMs?: number;
+};
+export type VoiceTurnLatencyHTMLHandlerOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceTurnLatencyOptions<TSession> & {
+    headers?: HeadersInit;
+    render?: (report: VoiceTurnLatencyReport) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceTurnLatencyRoutesOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceTurnLatencyHTMLHandlerOptions<TSession> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceTurnLatency: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyOptions<TSession>) => Promise<VoiceTurnLatencyReport>;
+export declare const renderVoiceTurnLatencyHTML: (report: VoiceTurnLatencyReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceTurnLatencyJSONHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyOptions<TSession>) => () => Promise<VoiceTurnLatencyReport>;
+export declare const createVoiceTurnLatencyHTMLHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyHTMLHandlerOptions<TSession>) => () => Promise<Response>;
+export declare const createVoiceTurnLatencyRoutes: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyRoutesOptions<TSession>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceTurnLatencyReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/turnProfiles.d.ts

@@ -1,5 +1,5 @@
-import type { VoiceResolvedTurnDetectionConfig, VoiceTurnDetectionConfig, VoiceTurnQualityProfile, VoiceTurnProfile } from './types';
-export declare const TURN_PROFILE_DEFAULTS: Record<VoiceTurnProfile, Omit<VoiceResolvedTurnDetectionConfig, 'profile'>>;
+import type { VoiceResolvedTurnDetectionConfig, VoiceTurnDetectionConfig, VoiceTurnQualityProfile, VoiceTurnProfile } from "./types";
+export declare const TURN_PROFILE_DEFAULTS: Record<VoiceTurnProfile, Omit<VoiceResolvedTurnDetectionConfig, "profile">>;
 export declare const QUALITY_PROFILE_DEFAULTS: Record<VoiceTurnQualityProfile, Partial<VoiceResolvedTurnDetectionConfig>>;
 export declare const DEFAULT_TURN_PROFILE: VoiceTurnProfile;
 export declare const DEFAULT_QUALITY_PROFILE: VoiceTurnQualityProfile;

package/dist/turnQuality.d.ts

@@ -0,0 +1,94 @@
+import { Elysia } from "elysia";
+import type { VoiceSessionRecord, VoiceSessionStore, VoiceTranscriptQuality } from "./types";
+export type VoiceTurnQualityStatus = "pass" | "warn" | "fail" | "unknown";
+export type VoiceTurnQualityItem = {
+    averageConfidence?: number;
+    committedAt: number;
+    correctionChanged: boolean;
+    correctionProvider?: string;
+    correctionReason?: string;
+    costUnits?: number;
+    fallbackSelectionReason?: string;
+    fallbackUsed: boolean;
+    finalTranscriptCount: number;
+    latencyMs?: number;
+    partialTranscriptCount: number;
+    selectedTranscriptCount: number;
+    sessionId: string;
+    source?: VoiceTranscriptQuality["source"];
+    status: VoiceTurnQualityStatus;
+    text: string;
+    turnId: string;
+};
+export type VoiceTurnQualityReport = {
+    checkedAt: number;
+    failed: number;
+    sessions: number;
+    status: VoiceTurnQualityStatus;
+    total: number;
+    turns: VoiceTurnQualityItem[];
+    warnings: number;
+};
+export type VoiceTurnQualityOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = {
+    confidenceWarnThreshold?: number;
+    limit?: number;
+    sessionIds?: string[];
+    sessions?: TSession[];
+    store?: VoiceSessionStore<TSession>;
+};
+export type VoiceTurnQualityHTMLHandlerOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceTurnQualityOptions<TSession> & {
+    headers?: HeadersInit;
+    render?: (report: VoiceTurnQualityReport) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceTurnQualityRoutesOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceTurnQualityHTMLHandlerOptions<TSession> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceTurnQuality: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnQualityOptions<TSession>) => Promise<VoiceTurnQualityReport>;
+export declare const renderVoiceTurnQualityHTML: (report: VoiceTurnQualityReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceTurnQualityJSONHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnQualityOptions<TSession>) => () => Promise<VoiceTurnQualityReport>;
+export declare const createVoiceTurnQualityHTMLHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnQualityHTMLHandlerOptions<TSession>) => () => Promise<Response>;
+export declare const createVoiceTurnQualityRoutes: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnQualityRoutesOptions<TSession>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceTurnQualityReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;