@absolutejs/voice 0.0.22-beta.264 → 0.0.22-beta.266

package/dist/index.d.ts

@@ -40,7 +40,7 @@ export { createVoiceLiveLatencyRoutes, renderVoiceLiveLatencyHTML, summarizeVoic
 export { assertVoiceLatencySLOGate, buildVoiceLatencySLOGate, renderVoiceLatencySLOMarkdown } from './latencySlo';
 export { createVoiceTurnQualityHTMLHandler, createVoiceTurnQualityJSONHandler, createVoiceTurnQualityRoutes, renderVoiceTurnQualityHTML, summarizeVoiceTurnQuality } from './turnQuality';
 export { assertVoiceOutcomeContractEvidence, createVoiceOutcomeContractHTMLHandler, createVoiceOutcomeContractJSONHandler, createVoiceOutcomeContractRoutes, evaluateVoiceOutcomeContractEvidence, renderVoiceOutcomeContractHTML, runVoiceOutcomeContractSuite } from './outcomeContract';
-export { applyVoiceTelephonyOutcome, createMemoryVoiceTelephonyWebhookIdempotencyStore, createVoiceTelephonyOutcomePolicy, createVoiceTelephonyWebhookHandler, createVoiceTelephonyWebhookRoutes, parseVoiceTelephonyWebhookEvent, resolveVoiceTelephonyOutcome, signVoiceTwilioWebhook, verifyVoiceTwilioWebhookSignature, voiceTelephonyOutcomeToRouteResult } from './telephonyOutcome';
+export { applyVoiceTelephonyOutcome, assertVoiceTelephonyWebhookNormalizationEvidence, createMemoryVoiceTelephonyWebhookIdempotencyStore, createVoiceTelephonyOutcomePolicy, createVoiceTelephonyWebhookHandler, createVoiceTelephonyWebhookRoutes, evaluateVoiceTelephonyWebhookNormalizationEvidence, parseVoiceTelephonyWebhookEvent, resolveVoiceTelephonyOutcome, signVoiceTwilioWebhook, verifyVoiceTwilioWebhookSignature, voiceTelephonyOutcomeToRouteResult } from './telephonyOutcome';
 export { assertVoicePhoneCallControlEvidence, assertVoicePhoneAssistantEvidence, createVoicePhoneAgent, evaluateVoicePhoneCallControlEvidence, evaluateVoicePhoneAssistantEvidence } from './phoneAgent';
 export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileIncidentBundleStore, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileAuditEventStore, createVoiceFileAuditSinkDeliveryStore, createVoiceFileCampaignStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
@@ -115,7 +115,7 @@ export type { VoiceLiveLatencyOptions, VoiceLiveLatencyReport, VoiceLiveLatencyR
 export type { VoiceLatencySLOBudget, VoiceLatencySLOGateError, VoiceLatencySLOGateOptions, VoiceLatencySLOGateReport, VoiceLatencySLOMeasurement, VoiceLatencySLOStage, VoiceLatencySLOStageSummary, VoiceLatencySLOStatus } from './latencySlo';
 export type { VoiceTurnQualityHTMLHandlerOptions, VoiceTurnQualityItem, VoiceTurnQualityOptions, VoiceTurnQualityReport, VoiceTurnQualityRoutesOptions, VoiceTurnQualityStatus } from './turnQuality';
 export type { VoiceOutcomeContractAssertionInput, VoiceOutcomeContractAssertionReport, VoiceOutcomeContractDefinition, VoiceOutcomeContractHTMLHandlerOptions, VoiceOutcomeContractIssue, VoiceOutcomeContractOptions, VoiceOutcomeContractReport, VoiceOutcomeContractRoutesOptions, VoiceOutcomeContractStatus, VoiceOutcomeContractSuiteReport } from './outcomeContract';
-export type { VoiceTelephonyOutcomeAction, VoiceTelephonyOutcomeDecision, VoiceTelephonyOutcomePolicy, VoiceTelephonyOutcomeProviderEvent, VoiceTelephonyOutcomeRouteResult, VoiceTelephonyOutcomeStatusDecision, VoiceTelephonyWebhookDecision, VoiceTelephonyWebhookHandlerOptions, VoiceTelephonyWebhookIdempotencyStore, VoiceTelephonyWebhookParseInput, VoiceTelephonyWebhookProvider, VoiceTelephonyWebhookRoutesOptions, VoiceTelephonyWebhookVerificationResult, StoredVoiceTelephonyWebhookDecision } from './telephonyOutcome';
+export type { VoiceTelephonyOutcomeAction, VoiceTelephonyOutcomeDecision, VoiceTelephonyOutcomePolicy, VoiceTelephonyOutcomeProviderEvent, VoiceTelephonyOutcomeRouteResult, VoiceTelephonyOutcomeStatusDecision, VoiceTelephonyWebhookDecision, VoiceTelephonyWebhookHandlerOptions, VoiceTelephonyWebhookIdempotencyStore, VoiceTelephonyWebhookNormalizationEvidenceDecision, VoiceTelephonyWebhookNormalizationEvidenceInput, VoiceTelephonyWebhookNormalizationEvidenceReport, VoiceTelephonyWebhookParseInput, VoiceTelephonyWebhookProvider, VoiceTelephonyWebhookRoutesOptions, VoiceTelephonyWebhookVerificationResult, StoredVoiceTelephonyWebhookDecision } from './telephonyOutcome';
 export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneAssistantEvidenceInput, VoicePhoneAssistantEvidenceReport, VoicePhoneCallControlEvidenceInput, VoicePhoneCallControlEvidenceReport, VoicePhoneAgentLifecycleStage, VoicePhoneAgentPlivoCarrier, VoicePhoneAgentRoutes, VoicePhoneAgentRoutesOptions, VoicePhoneAgentSetupReport, VoicePhoneAgentTelnyxCarrier, VoicePhoneAgentTwilioCarrier } from './phoneAgent';
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';

package/dist/index.js

@@ -17364,6 +17364,14 @@ var DEFAULT_MACHINE_VOICEMAIL_VALUES = [
 ];
 var DEFAULT_NO_ANSWER_SIP_CODES = [408, 480, 486, 487, 603];
 var isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var uniqueSorted3 = (values) => Array.from(new Set(values)).sort();
+var findMissing3 = (values, required) => {
+  if (!required?.length) {
+    return [];
+  }
+  const valueSet = new Set(values);
+  return required.filter((value) => !valueSet.has(value));
+};
 
 class VoiceTelephonyWebhookVerificationError extends Error {
   result;
@@ -17382,6 +17390,75 @@ var createMemoryVoiceTelephonyWebhookIdempotencyStore = () => {
     }
   };
 };
+var isTelephonyWebhookProvider = (value) => value === "generic" || value === "plivo" || value === "telnyx" || value === "twilio";
+var isTelephonyOutcomeAction = (value) => value === "complete" || value === "escalate" || value === "ignore" || value === "no-answer" || value === "transfer" || value === "voicemail";
+var isCallDisposition = (value) => value === "completed" || value === "escalated" || value === "failed" || value === "no-answer" || value === "transferred" || value === "voicemail";
+var evaluateVoiceTelephonyWebhookNormalizationEvidence = (input = {}) => {
+  const issues = [];
+  const decisions = input.decisions ?? [];
+  const actions = uniqueSorted3(decisions.map((decision) => decision.decision?.action ?? decision.action).filter(isTelephonyOutcomeAction));
+  const dispositions = uniqueSorted3(decisions.map((decision) => decision.decision?.disposition ?? decision.disposition).filter(isCallDisposition));
+  const providers = uniqueSorted3(decisions.map((decision) => decision.provider ?? decision.event?.provider).filter(isTelephonyWebhookProvider));
+  const sources = uniqueSorted3(decisions.map((decision) => decision.decision?.source ?? decision.source).filter((source) => typeof source === "string"));
+  const applied = decisions.filter((decision) => decision.applied === true).length;
+  const duplicateDecisions = decisions.filter((decision) => decision.duplicate === true);
+  const duplicateProviders = uniqueSorted3(duplicateDecisions.map((decision) => decision.provider ?? decision.event?.provider).filter(isTelephonyWebhookProvider));
+  const duplicateIdempotencyKeys = new Set(duplicateDecisions.map((decision) => decision.idempotencyKey).filter((key) => typeof key === "string" && key.length > 0)).size;
+  const routeResults = decisions.filter((decision) => isRecord(decision.routeResult)).length;
+  const missingSessionIds = decisions.filter((decision) => !decision.sessionId).length;
+  if (input.minDecisions !== undefined && decisions.length < input.minDecisions) {
+    issues.push(`Expected at least ${String(input.minDecisions)} telephony webhook decision(s), found ${String(decisions.length)}.`);
+  }
+  if (input.minApplied !== undefined && applied < input.minApplied) {
+    issues.push(`Expected at least ${String(input.minApplied)} applied telephony webhook decision(s), found ${String(applied)}.`);
+  }
+  if (input.minDuplicates !== undefined && duplicateDecisions.length < input.minDuplicates) {
+    issues.push(`Expected at least ${String(input.minDuplicates)} duplicate telephony webhook decision(s), found ${String(duplicateDecisions.length)}.`);
+  }
+  if (input.minDuplicateIdempotencyKeys !== undefined && duplicateIdempotencyKeys < input.minDuplicateIdempotencyKeys) {
+    issues.push(`Expected at least ${String(input.minDuplicateIdempotencyKeys)} duplicate telephony webhook idempotency key(s), found ${String(duplicateIdempotencyKeys)}.`);
+  }
+  if (input.maxMissingSessionIds !== undefined && missingSessionIds > input.maxMissingSessionIds) {
+    issues.push(`Expected at most ${String(input.maxMissingSessionIds)} telephony webhook decision(s) without sessionId, found ${String(missingSessionIds)}.`);
+  }
+  if (input.requireRouteResults && routeResults < decisions.length) {
+    issues.push(`Expected every telephony webhook decision to include a route result, found ${String(routeResults)} of ${String(decisions.length)}.`);
+  }
+  for (const provider of findMissing3(providers, input.requiredProviders)) {
+    issues.push(`Missing telephony webhook provider: ${provider}.`);
+  }
+  for (const provider of findMissing3(duplicateProviders, input.requiredDuplicateProviders)) {
+    issues.push(`Missing duplicate telephony webhook provider: ${provider}.`);
+  }
+  for (const action of findMissing3(actions, input.requiredActions)) {
+    issues.push(`Missing telephony webhook action: ${action}.`);
+  }
+  for (const disposition of findMissing3(dispositions, input.requiredDispositions)) {
+    issues.push(`Missing telephony webhook disposition: ${disposition}.`);
+  }
+  return {
+    actions,
+    applied,
+    decisions: decisions.length,
+    dispositions,
+    duplicateIdempotencyKeys,
+    duplicateProviders,
+    duplicates: duplicateDecisions.length,
+    issues,
+    missingSessionIds,
+    ok: issues.length === 0,
+    providers,
+    routeResults,
+    sources
+  };
+};
+var assertVoiceTelephonyWebhookNormalizationEvidence = (input = {}) => {
+  const assertion = evaluateVoiceTelephonyWebhookNormalizationEvidence(input);
+  if (!assertion.ok) {
+    throw new Error(`Voice telephony webhook normalization evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var normalizeToken = (value) => typeof value === "string" ? value.trim().toLowerCase().replace(/\s+/g, "-").replace(/_+/g, "-") : undefined;
 var firstString2 = (source, keys) => {
   for (const key of keys) {
@@ -20020,8 +20097,8 @@ var loadCarrierMatrixInputs = async (input) => {
 };
 var carrierAnswerLabel = (provider) => provider === "telnyx" ? "TeXML URL" : provider === "plivo" ? "Answer URL" : "TwiML URL";
 var findCarrierMatrixEntry = (matrix, carrier) => matrix?.entries.find((candidate) => candidate.provider === carrier.provider && (candidate.name === carrier.name || candidate.name === (carrier.name ?? carrier.provider)));
-var uniqueSorted3 = (values) => Array.from(new Set(values)).sort();
-var findMissing3 = (values, required) => {
+var uniqueSorted4 = (values) => Array.from(new Set(values)).sort();
+var findMissing4 = (values, required) => {
   if (!required?.length) {
     return [];
   }
@@ -20030,8 +20107,8 @@ var findMissing3 = (values, required) => {
 };
 var evaluateVoicePhoneAssistantEvidence = (report, input = {}) => {
   const issues = [];
-  const providers = uniqueSorted3(report.carriers.map((carrier) => carrier.provider));
-  const lifecycleStages = uniqueSorted3(report.lifecycleStages);
+  const providers = uniqueSorted4(report.carriers.map((carrier) => carrier.provider));
+  const lifecycleStages = uniqueSorted4(report.lifecycleStages);
   const carrierSummary = report.matrix?.summary;
   const carrierFailures = carrierSummary?.failing ?? 0;
   const carrierWarnings = carrierSummary?.warnings ?? 0;
@@ -20071,10 +20148,10 @@ var evaluateVoicePhoneAssistantEvidence = (report, input = {}) => {
   if (input.maxCarrierWarnings !== undefined && carrierWarnings > input.maxCarrierWarnings) {
     issues.push(`Expected at most ${String(input.maxCarrierWarnings)} phone carrier warning(s), found ${String(carrierWarnings)}.`);
   }
-  for (const provider of findMissing3(providers, input.requiredProviders)) {
+  for (const provider of findMissing4(providers, input.requiredProviders)) {
     issues.push(`Missing phone carrier provider: ${provider}.`);
   }
-  for (const stage of findMissing3(lifecycleStages, input.requiredLifecycleStages)) {
+  for (const stage of findMissing4(lifecycleStages, input.requiredLifecycleStages)) {
     issues.push(`Missing phone lifecycle stage: ${stage}.`);
   }
   const dialer = input.dialerProof ? evaluateVoiceCampaignDialerProofEvidence(input.dialerProof, {
@@ -20117,9 +20194,9 @@ var evaluateVoicePhoneCallControlEvidence = (input = {}) => {
   const issues = [];
   const setup = input.setup;
   const productionSmokes = input.productionSmokes ?? [];
-  const lifecycleStages = uniqueSorted3(setup?.lifecycleStages ?? []);
-  const providers = uniqueSorted3(productionSmokes.map((report) => report.provider).filter((provider) => Boolean(provider)));
-  const outcomes = uniqueSorted3(productionSmokes.flatMap((report) => report.observed.lifecycleOutcomes));
+  const lifecycleStages = uniqueSorted4(setup?.lifecycleStages ?? []);
+  const providers = uniqueSorted4(productionSmokes.map((report) => report.provider).filter((provider) => Boolean(provider)));
+  const outcomes = uniqueSorted4(productionSmokes.flatMap((report) => report.observed.lifecycleOutcomes));
   const failedSmokeReports = productionSmokes.filter((report) => !report.pass).length;
   const passingSmokeReports = productionSmokes.length - failedSmokeReports;
   if (productionSmokes.length === 0) {
@@ -20129,7 +20206,7 @@ var evaluateVoicePhoneCallControlEvidence = (input = {}) => {
     if (!setup) {
       issues.push("Expected phone setup report to be present.");
     }
-    for (const stage of findMissing3(lifecycleStages, input.requiredLifecycleStages)) {
+    for (const stage of findMissing4(lifecycleStages, input.requiredLifecycleStages)) {
       issues.push(`Missing phone call-control lifecycle stage: ${stage}.`);
     }
   }
@@ -20139,10 +20216,10 @@ var evaluateVoicePhoneCallControlEvidence = (input = {}) => {
   if (input.maxFailedSmokeReports !== undefined && failedSmokeReports > input.maxFailedSmokeReports) {
     issues.push(`Expected at most ${String(input.maxFailedSmokeReports)} failing phone call-control smoke report(s), found ${String(failedSmokeReports)}.`);
   }
-  for (const provider of findMissing3(providers, input.requiredProviders)) {
+  for (const provider of findMissing4(providers, input.requiredProviders)) {
     issues.push(`Missing phone call-control provider: ${provider}.`);
   }
-  for (const outcome of findMissing3(outcomes, input.requiredOutcomes)) {
+  for (const outcome of findMissing4(outcomes, input.requiredOutcomes)) {
     issues.push(`Missing phone call-control outcome: ${outcome}.`);
   }
   return {
@@ -23095,7 +23172,7 @@ var statusRank = {
 var escapeHtml36 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var roundMetric3 = (value) => Math.round(value * 1e4) / 1e4;
 var rate3 = (count, total) => count / Math.max(1, total);
-var uniqueSorted4 = (values) => [
+var uniqueSorted5 = (values) => [
   ...new Set(values.filter((value) => typeof value === "string"))
 ].sort();
 var percentile3 = (values, rank) => {
@@ -23278,7 +23355,7 @@ var buildVoiceProviderSloReport = async (options = {}) => {
 var evaluateVoiceProviderSloEvidence = (report, input = {}) => {
   const issues = [];
   const kindReports = Object.values(report.kinds);
-  const providers = uniqueSorted4(kindReports.flatMap((kind) => kind.providers));
+  const providers = uniqueSorted5(kindReports.flatMap((kind) => kind.providers));
   const kinds = providerKinds.filter((kind) => report.kinds[kind].events > 0);
   const fallbacks = kindReports.reduce((total, kind) => total + kind.fallbacks, 0);
   const timeouts = kindReports.reduce((total, kind) => total + kind.timeouts, 0);
@@ -23999,7 +24076,7 @@ var hasPayloadValue = (payload, key, values) => {
   return typeof value === "string" && values.has(value);
 };
 var countIntegrationDeliveryStatus = (events, status) => events.filter((event) => event.deliveryStatus === status).length;
-var uniqueSorted5 = (values) => [
+var uniqueSorted6 = (values) => [
   ...new Set(values.filter((value) => typeof value === "string"))
 ].sort();
 var pushMissingValuesIssue = (input) => {
@@ -24178,11 +24255,11 @@ var buildVoiceOperationsRecord = async (options) => {
 var evaluateVoiceOperationsRecordGuardrails = (record, input = {}) => {
   const issues = [];
   const decisions = record.guardrails.decisions;
-  const proofs = uniqueSorted5(decisions.map((decision) => decision.proof));
-  const ruleIds = uniqueSorted5(decisions.flatMap((decision) => decision.findings.map((finding) => finding.ruleId)));
-  const stages = uniqueSorted5(decisions.map((decision) => decision.stage));
-  const statuses = uniqueSorted5(decisions.map((decision) => decision.status));
-  const toolNames = uniqueSorted5(decisions.map((decision) => decision.toolName));
+  const proofs = uniqueSorted6(decisions.map((decision) => decision.proof));
+  const ruleIds = uniqueSorted6(decisions.flatMap((decision) => decision.findings.map((finding) => finding.ruleId)));
+  const stages = uniqueSorted6(decisions.map((decision) => decision.stage));
+  const statuses = uniqueSorted6(decisions.map((decision) => decision.status));
+  const toolNames = uniqueSorted6(decisions.map((decision) => decision.toolName));
   const minDecisions = input.minDecisions ?? 1;
   if (record.guardrails.total < minDecisions) {
     issues.push(`Expected at least ${String(minDecisions)} guardrail decisions, found ${String(record.guardrails.total)}.`);
@@ -31419,6 +31496,7 @@ export {
   exportVoiceAuditTrail,
   evaluateVoiceTrace,
   evaluateVoiceToolContractEvidence,
+  evaluateVoiceTelephonyWebhookNormalizationEvidence,
   evaluateVoiceTelephonyContract,
   evaluateVoiceSimulationSuiteEvidence,
   evaluateVoiceQuality,
@@ -31755,6 +31833,7 @@ export {
   buildEmptyVoiceProofTrendReport,
   assignVoiceOpsTask,
   assertVoiceToolContractEvidence,
+  assertVoiceTelephonyWebhookNormalizationEvidence,
   assertVoiceSimulationSuiteEvidence,
   assertVoiceProviderStackEvidence,
   assertVoiceProviderSloEvidence,

package/dist/telephonyOutcome.d.ts

@@ -65,6 +65,51 @@ export type StoredVoiceTelephonyWebhookDecision<TResult = unknown> = VoiceTeleph
     createdAt: number;
     updatedAt: number;
 };
+export type VoiceTelephonyWebhookNormalizationEvidenceDecision = {
+    action?: VoiceTelephonyOutcomeAction | string;
+    applied?: boolean;
+    decision?: {
+        action?: VoiceTelephonyOutcomeAction | string;
+        disposition?: VoiceCallDisposition | string;
+        source?: VoiceTelephonyOutcomeDecision['source'] | string;
+    };
+    disposition?: VoiceCallDisposition | string;
+    duplicate?: boolean;
+    event?: VoiceTelephonyOutcomeProviderEvent;
+    idempotencyKey?: string;
+    provider?: VoiceTelephonyWebhookProvider | string;
+    routeResult?: unknown;
+    sessionId?: string;
+    source?: VoiceTelephonyOutcomeDecision['source'] | string;
+};
+export type VoiceTelephonyWebhookNormalizationEvidenceInput = {
+    decisions?: VoiceTelephonyWebhookNormalizationEvidenceDecision[];
+    maxMissingSessionIds?: number;
+    minApplied?: number;
+    minDecisions?: number;
+    minDuplicateIdempotencyKeys?: number;
+    minDuplicates?: number;
+    requiredActions?: VoiceTelephonyOutcomeAction[];
+    requiredDispositions?: VoiceCallDisposition[];
+    requiredDuplicateProviders?: VoiceTelephonyWebhookProvider[];
+    requiredProviders?: VoiceTelephonyWebhookProvider[];
+    requireRouteResults?: boolean;
+};
+export type VoiceTelephonyWebhookNormalizationEvidenceReport = {
+    actions: VoiceTelephonyOutcomeAction[];
+    applied: number;
+    decisions: number;
+    dispositions: VoiceCallDisposition[];
+    duplicateIdempotencyKeys: number;
+    duplicateProviders: VoiceTelephonyWebhookProvider[];
+    duplicates: number;
+    issues: string[];
+    missingSessionIds: number;
+    ok: boolean;
+    providers: VoiceTelephonyWebhookProvider[];
+    routeResults: number;
+    sources: string[];
+};
 export type VoiceTelephonyWebhookIdempotencyStore<TResult = unknown> = {
     get: (key: string) => Promise<StoredVoiceTelephonyWebhookDecision<TResult> | undefined> | StoredVoiceTelephonyWebhookDecision<TResult> | undefined;
     set: (key: string, decision: StoredVoiceTelephonyWebhookDecision<TResult>) => Promise<void> | void;
@@ -139,6 +184,8 @@ export declare class VoiceTelephonyWebhookVerificationError extends Error {
     constructor(result: VoiceTelephonyWebhookVerificationResult);
 }
 export declare const createMemoryVoiceTelephonyWebhookIdempotencyStore: <TResult = unknown>() => VoiceTelephonyWebhookIdempotencyStore<TResult>;
+export declare const evaluateVoiceTelephonyWebhookNormalizationEvidence: (input?: VoiceTelephonyWebhookNormalizationEvidenceInput) => VoiceTelephonyWebhookNormalizationEvidenceReport;
+export declare const assertVoiceTelephonyWebhookNormalizationEvidence: (input?: VoiceTelephonyWebhookNormalizationEvidenceInput) => VoiceTelephonyWebhookNormalizationEvidenceReport;
 export declare const createVoiceTelephonyOutcomePolicy: (policy?: VoiceTelephonyOutcomePolicy) => Required<Pick<VoiceTelephonyOutcomePolicy, "completedStatuses" | "escalationStatuses" | "failedAsNoAnswer" | "failedStatuses" | "includeProviderPayload" | "machineDetectionVoicemailValues" | "noAnswerOnZeroDuration" | "noAnswerSipCodes" | "noAnswerStatuses" | "transferStatuses" | "voicemailStatuses">> & VoiceTelephonyOutcomePolicy;
 export declare const resolveVoiceTelephonyOutcome: (event: VoiceTelephonyOutcomeProviderEvent, policyInput?: VoiceTelephonyOutcomePolicy) => VoiceTelephonyOutcomeDecision;
 export declare const voiceTelephonyOutcomeToRouteResult: <TResult = unknown>(decision: VoiceTelephonyOutcomeDecision, result?: TResult) => VoiceTelephonyOutcomeRouteResult<TResult>;

package/dist/testing/index.js

@@ -8219,6 +8219,14 @@ var DEFAULT_MACHINE_VOICEMAIL_VALUES = [
 ];
 var DEFAULT_NO_ANSWER_SIP_CODES = [408, 480, 486, 487, 603];
 var isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var uniqueSorted = (values) => Array.from(new Set(values)).sort();
+var findMissing = (values, required) => {
+  if (!required?.length) {
+    return [];
+  }
+  const valueSet = new Set(values);
+  return required.filter((value) => !valueSet.has(value));
+};
 
 class VoiceTelephonyWebhookVerificationError extends Error {
   result;
@@ -8237,6 +8245,75 @@ var createMemoryVoiceTelephonyWebhookIdempotencyStore = () => {
     }
   };
 };
+var isTelephonyWebhookProvider = (value) => value === "generic" || value === "plivo" || value === "telnyx" || value === "twilio";
+var isTelephonyOutcomeAction = (value) => value === "complete" || value === "escalate" || value === "ignore" || value === "no-answer" || value === "transfer" || value === "voicemail";
+var isCallDisposition = (value) => value === "completed" || value === "escalated" || value === "failed" || value === "no-answer" || value === "transferred" || value === "voicemail";
+var evaluateVoiceTelephonyWebhookNormalizationEvidence = (input = {}) => {
+  const issues = [];
+  const decisions = input.decisions ?? [];
+  const actions = uniqueSorted(decisions.map((decision) => decision.decision?.action ?? decision.action).filter(isTelephonyOutcomeAction));
+  const dispositions = uniqueSorted(decisions.map((decision) => decision.decision?.disposition ?? decision.disposition).filter(isCallDisposition));
+  const providers = uniqueSorted(decisions.map((decision) => decision.provider ?? decision.event?.provider).filter(isTelephonyWebhookProvider));
+  const sources = uniqueSorted(decisions.map((decision) => decision.decision?.source ?? decision.source).filter((source) => typeof source === "string"));
+  const applied = decisions.filter((decision) => decision.applied === true).length;
+  const duplicateDecisions = decisions.filter((decision) => decision.duplicate === true);
+  const duplicateProviders = uniqueSorted(duplicateDecisions.map((decision) => decision.provider ?? decision.event?.provider).filter(isTelephonyWebhookProvider));
+  const duplicateIdempotencyKeys = new Set(duplicateDecisions.map((decision) => decision.idempotencyKey).filter((key) => typeof key === "string" && key.length > 0)).size;
+  const routeResults = decisions.filter((decision) => isRecord(decision.routeResult)).length;
+  const missingSessionIds = decisions.filter((decision) => !decision.sessionId).length;
+  if (input.minDecisions !== undefined && decisions.length < input.minDecisions) {
+    issues.push(`Expected at least ${String(input.minDecisions)} telephony webhook decision(s), found ${String(decisions.length)}.`);
+  }
+  if (input.minApplied !== undefined && applied < input.minApplied) {
+    issues.push(`Expected at least ${String(input.minApplied)} applied telephony webhook decision(s), found ${String(applied)}.`);
+  }
+  if (input.minDuplicates !== undefined && duplicateDecisions.length < input.minDuplicates) {
+    issues.push(`Expected at least ${String(input.minDuplicates)} duplicate telephony webhook decision(s), found ${String(duplicateDecisions.length)}.`);
+  }
+  if (input.minDuplicateIdempotencyKeys !== undefined && duplicateIdempotencyKeys < input.minDuplicateIdempotencyKeys) {
+    issues.push(`Expected at least ${String(input.minDuplicateIdempotencyKeys)} duplicate telephony webhook idempotency key(s), found ${String(duplicateIdempotencyKeys)}.`);
+  }
+  if (input.maxMissingSessionIds !== undefined && missingSessionIds > input.maxMissingSessionIds) {
+    issues.push(`Expected at most ${String(input.maxMissingSessionIds)} telephony webhook decision(s) without sessionId, found ${String(missingSessionIds)}.`);
+  }
+  if (input.requireRouteResults && routeResults < decisions.length) {
+    issues.push(`Expected every telephony webhook decision to include a route result, found ${String(routeResults)} of ${String(decisions.length)}.`);
+  }
+  for (const provider of findMissing(providers, input.requiredProviders)) {
+    issues.push(`Missing telephony webhook provider: ${provider}.`);
+  }
+  for (const provider of findMissing(duplicateProviders, input.requiredDuplicateProviders)) {
+    issues.push(`Missing duplicate telephony webhook provider: ${provider}.`);
+  }
+  for (const action of findMissing(actions, input.requiredActions)) {
+    issues.push(`Missing telephony webhook action: ${action}.`);
+  }
+  for (const disposition of findMissing(dispositions, input.requiredDispositions)) {
+    issues.push(`Missing telephony webhook disposition: ${disposition}.`);
+  }
+  return {
+    actions,
+    applied,
+    decisions: decisions.length,
+    dispositions,
+    duplicateIdempotencyKeys,
+    duplicateProviders,
+    duplicates: duplicateDecisions.length,
+    issues,
+    missingSessionIds,
+    ok: issues.length === 0,
+    providers,
+    routeResults,
+    sources
+  };
+};
+var assertVoiceTelephonyWebhookNormalizationEvidence = (input = {}) => {
+  const assertion = evaluateVoiceTelephonyWebhookNormalizationEvidence(input);
+  if (!assertion.ok) {
+    throw new Error(`Voice telephony webhook normalization evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var normalizeToken = (value) => typeof value === "string" ? value.trim().toLowerCase().replace(/\s+/g, "-").replace(/_+/g, "-") : undefined;
 var firstString = (source, keys) => {
   for (const key of keys) {

package/package.json

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