@absolutejs/voice 0.0.22-beta.391 → 0.0.22-beta.393

package/dist/campaign.d.ts

@@ -390,6 +390,31 @@ export type VoiceCampaignTelephonyOutcomeResult = {
     status?: 'failed' | 'succeeded';
     attemptId?: string;
 };
+export type VoiceCampaignTelephonyOutcomeSnapshot<TResult = unknown> = {
+    action: VoiceTelephonyOutcomeDecision['action'];
+    at: number;
+    campaignOutcome: VoiceCampaignTelephonyOutcomeResult;
+    disposition?: VoiceTelephonyOutcomeDecision['disposition'];
+    duplicate?: boolean;
+    idempotencyKey?: string;
+    provider?: string;
+    routeResult?: TResult;
+    sessionId?: string;
+    source?: VoiceTelephonyOutcomeDecision['source'];
+};
+export type VoiceCampaignTelephonyOutcomeRecorderOptions<TResult = unknown> = VoiceCampaignTelephonyOutcomeOptions<TResult> & {
+    maxSnapshots?: number;
+    now?: () => number;
+};
+export type VoiceCampaignTelephonyOutcomeRecorderRecordInput<TResult = unknown> = VoiceTelephonyWebhookDecision<TResult> & {
+    provider?: string;
+};
+export type VoiceCampaignTelephonyOutcomeRecorder<TResult = unknown> = {
+    clear: () => void;
+    handler: (provider?: string) => (input: VoiceTelephonyWebhookDecision<TResult>) => Promise<void>;
+    list: () => VoiceCampaignTelephonyOutcomeSnapshot<TResult>[];
+    record: (input: VoiceCampaignTelephonyOutcomeRecorderRecordInput<TResult>) => Promise<VoiceCampaignTelephonyOutcomeSnapshot<TResult>>;
+};
 export declare const importVoiceCampaignRecipients: (options: VoiceCampaignRecipientImportOptions) => VoiceCampaignRecipientImportResult;
 export declare const createVoiceMemoryCampaignStore: () => VoiceCampaignStore;
 export declare const summarizeVoiceCampaigns: (records: VoiceCampaignRecord[]) => VoiceCampaignSummary;
@@ -399,6 +424,7 @@ export declare const createVoiceCampaignWorker: (options: VoiceCampaignWorkerOpt
 export declare const createVoiceCampaignWorkerLoop: (options: VoiceCampaignWorkerLoopOptions) => VoiceCampaignWorkerLoop;
 export declare const applyVoiceCampaignTelephonyOutcome: <TResult = unknown>(input: VoiceCampaignTelephonyOutcomeInput<TResult>, options?: VoiceCampaignTelephonyOutcomeOptions<TResult>) => Promise<VoiceCampaignTelephonyOutcomeResult>;
 export declare const createVoiceCampaignTelephonyOutcomeHandler: <TResult = unknown>(options: VoiceCampaignTelephonyOutcomeOptions<TResult>) => (input: VoiceTelephonyWebhookDecision<TResult>) => Promise<VoiceCampaignTelephonyOutcomeResult>;
+export declare const createVoiceCampaignTelephonyOutcomeRecorder: <TResult = unknown>(options?: VoiceCampaignTelephonyOutcomeRecorderOptions<TResult>) => VoiceCampaignTelephonyOutcomeRecorder<TResult>;
 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;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { voice } from './plugin';
-export { applyVoiceCampaignTelephonyOutcome, assertVoiceCampaignReadinessEvidence, buildVoiceCampaignObservabilityReport, createVoiceCampaignTelephonyOutcomeHandler, createVoiceCampaign, createVoiceCampaignRoutes, createVoiceCampaignWorker, createVoiceCampaignWorkerLoop, createVoiceMemoryCampaignStore, evaluateVoiceCampaignReadinessEvidence, importVoiceCampaignRecipients, renderVoiceCampaignObservabilityHTML, renderVoiceCampaignsHTML, runVoiceCampaignProof, runVoiceCampaignReadinessProof, summarizeVoiceCampaigns } from './campaign';
+export { applyVoiceCampaignTelephonyOutcome, assertVoiceCampaignReadinessEvidence, buildVoiceCampaignObservabilityReport, createVoiceCampaignTelephonyOutcomeHandler, createVoiceCampaignTelephonyOutcomeRecorder, 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';
@@ -116,7 +116,7 @@ export { resolveVoiceRuntimePreset } from './presets';
 export { resolveTurnDetectionConfig, TURN_PROFILE_DEFAULTS } from './turnProfiles';
 export { createVoiceCallReviewFromLiveTelephonyReport, createVoiceCallReviewRecorder, renderVoiceCallReviewHTML, renderVoiceCallReviewMarkdown } from './testing/review';
 export { getDefaultVoiceTelephonyBenchmarkScenarios, runVoiceTelephonyBenchmark, runVoiceTelephonyBenchmarkScenario, runVoiceTelephonyMediaOperationsSmoke, summarizeVoiceTelephonyBenchmark } from './testing/telephony';
-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 { 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, VoiceCampaignTelephonyOutcomeInput, VoiceCampaignTelephonyOutcomeOptions, VoiceCampaignTelephonyOutcomeRecorder, VoiceCampaignTelephonyOutcomeRecorderOptions, VoiceCampaignTelephonyOutcomeRecorderRecordInput, VoiceCampaignTelephonyOutcomeResult, VoiceCampaignTelephonyOutcomeSnapshot, VoiceCampaignTelephonyOutcomeStatus, 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';

package/dist/index.js

@@ -7310,6 +7310,49 @@ var createVoiceCampaignTelephonyOutcomeHandler = (options) => (input) => applyVo
   routeResult: input.routeResult,
   sessionId: input.sessionId
 }, options);
+var createVoiceCampaignTelephonyOutcomeRecorder = (options = {}) => {
+  const snapshots = [];
+  const maxSnapshots = Math.max(0, options.maxSnapshots ?? 20);
+  const now = options.now ?? Date.now;
+  const record = async (input) => {
+    const campaignOutcome = await applyVoiceCampaignTelephonyOutcome({
+      decision: input.decision,
+      event: input.event,
+      routeResult: input.routeResult,
+      sessionId: input.sessionId
+    }, options);
+    const snapshot = {
+      action: input.decision.action,
+      at: now(),
+      campaignOutcome,
+      disposition: input.decision.disposition,
+      duplicate: input.duplicate,
+      idempotencyKey: input.idempotencyKey,
+      provider: input.provider ?? input.event.provider,
+      routeResult: input.routeResult,
+      sessionId: input.sessionId,
+      source: input.decision.source
+    };
+    if (maxSnapshots > 0) {
+      snapshots.unshift(snapshot);
+      snapshots.splice(maxSnapshots);
+    }
+    return snapshot;
+  };
+  return {
+    clear: () => {
+      snapshots.splice(0);
+    },
+    handler: (provider) => async (input) => {
+      await record({
+        ...input,
+        provider: provider ?? input.event.provider
+      });
+    },
+    list: () => snapshots.map((snapshot) => ({ ...snapshot })),
+    record
+  };
+};
 var defaultProofRecipients = () => [
   {
     id: "campaign-proof-recipient-1",
@@ -18307,7 +18350,7 @@ var formatVoiceProofTrendAge = (ageMs) => {
 // src/providerRouterTraces.ts
 var buildVoiceProviderRouterTraceEvent = (options) => ({
   at: options.at ?? options.event.at,
-  id: options.id,
+  id: options.id ?? `${options.sessionId}:${options.turnId ?? "session"}:${options.event.provider}:${options.event.status}:${String(options.at ?? options.event.at)}`,
   metadata: options.metadata,
   payload: {
     ...options.event,
@@ -18322,7 +18365,7 @@ var buildVoiceProviderRouterTraceEvent = (options) => ({
 var appendVoiceProviderRouterTraceEvent = async (options) => options.store.append(buildVoiceProviderRouterTraceEvent(options));
 var buildVoiceIOProviderRouterTraceEvent = (options) => ({
   at: options.at ?? options.event.at,
-  id: options.id,
+  id: options.id ?? `${options.sessionId}:${options.event.kind}:${options.event.operation}:${options.event.provider}:${options.event.status}:${String(options.at ?? options.event.at)}`,
   metadata: options.metadata,
   payload: {
     ...options.event,
@@ -39750,6 +39793,7 @@ export {
   createVoiceCompetitiveCoverageRoutes,
   createVoiceCampaignWorkerLoop,
   createVoiceCampaignWorker,
+  createVoiceCampaignTelephonyOutcomeRecorder,
   createVoiceCampaignTelephonyOutcomeHandler,
   createVoiceCampaignRoutes,
   createVoiceCampaign,

package/dist/providerRouterTraces.d.ts

@@ -29,7 +29,7 @@ export type VoiceProviderRouterTraceAppendOptions<TEvent extends StoredVoiceTrac
 export type VoiceIOProviderRouterTraceAppendOptions<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TProvider extends string = string> = VoiceIOProviderRouterTraceEventOptions<TProvider> & {
     store: Pick<VoiceTraceEventStore<TEvent>, 'append'>;
 };
-export declare const buildVoiceProviderRouterTraceEvent: <TProvider extends string = string>(options: VoiceProviderRouterTraceEventOptions<TProvider>) => VoiceTraceEvent;
+export declare const buildVoiceProviderRouterTraceEvent: <TProvider extends string = string>(options: VoiceProviderRouterTraceEventOptions<TProvider>) => StoredVoiceTraceEvent;
 export declare const appendVoiceProviderRouterTraceEvent: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TProvider extends string = string>(options: VoiceProviderRouterTraceAppendOptions<TEvent, TProvider>) => Promise<TEvent>;
-export declare const buildVoiceIOProviderRouterTraceEvent: <TProvider extends string = string>(options: VoiceIOProviderRouterTraceEventOptions<TProvider>) => VoiceTraceEvent;
+export declare const buildVoiceIOProviderRouterTraceEvent: <TProvider extends string = string>(options: VoiceIOProviderRouterTraceEventOptions<TProvider>) => StoredVoiceTraceEvent;
 export declare const appendVoiceIOProviderRouterTraceEvent: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TProvider extends string = string>(options: VoiceIOProviderRouterTraceAppendOptions<TEvent, TProvider>) => Promise<TEvent>;

package/package.json

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