@absolutejs/voice 0.0.22-beta.259 → 0.0.22-beta.260

package/dist/index.d.ts

@@ -41,7 +41,7 @@ export { assertVoiceLatencySLOGate, buildVoiceLatencySLOGate, renderVoiceLatency
 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 { createVoicePhoneAgent } from './phoneAgent';
+export { assertVoicePhoneAssistantEvidence, createVoicePhoneAgent, 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';
 export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, resolveVoiceProviderRoutingPolicyPreset, createVoiceProviderRouter } from './modelAdapters';
@@ -116,7 +116,7 @@ export type { VoiceLatencySLOBudget, VoiceLatencySLOGateError, VoiceLatencySLOGa
 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 { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneAgentLifecycleStage, VoicePhoneAgentPlivoCarrier, VoicePhoneAgentRoutes, VoicePhoneAgentRoutesOptions, VoicePhoneAgentSetupReport, VoicePhoneAgentTelnyxCarrier, VoicePhoneAgentTwilioCarrier } from './phoneAgent';
+export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneAssistantEvidenceInput, VoicePhoneAssistantEvidenceReport, 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';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';

package/dist/index.js

@@ -19875,6 +19875,99 @@ 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 uniqueSorted2 = (values) => Array.from(new Set(values)).sort();
+var findMissing2 = (values, required) => {
+  if (!required?.length) {
+    return [];
+  }
+  const valueSet = new Set(values);
+  return required.filter((value) => !valueSet.has(value));
+};
+var evaluateVoicePhoneAssistantEvidence = (report, input = {}) => {
+  const issues = [];
+  const providers = uniqueSorted2(report.carriers.map((carrier) => carrier.provider));
+  const lifecycleStages = uniqueSorted2(report.lifecycleStages);
+  const carrierSummary = report.matrix?.summary;
+  const carrierFailures = carrierSummary?.failing ?? 0;
+  const carrierWarnings = carrierSummary?.warnings ?? 0;
+  const readyCarriers = carrierSummary?.ready ?? report.carriers.filter((carrier) => findCarrierMatrixEntry(report.matrix, carrier)?.ready).length;
+  const smokePassing = carrierSummary?.smokePassing ?? 0;
+  const requireCarrierMatrix = input.requireCarrierMatrix ?? true;
+  const requireMatrixPass = input.requireMatrixPass ?? true;
+  const requireReady = input.requireReady ?? true;
+  const requireSetupPath = input.requireSetupPath ?? true;
+  if (requireSetupPath && !report.setupPath) {
+    issues.push("Expected phone assistant setup path to be configured.");
+  }
+  if (input.requireProductionSmokePath && !report.productionSmokePath) {
+    issues.push("Expected phone assistant production smoke path to be configured.");
+  }
+  if (requireReady && !report.ready) {
+    issues.push("Expected phone assistant setup report to be ready.");
+  }
+  if (requireCarrierMatrix && !report.matrix) {
+    issues.push("Expected phone assistant carrier matrix to be present.");
+  }
+  if (report.matrix && requireMatrixPass && !report.matrix.pass) {
+    issues.push("Expected phone assistant carrier matrix to pass.");
+  }
+  if (input.minCarriers !== undefined && report.carriers.length < input.minCarriers) {
+    issues.push(`Expected at least ${String(input.minCarriers)} phone carrier(s), found ${String(report.carriers.length)}.`);
+  }
+  if (input.minReadyCarriers !== undefined && readyCarriers < input.minReadyCarriers) {
+    issues.push(`Expected at least ${String(input.minReadyCarriers)} ready phone carrier(s), found ${String(readyCarriers)}.`);
+  }
+  if (input.minSmokePassing !== undefined && smokePassing < input.minSmokePassing) {
+    issues.push(`Expected at least ${String(input.minSmokePassing)} passing phone carrier smoke report(s), found ${String(smokePassing)}.`);
+  }
+  if (input.maxCarrierFailures !== undefined && carrierFailures > input.maxCarrierFailures) {
+    issues.push(`Expected at most ${String(input.maxCarrierFailures)} failing phone carrier(s), found ${String(carrierFailures)}.`);
+  }
+  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 findMissing2(providers, input.requiredProviders)) {
+    issues.push(`Missing phone carrier provider: ${provider}.`);
+  }
+  for (const stage of findMissing2(lifecycleStages, input.requiredLifecycleStages)) {
+    issues.push(`Missing phone lifecycle stage: ${stage}.`);
+  }
+  const dialer = input.dialerProof ? evaluateVoiceCampaignDialerProofEvidence(input.dialerProof, {
+    maxFailedProviders: input.maxFailedDialerProviders,
+    minCarrierRequests: input.minDialerCarrierRequests,
+    minSuccessfulOutcomes: input.minSuccessfulDialerOutcomes,
+    requiredProviders: input.requiredDialerProviders
+  }) : undefined;
+  if (input.requireDialerProof && !input.dialerProof) {
+    issues.push("Expected campaign dialer proof to be present.");
+  }
+  if (dialer && !dialer.ok) {
+    issues.push(...dialer.issues);
+  }
+  return {
+    carrierFailures,
+    carrierWarnings,
+    carriers: report.carriers.length,
+    dialer,
+    issues,
+    lifecycleStages,
+    matrixPass: report.matrix?.pass,
+    ok: issues.length === 0,
+    productionSmokePath: report.productionSmokePath,
+    providers,
+    ready: report.ready,
+    readyCarriers,
+    setupPath: report.setupPath,
+    smokePassing
+  };
+};
+var assertVoicePhoneAssistantEvidence = (report, input = {}) => {
+  const assertion = evaluateVoicePhoneAssistantEvidence(report, input);
+  if (!assertion.ok) {
+    throw new Error(`Voice phone assistant evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var buildVoicePhoneAgentSetupInstructions = (input) => input.carriers.map((carrier) => {
   const entry = findCarrierMatrixEntry(input.matrix, carrier);
   const urls = entry?.setup.urls;
@@ -22807,7 +22900,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 uniqueSorted2 = (values) => [
+var uniqueSorted3 = (values) => [
   ...new Set(values.filter((value) => typeof value === "string"))
 ].sort();
 var percentile3 = (values, rank) => {
@@ -22990,7 +23083,7 @@ var buildVoiceProviderSloReport = async (options = {}) => {
 var evaluateVoiceProviderSloEvidence = (report, input = {}) => {
   const issues = [];
   const kindReports = Object.values(report.kinds);
-  const providers = uniqueSorted2(kindReports.flatMap((kind) => kind.providers));
+  const providers = uniqueSorted3(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);
@@ -23711,7 +23804,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 uniqueSorted3 = (values) => [
+var uniqueSorted4 = (values) => [
   ...new Set(values.filter((value) => typeof value === "string"))
 ].sort();
 var pushMissingValuesIssue = (input) => {
@@ -23890,11 +23983,11 @@ var buildVoiceOperationsRecord = async (options) => {
 var evaluateVoiceOperationsRecordGuardrails = (record, input = {}) => {
   const issues = [];
   const decisions = record.guardrails.decisions;
-  const proofs = uniqueSorted3(decisions.map((decision) => decision.proof));
-  const ruleIds = uniqueSorted3(decisions.flatMap((decision) => decision.findings.map((finding) => finding.ruleId)));
-  const stages = uniqueSorted3(decisions.map((decision) => decision.stage));
-  const statuses = uniqueSorted3(decisions.map((decision) => decision.status));
-  const toolNames = uniqueSorted3(decisions.map((decision) => decision.toolName));
+  const proofs = uniqueSorted4(decisions.map((decision) => decision.proof));
+  const ruleIds = uniqueSorted4(decisions.flatMap((decision) => decision.findings.map((finding) => finding.ruleId)));
+  const stages = uniqueSorted4(decisions.map((decision) => decision.stage));
+  const statuses = uniqueSorted4(decisions.map((decision) => decision.status));
+  const toolNames = uniqueSorted4(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)}.`);
@@ -31142,6 +31235,7 @@ export {
   evaluateVoiceProofTrendEvidence,
   evaluateVoiceProductionReadinessEvidence,
   evaluateVoicePlatformCoverage,
+  evaluateVoicePhoneAssistantEvidence,
   evaluateVoiceOutcomeContractEvidence,
   evaluateVoiceOperationsRecordGuardrails,
   evaluateVoiceObservabilityExportReplayEvidence,
@@ -31472,6 +31566,7 @@ export {
   assertVoiceProofTrendEvidence,
   assertVoiceProductionReadinessEvidence,
   assertVoicePlatformCoverage,
+  assertVoicePhoneAssistantEvidence,
   assertVoiceOutcomeContractEvidence,
   assertVoiceOperationsRecordGuardrails,
   assertVoiceObservabilityExportSchema,

package/dist/phoneAgent.d.ts

@@ -4,6 +4,8 @@ import { type TelnyxVoiceRoutesOptions } from './telephony/telnyx';
 import { type TwilioVoiceRoutesOptions } from './telephony/twilio';
 import { type VoiceTelephonyCarrierMatrix, type VoiceTelephonyCarrierMatrixRoutesOptions } from './telephony/matrix';
 import { type VoicePhoneAgentProductionSmokeRoutesOptions } from './phoneAgentProductionSmoke';
+import { type VoiceCampaignDialerProofAssertionReport, type VoiceCampaignDialerProofProvider, type VoiceCampaignDialerProofReport } from './campaignDialers';
+import type { VoiceTelephonyProvider } from './telephony/contract';
 import type { VoiceSessionRecord } from './types';
 export type VoicePhoneAgentLifecycleStage = 'ringing' | 'answered' | 'media-started' | 'transcript' | 'assistant-response' | 'transfer' | 'voicemail' | 'no-answer' | 'completed' | 'failed';
 type VoicePhoneAgentCarrierBase = {
@@ -72,5 +74,43 @@ export type VoicePhoneAgentSetupReport = {
     setupPath?: string;
     title: string;
 };
+export type VoicePhoneAssistantEvidenceInput = {
+    dialerProof?: VoiceCampaignDialerProofReport;
+    maxCarrierFailures?: number;
+    maxCarrierWarnings?: number;
+    maxFailedDialerProviders?: number;
+    minCarriers?: number;
+    minDialerCarrierRequests?: number;
+    minReadyCarriers?: number;
+    minSmokePassing?: number;
+    minSuccessfulDialerOutcomes?: number;
+    requiredDialerProviders?: VoiceCampaignDialerProofProvider[];
+    requiredLifecycleStages?: VoicePhoneAgentLifecycleStage[];
+    requiredProviders?: VoiceTelephonyProvider[];
+    requireCarrierMatrix?: boolean;
+    requireDialerProof?: boolean;
+    requireMatrixPass?: boolean;
+    requireProductionSmokePath?: boolean;
+    requireReady?: boolean;
+    requireSetupPath?: boolean;
+};
+export type VoicePhoneAssistantEvidenceReport = {
+    carrierFailures: number;
+    carrierWarnings: number;
+    carriers: number;
+    dialer?: VoiceCampaignDialerProofAssertionReport;
+    issues: string[];
+    lifecycleStages: VoicePhoneAgentLifecycleStage[];
+    matrixPass?: boolean;
+    ok: boolean;
+    productionSmokePath?: string;
+    providers: VoiceTelephonyProvider[];
+    ready: boolean;
+    readyCarriers: number;
+    setupPath?: string;
+    smokePassing: number;
+};
+export declare const evaluateVoicePhoneAssistantEvidence: (report: VoicePhoneAgentSetupReport, input?: VoicePhoneAssistantEvidenceInput) => VoicePhoneAssistantEvidenceReport;
+export declare const assertVoicePhoneAssistantEvidence: (report: VoicePhoneAgentSetupReport, input?: VoicePhoneAssistantEvidenceInput) => VoicePhoneAssistantEvidenceReport;
 export declare const createVoicePhoneAgent: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options: VoicePhoneAgentRoutesOptions<TContext, TSession, TResult>) => VoicePhoneAgentRoutes;
 export {};

package/package.json

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