@absolutejs/voice 0.0.22-beta.253 → 0.0.22-beta.255

package/dist/agentSquadContract.d.ts

@@ -65,5 +65,34 @@ export type VoiceAgentSquadContractRunOptions<TContext = unknown, TSession exten
     squad: VoiceAgent<TContext, TSession, TResult>;
     trace?: VoiceTraceEventStore;
 };
+export type VoiceAgentSquadContractAssertionInput = {
+    maxBlockedHandoffs?: number;
+    maxFailed?: number;
+    maxIssues?: number;
+    minContracts?: number;
+    minHandoffs?: number;
+    requiredContractIds?: string[];
+    requiredFinalAgentIds?: string[];
+    requiredHandoffStatuses?: VoiceAgentSquadHandoffStatus[];
+    requiredHandoffTargets?: string[];
+    requiredScenarioIds?: string[];
+};
+export type VoiceAgentSquadContractAssertionReport = {
+    blockedHandoffs: number;
+    contractIds: string[];
+    failed: number;
+    finalAgentIds: string[];
+    handoffStatuses: VoiceAgentSquadHandoffStatus[];
+    handoffTargets: string[];
+    handoffs: number;
+    issues: string[];
+    issueCount: number;
+    ok: boolean;
+    passed: number;
+    scenarioIds: string[];
+    total: number;
+};
 export declare const runVoiceAgentSquadContract: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options: VoiceAgentSquadContractRunOptions<TContext, TSession, TResult>) => Promise<VoiceAgentSquadContractReport<TResult>>;
 export declare const assertVoiceAgentSquadContract: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options: VoiceAgentSquadContractRunOptions<TContext, TSession, TResult>) => Promise<VoiceAgentSquadContractReport<TResult>>;
+export declare const evaluateVoiceAgentSquadContractEvidence: (reports: readonly VoiceAgentSquadContractReport[], input?: VoiceAgentSquadContractAssertionInput) => VoiceAgentSquadContractAssertionReport;
+export declare const assertVoiceAgentSquadContractEvidence: (reports: readonly VoiceAgentSquadContractReport[], input?: VoiceAgentSquadContractAssertionInput) => VoiceAgentSquadContractAssertionReport;

package/dist/index.d.ts

@@ -32,7 +32,7 @@ export { createVoiceSimulationSuiteRoutes, renderVoiceSimulationSuiteHTML, runVo
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';
 export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, createVoiceSessionsHTMLHandler, createVoiceSessionsJSONHandler, renderVoiceSessionsHTML, summarizeVoiceProviderFallbackRecovery, summarizeVoiceSessions, summarizeVoiceSessionReplay } from './sessionReplay';
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from './agent';
-export { assertVoiceAgentSquadContract, runVoiceAgentSquadContract } from './agentSquadContract';
+export { assertVoiceAgentSquadContractEvidence, assertVoiceAgentSquadContract, evaluateVoiceAgentSquadContractEvidence, runVoiceAgentSquadContract } from './agentSquadContract';
 export { createVoiceToolIdempotencyKey, createVoiceToolRuntime } from './toolRuntime';
 export { createVoiceToolContract, createVoiceToolContractHTMLHandler, createVoiceToolContractJSONHandler, createVoiceToolContractRoutes, createVoiceToolRuntimeContractDefaults, renderVoiceToolContractHTML, runVoiceToolContractSuite, runVoiceToolContract } from './toolContract';
 export { createVoiceTurnLatencyHTMLHandler, createVoiceTurnLatencyJSONHandler, createVoiceTurnLatencyRoutes, renderVoiceTurnLatencyHTML, summarizeVoiceTurnLatency } from './turnLatency';
@@ -49,12 +49,12 @@ export { createOpenAIRealtimeAdapter } from './openaiRealtime';
 export { createOpenAIVoiceTTS } from './openaiTTS';
 export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHandler, createVoiceProviderHealthRoutes, renderVoiceProviderHealthHTML, summarizeVoiceProviderHealth } from './providerHealth';
 export { createVoiceProviderCapabilityHTMLHandler, createVoiceProviderCapabilityJSONHandler, createVoiceProviderCapabilityRoutes, renderVoiceProviderCapabilityHTML, summarizeVoiceProviderCapabilities } from './providerCapabilities';
-export { assertVoiceProviderRoutingContract, runVoiceProviderRoutingContract } from './providerRoutingContract';
+export { assertVoiceProviderRoutingContractEvidence, assertVoiceProviderRoutingContract, evaluateVoiceProviderRoutingContractEvidence, runVoiceProviderRoutingContract } from './providerRoutingContract';
 export { assertVoiceProviderSloEvidence, buildVoiceProviderSloReport, createVoiceProviderSloRoutes, evaluateVoiceProviderSloEvidence, renderVoiceProviderSloHTML, renderVoiceProviderSloMarkdown } from './providerSlo';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
 export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
-export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
+export { assertVoiceProviderContractMatrixEvidence, assertVoiceProviderStackEvidence, buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderContractMatrixEvidence, evaluateVoiceProviderStackEvidence, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { assertVoiceOperationsRecordGuardrails, buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, evaluateVoiceOperationsRecordGuardrails, renderVoiceOperationsRecordGuardrailMarkdown, renderVoiceOperationsRecordHTML, renderVoiceOperationsRecordIncidentMarkdown } from './operationsRecord';
 export { assertVoiceObservabilityExportDeliveryEvidence, assertVoiceObservabilityExportRecord, assertVoiceObservabilityExportReplayEvidence, buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExportReplayReport, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, createVoiceObservabilityExportReplayRoutes, deliverVoiceObservabilityExport, evaluateVoiceObservabilityExportDeliveryEvidence, evaluateVoiceObservabilityExportReplayEvidence, loadVoiceObservabilityExportReplaySource, replayVoiceObservabilityExport, renderVoiceObservabilityExportReplayHTML, renderVoiceObservabilityExportMarkdown, validateVoiceObservabilityExportRecord, voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion } from './observabilityExport';
@@ -108,7 +108,7 @@ export type { OpenAIVoiceTTSOptions, OpenAIVoiceTTSVoice } from './openaiTTS';
 export type { OpenAIRealtimeAdapterOptions, OpenAIRealtimeModel, OpenAIRealtimeNoiseReduction, OpenAIRealtimeResponseMode, OpenAIRealtimeTranscriptionModel, OpenAIRealtimeVoice } from './openaiRealtime';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
 export type { VoiceProviderCapabilityDefinition, VoiceProviderCapabilityHandlerOptions, VoiceProviderCapabilityHTMLHandlerOptions, VoiceProviderCapabilityKind, VoiceProviderCapabilityOptions, VoiceProviderCapabilityReport, VoiceProviderCapabilityRoutesOptions, VoiceProviderCapabilitySummary } from './providerCapabilities';
-export type { VoiceProviderRoutingContractDefinition, VoiceProviderRoutingContractIssue, VoiceProviderRoutingContractReport, VoiceProviderRoutingContractRunOptions, VoiceProviderRoutingExpectation, VoiceProviderRoutingStatus } from './providerRoutingContract';
+export type { VoiceProviderRoutingContractAssertionInput, VoiceProviderRoutingContractAssertionReport, VoiceProviderRoutingContractDefinition, VoiceProviderRoutingContractIssue, VoiceProviderRoutingContractReport, VoiceProviderRoutingContractRunOptions, VoiceProviderRoutingExpectation, VoiceProviderRoutingStatus } from './providerRoutingContract';
 export type { VoiceProviderSloAssertionInput, VoiceProviderSloAssertionReport, VoiceProviderSloIssue, VoiceProviderSloKindReport, VoiceProviderSloMetric, VoiceProviderSloReport, VoiceProviderSloReportOptions, VoiceProviderSloRoutesOptions, VoiceProviderSloSessionReport, VoiceProviderSloStatus, VoiceProviderSloThresholdConfig, VoiceProviderSloThresholds } from './providerSlo';
 export type { VoiceTurnLatencyHTMLHandlerOptions, VoiceTurnLatencyItem, VoiceTurnLatencyOptions, VoiceTurnLatencyReport, VoiceTurnLatencyRoutesOptions, VoiceTurnLatencyStage, VoiceTurnLatencyStatus } from './turnLatency';
 export type { VoiceLiveLatencyOptions, VoiceLiveLatencyReport, VoiceLiveLatencyRoutesOptions, VoiceLiveLatencySample, VoiceLiveLatencyStatus } from './liveLatency';
@@ -122,7 +122,7 @@ export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesO
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
 export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
-export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
+export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
 export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
 export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliveryAssertionInput, VoiceObservabilityExportDeliveryAssertionReport, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReplayIssue, VoiceObservabilityExportReplayIssueCode, VoiceObservabilityExportReplayAssertionInput, VoiceObservabilityExportReplayAssertionReport, VoiceObservabilityExportReplayRecords, VoiceObservabilityExportReplayReport, VoiceObservabilityExportReplayRoutesOptions, VoiceObservabilityExportReplaySource, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus, VoiceObservabilityExportValidationIssue, VoiceObservabilityExportValidationResult } from './observabilityExport';
 export type { VoiceOpsRecoveryFailedSession, VoiceOpsRecoveryInterventionSummary, VoiceOpsRecoveryIssue, VoiceOpsRecoveryIssueCode, VoiceOpsRecoveryLinks, VoiceOpsRecoveryProviderSummary, VoiceOpsRecoveryReport, VoiceOpsRecoveryReportOptions, VoiceOpsRecoveryRoutesOptions, VoiceOpsRecoveryStatus } from './opsRecovery';
@@ -131,7 +131,7 @@ export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQua
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingKindSummary, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind, VoiceRoutingSessionSummary, VoiceRoutingSessionSummaryOptions } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';
 export type { VoiceAgent, VoiceAgentMessage, VoiceAgentMessageRole, VoiceAgentModel, VoiceAgentModelInput, VoiceAgentModelOutput, VoiceAgentOptions, VoiceAgentRunResult, VoiceAgentSquadContextPolicyResult, VoiceAgentSquadHandoffPolicyResult, VoiceAgentSquadHandoffStatus, VoiceAgentSquadOptions, VoiceAgentSquadState, VoiceAgentSquadStateHandoff, VoiceAgentTool, VoiceAgentToolCall, VoiceAgentToolResult } from './agent';
-export type { VoiceAgentSquadContractDefinition, VoiceAgentSquadContractIssue, VoiceAgentSquadContractOutcome, VoiceAgentSquadContractReport, VoiceAgentSquadContractRunOptions, VoiceAgentSquadContractTurn, VoiceAgentSquadContractTurnReport, VoiceAgentSquadHandoffExpectation, VoiceAgentSquadTurnExpectation } from './agentSquadContract';
+export type { VoiceAgentSquadContractAssertionInput, VoiceAgentSquadContractAssertionReport, VoiceAgentSquadContractDefinition, VoiceAgentSquadContractIssue, VoiceAgentSquadContractOutcome, VoiceAgentSquadContractReport, VoiceAgentSquadContractRunOptions, VoiceAgentSquadContractTurn, VoiceAgentSquadContractTurnReport, VoiceAgentSquadHandoffExpectation, VoiceAgentSquadTurnExpectation } from './agentSquadContract';
 export type { VoiceToolRetryDelay, VoiceToolRuntime, VoiceToolRuntimeExecuteInput, VoiceToolRuntimeOptions, VoiceToolRuntimeResult } from './toolRuntime';
 export type { VoiceToolContractCase, VoiceToolContractCaseReport, VoiceToolContractDefinition, VoiceToolContractExpectation, VoiceToolContractHandlerOptions, VoiceToolContractHTMLHandlerOptions, VoiceToolContractIssue, VoiceToolContractReport, VoiceToolContractRoutesOptions, VoiceToolContractSuiteReport } from './toolContract';
 export type { VoiceOpsRuntime, VoiceOpsRuntimeConfig, VoiceOpsRuntimeSummary, VoiceOpsRuntimeSinkWorkerConfig, VoiceOpsRuntimeTaskWorkerConfig, VoiceOpsRuntimeTickResult, VoiceOpsRuntimeWebhookWorkerConfig } from './opsRuntime';

package/dist/index.js

@@ -15983,6 +15983,91 @@ var assertVoiceAgentSquadContract = async (options) => {
   }
   return report;
 };
+var evaluateVoiceAgentSquadContractEvidence = (reports, input = {}) => {
+  const issues = [];
+  const maxFailed = input.maxFailed ?? 0;
+  const maxIssues = input.maxIssues ?? 0;
+  const maxBlockedHandoffs = input.maxBlockedHandoffs ?? Infinity;
+  const allHandoffs = reports.flatMap((report) => report.turns.flatMap((turn) => turn.handoffs));
+  const contractIds = [...new Set(reports.map((report) => report.contractId))].sort();
+  const scenarioIds = [
+    ...new Set(reports.map((report) => report.scenarioId).filter((scenarioId) => Boolean(scenarioId)))
+  ].sort();
+  const finalAgentIds = [
+    ...new Set(reports.flatMap((report) => report.turns.map((turn) => turn.agentId)))
+  ].sort();
+  const handoffTargets = [
+    ...new Set(allHandoffs.map((handoff) => handoff.targetAgentId).filter((target) => Boolean(target)))
+  ].sort();
+  const handoffStatuses = [
+    ...new Set(allHandoffs.map((handoff) => handoff.status).filter((status) => status !== undefined))
+  ].sort();
+  const failed = reports.filter((report) => !report.pass).length;
+  const issueCount = reports.reduce((total, report) => total + report.issues.length, 0);
+  const blockedHandoffs = allHandoffs.filter((handoff) => handoff.status === "blocked").length;
+  if (input.minContracts !== undefined && reports.length < input.minContracts) {
+    issues.push(`Expected at least ${String(input.minContracts)} agent squad contract(s), found ${String(reports.length)}.`);
+  }
+  if (failed > maxFailed) {
+    issues.push(`Expected at most ${String(maxFailed)} failing agent squad contract(s), found ${String(failed)}.`);
+  }
+  if (issueCount > maxIssues) {
+    issues.push(`Expected at most ${String(maxIssues)} agent squad contract issue(s), found ${String(issueCount)}.`);
+  }
+  if (input.minHandoffs !== undefined && allHandoffs.length < input.minHandoffs) {
+    issues.push(`Expected at least ${String(input.minHandoffs)} agent squad handoff(s), found ${String(allHandoffs.length)}.`);
+  }
+  if (blockedHandoffs > maxBlockedHandoffs) {
+    issues.push(`Expected at most ${String(maxBlockedHandoffs)} blocked agent squad handoff(s), found ${String(blockedHandoffs)}.`);
+  }
+  for (const contractId of input.requiredContractIds ?? []) {
+    if (!contractIds.includes(contractId)) {
+      issues.push(`Missing agent squad contract: ${contractId}.`);
+    }
+  }
+  for (const scenarioId of input.requiredScenarioIds ?? []) {
+    if (!scenarioIds.includes(scenarioId)) {
+      issues.push(`Missing agent squad scenario: ${scenarioId}.`);
+    }
+  }
+  for (const agentId of input.requiredFinalAgentIds ?? []) {
+    if (!finalAgentIds.includes(agentId)) {
+      issues.push(`Missing final agent: ${agentId}.`);
+    }
+  }
+  for (const target of input.requiredHandoffTargets ?? []) {
+    if (!handoffTargets.includes(target)) {
+      issues.push(`Missing agent squad handoff target: ${target}.`);
+    }
+  }
+  for (const status of input.requiredHandoffStatuses ?? []) {
+    if (!handoffStatuses.includes(status)) {
+      issues.push(`Missing agent squad handoff status: ${status}.`);
+    }
+  }
+  return {
+    blockedHandoffs,
+    contractIds,
+    failed,
+    finalAgentIds,
+    handoffStatuses,
+    handoffTargets,
+    handoffs: allHandoffs.length,
+    issues,
+    issueCount,
+    ok: issues.length === 0,
+    passed: reports.length - failed,
+    scenarioIds,
+    total: reports.length
+  };
+};
+var assertVoiceAgentSquadContractEvidence = (reports, input = {}) => {
+  const report = evaluateVoiceAgentSquadContractEvidence(reports, input);
+  if (!report.ok) {
+    throw new Error(`Voice agent squad contract evidence assertion failed: ${report.issues.join(" ")}`);
+  }
+  return report;
+};
 // src/turnLatency.ts
 import { Elysia as Elysia25 } from "elysia";
 var DEFAULT_WARN_AFTER_MS = 1800;
@@ -22146,6 +22231,110 @@ var assertVoiceProviderRoutingContract = async (options) => {
   }
   return report;
 };
+var evaluateVoiceProviderRoutingContractEvidence = (reports, input = {}) => {
+  const issues = [];
+  const maxFailed = input.maxFailed ?? 0;
+  const maxIssues = input.maxIssues ?? 0;
+  const events = reports.flatMap((report) => report.events);
+  const contractIds = [...new Set(reports.map((report) => report.contractId))].sort();
+  const scenarioIds = [
+    ...new Set(reports.map((report) => report.scenarioId).filter((scenarioId) => Boolean(scenarioId)))
+  ].sort();
+  const kinds = [...new Set(events.map((event) => event.kind))].sort();
+  const operations = [
+    ...new Set(events.map((event) => event.operation).filter((operation) => Boolean(operation)))
+  ].sort();
+  const providers = [
+    ...new Set(events.map((event) => event.provider).filter((provider) => Boolean(provider)))
+  ].sort();
+  const selectedProviders = [
+    ...new Set(events.map((event) => event.selectedProvider).filter((provider) => Boolean(provider)))
+  ].sort();
+  const fallbackProviders = [
+    ...new Set(events.map((event) => event.fallbackProvider).filter((provider) => Boolean(provider)))
+  ].sort();
+  const statuses = [
+    ...new Set(events.map((event) => event.status).filter((status) => status !== undefined))
+  ].sort();
+  const failed = reports.filter((report) => !report.pass).length;
+  const issueCount = reports.reduce((total, report) => total + report.issues.length, 0);
+  if (input.minContracts !== undefined && reports.length < input.minContracts) {
+    issues.push(`Expected at least ${String(input.minContracts)} provider routing contract(s), found ${String(reports.length)}.`);
+  }
+  if (failed > maxFailed) {
+    issues.push(`Expected at most ${String(maxFailed)} failing provider routing contract(s), found ${String(failed)}.`);
+  }
+  if (issueCount > maxIssues) {
+    issues.push(`Expected at most ${String(maxIssues)} provider routing contract issue(s), found ${String(issueCount)}.`);
+  }
+  if (input.minEvents !== undefined && events.length < input.minEvents) {
+    issues.push(`Expected at least ${String(input.minEvents)} provider routing event(s), found ${String(events.length)}.`);
+  }
+  for (const contractId of input.requiredContractIds ?? []) {
+    if (!contractIds.includes(contractId)) {
+      issues.push(`Missing provider routing contract: ${contractId}.`);
+    }
+  }
+  for (const scenarioId of input.requiredScenarioIds ?? []) {
+    if (!scenarioIds.includes(scenarioId)) {
+      issues.push(`Missing provider routing scenario: ${scenarioId}.`);
+    }
+  }
+  for (const kind of input.requiredKinds ?? []) {
+    if (!kinds.includes(kind)) {
+      issues.push(`Missing provider routing kind: ${kind}.`);
+    }
+  }
+  for (const operation of input.requiredOperations ?? []) {
+    if (!operations.includes(operation)) {
+      issues.push(`Missing provider routing operation: ${operation}.`);
+    }
+  }
+  for (const provider of input.requiredProviders ?? []) {
+    if (!providers.includes(provider)) {
+      issues.push(`Missing provider routing provider: ${provider}.`);
+    }
+  }
+  for (const provider of input.requiredSelectedProviders ?? []) {
+    if (!selectedProviders.includes(provider)) {
+      issues.push(`Missing selected provider: ${provider}.`);
+    }
+  }
+  for (const provider of input.requiredFallbackProviders ?? []) {
+    if (!fallbackProviders.includes(provider)) {
+      issues.push(`Missing fallback provider: ${provider}.`);
+    }
+  }
+  for (const status of input.requiredStatuses ?? []) {
+    if (!statuses.includes(status)) {
+      issues.push(`Missing provider routing status: ${status}.`);
+    }
+  }
+  return {
+    contractIds,
+    events: events.length,
+    failed,
+    fallbackProviders,
+    issues,
+    issueCount,
+    kinds,
+    ok: issues.length === 0,
+    operations,
+    passed: reports.length - failed,
+    providers,
+    scenarioIds,
+    selectedProviders,
+    statuses,
+    total: reports.length
+  };
+};
+var assertVoiceProviderRoutingContractEvidence = (reports, input = {}) => {
+  const report = evaluateVoiceProviderRoutingContractEvidence(reports, input);
+  if (!report.ok) {
+    throw new Error(`Voice provider routing contract evidence assertion failed: ${report.issues.join(" ")}`);
+  }
+  return report;
+};
 // src/providerSlo.ts
 import { Elysia as Elysia37 } from "elysia";
 var defaultThresholds = {
@@ -26730,6 +26919,12 @@ var recommendVoiceProviderStack = (input) => {
   };
 };
 var rollupContractStatus = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
+var statusRank2 = {
+  pass: 0,
+  warn: 1,
+  fail: 2
+};
+var statusExceeds = (actual, max) => statusRank2[actual] > statusRank2[max];
 var buildVoiceProviderContractMatrix = (input) => {
   const rows = input.contracts.map((contract) => {
     const configured = contract.configured !== false;
@@ -26830,6 +27025,76 @@ var buildVoiceProviderContractMatrix = (input) => {
     warned
   };
 };
+var evaluateVoiceProviderContractMatrixEvidence = (report, input = {}) => {
+  const issues = [];
+  const maxStatus = input.maxStatus ?? "pass";
+  const maxFailed = input.maxFailed ?? 0;
+  const maxWarned = input.maxWarned ?? 0;
+  const minRows = input.minRows ?? 1;
+  const requireAllSelected = input.requireAllSelected ?? false;
+  const kinds = [...new Set(report.rows.map((row) => row.kind))].sort();
+  const providers = [...new Set(report.rows.map((row) => row.provider))].sort();
+  const selectedKinds = [
+    ...new Set(report.rows.filter((row) => row.selected).map((row) => row.kind))
+  ].sort();
+  if (statusExceeds(report.status, maxStatus)) {
+    issues.push(`Expected provider contract matrix status at most ${maxStatus}, found ${report.status}.`);
+  }
+  if (report.failed > maxFailed) {
+    issues.push(`Expected at most ${String(maxFailed)} failing provider contract row(s), found ${String(report.failed)}.`);
+  }
+  if (report.warned > maxWarned) {
+    issues.push(`Expected at most ${String(maxWarned)} warning provider contract row(s), found ${String(report.warned)}.`);
+  }
+  if (report.total < minRows) {
+    issues.push(`Expected at least ${String(minRows)} provider contract row(s), found ${String(report.total)}.`);
+  }
+  for (const kind of input.requiredKinds ?? []) {
+    if (!kinds.includes(kind)) {
+      issues.push(`Missing provider contract kind: ${kind}.`);
+    }
+  }
+  for (const provider of input.requiredProviders ?? []) {
+    if (!providers.includes(provider)) {
+      issues.push(`Missing provider contract provider: ${provider}.`);
+    }
+  }
+  for (const kind of input.selectedKinds ?? []) {
+    if (!selectedKinds.includes(kind)) {
+      issues.push(`Missing selected provider contract kind: ${kind}.`);
+    }
+  }
+  for (const key of input.requiredCheckKeys ?? []) {
+    const missingRows = report.rows.filter((row) => !row.checks.some((check) => check.key === key)).length;
+    if (missingRows > 0) {
+      issues.push(`Provider contract check ${key} is missing from ${String(missingRows)} row(s).`);
+    }
+  }
+  if (requireAllSelected) {
+    const unselected = report.rows.filter((row) => !row.selected).length;
+    if (unselected > 0) {
+      issues.push(`Expected every provider contract row to be selected, found ${String(unselected)} unselected row(s).`);
+    }
+  }
+  return {
+    failed: report.failed,
+    issues,
+    kinds,
+    ok: issues.length === 0,
+    providers,
+    selectedKinds,
+    status: report.status,
+    total: report.total,
+    warned: report.warned
+  };
+};
+var assertVoiceProviderContractMatrixEvidence = (report, input = {}) => {
+  const assertion = evaluateVoiceProviderContractMatrixEvidence(report, input);
+  if (!assertion.ok) {
+    throw new Error(`Voice provider contract matrix assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var createVoiceProviderContractMatrixPreset = (profile, options) => {
   const contracts = ["llm", "stt", "tts"].flatMap((kind) => {
     const providers = options.providers[kind] ?? [];
@@ -26965,6 +27230,65 @@ var evaluateVoiceProviderStackGaps = (input) => {
     status: gaps.some((gap) => gap.status === "fail") ? "fail" : gaps.some((gap) => gap.status === "warn") ? "warn" : "pass"
   };
 };
+var evaluateVoiceProviderStackEvidence = (report, input = {}) => {
+  const issues = [];
+  const maxStatus = 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 (statusExceeds(report.status, maxStatus)) {
+    issues.push(`Expected provider stack status at most ${maxStatus}, found ${report.status}.`);
+  }
+  if (report.missing > maxMissing) {
+    issues.push(`Expected at most ${String(maxMissing)} missing provider stack capability/capabilities, found ${String(report.missing)}.`);
+  }
+  for (const kind of input.requiredKinds ?? []) {
+    if (!kinds.includes(kind)) {
+      issues.push(`Missing provider stack kind: ${kind}.`);
+    }
+  }
+  for (const provider of input.requiredProviders ?? []) {
+    if (!providers.includes(provider)) {
+      issues.push(`Missing provider stack provider: ${provider}.`);
+    }
+  }
+  for (const [kind, capabilities] of Object.entries(input.requiredCapabilities ?? {})) {
+    const gap = report.gaps.find((entry) => entry.kind === kind);
+    if (!gap) {
+      issues.push(`Missing provider stack kind: ${kind}.`);
+      continue;
+    }
+    for (const capability of capabilities) {
+      if (!includesCapability(gap.present, capability)) {
+        issues.push(`Missing provider stack capability for ${kind}: ${capability}.`);
+      }
+    }
+  }
+  if (requireProviders) {
+    const missingProviders = report.gaps.filter((gap) => !gap.provider).map((gap) => gap.kind);
+    if (missingProviders.length > 0) {
+      issues.push(`Missing provider stack provider for kind(s): ${missingProviders.join(", ")}.`);
+    }
+  }
+  return {
+    issues,
+    kinds,
+    missing: report.missing,
+    ok: issues.length === 0,
+    providers,
+    status: report.status
+  };
+};
+var assertVoiceProviderStackEvidence = (report, input = {}) => {
+  const assertion = evaluateVoiceProviderStackEvidence(report, input);
+  if (!assertion.ok) {
+    throw new Error(`Voice provider stack assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 // src/opsConsoleRoutes.ts
 import { Elysia as Elysia44 } from "elysia";
 var DEFAULT_LINKS = [
@@ -30374,7 +30698,10 @@ export {
   evaluateVoiceTelephonyContract,
   evaluateVoiceQuality,
   evaluateVoiceProviderStackGaps,
+  evaluateVoiceProviderStackEvidence,
   evaluateVoiceProviderSloEvidence,
+  evaluateVoiceProviderRoutingContractEvidence,
+  evaluateVoiceProviderContractMatrixEvidence,
   evaluateVoiceProofTrendEvidence,
   evaluateVoiceProductionReadinessEvidence,
   evaluateVoicePlatformCoverage,
@@ -30382,6 +30709,7 @@ export {
   evaluateVoiceObservabilityExportReplayEvidence,
   evaluateVoiceObservabilityExportDeliveryEvidence,
   evaluateVoiceGuardrailPolicy,
+  evaluateVoiceAgentSquadContractEvidence,
   encodeTwilioMulawBase64,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceObservabilityExport,
@@ -30693,8 +31021,11 @@ export {
   buildVoiceAuditDeliveryReport,
   buildEmptyVoiceProofTrendReport,
   assignVoiceOpsTask,
+  assertVoiceProviderStackEvidence,
   assertVoiceProviderSloEvidence,
+  assertVoiceProviderRoutingContractEvidence,
   assertVoiceProviderRoutingContract,
+  assertVoiceProviderContractMatrixEvidence,
   assertVoiceProofTrendEvidence,
   assertVoiceProductionReadinessEvidence,
   assertVoicePlatformCoverage,
@@ -30704,6 +31035,7 @@ export {
   assertVoiceObservabilityExportRecord,
   assertVoiceObservabilityExportDeliveryEvidence,
   assertVoiceLatencySLOGate,
+  assertVoiceAgentSquadContractEvidence,
   assertVoiceAgentSquadContract,
   applyVoiceTelephonyOutcome,
   applyVoiceOpsTaskPolicy,

package/dist/providerRoutingContract.d.ts

@@ -34,5 +34,38 @@ export type VoiceProviderRoutingContractRunOptions = {
     events?: StoredVoiceTraceEvent[] | VoiceRoutingEvent[];
     store?: VoiceTraceEventStore;
 };
+export type VoiceProviderRoutingContractAssertionInput = {
+    maxFailed?: number;
+    maxIssues?: number;
+    minContracts?: number;
+    minEvents?: number;
+    requiredContractIds?: string[];
+    requiredFallbackProviders?: string[];
+    requiredKinds?: VoiceRoutingEventKind[];
+    requiredOperations?: string[];
+    requiredProviders?: string[];
+    requiredScenarioIds?: string[];
+    requiredSelectedProviders?: string[];
+    requiredStatuses?: VoiceProviderRoutingStatus[];
+};
+export type VoiceProviderRoutingContractAssertionReport = {
+    contractIds: string[];
+    events: number;
+    failed: number;
+    fallbackProviders: string[];
+    issues: string[];
+    issueCount: number;
+    kinds: VoiceRoutingEventKind[];
+    ok: boolean;
+    operations: string[];
+    passed: number;
+    providers: string[];
+    scenarioIds: string[];
+    selectedProviders: string[];
+    statuses: VoiceProviderRoutingStatus[];
+    total: number;
+};
 export declare const runVoiceProviderRoutingContract: (options: VoiceProviderRoutingContractRunOptions) => Promise<VoiceProviderRoutingContractReport>;
 export declare const assertVoiceProviderRoutingContract: (options: VoiceProviderRoutingContractRunOptions) => Promise<VoiceProviderRoutingContractReport>;
+export declare const evaluateVoiceProviderRoutingContractEvidence: (reports: readonly VoiceProviderRoutingContractReport[], input?: VoiceProviderRoutingContractAssertionInput) => VoiceProviderRoutingContractAssertionReport;
+export declare const assertVoiceProviderRoutingContractEvidence: (reports: readonly VoiceProviderRoutingContractReport[], input?: VoiceProviderRoutingContractAssertionInput) => VoiceProviderRoutingContractAssertionReport;

package/dist/providerStackRecommendations.d.ts

@@ -31,6 +31,22 @@ export type VoiceProviderStackCapabilityGapReport<TProvider extends string = str
     profile: VoiceReadinessProfileName;
     status: 'fail' | 'pass' | 'warn';
 };
+export type VoiceProviderStackAssertionInput<TProvider extends string = string> = {
+    maxMissing?: number;
+    maxStatus?: VoiceProviderContractCheckStatus;
+    requireProviders?: boolean;
+    requiredKinds?: VoiceProviderStackKind[];
+    requiredProviders?: TProvider[];
+    requiredCapabilities?: Partial<Record<VoiceProviderStackKind, readonly string[]>>;
+};
+export type VoiceProviderStackAssertionReport<TProvider extends string = string> = {
+    issues: string[];
+    kinds: VoiceProviderStackKind[];
+    missing: number;
+    ok: boolean;
+    providers: TProvider[];
+    status: VoiceProviderContractCheckStatus;
+};
 export type VoiceProviderStackCapabilityGapInput<TProvider extends string = string> = VoiceProviderStackInput<TProvider> & {
     capabilities?: VoiceProviderStackCapabilities<TProvider>;
     recommendation?: VoiceProviderStackRecommendation<TProvider>;
@@ -106,8 +122,32 @@ export type VoiceProviderContractMatrixReport<TProvider extends string = string>
     total: number;
     warned: number;
 };
+export type VoiceProviderContractMatrixAssertionInput<TProvider extends string = string> = {
+    maxFailed?: number;
+    maxStatus?: VoiceProviderContractCheckStatus;
+    maxWarned?: number;
+    minRows?: number;
+    requireAllSelected?: boolean;
+    requiredCheckKeys?: string[];
+    requiredKinds?: VoiceProviderStackKind[];
+    requiredProviders?: TProvider[];
+    selectedKinds?: VoiceProviderStackKind[];
+};
+export type VoiceProviderContractMatrixAssertionReport<TProvider extends string = string> = {
+    failed: number;
+    issues: string[];
+    kinds: VoiceProviderStackKind[];
+    ok: boolean;
+    providers: TProvider[];
+    selectedKinds: VoiceProviderStackKind[];
+    status: VoiceProviderContractCheckStatus;
+    total: number;
+    warned: number;
+};
 export declare const recommendVoiceProviderStack: <TProvider extends string = string>(input: VoiceProviderStackInput<TProvider>) => VoiceProviderStackRecommendation<TProvider>;
 export declare const buildVoiceProviderContractMatrix: <TProvider extends string = string>(input: VoiceProviderContractMatrixInput<TProvider>) => VoiceProviderContractMatrixReport<TProvider>;
+export declare const evaluateVoiceProviderContractMatrixEvidence: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, input?: VoiceProviderContractMatrixAssertionInput<TProvider>) => VoiceProviderContractMatrixAssertionReport<TProvider>;
+export declare const assertVoiceProviderContractMatrixEvidence: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, input?: VoiceProviderContractMatrixAssertionInput<TProvider>) => VoiceProviderContractMatrixAssertionReport<TProvider>;
 export declare const createVoiceProviderContractMatrixPreset: <TProvider extends string = string>(profile: VoiceReadinessProfileName, options: VoiceProviderContractMatrixPresetOptions<TProvider>) => VoiceProviderContractMatrixInput<TProvider>;
 export declare const renderVoiceProviderContractMatrixHTML: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, options?: {
     title?: string;
@@ -143,3 +183,5 @@ export declare const createVoiceProviderContractMatrixRoutes: <TProvider extends
     response: {};
 }>;
 export declare const evaluateVoiceProviderStackGaps: <TProvider extends string = string>(input: VoiceProviderStackCapabilityGapInput<TProvider>) => VoiceProviderStackCapabilityGapReport<TProvider>;
+export declare const evaluateVoiceProviderStackEvidence: <TProvider extends string = string>(report: VoiceProviderStackCapabilityGapReport<TProvider>, input?: VoiceProviderStackAssertionInput<TProvider>) => VoiceProviderStackAssertionReport<TProvider>;
+export declare const assertVoiceProviderStackEvidence: <TProvider extends string = string>(report: VoiceProviderStackCapabilityGapReport<TProvider>, input?: VoiceProviderStackAssertionInput<TProvider>) => VoiceProviderStackAssertionReport<TProvider>;

package/package.json

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