@absolutejs/voice 0.0.22-beta.240 → 0.0.22-beta.241

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkDescriptor, create
 export { buildVoiceOpsActionHistoryReport, createVoiceOpsActionAuditRoutes, recordVoiceOpsActionAudit, renderVoiceOpsActionHistoryHTML } from './opsActionAuditRoutes';
 export { buildVoicePlatformCoverageSummary, createVoicePlatformCoverageRoutes } from './platformCoverage';
 export type { VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
+export { buildEmptyVoiceProofTrendReport, buildVoiceProofTrendReport, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, formatVoiceProofTrendAge } from './proofTrends';
+export type { VoiceProofTrendCycle, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendStatus, VoiceProofTrendSummary } from './proofTrends';
 export { buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';
 export type { VoiceLiveOpsAction, VoiceLiveOpsActionInput, VoiceLiveOpsActionResult, VoiceLiveOpsControllerOptions, VoiceLiveOpsControlState, VoiceLiveOpsControlStatus, VoiceLiveOpsControlStore, VoiceLiveOpsRoutesOptions } from './liveOps';
 export { buildVoiceDeliveryRuntimeReport, createVoiceDeliveryRuntime, createVoiceDeliveryRuntimePresetConfig, createVoiceDeliveryRuntimeRoutes, renderVoiceDeliveryRuntimeHTML } from './deliveryRuntime';

package/dist/index.js

@@ -12291,6 +12291,67 @@ var createVoicePlatformCoverageRoutes = (options) => {
   });
   return routes;
 };
+// src/proofTrends.ts
+var DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+var normalizeMaxAgeMs = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? value : DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS;
+var toTimeMs = (value) => {
+  if (value instanceof Date) {
+    return value.getTime();
+  }
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return Date.parse(value);
+  }
+  return Date.now();
+};
+var buildVoiceProofTrendReport = (input = {}) => {
+  const maxAgeMs = normalizeMaxAgeMs(input.maxAgeMs);
+  const nowMs = toTimeMs(input.now);
+  const generatedAtMs = typeof input.generatedAt === "string" ? Date.parse(input.generatedAt) : Number.NaN;
+  const ageMs = Number.isFinite(generatedAtMs) && Number.isFinite(nowMs) ? Math.max(0, nowMs - generatedAtMs) : undefined;
+  const freshUntil = Number.isFinite(generatedAtMs) && Number.isFinite(maxAgeMs) ? new Date(generatedAtMs + maxAgeMs).toISOString() : undefined;
+  const isFresh = ageMs !== undefined && ageMs <= maxAgeMs;
+  const status = input.status === "empty" ? "empty" : !isFresh ? "stale" : input.ok === true ? "pass" : "fail";
+  return {
+    ageMs,
+    baseUrl: input.baseUrl,
+    cycles: input.cycles ?? [],
+    freshUntil,
+    generatedAt: input.generatedAt,
+    maxAgeMs,
+    ok: input.ok === true && status === "pass",
+    outputDir: input.outputDir,
+    runId: input.runId,
+    source: input.source ?? "",
+    status,
+    summary: input.summary ?? {}
+  };
+};
+var buildEmptyVoiceProofTrendReport = (source = "", maxAgeMs) => buildVoiceProofTrendReport({
+  maxAgeMs,
+  source,
+  status: "empty"
+});
+var formatVoiceProofTrendAge = (ageMs) => {
+  if (typeof ageMs !== "number" || !Number.isFinite(ageMs)) {
+    return "unknown";
+  }
+  const minutes = Math.floor(ageMs / 60000);
+  if (minutes < 1) {
+    return "less than 1m";
+  }
+  if (minutes < 60) {
+    return `${minutes}m`;
+  }
+  const hours = Math.floor(minutes / 60);
+  if (hours < 48) {
+    return `${hours}h ${minutes % 60}m`;
+  }
+  const days = Math.floor(hours / 24);
+  return `${days}d ${hours % 24}h`;
+};
 // src/liveOps.ts
 import { Elysia as Elysia14 } from "elysia";
 var VOICE_LIVE_OPS_ACTIONS = [
@@ -29174,6 +29235,7 @@ export {
   hasVoiceOpsTaskSLABreach,
   getVoiceLiveOpsControlStatus,
   getVoiceCampaignDialerProofStatus,
+  formatVoiceProofTrendAge,
   filterVoiceTraceEvents,
   filterVoiceAuditEvents,
   failVoiceOpsTask,
@@ -29457,6 +29519,7 @@ export {
   buildVoiceTraceDeliveryReport,
   buildVoiceProviderSloReport,
   buildVoiceProviderContractMatrix,
+  buildVoiceProofTrendReport,
   buildVoiceProductionReadinessReport,
   buildVoiceProductionReadinessGate,
   buildVoicePlatformCoverageSummary,
@@ -29484,6 +29547,7 @@ export {
   buildVoiceAuditTrailReport,
   buildVoiceAuditExport,
   buildVoiceAuditDeliveryReport,
+  buildEmptyVoiceProofTrendReport,
   assignVoiceOpsTask,
   assertVoiceProviderRoutingContract,
   assertVoiceObservabilityExportSchema,
@@ -29499,5 +29563,6 @@ export {
   applyRiskTieredPhraseHintCorrections,
   applyPhraseHintCorrections,
   VOICE_LIVE_OPS_ACTIONS,
-  TURN_PROFILE_DEFAULTS
+  TURN_PROFILE_DEFAULTS,
+  DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS
 };

package/dist/proofTrends.d.ts

@@ -0,0 +1,64 @@
+export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
+export type VoiceProofTrendSummary = {
+    cycles?: number;
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxTurnP95Ms?: number;
+};
+export type VoiceProofTrendCycle = {
+    at?: string;
+    cycle?: number;
+    liveLatency?: {
+        p95Ms?: number;
+        samples?: number;
+    };
+    ok?: boolean;
+    opsRecovery?: {
+        issues?: number;
+        status?: string;
+    };
+    productionReadiness?: {
+        status?: string;
+    };
+    providerSlo?: {
+        events?: number;
+        eventsWithLatency?: number;
+        status?: string;
+    };
+    turnLatency?: {
+        p95Ms?: number;
+        samples?: number;
+        status?: string;
+    };
+};
+export type VoiceProofTrendReportInput = {
+    baseUrl?: string;
+    cycles?: VoiceProofTrendCycle[];
+    generatedAt?: string;
+    maxAgeMs?: number;
+    now?: Date | number | string;
+    ok?: boolean;
+    outputDir?: string;
+    runId?: string;
+    source?: string;
+    status?: VoiceProofTrendStatus;
+    summary?: VoiceProofTrendSummary;
+};
+export type VoiceProofTrendReport = {
+    ageMs?: number;
+    baseUrl?: string;
+    cycles: VoiceProofTrendCycle[];
+    freshUntil?: string;
+    generatedAt?: string;
+    maxAgeMs: number;
+    ok: boolean;
+    outputDir?: string;
+    runId?: string;
+    source: string;
+    status: VoiceProofTrendStatus;
+    summary: VoiceProofTrendSummary;
+};
+export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
+export declare const buildVoiceProofTrendReport: (input?: VoiceProofTrendReportInput) => VoiceProofTrendReport;
+export declare const buildEmptyVoiceProofTrendReport: (source?: string, maxAgeMs?: number) => VoiceProofTrendReport;
+export declare const formatVoiceProofTrendAge: (ageMs: unknown) => string;

package/package.json

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