@absolutejs/voice 0.0.22-beta.163 → 0.0.22-beta.165

package/dist/index.d.ts

@@ -46,6 +46,7 @@ export { assertVoiceProviderRoutingContract, runVoiceProviderRoutingContract } f
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
 export { buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
+export { evaluateVoiceProviderStackGaps, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
@@ -105,6 +106,7 @@ export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesO
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
 export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
+export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingKindSummary, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind, VoiceRoutingSessionSummary, VoiceRoutingSessionSummaryOptions } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';

package/dist/index.js

@@ -20142,6 +20142,7 @@ var readinessGateCodes = {
   "Provider fallback recovery": "voice.readiness.provider_fallback_recovery",
   "Provider health": "voice.readiness.provider_health",
   "Provider routing contracts": "voice.readiness.provider_routing_contracts",
+  "Provider stack capabilities": "voice.readiness.provider_stack_capabilities",
   "Quality gates": "voice.readiness.quality_gates",
   "Reconnect recovery contracts": "voice.readiness.reconnect_contracts",
   "Routing evidence": "voice.readiness.routing_evidence",
@@ -20213,6 +20214,12 @@ var resolveProviderRoutingContracts = async (options, input) => {
   }
   return typeof options.providerRoutingContracts === "function" ? await options.providerRoutingContracts(input) : options.providerRoutingContracts;
 };
+var resolveProviderStack = async (options, input) => {
+  if (options.providerStack === false || options.providerStack === undefined) {
+    return;
+  }
+  return typeof options.providerStack === "function" ? await options.providerStack(input) : options.providerStack;
+};
 var resolvePhoneAgentSmokes = async (options, input) => {
   if (options.phoneAgentSmokes === false || options.phoneAgentSmokes === undefined) {
     return;
@@ -20472,6 +20479,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     carriers,
     agentSquadContracts,
     providerRoutingContracts,
+    providerStack,
     phoneAgentSmokes,
     reconnectContracts,
     bargeInReports,
@@ -20502,6 +20510,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveCarriers(options, { query, request }),
     resolveAgentSquadContracts(options, { query, request }),
     resolveProviderRoutingContracts(options, { query, request }),
+    resolveProviderStack(options, { query, request }),
     resolvePhoneAgentSmokes(options, { query, request }),
     resolveReconnectContracts(options, { query, request }),
     resolveBargeInReports(options, { query, request }),
@@ -20695,6 +20704,23 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (providerStack) {
+    const missingLanes = providerStack.gaps.filter((gap) => gap.status !== "pass");
+    checks.push({
+      detail: providerStack.status === "pass" ? `${providerStack.profile} provider stack has declared capability coverage.` : missingLanes.length > 0 ? missingLanes.map((gap) => gap.provider ? `${gap.kind.toUpperCase()} ${gap.provider} missing ${gap.missing.join(", ")}` : `${gap.kind.toUpperCase()} provider is not configured`).join("; ") + "." : "Provider stack capability coverage needs review.",
+      href: options.links?.providerRoutingContracts ?? options.links?.resilience ?? "/resilience",
+      label: "Provider stack capabilities",
+      status: providerStack.status,
+      value: providerStack.status === "pass" ? "covered" : `${providerStack.missing} missing`,
+      actions: providerStack.status === "pass" ? [] : [
+        {
+          description: "Open provider capabilities and confirm the selected stack covers this readiness profile.",
+          href: options.links?.providerRoutingContracts ?? options.links?.resilience ?? "/resilience",
+          label: "Open provider capabilities"
+        }
+      ]
+    });
+  }
   if (phoneAgentSmokeSummary) {
     checks.push({
       detail: phoneAgentSmokeSummary.status === "pass" ? `${phoneAgentSmokeSummary.passed} phone-agent smoke contract(s) are passing.` : phoneAgentSmokeSummary.total === 0 ? "No phone-agent production smoke contracts are configured." : `${phoneAgentSmokeSummary.failed} phone-agent production smoke contract(s) failed.`,
@@ -20889,6 +20915,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         degraded: degradedProviders,
         total: providers.length
       },
+      providerStack,
       providerRecovery,
       phoneAgentSmokes: phoneAgentSmokeSummary,
       providerRoutingContracts: providerRoutingContractSummary,
@@ -21284,6 +21311,121 @@ var recommendVoiceReadinessProfile = (options) => {
     scores
   };
 };
+// src/providerStackRecommendations.ts
+var profileProviderPriorities = {
+  "meeting-recorder": {
+    llm: ["openai", "anthropic", "gemini"],
+    stt: ["deepgram", "assemblyai", "openai"],
+    tts: ["openai", "elevenlabs"]
+  },
+  "ops-heavy": {
+    llm: ["anthropic", "openai", "gemini"],
+    stt: ["deepgram", "assemblyai", "openai"],
+    tts: ["openai", "elevenlabs"]
+  },
+  "phone-agent": {
+    llm: ["openai", "anthropic", "gemini"],
+    stt: ["deepgram", "assemblyai", "openai"],
+    tts: ["openai", "elevenlabs"]
+  }
+};
+var profileProviderReasons = {
+  "meeting-recorder": {
+    llm: "meeting-recorder favors strong summarization and extraction quality",
+    stt: "meeting-recorder favors accurate long-form transcription",
+    tts: "meeting-recorder usually needs optional, low-friction spoken playback"
+  },
+  "ops-heavy": {
+    llm: "ops-heavy deployments favor dependable reasoning for review and escalation flows",
+    stt: "ops-heavy deployments keep STT recommendation available for live proof surfaces",
+    tts: "ops-heavy deployments keep TTS recommendation available for operator demos"
+  },
+  "phone-agent": {
+    llm: "phone-agent favors low-latency turn handling and tool orchestration",
+    stt: "phone-agent favors low-latency realtime transcription",
+    tts: "phone-agent favors low-latency spoken response"
+  }
+};
+var profileRequiredCapabilities = {
+  "meeting-recorder": {
+    llm: ["JSON result shaping", "summarization"],
+    stt: ["realtime STT", "smart formatting"],
+    tts: ["spoken playback"]
+  },
+  "ops-heavy": {
+    llm: ["tool calling", "JSON result shaping", "fallback routing"],
+    stt: ["realtime STT"],
+    tts: ["spoken playback"]
+  },
+  "phone-agent": {
+    llm: ["tool calling", "JSON result shaping", "fallback routing"],
+    stt: ["realtime STT", "VAD events"],
+    tts: ["streaming speech", "barge-in friendly"]
+  }
+};
+var chooseProvider = (available, priorities) => priorities.find((provider) => available.includes(provider)) ?? available[0];
+var recommendVoiceProviderStack = (input) => {
+  const priorities = profileProviderPriorities[input.profile];
+  const stacks = {};
+  const recommended = {};
+  const reasons = [];
+  for (const kind of ["llm", "stt", "tts"]) {
+    const available = input.providers[kind] ?? [];
+    const provider = chooseProvider(available, priorities[kind]);
+    const alternatives = provider ? available.filter((candidate) => candidate !== provider) : [...available];
+    const kindReasons = [
+      profileProviderReasons[input.profile][kind],
+      provider ? `${provider} is the recommended ${kind.toUpperCase()} provider from the configured set` : `no ${kind.toUpperCase()} providers are configured`
+    ];
+    if (provider) {
+      recommended[kind] = provider;
+    }
+    stacks[kind] = {
+      alternatives,
+      provider,
+      reasons: kindReasons
+    };
+    reasons.push(...kindReasons);
+  }
+  return {
+    profile: input.profile,
+    reasons,
+    recommended,
+    stacks
+  };
+};
+var normalizeCapability = (value) => value.toLowerCase().replace(/[^a-z0-9]+/g, "");
+var includesCapability = (capabilities, required) => {
+  const normalizedRequired = normalizeCapability(required);
+  return capabilities.some((capability) => {
+    const normalizedCapability = normalizeCapability(capability);
+    return normalizedCapability === normalizedRequired || normalizedCapability.includes(normalizedRequired) || normalizedRequired.includes(normalizedCapability);
+  });
+};
+var evaluateVoiceProviderStackGaps = (input) => {
+  const recommendation = input.recommendation ?? recommendVoiceProviderStack(input);
+  const gaps = ["llm", "stt", "tts"].map((kind) => {
+    const required = input.required?.[kind] ?? profileRequiredCapabilities[input.profile][kind];
+    const provider = recommendation.recommended[kind];
+    const present = provider ? [...input.capabilities?.[kind]?.[provider] ?? []] : [];
+    const missing2 = provider ? required.filter((capability) => !includesCapability(present, capability)) : [...required];
+    return {
+      kind,
+      missing: missing2,
+      present,
+      provider,
+      required: [...required],
+      status: !provider ? "fail" : missing2.length > 0 ? "warn" : "pass"
+    };
+  });
+  const missing = gaps.reduce((total, gap) => total + gap.missing.length, 0);
+  return {
+    gaps,
+    missing,
+    profile: input.profile,
+    status: gaps.some((gap) => gap.status === "fail") ? "fail" : gaps.some((gap) => gap.status === "warn") ? "warn" : "pass"
+  };
+};
 // src/opsConsoleRoutes.ts
 import { Elysia as Elysia34 } from "elysia";
 var DEFAULT_LINKS = [
@@ -24100,6 +24242,7 @@ export {
   recordVoiceHandoffAuditEvent,
   recordVoiceAuditEvent,
   recommendVoiceReadinessProfile,
+  recommendVoiceProviderStack,
   pruneVoiceTraceEvents,
   parseVoiceTelephonyWebhookEvent,
   matchesVoiceOpsTaskAssignmentRule,
@@ -24118,6 +24261,7 @@ export {
   evaluateVoiceTrace,
   evaluateVoiceTelephonyContract,
   evaluateVoiceQuality,
+  evaluateVoiceProviderStackGaps,
   encodeTwilioMulawBase64,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceIntegrationEventToSinks,

package/dist/productionReadiness.d.ts

@@ -11,6 +11,7 @@ import type { VoicePhoneAgentProductionSmokeReport } from './phoneAgentProductio
 import type { VoiceReconnectContractReport } from './reconnectContract';
 import type { VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditOutcome } from './audit';
 import { type VoiceAuditSinkDeliveryStore } from './auditSinks';
+import type { VoiceProviderStackCapabilityGapReport } from './providerStackRecommendations';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProductionReadinessAction = {
     description?: string;
@@ -137,6 +138,7 @@ export type VoiceProductionReadinessReport = {
             degraded: number;
             total: number;
         };
+        providerStack?: VoiceProviderStackCapabilityGapReport;
         providerRecovery: VoiceProviderFallbackRecoverySummary;
         phoneAgentSmokes?: {
             failed: number;
@@ -297,6 +299,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<readonly VoiceProviderRoutingContractReport[]> | readonly VoiceProviderRoutingContractReport[]);
+    providerStack?: false | VoiceProviderStackCapabilityGapReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceProviderStackCapabilityGapReport> | VoiceProviderStackCapabilityGapReport);
     reconnectContracts?: false | readonly VoiceReconnectContractReport[] | ((input: {
         query: Record<string, unknown>;
         request: Request;

package/dist/providerStackRecommendations.d.ts

@@ -0,0 +1,39 @@
+import type { VoiceReadinessProfileName } from './readinessProfiles';
+export type VoiceProviderStackKind = 'llm' | 'stt' | 'tts';
+export type VoiceProviderStackInput<TProvider extends string = string> = {
+    profile: VoiceReadinessProfileName;
+    providers: Partial<Record<VoiceProviderStackKind, readonly TProvider[]>>;
+};
+export type VoiceProviderStackChoice<TProvider extends string = string> = {
+    alternatives: TProvider[];
+    provider?: TProvider;
+    reasons: string[];
+};
+export type VoiceProviderStackRecommendation<TProvider extends string = string> = {
+    profile: VoiceReadinessProfileName;
+    reasons: string[];
+    recommended: Partial<Record<VoiceProviderStackKind, TProvider>>;
+    stacks: Partial<Record<VoiceProviderStackKind, VoiceProviderStackChoice<TProvider>>>;
+};
+export type VoiceProviderStackCapabilities<TProvider extends string = string> = Partial<Record<VoiceProviderStackKind, Partial<Record<TProvider, readonly string[]>>>>;
+export type VoiceProviderStackCapabilityGap<TProvider extends string = string> = {
+    kind: VoiceProviderStackKind;
+    missing: string[];
+    present: string[];
+    provider?: TProvider;
+    required: string[];
+    status: 'fail' | 'pass' | 'warn';
+};
+export type VoiceProviderStackCapabilityGapReport<TProvider extends string = string> = {
+    gaps: VoiceProviderStackCapabilityGap<TProvider>[];
+    missing: number;
+    profile: VoiceReadinessProfileName;
+    status: 'fail' | 'pass' | 'warn';
+};
+export type VoiceProviderStackCapabilityGapInput<TProvider extends string = string> = VoiceProviderStackInput<TProvider> & {
+    capabilities?: VoiceProviderStackCapabilities<TProvider>;
+    recommendation?: VoiceProviderStackRecommendation<TProvider>;
+    required?: Partial<Record<VoiceProviderStackKind, readonly string[]>>;
+};
+export declare const recommendVoiceProviderStack: <TProvider extends string = string>(input: VoiceProviderStackInput<TProvider>) => VoiceProviderStackRecommendation<TProvider>;
+export declare const evaluateVoiceProviderStackGaps: <TProvider extends string = string>(input: VoiceProviderStackCapabilityGapInput<TProvider>) => VoiceProviderStackCapabilityGapReport<TProvider>;

package/package.json

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