@absolutejs/voice 0.0.22-beta.480 → 0.0.22-beta.482

package/dist/index.d.ts

@@ -71,6 +71,10 @@ export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, crea
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool, } from "./agent";
 export { createAIVoiceModel } from "./aiVoiceModel";
 export type { CreateAIVoiceModelOptions } from "./aiVoiceModel";
+export { createVoiceAIJudgeCompletion, createVoiceLLMJudge, } from "./llmJudge";
+export type { CreateVoiceAIJudgeCompletionOptions, CreateVoiceLLMJudgeOptions, VoiceLLMJudge, VoiceLLMJudgeCompletion, VoiceLLMJudgeCriterionVerdict, VoiceLLMJudgeInput, VoiceLLMJudgeRubric, VoiceLLMJudgeRubricCriterion, VoiceLLMJudgeVerdict, } from "./llmJudge";
+export { DEFAULT_VOICE_REDACTION_PATTERNS, createVoiceTranscriptRedactor, redactVoiceTranscript, } from "./redaction";
+export type { CreateVoiceTranscriptRedactorOptions, VoiceRedactionPattern, VoiceTranscriptRedactor, } from "./redaction";
 export { DEFAULT_VOICE_PRICE_BOOK, createVoiceCostAccountant, } from "./costAccounting";
 export type { CreateVoiceCostAccountantOptions, VoiceCostAccountant, VoiceCostBreakdown, VoiceCostLLMRecord, VoiceCostSTTRecord, VoiceCostTTSRecord, VoiceCostTelephonyRecord, VoicePriceBook, VoiceProviderRates, } from "./costAccounting";
 export { createMonologueAMDDetector } from "./amdDetector";

package/dist/index.js

@@ -4505,11 +4505,13 @@ var createVoiceSession = (options) => {
       fallbackSession.on("final", ({ transcript }) => {
         fallbackFinalReceived = true;
         lastFallbackTranscriptAt = Date.now();
-        fallbackTranscripts.push(cloneTranscript(transcript));
+        const next = options.redact ? options.redact(transcript) : transcript;
+        fallbackTranscripts.push(cloneTranscript(next));
       }),
       fallbackSession.on("partial", ({ transcript }) => {
         lastFallbackTranscriptAt = Date.now();
-        fallbackTranscripts.push(cloneTranscript(transcript));
+        const next = options.redact ? options.redact(transcript) : transcript;
+        fallbackTranscripts.push(cloneTranscript(next));
       }),
       fallbackSession.on("endOfTurn", () => {
         fallbackEndOfTurnReceived = true;
@@ -4827,10 +4829,12 @@ var createVoiceSession = (options) => {
       });
     };
     openedSession.on("partial", ({ transcript }) => {
-      runAdapterEvent("adapter.partial", () => handlePartial(transcript));
+      const next = options.redact ? options.redact(transcript) : transcript;
+      runAdapterEvent("adapter.partial", () => handlePartial(next));
     });
     openedSession.on("final", ({ transcript }) => {
-      runAdapterEvent("adapter.final", () => handleFinal(transcript));
+      const next = options.redact ? options.redact(transcript) : transcript;
+      runAdapterEvent("adapter.final", () => handleFinal(next));
     });
     openedSession.on("endOfTurn", ({ reason }) => {
       runAdapterEvent("adapter.endOfTurn", async () => {
@@ -34977,6 +34981,174 @@ var createAIVoiceModel = (options) => ({
     return output;
   }
 });
+// src/llmJudge.ts
+var DEFAULT_SYSTEM_PROMPT = "You are an impartial evaluator scoring a voice-agent transcript against a rubric. " + "For each criterion, decide pass/fail and give a one-sentence rationale grounded in the transcript. " + 'Respond with strict JSON: {"criteria":[{"criterionId":"\u2026","passed":true,"rationale":"\u2026"}],"summary":"\u2026"}.';
+var buildPrompt = (rubric, input) => {
+  const criteriaBlock = rubric.criteria.map((criterion) => `- ${criterion.id}${criterion.required ? " (required)" : ""}: ${criterion.description}`).join(`
+`);
+  const metadataBlock = input.metadata ? `
+Metadata:
+${JSON.stringify(input.metadata, null, 2)}
+` : "";
+  return `Rubric criteria:
+${criteriaBlock}
+${metadataBlock}
+Transcript:
+${input.transcript}
+
+Return JSON only.`;
+};
+var extractJson = (raw) => {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    throw new Error("LLM judge returned an 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(`LLM judge response was not valid JSON: ${raw.slice(0, 200)}`);
+  }
+};
+var parseCriteria = (payload, rubric) => {
+  if (!payload || typeof payload !== "object") {
+    throw new Error("LLM judge response is not a JSON object");
+  }
+  const root = payload;
+  const criteriaRaw = root.criteria;
+  if (!Array.isArray(criteriaRaw)) {
+    throw new Error("LLM judge response is missing the 'criteria' array");
+  }
+  const verdictById = new Map;
+  for (const entry of criteriaRaw) {
+    if (!entry || typeof entry !== "object") {
+      continue;
+    }
+    const record = entry;
+    const criterionId = typeof record.criterionId === "string" ? record.criterionId : typeof record.id === "string" ? record.id : undefined;
+    if (!criterionId) {
+      continue;
+    }
+    verdictById.set(criterionId, {
+      criterionId,
+      passed: record.passed === true,
+      rationale: typeof record.rationale === "string" ? record.rationale : ""
+    });
+  }
+  const criteria = rubric.criteria.map((criterion) => verdictById.get(criterion.id) ?? {
+    criterionId: criterion.id,
+    passed: false,
+    rationale: "Judge did not return a verdict for this criterion."
+  });
+  return {
+    criteria,
+    summary: typeof root.summary === "string" ? root.summary : undefined
+  };
+};
+var scoreVerdict = (rubric, criteria) => {
+  const totalWeight = rubric.criteria.reduce((sum, criterion) => sum + (criterion.weight ?? 1), 0);
+  if (totalWeight === 0) {
+    return { passed: false, score: 0 };
+  }
+  const weightById = new Map(rubric.criteria.map((criterion) => [criterion.id, criterion.weight ?? 1]));
+  const requiredIds = new Set(rubric.criteria.filter((criterion) => criterion.required).map((criterion) => criterion.id));
+  let earned = 0;
+  let allRequiredPassed = true;
+  for (const verdict of criteria) {
+    if (verdict.passed) {
+      earned += weightById.get(verdict.criterionId) ?? 1;
+    } else if (requiredIds.has(verdict.criterionId)) {
+      allRequiredPassed = false;
+    }
+  }
+  const score = earned / totalWeight;
+  const minPassScore = rubric.minPassScore ?? 1;
+  return {
+    passed: allRequiredPassed && score >= minPassScore,
+    score
+  };
+};
+var createVoiceLLMJudge = (options) => ({
+  evaluate: async (input) => {
+    const prompt = buildPrompt(options.rubric, input);
+    const raw = await options.completion({
+      prompt,
+      systemPrompt: options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT
+    });
+    const parsed = parseCriteria(extractJson(raw), options.rubric);
+    const { passed, score } = scoreVerdict(options.rubric, parsed.criteria);
+    return {
+      criteria: parsed.criteria,
+      passed,
+      score,
+      summary: parsed.summary
+    };
+  },
+  rubric: options.rubric
+});
+var createVoiceAIJudgeCompletion = (options) => async ({ prompt, systemPrompt }) => {
+  const messages = [
+    { content: prompt, role: "user" }
+  ];
+  const stream = options.provider.stream({
+    messages,
+    model: options.model,
+    systemPrompt
+  });
+  let buffered = "";
+  for await (const chunk of stream) {
+    if (chunk.type === "text") {
+      buffered += chunk.content;
+    }
+  }
+  return buffered;
+};
+// src/redaction.ts
+var DEFAULT_VOICE_REDACTION_PATTERNS = [
+  {
+    label: "credit-card",
+    regex: /\b(?:\d[ -]?){13,19}\b/g,
+    replacement: "[REDACTED:CC]"
+  },
+  {
+    label: "ssn",
+    regex: /\b\d{3}-\d{2}-\d{4}\b/g,
+    replacement: "[REDACTED:SSN]"
+  },
+  {
+    label: "email",
+    regex: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,
+    replacement: "[REDACTED:EMAIL]"
+  },
+  {
+    label: "phone",
+    regex: /\b(?:\+?1[ .-]?)?\(?\d{3}\)?[ .-]?\d{3}[ .-]?\d{4}\b/g,
+    replacement: "[REDACTED:PHONE]"
+  }
+];
+var createVoiceTranscriptRedactor = (options = {}) => {
+  const patterns = options.patterns ?? DEFAULT_VOICE_REDACTION_PATTERNS;
+  return (transcript) => {
+    if (!transcript.text) {
+      return transcript;
+    }
+    let redacted = transcript.text;
+    for (const pattern of patterns) {
+      redacted = redacted.replace(pattern.regex, pattern.replacement ?? `[REDACTED:${pattern.label.toUpperCase()}]`);
+    }
+    if (redacted === transcript.text) {
+      return transcript;
+    }
+    return { ...transcript, text: redacted };
+  };
+};
+var redactVoiceTranscript = (transcript, patterns = DEFAULT_VOICE_REDACTION_PATTERNS) => createVoiceTranscriptRedactor({ patterns })(transcript);
 // src/costAccounting.ts
 var DEFAULT_VOICE_PRICE_BOOK = {
   "anthropic:claude-opus-4-5": {
@@ -45884,6 +46056,7 @@ export {
   renderVoiceAuditHTML,
   renderVoiceAuditDeliveryHTML,
   renderVoiceAssistantHealthHTML,
+  redactVoiceTranscript,
   redactVoiceTraceText,
   redactVoiceTraceEvents,
   redactVoiceTraceEvent,
@@ -46005,6 +46178,7 @@ export {
   createVoiceTurnLatencyJSONHandler,
   createVoiceTurnLatencyHTMLHandler,
   createVoiceTransferCallTool,
+  createVoiceTranscriptRedactor,
   createVoiceTraceTimelineRoutes,
   createVoiceTraceSinkStore,
   createVoiceTraceSinkDeliveryWorkerLoop,
@@ -46206,6 +46380,7 @@ export {
   createVoiceLinearIssueUpdateSink,
   createVoiceLinearIssueSyncSinks,
   createVoiceLinearIssueSink,
+  createVoiceLLMJudge,
   createVoiceIntegrationSinkWorkerLoop,
   createVoiceIntegrationSinkWorker,
   createVoiceIntegrationHTTPSink,
@@ -46301,6 +46476,7 @@ export {
   createVoiceAgentTool,
   createVoiceAgentSquad,
   createVoiceAgent,
+  createVoiceAIJudgeCompletion,
   createTwilioVoiceRoutes,
   createTwilioVoiceResponse,
   createTwilioMediaStreamBridge,
@@ -46475,6 +46651,7 @@ export {
   acknowledgeVoiceMonitorIssue,
   VOICE_LIVE_OPS_ACTIONS,
   TURN_PROFILE_DEFAULTS,
+  DEFAULT_VOICE_REDACTION_PATTERNS,
   DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS,
   DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS,
   DEFAULT_VOICE_PRICE_BOOK

package/dist/llmJudge.d.ts

@@ -0,0 +1,45 @@
+import type { AIProviderConfig } from "@absolutejs/ai";
+export type VoiceLLMJudgeRubricCriterion = {
+    description: string;
+    id: string;
+    required?: boolean;
+    weight?: number;
+};
+export type VoiceLLMJudgeRubric = {
+    criteria: VoiceLLMJudgeRubricCriterion[];
+    minPassScore?: number;
+};
+export type VoiceLLMJudgeCriterionVerdict = {
+    criterionId: string;
+    passed: boolean;
+    rationale: string;
+};
+export type VoiceLLMJudgeVerdict = {
+    criteria: VoiceLLMJudgeCriterionVerdict[];
+    passed: boolean;
+    score: number;
+    summary?: string;
+};
+export type VoiceLLMJudgeInput = {
+    metadata?: Record<string, unknown>;
+    transcript: string;
+};
+export type VoiceLLMJudgeCompletion = (input: {
+    prompt: string;
+    systemPrompt?: string;
+}) => Promise<string>;
+export type CreateVoiceLLMJudgeOptions = {
+    completion: VoiceLLMJudgeCompletion;
+    rubric: VoiceLLMJudgeRubric;
+    systemPrompt?: string;
+};
+export type VoiceLLMJudge = {
+    evaluate: (input: VoiceLLMJudgeInput) => Promise<VoiceLLMJudgeVerdict>;
+    rubric: VoiceLLMJudgeRubric;
+};
+export declare const createVoiceLLMJudge: (options: CreateVoiceLLMJudgeOptions) => VoiceLLMJudge;
+export type CreateVoiceAIJudgeCompletionOptions = {
+    model: string;
+    provider: AIProviderConfig;
+};
+export declare const createVoiceAIJudgeCompletion: (options: CreateVoiceAIJudgeCompletionOptions) => VoiceLLMJudgeCompletion;

package/dist/redaction.d.ts

@@ -0,0 +1,13 @@
+import type { Transcript } from "./types";
+export type VoiceRedactionPattern = {
+    label: string;
+    replacement?: string;
+    regex: RegExp;
+};
+export declare const DEFAULT_VOICE_REDACTION_PATTERNS: VoiceRedactionPattern[];
+export type VoiceTranscriptRedactor = (transcript: Transcript) => Transcript;
+export type CreateVoiceTranscriptRedactorOptions = {
+    patterns?: VoiceRedactionPattern[];
+};
+export declare const createVoiceTranscriptRedactor: (options?: CreateVoiceTranscriptRedactorOptions) => VoiceTranscriptRedactor;
+export declare const redactVoiceTranscript: (transcript: Transcript, patterns?: VoiceRedactionPattern[]) => Transcript;

package/dist/testing/index.js

@@ -6473,11 +6473,13 @@ var createVoiceSession = (options) => {
       fallbackSession.on("final", ({ transcript }) => {
         fallbackFinalReceived = true;
         lastFallbackTranscriptAt = Date.now();
-        fallbackTranscripts.push(cloneTranscript(transcript));
+        const next = options.redact ? options.redact(transcript) : transcript;
+        fallbackTranscripts.push(cloneTranscript(next));
       }),
       fallbackSession.on("partial", ({ transcript }) => {
         lastFallbackTranscriptAt = Date.now();
-        fallbackTranscripts.push(cloneTranscript(transcript));
+        const next = options.redact ? options.redact(transcript) : transcript;
+        fallbackTranscripts.push(cloneTranscript(next));
       }),
       fallbackSession.on("endOfTurn", () => {
         fallbackEndOfTurnReceived = true;
@@ -6795,10 +6797,12 @@ var createVoiceSession = (options) => {
       });
     };
     openedSession.on("partial", ({ transcript }) => {
-      runAdapterEvent("adapter.partial", () => handlePartial(transcript));
+      const next = options.redact ? options.redact(transcript) : transcript;
+      runAdapterEvent("adapter.partial", () => handlePartial(next));
     });
     openedSession.on("final", ({ transcript }) => {
-      runAdapterEvent("adapter.final", () => handleFinal(transcript));
+      const next = options.redact ? options.redact(transcript) : transcript;
+      runAdapterEvent("adapter.final", () => handleFinal(next));
     });
     openedSession.on("endOfTurn", ({ reason }) => {
       runAdapterEvent("adapter.endOfTurn", async () => {

package/dist/types.d.ts

@@ -730,6 +730,7 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     costTelephony?: {
         provider?: string;
     };
+    redact?: import("./redaction").VoiceTranscriptRedactor;
     reconnect: Required<VoiceReconnectConfig>;
     phraseHints?: VoicePhraseHint[];
     sessionMetadata?: Record<string, unknown>;

package/package.json

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