@absolutejs/voice 0.0.22-beta.40 → 0.0.22-beta.400

package/dist/opsStatus.d.ts

@@ -0,0 +1,76 @@
+import { type VoiceEvalLink, type VoiceEvalRoutesOptions } from './evalRoutes';
+import { type VoiceDeliverySinkRoutesOptions } from './deliverySinkRoutes';
+import { type VoiceQualityRoutesOptions } from './qualityRoutes';
+import { type VoiceProviderFallbackRecoverySummary } from './sessionReplay';
+import { type VoiceTraceEventStore } from './trace';
+export type VoiceOpsStatus = 'pass' | 'fail';
+export type VoiceOpsStatusLink = VoiceEvalLink & {
+    description?: string;
+    statusHref?: string;
+};
+export type VoiceOpsStatusOptions<TProvider extends string = string> = {
+    deliverySinks?: false | VoiceDeliverySinkRoutesOptions;
+    evals?: false | Partial<VoiceEvalRoutesOptions>;
+    include?: {
+        deliverySinks?: boolean;
+        handoffs?: boolean;
+        providers?: boolean;
+        providerRecovery?: boolean;
+        quality?: boolean;
+        sessions?: boolean;
+        workflows?: boolean;
+    };
+    links?: VoiceOpsStatusLink[];
+    llmProviders?: readonly TProvider[];
+    preferFixtureWorkflows?: boolean;
+    quality?: false | Partial<VoiceQualityRoutesOptions>;
+    store: VoiceTraceEventStore;
+    sttProviders?: readonly string[];
+    ttsProviders?: readonly string[];
+};
+export type VoiceOpsStatusReport = {
+    checkedAt: number;
+    failed: number;
+    links: VoiceOpsStatusLink[];
+    passed: number;
+    status: VoiceOpsStatus;
+    surfaces: {
+        handoffs?: {
+            failed: number;
+            status: VoiceOpsStatus;
+            total: number;
+        };
+        deliverySinks?: {
+            auditTotal: number;
+            status: VoiceOpsStatus;
+            traceTotal: number;
+        };
+        providers?: {
+            degraded: number;
+            status: VoiceOpsStatus;
+            total: number;
+        };
+        providerRecovery?: VoiceProviderFallbackRecoverySummary;
+        quality?: {
+            status: VoiceOpsStatus;
+        };
+        sessions?: {
+            failed: number;
+            status: VoiceOpsStatus;
+            total: number;
+        };
+        workflows?: {
+            failed: number;
+            source: 'fixtures' | 'live';
+            status: VoiceOpsStatus;
+            total: number;
+        };
+    };
+    total: number;
+};
+export type VoiceOpsStatusRoutesOptions<TProvider extends string = string> = VoiceOpsStatusOptions<TProvider> & {
+    headers?: HeadersInit;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceOpsStatus: <TProvider extends string = string>(options: VoiceOpsStatusOptions<TProvider>) => Promise<VoiceOpsStatusReport>;

package/dist/opsStatusRoutes.d.ts

@@ -0,0 +1,33 @@
+import { Elysia } from 'elysia';
+import { type VoiceOpsStatusReport, type VoiceOpsStatusRoutesOptions } from './opsStatus';
+export declare const renderVoiceOpsStatusHTML: (report: VoiceOpsStatusReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOpsStatusRoutes: (options: VoiceOpsStatusRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/outcomeContract.d.ts

@@ -0,0 +1,146 @@
+import { Elysia } from 'elysia';
+import type { StoredVoiceHandoffDelivery, VoiceCallDisposition, VoiceHandoffAction, VoiceHandoffDeliveryStore, VoiceSessionRecord, VoiceSessionStore } from './types';
+import type { StoredVoiceIntegrationEvent, StoredVoiceOpsTask, VoiceIntegrationEventType } from './ops';
+import type { StoredVoiceCallReviewArtifact } from './testing/review';
+export type VoiceOutcomeContractStatus = 'pass' | 'fail';
+export type VoiceOutcomeContractDefinition = {
+    description?: string;
+    expectedDisposition?: VoiceCallDisposition;
+    id: string;
+    label?: string;
+    minSessions?: number;
+    minTasks?: number;
+    requireHandoffActions?: VoiceHandoffAction[];
+    requireIntegrationEvents?: VoiceIntegrationEventType[];
+    requireReview?: boolean;
+    requireTask?: boolean;
+    scenarioId?: string;
+};
+export type VoiceOutcomeContractIssue = {
+    code: string;
+    message: string;
+};
+export type VoiceOutcomeContractReport = {
+    contractId: string;
+    description?: string;
+    issues: VoiceOutcomeContractIssue[];
+    label?: string;
+    matched: {
+        handoffs: number;
+        integrationEvents: number;
+        reviews: number;
+        sessions: number;
+        tasks: number;
+    };
+    operationsRecordHrefs: string[];
+    pass: boolean;
+    sessionIds: string[];
+};
+export type VoiceOutcomeContractSuiteReport = {
+    checkedAt: number;
+    contracts: VoiceOutcomeContractReport[];
+    failed: number;
+    passed: number;
+    status: VoiceOutcomeContractStatus;
+    total: number;
+};
+export type VoiceOutcomeContractAssertionInput = {
+    maxFailed?: number;
+    maxIssues?: number;
+    minContracts?: number;
+    minHandoffs?: number;
+    minIntegrationEvents?: number;
+    minOperationsRecordHrefs?: number;
+    minReviews?: number;
+    minSessions?: number;
+    minTasks?: number;
+    requiredContractIds?: string[];
+    requireOperationRecordHrefs?: boolean;
+};
+export type VoiceOutcomeContractAssertionReport = {
+    contractIds: string[];
+    failed: number;
+    handoffs: number;
+    integrationEvents: number;
+    issues: string[];
+    issueCount: number;
+    ok: boolean;
+    operationsRecordHrefs: number;
+    passed: number;
+    reviews: number;
+    sessions: number;
+    status: VoiceOutcomeContractStatus;
+    tasks: number;
+    total: number;
+};
+type ListStore<T> = {
+    list: () => Promise<T[]> | T[];
+};
+export type VoiceOutcomeContractOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = {
+    contracts: VoiceOutcomeContractDefinition[];
+    events?: StoredVoiceIntegrationEvent[] | ListStore<StoredVoiceIntegrationEvent>;
+    handoffs?: StoredVoiceHandoffDelivery[] | VoiceHandoffDeliveryStore;
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
+    reviews?: StoredVoiceCallReviewArtifact[] | ListStore<StoredVoiceCallReviewArtifact>;
+    sessions?: TSession[] | VoiceSessionStore<TSession>;
+    tasks?: StoredVoiceOpsTask[] | ListStore<StoredVoiceOpsTask>;
+};
+export type VoiceOutcomeContractHTMLHandlerOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceOutcomeContractOptions<TSession> & {
+    headers?: HeadersInit;
+    render?: (report: VoiceOutcomeContractSuiteReport) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceOutcomeContractRoutesOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceOutcomeContractHTMLHandlerOptions<TSession> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const runVoiceOutcomeContractSuite: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceOutcomeContractOptions<TSession>) => Promise<VoiceOutcomeContractSuiteReport>;
+export declare const evaluateVoiceOutcomeContractEvidence: (report: VoiceOutcomeContractSuiteReport, input?: VoiceOutcomeContractAssertionInput) => VoiceOutcomeContractAssertionReport;
+export declare const assertVoiceOutcomeContractEvidence: (report: VoiceOutcomeContractSuiteReport, input?: VoiceOutcomeContractAssertionInput) => VoiceOutcomeContractAssertionReport;
+export declare const renderVoiceOutcomeContractHTML: (report: VoiceOutcomeContractSuiteReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOutcomeContractJSONHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceOutcomeContractOptions<TSession>) => () => Promise<VoiceOutcomeContractSuiteReport>;
+export declare const createVoiceOutcomeContractHTMLHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceOutcomeContractHTMLHandlerOptions<TSession>) => () => Promise<Response>;
+export declare const createVoiceOutcomeContractRoutes: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceOutcomeContractRoutesOptions<TSession>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceOutcomeContractSuiteReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export {};

package/dist/phoneAgent.d.ts

@@ -0,0 +1,139 @@
+import { Elysia } from 'elysia';
+import { type PlivoVoiceRoutesOptions } from './telephony/plivo';
+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 { VoicePhoneAgentProductionSmokeReport } from './phoneAgentProductionSmoke';
+import type { VoiceSessionRecord } from './types';
+export type VoicePhoneAgentLifecycleStage = 'ringing' | 'answered' | 'media-started' | 'transcript' | 'assistant-response' | 'transfer' | 'voicemail' | 'no-answer' | 'completed' | 'failed';
+type VoicePhoneAgentCarrierBase = {
+    name?: string;
+    smokePath?: false | string;
+    setupPath?: false | string;
+};
+export type VoicePhoneAgentTwilioCarrier<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = VoicePhoneAgentCarrierBase & {
+    options: TwilioVoiceRoutesOptions<TContext, TSession, TResult>;
+    provider: 'twilio';
+};
+export type VoicePhoneAgentTelnyxCarrier<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = VoicePhoneAgentCarrierBase & {
+    options?: TelnyxVoiceRoutesOptions<TContext, TSession, TResult>;
+    provider: 'telnyx';
+};
+export type VoicePhoneAgentPlivoCarrier<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = VoicePhoneAgentCarrierBase & {
+    options?: PlivoVoiceRoutesOptions<TContext, TSession, TResult>;
+    provider: 'plivo';
+};
+export type VoicePhoneAgentCarrier<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = VoicePhoneAgentTwilioCarrier<TContext, TSession, TResult> | VoicePhoneAgentTelnyxCarrier<TContext, TSession, TResult> | VoicePhoneAgentPlivoCarrier<TContext, TSession, TResult>;
+export type VoicePhoneAgentRoutesOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    carriers: readonly VoicePhoneAgentCarrier<TContext, TSession, TResult>[];
+    matrix?: false | Omit<VoiceTelephonyCarrierMatrixRoutesOptions, 'load'>;
+    name?: string;
+    productionSmoke?: false | VoicePhoneAgentProductionSmokeRoutesOptions;
+    setup?: false | {
+        path?: string;
+        title?: string;
+    };
+};
+export type VoicePhoneAgentCarrierSummary = {
+    name?: string;
+    provider: 'plivo' | 'telnyx' | 'twilio';
+    setupPath?: false | string;
+    smokePath?: false | string;
+};
+export type VoicePhoneAgentSetupInstruction = {
+    answerLabel: string;
+    answerUrl?: string;
+    carrierName: string;
+    issues: string[];
+    provider: 'plivo' | 'telnyx' | 'twilio';
+    setupPath?: false | string;
+    smokePath?: false | string;
+    status: 'fail' | 'pass' | 'unknown' | 'warn';
+    steps: string[];
+    streamUrl?: string;
+    webhookUrl?: string;
+};
+export type VoicePhoneAgentRoutes = {
+    carriers: VoicePhoneAgentCarrierSummary[];
+    matrixPath?: string;
+    productionSmokePath?: string;
+    routes: Elysia;
+    setupPath?: string;
+};
+export type VoicePhoneAgentSetupReport = {
+    carriers: VoicePhoneAgentCarrierSummary[];
+    generatedAt: number;
+    lifecycleStages: VoicePhoneAgentLifecycleStage[];
+    matrix?: VoiceTelephonyCarrierMatrix;
+    matrixPath?: string;
+    productionSmokePath?: string;
+    ready: boolean;
+    setupInstructions: VoicePhoneAgentSetupInstruction[];
+    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 type VoicePhoneCallControlEvidenceInput = {
+    maxFailedSmokeReports?: number;
+    minPassingSmokeReports?: number;
+    productionSmokes?: VoicePhoneAgentProductionSmokeReport[];
+    requiredLifecycleStages?: VoicePhoneAgentLifecycleStage[];
+    requiredOutcomes?: string[];
+    requiredProviders?: VoiceTelephonyProvider[];
+    requireSetupLifecycleStages?: boolean;
+    setup?: VoicePhoneAgentSetupReport;
+};
+export type VoicePhoneCallControlEvidenceReport = {
+    failedSmokeReports: number;
+    issues: string[];
+    lifecycleStages: VoicePhoneAgentLifecycleStage[];
+    ok: boolean;
+    outcomes: string[];
+    passingSmokeReports: number;
+    providers: VoiceTelephonyProvider[];
+    smokeReports: number;
+};
+export declare const evaluateVoicePhoneAssistantEvidence: (report: VoicePhoneAgentSetupReport, input?: VoicePhoneAssistantEvidenceInput) => VoicePhoneAssistantEvidenceReport;
+export declare const assertVoicePhoneAssistantEvidence: (report: VoicePhoneAgentSetupReport, input?: VoicePhoneAssistantEvidenceInput) => VoicePhoneAssistantEvidenceReport;
+export declare const evaluateVoicePhoneCallControlEvidence: (input?: VoicePhoneCallControlEvidenceInput) => VoicePhoneCallControlEvidenceReport;
+export declare const assertVoicePhoneCallControlEvidence: (input?: VoicePhoneCallControlEvidenceInput) => VoicePhoneCallControlEvidenceReport;
+export declare const createVoicePhoneAgent: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options: VoicePhoneAgentRoutesOptions<TContext, TSession, TResult>) => VoicePhoneAgentRoutes;
+export {};

package/dist/phoneAgentProductionSmoke.d.ts

@@ -0,0 +1,115 @@
+import { Elysia } from 'elysia';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+import type { VoiceTelephonyContractReport, VoiceTelephonyProvider } from './telephony/contract';
+export type VoicePhoneAgentProductionSmokeRequirement = 'assistant-response' | 'carrier-contract' | 'fresh-trace' | 'lifecycle-outcome' | 'media-started' | 'no-session-error' | 'transcript';
+export type VoicePhoneAgentProductionSmokeIssue = {
+    message: string;
+    requirement: VoicePhoneAgentProductionSmokeRequirement;
+    severity: 'error' | 'warning';
+};
+export type VoicePhoneAgentProductionSmokeReport<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = {
+    contract?: VoiceTelephonyContractReport<TProvider>;
+    contractId: string;
+    generatedAt: number;
+    issues: VoicePhoneAgentProductionSmokeIssue[];
+    maxAgeMs?: number;
+    observed: {
+        assistantResponses: number;
+        carrierContract?: boolean;
+        lifecycleOutcomes: string[];
+        latestEventAt?: number;
+        mediaStarts: number;
+        sessionErrors: number;
+        transcripts: number;
+    };
+    pass: boolean;
+    provider?: TProvider;
+    required: VoicePhoneAgentProductionSmokeRequirement[];
+    scenarioId?: string;
+    sessionId?: string;
+    traceId?: string;
+};
+export type VoicePhoneAgentProductionSmokeOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = {
+    contract?: VoiceTelephonyContractReport<TProvider>;
+    contractId?: string;
+    events?: readonly StoredVoiceTraceEvent[];
+    maxAgeMs?: number;
+    now?: number;
+    provider?: TProvider;
+    required?: readonly VoicePhoneAgentProductionSmokeRequirement[];
+    scenarioId?: string;
+    sessionId?: string;
+    store?: VoiceTraceEventStore;
+    traceId?: string;
+};
+export type VoicePhoneAgentProductionSmokeHandlerOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = Omit<VoicePhoneAgentProductionSmokeOptions<TProvider>, 'events' | 'scenarioId' | 'sessionId' | 'traceId'> & {
+    getContract?: (input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceTelephonyContractReport<TProvider> | undefined> | VoiceTelephonyContractReport<TProvider> | undefined;
+    scenarioId?: string;
+    sessionId?: string;
+    traceId?: string;
+};
+export type VoicePhoneAgentProductionSmokeHTMLHandlerOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = VoicePhoneAgentProductionSmokeHandlerOptions<TProvider> & {
+    headers?: HeadersInit;
+    render?: (report: VoicePhoneAgentProductionSmokeReport<TProvider>) => Promise<string> | string;
+    title?: string;
+};
+export type VoicePhoneAgentProductionSmokeRoutesOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = VoicePhoneAgentProductionSmokeHTMLHandlerOptions<TProvider> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const runVoicePhoneAgentProductionSmokeContract: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeOptions<TProvider>) => Promise<VoicePhoneAgentProductionSmokeReport<TProvider>>;
+export declare const renderVoicePhoneAgentProductionSmokeHTML: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(report: VoicePhoneAgentProductionSmokeReport<TProvider>, options?: {
+    title?: string;
+}) => string;
+export declare const createVoicePhoneAgentProductionSmokeJSONHandler: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeHandlerOptions<TProvider>) => ({ query, request }: {
+    query: Record<string, unknown>;
+    request: Request;
+}) => Promise<VoicePhoneAgentProductionSmokeReport<TProvider>>;
+export declare const createVoicePhoneAgentProductionSmokeHTMLHandler: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeHTMLHandlerOptions<TProvider>) => ({ query, request }: {
+    query: Record<string, unknown>;
+    request: Request;
+}) => Promise<Response>;
+export declare const createVoicePhoneAgentProductionSmokeRoutes: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeRoutesOptions<TProvider>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoicePhoneAgentProductionSmokeReport<TProvider>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/platformCoverage.d.ts

@@ -0,0 +1,91 @@
+import { Elysia } from 'elysia';
+export type VoicePlatformCoverageStatus = 'fail' | 'missing' | 'pass' | 'stale';
+export type VoicePlatformCoverageEvidence = {
+    method?: string;
+    name: string;
+    ok?: boolean;
+    path?: string;
+    status?: number;
+    url?: string;
+};
+export type VoicePlatformCoverageSurface = {
+    evidence: VoicePlatformCoverageEvidence[];
+    failed?: number;
+    gap?: string;
+    missing?: number;
+    missingEvidence?: string[];
+    replacement: string;
+    status: 'fail' | 'pass' | string;
+    surface: string;
+};
+export type VoicePlatformCoverageSummary = {
+    generatedAt?: string;
+    ok: boolean;
+    outputDir?: string;
+    runId?: string;
+    source?: string;
+    status: VoicePlatformCoverageStatus;
+    total: number;
+    coverage: VoicePlatformCoverageSurface[];
+};
+export type VoicePlatformCoverageSummaryInput = {
+    coverage?: VoicePlatformCoverageSurface[];
+    generatedAt?: string;
+    ok?: boolean;
+    outputDir?: string;
+    runId?: string;
+    source?: string;
+};
+export type VoicePlatformCoverageRoutesOptions = {
+    headers?: HeadersInit;
+    name?: string;
+    path?: string;
+    source: (() => Promise<VoicePlatformCoverageSummary | VoicePlatformCoverageSummaryInput> | VoicePlatformCoverageSummary | VoicePlatformCoverageSummaryInput) | VoicePlatformCoverageSummary | VoicePlatformCoverageSummaryInput;
+};
+export type VoicePlatformCoverageAssertionInput = {
+    maxFailedSurfaces?: number;
+    minSurfaces?: number;
+    requiredEvidence?: string[];
+    requiredSurfaces?: string[];
+    requirePass?: boolean;
+};
+export type VoicePlatformCoverageAssertionReport = {
+    failed: number;
+    issues: string[];
+    missing: number;
+    ok: boolean;
+    status: VoicePlatformCoverageStatus;
+    surfaces: string[];
+    total: number;
+};
+export declare const buildVoicePlatformCoverageSummary: (input: VoicePlatformCoverageSummaryInput) => VoicePlatformCoverageSummary;
+export declare const evaluateVoicePlatformCoverage: (summary: VoicePlatformCoverageSummary, input?: VoicePlatformCoverageAssertionInput) => VoicePlatformCoverageAssertionReport;
+export declare const assertVoicePlatformCoverage: (summary: VoicePlatformCoverageSummary, input?: VoicePlatformCoverageAssertionInput) => VoicePlatformCoverageAssertionReport;
+export declare const createVoicePlatformCoverageRoutes: (options: VoicePlatformCoverageRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;