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

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 { evaluateVoiceProviderStackGaps, recommendVoiceProviderStack } from './providerStackRecommendations';
+export { buildVoiceProviderContractMatrix, evaluateVoiceProviderStackGaps, 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, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
+export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixReport, 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

@@ -20139,6 +20139,7 @@ var readinessGateCodes = {
   "Live latency proof": "voice.readiness.live_latency",
   "Operator action history": "voice.readiness.operator_action_history",
   "Phone agent production smoke": "voice.readiness.phone_agent_smoke",
+  "Provider contract matrix": "voice.readiness.provider_contract_matrix",
   "Provider fallback recovery": "voice.readiness.provider_fallback_recovery",
   "Provider health": "voice.readiness.provider_health",
   "Provider routing contracts": "voice.readiness.provider_routing_contracts",
@@ -20220,6 +20221,12 @@ var resolveProviderStack = async (options, input) => {
   }
   return typeof options.providerStack === "function" ? await options.providerStack(input) : options.providerStack;
 };
+var resolveProviderContractMatrix = async (options, input) => {
+  if (options.providerContractMatrix === false || options.providerContractMatrix === undefined) {
+    return;
+  }
+  return typeof options.providerContractMatrix === "function" ? await options.providerContractMatrix(input) : options.providerContractMatrix;
+};
 var resolvePhoneAgentSmokes = async (options, input) => {
   if (options.phoneAgentSmokes === false || options.phoneAgentSmokes === undefined) {
     return;
@@ -20480,6 +20487,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     agentSquadContracts,
     providerRoutingContracts,
     providerStack,
+    providerContractMatrix,
     phoneAgentSmokes,
     reconnectContracts,
     bargeInReports,
@@ -20511,6 +20519,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveAgentSquadContracts(options, { query, request }),
     resolveProviderRoutingContracts(options, { query, request }),
     resolveProviderStack(options, { query, request }),
+    resolveProviderContractMatrix(options, { query, request }),
     resolvePhoneAgentSmokes(options, { query, request }),
     resolveReconnectContracts(options, { query, request }),
     resolveBargeInReports(options, { query, request }),
@@ -20721,6 +20730,26 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (providerContractMatrix) {
+    const blocked = providerContractMatrix.rows.filter((row) => row.status !== "pass");
+    checks.push({
+      detail: providerContractMatrix.status === "pass" ? `${providerContractMatrix.passed} provider contract row(s) are production-ready.` : blocked.length > 0 ? blocked.map((row) => {
+        const issues = row.checks.filter((check) => check.status !== "pass").map((check) => check.label).join(", ");
+        return `${row.kind.toUpperCase()} ${row.provider}: ${issues}`;
+      }).join("; ") + "." : "Provider contract matrix needs review.",
+      href: options.links?.providerRoutingContracts ?? options.links?.resilience ?? "/resilience",
+      label: "Provider contract matrix",
+      status: providerContractMatrix.status,
+      value: `${providerContractMatrix.passed}/${providerContractMatrix.total}`,
+      actions: providerContractMatrix.status === "pass" ? [] : [
+        {
+          description: "Open provider capabilities and inspect missing env, fallback, streaming, latency, or capability contracts.",
+          href: options.links?.providerRoutingContracts ?? options.links?.resilience ?? "/resilience",
+          label: "Open provider matrix"
+        }
+      ]
+    });
+  }
   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.`,
@@ -20916,6 +20945,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         total: providers.length
       },
       providerStack,
+      providerContractMatrix,
       providerRecovery,
       phoneAgentSmokes: phoneAgentSmokeSummary,
       providerRoutingContracts: providerRoutingContractSummary,
@@ -21394,6 +21424,71 @@ var recommendVoiceProviderStack = (input) => {
     stacks
   };
 };
+var rollupContractStatus = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
+var buildVoiceProviderContractMatrix = (input) => {
+  const rows = input.contracts.map((contract) => {
+    const configured = contract.configured !== false;
+    const missingEnv = (contract.requiredEnv ?? []).filter((name) => !contract.env?.[name]);
+    const missingCapabilities = (contract.requiredCapabilities ?? []).filter((capability) => !includesCapability(contract.capabilities ?? [], capability));
+    const checks = [
+      {
+        detail: configured ? "Provider is configured for this deployment." : "Provider is declared but not configured.",
+        key: "configured",
+        label: "Configured",
+        status: configured ? "pass" : "fail"
+      },
+      {
+        detail: missingEnv.length === 0 ? "Required environment is present." : `Missing env: ${missingEnv.join(", ")}.`,
+        key: "env",
+        label: "Required env",
+        status: missingEnv.length === 0 ? "pass" : "fail"
+      },
+      {
+        detail: contract.latencyBudgetMs !== undefined ? `Latency budget is ${contract.latencyBudgetMs}ms.` : "No latency budget declared.",
+        key: "latencyBudget",
+        label: "Latency budget",
+        status: contract.latencyBudgetMs !== undefined ? "pass" : "warn"
+      },
+      {
+        detail: (contract.fallbackProviders ?? []).length > 0 ? `Fallback providers: ${contract.fallbackProviders?.join(", ")}.` : "No fallback provider declared.",
+        key: "fallback",
+        label: "Fallback",
+        status: (contract.fallbackProviders ?? []).length > 0 ? "pass" : "warn"
+      },
+      {
+        detail: contract.streaming ? "Streaming is supported." : "Streaming support is not declared.",
+        key: "streaming",
+        label: "Streaming",
+        status: contract.streaming ? "pass" : "warn"
+      },
+      {
+        detail: missingCapabilities.length === 0 ? "Required capabilities are declared." : `Missing capabilities: ${missingCapabilities.join(", ")}.`,
+        key: "capabilities",
+        label: "Capabilities",
+        status: missingCapabilities.length === 0 ? "pass" : "warn"
+      }
+    ];
+    const status = rollupContractStatus(checks);
+    return {
+      checks,
+      configured,
+      kind: contract.kind,
+      provider: contract.provider,
+      selected: contract.selected === true,
+      status
+    };
+  });
+  const failed = rows.filter((row) => row.status === "fail").length;
+  const warned = rows.filter((row) => row.status === "warn").length;
+  return {
+    failed,
+    passed: rows.filter((row) => row.status === "pass").length,
+    rows,
+    status: failed > 0 ? "fail" : warned > 0 ? "warn" : "pass",
+    total: rows.length,
+    warned
+  };
+};
 var normalizeCapability = (value) => value.toLowerCase().replace(/[^a-z0-9]+/g, "");
 var includesCapability = (capabilities, required) => {
   const normalizedRequired = normalizeCapability(required);
@@ -24511,6 +24606,7 @@ export {
   claimVoiceOpsTask,
   buildVoiceTraceReplay,
   buildVoiceTraceDeliveryReport,
+  buildVoiceProviderContractMatrix,
   buildVoiceProductionReadinessReport,
   buildVoiceProductionReadinessGate,
   buildVoiceOpsTaskFromSLABreach,

package/dist/productionReadiness.d.ts

@@ -11,7 +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';
+import type { VoiceProviderContractMatrixReport, VoiceProviderStackCapabilityGapReport } from './providerStackRecommendations';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProductionReadinessAction = {
     description?: string;
@@ -139,6 +139,7 @@ export type VoiceProductionReadinessReport = {
             total: number;
         };
         providerStack?: VoiceProviderStackCapabilityGapReport;
+        providerContractMatrix?: VoiceProviderContractMatrixReport;
         providerRecovery: VoiceProviderFallbackRecoverySummary;
         phoneAgentSmokes?: {
             failed: number;
@@ -303,6 +304,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<VoiceProviderStackCapabilityGapReport> | VoiceProviderStackCapabilityGapReport);
+    providerContractMatrix?: false | VoiceProviderContractMatrixReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceProviderContractMatrixReport> | VoiceProviderContractMatrixReport);
     reconnectContracts?: false | readonly VoiceReconnectContractReport[] | ((input: {
         query: Record<string, unknown>;
         request: Request;

package/dist/providerStackRecommendations.d.ts

@@ -35,5 +35,45 @@ export type VoiceProviderStackCapabilityGapInput<TProvider extends string = stri
     recommendation?: VoiceProviderStackRecommendation<TProvider>;
     required?: Partial<Record<VoiceProviderStackKind, readonly string[]>>;
 };
+export type VoiceProviderContractCheckStatus = 'fail' | 'pass' | 'warn';
+export type VoiceProviderContractCheck = {
+    detail?: string;
+    key: string;
+    label: string;
+    status: VoiceProviderContractCheckStatus;
+};
+export type VoiceProviderContractDefinition<TProvider extends string = string> = {
+    capabilities?: readonly string[];
+    configured?: boolean;
+    env?: Record<string, string | undefined>;
+    fallbackProviders?: readonly TProvider[];
+    kind: VoiceProviderStackKind;
+    latencyBudgetMs?: number;
+    provider: TProvider;
+    requiredCapabilities?: readonly string[];
+    requiredEnv?: readonly string[];
+    selected?: boolean;
+    streaming?: boolean;
+};
+export type VoiceProviderContractMatrixInput<TProvider extends string = string> = {
+    contracts: readonly VoiceProviderContractDefinition<TProvider>[];
+};
+export type VoiceProviderContractMatrixRow<TProvider extends string = string> = {
+    checks: VoiceProviderContractCheck[];
+    configured: boolean;
+    kind: VoiceProviderStackKind;
+    provider: TProvider;
+    selected: boolean;
+    status: VoiceProviderContractCheckStatus;
+};
+export type VoiceProviderContractMatrixReport<TProvider extends string = string> = {
+    failed: number;
+    passed: number;
+    rows: VoiceProviderContractMatrixRow<TProvider>[];
+    status: VoiceProviderContractCheckStatus;
+    total: number;
+    warned: number;
+};
 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 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.165",
+	"version": "0.0.22-beta.166",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",