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

package/dist/index.d.ts

@@ -45,7 +45,7 @@ export { createVoiceProviderCapabilityHTMLHandler, createVoiceProviderCapability
 export { assertVoiceProviderRoutingContract, runVoiceProviderRoutingContract } from './providerRoutingContract';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
 export { buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
-export { createVoiceReadinessProfile } from './readinessProfiles';
+export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
@@ -103,8 +103,8 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
-export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
+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 { 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

@@ -20149,6 +20149,27 @@ var readinessGateCodes = {
   "Trace sink delivery": "voice.readiness.trace_sink_delivery"
 };
 var readinessGateCodeForCheck = (check) => readinessGateCodes[check.label] ?? `voice.readiness.${check.label.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "")}`;
+var normalizeReadinessLabel = (value) => value.toLowerCase().replace(/[^a-z0-9]+/g, "");
+var issueMatchesProfileSurface = (issue, surface) => normalizeReadinessLabel(issue.label) === normalizeReadinessLabel(surface.label) || issue.code.includes(surface.key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase().replace(/[^a-z0-9]+/g, "_"));
+var summarizeProfileSurfaceStatus = (issues) => issues.some((issue) => issue.status === "fail") ? "fail" : issues.some((issue) => issue.status === "warn") ? "warn" : "pass";
+var summarizeVoiceProductionReadinessGateProfile = (report, issues) => {
+  if (!report.profile) {
+    return;
+  }
+  return {
+    description: report.profile.description,
+    name: report.profile.name,
+    purpose: report.profile.purpose,
+    surfaces: report.profile.surfaces.map((surface) => {
+      const surfaceIssues = issues.filter((issue) => issueMatchesProfileSurface(issue, surface));
+      return {
+        ...surface,
+        issues: surfaceIssues,
+        status: summarizeProfileSurfaceStatus(surfaceIssues)
+      };
+    })
+  };
+};
 var summarizeVoiceProductionReadinessGate = (report, options = {}) => {
   const issues = report.checks.filter((check) => check.status !== "pass").map((check) => ({
     code: readinessGateCodeForCheck(check),
@@ -20165,6 +20186,7 @@ var summarizeVoiceProductionReadinessGate = (report, options = {}) => {
     checkedAt: report.checkedAt,
     failures,
     ok,
+    profile: summarizeVoiceProductionReadinessGateProfile(report, issues),
     status: ok ? report.status : "fail",
     warnings
   };
@@ -20947,6 +20969,73 @@ var createVoiceProductionReadinessRoutes = (options) => {
   return routes;
 };
 // src/readinessProfiles.ts
+var profileSurfaceLabels = {
+  "meeting-recorder": {
+    bargeInReports: "barge-in proof configured",
+    providerRoutingContracts: "provider routing contracts configured",
+    reconnectContracts: "reconnect contracts configured"
+  },
+  "ops-heavy": {
+    audit: "audit evidence configured",
+    auditDeliveries: "audit delivery queue configured",
+    deliveryRuntime: "delivery runtime configured",
+    opsActionHistory: "operator action history configured",
+    traceDeliveries: "trace delivery queue configured"
+  },
+  "phone-agent": {
+    auditDeliveries: "audit delivery queue configured",
+    carriers: "carrier readiness configured",
+    deliveryRuntime: "delivery runtime configured",
+    phoneAgentSmokes: "phone-agent smoke proof configured",
+    providerRoutingContracts: "provider routing contracts configured",
+    traceDeliveries: "trace delivery queue configured"
+  }
+};
+var profileRequiredKeys = {
+  "meeting-recorder": [
+    "bargeInReports",
+    "providerRoutingContracts",
+    "reconnectContracts"
+  ],
+  "ops-heavy": [
+    "audit",
+    "opsActionHistory",
+    "auditDeliveries",
+    "traceDeliveries",
+    "deliveryRuntime"
+  ],
+  "phone-agent": [
+    "carriers",
+    "phoneAgentSmokes",
+    "providerRoutingContracts",
+    "auditDeliveries",
+    "traceDeliveries",
+    "deliveryRuntime"
+  ]
+};
+var configuredProfileKeys = (options) => {
+  const configured = new Set;
+  for (const key of [
+    "audit",
+    "auditDeliveries",
+    "bargeInReports",
+    "carriers",
+    "deliveryRuntime",
+    "opsActionHistory",
+    "phoneAgentSmokes",
+    "providerRoutingContracts",
+    "reconnectContracts",
+    "traceDeliveries"
+  ]) {
+    if (isConfigured(options[key])) {
+      configured.add(key);
+    }
+  }
+  if (configured.has("audit")) {
+    configured.add("opsActionHistory");
+  }
+  return configured;
+};
 var auditStoreFromOptions = (audit) => {
   if (!audit) {
     return;
@@ -21163,6 +21252,38 @@ var createVoiceReadinessProfile = (profile, options = {}) => {
     traceDeliveries: options.traceDeliveries
   });
 };
+var recommendVoiceReadinessProfile = (options) => {
+  const configured = configuredProfileKeys(options);
+  const scores = ["phone-agent", "meeting-recorder", "ops-heavy"].map((profile) => {
+    const required = profileRequiredKeys[profile];
+    const configuredKeys = required.filter((key) => configured.has(key));
+    const missing = required.filter((key) => !configured.has(key));
+    const reasons = configuredKeys.map((key) => profileSurfaceLabels[profile][key] ?? `${key} configured`);
+    return {
+      configured: configuredKeys,
+      confidence: required.length === 0 ? 0 : Math.round(configuredKeys.length / required.length * 100) / 100,
+      missing,
+      profile,
+      reasons
+    };
+  });
+  const [best] = scores.toSorted((left, right) => {
+    if (right.confidence !== left.confidence) {
+      return right.confidence - left.confidence;
+    }
+    return right.configured.length - left.configured.length;
+  });
+  if (!best) {
+    throw new Error("No voice readiness profiles are available.");
+  }
+  return {
+    confidence: best.confidence,
+    missing: best.missing,
+    profile: best.profile,
+    reasons: best.reasons,
+    scores
+  };
+};
 // src/opsConsoleRoutes.ts
 import { Elysia as Elysia34 } from "elysia";
 var DEFAULT_LINKS = [
@@ -23978,6 +24099,7 @@ export {
   recordVoiceOperatorAuditEvent,
   recordVoiceHandoffAuditEvent,
   recordVoiceAuditEvent,
+  recommendVoiceReadinessProfile,
   pruneVoiceTraceEvents,
   parseVoiceTelephonyWebhookEvent,
   matchesVoiceOpsTaskAssignmentRule,

package/dist/productionReadiness.d.ts

@@ -42,6 +42,7 @@ export type VoiceProductionReadinessGateReport = {
     checkedAt: number;
     failures: VoiceProductionReadinessGateIssue[];
     ok: boolean;
+    profile?: VoiceProductionReadinessGateProfile;
     status: VoiceProductionReadinessStatus;
     warnings: VoiceProductionReadinessGateIssue[];
 };
@@ -64,6 +65,13 @@ export type VoiceProductionReadinessProfileExplanation = {
     purpose: string;
     surfaces: VoiceProductionReadinessProfileSurface[];
 };
+export type VoiceProductionReadinessGateProfileSurface = VoiceProductionReadinessProfileSurface & {
+    issues: VoiceProductionReadinessGateIssue[];
+    status: VoiceProductionReadinessStatus;
+};
+export type VoiceProductionReadinessGateProfile = Omit<VoiceProductionReadinessProfileExplanation, 'surfaces'> & {
+    surfaces: VoiceProductionReadinessGateProfileSurface[];
+};
 export type VoiceProductionReadinessReport = {
     checkedAt: number;
     checks: VoiceProductionReadinessCheck[];

package/dist/readinessProfiles.d.ts

@@ -17,4 +17,19 @@ export type VoiceReadinessProfileOptions = {
     traceDeliveries?: VoiceProductionReadinessTraceDeliveryOptions;
 };
 export type VoiceReadinessProfileRoutesOptions = Partial<Omit<VoiceProductionReadinessRoutesOptions, 'store'>>;
+export type VoiceReadinessProfileRecommendationScore = {
+    configured: string[];
+    confidence: number;
+    missing: string[];
+    profile: VoiceReadinessProfileName;
+    reasons: string[];
+};
+export type VoiceReadinessProfileRecommendation = {
+    confidence: number;
+    missing: string[];
+    profile: VoiceReadinessProfileName;
+    reasons: string[];
+    scores: VoiceReadinessProfileRecommendationScore[];
+};
 export declare const createVoiceReadinessProfile: (profile: VoiceReadinessProfileName, options?: VoiceReadinessProfileOptions) => VoiceReadinessProfileRoutesOptions;
+export declare const recommendVoiceReadinessProfile: (options: VoiceReadinessProfileOptions) => VoiceReadinessProfileRecommendation;

package/package.json

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