@absolutejs/voice 0.0.22-beta.257 → 0.0.22-beta.258

package/dist/campaign.d.ts

@@ -190,6 +190,26 @@ export type VoiceCampaignReadinessProofReport = {
         windowBlocked: VoiceCampaignTickResult;
     };
 };
+export type VoiceCampaignReadinessAssertionInput = {
+    maxFailedChecks?: number;
+    minAcceptedImports?: number;
+    minRejectedImports?: number;
+    minTotalImports?: number;
+    requiredBlockedReasons?: VoiceCampaignTickResult['blocked'][number]['reason'][];
+    requiredChecks?: string[];
+    requireOk?: boolean;
+};
+export type VoiceCampaignReadinessAssertionReport = {
+    acceptedImports: number;
+    blockedReasons: VoiceCampaignTickResult['blocked'][number]['reason'][];
+    failed: number;
+    issues: string[];
+    ok: boolean;
+    passed: number;
+    rejectedImports: number;
+    total: number;
+    totalImports: number;
+};
 export type VoiceCampaignSummary = {
     attempts: {
         failed: number;
@@ -381,6 +401,8 @@ export declare const applyVoiceCampaignTelephonyOutcome: <TResult = unknown>(inp
 export declare const createVoiceCampaignTelephonyOutcomeHandler: <TResult = unknown>(options: VoiceCampaignTelephonyOutcomeOptions<TResult>) => (input: VoiceTelephonyWebhookDecision<TResult>) => Promise<VoiceCampaignTelephonyOutcomeResult>;
 export declare const runVoiceCampaignProof: (options?: VoiceCampaignProofOptions) => Promise<VoiceCampaignProofReport>;
 export declare const runVoiceCampaignReadinessProof: (options?: VoiceCampaignReadinessProofOptions) => Promise<VoiceCampaignReadinessProofReport>;
+export declare const evaluateVoiceCampaignReadinessEvidence: (report: VoiceCampaignReadinessProofReport, input?: VoiceCampaignReadinessAssertionInput) => VoiceCampaignReadinessAssertionReport;
+export declare const assertVoiceCampaignReadinessEvidence: (report: VoiceCampaignReadinessProofReport, input?: VoiceCampaignReadinessAssertionInput) => VoiceCampaignReadinessAssertionReport;
 export declare const renderVoiceCampaignsHTML: (records: VoiceCampaignRecord[], options?: Pick<VoiceCampaignRoutesOptions, "operationsRecordHref" | "title">) => string;
 export declare const renderVoiceCampaignObservabilityHTML: (report: VoiceCampaignObservabilityReport, options?: {
     title?: string;

package/dist/campaignDialers.d.ts

@@ -82,9 +82,30 @@ export type VoiceCampaignDialerProofOptions = {
     runPath?: string;
     store?: VoiceCampaignStore;
 };
+export type VoiceCampaignDialerProofAssertionInput = {
+    maxFailedProviders?: number;
+    minCarrierRequests?: number;
+    minProviders?: number;
+    minSuccessfulOutcomes?: number;
+    requiredProviders?: VoiceCampaignDialerProofProvider[];
+    requireDryRun?: boolean;
+    requireOk?: boolean;
+};
+export type VoiceCampaignDialerProofAssertionReport = {
+    carrierRequests: number;
+    failedProviders: number;
+    issues: string[];
+    mode: VoiceCampaignDialerProofReport['mode'];
+    ok: boolean;
+    providers: VoiceCampaignDialerProofProvider[];
+    successfulOutcomes: number;
+    totalProviders: number;
+};
 export declare const createVoiceTwilioCampaignDialer: (options: VoiceTwilioCampaignDialerOptions) => VoiceCampaignDialer;
 export declare const createVoiceTelnyxCampaignDialer: (options: VoiceTelnyxCampaignDialerOptions) => VoiceCampaignDialer;
 export declare const createVoicePlivoCampaignDialer: (options: VoicePlivoCampaignDialerOptions) => VoiceCampaignDialer;
 export declare const getVoiceCampaignDialerProofStatus: (options?: Pick<VoiceCampaignDialerProofOptions, "providers" | "runPath">) => VoiceCampaignDialerProofStatus;
 export declare const runVoiceCampaignDialerProof: (options?: VoiceCampaignDialerProofOptions) => Promise<VoiceCampaignDialerProofReport>;
+export declare const evaluateVoiceCampaignDialerProofEvidence: (report: VoiceCampaignDialerProofReport, input?: VoiceCampaignDialerProofAssertionInput) => VoiceCampaignDialerProofAssertionReport;
+export declare const assertVoiceCampaignDialerProofEvidence: (report: VoiceCampaignDialerProofReport, input?: VoiceCampaignDialerProofAssertionInput) => VoiceCampaignDialerProofAssertionReport;
 export {};

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { voice } from './plugin';
-export { applyVoiceCampaignTelephonyOutcome, buildVoiceCampaignObservabilityReport, createVoiceCampaignTelephonyOutcomeHandler, createVoiceCampaign, createVoiceCampaignRoutes, createVoiceCampaignWorker, createVoiceCampaignWorkerLoop, createVoiceMemoryCampaignStore, importVoiceCampaignRecipients, renderVoiceCampaignObservabilityHTML, renderVoiceCampaignsHTML, runVoiceCampaignProof, runVoiceCampaignReadinessProof, summarizeVoiceCampaigns } from './campaign';
-export { createVoicePlivoCampaignDialer, createVoiceTelnyxCampaignDialer, createVoiceTwilioCampaignDialer, getVoiceCampaignDialerProofStatus, runVoiceCampaignDialerProof } from './campaignDialers';
+export { applyVoiceCampaignTelephonyOutcome, assertVoiceCampaignReadinessEvidence, buildVoiceCampaignObservabilityReport, createVoiceCampaignTelephonyOutcomeHandler, createVoiceCampaign, createVoiceCampaignRoutes, createVoiceCampaignWorker, createVoiceCampaignWorkerLoop, createVoiceMemoryCampaignStore, evaluateVoiceCampaignReadinessEvidence, importVoiceCampaignRecipients, renderVoiceCampaignObservabilityHTML, renderVoiceCampaignsHTML, runVoiceCampaignProof, runVoiceCampaignReadinessProof, summarizeVoiceCampaigns } from './campaign';
+export { assertVoiceCampaignDialerProofEvidence, createVoicePlivoCampaignDialer, createVoiceTelnyxCampaignDialer, createVoiceTwilioCampaignDialer, evaluateVoiceCampaignDialerProofEvidence, getVoiceCampaignDialerProofStatus, runVoiceCampaignDialerProof } from './campaignDialers';
 export { createVoiceAssistant, createVoiceExperiment, summarizeVoiceAssistantRuns } from './assistant';
 export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHandler, createVoiceAssistantHealthRoutes, renderVoiceAssistantHealthHTML, summarizeVoiceAssistantHealth } from './assistantHealth';
 export { createVoiceAuditEvent, createVoiceAuditLogger, createVoiceMemoryAuditEventStore, filterVoiceAuditEvents, recordVoiceAuditEvent, recordVoiceHandoffAuditEvent, recordVoiceOperatorAuditEvent, recordVoiceProviderAuditEvent, recordVoiceRetentionAuditEvent, recordVoiceToolAuditEvent } from './audit';
@@ -92,8 +92,8 @@ export { conditionAudioChunk, resolveAudioConditioningConfig } from './audioCond
 export { resolveVoiceRuntimePreset } from './presets';
 export { resolveTurnDetectionConfig, TURN_PROFILE_DEFAULTS } from './turnProfiles';
 export { createVoiceCallReviewFromLiveTelephonyReport, createVoiceCallReviewRecorder, renderVoiceCallReviewHTML, renderVoiceCallReviewMarkdown } from './testing/review';
-export type { VoiceCampaign, VoiceCampaignAttempt, VoiceCampaignAttemptResultInput, VoiceCampaignAttemptStatus, VoiceCampaignCreateInput, VoiceCampaignDialer, VoiceCampaignDialerInput, VoiceCampaignDialerResult, VoiceCampaignProofOptions, VoiceCampaignProofReport, VoiceCampaignReadinessCheck, VoiceCampaignReadinessProofOptions, VoiceCampaignReadinessProofReport, VoiceCampaignRecipient, VoiceCampaignRecipientImportIssue, VoiceCampaignRecipientImportIssueCode, VoiceCampaignRecipientImportOptions, VoiceCampaignRecipientImportResult, VoiceCampaignRecipientImportRow, VoiceCampaignRecipientInput, VoiceCampaignRecipientStatus, VoiceCampaignRecord, VoiceCampaignRoutesOptions, VoiceCampaignRuntime, VoiceCampaignRuntimeOptions, VoiceCampaignRateLimit, VoiceCampaignRetryPolicy, VoiceCampaignSchedule, VoiceCampaignStatus, VoiceCampaignStore, VoiceCampaignSummary, VoiceCampaignTimeWindow, VoiceCampaignTickResult } from './campaign';
-export type { VoiceCampaignDialerProofCarrierRequest, VoiceCampaignDialerProofOptions, VoiceCampaignDialerProofProvider, VoiceCampaignDialerProofProviderResult, VoiceCampaignDialerProofReport, VoiceCampaignDialerProofStatus, VoicePlivoCampaignDialerOptions, VoiceTelnyxCampaignDialerOptions, VoiceTwilioCampaignDialerOptions } from './campaignDialers';
+export type { VoiceCampaign, VoiceCampaignAttempt, VoiceCampaignAttemptResultInput, VoiceCampaignAttemptStatus, VoiceCampaignCreateInput, VoiceCampaignDialer, VoiceCampaignDialerInput, VoiceCampaignDialerResult, VoiceCampaignProofOptions, VoiceCampaignProofReport, VoiceCampaignReadinessAssertionInput, VoiceCampaignReadinessAssertionReport, VoiceCampaignReadinessCheck, VoiceCampaignReadinessProofOptions, VoiceCampaignReadinessProofReport, VoiceCampaignRecipient, VoiceCampaignRecipientImportIssue, VoiceCampaignRecipientImportIssueCode, VoiceCampaignRecipientImportOptions, VoiceCampaignRecipientImportResult, VoiceCampaignRecipientImportRow, VoiceCampaignRecipientInput, VoiceCampaignRecipientStatus, VoiceCampaignRecord, VoiceCampaignRoutesOptions, VoiceCampaignRuntime, VoiceCampaignRuntimeOptions, VoiceCampaignRateLimit, VoiceCampaignRetryPolicy, VoiceCampaignSchedule, VoiceCampaignStatus, VoiceCampaignStore, VoiceCampaignSummary, VoiceCampaignTimeWindow, VoiceCampaignTickResult } from './campaign';
+export type { VoiceCampaignDialerProofAssertionInput, VoiceCampaignDialerProofAssertionReport, VoiceCampaignDialerProofCarrierRequest, VoiceCampaignDialerProofOptions, VoiceCampaignDialerProofProvider, VoiceCampaignDialerProofProviderResult, VoiceCampaignDialerProofReport, VoiceCampaignDialerProofStatus, VoicePlivoCampaignDialerOptions, VoiceTelnyxCampaignDialerOptions, VoiceTwilioCampaignDialerOptions } from './campaignDialers';
 export type { VoiceBargeInReport, VoiceBargeInRoutesOptions } from './bargeInRoutes';
 export type { VoiceAssistant, VoiceAssistantArtifactPlan, VoiceAssistantExperiment, VoiceAssistantExperimentOptions, VoiceAssistantGuardrailInput, VoiceAssistantGuardrails, VoiceAssistantMemoryLifecycle, VoiceAssistantMemoryLifecycleInput, VoiceAssistantOptions, VoiceAssistantOutputGuardrailInput, VoiceAssistantPreset, VoiceAssistantRunsSummary, VoiceAssistantRunSummary, VoiceAssistantVariant } from './assistant';
 export type { VoiceAssistantHealthFailure, VoiceAssistantHealthHTMLHandlerOptions, VoiceAssistantHealthRoutesOptions, VoiceAssistantHealthSummary, VoiceAssistantHealthSummaryOptions } from './assistantHealth';

package/dist/index.js

@@ -6661,6 +6661,60 @@ recipient-no-consent,Barbara,+15550001004,no,delta`,
     }
   };
 };
+var evaluateVoiceCampaignReadinessEvidence = (report, input = {}) => {
+  const issues = [];
+  const maxFailedChecks = input.maxFailedChecks ?? 0;
+  const requireOk = input.requireOk ?? true;
+  const failed = report.checks.filter((check) => check.status === "fail").length;
+  const passed = report.checks.length - failed;
+  const checkNames = new Set(report.checks.map((check) => check.name));
+  const blockedReasons = [
+    ...new Set(Object.values(report.ticks).flatMap((tick) => tick.blocked.map((block) => block.reason)))
+  ].sort();
+  if (requireOk && !report.ok) {
+    issues.push("Expected campaign readiness proof to pass.");
+  }
+  if (failed > maxFailedChecks) {
+    issues.push(`Expected at most ${String(maxFailedChecks)} failing campaign readiness check(s), found ${String(failed)}.`);
+  }
+  if (input.minTotalImports !== undefined && report.import.total < input.minTotalImports) {
+    issues.push(`Expected at least ${String(input.minTotalImports)} campaign import row(s), found ${String(report.import.total)}.`);
+  }
+  if (input.minAcceptedImports !== undefined && report.import.accepted.length < input.minAcceptedImports) {
+    issues.push(`Expected at least ${String(input.minAcceptedImports)} accepted campaign import(s), found ${String(report.import.accepted.length)}.`);
+  }
+  if (input.minRejectedImports !== undefined && report.import.rejected.length < input.minRejectedImports) {
+    issues.push(`Expected at least ${String(input.minRejectedImports)} rejected campaign import(s), found ${String(report.import.rejected.length)}.`);
+  }
+  for (const check of input.requiredChecks ?? []) {
+    if (!checkNames.has(check)) {
+      issues.push(`Missing campaign readiness check: ${check}.`);
+    }
+  }
+  for (const reason of input.requiredBlockedReasons ?? []) {
+    if (!blockedReasons.includes(reason)) {
+      issues.push(`Missing campaign readiness blocked reason: ${reason}.`);
+    }
+  }
+  return {
+    acceptedImports: report.import.accepted.length,
+    blockedReasons,
+    failed,
+    issues,
+    ok: issues.length === 0,
+    passed,
+    rejectedImports: report.import.rejected.length,
+    total: report.checks.length,
+    totalImports: report.import.total
+  };
+};
+var assertVoiceCampaignReadinessEvidence = (report, input = {}) => {
+  const assertion = evaluateVoiceCampaignReadinessEvidence(report, input);
+  if (!assertion.ok) {
+    throw new Error(`Voice campaign readiness evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var escapeHtml3 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var getString = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
 var campaignAttemptSessionId = (attempt) => getString(attempt.metadata?.sessionId) ?? getString(attempt.metadata?.voiceSessionId) ?? getString(attempt.metadata?.callSessionId);
@@ -7094,6 +7148,56 @@ var runVoiceCampaignDialerProof = async (options = {}) => {
     providers: results
   };
 };
+var evaluateVoiceCampaignDialerProofEvidence = (report, input = {}) => {
+  const issues = [];
+  const maxFailedProviders = input.maxFailedProviders ?? 0;
+  const requireOk = input.requireOk ?? true;
+  const requireDryRun = input.requireDryRun ?? true;
+  const providers = report.providers.map((provider) => provider.provider).sort();
+  const carrierRequests = report.providers.reduce((total, provider) => total + provider.carrierRequests.length, 0);
+  const successfulOutcomes = report.providers.reduce((total, provider) => total + provider.outcomes.filter((outcome) => outcome.applied).length, 0);
+  const failedProviders = report.providers.filter((provider) => provider.carrierRequests.length === 0 || provider.outcomes.some((outcome) => !outcome.applied)).length;
+  if (requireOk && !report.ok) {
+    issues.push("Expected campaign dialer proof to pass.");
+  }
+  if (requireDryRun && report.mode !== "dry-run") {
+    issues.push(`Expected campaign dialer proof mode dry-run, found ${report.mode}.`);
+  }
+  if (failedProviders > maxFailedProviders) {
+    issues.push(`Expected at most ${String(maxFailedProviders)} failing campaign dialer provider(s), found ${String(failedProviders)}.`);
+  }
+  if (input.minProviders !== undefined && report.providers.length < input.minProviders) {
+    issues.push(`Expected at least ${String(input.minProviders)} campaign dialer provider(s), found ${String(report.providers.length)}.`);
+  }
+  if (input.minCarrierRequests !== undefined && carrierRequests < input.minCarrierRequests) {
+    issues.push(`Expected at least ${String(input.minCarrierRequests)} campaign dialer carrier request(s), found ${String(carrierRequests)}.`);
+  }
+  if (input.minSuccessfulOutcomes !== undefined && successfulOutcomes < input.minSuccessfulOutcomes) {
+    issues.push(`Expected at least ${String(input.minSuccessfulOutcomes)} applied campaign dialer outcome(s), found ${String(successfulOutcomes)}.`);
+  }
+  for (const provider of input.requiredProviders ?? []) {
+    if (!providers.includes(provider)) {
+      issues.push(`Missing campaign dialer provider: ${provider}.`);
+    }
+  }
+  return {
+    carrierRequests,
+    failedProviders,
+    issues,
+    mode: report.mode,
+    ok: issues.length === 0,
+    providers,
+    successfulOutcomes,
+    totalProviders: report.providers.length
+  };
+};
+var assertVoiceCampaignDialerProofEvidence = (report, input = {}) => {
+  const assertion = evaluateVoiceCampaignDialerProofEvidence(report, input);
+  if (!assertion.ok) {
+    throw new Error(`Voice campaign dialer proof evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 // src/audit.ts
 var includes = (filter, value) => {
   if (!filter) {
@@ -30922,6 +31026,8 @@ export {
   evaluateVoiceObservabilityExportReplayEvidence,
   evaluateVoiceObservabilityExportDeliveryEvidence,
   evaluateVoiceGuardrailPolicy,
+  evaluateVoiceCampaignReadinessEvidence,
+  evaluateVoiceCampaignDialerProofEvidence,
   evaluateVoiceAgentSquadContractEvidence,
   encodeTwilioMulawBase64,
   deliverVoiceTraceEventsToSinks,
@@ -31251,6 +31357,8 @@ export {
   assertVoiceObservabilityExportRecord,
   assertVoiceObservabilityExportDeliveryEvidence,
   assertVoiceLatencySLOGate,
+  assertVoiceCampaignReadinessEvidence,
+  assertVoiceCampaignDialerProofEvidence,
   assertVoiceAgentSquadContractEvidence,
   assertVoiceAgentSquadContract,
   applyVoiceTelephonyOutcome,

package/package.json

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