@absolutejs/voice 0.0.22-beta.396 → 0.0.22-beta.397

package/dist/index.d.ts

@@ -32,7 +32,9 @@ export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAs
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
 export { assertVoiceProofTrendEvidence, appendVoiceRealCallProfileRecoveryEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, runVoiceRealCallProfileRecoveryLoop, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { createVoiceEvidenceAssertion, createVoiceProofAssertion, summarizeVoiceProofAssertions } from './proofAssertions';
+export { buildVoiceSessionSnapshot, buildVoiceSessionSnapshotStatus, parseVoiceSessionSnapshot } from './sessionSnapshot';
 export type { VoiceEvidenceAssertionInput, VoiceProofAssertionInput, VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
+export type { VoiceSessionSnapshot, VoiceSessionSnapshotInput, VoiceSessionSnapshotQualityEvidence, VoiceSessionSnapshotStatus } from './sessionSnapshot';
 export { fetchVoiceProofTarget, getVoiceProofTargetLogicalFailure, mapVoiceProofTargetsWithConcurrency, runVoiceCommandProofTarget, runVoiceCommandProofTargets, runVoiceProofTargets } from './proofRunner';
 export type { VoiceCommandProofExecutionResult, VoiceCommandProofTarget, VoiceCommandProofTargetResult, VoiceCommandProofTargetRunnerOptions, VoiceCommandProofTargetRunOptions, VoiceProofTarget, VoiceProofTargetMethod, VoiceProofTargetResult, VoiceProofTargetRunnerOptions, VoiceProofTargetRunOptions } from './proofRunner';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';

package/dist/index.js

@@ -18385,6 +18385,73 @@ var summarizeVoiceProofAssertions = (assertions) => {
     total: assertions.length
   };
 };
+// src/sessionSnapshot.ts
+var statusRank4 = (status) => {
+  if (status === "fail") {
+    return 2;
+  }
+  if (status === "warn") {
+    return 1;
+  }
+  return 0;
+};
+var maxStatus = (statuses) => statuses.reduce((current, status) => statusRank4(status) > statusRank4(current) ? status : current, "pass");
+var buildVoiceSessionSnapshotStatus = (input) => {
+  const statuses = [];
+  for (const media of input.media ?? []) {
+    statuses.push(media.report.status);
+  }
+  for (const quality of input.quality ?? []) {
+    if (quality.status !== undefined) {
+      statuses.push(quality.status);
+    }
+  }
+  for (const outcome of input.telephonyOutcomes ?? []) {
+    if (outcome.campaignOutcome.status === "failed") {
+      statuses.push("fail");
+    } else if (outcome.duplicate === true || !outcome.campaignOutcome.applied) {
+      statuses.push("warn");
+    }
+  }
+  if (input.proofSummary?.ok === false) {
+    statuses.push("fail");
+  }
+  return maxStatus(statuses);
+};
+var buildVoiceSessionSnapshot = (input) => {
+  const proofAssertions = [...input.proofAssertions ?? []];
+  const proofSummary = summarizeVoiceProofAssertions(proofAssertions);
+  const media = [...input.media ?? []];
+  const providerRoutingEvents = [...input.providerRoutingEvents ?? []];
+  const quality = [...input.quality ?? []];
+  const telephonyOutcomes = [...input.telephonyOutcomes ?? []];
+  return {
+    capturedAt: Date.now(),
+    media,
+    name: input.name,
+    proofAssertions,
+    proofSummary,
+    providerRoutingEvents,
+    quality,
+    scenarioId: input.scenarioId,
+    schema: "absolute.voice.session.snapshot.v1",
+    sessionId: input.sessionId,
+    status: buildVoiceSessionSnapshotStatus({
+      media,
+      proofSummary,
+      quality,
+      telephonyOutcomes
+    }),
+    telephonyOutcomes,
+    turnId: input.turnId
+  };
+};
+var parseVoiceSessionSnapshot = (snapshot) => {
+  if (snapshot.schema !== "absolute.voice.session.snapshot.v1") {
+    throw new Error("Unsupported voice session snapshot schema.");
+  }
+  return snapshot;
+};
 // src/proofRunner.ts
 var encoder = new TextEncoder;
 var trimBaseUrl = (baseUrl) => baseUrl.replace(/\/$/, "");
@@ -28937,7 +29004,7 @@ var defaultRequirement = {
   requireFallback: false,
   requireTimeoutBudget: false
 };
-var statusRank4 = {
+var statusRank5 = {
   pass: 0,
   warn: 1,
   fail: 2
@@ -28953,7 +29020,7 @@ var surfaceProviderNames = (surface) => uniqueSorted6([
   ...isProviderList(surface.fallback) ? surface.fallback : [],
   ...isProviderList(surface.allowProviders) ? surface.allowProviders : []
 ]);
-var surfaceStatus = (issues) => issues.reduce((status, issue) => statusRank4[issue.status] > statusRank4[status] ? issue.status : status, "pass");
+var surfaceStatus = (issues) => issues.reduce((status, issue) => statusRank5[issue.status] > statusRank5[status] ? issue.status : status, "pass");
 var resolvedRequirement = (surface, options) => ({
   ...defaultRequirement,
   ...options.defaultRequirement ?? {},
@@ -29304,7 +29371,7 @@ var defaultThresholds = {
   }
 };
 var providerKinds = ["llm", "stt", "tts"];
-var statusRank5 = {
+var statusRank6 = {
   pass: 0,
   warn: 1,
   fail: 2
@@ -29500,9 +29567,9 @@ var evaluateVoiceProviderSloEvidence = (report, input = {}) => {
   const fallbacks = kindReports.reduce((total, kind) => total + kind.fallbacks, 0);
   const timeouts = kindReports.reduce((total, kind) => total + kind.timeouts, 0);
   const unresolvedErrors = kindReports.reduce((total, kind) => total + kind.unresolvedErrors, 0);
-  const maxStatus = input.maxStatus ?? "pass";
-  if (statusRank5[report.status] > statusRank5[maxStatus]) {
-    issues.push(`Expected provider SLO status at most ${maxStatus}, found ${report.status}.`);
+  const maxStatus2 = input.maxStatus ?? "pass";
+  if (statusRank6[report.status] > statusRank6[maxStatus2]) {
+    issues.push(`Expected provider SLO status at most ${maxStatus2}, found ${report.status}.`);
   }
   if (input.minEvents !== undefined && report.events < input.minEvents) {
     issues.push(`Expected at least ${String(input.minEvents)} provider routing events, found ${String(report.events)}.`);
@@ -36100,12 +36167,12 @@ var recommendVoiceProviderStack = (input) => {
   };
 };
 var rollupContractStatus = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
-var statusRank6 = {
+var statusRank7 = {
   pass: 0,
   warn: 1,
   fail: 2
 };
-var statusExceeds2 = (actual, max2) => statusRank6[actual] > statusRank6[max2];
+var statusExceeds2 = (actual, max2) => statusRank7[actual] > statusRank7[max2];
 var buildVoiceProviderContractMatrix = (input) => {
   const rows = input.contracts.map((contract) => {
     const configured = contract.configured !== false;
@@ -36208,7 +36275,7 @@ var buildVoiceProviderContractMatrix = (input) => {
 };
 var evaluateVoiceProviderContractMatrixEvidence = (report, input = {}) => {
   const issues = [];
-  const maxStatus = input.maxStatus ?? "pass";
+  const maxStatus2 = input.maxStatus ?? "pass";
   const maxFailed = input.maxFailed ?? 0;
   const maxWarned = input.maxWarned ?? 0;
   const minRows = input.minRows ?? 1;
@@ -36218,8 +36285,8 @@ var evaluateVoiceProviderContractMatrixEvidence = (report, input = {}) => {
   const selectedKinds = [
     ...new Set(report.rows.filter((row) => row.selected).map((row) => row.kind))
   ].sort();
-  if (statusExceeds2(report.status, maxStatus)) {
-    issues.push(`Expected provider contract matrix status at most ${maxStatus}, found ${report.status}.`);
+  if (statusExceeds2(report.status, maxStatus2)) {
+    issues.push(`Expected provider contract matrix status at most ${maxStatus2}, found ${report.status}.`);
   }
   if (report.failed > maxFailed) {
     issues.push(`Expected at most ${String(maxFailed)} failing provider contract row(s), found ${String(report.failed)}.`);
@@ -36413,15 +36480,15 @@ var evaluateVoiceProviderStackGaps = (input) => {
 };
 var evaluateVoiceProviderStackEvidence = (report, input = {}) => {
   const issues = [];
-  const maxStatus = input.maxStatus ?? "pass";
+  const maxStatus2 = input.maxStatus ?? "pass";
   const maxMissing = input.maxMissing ?? 0;
   const requireProviders = input.requireProviders ?? true;
   const kinds = [...new Set(report.gaps.map((gap) => gap.kind))].sort();
   const providers = [
     ...new Set(report.gaps.map((gap) => gap.provider).filter((provider) => provider !== undefined))
   ].sort();
-  if (statusExceeds2(report.status, maxStatus)) {
-    issues.push(`Expected provider stack status at most ${maxStatus}, found ${report.status}.`);
+  if (statusExceeds2(report.status, maxStatus2)) {
+    issues.push(`Expected provider stack status at most ${maxStatus2}, found ${report.status}.`);
   }
   if (report.missing > maxMissing) {
     issues.push(`Expected at most ${String(maxMissing)} missing provider stack capability/capabilities, found ${String(report.missing)}.`);
@@ -39733,6 +39800,7 @@ export {
   pruneVoiceTraceEvents,
   pruneVoiceIncidentBundleArtifacts,
   parseVoiceTelephonyWebhookEvent,
+  parseVoiceSessionSnapshot,
   normalizeVoiceProofTrendReport,
   muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
@@ -40123,6 +40191,8 @@ export {
   buildVoiceTelephonyMediaReport,
   buildVoiceSloReadinessThresholdReport,
   buildVoiceSloCalibrationReport,
+  buildVoiceSessionSnapshotStatus,
+  buildVoiceSessionSnapshot,
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,

package/dist/sessionSnapshot.d.ts

@@ -0,0 +1,44 @@
+import type { MediaProcessorGraphSnapshot } from '@absolutejs/media';
+import type { VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
+import type { VoiceCampaignTelephonyOutcomeSnapshot } from './campaign';
+import type { StoredVoiceTraceEvent } from './trace';
+export type VoiceSessionSnapshotStatus = 'fail' | 'pass' | 'warn';
+export type VoiceSessionSnapshotQualityEvidence = {
+    name: string;
+    report: unknown;
+    status?: VoiceSessionSnapshotStatus;
+};
+export type VoiceSessionSnapshot = {
+    capturedAt: number;
+    media: readonly MediaProcessorGraphSnapshot[];
+    name?: string;
+    proofAssertions: readonly VoiceProofAssertionResult[];
+    proofSummary: VoiceProofAssertionSummary;
+    providerRoutingEvents: readonly StoredVoiceTraceEvent[];
+    quality: readonly VoiceSessionSnapshotQualityEvidence[];
+    scenarioId?: string;
+    schema: 'absolute.voice.session.snapshot.v1';
+    sessionId: string;
+    status: VoiceSessionSnapshotStatus;
+    telephonyOutcomes: readonly VoiceCampaignTelephonyOutcomeSnapshot[];
+    turnId?: string;
+};
+export type VoiceSessionSnapshotInput = {
+    media?: readonly MediaProcessorGraphSnapshot[];
+    name?: string;
+    proofAssertions?: readonly VoiceProofAssertionResult[];
+    providerRoutingEvents?: readonly StoredVoiceTraceEvent[];
+    quality?: readonly VoiceSessionSnapshotQualityEvidence[];
+    scenarioId?: string;
+    sessionId: string;
+    telephonyOutcomes?: readonly VoiceCampaignTelephonyOutcomeSnapshot[];
+    turnId?: string;
+};
+export declare const buildVoiceSessionSnapshotStatus: (input: {
+    media?: readonly Pick<MediaProcessorGraphSnapshot, "report">[];
+    proofSummary?: Pick<VoiceProofAssertionSummary, "ok">;
+    quality?: readonly Pick<VoiceSessionSnapshotQualityEvidence, "status">[];
+    telephonyOutcomes?: readonly Pick<VoiceCampaignTelephonyOutcomeSnapshot, "campaignOutcome" | "duplicate">[];
+}) => VoiceSessionSnapshotStatus;
+export declare const buildVoiceSessionSnapshot: (input: VoiceSessionSnapshotInput) => VoiceSessionSnapshot;
+export declare const parseVoiceSessionSnapshot: (snapshot: VoiceSessionSnapshot) => VoiceSessionSnapshot;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.396",
+	"version": "0.0.22-beta.397",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",
@@ -246,7 +246,7 @@
 		}
 	},
 	"dependencies": {
-		"@absolutejs/media": "0.0.1-beta.7"
+		"@absolutejs/media": "0.0.1-beta.14"
 	},
 	"devDependencies": {
 		"@absolutejs/absolute": "0.19.0-beta.646",