@absolutejs/voice 0.0.22-beta.470 → 0.0.22-beta.472

package/README.md

@@ -8,6 +8,93 @@ Use it when you want Vapi/Retell/Bland-style voice-agent capability, but you wan
 
 ## What's new
 
+### 0.0.22-beta.472 · Phase 6 — multilingual STT proof gate
+
+`runVoiceMultilingualProof(...)` turns the `voice-fixtures-multilingual` corpus (FLEURS + BSC Catalan-Spanish code-switch + CoSHE Hindi-English code-switch) into a gateable readiness/proof artifact. Buyers evaluating Vapi-replacement can now run any combination of STT adapters against the multilingual corpus and assert per-language WER / pass-rate / term-recall budgets in CI.
+
+```ts
+import {
+  buildVoiceMultilingualProofReadinessCheck,
+  renderVoiceMultilingualProofMarkdown,
+  runVoiceMultilingualProof,
+} from "@absolutejs/voice";
+import { deepgram } from "@absolutejs/voice-deepgram";
+import { speechmatics } from "@absolutejs/voice-speechmatics";
+import { soniox } from "@absolutejs/voice-soniox";
+
+const report = await runVoiceMultilingualProof({
+  adapters: [
+    { adapter: deepgram({ apiKey, model: "nova-3" }), adapterId: "deepgram-nova3" },
+    { adapter: speechmatics({ apiKey, region: "eu2" }), adapterId: "speechmatics-enhanced" },
+    { adapter: soniox({ apiKey, enableLanguageIdentification: true }), adapterId: "soniox" },
+  ],
+  defaultThresholds: { maxAverageWordErrorRate: 0.30, minPassRate: 0.7 },
+  perLanguage: [
+    { language: "ca-es", label: "Catalan-Spanish code-switch", maxAverageWordErrorRate: 0.45 },
+    { language: "hi-en", label: "Hindi-English code-switch", maxAverageWordErrorRate: 0.50 },
+  ],
+});
+
+const readiness = buildVoiceMultilingualProofReadinessCheck(report, {
+  baseHref: "/voice/multilingual-proof",
+});
+// drop `readiness` into your VoiceProductionReadinessReport.checks array
+
+await Bun.write("docs/multilingual-proof.md", renderVoiceMultilingualProofMarkdown(report));
+```
+
+Highlights:
+- Loads fixtures from `VOICE_FIXTURE_DIR` (or any caller-supplied directory list / pre-loaded `VoiceTestFixture[]`), filters by an optional predicate, and runs each adapter through the existing `runSTTAdapterBenchmark` harness — no new STT plumbing required.
+- Buckets fixture results by `fixture.language` and applies per-language thresholds (`maxAverageWordErrorRate`, `minAverageWordAccuracyRate`, `minPassRate`, `minTermRecall`) layered over caller-provided `defaultThresholds`.
+- Returns a structured report (`adapters[].languageReports[]` with metrics + failures, plus per-adapter and global `passes` flags) plus a Markdown renderer for human review and a `VoiceProductionReadinessCheck`-shaped helper for drop-in readiness wiring.
+- Pairs naturally with every STT adapter shipped in `voice-adapters` (deepgram, assemblyai, azure streaming, speechmatics, gladia, soniox, google-speech streaming + buffered, openai-whisper buffered).
+
+### 0.0.22-beta.471 · Vapi parity — `fromVapiAssistantConfig` adapter
+
+Mechanical migration from a Vapi Assistant JSON to a voice assistant. Pass the JSON dump (or a typed subset), provide a `modelFactory` that maps Vapi's `model.provider`+`model.model` to a voice `VoiceAgentModel`, and get back `{ assistant, tools, routeHints, unsupported }`.
+
+```ts
+import {
+  createOpenAIVoiceAssistantModel,
+  fromVapiAssistantConfig,
+  type VapiAssistantConfig,
+} from "@absolutejs/voice";
+
+const config: VapiAssistantConfig = JSON.parse(vapiDump);
+
+const { assistant, tools, routeHints, unsupported } = fromVapiAssistantConfig(config, {
+  assistantId: "support",
+  fetch,
+  knowledgeBase: { collection: ragCollection },
+  modelFactory: ({ provider, model, temperature }) => {
+    if (provider === "openai") {
+      return createOpenAIVoiceAssistantModel({
+        apiKey: process.env.OPENAI_API_KEY!,
+        model: model ?? "gpt-4.1-mini",
+        temperature,
+      });
+    }
+    throw new Error(`Unsupported provider: ${provider}`);
+  },
+  variableResolver: (path, { context }) => {
+    if (path === "customer.name") return context.customerName;
+    return undefined;
+  },
+  dtmfSendFactory: () => ({ args, api }) =>
+    api.transfer({ target: "ivr", metadata: { digits: args.digits } }),
+});
+
+console.log("Migrated", tools.length, "tools;", unsupported.length, "fields need manual review:");
+for (const reason of unsupported) console.log(`  - ${reason.field}: ${reason.detail}`);
+```
+
+Mappings:
+- **`model.provider` + `model.model` + `temperature`** → your `modelFactory` (you control which provider adapter to use; the adapter doesn't bake in API keys).
+- **`messages[].role === "system"` (or `systemPrompt`)** → assistant `system` field; `{{var}}` bare expansions auto-compile to a function-form prompt that resolves built-ins (`{{now}}`, `{{date}}`, `{{time}}`) and your `variableResolver` for everything else. LiquidJS filters are reported in `unsupported`.
+- **`tools[].type`** → named-tool factories from beta.470: `endCall` → `createVoiceEndCallTool`, `transferCall` → `createVoiceTransferCallTool` (numbers/SIP URIs auto-mapped), `voicemail` → `createVoiceVoicemailDetectionTool`, `apiRequest` / `function` (with `server.url`) → `createVoiceApiRequestTool`, `query` (or top-level `knowledgeBaseId`) → `createVoiceRAGTool` if you pass a `knowledgeBase` option. `dtmf` requires a `dtmfSendFactory` so it can reach your telephony adapter. `function` tools without `server.url` are forwarded to your optional `customToolFactory`.
+- **`voice.*` (TTS) + `transcriber.*` (STT) + `firstMessage` / `firstMessageMode` / `silenceTimeoutSeconds` / `maxDurationSeconds` / `endCall*` / `recordingEnabled` / `compliancePlan.*` / `backgroundSound` / `voicemailMessage`** → `routeHints` you pass into your `voice()` plugin / carrier route at mount time.
+- **`monitorPlan`, `startSpeakingPlan`, `stopSpeakingPlan`, `voicemailDetection.provider`, `model.toolIds`, `firstMessageMode`** → reported in `unsupported` with concrete migration instructions.
+
 ### 0.0.22-beta.470 · Vapi parity — named tool catalog
 
 Five named-tool factories that mirror Vapi's built-in `tools[].type` entries 1:1. Drop them straight into `createVoiceAssistant({ tools: [...] })` to get the same buyer ergonomics without writing the wiring yourself.

package/dist/index.d.ts

@@ -72,6 +72,8 @@ export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool, } from "
 export { createVoiceRAGTool } from "./ragTool";
 export type { VoiceRAGCollectionLike, VoiceRAGQueryResult, VoiceRAGSearchInput, VoiceRAGToolArgs, VoiceRAGToolOptions, VoiceRAGToolResult, } from "./ragTool";
 export { createVoiceApiRequestTool, createVoiceDTMFTool, createVoiceEndCallTool, createVoiceTransferCallTool, createVoiceVoicemailDetectionTool, } from "./agentTools";
+export { fromVapiAssistantConfig } from "./vapiAdapter";
+export type { VapiAssistantConfig, VapiAssistantConfigModel, VapiAssistantConfigTool, VapiAssistantConfigTranscriber, VapiAssistantConfigTransferDestination, VapiAssistantConfigVoice, VapiAssistantMessage, VoiceFromVapiAssistantOptions, VoiceFromVapiAssistantResult, VoiceFromVapiCustomToolFactory, VoiceFromVapiCustomToolInput, VoiceFromVapiDTMFFactory, VoiceFromVapiKnowledgeBase, VoiceFromVapiModelFactory, VoiceFromVapiModelFactoryInput, VoiceFromVapiRouteHints, VoiceFromVapiUnsupportedReason, } from "./vapiAdapter";
 export type { VoiceApiRequestToolArgs, VoiceApiRequestToolFetch, VoiceApiRequestToolHttpMethod, VoiceApiRequestToolOptions, VoiceApiRequestToolResult, VoiceDTMFToolArgs, VoiceDTMFToolOptions, VoiceDTMFToolResult, VoiceEndCallToolArgs, VoiceEndCallToolOptions, VoiceEndCallToolResult, VoiceTransferCallToolArgs, VoiceTransferCallToolDestination, VoiceTransferCallToolOptions, VoiceTransferCallToolResult, VoiceVoicemailDetectionToolArgs, VoiceVoicemailDetectionToolOptions, VoiceVoicemailDetectionToolResult, } from "./agentTools";
 export { assertVoiceAgentSquadContractEvidence, assertVoiceAgentSquadContract, evaluateVoiceAgentSquadContractEvidence, runVoiceAgentSquadContract, } from "./agentSquadContract";
 export { createVoiceToolIdempotencyKey, createVoiceToolRuntime, } from "./toolRuntime";
@@ -221,4 +223,6 @@ export { shapeTelephonyAssistantText } from "./telephony/response";
 export type { TelephonyResponseShapeMode, TelephonyResponseShapeOptions, } from "./telephony/response";
 export { buildVoiceProofPackInput, buildVoiceProofPack, buildVoiceProofPackFromObservabilityExport, createVoiceProofPackBuildContext, createVoiceProofRefreshSnapshot, createVoiceProofPackStaleWhileRefreshSource, createVoiceProofPackArtifacts, createVoiceProofPackOperationsRecordSection, createVoiceProofPackProductionReadinessSection, createVoiceProofPackProviderSloSection, createVoiceProofPackRoutes, createVoiceProofPackSupportBundleSection, renderVoiceProofPackMarkdown, writeVoiceProofPack, } from "./proofPack";
 export type { VoiceProofPack, VoiceProofPackBuildContext, VoiceProofPackBuildContextOptions, VoiceProofPackBuildTiming, VoiceProofPackEvidence, VoiceProofPackInput, VoiceProofPackInputBuilderLoaderInput, VoiceProofPackInputBuilderOperationsLoaderInput, VoiceProofPackInputBuilderOptions, VoiceProofPackInputBuilderSupportBundle, VoiceProofPackRefreshState, VoiceProofPackRefreshStatus, VoiceProofPackRoutesOptions, VoiceProofPackSection, VoiceProofPackSourceValue, VoiceProofPackStatus, VoiceProofPackStaleWhileRefreshSource, VoiceProofPackStaleWhileRefreshSourceOptions, VoiceProofPackWriteResult, VoiceProofRefreshSnapshot, VoiceProofRefreshSnapshotOptions, } from "./proofPack";
+export { buildVoiceMultilingualProofReadinessCheck, renderVoiceMultilingualProofMarkdown, runVoiceMultilingualProof, } from "./multilingualProof";
+export type { VoiceMultilingualLanguageCode, VoiceMultilingualProofAdapterEntry, VoiceMultilingualProofAdapterReport, VoiceMultilingualProofDefaultThresholds, VoiceMultilingualProofLanguageMetrics, VoiceMultilingualProofLanguageReport, VoiceMultilingualProofLanguageThresholds, VoiceMultilingualProofOptions, VoiceMultilingualProofReadinessCheck, VoiceMultilingualProofReadinessOptions, VoiceMultilingualProofReport, } from "./multilingualProof";
 export * from "./types";