@absolutejs/voice 0.0.22-beta.522 → 0.0.22-beta.524

package/dist/types.d.ts

@@ -723,6 +723,12 @@ export type VoiceExpectedSpeakerTurn = {
     speaker: string;
     text: string;
 };
+/**
+ * Configures one of the plugin's optional route surfaces. Pass that surface's
+ * options object to mount it, `false` (or omit) to leave it off. Surfaces whose
+ * options are entirely optional may also be enabled with `true` for defaults.
+ */
+export type VoiceSurfaceConfig<O> = false | O | (Record<string, never> extends O ? true : never);
 export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
     costTelemetry?: VoiceCostTelemetryConfig<TContext, TSession, TResult>;
     path: string;
@@ -750,6 +756,83 @@ export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionR
     monitor?: VoiceMonitorRuntimeBinding;
     profileSwitchGuard?: VoicePluginProfileSwitchGuardConfig<TContext, TSession, TResult>;
     trace?: VoiceTraceEventStore;
+    assistantHealth?: VoiceSurfaceConfig<import("./assistantHealth").VoiceAssistantHealthRoutesOptions>;
+    auditDelivery?: VoiceSurfaceConfig<import("./auditDeliveryRoutes").VoiceAuditDeliveryRoutesOptions>;
+    auditTrail?: VoiceSurfaceConfig<import("./auditRoutes").VoiceAuditTrailRoutesOptions>;
+    bargeIn?: VoiceSurfaceConfig<import("./bargeInRoutes").VoiceBargeInRoutesOptions>;
+    browserCallProfile?: VoiceSurfaceConfig<import("./browserCallProfiles").VoiceBrowserCallProfileRoutesOptions>;
+    browserMedia?: VoiceSurfaceConfig<import("./browserMediaRoutes").VoiceBrowserMediaRoutesOptions>;
+    callDebugger?: VoiceSurfaceConfig<import("./callDebugger").VoiceCallDebuggerRoutesOptions>;
+    campaign?: VoiceSurfaceConfig<import("./campaign").VoiceCampaignRoutesOptions>;
+    competitiveCoverage?: VoiceSurfaceConfig<import("./competitiveCoverage").VoiceCompetitiveCoverageRoutesOptions>;
+    dataControl?: VoiceSurfaceConfig<import("./dataControl").VoiceDataControlRoutesOptions>;
+    deliveryRuntime?: VoiceSurfaceConfig<import("./deliveryRuntime").VoiceDeliveryRuntimeRoutesOptions>;
+    deliverySink?: VoiceSurfaceConfig<import("./deliverySinkRoutes").VoiceDeliverySinkRoutesOptions>;
+    demoReady?: VoiceSurfaceConfig<import("./demoReadyRoutes").VoiceDemoReadyRoutesOptions>;
+    diagnostics?: VoiceSurfaceConfig<import("./diagnosticsRoutes").VoiceDiagnosticsRoutesOptions>;
+    eval?: VoiceSurfaceConfig<import("./evalRoutes").VoiceEvalRoutesOptions>;
+    guardrail?: VoiceSurfaceConfig<import("./guardrails").VoiceGuardrailRoutesOptions>;
+    handoffHealth?: VoiceSurfaceConfig<import("./handoffHealth").VoiceHandoffHealthRoutesOptions>;
+    htmxDashboard?: VoiceSurfaceConfig<import("./htmxDashboardRoutes").VoiceHTMXDashboardRoutesOptions>;
+    incidentBundle?: VoiceSurfaceConfig<import("./incidentBundle").VoiceIncidentBundleRoutesOptions>;
+    incidentTimeline?: VoiceSurfaceConfig<import("./incidentTimeline").VoiceIncidentTimelineRoutesOptions>;
+    liveLatency?: VoiceSurfaceConfig<import("./liveLatency").VoiceLiveLatencyRoutesOptions>;
+    liveMonitor?: VoiceSurfaceConfig<import("./monitor").VoiceLiveMonitorRoutesOptions>;
+    liveOpsConsole?: VoiceSurfaceConfig<import("./liveOps").VoiceLiveOpsRoutesOptions>;
+    mediaPipeline?: VoiceSurfaceConfig<import("./mediaPipelineRoutes").VoiceMediaPipelineRoutesOptions>;
+    monitorReport?: VoiceSurfaceConfig<import("./voiceMonitoring").VoiceMonitorRoutesOptions>;
+    monitorRunner?: VoiceSurfaceConfig<import("./voiceMonitoring").VoiceMonitorRunnerRoutesOptions>;
+    observabilityExport?: VoiceSurfaceConfig<import("./observabilityExport").VoiceObservabilityExportRoutesOptions>;
+    observabilityExportReplay?: VoiceSurfaceConfig<import("./observabilityExport").VoiceObservabilityExportReplayRoutesOptions>;
+    operationalStatus?: VoiceSurfaceConfig<import("./operationalStatus").VoiceOperationalStatusRoutesOptions>;
+    operationsRecord?: VoiceSurfaceConfig<import("./operationsRecord").VoiceOperationsRecordRoutesOptions>;
+    opsActionAudit?: VoiceSurfaceConfig<import("./opsActionAuditRoutes").VoiceOpsActionAuditRoutesOptions>;
+    opsConsole?: VoiceSurfaceConfig<import("./opsConsoleRoutes").VoiceOpsConsoleRoutesOptions>;
+    opsRecovery?: VoiceSurfaceConfig<import("./opsRecovery").VoiceOpsRecoveryRoutesOptions>;
+    opsStatus?: VoiceSurfaceConfig<import("./opsStatus").VoiceOpsStatusRoutesOptions>;
+    opsWebhookReceiver?: VoiceSurfaceConfig<import("./opsWebhook").VoiceOpsWebhookReceiverRoutesOptions>;
+    outcomeContract?: VoiceSurfaceConfig<import("./outcomeContract").VoiceOutcomeContractRoutesOptions>;
+    phoneAgentProductionSmoke?: VoiceSurfaceConfig<import("./phoneAgentProductionSmoke").VoicePhoneAgentProductionSmokeRoutesOptions>;
+    platformCoverage?: VoiceSurfaceConfig<import("./platformCoverage").VoicePlatformCoverageRoutesOptions>;
+    postCallAnalysis?: VoiceSurfaceConfig<import("./postCallAnalysis").VoicePostCallAnalysisRoutesOptions>;
+    productionReadiness?: VoiceSurfaceConfig<import("./productionReadiness").VoiceProductionReadinessRoutesOptions>;
+    profileSwitchLiveDecision?: VoiceSurfaceConfig<import("./profileSwitchRecommendation").VoiceProfileSwitchLiveDecisionRoutesOptions>;
+    profileSwitchPolicyProof?: VoiceSurfaceConfig<import("./profileSwitchRecommendation").VoiceProfileSwitchPolicyProofRoutesOptions>;
+    profileSwitchReadiness?: VoiceSurfaceConfig<import("./profileSwitchRecommendation").VoiceProfileSwitchReadinessRoutesOptions>;
+    proofPack?: VoiceSurfaceConfig<import("./proofPack").VoiceProofPackRoutesOptions>;
+    proofTrend?: VoiceSurfaceConfig<import("./proofTrends").VoiceProofTrendRoutesOptions>;
+    proofTrendRecommendation?: VoiceSurfaceConfig<import("./proofTrends").VoiceProofTrendRecommendationRoutesOptions>;
+    providerCapability?: VoiceSurfaceConfig<import("./providerCapabilities").VoiceProviderCapabilityRoutesOptions>;
+    providerContractMatrix?: VoiceSurfaceConfig<import("./providerStackRecommendations").VoiceProviderContractMatrixRoutesOptions>;
+    providerDecisionTrace?: VoiceSurfaceConfig<import("./providerDecisionTraces").VoiceProviderDecisionTraceRoutesOptions>;
+    providerHealth?: VoiceSurfaceConfig<import("./providerHealth").VoiceProviderHealthRoutesOptions>;
+    providerOrchestration?: VoiceSurfaceConfig<import("./providerOrchestration").VoiceProviderOrchestrationRoutesOptions>;
+    providerSlo?: VoiceSurfaceConfig<import("./providerSlo").VoiceProviderSloRoutesOptions>;
+    quality?: VoiceSurfaceConfig<import("./qualityRoutes").VoiceQualityRoutesOptions>;
+    realCallEvidenceRuntime?: VoiceSurfaceConfig<import("./proofTrends").VoiceRealCallEvidenceRuntimeRoutesOptions>;
+    realCallProfileHistory?: VoiceSurfaceConfig<import("./proofTrends").VoiceRealCallProfileHistoryRoutesOptions>;
+    realCallProfileRecoveryAction?: VoiceSurfaceConfig<import("./proofTrends").VoiceRealCallProfileRecoveryActionRoutesOptions>;
+    realtimeChannel?: VoiceSurfaceConfig<import("./realtimeChannel").VoiceRealtimeChannelRoutesOptions>;
+    realtimeProviderContract?: VoiceSurfaceConfig<import("./realtimeProviderContracts").VoiceRealtimeProviderContractRoutesOptions>;
+    reconnectContract?: VoiceSurfaceConfig<import("./reconnectContract").VoiceReconnectContractRoutesOptions>;
+    reconnectProof?: VoiceSurfaceConfig<import("./reconnectContract").VoiceReconnectProofRoutesOptions>;
+    resilience?: VoiceSurfaceConfig<import("./resilienceRoutes").VoiceResilienceRoutesOptions>;
+    sessionList?: VoiceSurfaceConfig<import("./sessionReplay").VoiceSessionListRoutesOptions>;
+    sessionObservability?: VoiceSurfaceConfig<import("./sessionObservability").VoiceSessionObservabilityRoutesOptions>;
+    sessionReplay?: VoiceSurfaceConfig<import("./sessionReplay").VoiceSessionReplayRoutesOptions>;
+    sessionSnapshot?: VoiceSurfaceConfig<import("./sessionSnapshot").VoiceSessionSnapshotRoutesOptions>;
+    simulationSuite?: VoiceSurfaceConfig<import("./simulationSuite").VoiceSimulationSuiteRoutesOptions>;
+    sloCalibration?: VoiceSurfaceConfig<import("./sloCalibration").VoiceSloCalibrationRoutesOptions>;
+    sloReadinessThreshold?: VoiceSurfaceConfig<import("./sloCalibration").VoiceSloReadinessThresholdRoutesOptions>;
+    telephonyCarrierMatrix?: VoiceSurfaceConfig<import("./telephony/matrix").VoiceTelephonyCarrierMatrixRoutesOptions>;
+    telephonyMedia?: VoiceSurfaceConfig<import("./telephonyMediaRoutes").VoiceTelephonyMediaRoutesOptions>;
+    telephonyWebhook?: VoiceSurfaceConfig<import("./telephonyOutcome").VoiceTelephonyWebhookRoutesOptions>;
+    telephonyWebhookSecurity?: VoiceSurfaceConfig<import("./telephony/security").VoiceTelephonyWebhookSecurityRoutesOptions>;
+    toolContract?: VoiceSurfaceConfig<import("./toolContract").VoiceToolContractRoutesOptions>;
+    traceDelivery?: VoiceSurfaceConfig<import("./traceDeliveryRoutes").VoiceTraceDeliveryRoutesOptions>;
+    traceTimeline?: VoiceSurfaceConfig<import("./traceTimeline").VoiceTraceTimelineRoutesOptions>;
+    turnLatency?: VoiceSurfaceConfig<import("./turnLatency").VoiceTurnLatencyRoutesOptions>;
+    turnQuality?: VoiceSurfaceConfig<import("./turnQuality").VoiceTurnQualityRoutesOptions>;
 } & VoiceRouteConfig<TContext, TSession, TResult>;
 export type VoiceSessionRecordingConfig = {
     channels?: ReadonlyArray<"assistant" | "user">;

package/dist/variableAnalytics.d.ts

@@ -0,0 +1,47 @@
+export type VoiceAnalyticsVariableValue = string | number | boolean | null;
+export type VoiceAnalyticsCall = {
+    sessionId: string;
+    variables: Record<string, VoiceAnalyticsVariableValue>;
+    durationSeconds?: number;
+    costUsd?: number;
+    outcome?: string;
+    success?: boolean;
+    at?: number;
+};
+export type VoiceVariableValueStats = {
+    value: string;
+    count: number;
+    share: number;
+    successRate: number | null;
+    avgDurationSeconds: number | null;
+    avgCostUsd: number | null;
+    outcomes: Record<string, number>;
+};
+export type VoiceVariableBreakdown = {
+    variable: string;
+    distinctValues: number;
+    missingCount: number;
+    values: VoiceVariableValueStats[];
+};
+export type VoiceVariableAnalyticsReport = {
+    totalCalls: number;
+    overall: {
+        successRate: number | null;
+        avgDurationSeconds: number | null;
+        avgCostUsd: number | null;
+    };
+    byVariable: Record<string, VoiceVariableBreakdown>;
+};
+export type BuildVoiceVariableAnalyticsInput = {
+    calls: ReadonlyArray<VoiceAnalyticsCall>;
+    /** Variable keys to break analytics down by. */
+    variables: ReadonlyArray<string>;
+    /**
+     * Treat these outcome strings as successes when a call has no explicit
+     * `success` flag. Case-insensitive.
+     */
+    successOutcomes?: ReadonlyArray<string>;
+    /** Cap the values returned per variable (highest count first). */
+    topValuesPerVariable?: number;
+};
+export declare const buildVoiceVariableAnalytics: (input: BuildVoiceVariableAnalyticsInput) => VoiceVariableAnalyticsReport;

package/dist/vue/VoiceCostDashboard.d.ts

@@ -53,5 +53,5 @@ export declare const VoiceCostDashboard: import("vue").DefineComponent<import("v
     title: string;
     currency: string;
     emptyMessage: string;
-    bucketBy: "day" | "month" | "hour" | undefined;
+    bucketBy: "day" | "hour" | "month" | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/zeroDataRetention.d.ts

@@ -0,0 +1,41 @@
+import type { VoiceTraceEvent } from "./trace";
+import type { VoiceTurnRecord } from "./types";
+export type VoiceZeroDataRetentionMode = "off" | "strict" | "custom";
+export type VoiceZeroDataRetentionRetainFlags = {
+    /** Persist committed/partial transcript text. */
+    transcriptText: boolean;
+    /** Persist assistant response text. */
+    assistantText: boolean;
+    /** Persist recorded audio artifacts. */
+    recordings: boolean;
+    /** Persist free-text payloads on trace events. */
+    traceText: boolean;
+    /** Persist arbitrary session/turn metadata. */
+    metadata: boolean;
+};
+export type VoiceZeroDataRetentionPolicy = {
+    mode: VoiceZeroDataRetentionMode;
+    retain: VoiceZeroDataRetentionRetainFlags;
+};
+export type CreateVoiceZeroDataRetentionPolicyOptions = {
+    mode?: VoiceZeroDataRetentionMode;
+    /** Per-flag overrides; only meaningful with mode "custom" (or to relax "strict"). */
+    retain?: Partial<VoiceZeroDataRetentionRetainFlags>;
+};
+export declare const createVoiceZeroDataRetentionPolicy: (options?: CreateVoiceZeroDataRetentionPolicyOptions) => VoiceZeroDataRetentionPolicy;
+export declare const isVoiceZeroDataRetentionActive: (policy: VoiceZeroDataRetentionPolicy) => boolean;
+export declare const shouldRetainVoiceRecording: (policy: VoiceZeroDataRetentionPolicy) => boolean;
+export declare const shouldRetainVoiceTranscript: (policy: VoiceZeroDataRetentionPolicy) => boolean;
+/**
+ * Returns a scrubbed copy of a turn record honoring the ZDR policy. Structural
+ * fields (ids, timestamps, transcript count, citation ids) are preserved;
+ * content fields are replaced with a redaction marker or dropped.
+ */
+export declare const scrubVoiceTurnForZeroDataRetention: <TResult = unknown>(turn: VoiceTurnRecord<TResult>, policy: VoiceZeroDataRetentionPolicy) => VoiceTurnRecord<TResult>;
+/**
+ * Returns a scrubbed copy of a trace event honoring the ZDR policy. Drops or
+ * masks free-text payload fields while keeping the event type, ids, and
+ * timestamps so observability/lifecycle accounting still works.
+ */
+export declare const scrubVoiceTraceForZeroDataRetention: (event: VoiceTraceEvent, policy: VoiceZeroDataRetentionPolicy) => VoiceTraceEvent;
+export declare const VOICE_ZERO_DATA_RETENTION_REDACTION_MARKER = "[redacted:zdr]";

package/package.json

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