@absolutejs/voice 0.0.22-beta.169 → 0.0.22-beta.170

package/dist/index.d.ts

@@ -46,7 +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 { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
+export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
@@ -106,7 +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, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
+export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, 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

@@ -21395,6 +21395,34 @@ var profileRequiredCapabilities = {
     tts: ["streaming speech", "barge-in friendly"]
   }
 };
+var defaultProviderEnv = {
+  anthropic: ["ANTHROPIC_API_KEY"],
+  assemblyai: ["ASSEMBLYAI_API_KEY"],
+  deepgram: ["DEEPGRAM_API_KEY"],
+  gemini: ["GEMINI_API_KEY"],
+  openai: ["OPENAI_API_KEY"]
+};
+var defaultStreamingProviders = new Set([
+  "assemblyai",
+  "deepgram",
+  "openai"
+]);
+var defaultProviderCapabilities = {
+  anthropic: ["tool calling", "JSON result shaping", "fallback routing"],
+  assemblyai: ["realtime STT", "turn formatting", "fallback STT"],
+  deepgram: ["realtime STT", "VAD events", "smart formatting"],
+  deterministic: ["offline demo mode", "zero external dependency"],
+  emergency: ["spoken playback", "offline fallback"],
+  gemini: ["tool calling", "JSON result shaping", "fallback routing"],
+  openai: [
+    "tool calling",
+    "JSON result shaping",
+    "fallback routing",
+    "streaming speech",
+    "barge-in friendly",
+    "spoken playback"
+  ]
+};
 var chooseProvider = (available, priorities) => priorities.find((provider) => available.includes(provider)) ?? available[0];
 var recommendVoiceProviderStack = (input) => {
   const priorities = profileProviderPriorities[input.profile];
@@ -21527,6 +21555,33 @@ var buildVoiceProviderContractMatrix = (input) => {
     warned
   };
 };
+var createVoiceProviderContractMatrixPreset = (profile, options) => {
+  const contracts = ["llm", "stt", "tts"].flatMap((kind) => {
+    const providers = options.providers[kind] ?? [];
+    return providers.map((provider) => {
+      const configured = options.configured?.[provider] ?? (defaultProviderEnv[provider]?.length ? defaultProviderEnv[provider].every((name) => options.env?.[name]) : true);
+      const fallbackProviders = options.fallbackProviders?.[kind] ?? providers.filter((candidate) => candidate !== provider);
+      const requiredCapabilities = profileRequiredCapabilities[profile][kind];
+      const capabilities = options.capabilities?.[kind]?.[provider] ?? defaultProviderCapabilities[provider] ?? [];
+      const requiredEnv = defaultProviderEnv[provider] ?? [];
+      return {
+        capabilities,
+        configured,
+        env: options.env,
+        fallbackProviders,
+        kind,
+        latencyBudgetMs: options.latencyBudgets?.[provider],
+        provider,
+        requiredCapabilities,
+        requiredEnv,
+        remediationHref: options.remediationHref,
+        selected: options.selected?.[kind] === provider,
+        streaming: options.streaming?.[provider] ?? defaultStreamingProviders.has(provider)
+      };
+    });
+  });
+  return { contracts };
+};
 var resolveProviderContractMatrixInput = async (matrix) => typeof matrix === "function" ? await matrix() : matrix;
 var renderVoiceProviderContractMatrixHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Provider Contract Matrix";
@@ -24549,6 +24604,7 @@ export {
   createVoiceProviderHealthJSONHandler,
   createVoiceProviderHealthHTMLHandler,
   createVoiceProviderContractMatrixRoutes,
+  createVoiceProviderContractMatrixPreset,
   createVoiceProviderContractMatrixJSONHandler,
   createVoiceProviderContractMatrixHTMLHandler,
   createVoiceProviderCapabilityRoutes,

package/dist/providerStackRecommendations.d.ts

@@ -67,6 +67,17 @@ export type VoiceProviderContractDefinition<TProvider extends string = string> =
 export type VoiceProviderContractMatrixInput<TProvider extends string = string> = {
     contracts: readonly VoiceProviderContractDefinition<TProvider>[];
 };
+export type VoiceProviderContractMatrixPresetOptions<TProvider extends string = string> = {
+    capabilities?: VoiceProviderStackCapabilities<TProvider>;
+    configured?: Partial<Record<TProvider, boolean>>;
+    env?: Record<string, string | undefined>;
+    fallbackProviders?: Partial<Record<VoiceProviderStackKind, readonly TProvider[]>>;
+    latencyBudgets?: Partial<Record<TProvider, number>>;
+    providers: Partial<Record<VoiceProviderStackKind, readonly TProvider[]>>;
+    remediationHref?: string;
+    selected?: Partial<Record<VoiceProviderStackKind, TProvider>>;
+    streaming?: Partial<Record<TProvider, boolean>>;
+};
 export type VoiceProviderContractMatrixHandlerOptions<TProvider extends string = string> = VoiceProviderContractMatrixInput<TProvider> | (() => Promise<VoiceProviderContractMatrixInput<TProvider>> | VoiceProviderContractMatrixInput<TProvider>);
 export type VoiceProviderContractMatrixHTMLHandlerOptions<TProvider extends string = string> = {
     matrix: VoiceProviderContractMatrixHandlerOptions<TProvider>;
@@ -97,6 +108,7 @@ export type VoiceProviderContractMatrixReport<TProvider extends string = string>
 };
 export declare const recommendVoiceProviderStack: <TProvider extends string = string>(input: VoiceProviderStackInput<TProvider>) => VoiceProviderStackRecommendation<TProvider>;
 export declare const buildVoiceProviderContractMatrix: <TProvider extends string = string>(input: VoiceProviderContractMatrixInput<TProvider>) => VoiceProviderContractMatrixReport<TProvider>;
+export declare const createVoiceProviderContractMatrixPreset: <TProvider extends string = string>(profile: VoiceReadinessProfileName, options: VoiceProviderContractMatrixPresetOptions<TProvider>) => VoiceProviderContractMatrixInput<TProvider>;
 export declare const renderVoiceProviderContractMatrixHTML: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, options?: {
     title?: string;
 }) => string;

package/package.json

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