@absolutejs/voice 0.0.22-beta.486 → 0.0.22-beta.488

package/dist/callerMemory.d.ts

@@ -0,0 +1,37 @@
+import type { Transcript, VoiceSessionRecord, VoiceTurnRecord } from "./types";
+import type { VoiceAssistantMemoryNamespaceInput } from "./assistantMemory";
+export type VoiceCallerIdentity = {
+    email?: string;
+    externalId?: string;
+    phone?: string;
+};
+export type VoiceCallerMemorySnapshot = {
+    facts: Record<string, string>;
+    identity: VoiceCallerIdentity;
+    lastSessionAt: number;
+    openActions: string[];
+    summary: string;
+};
+export declare const VOICE_CALLER_MEMORY_KEY = "caller-memory-snapshot";
+export declare const buildVoiceCallerMemoryNamespace: (identity: VoiceCallerIdentity | undefined, prefix?: string) => string;
+export type CreateVoiceCallerMemoryNamespaceOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord> = {
+    identifyCaller: (input: VoiceAssistantMemoryNamespaceInput<TContext, TSession>) => Promise<VoiceCallerIdentity | undefined> | VoiceCallerIdentity | undefined;
+    prefix?: string;
+};
+export declare const createVoiceCallerMemoryNamespace: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: CreateVoiceCallerMemoryNamespaceOptions<TContext, TSession>) => (input: VoiceAssistantMemoryNamespaceInput<TContext, TSession>) => Promise<string>;
+export type VoiceCallerMemoryCompletion = (input: {
+    prompt: string;
+    systemPrompt?: string;
+}) => Promise<string>;
+export type SummarizeVoiceCallerTranscriptOptions = {
+    completion: VoiceCallerMemoryCompletion;
+    previousSnapshot?: VoiceCallerMemorySnapshot;
+    systemPrompt?: string;
+};
+export type VoiceCallerMemorySummarizerInput = {
+    identity: VoiceCallerIdentity;
+    options: SummarizeVoiceCallerTranscriptOptions;
+    transcripts?: Transcript[];
+    turns: VoiceTurnRecord[];
+};
+export declare const summarizeVoiceCallerTranscript: (input: VoiceCallerMemorySummarizerInput) => Promise<VoiceCallerMemorySnapshot>;

package/dist/index.d.ts

@@ -81,6 +81,10 @@ export { describeVoiceAssistantMode, resolveVoiceAssistantMode, } from "./assist
 export type { VoiceAssistantMode, VoiceAssistantModality, VoiceAssistantModeDescriptor, VoiceSemanticVADConfig, } from "./assistantMode";
 export { createPunctuationSemanticTurnDetector, createRegexSemanticTurnDetector, } from "./semanticTurn";
 export { VOICE_WEBHOOK_SIGNATURE_HEADER, VOICE_WEBHOOK_TIMESTAMP_HEADER, extractVoiceWebhookSignatureFromHeaders, signVoiceWebhookBody, verifyVoiceWebhookSignature, } from "./webhookVerification";
+export { createVoiceIVRSession, describeVoiceIVRPlan, evaluateVoiceIVRPlan, } from "./ivrPlan";
+export type { VoiceIVRBranch, VoiceIVRDecision, VoiceIVRInput, VoiceIVRMatch, VoiceIVRPlan, VoiceIVRSession, } from "./ivrPlan";
+export { VOICE_CALLER_MEMORY_KEY, buildVoiceCallerMemoryNamespace, createVoiceCallerMemoryNamespace, summarizeVoiceCallerTranscript, } from "./callerMemory";
+export type { CreateVoiceCallerMemoryNamespaceOptions, SummarizeVoiceCallerTranscriptOptions, VoiceCallerIdentity, VoiceCallerMemoryCompletion, VoiceCallerMemorySnapshot, VoiceCallerMemorySummarizerInput, } from "./callerMemory";
 export { aggregateVoiceTurnLatencySpans, buildOTELSpanId, buildOTELTraceId, buildVoiceOTELPayload, createVoiceOTELHTTPExporter, } from "./otelExporter";
 export type { VoiceOTELAttribute, VoiceOTELExporter, VoiceOTELExporterOptions, VoiceOTELPayload, VoiceOTELResourceSpans, VoiceOTELSpan, VoiceTurnLatencySpanSet, VoiceTurnLatencySpanStage, } from "./otelExporter";
 export type { VoiceWebhookVerificationInput, VoiceWebhookVerificationReason, VoiceWebhookVerificationResult, } from "./webhookVerification";

package/dist/index.js

@@ -35475,6 +35475,181 @@ var extractVoiceWebhookSignatureFromHeaders = (headers) => {
     timestamp: get(VOICE_WEBHOOK_TIMESTAMP_HEADER)
   };
 };
+// src/ivrPlan.ts
+var speechMatchesPattern = (pattern, speech) => {
+  const normalized = speech.toLowerCase().trim();
+  if (pattern instanceof RegExp) {
+    return pattern.test(normalized);
+  }
+  const target = pattern.toLowerCase().trim();
+  if (!target) {
+    return false;
+  }
+  return normalized.includes(target);
+};
+var digitsMatchPattern = (pattern, input) => {
+  return input === pattern;
+};
+var branchMatches = (branch, input) => {
+  const matcher = branch.match;
+  if (matcher.digit && input.digits) {
+    if (input.digits === matcher.digit) {
+      return true;
+    }
+  }
+  if (matcher.digits && input.digits) {
+    if (digitsMatchPattern(matcher.digits, input.digits)) {
+      return true;
+    }
+  }
+  if (matcher.speech && input.speech) {
+    if (speechMatchesPattern(matcher.speech, input.speech)) {
+      return true;
+    }
+  }
+  return false;
+};
+var evaluateVoiceIVRPlan = (plan, input) => {
+  if (!input.digits && !input.speech) {
+    return { reason: "timeout" };
+  }
+  for (const branch of plan.branches) {
+    if (branchMatches(branch, input)) {
+      return { branch, reason: "matched" };
+    }
+  }
+  if (plan.fallbackBranchId) {
+    const fallback = plan.branches.find((branch) => branch.id === plan.fallbackBranchId);
+    if (fallback) {
+      return { branch: fallback, reason: "fallback" };
+    }
+  }
+  return { reason: "no-match" };
+};
+var createVoiceIVRSession = (plan) => {
+  const maxAttempts = plan.maxAttempts ?? 3;
+  let attempts = 0;
+  return {
+    attempt: () => attempts,
+    decide: (input) => {
+      attempts += 1;
+      return evaluateVoiceIVRPlan(plan, input);
+    },
+    exhausted: () => attempts >= maxAttempts,
+    reset: () => {
+      attempts = 0;
+    }
+  };
+};
+var describeVoiceIVRPlan = (plan) => {
+  const lines = [plan.greeting];
+  for (const branch of plan.branches) {
+    const triggers = [];
+    if (branch.match.digit) {
+      triggers.push(`press ${branch.match.digit}`);
+    }
+    if (branch.match.digits) {
+      triggers.push(`press ${branch.match.digits}`);
+    }
+    if (branch.match.speech) {
+      triggers.push(`say "${branch.match.speech instanceof RegExp ? branch.match.speech.source : branch.match.speech}"`);
+    }
+    lines.push(`- ${branch.label}: ${triggers.join(" or ")}`);
+  }
+  return lines.join(`
+`);
+};
+// src/callerMemory.ts
+var VOICE_CALLER_MEMORY_KEY = "caller-memory-snapshot";
+var normalizeIdentifier = (value) => value.trim().replace(/[^a-zA-Z0-9+@._-]/g, "-").toLowerCase();
+var buildVoiceCallerMemoryNamespace = (identity, prefix = "caller") => {
+  const identifier = identity?.externalId ?? identity?.phone ?? identity?.email ?? "anonymous";
+  return `${prefix}:${normalizeIdentifier(identifier)}`;
+};
+var createVoiceCallerMemoryNamespace = (options) => async (input) => {
+  const identity = await Promise.resolve(options.identifyCaller(input));
+  return buildVoiceCallerMemoryNamespace(identity, options.prefix);
+};
+var DEFAULT_SYSTEM_PROMPT2 = "You write structured caller memory snapshots for a voice agent. " + "Given the latest call transcript (and an optional previous snapshot), " + "merge them into JSON with shape " + '{"summary":"\u2026","facts":{"key":"value"},"openActions":["\u2026"]}. ' + "Keep summary under 240 chars. Facts must be short value strings (name, plan, last_issue). " + "openActions are concrete follow-ups still pending. JSON only.";
+var buildTranscriptBlock = (turns) => turns.map((turn, index) => {
+  const userText = turn.text.trim();
+  const assistantText = typeof turn.assistantText === "string" ? turn.assistantText.trim() : "";
+  const lines = [`Turn ${index + 1}:`];
+  if (userText) {
+    lines.push(`  user: ${userText}`);
+  }
+  if (assistantText) {
+    lines.push(`  agent: ${assistantText}`);
+  }
+  return lines.join(`
+`);
+}).join(`
+`);
+var extractJson2 = (raw) => {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    throw new Error("Caller-memory summarizer returned empty response");
+  }
+  const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(trimmed);
+  const candidate = fenced ? fenced[1].trim() : trimmed;
+  try {
+    return JSON.parse(candidate);
+  } catch {
+    const start = candidate.indexOf("{");
+    const end = candidate.lastIndexOf("}");
+    if (start >= 0 && end > start) {
+      return JSON.parse(candidate.slice(start, end + 1));
+    }
+    throw new Error("Caller-memory response was not valid JSON");
+  }
+};
+var coerceFacts = (input) => {
+  if (!input || typeof input !== "object") {
+    return {};
+  }
+  const out = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (typeof value === "string") {
+      out[key] = value;
+    } else if (value !== null && value !== undefined) {
+      out[key] = String(value);
+    }
+  }
+  return out;
+};
+var coerceActions = (input) => {
+  if (!Array.isArray(input)) {
+    return [];
+  }
+  return input.map((value) => typeof value === "string" ? value.trim() : "").filter((value) => value.length > 0);
+};
+var summarizeVoiceCallerTranscript = async (input) => {
+  const transcriptBlock = buildTranscriptBlock(input.turns);
+  const previousBlock = input.options.previousSnapshot ? `Previous snapshot:
+${JSON.stringify(input.options.previousSnapshot, null, 2)}
+
+` : "";
+  const prompt = `${previousBlock}Latest call transcript:
+${transcriptBlock}
+
+Return JSON only.`;
+  const raw = await input.options.completion({
+    prompt,
+    systemPrompt: input.options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT2
+  });
+  const parsed = extractJson2(raw);
+  if (!parsed || typeof parsed !== "object") {
+    throw new Error("Caller-memory summarizer returned non-object JSON");
+  }
+  const record = parsed;
+  return {
+    facts: coerceFacts(record.facts),
+    identity: input.identity,
+    lastSessionAt: Date.now(),
+    openActions: coerceActions(record.openActions ?? record.open_actions),
+    summary: typeof record.summary === "string" ? record.summary : ""
+  };
+};
 // src/otelExporter.ts
 var SCOPE_NAME = "@absolutejs/voice";
 var SPAN_KIND_INTERNAL = 1;
@@ -46222,6 +46397,7 @@ export {
   summarizeVoiceHandoffHealth,
   summarizeVoiceHandoffDeliveries,
   summarizeVoiceCampaigns,
+  summarizeVoiceCallerTranscript,
   summarizeVoiceBrowserMedia,
   summarizeVoiceBargeIn,
   summarizeVoiceAuditTrail,
@@ -46461,6 +46637,7 @@ export {
   evaluateVoiceMediaPipelineEvidence,
   evaluateVoiceLiveOpsEvidence,
   evaluateVoiceLiveOpsControlEvidence,
+  evaluateVoiceIVRPlan,
   evaluateVoiceGuardrailPolicy,
   evaluateVoiceDataControlEvidence,
   evaluateVoiceCompetitiveCoverage,
@@ -46470,6 +46647,7 @@ export {
   evaluateVoiceAgentSquadContractEvidence,
   encodeTwilioMulawBase64,
   encodePcmAsWav,
+  describeVoiceIVRPlan,
   describeVoiceAssistantMode,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceObservabilityExport,
@@ -46715,6 +46893,7 @@ export {
   createVoiceIncidentBundleRoutes,
   createVoiceInMemoryRealCallProfileRecoveryJobStore,
   createVoiceInMemoryMonitorRegistry,
+  createVoiceIVRSession,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,
@@ -46770,6 +46949,7 @@ export {
   createVoiceCampaignTelephonyOutcomeHandler,
   createVoiceCampaignRoutes,
   createVoiceCampaign,
+  createVoiceCallerMemoryNamespace,
   createVoiceCallReviewRecorder,
   createVoiceCallReviewFromSession,
   createVoiceCallReviewFromLiveTelephonyReport,
@@ -46922,6 +47102,7 @@ export {
   buildVoiceDataControlReport,
   buildVoiceCompetitiveCoverageReport,
   buildVoiceCampaignObservabilityReport,
+  buildVoiceCallerMemoryNamespace,
   buildVoiceCallDebuggerReport,
   buildVoiceBrowserCallProfileReport,
   buildVoiceAuditTrailReport,
@@ -46984,6 +47165,7 @@ export {
   VOICE_WEBHOOK_TIMESTAMP_HEADER,
   VOICE_WEBHOOK_SIGNATURE_HEADER,
   VOICE_LIVE_OPS_ACTIONS,
+  VOICE_CALLER_MEMORY_KEY,
   TURN_PROFILE_DEFAULTS,
   DEFAULT_VOICE_REDACTION_PATTERNS,
   DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS,

package/dist/ivrPlan.d.ts

@@ -0,0 +1,40 @@
+export type VoiceIVRMatch = {
+    digit?: string;
+    digits?: string;
+    speech?: string | RegExp;
+};
+export type VoiceIVRBranch = {
+    assistantId?: string;
+    description?: string;
+    id: string;
+    label: string;
+    match: VoiceIVRMatch;
+    metadata?: Record<string, unknown>;
+    target?: string;
+};
+export type VoiceIVRPlan = {
+    branches: readonly VoiceIVRBranch[];
+    fallbackBranchId?: string;
+    greeting: string;
+    maxAttempts?: number;
+    noMatchPrompt?: string;
+    timeoutMs?: number;
+    timeoutPrompt?: string;
+};
+export type VoiceIVRInput = {
+    digits?: string;
+    speech?: string;
+};
+export type VoiceIVRDecision = {
+    branch?: VoiceIVRBranch;
+    reason: "matched" | "no-match" | "fallback" | "timeout";
+};
+export declare const evaluateVoiceIVRPlan: (plan: VoiceIVRPlan, input: VoiceIVRInput) => VoiceIVRDecision;
+export type VoiceIVRSession = {
+    attempt: () => number;
+    decide: (input: VoiceIVRInput) => VoiceIVRDecision;
+    exhausted: () => boolean;
+    reset: () => void;
+};
+export declare const createVoiceIVRSession: (plan: VoiceIVRPlan) => VoiceIVRSession;
+export declare const describeVoiceIVRPlan: (plan: VoiceIVRPlan) => string;

package/package.json

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