@absolutejs/voice 0.0.22-beta.284 → 0.0.22-beta.286

package/dist/index.js

@@ -10798,6 +10798,18 @@ var findDuplicateTurnIds = (snapshots) => {
   }
   return [...duplicates].sort();
 };
+var percentile = (values, rank) => {
+  if (values.length === 0) {
+    return;
+  }
+  const sorted = [...values].sort((left, right) => left - right);
+  const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(rank / 100 * sorted.length) - 1));
+  return sorted[index];
+};
+var getResumeLatencies = (snapshots) => snapshots.filter((snapshot) => snapshot.reconnect.status === "resumed" && typeof snapshot.reconnect.lastResumedAt === "number").map((snapshot) => {
+  const previousReconnect = snapshots.filter((candidate) => candidate.at <= snapshot.at && candidate.reconnect.status === "reconnecting" && typeof candidate.reconnect.lastDisconnectAt === "number").at(-1);
+  return previousReconnect?.reconnect.lastDisconnectAt === undefined ? undefined : snapshot.reconnect.lastResumedAt - previousReconnect.reconnect.lastDisconnectAt;
+}).filter((value) => typeof value === "number" && value >= 0);
 var runVoiceReconnectContract = (options) => {
   const snapshots = [...options.snapshots].sort((left, right) => left.at - right.at);
   const issues = [];
@@ -10808,6 +10820,7 @@ var runVoiceReconnectContract = (options) => {
   const resumed = statuses.includes("resumed");
   const exhausted = statuses.includes("exhausted");
   const duplicateTurnIds = findDuplicateTurnIds(snapshots);
+  const resumeLatencyP95Ms = percentile(getResumeLatencies(snapshots), 95);
   const requireReconnect = options.requireReconnect ?? true;
   const requireResume = options.requireResume ?? true;
   const requireReplayProtection = options.requireReplayProtection ?? true;
@@ -10861,6 +10874,7 @@ var runVoiceReconnectContract = (options) => {
     checkedAt: Date.now(),
     issues,
     pass,
+    resumeLatencyP95Ms,
     snapshotCount: snapshots.length,
     statuses,
     summary: {
@@ -12628,7 +12642,7 @@ var DEFAULT_WARN_RATIO = 0.8;
 var DEFAULT_MIN_PASSING_RUNS = 3;
 var roundMs = (value) => Math.max(1, Math.ceil(value));
 var finiteNumber = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0;
-var percentile = (values, rank) => {
+var percentile2 = (values, rank) => {
   if (values.length === 0) {
     return;
   }
@@ -12651,7 +12665,7 @@ var normalizeSample = (input) => {
   return input;
 };
 var createThreshold = (metric, values, options) => {
-  const baselineP95Ms = percentile(values, 95);
+  const baselineP95Ms = percentile2(values, 95);
   const maxObservedMs = values.length > 0 ? Math.max(...values) : undefined;
   const recommendedMs = baselineP95Ms === undefined ? undefined : roundMs(Math.max(options.minimumMs, baselineP95Ms * options.headroomMultiplier));
   const warnAfterMs = recommendedMs === undefined ? undefined : roundMs(Math.max(options.minimumMs, recommendedMs * options.warnRatio));
@@ -17030,7 +17044,7 @@ var createVoiceTurnLatencyRoutes = (options) => {
 // src/liveLatency.ts
 import { Elysia as Elysia27 } from "elysia";
 var escapeHtml26 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var percentile2 = (values, percentileValue) => {
+var percentile3 = (values, percentileValue) => {
   if (values.length === 0) {
     return;
   }
@@ -17066,8 +17080,8 @@ var summarizeVoiceLiveLatency = async (options) => {
     averageLatencyMs: latencies.length > 0 ? Math.round(latencies.reduce((total, value) => total + value, 0) / latencies.length) : undefined,
     checkedAt: Date.now(),
     failed,
-    p50LatencyMs: percentile2(latencies, 50),
-    p95LatencyMs: percentile2(latencies, 95),
+    p50LatencyMs: percentile3(latencies, 50),
+    p95LatencyMs: percentile3(latencies, 95),
     recent,
     status: latencies.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
     total: latencies.length,
@@ -17143,7 +17157,7 @@ var TRACE_TYPES = [
 ];
 var getNumber6 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getString12 = (value) => typeof value === "string" && value.trim() ? value : undefined;
-var percentile3 = (values, percentileValue) => {
+var percentile4 = (values, percentileValue) => {
   if (values.length === 0) {
     return;
   }
@@ -17351,8 +17365,8 @@ var summarizeStage = (stage, measurements, options) => {
     label: STAGE_LABELS[stage],
     maxMs: latencies.length > 0 ? Math.max(...latencies) : undefined,
     measurements: stageMeasurements,
-    p50Ms: percentile3(latencies, 50),
-    p95Ms: percentile3(latencies, 95),
+    p50Ms: percentile4(latencies, 50),
+    p95Ms: percentile4(latencies, 95),
     stage,
     status: stageMeasurements.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
     total: stageMeasurements.length,
@@ -23790,7 +23804,7 @@ var rate3 = (count, total) => count / Math.max(1, total);
 var uniqueSorted5 = (values) => [
   ...new Set(values.filter((value) => typeof value === "string"))
 ].sort();
-var percentile4 = (values, rank) => {
+var percentile5 = (values, rank) => {
   if (values.length === 0) {
     return 0;
   }
@@ -23848,7 +23862,7 @@ var summarizeKind = (kind, events, thresholds, required) => {
       unit: "rate"
     }),
     p95ElapsedMs: createMetric2({
-      actual: percentile4(latencies, 95),
+      actual: percentile5(latencies, 95),
       label: "P95 latency",
       threshold: thresholds.maxP95ElapsedMs,
       unit: "ms"
@@ -27857,6 +27871,7 @@ var voiceOperationsRecordHref = (base, sessionId) => {
 };
 var buildOperationsRecordLinks = (input) => {
   const failedSessionSet = new Set(input.failedSessionIds);
+  const minLiveLatencyAt = typeof input.liveLatencyMaxAgeMs === "number" && Number.isFinite(input.liveLatencyMaxAgeMs) && input.liveLatencyMaxAgeMs > 0 ? Date.now() - input.liveLatencyMaxAgeMs : undefined;
   const providerErrors = input.events.filter((event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string")).map((event) => ({
     detail: getString18(event.payload.error),
     href: voiceOperationsRecordHref(input.base, event.sessionId),
@@ -27864,7 +27879,7 @@ var buildOperationsRecordLinks = (input) => {
     sessionId: event.sessionId,
     status: "fail"
   }));
-  const failingLatency = input.events.filter((event) => event.type === "client.live_latency").map((event) => ({
+  const failingLatency = input.events.filter((event) => event.type === "client.live_latency" && (minLiveLatencyAt === undefined || event.at >= minLiveLatencyAt)).map((event) => ({
     event,
     latencyMs: getNumber10(event.payload.latencyMs) ?? getNumber10(event.payload.elapsedMs)
   })).filter((entry) => entry.latencyMs !== undefined && entry.latencyMs > input.liveLatencyWarnAfterMs).map(({ event, latencyMs }) => ({
@@ -27973,6 +27988,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     events,
     failedSessionIds: failedSessionItems.map((session) => session.sessionId),
     liveLatencyFailAfterMs: options.liveLatencyFailAfterMs ?? 3200,
+    liveLatencyMaxAgeMs: options.liveLatencyMaxAgeMs,
     liveLatencyWarnAfterMs: options.liveLatencyWarnAfterMs ?? 1800
   });
   const checks = [
@@ -28164,15 +28180,17 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   } : undefined;
   const monitoringSummary = monitoring ? {
     criticalOpen: monitoring.summary.criticalOpen,
+    elapsedMs: monitoring.elapsedMs,
     open: monitoring.summary.open,
-    status: monitoring.status,
+    status: options.monitoringRunFailAfterMs !== undefined && monitoring.elapsedMs > options.monitoringRunFailAfterMs ? "fail" : monitoring.status,
     total: monitoring.summary.total
   } : undefined;
   const monitoringNotifierDeliverySummary = monitoringNotifierDelivery ? {
+    elapsedMs: monitoringNotifierDelivery.elapsedMs,
     failed: monitoringNotifierDelivery.summary.failed,
     notifiers: monitoringNotifierDelivery.summary.notifiers,
     sent: monitoringNotifierDelivery.summary.sent,
-    status: monitoringNotifierDelivery.status,
+    status: options.monitoringNotifierDeliveryFailAfterMs !== undefined && monitoringNotifierDelivery.elapsedMs > options.monitoringNotifierDeliveryFailAfterMs ? "fail" : monitoringNotifierDelivery.status,
     total: monitoringNotifierDelivery.summary.total
   } : undefined;
   const telephonyWebhookSecuritySummary = telephonyWebhookSecurity ? {
@@ -28182,12 +28200,17 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     status: telephonyWebhookSecurity.status,
     warned: telephonyWebhookSecurity.summary.warned
   } : undefined;
-  const reconnectContractSummary = reconnectContracts ? {
-    failed: reconnectContracts.filter((report) => !report.pass).length,
-    passed: reconnectContracts.filter((report) => report.pass).length,
-    status: reconnectContracts.some((report) => !report.pass) ? "fail" : reconnectContracts.length === 0 ? "warn" : "pass",
-    total: reconnectContracts.length
-  } : undefined;
+  const reconnectContractSummary = reconnectContracts ? (() => {
+    const failedReports = reconnectContracts.filter((report) => !report.pass || options.reconnectResumeFailAfterMs !== undefined && report.resumeLatencyP95Ms !== undefined && report.resumeLatencyP95Ms > options.reconnectResumeFailAfterMs);
+    const resumeLatencies = reconnectContracts.map((report) => report.resumeLatencyP95Ms).filter((value) => typeof value === "number");
+    return {
+      failed: failedReports.length,
+      passed: reconnectContracts.length - failedReports.length,
+      resumeLatencyP95Ms: resumeLatencies.length > 0 ? Math.max(...resumeLatencies) : undefined,
+      status: failedReports.length > 0 ? "fail" : reconnectContracts.length === 0 ? "warn" : "pass",
+      total: reconnectContracts.length
+    };
+  })() : undefined;
   const bargeInSummary = bargeInReports ? {
     failed: bargeInReports.reduce((total, report) => total + report.failed, 0),
     passed: bargeInReports.reduce((total, report) => total + report.passed, 0),
@@ -28404,7 +28427,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   }
   if (reconnectContractSummary) {
     checks.push({
-      detail: reconnectContractSummary.status === "pass" ? `${reconnectContractSummary.passed} reconnect contract(s) are passing.` : reconnectContractSummary.total === 0 ? "No reconnect contracts are configured." : `${reconnectContractSummary.failed} reconnect contract(s) failed.`,
+      detail: reconnectContractSummary.status === "pass" ? `${reconnectContractSummary.passed} reconnect contract(s) are passing.` : reconnectContractSummary.total === 0 ? "No reconnect contracts are configured." : options.reconnectResumeFailAfterMs !== undefined && reconnectContractSummary.resumeLatencyP95Ms !== undefined && reconnectContractSummary.resumeLatencyP95Ms > options.reconnectResumeFailAfterMs ? `Reconnect resume p95 ${reconnectContractSummary.resumeLatencyP95Ms}ms exceeded ${options.reconnectResumeFailAfterMs}ms.` : `${reconnectContractSummary.failed} reconnect contract(s) failed.`,
       href: options.links?.reconnectContracts ?? options.links?.sessions ?? "/sessions",
       label: "Reconnect recovery contracts",
       proofSource: proofSource("reconnectContracts", "reconnect"),
@@ -28573,7 +28596,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   }
   if (monitoring && monitoringSummary) {
     checks.push({
-      detail: monitoringSummary.status === "pass" ? `${monitoringSummary.total} monitor(s) are passing with no open issues.` : `${monitoringSummary.open} monitor issue(s) open, ${monitoringSummary.criticalOpen} critical.`,
+      detail: monitoringSummary.status === "pass" ? `${monitoringSummary.total} monitor(s) are passing with no open issues.` : options.monitoringRunFailAfterMs !== undefined && monitoringSummary.elapsedMs !== undefined && monitoringSummary.elapsedMs > options.monitoringRunFailAfterMs ? `Monitor run took ${monitoringSummary.elapsedMs}ms, above ${options.monitoringRunFailAfterMs}ms.` : `${monitoringSummary.open} monitor issue(s) open, ${monitoringSummary.criticalOpen} critical.`,
       href: options.links?.monitoring ?? "/voice/monitors",
       label: "Monitoring issues",
       status: monitoringSummary.status,
@@ -28589,7 +28612,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   }
   if (monitoringNotifierDelivery && monitoringNotifierDeliverySummary) {
     checks.push({
-      detail: monitoringNotifierDeliverySummary.status === "pass" ? `${monitoringNotifierDeliverySummary.sent} monitor notification(s) delivered.` : `${monitoringNotifierDeliverySummary.failed} monitor notification delivery failure(s).`,
+      detail: monitoringNotifierDeliverySummary.status === "pass" ? `${monitoringNotifierDeliverySummary.sent} monitor notification(s) delivered.` : options.monitoringNotifierDeliveryFailAfterMs !== undefined && monitoringNotifierDeliverySummary.elapsedMs !== undefined && monitoringNotifierDeliverySummary.elapsedMs > options.monitoringNotifierDeliveryFailAfterMs ? `Monitor notification delivery took ${monitoringNotifierDeliverySummary.elapsedMs}ms, above ${options.monitoringNotifierDeliveryFailAfterMs}ms.` : `${monitoringNotifierDeliverySummary.failed} monitor notification delivery failure(s).`,
       href: options.links?.monitoringNotifierDelivery ?? "/api/voice/monitor-issues/notifications",
       label: "Monitor notifier delivery",
       status: monitoringNotifierDeliverySummary.status,
@@ -28821,7 +28844,8 @@ var createVoiceMemoryMonitorNotifierDeliveryReceiptStore = (initial = []) => {
   };
 };
 var buildVoiceMonitorRunReport = async (options) => {
-  const checkedAt = options.now ?? Date.now();
+  const startedAt = Date.now();
+  const checkedAt = options.now ?? startedAt;
   const runs = await Promise.all(options.monitors.map(async (monitor) => {
     const evaluation = await monitor.evaluate({
       evidence: options.evidence,
@@ -28861,6 +28885,7 @@ var buildVoiceMonitorRunReport = async (options) => {
   const criticalOpen = openIssues.filter((issue) => issue.severity === "critical").length;
   return {
     checkedAt,
+    elapsedMs: Math.max(0, Date.now() - startedAt),
     issues,
     runs,
     status: criticalOpen > 0 ? "fail" : openIssues.length > 0 || rollupStatus4(runs) === "warn" ? "warn" : rollupStatus4(runs),
@@ -28921,7 +28946,8 @@ var createVoiceMonitorWebhookNotifier = (options) => ({
   }
 });
 var deliverVoiceMonitorIssueNotifications = async (options) => {
-  const checkedAt = options.now ?? Date.now();
+  const startedAt = Date.now();
+  const checkedAt = options.now ?? startedAt;
   const statuses = new Set(options.statuses ?? ["open"]);
   const issues = (await options.issueStore.list()).filter((issue) => statuses.has(issue.status));
   const receipts = [];
@@ -28947,6 +28973,7 @@ var deliverVoiceMonitorIssueNotifications = async (options) => {
   const skipped = allReceipts.filter((receipt) => receipt.status === "skipped").length;
   return {
     checkedAt,
+    elapsedMs: Math.max(0, Date.now() - startedAt),
     receipts: allReceipts,
     status: failed > 0 ? "fail" : allReceipts.length === 0 ? "warn" : "pass",
     summary: {

package/dist/productionReadiness.d.ts

@@ -181,11 +181,13 @@ export type VoiceProductionReadinessReport = {
         };
         monitoring?: {
             criticalOpen: number;
+            elapsedMs?: number;
             open: number;
             status: VoiceProductionReadinessStatus;
             total: number;
         };
         monitoringNotifierDelivery?: {
+            elapsedMs?: number;
             failed: number;
             notifiers: number;
             sent: number;
@@ -259,6 +261,7 @@ export type VoiceProductionReadinessReport = {
         reconnectContracts?: {
             failed: number;
             passed: number;
+            resumeLatencyP95Ms?: number;
             status: VoiceProductionReadinessStatus;
             total: number;
         };
@@ -482,6 +485,9 @@ export type VoiceProductionReadinessRoutesOptions = {
     liveLatencyWarnAfterMs?: number;
     liveLatencyFailAfterMs?: number;
     liveLatencyMaxAgeMs?: number;
+    monitoringRunFailAfterMs?: number;
+    monitoringNotifierDeliveryFailAfterMs?: number;
+    reconnectResumeFailAfterMs?: number;
 };
 export declare const summarizeVoiceProductionReadinessGate: (report: VoiceProductionReadinessReport, options?: VoiceProductionReadinessGateOptions) => VoiceProductionReadinessGateReport;
 export declare const evaluateVoiceProductionReadinessEvidence: (report: VoiceProductionReadinessReport, input?: VoiceProductionReadinessAssertionInput) => VoiceProductionReadinessAssertionReport;

package/dist/reconnectContract.d.ts

@@ -15,6 +15,7 @@ export type VoiceReconnectContractReport = {
     checkedAt: number;
     issues: VoiceReconnectContractIssue[];
     pass: boolean;
+    resumeLatencyP95Ms?: number;
     snapshotCount: number;
     statuses: VoiceReconnectClientState['status'][];
     summary: {

package/dist/voiceMonitoring.d.ts

@@ -83,6 +83,7 @@ export type VoiceMonitorNotifierDeliveryReceiptStore = {
 };
 export type VoiceMonitorNotifierDeliveryReport = {
     checkedAt: number;
+    elapsedMs: number;
     receipts: VoiceMonitorNotifierDeliveryReceipt[];
     status: VoiceMonitorStatus;
     summary: {
@@ -95,6 +96,7 @@ export type VoiceMonitorNotifierDeliveryReport = {
 };
 export type VoiceMonitorRunReport = {
     checkedAt: number;
+    elapsedMs: number;
     issues: VoiceMonitorIssue[];
     runs: VoiceMonitorRun[];
     status: VoiceMonitorStatus;

package/package.json

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