@absolutejs/voice 0.0.22-beta.367 → 0.0.22-beta.368

package/README.md

@@ -1401,6 +1401,91 @@ assertVoiceProductionReadinessEvidence(readiness, {
 });
 ```
 
+Use `createVoiceProductionReadinessProofRuntime(...)` when the app needs a fresh, isolated proof window instead of letting stale local traces certify a deploy. The runtime is intentionally small: it owns a bounded in-memory trace store, route-cache defaults, a reusable TTL cache, a proof-freshness check, and optional synthetic provider/live-latency seed events. Your app still mounts routes, writes artifacts, and decides which proof sources matter.
+
+```ts
+import {
+	createVoiceProductionReadinessProofRuntime,
+	createVoiceProductionReadinessRoutes,
+	createVoiceReadinessProfile
+} from '@absolutejs/voice';
+
+const readinessProof = createVoiceProductionReadinessProofRuntime({
+	cacheMs: 10_000,
+	traceMaxAgeMs: 30 * 60_000
+});
+
+const refreshReadinessProof = () =>
+	readinessProof.refresh(async (metadata) => {
+		await readinessProof.seedTraceProof({
+			llmProvider: 'openai',
+			scenarioId: 'provider-slo-proof',
+			sttProvider: 'deepgram',
+			ttsProvider: 'openai'
+		});
+
+		await writeProofPack({
+			generatedAt: metadata.generatedAt,
+			runId: metadata.runId
+		});
+	});
+
+app.use(
+	createVoiceProductionReadinessRoutes({
+		...createVoiceReadinessProfile('phone-agent', {
+			explain: true
+		}),
+		additionalChecks: async () => [
+			await readinessProof.buildFreshnessCheck()
+		],
+		cacheMs: readinessProof.options.cacheMs,
+		providerSlo: async () => {
+			await refreshReadinessProof();
+			return {
+				events: await readinessProof.store.list(),
+				requiredKinds: ['llm', 'stt', 'tts']
+			};
+		},
+		resolveOptions: async () => {
+			await refreshReadinessProof();
+			return {};
+		},
+		store: readinessProof.store,
+		traceMaxAgeMs: readinessProof.options.traceMaxAgeMs
+	})
+);
+```
+
+This primitive does not start workers, create persistent storage, mount a dashboard, or prescribe a deploy workflow. It only gives self-hosted apps one clean readiness-proof runtime so JSON, HTML, gate checks, proof packs, and trend artifacts agree on the same fresh evidence window.
+
+Use `buildVoiceRealCallProfileEvidenceFromTraceEvents(...)` or `loadVoiceRealCallProfileEvidenceFromTraceStore(...)` when repeated real browser/phone sessions should drive profile defaults and provider/runtime recommendations. These helpers read ordinary trace events such as `session.error`, `provider.decision`, `client.live_latency`, `client.browser_media`, `client.telephony_media`, `client.barge_in`, and `turn_latency.stage`, then emit `VoiceProofTrendRealCallProfileEvidence[]` for `buildVoiceRealCallProfileHistoryReport(...)`.
+
+```ts
+import {
+	buildVoiceRealCallProfileHistoryReport,
+	createVoiceRealCallProfileHistoryRoutes,
+	loadVoiceRealCallProfileEvidenceFromTraceStore
+} from '@absolutejs/voice';
+
+const buildRealCallHistory = async () =>
+	buildVoiceRealCallProfileHistoryReport({
+		evidence: await loadVoiceRealCallProfileEvidenceFromTraceStore({
+			defaultProfileId: 'meeting-recorder',
+			defaultProfileLabel: 'Meeting recorder',
+			store: runtime.traces
+		}),
+		source: 'runtime.traces'
+	});
+
+app.use(
+	createVoiceRealCallProfileHistoryRoutes({
+		source: buildRealCallHistory
+	})
+);
+```
+
+The point is not to benchmark a fake demo once. The point is to let every real call add profile evidence so `/api/voice/real-call-profile-history`, provider recommendations, profile-switch readiness, and operations records can explain which provider/runtime path is winning for each call shape.
+
 Built-in profiles:
 
 - `meeting-recorder`: live latency, session health, provider fallback, routing contracts, reconnect proof, and barge-in interruption proof.

package/dist/client/index.js

@@ -4016,6 +4016,20 @@ var maxNumber = (values) => {
   const finite = values.filter((value) => typeof value === "number" && Number.isFinite(value));
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
+var percentile = (values, rank) => {
+  const finite = values.filter((value) => Number.isFinite(value)).sort((left, right) => left - right);
+  if (finite.length === 0) {
+    return;
+  }
+  const index = Math.min(finite.length - 1, Math.max(0, Math.ceil(rank / 100 * finite.length) - 1));
+  return finite[index];
+};
+var averageNumber = (values) => {
+  const finite = values.filter((value) => Number.isFinite(value));
+  return finite.length === 0 ? undefined : Math.round(finite.reduce((total, value) => total + value, 0) / finite.length);
+};
+var readString = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var readNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
 var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
@@ -4079,6 +4093,149 @@ var aggregateProofTrendRuntimeChannel = (channels) => {
     status: channels.some((channel) => channel.status === "fail") ? "fail" : channels.some((channel) => channel.status === "warn") ? "warn" : channels.every((channel) => channel.status === "pass") ? "pass" : undefined
   };
 };
+var readTraceRecord = (event) => event.payload;
+var readTraceProfileId = (events, options) => {
+  for (const event of events) {
+    const payload = readTraceRecord(event);
+    const profileId = readString(payload.profileId) ?? readString(event.metadata?.profileId) ?? readString(payload.benchmarkProfileId) ?? readString(event.metadata?.benchmarkProfileId);
+    if (profileId) {
+      return profileId;
+    }
+  }
+  return options.defaultProfileId;
+};
+var readProviderTraceRole = (payload) => readString(payload.kind) ?? readString(payload.role) ?? readString(payload.surface) ?? "provider";
+var readProviderTraceLatency = (payload) => readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs) ?? readNumber2(payload.durationMs);
+var readProviderTraceId = (payload) => readString(payload.selectedProvider) ?? readString(payload.provider) ?? readString(payload.model) ?? readString(payload.adapter);
+var readTraceStatus = (payload) => readString(payload.providerStatus) ?? readString(payload.status);
+var isFailingTraceStatus = (status) => status === "error" || status === "fail" || status === "failed" || status === "timeout";
+var summarizeProviderTraceEvidence = (events, maxProviderP95Ms) => {
+  const providerLatencies = new Map;
+  const providerMeta = new Map;
+  for (const event of events) {
+    if (event.type !== "session.error" && event.type !== "provider.decision") {
+      continue;
+    }
+    const payload = readTraceRecord(event);
+    const provider = readProviderTraceId(payload);
+    if (!provider) {
+      continue;
+    }
+    const role = readProviderTraceRole(payload);
+    const id = `${role}:${provider}`;
+    const latency = readProviderTraceLatency(payload);
+    if (latency !== undefined) {
+      providerLatencies.set(id, [...providerLatencies.get(id) ?? [], latency]);
+    }
+    const existing = providerMeta.get(id);
+    providerMeta.set(id, {
+      failed: existing?.failed === true || isFailingTraceStatus(readTraceStatus(payload)),
+      label: existing?.label ?? `${role.toUpperCase()} ${provider}`,
+      role: existing?.role ?? role
+    });
+  }
+  return [...providerMeta.entries()].map(([id, meta]) => {
+    const latencies = providerLatencies.get(id) ?? [];
+    const p95Ms = percentile(latencies, 95);
+    return {
+      averageMs: averageNumber(latencies),
+      id,
+      label: meta.label,
+      p50Ms: percentile(latencies, 50),
+      p95Ms,
+      role: meta.role,
+      samples: latencies.length,
+      status: meta.failed || (p95Ms ?? 0) > (maxProviderP95Ms ?? Number.POSITIVE_INFINITY) ? "fail" : latencies.length > 0 ? "pass" : "warn"
+    };
+  });
+};
+var summarizeTurnTraceP95 = (events) => {
+  const explicit = events.filter((event) => event.type === "turn_latency.stage").map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.totalMs) ?? readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs);
+  }).filter((value) => value !== undefined);
+  if (explicit.length > 0) {
+    return percentile(explicit, 95);
+  }
+  const turnStages = new Map;
+  for (const event of events) {
+    if (event.type !== "turn_latency.stage" || !event.turnId) {
+      continue;
+    }
+    const key = `${event.sessionId}:${event.turnId}`;
+    turnStages.set(key, [...turnStages.get(key) ?? [], event.at]);
+  }
+  const totals = [...turnStages.values()].map((stages) => stages.length < 2 ? undefined : Math.max(...stages) - Math.min(...stages)).filter((value) => value !== undefined);
+  return percentile(totals, 95);
+};
+var summarizeRuntimeChannelTraceEvidence = (events) => {
+  const runtimeEvents = events.filter((event) => event.type === "client.browser_media" || event.type === "client.telephony_media" || event.type === "client.barge_in");
+  if (runtimeEvents.length === 0) {
+    return;
+  }
+  const firstAudio = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).firstAudioLatencyMs)).filter((value) => value !== undefined);
+  const jitter = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).jitterMs)).filter((value) => value !== undefined);
+  const timestampDrift = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).timestampDriftMs)).filter((value) => value !== undefined);
+  const backpressure = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).backpressureEvents)).filter((value) => value !== undefined);
+  const interruptions = runtimeEvents.map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.interruptionLatencyMs) ?? readNumber2(payload.interruptionMs) ?? readNumber2(payload.elapsedMs);
+  }).filter((value) => value !== undefined);
+  return {
+    maxBackpressureEvents: maxNumber(backpressure),
+    maxFirstAudioLatencyMs: maxNumber(firstAudio),
+    maxInterruptionP95Ms: percentile(interruptions, 95),
+    maxJitterMs: maxNumber(jitter),
+    maxTimestampDriftMs: maxNumber(timestampDrift),
+    samples: runtimeEvents.length,
+    status: runtimeEvents.some((event) => isFailingTraceStatus(readTraceStatus(readTraceRecord(event)))) ? "fail" : "pass"
+  };
+};
+var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) => {
+  const sessionFilter = new Set(options.sessionIds ?? []);
+  const eventsBySession = new Map;
+  for (const event of events) {
+    if (sessionFilter.size > 0 && !sessionFilter.has(event.sessionId)) {
+      continue;
+    }
+    eventsBySession.set(event.sessionId, [
+      ...eventsBySession.get(event.sessionId) ?? [],
+      event
+    ]);
+  }
+  return [...eventsBySession.entries()].map(([
+    sessionId,
+    sessionEvents
+  ]) => {
+    const profileId = readTraceProfileId(sessionEvents, options);
+    if (!profileId) {
+      return;
+    }
+    const providers = summarizeProviderTraceEvidence(sessionEvents, options.maxProviderP95Ms);
+    const liveLatencies = sessionEvents.filter((event) => event.type === "client.live_latency").map((event) => {
+      const payload = readTraceRecord(event);
+      return readNumber2(payload.latencyMs) ?? readNumber2(payload.elapsedMs);
+    }).filter((value) => value !== undefined);
+    const turnP95Ms = summarizeTurnTraceP95(sessionEvents);
+    const providerP95Ms = maxNumber(providers.map((provider) => provider.p95Ms));
+    const runtimeChannel = summarizeRuntimeChannelTraceEvidence(sessionEvents);
+    return {
+      generatedAt: new Date(Math.max(...sessionEvents.map((event) => event.at))).toISOString(),
+      liveP95Ms: percentile(liveLatencies, 95),
+      ok: providers.every((provider) => provider.status !== "fail") && (runtimeChannel?.status ?? "pass") !== "fail",
+      operationsRecordHref: `/voice-operations/${sessionId}`,
+      profileDescription: options.profileDescriptions?.[profileId],
+      profileId,
+      profileLabel: options.profileLabels?.[profileId] ?? (profileId === options.defaultProfileId ? options.defaultProfileLabel : undefined),
+      providerP95Ms,
+      providers,
+      runtimeChannel,
+      sessionId,
+      turnP95Ms
+    };
+  }).filter((evidence) => evidence !== undefined);
+};
+var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {

package/dist/index.d.ts

@@ -30,12 +30,12 @@ export { assertVoicePlatformCoverage, buildVoicePlatformCoverageSummary, createV
 export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, createVoiceCompetitiveCoverageRoutes, evaluateVoiceCompetitiveCoverage, renderVoiceCompetitiveCoverageHTML, renderVoiceCompetitiveCoverageMarkdown } from './competitiveCoverage';
 export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAssertionReport, VoiceCompetitiveCoverageIssue, VoiceCompetitiveCoverageLevel, VoiceCompetitiveCoverageReport, VoiceCompetitiveCoverageReportInput, VoiceCompetitiveCoverageRoutesOptions, VoiceCompetitiveCoverageStatus, VoiceCompetitiveCoverageSummary, VoiceCompetitiveDepthLevel, VoiceCompetitiveEvidence, VoiceCompetitiveSurface } from './competitiveCoverage';
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
-export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
+export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
 export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, VoiceProfileSwitchLiveDecisionEvidence, VoiceProfileSwitchLiveDecisionReport, VoiceProfileSwitchLiveDecisionReportOptions, VoiceProfileSwitchLiveDecisionRoutesOptions, VoiceProfileSwitchLiveDecisionSession, VoiceProfileSwitchPolicyProofCase, VoiceProfileSwitchPolicyProofCaseResult, VoiceProfileSwitchPolicyProofOptions, VoiceProfileSwitchPolicyProofReport, VoiceProfileSwitchPolicyProofRoutesOptions, VoiceProfileSwitchReadinessIssue, VoiceProfileSwitchReadinessOptions, VoiceProfileSwitchReadinessReport, VoiceProfileSwitchReadinessRoutesOptions, VoiceProfileSwitchReadinessStatus, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
 export { buildVoiceProviderDecisionTraceReport, createVoiceProviderDecisionTraceEvent, createVoiceProviderDecisionTraceRoutes, listVoiceProviderDecisionTraces, renderVoiceProviderDecisionTraceHTML, renderVoiceProviderDecisionTraceMarkdown } from './providerDecisionTraces';
 export type { VoiceProviderDecisionStatus, VoiceProviderDecisionSurfaceReport, VoiceProviderDecisionTrace, VoiceProviderDecisionTraceInput, VoiceProviderDecisionTraceIssue, VoiceProviderDecisionTraceReport, VoiceProviderDecisionTraceReportOptions, VoiceProviderDecisionTraceRoutesOptions } from './providerDecisionTraces';
-export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions } from './proofTrends';
+export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions, VoiceRealCallProfileTraceEvidenceOptions, VoiceRealCallProfileTraceStoreEvidenceOptions } from './proofTrends';
 export { assertVoiceSloCalibration, buildVoiceSloCalibrationReport, buildVoiceSloReadinessThresholdReport, createVoiceSloReadinessThresholdOptions, createVoiceSloReadinessThresholdRoutes, createVoiceSloThresholdProfile, createVoiceSloCalibrationRoutes, renderVoiceSloCalibrationMarkdown, renderVoiceSloReadinessThresholdHTML, renderVoiceSloReadinessThresholdMarkdown } from './sloCalibration';
 export type { VoiceSloCalibrationMetricKey, VoiceSloCalibrationOptions, VoiceSloCalibrationReport, VoiceSloCalibrationRoutesOptions, VoiceSloCalibrationSample, VoiceSloCalibrationStatus, VoiceSloCalibrationThreshold, VoiceSloCalibrationThresholds, VoiceSloReadinessThresholdReport, VoiceSloReadinessThresholdReportOptions, VoiceSloReadinessThresholdOptions, VoiceSloReadinessThresholdRoutesOptions, VoiceSloThresholdProfile } from './sloCalibration';
 export { assertVoiceLiveOpsControlEvidence, assertVoiceLiveOpsEvidence, buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, evaluateVoiceLiveOpsControlEvidence, evaluateVoiceLiveOpsEvidence, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';

package/dist/index.js

@@ -15445,6 +15445,20 @@ var maxNumber = (values) => {
   const finite = values.filter((value) => typeof value === "number" && Number.isFinite(value));
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
+var percentile2 = (values, rank) => {
+  const finite = values.filter((value) => Number.isFinite(value)).sort((left, right) => left - right);
+  if (finite.length === 0) {
+    return;
+  }
+  const index = Math.min(finite.length - 1, Math.max(0, Math.ceil(rank / 100 * finite.length) - 1));
+  return finite[index];
+};
+var averageNumber = (values) => {
+  const finite = values.filter((value) => Number.isFinite(value));
+  return finite.length === 0 ? undefined : Math.round(finite.reduce((total, value) => total + value, 0) / finite.length);
+};
+var readString2 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var readNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
 var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
@@ -15508,6 +15522,149 @@ var aggregateProofTrendRuntimeChannel = (channels) => {
     status: channels.some((channel) => channel.status === "fail") ? "fail" : channels.some((channel) => channel.status === "warn") ? "warn" : channels.every((channel) => channel.status === "pass") ? "pass" : undefined
   };
 };
+var readTraceRecord = (event) => event.payload;
+var readTraceProfileId = (events, options) => {
+  for (const event of events) {
+    const payload = readTraceRecord(event);
+    const profileId = readString2(payload.profileId) ?? readString2(event.metadata?.profileId) ?? readString2(payload.benchmarkProfileId) ?? readString2(event.metadata?.benchmarkProfileId);
+    if (profileId) {
+      return profileId;
+    }
+  }
+  return options.defaultProfileId;
+};
+var readProviderTraceRole = (payload) => readString2(payload.kind) ?? readString2(payload.role) ?? readString2(payload.surface) ?? "provider";
+var readProviderTraceLatency = (payload) => readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs) ?? readNumber2(payload.durationMs);
+var readProviderTraceId = (payload) => readString2(payload.selectedProvider) ?? readString2(payload.provider) ?? readString2(payload.model) ?? readString2(payload.adapter);
+var readTraceStatus = (payload) => readString2(payload.providerStatus) ?? readString2(payload.status);
+var isFailingTraceStatus = (status) => status === "error" || status === "fail" || status === "failed" || status === "timeout";
+var summarizeProviderTraceEvidence = (events, maxProviderP95Ms) => {
+  const providerLatencies = new Map;
+  const providerMeta = new Map;
+  for (const event of events) {
+    if (event.type !== "session.error" && event.type !== "provider.decision") {
+      continue;
+    }
+    const payload = readTraceRecord(event);
+    const provider = readProviderTraceId(payload);
+    if (!provider) {
+      continue;
+    }
+    const role = readProviderTraceRole(payload);
+    const id = `${role}:${provider}`;
+    const latency = readProviderTraceLatency(payload);
+    if (latency !== undefined) {
+      providerLatencies.set(id, [...providerLatencies.get(id) ?? [], latency]);
+    }
+    const existing = providerMeta.get(id);
+    providerMeta.set(id, {
+      failed: existing?.failed === true || isFailingTraceStatus(readTraceStatus(payload)),
+      label: existing?.label ?? `${role.toUpperCase()} ${provider}`,
+      role: existing?.role ?? role
+    });
+  }
+  return [...providerMeta.entries()].map(([id, meta]) => {
+    const latencies = providerLatencies.get(id) ?? [];
+    const p95Ms = percentile2(latencies, 95);
+    return {
+      averageMs: averageNumber(latencies),
+      id,
+      label: meta.label,
+      p50Ms: percentile2(latencies, 50),
+      p95Ms,
+      role: meta.role,
+      samples: latencies.length,
+      status: meta.failed || (p95Ms ?? 0) > (maxProviderP95Ms ?? Number.POSITIVE_INFINITY) ? "fail" : latencies.length > 0 ? "pass" : "warn"
+    };
+  });
+};
+var summarizeTurnTraceP95 = (events) => {
+  const explicit = events.filter((event) => event.type === "turn_latency.stage").map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.totalMs) ?? readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs);
+  }).filter((value) => value !== undefined);
+  if (explicit.length > 0) {
+    return percentile2(explicit, 95);
+  }
+  const turnStages = new Map;
+  for (const event of events) {
+    if (event.type !== "turn_latency.stage" || !event.turnId) {
+      continue;
+    }
+    const key = `${event.sessionId}:${event.turnId}`;
+    turnStages.set(key, [...turnStages.get(key) ?? [], event.at]);
+  }
+  const totals = [...turnStages.values()].map((stages) => stages.length < 2 ? undefined : Math.max(...stages) - Math.min(...stages)).filter((value) => value !== undefined);
+  return percentile2(totals, 95);
+};
+var summarizeRuntimeChannelTraceEvidence = (events) => {
+  const runtimeEvents = events.filter((event) => event.type === "client.browser_media" || event.type === "client.telephony_media" || event.type === "client.barge_in");
+  if (runtimeEvents.length === 0) {
+    return;
+  }
+  const firstAudio = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).firstAudioLatencyMs)).filter((value) => value !== undefined);
+  const jitter = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).jitterMs)).filter((value) => value !== undefined);
+  const timestampDrift = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).timestampDriftMs)).filter((value) => value !== undefined);
+  const backpressure = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).backpressureEvents)).filter((value) => value !== undefined);
+  const interruptions = runtimeEvents.map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.interruptionLatencyMs) ?? readNumber2(payload.interruptionMs) ?? readNumber2(payload.elapsedMs);
+  }).filter((value) => value !== undefined);
+  return {
+    maxBackpressureEvents: maxNumber(backpressure),
+    maxFirstAudioLatencyMs: maxNumber(firstAudio),
+    maxInterruptionP95Ms: percentile2(interruptions, 95),
+    maxJitterMs: maxNumber(jitter),
+    maxTimestampDriftMs: maxNumber(timestampDrift),
+    samples: runtimeEvents.length,
+    status: runtimeEvents.some((event) => isFailingTraceStatus(readTraceStatus(readTraceRecord(event)))) ? "fail" : "pass"
+  };
+};
+var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) => {
+  const sessionFilter = new Set(options.sessionIds ?? []);
+  const eventsBySession = new Map;
+  for (const event of events) {
+    if (sessionFilter.size > 0 && !sessionFilter.has(event.sessionId)) {
+      continue;
+    }
+    eventsBySession.set(event.sessionId, [
+      ...eventsBySession.get(event.sessionId) ?? [],
+      event
+    ]);
+  }
+  return [...eventsBySession.entries()].map(([
+    sessionId,
+    sessionEvents
+  ]) => {
+    const profileId = readTraceProfileId(sessionEvents, options);
+    if (!profileId) {
+      return;
+    }
+    const providers = summarizeProviderTraceEvidence(sessionEvents, options.maxProviderP95Ms);
+    const liveLatencies = sessionEvents.filter((event) => event.type === "client.live_latency").map((event) => {
+      const payload = readTraceRecord(event);
+      return readNumber2(payload.latencyMs) ?? readNumber2(payload.elapsedMs);
+    }).filter((value) => value !== undefined);
+    const turnP95Ms = summarizeTurnTraceP95(sessionEvents);
+    const providerP95Ms = maxNumber(providers.map((provider) => provider.p95Ms));
+    const runtimeChannel = summarizeRuntimeChannelTraceEvidence(sessionEvents);
+    return {
+      generatedAt: new Date(Math.max(...sessionEvents.map((event) => event.at))).toISOString(),
+      liveP95Ms: percentile2(liveLatencies, 95),
+      ok: providers.every((provider) => provider.status !== "fail") && (runtimeChannel?.status ?? "pass") !== "fail",
+      operationsRecordHref: `/voice-operations/${sessionId}`,
+      profileDescription: options.profileDescriptions?.[profileId],
+      profileId,
+      profileLabel: options.profileLabels?.[profileId] ?? (profileId === options.defaultProfileId ? options.defaultProfileLabel : undefined),
+      providerP95Ms,
+      providers,
+      runtimeChannel,
+      sessionId,
+      turnP95Ms
+    };
+  }).filter((evidence) => evidence !== undefined);
+};
+var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {
@@ -17189,7 +17346,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 percentile2 = (values, rank) => {
+var percentile3 = (values, rank) => {
   if (values.length === 0) {
     return;
   }
@@ -17213,7 +17370,7 @@ var normalizeSample = (input) => {
   return input;
 };
 var createThreshold = (metric, values, options) => {
-  const baselineP95Ms = percentile2(values, 95);
+  const baselineP95Ms = percentile3(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));
@@ -21729,7 +21886,7 @@ var createVoiceTurnLatencyRoutes = (options) => {
 // src/liveLatency.ts
 import { Elysia as Elysia37 } from "elysia";
 var escapeHtml38 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var percentile3 = (values, percentileValue) => {
+var percentile4 = (values, percentileValue) => {
   if (values.length === 0) {
     return;
   }
@@ -21765,8 +21922,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: percentile3(latencies, 50),
-    p95LatencyMs: percentile3(latencies, 95),
+    p50LatencyMs: percentile4(latencies, 50),
+    p95LatencyMs: percentile4(latencies, 95),
     recent,
     status: latencies.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
     total: latencies.length,
@@ -21842,7 +21999,7 @@ var TRACE_TYPES = [
 ];
 var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getString14 = (value) => typeof value === "string" && value.trim() ? value : undefined;
-var percentile4 = (values, percentileValue) => {
+var percentile5 = (values, percentileValue) => {
   if (values.length === 0) {
     return;
   }
@@ -22050,8 +22207,8 @@ var summarizeStage = (stage, measurements, options) => {
     label: STAGE_LABELS[stage],
     maxMs: latencies.length > 0 ? Math.max(...latencies) : undefined,
     measurements: stageMeasurements,
-    p50Ms: percentile4(latencies, 50),
-    p95Ms: percentile4(latencies, 95),
+    p50Ms: percentile5(latencies, 50),
+    p95Ms: percentile5(latencies, 95),
     stage,
     status: stageMeasurements.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
     total: stageMeasurements.length,
@@ -27869,7 +28026,7 @@ var rate3 = (count, total) => count / Math.max(1, total);
 var uniqueSorted7 = (values) => [
   ...new Set(values.filter((value) => typeof value === "string"))
 ].sort();
-var percentile5 = (values, rank) => {
+var percentile6 = (values, rank) => {
   if (values.length === 0) {
     return 0;
   }
@@ -27927,7 +28084,7 @@ var summarizeKind = (kind, events, thresholds, required) => {
       unit: "rate"
     }),
     p95ElapsedMs: createMetric2({
-      actual: percentile5(latencies, 95),
+      actual: percentile6(latencies, 95),
       label: "P95 latency",
       threshold: thresholds.maxP95ElapsedMs,
       unit: "ms"
@@ -38256,6 +38413,7 @@ export {
   muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
+  loadVoiceRealCallProfileEvidenceFromTraceStore,
   loadVoiceObservabilityExportReplaySource,
   listVoiceRoutingEvents,
   listVoiceProviderDecisionTraces,
@@ -38634,6 +38792,7 @@ export {
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
   buildVoiceRealCallProfileHistoryReport,
+  buildVoiceRealCallProfileEvidenceFromTraceEvents,
   buildVoiceRealCallProfileDefaults,
   buildVoiceProviderSloReport,
   buildVoiceProviderOrchestrationReport,

package/dist/proofTrends.d.ts

@@ -1,4 +1,5 @@
 import { Elysia } from 'elysia';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
 export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
 export type VoiceProofTrendSummary = {
     cycles?: number;
@@ -134,6 +135,18 @@ export type VoiceProofTrendRealCallProfileEvidence = {
     sessionId: string;
     turnP95Ms?: number;
 };
+export type VoiceRealCallProfileTraceEvidenceOptions = {
+    defaultProfileId?: string;
+    defaultProfileLabel?: string;
+    maxProviderP95Ms?: number;
+    profileDescriptions?: Record<string, string>;
+    profileLabels?: Record<string, string>;
+    sessionIds?: readonly string[];
+};
+export type VoiceRealCallProfileTraceStoreEvidenceOptions = VoiceRealCallProfileTraceEvidenceOptions & {
+    limit?: number;
+    store: VoiceTraceEventStore;
+};
 export type VoiceProofTrendRealCallProfileReportOptions = VoiceProofTrendProfileSummaryOptions & {
     baseUrl?: string;
     evidence: readonly VoiceProofTrendRealCallProfileEvidence[];
@@ -370,6 +383,8 @@ export declare const normalizeVoiceProofTrendReport: (value: VoiceProofTrendRepo
 export declare const readVoiceProofTrendReportFile: (path: string, options?: {
     maxAgeMs?: number;
 }) => Promise<VoiceProofTrendReport>;
+export declare const buildVoiceRealCallProfileEvidenceFromTraceEvents: (events: readonly StoredVoiceTraceEvent[], options?: VoiceRealCallProfileTraceEvidenceOptions) => VoiceProofTrendRealCallProfileEvidence[];
+export declare const loadVoiceRealCallProfileEvidenceFromTraceStore: (options: VoiceRealCallProfileTraceStoreEvidenceOptions) => Promise<VoiceProofTrendRealCallProfileEvidence[]>;
 export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTrendReport | readonly VoiceProofTrendReport[], options?: VoiceProofTrendProfileSummaryOptions) => VoiceProofTrendProfileSummary[];
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
 export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;

package/dist/react/index.js

@@ -1603,6 +1603,20 @@ var maxNumber = (values) => {
   const finite = values.filter((value) => typeof value === "number" && Number.isFinite(value));
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
+var percentile = (values, rank) => {
+  const finite = values.filter((value) => Number.isFinite(value)).sort((left, right) => left - right);
+  if (finite.length === 0) {
+    return;
+  }
+  const index = Math.min(finite.length - 1, Math.max(0, Math.ceil(rank / 100 * finite.length) - 1));
+  return finite[index];
+};
+var averageNumber = (values) => {
+  const finite = values.filter((value) => Number.isFinite(value));
+  return finite.length === 0 ? undefined : Math.round(finite.reduce((total, value) => total + value, 0) / finite.length);
+};
+var readString = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var readNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
 var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
@@ -1666,6 +1680,149 @@ var aggregateProofTrendRuntimeChannel = (channels) => {
     status: channels.some((channel) => channel.status === "fail") ? "fail" : channels.some((channel) => channel.status === "warn") ? "warn" : channels.every((channel) => channel.status === "pass") ? "pass" : undefined
   };
 };
+var readTraceRecord = (event) => event.payload;
+var readTraceProfileId = (events, options) => {
+  for (const event of events) {
+    const payload = readTraceRecord(event);
+    const profileId = readString(payload.profileId) ?? readString(event.metadata?.profileId) ?? readString(payload.benchmarkProfileId) ?? readString(event.metadata?.benchmarkProfileId);
+    if (profileId) {
+      return profileId;
+    }
+  }
+  return options.defaultProfileId;
+};
+var readProviderTraceRole = (payload) => readString(payload.kind) ?? readString(payload.role) ?? readString(payload.surface) ?? "provider";
+var readProviderTraceLatency = (payload) => readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs) ?? readNumber2(payload.durationMs);
+var readProviderTraceId = (payload) => readString(payload.selectedProvider) ?? readString(payload.provider) ?? readString(payload.model) ?? readString(payload.adapter);
+var readTraceStatus = (payload) => readString(payload.providerStatus) ?? readString(payload.status);
+var isFailingTraceStatus = (status) => status === "error" || status === "fail" || status === "failed" || status === "timeout";
+var summarizeProviderTraceEvidence = (events, maxProviderP95Ms) => {
+  const providerLatencies = new Map;
+  const providerMeta = new Map;
+  for (const event of events) {
+    if (event.type !== "session.error" && event.type !== "provider.decision") {
+      continue;
+    }
+    const payload = readTraceRecord(event);
+    const provider = readProviderTraceId(payload);
+    if (!provider) {
+      continue;
+    }
+    const role = readProviderTraceRole(payload);
+    const id = `${role}:${provider}`;
+    const latency = readProviderTraceLatency(payload);
+    if (latency !== undefined) {
+      providerLatencies.set(id, [...providerLatencies.get(id) ?? [], latency]);
+    }
+    const existing = providerMeta.get(id);
+    providerMeta.set(id, {
+      failed: existing?.failed === true || isFailingTraceStatus(readTraceStatus(payload)),
+      label: existing?.label ?? `${role.toUpperCase()} ${provider}`,
+      role: existing?.role ?? role
+    });
+  }
+  return [...providerMeta.entries()].map(([id, meta]) => {
+    const latencies = providerLatencies.get(id) ?? [];
+    const p95Ms = percentile(latencies, 95);
+    return {
+      averageMs: averageNumber(latencies),
+      id,
+      label: meta.label,
+      p50Ms: percentile(latencies, 50),
+      p95Ms,
+      role: meta.role,
+      samples: latencies.length,
+      status: meta.failed || (p95Ms ?? 0) > (maxProviderP95Ms ?? Number.POSITIVE_INFINITY) ? "fail" : latencies.length > 0 ? "pass" : "warn"
+    };
+  });
+};
+var summarizeTurnTraceP95 = (events) => {
+  const explicit = events.filter((event) => event.type === "turn_latency.stage").map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.totalMs) ?? readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs);
+  }).filter((value) => value !== undefined);
+  if (explicit.length > 0) {
+    return percentile(explicit, 95);
+  }
+  const turnStages = new Map;
+  for (const event of events) {
+    if (event.type !== "turn_latency.stage" || !event.turnId) {
+      continue;
+    }
+    const key = `${event.sessionId}:${event.turnId}`;
+    turnStages.set(key, [...turnStages.get(key) ?? [], event.at]);
+  }
+  const totals = [...turnStages.values()].map((stages) => stages.length < 2 ? undefined : Math.max(...stages) - Math.min(...stages)).filter((value) => value !== undefined);
+  return percentile(totals, 95);
+};
+var summarizeRuntimeChannelTraceEvidence = (events) => {
+  const runtimeEvents = events.filter((event) => event.type === "client.browser_media" || event.type === "client.telephony_media" || event.type === "client.barge_in");
+  if (runtimeEvents.length === 0) {
+    return;
+  }
+  const firstAudio = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).firstAudioLatencyMs)).filter((value) => value !== undefined);
+  const jitter = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).jitterMs)).filter((value) => value !== undefined);
+  const timestampDrift = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).timestampDriftMs)).filter((value) => value !== undefined);
+  const backpressure = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).backpressureEvents)).filter((value) => value !== undefined);
+  const interruptions = runtimeEvents.map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.interruptionLatencyMs) ?? readNumber2(payload.interruptionMs) ?? readNumber2(payload.elapsedMs);
+  }).filter((value) => value !== undefined);
+  return {
+    maxBackpressureEvents: maxNumber(backpressure),
+    maxFirstAudioLatencyMs: maxNumber(firstAudio),
+    maxInterruptionP95Ms: percentile(interruptions, 95),
+    maxJitterMs: maxNumber(jitter),
+    maxTimestampDriftMs: maxNumber(timestampDrift),
+    samples: runtimeEvents.length,
+    status: runtimeEvents.some((event) => isFailingTraceStatus(readTraceStatus(readTraceRecord(event)))) ? "fail" : "pass"
+  };
+};
+var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) => {
+  const sessionFilter = new Set(options.sessionIds ?? []);
+  const eventsBySession = new Map;
+  for (const event of events) {
+    if (sessionFilter.size > 0 && !sessionFilter.has(event.sessionId)) {
+      continue;
+    }
+    eventsBySession.set(event.sessionId, [
+      ...eventsBySession.get(event.sessionId) ?? [],
+      event
+    ]);
+  }
+  return [...eventsBySession.entries()].map(([
+    sessionId,
+    sessionEvents
+  ]) => {
+    const profileId = readTraceProfileId(sessionEvents, options);
+    if (!profileId) {
+      return;
+    }
+    const providers = summarizeProviderTraceEvidence(sessionEvents, options.maxProviderP95Ms);
+    const liveLatencies = sessionEvents.filter((event) => event.type === "client.live_latency").map((event) => {
+      const payload = readTraceRecord(event);
+      return readNumber2(payload.latencyMs) ?? readNumber2(payload.elapsedMs);
+    }).filter((value) => value !== undefined);
+    const turnP95Ms = summarizeTurnTraceP95(sessionEvents);
+    const providerP95Ms = maxNumber(providers.map((provider) => provider.p95Ms));
+    const runtimeChannel = summarizeRuntimeChannelTraceEvidence(sessionEvents);
+    return {
+      generatedAt: new Date(Math.max(...sessionEvents.map((event) => event.at))).toISOString(),
+      liveP95Ms: percentile(liveLatencies, 95),
+      ok: providers.every((provider) => provider.status !== "fail") && (runtimeChannel?.status ?? "pass") !== "fail",
+      operationsRecordHref: `/voice-operations/${sessionId}`,
+      profileDescription: options.profileDescriptions?.[profileId],
+      profileId,
+      profileLabel: options.profileLabels?.[profileId] ?? (profileId === options.defaultProfileId ? options.defaultProfileLabel : undefined),
+      providerP95Ms,
+      providers,
+      runtimeChannel,
+      sessionId,
+      turnP95Ms
+    };
+  }).filter((evidence) => evidence !== undefined);
+};
+var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {

package/dist/vue/index.js

@@ -1524,6 +1524,20 @@ var maxNumber = (values) => {
   const finite = values.filter((value) => typeof value === "number" && Number.isFinite(value));
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
+var percentile = (values, rank) => {
+  const finite = values.filter((value) => Number.isFinite(value)).sort((left, right) => left - right);
+  if (finite.length === 0) {
+    return;
+  }
+  const index = Math.min(finite.length - 1, Math.max(0, Math.ceil(rank / 100 * finite.length) - 1));
+  return finite[index];
+};
+var averageNumber = (values) => {
+  const finite = values.filter((value) => Number.isFinite(value));
+  return finite.length === 0 ? undefined : Math.round(finite.reduce((total, value) => total + value, 0) / finite.length);
+};
+var readString = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var readNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
 var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
@@ -1587,6 +1601,149 @@ var aggregateProofTrendRuntimeChannel = (channels) => {
     status: channels.some((channel) => channel.status === "fail") ? "fail" : channels.some((channel) => channel.status === "warn") ? "warn" : channels.every((channel) => channel.status === "pass") ? "pass" : undefined
   };
 };
+var readTraceRecord = (event) => event.payload;
+var readTraceProfileId = (events, options) => {
+  for (const event of events) {
+    const payload = readTraceRecord(event);
+    const profileId = readString(payload.profileId) ?? readString(event.metadata?.profileId) ?? readString(payload.benchmarkProfileId) ?? readString(event.metadata?.benchmarkProfileId);
+    if (profileId) {
+      return profileId;
+    }
+  }
+  return options.defaultProfileId;
+};
+var readProviderTraceRole = (payload) => readString(payload.kind) ?? readString(payload.role) ?? readString(payload.surface) ?? "provider";
+var readProviderTraceLatency = (payload) => readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs) ?? readNumber2(payload.durationMs);
+var readProviderTraceId = (payload) => readString(payload.selectedProvider) ?? readString(payload.provider) ?? readString(payload.model) ?? readString(payload.adapter);
+var readTraceStatus = (payload) => readString(payload.providerStatus) ?? readString(payload.status);
+var isFailingTraceStatus = (status) => status === "error" || status === "fail" || status === "failed" || status === "timeout";
+var summarizeProviderTraceEvidence = (events, maxProviderP95Ms) => {
+  const providerLatencies = new Map;
+  const providerMeta = new Map;
+  for (const event of events) {
+    if (event.type !== "session.error" && event.type !== "provider.decision") {
+      continue;
+    }
+    const payload = readTraceRecord(event);
+    const provider = readProviderTraceId(payload);
+    if (!provider) {
+      continue;
+    }
+    const role = readProviderTraceRole(payload);
+    const id = `${role}:${provider}`;
+    const latency = readProviderTraceLatency(payload);
+    if (latency !== undefined) {
+      providerLatencies.set(id, [...providerLatencies.get(id) ?? [], latency]);
+    }
+    const existing = providerMeta.get(id);
+    providerMeta.set(id, {
+      failed: existing?.failed === true || isFailingTraceStatus(readTraceStatus(payload)),
+      label: existing?.label ?? `${role.toUpperCase()} ${provider}`,
+      role: existing?.role ?? role
+    });
+  }
+  return [...providerMeta.entries()].map(([id, meta]) => {
+    const latencies = providerLatencies.get(id) ?? [];
+    const p95Ms = percentile(latencies, 95);
+    return {
+      averageMs: averageNumber(latencies),
+      id,
+      label: meta.label,
+      p50Ms: percentile(latencies, 50),
+      p95Ms,
+      role: meta.role,
+      samples: latencies.length,
+      status: meta.failed || (p95Ms ?? 0) > (maxProviderP95Ms ?? Number.POSITIVE_INFINITY) ? "fail" : latencies.length > 0 ? "pass" : "warn"
+    };
+  });
+};
+var summarizeTurnTraceP95 = (events) => {
+  const explicit = events.filter((event) => event.type === "turn_latency.stage").map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.totalMs) ?? readNumber2(payload.elapsedMs) ?? readNumber2(payload.latencyMs);
+  }).filter((value) => value !== undefined);
+  if (explicit.length > 0) {
+    return percentile(explicit, 95);
+  }
+  const turnStages = new Map;
+  for (const event of events) {
+    if (event.type !== "turn_latency.stage" || !event.turnId) {
+      continue;
+    }
+    const key = `${event.sessionId}:${event.turnId}`;
+    turnStages.set(key, [...turnStages.get(key) ?? [], event.at]);
+  }
+  const totals = [...turnStages.values()].map((stages) => stages.length < 2 ? undefined : Math.max(...stages) - Math.min(...stages)).filter((value) => value !== undefined);
+  return percentile(totals, 95);
+};
+var summarizeRuntimeChannelTraceEvidence = (events) => {
+  const runtimeEvents = events.filter((event) => event.type === "client.browser_media" || event.type === "client.telephony_media" || event.type === "client.barge_in");
+  if (runtimeEvents.length === 0) {
+    return;
+  }
+  const firstAudio = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).firstAudioLatencyMs)).filter((value) => value !== undefined);
+  const jitter = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).jitterMs)).filter((value) => value !== undefined);
+  const timestampDrift = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).timestampDriftMs)).filter((value) => value !== undefined);
+  const backpressure = runtimeEvents.map((event) => readNumber2(readTraceRecord(event).backpressureEvents)).filter((value) => value !== undefined);
+  const interruptions = runtimeEvents.map((event) => {
+    const payload = readTraceRecord(event);
+    return readNumber2(payload.interruptionLatencyMs) ?? readNumber2(payload.interruptionMs) ?? readNumber2(payload.elapsedMs);
+  }).filter((value) => value !== undefined);
+  return {
+    maxBackpressureEvents: maxNumber(backpressure),
+    maxFirstAudioLatencyMs: maxNumber(firstAudio),
+    maxInterruptionP95Ms: percentile(interruptions, 95),
+    maxJitterMs: maxNumber(jitter),
+    maxTimestampDriftMs: maxNumber(timestampDrift),
+    samples: runtimeEvents.length,
+    status: runtimeEvents.some((event) => isFailingTraceStatus(readTraceStatus(readTraceRecord(event)))) ? "fail" : "pass"
+  };
+};
+var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) => {
+  const sessionFilter = new Set(options.sessionIds ?? []);
+  const eventsBySession = new Map;
+  for (const event of events) {
+    if (sessionFilter.size > 0 && !sessionFilter.has(event.sessionId)) {
+      continue;
+    }
+    eventsBySession.set(event.sessionId, [
+      ...eventsBySession.get(event.sessionId) ?? [],
+      event
+    ]);
+  }
+  return [...eventsBySession.entries()].map(([
+    sessionId,
+    sessionEvents
+  ]) => {
+    const profileId = readTraceProfileId(sessionEvents, options);
+    if (!profileId) {
+      return;
+    }
+    const providers = summarizeProviderTraceEvidence(sessionEvents, options.maxProviderP95Ms);
+    const liveLatencies = sessionEvents.filter((event) => event.type === "client.live_latency").map((event) => {
+      const payload = readTraceRecord(event);
+      return readNumber2(payload.latencyMs) ?? readNumber2(payload.elapsedMs);
+    }).filter((value) => value !== undefined);
+    const turnP95Ms = summarizeTurnTraceP95(sessionEvents);
+    const providerP95Ms = maxNumber(providers.map((provider) => provider.p95Ms));
+    const runtimeChannel = summarizeRuntimeChannelTraceEvidence(sessionEvents);
+    return {
+      generatedAt: new Date(Math.max(...sessionEvents.map((event) => event.at))).toISOString(),
+      liveP95Ms: percentile(liveLatencies, 95),
+      ok: providers.every((provider) => provider.status !== "fail") && (runtimeChannel?.status ?? "pass") !== "fail",
+      operationsRecordHref: `/voice-operations/${sessionId}`,
+      profileDescription: options.profileDescriptions?.[profileId],
+      profileId,
+      profileLabel: options.profileLabels?.[profileId] ?? (profileId === options.defaultProfileId ? options.defaultProfileLabel : undefined),
+      providerP95Ms,
+      providers,
+      runtimeChannel,
+      sessionId,
+      turnP95Ms
+    };
+  }).filter((evidence) => evidence !== undefined);
+};
+var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {

package/package.json

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