@absolutejs/voice 0.0.21 → 0.0.22-beta.0

package/dist/testing/corrected.d.ts

@@ -0,0 +1,41 @@
+import type { VoiceLexiconEntry, VoicePhraseHint, VoiceTurnCorrectionHandler } from '../types';
+import { type VoiceExpectedTermAccuracy, type VoiceSTTBenchmarkReport } from './benchmark';
+import type { VoiceSessionBenchmarkReport } from './sessionBenchmark';
+import type { VoiceTestFixture } from './fixtures';
+export type VoiceCorrectionHintProfile = 'generic' | 'benchmark-seeded';
+type VoiceCorrectionAuditSlice<TReport> = {
+    fixtureIds: string[];
+    raw: TReport;
+    generic: TReport;
+    experimental: TReport;
+    benchmarkSeeded: TReport;
+};
+export type VoiceCorrectionBenchmarkAudit = {
+    raw: VoiceSTTBenchmarkReport;
+    generic: VoiceSTTBenchmarkReport;
+    experimental: VoiceSTTBenchmarkReport;
+    benchmarkSeeded: VoiceSTTBenchmarkReport;
+    holdout: VoiceCorrectionAuditSlice<VoiceSTTBenchmarkReport>;
+    lexicalHoldout: VoiceCorrectionAuditSlice<VoiceSTTBenchmarkReport>;
+};
+export type VoiceSessionCorrectionAudit = {
+    raw: VoiceSessionBenchmarkReport;
+    generic: VoiceSessionBenchmarkReport;
+    experimental: VoiceSessionBenchmarkReport;
+    benchmarkSeeded: VoiceSessionBenchmarkReport;
+    holdout: VoiceCorrectionAuditSlice<VoiceSessionBenchmarkReport>;
+    lexicalHoldout: VoiceCorrectionAuditSlice<VoiceSessionBenchmarkReport>;
+};
+export declare const isCorrectionHoldoutFixtureId: (fixtureId: string) => boolean;
+export declare const buildFixturePhraseHints: (fixture: Pick<VoiceTestFixture, "expectedTerms" | "expectedText">, profile?: VoiceCorrectionHintProfile) => VoicePhraseHint[];
+export declare const buildCodeSwitchBenchmarkLexicon: (fixture: Pick<VoiceTestFixture, "expectedTerms" | "expectedText" | "language" | "tags">) => VoiceLexiconEntry[];
+export declare const buildCodeSwitchBenchmarkPhraseHints: (fixture: Pick<VoiceTestFixture, "expectedTerms" | "expectedText" | "language" | "tags">) => VoicePhraseHint[];
+export declare const createCodeSwitchBenchmarkCorrectionHandler: () => VoiceTurnCorrectionHandler;
+export declare const createBenchmarkCorrectionHandler: (profile: VoiceCorrectionHintProfile) => VoiceTurnCorrectionHandler;
+export declare const scoreCorrectedExpectedTerms: (actualText: string, expectedTerms: string[] | undefined) => VoiceExpectedTermAccuracy;
+export declare const applyCorrectedBenchmarkReport: (report: VoiceSTTBenchmarkReport, fixtures: VoiceTestFixture[], profile?: VoiceCorrectionHintProfile) => VoiceSTTBenchmarkReport;
+export declare const applyExperimentalBenchmarkReport: (report: VoiceSTTBenchmarkReport, fixtures: VoiceTestFixture[]) => VoiceSTTBenchmarkReport;
+export declare const applyLexiconCorrectedBenchmarkReport: (report: VoiceSTTBenchmarkReport, fixtures: VoiceTestFixture[], buildLexicon: (fixture: Pick<VoiceTestFixture, "expectedTerms" | "expectedText" | "language" | "tags">) => VoiceLexiconEntry[]) => VoiceSTTBenchmarkReport;
+export declare const buildCorrectionBenchmarkAudit: (rawReport: VoiceSTTBenchmarkReport, fixtures: VoiceTestFixture[]) => VoiceCorrectionBenchmarkAudit;
+export declare const buildSessionCorrectionAudit: (raw: VoiceSessionBenchmarkReport, generic: VoiceSessionBenchmarkReport, experimental: VoiceSessionBenchmarkReport, benchmarkSeeded: VoiceSessionBenchmarkReport, scenarios: Array<Pick<VoiceTestFixture, "expectedTerms" | "expectedText" | "expectedTurnTexts" | "id">>) => VoiceSessionCorrectionAudit;
+export {};

package/dist/testing/duplex.d.ts

@@ -0,0 +1,59 @@
+import type { VoiceBargeInOptions } from '../types';
+export type VoiceDuplexBenchmarkScenario = {
+    expectedInterruptCount: number;
+    id: string;
+    initialPartial?: string;
+    interruptDelayMs?: number;
+    level?: number;
+    mode: 'audio-send' | 'input-level' | 'partial';
+    partial?: string;
+    title: string;
+};
+export type VoiceDuplexBenchmarkScenarioResult = {
+    actualInterruptCount: number;
+    elapsedMs: number;
+    expectedInterruptCount: number;
+    fixtureId: string;
+    interruptLatencyMs?: number;
+    mode: VoiceDuplexBenchmarkScenario['mode'];
+    passes: boolean;
+    title: string;
+};
+export type VoiceDuplexBenchmarkSummary = {
+    averageElapsedMs: number;
+    averageInterruptLatencyMs?: number;
+    passCount: number;
+    passRate: number;
+    scenarioCount: number;
+};
+export type VoiceDuplexBenchmarkReport = {
+    fixtures: VoiceDuplexBenchmarkScenarioResult[];
+    generatedAt: number;
+    summary: VoiceDuplexBenchmarkSummary;
+};
+export type VoiceDuplexBenchmarkOptions = {
+    bargeIn?: VoiceBargeInOptions;
+    defaultInterruptDelayMs?: number;
+};
+export declare const getDefaultVoiceDuplexBenchmarkScenarios: () => {
+    expectedInterruptCount: number;
+    id: string;
+    initialPartial?: string;
+    interruptDelayMs?: number;
+    level?: number;
+    mode: "audio-send" | "input-level" | "partial";
+    partial?: string;
+    title: string;
+}[];
+export declare const runVoiceDuplexBenchmarkScenario: (scenario: VoiceDuplexBenchmarkScenario, options?: VoiceDuplexBenchmarkOptions) => Promise<VoiceDuplexBenchmarkScenarioResult>;
+export declare const summarizeVoiceDuplexBenchmark: (fixtures: VoiceDuplexBenchmarkScenarioResult[]) => VoiceDuplexBenchmarkSummary;
+export declare const runVoiceDuplexBenchmark: (scenarios?: {
+    expectedInterruptCount: number;
+    id: string;
+    initialPartial?: string;
+    interruptDelayMs?: number;
+    level?: number;
+    mode: "audio-send" | "input-level" | "partial";
+    partial?: string;
+    title: string;
+}[], options?: VoiceDuplexBenchmarkOptions) => Promise<VoiceDuplexBenchmarkReport>;

package/dist/testing/fixtures.d.ts

@@ -1,10 +1,11 @@
-import type { AudioFormat } from '../types';
+import type { AudioFormat, VoiceExpectedSpeakerTurn } from '../types';
 export type VoiceTestFixtureManifestEntry = {
     id: string;
     title: string;
     audioPath: string;
     expectedText: string;
     expectedTerms?: string[];
+    expectedSpeakerTurns?: VoiceExpectedSpeakerTurn[];
     expectedTurnTexts?: string[];
     chunkDurationMs?: number;
     language?: string;
@@ -18,5 +19,20 @@ export type VoiceTestFixture = Omit<VoiceTestFixtureManifestEntry, 'audioPath'>
     audioPath: string;
     format: AudioFormat;
 };
+export type VoiceTelephonyFixtureOptions = {
+    includeAccents?: boolean;
+    targetSampleRateHz?: number;
+};
+export type VoiceMultiSpeakerFixtureOptions = {
+    silenceMs?: number;
+};
+export type VoiceFixtureLoadOptions = {
+    directories?: string[];
+    includeBundled?: boolean;
+};
 export declare const getVoiceFixtureDirectory: () => Promise<string>;
-export declare const loadVoiceTestFixtures: (fixtureDirectory?: string) => Promise<VoiceTestFixture[]>;
+export declare const resolveVoiceFixtureDirectories: (input?: string | string[] | VoiceFixtureLoadOptions) => Promise<string[]>;
+export declare const createTelephonyVoiceTestFixtures: (fixtures: VoiceTestFixture[], options?: VoiceTelephonyFixtureOptions) => VoiceTestFixture[];
+export declare const createMultiSpeakerVoiceTestFixtures: (fixtures: VoiceTestFixture[], options?: VoiceMultiSpeakerFixtureOptions) => VoiceTestFixture[];
+export declare const createJargonVoiceTestFixtures: (fixtures: VoiceTestFixture[]) => VoiceTestFixture[];
+export declare const loadVoiceTestFixtures: (fixtureDirectory?: string | string[] | VoiceFixtureLoadOptions) => Promise<VoiceTestFixture[]>;

package/dist/testing/index.d.ts

@@ -1,6 +1,11 @@
 export * from './accuracy';
 export * from './benchmark';
+export * from './corrected';
+export * from './duplex';
 export * from './fixtures';
 export * from './resilience';
+export * from './review';
 export * from './sessionBenchmark';
 export * from './stt';
+export * from './telephony';
+export * from './tts';