@absolutejs/voice 0.0.22-beta.490 → 0.0.22-beta.492

package/dist/campaignControls.d.ts

@@ -0,0 +1,37 @@
+import type { VoiceCampaign, VoiceCampaignAttemptStatus, VoiceCampaignRecipient, VoiceCampaignRecord, VoiceCampaignTimeWindow } from "./campaign";
+export type VoiceCampaignDisposition = "answered" | "busy" | "failed" | "no-answer" | "voicemail";
+export type VoiceCampaignDispositionRetryRule = {
+    backoffMs?: number;
+    maxAttempts?: number;
+    retry?: boolean;
+};
+export type VoiceCampaignDispositionRetryPolicy = Partial<Record<VoiceCampaignDisposition, VoiceCampaignDispositionRetryRule>>;
+export type VoiceDNCList = {
+    contains: (phone: string) => boolean | Promise<boolean>;
+};
+export declare const normalizePhoneNumber: (phone: string) => string;
+export declare const createInMemoryDNCList: (phones: ReadonlyArray<string>) => VoiceDNCList;
+export declare const isPhoneOnDNC: (phone: string, list: VoiceDNCList) => Promise<boolean>;
+export type VoiceCampaignWindowCheckInput = {
+    now?: Date;
+    window: VoiceCampaignTimeWindow;
+};
+export declare const isWithinCampaignWindow: (input: VoiceCampaignWindowCheckInput) => boolean;
+export declare const shouldRetryCampaignAttempt: (input: {
+    attempts: number;
+    campaign: Pick<VoiceCampaign, "maxAttempts">;
+    disposition?: VoiceCampaignDisposition;
+    policy?: VoiceCampaignDispositionRetryPolicy;
+}) => {
+    backoffMs?: number;
+    retry: boolean;
+};
+export type VoiceCampaignDispositionSummary = {
+    attempts: number;
+    byDisposition: Partial<Record<VoiceCampaignDisposition, number>>;
+    byStatus: Record<VoiceCampaignAttemptStatus, number>;
+    campaignId: string;
+    recipientsByStatus: Record<VoiceCampaignRecipient["status"], number>;
+    totalRecipients: number;
+};
+export declare const summarizeVoiceCampaignDispositions: (record: VoiceCampaignRecord) => VoiceCampaignDispositionSummary;

package/dist/index.d.ts

@@ -83,6 +83,8 @@ export { createPunctuationSemanticTurnDetector, createRegexSemanticTurnDetector,
 export { VOICE_WEBHOOK_SIGNATURE_HEADER, VOICE_WEBHOOK_TIMESTAMP_HEADER, extractVoiceWebhookSignatureFromHeaders, signVoiceWebhookBody, verifyVoiceWebhookSignature, } from "./webhookVerification";
 export { describeVoiceAgentUIState, deriveVoiceAgentUIState, voiceAgentUIStateOrder, } from "./agentState";
 export type { VoiceAgentUIInput, VoiceAgentUIState, } from "./agentState";
+export { createInMemoryDNCList, isPhoneOnDNC, isWithinCampaignWindow, normalizePhoneNumber, shouldRetryCampaignAttempt, summarizeVoiceCampaignDispositions, } from "./campaignControls";
+export type { VoiceCampaignDisposition, VoiceCampaignDispositionRetryPolicy, VoiceCampaignDispositionRetryRule, VoiceCampaignDispositionSummary, VoiceCampaignWindowCheckInput, VoiceDNCList, } from "./campaignControls";
 export { createVoiceBackchannelDriver } from "./backchannel";
 export type { VoiceBackchannelCue, VoiceBackchannelDriver, VoiceBackchannelDriverOptions, } from "./backchannel";
 export { createVoiceIVRSession, describeVoiceIVRPlan, evaluateVoiceIVRPlan, } from "./ivrPlan";
@@ -95,8 +97,8 @@ export type { VoiceWebhookVerificationInput, VoiceWebhookVerificationReason, Voi
 export type { CreatePunctuationSemanticTurnDetectorOptions, CreateRegexSemanticTurnDetectorOptions, VoiceSemanticTurnDetector, VoiceSemanticTurnInput, VoiceSemanticTurnVerdict, } from "./semanticTurn";
 export { createMonologueAMDDetector } from "./amdDetector";
 export type { MonologueAMDDetectorOptions, VoiceAMDDetector, VoiceAMDDetectorInput, VoiceAMDVerdict, } from "./amdDetector";
-export { createVoiceRAGTool } from "./ragTool";
-export type { VoiceRAGCollectionLike, VoiceRAGQueryResult, VoiceRAGSearchInput, VoiceRAGToolArgs, VoiceRAGToolOptions, VoiceRAGToolResult, } from "./ragTool";
+export { createVoiceRAGTool, extractVoiceRAGCitations } from "./ragTool";
+export type { VoiceRAGCitationSummary, VoiceRAGCollectionLike, VoiceRAGQueryResult, VoiceRAGSearchInput, VoiceRAGToolArgs, VoiceRAGToolOptions, VoiceRAGToolResult, } from "./ragTool";
 export { createVoiceApiRequestTool, createVoiceDTMFTool, createVoiceEndCallTool, createVoiceTransferCallTool, createVoiceVoicemailDetectionTool, } from "./agentTools";
 export { fromVapiAssistantConfig } from "./vapiAdapter";
 export type { VapiAssistantConfig, VapiAssistantConfigModel, VapiAssistantConfigTool, VapiAssistantConfigTranscriber, VapiAssistantConfigTransferDestination, VapiAssistantConfigVoice, VapiAssistantMessage, VoiceFromVapiAssistantOptions, VoiceFromVapiAssistantResult, VoiceFromVapiCustomToolFactory, VoiceFromVapiCustomToolInput, VoiceFromVapiDTMFFactory, VoiceFromVapiKnowledgeBase, VoiceFromVapiModelFactory, VoiceFromVapiModelFactoryInput, VoiceFromVapiRouteHints, VoiceFromVapiUnsupportedReason, } from "./vapiAdapter";

package/dist/index.js

@@ -35515,6 +35515,90 @@ var voiceAgentUIStateOrder = [
   "thinking",
   "speaking"
 ];
+// src/campaignControls.ts
+var normalizePhoneNumber = (phone) => phone.replace(/[\s()-]/g, "").trim();
+var createInMemoryDNCList = (phones) => {
+  const set = new Set(phones.map(normalizePhoneNumber));
+  return {
+    contains: (phone) => set.has(normalizePhoneNumber(phone))
+  };
+};
+var isPhoneOnDNC = async (phone, list) => Promise.resolve(list.contains(phone));
+var isWithinCampaignWindow = (input) => {
+  const now = input.now ?? new Date;
+  const offsetMinutes = input.window.timeZoneOffsetMinutes ?? 0;
+  const shifted = new Date(now.getTime() + offsetMinutes * 60000);
+  const day = shifted.getUTCDay();
+  if (input.window.daysOfWeek && !input.window.daysOfWeek.includes(day)) {
+    return false;
+  }
+  const hour = shifted.getUTCHours();
+  if (input.window.startHour <= input.window.endHour) {
+    return hour >= input.window.startHour && hour < input.window.endHour;
+  }
+  return hour >= input.window.startHour || hour < input.window.endHour;
+};
+var shouldRetryCampaignAttempt = (input) => {
+  if (input.attempts >= input.campaign.maxAttempts) {
+    return { retry: false };
+  }
+  const rule = input.disposition ? input.policy?.[input.disposition] : undefined;
+  if (rule && rule.retry === false) {
+    return { retry: false };
+  }
+  if (rule?.maxAttempts !== undefined && input.attempts >= rule.maxAttempts) {
+    return { retry: false };
+  }
+  return { backoffMs: rule?.backoffMs, retry: true };
+};
+var dispositionFromAttempt = (attempt) => {
+  const metadata = attempt.metadata;
+  if (metadata && typeof metadata.disposition === "string") {
+    return metadata.disposition;
+  }
+  if (attempt.status === "failed") {
+    return "failed";
+  }
+  if (attempt.status === "succeeded") {
+    return "answered";
+  }
+  return;
+};
+var summarizeVoiceCampaignDispositions = (record) => {
+  const byStatus = {
+    canceled: 0,
+    failed: 0,
+    queued: 0,
+    running: 0,
+    succeeded: 0
+  };
+  const byDisposition = {};
+  for (const attempt of record.attempts) {
+    byStatus[attempt.status] = (byStatus[attempt.status] ?? 0) + 1;
+    const disposition = dispositionFromAttempt(attempt);
+    if (disposition) {
+      byDisposition[disposition] = (byDisposition[disposition] ?? 0) + 1;
+    }
+  }
+  const recipientsByStatus = {
+    canceled: 0,
+    completed: 0,
+    failed: 0,
+    pending: 0,
+    queued: 0
+  };
+  for (const recipient of record.recipients) {
+    recipientsByStatus[recipient.status] = (recipientsByStatus[recipient.status] ?? 0) + 1;
+  }
+  return {
+    attempts: record.attempts.length,
+    byDisposition,
+    byStatus,
+    campaignId: record.campaign.id,
+    recipientsByStatus,
+    totalRecipients: record.recipients.length
+  };
+};
 // src/backchannel.ts
 var DEFAULT_CUES = [
   { text: "mm-hmm" },
@@ -35922,6 +36006,28 @@ var createMonologueAMDDetector = (options = {}) => {
   };
 };
 // src/ragTool.ts
+var extractVoiceRAGCitations = (toolResults, toolName = "searchKnowledgeBase") => {
+  const out = [];
+  for (const entry of toolResults) {
+    if (entry.toolName !== toolName) {
+      continue;
+    }
+    const result = entry.result;
+    const citations = result?.citations;
+    if (!Array.isArray(citations)) {
+      continue;
+    }
+    for (const citation of citations) {
+      out.push({
+        chunkId: citation.chunkId,
+        score: citation.score,
+        source: citation.source,
+        title: citation.title
+      });
+    }
+  }
+  return out;
+};
 var DEFAULT_TOOL_NAME = "searchKnowledgeBase";
 var DEFAULT_DESCRIPTION = "Search the knowledge base and return short grounded citations. Use this whenever the caller asks a question that may be answered by indexed reference material.";
 var DEFAULT_TOP_K = 6;
@@ -46502,6 +46608,7 @@ export {
   summarizeVoiceHandoffHealth,
   summarizeVoiceHandoffDeliveries,
   summarizeVoiceCampaigns,
+  summarizeVoiceCampaignDispositions,
   summarizeVoiceCallerTranscript,
   summarizeVoiceBrowserMedia,
   summarizeVoiceBargeIn,
@@ -46513,6 +46620,7 @@ export {
   signVoiceWebhookBody,
   signVoiceTwilioWebhook,
   signVoicePlivoWebhook,
+  shouldRetryCampaignAttempt,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,
   saveVoiceIncidentBundleArtifact,
@@ -46684,6 +46792,7 @@ export {
   parseVoiceTelephonyWebhookEvent,
   parseVoiceSessionSnapshot,
   normalizeVoiceProofTrendReport,
+  normalizePhoneNumber,
   muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
@@ -46694,7 +46803,9 @@ export {
   listVoiceRoutingEvents,
   listVoiceProviderDecisionTraces,
   listVoiceOpsTasks,
+  isWithinCampaignWindow,
   isVoiceOpsTaskOverdue,
+  isPhoneOnDNC,
   importVoiceCampaignRecipients,
   heartbeatVoiceOpsTask,
   hasVoiceOpsTaskSLABreach,
@@ -46711,6 +46822,7 @@ export {
   fetchVoiceProofTarget,
   failVoiceOpsTask,
   extractVoiceWebhookSignatureFromHeaders,
+  extractVoiceRAGCitations,
   extractVoiceMediaPipelineIssueEntries,
   exportVoiceTrace,
   exportVoiceAuditTrail,
@@ -47116,6 +47228,7 @@ export {
   createMemoryVoiceTelephonyWebhookIdempotencyStore,
   createMemoryVoicePlivoWebhookNonceStore,
   createJSONVoiceAssistantModel,
+  createInMemoryDNCList,
   createId,
   createGeminiVoiceAssistantModel,
   createDomainPhraseHints,

package/dist/ragTool.d.ts

@@ -29,6 +29,16 @@ export type VoiceRAGToolResult = {
     query: string;
     topK: number;
 };
+export type VoiceRAGCitationSummary = {
+    chunkId: string;
+    score: number;
+    source?: string;
+    title?: string;
+};
+export declare const extractVoiceRAGCitations: (toolResults: ReadonlyArray<{
+    result?: unknown;
+    toolName: string;
+}>, toolName?: string) => VoiceRAGCitationSummary[];
 export type VoiceRAGToolOptions<TContext = unknown> = {
     allowedFilterKeys?: readonly string[];
     description?: string;

package/package.json

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